@ubean/client 0.4.5 → 0.4.7

package/dist/{app-emLZM9XN.d.ts → app-Busq_M7n.d.ts}

@@ -1,7 +1,7 @@
 import { i as RouterConfig } from "./define-app-RzHOZlYB.js";
 import { App, Component } from "vue";
 import { RouteRecordRaw, Router, RouterOptions } 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 { 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";
@@ -134,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-Bt-2meGm.js → app-C5YuXGJl.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 { a as getI18nRuntimeConfig, l as localizePath, r as createUbeanI18n, s as initClientI18n, t as bindI18nRuntime } from "./i18n-DPOzFBuG.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";
@@ -206,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,
@@ -245,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,
@@ -260,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-emLZM9XN.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-Bt-2meGm.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-C5YuXGJl.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/{i18n-CAeXKTpy.js → i18n-DPOzFBuG.js}

@@ -108,6 +108,13 @@ function writeLocaleCookie(code) {
 * Framework setLocale: load messages, switch composer locale, write cookie,
 * navigate to the localized path (`no_prefix` skips navigation).
 *
+* Server-side (no `window`) the navigation is skipped: the render URL is the
+* source of truth during SSR/SSG, and `router.replace` on the shared
+* memory-history router — often a stale instance from a previous render —
+* cancels in-flight initial navigations. Combined with a navigation guard
+* calling `setLocale`, this used to create a self-sustaining replace loop
+* that starved the event loop (docs SSG build hang, 2026-09-10).
+*
 * Uses the runtime bound by `bindI18nRuntime` (not Vue composables) so it is
 * safe to call from click handlers.
 */
@@ -123,7 +130,7 @@ async function setLocale(code) {
 	}) : Promise.resolve();
 	const cfg = state.config;
 	let navPromise = Promise.resolve();
-	if (cfg && cfg.strategy !== "no_prefix") {
+	if (cfg && cfg.strategy !== "no_prefix" && typeof window !== "undefined") {
 		const router = state.router;
 		const currentPath = (router?.currentRoute.value.path || router?.currentRoute.value.fullPath?.split("?")[0] || (typeof window !== "undefined" ? window.location.pathname : "/")).split("?")[0];
 		const target = switchLocalePath(code, currentPath, routingFrom(cfg));
@@ -135,6 +142,8 @@ function getLocale() {
 	try {
 		return String(useI18n().locale.value);
 	} catch {
+		const composer = getRuntimeState().i18n?.global;
+		if (composer) return String(composer.locale.value);
 		return getRuntimeConfigState()?.defaultLocale || "en";
 	}
 }

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-emLZM9XN.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,40 +120,47 @@ 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).
  *
+ * Server-side (no `window`) the navigation is skipped: the render URL is the
+ * source of truth during SSR/SSG, and `router.replace` on the shared
+ * memory-history router — often a stale instance from a previous render —
+ * cancels in-flight initial navigations. Combined with a navigation guard
+ * calling `setLocale`, this used to create a self-sustaining replace loop
+ * that starved the event loop (docs SSG build hang, 2026-09-10).
+ *
  * 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 +200,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 +213,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 +237,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 +278,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 +288,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 +362,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 +442,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 +456,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 +501,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 +511,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-Bt-2meGm.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 { 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-C5YuXGJl.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-DPOzFBuG.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-emLZM9XN.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-Bt-2meGm.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-C5YuXGJl.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

@@ -3,7 +3,7 @@ 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

@@ -1,4 +1,4 @@
-import { n as configureI18nRuntime, r as createUbeanI18n } from "./i18n-CAeXKTpy.js";
+import { n as configureI18nRuntime, r as createUbeanI18n } from "./i18n-DPOzFBuG.js";
 import { applyAppConfig } from "./define-app.js";
 import { createSSRApp, defineComponent, h, provide, reactive } from "vue";
 import { SSR_CONTENT_MARKER, STATE_DATA_ID, STATE_MARKER, __clearDataPayload, __clearDeferred, __resolveDataPayload, __resolveDeferred, __serializeDataPayload, __serializeDeferred, safeJsonStringify } from "@ubean/pages";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/client",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "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.5",
-    "@ubean/islands": "0.4.5",
-    "@ubean/pages": "0.4.5",
-    "@ubean/shared": "0.4.5",
-    "@ubean/vue": "0.4.5",
+    "@ubean/i18n": "0.4.7",
+    "@ubean/islands": "0.4.7",
+    "@ubean/pages": "0.4.7",
+    "@ubean/shared": "0.4.7",
+    "@ubean/vue": "0.4.7",
     "@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.5"
+    "@ubean/seo": "0.4.7"
   },
   "peerDependenciesMeta": {
     "@ubean/seo": {