CHANGELOG - go/js

v1.5.2 (2026-06-08)

API 增强: 脚本版本管理与发现:
- Define 方法现在支持可选的 name 和 version (int64) 参数。
- 增加 CheckVersion(name string, version int64) bool 用于检查脚本是否已加载且版本匹配，减少重复加载。
- 实现 FuncList() []string，支持动态发现脚本中定义的函数名（基于正则提取）。
执行安全: Context 中断支持:
- Call 方法现在支持 context.Context 中断。如果 context 被取消或超时，JS 执行将被立即中断。
性能优化:
- 优化 createNewRuntime 中的反射检查逻辑。
- 优化 Call 方法，在 Context 不可取消时避免创建额外的 goroutine。
稳定性:
- 完善 Pool 状态上报，包含已加载脚本和函数数量。

架构重构: 多例支持与优雅停机:
- 引入 Pool 结构体，支持通过 js.NewPool() 创建相互隔离的执行环境，避免业务间脚本冲突。
- 实现 starter.Service 接口（Start, Stop, Status），支持集成到基础设施生命周期管理中。
- 优化优雅停机逻辑：Stop 会自动阻塞并等待所有活跃的 JS 调用完成，或直到 Context 超时。
文档增强: AI/IDE 丝滑对齐:
- 彻底重写 js.Doc()，采用 declare const go 全局声明，支持 VSCode 零配置代码提示。
- 穿透防护: 自动识别并拦截非项目路径下的结构体，统一映射为 GoPkg_Name 不透明句柄。
- 方法提纯: 自动过滤涉及 io.Reader/Writer、reflect、sync 等 JS 无法处理的底层方法。
- 放行 time.Time: 开放时间对象的方法反射，支持 JS 直接调用 Unix(), Format() 等业务方法。
- 隐式类型导出: 支持 __export 命名前缀，用于导出类型结构而不暴露工厂函数。
稳定性: 修复了基于原始类型别名（如 time.Month）导致反射崩溃的问题。