@faapi/faapi 3.2.0 → 3.2.1

package/dist/index.d.ts

@@ -607,17 +607,28 @@ interface WsContext {
 type WsHandler = (ctx: WsContext) => WsEventHandlers | void;
 
 /**
- * 清理所有 Program 缓存（watch 模式下文件变化时调用）
+ * 清理所有 Program 缓存 + tsconfig 解析缓存（watch 模式下文件变化时调用）
  *
  * 全量清理而非增量清理，理由：
  * - 简单可靠，无状态一致性问题
  * - 跨文件类型引用需要所有文件的 Program 同步更新
+ * - tsconfig 可能变化，需重新读取
  * - dev 模式文件量有限，全量重建在百毫秒级
  */
 declare function invalidateProgramCache(): void;
 /**
  * 为指定文件创建 TypeScript Program（带缓存）
  *
+ * 从 filePath 向上查找最近的 tsconfig.json：
+ * - 找到：用 ts.parseJsonConfigFileContent 解析，取 module / moduleResolution
+ *   覆盖默认值，同时取 parsed.fileNames 作为 program 的 rootNames（让跨文件
+ *   import 的源文件被加载进 program）
+ * - 找不到（如 os.tmpdir() 测试场景）：回退到默认 NodeNext，rootNames 仅包含 filePath
+ *
+ * 加载全部相关文件保证 `resolveTypeReference` 的兜底遍历（找同名声明）能成功，
+ * 修复业务项目用 `moduleResolution: Bundler` + 无扩展名相对导入时跨文件
+ * `import type` 解析失败的问题。
+ *
  * @param filePath 要分析的 .ts 文件绝对路径
  */
 declare function createProgram(filePath: string): ts.Program;