pantoken / deprecations

deprecations ​

Бета

@pantoken/plugin-deprecations — совместимые shim-патчи, учитывающие жизненный цикл для удалённых upstream токенов.

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

Вывод из обращения принудительно контролируется в другом месте (pipeline обновления жёстко фейлит bump, как только достигается upstream minor, указанный в записи removeIn, заставляя запись быть удалённой и выпустить minor для потребителей). 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