pantoken-root / deprecations

deprecations ​

Beta

@pantoken/plugin-deprecations — shimy kompatybilności świadome cyklu życia dla usuniętych tokenów upstream.

Kiedy wydanie upstream usuwa token --instui-*, ręcznie stworzone DeprecationLedger rejestruje jego cykl życia: kiedy został oznaczony jako przestarzały, w którym upstream minorze zostanie usunięty i jak utrzymać jego działanie tymczasowo — albo przekierować do kanonicznego tokena (replacement → var(...)) albo zamrozić jego ostatnią znaną literalną wartość (value). Ten plugin dopisuje jeden shim token na wpis. Ponieważ shim jest pojedynczym var(...) lub zwykłą wartością, defineToken rejestruje jego refersTo/składnię i toCss go emituje, więc shim trafia do css/scss/less/stylus/wordpress/vanilla bez dodatkowego okablowania.

Wycofanie jest wymuszane gdzie indziej (pipeline aktualizacji odrzuca bump, gdy osiągnięty zostanie upstream minor przypisany wpisowi, zmuszając do wycofania wpisu i wydania minoru do konsumentów). dueForRemoval to kontrola, która to napędza; describeLifecycle napędza dokumentację.

Przykład ​

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

Interfejsy ​

Funkcje ​

Odwołania ​

default ​

Zmienia nazwę i ponownie eksportuje deprecationShims