pantoken-root / packages/core/src / modifyExpression

Função: modifyExpression() ​

modifyExpression(base, modify): string

Beta

A forma em expressão CSS de applyModify: mesma matemática, mas aplicada a base no momento da pintura em vez de a um hex no tempo de build, de modo que uma origem var(--instui-…) sobrevive até a folha de estilo e continua rastreando aquilo para o que esse token resolve (incluindo um par light-dark(), e qualquer reapontamento em tempo de execução da primitiva da qual ele deriva).

A sintaxe de cor relativa resolve l na escala de 0–100 tanto em hsl() quanto em lch(), e um canal alfa omitido herda o da origem — correspondendo à passagem do 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 (p.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))"