@ubean/build 0.4.4 → 0.4.6

package/dist/production.js

@@ -2,7 +2,7 @@ import { a as useVirtualRegistry } from "./virtual-registry-BWkaQHXN.js";
 import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, t as createAppVirtualModule } from "./virtual-modules-vLkLkAfT.js";
 import { a as ssrSingletonProdOptimizeExclude, o as ssrSingletonProdSsr } from "./ssr-singleton-CEQi_H6-.js";
 import { n as localeVueParamFromI18n, r as serializeI18nConfig, t as ubeanPlugin } from "./vite-D2EZl_6P.js";
-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";
 import { join, relative, resolve } from "pathe";
 import { resolveModules } from "@ubean/config";
 import { build } from "vite";
@@ -14,6 +14,282 @@ import { ubeanIslandsPlugin } from "@ubean/islands/vite";
 import { isEphemeralCachePreset, resolveProductionCacheStore } from "@ubean/preset";
 import { getLogger } from "@ubean/shared/logger";
 import { findUserViteConfig } from "@ubean/shared/node";
+//#region src/ssg-entry.ts
+/**
+* 生成 renderer setup 代码块（`_rendererRoutes` + `_pageRenderer`）。
+*
+* 依赖外层已定义：`_pages` / `_layouts` / `pageLoaders` / `layoutLoaders` /
+* （notFoundCatchAll 时）`_notFoundPage`，以及 `toVueRouterLocalePath` 导入。
+* ssrEnabled=false 时 `_pageRenderer = null`（与 fullstack 现状一致）。
+*/
+function buildRendererSetup(options) {
+	const { ssrEnabled, mode, localeVueParam, notFoundCatchAll } = options;
+	if (!ssrEnabled) return `
+// --- SSR disabled (mode=${mode}) ---
+// pageRenderer is null; page requests fall back to a client-only HTML shell.
+const _pageRenderer = null;`;
+	return `
+// --- SSR renderer setup ---
+const _defaultLayout = _layouts.find(l => l.isDefault)?.name || null;
+
+// Same i18n locale param as the client virtual:ubean-pages route table, so
+// language-prefixed URLs (e.g. /zh/playground) match the real page on SSR too.
+const _localeVueParam = ${JSON.stringify(localeVueParam)};
+
+const _rendererRoutes = _pages.map(p => {
+  // For reuse routes, load the target page's module (the .reuse.ts file
+  // only contains definePage metadata, not a Vue component).
+  const _targetPage = p.isReuse && p.reuseTarget ? _pages.find(tp => tp.name === p.reuseTarget) : undefined;
+  const _loaderKey = _targetPage?.relativePath || p.relativePath;
+  return {
+    path: _localeVueParam
+      ? toVueRouterLocalePath(p.route.replace(/\\*\\*:(\\w[\\w-]*)/g, ':$1(.*)*'), _localeVueParam)
+      : p.route.replace(/\\*\\*:(\\w[\\w-]*)/g, ':$1(.*)*'),
+    name: p.name,
+    component: async () => {
+      const loader = pageLoaders[_loaderKey];
+      if (!loader) throw new Error('Page loader not found: ' + _loaderKey);
+      const mod = await loader();
+      return mod.default || mod;
+    },
+    meta: {
+      layout: p.layout === false ? false : p.layout || _defaultLayout,
+      pageName: p.name,
+      cache: p.cache === true ? true : undefined
+    }
+  };
+});${notFoundCatchAll ? `
+
+// 404 渲染路由：注册为静态路径 /404（而非客户端的 /:pathMatch(.*)* catch-all）。
+// vue-router 中静态段确定性优先于 repeatable 参数 —— 即使应用存在根 catch-all
+// 页面（如 [...slug].vue），/404 也稳定命中本路由，保证 404.html 产物
+// 渲染的是 pages/404.vue 而非被 catch-all 抢占。
+if (_notFoundPage) {
+  const _nfLoaderKey = _notFoundPage.relativePath;
+  _rendererRoutes.push({
+    path: _localeVueParam
+      ? toVueRouterLocalePath('/404', _localeVueParam)
+      : '/404',
+    name: 'NotFound',
+    component: async () => {
+      const loader = pageLoaders[_nfLoaderKey];
+      if (!loader) throw new Error('Page loader not found: ' + _nfLoaderKey);
+      const mod = await loader();
+      return mod.default || mod;
+    },
+    meta: { pageName: 'NotFound' }
+  });
+}` : ""}
+
+const _layoutMap = new Map();
+for (const l of _layouts) {
+  _layoutMap.set(l.name, l.relativePath);
+}
+
+const _pageRenderer = createVueRenderer({
+  routes: _rendererRoutes,
+  async resolveLayoutComponent(name) {
+    if (name === false || name == null) return null;
+    const relPath = _layoutMap.get(name);
+    if (!relPath) return null;
+    const loader = layoutLoaders[relPath];
+    if (!loader) return null;
+    const mod = await loader();
+    return mod.default || mod;
+  },
+  defaultLayout: _defaultLayout,
+  resolveAppConfig: () => _resolveAppConfig('server')
+});
+`;
+}
+/**
+* 生成 client asset tags 代码块（读取 `.vite/manifest.json`）。
+* 依赖外层已定义 `readFileSync` / `join` / `dirname` / `fileURLToPath` 导入。
+*/
+function buildAssetTagsSetup(favicon) {
+	return `
+// --- Client asset tags from Vite manifest ---
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let _assetTags = { css: '', preloads: '', body: '', favicon: ${JSON.stringify(favicon)} };
+try {
+  const manifestPath = join(__dirname, '..', 'public', '.vite', 'manifest.json');
+  const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+  const entry = Object.values(manifest).find(m => m.isEntry);
+  if (entry) {
+    _assetTags.body = '<script type="module" src="/' + entry.file + '"><\/script>';
+    if (Array.isArray(entry.css)) {
+      _assetTags.css = entry.css.map(c => '<link rel="stylesheet" href="/' + c + '">').join('\\n');
+    }
+  }
+} catch (e) {
+  console.warn('[ubean] Failed to load client manifest:', e.message || e);
+}
+`;
+}
+/**
+* 生成静态 SSG entry 源码（写入 virtualDir/server-entry.mjs，由 SSR build
+* 产出 dist/server/entry.mjs）。
+*
+* 导出契约：
+* - `renderStaticPage({ pageName, params, url, locale }) → { html, statusCode }`
+* - `pageLoaders`（调试用）
+*/
+function buildStaticSsgEntry(input) {
+	const { pagesGlob, layoutsGlob, srcPrefix, pagesJson, layoutsJson, notFoundPageJson, localeVueParam, contentBootstrap, colorModeScript, favicon } = input;
+	return `// Auto-generated ubean static SSG entry (mode: ssg)
+import { renderPage } from '@ubean/pages';
+import { createVueRenderer } from 'ubean/ssr';
+import { toVueRouterLocalePath } from '@ubean/i18n';
+import { i18nConfig as _i18nConfig, loadLocales as _loadLocales } from 'ubean:locales';
+import { resolveAppConfig as _resolveAppConfig } from 'virtual:ubean-app';
+${contentBootstrap}
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const pageModules = import.meta.glob(${pagesGlob}, { eager: false });
+const layoutModules = import.meta.glob(${layoutsGlob}, { eager: false });
+
+const _srcPrefix = ${srcPrefix};
+function normalizeKey(p) {
+  const prefixes = ['/pages/', '/layouts/'];
+  for (const prefix of prefixes) {
+    const fullPrefix = _srcPrefix + prefix;
+    if (p.includes(fullPrefix)) {
+      const idx = p.indexOf(fullPrefix);
+      return p.slice(idx + fullPrefix.length);
+    }
+  }
+  return p;
+}
+
+export const pageLoaders = {};
+for (const [key, loader] of Object.entries(pageModules)) {
+  pageLoaders[normalizeKey(key)] = loader;
+}
+
+const layoutLoaders = {};
+for (const [key, loader] of Object.entries(layoutModules)) {
+  layoutLoaders[normalizeKey(key)] = loader;
+}
+
+const _pages = ${pagesJson};
+const _layouts = ${layoutsJson};
+const _notFoundPage = ${notFoundPageJson};
+const _hasDefaultLayout = _layouts.some(l => l.isDefault);
+${buildRendererSetup({
+		ssrEnabled: true,
+		mode: "ssg",
+		localeVueParam,
+		notFoundCatchAll: true
+	})}
+${buildAssetTagsSetup(favicon)}
+const _colorModeScript = ${JSON.stringify(colorModeScript)};
+
+// --- i18n ---
+const _i18nEnabled = _i18nConfig && _i18nConfig.enabled !== false;
+const _localeCodes = _i18nEnabled
+  ? (_i18nConfig.locales || []).map(l => (typeof l === 'string' ? l : l.code))
+  : [];
+const _defaultLocale = (_i18nEnabled && _i18nConfig.defaultLocale) || '';
+let _localesReady = false;
+
+async function _ensureLocales() {
+  if (_localesReady) return;
+  _localesReady = true;
+  if (!_i18nEnabled || _localeCodes.length === 0) return;
+  try {
+    await _loadLocales();
+  } catch (e) {
+    console.warn('[ubean-ssg] Failed to load locales:', (e && e.message) || e);
+  }
+}
+
+// 静态模式不执行 loader —— 检测到页面导出 loader 时警告一次（每页）
+const _loaderWarned = new Set();
+
+/**
+ * 渲染单个静态页面（由 createStaticSsgRenderer 调用）。
+ *
+ * @param input.pageName 目标页面名（ScannedPageRoute.name）或 'NotFound'
+ * @param input.params   路由参数（matchRoutePattern 提取）
+ * @param input.url      完整 URL path（含 locale 前缀与 query）
+ * @param input.locale   渲染语言（prefix 策略下已从 URL 提取）
+ */
+export async function renderStaticPage(input) {
+  const pageName = input && input.pageName;
+  const page = pageName === 'NotFound' ? _notFoundPage : _pages.find(p => p.name === pageName);
+  if (!page) return { html: '', statusCode: 404 };
+
+  await _ensureLocales();
+
+  // loader 检测 warn（模块加载有缓存，此处与渲染共用同一实例）
+  const _targetPage =
+    page.isReuse && page.reuseTarget ? _pages.find(tp => tp.name === page.reuseTarget) : undefined;
+  const _loaderKey = (_targetPage && _targetPage.relativePath) || page.relativePath;
+  const _modLoader = pageLoaders[_loaderKey];
+  if (_modLoader && !_loaderWarned.has(page.name)) {
+    try {
+      const mod = await _modLoader();
+      if (mod && typeof mod.loader === 'function') {
+        _loaderWarned.add(page.name);
+        console.warn(
+          '[ubean-ssg] page "' + page.name + '" exports \`loader\`, which is not executed in static SSG mode'
+        );
+      }
+    } catch {}
+  }
+
+  // renderContext 构造与 routes/router.ts 的页面渲染路径保持一致
+  const renderContext = {};
+  const locale = (input && input.locale) || _defaultLocale;
+  if (_i18nEnabled && locale) {
+    renderContext.locale = locale;
+    renderContext.localeDir = 'ltr';
+    renderContext.routing = {
+      defaultLocale: _i18nConfig.defaultLocale || 'en',
+      locales: _localeCodes,
+      strategy: _i18nConfig.strategy || 'prefix_except_default'
+    };
+    const cookieName =
+      _i18nConfig.detectBrowserLanguage && _i18nConfig.detectBrowserLanguage.cookieName;
+    if (cookieName) renderContext.cookieName = cookieName;
+    if (_i18nConfig.baseUrl) renderContext.baseUrl = _i18nConfig.baseUrl;
+    try {
+      const i18nMod = await import('ubean/i18n');
+      renderContext.localeDir = i18nMod.getLocaleDir(locale);
+      renderContext.messages = i18nMod.getLocaleMessages(locale);
+      const fallback = i18nMod.getFallbackLocale();
+      renderContext.fallbackLocale = fallback;
+      if (fallback !== locale) {
+        renderContext.fallbackMessages = i18nMod.getLocaleMessages(fallback);
+      }
+      renderContext.availableLocales = i18nMod.getRegisteredLocalesMeta();
+    } catch {}
+  }
+
+  // pageObj 构造与 routes/router.ts handlePageRequest 保持一致
+  const pageObj = {
+    component: page.reuseTarget || page.name,
+    props: {},
+    params: (input && input.params) || {},
+    url: (input && input.url) || '/',
+    layout: page.layout === false
+      ? false
+      : page.layout || (page.pageMeta && page.pageMeta.layout) || (_hasDefaultLayout ? 'default' : false),
+    errors: null,
+    head: page.pageMeta && page.pageMeta.head
+  };
+
+  let html = await renderPage(pageObj, _assetTags, _pageRenderer, 'app', renderContext);
+  if (_colorModeScript) {
+    html = html.replace('<head>', '<head>\\n    ' + _colorModeScript);
+  }
+  return { html, statusCode: 200 };
+}
+`;
+}
+//#endregion
 //#region src/production.ts
 const logger = getLogger("build");
 function getOutDirs(cwd, outputDir) {
@@ -134,61 +410,12 @@ async function generateVirtualModulesToDisk(cwd, config, scanResult, virtualDir,
 	const colorModeScript = config.colorMode !== false ? getColorModeScript(resolveColorModeConfig(config.colorMode)) : "";
 	const rendererImport = ssrEnabled ? `import { createVueRenderer } from 'ubean/ssr';` : "";
 	const prodLocaleVueParam = localeVueParamFromI18n(config.i18n) || "";
-	const rendererSetup = ssrEnabled ? `
-// --- SSR renderer setup ---
-const _defaultLayout = _layouts.find(l => l.isDefault)?.name || null;
-
-// Same i18n locale param as the client virtual:ubean-pages route table, so
-// language-prefixed URLs (e.g. /zh/playground) match the real page on SSR too.
-const _localeVueParam = ${JSON.stringify(prodLocaleVueParam)};
-
-const _rendererRoutes = _pages.map(p => {
-  // For reuse routes, load the target page's module (the .reuse.ts file
-  // only contains definePage metadata, not a Vue component).
-  const _targetPage = p.isReuse && p.reuseTarget ? _pages.find(tp => tp.name === p.reuseTarget) : undefined;
-  const _loaderKey = _targetPage?.relativePath || p.relativePath;
-  return {
-    path: _localeVueParam
-      ? toVueRouterLocalePath(p.route.replace(/\\*\\*:(\\w[\\w-]*)/g, ':$1(.*)*'), _localeVueParam)
-      : p.route.replace(/\\*\\*:(\\w[\\w-]*)/g, ':$1(.*)*'),
-    name: p.name,
-    component: async () => {
-      const loader = pageLoaders[_loaderKey];
-      if (!loader) throw new Error('Page loader not found: ' + _loaderKey);
-      const mod = await loader();
-      return mod.default || mod;
-    },
-    meta: {
-      layout: p.layout === false ? false : p.layout || _defaultLayout,
-      pageName: p.name,
-      cache: p.cache === true ? true : undefined
-    }
-  };
-});
-
-const _layoutMap = new Map();
-for (const l of _layouts) {
-  _layoutMap.set(l.name, l.relativePath);
-}
-
-const _pageRenderer = createVueRenderer({
-  routes: _rendererRoutes,
-  async resolveLayoutComponent(name) {
-    if (name === false || name == null) return null;
-    const relPath = _layoutMap.get(name);
-    if (!relPath) return null;
-    const loader = layoutLoaders[relPath];
-    if (!loader) return null;
-    const mod = await loader();
-    return mod.default || mod;
-  },
-  defaultLayout: _defaultLayout,
-  resolveAppConfig: () => _resolveAppConfig('server')
-});
-` : `
-// --- SSR disabled (mode=${mode}, ssr=${config.ssr.enabled}) ---
-// pageRenderer is null; page requests fall back to a client-only HTML shell.
-const _pageRenderer = null;`;
+	const rendererSetup = buildRendererSetup({
+		ssrEnabled,
+		mode,
+		localeVueParam: prodLocaleVueParam
+	});
+	const assetTagsSetup = buildAssetTagsSetup(config.favicon);
 	const productionCache = resolveProductionCacheStore(preset.name || "standard", config.cache);
 	const contentEntries = Object.entries(contentSnapshot ?? {}).filter(([, docs]) => Array.isArray(docs));
 	const contentBootstrap = contentEntries.length > 0 ? `
@@ -201,6 +428,22 @@ ${contentEntries.map(([name, docs]) => `registerContent(${JSON.stringify(name)},
 	const cronImport = enableInProcessCron ? `import { startCronScheduler } from '@ubean/server/cron';
 ` : "";
 	if (hasServer) {
+		if (mode === "ssg") {
+			const staticEntry = buildStaticSsgEntry({
+				pagesGlob,
+				layoutsGlob,
+				srcPrefix: JSON.stringify(viteSrcPrefix),
+				pagesJson,
+				layoutsJson,
+				notFoundPageJson,
+				localeVueParam: prodLocaleVueParam,
+				contentBootstrap,
+				colorModeScript,
+				favicon: config.favicon
+			});
+			await writeFile(join(virtualDir, "server-entry.mjs"), staticEntry, "utf-8");
+			return virtualDir;
+		}
 		const serverEntry = `// Auto-generated server entry
 import { createUbeanApp, applyServerConfig } from 'ubean/server';
 import { toVueRouterLocalePath } from '@ubean/i18n';
@@ -260,22 +503,7 @@ const _pages = ${pagesJson};
 const _layouts = ${layoutsJson};
 const _notFoundPage = ${notFoundPageJson};
 ${rendererSetup}
-// --- Client asset tags from Vite manifest ---
-const __dirname = dirname(fileURLToPath(import.meta.url));
-let _assetTags = { css: '', preloads: '', body: '', favicon: ${JSON.stringify(config.favicon)} };
-try {
-  const manifestPath = join(__dirname, '..', 'public', '.vite', 'manifest.json');
-  const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
-  const entry = Object.values(manifest).find(m => m.isEntry);
-  if (entry) {
-    _assetTags.body = '<script type="module" src="/' + entry.file + '"><\/script>';
-    if (Array.isArray(entry.css)) {
-      _assetTags.css = entry.css.map(c => '<link rel="stylesheet" href="/' + c + '">').join('\\n');
-    }
-  }
-} catch (e) {
-  console.warn('[ubean] Failed to load client manifest:', e.message || e);
-}
+${assetTagsSetup}
 
 export async function createApp(options = {}) {
   const app = createUbeanApp({
@@ -625,7 +853,8 @@ async function buildProduction(options) {
 			resolve: commonResolve
 		});
 		serverEntry = "entry.mjs";
-		if (presetBuildConfig.entryType === "node") {
+		if (mode === "ssg") logger.info("SSG mode: skipping preset server wrapper (static output only)");
+		else if (presetBuildConfig.entryType === "node") {
 			await writeFile(join(outDirs.server, "server.mjs"), generateNodeServerEntry(), "utf-8");
 			serverEntry = "server.mjs";
 			await writeFile(join(outDirs.server, "package.json"), JSON.stringify({

package/dist/static-render.d.ts

@@ -0,0 +1,100 @@
+import { ScannedPageRoute } from "@ubean/scan";
+//#region src/static-render.d.ts
+/** 哨兵路由：prerender 队列中的 404 页标记，产物映射为 `404.html` */
+export declare const STATIC_NOT_FOUND_ROUTE = "/__ubean_404__";
+export interface CompiledPageRoute {
+  page: ScannedPageRoute;
+  regex: RegExp;
+  /** 捕获组顺序对应的参数名 */
+  paramNames: string[];
+  isCatchAll: boolean;
+  /** 静态段数量（特异性排序用） */
+  staticSegments: number;
+}
+/**
+ * 编译页面路由模式为正则。
+ *
+ * 输入 `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+)`（自定义正则）
+ */
+export declare function compilePageRoute(page: ScannedPageRoute): CompiledPageRoute;
+export interface StaticRouteMatch {
+  page: ScannedPageRoute;
+  params: Record<string, string>;
+}
+/**
+ * 将具象 URL path 匹配到页面路由模式，返回命中的页面与提取的参数。
+ *
+ * 匹配顺序（确定性）：静态段多者优先 → catch-all 最后 → 同分保持传入顺序。
+ * 参数值经 `decodeURIComponent` 解码（对齐 Hono `c.req.param()` 行为）。
+ */
+export declare function matchRoutePattern(pages: Array<ScannedPageRoute | CompiledPageRoute>, path: string): StaticRouteMatch | null;
+/**
+ * 按路由策略将收集到的路由展开为全语言 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`
+ */
+export declare function expandRoutesForLocales(routes: string[], i18n: StaticSsgRendererI18nInit): string[];
+export interface StaticSsgRendererI18nInit {
+  enabled?: boolean;
+  strategy?: 'prefix' | 'prefix_except_default' | 'prefix_and_default' | 'no_prefix';
+  defaultLocale?: string;
+  locales?: Array<string | {
+    code: string;
+  }>;
+}
+export interface StaticSsgRendererInit {
+  /** 扫描得到的页面（含动态路由模式，供具象 URL 匹配） */
+  pages: ScannedPageRoute[];
+  /** `pages/404.vue` 自动检测的 404 页（可选） */
+  notFoundPage?: ScannedPageRoute | null;
+  /** i18n 配置（用于 locale 前缀剥离与默认语言） */
+  i18n?: StaticSsgRendererI18nInit;
+}
+export interface RenderStaticPageInput {
+  pageName: string;
+  params: Record<string, string>;
+  url: string;
+  locale?: string;
+}
+export type RenderStaticPageFn = (input: RenderStaticPageInput) => Promise<{
+  html: string;
+  statusCode: number;
+}>;
+export interface StaticSsgRenderer {
+  /** 与 `PrerendererOptions.fetcher` 同构的契约 */
+  fetcher: (url: string) => Promise<{
+    html: string;
+    statusCode: number;
+  }>;
+  /** i18n 多语言展开（按 strategy 生成全语言 URL，供 prerender 入队前应用） */
+  expandRoutes: (routes: string[]) => string[];
+  /** 底层渲染函数（等价性测试 / 调试用） */
+  renderStaticPage: RenderStaticPageFn;
+}
+/**
+ * 加载构建产物中的静态 entry（`dist/server/entry.mjs`），返回静态渲染器。
+ *
+ * 失败（entry 缺失 / 无 renderStaticPage 导出 / 加载异常）返回 `undefined`，
+ * 由调用方降级（warn + placeholder prerender）。
+ */
+export declare function createStaticSsgRenderer(cwd: string, manifest: {
+  serverDir: string;
+}, init: StaticSsgRendererInit): Promise<StaticSsgRenderer | undefined>;
+//#endregion