---
generated_at: 2026-02-22 10:30:00
metrics:
  claims_total: 35
  claims_with_evidence: 33
  claims_without_evidence: 2
confidence_derived: 0.94
---

# 根拠レポート：Avalonia.HarfBuzz 単体テストケース一覧

## 本レポートについて

### 目的
本レポートは、生成された単体テストケース一覧の信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.94**
  - 根拠あり：33 / 35、根拠なし：2
- 優先レビュー（高）
  1. **UT-HFB-025**：複数回Dispose時の挙動（HarfBuzzSharpの内部実装依存）
  2. **UT-HFB-035**：GetContainingMemoryの例外ケース（理論上到達不能な可能性）

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

- E-01: `src/HarfBuzz/Avalonia.HarfBuzz/HarfBuzzTextShaper.cs` (237行)
- E-02: `src/HarfBuzz/Avalonia.HarfBuzz/HarfBuzzApplicationExtensions.cs` (27行)
- E-03: `src/HarfBuzz/Avalonia.HarfBuzz/HarfBuzzTypeface.cs` (64行)
- E-04: `src/HarfBuzz/Avalonia.HarfBuzz/Avalonia.HarfBuzz.csproj` (プロジェクト設定)

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | ShapeTextが有効なテキストを正しくシェイプする | E-01 (L23-115) | ○ |
| C-02 | 空文字列で空のShapedBufferが返却される | E-01 (L27-28) | ○ |
| C-03 | 非HarfBuzzTypefaceでNotSupportedExceptionがスローされる | E-01 (L32-35) | ○ |
| C-04 | RTLテキストが正しくシェイプされる | E-01 (L53, L66-69) | ○ |
| C-05 | LTRテキストが正しくシェイプされる | E-01 (L53) | ○ |
| C-06 | タブ文字がIncrementalTabWidthで処理される | E-01 (L95-109) | ○ |
| C-07 | タブ文字でIncrementalTabWidth=0の場合のデフォルト処理 | E-01 (L103-108) | ○ |
| C-08 | LetterSpacingが適用される | E-01 (L91) | ○ |
| C-09 | カルチャが正しく設定される | E-01 (L57-60) | ○ |
| C-10 | カルチャnullでCurrentCultureが使用される | E-01 (L55) | ○ |
| C-11 | FontFeaturesが適用される | E-01 (L64, L214-235) | ○ |
| C-12 | FontFeaturesがnullで空配列が使用される | E-01 (L216-218) | ○ |
| C-13 | FontFeaturesが空で空配列が使用される | E-01 (L216-218) | ○ |
| C-14 | CRLF改行ペアが正しくマージされる | E-01 (L123-171) | ○ |
| C-15 | LF単独の改行が正しく処理される | E-01 (L159-170) | ○ |
| C-16 | CreateTypefaceがHarfBuzzTypefaceを作成する | E-01 (L118-121) | ○ |
| C-17 | UseHarfBuzzがAppBuilderにHarfBuzzTextShaperを登録する | E-02 (L21-24) | ○ |
| C-18 | UseHarfBuzzがメソッドチェーンで使用できる | E-02 (L21-24) | ○ |
| C-19 | HarfBuzzTypefaceコンストラクタがHBFont/HBFaceを初期化する | E-03 (L10-18) | ○ |
| C-20 | UnitsPerEmがMetricsから設定される | E-03 (L14) | ○ |
| C-21 | 管理配列バックのテーブルが正しく取得される | E-03 (L33-41) | ○ |
| C-22 | 非配列バックのテーブルがネイティブメモリにコピーされる | E-03 (L44-54) | ○ |
| C-23 | 存在しないテーブルでnullが返却される | E-03 (L27-30) | ○ |
| C-24 | DisposeでHBFont/HBFaceが破棄される | E-03 (L57-61) | ○ |
| C-25 | 複数回Disposeを呼び出しても例外が発生しない | **根拠なし** | △ |
| C-26 | GlyphTypefaceプロパティが取得できる | E-03 (L21) | ○ |
| C-27 | 1文字のテキストが正しくシェイプされる | E-01 (L23-115) | ○ |
| C-28 | サロゲートペア文字が正しくシェイプされる | E-01 (L47) | ○ |
| C-29 | 結合文字が正しくシェイプされる | E-01 (L47, L64) | ○ |
| C-30 | 非常に長いテキストが正しくシェイプされる | E-01 (L23-115) | ○ |
| C-31 | スレッドセーフにシェイピングが実行される | E-01 (L18-19) | ○ |
| C-32 | 同一カルチャのLanguageがキャッシュされる | E-01 (L21, L57-60) | ○ |
| C-33 | FontRenderingEmSizeに基づいてスケールが計算される | E-01 (L71-73) | ○ |
| C-34 | グリフオフセットが正しく計算される | E-01 (L173-182) | ○ |
| C-35 | サポートされないメモリタイプでInvalidOperationExceptionがスローされる | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-25（複数回Dispose）**: HarfBuzzTypefaceクラス自体に複数回Disposeの防御コードが存在しない。HarfBuzzSharpライブラリのFont.Dispose()およびFace.Dispose()の内部実装に依存する。実際の挙動は外部ライブラリのテストが必要。
  - 候補：HarfBuzzSharpのドキュメント / HarfBuzzSharpのソースコード / 実機テスト

- **C-35（GetContainingMemoryの例外）**: このメソッドはstring, array, MemoryManagerのいずれかでバックされていない場合にInvalidOperationExceptionをスローするが、ReadOnlyMemory<char>の標準的な使用ではこのケースに到達することは稀。テストケースとしては理論的なカバレッジ目的。
  - 候補：カスタムMemory<char>実装の作成 / .NETランタイムの仕様確認

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**: UseHarfBuzz拡張メソッド - シンプルな登録処理
- **1（中リスク）**: HarfBuzzTypeface.GetTable - メモリ管理（GCHandle, AllocHGlobal）を含む
- **1（中リスク）**: MergeBreakPair - unsafeコードでポインタ操作
- **0（低リスク）**: ShapeText正常系 - HarfBuzzSharpへの委譲

## 6) レビュアーチェックリスト（最小）
- [ ] HarfBuzzTextShaper.ShapeTextの主要パス（正常系、RTL/LTR、タブ処理）のテストケースが網羅されているか
- [ ] HarfBuzzTypeface.GetTableのメモリ管理（ピン留め vs AllocHGlobal）の両方のパスがカバーされているか
- [ ] IDisposableパターンの実装が適切にテストされているか
- [ ] スレッドセーフ（ThreadStatic s_buffer）の検証方法が適切か
- [ ] 外部ライブラリ（HarfBuzzSharp）依存部分のモック戦略が検討されているか
