pantoken / prune-custom-props

prune-custom-props ​

Beta

@pantoken/plugin-prune-custom-props — elimina por tree-shaking propriedades customizadas não utilizadas de uma folha de estilo composta.

O @pantoken/css do pantoken emite todo o conjunto de tokens --instui-* (≈1.800 data-URIs de ícones incluídos). Um renderer que se baseia nessa camada mas estiliza apenas uma parte do sistema acabaria por distribuir o conjunto inteiro — por isso qualquer renderer desse tipo quer isto. A partir das referências var() em declarações reais (não em custom properties), ele mantém transitivamente apenas as custom properties efetivamente alcançáveis e remove os registros @property não utilizados correspondentes.

É um plugin PostCSS independente (execute-o na sua própria pipeline PostCSS). A fábrica retorna um objeto de plugin simples, então importar este módulo não traz dependência de runtime — postcss é apenas um tipo.

Exemplo ​

ts
import postcss from "postcss";
import { pruneCustomProps } from "@pantoken/plugin-prune-custom-props";
const out = postcss([pruneCustomProps()]).process(css, { from: undefined }).css;

Variáveis ​

Referências ​

default ​

Renomeia e reexporta pruneCustomProps