pantoken / deprecations

deprecations ​

Бета

@pantoken/plugin-deprecations — сумісні шими, що враховують життєвий цикл для вилучених upstream‑токенів.

Коли в upstream‑релізі видаляють токен --instui-*, вручну створений запис DeprecationLedger фіксує його життєвий цикл: коли він був застарілим, в якому upstream‑майнорі його буде видалено, і як забезпечити його роботу тимчасово — або перенаправити на канонічний токен (replacement → var(...)), або заморозити його останнє відоме літеральне значення (value). Цей плагін додає по одному shim‑токену на запис. Оскільки shim є одиночним var(...) або простим значенням, defineToken фіксує його refersTo/синтаксис, а toCss емісує його, тож shim потрапляє в css/scss/less/stylus/wordpress/vanilla без додаткового підключення.

Виведення з обігу контролюється в іншому місці (пайплайн оновлення різко провалює підвищення версії, щойно досягнено upstream‑майнора для запису, змушуючи запис бути виведеним і випустити consumer‑майнор). 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