---
generated_at: 2026-02-27 12:00:00
metrics:
  claims_total: 69
  claims_with_evidence: 64
  claims_without_evidence: 5
confidence_derived: 0.93
---

# 根拠レポート：API設計書

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：64 / 69、根拠なし：5
- 優先レビュー（高）
  1. **C-65 SSRContext型定義の詳細フィールド**：内部型のため完全な仕様が変動する可能性
  2. **C-66 renderToStream非推奨の理由**：ソースコードのコメントから推測
  3. **C-67 CustomElementOptionsのデフォルト値**：ソースコードの暗黙的挙動から推測
  4. **C-68 useIdの出力形式**：実装詳細に依存し将来変更される可能性
  5. **C-69 defineAsyncComponentのデフォルトdelay値**：ソース上のデフォルト値は確認したが公式ドキュメントとの完全照合は未実施

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `packages/reactivity/src/index.ts` — reactivityパッケージのエクスポート定義
- E-02: `packages/reactivity/src/ref.ts` — ref, shallowRef, isRef, unref, toValue, toRef, toRefs, triggerRef, customRef等の実装
- E-03: `packages/reactivity/src/reactive.ts` — reactive, shallowReactive, readonly, shallowReadonly, isReactive, isReadonly, isShallow, isProxy, toRaw, markRaw等の実装
- E-04: `packages/reactivity/src/computed.ts` — computed, ComputedRefImpl等の実装
- E-05: `packages/reactivity/src/effect.ts` — effect, stop, ReactiveEffect, pauseTracking, enableTracking, resetTracking, onEffectCleanup等の実装
- E-06: `packages/reactivity/src/effectScope.ts` — effectScope, EffectScope, getCurrentScope, onScopeDispose等の実装
- E-07: `packages/reactivity/src/watch.ts` — watch, getCurrentWatcher, onWatcherCleanup, traverse等の実装
- E-08: `packages/reactivity/src/dep.ts` — track, trigger, ITERATE_KEY等の実装
- E-09: `packages/reactivity/src/constants.ts` — TrackOpTypes, TriggerOpTypes, ReactiveFlags等のenum定義
- E-10: `packages/runtime-core/src/index.ts` — runtime-coreパッケージのエクスポート定義
- E-11: `packages/runtime-core/src/apiComputed.ts` — runtime-core版computedの実装
- E-12: `packages/runtime-core/src/apiWatch.ts` — watch, watchEffect, watchPostEffect, watchSyncEffect等の実装
- E-13: `packages/runtime-core/src/apiLifecycle.ts` — ライフサイクルフック群の実装
- E-14: `packages/runtime-core/src/apiInject.ts` — provide, inject, hasInjectionContext等の実装
- E-15: `packages/runtime-core/src/scheduler.ts` — nextTick, queuePostFlushCb等の実装
- E-16: `packages/runtime-core/src/apiDefineComponent.ts` — defineComponent等の実装
- E-17: `packages/runtime-core/src/apiAsyncComponent.ts` — defineAsyncComponent等の実装
- E-18: `packages/runtime-core/src/apiSetupHelpers.ts` — defineProps, defineEmits, defineExpose, defineOptions, defineSlots, defineModel, withDefaults, useSlots, useAttrs等の実装
- E-19: `packages/runtime-core/src/h.ts` — h関数の実装
- E-20: `packages/runtime-core/src/vnode.ts` — createVNode, cloneVNode, mergeProps, isVNode等の実装
- E-21: `packages/runtime-core/src/renderer.ts` — createRenderer, createHydrationRenderer等の実装
- E-22: `packages/runtime-core/src/component.ts` — getCurrentInstance等の実装
- E-23: `packages/runtime-core/src/components/Teleport.ts` — Teleportコンポーネントの実装
- E-24: `packages/runtime-core/src/components/Suspense.ts` — Suspenseコンポーネントの実装
- E-25: `packages/runtime-core/src/components/KeepAlive.ts` — KeepAliveコンポーネントの実装
- E-26: `packages/runtime-core/src/hydrationStrategies.ts` — hydrateOnIdle, hydrateOnVisible, hydrateOnMediaQuery, hydrateOnInteraction等の実装
- E-27: `packages/runtime-core/src/helpers/useModel.ts` — useModel等の実装
- E-28: `packages/runtime-core/src/helpers/useTemplateRef.ts` — useTemplateRef等の実装
- E-29: `packages/runtime-core/src/helpers/useId.ts` — useId等の実装
- E-30: `packages/runtime-core/src/directives.ts` — withDirectives等の実装
- E-31: `packages/runtime-core/src/helpers/resolveAssets.ts` — resolveComponent, resolveDirective, resolveDynamicComponent等の実装
- E-32: `packages/runtime-dom/src/index.ts` — runtime-domパッケージのエクスポート定義（createApp, createSSRApp, render, hydrate等）
- E-33: `packages/runtime-dom/src/components/Transition.ts` — Transitionコンポーネントの実装
- E-34: `packages/runtime-dom/src/components/TransitionGroup.ts` — TransitionGroupコンポーネントの実装
- E-35: `packages/runtime-dom/src/directives/vShow.ts` — vShowディレクティブの実装
- E-36: `packages/runtime-dom/src/directives/vModel.ts` — vModelText, vModelCheckbox, vModelRadio, vModelSelect, vModelDynamic等の実装
- E-37: `packages/runtime-dom/src/directives/vOn.ts` — withModifiers, withKeys等の実装
- E-38: `packages/runtime-dom/src/apiCustomElement.ts` — defineCustomElement, defineSSRCustomElement, VueElement, useHost, useShadowRoot等の実装
- E-39: `packages/runtime-dom/src/helpers/useCssModule.ts` — useCssModule等の実装
- E-40: `packages/runtime-dom/src/helpers/useCssVars.ts` — useCssVars等の実装
- E-41: `packages/compiler-core/src/index.ts` — compiler-coreパッケージのエクスポート定義
- E-42: `packages/compiler-core/src/compile.ts` — baseCompile等の実装
- E-43: `packages/compiler-core/src/parse.ts` — baseParse等の実装
- E-44: `packages/compiler-core/src/transform.ts` — transform, createTransformContext, traverseNode等の実装
- E-45: `packages/compiler-core/src/codegen.ts` — generate等の実装
- E-46: `packages/compiler-dom/src/index.ts` — compiler-domパッケージのエクスポート定義（compile, parse等）
- E-47: `packages/compiler-sfc/src/index.ts` — compiler-sfcパッケージのエクスポート定義
- E-48: `packages/compiler-sfc/src/parse.ts` — SFC parse等の実装
- E-49: `packages/compiler-sfc/src/compileScript.ts` — compileScript等の実装
- E-50: `packages/compiler-sfc/src/compileTemplate.ts` — compileTemplate等の実装
- E-51: `packages/compiler-sfc/src/compileStyle.ts` — compileStyle, compileStyleAsync等の実装
- E-52: `packages/compiler-ssr/src/index.ts` — compiler-ssrパッケージのエクスポート定義（compile等）
- E-53: `packages/server-renderer/src/index.ts` — server-rendererパッケージのエクスポート定義
- E-54: `packages/server-renderer/src/renderToString.ts` — renderToString等の実装
- E-55: `packages/server-renderer/src/renderToStream.ts` — renderToNodeStream, pipeToNodeWritable, renderToWebStream, pipeToWebWritable, renderToSimpleStream等の実装
- E-56: `packages/shared/src/index.ts` — sharedパッケージのエクスポート定義
- E-57: `packages/vue/src/index.ts` — vueメインパッケージのエクスポート定義
- E-58: `packages/reactivity/src/arrayInstrumentations.ts` — reactiveReadArray, shallowReadArray等の実装
- E-59: `packages/compiler-core/src/ast.ts` — AST型定義、AST作成関数群
- E-60: `packages/compiler-core/src/runtimeHelpers.ts` — ランタイムヘルパーシンボル定義

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | ref関数のシグネチャと戻り値型 | E-02 | ○ |
| C-02 | shallowRefのシャロートラッキング動作 | E-02 | ○ |
| C-03 | isRefの型ガード機能 | E-02 | ○ |
| C-04 | unrefのシュガー関数としての動作 | E-02 | ○ |
| C-05 | toValueがgetter関数も呼び出す | E-02 | ○ |
| C-06 | toRefの3つのオーバーロード | E-02 | ○ |
| C-07 | toRefsの分割代入リアクティビティ保持 | E-02 | ○ |
| C-08 | triggerRefがshallowRefのエフェクトをトリガー | E-02 | ○ |
| C-09 | customRefのfactoryシグネチャ | E-02 | ○ |
| C-10 | reactiveの深い変換動作 | E-03 | ○ |
| C-11 | shallowReactiveのルートレベルのみリアクティブ | E-03 | ○ |
| C-12 | readonlyの深い読み取り専用プロキシ | E-03 | ○ |
| C-13 | shallowReadonlyのシャロー動作 | E-03 | ○ |
| C-14 | isReactive/isReadonly/isShallow/isProxyの各判定ロジック | E-03 | ○ |
| C-15 | toRawがプロキシから元オブジェクトを返す | E-03 | ○ |
| C-16 | markRawがプロキシ変換を防止する | E-03 | ○ |
| C-17 | computedのキャッシュ動作と2つのオーバーロード | E-04 | ○ |
| C-18 | effect関数のシグネチャと自動再実行 | E-05 | ○ |
| C-19 | stop関数によるエフェクト停止 | E-05 | ○ |
| C-20 | effectScopeのrun/stop/pause/resumeメソッド | E-06 | ○ |
| C-21 | getCurrentScopeとonScopeDisposeの動作 | E-06 | ○ |
| C-22 | watchの3引数シグネチャとWatchHandle戻り値 | E-07 | ○ |
| C-23 | trackとtriggerのシグネチャ | E-08 | ○ |
| C-24 | TrackOpTypes/TriggerOpTypes/ReactiveFlags enum値 | E-09 | ○ |
| C-25 | createAppのシグネチャとApp戻り値 | E-32 | ○ |
| C-26 | createSSRAppのハイドレーション対応 | E-32 | ○ |
| C-27 | h関数の多数のオーバーロード | E-19 | ○ |
| C-28 | nextTickのPromise戻り値 | E-15 | ○ |
| C-29 | defineComponentの2つの主要オーバーロード | E-16 | ○ |
| C-30 | defineAsyncComponentのオプション（loader, delay, timeout等） | E-17 | ○ |
| C-31 | defineProps/defineEmits/defineExposeのコンパイラマクロとしての性質 | E-18 | ○ |
| C-32 | defineModelのv-model双方向バインディング | E-18 | ○ |
| C-33 | withDefaultsのシグネチャ | E-18 | ○ |
| C-34 | provide/injectの依存性注入メカニズム | E-14 | ○ |
| C-35 | useTemplateRefの読み取り専用ShallowRef戻り値 | E-28 | ○ |
| C-36 | useIdのstring戻り値 | E-29 | ○ |
| C-37 | ライフサイクルフック群のタイミングと共通シグネチャ | E-13 | ○ |
| C-38 | onErrorCapturedのfalse戻り値によるエラー伝播停止 | E-13 | ○ |
| C-39 | watch(runtime-core版)のflushオプション | E-12 | ○ |
| C-40 | watchEffect/watchPostEffect/watchSyncEffectの各flushデフォルト | E-12 | ○ |
| C-41 | hydrateOnIdle/hydrateOnVisible/hydrateOnMediaQuery/hydrateOnInteractionの各戦略 | E-26 | ○ |
| C-42 | createRenderer/createHydrationRendererの戻り値構造 | E-21 | ○ |
| C-43 | Transitionコンポーネントのprops一覧 | E-33 | ○ |
| C-44 | TransitionGroupのtagプロパティとFLIPアニメーション | E-34 | ○ |
| C-45 | vShowのdisplayスタイル切り替え動作 | E-35 | ○ |
| C-46 | vModelText/vModelCheckbox/vModelRadio/vModelSelect/vModelDynamicの対象要素とModifier | E-36 | ○ |
| C-47 | withModifiersのサポートModifier一覧 | E-37 | ○ |
| C-48 | withKeysのキーModifierフィルタ | E-37 | ○ |
| C-49 | defineCustomElementのVueElementConstructor戻り値 | E-38 | ○ |
| C-50 | useHost/useShadowRootの戻り値型 | E-38 | ○ |
| C-51 | useCssModuleの$styleデフォルト値 | E-39 | ○ |
| C-52 | baseCompileのパース→変換→コード生成パイプライン | E-42 | ○ |
| C-53 | baseParseのRootNode戻り値 | E-43 | ○ |
| C-54 | transformのAST in-place変更 | E-44 | ○ |
| C-55 | generateのCodegenResult戻り値構造 | E-45 | ○ |
| C-56 | compile(DOM版)のDOM固有トランスフォーム適用 | E-46 | ○ |
| C-57 | parse(SFC版)のSFCDescriptor戻り値 | E-48 | ○ |
| C-58 | compileScriptのマクロ処理・TypeScript型解析 | E-49 | ○ |
| C-59 | compileTemplateのレンダー関数コード生成 | E-50 | ○ |
| C-60 | compileStyle/compileStyleAsyncのスコープ付きCSS対応 | E-51 | ○ |
| C-61 | compile(SSR版)のssr:true強制設定と固有トランスフォーム | E-52 | ○ |
| C-62 | renderToStringのPromise<string>戻り値 | E-54 | ○ |
| C-63 | renderToNodeStream/pipeToNodeWritable/renderToWebStream/pipeToWebWritableの各ストリームAPI | E-55 | ○ |
| C-64 | パッケージ構成と再エクスポートの階層関係 | E-01, E-10, E-32, E-57 | ○ |
| C-65 | SSRContextの teleports フィールドの詳細仕様 | E-53 | △ |
| C-66 | renderToStreamが非推奨である理由 | E-55 | △ |
| C-67 | CustomElementOptionsのshadowRootデフォルトtrue | E-38 | △ |
| C-68 | useIdの出力形式 `v-{instanceId}{counter}` | E-29 | △ |
| C-69 | defineAsyncComponentのdelay デフォルト200ms | E-17 | △ |

## 4) 不足情報（Unknown / Missing）
- SSRContext型の内部フィールド（`__teleportBuffers`, `__watcherHandles`）は`@internal`マーク付きのため、将来のバージョンで変更される可能性がある
  - 候補：Vue公式リリースノート / CHANGELOG.md / SSR Guide
- renderToStreamの非推奨化の正確な経緯はソースコード内の`@deprecated`タグに基づくが、公式マイグレーションガイドとの照合は未実施
  - 候補：Vue 3 SSR Migration Guide / CHANGELOG.md
- CustomElementOptionsのshadowRootデフォルト値はソースコードの条件分岐から推測したが、明示的なデフォルト値指定は確認していない
  - 候補：Vue公式ドキュメント Custom Elements ガイド
- useIdの出力形式はソースコードの実装から読み取ったが、公開APIとして保証されているかは未確認
  - 候補：Vue公式ドキュメント useId API
- defineAsyncComponentのdelay 200msはソースコード内のデフォルト値から確認したが、公式ドキュメントとの完全照合は未実施
  - 候補：Vue公式ドキュメント Async Components Guide

## 5) リスクフラグ（レビュー観点）
- 0: パッケージ構成とAPIのエクスポート階層 — ソースコードのindex.tsから直接確認
- 0: リアクティビティAPI群のシグネチャと動作 — ソースコードの実装から直接確認
- 0: ライフサイクルフック群のタイミング — 既知のVue 3仕様と一致
- 1: SSR関連APIの一部内部型定義 — 内部型のため変動の可能性あり
- 1: カスタム要素関連のデフォルト値 — ソースコードの暗黙的挙動に依存
- 0: コンパイラAPI群のシグネチャ — ソースコードから直接確認

## 6) レビュアーチェックリスト（最小）
- [ ] SSRContext型の詳細フィールドが現行バージョンのソースと一致するか確認
- [ ] defineAsyncComponentのdelayデフォルト値が公式ドキュメントと一致するか確認
- [ ] CustomElementOptionsのshadowRootデフォルト値の正確性を確認
- [ ] useIdの出力形式が公開API保証されているか公式ドキュメントで確認
- [ ] コンパイラ内部API（コンパイラ生成コード向けヘルパー）の網羅性が十分か確認
