Add C++ class parsing and exclude_dirs filter

Parse and expose C++ classes/methods in the IR and add directory-based exclusion support. Introduces IRClass and IRMethod (with qualified_name on many IR nodes), includes classes in codegen context, and refactors normalizer to detect C++ records, methods, enums and typedef-backed anonymous types. Replaces the previous export_macro filtering with filters.exclude_dirs (and updates FilterConfig and example config), removes the legacy bindgen.yaml, and updates header discovery to honor exclude_dirs. README updated to remove export_macro recommendations.

Author: lijy91

tools/bindgen/README.md

@@ -63,13 +63,13 @@ C++ Headers
 ## 输入与约束
 
 - 入口：一组 C++ 头文件 + include paths + compile flags
-- 建议约定宏：用于筛选可导出 API（例如 `NATIVEAPI_EXPORT`）
 - 过滤方式：
-  - `export_macro`：只导出带宏标记的符号
   - `// bindgen:ignore`：显式忽略
   - 可选白名单/黑名单（按正则匹配函数/类型名）
+  - 可选排除目录（例如 `capi`）
 - 只处理（MVP）：
-  - 可导出的 C API 函数（`extern "C"`）
+  - `extern "C"` 函数
+  - C++ class/struct 的 public 方法（不含继承、多态、异常语义）
   - `struct` + POD 类型
   - `enum` 常量
   - `#define` 的简单常量
@@ -105,6 +105,7 @@ C++ Headers
 - headers
 - types
 - functions
+- classes
 - constants
 - aliases
 
@@ -209,6 +210,7 @@ render_to_files(templates, context, out_dir)
 - `module`: 当前模块信息（headers, namespaces）
 - `types`: 结构体/枚举/别名列表（已排序）
 - `functions`: 函数列表（已过滤）
+- `classes`: C++ 类/struct 列表（public methods）
 - `constants`: 常量列表
 - `mapping`: 语言映射配置（types/conventions/naming）
 
@@ -230,21 +232,20 @@ render_to_files(templates, context, out_dir)
 ```yaml
 clang_flags:
   - -std=c11
-  - -DNATIVEAPI_EXPORT
 mapping:
   language: example
 filters:
-  export_macro: NATIVEAPI_EXPORT
   allowlist_regex: []
   denylist_regex: []
+  exclude_dirs:
+    - capi
 ```
 
 说明：`entry_headers` 将自动从 `src/` 目录下收集所有 `.h`（忽略 `platform/`），`include_paths` 也会默认指向 `src/`，无需在配置中手动列出。模板目录默认读取 `config.yaml` 同路径下的 `template/`。
 
 ### 注解建议（可扩展）
 
 - 使用宏或注释标注 API，如：
-  - `NATIVEAPI_EXPORT` 标记导出
   - `// bindgen:ignore` 跳过
   - `// bindgen:nullable` 标记可为空
   - `// bindgen:rename <NewName>` 重命名
@@ -295,12 +296,11 @@ PYTHONPATH=../.. python3 -m bindgen \
 
 ## 风险与规避
 
-- **宏复杂度高**：MVP 仅处理简单宏与 export 宏
+- **宏复杂度高**：MVP 仅处理简单宏
 - **C++ 语义**：默认 `extern "C"` 入口
 - **跨平台 ABI**：需在生成器中区分平台（Windows/Linux/macOS）
 
 ## 下一步
 
-- 补充 `bindgen.yaml` 示例
-- 实现 `parser.py` 与 `ir.py` 的最小骨架
-- 选择模板引擎（如 `jinja2`）用于 codegen
+- 补充更多模板示例
+- 扩展 C++ 类方法语义（如继承信息、构造/析构、const 重载等）

tools/bindgen/bindgen.yaml

@@ -11,6 +11,7 @@ def build_context(module: IRModule, mapping: Dict) -> Dict:
         "types": module.types,
         "enums": module.enums,
         "functions": module.functions,
+        "classes": module.classes,
         "constants": module.constants,
         "aliases": module.aliases,
         "mapping": mapping,

tools/bindgen/codegen/context.py

@@ -18,9 +18,9 @@ def _load_yaml(path: Path) -> dict:
 
 @dataclass
 class FilterConfig:
-    export_macro: Optional[str]
     allowlist_regex: List[str]
     denylist_regex: List[str]
+    exclude_dirs: List[str]
 
 
 @dataclass
@@ -44,8 +44,8 @@ def load_config(path: Path) -> BindgenConfig:
         clang_flags=data.get("clang_flags", []),
         mapping=dict(mapping),
         filters=FilterConfig(
-            export_macro=filters.get("export_macro"),
             allowlist_regex=list(filters.get("allowlist_regex", []) or []),
             denylist_regex=list(filters.get("denylist_regex", []) or []),
+            exclude_dirs=list(filters.get("exclude_dirs", []) or []),
         ),
     )

tools/bindgen/config.py

@@ -2,11 +2,11 @@ clang_flags:
   - -x
   - c++
   - -std=c++17
-  - -DNATIVEAPI_EXPORT
 mapping:
   language: example
   output_note: Generated by bindgen example template.
 filters:
-  export_macro: NATIVEAPI_EXPORT
   allowlist_regex: []
   denylist_regex: []
+  exclude_dirs:
+    - capi

tools/bindgen/example/bindgen/config.yaml

@@ -25,6 +25,7 @@ class IRField:
 class IRStruct:
     name: str
     fields: List[IRField]
+    qualified_name: Optional[str] = None
 
 
 @dataclass
@@ -38,6 +39,7 @@ class IREnum:
     name: str
     values: List[IREnumValue]
     scoped: bool = False
+    qualified_name: Optional[str] = None
 
 
 @dataclass
@@ -61,6 +63,25 @@ class IRFunction:
     params: List[IRParam]
     callconv: Optional[str] = None
     variadic: bool = False
+    qualified_name: Optional[str] = None
+
+
+@dataclass
+class IRMethod:
+    name: str
+    return_type: IRType
+    params: List[IRParam]
+    static: bool = False
+    const: bool = False
+    access: Optional[str] = None
+    variadic: bool = False
+
+
+@dataclass
+class IRClass:
+    name: str
+    methods: List[IRMethod] = field(default_factory=list)
+    qualified_name: Optional[str] = None
 
 
 @dataclass
@@ -76,5 +97,6 @@ class IRModule:
     types: List[IRStruct] = field(default_factory=list)
     enums: List[IREnum] = field(default_factory=list)
     functions: List[IRFunction] = field(default_factory=list)
+    classes: List[IRClass] = field(default_factory=list)
     constants: List[IRConstant] = field(default_factory=list)
     aliases: List[IRAlias] = field(default_factory=list)