@ubean/build 0.4.5 → 0.4.7

package/dist/actions-plugin.d.ts

@@ -1,6 +1,6 @@
 import { Plugin } from "vite";
 //#region src/actions-plugin.d.ts
-interface ServerActionsPluginOptions {
+export interface ServerActionsPluginOptions {
   /**
    * The project root directory (used for computing stable action IDs).
    * Defaults to `process.cwd()` at plugin creation time.
@@ -32,31 +32,30 @@ interface DefineActionCall {
  *
  * 跳过注释内的匹配(如 JSDoc 示例)和函数声明(`function defineAction(`)。
  */
-declare function findDefineActionCalls(code: string): DefineActionCall[];
+export declare function findDefineActionCalls(code: string): DefineActionCall[];
 /**
  * 检测源码是否包含 `defineAction(` 调用。
  */
-declare function hasDefineActionCall(code: string): boolean;
+export declare function hasDefineActionCall(code: string): boolean;
 /**
  * 服务端转换:为每个 `defineAction()` 调用注入 `filePath`(以及缺失时的 `name`),
  * 确保 action ID 在 dev / build 之间稳定。
  *
  * 返回转换后的代码;若无 `defineAction` 调用则返回 `null`。
  */
-declare function transformActionsForServer(code: string, filePath: string, root: string): string | null;
+export declare function transformActionsForServer(code: string, filePath: string, root: string): string | null;
 /**
  * 客户端转换:将每个 `defineAction(...)` 调用替换为
  * `__ubean_createActionStub('<id>')`(别名 import,避免与用户代码冲突)。
  *
  * 返回转换后的代码(含注入的 import);若无 `defineAction` 调用则返回 `null`。
  */
-declare function transformActionsForClient(code: string, filePath: string, root: string): string | null;
+export declare function transformActionsForClient(code: string, filePath: string, root: string): string | null;
 /**
  * Vite 插件:Server Actions 的客户端/服务端拆分。
  *
  *  - 服务端(SSR):注入 `filePath`/`name` 到 `defineAction()` 选项。
  *  - 客户端(浏览器):将 `defineAction(...)` 替换为 `createActionStub('<id>')`。
  */
-declare function ubeanServerActionsPlugin(options?: ServerActionsPluginOptions): Plugin;
-//#endregion
-export { ServerActionsPluginOptions, findDefineActionCalls, hasDefineActionCall, transformActionsForClient, transformActionsForServer, ubeanServerActionsPlugin };
+export declare function ubeanServerActionsPlugin(options?: ServerActionsPluginOptions): Plugin;
+//#endregion

package/dist/codegen/index.d.ts

@@ -35,9 +35,9 @@ interface ResolvedAutoImports {
   options: AutoImportOptions;
 }
 /** 将 `boolean | AutoImportOptions` 归一化为分库开关 + 透传选项。 */
-declare function resolveAutoImportsConfig(input: boolean | AutoImportOptions | undefined): ResolvedAutoImports;
+export declare function resolveAutoImportsConfig(input: boolean | AutoImportOptions | undefined): ResolvedAutoImports;
 /** 按分库开关组装内置预设（顺序稳定：ubean client/server → vue → vue-router → vue-i18n → hono-openapi）。 */
-declare function getAutoImportPresets(resolved: ResolvedAutoImports): InlinePreset[];
+export declare function getAutoImportPresets(resolved: ResolvedAutoImports): InlinePreset[];
 interface ResolvedComponentsAutoImport {
   /** 目录扫描 + dts 总开关（`components: false` 时为 `false`；resolver 仍然生效）。 */
   enabled: boolean;
@@ -47,28 +47,28 @@ interface ResolvedComponentsAutoImport {
   options: ComponentsOptions;
 }
 /** 将 `boolean | ComponentsOptions` 归一化。 */
-declare function resolveComponentsConfig(input: boolean | ComponentsOptions | undefined): ResolvedComponentsAutoImport;
+export declare function resolveComponentsConfig(input: boolean | ComponentsOptions | undefined): ResolvedComponentsAutoImport;
 /** unplugin 系选项普遍使用 `Arrayable<T>`，合并进数组前先归一化。 */
-declare function toArray<T>(value: T | T[] | undefined): T[];
-declare const VUE_PRESET: InlinePreset;
-declare const VUE_MACROS_PRESET: InlinePreset;
+export declare function toArray<T>(value: T | T[] | undefined): T[];
+export declare const VUE_PRESET: InlinePreset;
+export declare const VUE_MACROS_PRESET: InlinePreset;
 /**
  * Client-safe symbols sourced from the first-class `ubean/client` entry.
  * These are safe to auto-import in Vue components (browser-side) because
  * `@ubean/client` has zero build-time dependencies and no `node:*` imports.
  */
-declare const UBEAN_CLIENT_PRESET: InlinePreset;
+export declare const UBEAN_CLIENT_PRESET: InlinePreset;
 /**
  * vue-router composables, sourced directly from `vue-router` (not re-exported
  * through `ubean/client` — third-party APIs are imported from their own packages).
  */
-declare const VUE_ROUTER_PRESET: InlinePreset;
+export declare const VUE_ROUTER_PRESET: InlinePreset;
 /**
  * vue-i18n Composition API, sourced directly from `vue-i18n` (ubean no longer
  * wraps `useI18n` — same instance is exposed by the framework-installed
  * vue-i18n plugin; `t` is destructured from the returned composer).
  */
-declare const VUE_I18N_PRESET: InlinePreset;
+export declare const VUE_I18N_PRESET: InlinePreset;
 /**
  * Server-only symbols sourced from the `ubean/server` aggregation entry
  * (`@ubean/app` + `@ubean/routes` + `@ubean/server` + `@ubean/shared/node`).
@@ -85,9 +85,9 @@ declare const VUE_I18N_PRESET: InlinePreset;
  * unplugin-auto-import emit a "Duplicated imports" warning, so they live in
  * the client preset only.
  */
-declare const UBEAN_SERVER_PRESET: InlinePreset;
-declare const HONO_OPENAPI_PRESET: InlinePreset;
-declare const BUILTIN_PRESETS: InlinePreset[];
+export declare const UBEAN_SERVER_PRESET: InlinePreset;
+export declare const HONO_OPENAPI_PRESET: InlinePreset;
+export declare const BUILTIN_PRESETS: InlinePreset[];
 interface ComponentInfo {
   name: string;
   filePath: string;
@@ -100,8 +100,8 @@ interface AutoImportResult {
   autoImportsDtsPath: string;
   componentsDtsPath: string;
 }
-declare function generateAutoImports(_scanResult: ScanResult, options: GenerateAutoImportsOptions): Promise<AutoImportResult>;
-declare function getBuiltinComposables(): Import[];
+export declare function generateAutoImports(_scanResult: ScanResult, options: GenerateAutoImportsOptions): Promise<AutoImportResult>;
+export declare function getBuiltinComposables(): Import[];
 /** unplugin-auto-import 的组装结果（透传字段类型直接引用 unplugin 类型，避免跨包类型命名问题）。 */
 interface UbeanAutoImportConfig {
   imports: Options$1['imports'];
@@ -110,7 +110,7 @@ interface UbeanAutoImportConfig {
   vueTemplate: boolean;
   eslintrc: Options$1['eslintrc'];
 }
-declare function getUbeanAutoImportConfig(options?: {
+export declare function getUbeanAutoImportConfig(options?: {
   cwd?: string;
   srcDir?: string;
   buildDir?: string;
@@ -126,7 +126,7 @@ interface UbeanComponentsConfig {
   dts: Options['dts'];
   deep: boolean;
 }
-declare function getUbeanComponentsConfig(options?: {
+export declare function getUbeanComponentsConfig(options?: {
   cwd?: string;
   srcDir?: string;
   buildDir?: string;
@@ -135,7 +135,7 @@ declare function getUbeanComponentsConfig(options?: {
   /** `ubean.config.ts` 的 `components` 配置。 */
   components?: boolean | ComponentsOptions;
 }): UbeanComponentsConfig;
-declare function generateImportsTransform(imports: Import[]): {
+export declare function generateImportsTransform(imports: Import[]): {
   code: string;
   map?: null;
 };
@@ -147,12 +147,12 @@ interface RouteTypesOptions {
   outDir: string;
   fileName?: string;
 }
-declare function generateRouteTypes(result: ScanResult, options: RouteTypesOptions): Promise<string>;
+export declare function generateRouteTypes(result: ScanResult, options: RouteTypesOptions): Promise<string>;
 interface PageTypesOptions {
   outDir: string;
   fileName?: string;
 }
-declare function generatePageTypes(result: ScanResult, options: PageTypesOptions): Promise<string>;
+export declare function generatePageTypes(result: ScanResult, options: PageTypesOptions): Promise<string>;
 //#endregion
 //#region src/codegen/i18n-types.d.ts
 interface I18nTypesOptions {
@@ -161,13 +161,13 @@ interface I18nTypesOptions {
   defaultLocale?: string;
 }
 /** Convert a JSON message tree into a TypeScript object type body. */
-declare function messagesToTsType(value: unknown, indent?: number): string;
+export declare function messagesToTsType(value: unknown, indent?: number): string;
 /**
  * Generate `.ubean/i18n.d.ts` augmenting vue-i18n `DefineLocaleMessage`
  * from the default locale JSON. Users can also hand-write the same
  * module augmentation if they prefer.
  */
-declare function generateI18nTypes(result: ScanResult, options: I18nTypesOptions): Promise<string | null>;
+export declare function generateI18nTypes(result: ScanResult, options: I18nTypesOptions): Promise<string | null>;
 //#endregion
 //#region src/codegen/openapi-types.d.ts
 /**
@@ -187,7 +187,7 @@ interface GenerateOpenApiTypesOptions {
 /**
  * 从 OpenAPI schema 对象生成 paths 类型声明文件。
  */
-declare function generateOpenApiTypes(schema: unknown, options: GenerateOpenApiTypesOptions): Promise<string>;
+export declare function generateOpenApiTypes(schema: unknown, options: GenerateOpenApiTypesOptions): Promise<string>;
 /**
  * 从 dev server 的 `/_openapi.json` 路由获取 schema 并生成类型声明文件。
  *
@@ -195,18 +195,18 @@ declare function generateOpenApiTypes(schema: unknown, options: GenerateOpenApiT
  * HTML(页面 fallback)而非 JSON。此时跳过生成并返回 `null`,避免抛出
  * `Unexpected token '<'` 之类的误导性错误。
  */
-declare function generateOpenApiTypesFromServer(baseUrl: string, options: GenerateOpenApiTypesOptions): Promise<string | null>;
+export declare function generateOpenApiTypesFromServer(baseUrl: string, options: GenerateOpenApiTypesOptions): Promise<string | null>;
 //#endregion
 //#region src/codegen/index.d.ts
-declare const CODEGEN_CONTRACT_VERSION: 1;
-interface CodegenFileContract {
+export declare const CODEGEN_CONTRACT_VERSION: 1;
+export interface CodegenFileContract {
   name: string;
   module: string | null;
   required: boolean;
   types: string[];
 }
-declare const CODEGEN_FILES: readonly CodegenFileContract[];
-interface CodegenManifest {
+export declare const CODEGEN_FILES: readonly CodegenFileContract[];
+export interface CodegenManifest {
   contractVersion: typeof CODEGEN_CONTRACT_VERSION;
   generatedAt: string;
   files: Array<{
@@ -217,12 +217,12 @@ interface CodegenManifest {
     generated: boolean;
   }>;
 }
-interface CodegenOptions extends Omit<GenerateAutoImportsOptions, 'cwd' | 'srcDir' | 'buildDir'> {
+export interface CodegenOptions extends Omit<GenerateAutoImportsOptions, 'cwd' | 'srcDir' | 'buildDir'> {
   cwd: string;
   srcDir: string;
   buildDir: string;
 }
-interface CodegenResult {
+export interface CodegenResult {
   routeTypesPath: string;
   pageTypesPath: string;
   i18nTypesPath?: string | null;
@@ -230,6 +230,6 @@ interface CodegenResult {
   componentsDtsPath?: string;
   generated: string[];
 }
-declare function generateTypes(result: ScanResult, options: CodegenOptions): Promise<CodegenResult>;
+export declare function generateTypes(result: ScanResult, options: CodegenOptions): Promise<CodegenResult>;
 //#endregion
-export { type AutoImportResult, BUILTIN_PRESETS, CODEGEN_CONTRACT_VERSION, CODEGEN_FILES, CodegenFileContract, CodegenManifest, CodegenOptions, CodegenResult, type ComponentInfo, type GenerateAutoImportsOptions, type GenerateOpenApiTypesOptions, HONO_OPENAPI_PRESET, type I18nTypesOptions, type Import, type InlinePreset, type PageTypesOptions, type ResolvedAutoImports, type ResolvedComponentsAutoImport, type RouteTypesOptions, UBEAN_CLIENT_PRESET, UBEAN_SERVER_PRESET, VUE_I18N_PRESET, VUE_MACROS_PRESET, VUE_PRESET, VUE_ROUTER_PRESET, generateAutoImports, generateI18nTypes, generateImportsTransform, generateOpenApiTypes, generateOpenApiTypesFromServer, generatePageTypes, generateRouteTypes, generateTypes, getAutoImportPresets, getBuiltinComposables, getUbeanAutoImportConfig, getUbeanComponentsConfig, messagesToTsType, resolveAutoImportsConfig, resolveComponentsConfig, toArray };
+export type { AutoImportResult, ComponentInfo, GenerateAutoImportsOptions, GenerateOpenApiTypesOptions, I18nTypesOptions, Import, InlinePreset, PageTypesOptions, ResolvedAutoImports, ResolvedComponentsAutoImport, RouteTypesOptions };

package/dist/codegen/index.js

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

package/dist/{codegen-BqqGw4Dv.js → codegen-B3oGeRtK.js}

@@ -369,7 +369,8 @@ function generateComponentsDts(components, dtsPath) {
 	for (const name of [
 		"Link",
 		"Head",
-		"PageView"
+		"PageView",
+		"ClientOnly"
 	]) entries.set(name, `typeof import('ubean/client')['${name}']`);
 	for (const comp of components) {
 		const importPath = `./${toPosixPath(relative(dtsDir, toPosixPath(normalize(comp.filePath))))}`;

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import { a as defineVirtualModule, c as useVirtualRegistry, i as VirtualModuleTr
 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;
+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
 /**
@@ -32,28 +32,28 @@ type ComponentResolver = ((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;
+export declare function registerComponentResolver(resolver: ComponentResolver): void;
 /**
  * Get all registered component resolvers.
  * Called by `ubeanVite` when constructing the `Components()` plugin.
  */
-declare function getComponentResolvers(): ComponentResolver[];
+export 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;
+export declare function registerCssImport(cssPath: string): void;
 /**
  * Get all registered CSS import paths.
  * Called by `createClientEntryVirtualModule` to prepend CSS imports.
  */
-declare function getCssImports(): string[];
+export declare function getCssImports(): string[];
 /**
  * Reset the registry (for testing).
  * @internal
  */
-declare function resetModuleRegistry(): void;
+export declare function resetModuleRegistry(): void;
 //#endregion
 //#region src/ssr-singleton.d.ts
 /**
@@ -68,10 +68,10 @@ declare function resetModuleRegistry(): void;
  * - 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(): {
+export declare const SSR_SINGLETON_PACKAGES: readonly ["ubean", "@ubean/client", "@ubean/i18n", "vue-i18n", "@intlify/core", "@intlify/core-base"];
+export declare const SSR_SINGLETON_DEDUPE: readonly ["vue", "vue-i18n", "@ubean/client", "@ubean/i18n"];
+export declare const SSR_SINGLETON_OPTIMIZE_EXCLUDE: readonly ["ubean", "@ubean/client", "@ubean/i18n"];
+export declare function ssrSingletonDevPolicy(): {
   resolve: {
     dedupe: string[];
   };
@@ -84,16 +84,16 @@ declare function ssrSingletonDevPolicy(): {
     external: string[];
   };
 };
-declare function ssrSingletonProdSsr(): {
+export declare function ssrSingletonProdSsr(): {
   noExternal: string[];
 };
-declare function ssrSingletonProdOptimizeExclude(extra?: string[]): string[];
+export declare function ssrSingletonProdOptimizeExclude(extra?: string[]): string[];
 //#endregion
 //#region src/virtual-modules.d.ts
-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;
+export declare function createRoutingVirtualModule(routes: CompiledRoute[], middlewares: CompiledMiddleware[], cwd: string): VirtualModule;
+export declare function createPagesVirtualModule(pages: CompiledPage[], layouts: CompiledLayout[], cwd: string): VirtualModule;
+export declare function createMetaVirtualModule(): VirtualModule;
+export declare function createAppVirtualModule(apiRoutes: ScannedApiRoute[], middlewares: ScannedMiddleware[], pages: ScannedPageRoute[], srcDir: string): VirtualModule;
+export declare function createLocalesVirtualModule(_locales: ScannedLocale[], defaultLocale: string | undefined, srcDir?: string, i18nConfigJson?: string): VirtualModule;
 //#endregion
-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 };
+export { type VirtualModule, type VirtualModuleContext, VirtualModuleRegistry, type VirtualModuleTransform, defineVirtualModule, defineVirtualModulePrefix, resetVirtualRegistry, useVirtualRegistry };

package/dist/prerender.d.ts

@@ -2,7 +2,7 @@ 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 {
+export interface PrerendererOptions {
   cwd: string;
   outputDir: string;
   pages: ScannedPageRoute[];
@@ -48,7 +48,7 @@ interface PrerendererOptions {
  * 返回的路径列表会进一步与 `pages` 候选池匹配(glob 模式)或直接加入(具体路径)。
  * 动态路由的具象值(如 `/blog/hello-world`)可通过具体路径直接加入。
  */
-declare function extractPrerenderRoutesFromRules(routeRules: Record<string, RouteRule$1> | undefined): string[];
+export declare function extractPrerenderRoutesFromRules(routeRules: Record<string, RouteRule$1> | undefined): string[];
 /**
  * 收集需要预渲染的路由列表。
  *
@@ -62,7 +62,7 @@ declare function extractPrerenderRoutesFromRules(routeRules: Record<string, Rout
  *
  * 返回的 `skipped` 为被 `exclude` 命中的路由集合。
  */
-declare function collectPrerenderRoutes(pages: ScannedPageRoute[], options?: {
+export declare function collectPrerenderRoutes(pages: ScannedPageRoute[], options?: {
   all?: boolean;
   include?: string[];
   exclude?: string[];
@@ -74,7 +74,7 @@ declare function collectPrerenderRoutes(pages: ScannedPageRoute[], options?: {
   routes: string[];
   skipped: string[];
 };
-declare function extractLinks(html: string, baseUrl?: string): string[];
+export declare function extractLinks(html: string, baseUrl?: string): string[];
 /**
  * 将路由路径映射到磁盘文件路径。
  *
@@ -87,7 +87,7 @@ declare function extractLinks(html: string, baseUrl?: string): string[];
  * 处理带扩展名路由是为了避免 `/robots.txt/index.html`、`/sitemap.xml/index.html`
  * 这种被错误转成目录的产物。
  */
-declare function routeToFilePath(route: string, outputDir: string): string;
+export declare function routeToFilePath(route: string, outputDir: string): string;
 /**
  * 将路由路径映射到对应的 `__data.json` 文件路径。
  *
@@ -99,11 +99,11 @@ declare function routeToFilePath(route: string, outputDir: string): string;
  * 与 HTML 不同,这里不需要处理扩展名路由(`.html`/`.txt` 等)—— payload
  * 仅对页面路由有意义,扩展名路由(如 `/robots.txt`)不参与 payload 提取。
  */
-declare function routeToDataFilePath(route: string, outputDir: string): string;
+export declare function routeToDataFilePath(route: string, outputDir: string): string;
 /**
  * `extractDataPayload` 的返回结构。
  */
-interface ExtractedPayload {
+export interface ExtractedPayload {
   /** 从 `__UBEAN_DATA__` 解析出的 payload 数据。 */
   data: Record<string, unknown>;
   /** 替换内联 script 后的 HTML(包含 preload link + 引导脚本)。 */
@@ -126,10 +126,10 @@ interface ExtractedPayload {
  * @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): {
+export declare function extractDataPayload(html: string, route: string): ExtractedPayload | null;
+export declare function writePrerenderedFile(filePath: string, html: string): Promise<void>;
+export declare function prerender(options: PrerendererOptions): Promise<PrerenderResult>;
+export declare function generatePrerenderManifest(result: PrerenderResult, baseUrl?: string): {
   routes: string[];
   generatedAt: string;
   errors: Array<{
@@ -138,4 +138,4 @@ declare function generatePrerenderManifest(result: PrerenderResult, baseUrl?: st
   }>;
 };
 //#endregion
-export { ExtractedPayload, PrerendererOptions, type RouteRule, collectPrerenderRoutes, extractDataPayload, extractLinks, extractPrerenderRoutesFromRules, generatePrerenderManifest, prerender, routeToDataFilePath, routeToFilePath, writePrerenderedFile };
+export type { RouteRule };

package/dist/production.d.ts

@@ -2,7 +2,7 @@ import { ResolvedConfig } from "@ubean/config";
 import { ScanResult } from "@ubean/scan";
 import { Preset } from "@ubean/preset";
 //#region src/production.d.ts
-interface BuildOptions {
+export interface BuildOptions {
   cwd: string;
   config: ResolvedConfig;
   preset: Preset;
@@ -12,7 +12,7 @@ interface BuildOptions {
   /** Inlined content collections for production SSR (`queryCollection`). */
   contentSnapshot?: Record<string, unknown[]>;
 }
-interface BuildManifest {
+export interface BuildManifest {
   assets: Array<{
     file: string;
     src?: string;
@@ -24,6 +24,5 @@ interface BuildManifest {
   serverDir: string;
   preset: string;
 }
-declare function buildProduction(options: BuildOptions): Promise<BuildManifest>;
-//#endregion
-export { BuildManifest, BuildOptions, buildProduction };
+export declare function buildProduction(options: BuildOptions): Promise<BuildManifest>;
+//#endregion

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-CIj7ErAs.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";

package/dist/static-render.d.ts

@@ -1,8 +1,8 @@
 import { ScannedPageRoute } from "@ubean/scan";
 //#region src/static-render.d.ts
 /** 哨兵路由：prerender 队列中的 404 页标记，产物映射为 `404.html` */
-declare const STATIC_NOT_FOUND_ROUTE = "/__ubean_404__";
-interface CompiledPageRoute {
+export declare const STATIC_NOT_FOUND_ROUTE = "/__ubean_404__";
+export interface CompiledPageRoute {
   page: ScannedPageRoute;
   regex: RegExp;
   /** 捕获组顺序对应的参数名 */
@@ -24,8 +24,8 @@ interface CompiledPageRoute {
  *    - `/blog/:slug(.*)*`（自定义正则 + 可重复 = catch-all）
  *    - `/users/:id(\\d+)`（自定义正则）
  */
-declare function compilePageRoute(page: ScannedPageRoute): CompiledPageRoute;
-interface StaticRouteMatch {
+export declare function compilePageRoute(page: ScannedPageRoute): CompiledPageRoute;
+export interface StaticRouteMatch {
   page: ScannedPageRoute;
   params: Record<string, string>;
 }
@@ -35,7 +35,7 @@ interface StaticRouteMatch {
  * 匹配顺序（确定性）：静态段多者优先 → catch-all 最后 → 同分保持传入顺序。
  * 参数值经 `decodeURIComponent` 解码（对齐 Hono `c.req.param()` 行为）。
  */
-declare function matchRoutePattern(pages: Array<ScannedPageRoute | CompiledPageRoute>, path: string): StaticRouteMatch | null;
+export declare function matchRoutePattern(pages: Array<ScannedPageRoute | CompiledPageRoute>, path: string): StaticRouteMatch | null;
 /**
  * 按路由策略将收集到的路由展开为全语言 URL 列表。
  *
@@ -50,8 +50,8 @@ declare function matchRoutePattern(pages: Array<ScannedPageRoute | CompiledPageR
  * - 404 哨兵路由不展开（静态托管平台仅认单份 `404.html`）
  * - 已带 locale 前缀的 URL（crawlLinks 发现）保持原样，避免 `/zh/zh/about`
  */
-declare function expandRoutesForLocales(routes: string[], i18n: StaticSsgRendererI18nInit): string[];
-interface StaticSsgRendererI18nInit {
+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;
@@ -59,7 +59,7 @@ interface StaticSsgRendererI18nInit {
     code: string;
   }>;
 }
-interface StaticSsgRendererInit {
+export interface StaticSsgRendererInit {
   /** 扫描得到的页面（含动态路由模式，供具象 URL 匹配） */
   pages: ScannedPageRoute[];
   /** `pages/404.vue` 自动检测的 404 页（可选） */
@@ -67,17 +67,17 @@ interface StaticSsgRendererInit {
   /** i18n 配置（用于 locale 前缀剥离与默认语言） */
   i18n?: StaticSsgRendererI18nInit;
 }
-interface RenderStaticPageInput {
+export interface RenderStaticPageInput {
   pageName: string;
   params: Record<string, string>;
   url: string;
   locale?: string;
 }
-type RenderStaticPageFn = (input: RenderStaticPageInput) => Promise<{
+export type RenderStaticPageFn = (input: RenderStaticPageInput) => Promise<{
   html: string;
   statusCode: number;
 }>;
-interface StaticSsgRenderer {
+export interface StaticSsgRenderer {
   /** 与 `PrerendererOptions.fetcher` 同构的契约 */
   fetcher: (url: string) => Promise<{
     html: string;
@@ -94,8 +94,7 @@ interface StaticSsgRenderer {
  * 失败（entry 缺失 / 无 renderStaticPage 导出 / 加载异常）返回 `undefined`，
  * 由调用方降级（warn + placeholder prerender）。
  */
-declare function createStaticSsgRenderer(cwd: string, manifest: {
+export declare function createStaticSsgRenderer(cwd: string, manifest: {
   serverDir: string;
 }, init: StaticSsgRendererInit): Promise<StaticSsgRenderer | undefined>;
-//#endregion
-export { CompiledPageRoute, RenderStaticPageFn, RenderStaticPageInput, STATIC_NOT_FOUND_ROUTE, StaticRouteMatch, StaticSsgRenderer, StaticSsgRendererI18nInit, StaticSsgRendererInit, compilePageRoute, createStaticSsgRenderer, expandRoutesForLocales, matchRoutePattern };
+//#endregion

package/dist/vite.d.ts

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

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

@@ -1,6 +1,6 @@
 import { a as useVirtualRegistry, n as defineVirtualModule } from "./virtual-registry-BWkaQHXN.js";
 import { c as getCssImports, i as ssrSingletonDevPolicy, s as getComponentResolvers } from "./ssr-singleton-CEQi_H6-.js";
-import { E as toArray, T as resolveComponentsConfig, b as getAutoImportPresets, w as resolveAutoImportsConfig } from "./codegen-BqqGw4Dv.js";
+import { E as toArray, T as resolveComponentsConfig, b as getAutoImportPresets, w as resolveAutoImportsConfig } from "./codegen-B3oGeRtK.js";
 import { createRequire } from "node:module";
 import { join, resolve } from "pathe";
 import { scanProject } from "@ubean/scan";
@@ -630,7 +630,8 @@ function ubeanVite(options) {
 	const UBEAN_BUILTIN_COMPONENTS = [
 		"Link",
 		"Head",
-		"PageView"
+		"PageView",
+		"ClientOnly"
 	];
 	function ubeanComponentsResolver(componentName) {
 		if (UBEAN_BUILTIN_COMPONENTS.includes(componentName)) return {

package/dist/vue.d.ts

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

package/dist/vue.js

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

package/package.json

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