@faapi/faapi 3.2.1 → 4.0.0

package/dist/testing.js

@@ -129,14 +129,14 @@ var ValidationError = class extends FaapiError {
   issues;
 };
 var RouteNotFoundError = class extends FaapiError {
-  constructor(path12) {
-    super("ROUTE_NOT_FOUND", `Route not found: ${path12}`, 404);
+  constructor(path15) {
+    super("ROUTE_NOT_FOUND", `Route not found: ${path15}`, 404);
     this.name = "RouteNotFoundError";
   }
 };
 var MethodNotAllowedError = class extends FaapiError {
-  constructor(method, path12, allowedMethods) {
-    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path12}`, 405);
+  constructor(method, path15, allowedMethods) {
+    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path15}`, 405);
     this.allowedMethods = allowedMethods;
     this.name = "MethodNotAllowedError";
   }
@@ -205,10 +205,14 @@ function formatErrorResponse(error, config) {
       code: error.code,
       message: error.message
     });
-    const bodyObj = typeof body2 === "object" && body2 !== null ? body2 : { error: body2 };
-    const errorObj = bodyObj.error ?? bodyObj;
-    if (errorObj) {
-      errorObj.issues = error.issues;
+    const bodyObj = typeof body2 === "object" && body2 !== null ? { ...body2 } : { error: body2 };
+    const existingError = bodyObj.error;
+    if (existingError && typeof existingError === "object") {
+      bodyObj.error = { ...existingError, issues: error.issues };
+    } else if (typeof body2 === "object" && body2 !== null) {
+      bodyObj.issues = error.issues;
+    } else {
+      bodyObj.error = { issues: error.issues };
     }
     return jsonOk(bodyObj, error.statusCode);
   }
@@ -265,8 +269,10 @@ function formatSetCookie(name, value, options) {
   if (options?.sameSite) cookie += `; SameSite=${options.sameSite}`;
   return cookie;
 }
-function createContext(request, params, config = {}, ip = "") {
-  const url = new URL(request.url);
+function createContext(request, params, config = {}, ip = "", registries) {
+  return createContextFromUrl(request, new URL(request.url), params, config, ip, registries);
+}
+function createContextFromUrl(request, url, params, config = {}, ip = "", registries) {
   const meta = { headers: {}, setCookies: [] };
   const parsedCookies = parseCookies(request.headers.get("cookie") ?? "");
   const cookiesObj = {};
@@ -363,6 +369,9 @@ function createContext(request, params, config = {}, ip = "") {
       return formatFailResponse(options, config);
     }
   };
+  if (registries) {
+    ctx.registries = registries;
+  }
   const extend = config?.extendContext;
   if (typeof extend === "function") {
     extend(ctx);
@@ -370,8 +379,17 @@ function createContext(request, params, config = {}, ip = "") {
   return ctx;
 }
 function createTestContext(options) {
-  const { method = "GET", path: path12, query, headers, params = {}, config = {}, ip = "" } = options;
-  const url = new URL(`http://localhost${path12}`);
+  const {
+    method = "GET",
+    path: path15,
+    query,
+    headers,
+    params = {},
+    config = {},
+    ip = "",
+    registries
+  } = options;
+  const url = new URL(`http://localhost${path15}`);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       if (Array.isArray(value)) {
@@ -387,7 +405,7 @@ function createTestContext(options) {
     method,
     headers
   });
-  return createContext(request, params, config, ip);
+  return createContext(request, params, config, ip, registries);
 }
 
 // src/utils/isPlainObject.ts
@@ -402,6 +420,25 @@ function isPlainObject(value) {
   return proto === null || proto === Object.prototype;
 }
 
+// src/response/pendingMeta.ts
+var pending = /* @__PURE__ */ new WeakMap();
+function deferMetaHeaders(response, headers) {
+  const existing = pending.get(response);
+  if (existing) {
+    Object.assign(existing, headers);
+    return;
+  }
+  pending.set(response, { ...headers });
+}
+function consumePendingMetaHeaders(response) {
+  const headers = pending.get(response);
+  if (headers) pending.delete(response);
+  return headers;
+}
+function isHeadersOnlyMeta(meta) {
+  return meta.status === void 0 && meta.setCookies.length === 0;
+}
+
 // src/response/toResponse.ts
 async function toResponse(value, meta) {
   if (value instanceof Promise) {
@@ -418,6 +455,10 @@ async function toResponse(value, meta) {
   };
   if (value instanceof Response) {
     if (meta && (meta.status !== void 0 || Object.keys(meta.headers).length > 0 || meta.setCookies.length > 0)) {
+      if (isHeadersOnlyMeta(meta)) {
+        deferMetaHeaders(value, meta.headers);
+        return value;
+      }
       const headers2 = new Headers(value.headers);
       applyMeta(headers2);
       return new Response(value.body, {
@@ -512,10 +553,15 @@ var PARAM_TYPE_MAP = {
   agents: "agents"
   // Phase 2.3
 };
+var injectionCache = /* @__PURE__ */ new WeakMap();
 function resolveInjection(fn) {
+  const cached = injectionCache.get(fn);
+  if (cached) {
+    return cached;
+  }
   const fnStr = fn.toString();
   const params = extractParamsWithAst(fnStr);
-  return params.map((param) => {
+  const items = params.map((param) => {
     const type = PARAM_TYPE_MAP[param.name] || "unknown";
     return {
       name: param.name,
@@ -524,6 +570,8 @@ function resolveInjection(fn) {
       // 运行时类型已擦除
     };
   });
+  injectionCache.set(fn, items);
+  return items;
 }
 function extractParamsWithAst(fnStr) {
   const sourceFile = ts.createSourceFile(
@@ -585,24 +633,157 @@ function extractParamName(param, names) {
 function queryToObject(params) {
   const result = {};
   for (const [key, value] of params) {
-    result[key] = value;
+    const existing = result[key];
+    if (existing === void 0) {
+      result[key] = value;
+    } else if (Array.isArray(existing)) {
+      existing.push(value);
+    } else {
+      result[key] = [existing, value];
+    }
   }
   return result;
 }
 
+// src/injection/registries.ts
+function createToolRegistry() {
+  let registry = /* @__PURE__ */ new Map();
+  return {
+    hydrate(tools) {
+      const next = /* @__PURE__ */ new Map();
+      for (const tool of tools) {
+        next.set(tool.name, tool);
+      }
+      registry = next;
+    },
+    get(name) {
+      return registry.get(name);
+    },
+    list() {
+      return Array.from(registry.values());
+    },
+    clear() {
+      registry = /* @__PURE__ */ new Map();
+    }
+  };
+}
+function createAgentRegistry(tool) {
+  let registry = /* @__PURE__ */ new Map();
+  const getAgent = (name) => registry.get(name);
+  return {
+    hydrate(agents) {
+      const next = /* @__PURE__ */ new Map();
+      for (const agent of agents) {
+        next.set(agent.name, agent);
+      }
+      registry = next;
+    },
+    getAgent,
+    getAgentEntry(name) {
+      return registry.get(name);
+    },
+    listAgents() {
+      const merged = /* @__PURE__ */ new Map();
+      for (const agent of registry.values()) merged.set(agent.name, agent);
+      return Array.from(merged.values());
+    },
+    asTool(name) {
+      const agent = getAgent(name);
+      if (!agent) return void 0;
+      return {
+        kind: "agent",
+        name: `agent.${agent.name}`,
+        agentName: agent.name,
+        description: agent.description,
+        metadata: agent
+      };
+    },
+    resolveAgentTools(name) {
+      const agent = getAgent(name);
+      if (!agent) return [];
+      const result = /* @__PURE__ */ new Map();
+      if (agent.tools) {
+        for (const toolName of agent.tools) {
+          const resolved = tool.get(toolName);
+          if (resolved) result.set(resolved.name, resolved);
+        }
+      }
+      return Array.from(result.values());
+    },
+    resolveSubAgents(name) {
+      const agent = getAgent(name);
+      if (!agent || !agent.agents) return [];
+      const result = [];
+      for (const subName of agent.agents) {
+        const sub = getAgent(subName);
+        if (sub) result.push(sub);
+      }
+      return result;
+    },
+    clear() {
+      registry = /* @__PURE__ */ new Map();
+    }
+  };
+}
+function createSkillRegistry() {
+  let registry = /* @__PURE__ */ new Map();
+  return {
+    hydrate(skills) {
+      const next = /* @__PURE__ */ new Map();
+      for (const skill of skills) {
+        next.set(skill.name, skill);
+      }
+      registry = next;
+    },
+    upsert(skill) {
+      registry.set(skill.name, skill);
+    },
+    remove(name) {
+      registry.delete(name);
+    },
+    get(name) {
+      return registry.get(name);
+    },
+    list() {
+      return Array.from(registry.values());
+    },
+    clear() {
+      registry = /* @__PURE__ */ new Map();
+    }
+  };
+}
+function createAgentHandleStore() {
+  let currentFactory = null;
+  return {
+    register(factory) {
+      currentFactory = factory;
+    },
+    get(ctx) {
+      if (currentFactory === null) return void 0;
+      return currentFactory(ctx);
+    },
+    clear() {
+      currentFactory = null;
+    }
+  };
+}
+function createAppRegistries() {
+  const tool = createToolRegistry();
+  const agent = createAgentRegistry(tool);
+  const skill = createSkillRegistry();
+  const agentHandle = createAgentHandleStore();
+  return { tool, agent, skill, agentHandle };
+}
+var defaultRegistries = createAppRegistries();
+
 // src/injection/agentRegistry.ts
-var registry = /* @__PURE__ */ new Map();
 function listAgents() {
-  const merged = /* @__PURE__ */ new Map();
-  for (const agent of registry.values()) merged.set(agent.name, agent);
-  return Array.from(merged.values());
+  return defaultRegistries.agent.listAgents();
 }
 
 // src/injection/agentHandle.ts
-var currentFactory = null;
 function getAgentHandle(ctx) {
-  if (currentFactory === null) return void 0;
-  return currentFactory(ctx);
+  return defaultRegistries.agentHandle.get(ctx);
 }
 
 // src/injection/injectParams.ts
@@ -639,11 +820,12 @@ function getBuiltinInjectionValue(type, ctx, body) {
       }
       return {};
     // Phase 2.3：注入所有已注册 agent 元数据列表
+    // 方案 A：优先读 app 实例注册表，无实例（编程式直调 ctx）回退默认全局实例
     case "agents":
-      return listAgents();
+      return ctx.registries ? ctx.registries.agent.listAgents() : listAgents();
     // Phase 3.5：调 @faapi/agent 插件注册的工厂获取 AgentHandle
     case "agent":
-      return getAgentHandle(ctx);
+      return ctx.registries ? ctx.registries.agentHandle.get(ctx) : getAgentHandle(ctx);
     default:
       return void 0;
   }
@@ -674,6 +856,10 @@ function wrapResult(result, ctx) {
 function mergeMeta(response, meta) {
   const hasMeta = meta.status !== void 0 || Object.keys(meta.headers).length > 0 || meta.setCookies.length > 0;
   if (!hasMeta) return response;
+  if (isHeadersOnlyMeta(meta)) {
+    deferMetaHeaders(response, meta.headers);
+    return response;
+  }
   const headers = new Headers(response.headers);
   for (const [key, value] of Object.entries(meta.headers)) {
     headers.set(key, value);
@@ -756,23 +942,23 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
 }
 
 // src/testServer.ts
-import path11 from "path";
+import path14 from "path";
 import os from "os";
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 
 // src/router/scanRoutes.ts
 import fg from "fast-glob";
-import path from "path";
-import fs from "fs";
+import path2 from "path";
+import fs2 from "fs";
 
 // src/router/constants.ts
 var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
 var HTTP_METHOD_SET = new Set(HTTP_METHODS);
 
 // src/utils/normalizePath.ts
-function normalizePath(path12) {
-  if (!path12) return "";
-  let result = path12.replace(/\\/g, "/");
+function normalizePath(path15) {
+  if (!path15) return "";
+  let result = path15.replace(/\\/g, "/");
   result = result.replace(/\/+/g, "/");
   result = result.replace(/\/+$/, "");
   if (result && !result.startsWith("/")) {
@@ -845,6 +1031,7 @@ async function importWithCacheBust(filePath, bustViteCache = false) {
 
 // src/middleware/loadMiddlewares.ts
 var middlewareCache = /* @__PURE__ */ new Map();
+var inFlight = /* @__PURE__ */ new Map();
 function getCachedMiddlewares(absPath) {
   return middlewareCache.get(absPath);
 }
@@ -896,8 +1083,15 @@ async function loadMergedMiddlewares(middlewarePaths) {
   for (const absMwPath of middlewarePaths) {
     let bundle = getCachedMiddlewares(absMwPath);
     if (bundle === void 0) {
-      bundle = await loadMiddlewaresFile(absMwPath);
-      setCachedMiddlewares(absMwPath, bundle);
+      let loading = inFlight.get(absMwPath);
+      if (!loading) {
+        loading = loadMiddlewaresFile(absMwPath).then((result) => {
+          setCachedMiddlewares(absMwPath, result);
+          return result;
+        });
+        inFlight.set(absMwPath, loading);
+      }
+      bundle = await loading;
     }
     mergedMiddlewares.push(...bundle.middlewares);
     for (const [name, injector] of Object.entries(bundle.injectors)) {
@@ -910,6 +1104,36 @@ async function loadMergedMiddlewares(middlewarePaths) {
   return { middlewares: mergedMiddlewares, injectors: mergedInjectors };
 }
 
+// src/utils/prodPaths.ts
+import path from "path";
+import fs from "fs";
+var APP_DIR = "src";
+function toProdFilePath(filePath, dist) {
+  let rel = filePath.replace(/\\/g, "/");
+  if (rel.startsWith("src/")) {
+    rel = rel.slice(4);
+  }
+  const jsPath = rel.replace(/\.ts$/, ".js");
+  return jsPath.startsWith(`${dist}/`) ? jsPath : `${dist}/${jsPath}`;
+}
+function toProdExtension(filePath) {
+  if (filePath.endsWith(".ts")) return filePath.slice(0, -3) + ".js";
+  if (filePath.endsWith(".tsx")) return filePath.slice(0, -4) + ".js";
+  if (filePath.endsWith(".jsx")) return filePath.slice(0, -4) + ".js";
+  return filePath;
+}
+function toRealPath(p) {
+  try {
+    return fs.realpathSync(p);
+  } catch {
+    return p;
+  }
+}
+function isInsideDir(filePath, dir) {
+  const rel = path.relative(dir, filePath);
+  return rel !== "" && !rel.startsWith("..") && !path.isAbsolute(rel);
+}
+
 // src/router/scanRoutes.ts
 var HTTP_OR_WS_EXPORT_RE = new RegExp(
   String.raw`export\s+(?:async\s+)?(?:function\s+|const\s+)(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS|WS)\b`,
@@ -925,48 +1149,40 @@ function extractExportsFromSource(source) {
   return names;
 }
 function collectMiddlewarePaths(routeFilePath, rootDir, dist) {
-  const routeDir = path.dirname(routeFilePath);
-  const resolvedRoot = path.resolve(rootDir);
+  const routeDir = path2.dirname(routeFilePath);
+  const resolvedRoot = path2.resolve(rootDir);
   const paths = [];
-  let currentDir = path.resolve(rootDir, routeDir);
+  let currentDir = path2.resolve(rootDir, routeDir);
   while (true) {
     if (dist) {
-      const mwTsPath = path.join(currentDir, "middlewares.ts");
-      const mwJsPath = path.join(currentDir, "middlewares.js");
-      const absTsPath = path.resolve(rootDir, mwTsPath);
-      const absJsPath = path.resolve(rootDir, mwJsPath);
-      const absMwPath = fs.existsSync(absTsPath) ? absTsPath : fs.existsSync(absJsPath) ? absJsPath : null;
+      const mwTsPath = path2.join(currentDir, "middlewares.ts");
+      const mwJsPath = path2.join(currentDir, "middlewares.js");
+      const absTsPath = path2.resolve(rootDir, mwTsPath);
+      const absJsPath = path2.resolve(rootDir, mwJsPath);
+      const absMwPath = fs2.existsSync(absTsPath) ? absTsPath : fs2.existsSync(absJsPath) ? absJsPath : null;
       if (absMwPath) {
-        const relMwPath = path.relative(rootDir, absMwPath);
-        const prodAbsPath = path.resolve(rootDir, toProdFilePath(relMwPath, dist));
+        const relMwPath = path2.relative(rootDir, absMwPath);
+        const prodAbsPath = path2.resolve(rootDir, toProdFilePath(relMwPath, dist));
         paths.push(prodAbsPath);
       }
     } else {
       for (const ext of [".ts", ".js"]) {
-        const mwPath = path.join(currentDir, `middlewares${ext}`);
-        const absMwPath = path.resolve(rootDir, mwPath);
-        if (fs.existsSync(absMwPath)) {
+        const mwPath = path2.join(currentDir, `middlewares${ext}`);
+        const absMwPath = path2.resolve(rootDir, mwPath);
+        if (fs2.existsSync(absMwPath)) {
           paths.push(absMwPath);
           break;
         }
       }
     }
     if (currentDir === resolvedRoot) break;
-    const parentDir = path.dirname(currentDir);
+    const parentDir = path2.dirname(currentDir);
     if (parentDir === currentDir) break;
     currentDir = parentDir;
   }
   paths.reverse();
   return paths;
 }
-function toProdFilePath(filePath, dist) {
-  let rel = filePath.replace(/\\/g, "/");
-  if (rel.startsWith("src/")) {
-    rel = rel.slice(4);
-  }
-  const jsPath = rel.replace(/\.ts$/, ".js");
-  return jsPath.startsWith(`${dist}/`) ? jsPath : `${dist}/${jsPath}`;
-}
 async function scanRoutes(rootDir, patterns, dist) {
   const files = await fg(patterns, {
     cwd: rootDir,
@@ -979,7 +1195,7 @@ async function scanRoutes(rootDir, patterns, dist) {
     const normalizedFile = file.replace(/\\/g, "/");
     const fileName = normalizedFile.split("/").pop();
     if (fileName === "handler.ts" || fileName === "handler.js") {
-      const absPath = path.resolve(rootDir, normalizedFile);
+      const absPath = path2.resolve(rootDir, normalizedFile);
       const urlPath = filePathToUrlPath(normalizedFile);
       const paramNames = extractParamNames(urlPath);
       const isDynamic = paramNames.length > 0;
@@ -992,7 +1208,7 @@ async function scanRoutes(rootDir, patterns, dist) {
         const mwPaths = collectMiddlewarePaths(normalizedFile, rootDir);
         middlewareBundle = await loadMergedMiddlewares(mwPaths);
       }
-      const source = await fs.promises.readFile(absPath, "utf8").catch(() => "");
+      const source = await fs2.promises.readFile(absPath, "utf8").catch(() => "");
       const exportNames = extractExportsFromSource(source);
       const methods = HTTP_METHODS.filter((m) => exportNames.has(m));
       for (const method of methods) {
@@ -1045,25 +1261,34 @@ function sortRoutes(routes) {
 }
 
 // src/cli/generateSchemaFiles.ts
-import path4 from "path";
-import fs3 from "fs/promises";
+import path6 from "path";
+
+// src/utils/atomicWrite.ts
+import path3 from "path";
+import fs3 from "fs";
+async function atomicWriteFile(outputPath, content) {
+  await fs3.promises.mkdir(path3.dirname(outputPath), { recursive: true });
+  const tmp = `${outputPath}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
+  await fs3.promises.writeFile(tmp, content, "utf-8");
+  await fs3.promises.rename(tmp, outputPath);
+}
 
 // src/ast/createProgram.ts
 import ts2 from "typescript";
-import fs2 from "fs";
-import path2 from "path";
+import fs4 from "fs";
+import path4 from "path";
 var programCache = /* @__PURE__ */ new Map();
 var tsConfigCache = /* @__PURE__ */ new Map();
 function findTsConfig(filePath) {
-  let dir = path2.dirname(filePath);
-  const root = path2.parse(dir).root;
+  let dir = path4.dirname(filePath);
+  const root = path4.parse(dir).root;
   while (true) {
-    const candidate = path2.join(dir, "tsconfig.json");
-    if (fs2.existsSync(candidate)) {
+    const candidate = path4.join(dir, "tsconfig.json");
+    if (fs4.existsSync(candidate)) {
       return candidate;
     }
     if (dir === root) return null;
-    const parent = path2.dirname(dir);
+    const parent = path4.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -1073,13 +1298,13 @@ function parseTsConfig(tsconfigPath) {
   if (cached) return cached;
   const result = { fileNames: [] };
   try {
-    const configFile = ts2.readConfigFile(tsconfigPath, (p) => fs2.readFileSync(p, "utf-8"));
+    const configFile = ts2.readConfigFile(tsconfigPath, (p) => fs4.readFileSync(p, "utf-8"));
     if (configFile.error) {
       tsConfigCache.set(tsconfigPath, result);
       return result;
     }
     const config = configFile.config ?? {};
-    const basePath = path2.dirname(tsconfigPath);
+    const basePath = path4.dirname(tsconfigPath);
     const parsed = ts2.parseJsonConfigFileContent(
       config,
       ts2.sys,
@@ -1105,6 +1330,46 @@ function createProgram(filePath) {
   if (cached) {
     return cached;
   }
+  const program = buildProgram([filePath], findTsConfig(filePath));
+  programCache.set(filePath, program);
+  return program;
+}
+function createPrograms(filePaths) {
+  const unique = [...new Set(filePaths)];
+  const result = /* @__PURE__ */ new Map();
+  const groups = /* @__PURE__ */ new Map();
+  const noTsconfigFiles = [];
+  for (const filePath of unique) {
+    const tsconfigPath = findTsConfig(filePath);
+    if (!tsconfigPath) {
+      noTsconfigFiles.push(filePath);
+      continue;
+    }
+    const group = groups.get(tsconfigPath);
+    if (group) {
+      group.files.push(filePath);
+    } else {
+      groups.set(tsconfigPath, { tsconfigPath, files: [filePath] });
+    }
+  }
+  for (const { tsconfigPath, files } of groups.values()) {
+    const cacheKey = `shared::${tsconfigPath}`;
+    let program = programCache.get(cacheKey);
+    const coversAll = program !== void 0 && files.every((f) => program.getSourceFile(f) !== void 0);
+    if (!program || !coversAll) {
+      program = buildProgram(files, tsconfigPath);
+      programCache.set(cacheKey, program);
+    }
+    for (const filePath of files) {
+      result.set(filePath, program);
+    }
+  }
+  for (const filePath of noTsconfigFiles) {
+    result.set(filePath, createProgram(filePath));
+  }
+  return result;
+}
+function buildProgram(entryFiles, tsconfigPath) {
   const options = {
     strict: true,
     target: ts2.ScriptTarget.ES2022,
@@ -1113,8 +1378,7 @@ function createProgram(filePath) {
     skipLibCheck: true,
     noEmit: true
   };
-  let rootNames = [filePath];
-  const tsconfigPath = findTsConfig(filePath);
+  const rootNames = [...entryFiles];
   if (tsconfigPath) {
     const tsOptions = parseTsConfig(tsconfigPath);
     if (tsOptions.module !== void 0) {
@@ -1124,16 +1388,14 @@ function createProgram(filePath) {
       options.moduleResolution = tsOptions.moduleResolution;
     }
     if (tsOptions.fileNames.length > 0) {
-      if (!tsOptions.fileNames.includes(filePath)) {
-        rootNames = [filePath, ...tsOptions.fileNames];
-      } else {
-        rootNames = tsOptions.fileNames;
+      for (const fileName of tsOptions.fileNames) {
+        if (!rootNames.includes(fileName)) {
+          rootNames.push(fileName);
+        }
       }
     }
   }
-  const program = ts2.createProgram(rootNames, options);
-  programCache.set(filePath, program);
-  return program;
+  return ts2.createProgram(rootNames, options);
 }
 
 // src/ast/extractHandlerTypes.ts
@@ -1145,17 +1407,40 @@ var currentProgram = null;
 function setProgramContext(program) {
   currentProgram = program;
 }
-var SchemaExtractionError = class extends Error {
-  constructor(typeText, reason, options) {
-    super(`\u65E0\u6CD5\u89E3\u6790\u7C7B\u578B "${typeText}": ${reason}`, options);
+var SchemaExtractionError = class _SchemaExtractionError extends Error {
+  constructor(typeText, reason, options, location) {
+    super(
+      `\u65E0\u6CD5\u89E3\u6790\u7C7B\u578B "${typeText}": ${reason}` + (location ? ` (${location.file}:${location.line}:${location.column})` : ""),
+      options
+    );
     this.typeText = typeText;
     this.reason = reason;
+    this.location = location;
     this.name = "SchemaExtractionError";
   }
   typeText;
   reason;
+  location;
+  /**
+   * 从 AST 节点构造错误（自动携带 file:line:column）
+   *
+   * 所有抛错点应优先使用此工厂——错误无行号时，几百行的类型文件只能靠
+   * 类型名肉眼定位；解析 lib.d.ts 类型别名时还会出现错误文本与文件上下文错位
+   */
+  static at(node, typeText, reason) {
+    const sourceFile = node.getSourceFile();
+    if (!sourceFile) {
+      return new _SchemaExtractionError(typeText, reason);
+    }
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    return new _SchemaExtractionError(typeText, reason, void 0, {
+      file: sourceFile.fileName,
+      line: line + 1,
+      column: character + 1
+    });
+  }
 };
-function resolveTypeNode(typeNode, checker, visited = /* @__PURE__ */ new Set()) {
+function resolveTypeNode(typeNode, checker, visited = /* @__PURE__ */ new Set(), bindings = /* @__PURE__ */ new Map()) {
   const kind = typeNode.kind;
   switch (kind) {
     case ts3.SyntaxKind.StringKeyword:
@@ -1211,13 +1496,13 @@ function resolveTypeNode(typeNode, checker, visited = /* @__PURE__ */ new Set())
   if (ts3.isArrayTypeNode(typeNode)) {
     return {
       kind: "array",
-      element: resolveTypeNode(typeNode.elementType, checker, visited)
+      element: resolveTypeNode(typeNode.elementType, checker, visited, bindings)
     };
   }
   if (ts3.isTupleTypeNode(typeNode)) {
     const elements = typeNode.elements.map((e) => {
       if (ts3.isRestTypeNode(e)) {
-        const inner = resolveTypeNode(e.type, checker, visited);
+        const inner = resolveTypeNode(e.type, checker, visited, bindings);
         if (inner.kind === "array") {
           return { type: inner.element, optional: false, rest: true };
         }
@@ -1225,20 +1510,20 @@ function resolveTypeNode(typeNode, checker, visited = /* @__PURE__ */ new Set())
       }
       if (ts3.isNamedTupleMember(e)) {
         return {
-          type: resolveTypeNode(e.type, checker, visited),
+          type: resolveTypeNode(e.type, checker, visited, bindings),
           optional: !!e.questionToken,
           rest: false
         };
       }
       if (ts3.isOptionalTypeNode(e)) {
         return {
-          type: resolveTypeNode(e.type, checker, visited),
+          type: resolveTypeNode(e.type, checker, visited, bindings),
           optional: true,
           rest: false
         };
       }
       return {
-        type: resolveTypeNode(e, checker, visited),
+        type: resolveTypeNode(e, checker, visited, bindings),
         optional: false,
         rest: false
       };
@@ -1246,40 +1531,80 @@ function resolveTypeNode(typeNode, checker, visited = /* @__PURE__ */ new Set())
     return { kind: "tuple", elements };
   }
   if (ts3.isUnionTypeNode(typeNode)) {
-    const members = typeNode.types.map((t) => resolveTypeNode(t, checker, visited));
+    const members = typeNode.types.map((t) => resolveTypeNode(t, checker, visited, bindings));
     return { kind: "union", members };
   }
   if (ts3.isIntersectionTypeNode(typeNode)) {
-    const properties = [];
+    const propMap = /* @__PURE__ */ new Map();
     for (const t of typeNode.types) {
-      const resolved = resolveTypeNode(t, checker, visited);
-      if (resolved.kind === "object") {
-        properties.push(...resolved.properties);
+      const resolved = resolveTypeNode(t, checker, visited, bindings);
+      if (resolved.kind !== "object") {
+        throw new SchemaExtractionError(
+          typeNode.getText(),
+          `\u4EA4\u53C9\u7C7B\u578B\u5305\u542B\u975E object \u6210\u5458\uFF08${resolved.kind}\uFF09,\u8FD0\u884C\u65F6\u65E0\u6CD5\u6821\u9A8C\u2014\u2014branded \u7C7B\u578B\u5EFA\u8BAE\u6539\u7528\u5177\u4F53\u7C7B\u578B\u6216 unknown`
+        );
+      }
+      for (const prop of resolved.properties) {
+        const existing = propMap.get(prop.name);
+        if (!existing) {
+          propMap.set(prop.name, prop);
+          continue;
+        }
+        if (JSON.stringify(existing.type) !== JSON.stringify(prop.type) || existing.optional !== prop.optional) {
+          throw SchemaExtractionError.at(
+            typeNode,
+            typeNode.getText(),
+            `\u4EA4\u53C9\u7C7B\u578B\u6210\u5458\u7684\u540C\u540D\u5B57\u6BB5 "${prop.name}" \u7C7B\u578B\u51B2\u7A81\uFF08TS \u4E2D\u4E3A never\uFF09,\u8FD0\u884C\u65F6\u65E0\u6CD5\u6821\u9A8C`
+          );
+        }
+        if (!existing.constraints?.length && prop.constraints?.length) {
+          propMap.set(prop.name, prop);
+        }
       }
     }
-    return { kind: "object", properties };
+    return { kind: "object", properties: [...propMap.values()] };
   }
   if (ts3.isTypeLiteralNode(typeNode)) {
-    return resolveTypeLiteral(typeNode, checker, visited);
+    return resolveTypeLiteral(typeNode, checker, visited, bindings);
   }
   if (ts3.isTypeOperatorNode(typeNode) && typeNode.operator === ts3.SyntaxKind.KeyOfKeyword) {
     return resolveKeyOf(typeNode, checker);
   }
   if (ts3.isTypeOperatorNode(typeNode) && typeNode.operator === ts3.SyntaxKind.ReadonlyKeyword) {
-    return resolveTypeNode(typeNode.type, checker, visited);
+    return resolveTypeNode(typeNode.type, checker, visited, bindings);
   }
   if (ts3.isTypeReferenceNode(typeNode)) {
-    return resolveTypeReference(typeNode, checker, visited);
+    return resolveTypeReference(typeNode, checker, visited, bindings);
   }
-  throw new SchemaExtractionError(typeNode.getText(), "\u4E0D\u652F\u6301\u7684\u7C7B\u578B\u8BED\u6CD5");
+  if (ts3.isExpressionWithTypeArguments(typeNode)) {
+    return resolveTypeReference(
+      {
+        getText: () => typeNode.getText(),
+        typeName: typeNode.expression,
+        typeArguments: typeNode.typeArguments
+      },
+      checker,
+      visited,
+      bindings
+    );
+  }
+  throw SchemaExtractionError.at(typeNode, typeNode.getText(), "\u4E0D\u652F\u6301\u7684\u7C7B\u578B\u8BED\u6CD5");
 }
-function resolveTypeLiteral(typeNode, checker, visited = /* @__PURE__ */ new Set()) {
+function resolveTypeLiteral(typeNode, checker, visited = /* @__PURE__ */ new Set(), bindings = /* @__PURE__ */ new Map()) {
   const properties = [];
+  let catchall;
   for (const member of typeNode.members) {
+    if (ts3.isMethodSignature(member) || ts3.isGetAccessorDeclaration(member) || ts3.isSetAccessorDeclaration(member)) {
+      throw SchemaExtractionError.at(
+        member,
+        member.getText(),
+        "\u5BF9\u8C61\u7C7B\u578B\u542B\u65B9\u6CD5\u7B7E\u540D\u6216\u5B58\u53D6\u5668,\u8FD0\u884C\u65F6 JSON \u6570\u636E\u65E0\u6CD5\u6821\u9A8C\u65B9\u6CD5\u2014\u2014\u8BF7\u6539\u7528\u5177\u4F53\u5C5E\u6027\u7C7B\u578B"
+      );
+    }
     if (ts3.isPropertySignature(member) && member.name) {
       const name = member.name.getText();
       const optional = !!member.questionToken;
-      const type = member.type ? resolveTypeNode(member.type, checker, visited) : { kind: "any" };
+      const type = member.type ? resolveTypeNode(member.type, checker, visited, bindings) : { kind: "any" };
       const constraints = extractConstraintsFromJsDoc(member, name);
       validateConstraints(constraints, type, name);
       properties.push(
@@ -1287,12 +1612,10 @@ function resolveTypeLiteral(typeNode, checker, visited = /* @__PURE__ */ new Set
       );
     }
     if (ts3.isIndexSignatureDeclaration(member)) {
-      const keyType = member.parameters[0]?.type ? resolveTypeNode(member.parameters[0].type, checker, visited) : { kind: "any" };
-      const valueType = member.type ? resolveTypeNode(member.type, checker, visited) : { kind: "any" };
-      return { kind: "record", key: keyType, value: valueType };
+      catchall = member.type ? resolveTypeNode(member.type, checker, visited, bindings) : { kind: "any" };
     }
   }
-  return { kind: "object", properties };
+  return catchall !== void 0 ? { kind: "object", properties, catchall } : { kind: "object", properties };
 }
 function extractLiteralKeys(type) {
   if (type.kind === "literal" && typeof type.value === "string") {
@@ -1361,36 +1684,48 @@ function resolveKeyOf(typeNode, checker) {
   }
   throw new SchemaExtractionError(typeNode.getText(), "keyof T \u7684\u7ED3\u679C\u65E0\u6CD5\u89E3\u6790\u4E3A\u5B57\u9762\u91CF\u8054\u5408");
 }
-function resolveTypeReference(typeNode, checker, visited = /* @__PURE__ */ new Set()) {
+function resolveTypeReference(typeNode, checker, visited = /* @__PURE__ */ new Set(), bindings = /* @__PURE__ */ new Map()) {
   const typeName = typeNode.typeName.getText();
+  const bound = bindings.get(typeName);
+  if (bound) {
+    return bound;
+  }
   if (typeName === "Date") {
     return { kind: "date" };
   }
   if ((typeName === "Array" || typeName === "ReadonlyArray") && typeNode.typeArguments?.length === 1) {
+    const [arg] = typeNode.typeArguments;
     return {
       kind: "array",
-      element: resolveTypeNode(typeNode.typeArguments[0], checker, visited)
+      element: resolveTypeNode(arg, checker, visited, bindings)
     };
   }
   if (typeName === "Record" && typeNode.typeArguments?.length === 2) {
+    const [keyArg, valueArg] = typeNode.typeArguments;
     return {
       kind: "record",
-      key: resolveTypeNode(typeNode.typeArguments[0], checker, visited),
-      value: resolveTypeNode(typeNode.typeArguments[1], checker, visited)
+      key: resolveTypeNode(keyArg, checker, visited, bindings),
+      value: resolveTypeNode(valueArg, checker, visited, bindings)
     };
   }
   if ((typeName === "Partial" || typeName === "Required" || typeName === "Readonly") && typeNode.typeArguments?.length === 1) {
-    const inner = resolveTypeNode(typeNode.typeArguments[0], checker, visited);
+    const inner = resolveTypeNode(typeNode.typeArguments[0], checker, visited, bindings);
     if (inner.kind === "object" && typeName === "Partial") {
       return {
         kind: "object",
         properties: inner.properties.map((p) => ({ ...p, optional: true }))
       };
     }
+    if (inner.kind === "object" && typeName === "Required") {
+      return {
+        kind: "object",
+        properties: inner.properties.map((p) => ({ ...p, optional: false }))
+      };
+    }
     return inner;
   }
   if ((typeName === "Pick" || typeName === "Omit") && typeNode.typeArguments?.length === 2) {
-    const innerType = resolveTypeNode(typeNode.typeArguments[0], checker, visited);
+    const innerType = resolveTypeNode(typeNode.typeArguments[0], checker, visited, bindings);
     if (innerType.kind !== "object") {
       throw new SchemaExtractionError(
         typeNode.getText(),
@@ -1398,7 +1733,7 @@ function resolveTypeReference(typeNode, checker, visited = /* @__PURE__ */ new S
       );
     }
     const keyTypeNode = typeNode.typeArguments[1];
-    let keys = extractLiteralKeys(resolveTypeNode(keyTypeNode, checker, visited));
+    let keys = extractLiteralKeys(resolveTypeNode(keyTypeNode, checker, visited, bindings));
     if (keys === null) {
       keys = extractKeysFromChecker(keyTypeNode, checker);
     }
@@ -1416,10 +1751,11 @@ function resolveTypeReference(typeNode, checker, visited = /* @__PURE__ */ new S
         "Map \u5FC5\u987B\u5E26 2 \u4E2A\u7C7B\u578B\u53C2\u6570\uFF0C\u5982 Map<K, V>\uFF0C\u88F8 Map \u4E0D\u652F\u6301"
       );
     }
+    const [mapKey, mapValue] = typeNode.typeArguments;
     return {
       kind: "map",
-      key: resolveTypeNode(typeNode.typeArguments[0], checker, visited),
-      value: resolveTypeNode(typeNode.typeArguments[1], checker, visited)
+      key: resolveTypeNode(mapKey, checker, visited, bindings),
+      value: resolveTypeNode(mapValue, checker, visited, bindings)
     };
   }
   if (typeName === "Set") {
@@ -1429,9 +1765,10 @@ function resolveTypeReference(typeNode, checker, visited = /* @__PURE__ */ new S
         "Set \u5FC5\u987B\u5E26 1 \u4E2A\u7C7B\u578B\u53C2\u6570\uFF0C\u5982 Set<T>\uFF0C\u88F8 Set \u4E0D\u652F\u6301"
       );
     }
+    const [setArg] = typeNode.typeArguments;
     return {
       kind: "set",
-      element: resolveTypeNode(typeNode.typeArguments[0], checker, visited)
+      element: resolveTypeNode(setArg, checker, visited, bindings)
     };
   }
   if (typeName === "WeakMap" || typeName === "WeakSet") {
@@ -1454,21 +1791,42 @@ function resolveTypeReference(typeNode, checker, visited = /* @__PURE__ */ new S
   }
   visited.add(typeName);
   if (checker) {
-    const symbol = typeNode.typeName.kind === ts3.SyntaxKind.Identifier ? checker.getSymbolAtLocation(typeNode.typeName) : void 0;
+    const symbol = ts3.isIdentifier(typeNode.typeName) || ts3.isQualifiedName(typeNode.typeName) ? checker.getSymbolAtLocation(typeNode.typeName) : void 0;
     if (symbol) {
       const declaration = symbol.declarations?.[0];
       if (declaration) {
         if (ts3.isInterfaceDeclaration(declaration)) {
-          return resolveInterfaceDeclaration(declaration, checker, visited);
+          return resolveInterfaceDeclaration(
+            declaration,
+            checker,
+            visited,
+            bindings,
+            typeNode.typeArguments
+          );
         }
         if (ts3.isTypeAliasDeclaration(declaration)) {
-          return resolveTypeNode(declaration.type, checker, visited);
+          const declBindings = bindTypeParameters(
+            declaration.typeParameters,
+            typeNode.typeArguments,
+            bindings,
+            checker,
+            visited,
+            typeNode
+          );
+          return resolveTypeNode(declaration.type, checker, visited, declBindings);
         }
         if (ts3.isEnumDeclaration(declaration)) {
           return resolveEnumDeclaration(declaration);
         }
         if (ts3.isImportSpecifier(declaration) || ts3.isImportClause(declaration)) {
-          const resolved = resolveImportAlias(typeNode, symbol, checker, visited);
+          const resolved = resolveImportAlias(
+            typeNode,
+            symbol,
+            checker,
+            visited,
+            bindings,
+            typeNode.typeArguments
+          );
           if (resolved) return resolved;
         }
       }
@@ -1476,17 +1834,45 @@ function resolveTypeReference(typeNode, checker, visited = /* @__PURE__ */ new S
   }
   throw new SchemaExtractionError(typeNode.getText(), `\u65E0\u6CD5\u89E3\u6790\u7684\u5F15\u7528\u7C7B\u578B "${typeName}"`);
 }
-function resolveImportAlias(typeNode, symbol, checker, visited) {
+function bindTypeParameters(typeParameters, typeArguments, outerBindings, checker, visited, errorNode) {
+  if (!typeParameters || typeParameters.length === 0) return outerBindings;
+  const bindings = new Map(outerBindings);
+  for (let i = 0; i < typeParameters.length; i++) {
+    const param = typeParameters[i];
+    if (!param) continue;
+    const arg = typeArguments?.[i];
+    if (arg) {
+      bindings.set(param.name.text, resolveTypeNode(arg, checker, visited, outerBindings));
+    } else if (param.default) {
+      bindings.set(param.name.text, resolveTypeNode(param.default, checker, visited, bindings));
+    } else {
+      throw new SchemaExtractionError(
+        errorNode.getText(),
+        `\u6CDB\u578B\u53C2\u6570 "${param.name.text}" \u7F3A\u5C11\u7C7B\u578B\u5B9E\u53C2\uFF08\u4E14\u65E0\u9ED8\u8BA4\u7C7B\u578B\uFF09`
+      );
+    }
+  }
+  return bindings;
+}
+function resolveImportAlias(typeNode, symbol, checker, visited, bindings = /* @__PURE__ */ new Map(), typeArguments) {
   const typeName = typeNode.typeName.getText();
   try {
     const aliased = checker.getAliasedSymbol(symbol);
     if (aliased && aliased.declarations && aliased.declarations.length > 0) {
       const decl = aliased.declarations[0];
       if (ts3.isInterfaceDeclaration(decl)) {
-        return resolveInterfaceDeclaration(decl, checker, visited);
+        return resolveInterfaceDeclaration(decl, checker, visited, bindings, typeArguments);
       }
       if (ts3.isTypeAliasDeclaration(decl)) {
-        return resolveTypeNode(decl.type, checker, visited);
+        const declBindings = bindTypeParameters(
+          decl.typeParameters,
+          typeArguments,
+          bindings,
+          checker,
+          visited,
+          typeNode
+        );
+        return resolveTypeNode(decl.type, checker, visited, declBindings);
       }
       if (ts3.isEnumDeclaration(decl)) {
         return resolveEnumDeclaration(decl);
@@ -1504,10 +1890,18 @@ function resolveImportAlias(typeNode, symbol, checker, visited) {
     const found = findTopLevelDecl(sourceFile, typeName);
     if (found) {
       if (found.kind === "interface") {
-        return resolveInterfaceDeclaration(found.node, checker, visited);
+        return resolveInterfaceDeclaration(found.node, checker, visited, bindings, typeArguments);
       }
       if (found.kind === "typeAlias") {
-        return resolveTypeNode(found.node.type, checker, visited);
+        const declBindings = bindTypeParameters(
+          found.node.typeParameters,
+          typeArguments,
+          bindings,
+          checker,
+          visited,
+          typeNode
+        );
+        return resolveTypeNode(found.node.type, checker, visited, declBindings);
       }
       if (found.kind === "enum") {
         return resolveEnumDeclaration(found.node);
@@ -1554,13 +1948,22 @@ function resolveEnumDeclaration(node) {
   }
   return { kind: "union", members };
 }
-function resolveInterfaceDeclaration(node, checker, visited = /* @__PURE__ */ new Set()) {
+function resolveInterfaceDeclaration(node, checker, visited = /* @__PURE__ */ new Set(), outerBindings = /* @__PURE__ */ new Map(), typeArguments) {
   const properties = [];
   const propMap = /* @__PURE__ */ new Map();
+  let catchall;
+  const bindings = bindTypeParameters(
+    node.typeParameters,
+    typeArguments,
+    outerBindings,
+    checker,
+    visited,
+    node
+  );
   for (const heritageClause of node.heritageClauses ?? []) {
     if (heritageClause.token === ts3.SyntaxKind.ExtendsKeyword) {
       for (const expr of heritageClause.types) {
-        const parentType = resolveTypeNode(expr, checker, visited);
+        const parentType = resolveTypeNode(expr, checker, visited, bindings);
         if (parentType.kind === "object") {
           for (const prop of parentType.properties) {
             propMap.set(prop.name, prop);
@@ -1570,10 +1973,17 @@ function resolveInterfaceDeclaration(node, checker, visited = /* @__PURE__ */ ne
     }
   }
   for (const member of node.members) {
+    if (ts3.isMethodSignature(member) || ts3.isGetAccessorDeclaration(member) || ts3.isSetAccessorDeclaration(member)) {
+      throw SchemaExtractionError.at(
+        member,
+        member.getText(),
+        "\u63A5\u53E3\u542B\u65B9\u6CD5\u7B7E\u540D\u6216\u5B58\u53D6\u5668,\u8FD0\u884C\u65F6 JSON \u6570\u636E\u65E0\u6CD5\u6821\u9A8C\u65B9\u6CD5\u2014\u2014\u8BF7\u6539\u7528\u5177\u4F53\u5C5E\u6027\u7C7B\u578B"
+      );
+    }
     if (ts3.isPropertySignature(member) && member.name) {
       const name = member.name.getText();
       const optional = !!member.questionToken;
-      const type = member.type ? resolveTypeNode(member.type, checker, visited) : { kind: "any" };
+      const type = member.type ? resolveTypeNode(member.type, checker, visited, bindings) : { kind: "any" };
       const constraints = extractConstraintsFromJsDoc(member, name);
       validateConstraints(constraints, type, name);
       propMap.set(
@@ -1582,15 +1992,13 @@ function resolveInterfaceDeclaration(node, checker, visited = /* @__PURE__ */ ne
       );
     }
     if (ts3.isIndexSignatureDeclaration(member)) {
-      const keyType = member.parameters[0]?.type ? resolveTypeNode(member.parameters[0].type, checker, visited) : { kind: "any" };
-      const valueType = member.type ? resolveTypeNode(member.type, checker, visited) : { kind: "any" };
-      return { kind: "record", key: keyType, value: valueType };
+      catchall = member.type ? resolveTypeNode(member.type, checker, visited, bindings) : { kind: "any" };
     }
   }
   for (const prop of propMap.values()) {
     properties.push(prop);
   }
-  return { kind: "object", properties };
+  return catchall !== void 0 ? { kind: "object", properties, catchall } : { kind: "object", properties };
 }
 var NUMBER_CONSTRAINT_KINDS = /* @__PURE__ */ new Set([
   "max",
@@ -1770,55 +2178,47 @@ function extractTypeInfo(program, filePath, typeName) {
         return;
       }
     });
-    return result;
-  } finally {
-    setProgramContext(null);
-  }
-}
-function extractAllTypes(program, filePath) {
-  const sourceFile = program.getSourceFile(filePath);
-  if (!sourceFile) return /* @__PURE__ */ new Map();
-  const checker = program.getTypeChecker();
-  setProgramContext(program);
-  try {
-    const result = /* @__PURE__ */ new Map();
-    ts4.forEachChild(sourceFile, (node) => {
-      if (ts4.isInterfaceDeclaration(node)) {
-        const visited = /* @__PURE__ */ new Set();
-        visited.add(node.name.text);
-        const runtimeType = withFileContext(
-          filePath,
-          node.name.text,
-          () => resolveInterfaceDeclaration(node, checker, visited)
-        );
-        result.set(node.name.text, {
-          name: node.name.text,
-          properties: runtimeType.kind === "object" ? runtimeType.properties : [],
-          runtimeType
-        });
-        return;
-      }
-      if (ts4.isTypeAliasDeclaration(node)) {
-        const visited = /* @__PURE__ */ new Set();
-        visited.add(node.name.text);
-        const runtimeType = withFileContext(
-          filePath,
-          node.name.text,
-          () => resolveTypeNode(node.type, checker, visited)
-        );
-        result.set(node.name.text, {
-          name: node.name.text,
-          properties: runtimeType.kind === "object" ? runtimeType.properties : [],
-          runtimeType
-        });
-        return;
+    if (result) return result;
+    for (const sf of program.getSourceFiles()) {
+      if (sf === sourceFile) continue;
+      if (sf.fileName.includes("/node_modules/") || sf.fileName.includes("typescript/lib/")) {
+        continue;
       }
-    });
-    return result;
+      const found = findTopLevelDecl(sf, typeName);
+      if (!found) continue;
+      const visited = /* @__PURE__ */ new Set();
+      visited.add(typeName);
+      const runtimeType = withFileContext(filePath, typeName, () => {
+        if (found.kind === "interface") {
+          return resolveInterfaceDeclaration(found.node, checker, visited);
+        }
+        if (found.kind === "typeAlias") {
+          return resolveTypeNode(found.node.type, checker, visited);
+        }
+        return resolveEnumDeclaration(found.node);
+      });
+      return {
+        name: typeName,
+        properties: runtimeType.kind === "object" ? runtimeType.properties : [],
+        runtimeType
+      };
+    }
+    return null;
   } finally {
     setProgramContext(null);
   }
 }
+function createLazyTypeResolver(program, filePath) {
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    resolve(name) {
+      if (cache.has(name)) return cache.get(name);
+      const info = extractTypeInfo(program, filePath, name);
+      cache.set(name, info);
+      return info;
+    }
+  };
+}
 function withFileContext(filePath, typeName, fn) {
   try {
     return fn();
@@ -1828,7 +2228,8 @@ function withFileContext(filePath, typeName, fn) {
       const enriched = new SchemaExtractionError(
         err.typeText,
         `${err.reason}\uFF08\u6587\u4EF6: ${fileName}, \u7C7B\u578B: ${typeName}\uFF09`,
-        { cause: err }
+        { cause: err },
+        err.location
       );
       throw enriched;
     }
@@ -1856,8 +2257,7 @@ function getSchemaName(method, inputType) {
 
 // src/injection/analyzeInjection.ts
 import ts5 from "typescript";
-function analyzeInjection(code, functionName) {
-  const sourceFile = ts5.createSourceFile("temp.ts", code, ts5.ScriptTarget.Latest, true);
+function analyzeInjectionInSourceFile(sourceFile, functionName) {
   const params = [];
   ts5.forEachChild(sourceFile, (node) => {
     if (ts5.isFunctionDeclaration(node) && node.name?.text === functionName) {
@@ -1900,11 +2300,11 @@ function extractSchema(typeNode, sourceFile) {
 }
 
 // src/cli/collectRouteSchemaSources.ts
-import path3 from "path";
+import path5 from "path";
 function collectRouteSchemaSources(routes, rootDir) {
   const methodsByFile = /* @__PURE__ */ new Map();
   for (const route of routes) {
-    const filePath = rootDir ? path3.resolve(rootDir, route.filePath) : route.filePath;
+    const filePath = rootDir ? path5.resolve(rootDir, route.filePath) : route.filePath;
     let entry = methodsByFile.get(filePath);
     if (!entry) {
       entry = { urlPath: route.urlPath, methods: /* @__PURE__ */ new Set() };
@@ -1912,30 +2312,24 @@ function collectRouteSchemaSources(routes, rootDir) {
     }
     entry.methods.add(route.method);
   }
-  const programByFile = /* @__PURE__ */ new Map();
-  const allTypesByFile = /* @__PURE__ */ new Map();
-  const mergedAllTypes = /* @__PURE__ */ new Map();
+  const programByFile = createPrograms([...methodsByFile.keys()]);
+  const resolversByFile = /* @__PURE__ */ new Map();
   for (const filePath of methodsByFile.keys()) {
-    const program = createProgram(filePath);
-    programByFile.set(filePath, program);
-    const allTypes = extractAllTypes(program, filePath);
-    allTypesByFile.set(filePath, allTypes);
-    for (const [name, info] of allTypes) {
-      mergedAllTypes.set(name, info);
-    }
+    resolversByFile.set(filePath, createLazyTypeResolver(programByFile.get(filePath), filePath));
   }
   const sources = [];
   for (const [filePath, entry] of methodsByFile) {
     const program = programByFile.get(filePath);
     const sourceFile = program.getSourceFile(filePath);
-    const code = sourceFile?.text ?? "";
+    if (!sourceFile) continue;
+    const resolver = resolversByFile.get(filePath);
     for (const method of entry.methods) {
       const inputType = getInputTypeForMethod(method);
       const schemaName = getSchemaName(method, inputType);
-      const meta = analyzeInjection(code, method);
+      const meta = analyzeInjectionInSourceFile(sourceFile, method);
       const param = meta.params.find((p) => p.type === inputType) ?? (inputType === "body" ? meta.params.find((p) => p.type === "form") : void 0);
       const isForm = param?.type === "form";
-      const typeInfo = param?.typeName ? extractTypeInfo(program, filePath, param.typeName) : null;
+      const typeInfo = param?.typeName ? resolver.resolve(param.typeName) : null;
       sources.push({
         urlPath: entry.urlPath,
         filePath,
@@ -1945,7 +2339,7 @@ function collectRouteSchemaSources(routes, rootDir) {
       });
     }
   }
-  return { sources, allTypesByFile, mergedAllTypes };
+  return { sources, resolversByFile };
 }
 
 // src/ast/generateZodSchema.ts
@@ -2018,8 +2412,12 @@ function collectNamedTypes(type, ctx) {
       if (resolved) {
         ctx.namedTypes.set(type.name, resolved);
         collectNamedTypes(resolved, ctx);
+        return;
       }
-      return;
+      throw new SchemaExtractionError(
+        type.name,
+        `\u65E0\u6CD5\u89E3\u6790\u547D\u540D\u7C7B\u578B\u5F15\u7528 "${type.name}"\uFF08handler \u6587\u4EF6\u4E0E program \u6E90\u6587\u4EF6\u4E2D\u5747\u672A\u627E\u5230\u540C\u540D\u9876\u5C42\u58F0\u660E\uFF09`
+      );
     }
   }
 }
@@ -2029,6 +2427,12 @@ function runtimeTypeToZodExpression(type, ctx, constraints) {
   if (ctx.coerce && (type.kind === "number" || type.kind === "boolean")) {
     return wrapCoercePreprocess(type.kind, withConstraints);
   }
+  if (ctx.coerce && type.kind === "literal" && (typeof type.value === "number" || typeof type.value === "boolean")) {
+    return wrapCoercePreprocess(
+      typeof type.value === "number" ? "number" : "boolean",
+      withConstraints
+    );
+  }
   return withConstraints;
 }
 function applyConstraints(baseExpr, constraints, typeKind) {
@@ -2093,7 +2497,7 @@ function baseExpression(type, ctx) {
     case "tuple":
       return generateTupleExpression(type.elements, ctx);
     case "object":
-      return generateObjectExpression(type.properties, ctx);
+      return generateObjectExpression(type, ctx);
     case "union":
       return generateUnionExpression(type.members, ctx);
     case "date":
@@ -2112,7 +2516,7 @@ function baseExpression(type, ctx) {
   }
 }
 var COERCE_NUMBER_HELPER = 'export const coerceNumber = (v) => typeof v === "string" && v.trim() !== "" && !isNaN(Number(v)) ? Number(v) : v;';
-var COERCE_BOOLEAN_HELPER = 'export const coerceBoolean = (v) => v === "true" || v === "1" ? true : v === "false" || v === "0" ? false : v;';
+var COERCE_BOOLEAN_HELPER = 'export const coerceBoolean = (v) => {\n  const lower = typeof v === "string" ? v.toLowerCase() : v;\n  return lower === "true" || lower === "1" ? true : lower === "false" || lower === "0" ? false : v;\n};';
 var COERCE_MAP_HELPER = 'export const coerceMap = (v) => Array.isArray(v) ? new Map(v) : v instanceof Map ? v : (v && typeof v === "object" ? new Map(Object.entries(v)) : v);';
 var COERCE_SET_HELPER = "export const coerceSet = (v) => v instanceof Set ? v : (Array.isArray(v) ? new Set(v) : v);";
 var HELPERS_FILENAME = "faapi-helpers.js";
@@ -2150,7 +2554,10 @@ function generateTupleExpression(elements, ctx) {
     }
   }
   if (restExpression) {
-    return `z.tuple([${fixedExprs.join(", ")}]).rest(${restExpression})`;
+    const fixedWithOptional = fixedExprs.map(
+      (expr, i) => fixedOptional[i] ? `${expr}.optional()` : expr
+    );
+    return `z.tuple([${fixedWithOptional.join(", ")}]).rest(${restExpression})`;
   }
   const hasOptional = fixedOptional.some((o) => o);
   if (!hasOptional) {
@@ -2171,13 +2578,14 @@ function generateTupleExpression(elements, ctx) {
   }
   return `z.union([${variants.join(", ")}])`;
 }
-function generateObjectExpression(properties, ctx) {
-  const fields = properties.map((prop) => {
+function generateObjectExpression(type, ctx) {
+  const fields = type.properties.map((prop) => {
     const expr = runtimeTypeToZodExpression(prop.type, ctx, prop.constraints);
     const finalExpr = prop.optional ? `${expr}.optional()` : expr;
     return `${JSON.stringify(prop.name)}: ${finalExpr}`;
   });
-  return `z.object({ ${fields.join(", ")} })`;
+  const objectExpr = `z.object({ ${fields.join(", ")} })`;
+  return type.catchall !== void 0 ? `${objectExpr}.catchall(${runtimeTypeToZodExpression(type.catchall, ctx)})` : objectExpr;
 }
 function generateUnionExpression(members, ctx) {
   const hasNull = members.some((m) => m.kind === "null");
@@ -2222,7 +2630,7 @@ function containsRef(type, visited) {
       return false;
   }
 }
-function generateZodSchemaSource(typeInfo, resolveType, exportName, coerce = false) {
+function generateZodSchemaSourceParts(typeInfo, resolveType, exportName, coerce = false) {
   const ctx = new CodeGenContext(resolveType);
   const name = exportName ?? typeInfo.name;
   ctx.entryTypeName = typeInfo.name;
@@ -2230,21 +2638,14 @@ function generateZodSchemaSource(typeInfo, resolveType, exportName, coerce = fal
   ctx.coerce = coerce;
   collectNamedTypes(typeInfo.runtimeType, ctx);
   ctx.namedTypes.delete(typeInfo.name);
-  const lines = [];
-  lines.push("import { z } from 'zod';");
-  lines.push("");
-  for (const [n, type] of ctx.namedTypes) {
-    lines.push(generateNamedTypeDeclaration(n, type, ctx));
-  }
-  if (ctx.namedTypes.size > 0) lines.push("");
+  const namedTypeDeclarations = [...ctx.namedTypes].map(([n, type]) => ({
+    name: n,
+    declaration: generateNamedTypeDeclaration(n, type, ctx)
+  }));
   const entryExpr = runtimeTypeToZodExpression(typeInfo.runtimeType, ctx);
   const hasSelfRef = containsRef(typeInfo.runtimeType, /* @__PURE__ */ new Set([typeInfo.name]));
-  if (hasSelfRef) {
-    lines.push(`export const ${name}Schema = z.lazy(() => ${entryExpr});`);
-  } else {
-    lines.push(`export const ${name}Schema = ${entryExpr};`);
-  }
-  return lines.join("\n");
+  const entryDeclaration = hasSelfRef ? `export const ${name}Schema = z.lazy(() => ${entryExpr});` : `export const ${name}Schema = ${entryExpr};`;
+  return { namedTypeDeclarations, entryDeclaration };
 }
 
 // src/cli/generateSchemaFiles.ts
@@ -2255,7 +2656,7 @@ function getSchemaOutputPath(sourceFile, dist, rootDir) {
   }
   const idx = rel.lastIndexOf("/");
   const relDir = idx >= 0 ? rel.slice(0, idx) : "";
-  return path4.resolve(rootDir, dist, relDir, "zod.js");
+  return path6.resolve(rootDir, dist, relDir, "zod.js");
 }
 function getRuntimeSchemaPath(filePath, dist, rootDir) {
   let rel = filePath.replace(/\\/g, "/");
@@ -2266,16 +2667,17 @@ function getRuntimeSchemaPath(filePath, dist, rootDir) {
   }
   const idx = rel.lastIndexOf("/");
   const relDir = idx >= 0 ? rel.slice(0, idx) : "";
-  return path4.resolve(rootDir, dist, relDir, "zod.js");
+  return path6.resolve(rootDir, dist, relDir, "zod.js");
 }
 function getHelpersImportPath(relDir) {
   if (!relDir) return `./${HELPERS_FILENAME}`;
   const depth = relDir.split("/").filter(Boolean).length;
   return `${"../".repeat(depth)}${HELPERS_FILENAME}`;
 }
-function generateSchemaFileSource(sources, allTypes, helpersImportPath) {
-  const resolveType = (name) => allTypes.get(name)?.runtimeType;
+function generateSchemaFileSource(sources, resolveType, helpersImportPath) {
   const lines = ["import { z } from 'zod';"];
+  const namedTypeDeclarations = [];
+  const seenNamedTypes = /* @__PURE__ */ new Set();
   const schemaBlocks = [];
   for (const source of sources) {
     const { schemaName, typeInfo } = source;
@@ -2283,16 +2685,24 @@ function generateSchemaFileSource(sources, allTypes, helpersImportPath) {
       continue;
     }
     const coerce = source.coerce ?? /(?:Query|Params)$/.test(schemaName);
-    const block = [`// ${schemaName}`];
-    const schemaCode = generateZodSchemaSource(typeInfo, resolveType, schemaName, coerce).replace(
-      /^import \{ z \} from 'zod';\s*\n\s*\n/,
-      ""
+    const { namedTypeDeclarations: decls, entryDeclaration } = generateZodSchemaSourceParts(
+      typeInfo,
+      resolveType,
+      schemaName,
+      coerce
     );
-    block.push(schemaCode);
-    block.push("");
-    schemaBlocks.push(block.join("\n"));
+    for (const { name, declaration } of decls) {
+      if (seenNamedTypes.has(name)) continue;
+      seenNamedTypes.add(name);
+      namedTypeDeclarations.push(declaration);
+    }
+    schemaBlocks.push([`// ${schemaName}`, entryDeclaration, ""].join("\n"));
+  }
+  if (namedTypeDeclarations.length > 0) {
+    lines.push(...namedTypeDeclarations);
+    lines.push("");
   }
-  const allSchemaCode = schemaBlocks.join("\n");
+  const allSchemaCode = [...namedTypeDeclarations, ...schemaBlocks].join("\n");
   if (helpersImportPath && usesCoerceHelpers(allSchemaCode)) {
     lines.push(
       `import { coerceNumber, coerceBoolean, coerceMap, coerceSet } from '${helpersImportPath}';`
@@ -2304,7 +2714,7 @@ function generateSchemaFileSource(sources, allTypes, helpersImportPath) {
 }
 async function generateSchemaFiles(routes, rootDir, dist) {
   if (routes.length === 0) return;
-  const { sources, allTypesByFile } = collectRouteSchemaSources(routes, rootDir);
+  const { sources, resolversByFile } = collectRouteSchemaSources(routes, rootDir);
   const sourcesByFile = /* @__PURE__ */ new Map();
   for (const source of sources) {
     let list = sourcesByFile.get(source.filePath);
@@ -2316,9 +2726,8 @@ async function generateSchemaFiles(routes, rootDir, dist) {
   }
   const fileEntries = [];
   for (const [filePath, fileSources] of sourcesByFile) {
-    const relFile = path4.relative(rootDir, filePath).replace(/\\/g, "/");
+    const relFile = path6.relative(rootDir, filePath).replace(/\\/g, "/");
     const outputPath = getSchemaOutputPath(relFile, dist, rootDir);
-    const allTypes = allTypesByFile.get(filePath) ?? /* @__PURE__ */ new Map();
     let relForDir = relFile;
     if (relForDir.startsWith("src/")) {
       relForDir = relForDir.slice(4);
@@ -2326,12 +2735,17 @@ async function generateSchemaFiles(routes, rootDir, dist) {
     const dirIdx = relForDir.lastIndexOf("/");
     const zodRelDir = dirIdx >= 0 ? relForDir.slice(0, dirIdx) : "";
     const helpersImportPath = getHelpersImportPath(zodRelDir);
-    const source = generateSchemaFileSource(fileSources, allTypes, helpersImportPath);
+    const resolver = resolversByFile.get(filePath);
+    const source = generateSchemaFileSource(
+      fileSources,
+      (name) => resolver?.resolve(name)?.runtimeType,
+      helpersImportPath
+    );
     fileEntries.push({ outputPath, source });
   }
   const allSourceCode = fileEntries.map((e) => e.source).join("\n");
   if (usesCoerceHelpers(allSourceCode)) {
-    const helpersPath = path4.resolve(rootDir, dist, HELPERS_FILENAME);
+    const helpersPath = path6.resolve(rootDir, dist, HELPERS_FILENAME);
     await writeSchemaFile(helpersPath, generateHelpersFileSource());
   }
   await Promise.all(
@@ -2339,22 +2753,21 @@ async function generateSchemaFiles(routes, rootDir, dist) {
   );
 }
 async function writeSchemaFile(outputPath, source) {
-  await fs3.mkdir(path4.dirname(outputPath), { recursive: true });
-  await fs3.writeFile(outputPath, source, "utf-8");
+  await atomicWriteFile(outputPath, source);
 }
 
 // src/cli/compileOnDemand.ts
-import path8 from "path";
-import fs7 from "fs";
+import path11 from "path";
+import fs9 from "fs";
 
-// src/cli/compileDevRoutes.ts
-import path7 from "path";
-import fs6 from "fs";
+// src/cli/compileSourceFiles.ts
+import path9 from "path";
+import fs7 from "fs";
 import fg2 from "fast-glob";
 
 // src/cli/aliasPlugin.ts
-import path6 from "path";
-import fs5 from "fs";
+import path8 from "path";
+import fs6 from "fs";
 
 // src/utils/resolveAlias.ts
 function resolveAlias(specifier, config) {
@@ -2381,55 +2794,51 @@ function resolveAlias(specifier, config) {
 
 // src/utils/readTsconfig.ts
 import ts6 from "typescript";
-import path5 from "path";
-import fs4 from "fs";
+import path7 from "path";
+import fs5 from "fs";
+var tsconfigCache = /* @__PURE__ */ new Map();
 function readTsconfig(rootDir) {
-  const tsconfigPath = path5.resolve(rootDir, "tsconfig.json");
-  if (!fs4.existsSync(tsconfigPath)) return null;
+  const tsconfigPath = path7.resolve(rootDir, "tsconfig.json");
+  if (!fs5.existsSync(tsconfigPath)) return null;
+  let mtimeMs;
+  try {
+    mtimeMs = fs5.statSync(tsconfigPath).mtimeMs;
+  } catch {
+    return null;
+  }
+  const cached = tsconfigCache.get(tsconfigPath);
+  if (cached && cached.mtimeMs === mtimeMs) {
+    return cached.config;
+  }
   const configFile = ts6.readConfigFile(tsconfigPath, ts6.sys.readFile);
   if (configFile.error || !configFile.config) return null;
   const parsed = ts6.parseJsonConfigFileContent(configFile.config, ts6.sys, rootDir);
   const baseUrl = parsed.options.baseUrl ?? rootDir;
   const rawPaths = parsed.options.paths;
-  if (!rawPaths) return null;
-  const paths = {};
-  for (const [pattern, targets] of Object.entries(rawPaths)) {
-    paths[pattern] = targets.map((t) => path5.resolve(baseUrl, t));
-  }
-  return { baseUrl, paths };
+  const config = rawPaths ? (() => {
+    const paths = {};
+    for (const [pattern, targets] of Object.entries(rawPaths)) {
+      paths[pattern] = targets.map((t) => path7.resolve(baseUrl, t));
+    }
+    return { baseUrl, paths };
+  })() : null;
+  tsconfigCache.set(tsconfigPath, { mtimeMs, config });
+  return config;
 }
 
 // src/cli/aliasPlugin.ts
-function toProdExtension(filePath) {
-  if (filePath.endsWith(".ts")) return filePath.slice(0, -3) + ".js";
-  if (filePath.endsWith(".tsx")) return filePath.slice(0, -4) + ".js";
-  if (filePath.endsWith(".jsx")) return filePath.slice(0, -4) + ".js";
-  return filePath;
-}
 function toProdImportPath(sourceFile, importer) {
-  const importerDir = path6.dirname(importer);
-  let rel = path6.relative(importerDir, sourceFile);
-  rel = rel.split(path6.sep).join("/");
+  const importerDir = path8.dirname(importer);
+  let rel = path8.relative(importerDir, sourceFile);
+  rel = rel.split(path8.sep).join("/");
   if (!rel.startsWith(".")) rel = "./" + rel;
   return toProdExtension(rel);
 }
-function toRealPath(p) {
-  try {
-    return fs5.realpathSync(p);
-  } catch {
-    return p;
-  }
-}
-function isInsideDir(filePath, dir) {
-  const rel = path6.relative(dir, filePath);
-  return rel !== "" && !rel.startsWith("..") && !path6.isAbsolute(rel);
-}
-var APP_DIR = "src";
 function toStrippedProdImportPath(sourceFile, rootDir) {
-  const appDirAbs = toRealPath(path6.resolve(rootDir, APP_DIR));
+  const appDirAbs = toRealPath(path8.resolve(rootDir, APP_DIR));
   const sourceReal = toRealPath(sourceFile);
-  let rel = path6.relative(appDirAbs, sourceReal);
-  rel = rel.split(path6.sep).join("/");
+  let rel = path8.relative(appDirAbs, sourceReal);
+  rel = rel.split(path8.sep).join("/");
   if (!rel.startsWith(".")) rel = "./" + rel;
   return toProdExtension(rel);
 }
@@ -2444,41 +2853,41 @@ var INDEX_EXTS = [
   "/index.cjs"
 ];
 function resolveRelativeSpecifier(importer, specifier) {
-  const importerDir = path6.dirname(importer);
-  const base = path6.resolve(importerDir, specifier);
+  const importerDir = path8.dirname(importer);
+  const base = path8.resolve(importerDir, specifier);
   if (PROD_EXTS.some((ext) => specifier.endsWith(ext))) {
-    return fs5.existsSync(base) ? base : null;
+    return fs6.existsSync(base) ? base : null;
   }
   if (/\.(ts|tsx|jsx)$/.test(specifier)) {
-    return fs5.existsSync(base) ? base : null;
+    return fs6.existsSync(base) ? base : null;
   }
   for (const ext of SOURCE_EXTS) {
     const file = base + ext;
-    if (fs5.existsSync(file)) return file;
+    if (fs6.existsSync(file)) return file;
   }
   for (const indexExt of INDEX_EXTS) {
     const file = base + indexExt;
-    if (fs5.existsSync(file)) return file;
+    if (fs6.existsSync(file)) return file;
   }
   return null;
 }
 function createAliasPlugin(config, options) {
-  const SPEC_RE = /(\bfrom\s*|import\s*\(\s*)(['"])([^'"]+)\2/g;
-  const appDirAbs = options?.rootDir ? toRealPath(path6.resolve(options.rootDir, APP_DIR)) : null;
+  const SPEC_RE2 = /(\bfrom\s*|import\s*\(\s*)(['"])([^'"]+)\2/g;
+  const appDirAbs = options?.rootDir ? toRealPath(path8.resolve(options.rootDir, APP_DIR)) : null;
   return {
     name: "faapi-alias",
     setup(build) {
       build.onLoad({ filter: /\.(ts|tsx|js|jsx|mjs|cjs)$/ }, (args) => {
         let source;
         try {
-          source = fs5.readFileSync(args.path, "utf8");
+          source = fs6.readFileSync(args.path, "utf8");
         } catch {
           return void 0;
         }
         const importer = args.path;
         const importerOutsideAppDir = appDirAbs ? !isInsideDir(importer, appDirAbs) : false;
         let modified = false;
-        const newSource = source.replace(SPEC_RE, (full, prefix, quote, specifier) => {
+        const newSource = source.replace(SPEC_RE2, (full, prefix, quote, specifier) => {
           if (specifier.startsWith("/") || specifier.startsWith("file:") || specifier.startsWith("node:")) {
             return full;
           }
@@ -2504,7 +2913,7 @@ function createAliasPlugin(config, options) {
           for (const candidate of candidates) {
             for (const ext of SOURCE_EXTS) {
               const file = candidate + ext;
-              if (fs5.existsSync(file)) {
+              if (fs6.existsSync(file)) {
                 modified = true;
                 if (appDirAbs && importerOutsideAppDir && isInsideDir(file, appDirAbs)) {
                   return `${prefix}${quote}${toStrippedProdImportPath(
@@ -2517,7 +2926,7 @@ function createAliasPlugin(config, options) {
             }
             for (const indexExt of INDEX_EXTS) {
               const file = candidate + indexExt;
-              if (fs5.existsSync(file)) {
+              if (fs6.existsSync(file)) {
                 modified = true;
                 if (appDirAbs && importerOutsideAppDir && isInsideDir(file, appDirAbs)) {
                   return `${prefix}${quote}${toStrippedProdImportPath(
@@ -2542,11 +2951,10 @@ function buildAliasPlugins(rootDir) {
   return [createAliasPlugin(tsconfig ?? { baseUrl: ".", paths: {} }, { rootDir })];
 }
 
-// src/cli/compileDevRoutes.ts
-var APP_DIR2 = "src";
-async function compileDevRoutes(options) {
-  const { rootDir, dist, files, logLevel = "silent" } = options;
-  const entryPoints = files ?? await fg2([`${APP_DIR2}/**/*.ts`], {
+// src/cli/compileSourceFiles.ts
+async function compileSourceFiles(options) {
+  const { rootDir, dist, files, logLevel = "silent", production, atomicWrite } = options;
+  const entryPoints = files ?? await fg2([`${APP_DIR}/**/*.ts`], {
     cwd: rootDir,
     onlyFiles: true,
     absolute: true,
@@ -2555,11 +2963,11 @@ async function compileDevRoutes(options) {
   if (entryPoints.length === 0) {
     return { compiledFiles: [] };
   }
-  const absDist = path7.resolve(rootDir, dist);
-  await fs6.promises.mkdir(absDist, { recursive: true });
+  const absDist = path9.resolve(rootDir, dist);
+  await fs7.promises.mkdir(absDist, { recursive: true });
   const plugins = buildAliasPlugins(rootDir);
   const esbuild = await import("esbuild");
-  const outbase = path7.resolve(rootDir, APP_DIR2);
+  const outbase = path9.resolve(rootDir, APP_DIR);
   const result = await esbuild.build({
     entryPoints,
     outdir: absDist,
@@ -2570,27 +2978,102 @@ async function compileDevRoutes(options) {
     sourcemap: true,
     packages: "external",
     plugins,
+    // build 语义：编译期 NODE_ENV 替换 + 死分支删除（见 AGENTS.md §5.3）
+    ...production ? { define: { "process.env.NODE_ENV": '"production"' }, minifySyntax: true } : {},
     logLevel,
-    write: false
+    // dev 语义：esbuild 返回内存内容，由下方原子写落盘
+    ...atomicWrite ? { write: false } : {}
   });
-  if (result.outputFiles) {
+  if (atomicWrite && result.outputFiles) {
     await Promise.all(
       result.outputFiles.map(async (file) => {
-        await fs6.promises.mkdir(path7.dirname(file.path), { recursive: true });
+        await fs7.promises.mkdir(path9.dirname(file.path), { recursive: true });
         const tmp = `${file.path}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
-        await fs6.promises.writeFile(tmp, file.contents);
-        await fs6.promises.rename(tmp, file.path);
+        await fs7.promises.writeFile(tmp, file.contents);
+        await fs7.promises.rename(tmp, file.path);
       })
     );
   }
   return { compiledFiles: entryPoints };
 }
 
+// src/cli/compileDevRoutes.ts
+async function compileDevRoutes(options) {
+  return compileSourceFiles({ ...options, atomicWrite: true });
+}
+
+// src/cli/collectImports.ts
+import path10 from "path";
+import fs8 from "fs";
+var SPEC_RE = /(\bfrom\s*|import\s*\(\s*)(['"])([^'"]+)\2/g;
+function extractImportSpecifiers(source) {
+  const specifiers = [];
+  let match;
+  SPEC_RE.lastIndex = 0;
+  while ((match = SPEC_RE.exec(source)) !== null) {
+    specifiers.push(match[3]);
+  }
+  return specifiers;
+}
+function resolveSpecifierFromDir(dir, specifier) {
+  return resolveRelativeSpecifier(path10.join(dir, "__faapi_probe__.ts"), specifier);
+}
+async function collectRelativeImports(entryFiles, rootDir) {
+  const appDirAbs = toRealPath(path10.resolve(rootDir, "src"));
+  const tsconfig = readTsconfig(rootDir);
+  const visited = /* @__PURE__ */ new Set();
+  const insideFiles = /* @__PURE__ */ new Set();
+  const outsideFiles = /* @__PURE__ */ new Set();
+  async function collect(filePath) {
+    if (visited.has(filePath)) return;
+    visited.add(filePath);
+    let source;
+    try {
+      source = await fs8.promises.readFile(filePath, "utf8");
+    } catch {
+      return;
+    }
+    for (const specifier of extractImportSpecifiers(source)) {
+      if (/\.(js|mjs|cjs)$/.test(specifier)) continue;
+      let resolved;
+      if (specifier.startsWith("./") || specifier.startsWith("../")) {
+        resolved = resolveRelativeSpecifier(filePath, specifier);
+      } else if (tsconfig) {
+        resolved = null;
+        for (const candidate of resolveAlias(specifier, tsconfig)) {
+          const probed = resolveSpecifierFromDir(rootDir, candidate);
+          if (probed) {
+            resolved = probed;
+            break;
+          }
+        }
+      } else {
+        resolved = null;
+      }
+      if (!resolved) continue;
+      if (!isInsideDir(toRealPath(resolved), toRealPath(path10.resolve(rootDir)))) continue;
+      if (isInsideDir(toRealPath(resolved), appDirAbs)) {
+        insideFiles.add(resolved);
+      } else {
+        outsideFiles.add(resolved);
+      }
+      await collect(resolved);
+    }
+  }
+  for (const entry of entryFiles) {
+    await collect(entry);
+  }
+  return {
+    insideFiles: Array.from(insideFiles),
+    outsideFiles: Array.from(outsideFiles)
+  };
+}
+
 // src/cli/compileOnDemand.ts
 function isProductFresh(sourceAbsPath, productAbsPath) {
   try {
-    const srcStat = fs7.statSync(sourceAbsPath);
-    const prodStat = fs7.statSync(productAbsPath);
+    const srcStat = fs9.statSync(sourceAbsPath);
+    const prodStat = fs9.statSync(productAbsPath);
     return prodStat.mtimeMs >= srcStat.mtimeMs;
   } catch {
     return false;
@@ -2608,16 +3091,16 @@ function createDevOnDemandState() {
 }
 var state = createDevOnDemandState();
 async function ensureCompiled(sourceAbsPath, rootDir, dist) {
-  const inFlight = state.inFlightCompilations.get(sourceAbsPath);
-  if (inFlight) {
-    await inFlight.catch(() => {
+  const inFlight2 = state.inFlightCompilations.get(sourceAbsPath);
+  if (inFlight2) {
+    await inFlight2.catch(() => {
     });
     return false;
   }
   if (state.compiledFiles.has(sourceAbsPath)) {
     return false;
   }
-  if (!fs7.existsSync(sourceAbsPath)) {
+  if (!fs9.existsSync(sourceAbsPath)) {
     return false;
   }
   const productPath = prodSourcePathToProductPath(sourceAbsPath, rootDir, dist);
@@ -2626,12 +3109,23 @@ async function ensureCompiled(sourceAbsPath, rootDir, dist) {
     return false;
   }
   const compilePromise = (async () => {
+    const { insideFiles } = await collectRelativeImports([sourceAbsPath], rootDir);
+    const files = [sourceAbsPath];
+    for (const dep of insideFiles) {
+      if (state.compiledFiles.has(dep)) continue;
+      const depProduct = prodSourcePathToProductPath(dep, rootDir, dist);
+      if (depProduct && isProductFresh(dep, depProduct)) continue;
+      files.push(dep);
+    }
     await compileDevRoutes({
       rootDir,
       dist,
-      files: [sourceAbsPath],
+      files,
       logLevel: "silent"
     });
+    for (const file of files) {
+      state.compiledFiles.add(file);
+    }
     state.compiledFiles.add(sourceAbsPath);
   })();
   state.inFlightCompilations.set(sourceAbsPath, compilePromise);
@@ -2642,26 +3136,39 @@ async function ensureCompiled(sourceAbsPath, rootDir, dist) {
     state.inFlightCompilations.delete(sourceAbsPath);
   }
 }
+async function ensureMiddlewaresCompiled(middlewarePaths, rootDir) {
+  if (!isDevOnDemandEnabled() || middlewarePaths.length === 0) return;
+  const dist = getDevDist();
+  if (!dist) return;
+  for (const mwPath of middlewarePaths) {
+    const sourcePath = prodPathToSourcePath(mwPath, rootDir, dist);
+    try {
+      await ensureCompiled(sourcePath, rootDir, dist);
+    } catch (err) {
+      console.error(`[faapi] Failed to compile middleware source ${sourcePath}:`, err);
+    }
+  }
+}
 function prodSourcePathToProductPath(sourceAbsPath, rootDir, dist) {
-  const rel = path8.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
+  const rel = path11.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
   if (!rel.startsWith("src/")) return null;
   const relWithoutSrc = rel.slice(4);
   const jsRel = relWithoutSrc.replace(/\.ts$/, ".js");
-  return path8.resolve(rootDir, dist, jsRel);
+  return path11.resolve(rootDir, dist, jsRel);
 }
 async function ensureSchemaGenerated(schemaPath, routeFilePath, routes, rootDir, dist) {
-  const inFlight = state.inFlightSchemaGenerations.get(schemaPath);
-  if (inFlight) {
-    await inFlight.catch(() => {
+  const inFlight2 = state.inFlightSchemaGenerations.get(schemaPath);
+  if (inFlight2) {
+    await inFlight2.catch(() => {
     });
     return false;
   }
   if (state.generatedSchemas.has(schemaPath)) {
     return false;
   }
-  const prodAbsPath = path8.resolve(rootDir, routeFilePath);
+  const prodAbsPath = path11.resolve(rootDir, routeFilePath);
   const sourceAbsPath = prodPathToSourcePath(prodAbsPath, rootDir, dist);
-  if (!fs7.existsSync(sourceAbsPath)) {
+  if (!fs9.existsSync(sourceAbsPath)) {
     return false;
   }
   if (isProductFresh(sourceAbsPath, schemaPath)) {
@@ -2672,7 +3179,7 @@ async function ensureSchemaGenerated(schemaPath, routeFilePath, routes, rootDir,
   if (fileRoutes.length === 0) {
     return false;
   }
-  const sourceRelPath = path8.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
+  const sourceRelPath = path11.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
   const sourceRoutes = fileRoutes.map((r) => ({ ...r, filePath: sourceRelPath }));
   const generatePromise = (async () => {
     await generateSchemaFiles(sourceRoutes, rootDir, dist);
@@ -2686,17 +3193,26 @@ async function ensureSchemaGenerated(schemaPath, routeFilePath, routes, rootDir,
     state.inFlightSchemaGenerations.delete(schemaPath);
   }
 }
+var sourcePathCache = /* @__PURE__ */ new Map();
 function prodPathToSourcePath(prodAbsPath, rootDir, dist) {
-  const rel = path8.relative(rootDir, prodAbsPath).replace(/\\/g, "/");
+  const cached = sourcePathCache.get(prodAbsPath);
+  if (cached) return cached;
+  const rel = path11.relative(rootDir, prodAbsPath).replace(/\\/g, "/");
   let relWithoutDist = rel;
   if (relWithoutDist.startsWith(`${dist}/`)) {
     relWithoutDist = relWithoutDist.slice(dist.length + 1);
   }
   const srcRel = `src/${relWithoutDist}`;
   const tsRel = srcRel.replace(/\.js$/, ".ts");
-  const tsAbs = path8.resolve(rootDir, tsRel);
-  if (fs7.existsSync(tsAbs)) return tsAbs;
-  return path8.resolve(rootDir, srcRel);
+  const tsAbs = path11.resolve(rootDir, tsRel);
+  let result;
+  if (fs9.existsSync(tsAbs)) {
+    result = tsAbs;
+  } else {
+    result = path11.resolve(rootDir, srcRel);
+  }
+  sourcePathCache.set(prodAbsPath, result);
+  return result;
 }
 function isDevOnDemandEnabled() {
   return state.enabled;
@@ -2730,28 +3246,25 @@ async function validateInput(schemaPath, method, inputType, input) {
   }
   const schema = mod[schemaKey];
   if (schema === void 0 || schema === null) {
-    const data = typeof input === "object" && input !== null && !Array.isArray(input) ? input : {};
-    return { valid: true, issues: [], data };
+    return { valid: true, issues: [], data: input };
   }
   if (typeof schema !== "object" || typeof schema.safeParse !== "function") {
     throw new InternalError(`Schema \u4E0D\u662F\u6709\u6548\u7684 zod schema: ${schemaPath}#${schemaName}`);
   }
-  const inputObj = typeof input === "object" && input !== null && !Array.isArray(input) ? input : {};
   const zodSchema = schema;
-  const result = zodSchema.safeParse(inputObj);
+  const result = zodSchema.safeParse(input);
   if (result.success) {
-    const data = typeof result.data === "object" && result.data !== null && !Array.isArray(result.data) ? result.data : {};
-    return { valid: true, issues: [], data };
+    return { valid: true, issues: [], data: result.data };
   }
   const issues = mapZodIssues(result.error);
-  return { valid: false, issues, data: inputObj };
+  return { valid: false, issues, data: input };
 }
 function mapZodIssues(error) {
   return error.issues.map((issue) => {
-    const code = mapZodCode(issue.code, issue.message);
-    const path12 = issue.path.map(String).join(".") || "";
+    const code = mapZodCode(issue);
+    const path15 = issue.path.map(String).join(".") || "";
     return {
-      path: path12,
+      path: path15,
       code,
       expected: issue.expected ?? mapExpectedFromMessage(issue.message),
       received: issue.received ?? mapReceivedFromMessage(issue.message),
@@ -2759,27 +3272,29 @@ function mapZodIssues(error) {
     };
   });
 }
-function mapZodCode(zodCode, message) {
-  switch (zodCode) {
+function mapZodCode(issue) {
+  switch (issue.code) {
     case "invalid_type":
+      if (issue.received === "undefined" || /received undefined/i.test(issue.message)) {
+        return "MISSING_FIELD";
+      }
+      return "TYPE_MISMATCH";
     case "invalid_union":
     case "invalid_union_discriminator":
       return "TYPE_MISMATCH";
     case "unrecognized_keys":
       return "INVALID_FORMAT";
     case "invalid_value":
-    case "invalid_string":
+    case "invalid_format":
+    case "invalid_key":
+    case "invalid_element":
     case "too_small":
     case "too_big":
     case "invalid_intersection_types":
     case "not_multiple_of":
-      return "INVALID_VALUE";
     case "custom":
       return "INVALID_VALUE";
     default:
-      if (message.includes("Required") || message.includes("required")) {
-        return "MISSING_FIELD";
-      }
       return "INVALID_VALUE";
   }
 }
@@ -2799,45 +3314,119 @@ import {
 import { createSecureServer as createHttp2SecureServer } from "http2";
 import { readFileSync } from "fs";
 import { Readable as Readable2 } from "stream";
-import path10 from "path";
+import path13 from "path";
 
 // src/router/matchRoute.ts
-function matchRoute(routes, method, path12) {
+var httpIndexCache = /* @__PURE__ */ new WeakMap();
+var wsIndexCache = /* @__PURE__ */ new WeakMap();
+function getHttpIndex(routes) {
+  let index = httpIndexCache.get(routes);
+  if (index) return index;
+  index = { static: /* @__PURE__ */ new Map(), methodsByStaticPath: /* @__PURE__ */ new Map(), dynamics: [] };
   for (const route of routes) {
-    if (route.method !== method) {
-      continue;
-    }
-    if (!route.isDynamic) {
-      if (route.urlPath === path12) {
-        return { route, params: {} };
+    if (route.isDynamic) {
+      index.dynamics.push({
+        route,
+        segments: route.urlPath.split("/").filter(Boolean)
+      });
+    } else {
+      index.static.set(`${route.method}|${route.urlPath}`, route);
+      let methods = index.methodsByStaticPath.get(route.urlPath);
+      if (!methods) {
+        methods = /* @__PURE__ */ new Set();
+        index.methodsByStaticPath.set(route.urlPath, methods);
       }
+      methods.add(route.method);
+    }
+  }
+  httpIndexCache.set(routes, index);
+  return index;
+}
+function getWsIndex(routes) {
+  let index = wsIndexCache.get(routes);
+  if (index) return index;
+  index = { static: /* @__PURE__ */ new Map(), dynamics: [] };
+  for (const route of routes) {
+    if (route.isDynamic) {
+      index.dynamics.push(route);
+    } else {
+      index.static.set(route.urlPath, route);
+    }
+  }
+  wsIndexCache.set(routes, index);
+  return index;
+}
+function matchRoute(routes, method, path15) {
+  const index = getHttpIndex(routes);
+  const upper = method.toUpperCase();
+  const hit = matchByMethod(index, upper, path15);
+  if (hit) return hit;
+  if (upper === "HEAD") {
+    return matchByMethod(index, "GET", path15);
+  }
+  return null;
+}
+function matchByMethod(index, method, path15) {
+  const staticHit = index.static.get(`${method}|${path15}`);
+  if (staticHit) {
+    return { route: staticHit, params: {} };
+  }
+  for (const entry of index.dynamics) {
+    const route = entry.route;
+    if (route.method !== method) {
       continue;
     }
-    const params = matchDynamicPath(route.urlPath, path12, route.paramNames, route.isCatchAll);
+    const params = matchSegments(entry.segments, path15, route.paramNames, route.isCatchAll);
     if (params !== null) {
       return { route, params };
     }
   }
   return null;
 }
-function matchWsRoute(wsRoutes, path12) {
-  for (const route of wsRoutes) {
-    if (!route.isDynamic) {
-      if (route.urlPath === path12) {
-        return { route, params: {} };
-      }
-      continue;
-    }
-    const params = matchDynamicPath(route.urlPath, path12, route.paramNames, route.isCatchAll);
+function matchWsRoute(wsRoutes, path15) {
+  const index = getWsIndex(wsRoutes);
+  const staticHit = index.static.get(path15);
+  if (staticHit) {
+    return { route: staticHit, params: {} };
+  }
+  for (const route of index.dynamics) {
+    const params = matchDynamicPath(route.urlPath, path15, route.paramNames, route.isCatchAll);
     if (params !== null) {
       return { route, params };
     }
   }
   return null;
 }
-function matchDynamicPath(pattern, path12, paramNames, isCatchAll) {
-  const patternSegments = pattern.split("/").filter(Boolean);
-  const pathSegments = path12.split("/").filter(Boolean);
+function findAllowedMethods(routes, path15) {
+  const index = getHttpIndex(routes);
+  const methods = /* @__PURE__ */ new Set();
+  const staticMethods = index.methodsByStaticPath.get(path15);
+  if (staticMethods) {
+    for (const method of staticMethods) {
+      methods.add(method);
+    }
+  }
+  for (const entry of index.dynamics) {
+    const params = matchSegments(
+      entry.segments,
+      path15,
+      entry.route.paramNames,
+      entry.route.isCatchAll
+    );
+    if (params !== null) {
+      methods.add(entry.route.method);
+    }
+  }
+  if (methods.has("GET")) {
+    methods.add("HEAD");
+  }
+  return Array.from(methods);
+}
+function matchDynamicPath(pattern, path15, paramNames, isCatchAll) {
+  return matchSegments(pattern.split("/").filter(Boolean), path15, paramNames, isCatchAll);
+}
+function matchSegments(patternSegments, path15, paramNames, isCatchAll) {
+  const pathSegments = path15.split("/").filter(Boolean);
   if (isCatchAll) {
     const nonCatchAllCount = patternSegments.length - 1;
     if (pathSegments.length <= nonCatchAllCount) {
@@ -2882,9 +3471,6 @@ function matchDynamicPath(pattern, path12, paramNames, isCatchAll) {
   return params;
 }
 
-// src/loader/loadRouteModule.ts
-import fs8 from "fs";
-
 // src/loader/resolveExports.ts
 function resolveExport(module, exportName) {
   if (exportName in module && typeof module[exportName] !== "undefined") {
@@ -2915,7 +3501,7 @@ async function loadRouteModule(filePath, method, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs8.existsSync(sourcePath)) {
+      if (sourcePath) {
         try {
           await ensureCompiled(sourcePath, rootDir, dist);
         } catch (compileErr) {
@@ -2980,7 +3566,7 @@ async function parseMultipart(request) {
 }
 
 // src/runtime/resolveInput.ts
-async function resolveInput(method, request) {
+async function resolveInputFromUrl(method, request, url) {
   const inputType = getInputTypeForMethod(method);
   if (inputType === "body") {
     const contentType = request.headers.get("content-type") ?? "";
@@ -2989,7 +3575,7 @@ async function resolveInput(method, request) {
     }
     if (contentType.includes("application/x-www-form-urlencoded")) {
       const text2 = await request.text();
-      if (text2.trim() === "") return null;
+      if (isBlankText(text2)) return null;
       const params = new URLSearchParams(text2);
       const obj = {};
       for (const [key, value] of params) {
@@ -2998,7 +3584,7 @@ async function resolveInput(method, request) {
       return obj;
     }
     const text = await request.text();
-    if (text.trim() === "") {
+    if (isBlankText(text)) {
       return null;
     }
     const result = parseJsonBody(text);
@@ -3015,9 +3601,28 @@ async function resolveInput(method, request) {
     }
     return result.data;
   }
-  const url = new URL(request.url);
   return queryToObject(url.searchParams);
 }
+function isBlankText(text) {
+  return text.length === 0 || !/\S/.test(text);
+}
+async function resolveBodyForQueryMethod(request) {
+  const text = await request.text();
+  if (isBlankText(text)) return void 0;
+  const result = parseJsonBody(text);
+  if (!result.success) {
+    throw new ValidationError("\u8BF7\u6C42\u4F53\u4E0D\u662F\u5408\u6CD5\u7684 JSON", [
+      {
+        path: "body",
+        code: "INVALID_FORMAT",
+        expected: "JSON",
+        received: "text",
+        message: "\u8BF7\u6C42\u4F53\u4E0D\u662F\u5408\u6CD5\u7684 JSON"
+      }
+    ]);
+  }
+  return result.data;
+}
 
 // src/response/sendNodeResponse.ts
 import { Readable } from "stream";
@@ -3030,11 +3635,24 @@ async function sendNodeResponse(response, res) {
       res.setHeader(key, value);
     }
   }
+  const deferred = consumePendingMetaHeaders(response);
+  if (deferred) {
+    for (const [key, value] of Object.entries(deferred)) {
+      res.setHeader(key, value);
+    }
+  }
   if (response.body) {
     const nodeStream = Readable.fromWeb(response.body);
     await new Promise((resolve, reject) => {
       nodeStream.on("error", reject);
-      res.on("error", reject);
+      const abort = () => {
+        nodeStream.destroy();
+        resolve();
+      };
+      res.on("error", abort);
+      res.on("close", () => {
+        if (!res.writableEnded) abort();
+      });
       res.on("finish", resolve);
       nodeStream.pipe(res);
     });
@@ -3044,11 +3662,13 @@ async function sendNodeResponse(response, res) {
 }
 
 // src/utils/getClientIp.ts
-function getClientIp(req) {
-  const xff = req.headers["x-forwarded-for"];
-  if (typeof xff === "string" && xff.length > 0) {
-    const first = xff.split(",")[0]?.trim();
-    if (first) return first;
+function getClientIp(req, trustedProxy = false) {
+  if (trustedProxy) {
+    const xff = req.headers["x-forwarded-for"];
+    if (typeof xff === "string" && xff.length > 0) {
+      const first = xff.split(",")[0]?.trim();
+      if (first) return first;
+    }
   }
   const remote = req.socket?.remoteAddress;
   if (remote) {
@@ -3085,11 +3705,6 @@ function cors(options = {}) {
     } else if (Array.isArray(origin)) {
       allowOrigin = origin.includes(reqOrigin) ? reqOrigin : null;
     }
-    if (!allowOrigin) {
-      await next();
-      return;
-    }
-    ctx.setHeader("Access-Control-Allow-Origin", allowOrigin);
     if (origin === true || Array.isArray(origin)) {
       const existingVary = ctx.headers.get("vary");
       if (existingVary) {
@@ -3100,6 +3715,11 @@ function cors(options = {}) {
         ctx.setHeader("Vary", "Origin");
       }
     }
+    if (!allowOrigin) {
+      await next();
+      return;
+    }
+    ctx.setHeader("Access-Control-Allow-Origin", allowOrigin);
     ctx.setHeader("Access-Control-Allow-Methods", methods.join(", "));
     if (allowedHeaders) {
       ctx.setHeader("Access-Control-Allow-Headers", allowedHeaders.join(", "));
@@ -3187,6 +3807,172 @@ function helmet(options = {}) {
   };
 }
 
+// src/middleware/compression.ts
+import zlib from "zlib";
+import { promisify } from "util";
+var gzipAsync = promisify(zlib.gzip);
+var deflateAsync = promisify(zlib.deflate);
+var brotliAsync = promisify(zlib.brotliCompress);
+var DEFAULT_THRESHOLD = 1024;
+var COMPRESSIBLE_CHECKS = [
+  (ct) => ct === "application/json",
+  (ct) => ct === "application/javascript",
+  (ct) => ct === "image/svg+xml",
+  (ct) => ct.startsWith("text/") && ct !== "text/event-stream"
+];
+function isCompressible(contentType) {
+  const ct = contentType.split(";")[0].trim().toLowerCase();
+  if (ct === "") return false;
+  return COMPRESSIBLE_CHECKS.some((check) => check(ct));
+}
+function parseAcceptEncoding(header) {
+  return header.split(",").map((part) => part.trim()).filter((part) => part !== "").map((part) => {
+    const [encoding, ...params] = part.split(";");
+    let quality = 1;
+    for (const param of params) {
+      const trimmed = param.trim();
+      if (trimmed.startsWith("q=")) {
+        const q = Number(trimmed.slice(2));
+        if (Number.isFinite(q)) quality = q;
+      }
+    }
+    return { encoding: (encoding ?? "").trim().toLowerCase(), quality };
+  }).filter((e) => e.encoding !== "" && e.quality > 0);
+}
+function selectEncoding(accepted) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const { encoding, quality } of accepted) {
+    byName.set(encoding, Math.max(byName.get(encoding) ?? 0, quality));
+  }
+  for (const [encoding, quality] of byName) {
+    if (quality === 0) byName.delete(encoding);
+  }
+  for (const candidate of ["br", "gzip", "deflate"]) {
+    if ((byName.get(candidate) ?? 0) > 0) return candidate;
+  }
+  if ((byName.get("*") ?? 0) > 0) return "gzip";
+  return null;
+}
+async function compressBody(encoding, body) {
+  const buf = Buffer.from(body, "utf-8");
+  switch (encoding) {
+    case "br":
+      return brotliAsync(buf);
+    case "gzip":
+      return gzipAsync(buf);
+    case "deflate":
+      return deflateAsync(buf);
+  }
+}
+function mergeVary(meta, value) {
+  const existing = meta.headers["Vary"] ?? meta.headers["vary"];
+  if (!existing) {
+    meta.headers["Vary"] = value;
+    return;
+  }
+  if (!existing.toLowerCase().includes(value.toLowerCase())) {
+    const key = meta.headers["Vary"] !== void 0 ? "Vary" : "vary";
+    meta.headers[key] = `${existing}, ${value}`;
+  }
+}
+function compression(options = {}) {
+  const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+  return async (ctx, next) => {
+    const meta = ctx.meta;
+    const response = await next();
+    if (!response) return response;
+    mergeVary(meta, "Accept-Encoding");
+    const acceptEncoding = ctx.request.headers.get("accept-encoding") ?? "";
+    const encoding = selectEncoding(parseAcceptEncoding(acceptEncoding));
+    const contentType = response.headers.get("content-type") ?? "";
+    if (!encoding || !isCompressible(contentType) || response.headers.has("content-encoding") || (response.headers.get("cache-control") ?? "").includes("no-transform") || response.status === 204 || response.status === 304 || response.body === null) {
+      return response;
+    }
+    const deferredHeaders = consumePendingMetaHeaders(response);
+    const bodyText = await response.text();
+    if (bodyText.length < threshold) {
+      const headers2 = new Headers(response.headers);
+      for (const [key, value] of Object.entries(deferredHeaders ?? {})) {
+        headers2.set(key, value);
+      }
+      return new Response(bodyText, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: headers2
+      });
+    }
+    const compressed = await compressBody(encoding, bodyText);
+    const headers = new Headers(response.headers);
+    for (const [key, value] of Object.entries(deferredHeaders ?? {})) {
+      headers.set(key, value);
+    }
+    headers.set("Content-Encoding", encoding);
+    headers.delete("Content-Length");
+    return new Response(compressed, {
+      status: response.status,
+      statusText: response.statusText,
+      headers
+    });
+  };
+}
+
+// src/middleware/etag.ts
+import { createHash } from "crypto";
+var DEFAULTS2 = { weak: true };
+function computeEtag(body, weak) {
+  const hash = createHash("sha1").update(body).digest("base64");
+  return weak ? `W/"${hash}"` : `"${hash}"`;
+}
+function ifNoneMatchMatches(ifNoneMatch, etag2, weak) {
+  const normalize = (tag) => tag.trim().replace(/^W\//i, "");
+  if (weak) {
+    const target = normalize(etag2);
+    return ifNoneMatch.split(",").some((tag) => {
+      const trimmed = tag.trim();
+      return trimmed === "*" || normalize(trimmed) === target;
+    });
+  }
+  return ifNoneMatch.split(",").some((tag) => tag.trim() === etag2 || tag.trim() === "*");
+}
+function etag(options = {}) {
+  const opts = { ...DEFAULTS2, ...options };
+  return async (ctx, next) => {
+    const meta = ctx.meta;
+    const response = await next();
+    if (!response) return response;
+    const method = ctx.request.method.toUpperCase();
+    if (method !== "GET" && method !== "HEAD") return response;
+    if (response.status < 200 || response.status >= 300) return response;
+    if (meta.headers["etag"] !== void 0 || response.headers.has("etag")) {
+      return response;
+    }
+    if (response.body === null || (response.headers.get("content-type") ?? "").includes("text/event-stream")) {
+      return response;
+    }
+    const bodyText = await response.text();
+    const etagValue = computeEtag(bodyText, opts.weak);
+    const ifNoneMatch = ctx.request.headers.get("if-none-match");
+    if (ifNoneMatch && ifNoneMatchMatches(ifNoneMatch, etagValue, opts.weak)) {
+      return new Response(null, {
+        status: 304,
+        statusText: response.statusText,
+        headers: { ETag: etagValue }
+      });
+    }
+    meta.headers["etag"] = etagValue;
+    const headers = new Headers(response.headers);
+    const deferredHeaders = consumePendingMetaHeaders(response);
+    for (const [key, value] of Object.entries(deferredHeaders ?? {})) {
+      headers.set(key, value);
+    }
+    return new Response(bodyText, {
+      status: response.status,
+      statusText: response.statusText,
+      headers
+    });
+  };
+}
+
 // src/middleware/logger.ts
 function logger(options = {}) {
   return async (ctx, next) => {
@@ -3221,9 +4007,9 @@ function logger(options = {}) {
 }
 
 // src/server/handleWsUpgrade.ts
-import fs9 from "fs";
+import fs10 from "fs";
 import { WebSocketServer, WebSocket } from "ws";
-import path9 from "path";
+import path12 from "path";
 
 // src/server/serverUtils.ts
 function nodeHttpToWebHeaders(req) {
@@ -3279,7 +4065,7 @@ async function loadWsHandler(filePath, ctx, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs9.existsSync(sourcePath)) {
+      if (sourcePath && fs10.existsSync(sourcePath)) {
         await ensureCompiled(sourcePath, rootDir, dist);
       }
     }
@@ -3302,9 +4088,9 @@ function bindEvents(rawSocket, handlers) {
     }
   }
   if (handlers.onMessage) {
-    rawSocket.on("message", (data) => {
-      const buf = Buffer.isBuffer(data) ? data : Buffer.from(data);
-      handlers.onMessage(ws, buf.toString("utf8"));
+    rawSocket.on("message", (data, isBinary) => {
+      const buf = toWsBuffer(data);
+      handlers.onMessage(ws, isBinary ? buf : buf.toString("utf8"));
     });
   }
   if (handlers.onClose) {
@@ -3318,12 +4104,22 @@ function bindEvents(rawSocket, handlers) {
     });
   }
 }
+function toWsBuffer(data) {
+  if (Buffer.isBuffer(data)) return data;
+  if (Array.isArray(data)) return Buffer.concat(data);
+  return Buffer.from(data);
+}
 async function sendResponseToSocket(socket, response) {
   const body = await response.text().catch(() => "");
   const statusLine = `HTTP/1.1 ${response.status} ${response.statusText || ""}\r
 `;
   const headerLines = [];
   let hasContentLength = false;
+  const deferredHeaders = consumePendingMetaHeaders(response);
+  for (const [key, value] of Object.entries(deferredHeaders ?? {})) {
+    if (key.toLowerCase() === "content-length") hasContentLength = true;
+    headerLines.push(`${key}: ${value}`);
+  }
   for (const [key, value] of response.headers) {
     if (key.toLowerCase() === "content-length") {
       hasContentLength = true;
@@ -3337,9 +4133,33 @@ async function sendResponseToSocket(socket, response) {
   socket.destroy();
 }
 function attachWebSocket(options) {
-  const { server, routesRef, rootDir, config, globalMiddlewares } = options;
+  const {
+    server,
+    routesRef,
+    rootDir,
+    config,
+    globalMiddlewares,
+    trustedProxy = false,
+    registries
+  } = options;
   const wss = new WebSocketServer({ noServer: true });
   server.on("upgrade", async (req, socket, head) => {
+    try {
+      await handleUpgradeRequest(req, socket, head);
+    } catch (err) {
+      console.error("[faapi] WS upgrade \u5904\u7406\u5931\u8D25:", err);
+      if (!socket.destroyed) {
+        try {
+          if (!socket.writableEnded) {
+            socket.write("HTTP/1.1 500 Internal Server Error\r\n\r\n");
+          }
+        } catch {
+        }
+        socket.destroy();
+      }
+    }
+  });
+  async function handleUpgradeRequest(req, socket, head) {
     const currentWsRoutes = routesRef.wsCurrent;
     const pathname = getPathname(req);
     const match = matchWsRoute(currentWsRoutes, pathname);
@@ -3353,13 +4173,13 @@ function attachWebSocket(options) {
     const host = req.headers.host ?? "localhost";
     const url = `http://${host}${req.url ?? "/"}`;
     const request = new Request(url, { method: "GET", headers });
-    const ctx = createContext(request, params, config, getClientIp(req));
+    const ctx = createContext(request, params, config, getClientIp(req, trustedProxy), registries);
     const meta = ctx.meta;
     let upgraded = false;
     const finalHandler = async () => {
       let handlers;
       try {
-        const absoluteFilePath = path9.resolve(rootDir, route.filePath);
+        const absoluteFilePath = path12.resolve(rootDir, route.filePath);
         handlers = await loadWsHandler(absoluteFilePath, ctx, rootDir);
       } catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
@@ -3383,6 +4203,7 @@ function attachWebSocket(options) {
     let response;
     try {
       if (route.middlewares === void 0 && route.middlewarePaths) {
+        await ensureMiddlewaresCompiled(route.middlewarePaths, rootDir);
         const bundle = await loadMergedMiddlewares(route.middlewarePaths);
         if (bundle) {
           route.middlewares = bundle.middlewares;
@@ -3408,7 +4229,7 @@ function attachWebSocket(options) {
       return;
     }
     await sendResponseToSocket(socket, mergeMeta(response, meta));
-  });
+  }
   return wss;
 }
 
@@ -3422,16 +4243,26 @@ function toWebRequest(req, bodyLimit = DEFAULT_BODY_LIMIT) {
   const headers = nodeHttpToWebHeaders(req);
   const method = req.method ?? "GET";
   if (method === "GET" || method === "HEAD") {
-    return new Request(url.toString(), { method, headers });
+    return { request: new Request(url.toString(), { method, headers }), url };
+  }
+  const contentLength = req.headers["content-length"];
+  if (contentLength !== void 0) {
+    const declared = Number(Array.isArray(contentLength) ? contentLength[0] : contentLength);
+    if (Number.isFinite(declared) && declared > bodyLimit) {
+      throw new PayloadTooLargeError(bodyLimit);
+    }
   }
   const stream = Readable2.toWeb(req);
   const limitedStream = limitStreamSize(stream, bodyLimit);
-  return new Request(url.toString(), {
-    method,
-    headers,
-    body: limitedStream,
-    duplex: "half"
-  });
+  return {
+    request: new Request(url.toString(), {
+      method,
+      headers,
+      body: limitedStream,
+      duplex: "half"
+    }),
+    url
+  };
 }
 function limitStreamSize(stream, maxSize) {
   let totalSize = 0;
@@ -3483,22 +4314,6 @@ function limitStreamSize(stream, maxSize) {
     }
   });
 }
-function findAllowedMethods(routes, path12) {
-  const methods = /* @__PURE__ */ new Set();
-  for (const route of routes) {
-    if (route.urlPath === path12) {
-      methods.add(route.method);
-      continue;
-    }
-    if (route.isDynamic) {
-      const params = matchDynamicPath(route.urlPath, path12, route.paramNames, route.isCatchAll);
-      if (params !== null) {
-        methods.add(route.method);
-      }
-    }
-  }
-  return Array.from(methods);
-}
 function createServer(options) {
   const {
     routes,
@@ -3511,12 +4326,20 @@ function createServer(options) {
     middlewares: globalMiddlewares,
     injectors: globalInjectors,
     helmet: helmetOption,
+    compression: compressionOption,
+    etag: etagOption,
+    registries,
     logger: loggerOption,
     bodyLimit = DEFAULT_BODY_LIMIT,
-    http2: http2Option
+    http2: http2Option,
+    trustedProxy = false
   } = options;
   const routesRef = { current: routes, wsCurrent: wsRoutes ?? [] };
   const configMiddlewares = [];
+  if (compressionOption) {
+    const compOpts = typeof compressionOption === "object" ? compressionOption : {};
+    configMiddlewares.push(compression(compOpts));
+  }
   const corsMiddleware = corsOption === false ? null : corsOption === true || corsOption === void 0 ? cors() : cors(corsOption);
   if (corsMiddleware) configMiddlewares.push(corsMiddleware);
   if (helmetOption) {
@@ -3525,6 +4348,14 @@ function createServer(options) {
   }
   const loggerMiddlewareInst = loggerOption === false ? null : loggerOption === true || loggerOption === void 0 ? logger() : logger(loggerOption);
   if (loggerMiddlewareInst) configMiddlewares.push(loggerMiddlewareInst);
+  if (etagOption) {
+    const etagOpts = typeof etagOption === "object" ? etagOption : {};
+    configMiddlewares.push(etag(etagOpts));
+  }
+  const outerMiddlewares = [...configMiddlewares];
+  if (globalMiddlewares && globalMiddlewares.length > 0) {
+    outerMiddlewares.push(...globalMiddlewares);
+  }
   const server = (() => {
     if (http2Option) {
       const h2Opts = typeof http2Option === "object" ? http2Option : {};
@@ -3544,29 +4375,43 @@ function createServer(options) {
       dist,
       req,
       res,
-      configMiddlewares,
+      outerMiddlewares,
       onError,
       config,
-      globalMiddlewares,
       globalInjectors,
-      bodyLimit
+      bodyLimit,
+      trustedProxy,
+      registries
     ).catch(() => {
       res.statusCode = 500;
       res.end();
     });
   });
-  if (routesRef.wsCurrent.length > 0) {
-    attachWebSocket({ server, routesRef, rootDir, config, globalMiddlewares });
-  }
+  attachWebSocket({
+    server,
+    routesRef,
+    rootDir,
+    config,
+    globalMiddlewares,
+    trustedProxy,
+    registries
+  });
   return { server, routesRef };
 }
-function prepareRequest(req, config, bodyLimit) {
-  const request = toWebRequest(req, bodyLimit);
+function prepareRequest(req, config, bodyLimit, trustedProxy, registries) {
+  const { request, url } = toWebRequest(req, bodyLimit);
   const method = request.method.toUpperCase();
-  const urlPath = new URL(request.url).pathname;
-  const ctx = createContext(request, {}, config, getClientIp(req));
+  const urlPath = url.pathname;
+  const ctx = createContextFromUrl(
+    request,
+    url,
+    {},
+    config,
+    getClientIp(req, trustedProxy),
+    registries
+  );
   const meta = ctx.meta;
-  return { request, ctx, meta, method, urlPath };
+  return { request, url, ctx, meta, method, urlPath };
 }
 function resolveRouteOrThrow(routes, method, urlPath) {
   const match = matchRoute(routes, method, urlPath);
@@ -3577,17 +4422,28 @@ function resolveRouteOrThrow(routes, method, urlPath) {
   }
   throw new RouteNotFoundError(urlPath);
 }
+var routePathCache = /* @__PURE__ */ new WeakMap();
+function getRoutePaths(route, rootDir, dist) {
+  let cached = routePathCache.get(route);
+  if (!cached) {
+    cached = {
+      absFilePath: path13.resolve(rootDir, route.filePath),
+      schemaPath: getRuntimeSchemaPath(route.filePath, dist, rootDir)
+    };
+    routePathCache.set(route, cached);
+  }
+  return cached;
+}
 function createRoutePipeline(opts) {
-  const { routes, method, urlPath, ctx, request, rootDir, dist, globalInjectors } = opts;
+  const { routes, method, urlPath, url, ctx, request, rootDir, dist, globalInjectors } = opts;
   return async () => {
     const match = resolveRouteOrThrow(routes, method, urlPath);
     ctx.params = match.params;
     const { route } = match;
-    const absoluteFilePath = path10.resolve(rootDir, route.filePath);
-    const routeModule = await loadRouteModule(absoluteFilePath, route.method, rootDir);
-    const input = await resolveInput(route.method, request);
+    const { absFilePath, schemaPath } = getRoutePaths(route, rootDir, dist);
+    const routeModule = await loadRouteModule(absFilePath, route.method, rootDir);
+    const input = await resolveInputFromUrl(route.method, request, url);
     const inputType = getInputTypeForMethod(route.method);
-    const schemaPath = getRuntimeSchemaPath(route.filePath, dist, rootDir);
     if (isDevOnDemandEnabled()) {
       const devDist = getDevDist();
       if (devDist) {
@@ -3598,8 +4454,9 @@ function createRoutePipeline(opts) {
     if (!result.valid) {
       throw new ValidationError("\u53C2\u6570\u6821\u9A8C\u5931\u8D25", result.issues);
     }
-    const body = hasBody(route.method) ? result.data : void 0;
+    const body = inputType === "query" && hasBody(route.method) ? await resolveBodyForQueryMethod(request) : hasBody(route.method) ? result.data : void 0;
     if (route.middlewares === void 0 && route.injectors === void 0 && route.middlewarePaths) {
+      await ensureMiddlewaresCompiled(route.middlewarePaths, rootDir);
       const bundle = await loadMergedMiddlewares(route.middlewarePaths);
       if (bundle) {
         route.middlewares = bundle.middlewares;
@@ -3617,36 +4474,37 @@ async function sendSuccessResponse(response, res) {
   await sendNodeResponse(response, res);
 }
 async function sendErrorResponse(err, meta, res, onError, ctx) {
-  await sendNodeResponse(mergeMeta(buildErrorResponse(err, ctx.config), meta), res);
-  if (onError) {
+  await sendNodeResponse(mergeMeta(buildErrorResponse(err, ctx?.config), meta), res);
+  if (onError && ctx) {
     try {
       await onError(err, ctx);
     } catch {
     }
   }
 }
-async function handleRequest(routes, rootDir, dist, req, res, configMiddlewares, onError, config, globalMiddlewares, globalInjectors, bodyLimit) {
-  const { request, ctx, meta, method, urlPath } = prepareRequest(req, config, bodyLimit);
-  const routePipeline = createRoutePipeline({
-    routes,
-    method,
-    urlPath,
-    ctx,
-    request,
-    rootDir,
-    dist,
-    globalMiddlewares,
-    globalInjectors
-  });
-  const outerMiddlewares = [];
-  if (configMiddlewares.length > 0) outerMiddlewares.push(...configMiddlewares);
-  if (globalMiddlewares && globalMiddlewares.length > 0) {
-    outerMiddlewares.push(...globalMiddlewares);
-  }
+async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares, onError, config, globalInjectors, bodyLimit, trustedProxy, registries) {
+  let meta = { headers: {}, setCookies: [] };
+  let ctx;
   try {
+    const prepared = prepareRequest(req, config, bodyLimit, trustedProxy, registries);
+    ctx = prepared.ctx;
+    meta = prepared.meta;
+    const { request, url, method, urlPath } = prepared;
+    const routePipeline = createRoutePipeline({
+      routes,
+      method,
+      urlPath,
+      url,
+      ctx,
+      request,
+      rootDir,
+      dist,
+      globalInjectors
+    });
     const response = outerMiddlewares.length > 0 ? await compose(outerMiddlewares, ctx, routePipeline) : await routePipeline();
     await sendSuccessResponse(response, res);
   } catch (err) {
+    if (res.destroyed || res.writableEnded) return;
     await sendErrorResponse(err, meta, res, onError, ctx);
   }
 }
@@ -3670,7 +4528,7 @@ async function createTestServer(options) {
   } = options;
   const { routes, wsRoutes } = await scanRoutes(rootDir, patterns);
   const sorted = sortRoutes(routes);
-  const schemaDist = dist ? path11.isAbsolute(dist) ? dist : path11.resolve(rootDir, dist) : await fs10.mkdtemp(path11.join(os.tmpdir(), "faapi-test-schema-"));
+  const schemaDist = dist ? path14.isAbsolute(dist) ? dist : path14.resolve(rootDir, dist) : await fs11.mkdtemp(path14.join(os.tmpdir(), "faapi-test-schema-"));
   await generateSchemaFiles(sorted, rootDir, schemaDist);
   const { server } = createServer({
     routes: sorted,
@@ -3703,7 +4561,7 @@ async function createTestServer(options) {
       await new Promise((resolve) => {
         server.close(() => resolve());
       });
-      await fs10.rm(schemaDist, { recursive: true, force: true }).catch(() => {
+      await fs11.rm(schemaDist, { recursive: true, force: true }).catch(() => {
       });
       invalidateSchemaCache();
     }