pantoken / deprecations

deprecations ​

Βήτα

@pantoken/plugin-deprecations — προσαρμογείς συμβατότητας με επίγνωση του κύκλου ζωής για tokens που αφαιρέθηκαν από το upstream.

Όταν μια upstream έκδοση αφαιρεί ένα --instui-* token, ένα χειρογράφως δημιουργημένο DeprecationLedger καταγράφει τον κύκλο ζωής του: πότε χαρακτηρίστηκε deprecated, ποιο upstream minor θα το αφαιρέσει, και πώς να διατηρηθεί λειτουργικό εν τω μεταξύ — είτε προώθηση σε ένα κανονικό token (replacement → var(...)) είτε πάγωμα της τελευταίας γνωστής λεκτικής τιμής (value). Αυτό το plugin προσθέτει έναν shim token ανά εγγραφή. Επειδή ο shim είναι είτε ένα μεμονωμένο var(...) είτε μια απλή τιμή, ο defineToken καταγράφει την refersTo/σύνταξή του και ο toCss το εκπέμπει, έτσι ο shim μεταφέρεται σε css/scss/less/stylus/wordpress/vanilla χωρίς επιπλέον σύνδεση.

Η αποσύνταξη επιβάλλεται αλλού (το pipeline αναβάθμισης αποτυγχάνει σκληρά ένα bump όταν φτάσει το upstream minor ενός removeIn εγγραφής, αναγκάζοντας την εγγραφή να αποσυρθεί και να κοπεί ένα consumer 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