pantoken / prune-custom-props

prune-custom-props ​

Beta

@pantoken/plugin-prune-custom-props — entfernt per Tree-Shaking ungenutzte Custom Properties aus einem zusammengesetzten Stylesheet.

pantoken's @pantoken/css gibt das gesamte --instui-*-Token-Set aus (≈1.800 Icon-Data-URIs inklusive). Ein Renderer, der auf dieser Ebene aufbaut, aber nur einen Ausschnitt des Systems stylt, würde ansonsten das komplette Set ausliefern — daher wollen solche Renderer dieses Feature. Ausgehend von den var() Referenzen in echten (Nicht-Custom-Property-)Deklarationen behält es transitiv nur die tatsächlich erreichbaren Custom Properties und entfernt die entsprechenden ungenutzten @property-Registrierungen.

Es ist ein eigenständiges PostCSS-Plugin (in der eigenen PostCSS-Pipeline ausführen). Die Factory gibt ein normales Plugin-Objekt zurück, sodass das Importieren dieses Moduls keine Laufzeitabhängigkeit hereinzieht — postcss ist nur ein Typ.

Beispiel ​

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

Variablen ​

Referenzen ​

default ​

Benennt um und re-exportiert pruneCustomProps