pantoken / deprecations

deprecations ​

Beta

@pantoken/plugin-deprecations — các shim tương thích nhận biết vòng đời cho các token upstream bị loại bỏ.

Khi một bản phát hành upstream loại bỏ một token --instui-*, một DeprecationLedger do con người viết tay ghi lại vòng đời của nó: khi nó bị đánh dấu lỗi thời, bản minor upstream sẽ xóa nó, và cách giữ cho nó hoạt động trong khi chờ — hoặc chuyển tiếp sang token chuẩn (replacement → var(...)) hoặc đóng băng giá trị cuối cùng đã biết của nó (value). Plugin này thêm một token shim cho mỗi mục. Bởi vì shim là một var(...) đơn hoặc một giá trị thuần túy, defineToken ghi lại refersTo/cú pháp của nó và toCss phát ra nó, nên shim được đưa vào css/scss/less/stylus/wordpress/vanilla mà không cần dây nối bổ sung.

Việc nghỉ hưu được thực thi ở nơi khác (pipeline nâng cấp sẽ thất bại nghiêm trọng khi tăng phiên bản một khi minor upstream của mục removeIn được đạt tới, buộc mục phải bị nghỉ và một minor cho người tiêu thụ phải được cắt). dueForRemoval là kiểm tra cung cấp năng lượng cho việc này; describeLifecycle cung cấp năng lượng cho tài liệu.

Ví dụ ​

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

Giao diện ​

Hàm ​

Tham chiếu ​

default ​

Đổi tên và xuất lại deprecationShims