5.14.0

5.14.0のリリースノート。

リリース日: 2026-08-31

機能

• public/assets/ 配下のファイルに対応する設定可能なアセットビューアーを追加しました。ファイル種別ごとのビューページ、元ファイルの表示・ダウンロード、リンク元のコンテキストに加え、assetViewerDir、assetViewerRoutePrefix、assetViewerExclude の各設定を利用できます。 (45dc50cdb, 19b8f0599, e6e77f790)

• Markdownリンク、Asset・AssetCodeコンポーネント、画像キャプションのリンクからアセットページを開ける執筆用エントリーポイントを追加しました。ビューアー用URLの安全なパス生成とコード抜粋にも対応しています。 (2b74f1da2, 6f22ebb97, b883bff41)

• /files/ にオプトインのアセットインデックスを追加しました。ネイティブな入れ子の開閉、ファイル種別アイコン、ビューワーへのリンク、ファイル情報、開閉状態の保持、assetViewerIndex 設定に対応しています。 (debdd3cf8, bbf10483b, 177028439)

• 並行する開発タスク向けに、パッケージが提供する run-parallel コマンドを追加しました。シグナル転送、子孫プロセスの終了、実際の失敗コードの伝播に対応し、npm-run-all2 を置き換えます。 (9402ff157, 3ebfa6e9c, dab5d7e07)

• YAML 1.2での解析とYAML 1.1に安全なシリアライズを行う、公開の @takazudo/zudo-doc/frontmatter 解析・書き出しヘルパーを追加しました。これにより、gray-matter と js-yaml 3の依存チェーンを削除しました。 (c07422672, 49cfb1895, bd8ad5be9)

バグ修正

• アクティブなヘッダーナビ項目がオーバーフローメニューへ移動しても選択状態を保ち、表示中の aria-current="page" が常に1つになるようにしました。 (81582a042)

• ツリーナビゲーション行の意図した右余白を復元しました。 (fa6a2074d)

• プロジェクトが一部のロケール翻訳だけを上書きした場合でも、アセットインデックスのパッケージ既定翻訳を保持するようにしました。 (0b1958562)

• アセットインデックスの開閉セマンティクスをネイティブのまま維持し、リーフファイルのアイコンを先頭の操作列に揃えました。 (295b3d8d0, 35356dad4)

その他の変更

• 有効なアセットビューアールートは、defaultLocaleOnlyPrefixesに/${assetViewerRoutePrefix}/を明示してオプトアウトしない限り、既存の複数ロケール利用者でもパッケージ更新後に自動でローカライズされます。一方、従来のClaude/Codexリソースプレフィックスを設定に明示している既存アプリは、更新後もそれらのページがデフォルトロケール限定のままです。すべての設定済みロケールに生成したいリソースセクションのプレフィックスを削除してください。 (#3820)

• 移行時の注意：5.14.0でビルドする前に、ジェネレーターの生成先にある手書きのロケールリソース概要／カテゴリindex.mdxを削除または名前変更し、独自のタイトル、説明、ラベルはZudoDocConfig.translationsで表現してください。frontmatterにgenerated: trueがない既存ファイルは、ジェネレーターが上書きを拒否します。 (#3820)

• zfbピアファミリーを2.14.0、@takazudo/zdtp を0.4.14、doc-history-serverのピア下限を5.13.1へ更新しました。 (dbe8553c7, 038870c94, 95a82f15f)