5.0.0

5.0.0のリリースノート。

リリース日: 2026-08-04

破壊的変更

• @takazudo/zfb ファミリーの peer 範囲が ^1.1.0 から ^2.1.0 に移行しました。利用側は @takazudo/zfb、@takazudo/zfb-md-wasm、@takazudo/zfb-runtime をまとめて更新する必要があります。@takazudo/design-token-lint も 1.x から 2.x に移行します (d23e47a8, fb91919f)

• githubAutolinks 機能と githubAutolinksRepo 設定を削除しました。githubAutolinksRepo を渡し続けているプロジェクトは、黙って無視されるのではなく実行時に明示的なエラーになります。設定シムも zfb 2.0.0 で削除された githubAutolinks キーを同様に拒否します (3d4a8ca7, 4c03befc, 255676da)

• 本リポジトリの設定で strictContentBridge を有効化し、b4push/CI の配線を張り替えました。コンテンツブリッジのフォールバックは、許可リスト方式の b4push ステップだけでなく、素の pnpm build でも失敗するようになります (#3234, d3035f68)

• 共有ベース tsconfig の JSX モードを react-jsx + jsxImportSource: preact に変更し、生成プロジェクトの devDependencies から @types/react を削除しました。React の型定義が存在することに依存していたプロジェクトは、明示的に追加し直してください (#3182, 705c3957, be91c050)

機能

• デスクトップ TOC の表示切り替え — 新しい tocToggle 設定により、prepaint 対応の目次の表示/非表示コントロールが追加されました。ジェネレーター、ショーケース、サイドバーフィクスチャに配線され、e2e テストも追加されています。適用範囲はデフォルト TOC のページに限定されます (c5a26102, 3f851196, ed1f6887, 304ce68d, 409b0bfe, 5301b011)

• entryDocSlug と headerNav のバージョン対応設定フィールドを追加しました。バージョン管理されたサイトが入口ドキュメントを指定し、ヘッダーナビゲーションにバージョン文脈を引き回せるようになります (#3217, 0d42ffbd, e56c4dee)

• バージョンスイッチャーが SPA ナビゲーションをまたいで disabled 状態を再計算するようになりました。各ページが未提供バージョンのペイロードを差し替え後のコンテンツに埋め込み、スイッチャーは after-swap で再配線されます (faa0e8aa, d2a3fccf)

• GFM のタスクリストと脚注をプリセットのデフォルトとして有効化しました (31c1f253)

• strictContentBridge をシェルのパススルーフィールドとして追加し、下流プロジェクトが自身の設定から strict content bridge を有効化できるようにしました (725febec, c1432ffa)

• テーマパックに、fixed-attachment レイヤー向けのカタログ全体の (pointer: coarse) スクロールフォールバックを追加しました。またパックのバリデーターがトップレベルの @media でラップされたパックスコープのルールを受け付けるようになりました (ee973b27, 594b0486)

• create-zudo-doc がベーステンプレートにデフォルトの public/ favicon セットを同梱し、.ico/.png より前に SVG favicon のリンクを出力するようになりました (a9d100bc, 19d11f8d)

• safelist チェッカーに safelist-ok マーカーによるエスケープハッチと、実態に即した修正手順の表示を追加しました (150925a4)

バグ修正

• デスクトップ TOC の sticky スクロール追従を復旧し、e2e のリグレッションガードを追加しました (ab25912a, ac7d3fc0)

• バージョンの提供状況を近似ではなく実際のルート生成に基づいて算出し、両方のバージョンスイッチャーで unavailableVersions を計算するようにしました (01409a94, a820304b)

• バージョン提供状況のペイロードが存在しない場合、disabled 状態をクリアせずそのまま保持するようにしました。またスイッチャーの再配線を DOMContentLoaded まで遅延させました (6593e0c0, d5d6b586)

• CategoryNav / CategoryTreeNav / SiteTreeNav のラッパーに currentVersion を引き回し、バージョン管理されたサイトのナビカードのリンクが正しくなるようにしました (ddeaa6da)

• バージョンページで entryDocSlug を任意かつロケール対応にしました (20890f21)

• zfb 設定シムが形状を手作業でコピーする代わりに zfb/config を再エクスポートするようにし、シム形状の検証を部分文字列一致から AST ベースに変更して、3 つの見逃し経路を塞ぎました (#3239, #3241, 213f4e5a, ea109c66, 70ad667c)

• バージョニングの deps/node シェイプについて公開 API の後方互換性を復旧しました (416baef2)

• claude-resources がビルドディレクトリをトップレベルだけでなく任意の深さでベース名により除外するようにしました (6e830dc4)

• 区切り文字のない長いインラインコード識別子が、はみ出さずに折り返されるようになりました (62679947)

• island のマーカー名衝突を避けるため、TOC island のヘルパーをリネームしました (7c29a6ca)

• パックした tarball を使う slow フィクスチャで、パッケージ専用の依存を解決できるようにしました (df23d982)

その他の変更

• Academia テーマパックの可読性調整 — 通常状態のリンク下線を低不透明度にし、コードブロックを 0.9rem にしました (8dbb8f46)

• CLAUDE.md の階層構造を再編し、そのリファクタリングの自己レビューで見つかった 7 件の記述誤りを修正しました (#3167, fd2124ba, ed8917a4)

• リポジトリのクリーンアップ — 未使用の依存 6 件と不要ファイル 2 件を削除し、パッケージ側に置き換わったホスト側ソースを削除、完了済みエピックのスクラッチ/レポートディレクトリを削除、README・設定・b4push スキルの古い参照を修正しました (332c8406, 6d2f90dd, a40bc5fd, c035c76d, 7869d45b)

• Tauri Mode 1 の CSP 検証結果を記録し、Tauri ドキュメントでアイコンの前提条件をビルドコマンドより前に配置しました (4a45c00f, 532eb81e, 8a93286e)

• テストカバレッジ: version-link 系のドッグフーディングスナップショットと e2e フィクスチャ/スペック、バージョンスイッチャーの disabled 状態に対する SPA ナビゲーションガード、見出し・タスクリスト・脚注・ディレクティブを含むよう拡張した A2 フィクスチャ、ターゲットマニフェストフィクスチャへの favicon セットの反映 (#3219, #3245, 1a73989b, fab8568d, 0310c8fb, 94e09ceb)

• content-fallback ガードの配線、e2e のフィクスチャセットアップに関する記述、safelist-ok の例についてドキュメントを修正しました (9047c389, 2bb9a1e1, 70d69842, 66ad3101, 100761b3)