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。

条目的移除由别处强制执行（升级流水线在达到条目标记的上游次版本时会使 bump 失败，强制该条目被移除并切出一个消费者次版本）。 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