0.5.1
0.5.1 のリリースノート。
Released: 2026-09-06
パネルの最小幅において、トークングリッド、カード操作、ヘッダー操作がはみ出さずに収まるようになりました。複数パネルの表示位置も安定します。生成順の番号を保存するようにし、Astro のクライアントサイド遷移をまたいでも維持されます。先行読み込みはパネルが実際に読み取れる状態キーだけに限定し、スペシメンのスタイルシートにはドキュメント側の採用チェックが要求する境界指定を追加しました。
破壊的変更
公開エクスポートである
EAGER_LOAD_GATE_STATE_FAMILY.matchesKeyが受け付けるキーの範囲を狭めました。 0.5.0 では${storagePrefix}-stateに-vと 1 桁以上の数字が続くキーをすべて受け付けていましたが、0.5.1 では新しいREADABLE_STATE_KEY_SUFFIXESレジストリ（-state、-state-v2、-state-v3、-state-v4）との完全一致だけを受け付けます。そのため${storagePrefix}-stateと${storagePrefix}-state-v2は引き続き一致しますが、${storagePrefix}-state-v1、${storagePrefix}-state-v0、${storagePrefix}-state-v01、${storagePrefix}-state-v123は 0.5.0 では一致していたのに 0.5.1 では一致しません。同期的な先行読み込みゲートはローダーが実際に読めるバージョンだけを調べるべきなので、この絞り込み自体は意図的なものです。ただし利用側から観測できる変更であり、TypeScript の型シグネチャは変わっていないため型チェックでは検出できません。本来はパッチではなくマイナーリリースに含めるべき変更でした。移行方法:-state-vN形式のキーを前提にしているホストは、数値パターンでマッチするのではなく、新しいREADABLE_STATE_KEY_SUFFIXESエクスポートからキーを導出してください。次にストレージ形式が更新されたときに、そのアサーションが自動で追従します。(bcc55fd, #790, #793, #814)パネルのコンテンツ幅が 1135px 以下になると、ヘッダーのアクションリンクがケバブメニューの中に折りたたまれるようになりました。それまでクリックできていた操作が、従来のセレクタでは掴めなくなります。 (2026-09-08 に追記した、リリース済みバージョンへの遡及的な訂正です。この挙動は 0.5.1 で出荷されていましたが、当時は バグ修正 の
fix(panel): yield header controls before floating panel overflowとしてしか記載しておらず、本来はこちらに書くべきものでした。) ヘッダーのアクションリンク（Export、Load from JSON…、Apply、Reset）は非表示になり、代わりにケバブメニューのトリガー.tokenpanel-actions-menu-btn（aria-label="Panel actions"）から開く.tokenpanel-actions-popoverの中に置かれます。これを制御しているのは.tokenpanel-shell（container: tokenpanel / inline-size）に対する@container tokenpanel (max-width: 1135px)です。このしきい値には注意すべき点が 2 つあります。ひとつは 1135px 以下 で折りたたまれること、つまりちょうど 1135px は折りたたまれ、1136px は折りたたまれないこと。もうひとつは、判定に使われるのが ビューポートではなくシェル自身のコンテンツボックスのインラインサイズ であり、パネル自身のボーダーの分だけ測定される幅が変わることです。1135px は、ふつうのデスクトップ表示のパネルであればすでに下回っている程度の幅です。シェル幅 1024px は、狭い表示でもモバイルでもありません。意外なのはレスポンシブな折りたたみが存在すること自体ではなく、多くの人が「デスクトップ」と呼ぶ幅でそれが起きることです。折りたたまれたリンクはdisplay: noneになってアクセシビリティツリーからも外れるため、0.5.0 まで動いていた次のようなクエリは 0.5.1 ではタイムアウトします。await page.getByRole('button', { name: 'Reset', exact: true }).click();上の
matchesKeyの絞り込みと同じく、これは利用側から観測できる変更でありながら、TypeScript の型シグネチャは変わっていないため型チェックでは検出できません。本来はパッチではなくマイナーリリースに含めるべき変更でした。移行方法: アクションを操作する前にケバブメニューを開くか、しきい値より広いコンテンツ幅でパネルを動かしてください。どちらの手順も、境界値の計算とあわせてレシピ ヘッダーのアクションに到達する で解説しています。これらの操作を指す安定したdata-zdtp-action属性は 0.5.2 で追加されましたが、0.5.1 には存在しません。(06cbb0e, #787, #831)
バグ修正
fix: 最小幅でトークングリッドとカード操作が収まるように調整 (8db4235)
fix(panel): フローティングパネルのはみ出しより先にヘッダー操作を折りたたむ (06cbb0e)
fix: ドキュメント採用時の境界指定を検証 (a11fd6a)
その他の変更
プルリクエストをマージ: #801 from Takazudo/base/sweep-260906-2 (2631545)
プルリクエストをマージ: #813 from Takazudo/base/sweep-260906-2-doc-zdtp-050 (406fb79)
ブランチをマージ: 'topic/795-doc-adoption-confirm' → base/sweep-260906-2-doc-zdtp-050 (1f5abd9)
ブランチをマージ: 'topic/795-doc-pin-manifest' → base/sweep-260906-2-doc-zdtp-050 (2fe626b)
ドキュメントで zdtp 0.5.0 を採用 (8026c66)
プルリクエストをマージ: #810 from Takazudo/base/sweep-260906-2-storage-bootstrap (e8edd31)
ブランチをマージ: 'topic/790-storage-bootstrap-confirm' → base/sweep-260906-2-storage-bootstrap (aca17d0)
ストレージ初期化まわりのリグレッションをテストで確認 (1fdb75e)
ブランチをマージ: 'topic/790-readable-gate-probe' → base/sweep-260906-2-storage-bootstrap (be49753)
ブランチをマージ: 'topic/790-astro-ordinal-lifecycle' → base/sweep-260906-2-storage-bootstrap (48a76ab)
Astro のページ遷移をまたいでも生成位置を維持 (2a6672b)
ブランチをマージ: 'topic/790-persisted-spawn-ordinal' → base/sweep-260906-2-storage-bootstrap (03deeaa)
パネルの生成順の番号を保存 (3f1caa3)
プルリクエストをマージ: #805 from Takazudo/base/sweep-260906-2-panel-width-layout (b62b94d)
test: ウォーキングスケルトンをコンパクト表示時の操作に追従 (de19350)
ブランチをマージ: 'topic/783-containment-confirm' → base/sweep-260906-2-panel-width-layout (1cdbb29)
test: 幅レイアウトの VRT 基準画像を更新 (f54695a)
test: コンパクト表示のラベル収まり判定を修正 (777ac84)
ブランチをマージ: 'topic/783-grid-implementation' → base/sweep-260906-2-panel-width-layout (5283cfc)
test: ハイライト切り替えの保存状態を分離して検証 (373239c)
test: カードの収まり判定用フィクスチャをマニフェストとクエリの仕様に合わせる (6345370)
ブランチをマージ: 'topic/783-header-implementation' → base/sweep-260906-2-panel-width-layout (eacf1ef)
test(panel): ヘッダーのポータルと端のヒット判定のアサーションを修正 (8fafedd)
プルリクエストをマージ: #800 from Takazudo/base/sweep-260906-2-docs-consistency (82073a5)
ブランチをマージ: 'topic/780-docs-version-skew-note' → base/sweep-260906-2-docs-consistency (d838cc2)
ブランチをマージ: 'topic/780-readme-section-renumber' → base/sweep-260906-2-docs-consistency (22dd16d)
docs: はじめにのページでリリース間のバージョン差を説明 (b62ffb9)
docs: README のカラープリセット節の番号を振り直し (fb19bed)