pantoken / deprecations

deprecations ​

Bèta

@pantoken/plugin-deprecations — levenscyclusbewuste compatibiliteits-shims voor upstream-tokens die zijn verwijderd.

Wanneer een upstream-release een --instui-* token verwijdert, legt een handmatig geschreven DeprecationLedger het verloop ervan vast: wanneer het is afgevoerd, welke upstream minor het zal verwijderen, en hoe het intussen werkend te houden — ofwel door te verwijzen naar een canoniek token (replacement → var(...)) of het laatst-bekende literal te bevriezen (value). Deze plugin voegt één shim-token per invoer toe. Omdat de shim een enkel var(...) of een eenvoudige waarde is, legt defineToken de refersTo/syntaxis vast en geeft toCss het uit, zodat de shim zonder extra bedrading in css/scss/less/stylus/wordpress/vanilla meereist.

Het buiten gebruik stellen wordt elders afgedwongen (de upgrade-pijplijn faalt hard bij een bump zodra de removeIn upstream-minor van een invoer is bereikt, waardoor de invoer moet worden uitgefaseerd en er een consumer-minor moet worden gemaakt). dueForRemoval is de controle die dit aandrijft; describeLifecycle voorziet de documentatie.

Voorbeeld ​

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 ​

Functies ​

Referenties ​

default ​

Hernoemt en herexporteert deprecationShims