@ubean/build 0.2.2 → 0.3.1

package/dist/index.d.ts

@@ -1,11 +1,99 @@
-import { VirtualModule, VirtualModuleContext, VirtualModuleRegistry, VirtualModuleTransform, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, registerComponentResolver, registerCssImport, resetModuleRegistry, resetVirtualRegistry, stripMacros, transformMacros, useVirtualRegistry } from "@ubean/build-core";
+import { a as defineVirtualModule, c as useVirtualRegistry, i as VirtualModuleTransform, n as VirtualModuleContext, o as defineVirtualModulePrefix, r as VirtualModuleRegistry, s as resetVirtualRegistry, t as VirtualModule } from "./virtual-registry-BF0jYPle.js";
 import { CompiledLayout, CompiledMiddleware, CompiledPage, CompiledRoute } from "@ubean/routes";
 import { ScannedApiRoute, ScannedLocale, ScannedMiddleware, ScannedPageRoute } from "@ubean/scan";
+//#region src/macros.d.ts
+declare function stripMacros(code: string, macros?: readonly string[]): string;
+declare function transformMacros(code: string, id: string): string | null;
+//#endregion
+//#region src/registry.d.ts
+/**
+ * Module extension registry.
+ *
+ * Allows built-in extension modules (@ubean/integrations, @ubean/icon, etc.) to inject
+ * component resolvers and CSS imports into the core Vite plugin pipeline
+ * without modifying ubeanVite directly.
+ *
+ * Registration happens at module load time (when ubeanUiPlugin() etc. are
+ * called by the module system, before ubeanVite reads the registry).
+ *
+ * Uses globalThis for storage to ensure state is shared across multiple
+ * copies of @ubean/build that may exist due to package manager duplication
+ * (e.g. pnpm creating separate instances for different version ranges).
+ */
+/**
+ * Generic component resolver type compatible with unplugin-vue-components.
+ * Accepts both function resolvers and object resolvers (ComponentResolverObject).
+ */
+type ComponentResolver = ((name: string) => any) | {
+  type: 'component' | 'directive';
+  resolve: (name: string) => any;
+};
+/**
+ * Register a component resolver (e.g. `UiResolver()` from `@soybeanjs/ui/resolver`).
+ * The resolver will be merged into `unplugin-vue-components`'s `resolvers` array.
+ */
+declare function registerComponentResolver(resolver: ComponentResolver): void;
+/**
+ * Get all registered component resolvers.
+ * Called by `ubeanVite` when constructing the `Components()` plugin.
+ */
+declare function getComponentResolvers(): ComponentResolver[];
+/**
+ * Register a CSS import path to be injected into the client entry.
+ * e.g. `registerCssImport('@soybeanjs/ui/styles.css')` makes the client
+ * entry module prepend `import '@soybeanjs/ui/styles.css'`.
+ */
+declare function registerCssImport(cssPath: string): void;
+/**
+ * Get all registered CSS import paths.
+ * Called by `createClientEntryVirtualModule` to prepend CSS imports.
+ */
+declare function getCssImports(): string[];
+/**
+ * Reset the registry (for testing).
+ * @internal
+ */
+declare function resetModuleRegistry(): void;
+//#endregion
+//#region src/ssr-singleton.d.ts
+/**
+ * Single-copy runtime policy for Vite client / SSR graphs.
+ *
+ * `@ubean/i18n` (ALS + catalogs) and `@ubean/client` (locale runtime) must
+ * resolve to one module instance per process. Dev and production use the
+ * same package lists; only the SSR externalization differs:
+ *
+ * - Dev: Vite `ssrLoadModule` and the CLI-created app share Node's
+ *   `@ubean/i18n` (external). `ubean` stays noExternal so virtual ids resolve.
+ * - Prod: `ubean` is bundled (`noExternal`). Do **not** also externalize
+ *   `@ubean/i18n` — that would create a second copy beside the bundle.
+ */
+declare const SSR_SINGLETON_PACKAGES: readonly ["ubean", "@ubean/client", "@ubean/i18n", "vue-i18n", "@intlify/core", "@intlify/core-base"];
+declare const SSR_SINGLETON_DEDUPE: readonly ["vue", "vue-i18n", "@ubean/client", "@ubean/i18n"];
+declare const SSR_SINGLETON_OPTIMIZE_EXCLUDE: readonly ["ubean", "@ubean/client", "@ubean/i18n"];
+declare function ssrSingletonDevPolicy(): {
+  resolve: {
+    dedupe: string[];
+  };
+  optimizeDeps: {
+    exclude: string[];
+    include: string[];
+  };
+  ssr: {
+    noExternal: string[];
+    external: string[];
+  };
+};
+declare function ssrSingletonProdSsr(): {
+  noExternal: string[];
+};
+declare function ssrSingletonProdOptimizeExclude(extra?: string[]): string[];
+//#endregion
 //#region src/virtual-modules.d.ts
-declare function createRoutingVirtualModule(routes: CompiledRoute[], middlewares: CompiledMiddleware[], cwd: string): any;
-declare function createPagesVirtualModule(pages: CompiledPage[], layouts: CompiledLayout[], cwd: string): any;
-declare function createMetaVirtualModule(): any;
-declare function createAppVirtualModule(apiRoutes: ScannedApiRoute[], middlewares: ScannedMiddleware[], pages: ScannedPageRoute[], srcDir: string): any;
-declare function createLocalesVirtualModule(_locales: ScannedLocale[], defaultLocale: string | undefined, srcDir?: string): any;
+declare function createRoutingVirtualModule(routes: CompiledRoute[], middlewares: CompiledMiddleware[], cwd: string): VirtualModule;
+declare function createPagesVirtualModule(pages: CompiledPage[], layouts: CompiledLayout[], cwd: string): VirtualModule;
+declare function createMetaVirtualModule(): VirtualModule;
+declare function createAppVirtualModule(apiRoutes: ScannedApiRoute[], middlewares: ScannedMiddleware[], pages: ScannedPageRoute[], srcDir: string): VirtualModule;
+declare function createLocalesVirtualModule(_locales: ScannedLocale[], defaultLocale: string | undefined, srcDir?: string, i18nConfigJson?: string): VirtualModule;
 //#endregion
-export { type VirtualModule, type VirtualModuleContext, VirtualModuleRegistry, type VirtualModuleTransform, createAppVirtualModule, createLocalesVirtualModule, createMetaVirtualModule, createPagesVirtualModule, createRoutingVirtualModule, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, registerComponentResolver, registerCssImport, resetModuleRegistry, resetVirtualRegistry, stripMacros, transformMacros, useVirtualRegistry };
+export { SSR_SINGLETON_DEDUPE, SSR_SINGLETON_OPTIMIZE_EXCLUDE, SSR_SINGLETON_PACKAGES, type VirtualModule, type VirtualModuleContext, VirtualModuleRegistry, type VirtualModuleTransform, createAppVirtualModule, createLocalesVirtualModule, createMetaVirtualModule, createPagesVirtualModule, createRoutingVirtualModule, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, registerComponentResolver, registerCssImport, resetModuleRegistry, resetVirtualRegistry, ssrSingletonDevPolicy, ssrSingletonProdOptimizeExclude, ssrSingletonProdSsr, stripMacros, transformMacros, useVirtualRegistry };

package/dist/index.js

@@ -1,3 +1,4 @@
-import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, t as createAppVirtualModule } from "./virtual-modules-BDgTqx3t.js";
-import { VirtualModuleRegistry, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, registerComponentResolver, registerCssImport, resetModuleRegistry, resetVirtualRegistry, stripMacros, transformMacros, useVirtualRegistry } from "@ubean/build-core";
-export { VirtualModuleRegistry, createAppVirtualModule, createLocalesVirtualModule, createMetaVirtualModule, createPagesVirtualModule, createRoutingVirtualModule, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, registerComponentResolver, registerCssImport, resetModuleRegistry, resetVirtualRegistry, stripMacros, transformMacros, useVirtualRegistry };
+import { a as useVirtualRegistry, i as resetVirtualRegistry, n as defineVirtualModule, r as defineVirtualModulePrefix, t as VirtualModuleRegistry } from "./virtual-registry-BWkaQHXN.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-D5WBA3u7.js";
+import { a as ssrSingletonProdOptimizeExclude, c as getCssImports, d as resetModuleRegistry, i as ssrSingletonDevPolicy, l as registerComponentResolver, n as SSR_SINGLETON_OPTIMIZE_EXCLUDE, o as ssrSingletonProdSsr, r as SSR_SINGLETON_PACKAGES, s as getComponentResolvers, t as SSR_SINGLETON_DEDUPE, u as registerCssImport } from "./ssr-singleton-CEQi_H6-.js";
+export { SSR_SINGLETON_DEDUPE, SSR_SINGLETON_OPTIMIZE_EXCLUDE, SSR_SINGLETON_PACKAGES, VirtualModuleRegistry, createAppVirtualModule, createLocalesVirtualModule, createMetaVirtualModule, createPagesVirtualModule, createRoutingVirtualModule, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, registerComponentResolver, registerCssImport, resetModuleRegistry, resetVirtualRegistry, ssrSingletonDevPolicy, ssrSingletonProdOptimizeExclude, ssrSingletonProdSsr, stripMacros, transformMacros, useVirtualRegistry };

package/dist/prerender.d.ts

@@ -0,0 +1,129 @@
+import { PrerenderConfig, PrerenderResult, RouteRule } from "@ubean/config";
+import { ScannedPageRoute } from "@ubean/scan";
+import { RouteRule as RouteRule$1 } from "@ubean/shared";
+//#region src/prerender.d.ts
+interface PrerendererOptions {
+  cwd: string;
+  outputDir: string;
+  pages: ScannedPageRoute[];
+  /**
+   * 预渲染配置。可直接传用户配置对象(由 `resolvePrerenderConfig` 解析默认值)。
+   * 未设置或 `enabled: false` 时直接返回空结果。
+   */
+  prerender?: PrerenderConfig;
+  /**
+   * 路由规则(P9-03)。用于自动发现标记了 `prerender: true` 的路由。
+   * 与 `PrerenderConfig.include` / `all` 合并:
+   *   - `all: true` 时 routeRules 中的 prerender 标记被忽略(已包含全部)
+   *   - 否则 prerender 标记的路由加入 include 列表
+   * 受 `PrerenderConfig.exclude` 过滤。
+   */
+  routeRules?: Record<string, RouteRule$1>;
+  /** Content collection URLs merged into `include` (see `extractContentPageRoutes`). */
+  contentRoutes?: string[];
+  fetcher?: (url: string) => Promise<{
+    html: string;
+    statusCode: number;
+  }>;
+}
+/**
+ * 从 routeRules 中提取标记了 `prerender: true` 或 `ppr: true` 的路由模式
+ * (P9-03 + P9-04)。
+ *
+ * P9-04:`ppr: true` 隐含 `prerender: true` —— PPR 路由的静态壳需要通过
+ * 预渲染生成(`server:defer` 组件在预渲染时仅渲染 fallback)。
+ *
+ * 返回的路径列表会进一步与 `pages` 候选池匹配(glob 模式)或直接加入(具体路径)。
+ * 动态路由的具象值(如 `/blog/hello-world`)可通过具体路径直接加入。
+ */
+declare function extractPrerenderRoutesFromRules(routeRules: Record<string, RouteRule$1> | undefined): string[];
+/**
+ * 收集需要预渲染的路由列表。
+ *
+ * 行为:
+ * 1. 扫描 `pages` 得到所有非动态页面作为候选池
+ * 2. 若 `options.all === true`:加入候选池所有路由(`include` 被忽略)
+ * 3. 否则遍历 `options.include` + `options.routeRules` 中 `prerender: true` 的模式:
+ *    - 含通配符的模式 → 与候选池匹配
+ *    - 不含通配符的具体路径 → 直接加入(用于动态路由的具象值)
+ * 4. 应用 `options.exclude` 过滤
+ *
+ * 返回的 `skipped` 为被 `exclude` 命中的路由集合。
+ */
+declare function collectPrerenderRoutes(pages: ScannedPageRoute[], options?: {
+  all?: boolean;
+  include?: string[];
+  exclude?: string[];
+  /** P9-03: routeRules 中 `prerender: true` 的模式会合并到 include 列表 */
+  routeRules?: Record<string, RouteRule$1>;
+  /** Content collection URLs (`extractContentPageRoutes`) merged into include */
+  contentRoutes?: string[];
+}): {
+  routes: string[];
+  skipped: string[];
+};
+declare function extractLinks(html: string, baseUrl?: string): string[];
+/**
+ * 将路由路径映射到磁盘文件路径。
+ *
+ * 规则:
+ * - `/` 或空 → `outputDir/index.html`
+ * - 含文件扩展名(`.html`/`.txt`/`.xml`/`.json`/`.webmanifest`/`.svg`/`.ico` 等)
+ *   的路由 → 保留原文件名,例如 `/robots.txt` → `outputDir/robots.txt`(文件,不是目录)
+ * - 其他路由 → `outputDir/<route>/index.html`
+ *
+ * 处理带扩展名路由是为了避免 `/robots.txt/index.html`、`/sitemap.xml/index.html`
+ * 这种被错误转成目录的产物。
+ */
+declare function routeToFilePath(route: string, outputDir: string): string;
+/**
+ * 将路由路径映射到对应的 `__data.json` 文件路径。
+ *
+ * 规则(与 `routeToFilePath` 对应,但产物是 JSON payload 而非 HTML):
+ * - `/` → `outputDir/__data.json`
+ * - `/about` → `outputDir/about/__data.json`
+ * - `/dashboard/settings` → `outputDir/dashboard/settings/__data.json`
+ *
+ * 与 HTML 不同,这里不需要处理扩展名路由(`.html`/`.txt` 等)—— payload
+ * 仅对页面路由有意义,扩展名路由(如 `/robots.txt`)不参与 payload 提取。
+ */
+declare function routeToDataFilePath(route: string, outputDir: string): string;
+/**
+ * `extractDataPayload` 的返回结构。
+ */
+interface ExtractedPayload {
+  /** 从 `__UBEAN_DATA__` 解析出的 payload 数据。 */
+  data: Record<string, unknown>;
+  /** 替换内联 script 后的 HTML(包含 preload link + 引导脚本)。 */
+  html: string;
+  /** `__data.json` 的 URL(用于 preload + fetch)。 */
+  dataUrl: string;
+}
+/**
+ * 从预渲染 HTML 中提取 `__UBEAN_DATA__` payload,替换为外部引用。
+ *
+ * 流程:
+ * 1. 用正则匹配 `<script id="__UBEAN_DATA__">JSON</script>`
+ * 2. JSON.parse 提取的数据(解析失败/为空 → 返回 null)
+ * 3. 计算 `dataUrl`(根路由 → `/__data.json`,其他 → `<route>/__data.json`)
+ * 4. 用 `<link rel="preload">` + 引导脚本替换内联 script
+ *    (引导脚本通过 `fetch(dataUrl)` 加载 payload,设置全局 `__UBEAN_DATA_PAYLOAD__`)
+ *
+ * 返回 `null` 表示不进行提取(无 script / JSON 解析失败 / payload 为空对象)。
+ *
+ * @param html 预渲染后的完整 HTML
+ * @param route 当前路由路径(用于计算 dataUrl)
+ */
+declare function extractDataPayload(html: string, route: string): ExtractedPayload | null;
+declare function writePrerenderedFile(filePath: string, html: string): Promise<void>;
+declare function prerender(options: PrerendererOptions): Promise<PrerenderResult>;
+declare function generatePrerenderManifest(result: PrerenderResult, baseUrl?: string): {
+  routes: string[];
+  generatedAt: string;
+  errors: Array<{
+    route: string;
+    message: string;
+  }>;
+};
+//#endregion
+export { ExtractedPayload, PrerendererOptions, type RouteRule, collectPrerenderRoutes, extractDataPayload, extractLinks, extractPrerenderRoutesFromRules, generatePrerenderManifest, prerender, routeToDataFilePath, routeToFilePath, writePrerenderedFile };

package/dist/prerender.js

@@ -0,0 +1,308 @@
+import { dirname, join } from "pathe";
+import { resolvePrerenderConfig } from "@ubean/config";
+import { DATA_PAYLOAD_ID } from "@ubean/pages";
+import { mkdir, writeFile } from "node:fs/promises";
+import { matchGlob } from "@ubean/shared";
+//#region src/prerender.ts
+const LINK_REGEX = /<a[^>]+href=["']([^"']+)["'][^>]*>/gi;
+/**
+* 匹配 `__UBEAN_DATA__` 内联 script 的正则。
+*
+* 预渲染时从中提取 JSON payload,替换为 `<link rel="preload">` + 引导脚本
+* (引导脚本通过 fetch 加载 `__data.json`,设置全局 `__UBEAN_DATA_PAYLOAD__`)。
+*
+* 使用 `[\s\S]*?` 非贪婪匹配,避免多个 script 之间的过度匹配。
+*/
+const DATA_PAYLOAD_REGEX = new RegExp(`<script id="${DATA_PAYLOAD_ID}" type="application/json">([\\s\\S]*?)<\/script>`);
+function isDynamicPath(path) {
+	return /\[.*?\]/.test(path) || path.includes(":");
+}
+function normalizePagePath(filePath) {
+	let path = filePath.replace(/\.(vue|ts|js|tsx|jsx|md|mdx)$/, "");
+	if (path === "index" || path.endsWith("/index")) path = path.slice(0, -5);
+	path = path.replace(/\\/g, "/");
+	if (!path.startsWith("/")) path = `/${path}`;
+	if (path.length > 1 && path.endsWith("/")) path = path.slice(0, -1);
+	return path || "/";
+}
+/**
+* 从 routeRules 中提取标记了 `prerender: true` 或 `ppr: true` 的路由模式
+* (P9-03 + P9-04)。
+*
+* P9-04:`ppr: true` 隐含 `prerender: true` —— PPR 路由的静态壳需要通过
+* 预渲染生成(`server:defer` 组件在预渲染时仅渲染 fallback)。
+*
+* 返回的路径列表会进一步与 `pages` 候选池匹配(glob 模式)或直接加入(具体路径)。
+* 动态路由的具象值(如 `/blog/hello-world`)可通过具体路径直接加入。
+*/
+function extractPrerenderRoutesFromRules(routeRules) {
+	if (!routeRules) return [];
+	const result = [];
+	for (const [pattern, rule] of Object.entries(routeRules)) if (rule?.prerender === true || rule?.ppr === true) result.push(pattern);
+	return result;
+}
+/**
+* 收集需要预渲染的路由列表。
+*
+* 行为:
+* 1. 扫描 `pages` 得到所有非动态页面作为候选池
+* 2. 若 `options.all === true`:加入候选池所有路由(`include` 被忽略)
+* 3. 否则遍历 `options.include` + `options.routeRules` 中 `prerender: true` 的模式:
+*    - 含通配符的模式 → 与候选池匹配
+*    - 不含通配符的具体路径 → 直接加入(用于动态路由的具象值)
+* 4. 应用 `options.exclude` 过滤
+*
+* 返回的 `skipped` 为被 `exclude` 命中的路由集合。
+*/
+function collectPrerenderRoutes(pages, options = {}) {
+	const all = options.all === true;
+	const exclude = options.exclude ?? [];
+	const include = [
+		...options.include ?? [],
+		...extractPrerenderRoutesFromRules(options.routeRules),
+		...options.contentRoutes ?? []
+	];
+	const allPageRoutes = [];
+	for (const page of pages) {
+		const path = normalizePagePath(page.path);
+		if (!isDynamicPath(path)) allPageRoutes.push(path);
+	}
+	const matched = /* @__PURE__ */ new Set();
+	if (all) for (const r of allPageRoutes) matched.add(r);
+	else for (const pattern of include) if (pattern.includes("*")) {
+		for (const r of allPageRoutes) if (matchGlob(r, pattern)) matched.add(r);
+	} else matched.add(pattern.startsWith("/") ? pattern : `/${pattern}`);
+	const skipped = [];
+	for (const r of matched) if (exclude.some((p) => matchGlob(r, p))) skipped.push(r);
+	for (const r of skipped) matched.delete(r);
+	return {
+		routes: Array.from(matched),
+		skipped
+	};
+}
+function extractLinks(html, baseUrl = "") {
+	const links = /* @__PURE__ */ new Set();
+	let match;
+	const anchorRe = new RegExp(LINK_REGEX.source, LINK_REGEX.flags);
+	while ((match = anchorRe.exec(html)) !== null) {
+		const href = match[1];
+		if (isInternalLink(href, baseUrl)) {
+			const path = normalizeHref(href, baseUrl);
+			if (path) links.add(path);
+		}
+	}
+	return Array.from(links);
+}
+function isInternalLink(href, baseUrl) {
+	if (!href) return false;
+	if (href.startsWith("#") || href.startsWith("mailto:") || href.startsWith("tel:") || href.startsWith("javascript:")) return false;
+	if (href.startsWith("http://") || href.startsWith("https://")) return baseUrl ? href.startsWith(baseUrl) : false;
+	if (href.startsWith("//")) return false;
+	return true;
+}
+function normalizeHref(href, baseUrl) {
+	let path = href;
+	if (baseUrl && path.startsWith(baseUrl)) path = path.slice(baseUrl.length);
+	const hashIdx = path.indexOf("#");
+	if (hashIdx !== -1) path = path.slice(0, hashIdx);
+	const queryIdx = path.indexOf("?");
+	if (queryIdx !== -1) path = path.slice(0, queryIdx);
+	if (path.includes(":")) return null;
+	if (path.includes("//")) return null;
+	if (!path.startsWith("/")) path = `/${path}`;
+	if (path.length > 1 && path.endsWith("/")) path = path.slice(0, -1);
+	return path || "/";
+}
+/**
+* 将路由路径映射到磁盘文件路径。
+*
+* 规则:
+* - `/` 或空 → `outputDir/index.html`
+* - 含文件扩展名(`.html`/`.txt`/`.xml`/`.json`/`.webmanifest`/`.svg`/`.ico` 等)
+*   的路由 → 保留原文件名,例如 `/robots.txt` → `outputDir/robots.txt`(文件,不是目录)
+* - 其他路由 → `outputDir/<route>/index.html`
+*
+* 处理带扩展名路由是为了避免 `/robots.txt/index.html`、`/sitemap.xml/index.html`
+* 这种被错误转成目录的产物。
+*/
+function routeToFilePath(route, outputDir) {
+	if (route === "/" || route === "") return join(outputDir, "index.html");
+	if (route.endsWith(".html")) return join(outputDir, route);
+	const lastSegment = route.slice(route.lastIndexOf("/") + 1);
+	const dotIdx = lastSegment.lastIndexOf(".");
+	if (dotIdx > 0 && dotIdx < lastSegment.length - 1) return join(outputDir, route);
+	return join(outputDir, route, "index.html");
+}
+/**
+* 将路由路径映射到对应的 `__data.json` 文件路径。
+*
+* 规则(与 `routeToFilePath` 对应,但产物是 JSON payload 而非 HTML):
+* - `/` → `outputDir/__data.json`
+* - `/about` → `outputDir/about/__data.json`
+* - `/dashboard/settings` → `outputDir/dashboard/settings/__data.json`
+*
+* 与 HTML 不同,这里不需要处理扩展名路由(`.html`/`.txt` 等)—— payload
+* 仅对页面路由有意义,扩展名路由(如 `/robots.txt`)不参与 payload 提取。
+*/
+function routeToDataFilePath(route, outputDir) {
+	if (route === "/" || route === "") return join(outputDir, "__data.json");
+	return join(outputDir, route, "__data.json");
+}
+/**
+* 从预渲染 HTML 中提取 `__UBEAN_DATA__` payload,替换为外部引用。
+*
+* 流程:
+* 1. 用正则匹配 `<script id="__UBEAN_DATA__">JSON<\/script>`
+* 2. JSON.parse 提取的数据(解析失败/为空 → 返回 null)
+* 3. 计算 `dataUrl`(根路由 → `/__data.json`,其他 → `<route>/__data.json`)
+* 4. 用 `<link rel="preload">` + 引导脚本替换内联 script
+*    (引导脚本通过 `fetch(dataUrl)` 加载 payload,设置全局 `__UBEAN_DATA_PAYLOAD__`)
+*
+* 返回 `null` 表示不进行提取(无 script / JSON 解析失败 / payload 为空对象)。
+*
+* @param html 预渲染后的完整 HTML
+* @param route 当前路由路径(用于计算 dataUrl)
+*/
+function extractDataPayload(html, route) {
+	const match = DATA_PAYLOAD_REGEX.exec(html);
+	if (!match) return null;
+	const jsonText = match[1];
+	let data;
+	try {
+		data = JSON.parse(jsonText);
+	} catch {
+		return null;
+	}
+	if (!data || typeof data !== "object" || Object.keys(data).length === 0) return null;
+	const dataUrl = route === "/" || route === "" ? "/__data.json" : `${route}/__data.json`;
+	const replacement = `<link rel="preload" href="${dataUrl}" as="fetch" crossorigin="anonymous"><script>window.__UBEAN_DATA_PAYLOAD__=fetch(${JSON.stringify(dataUrl)},{credentials:"include"}).then(r=>r.ok?r.json():null).catch(()=>null)<\/script>`;
+	const modifiedHtml = html.slice(0, match.index) + replacement + html.slice(match.index + match[0].length);
+	return {
+		data,
+		html: modifiedHtml,
+		dataUrl
+	};
+}
+async function writePrerenderedFile(filePath, html) {
+	await mkdir(dirname(filePath), { recursive: true });
+	await writeFile(filePath, html, "utf-8");
+}
+const _logger = {
+	info: (msg) => console.log(msg),
+	warn: (msg) => console.warn(msg),
+	error: (msg) => console.error(msg),
+	success: (msg) => console.log(msg),
+	debug: (_msg) => {}
+};
+async function prerender(options) {
+	const startTime = Date.now();
+	const config = resolvePrerenderConfig(options.prerender);
+	const enabledByRules = extractPrerenderRoutesFromRules(options.routeRules).length > 0;
+	if (!config.enabled && !enabledByRules) return {
+		routes: [],
+		generated: [],
+		errors: [],
+		skipped: [],
+		duration: 0
+	};
+	const outputDir = join(options.cwd, config.staticDir);
+	const { routes: initialRoutes, skipped: initiallySkipped } = collectPrerenderRoutes(options.pages, {
+		all: config.all,
+		include: config.include,
+		exclude: config.exclude,
+		routeRules: options.routeRules,
+		contentRoutes: options.contentRoutes
+	});
+	const queue = [...initialRoutes];
+	const visited = /* @__PURE__ */ new Set();
+	const results = [];
+	const generated = [];
+	const errors = [];
+	const skipped = [...initiallySkipped];
+	_logger.info(`Prerendering ${queue.length} initial routes...`);
+	async function processRoute(route) {
+		if (visited.has(route)) return;
+		visited.add(route);
+		if (config.exclude.some((p) => matchGlob(route, p))) {
+			if (!skipped.includes(route)) skipped.push(route);
+			return;
+		}
+		const result = { route };
+		try {
+			if (options.fetcher) {
+				const resp = await options.fetcher(route);
+				result.statusCode = resp.statusCode;
+				result.html = resp.html;
+				if (resp.statusCode >= 400) {
+					result.error = /* @__PURE__ */ new Error(`HTTP ${resp.statusCode}`);
+					errors.push(result);
+					if (config.failOnError) throw result.error;
+					_logger.warn(`  ⚠ ${route} → ${resp.statusCode}`);
+					return;
+				}
+				if (config.crawlLinks && resp.html) {
+					const links = extractLinks(resp.html);
+					for (const link of links) if (!visited.has(link) && !config.exclude.some((p) => matchGlob(link, p))) queue.push(link);
+				}
+				let htmlToWrite = resp.html;
+				if (config.extractDataPayload && resp.statusCode === 200 && resp.html) {
+					const extracted = extractDataPayload(resp.html, route);
+					if (extracted) {
+						await writePrerenderedFile(routeToDataFilePath(route, outputDir), JSON.stringify(extracted.data));
+						htmlToWrite = extracted.html;
+					}
+				}
+				await writePrerenderedFile(routeToFilePath(route, outputDir), htmlToWrite);
+				generated.push(route);
+				result.html = void 0;
+			} else {
+				const placeholderHtml = `<!DOCTYPE html>
+<html>
+<head><title>ubean</title></head>
+<body>
+<div id="app"><!-- Prerendered content placeholder for ${route} --></div>
+</body>
+</html>`;
+				await writePrerenderedFile(routeToFilePath(route, outputDir), placeholderHtml);
+				generated.push(route);
+				result.statusCode = 200;
+			}
+		} catch (err) {
+			result.error = err instanceof Error ? err : new Error(String(err));
+			errors.push(result);
+			if (config.failOnError) throw result.error;
+			_logger.warn(`  ⚠ ${route} → ${result.error.message}`);
+		}
+		results.push(result);
+	}
+	while (queue.length > 0) {
+		const batch = [];
+		while (batch.length < config.concurrency && queue.length > 0) {
+			const r = queue.shift();
+			if (r && !visited.has(r)) batch.push(r);
+		}
+		if (batch.length === 0) break;
+		await Promise.all(batch.map((r) => processRoute(r)));
+	}
+	const duration = Date.now() - startTime;
+	_logger.success(`Prerendered ${generated.length} routes${errors.length > 0 ? ` (${errors.length} errors)` : ""}${skipped.length > 0 ? `, skipped ${skipped.length}` : ""} in ${duration}ms`);
+	return {
+		routes: results,
+		generated,
+		errors,
+		skipped,
+		duration
+	};
+}
+function generatePrerenderManifest(result, baseUrl = "/") {
+	return {
+		routes: result.generated.map((r) => baseUrl + r.replace(/^\//, "")),
+		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		errors: result.errors.map((e) => ({
+			route: e.route,
+			message: e.error?.message || "Unknown error"
+		}))
+	};
+}
+//#endregion
+export { collectPrerenderRoutes, extractDataPayload, extractLinks, extractPrerenderRoutesFromRules, generatePrerenderManifest, prerender, routeToDataFilePath, routeToFilePath, writePrerenderedFile };

package/dist/production.d.ts

@@ -9,6 +9,8 @@ interface BuildOptions {
   scanResult: ScanResult;
   minify?: boolean;
   sourcemap?: boolean;
+  /** Inlined content collections for production SSR (`queryCollection`). */
+  contentSnapshot?: Record<string, unknown[]>;
 }
 interface BuildManifest {
   assets: Array<{