Skip to content

pantoken / deprecations

deprecations

Beta

@pantoken/plugin-deprecations — shim keserasian yang peka kitaran hayat untuk token hulu yang dihentikan.

Apabila keluaran hulu membuang token --instui-*, sebuah DeprecationLedger yang ditulis tangan merekod kitarannya: bila ia ditandakan usang, minor hulu yang akan mengalihnya, dan cara untuk mengekalkannya berfungsi sementara — sama ada meneruskan ke token kanonik (replacementvar(...)) atau membekukan literal terakhir yang diketahui (value). Plugin ini menambah satu token shim bagi setiap entri. Kerana shim adalah sebuah var(...) tunggal atau nilai biasa, defineToken merekod refersTo/sintaksnya dan toCss mengeluarkannya, jadi shim itu dibawa ke dalam css/scss/less/stylus/wordpress/vanilla tanpa pendawaian tambahan.

Persaraan dikuatkuasakan di tempat lain (saluran naik taraf akan gagal keras apabila bump mencapai minor hulu bagi entri, memaksa entri itu dipenswakan dan minor pengguna dipotong). dueForRemoval ialah pemeriksaan yang menggerakkannya; describeLifecycle menggerakkan dokumen.

Contoh

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

Antaramuka

Fungsi

Rujukan

default

Menamakan semula dan mengeksport semula deprecationShims