pantoken / deprecations

deprecations ​

Bêta

@pantoken/plugin-deprecations — shim de compatibilité conscient du cycle de vie pour les tokens supprimés en amont.

Lorsqu’une publication upstream supprime un token --instui-*, un DeprecationLedger rédigé à la main enregistre son cycle de vie : quand il a été déprécié, la version mineure upstream qui le supprimera, et comment le maintenir fonctionnel en attendant — soit le rediriger vers un token canonique (replacement → var(...)) ou geler sa dernière valeur littérale connue (value). Ce plugin ajoute un token shim par entrée. Parce que le shim est un unique var(...) ou une valeur simple, defineToken enregistre sa refersTo/syntaxe et toCss l’émet, donc le shim voyage dans css/scss/less/stylus/wordpress/vanilla sans câblage supplémentaire.

La retraite est appliquée ailleurs (le pipeline de mise à niveau échoue immédiatement sur un bump une fois que la version mineure upstream removeIn d’une entrée est atteinte, forçant la retraite de l’entrée et la publication d’une version mineure consommateur). dueForRemoval est la vérification qui l’alimente ; describeLifecycle alimente la documentation.

Exemple ​

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)] });

Interfaces ​

Fonctions ​

Références ​

default ​

Renomme et ré-exporte deprecationShims