pantoken / packages/core/src / applyModify

Função: applyModify() ​

applyModify(value, modify): string | undefined

Beta

Aplicar um Tokens Studio TokenModify a uma cor hexadecimal concreta.

Parâmetros ​

value ​

string

modify ​

TokenModify

Retorna ​

string | undefined

A cor modificada, ou undefined quando value não for uma cor hexadecimal (assim o chamador pode optar por preservar o modificador como metadados).

Exemplos ​

Escurecer, clarear e adicionar alfa

ts
import { applyModify } from "@pantoken/core";

applyModify("#808080", { type: "darken", value: 0.5 });  // → "#404040"
applyModify("#808080", { type: "lighten", value: 0.5 }); // → "#c0c0c0"
applyModify("#ffffff", { type: "alpha", value: 0.5 });   // → "#ffffff80"

Entrada não-hexadecimal e mix retornam undefined (preservar como metadados)

ts
import { applyModify } from "@pantoken/core";

applyModify("var(--x)", { type: "darken", value: 0.1 });        // → undefined
applyModify("#fff", { type: "mix", value: 0.5, color: "#000" }); // → undefined