5.25.0

5.25.0のリリースノート。

リリース日: 2026-09-16

機能

• siteTreeNavSecondary 設定を追加しました。ここに指定したトップレベルカテゴリは、ホームページのカードグリッドから外れて、コンパクトな二次リンク行に移動します。あわせて「See all tags」リンクもそれに合わせたスタイルに変更しました。CLI やプロンプトでの設定項目はまだないため、スキャフォールド後に設定ファイルを直接編集してください。(42bd642c5)

• HeaderWithDefaultsProps にオプションの sidebarNodes prop を追加しました。ホストは（固定配列、または遅延評価の buildDefault() を受け取るコールバックとして）レンダーごとにモバイルドロワーのサイドバーツリーを上書きできるようになり、Header chrome コンポーネント全体を置き換える必要がなくなりました。(01a7d088d)

• zfb を使わないアセットビューアーのサブパスを追加しました — ./asset-page/{body,components,script}、./asset-index-page、./asset-index-page/{body,tree,script} です。これにより AssetPageBody / AssetIndexPageBody とその resolveAsset*Labels(t, locale) ヘルパーを、ChromeContext や @takazudo/zfb* パッケージなしでインポート・レンダーできます。./asset-page と ./asset-index-page は引き続き zfb に依存したファクトリーのままで、どちらのボディも DocLayout を提供しないため、外側のページシェルは呼び出し側が用意します。(558aa58cf)

• サイト全体のリンクカラールールをパッケージの chrome 全体に適用しました。これまでコンポーネントごとにばらついていたリンクのスタイルが統一されます。地の文のリンクは従来どおりアクセント色＋下線のままで、それ以外のリンクは text-fg（三次的な chrome では text-muted）を基本とし、ホバーとフォーカスでアクセント色になります。地の文と三次的なインラインリンク行以外の静的な下線は削除されました。対象はフッター・パンくず・DocPager（ffef68952）、ナビゲーション用インデックスのリスト・ノートトレイの各部・site-tree-nav のフォーカス（4ed4e2f7d）、ナビゲーション用インデックスのカードグリッド（224232644）、アセットのコントロールと画像キャプションのビューアーリンク（87ee6c1d5）です。これまでのコンポーネント個別のスタイルに依存していた場合、リンク色と下線の見た目が変わります。

バグ修正

• アセットページが、SSR の複数回のレンダー間で prepaint スクリプトの VNode を使い回さないようにしました。これまでは、あるレンダーの prepaint の状態が別のレンダーに漏れる可能性がありました。(9bc892343)

• foundry テーマパックで、リンクカラールールの対応によって消えていたフッターのコピーライト表記の下線を元に戻しました。(dcec0daeb)

その他の変更

• パッケージが所有するルート注入のための .zudo-doc/routes-src プロジェクトローカルなステージング処理を削除しました。これは、node_modules 配下のルートファイルからの virtual:* インポートを zfb が解決できなかった問題への回避策でした。現在の zfb はそれらのインポートを直接解決できるため、公開された routes-src/ ファイルはステージングコピーを経由せずに注入されます。プロジェクトに <project>/.zudo-doc/ ディレクトリが残っている場合、それはすでに無効なので削除できます。(c56b24342)

• @takazudo/zfb、@takazudo/zfb-runtime、@takazudo/zfb-md-wasm の peer dependency の下限を ^2.18.0 に更新しました（e4d4b64b3）。このリリースでは、パッケージが注入するルートとプラグインの仮想モジュールまわりが改良されています。islands スキャナーがプラグインの仮想モジュールを解決できるようになり、パッケージ由来のルートのエントリーポイントが初期値として渡されるようになりました。また、開発時の CSS の content glob が注入されたルートから生成され、注入されたルートのエントリーポイントは実ファイルとしてステージングされて SSR の仮想モジュールから読み込めるようになりました。API・エクスポート・設定のデフォルト値に変更はないため、既存プロジェクトは zfb 2.18.0 を入れる以外の移行作業は不要です。