Skip to content

pantoken / deprecations

deprecations

Beta

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

Quando uma release upstream remove um token --instui-*, um registro escrito à mão DeprecationLedger documenta seu ciclo de vida: quando foi depreciado, o minor upstream que o removerá e como mantê‑lo funcionando enquanto isso — ou encaminhar para um token canônico (replacementvar(...)) ou congelar seu literal conhecido mais recente (value). Este plugin anexa um token shim por entrada. Como o shim é um único var(...) ou um valor plain, defineToken registra sua refersTo/sintaxe e toCss o emite, de modo que o shim chega ao css/scss/less/stylus/wordpress/vanilla sem fiação extra.

A aposentadoria é aplicada em outro lugar (o pipeline de upgrade falha criticamente num bump assim que o minor upstream indicado por uma entrada removeIn é alcançado, forçando a entrada a ser removida e um minor do consumidor a ser cortado). dueForRemoval é a verificação que a alimenta; 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