Skip to content

pantoken / deprecations

deprecations

Beta

@pantoken/plugin-deprecations — adaptadores de compatibilidad conscientes del ciclo de vida para tokens eliminados por upstream.

Cuando una versión upstream elimina un token --instui-*, un DeprecationLedger escrito a mano registra su ciclo de vida: cuándo fue desaprobado, el minor upstream que lo eliminará y cómo mantenerlo funcionando mientras tanto — ya sea reenviándolo a un token canónico (replacementvar(...)) o congelando su último literal conocido (value). Este complemento añade un token shim por entrada. Debido a que el shim es un único var(...) o un valor simple, defineToken registra su refersTo/sintaxis y toCss lo emite, por lo que el shim llega a css/scss/less/stylus/wordpress/vanilla sin cableado adicional.

La retirada se aplica en otro lugar (la canalización de actualización falla de forma estricta un bump una vez que se alcanza el minor upstream de una entrada, obligando a que la entrada sea retirada y se corte un minor para el consumidor). dueForRemoval es la comprobación que lo impulsa; describeLifecycle impulsa la documentación.

Ejemplo

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

Interfaces

Funciones

Referencias

default

Renombra y vuelve a exportar deprecationShims