@aipanel/core 1.3.2 → 1.3.3

package/es/node/diagnostics.d.ts

@@ -49,10 +49,11 @@ export declare function lintFiles(pattern: string, cwd: string, warnLimit?: numb
 export declare function findTsconfigDir(filePath: string): string | null;
 /** 在工作区子目录中查找 tsconfig.json（不包括根目录；调用方已处理根目录场景） */
 export declare function findAllTsconfigDirs(workspace: string): string[];
-/** 运行 TypeScript 类型检查（tsc / vue-tsc 按项目自动选择）--build --noEmit，返回原始输出 */
+/** 运行 TypeScript 类型检查（引擎按项目自动选择，优先项目自身版本），返回原始输出 */
 export declare function runTypeCheck(filePath: string | undefined, cwd: string): Promise<TscResult>;
 /**
- * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只跑一次 `--build --noEmit`，
+ * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只检查一次
+ * （TS >= 5.6 为一次 `--build --noEmit`，更早的 TS 按 references 逐项目 `-p`），
  * 再把项目输出切分回各文件（与单文件路径共用 filterTscOutputForFile）。
  * 一次编辑批次里的 N 个文件因此从 N 次项目构建降到 1 次。
  */

package/es/node/diagnostics.mjs

@@ -32,23 +32,48 @@ const DIAGNOSTICS_TOOL_DESCRIPTION = [
   "- \u6392\u67E5\u7F16\u8F91\u5668\u672A\u663E\u793A\u4F46\u5B9E\u9645\u5B58\u5728\u7684\u7C7B\u578B\u95EE\u9898",
   "- \u4E0D\u4F20\u53C2\u6570\u53EF\u5168\u91CF\u8BCA\u65AD\u6574\u4E2A\u9879\u76EE"
 ].join("\n");
-let ESLintClass;
+function cachedResolve(cache, key, resolve) {
+  const hit = cache.get(key);
+  if (hit !== void 0) return hit;
+  const value = resolve();
+  cache.set(key, value);
+  return value;
+}
+const _packageBinCache = /* @__PURE__ */ new Map();
+function resolvePackageBin(basePkgJson, pkgName, binName) {
+  return cachedResolve(_packageBinCache, `${basePkgJson}\0${pkgName}`, () => {
+    try {
+      const req = createRequire(basePkgJson);
+      const pkgJsonPath = req.resolve(`${pkgName}/package.json`);
+      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+      const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.[binName];
+      return binRel ? path.join(path.dirname(pkgJsonPath), binRel) : null;
+    } catch {
+      return null;
+    }
+  });
+}
+const _eslintClassByBase = /* @__PURE__ */ new Map();
 function loadESLint(workspace) {
-  if (ESLintClass) return;
-  log.debug("Loading eslint", { workspace });
-  try {
-    const req = createRequire(path.join(workspace, "package.json"));
-    const eslintModule = req("eslint");
-    ESLintClass ?? (ESLintClass = eslintModule.ESLint ?? eslintModule.FlatESLint);
-    log.debug("eslint loaded", { hasClass: !!ESLintClass });
-  } catch (e) {
-    log.warn("eslint not found", { error: e.message });
-  }
+  const basePkgJson = path.join(workspace, "package.json");
+  return cachedResolve(_eslintClassByBase, basePkgJson, () => {
+    log.debug("Loading eslint", { workspace });
+    try {
+      const req = createRequire(basePkgJson);
+      const eslintModule = req("eslint");
+      const eslintClass = eslintModule.ESLint ?? eslintModule.FlatESLint ?? null;
+      log.debug("eslint loaded", { hasClass: !!eslintClass });
+      return eslintClass;
+    } catch (e) {
+      log.warn("eslint not found", { error: e.message });
+      return null;
+    }
+  });
 }
 async function lintFiles(pattern, cwd, warnLimit = 5) {
-  loadESLint(cwd);
+  const eslintClass = loadESLint(cwd);
   const [eslintOutput, oxlintOutput] = await Promise.all([
-    ESLintClass ? runEslintFiles(pattern, cwd, warnLimit) : Promise.resolve(null),
+    eslintClass ? runEslintFiles(eslintClass, pattern, cwd, warnLimit) : Promise.resolve(null),
     runOxlintFiles(pattern, cwd, warnLimit)
   ]);
   const engines = [];
@@ -108,9 +133,9 @@ function formatLintMessages(messages, engine, warnLimit) {
     engines: [engine.label]
   };
 }
-async function runEslintFiles(pattern, cwd, warnLimit) {
+async function runEslintFiles(eslintClass, pattern, cwd, warnLimit) {
   try {
-    const eslint = new ESLintClass({ cwd });
+    const eslint = new eslintClass({ cwd });
     const results = await eslint.lintFiles(pattern);
     const messages = results.flatMap(
       (r) => (r.messages ?? []).map((m) => ({ ...m, filePath: r.filePath }))
@@ -130,19 +155,8 @@ async function runEslintFiles(pattern, cwd, warnLimit) {
     };
   }
 }
-let _oxlintBin;
 function resolveOxlintBin(workspace) {
-  if (_oxlintBin !== void 0) return _oxlintBin;
-  try {
-    const req = createRequire(path.join(workspace, "package.json"));
-    const pkgJsonPath = req.resolve("oxlint/package.json");
-    const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
-    const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.oxlint;
-    _oxlintBin = binRel ? path.join(path.dirname(pkgJsonPath), binRel) : null;
-  } catch {
-    _oxlintBin = null;
-  }
-  return _oxlintBin;
+  return resolvePackageBin(path.join(workspace, "package.json"), "oxlint", "oxlint");
 }
 function oxlintRuleName(code) {
   if (!code) return null;
@@ -219,18 +233,9 @@ async function runOxlintFiles(pattern, cwd, warnLimit) {
     };
   }
 }
-let _vueTscBin;
-function resolveVueTscBin() {
-  if (_vueTscBin !== void 0) return _vueTscBin;
-  try {
-    const req = createRequire(import.meta.url);
-    _vueTscBin = req.resolve("vue-tsc/bin/vue-tsc.js");
-  } catch {
-    _vueTscBin = null;
-  }
-  return _vueTscBin;
-}
-const _tscBinByPkgDir = /* @__PURE__ */ new Map();
+const BUNDLED_ENGINE_KEY = "<bundled>";
+const _engineCache = /* @__PURE__ */ new Map();
+const _tsVersionCache = /* @__PURE__ */ new Map();
 function nearestPackageJsonDir(startDir) {
   let dir = path.resolve(startDir);
   while (true) {
@@ -249,26 +254,53 @@ function isVuePackage(pkgDir) {
     return false;
   }
 }
-function resolveTypeCheckBin(projectDir) {
-  const pkgDir = nearestPackageJsonDir(projectDir);
-  if (!pkgDir || isVuePackage(pkgDir)) {
-    const bin2 = resolveVueTscBin();
-    return bin2 ? { bin: bin2, source: "vue-tsc" } : null;
+function readPackageMeta(pkgJsonPath) {
+  try {
+    return JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+  } catch {
+    return null;
   }
-  let bin = _tscBinByPkgDir.get(pkgDir);
-  if (bin === void 0) {
+}
+function resolveEngineTsVersion(bin) {
+  const pkgDir = nearestPackageJsonDir(path.dirname(bin));
+  if (!pkgDir) return null;
+  return cachedResolve(_tsVersionCache, pkgDir, () => {
+    const own = readPackageMeta(path.join(pkgDir, "package.json"));
+    if (own?.name === "typescript" && own.version) return own.version;
     try {
       const req = createRequire(path.join(pkgDir, "package.json"));
-      bin = req.resolve("typescript/bin/tsc");
+      return readPackageMeta(req.resolve("typescript/package.json"))?.version ?? null;
     } catch {
-      bin = null;
+      return null;
     }
-    _tscBinByPkgDir.set(pkgDir, bin);
-    if (!bin) log.debug("workspace tsc not resolvable, fallback to vue-tsc", { pkgDir });
-  }
-  if (bin) return { bin, source: "tsc" };
-  const vueBin = resolveVueTscBin();
-  return vueBin ? { bin: vueBin, source: "vue-tsc" } : null;
+  });
+}
+function toEngine(bin, source, origin) {
+  return bin ? { bin, source, origin, tsVersion: resolveEngineTsVersion(bin) } : null;
+}
+function resolveWorkspaceEngine(pkgDir, kind) {
+  const basePkgJson = path.join(pkgDir, "package.json");
+  return kind === "tsc" ? toEngine(resolvePackageBin(basePkgJson, "typescript", "tsc"), "tsc", "workspace") : toEngine(resolvePackageBin(basePkgJson, "vue-tsc", "vue-tsc"), "vue-tsc", "workspace");
+}
+function resolveBundledVueTscEngine() {
+  return toEngine(resolvePackageBin(import.meta.url, "vue-tsc", "vue-tsc"), "vue-tsc", "bundled");
+}
+function resolveTypeCheckEngine(projectDir) {
+  const pkgDir = nearestPackageJsonDir(projectDir);
+  return cachedResolve(_engineCache, pkgDir ?? BUNDLED_ENGINE_KEY, () => {
+    if (!pkgDir) return resolveBundledVueTscEngine();
+    const candidates = isVuePackage(pkgDir) ? [resolveWorkspaceEngine(pkgDir, "vue-tsc")] : [resolveWorkspaceEngine(pkgDir, "tsc"), resolveWorkspaceEngine(pkgDir, "vue-tsc")];
+    for (const engine of candidates) {
+      if (engine) return engine;
+    }
+    return resolveBundledVueTscEngine();
+  });
+}
+const BUILD_NO_EMIT_MIN_TS = { major: 5, minor: 6 };
+function supportsBuildNoEmit(tsVersion) {
+  if (!tsVersion) return false;
+  const [major, minor] = tsVersion.split(".").map((part) => Number.parseInt(part, 10));
+  return major > BUILD_NO_EMIT_MIN_TS.major || major === BUILD_NO_EMIT_MIN_TS.major && minor >= BUILD_NO_EMIT_MIN_TS.minor;
 }
 function findTsconfigDir(filePath) {
   const resolved = path.resolve(filePath);
@@ -358,6 +390,77 @@ function filterTscOutputForFile(rawOutput, filePath, projectDir) {
   }
   return filtered.join("\n");
 }
+async function readResolvedTsconfig(engine, configPath, projectDir) {
+  const result = await execa(
+    "node",
+    [
+      engine.bin,
+      "-p",
+      projectRelativeConfig(projectDir, configPath),
+      "--showConfig",
+      "--pretty",
+      "false"
+    ],
+    { cwd: projectDir, timeout: 3e4, maxBuffer: 10 * 1024 * 1024, reject: false }
+  ).catch(() => null);
+  if (!result || result.timedOut || result.isTerminated || result.isMaxBuffer) return null;
+  const stdout = result.stdout ?? "";
+  const start = stdout.indexOf("{");
+  const end = stdout.lastIndexOf("}");
+  if (start < 0 || end <= start) return null;
+  try {
+    return JSON.parse(stdout.slice(start, end + 1));
+  } catch {
+    return null;
+  }
+}
+async function resolveProjectConfigs(engine, projectDir) {
+  const configs = [];
+  const visited = /* @__PURE__ */ new Set();
+  const visit = async (configPath) => {
+    const resolved = path.resolve(configPath);
+    if (visited.has(resolved)) return;
+    visited.add(resolved);
+    const config = await readResolvedTsconfig(engine, resolved, projectDir);
+    const hasProgram = !config || (config.files?.length ?? 0) > 0 || (config.include?.length ?? 0) > 0;
+    if (hasProgram) configs.push(resolved);
+    for (const ref of config?.references ?? []) {
+      if (ref.path) await visit(path.resolve(path.dirname(resolved), ref.path));
+    }
+  };
+  const rootConfig = path.join(projectDir, "tsconfig.json");
+  await visit(fs.existsSync(rootConfig) ? rootConfig : projectDir);
+  return configs;
+}
+function projectRelativeConfig(projectDir, configPath) {
+  return path.relative(projectDir, configPath) || ".";
+}
+async function typeCheckArgGroups(engine, projectDir) {
+  const pretty = ["--pretty", "false"];
+  if (supportsBuildNoEmit(engine.tsVersion)) return [["--build", "--noEmit", ...pretty]];
+  const configs = await resolveProjectConfigs(engine, projectDir);
+  return configs.map((config) => [
+    "-p",
+    projectRelativeConfig(projectDir, config),
+    "--noEmit",
+    ...pretty
+  ]);
+}
+async function runTypeCheckCli(engine, args, cwd, timeout, maxBuffer) {
+  const result = await execa("node", [engine.bin, ...args], {
+    cwd,
+    timeout,
+    maxBuffer,
+    reject: false
+  });
+  let rawOutput = result.stdout + result.stderr;
+  const killed = result.timedOut || result.isTerminated || result.isMaxBuffer;
+  const exitCode = typeof result.exitCode === "number" ? result.exitCode : killed ? 1 : 0;
+  if (killed && !rawOutput) {
+    rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
+  }
+  return { rawOutput, exitCode };
+}
 async function runTypeCheck(filePath, cwd) {
   const dir = cwd;
   const projectDir = filePath ? findTsconfigDir(filePath) ?? dir : dir;
@@ -367,31 +470,27 @@ async function runTypeCheck(filePath, cwd) {
     projectDir,
     processCwd: process.cwd()
   });
-  const engine = resolveTypeCheckBin(projectDir);
+  const engine = resolveTypeCheckEngine(projectDir);
   if (!engine) {
     log.warn("type-check bin not found", { projectDir });
     return { rawOutput: "", exitCode: 0 };
   }
   const timeout = filePath ? 6e4 : 12e4;
   const maxBuffer = filePath ? 10 * 1024 * 1024 : 50 * 1024 * 1024;
-  const result = await execa("node", [engine.bin, "--build", "--noEmit", "--pretty", "false"], {
-    cwd: projectDir,
-    timeout,
-    maxBuffer,
-    reject: false
-  });
-  let rawOutput = result.stdout + result.stderr;
-  const killed = result.timedOut || result.isTerminated || result.isMaxBuffer;
-  const exitCode = typeof result.exitCode === "number" ? result.exitCode : killed ? 1 : 0;
-  if (killed && !rawOutput) {
-    rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
-  }
+  const argGroups = await typeCheckArgGroups(engine, projectDir);
+  const results = await Promise.all(
+    argGroups.map((args) => runTypeCheckCli(engine, args, projectDir, timeout, maxBuffer))
+  );
+  let rawOutput = results.map((result) => result.rawOutput).filter(Boolean).join("\n");
+  const exitCode = results.reduce((max, result) => Math.max(max, result.exitCode), 0);
   const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
   if (filePath) {
     rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
   }
   log.debug("type-check finished", {
     engine: engine.source,
+    engineOrigin: engine.origin,
+    tsVersion: engine.tsVersion,
     filePath: filePath || "(all)",
     exitCode,
     outputLength: rawOutput.length

package/lib/node/diagnostics.cjs

@@ -78,23 +78,48 @@ const DIAGNOSTICS_TOOL_DESCRIPTION = [
   "- \u6392\u67E5\u7F16\u8F91\u5668\u672A\u663E\u793A\u4F46\u5B9E\u9645\u5B58\u5728\u7684\u7C7B\u578B\u95EE\u9898",
   "- \u4E0D\u4F20\u53C2\u6570\u53EF\u5168\u91CF\u8BCA\u65AD\u6574\u4E2A\u9879\u76EE"
 ].join("\n");
-let ESLintClass;
+function cachedResolve(cache, key, resolve) {
+  const hit = cache.get(key);
+  if (hit !== void 0) return hit;
+  const value = resolve();
+  cache.set(key, value);
+  return value;
+}
+const _packageBinCache = /* @__PURE__ */ new Map();
+function resolvePackageBin(basePkgJson, pkgName, binName) {
+  return cachedResolve(_packageBinCache, `${basePkgJson}\0${pkgName}`, () => {
+    try {
+      const req = (0, import_node_module.createRequire)(basePkgJson);
+      const pkgJsonPath = req.resolve(`${pkgName}/package.json`);
+      const pkg = JSON.parse(import_node_fs.default.readFileSync(pkgJsonPath, "utf8"));
+      const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.[binName];
+      return binRel ? import_node_path.default.join(import_node_path.default.dirname(pkgJsonPath), binRel) : null;
+    } catch {
+      return null;
+    }
+  });
+}
+const _eslintClassByBase = /* @__PURE__ */ new Map();
 function loadESLint(workspace) {
-  if (ESLintClass) return;
-  log.debug("Loading eslint", { workspace });
-  try {
-    const req = (0, import_node_module.createRequire)(import_node_path.default.join(workspace, "package.json"));
-    const eslintModule = req("eslint");
-    ESLintClass ?? (ESLintClass = eslintModule.ESLint ?? eslintModule.FlatESLint);
-    log.debug("eslint loaded", { hasClass: !!ESLintClass });
-  } catch (e) {
-    log.warn("eslint not found", { error: e.message });
-  }
+  const basePkgJson = import_node_path.default.join(workspace, "package.json");
+  return cachedResolve(_eslintClassByBase, basePkgJson, () => {
+    log.debug("Loading eslint", { workspace });
+    try {
+      const req = (0, import_node_module.createRequire)(basePkgJson);
+      const eslintModule = req("eslint");
+      const eslintClass = eslintModule.ESLint ?? eslintModule.FlatESLint ?? null;
+      log.debug("eslint loaded", { hasClass: !!eslintClass });
+      return eslintClass;
+    } catch (e) {
+      log.warn("eslint not found", { error: e.message });
+      return null;
+    }
+  });
 }
 async function lintFiles(pattern, cwd, warnLimit = 5) {
-  loadESLint(cwd);
+  const eslintClass = loadESLint(cwd);
   const [eslintOutput, oxlintOutput] = await Promise.all([
-    ESLintClass ? runEslintFiles(pattern, cwd, warnLimit) : Promise.resolve(null),
+    eslintClass ? runEslintFiles(eslintClass, pattern, cwd, warnLimit) : Promise.resolve(null),
     runOxlintFiles(pattern, cwd, warnLimit)
   ]);
   const engines = [];
@@ -154,9 +179,9 @@ function formatLintMessages(messages, engine, warnLimit) {
     engines: [engine.label]
   };
 }
-async function runEslintFiles(pattern, cwd, warnLimit) {
+async function runEslintFiles(eslintClass, pattern, cwd, warnLimit) {
   try {
-    const eslint = new ESLintClass({ cwd });
+    const eslint = new eslintClass({ cwd });
     const results = await eslint.lintFiles(pattern);
     const messages = results.flatMap(
       (r) => (r.messages ?? []).map((m) => ({ ...m, filePath: r.filePath }))
@@ -176,19 +201,8 @@ async function runEslintFiles(pattern, cwd, warnLimit) {
     };
   }
 }
-let _oxlintBin;
 function resolveOxlintBin(workspace) {
-  if (_oxlintBin !== void 0) return _oxlintBin;
-  try {
-    const req = (0, import_node_module.createRequire)(import_node_path.default.join(workspace, "package.json"));
-    const pkgJsonPath = req.resolve("oxlint/package.json");
-    const pkg = JSON.parse(import_node_fs.default.readFileSync(pkgJsonPath, "utf8"));
-    const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.oxlint;
-    _oxlintBin = binRel ? import_node_path.default.join(import_node_path.default.dirname(pkgJsonPath), binRel) : null;
-  } catch {
-    _oxlintBin = null;
-  }
-  return _oxlintBin;
+  return resolvePackageBin(import_node_path.default.join(workspace, "package.json"), "oxlint", "oxlint");
 }
 function oxlintRuleName(code) {
   if (!code) return null;
@@ -265,18 +279,9 @@ async function runOxlintFiles(pattern, cwd, warnLimit) {
     };
   }
 }
-let _vueTscBin;
-function resolveVueTscBin() {
-  if (_vueTscBin !== void 0) return _vueTscBin;
-  try {
-    const req = (0, import_node_module.createRequire)(import_meta.url);
-    _vueTscBin = req.resolve("vue-tsc/bin/vue-tsc.js");
-  } catch {
-    _vueTscBin = null;
-  }
-  return _vueTscBin;
-}
-const _tscBinByPkgDir = /* @__PURE__ */ new Map();
+const BUNDLED_ENGINE_KEY = "<bundled>";
+const _engineCache = /* @__PURE__ */ new Map();
+const _tsVersionCache = /* @__PURE__ */ new Map();
 function nearestPackageJsonDir(startDir) {
   let dir = import_node_path.default.resolve(startDir);
   while (true) {
@@ -295,26 +300,53 @@ function isVuePackage(pkgDir) {
     return false;
   }
 }
-function resolveTypeCheckBin(projectDir) {
-  const pkgDir = nearestPackageJsonDir(projectDir);
-  if (!pkgDir || isVuePackage(pkgDir)) {
-    const bin2 = resolveVueTscBin();
-    return bin2 ? { bin: bin2, source: "vue-tsc" } : null;
+function readPackageMeta(pkgJsonPath) {
+  try {
+    return JSON.parse(import_node_fs.default.readFileSync(pkgJsonPath, "utf8"));
+  } catch {
+    return null;
   }
-  let bin = _tscBinByPkgDir.get(pkgDir);
-  if (bin === void 0) {
+}
+function resolveEngineTsVersion(bin) {
+  const pkgDir = nearestPackageJsonDir(import_node_path.default.dirname(bin));
+  if (!pkgDir) return null;
+  return cachedResolve(_tsVersionCache, pkgDir, () => {
+    const own = readPackageMeta(import_node_path.default.join(pkgDir, "package.json"));
+    if (own?.name === "typescript" && own.version) return own.version;
     try {
       const req = (0, import_node_module.createRequire)(import_node_path.default.join(pkgDir, "package.json"));
-      bin = req.resolve("typescript/bin/tsc");
+      return readPackageMeta(req.resolve("typescript/package.json"))?.version ?? null;
     } catch {
-      bin = null;
+      return null;
     }
-    _tscBinByPkgDir.set(pkgDir, bin);
-    if (!bin) log.debug("workspace tsc not resolvable, fallback to vue-tsc", { pkgDir });
-  }
-  if (bin) return { bin, source: "tsc" };
-  const vueBin = resolveVueTscBin();
-  return vueBin ? { bin: vueBin, source: "vue-tsc" } : null;
+  });
+}
+function toEngine(bin, source, origin) {
+  return bin ? { bin, source, origin, tsVersion: resolveEngineTsVersion(bin) } : null;
+}
+function resolveWorkspaceEngine(pkgDir, kind) {
+  const basePkgJson = import_node_path.default.join(pkgDir, "package.json");
+  return kind === "tsc" ? toEngine(resolvePackageBin(basePkgJson, "typescript", "tsc"), "tsc", "workspace") : toEngine(resolvePackageBin(basePkgJson, "vue-tsc", "vue-tsc"), "vue-tsc", "workspace");
+}
+function resolveBundledVueTscEngine() {
+  return toEngine(resolvePackageBin(import_meta.url, "vue-tsc", "vue-tsc"), "vue-tsc", "bundled");
+}
+function resolveTypeCheckEngine(projectDir) {
+  const pkgDir = nearestPackageJsonDir(projectDir);
+  return cachedResolve(_engineCache, pkgDir ?? BUNDLED_ENGINE_KEY, () => {
+    if (!pkgDir) return resolveBundledVueTscEngine();
+    const candidates = isVuePackage(pkgDir) ? [resolveWorkspaceEngine(pkgDir, "vue-tsc")] : [resolveWorkspaceEngine(pkgDir, "tsc"), resolveWorkspaceEngine(pkgDir, "vue-tsc")];
+    for (const engine of candidates) {
+      if (engine) return engine;
+    }
+    return resolveBundledVueTscEngine();
+  });
+}
+const BUILD_NO_EMIT_MIN_TS = { major: 5, minor: 6 };
+function supportsBuildNoEmit(tsVersion) {
+  if (!tsVersion) return false;
+  const [major, minor] = tsVersion.split(".").map((part) => Number.parseInt(part, 10));
+  return major > BUILD_NO_EMIT_MIN_TS.major || major === BUILD_NO_EMIT_MIN_TS.major && minor >= BUILD_NO_EMIT_MIN_TS.minor;
 }
 function findTsconfigDir(filePath) {
   const resolved = import_node_path.default.resolve(filePath);
@@ -404,6 +436,77 @@ function filterTscOutputForFile(rawOutput, filePath, projectDir) {
   }
   return filtered.join("\n");
 }
+async function readResolvedTsconfig(engine, configPath, projectDir) {
+  const result = await (0, import_execa.execa)(
+    "node",
+    [
+      engine.bin,
+      "-p",
+      projectRelativeConfig(projectDir, configPath),
+      "--showConfig",
+      "--pretty",
+      "false"
+    ],
+    { cwd: projectDir, timeout: 3e4, maxBuffer: 10 * 1024 * 1024, reject: false }
+  ).catch(() => null);
+  if (!result || result.timedOut || result.isTerminated || result.isMaxBuffer) return null;
+  const stdout = result.stdout ?? "";
+  const start = stdout.indexOf("{");
+  const end = stdout.lastIndexOf("}");
+  if (start < 0 || end <= start) return null;
+  try {
+    return JSON.parse(stdout.slice(start, end + 1));
+  } catch {
+    return null;
+  }
+}
+async function resolveProjectConfigs(engine, projectDir) {
+  const configs = [];
+  const visited = /* @__PURE__ */ new Set();
+  const visit = async (configPath) => {
+    const resolved = import_node_path.default.resolve(configPath);
+    if (visited.has(resolved)) return;
+    visited.add(resolved);
+    const config = await readResolvedTsconfig(engine, resolved, projectDir);
+    const hasProgram = !config || (config.files?.length ?? 0) > 0 || (config.include?.length ?? 0) > 0;
+    if (hasProgram) configs.push(resolved);
+    for (const ref of config?.references ?? []) {
+      if (ref.path) await visit(import_node_path.default.resolve(import_node_path.default.dirname(resolved), ref.path));
+    }
+  };
+  const rootConfig = import_node_path.default.join(projectDir, "tsconfig.json");
+  await visit(import_node_fs.default.existsSync(rootConfig) ? rootConfig : projectDir);
+  return configs;
+}
+function projectRelativeConfig(projectDir, configPath) {
+  return import_node_path.default.relative(projectDir, configPath) || ".";
+}
+async function typeCheckArgGroups(engine, projectDir) {
+  const pretty = ["--pretty", "false"];
+  if (supportsBuildNoEmit(engine.tsVersion)) return [["--build", "--noEmit", ...pretty]];
+  const configs = await resolveProjectConfigs(engine, projectDir);
+  return configs.map((config) => [
+    "-p",
+    projectRelativeConfig(projectDir, config),
+    "--noEmit",
+    ...pretty
+  ]);
+}
+async function runTypeCheckCli(engine, args, cwd, timeout, maxBuffer) {
+  const result = await (0, import_execa.execa)("node", [engine.bin, ...args], {
+    cwd,
+    timeout,
+    maxBuffer,
+    reject: false
+  });
+  let rawOutput = result.stdout + result.stderr;
+  const killed = result.timedOut || result.isTerminated || result.isMaxBuffer;
+  const exitCode = typeof result.exitCode === "number" ? result.exitCode : killed ? 1 : 0;
+  if (killed && !rawOutput) {
+    rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
+  }
+  return { rawOutput, exitCode };
+}
 async function runTypeCheck(filePath, cwd) {
   const dir = cwd;
   const projectDir = filePath ? findTsconfigDir(filePath) ?? dir : dir;
@@ -413,31 +516,27 @@ async function runTypeCheck(filePath, cwd) {
     projectDir,
     processCwd: process.cwd()
   });
-  const engine = resolveTypeCheckBin(projectDir);
+  const engine = resolveTypeCheckEngine(projectDir);
   if (!engine) {
     log.warn("type-check bin not found", { projectDir });
     return { rawOutput: "", exitCode: 0 };
   }
   const timeout = filePath ? 6e4 : 12e4;
   const maxBuffer = filePath ? 10 * 1024 * 1024 : 50 * 1024 * 1024;
-  const result = await (0, import_execa.execa)("node", [engine.bin, "--build", "--noEmit", "--pretty", "false"], {
-    cwd: projectDir,
-    timeout,
-    maxBuffer,
-    reject: false
-  });
-  let rawOutput = result.stdout + result.stderr;
-  const killed = result.timedOut || result.isTerminated || result.isMaxBuffer;
-  const exitCode = typeof result.exitCode === "number" ? result.exitCode : killed ? 1 : 0;
-  if (killed && !rawOutput) {
-    rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
-  }
+  const argGroups = await typeCheckArgGroups(engine, projectDir);
+  const results = await Promise.all(
+    argGroups.map((args) => runTypeCheckCli(engine, args, projectDir, timeout, maxBuffer))
+  );
+  let rawOutput = results.map((result) => result.rawOutput).filter(Boolean).join("\n");
+  const exitCode = results.reduce((max, result) => Math.max(max, result.exitCode), 0);
   const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
   if (filePath) {
     rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
   }
   log.debug("type-check finished", {
     engine: engine.source,
+    engineOrigin: engine.origin,
+    tsVersion: engine.tsVersion,
     filePath: filePath || "(all)",
     exitCode,
     outputLength: rawOutput.length

package/lib/node/diagnostics.d.ts

@@ -49,10 +49,11 @@ export declare function lintFiles(pattern: string, cwd: string, warnLimit?: numb
 export declare function findTsconfigDir(filePath: string): string | null;
 /** 在工作区子目录中查找 tsconfig.json（不包括根目录；调用方已处理根目录场景） */
 export declare function findAllTsconfigDirs(workspace: string): string[];
-/** 运行 TypeScript 类型检查（tsc / vue-tsc 按项目自动选择）--build --noEmit，返回原始输出 */
+/** 运行 TypeScript 类型检查（引擎按项目自动选择，优先项目自身版本），返回原始输出 */
 export declare function runTypeCheck(filePath: string | undefined, cwd: string): Promise<TscResult>;
 /**
- * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只跑一次 `--build --noEmit`，
+ * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只检查一次
+ * （TS >= 5.6 为一次 `--build --noEmit`，更早的 TS 按 references 逐项目 `-p`），
  * 再把项目输出切分回各文件（与单文件路径共用 filterTscOutputForFile）。
  * 一次编辑批次里的 N 个文件因此从 N 次项目构建降到 1 次。
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",