extractors/ 語言抽取器

這個 dataclass 是整個抽取架構的核心抽象。每個語言設定：

• tree-sitter grammar 名稱與 node_types 對應（class / function / method 在該文法裡叫什麼）。
• import / require 的節點型別與邊的關係名稱。
• 可掛勾的語言特定回呼：型別收集（collect_type_refs）、額外走訪（extra_walk）、class 基底判斷、decorator 處理、scope 邊界…（這些 function 定義在 engine.py，例如 _python_collect_type_refs、_csharp_extra_walk）。
• synthesize_import_module_nodes 等 opt-in 旗標（0.8.40 加的 Swift import 修復）。

同檔的 _Symbol*Fact dataclasses（_SymbolDeclarationFact、_SymbolImportFact、_SymbolUseFact…）是解析器收集的「符號事實」，供 resolution 用。

閱讀建議：先看這個檔，再看 engine.py 的 _extract_generic——你就懂了整個架構。

這是所有語言抽取器共用的心臟。它做的事（與 ARCHITECTURE.md 的「新增語言」步驟對應）：

1. 用 tree-sitter 把檔案解析成 AST（byte slice 一律 errors="replace" 解碼，非 UTF-8 也不當機）。
2. 依照 config.node_types 走訪 class/function/method 節點，產生節點（ID 用 {file_stem}_{symbol} 形式，附 source_location: L{line}）。
3. 依照 config.import_types 找 import，產生 imports 邊。
4. 收集 raw_calls（呼叫事件）供跨檔解析第二遍。
5. 收集型別引用（collect_type_refs）供型別解析（uses 邊）。
6. 呼叫語言特定的 extra_walk（如 C# 的 partial class 合併、Swift 的 extension 走訪）。

整個 260KB 塞滿了各語言的 _*_collect_type_refs、_*_extra_walk、scope 計算、裝飾器、generator、async 等特殊語法的處理——這是「36 種文法」真正的深度所在。

段落式說明：每個語言在 engine.py 有一組 _<lang>_* 函數，解決「這個語言怎麼解析型別/作用域/特殊語法」：

• _python_collect_type_refs — Python 型別註解收集；_PYTHON_ANNOTATION_NOISE 過濾 str/int/MagicMock 等內建型別（0.8.33 的 god-node 修復）。
• _csharp_extra_walk / _csharp_partial 系列 — C# partial class 合併、attribute 解析。
• _ts_extra_walk / _ts_decorator_name / _ts_receiver_type_table — TypeScript 裝飾器、receiver 型別表。
• _swift_pre_scan / _swift_receiver_name — Swift extension 與 receiver 解析。
• _js_extra_walk / _js_member_assignment_target — JavaScript 成員指派。

這組函數的命名規律（_<lang>_<用途>）本身就是一個好索引——看到名字就知道是哪個語言、做什麼。

跨檔解析的難題：import { Foo } from "@/lib/utils" 這個 @/lib/utils 到底是哪個檔案？resolution.py 負責：

• tsconfig paths / baseUrl：_read_tsconfig_aliases、_resolve_tsconfig_alias 讀 tsconfig 的 aliases，把 @/… 對到實際路徑。
• workspace 套件：_find_workspace_root、_pnpm_workspace_globs、_load_workspace_packages——monorepo 的 pnpm/yarn workspace 與 package.json exports 欄位解析。
• JS 路徑解析：_resolve_js_import_path 處理副檔名省略、目錄 index、.js → .ts 轉換。

這 120KB 是「讓 calls/imports 邊跨檔對得準」的真相所在——也是整個圖能不能跨檔連起來的關鍵。

段落式說明：

• sql.py（20KB）— SQL AST 抽取（tables、views、FK、reads_from）；[sql] extra 提供 tree-sitter-sql。
• go.py / rust.py / csharp.py / dart.py — 主要語言，各自處理特有的 import/module 系統。
• bash.py（22KB）— shell 腳本（source/#include 邊）。
• pascal.py + pascal_forms.py — Pascal/Delphi（[pascal] extra）。
• terraform.py — HCL（[terraform] extra）。
• apex.py — Salesforce Apex（regex-based）。
• sln.py — Visual Studio solution 檔（專案參考）。
• json_config.py / markdown.py — 特殊格式。
• base.py（4KB）— extractor 基底類別。

還有 MIGRATION.md（5KB）記錄舊架構 → 新架構的遷移。