pantoken-root / packages/core/src / modifyExpression

Função: modifyExpression() ​

modifyExpression(base, modify): string

Beta

The CSS-expression form of applyModify: mesmas operações matemáticas, mas aplicadas a base no momento da pintura em vez de a um hex durante o build, de modo que uma origem var(--instui-…) como var(--instui-…) sobreviva na folha de estilos e continue acompanhando aquilo a que esse token resolve (incluindo um par light-dark(), e qualquer reapontamento em tempo de execução da primitiva da qual ele deriva)).

Relative colour syntax resolves l na escala 0–100 tanto em hsl() quanto em lch(), e um canal alfa omitido herda o do originador — correspondendo à passagem de alfa do applyModify.

Parâmetros ​

base ​

string

A cor base (literal, var(--token) ou o resultado de um helper aninhado).

modify ​

TokenModify

O espaço de cor em que o modificador opera (ex.: "hsl").

Retorna ​

string

Uma expressão color-mix().

Exemplo ​

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

modifyExpression("var(--x)", { type: "alpha", value: 0.2, space: "hsl" });
// → "color-mix(in srgb, var(--x) 20%, transparent)"
modifyExpression("var(--x)", { type: "darken", value: 0.1, space: "hsl" });
// → "hsl(from var(--x) h s calc(l * 0.9))"
modifyExpression("var(--x)", { type: "lighten", value: 0.1, space: "hsl" });
// → "hsl(from var(--x) h s calc(l + (100 - l) * 0.1))"