ルートをパッケージに置く理由

2026年1月12日

ルートとchromeの処理をzudo-docに移し、プロジェクトをコンテンツに集中させる方法。

ホスト側の表面を小さくする

以前のショーケースでは、ページのエントリポイントやコレクションの配線、ドキュメントchromeの一部までルート層を所有していました。そのため、フレームワークの変更が毎回プロジェクトの移行に見えていました。これらの責務を @takazudo/zudo-doc パッケージへ移すことで、ホスト側には小さな設定の接続点とコンテンツツリーだけが残ります。

これは単なるコード整理ではありません。生成されたプロジェクトとショーケースが同じルートの契約を検証するため、パッケージの修正をコピーされたスタブの集まりではなく、実際のサイトでテストできます。ヘッダーナビゲーションガイドはホスト側の設定例として残りますが、その下のルート処理は共有されます。

接続点を意図的に保つ

ホスト側には、サイトの個性を表すもの（設定、翻訳、タグ、必要に応じたchrome binding）が残ります。それ以外をローカルに置くなら、明確な理由が必要です。この境界によってアップグレードの説明が容易になり、新しいプロジェクトにも信頼できる出発点を提供できます。