pantoken / deprecations

deprecations ​

Beta

@pantoken/plugin-deprecations — livssyklusbevisste kompatibilitets-shims for upstream-tokens som er fjernet.

Når en upstream-utgivelse fjerner et --instui-*-token, registrerer en håndskrevet DeprecationLedger dens livssyklus: når det ble avviklet, hvilken upstream-minor som vil fjerne det, og hvordan man holder det fungerende i mellomtiden — enten videresende til et kanonisk token (replacement → var(...)) eller fryse dets siste kjente literal (value). Denne pluginen legger til ett shim-token per oppføring. Fordi shimen er en enkelt var(...) eller en vanlig verdi, registrerer defineToken dens refersTo/syntaks og toCss emitterer den, slik at shimen følger med inn i css/scss/less/stylus/wordpress/vanilla uten ekstra kobling.

Utfasing håndheves andre steder (oppgraderingspipelinene feiler en bump når en oppførings removeIn upstream-minor nås, og tvinger oppføringen til å bli avviklet og en consumer-minor til å bli utgitt). dueForRemoval er sjekken som driver dette; describeLifecycle driver dokumentasjonen.

Eksempel ​

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

Grensesnitt ​

Funksjoner ​

Referanser ​

default ​

Omdøper og re-eksporterer deprecationShims