---
generated_at: 2026-02-27 10:30:00
metrics:
  claims_total: 20
  claims_with_evidence: 19
  claims_without_evidence: 1
confidence_derived: 0.95
---

# 根拠レポート：14-ソースマップ（RawSourceMap）

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.95**
  - 根拠あり：19 / 20、根拠なし：1
- 優先レビュー（高）
  1. **Source Map V3仕様への準拠**：RawSourceMapの構造はV3準拠だが、公式仕様書との照合は行っていない

## 2) 参照した情報（Evidence一覧）

- E-01: `packages/compiler-core/src/codegen.ts` 83-91行目（RawSourceMapインターフェース定義）
- E-02: `packages/compiler-core/src/codegen.ts` 72-81行目（CodegenSourceMapGeneratorインターフェース定義）
- E-03: `packages/compiler-core/src/codegen.ts` 93-100行目（MappingItemインターフェース定義）
- E-04: `packages/compiler-core/src/codegen.ts` 108-113行目（CodegenResult定義、map?: RawSourceMap）
- E-05: `packages/compiler-core/src/codegen.ts` 272-278行目（SourceMapGenerator初期化）
- E-06: `packages/compiler-core/src/codegen.ts` 256-270行目（addMapping関数）
- E-07: `packages/compiler-core/src/codegen.ts` 182-235行目（push()内のマッピング追加ロジック）
- E-08: `packages/compiler-core/src/codegen.ts` 400-405行目（generate関数の戻り値、map.toJSON()）
- E-09: `packages/compiler-core/src/codegen.ts` 63-71行目（TS 5.3 dts生成問題のコメント）
- E-10: `packages/compiler-core/src/codegen.ts` 186-191行目（SimpleExpressionのname検出）
- E-11: `packages/compiler-core/src/codegen.ts` 264行目（column -1のコメント：source-map is 0 based）
- E-12: `packages/compiler-core/src/index.ts` 29行目（RawSourceMapのエクスポート）
- E-13: `packages/compiler-sfc/src/parse.ts` 357-390行目（generateSourceMap関数）
- E-14: `packages/compiler-sfc/src/compileScript.ts` 1094-1101行目（ctx.s.generateMap()）
- E-15: `packages/compiler-sfc/src/compileScript.ts` 1103-1107行目（mergeSourceMaps呼び出し）
- E-16: `packages/compiler-sfc/src/compileStyle.ts` 62-69行目（SFCStyleCompileResults型定義）
- E-17: `packages/compiler-sfc/src/compileStyle.ts` 106-108行目（inMap入力のソースマップ）
- E-18: `packages/compiler-sfc/src/compileTemplate.ts` 44行目（SFCTemplateCompileResultsのmap定義）
- E-19: `packages/compiler-core/src/codegen.ts` 31行目（source-map-jsのimport）

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | RawSourceMapはcodegen.ts 83-91行目で定義されている | E-01 | ○ |
| C-02 | フィールドはversion, sources, names, mappings, file?, sourceRoot?, sourcesContent?の7つ | E-01 | ○ |
| C-03 | CodegenSourceMapGeneratorがSourceMapGeneratorをラップしている | E-02, E-19 | ○ |
| C-04 | _sources, _names, _mappingsのプライベートプロパティに直接アクセスしている | E-02, E-06 | ○ |
| C-05 | パフォーマンス最適化のためにプライベートプロパティを使用 | E-06（256-259行目のコメント） | ○ |
| C-06 | MappingItemはsource, generatedLine/Column, originalLine/Column, nameで構成 | E-03 | ○ |
| C-07 | CodegenResult.mapとしてRawSourceMapが出力される | E-04 | ○ |
| C-08 | sourceMapオプションがtrueで__BROWSER__でない場合にSourceMapGeneratorが生成される | E-05 | ○ |
| C-09 | setSourceContentでソースコードが設定される | E-05（276行目） | ○ |
| C-10 | push()内でノードのloc情報に基づきaddMappingが呼ばれる | E-07 | ○ |
| C-11 | SimpleExpressionのisStaticでない場合に_ctx.プレフィックスを除去してnameが設定される | E-10 | ○ |
| C-12 | source-mapのcolumnは0ベースなのでVueの1ベースから-1する | E-11 | ○ |
| C-13 | generate関数の戻り値でmap.toJSON()が呼ばれる | E-08 | ○ |
| C-14 | TS 5.3のdts生成問題回避のためソースマップ型をインライン定義している | E-09 | ○ |
| C-15 | SFCのparse関数ではgenerateSourceMap関数でブロック単位のソースマップを生成する | E-13 | ○ |
| C-16 | compileScriptではMagicStringのgenerateMapでソースマップを生成する | E-14 | ○ |
| C-17 | script setupとtemplateのソースマップをmergeSourceMapsでマージする | E-15 | ○ |
| C-18 | compileStyleではRawSourceMap型でmap出力される | E-16 | ○ |
| C-19 | RawSourceMap型はcompiler-core/src/index.tsからエクスポートされている | E-12 | ○ |
| C-20 | Source Map V3仕様に準拠している | **根拠なし**（ソースコード内に仕様参照の記載なし） | △ |

## 4) 不足情報（Unknown / Missing）
- Source Map V3仕様書への明示的な参照がソースコード内に記載されていない。RawSourceMapの構造がV3に準拠していることは構造の一致から推測しているが、公式仕様との照合は行っていない
  - 候補：Source Map Revision 3 Proposal / source-map-jsライブラリのドキュメント

## 5) リスクフラグ（レビュー観点）
- 0: RawSourceMapの型定義はソースコードに明確に記述されており低リスク
- 0: generate関数でのソースマップ生成フローはコードコメントとともに明確であり低リスク
- 1: TS 5.3のdts生成問題に関する記述はコメントに基づくが、将来のTSバージョンで変更される可能性があり中リスク
- 0: パフォーマンス最適化（プライベートプロパティ直接アクセス）はコメントで意図が明記されており低リスク

## 6) レビュアーチェックリスト（最小）
- [ ] RawSourceMapインターフェースの7フィールドがcodegen.ts 83-91行目と一致しているか確認
- [ ] addMapping関数のcolumn -1処理がcodegen.ts 264行目と一致しているか確認
- [ ] generate関数の戻り値でmap.toJSON()が呼ばれていることをcodegen.ts 404行目で確認
- [ ] parse.tsのgenerateSourceMap関数の行ループロジックが357-390行目と一致しているか確認
- [ ] compileScript.tsのmergeSourceMaps呼び出しが1103-1107行目と一致しているか確認
