Design Token Lint
GitHub リポジトリ

検索したい単語を入力

いつでも検索バーを開ける

v2.0.0

最初の安定版 2.x — semanticPrefixes が観測可能な名前空間宣言になり、ドキュメントサイトは zudo-doc 4.5 へ移行、リリースは stable-by-default に。

v1.0.0 以来最初の安定版リリースです。v1.1.0-next.1v1.1.0-next.3 のプリリリース系列の内容もすべて含まれます — v1.0.0 からアップグレードする場合は、それらのエントリもあわせて読んでください(v1.1.0-next.1v1.1.0-next.2v1.1.0-next.3)。2.0 メジャー自体を担うのは、意図的なリント挙動の変更が 1 つ: semanticPrefixes が実際に機能するようになりました。

Warning

挙動の変更: semanticPrefixes は、何もしない許可リストではなく名前空間宣言になりました。プレフィックスを追加すると違反が増えることがあります: デフォルト設定では p-hgap-2 がフラグされ(hgap- 名前空間の後の数値テール)、p-hgap-sm のような本物のセマンティックトークンは引き続きパスします。下記の移行ガイドを参照してください。

挙動の変更

移行: 名前空間宣言としての semanticPrefixes

1.x では、{n} プレースホルダーで構築された設定に対して semanticPrefixes は観測可能な効果を持ちませんでした — hgap-sm のようなセマンティック値はそもそも数値パターンにマッチしないため、バイパスが発火することがなかったのです。2.0 ではこのオプションはトークン名前空間を宣言します: 値がリストされた - 終わりのプレフィックスで始まる場合、名前空間が取り除かれ、ルールの数値テストが残りの部分に再適用されます(7adcb49)。

  • p-hgap-sm — パス(残りの sm は数値ではない)— 1.x と同じ

  • p-hgap-2新たにフラグ(残りの 2 が数値): トークン名前空間の中に隠れた生の数値

  • DEFAULT_CONFIG.semanticPrefixes["hgap-", "vgap-"] から ["hgap-", "vgap-", "hsp-", "vsp-"] に拡張

  • すべての exact-{n} ルール(スペーシング、サイズスケール、オプトインの z-index プリセット)に一様に適用

  • 末尾に - を持たずトークン途中にマッチするレガシーなエントリは、1.x の無条件バイパス挙動を維持します(設定ガイドに記載)

  • 挙動を比較するには "semanticPrefixes": [] を設定してください — フィールドを削除するとデフォルトに戻り、空リストにはなりません

  • 公開 API の形状は変更なし: LintResultViolationcheckClassCompiledRulecompilePattern はすべて同一

Playground は新しい挙動をミラーし、パス/フラグの反転を示すデモペアを搭載。パッケージ自身のテストスイート内のパリティテストで裏付けられています。

ドキュメントサイト

ドキュメントサイトは zudo-doc 4.5.0 + zfb 1.1.1(bauhaus テーマパック)に再スキャフォールドされました。ドキュメントのバージョニングが有効になり — v1.0.0 のドキュメントは閲覧可能なアーカイブとして保存 — さらにデザイントークンパネル、本物のファビコン、404 ページでの SPA トランジション、日本語化された Playground が追加されました。2.0 以前の設定ガイドと API リファレンスは完全に再同期されています(EN + JA)。

その他の変更

  • リリースは stable-by-default になりました: リリースは npm の latest タグに直接着地し、next dist-tag は明示的なオプトインのソークチャンネルとなり、安定版公開後は自動的にクリーンアップされます(b4043b6、273f498)。そのため npm i @takazudo/zudo-design-token-lint@next はソーク間ではバージョンが存在しないと報告することがあります。

  • レジストリのスモークテストは、next dist-tag が存在しない場合 @next レグを正常にスキップします(ce6a824)

  • ホームのヒーローが生成されたプレースホルダーではなくサイト自身のロゴを使用(b23a64d); zudo-doc 内部向けスキルを公開 claude-skills ドキュメントから削除(a17eae0)