GVSDS/ViperC
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
676 Commits 1 Branch 3 Tags
b03e55bb7e9da5229d413ee441b445d21e7283ef
Commit Graph
145 Commits
Author SHA1 Message Date
TermiNexus b03e55bb7e fix(gen): 类归属不采信星号导入候选，收口 fatal_error 返回类型与默认值补全 
TypeGenResolve._class_true_def_sha1 / CallGenBase._lookup_reexport_from_vpi 新增 allow_star 参数：类归属只采信具名 re-export。此前 `from X import *` 候选被当成类的真实定义模块，而几乎每个文件都 star-import stdint，导致 TypeGenErr 前向声明被建成 "stdint.TypeGenErr"；该名字在 StructTable 里只剩一个错误 sha1 的条目，fatal_error 的跨模块返回类型解析全部落空并 fail-fast。

TypeGenErr.fatal_error/fatal_type_error 显式 -> int（留空会解析出退化类型 i0，命中 CallGenCall 的 i0 守卫）；_fail_method_ret_ty 增加失败上下文转储并并入同一条 VLogger.error（批处理下 error 即 sys.exit，其后代码全是死代码）。

CallGenMixin 模块级调用：默认值已知但重建不出时 fail-fast，不再静默产出操作数不足的 llvm.call（只会被 MLIR 校验拦下）；AssignGenMixin 两处 VLogger.error 补上 category 实参。

M2.3 v1b 收尾：逃逸摘要表与扫描临时区改为只分配一次、传递闭包扫到不动点、u64 改 sizet；VpiReader 不再 free 跨阶段引用的 src_sha1（heap-use-after-free）。
 2026-10-08 16:38:35 +08:00
TermiNexus 52fd89decf feat(gen): 调用点逃逸检查（M2.3 v1b 步骤4） 
translate_call 里按被调者摘要核对实参：第 k 位为 1（该形参会逃逸/被返回）的形参位上，实参若交出本帧栈地址（&local / 局部数组退让）即报 LifetimeError。此处拿不到被调者形参类型，故传哑指针类型，仅用于让 life_of_expr 判定裸局部数组名处于指针位置=退让。
 2026-10-08 13:41:00 +08:00
TermiNexus 2ab6342d3c fix(gen): arg 糖支持转发形态的 va_list 
_translate_arg_sugar 原本在 trans._va_list_ptr 为 None 时（非变参的 vprintf 式包装函数，如 vsnprintf(buf,size,fmt,args)）直接返回 0，转发下来的 va_list 因此读不到；现增加回退：按名 args 取形参 alloca 并 load 出槽内的 va_list 指针（自身变参形态仍用 trans._va_list_ptr，不 load）。点号形式 stdarg.arg(...) 经 ExprGenBase.get_func_name 取属性短名，已天然命中同一分派，未改动。
 2026-10-07 20:15:40 +08:00
TermiNexus c20bd4734b feat(gen): 值引用自动取址接入虚分派/构造/属性/静态等全部方法调用路径 
CallGenBase 新增 _vpi_auto_addr_mode（把原先埋在 _coerce_args_to_def_params 里的 vpi 注解解析抽成唯一实现，两处共用）与 _apply_auto_addr_to_call_args（同模块先查 AutoAddrModes，跨模块回退 vpi 注解）。接入原先完全不查表的路径：虚分派（原在 vpi 取址前 return）、_call_method_on_ptr 覆盖的构造 __new__/__init__（含泛型）与 dunder 分派、属性 getter/setter/deleter、静态/类方法、super()、FakeDuck；属性 setter 由 AssignGenMixin 传入 rhs AST 以支持 &T 取左值地址。
 2026-10-07 19:59:52 +08:00
TermiNexus 5c1b882169 chore(gen): c.CIf 家族移除报错覆盖 CElif/CElse/CEndif，注释口径统一为 cif 
ExprGenName / CallGenDispatch 的「已删除拼写」守卫原本只认 CIf/CIfdef/CIfndef，现补齐 CElif/CElse/CEndif 六个（与 TPC 侧一致），报文同步；StmtGenCifMixin 的头注释、docstring 与状态注释把语句统一称作 cif，内部标记仍写作 c.@CIf 族。
 2026-10-07 19:10:05 +08:00
TermiNexus 2fb648d68a feat(lang): 新增 cif/celif/celse 条件编译与值引用注解 &T/&temp T，assert 改译 testcheck.check 
cif 三件套：StmtGenCifMixin 负责常量求值（含 defined(模块宏) 的 Attribute 形式），链式错配与含运行时变量一律 fail-fast；删掉 c.CIf 家族。值引用：TypeGenResolve 让 CRef/CTempRef 与 t.CPtr 走同一解析路径（&void 折叠为 i8*，删除 t.CNeedPtr），CallGenBase 在调用点按形参模式自动取址（ref 只接受左值，右值 fail-fast；temp 物化临时栈），跨模块经 VpiReader/StubMergerBuild 传递模式。assert：StmtGenMixin 合成 testcheck.check(cond, None, msg)，Translator 检测到 assert 时自动注入 testcheck 导入（带去重与防环），深递归守卫改用 stdio.printf + stdlib.exit（Translator 无 Gen 成员）。
 2026-10-07 19:03:16 +08:00
TermiNexus edca6c3760 chore(detsite): 类型文本 4096 缓冲补插桩 
19 处 TypePrint(..., 4096, ...) 对应的 pool.alloc(4096) 全部改用 alloc_tagged
（AssignGenMixin/ClassGenVTable/FuncGenDef/ExprGenBase/ExprGenCdef/CallGenLeafKit/
TypeGenCType/TypeGenResolve/CallGenCBuiltin/ExprGenOps），tag 33..51 见 memhub.vp。
detection==0 时 alloc_tagged 直接转发，无布局与性能变化。
 2026-10-07 15:16:52 +08:00
TermiNexus 848dc0ab38 fix(compiler): 跨模块调用补全 int→ptr 转换与别名默认参数；类型文本缓冲 512→4096 
1) CallGenMixin.vp（跨模块 extern 实参提升）：指针目标形参改为无条件走 coerce_to_type——原守卫按整数位宽比较，而指针类型的 bits 恒为 0，整段提升被跳过，致 VirtualAlloc(0,...) 以 i32 传入指针形参、mlir-opt 报 operand type mismatch（ViperAIChat 失败）。

2) CallGenMixin.vp（默认参数限定键）：改用 StructGen._resolve_module_sha1 解析模块 SHA——原只精确匹配模块名，import x as y 这类别名取不到真实 SHA，默认值表落空、跨模块调用实参数目不符（ViperRequestsTest 失败）。

3) 11 个文件的 TypePrint 类型文本缓冲 512→4096（分配与传入 size 成对修改）：48 字段类（如 MNIST 的 Net）的 MLIR 结构体类型文本超过 512 被截断并 fail-fast。
 2026-10-07 08:48:09 +08:00
TermiNexus 7a9bc5ae75 chore(messages): TransPyV 运行时中文字符串英文化 
把 TransPyV/App 下 57 个文件的运行时中文字符串（编译器报错/告警/日志、CLI 帮助与横幅、REPL 提示、Phase1/Phase2 流程日志、Codegen 各 Mixin 的类型与调用报错、Stub/Vpi 诊断等）共 1091 行译为英文。

口径：只改字符串字面量内部文字，行数零变化（+1092/-1092）；printf 格式符与转义序列多重集合校验不变（_strcheck 异常 0）；译文不引入撇号以免干扰单引号字面量解析。验证：三重重编 SUCCESS（136.20s）+ 全量 77/77 顺序回归通过 + VET 编译 SUCCESS / --search-paths 7 条 exit 0；新产物 help/日志输出已为英文。
 2026-10-07 00:03:58 +08:00
TermiNexus cd55a7e214 refactor: rawptr[T] -> T*（R14）+ 修 REnum 前向占位未就地填充 
R14：rawptr[X] -> X*（56 文件 / 834 行改动）；保留 6 处 rawptr[t.CPtr]（存纯裸指针的规范例外）。 修复：class X(t.REnum) 的变体字段写成自引用 X* 时，字段解析在变体扫描期经 ensure_forward_class 建了一个 opaque 前向占位；末尾 register_struct 按 Ty 指针去重会再建第二个同名 entry，而 find_struct 取首个（占位，0 字段）→ X.__sizeof__() == 0，报「已注册但大小为 0（字段链表未填充）」。改为注册前若命中同模块前向占位则就地填充（与 ensure_forward_class 文档口径一致）。TPC 无此问题，属 TPV 侧缺口。 验证：自举三重重编 SUCCESS；全量 77/77 顺序回归通过（修复前卡在 LLvmLiteTest）。
 2026-10-05 17:38:28 +08:00
TermiNexus aeb4e8e54c refactor(gen): R12 收尾同步——12 处计数 while 循环改 for range 
与 includes 同步：<= 条件转 range(expr + 1)，并放宽初始化行的紧贴要求（同块内最近一次写即为初始化即可）。其余保守守卫不变。

验证：bootstrap 三重重编 SUCCESS；全量 77/77 顺序回归通过。
 2026-10-05 16:36:36 +08:00
TermiNexus fb53f88893 refactor(gen): R12/R13 同步——下标 while 循环改 for range、去 c.Set 
与 includes 同步执行两批源改写：R12 把「i: int = 0 与 while i < N: … i += 1」形式的计数循环改写为「for i in range(N):」；R13 把 c.Set(*p, v) 迁移为 *p = v、c.Set(a, b) 迁移为 a = b（c.Set 是正在退化的路径）。

验证：bootstrap 三重重编 SUCCESS（无 vast_c 解析回退）；全量 77/77 顺序回归通过（WebTest 首轮网络超时，单独重跑通过）。
 2026-10-05 15:33:58 +08:00
TermiNexus a7b8118ce8 fix(call): c.Set 支持 Starred 解引用目标（*p 在实参位被解析为 Starred） 
新规范把 c.Set(c.Deref(p), v) 改写成 c.Set(*p, v)，而实参位的 '*' 由 ast/parser.vp 解析为 Starred(value=p, ctx=Load)，translate_c_set 只认 c.Deref/Call 与 Name 形态 ⇒ 整条 store 被静默丢弃。

后果：zlib 侧 includes 全部 47 处 c.Set(*out_len/*out/*length/*cap/*buf/*best_dist/*p_done, ...) 失效 —— 压缩结果长度恒为 0（decompress 报 Z_DATA_ERROR -3），ZlibTest 运行期 0xC0000005。现按 UnaryOp/Deref 与 Starred 两种形态统一走解引用写入，并对非指针目标 fail-fast。
 2026-10-05 14:35:50 +08:00
TermiNexus 0f4aeeceff docs(tpv): R11 注释与 docstring 英文化并压缩到 2 行内 
按 wiki/新规范：注释只讲作用、不掺杂历史原因、避免超长、尽可能英文（含三引号 __doc__）。全文 79 个 .vp：# 注释 16269 行（中文 13808）与 docstring（中文 1381 处）全部改英文；超 2 行的注释块（2093）与 docstring（397）全部压到 2 行。运行时可见文本未动（fatal_error/VLogger 的中文报错文案、stdio.printf 的横幅格式串）。校验：屏蔽注释与三引号后逐行比对各文件代码骨架，0 漂移。验证：自举重建 153.48s 通过（跨模块内联完成）；TPV 顺序回归 77/77 全通过。
 2026-10-05 13:38:22 +08:00
TermiNexus f2ef1bb240 refactor(tpv): 新语法 R10 括号内隐式续行并一行（1140 处 / 67 文件） 2026-10-05 07:14:14 +08:00
TermiNexus 4a685d478f refactor(tpv): 新语法 R10 单语句块并一行（7722 处 if/for/while 单语句体） 2026-10-05 03:10:55 +08:00
TermiNexus 30a3da4cd4 refactor(tpv): 新语法 R10（反斜杠续行合并）+ 回退 R5（语义不等价） 
- 反斜杠续行合并为单行（304 处），呼应"尽可能不换行"。
- 回退 c.DerefAs(p, v) → *p = v 两处（StructGenMixin）：原写法是 bitcast 后
  store 指针位，新写法按 pointee 值类型赋值，类型不符（i8* → List 值），
  语义不等价，保留 c.DerefAs。

种子自举通过。
 2026-10-04 22:56:27 +08:00
TermiNexus 185a2196ca refactor(tpv): 迁移新语法 R1/R2/R7/R8/R3/R4/R5（指针 T*、短别名、define、&/*、__asm__） 
按 wiki/新规范：
- T | t.CPtr → T*（无 | 标准）
- t.CInt/t.CUInt64T/t.CChar/t.CDouble 等 → int/uint64/char/double 等短别名
- X: t.CDefine = Y → define X = Y
- c.Asm → __asm__，c.AsmInp/c.AsmOut → asminp/asmout，t.ASM_DESCR. → ASM_DESCR.
- c.Addr(x) → &x，c.Deref(p) → *p，c.DerefAs(p, v) → *p = v

种子自举通过（96s）。
 2026-10-04 22:49:01 +08:00
TermiNexus 68cd5f2f90 fix(tpv): __new__ 截断条件放宽到 nn_pc>=1（源侧 __new__ 可无参数） 
OopInheritTest 报：
  error: 'llvm.call' op incorrect number of operands (4) for callee (expecting: 1)
      %16 = llvm.call @"...Vec3.__new__(%0, %5, %10, %15) : (!llvm.ptr, f64, f64, f64) -> !llvm.ptr

源码 `def __new__() -> 'Vec3' | CPtr:` 无参数（TransPyV 只注入 self），
__init__(self, x, y, z) 才收 x/y/z。上一提交的截断条件写成 nn_pc > 1，
nn_pc == 1 时被跳过 ⇒ 仍多传 3 个。放宽为 nn_pc >= 1（裁到只传 self）。

验证（均已跑通）：
- OopInheritTest：PhaseB 编译完成 → PhaseC 产出 OopInheritTest.exe → 完成
- SlotsBugTest：同上（无回归）
 2026-10-04 20:15:37 +08:00
TermiNexus 58cfe2346e fix(tpv): __new__ 调用按被调方签名截掉多余尾参 
mlir-opt 报：
  error: 'llvm.call' op incorrect number of operands (8) for callee (expecting: 7)
      %245 = llvm.call @a959d1abdb31a471.FunctionDef.__new__(%35, %239, %240,
             %241, %242, %243, %is_async, %244) : (...) -> !llvm.ptr

定义/声明侧（ast/stmts.vp vpi 核实）：
  FunctionDef.__new__(self, pool, name, args, decorator_list, returns, is_async)
      = 7 个形参（非-self 6）
  FunctionDef.__init__(..., is_async, type_params = None)
      = 8 个形参（非-self 7，多出的 type_params 有默认值）

根因：构造器路径把 ctor 实参**全量**转发给 __new__，而 __new__ 的签名比
__init__ 短（无 type_params）⇒ 调用点传了 7 个非-self 实参，声明只收 6 个。
（临时探针实测：mdf_param_count=6 正确、封参逻辑未触发，extra_count=7 才是不匹配源。）

修复：_call_method_on_ptr 中对 method_name == "__new__" 且已找到 declare 时，按被调方
非-self 形参数截掉多余**尾参**（这些尾参 __new__ 本就不接收，语义上由 __init__
消费；__new__ 只负责分配存储）。探针已删除。

验证：python ./TransPyC/Projectrans.py --project ./TransPyV/project.vpj --clean
      --rebuild-includes --clear-cache 重编通过；
      ./TransPyV/output/TransPyV.exe --project ./Test/SlotsBugTest/project.json
      PhaseB 编译完成 → PhaseC 产出 SlotsBugTest.exe → TransPyV 完成。
 2026-10-04 20:09:21 +08:00
TermiNexus 6a6cae2a44 fix(tpv): 模块限定调用优先用 vpi 定义侧形参类型，Win32 白名单降为兜底 
mlir-opt 报：
  error: 'llvm.call' op operand type mismatch for operand 2: 'i64' != 'i32'
      %5 = llvm.call @VirtualAlloc(%c6, %2, %3, %4) : (!llvm.ptr, i64, i64, i64) -> !llvm.ptr

声明（真值）：extern def VirtualAlloc(VOIDPTR, sizet, ULONG, ULONG) -> VOIDPTR
           ⇒ llvm.func @VirtualAlloc(!llvm.ptr, i64, i32, i32)

根因：调用点 found_func 为 None 时用 `_get_external_func_param_ty` 硬编码白名单，
它把 Win32 API 的**所有**非指针参数一律当 i64（注释依据"DWORD/ULONG 在 stubs 里
被映射为 i64"的旧口径），而现实中 ULONG → i32 ⇒ 字面量被 sext 到 i64，与声明
i32 不匹配。

修复：CallGenMixin 的参数 coerce 分支（found_func is None）改为**模块限定调用
先用定义侧 vpi 形参注解**（`_resolve_vpi_param_annot_seg`，模块级函数段下标 ==
形参下标）取真实类型；拿不到注解才回退白名单。CallGenLib 的该函数补注释，
标明它是**兜底专用**且 Win32 口径已过时。
 2026-10-04 18:17:51 +08:00
TermiNexus 94b174c8a0 fix(tpv): 补齐 asm_arg_cap 声明与嵌套数组 element 预算漏改 
上一条提交（3426139）中两处改动实际未落盘（编辑动作报告成功但文件内容未变），
导致 TransPyC 编译报 NameError: 未定义名称 'asm_arg_cap'。

- CallGenCBuiltin：补 asm_arg_cap 声明（按操作数个数给足内联汇编实参表容量），
  args_buf 改用该容量分配（此前 4 处用法已改为 asm_arg_cap，声明却缺席）
- TranslatorGenMixin：嵌套数组 element 预算 192 → 768（含子数组类型前缀）
 2026-10-03 21:17:41 +08:00
TermiNexus 3426139d03 fix(mlir): TypePrint 输出缓冲按 MLIR 类型长度放大；初始化器文本按类型长度给足 
MLIR 类型文本内联具名结构体完整字段体（可达数百字节），旧的短缓冲会截断类型
文本、产出畸形 MLIR（mlirlite 侧 TypePrint 现已对截断响亮报错，此处补齐容量）。

- 10 处 TypePrint 调用点及其缓冲统一放大到 512：
  AssignGenMixin / TranslatorGenMixin / CallGenCBuiltin(×2) / CallGenLeafKit /
  ClassGenVTable / ExprGenBase / ExprGenOps(×4) / FuncGenDef / TypeGenResolve(×2)
- TranslatorGenMixin：
  - _stg_field_zero_text 缓冲 160 → 576（元素 = 类型前缀 + 值）
  - _default_val_const_text 缓冲 48 → 576
  - 嵌套数组 element 预算 192 → 768（含子数组类型前缀）
  - storage 结构体 element 预算 160 → 576
- CallGenCBuiltin：内联汇编实参表按操作数个数分配（原固定 512，一个结构体
  操作数即溢出）、汇编行缓冲按实际长度分配
 2026-10-03 21:08:30 +08:00
TermiNexus cbf76cd468 fix(callgen): text.ll 返回类型回退支持 MLIR 形态 llvm.func 
- _CacheModuleRetTyTexts 同时认 define 行与 mlirlite 的 llvm.func 行（含缩进/void 省略 ->/变参）

- 缓存值以 '#' 前缀标记 MLIR 形态，命中时用新增 _ParseMlirRetTyStr 解析

- _ParseMlirRetTyStr 覆盖 none/iN/f16..f128/!llvm.ptr/!llvm.array/!llvm.struct（具名按登记表回查，未登记返回 None 不臆造）

- 背景：单端 MLIR 后 text.ll 无 define 行，回退恒空 ⇒ 指针返回值退回默认 i32 被 inttoptr 截断
 2026-10-03 19:45:47 +08:00
TermiNexus 7b3e814524 refactor(backend): 单端 MLIR —— 发射器全树改名 mlirlite 并删除 --backend 开关 
- App/Test 的 .vp 中 llvmlite 全部改名为 mlirlite（import、限定名、类型注解、注释）

- 删除后端开关：Config.set_backend/is_mlir_backend/alias_module_name、BackendTarget/BackendIsMlir、CLI --backend、options.backend/options.target 读取，以及 IncludesScanner/StubMergerIR 的模块别名调用

- BuildPipeline 的 mlir-opt -> mlir-translate 降级管线去掉开关门，改为恒执行

- backend_dir_suffix 改名 mlir_dir_suffix 并恒返回 _mlir：TempDir/OutputDir/includes 缓存继续落在 *_mlir，避免复用旧 LLVM 后端的 .ll/obj

- project.vpj 删除已失效的 options.target
 2026-10-03 19:26:24 +08:00
TermiNexus cda4cca805 refactor(generic): 类型实参符号判定复用 spec_sign_of_annot 
- 两处 Call 推断由 SpecSignFromTypeNameSpan 改为 TypeGenCType.spec_sign_of_annot，复用注解侧唯一真源（精确名白名单 + CTypedef 链逐层展开）

- 收益：别名（uint64/size_t/WCHAR->WORD->uint16 等）也能判出符号性，不再是裸白名单的 UNKNOWN
 2026-10-03 18:20:42 +08:00
TermiNexus 21436b2690 feat(generic): 泛型实参推断为无裸名别名的整型位宽补精确票名 
- _infer_scalar_type_name_from_spec 支持 i64/i16 -> t.CUInt64T/t.CInt64T、t.CUInt16T/t.CInt16T；符号性未知时不猜（返回 None）

- infer_scalar_type_arg_from_llvm_ty 增加 sign 参数：LLVM 类型层无法区分 iN/uN，符号性由被调名源码文本经 SpecSignFromTypeNameSpan 判定

- 泛型函数与泛型类构造两处 Call 推断同步传符号性，修复 GenericOopTest fxi2 第 3 个类型实参（CUInt64T）推断失败
 2026-10-03 17:12:47 +08:00
TermiNexus 28b7437e21 fix(generic): 泛型类构造 Call 实参推断同步收紧，抽出共用精确映射 
CallGenCtor._infer_generic_ctor_type_arg 的 Call 分支此前与泛型函数路径同款名字子串猜测（含 Int→int、Float→double），把 CUInt64T/CInt16T 静默归成 int=i32、CFloat32T 猜成 double。改为：把被调表达式交给注解解析器，命中标量才据精确位宽映射；非标量/不可解析仍 fail-fast（保持原有"明确的类型意图却无法解析"报错）。

新增 ClassGenGeneric.infer_scalar_type_arg_from_llvm_ty 作为两处共用的唯一入口（内部走 _infer_scalar_type_name_from_spec），泛型函数路径一并改为调用它，消除重复的 arena/SpecFromLLVMType 样板，保证两处同口径。
 2026-10-03 15:51:12 +08:00
TermiNexus c035a82394 fix(类型): str/bytes 聚合指针检查豁免字符数组衰减，并统一判据真源 
误报现场：includes/os/_win32.vp:207 `name: str = find_data.cFileName`。WIN32_FIND_DATAA.cFileName 是 [260 x i8]，字段访问得到 Ptr(Array(i8,260))，其指针在 C 语义下天然衰减为 char*/str，属合法赋值，原判据把 Ptr(Array) 一律当真而误杀。

新增 ExprGenBase._str_rejects_ptr_kind（单一真源：1=结构体/类/联合指针、2=非字符数组指针、3=函数指针、0=可接受；[N x i8] 豁免）供 fail_if_str_annot_agg_ptr 与 CallGenLib 跨模块实参检查共用，消除两处重复的 kind 判定，避免同规则两处演化。
 2026-10-03 15:40:01 +08:00
TermiNexus 09ea7283f9 fix(类型): str/bytes 不再作通用指针通配，补齐实参/赋值/返回三处隐式转换 fail-fast 
规则：void*/t.CPtr/rawptr 允许隐式转为任意指针类型，str/bytes 不允许（即便两者在 IR 层同为 i8*）。此前 coerce_to_type 的规则 1（通用指针通配）会把指向结构体/类/数组/函数的指针静默 bitcast 到 str 目标（反向亦然）。

- ExprGenBase：新增 _annot_name_is_bare_str/_annot_is_bare_str（裸 str/bytes 判定，组合段如 str|t.CPtr 不受影响）、fail_if_str_annot_agg_ptr（值是指向聚合类型的指针则 fail-fast，消息 CastError）、fail_if_str_annot_ast_agg_ptr（AST 注解入口）。

- 返回路径 StmtGenCifMixin.translate_return：在类型转换分支之前用 trans.CurFuncRetAnnot 判定，避免被规则 1 静默 bitcast。

- 赋值路径 AssignGenMixin.translate_annassign：四个分支（global / nonlocal / mod_glob / 局部）在 coerce 前用 aa.annotation 判定。

- 同模块实参 CallGenMixin.translate_call：在参数循环前一次性确保本模块 .vpi 参数注解缓存就绪（同跨模块 CallGenLib 键式：模块级函数 cls=None、段下标==形参下标），循环内按 _vpi_param_annot_seg_is 判定裸 str/bytes。
 2026-10-03 14:46:57 +08:00
TermiNexus 98ee53340f feat(call): 跨模块实参加 str/bytes 形参的 fail-fast（str 不作通用指针通配），并加 vpi 注解段等值判定 2026-10-03 14:23:12 +08:00
TermiNexus feb29fa7a3 fix(generic-func): 发射特化调用改传符号名（callee: str）而非 Function*，修复生成空 @ 的非法 IR 2026-10-03 14:18:14 +08:00
TermiNexus df1ffa4c2a refactor(subscript): 删除调用侧下标 zext 与 _zext_index_to_i32，统一交给 build_gep（单一真源） 2026-10-03 13:35:36 +08:00
TermiNexus bcbc7142be fix(subscript): 指针下标 GEP 补 zext，修复 i8 下标被符号扩展（uint8ptr[200] -> p[-56] 越界），zlib 漏计字节>=128 根因 2026-10-03 13:20:11 +08:00
TermiNexus 3b465121cd fix(call): kwargs 调用路径补齐省略形参的默认值 
_translate_call_with_kwargs 此前对「位置/关键字均未提供的形参」直接跳过 → 调用实参数 < define 形参数，被调函数按 ABI 读未写寄存器/栈槽（remote.one(x = 1) 的 cap 读成 0，DefaultArgTest 断言失败）。改为：按 found_func mangled 名前缀取定义模块 SHA1，用全局默认表 find_func_defaults 取定义处默认值快照补齐（右对齐索引）；取不到默认值时 fail-fast，绝不静默漏参/填零。跨模块默认值通道本就通（vpi 带默认值），无需改产物格式。
 2026-10-03 12:08:32 +08:00
TermiNexus 692998820c feat(generic): 泛型函数类型实参推断与单态化 
支持 def f[T](x: T) -> T 及 f(x)/f[T](x)：模板注册（Phase1Scan/Phase2 顶层 FunctionDef，键 {sha1}.{name}）、按形参注解对齐从实参推断类型实参（无来源即 fail-fast，不静默默认 int）、克隆模板并 set_generic_context 后翻译生成特化体（名字 {sha1}.f[int]，规范化复用 _mangle_generic_class_name）、同签名去重、跨模块按模板签名补 declare。泛型函数模板不再发 vpi（模板签名含未绑定 T），也不再发射 int 兜底版本。已知限制（未静默）：bound [T: bound] 解析期已被丢弃；t.CExport/t.CExtern/t.State 泛型函数、关键字/默认参数调用、mod.f[T](x) 显式下标等暂 fail-fast 或走既有报错。
 2026-10-03 11:59:26 +08:00
TermiNexus 4c114d8875 fix(call): 泛型模板的前向声明占位不再阻断构造期类型实参推断 
注解 vector.Vector | CPtr（无实参）会经 TypeGenResolve 登记不透明前向声明占位 {sha}.Vector（IsForwardDecl=1）。模块限定构造 vector.Vector(...) 在 CallGenMixin 命中该占位后，gen_ctor_entry != None 使泛型推断分支（struct_ty is None and gen_ctor_entry is None）被整段跳过，静默按普通结构体/函数构造并产出裸泛型基类对象 → 后续方法调用触发 D25 接收者 fail-fast（VectorGenericTest 根因）。改为：命中项是前向声明占位且类名为已注册泛型模板时，不锁定 struct_ty/gen_ctor_entry，放行泛型推断按实参（_hint: T）特化；裸名分支与模块限定分支同口径。
 2026-10-03 10:18:29 +08:00
TermiNexus 324a22b6d1 refactor(call): CallGenFd 返回类型精确化改以 vpi 为权威 
返回类型「精确化」原只读定义模块 text.ll；改为先查 vpi 返回注解缓存
（_lookup_method_ret_ty_via_vpi），未命中再回退 text.ll，与 ② 的
vpi→text.ll 口径一致。

去 IR 化遗留收尾；未编译验证。
 2026-10-03 08:28:07 +08:00
TermiNexus 78d3941f7d refactor(call): 跨模块返回类型解析改以 .vpi 为权威，text.ll 降为回退 
将 8 处跨模块方法/函数返回类型解析的 text.ll → vpi 顺序对调为 vpi → text.ll：
- CallGenProp：属性方法调用
- CallGenMixin：跨模块裸名 CExport、from-import 函数
- CallGenCall：跨模块方法、类方法调用、self 方法调用（含 MRO 祖先链重试段整体搬移）
- CallGenDispatch：__len__ 跨模块、泛型 Mixin 方法

本模块 found_func / local_fn 取当前 IR 声明类型的路径保持不变。
去 IR 化步骤②；未编译验证。
 2026-10-03 08:10:34 +08:00
TermiNexus 4eec3f0908 feat(dunder): 补齐 dunder 协议（__bool__/__call__/__str__/__abs__/__del__/**/增量/反向） 
- __bool__：ExprGenOps.coerce_cond_to_bool 统一 if/while/and/or/not/三元/协程条件的真值归一，优先调度 __bool__

- __call__：obj(args) 分发到 obj.__call__（CallGenMixin 裸名分支）

- __str__：str()/print/f-string 调度（CallGenDispatch/CallGenLeafKit/ExprGenFstr）

- __abs__：abs(obj) 调度（CallGenMixin）

- __del__/__delete__：del obj → __delete__；del obj.attr 无 property deleter 时回退对象 __del__

- ** / __pow__：新增 llvm.pow 内联（整数按常量指数回写），_binop_to_dunder 补 Pow

- 增量赋值：__iX__ 优先、缺失回退 __X__（新增 _aug_op_to_dunder）

- 反向运算符：新增 _rbinop_to_dunder，lhs 无 dunder 时调度 rhs.__rX__
 2026-10-03 00:40:00 +08:00
TermiNexus fabd92adc7 feat(switch): 新增 switch 语句并禁止 match 内 fallthrough 
- MatchGenMixin：case 体按 node.is_switch 置 _in_switch_case；_has_no_break 只认 FallThrough 节点（去掉 c.NoBreak() 兼容路径）
- StmtGenDeclMixin：translate_fallthrough 只在 switch 的 case 体内合法，match/switch 之外 fail-fast
- Translator：_in_match_case 更名 _in_switch_case（语义 = 当前 case 体属于 switch）
- FuncGenDef / FuncGenMixin：函数体 / 嵌套函数 / lambda 入口隔离并恢复 _in_switch_case
- 因 match 改为硬关键字，重命名同名局部变量 match -> Matched（StubMergerStore / ImportsGenMixin / ExprGenAttr / CallGenBase）
 2026-10-02 23:15:43 +08:00
TermiNexus 15b416b527 fix(type): 统一注入期类归属与导入上下文记账，修占位表爆与属性标记误解析 
- StubMergerStore 新增共享导入上下文记账（AppendImportedModule / AppendFromImport /
  ImportCtx / AllocImportCtx / NotePlainImport），ImportsGenMixin 与 VpiReader 共用同一份
  口径；顺带移除 add_from_import 的 256 缓冲静默截断，VpiReader 删除两份私有副本

- 注入窗口按「名字归属」判据解析（is_module_class + CurDefModuleSha1）：
  _forward_declare_ptr_from_node 的 Name 分支、resolve_annotation_type 的 Name/Attribute
  分支均补齐，使同一 stub 内先声明/先引用的类产出**具名占位**而不是 Ptr(i8)，并新增
  _is_tattr_marker 让 t.attr.* 属性标记不参与类型联合竞争

- VpiReader._inject_class_struct_declare：命中前向声明占位时不再早退，改为「占位 Ty
  原地写入」（对齐 ClassGenDef.fill_fwd），修 StructTable 爆表（table full, cannot
  register Translator）

- 清除全部一次性探针：[DBG-GEN]（VpiReader / StructGenMixin / ClassGenDef）、
  [DBG-ATTR]（ExprGenAttr）、[MODSHA1]（CallGenMixin）

根因记录：vpi 注入期漏记 `import X as Y -> from_imports "Y:X"`，使 GenTypes.VarEntry.Spec
（TSpec.TypeSpec | t.CPtr）取不到模块 SHA1、退化为 i8* 并被永久冻结
（CallGenCtor.vp:897 .PtrLevel 属性访问失败）。
 2026-10-02 17:29:38 +08:00
TermiNexus 1ad7abf33d refactor(TransPyV): 统一自举写法（novirtual / define / rawptr→* / 去续行反斜杠） 
- @t.NoVTable class X → novirtual class X
- t.CDefine = N → define N
- rawptr[X]、X | t.CPtr → X*
- t.CPtr → rawptr（裸指针标记）
- t.Callable[...] → callable[...]
- 去掉 if/elif 条件的行续反斜杠（改单行写法）
- w32.win32file.X → win32file.X（已 import as）
- core/__init__.vp 去掉未使用的 import t, c / from stdint import *

涉及：CompilerFactory、IncludesScanner、Repl、core/__init__、
Gen/Call/{CallGenBase,CallGenCBuiltin,CallGenCall,CallGenDispatch,CallGenLeafKit}、
Gen/Class/ClassGenGeneric。
 2026-10-02 02:16:37 +08:00
TermiNexus 57f8c655c8 chore(debug): 移除 [DBG-P7] 一次性插桩（根因已定位） 
定位结论见 Debugger/debug-nested-class-struct.md 的 P7：不是别名登记失败，而是
Phase A-pre（预注册 struct/enum/union，declare_only）解析类字段注解时，被 import
模块的 vpi 一概尚未注入 ⇒ 包重导出别名 entry 不存在 ⇒ 字段侧票名保留包前缀并被
冻结进结构体布局，与阶段 A 构造函数侧的真定义前缀分裂。

删除 96c1102 / 3b8a2b2 引入的全部临时打印（VpiReader.vp / TypeGenResolve.vp /
CallGenCtor.vp 三处），代码回到插桩前状态（-108/+0）。
 2026-10-02 00:59:44 +08:00
TermiNexus 3b8a2b225f debug(stub): 补全 [DBG-P7] 插桩覆盖所有票名产生路径（定位后删除） 
在 96c1102 基础上把"可能产出该票名"的路径一次打全，保证一次重建即可定死根因：

- TypeGenResolve._class_true_def_sha1：MISS 时额外 dump 结构体表里所有名字含
  ClassDef 的条目（下标/名字/归属 sha1/Ty 的 IR 名前缀）——直接看出别名 entry
  到底有没有、挂在哪个 sha1 上。
- TypeGenResolve.extract_class_name_from_annotation：AnnotClassName 通道算出的
  泛型票名（含 ClassDef 才打）。
- TypeGenResolve._resolve_generic_subscript_ty：注解/字段侧算出的泛型特化名
  gen_mangled（含 ClassDef 才打）。
- CallGenCtor._extract_type_args_from_slice：构造函数侧实参串的 raw/norm 两态。
- VpiReader._inject_class_struct_declare：进入 + 各出口
  （already / renum_skip / field_unresolved / zero_fields / registered）。
- VpiReader._inject_reexport_class_declare：调用现场与四个出口
  （already / no_src_entry / alias_reg_fail / alias_ok）。
 2026-10-02 00:34:38 +08:00
TermiNexus 8e3811c490 fix(CallGen): 跨模块调用的 declare 形参与实参统一以定义侧为准 
问题一（declare 形参被首个调用点冻结）：CallGenBase._ensure_method_declare 新建跨模块方法
declare 时形参类型取"首个调用点的实参类型"，而这条 declare 被同模块所有调用点共用 ⇒ 后续
调用传入另一种具体指针类型时，被这条被冻住的形参类型 coerce，报"非基本类型指针间隐式转换"。
现场：VarGenMixin.repl_ensure_entry 的 node: ast.AST*，先被 translate_annassign 以 ast.AnnAssign*
建 declare，后 translate_assign 传 ast.AST* 即报"源类型 …AST* → 目标类型 …AnnAssign*"。
⇒ 指针形参与整数同口径，一律采用定义侧（.vpi 注解段）类型；解析不出指针时保留实参类型。

问题二（实参未对齐 declare）：declare 改用定义侧类型后实参也必须对齐，否则首个调用点
（由它建立 declare、不走 coerce_to_type）原样传具体指针会与 declare 类型不一致（llc 报
argument type mismatch）。⇒ CallGenLib._coerce_arg_value_to_ty 的同层指针分支改为"类型内容
不一致即 bitcast 到定义侧类型"（原判据只覆盖一侧为 i8*、或模板注解来源两种情形）。
 2026-10-01 20:29:15 +08:00
TermiNexus f748cae562 fix(TPV/CallGenCall): 判据化重加兄弟 Mixin 方法解析（修 NoVTableCrossMixinTest 未定义符号） 
现场：Test/NoVTableCrossMixinTest 链接期报
  ld.lld: error: undefined symbol: 1e19037e6cfdce36.BaseB.helper
    >>> referenced by ...(1e19037e6cfdce36.BaseB.caller)
  ld.lld: error: undefined symbol: 1e19037e6cfdce36.MixinC2.mid2
    >>> referenced by ...(1e19037e6cfdce36.MixinC2.outer2)

这是 455c760 删除"兄弟 Mixin 兜底"的必然结果：NoVTable 多继承下，Mixin 内的
self.<兄弟方法>()（Combined(BaseA, BaseB) 中 BaseB.caller 调 BaseA.helper）本类
MRO 查不到、跨模块 stub 也没有 ⇒ 调用名退化成 {sha1}.BaseB.helper（该符号不存在）。

改动（不是恢复原兜底，而是**判据化解析**，不做"同名即绑"的猜测）：
- CallGenCall._translate_method_call：在自身 MRO 查找失败后新增兄弟 Mixin 解析，
  两条**正向判据**缺一不可：
    ① 接收类必须是某个已注册类的**直接父类**（它确实被组合使用，是真 Mixin）——
       挡掉 includes/w32/fileio.vp 的 FileW.__init__ → self.seek() 误绑 File.seek
       （FileW 无人继承，不是任何人的 Mixin）；
    ② 候选类与接收类必须同处某个已注册**组合类的 MRO**（真·兄弟）。
  命中后 found_func / mc_anc 都指向定义类 ⇒ 调用名用定义类 SHA1 前缀（符号存在），
  this 由既有的 mc_anc this-adjust 分支按组合布局前移（该分支未改动）。
  只取**本模块内已有函数**的候选（跨模块定义类需经其 text.ll 取签名，本轮不启用）；
  接收类为跨模块类时不启用（沿用原 sib_recv_local 守卫，避免误绑跨模块同名方法）。
- 新增两个判据辅助方法：_recv_is_mixin_base / _mixin_sibling_same_composite。

待验证：重编译 TransPyV（自举两遍）→ NoVTableCrossMixinTest / WebTest / FileIoTest。
 2026-10-01 15:00:55 +08:00
TermiNexus 455c7608b1 fix(TPV): 方法先声明后定义（消除方法查找的源顺序依赖），删除兄弟 Mixin 兜底 
现场：Test/FileIoTest 编译 includes/w32/fileio.vp 报
  CastError: 源 %"b0721da228be3d55.FileW"* → 目标 %"b0721da228be3d55.File"*
  （指针隐式转指针已禁止：被指类型是非基本类型）

根因（有旧 IR 佐证，非本轮改动引起）：FileW.__init__（源 304 行）里的
self.seek(0, SEEK_END) 被解析成 File.seek，而不是 FileW.seek：
  1) _translate_method 只在方法体翻译时才 create_function，于是方法查找
     （find_func_in_module）依赖方法在类体内的书写顺序：FileW.seek 在源 403 行，
     晚于 __init__ → 查不到 → None；
  2) MRO 无父类 → None；
  3) 兄弟 Mixin 兜底随即遍历全部已注册 struct，取"本模块存在同名方法"的
     第一个候选类 → 命中 File → 绑成 File.seek，self 再被 this-adjust
     bitcast 成 File*。
旧 IR（TransPyV\.tpv_build\temp\b0\b0721da228be3d55.text.ll，mtime 9/27，
早于本轮全部改动）里就是：
  %97 = bitcast %"...FileW"* %96 to %"...File"*
  %98 = call i32 @"...File.seek"(%"...File"* %97, i32 0, i32 2)
即靠一层隐式跨类 bitcast 静默通过；指针规则收紧后以 CastError 报出。
（File.__init__ 的 self.seek 同样查不到，只是兜底恰好扫到 File.seek 而"碰巧正确"。）

改动：
1. ClassGenVTable._translate_oop_methods：翻译方法体之前，先对本类**全部方法**
   跑一遍 sig_only=1 建前向声明（declare + 参数 + 函数表登记）——与
   FuncGenDef.forward_declare_functions 对模块级函数做的事完全同构，
   使方法查找不再依赖类体内的书写顺序。
2. ClassGenVTable._translate_method 新增 sig_only 形参：
   · 签名部分改用 create_declare（IsDeclared=1），已存在同名前向声明则复用；
   · 发射函数体前把 IsDeclared 清零转 define（对齐 FuncGenDef.vp:544-545），
     否则打印端按 IsDeclared 输出 declare、函数体整体丢失；
   · 复用声明时跳过重复的 add_param 与 add_func_to_table；
   · 命中同名函数且 IsDeclared==0（函数体已发射）时直接返回，杜绝重复发射
     （llvmlite.create_function 不做同名去重，旧写法会造 duplicate symbol）。
3. CallGenCall._translate_method_call：按"不兜底、fail-fast"决定，整块删除
   兄弟 Mixin 兜底（遍历 struct 表猜候选类）及其死分支
   （mixin_hit / mixin_ret_ty / mixin_anc_name / mixin_anc_sha1 的声明与消费点）。
   方法未命中即为真未定义，交下方 text.ll / vpi / 本模块豁免路径
   （CallGenCall.vp:962 起的 is_local_mod 分支，从已声明的本模块函数直接取
   返回类型）处理，不再猜候选类。
4. 同步修正 ClassGenVTable 顶部 _translate_method 的注释块与函数文档串。

TPC 侧无需同步：TPC 的声明阶段把类成员全部登记进 SymbolTable，本就不存在
"方法查找依赖源顺序"，也没有这段兄弟 Mixin 扫描（HandlesExprCall.py:3877-3914
的兜底带"调用类自身未声明该方法"守卫，与本次删除的 TPV 版不同）。

待验证（不自行执行编译命令）：重编译 TransPyV（自举需编两遍），再跑
FileIoTest / NoVTableCrossMixinTest / DictTest / 泛型相关测试。
 2026-10-01 13:45:10 +08:00
TermiNexus 3329c9beae fix(TPV/CallGenBase): text.ll 返回类型的命名指针不再坍缩成通用 i8*，修 FakeDuck parts[0] 报整数隐式转指针 
现象（TransPyV 编译 Test/FakeDuckTest）：
  main.vp:115  p0: str = parts[0]
  CastError: 整数隐式转指针已禁止…出错表达式: 下标表达式 Subscript
    （parts = s1.split(',')，s1: str，split 由 includes/_fakeduck.vp 的 _str 提供）

根因链（逐环取证，均落在产物文件上）：
1. _fakeduck.vp:273  `def split(self, delimiter: str) -> list[str]*`。
2. 定义侧产物正确：temp/88/884eaabef9bd161c.text.ll:1775
     define %"b0798adca340002b.list[str]"* @"884eaabef9bd161c._str.split"(...)
   （884eaabef9bd161c = includes/_fakeduck.vp，b0798adca340002b = includes/_list.vp）
3. 调用侧 declare 走了 vpi 注解：temp/88/884eaabef9bd161c.vpi:27
     def split(self, delimiter: str) -> list[str] | t.CPtr: pass
   该联合在 stub 侧解析不出 `list[str]` 这个泛型特化名 ⇒ 坍缩成 i8*（既有设计已知的
   「跨模块 declare 的 list[T] 返回类型被简化」），故 _translate_fakeduck_call 里那条
   「从定义模块 text.ll 读精确返回类型」的兜底（CallGenFd.vp:134-142）必须生效。
4. 但该兜底读到的 `%"b0798adca340002b.list[str]"*` 又被本函数坍缩回 i8*：
   CallGenBase._ParseLLVMRetTyStr 的「含 * 者一律返回通用 Ptr(Int8)」分支
   （原注释："包括 i8*, i32*, %"name"*, { i32, i8 }* 等"）。
5. 于是 parts 的 alloca 退化为 i8* ⇒ parts[0] 走字节下标取到整数 ⇒ 赋给 str 报
   「整数隐式转指针已禁止」（报文指不到真因，正是本问题最难查的地方）。

改动（CallGenBase._ParseLLVMRetTyStr）：
- 新增「命名类型 `%"name"*` / `%name*`」分支：剥引号/空格与尾随 `*`（支持多级），
  先 GenApi.get_struct_type(name)、未命中再 GenApi.get_enum_base_type(name)，命中即
  按星号层数包 Ptr 返回真实结构体/枚举指针；查不到登记项时才保持原来的通用 Ptr(Int8)
  行为（名字可能来自尚未登记的模块，不引入新的静默降级面）。
- 同步更新该函数顶部说明（原写「含 * 者返回通用 Ptr(Int8)」，现区分字面量结构体 /
  命名类型 / 其余）。
- 收益面不限 FakeDuck：所有经 text.ll 取返回类型的方法调用（CallGenCall / CallGenDispatch
  / CallGenProp / CallGenFd 等）都从「指针一律 i8*」变为「命名类指针精确」，
  调用方 alloca 与下标/字段语义不再退化。

待验证（不自行执行编译命令）：用 TransPyV.exe 重跑
  --project ./Test/FakeDuckTest/project.json --clean --clear-cache --rebuild-includes --traceback
预期 115 行不再报错；若仍在 parts2.get(0)（131 行）等处冒新错，请把栈贴回来。
 2026-09-30 23:53:18 +08:00
TermiNexus b289e93650 fix(泛型实参 T* 形): 补齐 T* 消费侧（VpiReader 段解析 / AnnotClassName 提取 / 构造推断） 
唯一规范形 T*（rawptr[T] ≡ t.CPtr[T] ≡ T|t.CPtr，见 83baf5a/2b2b70e）落地后，
所有"读**已归一实参文本**或**结构体名**并做文本解析/嗅探"的点都必须接受 T* 形，
否则会**静默**走错分支（不是报错，更难发现）：

- VpiReader._resolve_single_vpi_type_str：尾随 * 段按层重写回 rawptr[...] 文本形
  再走原分支（与既有 rawptr[ 分支逐字等价）。必须补的原因：_subst_template_arg
  用特化类名 [...] 内的**已归一实参**替换模板注解里的 T，喂进来的就是 {sha}.AST*；
  旧代码只认 rawptr[ / t.CPtr[ / 裸 t.CPtr ⇒ 落到 strrchr('.') 取末段 "AST*"、
  查 struct miss ⇒ 返回 None/i8*，跨模块参数/返回宽度被悄悄收窄。
- ExprGenCls / AssignGenMixin 的 _extract_annot_class_name（各 2 处）：段尾剔除集
  补 '*'，剥后再 find_struct（旧形态 {sha}.AST|t.CPtr 按 '|' 分段能命中，新形态
  不剥则 miss ⇒ 返回 None ⇒ 链式 .get(0).kind() 分派退化）。
- CallGenCtor._infer_generic_ctor_type_arg：新增 _ptr_layer_type_arg —— 先经
  _norm_type_arg_name 归一（保证类名带定义模块 SHA1，否则裸 "AST*" 无法再归一、
  反而新分裂），再按 VarEntry/FieldEntry 的 Spec.PtrLevel 补 '*'，使构造侧推出的
  类型实参与注解侧同票名（否则 Box(x) 这类隐式特化分裂成两个结构体）。
- CallGenDispatch.__sizeof__：'*' 判据由 strrchr 改为**尾随**判定 —— 原写法会把
  list[{sha}.AST*]（元素为指针的容器）误判成指针并返回 8。

现场：Test/AstTest/App/main.vp:21 的 list[ast.AST | t.CPtr] | t.CPtr 特化链
（→ includes/_list.vp:36 T.__sizeof__()）。
 2026-09-30 21:16:48 +08:00