JA intro

DependencyPropertyGenerator 仕様書概要

🇺🇸 English | 🇯🇵 日本語

このドキュメント群は、C# Incremental Source Generator である DependencyPropertyGenerator (Kassyi.Generators.DependencyProperty) の全体アーキテクチャ、ドメイン仕様、インクリメンタルパイプライン構造、コード生成エンジン、およびパフォーマンス最適化戦略をまとめた公式仕様書です。

ソースジェネレーターのパフォーマンス（ビルド時間、メモリ消費、IDE応答速度）の改善や新機能を追加する際に、システム全体の設計方針や Roslyn API との連携、キャッシュ戦略を正しく理解するためのリファレンスとして活用します。

仕様書インデックス

以下のドキュメントを通して、システムの内部構造を深く理解できます。

• 01. 設計思想と FAQ ゼロアロケーションを実現する設計哲学、フラットなコード合成、トークンストリーミング、およびよくある質問（FAQ）をまとめています。
• 02. 基盤とドメイン プロジェクトの目的やモジュール構成、対象プラットフォームを定義しています。ユビキタス言語や構造化データモデル（DTO）に関する基本情報を記載しています。
• 03. パイプラインとアーキテクチャ Incremental Generator のパイプライン構造やクラス間データフロー、抽出・生成の実行順序を解説しています。
• 04. フレームワーク別生成マッピング仕様 WPF, WinUI, Uno, Avalonia, MAUI などの各 UI フレームワーク間のプロパティ登録 API マッピングと、自動検出ロジックを定義しています。
• 05. コード生成とパフォーマンス最適化 ゼロアロケーションを実現するコード生成エンジン（SourceWriter / ClassScope）と、AST直接走査・LINQ排除をはじめとするパフォーマンス最適化原則、ベンチマーク実績を定義しています。
• 06. インクリメンタル・ジェネレーターの計算量モデル 最悪時間・メモリ計算量の数理分析を通じて、パイプラインのキャッシュスケーリングの限界と設計的アプローチを解説しています。
• 07. テスト仕様書 本プロジェクトにおけるテスト戦略、品質目標、直交表パラメータ（576件）、テストケース一覧、および合否判定基準を定義しています。
• 08. 診断エラーコード一覧 ジェネレーターが発行する診断エラー（DPG0000 ～ DPG9999）の発生原因と具体的な解決策をまとめたリファレンスです。

---

🇺🇸 English | 🇯🇵 日本語