pantoken / deprecations

deprecations ​

Beta

@pantoken/plugin-deprecations — livscykelmedvetna kompatibilitetsshim för borttagna upstream-tokens.

När en upstream‑release tar bort en --instui-*‑token registrerar en handskriven DeprecationLedger dess livscykel: när den deprecierades, vilken upstream‑minor som kommer att ta bort den, och hur man behåller dess funktion under tiden — antingen vidarekoppla till en kanonisk token (replacement → var(...)) eller frysa dess senast kända literal (value). Denna plugin lägger till en shim‑token per post. Eftersom shim:en är antingen en enda var(...) eller ett vanligt värde, defineToken registrerar dess refersTo/syntax och toCss emitterar den, så shim:en följer med in i css/scss/less/stylus/wordpress/vanilla utan extra kopplingar.

Utsorteringen verkställs på annat håll (uppgraderingspipeline:n misslyckas hårt vid en bump när en post når sin removeIn upstream‑minor, vilket tvingar posten att pensioneras och en consumer‑minor att skapas). dueForRemoval är kontrollen som driver detta; describeLifecycle driver dokumentationen.

Exempel ​

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

Gränssnitt ​

Funktioner ​

Referenser ​

default ​

Byter namn på och återexporterar deprecationShims