pantoken / deprecations

deprecations ​

Beta

@pantoken/plugin-deprecations — shim di compatibilità consapevoli del ciclo di vita per token upstream rimossi.

Quando in una release upstream viene rimosso un token --instui-*, un DeprecationLedger scritto a mano ne registra il ciclo di vita: quando è stato deprecato, il minor upstream che lo rimuoverà e come mantenerlo funzionante nel frattempo — oppure inoltrarlo a un token canonico (replacement → var(...)) oppure congelarne l'ultima forma letterale nota (value). Questo plugin aggiunge un token shim per ogni voce. Poiché lo shim è un singolo var(...) o un valore semplice, defineToken ne registra la refersTo/sintassi e toCss lo emette, così lo shim arriva in css/scss/less/stylus/wordpress/vanilla senza cablaggi aggiuntivi.

Il ritiro è fatto rispettare altrove (la pipeline di upgrade fallisce in modo hard quando viene raggiunto il minor upstream indicato dalla voce removeIn, costringendo la voce a essere rimossa e a tagliare un minor per i consumer). dueForRemoval è il controllo che lo alimenta; describeLifecycle alimenta la documentazione.

Esempio ​

ts
import { buildTokens } from "@pantoken/core/build";
import { deprecationShims } from "@pantoken/plugin-deprecations";
import ledger from "@pantoken/tokens/deprecations.json" with { type: "json" };

buildTokens({ theme: "rebrand", plugins: [deprecationShims(ledger)] });

Interfacce ​

Funzioni ​

Riferimenti ​

default ​

Rinomina e riesporta deprecationShims