@ubean/client 0.4.4 → 0.4.6

package/dist/{app-BQgi-8Qp.d.ts → app-Busq_M7n.d.ts}

@@ -1,6 +1,7 @@
+import { i as RouterConfig } from "./define-app-RzHOZlYB.js";
 import { App, Component } from "vue";
-import { RouteRecordRaw, Router } from "vue-router";
-import { ERROR_KEY as ERROR_KEY$1, LAYOUT_CHAIN_KEY, LOADING_KEY as LOADING_KEY$1, LOCALIZE_PATH_KEY as LOCALIZE_PATH_KEY$1, LayoutChainContext, LayoutChainRenderer as LayoutChainRenderer$1, Link, PAGE_KEY as PAGE_KEY$1, PageMeta, PageView, SSR_KEY as SSR_KEY$1, SlotView, TRANSITION_KEY as TRANSITION_KEY$1, UbeanVueOptions, ViewTransitionOptions, ubeanVue, useViewTransition } from "@ubean/vue";
+import { RouteRecordRaw, Router, RouterOptions } from "vue-router";
+import { ClientOnly, ERROR_KEY as ERROR_KEY$1, LAYOUT_CHAIN_KEY, LOADING_KEY as LOADING_KEY$1, LOCALIZE_PATH_KEY as LOCALIZE_PATH_KEY$1, LayoutChainContext, LayoutChainRenderer as LayoutChainRenderer$1, Link, PAGE_KEY as PAGE_KEY$1, PageMeta, PageView, SSR_KEY as SSR_KEY$1, SlotView, TRANSITION_KEY as TRANSITION_KEY$1, UbeanVueOptions, ViewTransitionOptions, ubeanVue, useViewTransition } from "@ubean/vue";
 import { VueHeadClient, useHead as useUnheadHead, useSeoMeta } from "@unhead/vue";
 import { PageObject } from "@ubean/pages";
 import { I18n } from "vue-i18n";
@@ -21,6 +22,15 @@ interface CreateUbeanRouterOptions {
    * 该回调在 Client 和 SSR 环境都会执行。
    */
   setup?: (router: Router) => void;
+  /**
+   * vue-router `scrollBehavior`,覆盖默认滚动策略。
+   *
+   * 默认行为:返回顶部;带 hash 时仅当目标元素已存在才平滑滚动。
+   * 客户端延迟生成的锚点(如 SSR 后由客户端渲染的标题 id)在首次导航时
+   * 可能尚不存在,直接返回 `{ el }` 会触发 VUE_ROUTER_R0042,因此默认
+   * 先探测元素存在性。
+   */
+  scrollBehavior?: RouterOptions['scrollBehavior'];
 }
 declare function createUbeanRouter(options: CreateUbeanRouterOptions): Router;
 //#endregion
@@ -65,12 +75,12 @@ interface UbeanAppOptions {
   viewTransitions?: boolean | ViewTransitionOptions;
   hydrate?: boolean;
   /**
-   * 在 router 实例创建后、`app.use(router)` 之前调用,
-   * 用于注册 vue-router 的导航守卫(`beforeEach` / `beforeResolve` / `afterEach`)。
-   *
-   * Client 和 SSR 都会执行。守卫注册必须同步完成(守卫本身可返回 Promise)。
+   * router 配置(setup 守卫 + scrollBehavior 等初始化选项)。
+   * Client 和 SSR 都会执行;setup 注册守卫必须同步完成。
+   * 来自 `defineApp({ router })`,由 `virtual:ubean-app` / `virtual:ubean-server`
+   * 在调用本工厂前通过 `resolveAppConfig()` 合并注入。
    */
-  routerSetup?: (router: ReturnType<typeof createUbeanRouter>) => void;
+  router?: RouterConfig;
   /**
    * 页面加载时的 fallback 组件,在 SPA 导航懒加载页面组件期间显示。
    * 来源:`pages/loading.vue` 自动检测 或 `defineApp({ loadingComponent })` 显式配置。
@@ -124,4 +134,4 @@ declare function createUbeanSSRApp(initialPage: PageObject, options: Omit<UbeanA
 };
 declare const Head: import("vue").DefineComponent;
 //#endregion
-export { defineMeta as C, usePage as D, UbeanVuePage as E, CreateUbeanRouterOptions as O, useViewTransition as S, definePage as T, createUbeanClientApp as _, LOCALIZE_PATH_KEY$1 as a, useSeoMeta as b, Link as c, SSR_KEY$1 as d, SlotView as f, UbeanVueOptions as g, UbeanAppOptions as h, LOADING_KEY$1 as i, createUbeanRouter as k, PAGE_KEY$1 as l, UbeanAppInstance as m, Head as n, LayoutChainContext as o, TRANSITION_KEY$1 as p, LAYOUT_CHAIN_KEY as r, LayoutChainRenderer$1 as s, ERROR_KEY$1 as t, PageView as u, createUbeanSSRApp as v, defineMiddleware as w, useUnheadHead as x, ubeanVue as y };
+export { createUbeanRouter as A, useViewTransition as C, UbeanVuePage as D, definePage as E, usePage as O, useUnheadHead as S, defineMiddleware as T, UbeanVueOptions as _, LOADING_KEY$1 as a, ubeanVue as b, LayoutChainRenderer$1 as c, PageView as d, SSR_KEY$1 as f, UbeanAppOptions as g, UbeanAppInstance as h, LAYOUT_CHAIN_KEY as i, CreateUbeanRouterOptions as k, Link as l, TRANSITION_KEY$1 as m, ERROR_KEY$1 as n, LOCALIZE_PATH_KEY$1 as o, SlotView as p, Head as r, LayoutChainContext as s, ClientOnly as t, PAGE_KEY$1 as u, createUbeanClientApp as v, defineMeta as w, useSeoMeta as x, createUbeanSSRApp as y };

package/dist/{app-DiXW_14_.js → app-COSjPzyK.js}

@@ -1,7 +1,7 @@
 import { a as getI18nRuntimeConfig, l as localizePath, r as createUbeanI18n, s as initClientI18n, t as bindI18nRuntime } from "./i18n-CAeXKTpy.js";
 import { computed, createApp, createSSRApp, defineComponent, h, inject, markRaw, provide, reactive, shallowRef, watchEffect } from "vue";
 import { createMemoryHistory, createRouter, createWebHistory, useRoute } from "vue-router";
-import { ERROR_KEY, ERROR_KEY as ERROR_KEY$1, LAYOUT_CHAIN_KEY, LOADING_KEY, LOADING_KEY as LOADING_KEY$1, LOCALIZE_PATH_KEY, LOCALIZE_PATH_KEY as LOCALIZE_PATH_KEY$1, LayoutChainRenderer, LayoutChainRenderer as LayoutChainRenderer$1, Link, PAGE_KEY, PAGE_KEY as PAGE_KEY$1, PageView, SSR_KEY, SSR_KEY as SSR_KEY$1, SlotView, TRANSITION_KEY, TRANSITION_KEY as TRANSITION_KEY$1, initCachedViewsFromRoutes, ubeanVue, useViewTransition } from "@ubean/vue";
+import { ClientOnly, ERROR_KEY, ERROR_KEY as ERROR_KEY$1, LAYOUT_CHAIN_KEY, LOADING_KEY, LOADING_KEY as LOADING_KEY$1, LOCALIZE_PATH_KEY, LOCALIZE_PATH_KEY as LOCALIZE_PATH_KEY$1, LayoutChainRenderer, LayoutChainRenderer as LayoutChainRenderer$1, Link, PAGE_KEY, PAGE_KEY as PAGE_KEY$1, PageView, SSR_KEY, SSR_KEY as SSR_KEY$1, SlotView, TRANSITION_KEY, TRANSITION_KEY as TRANSITION_KEY$1, initCachedViewsFromRoutes, ubeanVue, useViewTransition } from "@ubean/vue";
 import { useHead as useUnheadHead, useSeoMeta } from "@unhead/vue";
 import { vClient } from "@ubean/islands/directive";
 import { Head } from "@unhead/vue/components";
@@ -48,19 +48,24 @@ function createUbeanRouter(options) {
 	const router = createRouter({
 		history,
 		routes: options.routes,
-		scrollBehavior(_to, _from, savedPosition) {
-			if (savedPosition) return savedPosition;
-			if (_to.hash) return {
-				el: _to.hash,
-				behavior: "smooth"
-			};
-			return { top: 0 };
-		}
+		scrollBehavior: options.scrollBehavior ?? defaultScrollBehavior
 	});
 	if (options.setup) options.setup(router);
 	if (options.ssr && options.initialUrl) router.push(options.initialUrl);
 	return router;
 }
+/**
+* 默认滚动策略:返回顶部;带 hash 时仅在目标元素已存在时平滑滚动,
+* 否则返回 `false`(跳过滚动,避免 VUE_ROUTER_R0042 告警)。
+*/
+function defaultScrollBehavior(to, _from, savedPosition) {
+	if (savedPosition) return savedPosition;
+	if (to.hash) return typeof document !== "undefined" && document.querySelector(to.hash) ? {
+		el: to.hash,
+		behavior: "smooth"
+	} : false;
+	return { top: 0 };
+}
 //#endregion
 //#region src/page-macro.ts
 function definePage(_meta) {}
@@ -185,7 +190,8 @@ function createUbeanClientApp(options) {
 	const router = createUbeanRouter({
 		routes: options.routes,
 		ssr: false,
-		setup: options.routerSetup
+		setup: options.router?.setup,
+		scrollBehavior: options.router?.scrollBehavior
 	});
 	const { LayoutView: ClientLayoutWrapper, loadLayoutsForRoute: loadClientLayouts } = createLayoutWrapper(options.resolveLayoutComponent, options.defaultLayout || null);
 	initCachedViewsFromRoutes(options.routes);
@@ -200,6 +206,7 @@ function createUbeanClientApp(options) {
 	app.component("Link", Link);
 	app.component("PageView", PageView);
 	app.component("SlotView", SlotView);
+	app.component("ClientOnly", ClientOnly);
 	app.directive("client", vClient);
 	app.config.globalProperties.$ubean = {
 		page,
@@ -223,7 +230,8 @@ function createUbeanSSRApp(initialPage, options) {
 		routes: options.routes,
 		ssr: true,
 		initialUrl: initialPage.url,
-		setup: options.routerSetup
+		setup: options.router?.setup,
+		scrollBehavior: options.router?.scrollBehavior
 	});
 	const { LayoutView: SsrLayoutWrapper, loadLayoutsForRoute: loadSsrLayouts } = createLayoutWrapper(options.resolveLayoutComponent, options.defaultLayout || null);
 	initCachedViewsFromRoutes(options.routes);
@@ -238,6 +246,7 @@ function createUbeanSSRApp(initialPage, options) {
 	app.component("Link", Link);
 	app.component("PageView", PageView);
 	app.component("SlotView", SlotView);
+	app.component("ClientOnly", ClientOnly);
 	app.directive("client", vClient);
 	app.config.globalProperties.$ubean = {
 		page,
@@ -253,4 +262,4 @@ function createUbeanSSRApp(initialPage, options) {
 }
 const Head$1 = Head;
 //#endregion
-export { usePage as C, createUbeanRouter as S, useUnheadHead as _, LOCALIZE_PATH_KEY$1 as a, defineMiddleware as b, PAGE_KEY$1 as c, SlotView as d, TRANSITION_KEY$1 as f, useSeoMeta as g, ubeanVue as h, LOADING_KEY$1 as i, PageView as l, createUbeanSSRApp as m, Head$1 as n, LayoutChainRenderer$1 as o, createUbeanClientApp as p, LAYOUT_CHAIN_KEY as r, Link as s, ERROR_KEY$1 as t, SSR_KEY$1 as u, useViewTransition as v, definePage as x, defineMeta as y };
+export { createUbeanRouter as C, definePage as S, useSeoMeta as _, LOADING_KEY$1 as a, defineMeta as b, Link as c, SSR_KEY$1 as d, SlotView as f, ubeanVue as g, createUbeanSSRApp as h, LAYOUT_CHAIN_KEY as i, PAGE_KEY$1 as l, createUbeanClientApp as m, ERROR_KEY$1 as n, LOCALIZE_PATH_KEY$1 as o, TRANSITION_KEY$1 as p, Head$1 as r, LayoutChainRenderer$1 as s, ClientOnly as t, PageView as u, useUnheadHead as v, usePage as w, defineMiddleware as x, useViewTransition as y };

package/dist/app.d.ts

@@ -1,2 +1,2 @@
-import { C as defineMeta, D as usePage, E as UbeanVuePage, O as CreateUbeanRouterOptions, S as useViewTransition, T as definePage, _ as createUbeanClientApp, a as LOCALIZE_PATH_KEY, b as useSeoMeta, c as Link, d as SSR_KEY, f as SlotView, g as UbeanVueOptions, h as UbeanAppOptions, i as LOADING_KEY, k as createUbeanRouter, l as PAGE_KEY, m as UbeanAppInstance, n as Head, o as LayoutChainContext, p as TRANSITION_KEY, r as LAYOUT_CHAIN_KEY, s as LayoutChainRenderer, t as ERROR_KEY, u as PageView, v as createUbeanSSRApp, w as defineMiddleware, x as useUnheadHead, y as ubeanVue } from "./app-BQgi-8Qp.js";
-export { type CreateUbeanRouterOptions, ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, type LayoutChainContext, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, UbeanAppInstance, UbeanAppOptions, type UbeanVueOptions, type UbeanVuePage, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };
+import { A as createUbeanRouter, C as useViewTransition, D as UbeanVuePage, E as definePage, O as usePage, S as useUnheadHead, T as defineMiddleware, _ as UbeanVueOptions, a as LOADING_KEY, b as ubeanVue, c as LayoutChainRenderer, d as PageView, f as SSR_KEY, g as UbeanAppOptions, h as UbeanAppInstance, i as LAYOUT_CHAIN_KEY, k as CreateUbeanRouterOptions, l as Link, m as TRANSITION_KEY, n as ERROR_KEY, o as LOCALIZE_PATH_KEY, p as SlotView, r as Head, s as LayoutChainContext, t as ClientOnly, u as PAGE_KEY, v as createUbeanClientApp, w as defineMeta, x as useSeoMeta, y as createUbeanSSRApp } from "./app-Busq_M7n.js";
+export { ClientOnly, type CreateUbeanRouterOptions, ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, type LayoutChainContext, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, UbeanAppInstance, UbeanAppOptions, type UbeanVueOptions, type UbeanVuePage, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };

package/dist/app.js

@@ -1,2 +1,2 @@
-import { C as usePage, S as createUbeanRouter, _ as useUnheadHead, a as LOCALIZE_PATH_KEY, b as defineMiddleware, c as PAGE_KEY, d as SlotView, f as TRANSITION_KEY, g as useSeoMeta, h as ubeanVue, i as LOADING_KEY, l as PageView, m as createUbeanSSRApp, n as Head, o as LayoutChainRenderer, p as createUbeanClientApp, r as LAYOUT_CHAIN_KEY, s as Link, t as ERROR_KEY, u as SSR_KEY, v as useViewTransition, x as definePage, y as defineMeta } from "./app-DiXW_14_.js";
-export { ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };
+import { C as createUbeanRouter, S as definePage, _ as useSeoMeta, a as LOADING_KEY, b as defineMeta, c as Link, d as SSR_KEY, f as SlotView, g as ubeanVue, h as createUbeanSSRApp, i as LAYOUT_CHAIN_KEY, l as PAGE_KEY, m as createUbeanClientApp, n as ERROR_KEY, o as LOCALIZE_PATH_KEY, p as TRANSITION_KEY, r as Head, s as LayoutChainRenderer, t as ClientOnly, u as PageView, v as useUnheadHead, w as usePage, x as defineMiddleware, y as useViewTransition } from "./app-COSjPzyK.js";
+export { ClientOnly, ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };

package/dist/define-app-RzHOZlYB.d.ts

@@ -0,0 +1,179 @@
+import { App, Component, Plugin } from "vue";
+import { Router, RouterOptions } from "vue-router";
+import { ViewTransitionOptions } from "@ubean/vue";
+import { PageHead } from "@ubean/shared";
+//#region src/define-app.d.ts
+interface AppPluginConfig {
+  plugin: Plugin | [Plugin, ...any[]];
+  mode?: 'all' | 'client' | 'server';
+}
+/**
+ * Router 钩子配置 — 暴露 vue-router 的导航守卫注册入口 + 初始化选项。
+ *
+ * `setup(router)` 在 router 实例创建后、`app.use(router)` 之前调用,
+ * 因此守卫能拦截首次导航(包括 SSR 的初始 URL push)。
+ *
+ * Client 和 SSR 都会执行,适合做鉴权、埋点、进度条等逻辑。
+ *
+ * @example
+ * ```ts
+ * defineApp({
+ *   router: {
+ *     setup(router) {
+ *       router.beforeEach((to, from) => {
+ *         if (to.meta.requiresAuth && !isAuthenticated()) {
+ *           return '/login';
+ *         }
+ *       });
+ *       router.afterEach((to) => {
+ *         analytics.track('page_view', { path: to.fullPath });
+ *       });
+ *     },
+ *     scrollBehavior(to, from, savedPosition) {
+ *       // 覆盖默认滚动策略(默认已守卫 hash 目标元素不存在时的 R0042)
+ *       if (savedPosition) return savedPosition;
+ *       if (to.hash) return { el: to.hash, behavior: 'smooth' };
+ *       return { top: 0 };
+ *     }
+ *   }
+ * });
+ * ```
+ */
+interface RouterConfig {
+  /**
+   * 在 router 创建后、初始导航前调用。
+   * 用于注册 `beforeEach` / `beforeResolve` / `afterEach` 等守卫。
+   *
+   * 注意:setup 必须同步注册守卫(虽然守卫本身可以返回 Promise)。
+   * 不要在 setup 中执行异步操作(如请求 API),因为这会延迟首次导航。
+   */
+  setup?: (router: Router) => void;
+  /**
+   * vue-router `scrollBehavior`,覆盖 `createUbeanRouter` 的默认滚动策略。
+   * 未配置时使用框架默认:回到顶部;带 hash 且目标元素存在时平滑滚动。
+   */
+  scrollBehavior?: RouterOptions['scrollBehavior'];
+}
+interface DefineAppOptions {
+  plugins?: Array<Plugin | [Plugin, ...any[]] | AppPluginConfig>;
+  globalComponents?: Record<string, Component>;
+  provides?: Record<string | symbol, unknown>;
+  head?: PageHead;
+  rootId?: string;
+  rootAttrs?: Record<string, string>;
+  /**
+   * 应用根组件(包装组件,可选)—— 经典 Vue `App.vue` 的编程式等价物。
+   *
+   * 组件包裹在框架根组件(`UbeanAppRoot`)之上,框架出口(布局链 + 页面)
+   * 通过**默认 slot** 注入,组件内用 `<slot />` 声明渲染位置:
+   *
+   * ```vue
+   * <!-- src/app.ts 对应的 AppRoot.vue -->
+   * <template>
+   *   <SConfigProvider>
+   *     <AppHeader />
+   *     <slot /> <!-- 布局链 + 页面在这里渲染 -->
+   *   </SConfigProvider>
+   * </template>
+   * ```
+   *
+   * 适合放置"必须在布局之上"的全局内容:全局 ConfigProvider/主题上下文、
+   * 覆盖布局自身的错误边界、全局过渡/动效容器等。不要用它渲染
+   * `<PageView />` / `<RouterView />` —— 那会绕过布局链;出口是 `<slot />`。
+   *
+   * 自动检测:`src/app.vue`(小写,Nuxt 风格,优先)/ `src/App.vue`
+   * (大写,经典 Vue 约定)文件约定(与 loading/error 特殊页同模式),
+   * 两者都存在时取小写;无该文件时忽略。优先级:
+   * `defineApp({ appRoot })` > `src/app.vue` > `src/App.vue`。
+   */
+  appRoot?: Component;
+  /**
+   * 路由钩子配置,用于注册 vue-router 的导航守卫。
+   * 在 Client 和 SSR 都会执行。
+   */
+  router?: RouterConfig;
+  onAppCreated?: (app: App) => void | Promise<void>;
+  onClientReady?: (app: App) => void | Promise<void>;
+  errorComponent?: Component;
+  loadingComponent?: Component;
+  viewTransitions?: boolean | ViewTransitionOptions;
+  /**
+   * SSR 专用:在 `renderToString(app)` 完成后调用,从 app 实例提取需要
+   * 序列化到客户端的状态(如 Pinia 的 `pinia.state.value`)。
+   *
+   * 返回的对象会被 `safeJsonStringify` 序列化并注入到 HTML 的
+   * `__UBEAN_STATE__` script 标签中。
+   *
+   * 仅在 server mode 下生效;client mode 下被忽略。
+   *
+   * @example
+   * ```ts
+   * import { createPinia } from 'pinia';
+   * defineApp({
+   *   plugins: [createPinia()],
+   *   serializeState: (app) => ({
+   *     pinia: app.config.globalProperties.$pinia.state.value
+   *   })
+   * });
+   * ```
+   */
+  serializeState?: (app: App) => Record<string, unknown> | Promise<Record<string, unknown>>;
+  /**
+   * Client 专用:在 `applyAppConfig`(注册插件/provide)之后、`app.mount()` 之前调用,
+   * 用于从 `__UBEAN_STATE__` 反序列化的状态回填到 app(如 Pinia 的水合)。
+   *
+   * `state` 即 `serializeState` 在服务端返回的对象;若服务端未配置 `serializeState`
+   * 或返回空,`state` 为 `null`。
+   *
+   * 仅在 client mode 下生效;server mode 下被忽略。
+   *
+   * @example
+   * ```ts
+   * import { createPinia } from 'pinia';
+   * defineApp({
+   *   plugins: [createPinia()],
+   *   hydrateState: (app, state) => {
+   *     if (state?.pinia) {
+   *       app.config.globalProperties.$pinia.state.value = state.pinia;
+   *     }
+   *   }
+   * });
+   * ```
+   */
+  hydrateState?: (app: App, state: Record<string, unknown> | null) => void;
+}
+interface ResolvedAppConfig {
+  plugins: AppPluginConfig[];
+  globalComponents: Record<string, Component>;
+  provides: Record<string | symbol, unknown>;
+  head?: PageHead;
+  rootId: string;
+  rootAttrs: Record<string, string>;
+  /**
+   * 应用根组件(包装组件,可选)。语义见 `DefineAppOptions.appRoot`。
+   */
+  appRoot?: Component;
+  router?: RouterConfig;
+  onAppCreated?: (app: App) => void | Promise<void>;
+  onClientReady?: (app: App) => void | Promise<void>;
+  errorComponent?: Component;
+  loadingComponent?: Component;
+  viewTransitions?: boolean | ViewTransitionOptions;
+  serializeState?: (app: App) => Record<string, unknown> | Promise<Record<string, unknown>>;
+  hydrateState?: (app: App, state: Record<string, unknown> | null) => void;
+}
+declare function defineApp(options: DefineAppOptions): ResolvedAppConfig;
+declare function applyAppConfig(app: App, config: ResolvedAppConfig, mode: 'client' | 'server'): void;
+declare function createDefaultAppConfig(): ResolvedAppConfig;
+/**
+ * 从多个 `ResolvedAppConfig` 合并出一个最终配置(shared + client/server)。
+ *
+ * `serializeState` 与 `hydrateState` 的合并语义:server 配置的 `serializeState` 优先,
+ * client 配置的 `hydrateState` 优先;shared 配置作为默认值。
+ *
+ * 这个函数在 `virtual:ubean-app` 虚拟模块中以 JS 字符串形式重新实现
+ * (`_mergeAppConfig`),保持两者语义一致。
+ */
+declare function mergeAppConfig(base: ResolvedAppConfig, ...configs: (ResolvedAppConfig | null | undefined)[]): ResolvedAppConfig;
+//#endregion
+export { applyAppConfig as a, mergeAppConfig as c, RouterConfig as i, DefineAppOptions as n, createDefaultAppConfig as o, ResolvedAppConfig as r, defineApp as s, AppPluginConfig as t };

package/dist/define-app.d.ts

@@ -1,168 +1,2 @@
-import { App, Component, Plugin } from "vue";
-import { Router } from "vue-router";
-import { ViewTransitionOptions } from "@ubean/vue";
-import { PageHead } from "@ubean/shared";
-//#region src/define-app.d.ts
-interface AppPluginConfig {
-  plugin: Plugin | [Plugin, ...any[]];
-  mode?: 'all' | 'client' | 'server';
-}
-/**
- * Router 钩子配置 — 暴露 vue-router 的导航守卫注册入口。
- *
- * `setup(router)` 在 router 实例创建后、`app.use(router)` 之前调用,
- * 因此守卫能拦截首次导航(包括 SSR 的初始 URL push)。
- *
- * Client 和 SSR 都会执行,适合做鉴权、埋点、进度条等逻辑。
- *
- * @example
- * ```ts
- * defineApp({
- *   router: {
- *     setup(router) {
- *       router.beforeEach((to, from) => {
- *         if (to.meta.requiresAuth && !isAuthenticated()) {
- *           return '/login';
- *         }
- *       });
- *       router.afterEach((to) => {
- *         analytics.track('page_view', { path: to.fullPath });
- *       });
- *     }
- *   }
- * });
- * ```
- */
-interface RouterConfig {
-  /**
-   * 在 router 创建后、初始导航前调用。
-   * 用于注册 `beforeEach` / `beforeResolve` / `afterEach` 等守卫。
-   *
-   * 注意:setup 必须同步注册守卫(虽然守卫本身可以返回 Promise)。
-   * 不要在 setup 中执行异步操作(如请求 API),因为这会延迟首次导航。
-   */
-  setup?: (router: Router) => void;
-}
-interface DefineAppOptions {
-  plugins?: Array<Plugin | [Plugin, ...any[]] | AppPluginConfig>;
-  globalComponents?: Record<string, Component>;
-  provides?: Record<string | symbol, unknown>;
-  head?: PageHead;
-  rootId?: string;
-  rootAttrs?: Record<string, string>;
-  /**
-   * 应用根组件(包装组件,可选)—— 经典 Vue `App.vue` 的编程式等价物。
-   *
-   * 组件包裹在框架根组件(`UbeanAppRoot`)之上,框架出口(布局链 + 页面)
-   * 通过**默认 slot** 注入,组件内用 `<slot />` 声明渲染位置:
-   *
-   * ```vue
-   * <!-- src/app.ts 对应的 AppRoot.vue -->
-   * <template>
-   *   <SConfigProvider>
-   *     <AppHeader />
-   *     <slot /> <!-- 布局链 + 页面在这里渲染 -->
-   *   </SConfigProvider>
-   * </template>
-   * ```
-   *
-   * 适合放置"必须在布局之上"的全局内容:全局 ConfigProvider/主题上下文、
-   * 覆盖布局自身的错误边界、全局过渡/动效容器等。不要用它渲染
-   * `<PageView />` / `<RouterView />` —— 那会绕过布局链;出口是 `<slot />`。
-   *
-   * 自动检测:`src/app.vue`(小写,Nuxt 风格,优先)/ `src/App.vue`
-   * (大写,经典 Vue 约定)文件约定(与 loading/error 特殊页同模式),
-   * 两者都存在时取小写;无该文件时忽略。优先级:
-   * `defineApp({ appRoot })` > `src/app.vue` > `src/App.vue`。
-   */
-  appRoot?: Component;
-  /**
-   * 路由钩子配置,用于注册 vue-router 的导航守卫。
-   * 在 Client 和 SSR 都会执行。
-   */
-  router?: RouterConfig;
-  onAppCreated?: (app: App) => void | Promise<void>;
-  onClientReady?: (app: App) => void | Promise<void>;
-  errorComponent?: Component;
-  loadingComponent?: Component;
-  viewTransitions?: boolean | ViewTransitionOptions;
-  /**
-   * SSR 专用:在 `renderToString(app)` 完成后调用,从 app 实例提取需要
-   * 序列化到客户端的状态(如 Pinia 的 `pinia.state.value`)。
-   *
-   * 返回的对象会被 `safeJsonStringify` 序列化并注入到 HTML 的
-   * `__UBEAN_STATE__` script 标签中。
-   *
-   * 仅在 server mode 下生效;client mode 下被忽略。
-   *
-   * @example
-   * ```ts
-   * import { createPinia } from 'pinia';
-   * defineApp({
-   *   plugins: [createPinia()],
-   *   serializeState: (app) => ({
-   *     pinia: app.config.globalProperties.$pinia.state.value
-   *   })
-   * });
-   * ```
-   */
-  serializeState?: (app: App) => Record<string, unknown> | Promise<Record<string, unknown>>;
-  /**
-   * Client 专用:在 `applyAppConfig`(注册插件/provide)之后、`app.mount()` 之前调用,
-   * 用于从 `__UBEAN_STATE__` 反序列化的状态回填到 app(如 Pinia 的水合)。
-   *
-   * `state` 即 `serializeState` 在服务端返回的对象;若服务端未配置 `serializeState`
-   * 或返回空,`state` 为 `null`。
-   *
-   * 仅在 client mode 下生效;server mode 下被忽略。
-   *
-   * @example
-   * ```ts
-   * import { createPinia } from 'pinia';
-   * defineApp({
-   *   plugins: [createPinia()],
-   *   hydrateState: (app, state) => {
-   *     if (state?.pinia) {
-   *       app.config.globalProperties.$pinia.state.value = state.pinia;
-   *     }
-   *   }
-   * });
-   * ```
-   */
-  hydrateState?: (app: App, state: Record<string, unknown> | null) => void;
-}
-interface ResolvedAppConfig {
-  plugins: AppPluginConfig[];
-  globalComponents: Record<string, Component>;
-  provides: Record<string | symbol, unknown>;
-  head?: PageHead;
-  rootId: string;
-  rootAttrs: Record<string, string>;
-  /**
-   * 应用根组件(包装组件,可选)。语义见 `DefineAppOptions.appRoot`。
-   */
-  appRoot?: Component;
-  router?: RouterConfig;
-  onAppCreated?: (app: App) => void | Promise<void>;
-  onClientReady?: (app: App) => void | Promise<void>;
-  errorComponent?: Component;
-  loadingComponent?: Component;
-  viewTransitions?: boolean | ViewTransitionOptions;
-  serializeState?: (app: App) => Record<string, unknown> | Promise<Record<string, unknown>>;
-  hydrateState?: (app: App, state: Record<string, unknown> | null) => void;
-}
-declare function defineApp(options: DefineAppOptions): ResolvedAppConfig;
-declare function applyAppConfig(app: App, config: ResolvedAppConfig, mode: 'client' | 'server'): void;
-declare function createDefaultAppConfig(): ResolvedAppConfig;
-/**
- * 从多个 `ResolvedAppConfig` 合并出一个最终配置(shared + client/server)。
- *
- * `serializeState` 与 `hydrateState` 的合并语义:server 配置的 `serializeState` 优先,
- * client 配置的 `hydrateState` 优先;shared 配置作为默认值。
- *
- * 这个函数在 `virtual:ubean-app` 虚拟模块中以 JS 字符串形式重新实现
- * (`_mergeAppConfig`),保持两者语义一致。
- */
-declare function mergeAppConfig(base: ResolvedAppConfig, ...configs: (ResolvedAppConfig | null | undefined)[]): ResolvedAppConfig;
-//#endregion
+import { a as applyAppConfig, c as mergeAppConfig, i as RouterConfig, n as DefineAppOptions, o as createDefaultAppConfig, r as ResolvedAppConfig, s as defineApp, t as AppPluginConfig } from "./define-app-RzHOZlYB.js";
 export { AppPluginConfig, DefineAppOptions, ResolvedAppConfig, RouterConfig, applyAppConfig, createDefaultAppConfig, defineApp, mergeAppConfig };

package/dist/define-app.js

@@ -84,13 +84,17 @@ function mergeAppConfig(base, ...configs) {
 		if (cfg.viewTransitions !== void 0) result.viewTransitions = cfg.viewTransitions;
 		if (cfg.serializeState) result.serializeState = cfg.serializeState;
 		if (cfg.hydrateState) result.hydrateState = cfg.hydrateState;
-		if (cfg.router?.setup) {
-			const prevSetup = result.router?.setup;
-			if (prevSetup) result.router = { setup: (router) => {
-				prevSetup(router);
+		if (cfg.router) {
+			const prev = result.router;
+			const setup = cfg.router.setup ? prev?.setup ? (router) => {
+				prev.setup(router);
 				cfg.router.setup(router);
-			} };
-			else result.router = { setup: cfg.router.setup };
+			} : cfg.router.setup : prev?.setup;
+			const scrollBehavior = cfg.router.scrollBehavior !== void 0 ? cfg.router.scrollBehavior : prev?.scrollBehavior;
+			result.router = {
+				setup,
+				...scrollBehavior !== void 0 ? { scrollBehavior } : {}
+			};
 		}
 	}
 	return result;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as defineMeta, D as usePage, E as UbeanVuePage, O as CreateUbeanRouterOptions, T as definePage, _ as createUbeanClientApp, b as useSeoMeta, h as UbeanAppOptions, k as createUbeanRouter, m as UbeanAppInstance, n as Head, v as createUbeanSSRApp, w as defineMiddleware, x as useUnheadHead } from "./app-BQgi-8Qp.js";
-import { AppPluginConfig, DefineAppOptions, ResolvedAppConfig, applyAppConfig, createDefaultAppConfig, defineApp, mergeAppConfig } from "./define-app.js";
+import { A as createUbeanRouter, D as UbeanVuePage, E as definePage, O as usePage, S as useUnheadHead, T as defineMiddleware, g as UbeanAppOptions, h as UbeanAppInstance, k as CreateUbeanRouterOptions, r as Head, v as createUbeanClientApp, w as defineMeta, x as useSeoMeta, y as createUbeanSSRApp } from "./app-Busq_M7n.js";
+import { a as applyAppConfig, c as mergeAppConfig, n as DefineAppOptions, o as createDefaultAppConfig, r as ResolvedAppConfig, s as defineApp, t as AppPluginConfig } from "./define-app-RzHOZlYB.js";
 import { App, ComputedRef, Ref, ShallowRef } from "vue";
 import "vue-router";
-import { ERROR_KEY, ErrorBoundary, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainContext, LayoutChainRenderer, Link, PAGE_KEY, PageView, RouteLocation, RouteLocationRaw, SSR_KEY, SlotView, TRANSITION_KEY, TypedLinkProps, UbeanVueOptions, UbeanVuePageData, UseCacheViewsReturn, UsePageTransitionReturn, UseReloadSignalReturn, ViewTransitionOptions, clearPageTransition, disablePageCache, enablePageCache, excludePageCache, getCacheEnabled, getCachedViewNames, getExcludedViewNames, getNamedPageWrapper, getNavigationType, getPageTransitionName, getReloadCounter, includePageCache, initCachedViewsFromRoutes, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isReloading, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveRoute, setPageTransition, supportsViewTransitions, ubeanVue, useCacheViews, usePageTransition, useReloadSignal, useViewTransition, useViewTransitionState, withViewTransition } from "@ubean/vue";
+import { ClientOnly, ClientOnlyProps, ClientOnlySlots, ERROR_KEY, ErrorBoundary, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainContext, LayoutChainRenderer, Link, PAGE_KEY, PageView, RouteLocation, RouteLocationRaw, SSR_KEY, SlotView, TRANSITION_KEY, TypedLinkProps, UbeanVueOptions, UbeanVuePageData, UseCacheViewsReturn, UsePageTransitionReturn, UseReloadSignalReturn, ViewTransitionOptions, clearPageTransition, disablePageCache, enablePageCache, excludePageCache, getCacheEnabled, getCachedViewNames, getExcludedViewNames, getNamedPageWrapper, getNavigationType, getPageTransitionName, getReloadCounter, includePageCache, initCachedViewsFromRoutes, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isReloading, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveRoute, setPageTransition, supportsViewTransitions, ubeanVue, useCacheViews, usePageTransition, useReloadSignal, useViewTransition, useViewTransitionState, withViewTransition } from "@ubean/vue";
 import { createHead as createClientHead } from "@unhead/vue/client";
 import { DataResult, PageObject, UseAsyncDataOptions, UseFetchOptions, invalidateData, setDefaultFetch, useAsyncData, useData, useFetch } from "@ubean/pages";
 import { I18n } from "vue-i18n";
@@ -10,7 +10,7 @@ import { LocaleRoutingConfig, buildLocaleHead } from "@ubean/i18n/browser";
 import { HydrateIslandsOptions, IslandHydrateOptions, IslandHydrationScheduler, IslandRecord, collectIslands, hasPendingIslands, hydrateIsland, hydrateIslands, scheduleIslandHydration } from "@ubean/islands/runtime";
 import { LinkTag, MetaTag, SeoMetadata } from "@ubean/seo";
 //#region src/client.d.ts
-declare function getInitialPageData<T = Record<string, unknown>>(): PageObject<T> | null;
+export declare function getInitialPageData<T = Record<string, unknown>>(): PageObject<T> | null;
 /**
  * 从 DOM 中的 `<script id="__UBEAN_STATE__">` 读取 SSR 序列化的状态。
  *
@@ -21,10 +21,10 @@ declare function getInitialPageData<T = Record<string, unknown>>(): PageObject<T
  *
  * @returns 解析后的状态对象,或 `null`(无状态 / 解析失败 / 非 DOM 环境)
  */
-declare function getInitialState(): Record<string, unknown> | null;
+export declare function getInitialState(): Record<string, unknown> | null;
 //#endregion
 //#region src/head.d.ts
-declare function useHeadInstance(): import("@unhead/vue").VueHeadClient;
+export declare function useHeadInstance(): import("@unhead/vue").VueHeadClient;
 //#endregion
 //#region src/composables.d.ts
 interface UbeanVueContext {
@@ -45,7 +45,7 @@ interface DataCacheStore {
   subscribe: (fn: () => void) => () => void;
   getTimestamp: (key: string | symbol) => number | undefined;
 }
-declare function createDataCacheStore(): DataCacheStore;
+export declare function createDataCacheStore(): DataCacheStore;
 interface UseAsyncDataOptions$1<T> {
   key?: string;
   tags?: string[];
@@ -67,20 +67,20 @@ interface UseAsyncDataReturn<T> {
   refresh: () => Promise<void>;
   invalidate: () => void;
 }
-declare function createUseAsyncData(store: DataCacheStore): <T = unknown>(keyOrFetcher: string | (() => Promise<T>), fetcherOrOptions?: (() => Promise<T>) | UseAsyncDataOptions$1<T>, options?: UseAsyncDataOptions$1<T>) => UseAsyncDataReturn<T>;
-declare function invalidateCache(store: DataCacheStore, keyOrTag: string): number;
-declare function clearCache(store: DataCacheStore): void;
-declare function defineDataKey(key: string): symbol;
-declare function createLinkHandler(ctx: UbeanVueContext): {
+export declare function createUseAsyncData(store: DataCacheStore): <T = unknown>(keyOrFetcher: string | (() => Promise<T>), fetcherOrOptions?: (() => Promise<T>) | UseAsyncDataOptions$1<T>, options?: UseAsyncDataOptions$1<T>) => UseAsyncDataReturn<T>;
+export declare function invalidateCache(store: DataCacheStore, keyOrTag: string): number;
+export declare function clearCache(store: DataCacheStore): void;
+export declare function defineDataKey(key: string): symbol;
+export declare function createLinkHandler(ctx: UbeanVueContext): {
   getProps: () => {};
   navigate(href: string, opts?: {
     replace?: boolean;
   }): Promise<void>;
   prefetch(_href: string): Promise<void>;
 };
-declare function extractPageData<T = Record<string, unknown>>(): PageObject<T> | null;
-declare function useServerData<T>(fetcher: () => Promise<T>): Promise<T>;
-declare function getInvalidatedKeysForAction(actionName: string, invalidationMap: Record<string, Array<string | symbol>>, store: DataCacheStore): number;
+export declare function extractPageData<T = Record<string, unknown>>(): PageObject<T> | null;
+export declare function useServerData<T>(fetcher: () => Promise<T>): Promise<T>;
+export declare function getInvalidatedKeysForAction(actionName: string, invalidationMap: Record<string, Array<string | symbol>>, store: DataCacheStore): number;
 //#endregion
 //#region src/i18n.d.ts
 type LocaleMessages = Record<string, unknown>;
@@ -120,19 +120,19 @@ interface HydratedLocalePayload {
     isDefault?: boolean;
   }>;
 }
-declare function configureI18nRuntime(options: {
+export declare function configureI18nRuntime(options: {
   config: I18nRuntimeConfig;
   loadLocale?: LocaleLoader;
   locales?: HydratedLocalePayload['locales'];
 }): void;
-declare function getI18nRuntimeConfig(): I18nRuntimeConfig | null;
-declare function createUbeanI18n(options?: {
+export declare function getI18nRuntimeConfig(): I18nRuntimeConfig | null;
+export declare function createUbeanI18n(options?: {
   locale?: string;
   fallbackLocale?: string;
   messages?: Record<string, LocaleMessages>;
   vueI18n?: Record<string, unknown>;
 }): I18n;
-declare function installUbeanI18n(app: App, i18n: I18n): void;
+export declare function installUbeanI18n(app: App, i18n: I18n): void;
 /**
  * Framework setLocale: load messages, switch composer locale, write cookie,
  * navigate to the localized path (`no_prefix` skips navigation).
@@ -140,20 +140,20 @@ declare function installUbeanI18n(app: App, i18n: I18n): void;
  * Uses the runtime bound by `bindI18nRuntime` (not Vue composables) so it is
  * safe to call from click handlers.
  */
-declare function setLocale(code: string): Promise<void>;
-declare function getLocale(): string;
-declare function localizePath(path: string, locale?: string): string;
-declare function switchLocalePath(locale: string, path?: string): string;
-declare function extractLocaleFromPath(path: string): {
+export declare function setLocale(code: string): Promise<void>;
+export declare function getLocale(): string;
+export declare function localizePath(path: string, locale?: string): string;
+export declare function switchLocalePath(locale: string, path?: string): string;
+export declare function extractLocaleFromPath(path: string): {
   locale: string | null;
   pathWithoutLocale: string;
 };
-declare function useLocalePath(): (path: string, locale?: string) => string;
-declare function useSwitchLocalePath(): (locale: string) => string;
-declare function useLocaleRoute(): (path: string, locale?: string) => string;
-declare function useLocaleHead(): ComputedRef<ReturnType<typeof buildLocaleHead>>;
+export declare function useLocalePath(): (path: string, locale?: string) => string;
+export declare function useSwitchLocalePath(): (locale: string) => string;
+export declare function useLocaleRoute(): (path: string, locale?: string) => string;
+export declare function useLocaleHead(): ComputedRef<ReturnType<typeof buildLocaleHead>>;
 /** Hydrate routing config from SSR payload before the first render. */
-declare function initClientI18n(): void;
+export declare function initClientI18n(): void;
 //#endregion
 //#region src/color-mode.d.ts
 interface ColorModeConfig {
@@ -193,7 +193,7 @@ interface ColorMode {
   toggle: () => void;
 }
 /** Merge user config with defaults. */
-declare function resolveColorModeConfig(config?: Partial<ColorModeConfig>): ColorModeConfig;
+export declare function resolveColorModeConfig(config?: Partial<ColorModeConfig>): ColorModeConfig;
 /**
  * Generate the no-FOUC inline script that resolves the color mode and sets
  * the `<html>` class/attribute **before** the page renders.
@@ -206,11 +206,11 @@ declare function resolveColorModeConfig(config?: Partial<ColorModeConfig>): Colo
  *
  * This script is injected into `<head>` and runs synchronously.
  */
-declare function getColorModeScript(config: ColorModeConfig): string;
+export declare function getColorModeScript(config: ColorModeConfig): string;
 /** Configure the color mode module (called once during app initialization). */
-declare function configureColorMode(config?: Partial<ColorModeConfig>): ColorModeConfig;
+export declare function configureColorMode(config?: Partial<ColorModeConfig>): ColorModeConfig;
 /** Get the current color mode config. */
-declare function getColorModeConfig(): ColorModeConfig;
+export declare function getColorModeConfig(): ColorModeConfig;
 /**
  * Reactively access and control the color mode.
  *
@@ -230,21 +230,21 @@ declare function getColorModeConfig(): ColorModeConfig;
  * colorMode.toggle(); // cycles: light → dark → light
  * ```
  */
-declare function useColorMode(): ColorMode;
+export declare function useColorMode(): ColorMode;
 /**
  * Force a color mode (e.g. from route meta `colorMode: 'dark'`).
  * When forced, user changes are ignored until `unforceColorMode()` is called.
  */
-declare function forceColorMode(mode: string): void;
+export declare function forceColorMode(mode: string): void;
 /**
  * Remove the forced color mode, returning to user preference.
  */
-declare function unforceColorMode(): void;
+export declare function unforceColorMode(): void;
 /**
  * Reset the color mode module state (for testing).
  * @internal
  */
-declare function _resetColorMode(): void;
+export declare function _resetColorMode(): void;
 //#endregion
 //#region src/party-town.d.ts
 interface PartyTownConfig {
@@ -271,7 +271,7 @@ interface PartyTownConfig {
   nonBlocking: boolean;
 }
 /** Merge user config with defaults. */
-declare function resolvePartyTownConfig(config?: Partial<PartyTownConfig>): PartyTownConfig;
+export declare function resolvePartyTownConfig(config?: Partial<PartyTownConfig>): PartyTownConfig;
 /**
  * Generate the inline Partytown config script for `<head>`.
  *
@@ -281,12 +281,12 @@ declare function resolvePartyTownConfig(config?: Partial<PartyTownConfig>): Part
  *
  * Returns an empty string if Partytown is not enabled.
  */
-declare function getPartyTownScript(config: PartyTownConfig): string;
+export declare function getPartyTownScript(config: PartyTownConfig): string;
 /**
  * Generate the full HTML for Partytown initialization.
  * Used by the Vite plugin to inject into `<head>`.
  */
-declare function getPartyTownHeadContent(config: PartyTownConfig): string;
+export declare function getPartyTownHeadContent(config: PartyTownConfig): string;
 type ScriptTrigger = 'load' | 'idle' | 'visible' | 'manual';
 interface UseScriptOptions {
   /** When to load the script (default: 'load'). */
@@ -355,15 +355,15 @@ interface UseScriptReturn {
  * useScript('/analytics.js', { trigger: 'visible', target: targetRef });
  * ```
  */
-declare function useScript(src: string, options?: UseScriptOptions): UseScriptReturn;
+export declare function useScript(src: string, options?: UseScriptOptions): UseScriptReturn;
 /** Configure the Partytown module globally. */
-declare function configurePartyTown(config?: Partial<PartyTownConfig>): PartyTownConfig;
+export declare function configurePartyTown(config?: Partial<PartyTownConfig>): PartyTownConfig;
 /** Get the current Partytown config. */
-declare function getPartyTownConfig(): PartyTownConfig;
+export declare function getPartyTownConfig(): PartyTownConfig;
 /** Check if Partytown is enabled. */
-declare function isPartyTownEnabled(): boolean;
+export declare function isPartyTownEnabled(): boolean;
 /** Reset Partytown module state (for testing). @internal */
-declare function _resetPartyTown(): void;
+export declare function _resetPartyTown(): void;
 //#endregion
 //#region src/search.d.ts
 /** A single search result from Pagefind. */
@@ -435,11 +435,11 @@ interface SearchRuntimeConfig {
  * Configure the search runtime globally. Call this in `app.ts` (client-side)
  * to override defaults before any `useSearch()` call.
  */
-declare function configureSearch(config: Partial<SearchRuntimeConfig>): void;
+export declare function configureSearch(config: Partial<SearchRuntimeConfig>): void;
 /** Get the current runtime search config. */
-declare function getSearchConfig(): SearchRuntimeConfig;
+export declare function getSearchConfig(): SearchRuntimeConfig;
 /** Resolve a user-provided config object into a full SearchRuntimeConfig. */
-declare function resolveSearchConfig(config?: Partial<SearchRuntimeConfig> | true): SearchRuntimeConfig;
+export declare function resolveSearchConfig(config?: Partial<SearchRuntimeConfig> | true): SearchRuntimeConfig;
 /** The loaded Pagefind browser module (cached after first load). */
 type PagefindModule = any;
 /**
@@ -449,18 +449,18 @@ type PagefindModule = any;
  * served at `/pagefind/pagefind-modern.js`. In dev mode or when Pagefind is
  * not enabled, the import will fail — callers should catch and show a message.
  */
-declare function initPagefind(options?: {
+export declare function initPagefind(options?: {
   pagefindPath?: string;
 }): Promise<PagefindModule>;
 /** Check whether the Pagefind browser library has been loaded. */
-declare function isPagefindLoaded(): boolean;
+export declare function isPagefindLoaded(): boolean;
 /**
  * Execute a raw Pagefind search. Returns normalized `SearchResult[]`.
  *
  * Exposed for advanced use cases where the reactive composable is not needed
  * (e.g. server-side API routes that proxy search requests).
  */
-declare function executeSearch(query: string, options?: {
+export declare function executeSearch(query: string, options?: {
   filters?: SearchFilters;
   limit?: number;
   pagefindPath?: string;
@@ -494,9 +494,9 @@ declare function executeSearch(query: string, options?: {
  * </template>
  * ```
  */
-declare function useSearch(options?: UseSearchOptions): UseSearchReturn;
+export declare function useSearch(options?: UseSearchOptions): UseSearchReturn;
 /** Reset all internal state (for unit tests only). */
-declare function _resetSearch(): void;
+export declare function _resetSearch(): void;
 /**
  * Inject a mock Pagefind module for testing.
  *
@@ -504,6 +504,6 @@ declare function _resetSearch(): void;
  * results without a real Pagefind build. Also calls `mock.init()` to mimic
  * the real library's initialization.
  */
-declare function _setPagefindMock(mock: any): void;
+export declare function _setPagefindMock(mock: any): void;
 //#endregion
-export { type AppPluginConfig, type ColorMode, type ColorModeConfig, type CreateUbeanRouterOptions, type DataCacheStore, type DataResult, type DefineAppOptions, ERROR_KEY, ErrorBoundary, Head, type HydrateIslandsOptions, type I18nRuntimeConfig, type IslandHydrateOptions, type IslandHydrationScheduler, type IslandRecord, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, type LayoutChainContext, LayoutChainRenderer, Link, type LinkProps, type LinkTag, type LocaleLoader, type LocaleMessages, type MetaTag, PAGE_KEY, PageView, type PartyTownConfig, type ResolvedAppConfig, type RouteLocation, type RouteLocationRaw, SSR_KEY, type ScriptTrigger, type SearchFilters, type SearchResult, type SearchRuntimeConfig, type SeoMetadata, SlotView, TRANSITION_KEY, type TypedLinkProps, type UbeanAppInstance, type UbeanAppOptions, type UbeanVueContext, type UbeanVueOptions, type UbeanVuePage, type UbeanVuePageData, type UseAsyncDataOptions, type UseAsyncDataReturn, type UseCacheViewsReturn, type UseFetchOptions, type UsePageTransitionReturn, type UseReloadSignalReturn, type UseScriptOptions, type UseScriptReturn, type UseSearchOptions, type UseSearchReturn, type ViewTransitionOptions, _resetColorMode, _resetPartyTown, _resetSearch, _setPagefindMock, applyAppConfig, clearCache, clearPageTransition, collectIslands, configureColorMode, configureI18nRuntime, configurePartyTown, configureSearch, createClientHead, createDataCacheStore, createDefaultAppConfig, createLinkHandler, createUbeanClientApp, createUbeanI18n, createUbeanRouter, createUbeanSSRApp, createUseAsyncData, defineApp, defineDataKey, defineMeta, defineMiddleware, definePage, disablePageCache, enablePageCache, excludePageCache, executeSearch, extractLocaleFromPath, extractPageData, forceColorMode, getCacheEnabled, getCachedViewNames, getColorModeConfig, getColorModeScript, getExcludedViewNames, getI18nRuntimeConfig, getInitialPageData, getInitialState, getInvalidatedKeysForAction, getLocale, getNamedPageWrapper, getNavigationType, getPageTransitionName, getPartyTownConfig, getPartyTownHeadContent, getPartyTownScript, getReloadCounter, getSearchConfig, hasPendingIslands, hydrateIsland, hydrateIslands, includePageCache, initCachedViewsFromRoutes, initClientI18n, initPagefind, installUbeanI18n, invalidateCache, invalidateData, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isPagefindLoaded, isPartyTownEnabled, isReloading, localizePath, mergeAppConfig, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveColorModeConfig, resolvePartyTownConfig, resolveRoute, resolveSearchConfig, scheduleIslandHydration, setDefaultFetch, setLocale, setPageTransition, supportsViewTransitions, switchLocalePath, ubeanVue, unforceColorMode, useAsyncData, useCacheViews, useColorMode, useData, useFetch, useUnheadHead as useHead, useHeadInstance, useLocaleHead, useLocalePath, useLocaleRoute, usePage, usePageTransition, useReloadSignal, useScript, useSearch, useSeoMeta, useServerData, useSwitchLocalePath, useViewTransition, useViewTransitionState, withViewTransition };
+export { type AppPluginConfig, ClientOnly, type ClientOnlyProps, type ClientOnlySlots, type ColorMode, type ColorModeConfig, type CreateUbeanRouterOptions, type DataCacheStore, type DataResult, type DefineAppOptions, ERROR_KEY, ErrorBoundary, Head, type HydrateIslandsOptions, type I18nRuntimeConfig, type IslandHydrateOptions, type IslandHydrationScheduler, type IslandRecord, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, type LayoutChainContext, LayoutChainRenderer, Link, type LinkProps, type LinkTag, type LocaleLoader, type LocaleMessages, type MetaTag, PAGE_KEY, PageView, type PartyTownConfig, type ResolvedAppConfig, type RouteLocation, type RouteLocationRaw, SSR_KEY, type ScriptTrigger, type SearchFilters, type SearchResult, type SearchRuntimeConfig, type SeoMetadata, SlotView, TRANSITION_KEY, type TypedLinkProps, type UbeanAppInstance, type UbeanAppOptions, type UbeanVueContext, type UbeanVueOptions, type UbeanVuePage, type UbeanVuePageData, type UseAsyncDataOptions, type UseAsyncDataReturn, type UseCacheViewsReturn, type UseFetchOptions, type UsePageTransitionReturn, type UseReloadSignalReturn, type UseScriptOptions, type UseScriptReturn, type UseSearchOptions, type UseSearchReturn, type ViewTransitionOptions, applyAppConfig, clearPageTransition, collectIslands, createClientHead, createDefaultAppConfig, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineApp, defineMeta, defineMiddleware, definePage, disablePageCache, enablePageCache, excludePageCache, getCacheEnabled, getCachedViewNames, getExcludedViewNames, getNamedPageWrapper, getNavigationType, getPageTransitionName, getReloadCounter, hasPendingIslands, hydrateIsland, hydrateIslands, includePageCache, initCachedViewsFromRoutes, invalidateData, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isReloading, mergeAppConfig, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveRoute, scheduleIslandHydration, setDefaultFetch, setPageTransition, supportsViewTransitions, ubeanVue, useAsyncData, useCacheViews, useData, useFetch, useUnheadHead as useHead, usePage, usePageTransition, useReloadSignal, useSeoMeta, useViewTransition, useViewTransitionState, withViewTransition };

package/dist/index.js

@@ -1,8 +1,8 @@
-import { C as usePage, S as createUbeanRouter, _ as useUnheadHead, b as defineMiddleware, g as useSeoMeta, m as createUbeanSSRApp, n as Head, p as createUbeanClientApp, x as definePage, y as defineMeta } from "./app-DiXW_14_.js";
+import { C as createUbeanRouter, S as definePage, _ as useSeoMeta, b as defineMeta, h as createUbeanSSRApp, m as createUbeanClientApp, r as Head, v as useUnheadHead, w as usePage, x as defineMiddleware } from "./app-COSjPzyK.js";
 import { a as getI18nRuntimeConfig, c as installUbeanI18n, d as switchLocalePath, f as useLocaleHead, h as useSwitchLocalePath, i as extractLocaleFromPath, l as localizePath, m as useLocaleRoute, n as configureI18nRuntime, o as getLocale, p as useLocalePath, r as createUbeanI18n, s as initClientI18n, u as setLocale } from "./i18n-CAeXKTpy.js";
 import { applyAppConfig, createDefaultAppConfig, defineApp, mergeAppConfig } from "./define-app.js";
 import { computed, getCurrentInstance, markRaw, onMounted, onScopeDispose, onUnmounted, ref, shallowRef, watch } from "vue";
-import { ERROR_KEY, ErrorBoundary, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, clearPageTransition, disablePageCache, enablePageCache, excludePageCache, getCacheEnabled, getCachedViewNames, getExcludedViewNames, getNamedPageWrapper, getNavigationType, getPageTransitionName, getReloadCounter, includePageCache, initCachedViewsFromRoutes, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isReloading, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveRoute, setPageTransition, supportsViewTransitions, ubeanVue, useCacheViews, usePageTransition, useReloadSignal, useViewTransition, useViewTransitionState, withViewTransition } from "@ubean/vue";
+import { ClientOnly, ERROR_KEY, ErrorBoundary, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, clearPageTransition, disablePageCache, enablePageCache, excludePageCache, getCacheEnabled, getCachedViewNames, getExcludedViewNames, getNamedPageWrapper, getNavigationType, getPageTransitionName, getReloadCounter, includePageCache, initCachedViewsFromRoutes, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isReloading, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveRoute, setPageTransition, supportsViewTransitions, ubeanVue, useCacheViews, usePageTransition, useReloadSignal, useViewTransition, useViewTransitionState, withViewTransition } from "@ubean/vue";
 import { injectHead } from "@unhead/vue";
 import { createHead as createClientHead } from "@unhead/vue/client";
 import { defineDataKey as defineDataKey$1, invalidateData, setDefaultFetch, useAsyncData, useData, useFetch } from "@ubean/pages";
@@ -1021,4 +1021,4 @@ function _setPagefindMock(mock) {
 	pagefindPromise = Promise.resolve(mock);
 }
 //#endregion
-export { ERROR_KEY, ErrorBoundary, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, _resetColorMode, _resetPartyTown, _resetSearch, _setPagefindMock, applyAppConfig, clearCache, clearPageTransition, collectIslands, configureColorMode, configureI18nRuntime, configurePartyTown, configureSearch, createClientHead, createDataCacheStore, createDefaultAppConfig, createLinkHandler, createUbeanClientApp, createUbeanI18n, createUbeanRouter, createUbeanSSRApp, createUseAsyncData, defineApp, defineDataKey, defineMeta, defineMiddleware, definePage, disablePageCache, enablePageCache, excludePageCache, executeSearch, extractLocaleFromPath, extractPageData, forceColorMode, getCacheEnabled, getCachedViewNames, getColorModeConfig, getColorModeScript, getExcludedViewNames, getI18nRuntimeConfig, getInitialPageData, getInitialState, getInvalidatedKeysForAction, getLocale, getNamedPageWrapper, getNavigationType, getPageTransitionName, getPartyTownConfig, getPartyTownHeadContent, getPartyTownScript, getReloadCounter, getSearchConfig, hasPendingIslands, hydrateIsland, hydrateIslands, includePageCache, initCachedViewsFromRoutes, initClientI18n, initPagefind, installUbeanI18n, invalidateCache, invalidateData, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isPagefindLoaded, isPartyTownEnabled, isReloading, localizePath, mergeAppConfig, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveColorModeConfig, resolvePartyTownConfig, resolveRoute, resolveSearchConfig, scheduleIslandHydration, setDefaultFetch, setLocale, setPageTransition, supportsViewTransitions, switchLocalePath, ubeanVue, unforceColorMode, useAsyncData, useCacheViews, useColorMode, useData, useFetch, useUnheadHead as useHead, useHeadInstance, useLocaleHead, useLocalePath, useLocaleRoute, usePage, usePageTransition, useReloadSignal, useScript, useSearch, useSeoMeta, useServerData, useSwitchLocalePath, useViewTransition, useViewTransitionState, withViewTransition };
+export { ClientOnly, ERROR_KEY, ErrorBoundary, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, _resetColorMode, _resetPartyTown, _resetSearch, _setPagefindMock, applyAppConfig, clearCache, clearPageTransition, collectIslands, configureColorMode, configureI18nRuntime, configurePartyTown, configureSearch, createClientHead, createDataCacheStore, createDefaultAppConfig, createLinkHandler, createUbeanClientApp, createUbeanI18n, createUbeanRouter, createUbeanSSRApp, createUseAsyncData, defineApp, defineDataKey, defineMeta, defineMiddleware, definePage, disablePageCache, enablePageCache, excludePageCache, executeSearch, extractLocaleFromPath, extractPageData, forceColorMode, getCacheEnabled, getCachedViewNames, getColorModeConfig, getColorModeScript, getExcludedViewNames, getI18nRuntimeConfig, getInitialPageData, getInitialState, getInvalidatedKeysForAction, getLocale, getNamedPageWrapper, getNavigationType, getPageTransitionName, getPartyTownConfig, getPartyTownHeadContent, getPartyTownScript, getReloadCounter, getSearchConfig, hasPendingIslands, hydrateIsland, hydrateIslands, includePageCache, initCachedViewsFromRoutes, initClientI18n, initPagefind, installUbeanI18n, invalidateCache, invalidateData, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isPagefindLoaded, isPartyTownEnabled, isReloading, localizePath, mergeAppConfig, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveColorModeConfig, resolvePartyTownConfig, resolveRoute, resolveSearchConfig, scheduleIslandHydration, setDefaultFetch, setLocale, setPageTransition, supportsViewTransitions, switchLocalePath, ubeanVue, unforceColorMode, useAsyncData, useCacheViews, useColorMode, useData, useFetch, useUnheadHead as useHead, useHeadInstance, useLocaleHead, useLocalePath, useLocaleRoute, usePage, usePageTransition, useReloadSignal, useScript, useSearch, useSeoMeta, useServerData, useSwitchLocalePath, useViewTransition, useViewTransitionState, withViewTransition };

package/dist/server.d.ts

@@ -1,3 +1,3 @@
-import { C as defineMeta, D as usePage, E as UbeanVuePage, O as CreateUbeanRouterOptions, S as useViewTransition, T as definePage, _ as createUbeanClientApp, a as LOCALIZE_PATH_KEY, b as useSeoMeta, c as Link, d as SSR_KEY, f as SlotView, g as UbeanVueOptions, h as UbeanAppOptions, i as LOADING_KEY, k as createUbeanRouter, l as PAGE_KEY, m as UbeanAppInstance, n as Head, o as LayoutChainContext, p as TRANSITION_KEY, r as LAYOUT_CHAIN_KEY, s as LayoutChainRenderer, t as ERROR_KEY, u as PageView, v as createUbeanSSRApp, w as defineMiddleware, x as useUnheadHead, y as ubeanVue } from "./app-BQgi-8Qp.js";
+import { A as createUbeanRouter, C as useViewTransition, D as UbeanVuePage, E as definePage, O as usePage, S as useUnheadHead, T as defineMiddleware, _ as UbeanVueOptions, a as LOADING_KEY, b as ubeanVue, c as LayoutChainRenderer, d as PageView, f as SSR_KEY, g as UbeanAppOptions, h as UbeanAppInstance, i as LAYOUT_CHAIN_KEY, k as CreateUbeanRouterOptions, l as Link, m as TRANSITION_KEY, n as ERROR_KEY, o as LOCALIZE_PATH_KEY, p as SlotView, r as Head, s as LayoutChainContext, t as ClientOnly, u as PAGE_KEY, v as createUbeanClientApp, w as defineMeta, x as useSeoMeta, y as createUbeanSSRApp } from "./app-Busq_M7n.js";
 import { createHead as createServerHead } from "@unhead/vue/server";
-export { type CreateUbeanRouterOptions, ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, type LayoutChainContext, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, UbeanAppInstance, UbeanAppOptions, type UbeanVueOptions, type UbeanVuePage, createServerHead, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };
+export { ClientOnly, type CreateUbeanRouterOptions, ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, type LayoutChainContext, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, UbeanAppInstance, UbeanAppOptions, type UbeanVueOptions, type UbeanVuePage, createServerHead, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };

package/dist/server.js

@@ -1,3 +1,3 @@
-import { C as usePage, S as createUbeanRouter, _ as useUnheadHead, a as LOCALIZE_PATH_KEY, b as defineMiddleware, c as PAGE_KEY, d as SlotView, f as TRANSITION_KEY, g as useSeoMeta, h as ubeanVue, i as LOADING_KEY, l as PageView, m as createUbeanSSRApp, n as Head, o as LayoutChainRenderer, p as createUbeanClientApp, r as LAYOUT_CHAIN_KEY, s as Link, t as ERROR_KEY, u as SSR_KEY, v as useViewTransition, x as definePage, y as defineMeta } from "./app-DiXW_14_.js";
+import { C as createUbeanRouter, S as definePage, _ as useSeoMeta, a as LOADING_KEY, b as defineMeta, c as Link, d as SSR_KEY, f as SlotView, g as ubeanVue, h as createUbeanSSRApp, i as LAYOUT_CHAIN_KEY, l as PAGE_KEY, m as createUbeanClientApp, n as ERROR_KEY, o as LOCALIZE_PATH_KEY, p as TRANSITION_KEY, r as Head, s as LayoutChainRenderer, t as ClientOnly, u as PageView, v as useUnheadHead, w as usePage, x as defineMiddleware, y as useViewTransition } from "./app-COSjPzyK.js";
 import { createHead as createServerHead } from "@unhead/vue/server";
-export { ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, createServerHead, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };
+export { ClientOnly, ERROR_KEY, Head, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, LayoutChainRenderer, Link, PAGE_KEY, PageView, SSR_KEY, SlotView, TRANSITION_KEY, createServerHead, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useSeoMeta, useViewTransition };

package/dist/ssr.d.ts

@@ -1,9 +1,9 @@
-import { ResolvedAppConfig } from "./define-app.js";
+import { r as ResolvedAppConfig } from "./define-app-RzHOZlYB.js";
 import { Component } from "vue";
 import { RouteRecordRaw } from "vue-router";
 import { PageRenderer } from "@ubean/pages";
 //#region src/ssr.d.ts
-interface VueRendererSimpleOptions {
+export interface VueRendererSimpleOptions {
   resolvePageComponent: (path: string) => Promise<Component | null>;
   resolveLayoutComponent: (name: string | false | null | undefined) => Promise<Component | null>;
   defaultLayout?: string | null;
@@ -14,7 +14,7 @@ interface VueRendererSimpleOptions {
    */
   resolveAppConfig?: () => ResolvedAppConfig | Promise<ResolvedAppConfig>;
 }
-interface VueRendererRouterOptions {
+export interface VueRendererRouterOptions {
   routes: RouteRecordRaw[];
   resolveLayoutComponent: (name: string | false | null | undefined) => Promise<Component | null>;
   defaultLayout?: string | null;
@@ -25,7 +25,6 @@ interface VueRendererRouterOptions {
    */
   resolveAppConfig?: () => ResolvedAppConfig | Promise<ResolvedAppConfig>;
 }
-type VueRendererOptions = VueRendererSimpleOptions | VueRendererRouterOptions;
-declare function createVueRenderer(options: VueRendererOptions): PageRenderer;
-//#endregion
-export { VueRendererOptions, VueRendererRouterOptions, VueRendererSimpleOptions, createVueRenderer };
+export type VueRendererOptions = VueRendererSimpleOptions | VueRendererRouterOptions;
+export declare function createVueRenderer(options: VueRendererOptions): PageRenderer;
+//#endregion

package/dist/ssr.js

@@ -124,6 +124,7 @@ async function prepareRender(options, pageObj, renderContext) {
 			defaultLayout: options.defaultLayout,
 			head,
 			i18n,
+			router: appConfig?.router,
 			appRoot: appConfig?.appRoot
 		});
 		if (appConfig) await applyServerAppConfig(createdApp, appConfig);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/client",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Framework client runtime for ubean — layered over the lean @ubean/vue kernel, adding app factories, unhead, i18n, data layer, islands hydration and SSR state helpers",
   "files": [
     "dist"
@@ -32,11 +32,11 @@
     }
   },
   "dependencies": {
-    "@ubean/i18n": "0.4.4",
-    "@ubean/islands": "0.4.4",
-    "@ubean/pages": "0.4.4",
-    "@ubean/shared": "0.4.4",
-    "@ubean/vue": "0.4.4",
+    "@ubean/i18n": "0.4.6",
+    "@ubean/islands": "0.4.6",
+    "@ubean/pages": "0.4.6",
+    "@ubean/shared": "0.4.6",
+    "@ubean/vue": "0.4.6",
     "@unhead/vue": "^3.4.0",
     "@vue/server-renderer": "^3.5.42",
     "vue": "^3.5.42",
@@ -45,11 +45,11 @@
   },
   "devDependencies": {
     "@types/node": "^26.5.0",
-    "typescript": "7.0.2",
-    "vite-plus": "0.3.0"
+    "typescript": "npm:typescript-native-bridge@latest",
+    "vite-plus": "0.3.1"
   },
   "peerDependencies": {
-    "@ubean/seo": "0.4.4"
+    "@ubean/seo": "0.4.6"
   },
   "peerDependenciesMeta": {
     "@ubean/seo": {