vafast 0.4.2 → 0.4.4

package/README.md

@@ -274,8 +274,7 @@ export default { fetch: server.fetch };
 
 **Node.js 完整示例：**
 ```typescript
-import { Server, createHandler } from 'vafast';
-import { serve } from '@vafast/node-server';
+import { Server, createHandler, serve } from 'vafast';
 
 const server = new Server([
   { method: 'GET', path: '/', handler: createHandler(() => 'Hello Node!') }
@@ -570,21 +569,18 @@ const categories = registry.getCategories();  // ['auth', 'users']
 
 ## 🔧 运行时支持
 
-### Bun
-
 ```typescript
-export default { port: 3000, fetch: server.fetch };
+import { serve } from 'vafast';
+serve({ fetch: server.fetch, port: 3000 });
 ```
 
-### Node.js
+> 💡 `serve` 函数兼容 Bun 和 Node.js，代码无需修改即可跨运行时
 
+**Bun 原生写法（仅限 Bun）：**
 ```typescript
-import { serve } from '@vafast/node-server';
-serve({ fetch: server.fetch, port: 3000 });
+export default { port: 3000, fetch: server.fetch };
 ```
 
-> 💡 两种运行时使用相同的 API，代码可无缝迁移
-
 ## 📚 文档
 
 ### 入门

package/dist/base-server-CSkyjEaY.mjs

@@ -0,0 +1,113 @@
+import { t as __esmMin } from "./chunk-DW4-Jl94.mjs";
+
+//#region src/server/base-server.ts
+var BaseServer;
+var init_base_server = __esmMin((() => {
+	BaseServer = class {
+		globalMiddleware = [];
+		use(mw) {
+			this.globalMiddleware.push(mw);
+		}
+		/**
+		* 打印扁平化后的路由信息，用于调试
+		*/
+		logFlattenedRoutes(routes, type = "路由") {
+			console.log(`🚀 扁平化后的${type}:`);
+			for (const route of routes) {
+				const method = route.method || "GET";
+				const path = route.fullPath || route.path;
+				console.log(`  ${method} ${path}`);
+				if (route.middlewareChain && route.middlewareChain.length > 0) console.log(`    中间件链: ${route.middlewareChain.length} 个`);
+			}
+			console.log("");
+		}
+		/**
+		* 检测路由冲突
+		* 检查是否有路径相同但方法不同的路由，以及潜在的路径冲突
+		*/
+		detectRouteConflicts(routes) {
+			const pathGroups = /* @__PURE__ */ new Map();
+			for (const route of routes) {
+				const path = route.fullPath || route.path;
+				const method = route.method || "GET";
+				if (!pathGroups.has(path)) pathGroups.set(path, []);
+				pathGroups.get(path).push({
+					...route,
+					method
+				});
+			}
+			for (const [path, routeList] of pathGroups) if (routeList.length > 1) {
+				const methods = routeList.map((r) => r.method);
+				const uniqueMethods = [...new Set(methods)];
+				if (uniqueMethods.length === 1) {
+					console.warn(`⚠️  路由冲突: ${uniqueMethods[0]} ${path} 定义了 ${routeList.length} 次`);
+					routeList.forEach((route, index) => {
+						console.warn(`   ${index + 1}. ${route.method} ${path}`);
+					});
+				} else console.log(`ℹ️  路径 ${path} 支持方法: ${uniqueMethods.join(", ")}`);
+			}
+			this.detectDynamicRouteConflicts(routes);
+		}
+		/**
+		* 检测动态路由的潜在冲突
+		*/
+		detectDynamicRouteConflicts(routes) {
+			const dynamicRoutes = routes.filter((r) => {
+				const path = r.fullPath || r.path;
+				return path.includes(":") || path.includes("*");
+			});
+			for (let i = 0; i < dynamicRoutes.length; i++) for (let j = i + 1; j < dynamicRoutes.length; j++) {
+				const route1 = dynamicRoutes[i];
+				const route2 = dynamicRoutes[j];
+				const method1 = route1.method || "GET";
+				if (method1 === (route2.method || "GET")) {
+					const path1 = route1.fullPath || route1.path;
+					const path2 = route2.fullPath || route2.path;
+					if (this.pathsMayConflict(path1, path2)) console.warn(`⚠️  潜在路由冲突: ${method1} ${path1} 可能与 ${path2} 冲突`);
+				}
+			}
+		}
+		/**
+		* 判断两个路径是否可能冲突
+		*/
+		pathsMayConflict(path1, path2) {
+			const parts1 = path1.split("/").filter(Boolean);
+			const parts2 = path2.split("/").filter(Boolean);
+			if (parts1.length !== parts2.length) return false;
+			for (let i = 0; i < parts1.length; i++) {
+				const p1 = parts1[i];
+				const p2 = parts2[i];
+				if (!p1.startsWith(":") && !p1.startsWith("*") && !p2.startsWith(":") && !p2.startsWith("*") && p1 !== p2) return false;
+				if (p1 === "*" && p2.startsWith(":") || p2 === "*" && p1.startsWith(":")) return true;
+			}
+			return false;
+		}
+		/**
+		* 路径匹配
+		*/
+		matchPath(pattern, path) {
+			const patternParts = pattern.split("/").filter(Boolean);
+			const pathParts = path.split("/").filter(Boolean);
+			if (patternParts.length !== pathParts.length) return false;
+			for (let i = 0; i < patternParts.length; i++) if (patternParts[i] !== pathParts[i] && !patternParts[i].startsWith(":")) return false;
+			return true;
+		}
+		/**
+		* 提取路径参数
+		*/
+		extractParams(pattern, path) {
+			const params = {};
+			const patternParts = pattern.split("/").filter(Boolean);
+			const pathParts = path.split("/").filter(Boolean);
+			for (let i = 0; i < patternParts.length; i++) if (patternParts[i].startsWith(":")) {
+				const paramName = patternParts[i].slice(1);
+				params[paramName] = pathParts[i];
+			}
+			return params;
+		}
+	};
+}));
+
+//#endregion
+export { init_base_server as n, BaseServer as t };
+//# sourceMappingURL=base-server-CSkyjEaY.mjs.map

package/dist/base-server-CSkyjEaY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-server-CSkyjEaY.mjs","names":[],"sources":["../src/server/base-server.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\n\n/**\n * 服务器基类\n * 包含所有服务器类型的公共逻辑\n */\nexport abstract class BaseServer {\n  protected globalMiddleware: Middleware[] = [];\n\n  use(mw: Middleware) {\n    this.globalMiddleware.push(mw);\n  }\n\n  /**\n   * 打印扁平化后的路由信息，用于调试\n   */\n  protected logFlattenedRoutes(routes: any[], type: string = \"路由\"): void {\n    console.log(`🚀 扁平化后的${type}:`);\n    for (const route of routes) {\n      const method = route.method || \"GET\";\n      const path = route.fullPath || route.path;\n      console.log(`  ${method} ${path}`);\n      if (route.middlewareChain && route.middlewareChain.length > 0) {\n        console.log(`    中间件链: ${route.middlewareChain.length} 个`);\n      }\n    }\n    console.log(\"\");\n  }\n\n  /**\n   * 检测路由冲突\n   * 检查是否有路径相同但方法不同的路由，以及潜在的路径冲突\n   */\n  protected detectRouteConflicts(routes: any[]): void {\n    const pathGroups = new Map<string, any[]>();\n\n    // 按路径分组\n    for (const route of routes) {\n      const path = route.fullPath || route.path;\n      const method = route.method || \"GET\";\n      if (!pathGroups.has(path)) {\n        pathGroups.set(path, []);\n      }\n      pathGroups.get(path)!.push({ ...route, method });\n    }\n\n    // 检查冲突\n    for (const [path, routeList] of pathGroups) {\n      if (routeList.length > 1) {\n        const methods = routeList.map((r) => r.method);\n        const uniqueMethods = [...new Set(methods)];\n\n        if (uniqueMethods.length === 1) {\n          // 相同路径、相同方法 - 这是冲突！\n          console.warn(\n            `⚠️  路由冲突: ${uniqueMethods[0]} ${path} 定义了 ${routeList.length} 次`,\n          );\n          routeList.forEach((route, index) => {\n            console.warn(`   ${index + 1}. ${route.method} ${path}`);\n          });\n        } else {\n          // 相同路径、不同方法 - 这是正常的\n          console.log(`ℹ️  路径 ${path} 支持方法: ${uniqueMethods.join(\", \")}`);\n        }\n      }\n    }\n\n    // 检查潜在的路径冲突（动态路由可能冲突）\n    this.detectDynamicRouteConflicts(routes);\n  }\n\n  /**\n   * 检测动态路由的潜在冲突\n   */\n  private detectDynamicRouteConflicts(routes: any[]): void {\n    const dynamicRoutes = routes.filter((r) => {\n      const path = r.fullPath || r.path;\n      return path.includes(\":\") || path.includes(\"*\");\n    });\n\n    for (let i = 0; i < dynamicRoutes.length; i++) {\n      for (let j = i + 1; j < dynamicRoutes.length; j++) {\n        const route1 = dynamicRoutes[i];\n        const route2 = dynamicRoutes[j];\n        const method1 = route1.method || \"GET\";\n        const method2 = route2.method || \"GET\";\n\n        if (method1 === method2) {\n          const path1 = route1.fullPath || route1.path;\n          const path2 = route2.fullPath || route2.path;\n          // 检查路径是否可能冲突\n          if (this.pathsMayConflict(path1, path2)) {\n            console.warn(\n              `⚠️  潜在路由冲突: ${method1} ${path1} 可能与 ${path2} 冲突`,\n            );\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * 判断两个路径是否可能冲突\n   */\n  private pathsMayConflict(path1: string, path2: string): boolean {\n    const parts1 = path1.split(\"/\").filter(Boolean);\n    const parts2 = path2.split(\"/\").filter(Boolean);\n\n    if (parts1.length !== parts2.length) return false;\n\n    for (let i = 0; i < parts1.length; i++) {\n      const p1 = parts1[i];\n      const p2 = parts2[i];\n\n      // 如果两个部分都是静态的且不同，则不会冲突\n      if (\n        !p1.startsWith(\":\") &&\n        !p1.startsWith(\"*\") &&\n        !p2.startsWith(\":\") &&\n        !p2.startsWith(\"*\") &&\n        p1 !== p2\n      ) {\n        return false;\n      }\n\n      // 如果一个是通配符，另一个是动态参数，可能冲突\n      if (\n        (p1 === \"*\" && p2.startsWith(\":\")) ||\n        (p2 === \"*\" && p1.startsWith(\":\"))\n      ) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * 路径匹配\n   */\n  protected matchPath(pattern: string, path: string): boolean {\n    const patternParts = pattern.split(\"/\").filter(Boolean);\n    const pathParts = path.split(\"/\").filter(Boolean);\n\n    if (patternParts.length !== pathParts.length) {\n      return false;\n    }\n\n    for (let i = 0; i < patternParts.length; i++) {\n      if (\n        patternParts[i] !== pathParts[i] &&\n        !patternParts[i].startsWith(\":\")\n      ) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * 提取路径参数\n   */\n  protected extractParams(\n    pattern: string,\n    path: string,\n  ): Record<string, string> {\n    const params: Record<string, string> = {};\n    const patternParts = pattern.split(\"/\").filter(Boolean);\n    const pathParts = path.split(\"/\").filter(Boolean);\n\n    for (let i = 0; i < patternParts.length; i++) {\n      if (patternParts[i].startsWith(\":\")) {\n        const paramName = patternParts[i].slice(1);\n        params[paramName] = pathParts[i];\n      }\n    }\n\n    return params;\n  }\n}\n"],"mappings":"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"}

package/dist/base-server-DvGS6ATg.d.mts

@@ -0,0 +1,40 @@
+import { o as Middleware } from "./types-DuTa8AVN.mjs";
+
+//#region src/server/base-server.d.ts
+
+/**
+ * 服务器基类
+ * 包含所有服务器类型的公共逻辑
+ */
+declare abstract class BaseServer {
+  protected globalMiddleware: Middleware[];
+  use(mw: Middleware): void;
+  /**
+   * 打印扁平化后的路由信息，用于调试
+   */
+  protected logFlattenedRoutes(routes: any[], type?: string): void;
+  /**
+   * 检测路由冲突
+   * 检查是否有路径相同但方法不同的路由，以及潜在的路径冲突
+   */
+  protected detectRouteConflicts(routes: any[]): void;
+  /**
+   * 检测动态路由的潜在冲突
+   */
+  private detectDynamicRouteConflicts;
+  /**
+   * 判断两个路径是否可能冲突
+   */
+  private pathsMayConflict;
+  /**
+   * 路径匹配
+   */
+  protected matchPath(pattern: string, path: string): boolean;
+  /**
+   * 提取路径参数
+   */
+  protected extractParams(pattern: string, path: string): Record<string, string>;
+}
+//#endregion
+export { BaseServer as t };
+//# sourceMappingURL=base-server-DvGS6ATg.d.mts.map

package/dist/base64url-0N9uQPjZ.d.mts

@@ -0,0 +1,6 @@
+//#region src/utils/base64url.d.ts
+declare function base64urlEncode(str: string): string;
+declare function base64urlDecode(str: string): string;
+//#endregion
+export { base64urlEncode as n, base64urlDecode as t };
+//# sourceMappingURL=base64url-0N9uQPjZ.d.mts.map

package/dist/base64url-CwQnvZyp.mjs

@@ -0,0 +1,13 @@
+//#region src/utils/base64url.ts
+function base64urlEncode(str) {
+	return btoa(str).replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
+}
+function base64urlDecode(str) {
+	const pad = str.length % 4 === 0 ? "" : "=".repeat(4 - str.length % 4);
+	const base64 = str.replace(/-/g, "+").replace(/_/g, "/") + pad;
+	return atob(base64);
+}
+
+//#endregion
+export { base64urlEncode as n, base64urlDecode as t };
+//# sourceMappingURL=base64url-CwQnvZyp.mjs.map

package/dist/base64url-CwQnvZyp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64url-CwQnvZyp.mjs","names":[],"sources":["../src/utils/base64url.ts"],"sourcesContent":["export function base64urlEncode(str: string): string {\n  return btoa(str)\n    .replace(/=/g, \"\") // ✅ 删除填充\n    .replace(/\\+/g, \"-\")\n    .replace(/\\//g, \"_\");\n}\n\nexport function base64urlDecode(str: string): string {\n  const pad = str.length % 4 === 0 ? \"\" : \"=\".repeat(4 - (str.length % 4));\n  const base64 = str.replace(/-/g, \"+\").replace(/_/g, \"/\") + pad;\n  return atob(base64);\n}\n"],"mappings":";AAAA,SAAgB,gBAAgB,KAAqB;AACnD,QAAO,KAAK,IAAI,CACb,QAAQ,MAAM,GAAG,CACjB,QAAQ,OAAO,IAAI,CACnB,QAAQ,OAAO,IAAI;;AAGxB,SAAgB,gBAAgB,KAAqB;CACnD,MAAM,MAAM,IAAI,SAAS,MAAM,IAAI,KAAK,IAAI,OAAO,IAAK,IAAI,SAAS,EAAG;CACxE,MAAM,SAAS,IAAI,QAAQ,MAAM,IAAI,CAAC,QAAQ,MAAM,IAAI,GAAG;AAC3D,QAAO,KAAK,OAAO"}

package/dist/chunk-DW4-Jl94.mjs

@@ -0,0 +1,37 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+//#endregion
+export { __exportAll as n, __toCommonJS as r, __esmMin as t };

package/dist/component-route-CYxLOnci.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/component-route-CZawYn61.d.mts

@@ -0,0 +1,31 @@
+import { a as Middleware } from "./route-BJ-40LNI.mjs";
+
+//#region src/types/component-route.d.ts
+
+/**
+ * 组件路由配置
+ * 支持声明式的组件关联
+ */
+interface ComponentRoute {
+  path: string;
+  component: () => Promise<any>;
+  middleware?: Middleware[];
+}
+/**
+ * 嵌套组件路由配置
+ */
+interface NestedComponentRoute {
+  path: string;
+  middleware?: Middleware[];
+  children?: (ComponentRoute | NestedComponentRoute)[];
+}
+/**
+ * 扁平化后的组件路由
+ */
+interface FlattenedComponentRoute extends ComponentRoute {
+  fullPath: string;
+  middlewareChain: Middleware[];
+}
+//#endregion
+export { FlattenedComponentRoute as n, NestedComponentRoute as r, ComponentRoute as t };
+//# sourceMappingURL=component-route-CZawYn61.d.mts.map

package/dist/component-router-CErbGh2A.mjs

@@ -0,0 +1,33 @@
+import { t as __esmMin } from "./chunk-DW4-Jl94.mjs";
+
+//#region src/middleware/component-router.ts
+/**
+* 扁平化嵌套组件路由
+*/
+function flattenComponentRoutes(routes) {
+	const flattened = [];
+	function processRoute(route, parentPath = "", parentMiddleware = []) {
+		const currentPath = parentPath + route.path;
+		const currentMiddleware = [...parentMiddleware, ...route.middleware || []];
+		if ("component" in route) flattened.push({
+			...route,
+			fullPath: currentPath,
+			middlewareChain: currentMiddleware
+		});
+		else if ("children" in route && route.children) for (const child of route.children) processRoute(child, currentPath, currentMiddleware);
+	}
+	for (const route of routes) processRoute(route);
+	return flattened;
+}
+var componentRouter;
+var init_component_router = __esmMin((() => {
+	componentRouter = () => {
+		return async (req, next) => {
+			return next();
+		};
+	};
+}));
+
+//#endregion
+export { flattenComponentRoutes as n, init_component_router as r, componentRouter as t };
+//# sourceMappingURL=component-router-CErbGh2A.mjs.map

package/dist/component-router-CErbGh2A.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-router-CErbGh2A.mjs","names":[],"sources":["../src/middleware/component-router.ts"],"sourcesContent":["import type {\n  ComponentRoute,\n  NestedComponentRoute,\n  FlattenedComponentRoute,\n} from \"../types/component-route\";\nimport { vueRenderer, reactRenderer } from \"./component-renderer\";\n\n/**\n * 扁平化嵌套组件路由\n */\nexport function flattenComponentRoutes(\n  routes: (ComponentRoute | NestedComponentRoute)[],\n): FlattenedComponentRoute[] {\n  const flattened: FlattenedComponentRoute[] = [];\n\n  function processRoute(\n    route: ComponentRoute | NestedComponentRoute,\n    parentPath: string = \"\",\n    parentMiddleware: any[] = [],\n  ) {\n    const currentPath = parentPath + route.path;\n    const currentMiddleware = [\n      ...parentMiddleware,\n      ...(route.middleware || []),\n    ];\n\n    if (\"component\" in route) {\n      // 这是一个组件路由\n      flattened.push({\n        ...route,\n        fullPath: currentPath,\n        middlewareChain: currentMiddleware,\n      });\n    } else if (\"children\" in route && route.children) {\n      // 这是一个嵌套路由\n      for (const child of route.children) {\n        processRoute(child, currentPath, currentMiddleware);\n      }\n    }\n  }\n\n  for (const route of routes) {\n    processRoute(route);\n  }\n\n  return flattened;\n}\n\n/**\n * 组件路由处理器中间件\n * 自动检测组件类型并应用相应的渲染器\n */\nexport const componentRouter = () => {\n  return async (req: Request, next: () => Promise<Response>) => {\n    // 这里可以添加组件路由的自动处理逻辑\n    // 比如自动检测组件类型，应用相应的渲染器\n    return next();\n  };\n};\n"],"mappings":";;;;;;AAUA,SAAgB,uBACd,QAC2B;CAC3B,MAAM,YAAuC,EAAE;CAE/C,SAAS,aACP,OACA,aAAqB,IACrB,mBAA0B,EAAE,EAC5B;EACA,MAAM,cAAc,aAAa,MAAM;EACvC,MAAM,oBAAoB,CACxB,GAAG,kBACH,GAAI,MAAM,cAAc,EAAE,CAC3B;AAED,MAAI,eAAe,MAEjB,WAAU,KAAK;GACb,GAAG;GACH,UAAU;GACV,iBAAiB;GAClB,CAAC;WACO,cAAc,SAAS,MAAM,SAEtC,MAAK,MAAM,SAAS,MAAM,SACxB,cAAa,OAAO,aAAa,kBAAkB;;AAKzD,MAAK,MAAM,SAAS,OAClB,cAAa,MAAM;AAGrB,QAAO;;;;CAOI,wBAAwB;AACnC,SAAO,OAAO,KAAc,SAAkC;AAG5D,UAAO,MAAM"}

package/dist/component-server-CGzU4bss.d.mts

@@ -0,0 +1,38 @@
+import { r as NestedComponentRoute, t as ComponentRoute } from "./component-route-CZawYn61.mjs";
+import { t as BaseServer } from "./base-server-DvGS6ATg.mjs";
+import { t as DependencyManager } from "./dependency-manager-C6vFWP2L.mjs";
+
+//#region src/server/component-server.d.ts
+
+/**
+ * 组件路由服务器
+ * 专门处理声明式组件路由
+ */
+declare class ComponentServer extends BaseServer {
+  private routes;
+  private dependencyManager;
+  constructor(routes: (ComponentRoute | NestedComponentRoute)[]);
+  /**
+   * 处理请求
+   */
+  fetch(req: Request): Promise<Response>;
+  /**
+   * 执行中间件链
+   */
+  private executeMiddlewareChain;
+  /**
+   * 渲染 Vue 组件
+   */
+  private renderVueComponent;
+  /**
+   * 渲染 React 组件
+   */
+  private renderReactComponent;
+  /**
+   * 获取依赖管理器（用于外部访问）
+   */
+  getDependencyManager(): DependencyManager;
+}
+//#endregion
+export { ComponentServer as t };
+//# sourceMappingURL=component-server-CGzU4bss.d.mts.map

package/dist/component-server-DAbIyIPI.mjs

@@ -0,0 +1,124 @@
+import { t as __esmMin } from "./chunk-DW4-Jl94.mjs";
+import { n as init_base_server, t as BaseServer } from "./base-server-CSkyjEaY.mjs";
+import { n as flattenComponentRoutes, r as init_component_router } from "./component-router-CErbGh2A.mjs";
+import { n as init_path_matcher, t as PathMatcher } from "./path-matcher-73cJd5Y7.mjs";
+import { n as init_html_renderer, t as HtmlRenderer } from "./html-renderer-CczE8mwC.mjs";
+import { n as init_dependency_manager, t as DependencyManager } from "./dependency-manager-Czg7Po2j.mjs";
+
+//#region src/server/component-server.ts
+var ComponentServer;
+var init_component_server = __esmMin((() => {
+	init_component_router();
+	init_base_server();
+	init_path_matcher();
+	init_html_renderer();
+	init_dependency_manager();
+	ComponentServer = class extends BaseServer {
+		routes;
+		dependencyManager;
+		constructor(routes) {
+			super();
+			this.routes = flattenComponentRoutes(routes);
+			this.dependencyManager = new DependencyManager();
+			this.detectRouteConflicts(this.routes);
+			this.logFlattenedRoutes(this.routes, "组件路由");
+			console.log("🚀 依赖按需加载，服务器启动完成");
+		}
+		/**
+		* 处理请求
+		*/
+		async fetch(req) {
+			const url = new URL(req.url);
+			const pathname = url.pathname;
+			if (req.method !== "GET") return new Response("Method Not Allowed", { status: 405 });
+			let matchedRoute = null;
+			for (const route of this.routes) if (PathMatcher.matchPath(route.fullPath, pathname)) {
+				matchedRoute = route;
+				break;
+			}
+			if (!matchedRoute) return new Response("Not Found", { status: 404 });
+			try {
+				const context = {
+					req,
+					params: PathMatcher.extractParams(matchedRoute.fullPath, pathname),
+					query: Object.fromEntries(url.searchParams),
+					pathname
+				};
+				return await this.executeMiddlewareChain(matchedRoute.middlewareChain, context, matchedRoute.component);
+			} catch (error) {
+				console.error("组件渲染失败:", error);
+				return new Response("Internal Server Error", { status: 500 });
+			}
+		}
+		/**
+		* 执行中间件链
+		*/
+		async executeMiddlewareChain(middlewareChain, context, componentImport) {
+			const renderComponent = async () => {
+				const componentModule = await componentImport();
+				const component = componentModule.default || componentModule;
+				const componentType = this.dependencyManager.detectComponentType(component);
+				const deps = await this.dependencyManager.getFrameworkDeps(componentType);
+				if (componentType === "vue") return await this.renderVueComponent(component, context, deps);
+				else if (componentType === "react") return await this.renderReactComponent(component, context, deps);
+				else throw new Error(`不支持的组件类型: ${componentType}`);
+			};
+			let index = 0;
+			const next = async () => {
+				if (index >= middlewareChain.length) return await renderComponent();
+				const middleware = middlewareChain[index++];
+				return await middleware(context.req, next);
+			};
+			return await next();
+		}
+		/**
+		* 渲染 Vue 组件
+		*/
+		async renderVueComponent(component, context, deps) {
+			try {
+				const [vue, renderer] = deps;
+				const app = vue.createSSRApp(component);
+				app.provide("routeInfo", {
+					params: context.params || {},
+					query: context.query || {},
+					pathname: context.pathname
+				});
+				const html = await renderer.renderToString(app);
+				const fullHtml = HtmlRenderer.generateVueHtml(html, context);
+				return new Response(fullHtml, { headers: { "Content-Type": "text/html; charset=utf-8" } });
+			} catch (error) {
+				console.error("Vue 组件渲染失败:", error);
+				return new Response("Vue Component Render Error", { status: 500 });
+			}
+		}
+		/**
+		* 渲染 React 组件
+		*/
+		async renderReactComponent(component, context, deps) {
+			try {
+				const [react, renderer] = deps;
+				const content = react.createElement(component, {
+					req: context.req,
+					params: context.params || {},
+					query: context.query || {}
+				});
+				const html = renderer.renderToString(content);
+				const fullHtml = HtmlRenderer.generateReactHtml(html, context);
+				return new Response(fullHtml, { headers: { "Content-Type": "text/html; charset=utf-8" } });
+			} catch (error) {
+				console.error("React 组件渲染失败:", error);
+				return new Response("React Component Render Error", { status: 500 });
+			}
+		}
+		/**
+		* 获取依赖管理器（用于外部访问）
+		*/
+		getDependencyManager() {
+			return this.dependencyManager;
+		}
+	};
+}));
+
+//#endregion
+export { init_component_server as n, ComponentServer as t };
+//# sourceMappingURL=component-server-DAbIyIPI.mjs.map

package/dist/component-server-DAbIyIPI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-server-DAbIyIPI.mjs","names":[],"sources":["../src/server/component-server.ts"],"sourcesContent":["import type {\n  ComponentRoute,\n  NestedComponentRoute,\n  FlattenedComponentRoute,\n} from \"../types/component-route\";\nimport { flattenComponentRoutes } from \"../middleware/component-router\";\nimport { BaseServer } from \"./base-server\";\nimport { PathMatcher } from \"../utils/path-matcher\";\nimport { HtmlRenderer } from \"../utils/html-renderer\";\nimport { DependencyManager } from \"../utils/dependency-manager\";\n\n/**\n * 组件路由服务器\n * 专门处理声明式组件路由\n */\nexport class ComponentServer extends BaseServer {\n  private routes: FlattenedComponentRoute[];\n  private dependencyManager: DependencyManager;\n\n  constructor(routes: (ComponentRoute | NestedComponentRoute)[]) {\n    super();\n    this.routes = flattenComponentRoutes(routes);\n    this.dependencyManager = new DependencyManager();\n\n    // 检测路由冲突\n    this.detectRouteConflicts(this.routes);\n    this.logFlattenedRoutes(this.routes, \"组件路由\");\n    console.log(\"🚀 依赖按需加载，服务器启动完成\");\n  }\n\n  /**\n   * 处理请求\n   */\n  async fetch(req: Request): Promise<Response> {\n    const url = new URL(req.url);\n    const pathname = url.pathname;\n    const method = req.method;\n\n    // 只支持 GET 请求\n    if (method !== \"GET\") {\n      return new Response(\"Method Not Allowed\", { status: 405 });\n    }\n\n    // 查找匹配的路由\n    let matchedRoute: FlattenedComponentRoute | null = null;\n    for (const route of this.routes) {\n      if (PathMatcher.matchPath(route.fullPath, pathname)) {\n        matchedRoute = route;\n        break;\n      }\n    }\n\n    if (!matchedRoute) {\n      return new Response(\"Not Found\", { status: 404 });\n    }\n\n    try {\n      // 创建中间件上下文\n      const context = {\n        req,\n        params: PathMatcher.extractParams(matchedRoute.fullPath, pathname),\n        query: Object.fromEntries(url.searchParams),\n        pathname,\n      };\n\n      // 执行中间件链，中间件会处理组件渲染\n      return await this.executeMiddlewareChain(\n        matchedRoute.middlewareChain,\n        context,\n        matchedRoute.component,\n      );\n    } catch (error) {\n      console.error(\"组件渲染失败:\", error);\n      return new Response(\"Internal Server Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 执行中间件链\n   */\n  private async executeMiddlewareChain(\n    middlewareChain: any[],\n    context: any,\n    componentImport: () => Promise<any>,\n  ): Promise<Response> {\n    // 创建最终的渲染函数\n    const renderComponent = async () => {\n      const componentModule = await componentImport();\n      const component = componentModule.default || componentModule;\n\n      // 自动检测组件类型\n      const componentType =\n        this.dependencyManager.detectComponentType(component);\n\n      // 按需加载依赖\n      const deps = await this.dependencyManager.getFrameworkDeps(componentType);\n\n      // 根据组件类型渲染\n      if (componentType === \"vue\") {\n        return await this.renderVueComponent(component, context, deps);\n      } else if (componentType === \"react\") {\n        return await this.renderReactComponent(component, context, deps);\n      } else {\n        throw new Error(`不支持的组件类型: ${componentType}`);\n      }\n    };\n\n    // 执行中间件链\n    let index = 0;\n    const next = async (): Promise<Response> => {\n      if (index >= middlewareChain.length) {\n        return await renderComponent();\n      }\n\n      const middleware = middlewareChain[index++];\n      return await middleware(context.req, next);\n    };\n\n    return await next();\n  }\n\n  /**\n   * 渲染 Vue 组件\n   */\n  private async renderVueComponent(\n    component: any,\n    context: any,\n    deps: any,\n  ): Promise<Response> {\n    try {\n      const [vue, renderer] = deps;\n      const app = vue.createSSRApp(component);\n\n      // 提供路由信息\n      app.provide(\"routeInfo\", {\n        params: context.params || {},\n        query: context.query || {},\n        pathname: context.pathname,\n      });\n\n      const html = await renderer.renderToString(app);\n      const fullHtml = HtmlRenderer.generateVueHtml(html, context);\n\n      return new Response(fullHtml, {\n        headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n      });\n    } catch (error) {\n      console.error(\"Vue 组件渲染失败:\", error);\n      return new Response(\"Vue Component Render Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 渲染 React 组件\n   */\n  private async renderReactComponent(\n    component: any,\n    context: any,\n    deps: any,\n  ): Promise<Response> {\n    try {\n      const [react, renderer] = deps;\n      const content = react.createElement(component, {\n        req: context.req,\n        params: context.params || {},\n        query: context.query || {},\n      });\n\n      const html = renderer.renderToString(content);\n      const fullHtml = HtmlRenderer.generateReactHtml(html, context);\n\n      return new Response(fullHtml, {\n        headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n      });\n    } catch (error) {\n      console.error(\"React 组件渲染失败:\", error);\n      return new Response(\"React Component Render Error\", { status: 500 });\n    }\n  }\n\n  /**\n   * 获取依赖管理器（用于外部访问）\n   */\n  getDependencyManager(): DependencyManager {\n    return this.dependencyManager;\n  }\n}\n"],"mappings":";;;;;;;;;;wBAKwE;mBAC7B;oBACS;qBACE;0BACU;CAMnD,kBAAb,cAAqC,WAAW;EAC9C,AAAQ;EACR,AAAQ;EAER,YAAY,QAAmD;AAC7D,UAAO;AACP,QAAK,SAAS,uBAAuB,OAAO;AAC5C,QAAK,oBAAoB,IAAI,mBAAmB;AAGhD,QAAK,qBAAqB,KAAK,OAAO;AACtC,QAAK,mBAAmB,KAAK,QAAQ,OAAO;AAC5C,WAAQ,IAAI,oBAAoB;;;;;EAMlC,MAAM,MAAM,KAAiC;GAC3C,MAAM,MAAM,IAAI,IAAI,IAAI,IAAI;GAC5B,MAAM,WAAW,IAAI;AAIrB,OAHe,IAAI,WAGJ,MACb,QAAO,IAAI,SAAS,sBAAsB,EAAE,QAAQ,KAAK,CAAC;GAI5D,IAAI,eAA+C;AACnD,QAAK,MAAM,SAAS,KAAK,OACvB,KAAI,YAAY,UAAU,MAAM,UAAU,SAAS,EAAE;AACnD,mBAAe;AACf;;AAIJ,OAAI,CAAC,aACH,QAAO,IAAI,SAAS,aAAa,EAAE,QAAQ,KAAK,CAAC;AAGnD,OAAI;IAEF,MAAM,UAAU;KACd;KACA,QAAQ,YAAY,cAAc,aAAa,UAAU,SAAS;KAClE,OAAO,OAAO,YAAY,IAAI,aAAa;KAC3C;KACD;AAGD,WAAO,MAAM,KAAK,uBAChB,aAAa,iBACb,SACA,aAAa,UACd;YACM,OAAO;AACd,YAAQ,MAAM,WAAW,MAAM;AAC/B,WAAO,IAAI,SAAS,yBAAyB,EAAE,QAAQ,KAAK,CAAC;;;;;;EAOjE,MAAc,uBACZ,iBACA,SACA,iBACmB;GAEnB,MAAM,kBAAkB,YAAY;IAClC,MAAM,kBAAkB,MAAM,iBAAiB;IAC/C,MAAM,YAAY,gBAAgB,WAAW;IAG7C,MAAM,gBACJ,KAAK,kBAAkB,oBAAoB,UAAU;IAGvD,MAAM,OAAO,MAAM,KAAK,kBAAkB,iBAAiB,cAAc;AAGzE,QAAI,kBAAkB,MACpB,QAAO,MAAM,KAAK,mBAAmB,WAAW,SAAS,KAAK;aACrD,kBAAkB,QAC3B,QAAO,MAAM,KAAK,qBAAqB,WAAW,SAAS,KAAK;QAEhE,OAAM,IAAI,MAAM,aAAa,gBAAgB;;GAKjD,IAAI,QAAQ;GACZ,MAAM,OAAO,YAA+B;AAC1C,QAAI,SAAS,gBAAgB,OAC3B,QAAO,MAAM,iBAAiB;IAGhC,MAAM,aAAa,gBAAgB;AACnC,WAAO,MAAM,WAAW,QAAQ,KAAK,KAAK;;AAG5C,UAAO,MAAM,MAAM;;;;;EAMrB,MAAc,mBACZ,WACA,SACA,MACmB;AACnB,OAAI;IACF,MAAM,CAAC,KAAK,YAAY;IACxB,MAAM,MAAM,IAAI,aAAa,UAAU;AAGvC,QAAI,QAAQ,aAAa;KACvB,QAAQ,QAAQ,UAAU,EAAE;KAC5B,OAAO,QAAQ,SAAS,EAAE;KAC1B,UAAU,QAAQ;KACnB,CAAC;IAEF,MAAM,OAAO,MAAM,SAAS,eAAe,IAAI;IAC/C,MAAM,WAAW,aAAa,gBAAgB,MAAM,QAAQ;AAE5D,WAAO,IAAI,SAAS,UAAU,EAC5B,SAAS,EAAE,gBAAgB,4BAA4B,EACxD,CAAC;YACK,OAAO;AACd,YAAQ,MAAM,eAAe,MAAM;AACnC,WAAO,IAAI,SAAS,8BAA8B,EAAE,QAAQ,KAAK,CAAC;;;;;;EAOtE,MAAc,qBACZ,WACA,SACA,MACmB;AACnB,OAAI;IACF,MAAM,CAAC,OAAO,YAAY;IAC1B,MAAM,UAAU,MAAM,cAAc,WAAW;KAC7C,KAAK,QAAQ;KACb,QAAQ,QAAQ,UAAU,EAAE;KAC5B,OAAO,QAAQ,SAAS,EAAE;KAC3B,CAAC;IAEF,MAAM,OAAO,SAAS,eAAe,QAAQ;IAC7C,MAAM,WAAW,aAAa,kBAAkB,MAAM,QAAQ;AAE9D,WAAO,IAAI,SAAS,UAAU,EAC5B,SAAS,EAAE,gBAAgB,4BAA4B,EACxD,CAAC;YACK,OAAO;AACd,YAAQ,MAAM,iBAAiB,MAAM;AACrC,WAAO,IAAI,SAAS,gCAAgC,EAAE,QAAQ,KAAK,CAAC;;;;;;EAOxE,uBAA0C;AACxC,UAAO,KAAK"}