pantoken / deprecations

deprecations ​

Bêta

@pantoken/plugin-deprecations — greffons de compatibilité sensibles au cycle de vie pour les tokens supprimés en amont.

Lorsqu'une publication en amont supprime un token --instui-*, un DeprecationLedger rédigé manuellement enregistre son cycle de vie : quand il a été marqué comme obsolète, la version mineure en amont qui le retirera, et comment le conserver en attendant — soit le rediriger vers un token canonique (replacement → var(...)) soit 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, de sorte que le shim est transporté dans css/scss/less/stylus/wordpress/vanilla sans câblage supplémentaire.

La mise hors service est appliquée ailleurs (le pipeline de mise à niveau échoue catégoriquement lors d'un bump une fois que la version mineure en amont indiquée par l'entrée removeIn est atteinte, forçant la suppression 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