@ubean/build 0.1.2 → 0.1.3

package/dist/virtual-modules-DXIaZdQI.js

@@ -0,0 +1,404 @@
+//#region src/virtual-registry.ts
+var VirtualModuleRegistry = class {
+	modules = /* @__PURE__ */ new Map();
+	invalidated = /* @__PURE__ */ new Set();
+	register(mod) {
+		this.modules.set(mod.id, mod);
+	}
+	resolveId(id, importer) {
+		if (this.modules.has(id)) return id;
+		for (const mod of this.modules.values()) {
+			const resolved = mod.resolve(id, importer);
+			if (resolved) return resolved;
+		}
+	}
+	async load(id) {
+		const mod = this.modules.get(id);
+		if (!mod) return void 0;
+		return mod.load();
+	}
+	invalidate(id) {
+		this.invalidated.add(id);
+	}
+	isInvalidated(id) {
+		return this.invalidated.has(id);
+	}
+	clearInvalidated() {
+		this.invalidated.clear();
+	}
+	getModules() {
+		return [...this.modules.values()];
+	}
+	clear() {
+		this.modules.clear();
+		this.invalidated.clear();
+	}
+};
+let _registry = null;
+function useVirtualRegistry() {
+	if (!_registry) _registry = new VirtualModuleRegistry();
+	return _registry;
+}
+function resetVirtualRegistry() {
+	_registry = null;
+}
+function defineVirtualModule(id, loader) {
+	return {
+		id,
+		resolve(resolvedId) {
+			return resolvedId === id ? id : void 0;
+		},
+		load: loader
+	};
+}
+function defineVirtualModulePrefix(prefix, loader) {
+	return {
+		id: prefix,
+		resolve(id) {
+			if (id.startsWith(prefix)) return id;
+		},
+		load(id) {
+			return loader(id || prefix);
+		}
+	};
+}
+//#endregion
+//#region src/macros.ts
+const MACRO_NAMES = ["definePage"];
+function findBalancedCall(code, funcName, startSearch = 0) {
+	const pattern = new RegExp(`\\b${funcName}\\s*\\(`, "g");
+	pattern.lastIndex = startSearch;
+	const match = pattern.exec(code);
+	if (!match) return null;
+	const startIdx = match.index;
+	const parenStart = match.index + match[0].length;
+	let depth = 1;
+	let i = parenStart;
+	let inString = null;
+	let escaped = false;
+	let inTemplateExpr = 0;
+	while (i < code.length && depth > 0) {
+		const ch = code[i];
+		if (escaped) {
+			escaped = false;
+			i++;
+			continue;
+		}
+		if (ch === "\\") {
+			escaped = true;
+			i++;
+			continue;
+		}
+		if (inString) {
+			if (inString === "`" && ch === "$" && code[i + 1] === "{") {
+				inTemplateExpr++;
+				i += 2;
+				continue;
+			}
+			if (inString === "`" && ch === "}" && inTemplateExpr > 0) {
+				inTemplateExpr--;
+				i++;
+				continue;
+			}
+			if (ch === inString) inString = null;
+			i++;
+			continue;
+		}
+		if (ch === "\"" || ch === "'" || ch === "`") {
+			inString = ch;
+			i++;
+			continue;
+		}
+		if (ch === "/" && code[i + 1] === "/") {
+			while (i < code.length && code[i] !== "\n") i++;
+			continue;
+		}
+		if (ch === "/" && code[i + 1] === "*") {
+			i += 2;
+			while (i < code.length && !(code[i] === "*" && code[i + 1] === "/")) i++;
+			i += 2;
+			continue;
+		}
+		if (ch === "(" || ch === "{" || ch === "[") depth++;
+		else if (ch === ")" || ch === "}" || ch === "]") {
+			depth--;
+			if (depth === 0 && ch === ")") return {
+				start: startIdx,
+				end: i + 1
+			};
+		}
+		i++;
+	}
+	return null;
+}
+function stripStatement(code, callStart, callEnd) {
+	let start = callStart;
+	let end = callEnd;
+	while (start > 0 && /[ \t]/.test(code[start - 1])) start--;
+	const exportDefaultMatch = code.slice(0, start).match(/export\s+default\s*$/);
+	if (exportDefaultMatch) {
+		start -= exportDefaultMatch[0].length;
+		while (start > 0 && /[ \t\n\r]/.test(code[start - 1])) start--;
+	}
+	if (code[end] === ";") end++;
+	while (end < code.length && /[ \t]/.test(code[end])) end++;
+	return code.slice(0, start) + code.slice(end);
+}
+function stripMacros(code, macros = MACRO_NAMES) {
+	let result = code;
+	for (const macro of macros) {
+		let offset = 0;
+		while (true) {
+			const found = findBalancedCall(result, macro, offset);
+			if (!found) break;
+			result = stripStatement(result, found.start, found.end);
+			offset = found.start;
+		}
+	}
+	return result;
+}
+function transformMacros(code, id) {
+	if (!(id.includes("/src/pages/") || id.includes("/src/routes/") || id.includes("/src/middleware/"))) return null;
+	if (id.endsWith(".vue")) return transformVueMacros(code);
+	if (/\.(ts|js|mjs|mts|tsx|jsx)$/.test(id)) return stripMacros(code);
+	return null;
+}
+function transformVueMacros(code) {
+	return code.replace(/<script([^>]*)>([\s\S]*?)<\/script>/g, (_match, attrs, content) => {
+		return `<script${attrs}>${stripMacros(content)}<\/script>`;
+	});
+}
+//#endregion
+//#region src/virtual-modules.ts
+function toVitePath(p) {
+	return p.replace(/\\/g, "/");
+}
+function createRoutingVirtualModule(routes, middlewares) {
+	return defineVirtualModule("ubean:routes", () => {
+		return `export const routes = [\n${routes.map((r) => `  { method: ${JSON.stringify(r.method)}, path: ${JSON.stringify(r.path)}, id: ${JSON.stringify(r.id)}, filePath: ${JSON.stringify(r.filePath)} }`).join(",\n")}\n];\nexport const middlewares = [\n${middlewares.map((m) => `  { path: ${JSON.stringify(m.path)}, filePath: ${JSON.stringify(m.filePath)}, order: ${m.order}, global: ${m.global} }`).join(",\n")}\n];\nexport default { routes, middlewares };`;
+	});
+}
+function createPagesVirtualModule(pages, layouts) {
+	return defineVirtualModule("ubean:pages", () => {
+		return `export const pages = {\n${pages.map((p) => `  ${JSON.stringify(p.name)}: { name: ${JSON.stringify(p.name)}, path: ${JSON.stringify(p.path)}, filePath: ${JSON.stringify(p.filePath)}, layout: ${JSON.stringify(p.layout)}, reuseTarget: ${JSON.stringify(p.reuseTarget)} }`).join(",\n")}\n};\nexport const layouts = {\n${layouts.map((l) => `  ${JSON.stringify(l.name)}: { name: ${JSON.stringify(l.name)}, filePath: ${JSON.stringify(l.filePath)}, isDefault: ${l.isDefault} }`).join(",\n")}\n};\nexport type RouteName = ${pages.map((p) => JSON.stringify(p.name)).join(" | ") || "string"};\nexport type LayoutName = ${layouts.map((l) => JSON.stringify(l.name)).join(" | ") || "string"};\nexport default { pages, layouts };`;
+	});
+}
+function createMetaVirtualModule() {
+	return defineVirtualModule("ubean:meta", () => {
+		return `export const UBEAN_VERSION = "0.0.1";\nexport default { version: UBEAN_VERSION };`;
+	});
+}
+function createAppVirtualModule(apiRoutes, middlewares, pages, srcDir) {
+	return defineVirtualModule("ubean:app-config", () => {
+		const routesJson = apiRoutes.map((r) => JSON.stringify({
+			relativePath: r.relativePath,
+			route: r.route,
+			method: r.method,
+			env: r.env
+		}));
+		const middlewareJson = middlewares.map((m) => JSON.stringify({
+			relativePath: m.relativePath,
+			order: m.order,
+			global: m.global
+		}));
+		const pagesJson = pages.map((p) => JSON.stringify({
+			relativePath: p.relativePath,
+			name: p.name,
+			route: p.route,
+			isReuse: p.isReuse,
+			layout: p.layout
+		}));
+		const viteSrcDir = toVitePath(srcDir);
+		const prefix = viteSrcDir === "/" || viteSrcDir === "" ? "" : viteSrcDir;
+		return `
+const routeModules = import.meta.glob([${JSON.stringify(`${prefix}/routes/**/*.{ts,js,mjs}`)}], { eager: false });
+const middlewareModules = import.meta.glob([${JSON.stringify(`${prefix}/middleware/**/*.{ts,js,mjs}`)}], { eager: false });
+const pageModules = import.meta.glob([${JSON.stringify(`${prefix}/pages/**/*.{vue,ts,tsx,js,jsx}`)}], { eager: false });
+
+const _srcPrefix = ${JSON.stringify(prefix)};
+function normalizeKey(p) {
+  const prefixes = ['/routes/', '/middleware/', '/pages/'];
+  for (const pf of prefixes) {
+    const fullPf = _srcPrefix + pf;
+    if (p.includes(fullPf)) {
+      const idx = p.indexOf(fullPf);
+      return p.slice(idx + fullPf.length);
+    }
+  }
+  return p;
+}
+
+export const routeLoaders = {};
+for (const [key, loader] of Object.entries(routeModules)) {
+  routeLoaders[normalizeKey(key)] = loader;
+}
+
+export const middlewareLoaders = {};
+for (const [key, loader] of Object.entries(middlewareModules)) {
+  middlewareLoaders[normalizeKey(key)] = loader;
+}
+
+export const pageLoaders = {};
+for (const [key, loader] of Object.entries(pageModules)) {
+  pageLoaders[normalizeKey(key)] = loader;
+}
+
+export const apiRoutes = [${routesJson.join(",")}];
+export const middlewares = [${middlewareJson.join(",")}];
+export const pages = [${pagesJson.join(",")}];
+
+export default { routeLoaders, middlewareLoaders, pageLoaders, apiRoutes, middlewares, pages };
+`;
+	});
+}
+function createLocalesVirtualModule(_locales, defaultLocale, srcDir = "src") {
+	return defineVirtualModule("ubean:locales", () => {
+		const defaultCode = JSON.stringify(defaultLocale);
+		const viteSrcDir = toVitePath(srcDir);
+		const prefix = viteSrcDir === "/" || viteSrcDir === "" ? "" : viteSrcDir;
+		return `
+import { defineLocale, setLocale, mergeLocale } from 'ubean/runtime/i18n';
+
+const localeModules = import.meta.glob([${JSON.stringify(`${prefix}/locales/**/*.{json,json5,yaml,yml,js,mjs,cjs,ts,mts,cts}`)}], { eager: false });
+
+function parseLocalePath(path) {
+  const withoutPrefix = path.replace(${JSON.stringify(`${prefix || ""}/locales/`)}, '');
+  const lastDot = withoutPrefix.lastIndexOf('.');
+  const withoutExt = lastDot > 0 ? withoutPrefix.slice(0, lastDot) : withoutPrefix;
+  const parts = withoutExt.split('/');
+  const fileName = parts[parts.length - 1];
+  const orderMatch = fileName.match(/^(\\d+)\\.(.+)$/);
+  let code = orderMatch ? orderMatch[2] : fileName;
+  let isDefault = code === 'default' || fileName.startsWith('default.');
+  const dirParts = parts.slice(0, -1);
+
+  let namespace;
+  if (dirParts.length > 0) {
+    const fileNameCode = code === 'index' ? undefined : code;
+    code = fileNameCode || dirParts[dirParts.length - 1];
+    namespace = dirParts.join('.');
+    if (fileNameCode && fileNameCode !== code) {
+      namespace = dirParts.join('.') + '.' + fileNameCode;
+    }
+  }
+
+  if (isDefault && code === 'default') {
+    code = 'en';
+  }
+
+  return { code, namespace, isDefault };
+}
+
+function setNestedValue(obj, path, value) {
+  let current = obj;
+  for (let i = 0; i < path.length - 1; i++) {
+    const key = path[i];
+    if (!current[key]) current[key] = {};
+    current = current[key];
+  }
+  current[path[path.length - 1]] = value;
+}
+
+let loaded = false;
+
+export async function loadLocales() {
+  if (loaded) return;
+  loaded = true;
+
+  const localeData = new Map();
+
+  for (const [path, loader] of Object.entries(localeModules)) {
+    try {
+      const { code, namespace, isDefault } = parseLocalePath(path);
+      const mod = await loader();
+      const data = mod.default || mod;
+      const hasMeta = typeof data.name === 'string' || data.dir === 'ltr' || data.dir === 'rtl' || typeof data.isDefault === 'boolean';
+      const isWrapper = hasMeta && typeof data.messages === 'object' && data.messages !== null;
+      const messages = isWrapper ? data.messages : data;
+      const options = {
+        name: isWrapper ? data.name : undefined,
+        dir: isWrapper ? (data.dir || 'ltr') : 'ltr',
+        isDefault: isDefault || (isWrapper ? data.isDefault : false)
+      };
+
+      if (!localeData.has(code)) {
+        localeData.set(code, { messages: {}, options: { isDefault: options.isDefault || isDefault, name: options.name, dir: options.dir } });
+      }
+      const entry = localeData.get(code);
+      if (options.name) entry.options.name = options.name;
+      if (options.dir) entry.options.dir = options.dir;
+      if (options.isDefault) entry.options.isDefault = true;
+
+      if (namespace) {
+        setNestedValue(entry.messages, namespace.split('.'), messages);
+      } else {
+        Object.assign(entry.messages, messages);
+      }
+    } catch (e) {
+      console.warn('[ubean] Failed to load locale:', path, e);
+    }
+  }
+
+  for (const [code, { messages, options }] of localeData.entries()) {
+    defineLocale({
+      code,
+      messages,
+      name: options.name,
+      dir: options.dir,
+      isDefault: options.isDefault
+    });
+  }
+
+  const defaultCode = ${defaultCode};
+  if (defaultCode && localeData.has(defaultCode)) {
+    setLocale(defaultCode);
+  } else if (localeData.size > 0) {
+    const firstDefault = [...localeData.entries()].find(([, v]) => v.options.isDefault);
+    if (firstDefault) {
+      setLocale(firstDefault[0]);
+    } else {
+      setLocale([...localeData.keys()][0]);
+    }
+  }
+}
+
+export async function reloadLocale(path) {
+  if (!path.includes('/locales/')) return;
+  try {
+    const loader = localeModules[path];
+    if (loader) {
+      const { code, namespace } = parseLocalePath(path);
+      const mod = await loader();
+      const data = mod.default || mod;
+      const hasMeta = typeof data.name === 'string' || data.dir === 'ltr' || data.dir === 'rtl' || typeof data.isDefault === 'boolean';
+      const isWrapper = hasMeta && typeof data.messages === 'object' && data.messages !== null;
+      const messages = isWrapper ? data.messages : data;
+      const merged = {};
+      if (namespace) {
+        setNestedValue(merged, namespace.split('.'), messages);
+      } else {
+        Object.assign(merged, messages);
+      }
+      mergeLocale(code, merged);
+    }
+  } catch (e) {
+    console.warn('[ubean] Failed to reload locale:', path, e);
+  }
+}
+
+export default { loadLocales, reloadLocale };
+
+if (import.meta.hot) {
+  import.meta.hot.accept((mod) => {
+    if (mod) {
+      for (const path of Object.keys(localeModules)) {
+        mod.reloadLocale(path);
+      }
+    }
+  });
+}
+`;
+	});
+}
+//#endregion
+export { createRoutingVirtualModule as a, VirtualModuleRegistry as c, resetVirtualRegistry as d, useVirtualRegistry as f, createPagesVirtualModule as i, defineVirtualModule as l, createLocalesVirtualModule as n, stripMacros as o, createMetaVirtualModule as r, transformMacros as s, createAppVirtualModule as t, defineVirtualModulePrefix as u };

package/dist/vite.d.ts

@@ -0,0 +1,41 @@
+import { ResolvedConfig } from "@ubean/config";
+import { Plugin } from "vite";
+//#region src/vite.d.ts
+interface UbeanPluginOptions {
+  /**
+   * 已解析的 ubean 配置。如果未提供,插件会按以下顺序获取:
+   * 1. 尝试从全局缓存读取(`loadUbeanConfig` 已被 CLI 调用时会有缓存)
+   * 2. 在 `buildStart` 中异步调用 `loadUbeanConfig()` 加载
+   */
+  config?: ResolvedConfig;
+}
+/**
+ * ubean 核心 Vite 插件(框架无关部分)。
+ *
+ * 提供:
+ * - 虚拟模块(`ubean:routes`、`ubean:pages`、`ubean:meta`、`ubean:app-config`、`ubean:locales`)
+ * - 宏转换(`definePage` / `defineMeta` 在 `.ts` / `.vue` 中被剥离)
+ * - 文件监听(dev 模式下扫描 `routes` / `middleware` / `pages` / `layouts` / `plugins` / `locales`)
+ * - 实体路由文件生成(当 `routing.mode` 为 `'file'` 或 `'both'` 时触发 `@ubean/routing/generator`)
+ *
+ * Vue 专属的虚拟模块(`virtual:ubean-pages`、`virtual:ubean-app` 等)由 `@ubean/vite` 的
+ * `ubeanVuePlugin` 提供,二者共用 `useVirtualRegistry()` 注册表。
+ *
+ * @example 在 vite.config.ts 中使用(自动加载 ubean.config)
+ * ```typescript
+ * import { defineConfig } from 'vite';
+ * import { ubeanPlugin } from '@ubean/build/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [ubeanPlugin()]
+ * });
+ * ```
+ *
+ * @example 显式传入配置(ubean dev/build 内部使用)
+ * ```typescript
+ * ubeanPlugin({ config: resolvedConfig })
+ * ```
+ */
+declare function ubeanPlugin(options?: UbeanPluginOptions): Plugin;
+//#endregion
+export { UbeanPluginOptions, ubeanPlugin };

package/dist/vite.js

@@ -0,0 +1,209 @@
+import { a as createRoutingVirtualModule, f as useVirtualRegistry, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-DXIaZdQI.js";
+import { loadUbeanConfig, tryGetConfig } from "@ubean/config";
+import { createUbeanRouter, scanProject } from "@ubean/routing";
+import { join, relative, resolve } from "pathe";
+//#region src/vite.ts
+const VIRTUAL_MODULES = [
+	"ubean:routes",
+	"ubean:pages",
+	"ubean:meta",
+	"ubean:app-config",
+	"ubean:locales"
+];
+const VIRTUAL_PREFIX = "\0ubean:";
+/**
+* ubean 核心 Vite 插件(框架无关部分)。
+*
+* 提供:
+* - 虚拟模块(`ubean:routes`、`ubean:pages`、`ubean:meta`、`ubean:app-config`、`ubean:locales`)
+* - 宏转换(`definePage` / `defineMeta` 在 `.ts` / `.vue` 中被剥离)
+* - 文件监听(dev 模式下扫描 `routes` / `middleware` / `pages` / `layouts` / `plugins` / `locales`)
+* - 实体路由文件生成(当 `routing.mode` 为 `'file'` 或 `'both'` 时触发 `@ubean/routing/generator`)
+*
+* Vue 专属的虚拟模块(`virtual:ubean-pages`、`virtual:ubean-app` 等)由 `@ubean/vite` 的
+* `ubeanVuePlugin` 提供,二者共用 `useVirtualRegistry()` 注册表。
+*
+* @example 在 vite.config.ts 中使用(自动加载 ubean.config)
+* ```typescript
+* import { defineConfig } from 'vite';
+* import { ubeanPlugin } from '@ubean/build/vite';
+*
+* export default defineConfig({
+*   plugins: [ubeanPlugin()]
+* });
+* ```
+*
+* @example 显式传入配置(ubean dev/build 内部使用)
+* ```typescript
+* ubeanPlugin({ config: resolvedConfig })
+* ```
+*/
+function ubeanPlugin(options) {
+	const virtualRegistry = useVirtualRegistry();
+	let ubeanConfig = options?.config ?? tryGetConfig() ?? void 0;
+	let srcDirAbs = "";
+	let viteSrcDir = "";
+	let viteSrcPrefix = "";
+	function ensureDerived() {
+		if (!ubeanConfig) return;
+		srcDirAbs = resolve(ubeanConfig.rootDir, ubeanConfig.srcDir);
+		viteSrcDir = relative(ubeanConfig.rootDir, srcDirAbs).replace(/\\/g, "/");
+		viteSrcPrefix = viteSrcDir ? `/${viteSrcDir}` : "";
+	}
+	if (ubeanConfig) ensureDerived();
+	return {
+		name: "ubean:core",
+		enforce: "pre",
+		async buildStart() {
+			if (!ubeanConfig) {
+				ubeanConfig = await loadUbeanConfig();
+				ensureDerived();
+			}
+			await scanAndRegister();
+		},
+		resolveId(id) {
+			if (VIRTUAL_MODULES.includes(id)) return VIRTUAL_PREFIX + id;
+		},
+		async load(id) {
+			if (id.startsWith(VIRTUAL_PREFIX)) {
+				const moduleId = id.slice(7);
+				const mod = virtualRegistry.getModules().find((m) => m.id === moduleId);
+				if (mod) return await mod.load();
+			}
+		},
+		transform(code, id) {
+			const result = transformMacros(code, id);
+			if (result !== null && result !== code) return {
+				code: result,
+				map: null
+			};
+			return null;
+		},
+		configureServer(server) {
+			const watchDirs = [
+				"routes",
+				"middleware",
+				"pages",
+				"layouts",
+				"plugins",
+				"locales"
+			];
+			const config = ubeanConfig;
+			const srcDir = join(config.rootDir, config.srcDir);
+			for (const dir of watchDirs) server.watcher.add(join(srcDir, dir));
+			server.watcher.on("add", handleFileChange);
+			server.watcher.on("unlink", handleFileChange);
+			server.watcher.on("change", handleFileChange);
+			async function handleFileChange(file) {
+				const relativePath = file.replace(`${srcDir}/`, "");
+				if (watchDirs.some((d) => relativePath.startsWith(`${d}/`))) {
+					await scanAndRegister();
+					for (const mod of VIRTUAL_MODULES) {
+						const module = server.moduleGraph.getModuleById(VIRTUAL_PREFIX + mod);
+						if (module) server.moduleGraph.invalidateModule(module);
+					}
+					if (relativePath.startsWith("locales/")) server.ws.send({
+						type: "custom",
+						event: "ubean:locale-update",
+						data: { file }
+					});
+					else server.ws.send({ type: "full-reload" });
+				}
+			}
+		}
+	};
+	async function scanAndRegister() {
+		if (!ubeanConfig) return;
+		const result = await scanProject({
+			cwd: ubeanConfig.rootDir,
+			srcDir: ubeanConfig.srcDir,
+			dirs: ubeanConfig.dir,
+			ignore: ubeanConfig.scanOptions?.ignore
+		});
+		const router = createUbeanRouter();
+		for (const mw of result.middlewares) router.addMiddleware(mw);
+		for (const route of result.apiRoutes) router.addApiRoute(route);
+		for (const page of result.pages) router.addPage(page);
+		for (const layout of result.layouts) router.addLayout(layout);
+		virtualRegistry.register(createRoutingVirtualModule(result.apiRoutes.map((r) => ({
+			method: r.method?.toUpperCase() || "ALL",
+			path: r.route,
+			id: `${r.method}:${r.route}`,
+			filePath: r.fullPath
+		})), result.middlewares.map((m) => ({
+			path: "/**",
+			filePath: m.fullPath,
+			order: m.order,
+			global: m.global
+		}))));
+		virtualRegistry.register(createPagesVirtualModule(result.pages.map((p) => ({
+			name: p.name,
+			path: p.route,
+			filePath: p.fullPath,
+			layout: p.layout,
+			reuseTarget: p.reuseTarget
+		})), result.layouts.map((l) => ({
+			name: l.name,
+			filePath: l.fullPath,
+			isDefault: l.isDefault
+		}))));
+		virtualRegistry.register(createMetaVirtualModule());
+		virtualRegistry.register(createAppVirtualModule(result.apiRoutes, result.middlewares, result.pages, viteSrcPrefix || "/"));
+		virtualRegistry.register(createLocalesVirtualModule(result.locales, result.defaultLocale, viteSrcPrefix || "/"));
+		await maybeGenerateRouteFiles(ubeanConfig, result).catch((err) => {
+			console.warn("[ubean:core] Route file generation failed:", err?.message || err);
+		});
+	}
+}
+/**
+* 根据 `routing.mode` 决定是否触发实体文件生成。
+*
+* - `'virtual'`(默认):仅生成 `.ubean/typed-router.d.ts`(类型声明,所有模式都生成)
+* - `'file'`:额外生成 `routes.ts`/`imports.ts` 到 `outputDir`(实体文件,可编辑 `meta`)
+* - `'both'`:同 `'file'`,且虚拟模块也加载实体文件
+*
+* `typed-router.d.ts` 包含 `@ubean/routing` 和 `vue-router`/`vue-router/auto-routes`
+* 的模块增强(让 `useRoute<Name>(name)` 能推断 `route.params` 类型),所有模式
+* 都会生成到 `.ubean/typed-router.d.ts`,与 `auto-imports.d.ts`/`components.d.ts`
+* 等其他纯类型声明产物同目录,由 `.gitignore` 忽略。
+*
+* 由于 `@ubean/routing/generator` 通过动态 import 加载,前端-only 项目
+* (不依赖实体路由文件)即使没有安装 generator 相关依赖也能运行。
+*
+* 注意:`@ubean/config` 与 `@ubean/routing/generator` 的 `getRouteMeta` /
+* `onGenerated` 签名略有差异(配置层面向用户,生成器层面向内部)。本函数
+* 负责适配:把 `(filePath, frontmatter) => meta` 包装为 `(page) => meta`,
+* 把 `GeneratorResult` 转换为 `string[]` 文件路径列表。
+*/
+async function maybeGenerateRouteFiles(config, scanResult) {
+	const mode = config.routing?.mode;
+	const generateEntityFiles = mode === "file" || mode === "both";
+	const routing = config.routing;
+	const outDir = resolve(config.rootDir, routing.outputDir);
+	const dtsPath = resolve(config.rootDir, ".ubean", "typed-router.d.ts");
+	const configGetRouteMeta = routing.getRouteMeta;
+	const generatorGetRouteMeta = configGetRouteMeta ? (page) => configGetRouteMeta(page.relativePath, page.frontmatter ?? {}) : void 0;
+	const { generateRouteFiles } = await import("@ubean/routing/generator");
+	const result = await generateRouteFiles(scanResult, {
+		cwd: config.rootDir,
+		outDir,
+		dtsPath,
+		generateRoutes: generateEntityFiles,
+		generateImports: generateEntityFiles,
+		generateDts: true,
+		routeLazy: routing.routeLazy,
+		layoutLazy: routing.layoutLazy,
+		getRouteMeta: generatorGetRouteMeta,
+		headerComment: void 0
+	});
+	if (routing.onGenerated) {
+		const files = [
+			result.routesPath,
+			result.importsPath,
+			result.dtsPath
+		].filter((p) => Boolean(p));
+		routing.onGenerated(files);
+	}
+}
+//#endregion
+export { ubeanPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/build",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Core Vite plugin (framework-agnostic) for ubean (ubeanPlugin, virtual modules: routes/pages/meta/app-config/locales, macros)",
   "files": [
     "dist"
@@ -28,14 +28,14 @@
     "consola": "^3.4.2",
     "oxc-transform": "^0.141.0",
     "pathe": "^2.0.3",
-    "@ubean/config": "0.1.2",
-    "@ubean/islands": "0.1.2",
-    "@ubean/modules": "0.1.2",
-    "@ubean/routing": "0.1.2",
-    "@ubean/preset": "0.1.2",
-    "@ubean/vite": "0.1.2",
-    "@ubean/ssr": "0.1.2",
-    "@ubean/utils": "0.1.2"
+    "@ubean/config": "0.1.3",
+    "@ubean/islands": "0.1.3",
+    "@ubean/modules": "0.1.3",
+    "@ubean/preset": "0.1.3",
+    "@ubean/ssr": "0.1.3",
+    "@ubean/utils": "0.1.3",
+    "@ubean/routing": "0.1.3",
+    "@ubean/vite": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",