Skip to content

pantoken / deprecations

deprecations

Beta

@pantoken/plugin-deprecations — shim kompatibilitas sadar-lifecycle untuk token upstream yang dihapus.

Ketika rilis upstream menghapus token --instui-*, sebuah DeprecationLedger yang ditulis tangan mencatat lifecycle-nya: kapan ia didepresiasi, minor upstream yang akan menghapusnya, dan bagaimana menjaganya tetap berfungsi sementara — baik meneruskan ke token kanonik (replacementvar(...)) atau membekukan literal terakhir yang diketahui (value). Plugin ini menambahkan satu token shim per entri. Karena shim adalah sebuah var(...) tunggal atau nilai biasa, defineToken mencatat refersTo/sintaksnya dan toCss mengemitnya, sehingga shim ikut masuk ke css/scss/less/stylus/wordpress/vanilla tanpa pengkabelan tambahan.

Penghapusan dipaksakan di tempat lain (pipeline upgrade gagal keras pada bump setelah minor upstream removeIn tercapai untuk sebuah entri, memaksa entri tersebut dipensiunkan dan memotong minor konsumen). dueForRemoval adalah pemeriksaan yang menjalankannya; describeLifecycle menjalankan dokumentasinya.

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

Antarmuka

Fungsi

Referensi

default

Mengganti nama dan mengekspor ulang deprecationShims