@ubean/build 0.6.5 → 0.6.7

package/dist/codegen/index.js

@@ -1 +1 @@
-export { d as BUILTIN_PRESETS, t as CODEGEN_CONTRACT_VERSION, n as CODEGEN_FILES, r as CODEGEN_NON_CONTRACT_FILES, p as HONO_OPENAPI_PRESET, m as UBEAN_CLIENT_PRESET, h as UBEAN_SERVER_PRESET, g as VUE_I18N_PRESET, _ as VUE_MACROS_PRESET, v as VUE_PRESET, y as VUE_ROUTER_PRESET, b as generateAutoImports, l as generateI18nTypes, x as generateImportsTransform, a as generateOpenApiTypes, o as generateOpenApiTypesFromServer, s as generatePageTypes, c as generateRouteTypes, i as generateTypes, S as getAutoImportPresets, C as getBuiltinComposables, w as getUbeanAutoImportConfig, T as getUbeanComponentsConfig, u as messagesToTsType, E as resolveAutoImportsConfig, D as resolveComponentsConfig, O as toArray } from "../codegen-BL0s5Pyq.js";
+export { d as BUILTIN_PRESETS, t as CODEGEN_CONTRACT_VERSION, n as CODEGEN_FILES, r as CODEGEN_NON_CONTRACT_FILES, p as HONO_OPENAPI_PRESET, m as UBEAN_CLIENT_PRESET, h as UBEAN_SERVER_PRESET, g as VUE_I18N_PRESET, _ as VUE_MACROS_PRESET, v as VUE_PRESET, y as VUE_ROUTER_PRESET, b as generateAutoImports, l as generateI18nTypes, x as generateImportsTransform, a as generateOpenApiTypes, o as generateOpenApiTypesFromServer, s as generatePageTypes, c as generateRouteTypes, i as generateTypes, S as getAutoImportPresets, C as getBuiltinComposables, w as getUbeanAutoImportConfig, T as getUbeanComponentsConfig, u as messagesToTsType, E as resolveAutoImportsConfig, D as resolveComponentsConfig, O as toArray } from "../codegen-CUlE95gB.js";

package/dist/{codegen-BL0s5Pyq.js → codegen-CUlE95gB.js}

@@ -810,6 +810,8 @@ async function generatePageTypes(result, options) {
 		"    filePath: string;",
 		"    layout?: string;",
 		"    reuseTarget?: string;",
+		"    /** 是否参与路由注册（false = 只进页面清单）。 */",
+		"    routable?: boolean;",
 		"  }",
 		"",
 		"  export interface LayoutInfo {",
@@ -819,7 +821,7 @@ async function generatePageTypes(result, options) {
 		"  }",
 		""
 	];
-	const pageNames = pages.map((p) => JSON.stringify(p.name));
+	const pageNames = pages.filter((p) => p.routable !== false).map((p) => JSON.stringify(p.name));
 	if (pageNames.length > 0) {
 		lines.push("  export type RouteName =");
 		lines.push(pageNames.map((n) => `    | ${n}`).join("\n"));
@@ -834,6 +836,7 @@ async function generatePageTypes(result, options) {
 	} else lines.push("  export type LayoutName = string;");
 	lines.push("");
 	lines.push("  export const pages: Record<RouteName, PageInfo>;");
+	lines.push("  export const pageEntries: Record<string, PageInfo>;");
 	lines.push("  export const layouts: Record<LayoutName, LayoutInfo>;");
 	lines.push("}");
 	const content = `${lines.join("\n")}\n`;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { a as VirtualModuleTransform, c as defineVirtualModulePrefix, i as VirtualModuleResolver, l as resetVirtualRegistry, n as VirtualModuleContext, o as createVirtualRegistry, r as VirtualModuleRegistry, s as defineVirtualModule, t as VirtualModule, u as useVirtualRegistry } from "./virtual-registry-CaU8k-YP.js";
+import "@ubean/vue/vite";
 import { CompiledLayout, CompiledMiddleware, CompiledPage, CompiledRoute } from "@ubean/routes";
 import { ScannedApiRoute, ScannedLocale, ScannedMiddleware, ScannedPageRoute } from "@ubean/scan";
 //#region src/macros.d.ts
@@ -49,6 +50,21 @@ export declare function registerCssImport(cssPath: string): void;
  * Called by `createClientEntryVirtualModule` to prepend CSS imports.
  */
 export declare function getCssImports(): string[];
+/**
+ * Register an inline `<script>` to be injected as the first element of `<head>`.
+ * e.g. `@ubean/integrations/ui` registers `@vean/theme`'s first-paint script so a
+ * project using `ui: true` needs no manual `useHead()` injection.
+ *
+ * The script must be self-contained and must run **before** any blocking
+ * stylesheet: the three injection points (`transformIndexHtml`, the fullstack
+ * server entry and the ssg static entry) all prepend it right after `<head>`.
+ */
+export declare function registerHeadScript(script: string): void;
+/**
+ * Get all registered head scripts, joined in registration order.
+ * Called by the dev HTML transform and the build-time server/ssg entries.
+ */
+export declare function getHeadScripts(): string;
 /**
  * Reset the registry (for testing).
  * @internal

package/dist/index.js

@@ -1,3 +1,3 @@
-import { _ as resetVirtualRegistry, a as ssrSingletonProdOptimizeExclude, c as getComponentResolvers, d as registerCssImport, f as resetModuleRegistry, g as defineVirtualModulePrefix, h as defineVirtualModule, i as ssrSingletonDevPolicy, l as getCssImports, m as createVirtualRegistry, n as SSR_SINGLETON_OPTIMIZE_EXCLUDE, o as ssrSingletonProdSsr, p as VirtualModuleRegistry, r as SSR_SINGLETON_PACKAGES, t as SSR_SINGLETON_DEDUPE, u as registerComponentResolver, v as useVirtualRegistry } from "./ssr-singleton-Bbds29jS.js";
-import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, o as stripMacros, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-BK0L1Op-.js";
-export { SSR_SINGLETON_DEDUPE, SSR_SINGLETON_OPTIMIZE_EXCLUDE, SSR_SINGLETON_PACKAGES, VirtualModuleRegistry, createAppVirtualModule, createLocalesVirtualModule, createMetaVirtualModule, createPagesVirtualModule, createRoutingVirtualModule, createVirtualRegistry, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, registerComponentResolver, registerCssImport, resetModuleRegistry, resetVirtualRegistry, ssrSingletonDevPolicy, ssrSingletonProdOptimizeExclude, ssrSingletonProdSsr, stripMacros, transformMacros, useVirtualRegistry };
+import { _ as defineVirtualModule, a as ssrSingletonProdOptimizeExclude, b as useVirtualRegistry, c as getComponentResolvers, d as registerComponentResolver, f as registerCssImport, g as createVirtualRegistry, h as VirtualModuleRegistry, i as ssrSingletonDevPolicy, l as getCssImports, m as resetModuleRegistry, n as SSR_SINGLETON_OPTIMIZE_EXCLUDE, o as ssrSingletonProdSsr, p as registerHeadScript, r as SSR_SINGLETON_PACKAGES, t as SSR_SINGLETON_DEDUPE, u as getHeadScripts, v as defineVirtualModulePrefix, y as resetVirtualRegistry } from "./ssr-singleton-CUHZLgiO.js";
+import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, o as stripMacros, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-B3aE-Fmn.js";
+export { SSR_SINGLETON_DEDUPE, SSR_SINGLETON_OPTIMIZE_EXCLUDE, SSR_SINGLETON_PACKAGES, VirtualModuleRegistry, createAppVirtualModule, createLocalesVirtualModule, createMetaVirtualModule, createPagesVirtualModule, createRoutingVirtualModule, createVirtualRegistry, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, getHeadScripts, registerComponentResolver, registerCssImport, registerHeadScript, resetModuleRegistry, resetVirtualRegistry, ssrSingletonDevPolicy, ssrSingletonProdOptimizeExclude, ssrSingletonProdSsr, stripMacros, transformMacros, useVirtualRegistry };

package/dist/prerender.js

@@ -65,6 +65,7 @@ function collectPrerenderRoutes(pages, options = {}) {
 	];
 	const allPageRoutes = [];
 	for (const page of pages) {
+		if (page.routable === false) continue;
 		const path = normalizePagePath(page.path);
 		if (!isDynamicPath(path)) allPageRoutes.push(path);
 	}

package/dist/production.js

@@ -1 +1 @@
-export { T as buildWithEnvironments, v as createIslandsSsrStubPlugin, y as generateCloudflareWorkerEntry, b as generateNodeServerEntry, x as generateStandardHandlerEntry, S as generateVirtualModulesToDisk, C as getPresetBuildConfig, w as serializePagesForEntry } from "./vite-CmtXmVIm.js";
+export { T as buildWithEnvironments, v as createIslandsSsrStubPlugin, y as generateCloudflareWorkerEntry, b as generateNodeServerEntry, x as generateStandardHandlerEntry, S as generateVirtualModulesToDisk, C as getPresetBuildConfig, w as serializePagesForEntry } from "./vite--HujaLpA.js";

package/dist/{ssr-singleton-Bbds29jS.js → ssr-singleton-CUHZLgiO.js}

@@ -101,7 +101,8 @@ function getRegistry() {
 	const g = globalThis;
 	if (!g[REGISTRY_KEY]) g[REGISTRY_KEY] = {
 		componentResolvers: [],
-		cssImports: []
+		cssImports: [],
+		headScripts: []
 	};
 	return g[REGISTRY_KEY];
 }
@@ -136,6 +137,27 @@ function getCssImports() {
 	return [...getRegistry().cssImports];
 }
 /**
+* Register an inline `<script>` to be injected as the first element of `<head>`.
+* e.g. `@ubean/integrations/ui` registers `@vean/theme`'s first-paint script so a
+* project using `ui: true` needs no manual `useHead()` injection.
+*
+* The script must be self-contained and must run **before** any blocking
+* stylesheet: the three injection points (`transformIndexHtml`, the fullstack
+* server entry and the ssg static entry) all prepend it right after `<head>`.
+*/
+function registerHeadScript(script) {
+	if (!script) return;
+	const reg = getRegistry();
+	if (!reg.headScripts.includes(script)) reg.headScripts.push(script);
+}
+/**
+* Get all registered head scripts, joined in registration order.
+* Called by the dev HTML transform and the build-time server/ssg entries.
+*/
+function getHeadScripts() {
+	return getRegistry().headScripts.join("\n");
+}
+/**
 * Reset the registry (for testing).
 * @internal
 */
@@ -143,6 +165,7 @@ function resetModuleRegistry() {
 	const reg = getRegistry();
 	reg.componentResolvers.length = 0;
 	reg.cssImports.length = 0;
+	reg.headScripts.length = 0;
 }
 //#endregion
 //#region src/ssr-singleton.ts
@@ -215,4 +238,4 @@ function ssrSingletonProdOptimizeExclude(extra = []) {
 	return [...SSR_SINGLETON_OPTIMIZE_EXCLUDE, ...extra];
 }
 //#endregion
-export { resetVirtualRegistry as _, ssrSingletonProdOptimizeExclude as a, getComponentResolvers as c, registerCssImport as d, resetModuleRegistry as f, defineVirtualModulePrefix as g, defineVirtualModule as h, ssrSingletonDevPolicy as i, getCssImports as l, createVirtualRegistry as m, SSR_SINGLETON_OPTIMIZE_EXCLUDE as n, ssrSingletonProdSsr as o, VirtualModuleRegistry as p, SSR_SINGLETON_PACKAGES as r, ssr_singleton_exports as s, SSR_SINGLETON_DEDUPE as t, registerComponentResolver as u, useVirtualRegistry as v, __exportAll as y };
+export { defineVirtualModule as _, ssrSingletonProdOptimizeExclude as a, useVirtualRegistry as b, getComponentResolvers as c, registerComponentResolver as d, registerCssImport as f, createVirtualRegistry as g, VirtualModuleRegistry as h, ssrSingletonDevPolicy as i, getCssImports as l, resetModuleRegistry as m, SSR_SINGLETON_OPTIMIZE_EXCLUDE as n, ssrSingletonProdSsr as o, registerHeadScript as p, SSR_SINGLETON_PACKAGES as r, ssr_singleton_exports as s, SSR_SINGLETON_DEDUPE as t, getHeadScripts as u, defineVirtualModulePrefix as v, __exportAll as x, resetVirtualRegistry as y };

package/dist/static-render.d.ts

@@ -57,7 +57,10 @@ export interface StaticSsgRendererI18nInit {
   defaultLocale?: string;
   locales?: Array<string | {
     code: string;
+    path?: string;
   }>;
+  /** Locale code → URL segment override. See `LocaleRoutingConfig.paths`. */
+  paths?: Record<string, string>;
 }
 export interface StaticSsgRendererInit {
   /** 扫描得到的页面（含动态路由模式，供具象 URL 匹配） */

package/dist/static-render.js

@@ -144,13 +144,14 @@ function expandRoutesForLocales(routes, i18n) {
 	const strategy = i18n.strategy || "prefix_except_default";
 	if (strategy === "no_prefix") return dedupeRoutes(routes);
 	const defaultLocale = i18n.defaultLocale || localeCodes[0] || "";
+	const seg = (code) => segmentOf(code, i18n.paths);
 	const expanded = [];
 	for (const route of routes) {
 		if (route === "/__ubean_404__") {
 			expanded.push(route);
 			continue;
 		}
-		const { locale } = extractLocaleFromPath(route, localeCodes);
+		const { locale } = extractLocaleFromPath(route, localeCodes, i18n.paths);
 		if (locale) {
 			expanded.push(route);
 			continue;
@@ -158,22 +159,26 @@ function expandRoutesForLocales(routes, i18n) {
 		const suffix = route === "/" || route === "" ? "" : route;
 		switch (strategy) {
 			case "prefix":
-				for (const code of localeCodes) expanded.push(`/${code}${suffix}`);
+				for (const code of localeCodes) expanded.push(`/${seg(code)}${suffix}`);
 				break;
 			case "prefix_and_default":
 				expanded.push(route || "/");
-				for (const code of localeCodes) expanded.push(`/${code}${suffix}`);
+				for (const code of localeCodes) expanded.push(`/${seg(code)}${suffix}`);
 				break;
 			default:
 				expanded.push(route || "/");
 				for (const code of localeCodes) {
 					if (code === defaultLocale) continue;
-					expanded.push(`/${code}${suffix}`);
+					expanded.push(`/${seg(code)}${suffix}`);
 				}
 		}
 	}
 	return dedupeRoutes(expanded);
 }
+/** URL segment for a locale code (`paths` override, else the code). */
+function segmentOf(code, paths) {
+	return paths?.[code] ?? code;
+}
 /**
 * 加载构建产物中的静态 entry（`dist/server/entry.mjs`），返回静态渲染器。
 *
@@ -210,7 +215,8 @@ async function createStaticSsgRenderer(cwd, manifest, init) {
 			enabled: i18nEnabled,
 			strategy,
 			defaultLocale,
-			locales: localeCodes
+			locales: localeCodes,
+			paths: init.i18n?.paths
 		}),
 		fetcher: async (url) => {
 			const u = new URL(url, "http://ubean.local");
@@ -231,7 +237,7 @@ async function createStaticSsgRenderer(cwd, manifest, init) {
 			let pathToMatch = pathname;
 			let locale = defaultLocale;
 			if (usePrefix) {
-				const { locale: extracted, pathWithoutLocale } = extractLocaleFromPath(pathname, localeCodes);
+				const { locale: extracted, pathWithoutLocale } = extractLocaleFromPath(pathname, localeCodes, init.i18n?.paths);
 				if (extracted) {
 					locale = extracted;
 					pathToMatch = pathWithoutLocale;

package/dist/{virtual-modules-BK0L1Op-.js → virtual-modules-B3aE-Fmn.js}

@@ -1,98 +1,82 @@
-import { h as defineVirtualModule } from "./ssr-singleton-Bbds29jS.js";
+import { _ as defineVirtualModule } from "./ssr-singleton-CUHZLgiO.js";
+import { extractScriptBlocks, parseScriptAst, statementCall } from "@ubean/vue/vite";
 import { isAbsolute, relative } from "pathe";
 //#region src/macros.ts
+/**
+* 宏剥除(`definePage` 等编译期宏从产物中移除)。
+*
+* 实现方式:解析成 AST 后,按节点 `start` / `end` 区间**删除整条语句**。
+*
+* 此前是手写的括号平衡扫描 + 字符串切片,有两个静默故障面:
+*
+* 1. 提到宏的字符串/注释被一起切掉 —— `const doc = "definePage({...})"`
+*    变成 `const doc = ""`,`// 用法：definePage({...})` 变成 `// 用法：`;
+* 2. 正则字面量里的括号让括号计数错位(`const re = /\\(/g`)。
+*
+* 区间删除天然不会碰到这两种情况:拼接出的字符串里不存在 `definePage` 这个词,
+* 注释与正则都只存在于 AST 之外。
+*
+* 解析器来自 `@ubean/vue/vite`(基于 `vue/compiler-sfc` 的 `babelParse`),与
+* `definePage` 元数据提取共用同一份实现 —— 一处解析,两个消费者。
+*/
 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++;
+/**
+* 判断一条**顶层语句**是否需要整条删除,返回其源码区间。
+*
+* 支持三种形状:
+* - `definePage({...});`            → `ExpressionStatement`
+* - `export default definePage({...});` → `ExportDefaultDeclaration`
+*   (`.reuse.ts` / `.meta.ts` 的写法;只删 `definePage(...)` 会留下悬空的
+*   `export default`,语法错误)
+* - 语句外的包裹(如 `if (x) definePage(...)`)不删 —— 那意味着宏写在条件分支里,
+*   属于用户错误,整条删掉会连带删掉条件本身。
+*/
+function macroStatementRange(statement, macro) {
+	if (!statementCall(statement, macro)) return null;
+	const start = statement.start;
+	const end = statement.end;
+	if (typeof start !== "number" || typeof end !== "number") return null;
+	return {
+		start,
+		end
+	};
+}
+/**
+* 删除源码中给定区间,额外吞掉紧邻的空白与一个尾随分号。
+*
+* 之所以要吞分号:`ExpressionStatement` 的 `end` 在 babel 里**不含**尾随
+* 分号(它属于 `statement.start`..`expression.end` 之外的 extra 信息),
+* 不吞就会在产物里留下一个孤立的 `;`。
+*/
+function spliceOut(code, ranges) {
+	const sorted = [...ranges].sort((a, b) => b.start - a.start);
+	let result = code;
+	for (const { start, end } of sorted) {
+		let from = start;
+		let to = end;
+		let cursor = to;
+		while (cursor < result.length && (result[cursor] === " " || result[cursor] === "	")) cursor++;
+		if (result[cursor] === ";") to = cursor + 1;
+		while (from > 0 && (result[from - 1] === " " || result[from - 1] === "	")) from--;
+		result = result.slice(0, from) + result.slice(to);
 	}
-	return null;
+	return result;
 }
-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--;
+/** 在单个脚本块内剥除宏。 */
+function stripMacrosFromCode(code, macros, fileName = "page.ts") {
+	if (macros.length === 0) return code;
+	const ast = parseScriptAst(code, fileName);
+	if (!ast) return code;
+	const body = ast.program.body ?? [];
+	const ranges = [];
+	for (const statement of body) for (const macro of macros) {
+		const range = macroStatementRange(statement, macro);
+		if (range) ranges.push(range);
 	}
-	if (code[end] === ";") end++;
-	while (end < code.length && /[ \t]/.test(code[end])) end++;
-	return code.slice(0, start) + code.slice(end);
+	return ranges.length > 0 ? spliceOut(code, ranges) : code;
 }
 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;
+	return stripMacrosFromCode(code, macros);
 }
 function transformMacros(code, id) {
 	if (!(id.includes("/src/pages/") || id.includes("/src/routes/") || id.includes("/src/middleware/"))) return null;
@@ -114,12 +98,32 @@ const PLAIN_SCRIPT_RE = /<script(?![^>]*\bsetup\b)[^>]*>/;
 * 而 `definePage` 是宏、必被剥掉 —— 一个只有 loader 的页面正好落在坑里。
 */
 const EMPTY_SETUP_KEEP_ALIVE = "\n// ubean: 宏已剥离，保留此块以维持组件的默认导出（见 builder/src/macros.ts）\n";
+/**
+* SFC 宏剥除。
+*
+* 用 `extractScriptBlocks`(即 `@vue/compiler-sfc` 的 `parse`)拿到每个 `<script>`
+* 块在**原文件**中的精确区间,逐块删除后按偏移倒序回写 —— 而不是用
+* `/<script([^>]*)>([\s\S]*?)<\/script>/g` 猜标签边界(该正则在 `<script>` 出现在
+* 字符串或注释里时会错位)。
+*/
 function transformVueMacros(code) {
+	const blocks = extractScriptBlocks(code, "page.vue");
+	if (!blocks || blocks.length === 0) return code;
 	const hasPlainScript = PLAIN_SCRIPT_RE.test(code);
-	return code.replace(/<script([^>]*)>([\s\S]*?)<\/script>/g, (_match, attrs, content) => {
-		const stripped = stripMacros(content);
-		return `<script${attrs}>${/\bsetup\b/.test(attrs) && hasPlainScript && !stripped.trim() ? EMPTY_SETUP_KEEP_ALIVE : stripped}<\/script>`;
-	});
+	const edits = [];
+	for (const block of blocks) {
+		const stripped = stripMacrosFromCode(block.content, MACRO_NAMES, `page.${block.lang || "ts"}`);
+		const keepAlive = block.setup && hasPlainScript && !stripped.trim() ? EMPTY_SETUP_KEEP_ALIVE : stripped;
+		if (keepAlive !== block.content) edits.push({
+			start: block.start,
+			end: block.end,
+			text: keepAlive
+		});
+	}
+	if (edits.length === 0) return code;
+	let result = code;
+	for (const edit of [...edits].sort((a, b) => b.start - a.start)) result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
+	return result;
 }
 //#endregion
 //#region src/virtual-modules.ts
@@ -145,7 +149,7 @@ function createRoutingVirtualModule(routes, middlewares, cwd) {
 }
 function createPagesVirtualModule(pages, layouts, cwd) {
 	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(toPortableFilePath(p.filePath, cwd))}, 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(toPortableFilePath(l.filePath, cwd))}, 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 };`;
+		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(toPortableFilePath(p.filePath, cwd))}, layout: ${JSON.stringify(p.layout)}, reuseTarget: ${JSON.stringify(p.reuseTarget)}, routable: ${p.routable !== false}, pageMeta: ${JSON.stringify(p.pageMeta ?? null)} }`).join(",\n")}\n};\nexport const pageEntries = pages;\nexport const layouts = {\n${layouts.map((l) => `  ${JSON.stringify(l.name)}: { name: ${JSON.stringify(l.name)}, filePath: ${JSON.stringify(toPortableFilePath(l.filePath, cwd))}, isDefault: ${l.isDefault} }`).join(",\n")}\n};\nexport type RouteName = ${pages.filter((p) => p.routable !== false).map((p) => JSON.stringify(p.name)).join(" | ") || "string"};\nexport type LayoutName = ${layouts.map((l) => JSON.stringify(l.name)).join(" | ") || "string"};\nexport default { pages, layouts, pageEntries };`;
 	});
 }
 function createMetaVirtualModule() {
@@ -171,6 +175,8 @@ function createAppVirtualModule(apiRoutes, middlewares, pages, srcDir) {
 			name: p.name,
 			route: p.route,
 			isReuse: p.isReuse,
+			isMeta: p.isMeta,
+			routable: p.routable,
 			layout: p.layout
 		}));
 		const viteSrcDir = toVitePath(srcDir);
@@ -287,12 +293,16 @@ if (import.meta.env.SSR) {
 }
 
 async function collectMessages(code) {
-  const localeData = { messages: {}, options: { isDefault: false, name: undefined, dir: 'ltr', language: undefined } };
+  const localeData = {
+    messages: {},
+    options: { isDefault: false, name: undefined, path: undefined, dir: 'ltr', language: undefined }
+  };
   const configLoc = i18nConfig && i18nConfig.locales
     ? i18nConfig.locales.find(l => (typeof l === 'string' ? l : l.code) === code)
     : undefined;
   if (configLoc && typeof configLoc === 'object') {
     localeData.options.name = configLoc.name;
+    localeData.options.path = configLoc.path;
     localeData.options.dir = configLoc.dir || 'ltr';
     localeData.options.language = configLoc.language;
     localeData.options.isDefault = configLoc.code === (i18nConfig && i18nConfig.defaultLocale);

package/dist/{vite-CmtXmVIm.js → vite--HujaLpA.js}

@@ -1,13 +1,13 @@
-import { a as ssrSingletonProdOptimizeExclude, m as createVirtualRegistry, o as ssrSingletonProdSsr, y as __exportAll } from "./ssr-singleton-Bbds29jS.js";
-import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-BK0L1Op-.js";
-import { a as generateOpenApiTypes, i as generateTypes } from "./codegen-BL0s5Pyq.js";
-import { _ as toWebRequest, a as createVueAppEntryVirtualModule, b as getDevScanCoordinator, g as sendWebResponse, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, u as ensureDevApp } from "./vue-15_4jzH7.js";
+import { a as ssrSingletonProdOptimizeExclude, g as createVirtualRegistry, o as ssrSingletonProdSsr, x as __exportAll } from "./ssr-singleton-CUHZLgiO.js";
+import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-B3aE-Fmn.js";
+import { a as generateOpenApiTypes, i as generateTypes } from "./codegen-CUlE95gB.js";
+import { _ as sendWebResponse, a as createServerEntryVirtualModule, d as ensureDevApp, i as createClientEntryVirtualModule, n as ubeanVite, o as createVueAppEntryVirtualModule, r as composeHeadScripts, s as createVuePagesVirtualModule, v as toWebRequest, x as getDevScanCoordinator } from "./vue-Z4wVSxSE.js";
 import { createStaticSsgRenderer } from "./static-render.js";
 import { prerender, resolvePrerenderStaticDir } from "./prerender.js";
 import { dirname, isAbsolute, join, relative, resolve } from "pathe";
 import * as nodeFs from "node:fs";
 import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
-import { checkProjectDependenciesOnce, loadUbeanConfig, resolveModules, resolvePrerenderConfig, tryGetConfig } from "@ubean/config";
+import { checkProjectDependenciesOnce, loadUbeanConfig, localePathsOf, resolveModules, resolvePrerenderConfig, tryGetConfig } from "@ubean/config";
 import { isEphemeralCachePreset, registerBuiltinPresets, resolvePresetByName, resolveProductionCacheStore } from "@ubean/preset";
 import { createServerRouter } from "@ubean/routes";
 import { scanProject } from "@ubean/scan";
@@ -30,7 +30,8 @@ function localeVueParamFromI18n(config) {
 	return getVueLocaleParam({
 		defaultLocale: config.defaultLocale,
 		locales: config.locales.map((l) => l.code),
-		strategy: config.strategy
+		strategy: config.strategy,
+		paths: localePathsOf(config)
 	}) || void 0;
 }
 //#endregion
@@ -86,6 +87,8 @@ const _pageToRoute = p => {
 
 const _routeGroups = new Map();
 for (const _p of _pages) {
+  // routable: false 的页面不建路由（与客户端 virtual:ubean-pages 同形）。
+  if (_p.routable === false) continue;
   const _key = _p.route;
   const _group = _routeGroups.get(_key) || { slots: [] };
   if (_p.slot) _group.slots.push(_p);
@@ -285,7 +288,8 @@ export async function renderStaticPage(input) {
     renderContext.routing = {
       defaultLocale: _i18nConfig.defaultLocale || 'en',
       locales: _localeCodes,
-      strategy: _i18nConfig.strategy || 'prefix_except_default'
+      strategy: _i18nConfig.strategy || 'prefix_except_default',
+      ...(_i18nConfig.paths ? { paths: _i18nConfig.paths } : {})
     };
     const cookieName =
       _i18nConfig.detectBrowserLanguage && _i18nConfig.detectBrowserLanguage.cookieName;
@@ -738,14 +742,15 @@ async function writeClientIndexHtml(virtualDir) {
 * manifest、同一套标签规则，避免出现第二种「入口长什么样」的定义。
 */
 async function writeSpaIndexHtml(options) {
-	const { outDirs, tags } = options;
+	const { outDirs, tags, headScript } = options;
 	const target = join(outDirs.public, "index.html");
+	const favicon = tags.favicon ?? "/favicon.svg";
 	const html = `<!DOCTYPE html>
 <html>
-<head>
+<head>${headScript ? `\n  ${headScript}` : ""}
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <link rel="icon" href="${tags.favicon ?? "/favicon.svg"}" type="image/svg+xml" />
+  <link rel="icon" href="${favicon}" type="image/svg+xml" />
   <title>Ubean App</title>
 ${tags.css ? `  ${tags.css.split("\n").join("\n  ")}\n` : ""}</head>
 <body>
@@ -1250,10 +1255,7 @@ async function prepareBuild(ctx, manifestRef = { current: null }) {
 		mode: ctx.mode,
 		ssrEnabled: ctx.ssrEnabled
 	});
-	logger$2.info("Generating virtual modules...");
 	const virtualRegistry = createVirtualRegistry();
-	await generateVirtualModulesToDisk(cwd, config, scanResult, outDirs.virtual, preset, virtualRegistry, contentSnapshot);
-	if (hasPages) await writeClientIndexHtml(outDirs.virtual);
 	const userViteConfig = findUserViteConfig(cwd);
 	const builtinPlugins = [];
 	if (!userViteConfig) {
@@ -1277,6 +1279,9 @@ async function prepareBuild(ctx, manifestRef = { current: null }) {
 		builtinPlugins
 	});
 	if (hasServer) plugins.push(perEnvironmentPlugin("ubean", () => createIslandsSsrStubPlugin()));
+	logger$2.info("Generating virtual modules...");
+	await generateVirtualModulesToDisk(cwd, config, scanResult, outDirs.virtual, preset, virtualRegistry, contentSnapshot);
+	if (hasPages) await writeClientIndexHtml(outDirs.virtual);
 	return {
 		...ctx,
 		plugins,
@@ -1316,7 +1321,8 @@ async function runEnvBuilds(builder, prepared) {
 				css: tags.css,
 				body: tags.body,
 				favicon: prepared.config.favicon
-			}
+			},
+			headScript: composeHeadScripts(prepared.config.colorMode !== false ? getColorModeScript(resolveColorModeConfig(prepared.config.colorMode)) : "")
 		});
 	}
 	const builtManifest = await writeBuildManifest({
@@ -1429,6 +1435,8 @@ function serializePagesForEntry(pages) {
 		layout: p.layout,
 		cache: p.cache,
 		isReuse: p.isReuse,
+		isMeta: p.isMeta,
+		routable: p.routable,
 		isMarkdown: p.isMarkdown,
 		reuseTarget: p.reuseTarget,
 		pageMeta: p.pageMeta,
@@ -1528,7 +1536,7 @@ async function generateVirtualModulesToDisk(cwd, config, scanResult, virtualDir,
 		layout: scanResult.notFoundPage.layout,
 		pageMeta: scanResult.notFoundPage.pageMeta
 	} : null);
-	const colorModeScript = config.colorMode !== false ? getColorModeScript(resolveColorModeConfig(config.colorMode)) : "";
+	const colorModeScript = composeHeadScripts(config.colorMode !== false ? getColorModeScript(resolveColorModeConfig(config.colorMode)) : "");
 	const rendererImport = ssrEnabled ? `import { createVueRenderer } from 'ubean/ssr';` : "";
 	const prodLocaleVueParam = localeVueParamFromI18n(config.i18n) || "";
 	const rendererSetup = buildRendererSetup({
@@ -2482,7 +2490,7 @@ async function buildEnvironmentsForConfig(config) {
 		Promise.resolve().then(() => build_configs_exports),
 		import("./production.js"),
 		import("@ubean/preset"),
-		import("./ssr-singleton-Bbds29jS.js").then((n) => n.s)
+		import("./ssr-singleton-CUHZLgiO.js").then((n) => n.s)
 	]);
 	registerBuiltinPresets();
 	const outDirs = getBuildOutDirsForConfig(config);

package/dist/vite.js

@@ -1,4 +1,4 @@
-import { m as createVirtualRegistry } from "./ssr-singleton-Bbds29jS.js";
-import { A as toVueRouterPagePath, C as bootstrapDevApp, D as resolveLocaleVueParam, E as resolveDevSecurityHeaders, O as enhanceDevApp, S as peekDevScanCoordinator, T as createDevAppReady, _ as toWebRequest, b as getDevScanCoordinator, c as collectDevCssLinks, d as getDevApp, f as injectStylesheetLinks, g as sendWebResponse, h as ubeanDevRequestPlugin, k as buildDevSsrRoutes, l as createUbeanRequestHandlers, m as isViteResourceRequest, p as isFrameworkHtmlPage, s as DEVTOOLS_PASS_THROUGH_PREFIXES, u as ensureDevApp, v as DEV_SCAN_DIRS, w as createDevApp, x as onDevScan, y as createDevScanCoordinator } from "./vue-15_4jzH7.js";
-import { D as createCloudflarePreviewRunner, E as MINIFLARE_INSTALL_HINT, O as defaultLoadMiniflare, _ as ubeanPreviewPlugin, a as createEnvRunnerTransport, c as getDevWorkerEntrySource, d as attachPreviewMiddleware, f as createPreviewMiddleware, g as sendPreviewStatus, h as sendPreviewFile, i as bridgeEnvRunnerInvokes, k as readCompatibilityDate, l as invalidateDevWorkerModules, m as resolvePreviewFile, n as UBEAN_DEV_ENV_NAME, o as createUbeanDevEnvironmentFactory, p as previewMimeType, r as UbeanDevEnvironment, s as DEV_WORKER_FILE, t as ubeanPlugin, u as writeDevWorkerEntry } from "./vite-CmtXmVIm.js";
+import { g as createVirtualRegistry } from "./ssr-singleton-CUHZLgiO.js";
+import { A as buildDevSsrRoutes, C as peekDevScanCoordinator, D as resolveDevSecurityHeaders, E as createDevAppReady, O as resolveLocaleVueParam, S as onDevScan, T as createDevApp, _ as sendWebResponse, b as createDevScanCoordinator, c as DEVTOOLS_PASS_THROUGH_PREFIXES, d as ensureDevApp, f as getDevApp, g as ubeanDevRequestPlugin, h as isViteResourceRequest, j as toVueRouterPagePath, k as enhanceDevApp, l as collectDevCssLinks, m as isFrameworkHtmlPage, p as injectStylesheetLinks, u as createUbeanRequestHandlers, v as toWebRequest, w as bootstrapDevApp, x as getDevScanCoordinator, y as DEV_SCAN_DIRS } from "./vue-Z4wVSxSE.js";
+import { D as createCloudflarePreviewRunner, E as MINIFLARE_INSTALL_HINT, O as defaultLoadMiniflare, _ as ubeanPreviewPlugin, a as createEnvRunnerTransport, c as getDevWorkerEntrySource, d as attachPreviewMiddleware, f as createPreviewMiddleware, g as sendPreviewStatus, h as sendPreviewFile, i as bridgeEnvRunnerInvokes, k as readCompatibilityDate, l as invalidateDevWorkerModules, m as resolvePreviewFile, n as UBEAN_DEV_ENV_NAME, o as createUbeanDevEnvironmentFactory, p as previewMimeType, r as UbeanDevEnvironment, s as DEV_WORKER_FILE, t as ubeanPlugin, u as writeDevWorkerEntry } from "./vite--HujaLpA.js";
 export { DEVTOOLS_PASS_THROUGH_PREFIXES, DEV_SCAN_DIRS, DEV_WORKER_FILE, MINIFLARE_INSTALL_HINT, UBEAN_DEV_ENV_NAME, UbeanDevEnvironment, attachPreviewMiddleware, bootstrapDevApp, bridgeEnvRunnerInvokes, buildDevSsrRoutes, collectDevCssLinks, createCloudflarePreviewRunner, createDevApp, createDevAppReady, createDevScanCoordinator, createEnvRunnerTransport, createPreviewMiddleware, createUbeanDevEnvironmentFactory, createUbeanRequestHandlers, createVirtualRegistry, defaultLoadMiniflare, enhanceDevApp, ensureDevApp, getDevApp, getDevScanCoordinator, getDevWorkerEntrySource, injectStylesheetLinks, invalidateDevWorkerModules, isFrameworkHtmlPage, isViteResourceRequest, onDevScan, peekDevScanCoordinator, previewMimeType, readCompatibilityDate, resolveDevSecurityHeaders, resolveLocaleVueParam, resolvePreviewFile, sendPreviewFile, sendPreviewStatus, sendWebResponse, toVueRouterPagePath, toWebRequest, ubeanDevRequestPlugin, ubeanPlugin, ubeanPreviewPlugin, writeDevWorkerEntry };

package/dist/{vue-15_4jzH7.js → vue-Z4wVSxSE.js}

@@ -1,9 +1,10 @@
-import { c as getComponentResolvers, h as defineVirtualModule, i as ssrSingletonDevPolicy, l as getCssImports, m as createVirtualRegistry } from "./ssr-singleton-Bbds29jS.js";
-import { D as resolveComponentsConfig, E as resolveAutoImportsConfig, O as toArray, S as getAutoImportPresets, f as COMPONENT_HALF_GLOBS } from "./codegen-BL0s5Pyq.js";
+import { _ as defineVirtualModule, c as getComponentResolvers, g as createVirtualRegistry, i as ssrSingletonDevPolicy, l as getCssImports, u as getHeadScripts } from "./ssr-singleton-CUHZLgiO.js";
+import { D as resolveComponentsConfig, E as resolveAutoImportsConfig, O as toArray, S as getAutoImportPresets, f as COMPONENT_HALF_GLOBS } from "./codegen-CUlE95gB.js";
 import { createRequire } from "node:module";
+import { generatePagesModuleSource } from "@ubean/vue/vite";
 import { isAbsolute, join, normalize, relative, resolve } from "pathe";
 import { existsSync } from "node:fs";
-import { loadUbeanConfig } from "@ubean/config";
+import { loadUbeanConfig, localePathsOf } from "@ubean/config";
 import { scanProject } from "@ubean/scan";
 import { applyServerConfig, createUbeanApp } from "@ubean/app";
 import { getVueLocaleParam, toVueRouterLocalePath } from "@ubean/i18n";
@@ -16,7 +17,6 @@ import AutoImport from "unplugin-auto-import/vite";
 import { ubeanMdxPlugin } from "@ubean/markdown";
 import { renderFaviconLink } from "@ubean/pages";
 import VueI18nPlugin from "@intlify/unplugin-vue-i18n/vite";
-import { generatePagesModuleSource } from "@ubean/vue/vite";
 //#region src/dev/dev-ssr-routes.ts
 /**
 * dev/SSR 路由表（RM-V11 的组成部件，从 CLI dev server 抽出）。
@@ -49,9 +49,10 @@ function toVueRouterPagePath(route) {
 function buildDevSsrRoutes(options) {
 	const { pages, layouts, loadComponent, localeVueParam, notFoundPage } = options;
 	const defaultLayout = layouts.find((l) => l.isDefault)?.name ?? null;
+	const routablePages = pages.filter((p) => p.routable !== false);
 	const withLocale = (path) => localeVueParam ? toVueRouterLocalePath(path, localeVueParam) : path;
 	const pageByName = /* @__PURE__ */ new Map();
-	for (const page of pages) pageByName.set(page.name, page);
+	for (const page of routablePages) pageByName.set(page.name, page);
 	const componentFor = (page) => {
 		const fullPath = (page.isReuse && page.reuseTarget ? pageByName.get(page.reuseTarget) : void 0)?.fullPath || page.fullPath;
 		return async () => await loadComponent(fullPath);
@@ -67,7 +68,7 @@ function buildDevSsrRoutes(options) {
 		}
 	});
 	const grouped = /* @__PURE__ */ new Map();
-	for (const page of pages) {
+	for (const page of routablePages) {
 		const group = grouped.get(page.route) ?? { slots: [] };
 		if (page.slot) group.slots.push(page);
 		else if (!group.default) group.default = page;
@@ -391,7 +392,8 @@ function resolveLocaleVueParam(config) {
 	return getVueLocaleParam({
 		defaultLocale: i18n.defaultLocale,
 		locales: i18n.locales.map((l) => l.code),
-		strategy: i18n.strategy
+		strategy: i18n.strategy,
+		paths: localePathsOf(i18n)
 	});
 }
 //#endregion
@@ -1213,6 +1215,7 @@ if (_i18nConfig && _i18nConfig.enabled !== false) {
       fallbackLocale: _i18nConfig.fallbackLocale || _i18nConfig.defaultLocale,
       cookieName: (_i18nConfig.detectBrowserLanguage && _i18nConfig.detectBrowserLanguage.cookieName) || 'ubean_locale',
       baseUrl: _i18nConfig.baseUrl || '',
+      paths: _i18nConfig.paths,
       vueI18n: _i18nConfig.vueI18n
     },
     loadLocale: _loadLocale,
@@ -1465,6 +1468,21 @@ export const rootId = 'app';
 `.trim()}\n`;
 	});
 }
+/**
+* 合并首帧 `<head>` 脚本的两个来源，去重后返回。
+*
+* 通常只有一个源生效：`ui` 接管时配置层强制把 `colorMode` 置 false，所以两边不会同时非空。
+* 两个源合成一个字符串后，三条注入路径（dev `transformIndexHtml`、fullstack 服务端入口、
+* ssg 静态入口）只需要一个 `colorModeScript` 字段，不必各自改签名。
+*
+* @param colorModeScript - 已渲染的 ubean color-mode 脚本（`getColorModeScript()` 产物）
+*/
+function composeHeadScripts(colorModeScript) {
+	const headScripts = getHeadScripts();
+	if (!headScripts) return colorModeScript;
+	if (!colorModeScript) return headScripts;
+	return `${headScripts}\n${colorModeScript}`;
+}
 function createClientEntryVirtualModule() {
 	return defineVirtualModule("virtual:ubean-client-entry", () => {
 		return `${`
@@ -1570,7 +1588,8 @@ function localeVueParamFromConfig(config) {
 	return getVueLocaleParam({
 		defaultLocale: config.i18n.defaultLocale,
 		locales: codes,
-		strategy: config.i18n.strategy
+		strategy: config.i18n.strategy,
+		paths: localePathsOf(config.i18n)
 	}) || void 0;
 }
 function ubeanVite(options) {
@@ -1695,11 +1714,8 @@ function ubeanVite(options) {
 		transformIndexHtml(html, ctx) {
 			if (ctx?.path && isFrameworkHtmlPage(ctx.path)) return html;
 			let result = html;
-			const colorModeConfig = ubeanConfig.colorMode;
-			if (colorModeConfig !== false) {
-				const script = getColorModeScript(resolveColorModeConfig(colorModeConfig));
-				result = result.replace("<head>", `<head>\n    ${script}`);
-			}
+			const headScript = composeHeadScripts(ubeanConfig.colorMode !== false ? getColorModeScript(resolveColorModeConfig(ubeanConfig.colorMode)) : "");
+			if (headScript) result = result.replace("<head>", `<head>\n    ${headScript}`);
 			const partyTownConfig = ubeanConfig.partyTown;
 			if (partyTownConfig !== false && partyTownConfig !== void 0) {
 				const resolved = resolvePartyTownConfig(partyTownConfig === true ? { enabled: true } : partyTownConfig);
@@ -1872,4 +1888,4 @@ async function runPagefindIndexing(ubeanConfig, searchConfig) {
 	});
 }
 //#endregion
-export { toVueRouterPagePath as A, bootstrapDevApp as C, resolveLocaleVueParam as D, resolveDevSecurityHeaders as E, enhanceDevApp as O, peekDevScanCoordinator as S, createDevAppReady as T, toWebRequest as _, createVueAppEntryVirtualModule as a, getDevScanCoordinator as b, collectDevCssLinks as c, getDevApp as d, injectStylesheetLinks as f, sendWebResponse as g, ubeanDevRequestPlugin as h, createServerEntryVirtualModule as i, buildDevSsrRoutes as k, createUbeanRequestHandlers as l, isViteResourceRequest as m, ubeanVite as n, createVuePagesVirtualModule as o, isFrameworkHtmlPage as p, createClientEntryVirtualModule as r, DEVTOOLS_PASS_THROUGH_PREFIXES as s, VUE_PLUGIN_INCLUDE as t, ensureDevApp as u, DEV_SCAN_DIRS as v, createDevApp as w, onDevScan as x, createDevScanCoordinator as y };
+export { buildDevSsrRoutes as A, peekDevScanCoordinator as C, resolveDevSecurityHeaders as D, createDevAppReady as E, resolveLocaleVueParam as O, onDevScan as S, createDevApp as T, sendWebResponse as _, createServerEntryVirtualModule as a, createDevScanCoordinator as b, DEVTOOLS_PASS_THROUGH_PREFIXES as c, ensureDevApp as d, getDevApp as f, ubeanDevRequestPlugin as g, isViteResourceRequest as h, createClientEntryVirtualModule as i, toVueRouterPagePath as j, enhanceDevApp as k, collectDevCssLinks as l, isFrameworkHtmlPage as m, ubeanVite as n, createVueAppEntryVirtualModule as o, injectStylesheetLinks as p, composeHeadScripts as r, createVuePagesVirtualModule as s, VUE_PLUGIN_INCLUDE as t, createUbeanRequestHandlers as u, toWebRequest as v, bootstrapDevApp as w, getDevScanCoordinator as x, DEV_SCAN_DIRS as y };

package/dist/vue.d.ts

@@ -36,6 +36,16 @@ export declare function ubeanVite(options: UbeanViteOptions): Plugin[];
  */
 export declare function createVuePagesVirtualModule(pages: ScannedPageRoute[], layouts: ScannedLayout[], notFoundPage?: ScannedPageRoute, loadingPage?: ScannedPageRoute, errorPage?: ScannedPageRoute, localeVueParam?: string): VirtualModule;
 export declare function createVueAppEntryVirtualModule(appEntry?: ScannedAppEntry): VirtualModule;
+/**
+ * 合并首帧 `<head>` 脚本的两个来源，去重后返回。
+ *
+ * 通常只有一个源生效：`ui` 接管时配置层强制把 `colorMode` 置 false，所以两边不会同时非空。
+ * 两个源合成一个字符串后，三条注入路径（dev `transformIndexHtml`、fullstack 服务端入口、
+ * ssg 静态入口）只需要一个 `colorModeScript` 字段，不必各自改签名。
+ *
+ * @param colorModeScript - 已渲染的 ubean color-mode 脚本（`getColorModeScript()` 产物）
+ */
+export declare function composeHeadScripts(colorModeScript: string): string;
 export declare function createClientEntryVirtualModule(): VirtualModule;
 export declare function createServerEntryVirtualModule(serverEntry?: ScannedServerEntry): VirtualModule;
 //#endregion

package/dist/vue.js

@@ -1 +1 @@
-export { t as VUE_PLUGIN_INCLUDE, r as createClientEntryVirtualModule, i as createServerEntryVirtualModule, a as createVueAppEntryVirtualModule, o as createVuePagesVirtualModule, n as default, n as ubeanVite } from "./vue-15_4jzH7.js";
+export { t as VUE_PLUGIN_INCLUDE, r as composeHeadScripts, i as createClientEntryVirtualModule, a as createServerEntryVirtualModule, o as createVueAppEntryVirtualModule, s as createVuePagesVirtualModule, n as default, n as ubeanVite } from "./vue-Z4wVSxSE.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/build",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Vite plugins, production build, SSG prerender, type codegen, and Server Actions plugin for ubean",
   "files": [
     "dist"
@@ -48,20 +48,20 @@
     }
   },
   "dependencies": {
-    "@intlify/unplugin-vue-i18n": "11.2.6",
-    "@ubean/app": "0.6.5",
-    "@ubean/client": "0.6.5",
-    "@ubean/config": "0.6.5",
-    "@ubean/i18n": "0.6.5",
-    "@ubean/islands": "0.6.5",
-    "@ubean/markdown": "0.6.5",
-    "@ubean/pages": "0.6.5",
-    "@ubean/preset": "0.6.5",
-    "@ubean/routes": "0.6.5",
-    "@ubean/scan": "0.6.5",
-    "@ubean/server": "0.6.5",
-    "@ubean/shared": "0.6.5",
-    "@ubean/vue": "0.6.5",
+    "@intlify/unplugin-vue-i18n": "11.2.7",
+    "@ubean/app": "0.6.7",
+    "@ubean/client": "0.6.7",
+    "@ubean/config": "0.6.7",
+    "@ubean/i18n": "0.6.7",
+    "@ubean/islands": "0.6.7",
+    "@ubean/markdown": "0.6.7",
+    "@ubean/pages": "0.6.7",
+    "@ubean/preset": "0.6.7",
+    "@ubean/routes": "0.6.7",
+    "@ubean/scan": "0.6.7",
+    "@ubean/server": "0.6.7",
+    "@ubean/shared": "0.6.7",
+    "@ubean/vue": "0.6.7",
     "@vitejs/plugin-vue": "^6.0.10",
     "openapi-typescript": "^7.13.0",
     "pathe": "^2.0.3",
@@ -70,7 +70,7 @@
     "unplugin-auto-import": "21.1.0",
     "unplugin-vue-components": "^32.1.0",
     "unplugin-vue-markdown": "^32.1.1",
-    "vue-i18n": "11.4.15"
+    "vue-i18n": "11.4.16"
   },
   "devDependencies": {
     "@types/node": "^26.6.5",