npm - @ubean/client - Versions diffs - 0.2.2 → 0.3.0 - Mend

@ubean/client 0.2.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/dist/{app-Bc1d5Svw.js → app-B6vVB7hp.js} +13 -209
package/dist/{app-BknjDM9j.d.ts → app-BP3eySMH.d.ts} +6 -0
package/dist/app.d.ts +1 -1
package/dist/app.js +1 -1
package/dist/i18n-t0G3VyBs.js +206 -0
package/dist/index.d.ts +73 -47
package/dist/index.js +5 -4
package/dist/server.d.ts +1 -1
package/dist/server.js +1 -1
package/dist/ssr.d.ts +32 -0
package/dist/ssr.js +267 -0
package/package.json +17 -8

package/dist/{app-Bc1d5Svw.js → app-B6vVB7hp.js} RENAMED Viewed

@@ -1,11 +1,10 @@
-import { computed, createApp, createSSRApp, defineComponent, h, inject, markRaw, provide, reactive, ref, shallowRef, watchEffect } from "vue";
+import { a as getI18nRuntimeConfig, l as localizePath, r as createUbeanI18n, s as initClientI18n, t as bindI18nRuntime } from "./i18n-t0G3VyBs.js";
+import { computed, createApp, createSSRApp, defineComponent, h, inject, markRaw, provide, reactive, shallowRef, watchEffect } from "vue";
 import { createMemoryHistory, createRouter, createWebHistory, useRoute, useRouter } 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 { useHead as useUnheadHead, useSeoMeta } from "@unhead/vue";
-import { LOCALE_DATA_ID } from "@ubean/pages";
 import { vClient } from "@ubean/islands/directive";
 import { Head } from "@unhead/vue/components";
-import { addLocale, clearLocales, defineLocale, detectBrowserLocale, detectLocale, extractLocaleFromPath, getDefaultLocale, getI18nConfig, getLocale, getLocaleDir, getLocaleName, getRegisteredLocales, localizePath, mergeLocale, onLocaleChange, setI18nConfig, setLocale, switchLocalePath, t, useI18n } from "@ubean/i18n";
 //#region src/use-page.ts
 /**
 * 框架层 `usePage()` — 路由感知的响应式页面上下文。
@@ -63,209 +62,6 @@ function createUbeanRouter(options) {
 	return router;
 }
 //#endregion
-//#region src/i18n.ts
-const _global = globalThis;
-function hydrateLocale() {
-	if (typeof _global.document === "undefined") return {
-		locale: null,
-		dir: "ltr"
-	};
-	const el = _global.document.getElementById(LOCALE_DATA_ID);
-	if (!el) return {
-		locale: null,
-		dir: "ltr"
-	};
-	try {
-		const data = JSON.parse(el.textContent || "null");
-		if (data && typeof data.locale === "string") return {
-			locale: data.locale,
-			dir: data.dir === "rtl" ? "rtl" : "ltr",
-			messages: data.messages,
-			availableLocales: Array.isArray(data.availableLocales) ? data.availableLocales : void 0
-		};
-	} catch {
-		return {
-			locale: null,
-			dir: "ltr"
-		};
-	}
-	return {
-		locale: null,
-		dir: "ltr"
-	};
-}
-function syncHtmlLang(locale, dir) {
-	if (typeof _global.document === "undefined") return;
-	const html = _global.document.documentElement;
-	if (html) {
-		html.setAttribute("lang", locale);
-		html.setAttribute("dir", dir);
-	}
-}
-/**
-* Lazily hydrate SSR-injected locale data (idempotent).
-*
-* Previously this ran as a module-load side effect (reading the DOM and
-* mutating `<html lang/dir>` on import). It is now invoked explicitly by
-* `createUbeanClientApp` / `createUbeanSSRApp` and by the read APIs below,
-* keeping module import side-effect free.
-*/
-let _i18nHydrated = false;
-function initClientI18n() {
-	if (_i18nHydrated) return;
-	_i18nHydrated = true;
-	const { locale: hydratedLocale, dir: hydratedDir, messages: hydratedMessages, availableLocales: hydratedAvailable } = hydrateLocale();
-	if (!hydratedLocale) return;
-	if (hydratedAvailable && hydratedAvailable.length > 0) {
-		const sorted = [...hydratedAvailable].sort((a, b) => (b.isDefault ? 1 : 0) - (a.isDefault ? 1 : 0));
-		for (const loc of sorted) {
-			const isCurrent = loc.code === hydratedLocale;
-			defineLocale({
-				code: loc.code,
-				messages: isCurrent && hydratedMessages ? hydratedMessages : {},
-				name: loc.name,
-				dir: loc.dir,
-				isDefault: loc.isDefault
-			});
-		}
-	} else if (hydratedMessages && typeof hydratedMessages === "object") defineLocale({
-		code: hydratedLocale,
-		messages: hydratedMessages,
-		dir: hydratedDir
-	});
-	setLocale(hydratedLocale);
-	localeRef.value = hydratedLocale;
-	syncHtmlLang(hydratedLocale, hydratedDir);
-}
-const localeRef = ref(getLocale());
-onLocaleChange((newLocale) => {
-	localeRef.value = newLocale;
-	syncHtmlLang(newLocale, getLocaleDir(newLocale));
-});
-function useI18n$1() {
-	initClientI18n();
-	const core = useI18n();
-	const localeDir = computed(() => getLocaleDir(localeRef.value));
-	const localeName = computed(() => getLocaleName(localeRef.value));
-	function translate(key, params) {
-		localeRef.value;
-		return core.t(key, params);
-	}
-	return {
-		locale: localeRef,
-		get fallbackLocale() {
-			return core.fallbackLocale;
-		},
-		get availableLocales() {
-			return core.availableLocales;
-		},
-		t: translate,
-		setLocale(locale) {
-			core.setLocale(locale);
-		},
-		getLocale() {
-			return localeRef.value;
-		},
-		onLocaleChange(callback) {
-			return core.onLocaleChange(callback);
-		},
-		getLocaleDir(locale) {
-			return core.getLocaleDir(locale);
-		},
-		getLocaleName(locale) {
-			return core.getLocaleName(locale);
-		},
-		localeDir,
-		localeName
-	};
-}
-function defineLocale$1(definition) {
-	initClientI18n();
-	const result = defineLocale(definition);
-	localeRef.value = getLocale();
-	return result;
-}
-/**
-* 建立对当前 locale 的响应式依赖(模板中的 `t()` / `localizePath()` 经此驱动重渲染)。
-* i18n core 的状态存于 globalThis(非响应式),Vue 侧的 `localeRef` 是唯一响应源。
-*/
-function trackLocale() {
-	initClientI18n();
-	localeRef.value;
-}
-function t$1(key, params) {
-	trackLocale();
-	return t(key, params);
-}
-function setLocale$1(locale) {
-	setLocale(locale);
-}
-function getLocale$1() {
-	return localeRef.value;
-}
-function onLocaleChange$1(callback) {
-	return onLocaleChange(callback);
-}
-function getLocaleDir$1(locale) {
-	return getLocaleDir(locale);
-}
-function getLocaleName$1(locale) {
-	return getLocaleName(locale);
-}
-function getRegisteredLocales$1() {
-	initClientI18n();
-	return getRegisteredLocales();
-}
-function detectLocale$1(acceptLanguage) {
-	return detectLocale(acceptLanguage);
-}
-function detectBrowserLocale$1() {
-	return detectBrowserLocale();
-}
-function addLocale$1(code, messages, options) {
-	addLocale(code, messages, options);
-}
-function mergeLocale$1(code, messages) {
-	mergeLocale(code, messages);
-}
-function clearLocales$1() {
-	clearLocales();
-	localeRef.value = getLocale();
-}
-function getI18nConfig$1() {
-	return getI18nConfig();
-}
-function setI18nConfig$1(config) {
-	setI18nConfig(config);
-}
-function localizePath$1(path, locale) {
-	trackLocale();
-	return localizePath(path, locale);
-}
-function switchLocalePath$1(newLocale, currentPath) {
-	trackLocale();
-	return switchLocalePath(newLocale, currentPath);
-}
-function getDefaultLocale$1() {
-	return getDefaultLocale();
-}
-function extractLocaleFromPath$1(path) {
-	return extractLocaleFromPath(path);
-}
-function useSwitchLocalePath() {
-	initClientI18n();
-	return computed(() => (newLocale) => {
-		const path = typeof _global.window !== "undefined" ? _global.window.location.pathname : "/";
-		return switchLocalePath(newLocale, path);
-	});
-}
-function useLocalePath() {
-	initClientI18n();
-	return computed(() => (path, locale) => {
-		return localizePath(path, locale || localeRef.value);
-	});
-}
-//#endregion
 //#region src/page-macro.ts
 function definePage(_meta) {}
 function defineMeta(_meta) {}
@@ -273,7 +69,7 @@ function defineMiddleware(_handler) {}
 //#endregion
 //#region src/app.ts
 /**
-* Framework app factories — consumed by the ubean aggregator & `@ubean/ssr`.
+* Framework app factories — consumed by the ubean aggregator & `@ubean/client/ssr`.
 *
 * `createUbeanClientApp` / `createUbeanSSRApp` wire the lean kernel from
 * `@ubean/vue` together with framework extras: unhead, i18n path
@@ -352,7 +148,7 @@ function createRootComponent(LayoutWrapper, page, transitionOpts, isSSR, loading
 			provide(SSR_KEY, isSSR);
 			provide(LOADING_KEY, loadingComponent ?? null);
 			provide(ERROR_KEY, errorComponent ?? null);
-			provide(LOCALIZE_PATH_KEY, (path) => localizePath$1(path));
+			provide(LOCALIZE_PATH_KEY, (path, locale) => localizePath(path, locale));
 			return () => h(LayoutWrapper);
 		}
 	});
@@ -378,8 +174,12 @@ function createUbeanClientApp(options) {
 	initCachedViewsFromRoutes(options.routes);
 	const RootComponent = createRootComponent(LayoutWrapper, page, transitionOpts, false, resolveComp(options.loadingComponent), resolveComp(options.errorComponent));
 	const app = options.hydrate ? createSSRApp(RootComponent) : createApp(RootComponent);
+	const i18n = options.i18n ?? createUbeanI18n();
+	app.use(i18n);
 	app.use(head);
 	app.use(router);
+	bindI18nRuntime(i18n, router);
+	app.provide("ubean:i18n-runtime-config", getI18nRuntimeConfig());
 	app.component("Link", Link);
 	app.component("PageView", PageView);
 	app.component("SlotView", SlotView);
@@ -411,8 +211,12 @@ function createUbeanSSRApp(initialPage, options) {
 	initCachedViewsFromRoutes(options.routes);
 	const RootComponent = createRootComponent(LayoutWrapper, page, { enabled: false }, true, resolveComp(options.loadingComponent), resolveComp(options.errorComponent));
 	const app = createSSRApp(RootComponent);
+	const i18n = options.i18n ?? createUbeanI18n();
+	app.use(i18n);
 	app.use(head);
 	app.use(router);
+	bindI18nRuntime(i18n, router);
+	app.provide("ubean:i18n-runtime-config", getI18nRuntimeConfig());
 	app.component("Link", Link);
 	app.component("PageView", PageView);
 	app.component("SlotView", SlotView);
@@ -430,4 +234,4 @@ function createUbeanSSRApp(initialPage, options) {
 }
 const Head$1 = Head;
 //#endregion
-export { getI18nConfig$1 as A, setLocale$1 as B, addLocale$1 as C, detectLocale$1 as D, detectBrowserLocale$1 as E, initClientI18n as F, useSwitchLocalePath as G, t$1 as H, localizePath$1 as I, createUbeanRouter as K, mergeLocale$1 as L, getLocaleDir$1 as M, getLocaleName$1 as N, extractLocaleFromPath$1 as O, getRegisteredLocales$1 as P, onLocaleChange$1 as R, definePage as S, defineLocale$1 as T, useI18n$1 as U, switchLocalePath$1 as V, useLocalePath as W, useSeoMeta as _, LOCALIZE_PATH_KEY$1 as a, defineMeta as b, PAGE_KEY$1 as c, SlotView as d, TRANSITION_KEY$1 as f, useRouter as g, ubeanVue as h, LOADING_KEY$1 as i, getLocale$1 as j, getDefaultLocale$1 as k, PageView as l, createUbeanSSRApp as m, Head$1 as n, LayoutChainRenderer$1 as o, createUbeanClientApp as p, usePage as q, LAYOUT_CHAIN_KEY as r, Link as s, ERROR_KEY$1 as t, SSR_KEY$1 as u, useUnheadHead as v, clearLocales$1 as w, defineMiddleware as x, useViewTransition as y, setI18nConfig$1 as z };
+export { createUbeanRouter as C, definePage as S, useSeoMeta as _, LOCALIZE_PATH_KEY$1 as a, defineMeta as b, PAGE_KEY$1 as c, SlotView as d, TRANSITION_KEY$1 as f, useRouter 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, useUnheadHead as v, usePage as w, defineMiddleware as x, useViewTransition as y };

package/dist/{app-BknjDM9j.d.ts → app-BP3eySMH.d.ts} RENAMED Viewed

@@ -3,6 +3,7 @@ import { RouteRecordRaw, Router, useRouter } 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 { VueHeadClient, useHead as useUnheadHead, useSeoMeta } from "@unhead/vue";
 import { PageObject } from "@ubean/pages";
+import { I18n } from "vue-i18n";
 import { Input, RouteMeta } from "@ubean/shared";
 //#region src/router.d.ts
 interface CreateUbeanRouterOptions {
@@ -83,6 +84,11 @@ interface UbeanAppOptions {
    * 通过 Vue 的 `errorCaptured` 生命周期实现错误边界。
    */
   errorComponent?: Component | (() => Component);
+  /**
+   * vue-i18n instance (`legacy: false`). Created by `createUbeanI18n`.
+   * Installed with `app.use(i18n)` before the router.
+   */
+  i18n?: I18n;
 }
 interface UbeanAppInstance {
   app: App;

package/dist/app.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
-import { A as CreateUbeanRouterOptions, C as useUnheadHead, D as definePage, E as defineMiddleware, O as UbeanVuePage, S as useSeoMeta, T as defineMeta, _ as VueHeadClient, a as LOCALIZE_PATH_KEY, b as ubeanVue, c as Link, d as SSR_KEY, f as SlotView, g as UbeanVueOptions, h as UbeanAppOptions, i as LOADING_KEY, j as createUbeanRouter, k as usePage, 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 createUbeanClientApp, w as useViewTransition, x as useRouter, y as createUbeanSSRApp } from "./app-BknjDM9j.js";
+import { A as CreateUbeanRouterOptions, C as useUnheadHead, D as definePage, E as defineMiddleware, O as UbeanVuePage, S as useSeoMeta, T as defineMeta, _ as VueHeadClient, a as LOCALIZE_PATH_KEY, b as ubeanVue, c as Link, d as SSR_KEY, f as SlotView, g as UbeanVueOptions, h as UbeanAppOptions, i as LOADING_KEY, j as createUbeanRouter, k as usePage, 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 createUbeanClientApp, w as useViewTransition, x as useRouter, y as createUbeanSSRApp } from "./app-BP3eySMH.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, type VueHeadClient, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useRouter, useSeoMeta, useViewTransition };

package/dist/app.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import { K as createUbeanRouter, S as definePage, _ as useSeoMeta, a as LOCALIZE_PATH_KEY, b as defineMeta, c as PAGE_KEY, d as SlotView, f as TRANSITION_KEY, g as useRouter, h as ubeanVue, i as LOADING_KEY, l as PageView, m as createUbeanSSRApp, n as Head, o as LayoutChainRenderer, p as createUbeanClientApp, q as usePage, r as LAYOUT_CHAIN_KEY, s as Link, t as ERROR_KEY, u as SSR_KEY, v as useUnheadHead, x as defineMiddleware, y as useViewTransition } from "./app-Bc1d5Svw.js";
+import { C as createUbeanRouter, S as definePage, _ as useSeoMeta, a as LOCALIZE_PATH_KEY, b as defineMeta, c as PAGE_KEY, d as SlotView, f as TRANSITION_KEY, g as useRouter, 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 useUnheadHead, w as usePage, x as defineMiddleware, y as useViewTransition } from "./app-B6vVB7hp.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, useRouter, useSeoMeta, useViewTransition };

package/dist/i18n-t0G3VyBs.js ADDED Viewed

@@ -0,0 +1,206 @@
+import { computed } from "vue";
+import { useRoute } from "vue-router";
+import { LOCALE_DATA_ID } from "@ubean/pages";
+import { createI18n, useI18n as useVueI18n } from "vue-i18n";
+import { buildLocaleHead, extractLocaleFromPath, localizePath, switchLocalePath } from "@ubean/i18n/browser";
+//#region src/i18n.ts
+const RUNTIME_KEY = "__UBEAN_I18N_RUNTIME__";
+function getRuntimeState() {
+	const g = globalThis;
+	if (!g[RUNTIME_KEY]) g[RUNTIME_KEY] = {
+		config: null,
+		loader: null,
+		metas: []
+	};
+	return g[RUNTIME_KEY];
+}
+function getRuntimeConfigState() {
+	return getRuntimeState().config;
+}
+function setRuntimeConfigState(config) {
+	getRuntimeState().config = config;
+}
+function bindI18nRuntime(i18n, router) {
+	const state = getRuntimeState();
+	state.i18n = i18n;
+	if (router) state.router = router;
+}
+function configureI18nRuntime(options) {
+	const state = getRuntimeState();
+	state.config = options.config;
+	if (options.loadLocale) state.loader = options.loadLocale;
+	if (options.locales) state.metas = options.locales;
+}
+function getI18nRuntimeConfig() {
+	return getRuntimeConfigState();
+}
+function localeCodesFrom(input) {
+	if (!Array.isArray(input)) return [];
+	const codes = [];
+	for (const item of input) if (typeof item === "string") codes.push(item);
+	else if (item && typeof item === "object" && "code" in item) codes.push(String(item.code));
+	return codes;
+}
+function applyHydratedPayload(hydrated) {
+	const state = getRuntimeState();
+	if (hydrated.routing && !state.config) setRuntimeConfigState({
+		defaultLocale: hydrated.routing.defaultLocale,
+		locales: localeCodesFrom(hydrated.routing.locales),
+		strategy: hydrated.routing.strategy,
+		fallbackLocale: hydrated.fallbackLocale || hydrated.routing.defaultLocale,
+		cookieName: hydrated.cookieName || "ubean_locale",
+		baseUrl: hydrated.baseUrl || ""
+	});
+	else if (hydrated.routing && state.config && !state.config.locales.length) state.config.locales = localeCodesFrom(hydrated.routing.locales);
+	const metas = hydrated.locales || hydrated.availableLocales;
+	if (metas) state.metas = metas;
+}
+function routingFrom(config) {
+	return {
+		defaultLocale: config.defaultLocale,
+		locales: config.locales,
+		strategy: config.strategy
+	};
+}
+function readHydratedPayload() {
+	if (typeof document === "undefined") return null;
+	const el = document.getElementById(LOCALE_DATA_ID);
+	if (!el?.textContent) return null;
+	try {
+		return JSON.parse(el.textContent);
+	} catch {
+		return null;
+	}
+}
+function createUbeanI18n(options) {
+	const hydrated = typeof document !== "undefined" ? readHydratedPayload() : null;
+	const cfg = getRuntimeConfigState();
+	const locale = options?.locale || hydrated?.locale || cfg?.defaultLocale || "en";
+	const fallbackLocale = options?.fallbackLocale || hydrated?.fallbackLocale || cfg?.fallbackLocale || cfg?.defaultLocale || locale;
+	const messages = { ...options?.messages };
+	if (hydrated?.messages && hydrated.locale) messages[hydrated.locale] = hydrated.messages;
+	if (hydrated?.fallbackMessages && hydrated.fallbackLocale && hydrated.fallbackLocale !== hydrated.locale) messages[hydrated.fallbackLocale] = hydrated.fallbackMessages;
+	if (!messages[locale]) messages[locale] = {};
+	if (fallbackLocale !== locale && !messages[fallbackLocale]) messages[fallbackLocale] = {};
+	if (hydrated) applyHydratedPayload(hydrated);
+	const hydratedConfig = getRuntimeState().config;
+	if (hydratedConfig && options?.vueI18n) hydratedConfig.vueI18n = options.vueI18n;
+	return createI18n({
+		legacy: false,
+		locale,
+		fallbackLocale,
+		messages,
+		missingWarn: false,
+		fallbackWarn: false,
+		...cfg?.vueI18n,
+		...options?.vueI18n
+	});
+}
+function installUbeanI18n(app, i18n) {
+	app.use(i18n);
+}
+function writeLocaleCookie(code) {
+	if (typeof document === "undefined") return;
+	const name = getRuntimeConfigState()?.cookieName || "ubean_locale";
+	document.cookie = `${name}=${encodeURIComponent(code)}; Path=/; SameSite=Lax`;
+}
+/**
+* Framework setLocale: load messages, switch composer locale, write cookie,
+* navigate to the localized path (`no_prefix` skips navigation).
+*
+* Uses the runtime bound by `bindI18nRuntime` (not Vue composables) so it is
+* safe to call from click handlers.
+*/
+async function setLocale(code) {
+	const state = getRuntimeState();
+	const composer = state.i18n?.global;
+	if (!composer) return;
+	composer.locale.value = code;
+	writeLocaleCookie(code);
+	const loader = state.loader;
+	const loadPromise = loader ? loader(code).then((msgs) => {
+		composer.setLocaleMessage(code, msgs);
+	}) : Promise.resolve();
+	const cfg = state.config;
+	let navPromise = Promise.resolve();
+	if (cfg && cfg.strategy !== "no_prefix") {
+		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));
+		if (target !== currentPath && router) navPromise = router.replace(target).then(() => void 0, () => void 0);
+	}
+	await Promise.all([loadPromise, navPromise]);
+}
+function getLocale() {
+	try {
+		return String(useVueI18n().locale.value);
+	} catch {
+		return getRuntimeConfigState()?.defaultLocale || "en";
+	}
+}
+function localizePath$1(path, locale) {
+	const cfg = getRuntimeConfigState();
+	if (!cfg) return path;
+	return localizePath(path, locale || getLocale(), routingFrom(cfg));
+}
+function switchLocalePath$1(locale, path) {
+	const cfg = getRuntimeConfigState();
+	if (!cfg) return path || "/";
+	const current = path ?? (typeof window !== "undefined" ? window.location.pathname : "/");
+	return switchLocalePath(locale, current, routingFrom(cfg));
+}
+function extractLocaleFromPath$1(path) {
+	const codes = getRuntimeConfigState()?.locales || [];
+	return extractLocaleFromPath(path, codes);
+}
+function useI18n() {
+	return useVueI18n();
+}
+function t(key, ...args) {
+	const translate = useVueI18n().t;
+	return String(translate(key, ...args));
+}
+function useLocalePath() {
+	const i18n = useVueI18n();
+	return (path, locale) => localizePath$1(path, locale ?? String(i18n.locale.value));
+}
+function useSwitchLocalePath() {
+	const route = useRoute();
+	return (locale) => switchLocalePath$1(locale, route.path);
+}
+function useLocaleRoute() {
+	return useLocalePath();
+}
+function useLocaleHead() {
+	const i18n = useVueI18n();
+	const route = useRoute();
+	return computed(() => {
+		const cfg = getRuntimeConfigState();
+		const routing = cfg ? routingFrom(cfg) : {
+			defaultLocale: "en",
+			locales: ["en"],
+			strategy: "prefix_except_default"
+		};
+		return buildLocaleHead({
+			path: route.path,
+			locale: String(i18n.locale.value),
+			locales: (getRuntimeState().metas || []).map((l) => ({
+				code: l.code,
+				language: l.language,
+				name: l.name,
+				dir: l.dir,
+				isDefault: l.isDefault
+			})),
+			routing,
+			baseUrl: cfg?.baseUrl
+		});
+	});
+}
+/** Hydrate routing config from SSR payload before the first render. */
+function initClientI18n() {
+	const hydrated = readHydratedPayload();
+	if (!hydrated) return;
+	applyHydratedPayload(hydrated);
+}
+//#endregion
+export { useSwitchLocalePath as _, getI18nRuntimeConfig as a, installUbeanI18n as c, switchLocalePath$1 as d, t as f, useLocaleRoute as g, useLocalePath as h, extractLocaleFromPath$1 as i, localizePath$1 as l, useLocaleHead as m, configureI18nRuntime as n, getLocale as o, useI18n as p, createUbeanI18n as r, initClientI18n as s, bindI18nRuntime as t, setLocale as u };

package/dist/index.d.ts CHANGED Viewed

@@ -1,13 +1,14 @@
-import { A as CreateUbeanRouterOptions, C as useUnheadHead, D as definePage, E as defineMiddleware, O as UbeanVuePage, S as useSeoMeta, T as defineMeta, _ as VueHeadClient$1, h as UbeanAppOptions, j as createUbeanRouter, k as usePage, m as UbeanAppInstance, n as Head, v as createUbeanClientApp, y as createUbeanSSRApp } from "./app-BknjDM9j.js";
+import { A as CreateUbeanRouterOptions, C as useUnheadHead, D as definePage, E as defineMiddleware, O as UbeanVuePage, S as useSeoMeta, T as defineMeta, _ as VueHeadClient$1, h as UbeanAppOptions, j as createUbeanRouter, k as usePage, m as UbeanAppInstance, n as Head, v as createUbeanClientApp, y as createUbeanSSRApp } from "./app-BP3eySMH.js";
 import { AppPluginConfig, DefineAppOptions, ResolvedAppConfig, applyAppConfig, createDefaultAppConfig, defineApp, mergeAppConfig } from "./define-app.js";
-import { ComputedRef, Ref, ShallowRef } from "vue";
+import { App, ComputedRef, Ref, ShallowRef } from "vue";
 import { useRouter } from "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 { VueHeadClient, injectHead } from "@unhead/vue";
 import { createHead as createClientHead } from "@unhead/vue/client";
-import { PageObject } from "@ubean/pages";
-import { I18nConfig, LocaleChangeCallback, LocaleDefinition, LocaleMessages } from "@ubean/i18n";
-import { HydrateIslandsOptions, IslandHydrateOptions, IslandRecord, collectIslands, hydrateIsland, hydrateIslands } from "@ubean/islands/runtime";
+import { DataResult, PageObject, UseAsyncDataOptions, UseFetchOptions, invalidateData, setDefaultFetch, useAsyncData, useData, useFetch } from "@ubean/pages";
+import { Composer, I18n, I18n as VueI18nInstance } from "vue-i18n";
+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;
@@ -46,7 +47,7 @@ interface DataCacheStore {
   getTimestamp: (key: string | symbol) => number | undefined;
 }
 declare function createDataCacheStore(): DataCacheStore;
-interface UseAsyncDataOptions<T> {
+interface UseAsyncDataOptions$1<T> {
   key?: string;
   tags?: string[];
   lazy?: boolean;
@@ -67,7 +68,7 @@ interface UseAsyncDataReturn<T> {
   refresh: () => Promise<void>;
   invalidate: () => void;
 }
-declare function createUseAsyncData(store: DataCacheStore): <T = unknown>(keyOrFetcher: string | (() => Promise<T>), fetcherOrOptions?: (() => Promise<T>) | UseAsyncDataOptions<T>, options?: UseAsyncDataOptions<T>) => UseAsyncDataReturn<T>;
+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;
@@ -83,54 +84,79 @@ declare function useServerData<T>(fetcher: () => Promise<T>): Promise<T>;
 declare function getInvalidatedKeysForAction(actionName: string, invalidationMap: Record<string, Array<string | symbol>>, store: DataCacheStore): number;
 //#endregion
 //#region src/i18n.d.ts
-declare function initClientI18n(): void;
-interface VueI18nInstance {
-  locale: {
-    value: string;
-  };
+type LocaleMessages = Record<string, unknown>;
+interface I18nRuntimeConfig {
+  defaultLocale: string;
+  locales: string[];
+  strategy: LocaleRoutingConfig['strategy'];
   fallbackLocale: string;
-  availableLocales: string[];
-  t: (key: string, params?: Record<string, string | number>) => string;
-  setLocale: (locale: string) => void;
-  getLocale: () => string;
-  onLocaleChange: (callback: LocaleChangeCallback) => () => void;
-  getLocaleDir: (locale?: string) => 'ltr' | 'rtl';
-  getLocaleName: (locale?: string) => string | undefined;
-  localeDir: {
-    value: 'ltr' | 'rtl';
-  };
-  localeName: {
-    value: string | undefined;
-  };
+  cookieName: string;
+  baseUrl: string;
+  vueI18n?: Record<string, unknown>;
 }
-declare function useI18n(): VueI18nInstance;
-declare function defineLocale(definition: LocaleDefinition): LocaleDefinition;
-declare function t(key: string, params?: Record<string, string | number>): string;
-declare function setLocale(locale: string): void;
-declare function getLocale(): string;
-declare function onLocaleChange(callback: LocaleChangeCallback): () => void;
-declare function getLocaleDir(locale?: string): 'ltr' | 'rtl';
-declare function getLocaleName(locale?: string): string | undefined;
-declare function getRegisteredLocales(): string[];
-declare function detectLocale(acceptLanguage?: string): string;
-declare function detectBrowserLocale(): string;
-declare function addLocale(code: string, messages: LocaleMessages, options?: {
-  name?: string;
+interface LocaleLoader {
+  (code: string): Promise<LocaleMessages>;
+}
+interface HydratedLocalePayload {
+  locale?: string;
   dir?: 'ltr' | 'rtl';
+  messages?: LocaleMessages;
+  fallbackLocale?: string;
+  fallbackMessages?: LocaleMessages;
+  routing?: LocaleRoutingConfig;
+  cookieName?: string;
+  baseUrl?: string;
+  locales?: Array<{
+    code: string;
+    language?: string;
+    name?: string;
+    dir?: 'ltr' | 'rtl';
+    isDefault?: boolean;
+  }>;
+  availableLocales?: Array<{
+    code: string;
+    language?: string;
+    name?: string;
+    dir?: 'ltr' | 'rtl';
+    isDefault?: boolean;
+  }>;
+}
+declare function configureI18nRuntime(options: {
+  config: I18nRuntimeConfig;
+  loadLocale?: LocaleLoader;
+  locales?: HydratedLocalePayload['locales'];
 }): void;
-declare function mergeLocale(code: string, messages: LocaleMessages): void;
-declare function clearLocales(): void;
-declare function getI18nConfig(): I18nConfig;
-declare function setI18nConfig(config: Partial<I18nConfig>): void;
+declare function getI18nRuntimeConfig(): I18nRuntimeConfig | null;
+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;
+/**
+ * Framework setLocale: load messages, switch composer locale, write cookie,
+ * navigate to the localized path (`no_prefix` skips navigation).
+ *
+ * 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(newLocale: string, currentPath?: string): string;
-declare function getDefaultLocale(): string;
+declare function switchLocalePath(locale: string, path?: string): string;
 declare function extractLocaleFromPath(path: string): {
   locale: string | null;
   pathWithoutLocale: string;
 };
-declare function useSwitchLocalePath(): import("vue").ComputedRef<(newLocale: string) => string>;
-declare function useLocalePath(): import("vue").ComputedRef<(path: string, locale?: string) => string>;
+declare function useI18n(): Composer;
+declare function t(key: string, ...args: unknown[]): 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>>;
+/** Hydrate routing config from SSR payload before the first render. */
+declare function initClientI18n(): void;
 //#endregion
 //#region src/color-mode.d.ts
 interface ColorModeConfig {
@@ -483,4 +509,4 @@ declare function _resetSearch(): void;
  */
 declare function _setPagefindMock(mock: any): void;
 //#endregion
-export { type AppPluginConfig, type ColorMode, type ColorModeConfig, type CreateUbeanRouterOptions, type DataCacheStore, type DefineAppOptions, ERROR_KEY, ErrorBoundary, Head, type VueHeadClient as HeadClient, type HydrateIslandsOptions, type IslandHydrateOptions, type IslandRecord, LAYOUT_CHAIN_KEY, LOADING_KEY, LOCALIZE_PATH_KEY, type LayoutChainContext, LayoutChainRenderer, Link, type LinkProps, type LinkTag, 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 UsePageTransitionReturn, type UseReloadSignalReturn, type UseScriptOptions, type UseScriptReturn, type UseSearchOptions, type UseSearchReturn, type ViewTransitionOptions, type VueHeadClient$1 as VueHeadClient, type VueI18nInstance, _resetColorMode, _resetPartyTown, _resetSearch, _setPagefindMock, addLocale, applyAppConfig, clearCache, clearLocales, clearPageTransition, collectIslands, configureColorMode, configurePartyTown, configureSearch, createClientHead, createDataCacheStore, createDefaultAppConfig, createLinkHandler, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, createUseAsyncData, defineApp, defineDataKey, defineLocale, defineMeta, defineMiddleware, definePage, detectBrowserLocale, detectLocale, disablePageCache, enablePageCache, excludePageCache, executeSearch, extractLocaleFromPath, extractPageData, forceColorMode, getCacheEnabled, getCachedViewNames, getColorModeConfig, getColorModeScript, getDefaultLocale, getExcludedViewNames, getI18nConfig, getInitialPageData, getInitialState, getInvalidatedKeysForAction, getLocale, getLocaleDir, getLocaleName, getNamedPageWrapper, getNavigationType, getPageTransitionName, getPartyTownConfig, getPartyTownHeadContent, getPartyTownScript, getRegisteredLocales, getReloadCounter, getSearchConfig, hydrateIsland, hydrateIslands, includePageCache, initCachedViewsFromRoutes, initClientI18n, initPagefind, injectHead, invalidateCache, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isPagefindLoaded, isPartyTownEnabled, isReloading, localizePath, mergeAppConfig, mergeLocale, onLocaleChange, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveColorModeConfig, resolvePartyTownConfig, resolveRoute, resolveSearchConfig, setI18nConfig, setLocale, setPageTransition, supportsViewTransitions, switchLocalePath, t, ubeanVue, unforceColorMode, useCacheViews, useColorMode, useUnheadHead as useHead, useHeadInstance, useI18n, useLocalePath, usePage, usePageTransition, useReloadSignal, useRouter, useScript, useSearch, useSeoMeta, useServerData, useSwitchLocalePath, useViewTransition, useViewTransitionState, withViewTransition };
+export { type AppPluginConfig, type ColorMode, type ColorModeConfig, type CreateUbeanRouterOptions, type DataCacheStore, type DataResult, type DefineAppOptions, ERROR_KEY, ErrorBoundary, Head, type VueHeadClient as HeadClient, 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, type VueHeadClient$1 as VueHeadClient, type VueI18nInstance, _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, injectHead, 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, t, ubeanVue, unforceColorMode, useAsyncData, useCacheViews, useColorMode, useData, useFetch, useUnheadHead as useHead, useHeadInstance, useI18n, useLocaleHead, useLocalePath, useLocaleRoute, usePage, usePageTransition, useReloadSignal, useRouter, useScript, useSearch, useSeoMeta, useServerData, useSwitchLocalePath, useViewTransition, useViewTransitionState, withViewTransition };

package/dist/index.js CHANGED Viewed

@@ -1,12 +1,13 @@
-import { A as getI18nConfig, B as setLocale, C as addLocale, D as detectLocale, E as detectBrowserLocale, F as initClientI18n, G as useSwitchLocalePath, H as t, I as localizePath, K as createUbeanRouter, L as mergeLocale, M as getLocaleDir, N as getLocaleName, O as extractLocaleFromPath, P as getRegisteredLocales, R as onLocaleChange, S as definePage, T as defineLocale, U as useI18n, V as switchLocalePath, W as useLocalePath, _ as useSeoMeta, b as defineMeta, j as getLocale, k as getDefaultLocale, m as createUbeanSSRApp, n as Head, p as createUbeanClientApp, q as usePage, v as useUnheadHead, w as clearLocales, x as defineMiddleware, z as setI18nConfig } from "./app-Bc1d5Svw.js";
+import { C as createUbeanRouter, S as definePage, _ as useSeoMeta, b as defineMeta, m as createUbeanSSRApp, n as Head, p as createUbeanClientApp, v as useUnheadHead, w as usePage, x as defineMiddleware } from "./app-B6vVB7hp.js";
+import { _ as useSwitchLocalePath, a as getI18nRuntimeConfig, c as installUbeanI18n, d as switchLocalePath, f as t, g as useLocaleRoute, h as useLocalePath, i as extractLocaleFromPath, l as localizePath, m as useLocaleHead, n as configureI18nRuntime, o as getLocale, p as useI18n, r as createUbeanI18n, s as initClientI18n, u as setLocale } from "./i18n-t0G3VyBs.js";
 import { applyAppConfig, createDefaultAppConfig, defineApp, mergeAppConfig } from "./define-app.js";
 import { computed, getCurrentInstance, markRaw, onMounted, onScopeDispose, onUnmounted, ref, shallowRef, watch } from "vue";
 import { useRouter } from "vue-router";
 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 { injectHead, injectHead as injectHead$1 } from "@unhead/vue";
 import { createHead as createClientHead } from "@unhead/vue/client";
-import { defineDataKey as defineDataKey$1 } from "@ubean/pages";
-import { collectIslands, hydrateIsland, hydrateIslands } from "@ubean/islands/runtime";
+import { defineDataKey as defineDataKey$1, invalidateData, setDefaultFetch, useAsyncData, useData, useFetch } from "@ubean/pages";
+import { collectIslands, hasPendingIslands, hydrateIsland, hydrateIslands, scheduleIslandHydration } from "@ubean/islands/runtime";
 //#region src/client.ts
 const _global$1 = globalThis;
 function getInitialPageData() {
@@ -1021,4 +1022,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, addLocale, applyAppConfig, clearCache, clearLocales, clearPageTransition, collectIslands, configureColorMode, configurePartyTown, configureSearch, createClientHead, createDataCacheStore, createDefaultAppConfig, createLinkHandler, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, createUseAsyncData, defineApp, defineDataKey, defineLocale, defineMeta, defineMiddleware, definePage, detectBrowserLocale, detectLocale, disablePageCache, enablePageCache, excludePageCache, executeSearch, extractLocaleFromPath, extractPageData, forceColorMode, getCacheEnabled, getCachedViewNames, getColorModeConfig, getColorModeScript, getDefaultLocale, getExcludedViewNames, getI18nConfig, getInitialPageData, getInitialState, getInvalidatedKeysForAction, getLocale, getLocaleDir, getLocaleName, getNamedPageWrapper, getNavigationType, getPageTransitionName, getPartyTownConfig, getPartyTownHeadContent, getPartyTownScript, getRegisteredLocales, getReloadCounter, getSearchConfig, hydrateIsland, hydrateIslands, includePageCache, initCachedViewsFromRoutes, initClientI18n, initPagefind, injectHead, invalidateCache, invalidatePageCache, isActiveRoute, isCacheEnabled, isPageCached, isPageExcluded, isPagefindLoaded, isPartyTownEnabled, isReloading, localizePath, mergeAppConfig, mergeLocale, onLocaleChange, reloadPage, resetNamedPageWrappers, resetRouteCache, resolveColorModeConfig, resolvePartyTownConfig, resolveRoute, resolveSearchConfig, setI18nConfig, setLocale, setPageTransition, supportsViewTransitions, switchLocalePath, t, ubeanVue, unforceColorMode, useCacheViews, useColorMode, useUnheadHead as useHead, useHeadInstance, useI18n, useLocalePath, usePage, usePageTransition, useReloadSignal, useRouter, useScript, useSearch, useSeoMeta, useServerData, useSwitchLocalePath, useViewTransition, useViewTransitionState, withViewTransition };
+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, injectHead, 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, t, ubeanVue, unforceColorMode, useAsyncData, useCacheViews, useColorMode, useData, useFetch, useUnheadHead as useHead, useHeadInstance, useI18n, useLocaleHead, useLocalePath, useLocaleRoute, usePage, usePageTransition, useReloadSignal, useRouter, useScript, useSearch, useSeoMeta, useServerData, useSwitchLocalePath, useViewTransition, useViewTransitionState, withViewTransition };

package/dist/server.d.ts CHANGED Viewed

@@ -1,3 +1,3 @@
-import { A as CreateUbeanRouterOptions, C as useUnheadHead, D as definePage, E as defineMiddleware, O as UbeanVuePage, S as useSeoMeta, T as defineMeta, _ as VueHeadClient, a as LOCALIZE_PATH_KEY, b as ubeanVue, c as Link, d as SSR_KEY, f as SlotView, g as UbeanVueOptions, h as UbeanAppOptions, i as LOADING_KEY, j as createUbeanRouter, k as usePage, 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 createUbeanClientApp, w as useViewTransition, x as useRouter, y as createUbeanSSRApp } from "./app-BknjDM9j.js";
+import { A as CreateUbeanRouterOptions, C as useUnheadHead, D as definePage, E as defineMiddleware, O as UbeanVuePage, S as useSeoMeta, T as defineMeta, _ as VueHeadClient, a as LOCALIZE_PATH_KEY, b as ubeanVue, c as Link, d as SSR_KEY, f as SlotView, g as UbeanVueOptions, h as UbeanAppOptions, i as LOADING_KEY, j as createUbeanRouter, k as usePage, 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 createUbeanClientApp, w as useViewTransition, x as useRouter, y as createUbeanSSRApp } from "./app-BP3eySMH.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, type VueHeadClient, createServerHead, createUbeanClientApp, createUbeanRouter, createUbeanSSRApp, defineMeta, defineMiddleware, definePage, ubeanVue, useUnheadHead as useHead, usePage, useRouter, useSeoMeta, useViewTransition };

package/dist/server.js CHANGED Viewed

@@ -1,3 +1,3 @@
-import { K as createUbeanRouter, S as definePage, _ as useSeoMeta, a as LOCALIZE_PATH_KEY, b as defineMeta, c as PAGE_KEY, d as SlotView, f as TRANSITION_KEY, g as useRouter, h as ubeanVue, i as LOADING_KEY, l as PageView, m as createUbeanSSRApp, n as Head, o as LayoutChainRenderer, p as createUbeanClientApp, q as usePage, r as LAYOUT_CHAIN_KEY, s as Link, t as ERROR_KEY, u as SSR_KEY, v as useUnheadHead, x as defineMiddleware, y as useViewTransition } from "./app-Bc1d5Svw.js";
+import { C as createUbeanRouter, S as definePage, _ as useSeoMeta, a as LOCALIZE_PATH_KEY, b as defineMeta, c as PAGE_KEY, d as SlotView, f as TRANSITION_KEY, g as useRouter, 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 useUnheadHead, w as usePage, x as defineMiddleware, y as useViewTransition } from "./app-B6vVB7hp.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, useRouter, useSeoMeta, useViewTransition };

package/dist/ssr.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+import { ResolvedAppConfig } from "./define-app.js";
+import { Component } from "vue";
+import { RouteRecordRaw } from "vue-router";
+import { PageRenderer } from "@ubean/pages";
+import { renderToString } from "@vue/server-renderer";
+//#region src/ssr.d.ts
+interface VueRendererSimpleOptions {
+  resolvePageComponent: (path: string) => Promise<Component | null>;
+  resolveLayoutComponent: (name: string | false | null | undefined) => Promise<Component | null>;
+  defaultLayout?: string | null;
+  /**
+   * Resolves the user's `defineApp` config for the server side.
+   * When provided, plugins / globalComponents / provides / head / onAppCreated
+   * will be applied to each SSR app instance.
+   */
+  resolveAppConfig?: () => ResolvedAppConfig | Promise<ResolvedAppConfig>;
+}
+interface VueRendererRouterOptions {
+  routes: RouteRecordRaw[];
+  resolveLayoutComponent: (name: string | false | null | undefined) => Promise<Component | null>;
+  defaultLayout?: string | null;
+  /**
+   * Resolves the user's `defineApp` config for the server side.
+   * When provided, plugins / globalComponents / provides / head / onAppCreated
+   * will be applied to each SSR app instance.
+   */
+  resolveAppConfig?: () => ResolvedAppConfig | Promise<ResolvedAppConfig>;
+}
+type VueRendererOptions = VueRendererSimpleOptions | VueRendererRouterOptions;
+declare function createVueRenderer(options: VueRendererOptions): PageRenderer;
+//#endregion
+export { VueRendererOptions, VueRendererRouterOptions, VueRendererSimpleOptions, createVueRenderer, renderToString };

package/dist/ssr.js ADDED Viewed

@@ -0,0 +1,267 @@
+import { r as createUbeanI18n } from "./i18n-t0G3VyBs.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";
+import { buildLocaleHead } from "@ubean/i18n/browser";
+import { createHead, renderSSRHead, transformHtmlTemplate } from "@unhead/vue/server";
+import { renderToNodeStream, renderToString, renderToString as renderToString$1 } from "@vue/server-renderer";
+import { getIslandsBootstrapScript } from "@ubean/islands";
+//#region src/ssr.ts
+/**
+* Push a `PageHead` (from `defineApp` or page-level `head`) into an @unhead head instance.
+* Extracted so both the global app head and per-page head use the same mapping.
+*/
+function pushPageHead(head, pageHead) {
+	const headInput = {};
+	if (pageHead.title) headInput.title = pageHead.title;
+	if (pageHead.htmlAttrs) headInput.htmlAttrs = pageHead.htmlAttrs;
+	if (pageHead.bodyAttrs) headInput.bodyAttrs = pageHead.bodyAttrs;
+	if (pageHead.meta) headInput.meta = pageHead.meta;
+	if (pageHead.link) headInput.link = pageHead.link;
+	if (pageHead.script) headInput.script = pageHead.script;
+	head.push(headInput);
+}
+/**
+* Apply user's `defineApp` config (plugins, globalComponents, provides) and
+* invoke `onAppCreated` on a freshly created SSR app instance.
+*/
+async function applyServerAppConfig(app, appConfig) {
+	applyAppConfig(app, appConfig, "server");
+	if (appConfig.onAppCreated) await appConfig.onAppCreated(app);
+}
+function isSimpleOptions(opts) {
+	return "resolvePageComponent" in opts;
+}
+/**
+* Resolve a single layout component by name.
+* Returns `null` when layout is `false`, `null`, or not found.
+* ubean uses flat single-layer layout (no nesting), matching the
+* `layout: string | false` field on each page route.
+*/
+async function resolveSingleLayout(layoutName, defaultLayout, resolveLayoutComponent) {
+	const resolved = layoutName === void 0 ? defaultLayout : layoutName;
+	if (resolved === false || resolved == null) return null;
+	return resolveLayoutComponent(resolved);
+}
+function createSimpleApp(pageObj, PageComp, layout, head) {
+	const pageData = reactive({ ...pageObj });
+	const PAGE_KEY = Symbol("ubean-page");
+	const RootComponent = defineComponent({
+		name: "UbeanSimpleApp",
+		setup() {
+			provide(PAGE_KEY, pageData);
+			return () => {
+				const inner = h(PageComp, pageObj.props || {});
+				if (!layout) return inner;
+				return h(layout, {}, { default: () => inner });
+			};
+		}
+	});
+	const app = createSSRApp(RootComponent);
+	app.use(head);
+	return app;
+}
+/**
+* Shared setup for both buffered and streaming renders: creates the head
+* instance, pushes static head (defineApp + locale + page), builds the Vue
+* SSR app, and returns everything the render methods need.
+*/
+async function prepareRender(options, pageObj, renderContext) {
+	const head = createHead();
+	const appConfig = options.resolveAppConfig ? await options.resolveAppConfig() : null;
+	if (appConfig?.head) pushPageHead(head, appConfig.head);
+	if (renderContext?.locale) {
+		const routing = renderContext.routing;
+		if (routing && renderContext.availableLocales?.length) {
+			const tags = buildLocaleHead({
+				path: pageObj.url.split("?")[0] || "/",
+				locale: renderContext.locale,
+				locales: renderContext.availableLocales,
+				routing,
+				baseUrl: renderContext.baseUrl
+			});
+			head.push({
+				htmlAttrs: tags.htmlAttrs,
+				link: tags.link,
+				meta: tags.meta
+			});
+		} else head.push({ htmlAttrs: {
+			lang: renderContext.locale,
+			dir: renderContext.localeDir || "ltr"
+		} });
+	}
+	if (pageObj.head) pushPageHead(head, pageObj.head);
+	const i18n = renderContext?.locale ? createUbeanI18n({
+		locale: renderContext.locale,
+		fallbackLocale: renderContext.fallbackLocale || renderContext.locale,
+		messages: {
+			[renderContext.locale]: renderContext.messages || {},
+			...renderContext.fallbackLocale && renderContext.fallbackMessages && renderContext.fallbackLocale !== renderContext.locale ? { [renderContext.fallbackLocale]: renderContext.fallbackMessages } : {}
+		}
+	}) : void 0;
+	let renderApp;
+	if (isSimpleOptions(options)) {
+		const pageComponent = await options.resolvePageComponent(pageObj.component);
+		if (!pageComponent) throw new Error(`[ubean] Could not resolve page component: ${pageObj.component}`);
+		const app = createSimpleApp(pageObj, pageComponent, pageObj.layout === false ? null : await resolveSingleLayout(pageObj.layout, options.defaultLayout || null, options.resolveLayoutComponent), head);
+		if (i18n) app.use(i18n);
+		if (appConfig) await applyServerAppConfig(app, appConfig);
+		renderApp = app;
+	} else {
+		const { createUbeanSSRApp } = await import("@ubean/client/app");
+		const { app: createdApp, router } = createUbeanSSRApp(pageObj, {
+			routes: options.routes,
+			resolveLayoutComponent: options.resolveLayoutComponent,
+			defaultLayout: options.defaultLayout,
+			head,
+			i18n
+		});
+		if (appConfig) await applyServerAppConfig(createdApp, appConfig);
+		await router.isReady();
+		renderApp = createdApp;
+	}
+	return {
+		app: renderApp,
+		head,
+		appConfig
+	};
+}
+/**
+* Serialize SSR state (e.g. Pinia state) from the app instance after render.
+* Returns `undefined` when there is no state or serialization fails.
+*/
+async function resolveState(app, appConfig) {
+	if (!appConfig?.serializeState) return void 0;
+	try {
+		const serialized = await appConfig.serializeState(app);
+		if (serialized && Object.keys(serialized).length > 0) return serialized;
+	} catch (err) {
+		console.error("[ubean-ssr] serializeState failed:", err);
+	}
+}
+/**
+* P9-24: Collect dynamic head tags that were added during streaming.
+*
+* During streaming SSR, the initial `<head>` is sent before the Vue app
+* renders. Any `useHead()` / `useSeoMeta()` calls inside component setup
+* push entries to the head instance *after* the initial head was sent.
+*
+* This function compares the head state before and after streaming to
+* find tags that were added dynamically, and returns them as an HTML string
+* that can be injected before the stream closes.
+*
+* This ensures SEO crawlers and social media bots see the complete metadata
+* (title, og:tags, etc.) without waiting for client hydration.
+*/
+function collectDynamicHeadTags(head, staticHeadTags) {
+	const fullTags = renderSSRHead(head).headTags || "";
+	if (!fullTags || fullTags === staticHeadTags) return "";
+	const staticLines = new Set(staticHeadTags.split("\n").map((l) => l.trim()).filter(Boolean));
+	const dynamicLines = fullTags.split("\n").map((l) => l.trim()).filter((l) => Boolean(l) && !staticLines.has(l));
+	if (dynamicLines.length === 0) return "";
+	return dynamicLines.join("\n");
+}
+function createVueRenderer(options) {
+	const render = async (pageObj, shellHtml, _assetTags, renderContext) => {
+		__clearDeferred();
+		__clearDataPayload();
+		const { app, head, appConfig } = await prepareRender(options, pageObj, renderContext);
+		const appHtml = await renderToString$1(app);
+		const state = await resolveState(app, appConfig);
+		const deferredData = await __resolveDeferred();
+		const deferredScript = __serializeDeferred(deferredData);
+		const dataPayload = __resolveDataPayload();
+		const dataScript = __serializeDataPayload(dataPayload);
+		if (!shellHtml) {
+			const tail = (dataScript ? dataScript : "") + (deferredScript ? deferredScript : "");
+			return tail ? appHtml + tail : appHtml;
+		}
+		const htmlWithApp = shellHtml.replace(SSR_CONTENT_MARKER, appHtml);
+		let html = transformHtmlTemplate(head, htmlWithApp);
+		const preStateScripts = (dataScript ? `${dataScript}\n  ` : "") + (deferredScript ? `${deferredScript}\n  ` : "");
+		if (preStateScripts) html = html.replace(new RegExp(`(<script id="${STATE_DATA_ID}")`), `${preStateScripts}$1`);
+		if (state) return {
+			html,
+			state
+		};
+		return html;
+	};
+	/**
+	* Streaming SSR: 返回一个 ReadableStream<Uint8Array>,将 HTML 文档分块流式输出。
+	*
+	* 与 `render` 的关键差异:
+	* - 使用 Vue 的 `renderToStream` 替代 `renderToString`,app HTML 边渲染边输出
+	* - 静态 head(defineApp + definePage)在流式开始前注入 `<head>`
+	* - SSR state(Pinia 等)在 app 流结束后、tail 之前注入为 `<script>`(移到 app div 之后,
+	*   因为 state 只有渲染完成后才可用;客户端通过 getElementById 读取,位置无关)
+	* - P9-24: 动态 `useHead()`(组件 setup 内)在 app 流结束后收集,作为 late head tags
+	*   注入到 tail 之前。浏览器会将 `<meta>`/`<title>`/`<link>` 标签自动移入 `<head>`,
+	*   确保 SEO 爬虫和社交机器人看到完整 metadata,无需等待客户端水合。
+	*/
+	const renderToStreamFn = (pageObj, shellHtml, _assetTags, renderContext) => {
+		const encoder = new TextEncoder();
+		async function pumpVueStream(vueStream, controller) {
+			for await (const chunk of vueStream) {
+				const text = typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk);
+				controller.enqueue(encoder.encode(text));
+			}
+		}
+		return new ReadableStream({ async start(controller) {
+			try {
+				__clearDeferred();
+				__clearDataPayload();
+				const { app, head, appConfig } = await prepareRender(options, pageObj, renderContext);
+				if (!shellHtml) {
+					await pumpVueStream(renderToNodeStream(app), controller);
+					const dataPayload = __resolveDataPayload();
+					const dataScript = __serializeDataPayload(dataPayload);
+					if (dataScript) controller.enqueue(encoder.encode(dataScript));
+					const deferredData = await __resolveDeferred();
+					const deferredScript = __serializeDeferred(deferredData);
+					if (deferredScript) controller.enqueue(encoder.encode(deferredScript));
+					controller.close();
+					return;
+				}
+				const markerIdx = shellHtml.indexOf(SSR_CONTENT_MARKER);
+				if (markerIdx === -1) {
+					await pumpVueStream(renderToNodeStream(app), controller);
+					const dataPayload = __resolveDataPayload();
+					const dataScript = __serializeDataPayload(dataPayload);
+					if (dataScript) controller.enqueue(encoder.encode(dataScript));
+					const deferredData = await __resolveDeferred();
+					const deferredScript = __serializeDeferred(deferredData);
+					if (deferredScript) controller.enqueue(encoder.encode(deferredScript));
+					controller.close();
+					return;
+				}
+				let headPart = shellHtml.slice(0, markerIdx);
+				const tailPart = shellHtml.slice(markerIdx + SSR_CONTENT_MARKER.length);
+				const stateScriptRegex = new RegExp(`<script id="${STATE_DATA_ID}" type="application/json">${STATE_MARKER}<\/script>`);
+				headPart = headPart.replace(stateScriptRegex, "");
+				headPart = transformHtmlTemplate(head, headPart);
+				const staticHeadTags = renderSSRHead(head).headTags || "";
+				controller.enqueue(encoder.encode(headPart));
+				await pumpVueStream(renderToNodeStream(app), controller);
+				const dynamicHeadTags = collectDynamicHeadTags(head, staticHeadTags);
+				const dataPayload = __resolveDataPayload();
+				const dataScript = __serializeDataPayload(dataPayload);
+				const deferredData = await __resolveDeferred();
+				const deferredScript = __serializeDeferred(deferredData);
+				const state = await resolveState(app, appConfig);
+				const stateScript = `<script id="${STATE_DATA_ID}" type="application/json">${state ? safeJsonStringify(state) : ""}<\/script>`;
+				const tailContent = (dynamicHeadTags ? `${dynamicHeadTags}\n` : "") + (dataScript ? `${dataScript}\n  ` : "") + (deferredScript ? `${deferredScript}\n  ` : "") + stateScript + tailPart;
+				controller.enqueue(encoder.encode(tailContent));
+				controller.close();
+			} catch (err) {
+				controller.error(err);
+			}
+		} });
+	};
+	return {
+		render,
+		renderToStream: renderToStreamFn,
+		preambleScript: getIslandsBootstrapScript()
+	};
+}
+//#endregion
+export { createVueRenderer, renderToString };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/client",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "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"
@@ -25,17 +25,23 @@
     "./server": {
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js"
+    },
+    "./ssr": {
+      "types": "./dist/ssr.d.ts",
+      "import": "./dist/ssr.js"
     }
   },
   "dependencies": {
-    "@unhead/vue": "^3.3.2",
+    "@unhead/vue": "^3.4.0",
+    "@vue/server-renderer": "^3.5.41",
     "vue": "^3.5.41",
+    "vue-i18n": "11.4.8",
     "vue-router": "^5.2.0",
-    "@ubean/islands": "0.2.2",
-    "@ubean/i18n": "0.2.2",
-    "@ubean/pages": "0.2.2",
-    "@ubean/shared": "0.2.2",
-    "@ubean/vue": "0.2.2"
+    "@ubean/pages": "0.3.0",
+    "@ubean/i18n": "0.3.0",
+    "@ubean/shared": "0.3.0",
+    "@ubean/islands": "0.3.0",
+    "@ubean/vue": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
@@ -43,13 +49,16 @@
     "vite-plus": "0.2.9"
   },
   "peerDependencies": {
-    "@ubean/seo": "0.2.2"
+    "@ubean/seo": "0.3.0"
   },
   "peerDependenciesMeta": {
     "@ubean/seo": {
       "optional": true
     }
   },
+  "engines": {
+    "node": ">=22"
+  },
   "scripts": {
     "build": "vp pack",
     "dev": "vp pack --watch",