pantoken / packages/core/src / applyModify

Função: applyModify() ​

applyModify(value, modify): string | undefined

Beta

Aplicar um Tokens Studio TokenModify a uma cor hex concreta.

Parâmetros ​

value ​

string

modify ​

TokenModify

Retorna ​

string | undefined

A cor modificada, ou undefined quando value não for uma cor hex (assim o chamador pode recorrer a preservar o modificador como metadados).

Exemplos ​

Escurecer, clarear e adicionar alpha

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-hex 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