@ubean/build 0.4.4 → 0.4.6

package/dist/static-render.js

@@ -0,0 +1,254 @@
+import { resolve } from "pathe";
+import { extractLocaleFromPath } from "@ubean/i18n";
+import { getLogger } from "@ubean/shared/logger";
+import { pathToFileURL } from "node:url";
+//#region src/static-render.ts
+/**
+* 静态 SSG 渲染器（mode: 'ssg' 专用，见 docs/adr/0011-lightweight-ssg-direct-render.md）。
+*
+* 职责：
+* 1. `compilePageRoute` / `matchRoutePattern`：把具象 URL 匹配到页面路由模式
+*    （`[param]` → `:param`、`[...slug]` → `**:slug`、`[[param]]` → `:param?`），
+*    提取路由参数 —— 替代 Hono 的路由匹配层
+* 2. `createStaticSsgRenderer`：加载构建产物中的静态 entry（renderStaticPage），
+*    暴露与 `prerender()` 的 fetcher 同构的契约，绕过 Hono 请求管道
+*/
+const logger = getLogger("build");
+/** 哨兵路由：prerender 队列中的 404 页标记，产物映射为 `404.html` */
+const STATIC_NOT_FOUND_ROUTE = "/__ubean_404__";
+const CATCH_ALL_SEGMENT = /^\*\*:([A-Za-z_][\w-]*)$/;
+/**
+* vue-router 参数段语法（`definePage({ path })` 覆盖时的 route 形态）：
+* - `:param` → 单段
+* - `:param?` → 可选单段
+* - `:param(regex)` → 自定义正则（如 `:id(\\d+)`）
+* - `:param(regex)*` / `:param*` → 可重复（0..n 段，如 `:slug(.*)*` catch-all）
+* - `:param(regex)+` / `:param+` → 可重复（1..n 段）
+*/
+const DYNAMIC_SEGMENT = /^:([A-Za-z_][\w-]*)(\(.+\))?([*+?])?$/;
+function escapeRegExp(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** 归一化 URL path：去尾部斜杠（根路由归一为空串便于匹配） */
+function normalizeUrlPath(path) {
+	if (path === "/" || path === "") return "";
+	let p = path;
+	if (!p.startsWith("/")) p = `/${p}`;
+	while (p.length > 1 && p.endsWith("/")) p = p.slice(0, -1);
+	return p;
+}
+/**
+* 编译页面路由模式为正则。
+*
+* 输入 `page.route` 两种形态：
+* 1. scan 产物默认语法（route-path.ts）：
+*    - `/about`（静态）
+*    - `/blog/:slug`（动态）
+*    - `/docs/**:path`（catch-all，匹配剩余全部段，也匹配模式自身）
+*    - `/users/:id?`（可选段）
+* 2. `definePage({ path })` 覆盖的 vue-router 语法：
+*    - `/blog/:slug(.*)*`（自定义正则 + 可重复 = catch-all）
+*    - `/users/:id(\\d+)`（自定义正则）
+*/
+function compilePageRoute(page) {
+	const segments = normalizeUrlPath(page.route).split("/").filter(Boolean);
+	let source = "^";
+	const paramNames = [];
+	let isCatchAll = false;
+	let staticSegments = 0;
+	for (const seg of segments) {
+		const catchAll = CATCH_ALL_SEGMENT.exec(seg);
+		if (catchAll) {
+			paramNames.push(catchAll[1]);
+			isCatchAll = true;
+			source += "(?:/(.+))?";
+			continue;
+		}
+		const dynamic = DYNAMIC_SEGMENT.exec(seg);
+		if (dynamic) {
+			const [, name, custom, modifier] = dynamic;
+			paramNames.push(name);
+			const inner = custom ? custom.slice(1, -1) : "[^/]+";
+			if (modifier === "*" || modifier === "+") {
+				isCatchAll = true;
+				source += modifier === "*" ? `(?:/(${inner}(?:/${inner})*))?` : `/(${inner}(?:/${inner})*)`;
+			} else if (modifier === "?") source += `(?:/(${inner}))?`;
+			else source += `/(${inner})`;
+			continue;
+		}
+		staticSegments++;
+		source += `/${escapeRegExp(seg)}`;
+	}
+	source += "/?$";
+	return {
+		page,
+		regex: new RegExp(source),
+		paramNames,
+		isCatchAll,
+		staticSegments
+	};
+}
+/**
+* 将具象 URL path 匹配到页面路由模式，返回命中的页面与提取的参数。
+*
+* 匹配顺序（确定性）：静态段多者优先 → catch-all 最后 → 同分保持传入顺序。
+* 参数值经 `decodeURIComponent` 解码（对齐 Hono `c.req.param()` 行为）。
+*/
+function matchRoutePattern(pages, path) {
+	const ordered = pages.map((p) => "regex" in p ? p : compilePageRoute(p)).map((c, i) => ({
+		c,
+		i
+	})).sort((a, b) => Number(a.c.isCatchAll) - Number(b.c.isCatchAll) || b.c.staticSegments - a.c.staticSegments || a.i - b.i).map(({ c }) => c);
+	const target = normalizeUrlPath(path);
+	for (const c of ordered) {
+		const m = c.regex.exec(target);
+		if (!m) continue;
+		const params = {};
+		c.paramNames.forEach((name, idx) => {
+			const raw = m[idx + 1];
+			if (raw === void 0) return;
+			try {
+				params[name] = decodeURIComponent(raw);
+			} catch {
+				params[name] = raw;
+			}
+		});
+		return {
+			page: c.page,
+			params
+		};
+	}
+	return null;
+}
+function dedupeRoutes(routes) {
+	return [...new Set(routes)];
+}
+/**
+* 按路由策略将收集到的路由展开为全语言 URL 列表。
+*
+* | strategy | 展开规则 |
+* | --- | --- |
+* | `no_prefix` | 不展开（每 route 渲染 1 次） |
+* | `prefix_except_default` | default 无前缀 + 其余 locale 带前缀 |
+* | `prefix` | 全部 locale 带前缀（无前缀版本不生成——fetcher 对其 404） |
+* | `prefix_and_default` | 全部 locale 带前缀 + default 额外无前缀版本 |
+*
+* 特殊输入：
+* - 404 哨兵路由不展开（静态托管平台仅认单份 `404.html`）
+* - 已带 locale 前缀的 URL（crawlLinks 发现）保持原样，避免 `/zh/zh/about`
+*/
+function expandRoutesForLocales(routes, i18n) {
+	const i18nEnabled = i18n != null && i18n.enabled !== false;
+	const localeCodes = i18nEnabled ? (i18n.locales || []).map((l) => typeof l === "string" ? l : l.code) : [];
+	if (!i18nEnabled || localeCodes.length === 0) return dedupeRoutes(routes);
+	const strategy = i18n.strategy || "prefix_except_default";
+	if (strategy === "no_prefix") return dedupeRoutes(routes);
+	const defaultLocale = i18n.defaultLocale || localeCodes[0] || "";
+	const expanded = [];
+	for (const route of routes) {
+		if (route === "/__ubean_404__") {
+			expanded.push(route);
+			continue;
+		}
+		const { locale } = extractLocaleFromPath(route, localeCodes);
+		if (locale) {
+			expanded.push(route);
+			continue;
+		}
+		const suffix = route === "/" || route === "" ? "" : route;
+		switch (strategy) {
+			case "prefix":
+				for (const code of localeCodes) expanded.push(`/${code}${suffix}`);
+				break;
+			case "prefix_and_default":
+				expanded.push(route || "/");
+				for (const code of localeCodes) expanded.push(`/${code}${suffix}`);
+				break;
+			default:
+				expanded.push(route || "/");
+				for (const code of localeCodes) {
+					if (code === defaultLocale) continue;
+					expanded.push(`/${code}${suffix}`);
+				}
+		}
+	}
+	return dedupeRoutes(expanded);
+}
+/**
+* 加载构建产物中的静态 entry（`dist/server/entry.mjs`），返回静态渲染器。
+*
+* 失败（entry 缺失 / 无 renderStaticPage 导出 / 加载异常）返回 `undefined`，
+* 由调用方降级（warn + placeholder prerender）。
+*/
+async function createStaticSsgRenderer(cwd, manifest, init) {
+	let mod;
+	try {
+		const entryPath = resolve(cwd, manifest.serverDir, "entry.mjs");
+		mod = await import(pathToFileURL(entryPath).href);
+	} catch (err) {
+		logger.warn(`Failed to load static SSG entry: ${err instanceof Error ? err.message : String(err)}. Falling back.`);
+		return;
+	}
+	if (typeof mod.renderStaticPage !== "function") {
+		logger.warn("Static SSG entry does not export renderStaticPage; falling back.");
+		return;
+	}
+	const renderStaticPage = mod.renderStaticPage;
+	const compiled = init.pages.map(compilePageRoute);
+	const i18nEnabled = init.i18n != null && init.i18n.enabled !== false;
+	const localeCodes = i18nEnabled ? (init.i18n?.locales || []).map((l) => typeof l === "string" ? l : l.code) : [];
+	const strategy = i18nEnabled ? init.i18n?.strategy || "prefix_except_default" : "no_prefix";
+	const defaultLocale = i18nEnabled && init.i18n?.defaultLocale || "";
+	const usePrefix = i18nEnabled && localeCodes.length > 0 && strategy !== "no_prefix";
+	return {
+		renderStaticPage,
+		expandRoutes: (routes) => expandRoutesForLocales(routes, {
+			enabled: i18nEnabled,
+			strategy,
+			defaultLocale,
+			locales: localeCodes
+		}),
+		fetcher: async (url) => {
+			const u = new URL(url, "http://ubean.local");
+			const pathname = u.pathname;
+			const search = u.search;
+			if (pathname === "/__ubean_404__") {
+				if (!init.notFoundPage) return {
+					html: "",
+					statusCode: 404
+				};
+				return renderStaticPage({
+					pageName: "NotFound",
+					params: {},
+					url: `/404${search}`,
+					locale: defaultLocale
+				});
+			}
+			let pathToMatch = pathname;
+			let locale = defaultLocale;
+			if (usePrefix) {
+				const { locale: extracted, pathWithoutLocale } = extractLocaleFromPath(pathname, localeCodes);
+				if (extracted) {
+					locale = extracted;
+					pathToMatch = pathWithoutLocale;
+				} else if (strategy === "prefix") return {
+					html: "",
+					statusCode: 404
+				};
+			}
+			const match = matchRoutePattern(compiled, pathToMatch);
+			if (!match) return {
+				html: "",
+				statusCode: 404
+			};
+			return renderStaticPage({
+				pageName: match.page.name,
+				params: match.params,
+				url: `${pathname}${search}`,
+				locale
+			});
+		}
+	};
+}
+//#endregion
+export { STATIC_NOT_FOUND_ROUTE, compilePageRoute, createStaticSsgRenderer, expandRoutesForLocales, matchRoutePattern };

package/dist/vite.d.ts

@@ -1,7 +1,7 @@
 import { ResolvedConfig } from "@ubean/config";
 import { Plugin } from "vite";
 //#region src/vite.d.ts
-interface UbeanPluginOptions {
+export interface UbeanPluginOptions {
   /**
    * 已解析的 ubean 配置。如果未提供,插件会按以下顺序获取:
    * 1. 尝试从全局缓存读取(`loadUbeanConfig` 已被 CLI 调用时会有缓存)
@@ -36,6 +36,5 @@ interface UbeanPluginOptions {
  * ubeanPlugin({ config: resolvedConfig })
  * ```
  */
-declare function ubeanPlugin(options?: UbeanPluginOptions): Plugin;
-//#endregion
-export { UbeanPluginOptions, ubeanPlugin };
+export declare function ubeanPlugin(options?: UbeanPluginOptions): Plugin;
+//#endregion

package/dist/{vue-DzQKpjU3.js → vue-DcydGsvy.js}

@@ -1,6 +1,6 @@
 import { a as useVirtualRegistry, n as defineVirtualModule } from "./virtual-registry-BWkaQHXN.js";
 import { c as getCssImports, i as ssrSingletonDevPolicy, s as getComponentResolvers } from "./ssr-singleton-CEQi_H6-.js";
-import { E as toArray, T as resolveComponentsConfig, b as getAutoImportPresets, w as resolveAutoImportsConfig } from "./codegen-BqqGw4Dv.js";
+import { E as toArray, T as resolveComponentsConfig, b as getAutoImportPresets, w as resolveAutoImportsConfig } from "./codegen-B3oGeRtK.js";
 import { createRequire } from "node:module";
 import { join, resolve } from "pathe";
 import { scanProject } from "@ubean/scan";
@@ -162,15 +162,17 @@ function _mergeAppConfig(base, ...configs) {
   for (const cfg of [base, ...configs]) {
     if (cfg?.router?.setup) setups.push(cfg.router.setup);
   }
-  if (setups.length === 1) {
-    result.router = { setup: setups[0] };
-  } else if (setups.length > 1) {
-    result.router = {
-      setup: (router) => {
-        for (const s of setups) s(router);
-      }
-    };
+  // scrollBehavior 为函数不可合并,后者覆盖(shared 之后定义的 client/server 生效)。
+  let scrollBehavior;
+  for (const cfg of [base, ...configs]) {
+    if (cfg?.router?.scrollBehavior !== undefined) scrollBehavior = cfg.router.scrollBehavior;
+  }
+  const router = {};
+  if (setups.length > 0) {
+    router.setup = setups.length === 1 ? setups[0] : (r) => { for (const s of setups) s(r); };
   }
+  if (scrollBehavior !== undefined) router.scrollBehavior = scrollBehavior;
+  if (setups.length > 0 || scrollBehavior !== undefined) result.router = router;
   return result;
 }
 
@@ -233,7 +235,7 @@ export async function createApp() {
     viewTransitions: config.viewTransitions,
     initialPage: initialPage || undefined,
     hydrate: !!initialPage,
-    routerSetup: config.router?.setup,
+    router: config.router,
     loadingComponent,
     errorComponent,
     // appRoot 已在 resolveAppConfig 中合并(src/App.vue 默认 + defineApp 显式覆盖)
@@ -318,7 +320,7 @@ export async function createSSRApp(initialPage) {
     resolveLayoutComponent,
     defaultLayout,
     head,
-    routerSetup: config.router?.setup,
+    router: config.router,
     loadingComponent,
     errorComponent,
     // appRoot 已在 resolveAppConfig 中合并(src/App.vue 默认 + defineApp 显式覆盖),
@@ -628,7 +630,8 @@ function ubeanVite(options) {
 	const UBEAN_BUILTIN_COMPONENTS = [
 		"Link",
 		"Head",
-		"PageView"
+		"PageView",
+		"ClientOnly"
 	];
 	function ubeanComponentsResolver(componentName) {
 		if (UBEAN_BUILTIN_COMPONENTS.includes(componentName)) return {

package/dist/vue.d.ts

@@ -7,8 +7,8 @@ interface UbeanViteOptions {
   config: ResolvedConfig;
   ssr?: boolean;
 }
-declare const VUE_PLUGIN_INCLUDE: RegExp[];
-declare function ubeanVite(options: UbeanViteOptions): Plugin[];
+export declare const VUE_PLUGIN_INCLUDE: RegExp[];
+export declare function ubeanVite(options: UbeanViteOptions): Plugin[];
 //#endregion
 //#region src/vue-virtual-modules.d.ts
 /**
@@ -21,9 +21,9 @@ declare function ubeanVite(options: UbeanViteOptions): Plugin[];
  * `requiresAuth` / `head` / `definePage({ meta })` 透传字段(超集,
  * 使 `createMatcherGuard()` 与 SPA head guard 在框架模式下同样可用)。
  */
-declare function createVuePagesVirtualModule(pages: ScannedPageRoute[], layouts: ScannedLayout[], notFoundPage?: ScannedPageRoute, loadingPage?: ScannedPageRoute, errorPage?: ScannedPageRoute, localeVueParam?: string): VirtualModule;
-declare function createVueAppEntryVirtualModule(appEntry?: ScannedAppEntry): VirtualModule;
-declare function createClientEntryVirtualModule(): VirtualModule;
-declare function createServerEntryVirtualModule(serverEntry?: ScannedServerEntry): VirtualModule;
+export declare function createVuePagesVirtualModule(pages: ScannedPageRoute[], layouts: ScannedLayout[], notFoundPage?: ScannedPageRoute, loadingPage?: ScannedPageRoute, errorPage?: ScannedPageRoute, localeVueParam?: string): VirtualModule;
+export declare function createVueAppEntryVirtualModule(appEntry?: ScannedAppEntry): VirtualModule;
+export declare function createClientEntryVirtualModule(): VirtualModule;
+export declare function createServerEntryVirtualModule(serverEntry?: ScannedServerEntry): VirtualModule;
 //#endregion
-export { type UbeanViteOptions, VUE_PLUGIN_INCLUDE, createClientEntryVirtualModule, createServerEntryVirtualModule, createVueAppEntryVirtualModule, createVuePagesVirtualModule, ubeanVite as default, ubeanVite };
+export { type UbeanViteOptions, ubeanVite as default };

package/dist/vue.js

@@ -1,2 +1,2 @@
-import { a as createVueAppEntryVirtualModule, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, t as VUE_PLUGIN_INCLUDE } from "./vue-DzQKpjU3.js";
+import { a as createVueAppEntryVirtualModule, i as createServerEntryVirtualModule, n as ubeanVite, o as createVuePagesVirtualModule, r as createClientEntryVirtualModule, t as VUE_PLUGIN_INCLUDE } from "./vue-DcydGsvy.js";
 export { VUE_PLUGIN_INCLUDE, createClientEntryVirtualModule, createServerEntryVirtualModule, createVueAppEntryVirtualModule, createVuePagesVirtualModule, ubeanVite as default, ubeanVite };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/build",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Vite plugins, production build, SSG prerender, type codegen, and Server Actions plugin for ubean",
   "files": [
     "dist"
@@ -30,6 +30,10 @@
       "types": "./dist/prerender.d.ts",
       "import": "./dist/prerender.js"
     },
+    "./static-render": {
+      "types": "./dist/static-render.d.ts",
+      "import": "./dist/static-render.js"
+    },
     "./codegen": {
       "types": "./dist/codegen/index.d.ts",
       "import": "./dist/codegen/index.js"
@@ -41,17 +45,17 @@
   },
   "dependencies": {
     "@intlify/unplugin-vue-i18n": "11.2.5",
-    "@ubean/client": "0.4.4",
-    "@ubean/config": "0.4.4",
-    "@ubean/i18n": "0.4.4",
-    "@ubean/islands": "0.4.4",
-    "@ubean/markdown": "0.4.4",
-    "@ubean/pages": "0.4.4",
-    "@ubean/preset": "0.4.4",
-    "@ubean/routes": "0.4.4",
-    "@ubean/scan": "0.4.4",
-    "@ubean/shared": "0.4.4",
-    "@ubean/vue": "0.4.4",
+    "@ubean/client": "0.4.6",
+    "@ubean/config": "0.4.6",
+    "@ubean/i18n": "0.4.6",
+    "@ubean/islands": "0.4.6",
+    "@ubean/markdown": "0.4.6",
+    "@ubean/pages": "0.4.6",
+    "@ubean/preset": "0.4.6",
+    "@ubean/routes": "0.4.6",
+    "@ubean/scan": "0.4.6",
+    "@ubean/shared": "0.4.6",
+    "@ubean/vue": "0.4.6",
     "@vitejs/plugin-vue": "^6.0.8",
     "openapi-typescript": "^7.13.0",
     "pathe": "^2.0.3",
@@ -65,12 +69,12 @@
   "devDependencies": {
     "@types/node": "^26.5.0",
     "hono": "4.13.7",
-    "typescript": "7.0.2",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
-    "vite-plus": "0.3.0"
+    "typescript": "npm:typescript-native-bridge@latest",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",
+    "vite-plus": "0.3.1"
   },
   "peerDependencies": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1"
   },
   "peerDependenciesMeta": {
     "vite": {