pantoken / deprecations

deprecations ​

Beta

@pantoken/plugin-deprecations — shims de compatibilidade conscientes do ciclo de vida para tokens removidos upstream.

Quando uma release upstream remove um token --instui-*, um DeprecationLedger escrito à mão registra seu ciclo de vida: quando foi descontinuado, o minor upstream que o removerá e como mantê‑lo funcionando enquanto isso — ou encaminhando para um token canônico (replacement → var(...)) ou congelando seu último literal conhecido (value). Este plugin adiciona um token shim por entrada. Como o shim é um único var(...) ou um valor simples, defineToken registra seu refersTo/sintaxe e toCss o emite, de modo que o shim segue para css/scss/less/stylus/wordpress/vanilla sem cabeamento extra.

A aposentadoria é aplicada em outro lugar (a pipeline de upgrade falha ao tentar um bump assim que o minor upstream do removeIn da entrada é atingido, forçando a entrada a ser aposentada e a gerar um minor para o consumidor). dueForRemoval é a verificação que possibilita isso; describeLifecycle alimenta a documentação.

Exemplo ​

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 ​

Funções ​

Referências ​

default ​

Renomeia e reexporta deprecationShims