@ubean/build 0.7.3 → 0.7.5

package/dist/actions-plugin.d.ts

@@ -1,5 +1,4 @@
 import { Plugin } from "vite";
-//#region src/actions-plugin.d.ts
 export interface ServerActionsPluginOptions {
   /**
    * The project root directory (used for computing stable action IDs).
@@ -58,5 +57,4 @@ export declare function transformActionsForClient(code: string, filePath: string
  *  - 客户端(浏览器):将 `defineAction(...)` 替换为 `createActionStub('<id>')`。
  */
 export declare function ubeanServerActionsPlugin(options?: ServerActionsPluginOptions): Plugin;
-//#endregion
 export {};

package/dist/actions-plugin.js

@@ -1,6 +1,6 @@
 import { relative } from "pathe";
 import { createActionId } from "@ubean/routes";
-//#region src/actions-plugin.ts
+// src/actions-plugin.ts
 /**
 * 查找匹配的闭合括号(支持字符串/模板字面量/注释跳过)。
 */
@@ -430,5 +430,4 @@ function ubeanServerActionsPlugin(options = {}) {
 		}
 	};
 }
-//#endregion
 export { findDefineActionCalls, hasDefineActionCall, transformActionsForClient, transformActionsForServer, ubeanServerActionsPlugin };

package/dist/codegen/index.d.ts

@@ -3,7 +3,6 @@ import { ScanResult } from "@ubean/scan";
 import { Import, InlinePreset } from "unimport";
 import { Options } from "unplugin-vue-components/types";
 import { Options as Options$1 } from "unplugin-auto-import/types";
-//#region src/codegen/auto-imports.d.ts
 interface GenerateAutoImportsOptions {
   cwd: string;
   srcDir: string;
@@ -141,8 +140,6 @@ export declare function generateImportsTransform(imports: Import[]): {
   code: string;
   map?: null;
 };
-//#endregion
-//#region src/codegen/route-types.d.ts
 interface RouteTypesOptions {
   /** Project root directory (absolute). Used to compute portable relative `filePath` values. */
   cwd: string;
@@ -155,8 +152,6 @@ interface PageTypesOptions {
   fileName?: string;
 }
 export declare function generatePageTypes(result: ScanResult, options: PageTypesOptions): Promise<string>;
-//#endregion
-//#region src/codegen/i18n-types.d.ts
 interface I18nTypesOptions {
   outDir: string;
   fileName?: string;
@@ -171,8 +166,6 @@ export declare function messagesToTsType(value: unknown, indent?: number): strin
  * JSON source, the locale union only needs the locale files to exist.
  */
 export declare function generateI18nTypes(result: ScanResult, options: I18nTypesOptions): Promise<string | null>;
-//#endregion
-//#region src/codegen/openapi-types.d.ts
 /**
  * OpenAPI 类型生成
  *
@@ -199,8 +192,6 @@ export declare function generateOpenApiTypes(schema: unknown, options: GenerateO
  * `Unexpected token '<'` 之类的误导性错误。
  */
 export declare function generateOpenApiTypesFromServer(baseUrl: string, options: GenerateOpenApiTypesOptions): Promise<string | null>;
-//#endregion
-//#region src/codegen/index.d.ts
 export declare const CODEGEN_CONTRACT_VERSION: 1;
 export interface CodegenFileContract {
   name: string;
@@ -255,5 +246,4 @@ export interface CodegenResult {
   generated: string[];
 }
 export declare function generateTypes(result: ScanResult, options: CodegenOptions): Promise<CodegenResult>;
-//#endregion
 export type { AutoImportResult, ComponentInfo, GenerateAutoImportsOptions, GenerateOpenApiTypesOptions, I18nTypesOptions, Import, InlinePreset, PageTypesOptions, ResolvedAutoImports, ResolvedComponentsAutoImport, RouteTypesOptions };

package/dist/codegen/index.js

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

package/dist/{codegen-DUQT79IR.js → codegen-D9q6Yu0z.js}

@@ -1,10 +1,10 @@
-import { r as resolveEnvModules } from "./types-C2WT1hXQ.js";
+import { r as resolveEnvModules } from "./types-BvLO9ngd.js";
 import { isAbsolute, join, normalize, relative } from "pathe";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { glob } from "tinyglobby";
 import { createUnimport, toTypeDeclarationFile } from "unimport";
 import openapiTS, { astToString } from "openapi-typescript";
-//#region src/env/codegen.ts
+// src/env/codegen.ts
 /**
 * `.ubean/env.d.ts` 生成器。
 *
@@ -109,8 +109,7 @@ ${renderModuleTypes("ubean:env/client", modules.client)}${renderModuleTypes("ube
 	await writeFile(outPath, contents, "utf8");
 	return outPath;
 }
-//#endregion
-//#region src/codegen/auto-imports.ts
+// src/codegen/auto-imports.ts
 /** 将 `boolean | AutoImportOptions` 归一化为分库开关 + 透传选项。 */
 function resolveAutoImportsConfig(input) {
 	const options = typeof input === "object" && input !== null ? input : {};
@@ -717,8 +716,7 @@ function generateImportsTransform(imports) {
 	for (const [from, names] of importGroups) importStatements.push(`import { ${Array.from(names).join(", ")} } from '${from}';`);
 	return { code: importStatements.join("\n") };
 }
-//#endregion
-//#region src/codegen/i18n-types.ts
+// src/codegen/i18n-types.ts
 function isIdent(key) {
 	return /^[A-Za-z_$][\w$]*$/.test(key);
 }
@@ -807,8 +805,7 @@ declare module '@intlify/core-base' {
 	await writeFile(outPath, contents, "utf8");
 	return outPath;
 }
-//#endregion
-//#region src/codegen/route-types.ts
+// src/codegen/route-types.ts
 /**
 * Compute a portable file path for a scanned route.
 *
@@ -939,8 +936,7 @@ async function generatePageTypes(result, options) {
 	await writeFile(filePath, content, "utf-8");
 	return filePath;
 }
-//#endregion
-//#region src/codegen/openapi-types.ts
+// src/codegen/openapi-types.ts
 /**
 * OpenAPI 类型生成
 *
@@ -985,8 +981,7 @@ async function generateOpenApiTypesFromServer(baseUrl, options) {
 	if (!(response.headers.get("content-type") || "").includes("json")) return null;
 	return generateOpenApiTypes(await response.json(), options);
 }
-//#endregion
-//#region src/codegen/index.ts
+// src/codegen/index.ts
 const CODEGEN_CONTRACT_VERSION = 1;
 const CODEGEN_FILES = [
 	{
@@ -1093,5 +1088,4 @@ async function generateTypes(result, options) {
 		generated
 	};
 }
-//#endregion
 export { getBuiltinComposables as C, resolveComponentsConfig as D, resolveAutoImportsConfig as E, toArray as O, getAutoImportPresets as S, getUbeanComponentsConfig as T, VUE_MACROS_PRESET as _, generateOpenApiTypes as a, generateAutoImports as b, generateRouteTypes as c, BUILTIN_PRESETS as d, COMPONENT_HALF_GLOBS as f, VUE_I18N_PRESET as g, UBEAN_SERVER_PRESET as h, generateTypes as i, generateI18nTypes as l, UBEAN_CLIENT_PRESET as m, CODEGEN_FILES as n, generateOpenApiTypesFromServer as o, HONO_OPENAPI_PRESET as p, CODEGEN_NON_CONTRACT_FILES as r, generatePageTypes as s, CODEGEN_CONTRACT_VERSION as t, messagesToTsType as u, VUE_PRESET as v, getUbeanAutoImportConfig as w, generateImportsTransform as x, VUE_ROUTER_PRESET as y };

package/dist/env/plugin.d.ts

@@ -1,6 +1,5 @@
 import { ResolvedConfig } from "@ubean/config";
 import { Plugin } from "vite";
-//#region src/env/types.d.ts
 /**
  * `env.schema` → 两个虚拟模块（`ubean:env/client` / `ubean:env/server`）的规范化与取值。
  *
@@ -73,8 +72,6 @@ export declare function renderEnvClientModule(fields: EnvFieldSpec[]): string;
  * 会把「部署忘了配环境变量」拖到第一次请求才炸。
  */
 export declare function renderEnvServerModule(fields: EnvFieldSpec[], mode?: 'warn' | 'throw'): string;
-//#endregion
-//#region src/env/plugin.d.ts
 export declare const ENV_CLIENT_ID = "ubean:env/client";
 export declare const ENV_SERVER_ID = "ubean:env/server";
 export interface UbeanEnvPluginOptions {
@@ -87,5 +84,4 @@ export interface UbeanEnvPluginOptions {
  * - 同一个钩子还会给出 `mode`，用于判定生产/开发（决定 warn 的措辞）
  */
 export declare function ubeanEnvPlugin(options: UbeanEnvPluginOptions): Plugin;
-//#endregion
 export type { EnvFieldSpec, EnvModules, ResolveEnvModulesInput };

package/dist/env/plugin.js

@@ -1,6 +1,6 @@
-import { n as renderEnvServerModule, r as resolveEnvModules, t as renderEnvClientModule } from "../types-C2WT1hXQ.js";
+import { n as renderEnvServerModule, r as resolveEnvModules, t as renderEnvClientModule } from "../types-BvLO9ngd.js";
 import { loadEnv } from "vite";
-//#region src/env/plugin.ts
+// src/env/plugin.ts
 /**
 * `ubean:env/*` 虚拟模块插件（Astro `astro:env` 的 Vite 版）。
 *
@@ -76,5 +76,4 @@ or declare the field with \`context: 'client', access: 'public'\` if it is safe
 		}
 	};
 }
-//#endregion
 export { ENV_CLIENT_ID, ENV_SERVER_ID, renderEnvClientModule, renderEnvServerModule, resolveEnvModules, ubeanEnvPlugin };

package/dist/index.d.ts

@@ -1,12 +1,9 @@
-import { a as VirtualModuleTransform, c as defineVirtualModulePrefix, i as VirtualModuleResolver, l as resetVirtualRegistry, n as VirtualModuleContext, o as createVirtualRegistry, r as VirtualModuleRegistry, s as defineVirtualModule, t as VirtualModule, u as useVirtualRegistry } from "./virtual-registry-CaU8k-YP.js";
+import { a as VirtualModuleTransform, c as defineVirtualModulePrefix, i as VirtualModuleResolver, l as resetVirtualRegistry, n as VirtualModuleContext, o as createVirtualRegistry, r as VirtualModuleRegistry, s as defineVirtualModule, t as VirtualModule, u as useVirtualRegistry } from "./virtual-registry-CKfuFd5w.js";
 import "@ubean/vue/vite";
 import { CompiledLayout, CompiledMiddleware, CompiledPage, CompiledRoute } from "@ubean/routes";
 import { ScannedApiRoute, ScannedLocale, ScannedMiddleware, ScannedPageRoute } from "@ubean/scan";
-//#region src/macros.d.ts
 export declare function stripMacros(code: string, macros?: readonly string[]): string;
 export declare function transformMacros(code: string, id: string): string | null;
-//#endregion
-//#region src/registry.d.ts
 /**
  * Module extension registry.
  *
@@ -70,8 +67,6 @@ export declare function getHeadScripts(): string;
  * @internal
  */
 export declare function resetModuleRegistry(): void;
-//#endregion
-//#region src/ssr-singleton.d.ts
 /**
  * Single-copy runtime policy for Vite client / SSR graphs.
  *
@@ -104,8 +99,6 @@ export declare function ssrSingletonProdSsr(): {
   noExternal: string[];
 };
 export declare function ssrSingletonProdOptimizeExclude(extra?: string[]): string[];
-//#endregion
-//#region src/virtual-modules.d.ts
 /**
  * `ubean:pages` 的输入页 —— 比 `CompiledPage` 多出宿主构菜单所需的扫描元数据。
  *
@@ -129,5 +122,4 @@ export declare function createAppVirtualModule(apiRoutes: ScannedApiRoute[], mid
  */
 pageExtensions?: string): VirtualModule;
 export declare function createLocalesVirtualModule(_locales: ScannedLocale[], defaultLocale: string | undefined, srcDir?: string, i18nConfigJson?: string): VirtualModule;
-//#endregion
 export { type VirtualModule, type VirtualModuleContext, VirtualModuleRegistry, type VirtualModuleResolver, type VirtualModuleTransform, createVirtualRegistry, defineVirtualModule, defineVirtualModulePrefix, resetVirtualRegistry, useVirtualRegistry };

package/dist/index.js

@@ -1,3 +1,3 @@
-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-AXf0lNb0.js";
+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-CD6tSMIE.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-Cy1CnBzY.js";
 export { SSR_SINGLETON_DEDUPE, SSR_SINGLETON_OPTIMIZE_EXCLUDE, SSR_SINGLETON_PACKAGES, VirtualModuleRegistry, createAppVirtualModule, createLocalesVirtualModule, createMetaVirtualModule, createPagesVirtualModule, createRoutingVirtualModule, createVirtualRegistry, defineVirtualModule, defineVirtualModulePrefix, getComponentResolvers, getCssImports, getHeadScripts, registerComponentResolver, registerCssImport, registerHeadScript, resetModuleRegistry, resetVirtualRegistry, ssrSingletonDevPolicy, ssrSingletonProdOptimizeExclude, ssrSingletonProdSsr, stripMacros, transformMacros, useVirtualRegistry };

package/dist/prerender.d.ts

@@ -1,7 +1,6 @@
 import { PrerenderConfig, PrerenderResult, ResolvedPrerenderConfig, RouteRule } from "@ubean/config";
 import { ScannedPageRoute } from "@ubean/scan";
 import { RouteRule as RouteRule$1 } from "@ubean/shared";
-//#region src/prerender.d.ts
 export interface PrerendererOptions {
   cwd: string;
   outputDir: string;
@@ -157,5 +156,4 @@ export declare function generatePrerenderManifest(result: PrerenderResult, baseU
     message: string;
   }>;
 };
-//#endregion
 export type { RouteRule };

package/dist/prerender.js

@@ -4,7 +4,7 @@ import { resolvePrerenderConfig } from "@ubean/config";
 import { mkdir, writeFile } from "node:fs/promises";
 import { matchGlob } from "@ubean/shared";
 import { DATA_PAYLOAD_ID } from "@ubean/pages";
-//#region src/prerender.ts
+// src/prerender.ts
 const LINK_REGEX = /<a[^>]+href=["']([^"']+)["'][^>]*>/gi;
 /**
 * 匹配 `__UBEAN_DATA__` 内联 script 的正则。
@@ -343,5 +343,4 @@ function generatePrerenderManifest(result, baseUrl = "/") {
 		}))
 	};
 }
-//#endregion
 export { collectPrerenderRoutes, extractDataPayload, extractLinks, extractPrerenderRoutesFromRules, generatePrerenderManifest, isRedirectPage, prerender, resolvePrerenderStaticDir, routeToDataFilePath, routeToFilePath, writePrerenderedFile };

package/dist/production.d.ts

@@ -1,9 +1,8 @@
-import { r as VirtualModuleRegistry } from "./virtual-registry-CaU8k-YP.js";
+import { r as VirtualModuleRegistry } from "./virtual-registry-CKfuFd5w.js";
 import { ResolvedConfig } from "@ubean/config";
 import { Preset } from "@ubean/preset";
 import { ScanResult } from "@ubean/scan";
 import { Plugin } from "vite";
-//#region src/vite/build-app.d.ts
 /**
  * 一次 `createBuilder` 完成整套生产构建（`ubean build` 与 `vite build` 共用的唯一编排）。
  *
@@ -14,8 +13,6 @@ import { Plugin } from "vite";
  * 环境变量，结束后还原，避免影响同进程内的其它调用。
  */
 export declare function buildWithEnvironments(options: BuildOptions): Promise<BuildManifest>;
-//#endregion
-//#region src/production.d.ts
 export interface BuildOptions {
   cwd: string;
   config: ResolvedConfig;
@@ -85,5 +82,4 @@ export declare function getPresetBuildConfig(preset: Preset): {
 export declare function createIslandsSsrStubPlugin(): Plugin;
 export declare function generateNodeServerEntry(): string;
 export declare function generateStandardHandlerEntry(): string;
-export declare function generateCloudflareWorkerEntry(): string;
-//#endregion
+export declare function generateCloudflareWorkerEntry(): string;

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-Cwx2gAN6.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-DQ6nL0Kv.js";

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

@@ -1,5 +1,5 @@
 import "node:module";
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -10,8 +10,7 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
-//#endregion
-//#region src/virtual-registry.ts
+// src/virtual-registry.ts
 var VirtualModuleRegistry = class {
 	modules = /* @__PURE__ */ new Map();
 	invalidated = /* @__PURE__ */ new Set();
@@ -94,8 +93,7 @@ function defineVirtualModulePrefix(prefix, loader) {
 		}
 	};
 }
-//#endregion
-//#region src/registry.ts
+// src/registry.ts
 const REGISTRY_KEY = "__ubean_module_registry__";
 function getRegistry() {
 	const g = globalThis;
@@ -167,8 +165,7 @@ function resetModuleRegistry() {
 	reg.cssImports.length = 0;
 	reg.headScripts.length = 0;
 }
-//#endregion
-//#region src/ssr-singleton.ts
+// src/ssr-singleton.ts
 var ssr_singleton_exports = /* @__PURE__ */ __exportAll({
 	SSR_SINGLETON_DEDUPE: () => SSR_SINGLETON_DEDUPE,
 	SSR_SINGLETON_OPTIMIZE_EXCLUDE: () => SSR_SINGLETON_OPTIMIZE_EXCLUDE,
@@ -237,5 +234,4 @@ function ssrSingletonProdSsr() {
 function ssrSingletonProdOptimizeExclude(extra = []) {
 	return [...SSR_SINGLETON_OPTIMIZE_EXCLUDE, ...extra];
 }
-//#endregion
 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

@@ -1,5 +1,4 @@
 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 {
@@ -99,5 +98,4 @@ export interface StaticSsgRenderer {
  */
 export declare function createStaticSsgRenderer(cwd: string, manifest: {
   serverDir: string;
-}, init: StaticSsgRendererInit): Promise<StaticSsgRenderer | undefined>;
-//#endregion
+}, init: StaticSsgRendererInit): Promise<StaticSsgRenderer | undefined>;

package/dist/static-render.js

@@ -2,7 +2,7 @@ import { resolve } from "pathe";
 import { getLogger } from "@ubean/shared/logger";
 import { extractLocaleFromPath } from "@ubean/i18n";
 import { pathToFileURL } from "node:url";
-//#region src/static-render.ts
+// src/static-render.ts
 /**
 * 静态 SSG 渲染器（mode: 'ssg' 专用，见 docs/adr/0011-lightweight-ssg-direct-render.md）。
 *
@@ -260,5 +260,4 @@ async function createStaticSsgRenderer(cwd, manifest, init) {
 		}
 	};
 }
-//#endregion
 export { STATIC_NOT_FOUND_ROUTE, compilePageRoute, createStaticSsgRenderer, expandRoutesForLocales, matchRoutePattern };

package/dist/{types-C2WT1hXQ.js → types-BvLO9ngd.js}

@@ -1,5 +1,5 @@
 import { isEnvFieldMeta } from "@ubean/shared";
-//#region src/env/types.ts
+// src/env/types.ts
 /**
 * `env.schema` → 两个虚拟模块（`ubean:env/client` / `ubean:env/server`）的规范化与取值。
 *
@@ -170,5 +170,4 @@ export function getSecret(key) {
 }
 `;
 }
-//#endregion
 export { renderEnvServerModule as n, resolveEnvModules as r, renderEnvClientModule as t };

package/dist/{virtual-modules-AXf0lNb0.js → virtual-modules-Cy1CnBzY.js}

@@ -1,8 +1,8 @@
-import { _ as defineVirtualModule } from "./ssr-singleton-CUHZLgiO.js";
+import { _ as defineVirtualModule } from "./ssr-singleton-CD6tSMIE.js";
 import { extractScriptBlocks, parseScriptAst, statementCall } from "@ubean/vue/vite";
 import { resolvePageKind } from "@ubean/vue";
 import { isAbsolute, relative } from "pathe";
-//#region src/macros.ts
+// src/macros.ts
 /**
 * 宏剥除(`definePage` 等编译期宏从产物中移除)。
 *
@@ -126,8 +126,7 @@ function transformVueMacros(code) {
 	for (const edit of [...edits].sort((a, b) => b.start - a.start)) result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
 	return result;
 }
-//#endregion
-//#region src/virtual-modules.ts
+// src/virtual-modules.ts
 function toVitePath(p) {
 	return p.replace(/\\/g, "/");
 }
@@ -376,5 +375,4 @@ if (import.meta.hot) {
 `;
 	});
 }
-//#endregion
 export { createRoutingVirtualModule as a, createPagesVirtualModule as i, createLocalesVirtualModule as n, stripMacros as o, createMetaVirtualModule as r, transformMacros as s, createAppVirtualModule as t };

package/dist/{virtual-registry-CaU8k-YP.d.ts → virtual-registry-CKfuFd5w.d.ts}

@@ -1,4 +1,3 @@
-//#region src/virtual-registry.d.ts
 interface VirtualModuleContext {
   resolveId(id: string): string | undefined;
   load(id: string): string | undefined;
@@ -49,5 +48,4 @@ declare function useVirtualRegistry(): VirtualModuleRegistry;
 declare function resetVirtualRegistry(): void;
 declare function defineVirtualModule(id: string, loader: () => string | Promise<string>): VirtualModule;
 declare function defineVirtualModulePrefix(prefix: string, loader: (id: string) => string | Promise<string>): VirtualModule;
-//#endregion
 export { VirtualModuleTransform as a, defineVirtualModulePrefix as c, VirtualModuleResolver as i, resetVirtualRegistry as l, VirtualModuleContext as n, createVirtualRegistry as o, VirtualModuleRegistry as r, defineVirtualModule as s, VirtualModule as t, useVirtualRegistry as u };

package/dist/{vite-Cwx2gAN6.js → vite-DQ6nL0Kv.js}

@@ -1,7 +1,7 @@
-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-AXf0lNb0.js";
-import { a as generateOpenApiTypes, i as generateTypes } from "./codegen-DUQT79IR.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-Cr9byirH.js";
+import { a as ssrSingletonProdOptimizeExclude, g as createVirtualRegistry, o as ssrSingletonProdSsr, x as __exportAll } from "./ssr-singleton-CD6tSMIE.js";
+import { a as createRoutingVirtualModule, i as createPagesVirtualModule, n as createLocalesVirtualModule, r as createMetaVirtualModule, s as transformMacros, t as createAppVirtualModule } from "./virtual-modules-Cy1CnBzY.js";
+import { a as generateOpenApiTypes, i as generateTypes } from "./codegen-D9q6Yu0z.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-BSQATqn6.js";
 import { createStaticSsgRenderer } from "./static-render.js";
 import { prerender, resolvePrerenderStaticDir } from "./prerender.js";
 import { resolvePageKind } from "@ubean/vue";
@@ -22,7 +22,7 @@ import { ubeanIslandsPlugin } from "@ubean/islands/vite";
 import { findUserViteConfig } from "@ubean/shared/node";
 import { dirname as dirname$1, extname, join as join$1, normalize as normalize$1, relative as relative$1, resolve as resolve$1, sep } from "node:path";
 import { pathToFileURL } from "node:url";
-//#region src/i18n-config.ts
+// src/i18n-config.ts
 function serializeI18nConfig(config) {
 	return JSON.stringify(config);
 }
@@ -35,8 +35,7 @@ function localeVueParamFromI18n(config) {
 		paths: localePathsOf(config)
 	}) || void 0;
 }
-//#endregion
-//#region src/page-glob.ts
+// src/page-glob.ts
 /**
 * 页面 glob 的扩展名集合。
 *
@@ -64,8 +63,7 @@ function pageGlobExtensions(extensions, markdownExts = []) {
 	for (const ext of markdownExts) all.add(ext);
 	return [...all].join(",");
 }
-//#endregion
-//#region src/ssg-entry.ts
+// src/ssg-entry.ts
 /**
 * 生成 renderer setup 代码块（`_rendererRoutes` + `_pageRenderer`）。
 *
@@ -378,8 +376,7 @@ export async function renderStaticPage(input) {
 }
 `;
 }
-//#endregion
-//#region src/vite/asset-manifest.ts
+// src/vite/asset-manifest.ts
 /**
 * 客户端资产清单的**构建期注入**（RM-V18）。
 *
@@ -508,8 +505,7 @@ function ubeanAssetManifestPlugin(getManifest, getServerOutDir) {
 		}
 	};
 }
-//#endregion
-//#region src/vite/cloudflare-preview.ts
+// src/vite/cloudflare-preview.ts
 /**
 * Cloudflare 产物的本地预览 runner（RM-V26）。
 *
@@ -720,8 +716,7 @@ function isDirectory(path) {
 		return false;
 	}
 }
-//#endregion
-//#region src/vite/build-steps.ts
+// src/vite/build-steps.ts
 /**
 * 构建步骤的**可复用切片**（Phase 2 地基）。
 *
@@ -875,8 +870,7 @@ async function writeBuildManifest(options) {
 	}
 	return manifest;
 }
-//#endregion
-//#region src/vite/build-configs.ts
+// src/vite/build-configs.ts
 var build_configs_exports = /* @__PURE__ */ __exportAll({
 	CLIENT_VIRTUAL_EXCLUDE: () => CLIENT_VIRTUAL_EXCLUDE,
 	clientOptimizeDepsExclude: () => clientOptimizeDepsExclude,
@@ -1013,8 +1007,7 @@ function createBuildEnvironments(input) {
 		}
 	};
 }
-//#endregion
-//#region src/vite/openapi-step.ts
+// src/vite/openapi-step.ts
 /**
 * 构建期生成 `.ubean/openapi.d.ts`（OpenAPI → TypeScript 类型）。
 *
@@ -1089,8 +1082,7 @@ async function runOpenApiTypesStep(options) {
 		} catch {}
 	}
 }
-//#endregion
-//#region src/vite/prerender-step.ts
+// src/vite/prerender-step.ts
 /**
 * 预渲染步骤（RM-V21 的最后一环）。
 *
@@ -1242,8 +1234,7 @@ async function runPrerenderStep(options) {
 		logger$3.warn(`Search index generation skipped: ${err instanceof Error ? err.message : String(err)}`);
 	}
 }
-//#endregion
-//#region src/vite/build-app.ts
+// src/vite/build-app.ts
 /**
 * environment 驱动的生产构建（RM-V16 / RM-V21，ADR-0012 §4）。
 *
@@ -1473,8 +1464,7 @@ async function runEnvOrchestration(options) {
 	})).buildApp();
 	return manifest;
 }
-//#endregion
-//#region src/production.ts
+// src/production.ts
 function toVitePath(p) {
 	return p.replace(/\\/g, "/");
 }
@@ -1951,8 +1941,7 @@ export default {
 };
 `.trim();
 }
-//#endregion
-//#region src/vite/preview.ts
+// src/vite/preview.ts
 /**
 * `vite preview` 接管（RM-V24，对齐 `nitro:src/build/vite/preview.ts`）。
 *
@@ -2188,8 +2177,7 @@ function ubeanPreviewPlugin(options) {
 		}
 	};
 }
-//#endregion
-//#region src/vite/shims/index.ts
+// src/vite/shims/index.ts
 /**
 * worker 目标下的 Node 内建桩（构建期重写为**虚拟模块**）。
 *
@@ -2282,8 +2270,7 @@ function loadWorkerNodeStub(id) {
 	return STUB_SOURCES[id.slice(17)];
 }
 Object.freeze(Object.keys(STUB_SOURCES));
-//#endregion
-//#region src/dev/dev-worker.ts
+// src/dev/dev-worker.ts
 /**
 * dev worker 入口（RM-V09，ADR-0012 §3）。
 *
@@ -2404,8 +2391,7 @@ function candidateFileKeys(file) {
 	} catch {}
 	return [...new Set(keys)];
 }
-//#endregion
-//#region src/dev/dev-environment.ts
+// src/dev/dev-environment.ts
 /**
 * `UbeanDevEnvironment`（RM-V08，ADR-0012 §3）。
 *
@@ -2519,8 +2505,7 @@ var UbeanDevEnvironment = class extends DevEnvironment {
 function createUbeanDevEnvironmentFactory(runner) {
 	return (name, config, context) => new UbeanDevEnvironment(name, config, context, runner);
 }
-//#endregion
-//#region src/vite.ts
+// src/vite.ts
 const logger = getLogger("build");
 const VIRTUAL_MODULES = [
 	"ubean:routes",
@@ -2569,7 +2554,7 @@ async function buildEnvironmentsForConfig(config) {
 		Promise.resolve().then(() => build_configs_exports),
 		import("./production.js"),
 		import("@ubean/preset"),
-		import("./ssr-singleton-CUHZLgiO.js").then((n) => n.s)
+		import("./ssr-singleton-CD6tSMIE.js").then((n) => n.s)
 	]);
 	registerBuiltinPresets();
 	const outDirs = getBuildOutDirsForConfig(config);
@@ -2987,5 +2972,4 @@ async function maybeGenerateRouteFiles(config, scanResult) {
 		routing.onGenerated(files);
 	}
 }
-//#endregion
 export { getPresetBuildConfig as C, createCloudflarePreviewRunner as D, MINIFLARE_INSTALL_HINT as E, defaultLoadMiniflare as O, generateVirtualModulesToDisk as S, buildWithEnvironments as T, ubeanPreviewPlugin as _, createEnvRunnerTransport as a, generateNodeServerEntry as b, getDevWorkerEntrySource as c, attachPreviewMiddleware as d, createPreviewMiddleware as f, sendPreviewStatus as g, sendPreviewFile as h, bridgeEnvRunnerInvokes as i, readCompatibilityDate as k, invalidateDevWorkerModules as l, resolvePreviewFile as m, UBEAN_DEV_ENV_NAME as n, createUbeanDevEnvironmentFactory as o, previewMimeType as p, UbeanDevEnvironment as r, DEV_WORKER_FILE as s, ubeanPlugin as t, writeDevWorkerEntry as u, createIslandsSsrStubPlugin as v, serializePagesForEntry as w, generateStandardHandlerEntry as x, generateCloudflareWorkerEntry as y };

package/dist/vite.d.ts

@@ -1,11 +1,10 @@
-import { i as VirtualModuleResolver, o as createVirtualRegistry, r as VirtualModuleRegistry } from "./virtual-registry-CaU8k-YP.js";
+import { i as VirtualModuleResolver, o as createVirtualRegistry, r as VirtualModuleRegistry } from "./virtual-registry-CKfuFd5w.js";
 import { ResolvedConfig } from "@ubean/config";
 import { ScanResult, ScannedLayout, ScannedPageRoute } from "@ubean/scan";
 import { UbeanApp } from "@ubean/app";
 import { Connect, DevEnvironment, DevEnvironmentContext, HotChannel, Logger, Plugin, ResolvedConfig as ResolvedConfig$1, ViteDevServer } from "vite";
 import { PageRenderer, PageRenderer as PageRenderer$1 } from "@ubean/pages";
 import { IncomingMessage, ServerResponse } from "node:http";
-//#region src/dev/dev-worker.d.ts
 /** 生成到 `.ubean/` 下的文件名。 */
 export declare const DEV_WORKER_FILE = "dev-worker.mjs";
 interface DevWorkerEntryOptions {
@@ -59,8 +58,6 @@ export declare function invalidateDevWorkerModules(environment: {
 }, runner: {
   sendMessage(message: unknown): void;
 }, files: readonly string[]): DevWorkerInvalidation;
-//#endregion
-//#region src/dev/dev-environment.d.ts
 /**
  * env-runner runner 在本模块用到的最小面。
  *
@@ -105,8 +102,6 @@ export declare class UbeanDevEnvironment extends DevEnvironment {
  * 全仓没有 `createEnvironment` 的注册点，原因见文件头「当前状态」）。
  */
 export declare function createUbeanDevEnvironmentFactory(runner: EnvRunnerLike): (name: string, config: ResolvedConfig$1, context: DevEnvironmentContext) => UbeanDevEnvironment;
-//#endregion
-//#region src/dev/dev-request-router.d.ts
 /**
  * DevTools 相关、**必须交给 Vite** 的命名空间前缀（devframe hub 外壳 + ubean DevTools SPA）。
  *
@@ -240,8 +235,6 @@ export declare function createUbeanRequestHandlers(server: ViteDevServer, option
  * 未匹配请求正好落到我们的 post 中间件。
  */
 export declare function ubeanDevRequestPlugin(options: DevRequestRouterOptions): Plugin;
-//#endregion
-//#region src/dev/node-web.d.ts
 /**
  * `node:http` 请求 → Web `Request`。
  *
@@ -251,8 +244,6 @@ export declare function ubeanDevRequestPlugin(options: DevRequestRouterOptions):
 export declare function toWebRequest(req: IncomingMessage, host: string, protocol: string): Promise<Request>;
 /** Web `Response` → `node:http` 响应：写入状态与头，再流式转发 body（不整体缓冲）。 */
 export declare function sendWebResponse(res: ServerResponse, webRes: Response): Promise<void>;
-//#endregion
-//#region src/vite/cloudflare-preview.d.ts
 /** miniflare 实例的最小面（只声明用到的部分，避免把可选依赖的类型带进公共类型）。 */
 interface MiniflareInstanceLike {
   ready: Promise<unknown>;
@@ -309,8 +300,6 @@ export declare function defaultLoadMiniflare(): Promise<MiniflareConstructorLike
 export declare function createCloudflarePreviewRunner(options: CloudflarePreviewOptions): Promise<CloudflarePreviewResult>;
 /** 从 wrangler.toml 里取兼容性日期（preset 生成的文件就是它的产物契约）。 */
 export declare function readCompatibilityDate(wranglerToml: string): string | undefined;
-//#endregion
-//#region src/vite/preview.d.ts
 /** 静态文件的 MIME 推断（CLI 的静态服务器与本插件共用）。 */
 export declare function previewMimeType(filePath: string): string;
 /**
@@ -388,8 +377,6 @@ export declare function attachPreviewMiddleware(server: PreviewMiddlewareHost, c
  * 「不走 `ubeanPlugin()`」的场景。
  */
 export declare function ubeanPreviewPlugin(options?: UbeanPreviewPluginOptions): Plugin;
-//#endregion
-//#region src/dev/dev-ssr-routes.d.ts
 /** 扫描器方言 `**:slug`（catch-all）→ vue-router 的 `:slug(.*)*`。 */
 export declare function toVueRouterPagePath(route: string): string;
 interface DevSsrRedirectLocation {
@@ -442,8 +429,6 @@ interface DevSsrRoutesOptions {
  * 可以用 `/404`），必须与客户端同形才能让两侧 `useRoute()` 解析出同一份 matched 结构。
  */
 export declare function buildDevSsrRoutes(options: DevSsrRoutesOptions): DevSsrRoute[];
-//#endregion
-//#region src/dev/dev-host-app.d.ts
 /** `@ubean/app` 的 `UbeanApp` 在本模块用到的最小面。 */
 interface DevHostAppLike {
   options: {
@@ -492,6 +477,12 @@ interface EnhanceDevAppOptions {
   localeVueParam?: string;
   /** `backend` 模式无页面与 SSR，跳过 pageRenderer 创建。 */
   backend?: boolean;
+  /**
+   * SSR 是否启用（`config.ssr.enabled`）。`false` 时不创建渲染器，页面请求落到
+   * CSR 外壳 —— 与生产构建一致（`ssrEnabled` 在 `production.ts` / `build-app.ts`）。
+   * 默认 `true`，与生产侧的 `(mode === 'fullstack' && config.ssr.enabled)` 同义。
+   */
+  ssrEnabled?: boolean;
   /** crons 加载完后的启动钩子（CLI 传 `@ubean/server/cron` 的 `startCronScheduler`）。 */
   startCronScheduler?: () => unknown;
   /** 诊断用日志（默认 `console.error`，与原先行为一致）。 */
@@ -504,8 +495,6 @@ interface EnhanceDevAppOptions {
  * HMR 后需要重新指向新的扫描结果与 Vite 模块图。
  */
 export declare function enhanceDevApp(options: EnhanceDevAppOptions): DevHostAppLike;
-//#endregion
-//#region src/dev/dev-scan.d.ts
 /** `server.watcher` 用到的最小面（测试可传假实现）。 */
 interface DevScanSource {
   add(target: string): void;
@@ -573,8 +562,6 @@ export declare function peekDevScanCoordinator(server: ViteDevServer): DevScanCo
  * 允许在协调器建立之前订阅：`getDevScanCoordinator` 会把已登记的订阅转交给新实例。
  */
 export declare function onDevScan(server: ViteDevServer, handler: DevScanSubscriber): () => void;
-//#endregion
-//#region src/dev/dev-app.d.ts
 /** 本模块用到的最小 logger 面（与 Vite 的 `Logger` 兼容，便于直接传 `server.config.logger`）。 */
 type BootstrapLogger = Pick<Logger, 'warn' | 'error' | 'info'>;
 interface CreateDevAppOptions {
@@ -659,8 +646,6 @@ export declare function resolveDevSecurityHeaders(config: ResolvedConfig): boole
  * i18n 未启用或不需要前缀时返回空串。
  */
 export declare function resolveLocaleVueParam(config: ResolvedConfig): string;
-//#endregion
-//#region src/vite.d.ts
 export interface UbeanPluginOptions {
   /**
    * 已解析的 ubean 配置。如果未提供,插件会按以下顺序获取:
@@ -676,5 +661,4 @@ export interface UbeanPluginOptions {
   registry?: VirtualModuleRegistry;
 }
 export declare function ubeanPlugin(options?: UbeanPluginOptions): Plugin;
-//#endregion
 export { type BootstrapDevAppOptions, type BootstrapLogger, type CloudflarePreviewOptions, type CloudflarePreviewResult, type CloudflarePreviewRunner, type CreateDevAppOptions, type DevApp, type DevAppBootstrap, type DevAppReady, type DevAppReadyOptions, type DevHostAppLike, type DevRendererOptions, type DevRequestHandlers, type DevRequestRouterOptions, type DevScanCoordinator, type DevScanCoordinatorOptions, type DevScanSource, type DevScanSubscriber, type DevSsrRoute, type DevSsrRoutesOptions, type DevWorkerEntryOptions, type EnhanceDevAppOptions, type EnvRunnerLike, type MiniflareConstructorLike, type MiniflareInstanceLike, type PreviewFileResolution, type PreviewMiddleware, type PreviewMiddlewareHost, type UbeanPreviewMiddlewareOptions, type UbeanPreviewPluginOptions, type VirtualModuleRegistry, type VirtualModuleResolver, createVirtualRegistry };

package/dist/vite.js

@@ -1,4 +1,4 @@
-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-Cr9byirH.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-Cwx2gAN6.js";
+import { g as createVirtualRegistry } from "./ssr-singleton-CD6tSMIE.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-BSQATqn6.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-DQ6nL0Kv.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-Cr9byirH.js → vue-BSQATqn6.js}

@@ -1,5 +1,5 @@
-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-DUQT79IR.js";
+import { _ as defineVirtualModule, c as getComponentResolvers, g as createVirtualRegistry, i as ssrSingletonDevPolicy, l as getCssImports, u as getHeadScripts } from "./ssr-singleton-CD6tSMIE.js";
+import { D as resolveComponentsConfig, E as resolveAutoImportsConfig, O as toArray, S as getAutoImportPresets, f as COMPONENT_HALF_GLOBS } from "./codegen-D9q6Yu0z.js";
 import { createRequire } from "node:module";
 import { generatePagesModuleSource } from "@ubean/vue/vite";
 import { NOT_FOUND_ROUTE_PATH, resolvePageKind, sortPagesForRouting } from "@ubean/vue";
@@ -18,7 +18,7 @@ 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";
-//#region src/dev/dev-ssr-routes.ts
+// src/dev/dev-ssr-routes.ts
 /**
 * dev/SSR 路由表（RM-V11 的组成部件，从 CLI dev server 抽出）。
 *
@@ -105,8 +105,7 @@ function buildDevSsrRoutes(options) {
 	}
 	return routes;
 }
-//#endregion
-//#region src/dev/dev-host-app.ts
+// src/dev/dev-host-app.ts
 /**
 * 把 Vite SSR 图的加载器与 SSR 渲染器接到 host app 上。
 *
@@ -114,7 +113,7 @@ function buildDevSsrRoutes(options) {
 * HMR 后需要重新指向新的扫描结果与 Vite 模块图。
 */
 function enhanceDevApp(options) {
-	const { app, layouts = [], loadModule, localeVueParam, backend, startCronScheduler, onCronError } = options;
+	const { app, layouts = [], loadModule, localeVueParam, backend, ssrEnabled = true, startCronScheduler, onCronError } = options;
 	app.options.layouts = layouts;
 	const routeLoaders = {};
 	for (const route of app.options.routes || []) {
@@ -141,7 +140,7 @@ function enhanceDevApp(options) {
 		if (onCronError) onCronError(error);
 		else console.error("[ubean] Failed to load cron files:", error);
 	});
-	if (backend) {
+	if (backend || !ssrEnabled) {
 		app.resetInit();
 		return app;
 	}
@@ -175,8 +174,7 @@ function enhanceDevApp(options) {
 	});
 	return app;
 }
-//#endregion
-//#region src/dev/dev-app.ts
+// src/dev/dev-app.ts
 /**
 * 宿主 dev app 的创建与自举（RM-V11）。
 *
@@ -344,6 +342,7 @@ async function bootstrapDevApp(options) {
 		createRenderer: options.createRenderer,
 		localeVueParam: resolveLocaleVueParam(options.config),
 		backend: options.config.mode === "backend",
+		ssrEnabled: options.config.ssr.enabled,
 		startCronScheduler: options.startCronScheduler,
 		onCronError: (error) => (options.logger ?? fallbackLogger).error(`[ubean] Failed to load cron files: ${String(error)}`)
 	});
@@ -402,8 +401,7 @@ function resolveLocaleVueParam(config) {
 		paths: localePathsOf(i18n)
 	});
 }
-//#endregion
-//#region src/dev/dev-scan.ts
+// src/dev/dev-scan.ts
 /** 触发扫描的目录名（相对 `srcDir`）。并集来自 core 与 vue 两个插件此前的清单。 */
 const DEV_SCAN_DIRS = [
 	"routes",
@@ -631,8 +629,7 @@ function onDevScan(server, handler) {
 	state.pending.add(handler);
 	return () => state.pending?.delete(handler);
 }
-//#endregion
-//#region src/dev/node-web.ts
+// src/dev/node-web.ts
 /**
 * `node:http` 请求 → Web `Request`。
 *
@@ -675,8 +672,7 @@ async function sendWebResponse(res, webRes) {
 	}
 	res.end();
 }
-//#endregion
-//#region src/dev/dev-request-router.ts
+// src/dev/dev-request-router.ts
 /**
 * Vite 内部的 URL 前缀。这些路径与文件系统无关，交回 Vite 才能正确解析。
 *
@@ -1147,8 +1143,7 @@ function ubeanDevRequestPlugin(options) {
 		}
 	};
 }
-//#endregion
-//#region src/vue-virtual-modules.ts
+// src/vue-virtual-modules.ts
 /**
 * 页面虚拟模块(`virtual:ubean-pages`)。
 *
@@ -1335,6 +1330,21 @@ export function resolveAppConfig(mode) {
   return merged;
 }
 
+/**
+ * 容器里是否真有服务端渲染的标记。
+ *
+ * ssr: false 时服务端仍会下发 __UBEAN_PAGE_DATA__（客户端要靠它拿路由/参数），
+ * 但 #app 是空的 —— 只按 initialPage 判断会走 createSSRApp 水合空容器，
+ * Vue 报 "Attempting to hydrate existing markup but container is empty"。
+ * CSR 外壳自带 data-ubean-ssr="false"，直接用它做判据。
+ */
+function _hasSsrMarkup(rootId) {
+  if (typeof document === 'undefined') return false;
+  const el = document.getElementById(rootId || 'app');
+  if (!el || el.getAttribute('data-ubean-ssr') === 'false') return false;
+  return el.childNodes.length > 0;
+}
+
 export async function createApp() {
   const config = resolveAppConfig('client');
   const head = createClientHead();
@@ -1369,7 +1379,7 @@ export async function createApp() {
     head,
     viewTransitions: config.viewTransitions,
     initialPage: initialPage || undefined,
-    hydrate: !!initialPage,
+    hydrate: !!initialPage && _hasSsrMarkup(config.rootId),
     router: config.router,
     loadingComponent,
     errorComponent,
@@ -1550,8 +1560,7 @@ export function resolveServerConfig(mode) {
 `.trim()}\n`;
 	});
 }
-//#endregion
-//#region src/vue-plugin.ts
+// src/vue-plugin.ts
 const VUE_PLUGIN_INCLUDE = [/\.vue$/, /\.md$/];
 /**
 * 懒加载 `@vitejs/plugin-vue-jsx`。
@@ -1914,5 +1923,4 @@ async function runPagefindIndexing(ubeanConfig, searchConfig) {
 		});
 	});
 }
-//#endregion
 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

@@ -1,8 +1,7 @@
-import { r as VirtualModuleRegistry, t as VirtualModule } from "./virtual-registry-CaU8k-YP.js";
+import { r as VirtualModuleRegistry, t as VirtualModule } from "./virtual-registry-CKfuFd5w.js";
 import { ResolvedConfig } from "@ubean/config";
 import { ScannedAppEntry, ScannedLayout, ScannedPageRoute, ScannedServerEntry } from "@ubean/scan";
 import { Plugin } from "vite";
-//#region src/vue-plugin.d.ts
 interface UbeanViteOptions {
   config: ResolvedConfig;
   ssr?: boolean;
@@ -22,8 +21,6 @@ interface UbeanViteOptions {
 }
 export declare const VUE_PLUGIN_INCLUDE: RegExp[];
 export declare function ubeanVite(options: UbeanViteOptions): Plugin[];
-//#endregion
-//#region src/vue-virtual-modules.d.ts
 /**
  * 页面虚拟模块(`virtual:ubean-pages`)。
  *
@@ -48,5 +45,4 @@ export declare function createVueAppEntryVirtualModule(appEntry?: ScannedAppEntr
 export declare function composeHeadScripts(colorModeScript: string): string;
 export declare function createClientEntryVirtualModule(): VirtualModule;
 export declare function createServerEntryVirtualModule(serverEntry?: ScannedServerEntry): VirtualModule;
-//#endregion
 export { type UbeanViteOptions, ubeanVite as default };

package/dist/vue.js

@@ -1 +1 @@
-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-Cr9byirH.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-BSQATqn6.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/build",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "Vite plugins, production build, SSG prerender, type codegen, and Server Actions plugin for ubean",
   "files": [
     "dist"
@@ -49,19 +49,19 @@
   },
   "dependencies": {
     "@intlify/unplugin-vue-i18n": "11.2.7",
-    "@ubean/app": "0.7.3",
-    "@ubean/client": "0.7.3",
-    "@ubean/config": "0.7.3",
-    "@ubean/i18n": "0.7.3",
-    "@ubean/islands": "0.7.3",
-    "@ubean/markdown": "0.7.3",
-    "@ubean/pages": "0.7.3",
-    "@ubean/preset": "0.7.3",
-    "@ubean/routes": "0.7.3",
-    "@ubean/scan": "0.7.3",
-    "@ubean/server": "0.7.3",
-    "@ubean/shared": "0.7.3",
-    "@ubean/vue": "0.7.3",
+    "@ubean/app": "0.7.5",
+    "@ubean/client": "0.7.5",
+    "@ubean/config": "0.7.5",
+    "@ubean/i18n": "0.7.5",
+    "@ubean/islands": "0.7.5",
+    "@ubean/markdown": "0.7.5",
+    "@ubean/pages": "0.7.5",
+    "@ubean/preset": "0.7.5",
+    "@ubean/routes": "0.7.5",
+    "@ubean/scan": "0.7.5",
+    "@ubean/server": "0.7.5",
+    "@ubean/shared": "0.7.5",
+    "@ubean/vue": "0.7.5",
     "@vitejs/plugin-vue": "^6.0.10",
     "@vitejs/plugin-vue-jsx": "^5.1.6",
     "openapi-typescript": "^7.13.0",
@@ -78,11 +78,11 @@
     "@vue/compiler-sfc": "^3.5.44",
     "hono": "4.13.13",
     "typescript": "npm:typescript-native-bridge@latest",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0",
-    "vite-plus": "1.3.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0",
+    "vite-plus": "1.4.0"
   },
   "peerDependencies": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0"
   },
   "peerDependenciesMeta": {
     "vite": {