pantoken / deprecations

deprecations ​

Beta（測試）

@pantoken/plugin-deprecations — 針對已移除上游 token 的生命週期感知相容 shim。

當上游釋出移除一個 --instui-* token 時，一個手工撰寫的 DeprecationLedger 會記錄其生命週期：何時被標為棄用、將在何個上游小版本中移除，以及在此期間如何維持其運作——要麼轉發到一個規範 token（replacement → var(...)）要麼 凍結其最後已知的字面值（value）。此插件會為每一項目附加一個 shim token。由於 shim 是單一的 var(...) 或純值，defineToken 會記錄其 refersTo/語法，且 toCss 會輸出它，因此該 shim 可不需額外連接就一併匯出到 css/scss/less/stylus/wordpress/vanilla。

移除的執行在別處強制實行（升級管線在達到某筆條目的上游小版本 removeIn 時會使版本升級失敗，迫使該條目被退役並產生一個消費端的小版本）。 dueForRemoval 是驅動該檢查的機制；describeLifecycle 則用於提供文件說明。

範例 ​

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

介面 ​

函式 ​

參考 ​

default ​

重新命名並重新導出 deprecationShims