0.2.0
0.2.0のリリースノート。
リリース日: 2026-06-09
0.2.0系列の最初の安定版リリースです。0.2.0-next.1〜0.2.0-next.9のプレリリース系列を安定版へ昇格させ、npmのlatest dist-tagを0.1.0から0.2.0へ切り替えます。これにより、タグ指定なしのnpm install / pnpm dlx create-zudo-docが0.2.0系列を解決するようになります。@takazudo/zudo-doc、@takazudo/zudo-doc-history-server、create-zudo-docはロックステップで同時にリリースされます。以下はプレリリース系列の主な変更点の集約です。詳細は各0.2.0-next.Nのノートを参照してください。
破壊的変更
非推奨だった
colorTweakPanel設定エイリアスを削除。src/ではconfig/ settings. ts designTokenPanelを使用してください。colorTweakPanelを設定しても効果はなくなりました（#1862）。@takazudo/zudo-docから未使用の公開API残骸を3つ削除（#1866）:DesignTokenTweakPanelテーマスタブ（パネルUIは@takazudo/zdtpにあります）、VersionSwitcherPropsの無効化されたdisableInlineVisibilityStyleプロパティ、TocItem型エイリアス（HeadingItemを使用してください）。非推奨だった
ai-chat-workerパッケージを削除。 AIチャットAPIはSSRの/エンドポイントで提供されます。スタンドアロンのCloudflare Workerパッケージは削除されました。api/ ai- chat
機能
@takazudo/サブパスエクスポート。 共有アイコンモジュールを専用のサブパスエクスポートとして提供し、フレームワーク全体で採用しました。生成されたプロジェクトはnpmからzudo- doc/ icons @takazudo/を直接importします（#1906）。zudo- doc/ icons index.mdxフロントマターによるカテゴリメタデータ。 claude-resourcesジェネレーターが_category_.jsonサイドカーの代わりにcategory_no_page/sidebar_positionフロントマターを持つindex.mdxを出力するようになり、公開パッケージ利用者で発生していたunsupported data-file extensionビルド警告を解消しました（#1980、#1978、#1985）。パッケージ生成のCSSセーフリスト。
@takazudo/zudo-docがビルド時にdist/を生成しsafelist. css .エクスポートで公開するため、下流プロジェクトのTailwind v4ビルドが動的クラスを保持します（#1993、#1994）。/ safelist. css 正規のルートドキュメントURL
/。 ルートのドキュメントページがオプショナルキャッチオールルート経由で正規のdocs/ /に配信されます。検索・llms.txt・doc-historyはすべてベアルートを一貫して正規化します（#1891）。docs/ 汎用的なバージョン付き＋ロケールルーティング。 バージョン付きの非デフォルトロケールページがハードコードされた
jaパスではなく/を経由するようになりました。v/ {version}/ {locale}/ docs/ . . . 階層的なTOC見出しID。 zfbの階層的な見出しID戦略とslugifyを採用し、TOCアンカーがレンダリングされた見出しと一致するようにしました。TOCの深さは設定可能です（#1943、#1946）。
noUncheckedIndexedAccessを全体で有効化 — ルートtsconfig、packages/zudo-doc、各スタンドアロンパッケージ、create-zudo-docテンプレートで有効にし、新規スキャフォルドがより厳密なガードを継承するようにしました。非デモ環境向けにAIチャットAPIを強化。 オリジン許可リスト、グローバルな1日あたりリクエスト上限、システムコーパスブロックのプロンプトキャッシュを追加し、デモ以外でも安全かつ低コストに配置できるようにしました（#1889）。
OGPメタタグ。
HeadWithDefaultsがog:type・og:url・og:site_nameを出力します（#1975）。b4push / CIパリティメタチェック。 ローカルの
b4pushとCIゲート間の暗黙的なドリフトを検出するガードを追加し、fixture-drift・tags-audit・design-token-lintをpr-checks.ymlに組み込みました（#1967、#1982）。
バグ修正
HTML Previewが正しい縦積みレイアウトでハイドレートされるように。 アイランドの二重ラップ（Astro→zfb移行の回帰）を修正し、ホスト・テンプレート・既存の下流スキャフォルドが呼び出し側の変更なしでタイトルバー／プレビュー／コードの積み重ねにハイドレートされるようにしました（#1925）。
CategoryNavがno-pageカテゴリでデッドリンクを生成しないように。
categories=モードで、category_no_pageカードがカテゴリの最初のルーティング済み子孫へリンクするように（到達可能なページがなければスキップ）。CIのcheck:linksはb4pushに合わせて厳格（--strict-broken）になりました（#1985）。doc-historyの正確性。 gitコマンドがリポジトリルートをCWDとして実行され、CIがクリーンなリポジトリルート相対の
--content-dirを渡し、generateコマンドが部分的なgit失敗時にfail loud（非ゼロ終了）するようになり、ジェネレーターのセマフォのデッドロックを修正しました（#1907、#1913）。/ルートでのバージョン付きドキュメントのリンクと表示の正確性, バージョン付きロケールページのローカライズされたナビと履歴／クロスリンクの解決を含みます（#1916、#1909）。v/ doc-historyのpostBuildをオプトインに（
GEN_DOC_HISTORY=1）。これにより、素のpnpm buildが大規模コーパスでzfbのpostBuild予算を超過するリスクがなくなりました。CIと開発には影響しません（#1986）。nav-source-cacheのメモ化が正当に
undefinedとなる結果をキャッシュヒットとして登録するように（sub.has(key)）。またAIチャットの監査ログキーが同一ミリ秒の衝突を避けるためcrypto.randomUUID()を使用するようにしました。スキャフォルドテンプレートのパリティ修正 — sidebar-toggle / theme-toggleテンプレート、
zudo-docdist向けの@source＋インライン化したセーフリスト、実際のクライアントルーターブートストラップ、新しいvsp-3xs/shadow-lgトークンにまたがる修正（#1991、#1990）。
パフォーマンス
doc-history。 N+1のgit spawnをバッチ呼び出しに集約し、新しい非同期パス経由でgit履歴の探索を並列化して、大規模ドキュメントセットでのビルド時間を短縮しました（#1875、#1930）。
ナビゲーションキャッシュ。 ナビソースとナビツリーを同一性メモ化し、冗長な再計算を削減しました（#1902）。
セキュリティ
pnpm auditの全31件の脆弱性勧告を解消（31 → 0）。pnpm.overridesと直接バンプによる開発／ビルドツール推移依存の監査駆動クリーンアップ。vitest3 → ^4.1.0（クリティカルな勧告に3.x系の修正がないため）を含みます。typecheck・全ユニット／パッケージスイート・本番ビルドでグリーンを確認済み（a5010712）。
その他の変更
新しいリリースパイプライン＋ロックステップバージョニング。 3つの公開パッケージが同時に動き、新規スキャフォルドプロジェクトが対応する
@takazudo/zudo-doc/@takazudo/zudo-doc-history-serverリリースをpinします。プレリリースはnext、安定版はlatestで公開されます。design-token-lintを移行 — ベンダリングされた
file:依存から公開済みの@takazudo/npmパッケージへ。zudo- design- token- lint@^1. 0. 0 design-token-lintのbin名は変更ありません（#1863）。zfbをバンプ — ホストとジェネレーターのpinをプレリリース系列を通して
0.1.0-next.35まで（CSSパイプライン、islandsスキャナー、コンテンツ内のベアな#anchor解決の修正）。ドキュメントドリフトの一掃＋デッドコード削除 — 設定・ドキュメント・孤立したAstro→zfbホストファイルにまたがる整理に加え、型安全性のリファクタリングとバージョン付きルート／非同期doc-historyパスの振る舞いテストを追加しました。