@ubean/build 0.6.4 → 0.6.6

package/dist/index.d.ts

@@ -49,6 +49,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-CsmYnd9W.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/production.d.ts

@@ -21,7 +21,12 @@ export interface BuildOptions {
   config: ResolvedConfig;
   preset: Preset;
   scanResult: ScanResult;
+  /**
+   * 缺省时回落到 `config.build.minify`，再回落到 `true`。
+   * CLI `--minify` 优先级最高，由 `packages/cli/src/build.ts` 传入。
+   */
   minify?: boolean;
+  /** 缺省时回落到 `config.build.sourcemap`，再回落到 `false`。 */
   sourcemap?: boolean;
   /** Inlined content collections for production SSR (`queryCollection`). */
   contentSnapshot?: Record<string, unknown[]>;

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-DR0qiIma.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-Dva-CNKw.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-CsmYnd9W.js}

@@ -1,4 +1,4 @@
-import { h as defineVirtualModule } from "./ssr-singleton-Bbds29jS.js";
+import { _ as defineVirtualModule } from "./ssr-singleton-CUHZLgiO.js";
 import { isAbsolute, relative } from "pathe";
 //#region src/macros.ts
 const MACRO_NAMES = ["definePage"];
@@ -287,12 +287,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-DR0qiIma.js → vite-Dva-CNKw.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 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-CsmYnd9W.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-MyIMqUw0.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-q7rHFo73.js";
 import { createStaticSsgRenderer } from "./static-render.js";
 import { prerender, resolvePrerenderStaticDir } from "./prerender.js";
-import { dirname, join, relative, resolve } from "pathe";
+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
@@ -285,7 +286,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 +740,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>
@@ -1218,7 +1221,7 @@ function readClientManifest(publicDir) {
 }
 /** 由 options 派生上下文（不做任何 IO）。 */
 function createBuildContext(options) {
-	const { cwd, config, preset, scanResult, minify = true, sourcemap = false, contentSnapshot } = options;
+	const { cwd, config, preset, scanResult, minify = config.build.minify, sourcemap = config.build.sourcemap, contentSnapshot } = options;
 	const mode = config.mode;
 	return {
 		cwd,
@@ -1250,10 +1253,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 +1277,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,
@@ -1301,7 +1304,7 @@ async function runEnvBuilds(builder, prepared) {
 		await builder.build(builder.environments.ubean);
 	}
 	if (hasPages) {
-		const publicDir = join(cwd, "public");
+		const publicDir = isAbsolute(prepared.config.dir.public) ? prepared.config.dir.public : join(cwd, prepared.config.dir.public);
 		if (existsSync(publicDir)) {
 			logger$2.info("Copying public assets...");
 			await cp(publicDir, outDirs.public, { recursive: true });
@@ -1316,7 +1319,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({
@@ -1528,7 +1532,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 +2486,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);
@@ -2490,8 +2494,8 @@ async function buildEnvironmentsForConfig(config) {
 	return createBuildEnvironments({
 		outDirs,
 		clientInput: existsSync(clientEntryPath) ? clientEntryPath : join(outDirs.virtual, "client-entry.mjs"),
-		minify: true,
-		sourcemap: false,
+		minify: config.build.minify,
+		sourcemap: config.build.sourcemap,
 		presetBuildConfig: getPresetBuildConfig(resolvePresetByName(config.build.preset)),
 		ssrNoExternal: ssrSingletonProdSsr().noExternal
 	});
@@ -2700,6 +2704,7 @@ function ubeanPlugin(options) {
 			});
 			const announceMissingOpenApiTypes = async () => {
 				if (!ubeanConfig) return;
+				if (ubeanConfig.mode === "ssg" || ubeanConfig.mode === "spa") return;
 				const filePath = join(ubeanConfig.rootDir, ".ubean", "openapi.d.ts");
 				try {
 					const app = await ensureDevApp(server);

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-MyIMqUw0.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-DR0qiIma.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-q7rHFo73.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-Dva-CNKw.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-MyIMqUw0.js → vue-q7rHFo73.js}

@@ -1,13 +1,14 @@
-import { c as getComponentResolvers, h as defineVirtualModule, i as ssrSingletonDevPolicy, l as getCssImports, m as createVirtualRegistry } from "./ssr-singleton-Bbds29jS.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-BL0s5Pyq.js";
 import { createRequire } from "node:module";
 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";
 import { getColorModeScript, getPartyTownScript, resolveColorModeConfig, resolvePartyTownConfig } from "@ubean/client";
+import { generatePagesModuleSource } from "@ubean/vue/vite";
 import { transformWithOxc } from "vite";
 import vue from "@vitejs/plugin-vue";
 import Components from "unplugin-vue-components/vite";
@@ -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 抽出）。
@@ -391,7 +391,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
@@ -1009,6 +1010,22 @@ function renderErrorPage(error) {
 function createUbeanRequestHandlers(server, options) {
 	const { skipHtmlTransform, onError } = options;
 	const handler = options.handler ?? createLazyBootstrapHandler(server, options.bootstrap);
+	/**
+	* `vite.config.ts` 的 `server.headers` 合并到 ubean 自己渲染的响应上。
+	*
+	* Vite 只把它应用到自己的中间件（`servePublicMiddleware` / `transformMiddleware`），而 ubean 的
+	* 页面走 `respond()` 直接输出 —— 不合并的话「给所有响应加 header」在应用页面上静默失效。
+	* 通过 `res.setHeader` 写的值优先（框架/Hono 显式设置的不该被配置文件盖掉）。
+	*/
+	function applyConfiguredHeaders(res) {
+		const headers = server.config.server.headers;
+		if (!headers) return;
+		for (const [key, value] of Object.entries(headers)) {
+			if (value === void 0) continue;
+			if (res.hasHeader(key)) continue;
+			res.setHeader(key, value);
+		}
+	}
 	async function respond(req, res) {
 		const url = req.url || "/";
 		const webReq = await toWebRequest(req, "localhost", req.socket?.encrypted ? "https" : "http");
@@ -1025,9 +1042,11 @@ function createUbeanRequestHandlers(server, options) {
 			webRes.headers.forEach((value, key) => {
 				res.setHeader(key, value);
 			});
+			applyConfiguredHeaders(res);
 			res.end(transformed);
 			return;
 		}
+		applyConfiguredHeaders(res);
 		await sendWebResponse(res, webRes);
 	}
 	/** 统一错误处理：SSR 栈映射回源码，响应头已发出时只能断开。 */
@@ -1050,8 +1069,27 @@ function createUbeanRequestHandlers(server, options) {
 		const pathname = url.split("?")[0].split("#")[0];
 		return passThrough.some((prefix) => pathname.startsWith(prefix));
 	};
+	/**
+	* 命中 `vite.config.ts` 的 `server.proxy` 键？命中则让给 Vite。
+	*
+	* `proxyMiddleware` 在上游是 **`configureServer` 钩子之后**才 `use()` 的（本插件的 `pre` 走
+	* 钩子体内），因此无扩展名的代理路径会被 `pre` 先吃掉 —— `isViteResourceRequest` 不认识
+	* proxy 键，`/probe-proxy` 这种路径最终返回 ubean 的 404 而不是被代理。`/api/**` 这类路径
+	* 明明写了 `server.proxy` 也一样，因为保留命名空间判据先命中。
+	*
+	* 前置让给 Vite 与 `routeRules.proxy` 不冲突：Vite 只代理配置里显式写了的键，没写就照旧归 ubean。
+	*/
+	const proxyKeys = Object.keys(server.config.server.proxy ?? {});
+	const isProxyPath = (url) => {
+		if (proxyKeys.length === 0) return false;
+		const pathname = url.split("?")[0].split("#")[0];
+		return proxyKeys.some((key) => {
+			const pattern = key.startsWith("^") ? new RegExp(key) : null;
+			return pattern ? pattern.test(pathname) : pathname.startsWith(key);
+		});
+	};
 	const pre = (req, res, next) => {
-		if (isPassThrough(req.url || "/") || isViteResourceRequest(req.url || "/", req.headers)) {
+		if (isPassThrough(req.url || "/") || isProxyPath(req.url || "/") || isViteResourceRequest(req.url || "/", req.headers)) {
 			next();
 			return;
 		}
@@ -1176,6 +1214,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,
@@ -1428,6 +1467,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 `${`
@@ -1533,7 +1587,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) {
@@ -1658,11 +1713,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);
@@ -1835,4 +1887,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-MyIMqUw0.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-q7rHFo73.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/build",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "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.4",
-    "@ubean/client": "0.6.4",
-    "@ubean/config": "0.6.4",
-    "@ubean/i18n": "0.6.4",
-    "@ubean/islands": "0.6.4",
-    "@ubean/markdown": "0.6.4",
-    "@ubean/pages": "0.6.4",
-    "@ubean/preset": "0.6.4",
-    "@ubean/routes": "0.6.4",
-    "@ubean/scan": "0.6.4",
-    "@ubean/server": "0.6.4",
-    "@ubean/shared": "0.6.4",
-    "@ubean/vue": "0.6.4",
+    "@intlify/unplugin-vue-i18n": "11.2.7",
+    "@ubean/app": "0.6.6",
+    "@ubean/client": "0.6.6",
+    "@ubean/config": "0.6.6",
+    "@ubean/i18n": "0.6.6",
+    "@ubean/islands": "0.6.6",
+    "@ubean/markdown": "0.6.6",
+    "@ubean/pages": "0.6.6",
+    "@ubean/preset": "0.6.6",
+    "@ubean/routes": "0.6.6",
+    "@ubean/scan": "0.6.6",
+    "@ubean/server": "0.6.6",
+    "@ubean/shared": "0.6.6",
+    "@ubean/vue": "0.6.6",
     "@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.14"
+    "vue-i18n": "11.4.16"
   },
   "devDependencies": {
     "@types/node": "^26.6.5",