Skip to content

pantoken / deprecations

deprecations

Beta

@pantoken/plugin-deprecations — elinkaaritietoiset yhteensopivuussillat poistuneille upstream-tunnisteille.

Kun upstream-julkaisu poistaa --instui-*-tunnisteen, käsin kirjoitettu DeprecationLedger tallentaa sen elinkaaren: milloin se deprekoitiin, upstream-minor-versio joka sen poistaa, ja miten pitää se toiminnassa siihen asti — joko ohjaamalla se kanoniseen tunnisteeseen (replacementvar(...)) tai jäädyttämällä sen viimeksi tunnettu literal (value). Tämä plugin lisää yhden shim-tunnisteen kutakin merkintää kohti. Koska shim on yksittäinen var(...) tai pelkkä arvo, defineToken tallentaa sen refersTo/syntaksin ja toCss emittoi sen, joten shim kulkee css/scss/less/stylus/wordpress/vanilla -muotoihin ilman lisäkonfiguraatiota.

Eläkkeelle siirto pakotetaan muualla (päivitysputki epäonnistaa versionkorotuksen, kun merkinnän removeIn upstream-minor saavutetaan, pakottaen merkinnän eläkkeelle ja kuluttajalle uuden minor-version julkaistavaksi). dueForRemoval on tarkistus, joka tämän ajaa; describeLifecycle tuottaa dokumentaation.

Esimerkki

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

Rajapinnat

Funktionit

Viittaukset

default

Nimeää uudelleen ja vie uudelleen deprecationShims