pantoken / prune-custom-props

prune-custom-props ​

Beta

@pantoken/plugin-prune-custom-props — elimina (tree-shake) propriedades personalizadas 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 renderizador que constrói sobre essa camada mas estiliza apenas uma fatia do sistema acabaria distribuindo o conjunto inteiro — portanto, qualquer renderizador assim quer isto. A partir das referências var() em declarações reais (não em custom properties), ele retém transitivamente apenas as custom properties realmente alcançáveis e descarta os registros @property correspondentes que não são usados.

É um plugin PostCSS autônomo (execute-o em sua própria pipeline PostCSS). A fábrica retorna um objeto de plugin simples, então importar este módulo não puxa dependências 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