@pactor-app/app 1.41.0 → 1.42.0

package/dist/index.cjs

@@ -27,6 +27,7 @@ __export(index_exports, {
   ReactRouterBinding: () => ReactRouterBinding,
   SitemapApp: () => SitemapApp,
   createHttpHooks: () => createHttpHooks,
+  createLocalStorageLocaleStorage: () => createLocalStorageLocaleStorage,
   createPactorApplication: () => createPactorApplication,
   createPactorPage: () => createPactorPage,
   createRuntimeHttpAdapter: () => createRuntimeHttpAdapter,
@@ -281,8 +282,13 @@ function Application({ app }) {
 }
 function AppShell({
   app,
-  session
+  session: initialSession
 }) {
+  const liveSession = (0, import_react4.useSyncExternalStore)(
+    app.subscribeSession,
+    app.getSession
+  );
+  const session = liveSession ?? initialSession;
   const Router = app.routerOptions.type === "hash" ? import_react_router_dom.HashRouter : import_react_router_dom.BrowserRouter;
   const InteractionKit = app.interactionKit.Provider;
   const Providers = app.providers;
@@ -339,7 +345,7 @@ function ShellLayout({
               pageId,
               route: pageRoute
             },
-            pageLoaderKey(pageId, pageRoute)
+            pageLoaderKey(pageId, pageRoute, session.i18nVersion)
           )
         }
       )
@@ -376,8 +382,8 @@ function ShellLayout({
   }
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LayoutComponent, { brand: session.brand, children: outlet });
 }
-function pageLoaderKey(pageId, route) {
-  return `${pageId}|${JSON.stringify(route.params)}|${JSON.stringify(route.query)}`;
+function pageLoaderKey(pageId, route, i18nVersion) {
+  return `${pageId}|${i18nVersion}|${JSON.stringify(route.params)}|${JSON.stringify(route.query)}`;
 }
 function NotFoundPage() {
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
@@ -488,6 +494,32 @@ function createPactorAssembly(options) {
   };
 }
 
+// src/locale-storage.ts
+function createLocalStorageLocaleStorage(key = "pactor.locale") {
+  return {
+    get() {
+      if (typeof localStorage === "undefined") {
+        return void 0;
+      }
+      try {
+        const value = localStorage.getItem(key);
+        return typeof value === "string" && value !== "" ? value : void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    set(locale) {
+      if (typeof localStorage === "undefined") {
+        return;
+      }
+      try {
+        localStorage.setItem(key, locale);
+      } catch {
+      }
+    }
+  };
+}
+
 // src/application.ts
 var ReactRouterBinding = class {
   constructor() {
@@ -628,6 +660,15 @@ function createPactorApplication(options) {
   const permissionAdapter = (0, import_permission.createPermissionAdapter)(permissionStore);
   const routerAdapter = (0, import_router2.createRouterAdapter)(navigation);
   let session = null;
+  const sessionListeners = /* @__PURE__ */ new Set();
+  let pendingLocale = null;
+  function updateSession(next) {
+    session = next;
+    for (const listener of [...sessionListeners]) {
+      listener();
+    }
+  }
+  const localeStorage = options.localeStorage === false ? void 0 : options.localeStorage ?? createLocalStorageLocaleStorage();
   const handle = {
     appId,
     overlayManager,
@@ -658,10 +699,10 @@ function createPactorApplication(options) {
         logo: void 0
       };
       const browserLocale = typeof navigator !== "undefined" && typeof navigator.language === "string" ? navigator.language : "zh-CN";
-      const locale = options.locale ?? (typeof bootstrap.locale === "string" ? bootstrap.locale : void 0) ?? browserLocale;
+      const locale = options.locale ?? localeStorage?.get() ?? (typeof bootstrap.locale === "string" ? bootstrap.locale : void 0) ?? browserLocale;
       const defaultLocale = options.defaultLocale ?? (typeof bootstrap.defaultLocale === "string" ? bootstrap.defaultLocale : void 0) ?? "zh-CN";
       const messages = options.messages ?? (isRecord(bootstrap.messages) ? bootstrap.messages : void 0) ?? {};
-      const next = {
+      let next = {
         bootstrap,
         menuRegistry,
         layoutType,
@@ -671,11 +712,30 @@ function createPactorApplication(options) {
         app: appRecord,
         locale,
         defaultLocale,
-        messages
+        messages,
+        i18nVersion: 0
       };
-      session = next;
+      if (pendingLocale !== null) {
+        next = {
+          ...next,
+          locale: pendingLocale.locale,
+          messages: pendingLocale.messages ?? next.messages
+        };
+        pendingLocale = null;
+        localeStorage?.set(next.locale);
+      }
+      updateSession(next);
       return next;
     },
+    subscribeSession(listener) {
+      sessionListeners.add(listener);
+      return () => {
+        sessionListeners.delete(listener);
+      };
+    },
+    getSession() {
+      return session;
+    },
     createPageRuntime(pageDsl, route) {
       return (0, import_runtime4.createPageRuntime)(pageDsl, {
         components,
@@ -733,11 +793,20 @@ function createPactorApplication(options) {
     },
     setLocale(locale, messages) {
       if (session === null) {
-        console.warn("[@pactor-app/app] setLocale \u5728 bootstrap \u5B8C\u6210\u524D\u8C03\u7528\u5DF2\u5FFD\u7565");
+        pendingLocale = { locale, messages };
+        return;
+      }
+      const nextMessages = messages ?? session.messages;
+      if (locale === session.locale && nextMessages === session.messages) {
         return;
       }
-      session = { ...session, locale, messages: messages ?? session.messages };
-      window.location.reload();
+      updateSession({
+        ...session,
+        locale,
+        messages: nextMessages,
+        i18nVersion: session.i18nVersion + 1
+      });
+      localeStorage?.set(locale);
     }
   };
 }
@@ -790,7 +859,16 @@ function createPactorPage(options = {}) {
     });
   }
   return function ConfiguredPactorPage(props) {
-    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(EmbeddedPage, { assembly, options, i18n, createRuntime, resolvePage: options.loader ? resolvePage : void 0, ...props });
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_runtime5.I18nContextProvider, { value: i18n, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+      EmbeddedPage,
+      {
+        assembly,
+        options,
+        createRuntime,
+        resolvePage: options.loader ? resolvePage : void 0,
+        ...props
+      }
+    ) });
   };
   async function resolvePage(pageId) {
     if (!options.loader) {
@@ -812,13 +890,13 @@ function PactorPage(props) {
 function EmbeddedPage({
   assembly,
   options,
-  i18n,
   createRuntime,
   resolvePage,
   pageId,
   pageDsl,
   route
 }) {
+  const { t } = (0, import_runtime5.useI18n)();
   const [state, setState] = (0, import_react6.useState)({ status: "loading" });
   const [retryTick, setRetryTick] = (0, import_react6.useState)(0);
   const onError = options.onError;
@@ -879,15 +957,15 @@ function EmbeddedPage({
       ResultView,
       {
         className: "pactor-app-page-load-error",
-        title: "\u9875\u9762\u52A0\u8F7D\u5931\u8D25",
+        title: t("pactor.page.loadFailed"),
         subTitle: state.error.message,
-        extra: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PrimaryButton, { onClick: () => setRetryTick((n) => n + 1), children: "\u91CD\u8BD5" })
+        extra: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PrimaryButton, { onClick: () => setRetryTick((n) => n + 1), children: t("pactor.page.retry") })
       }
     );
   } else {
     content = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PageErrorBoundary, { children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_runtime5.PageRuntimeView, { runtime: state.runtime, children: resolvePage !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(OverlayHost2, { manager: assembly.overlayManager, resolvePage }) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(OverlayHost2, { manager: assembly.overlayManager }) }) });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_runtime5.I18nContextProvider, { value: i18n, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(InteractionProvider2, { bridge: assembly.uiBridge, children: content }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(InteractionProvider2, { bridge: assembly.uiBridge, children: content });
 }
 
 // src/sitemap/actions.ts
@@ -930,7 +1008,9 @@ var defaultSitemapActions = {
 };
 
 // src/sitemap/SitemapApp.tsx
+var import_core4 = require("@pactor-app/core");
 var import_router3 = require("@pactor-app/router");
+var import_runtime6 = require("@pactor-app/runtime");
 var import_components2 = require("@pactor-app/ui/components");
 var import_react8 = require("react");
 
@@ -1259,6 +1339,18 @@ function SitemapMenu({
   );
 }
 function SitemapApp(props) {
+  const i18n = (0, import_react8.useMemo)(
+    () => (0, import_core4.createI18nContext)({
+      locale: props.locale,
+      defaultLocale: props.defaultLocale,
+      messages: props.messages
+    }),
+    [props.locale, props.defaultLocale, props.messages]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_runtime6.I18nContextProvider, { value: i18n, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(SitemapAppInner, { ...props }) });
+}
+function SitemapAppInner(props) {
+  const { t } = (0, import_runtime6.useI18n)();
   const { sources, fetcher, baseUrl } = props;
   const browserRoute = useBrowserRoute();
   const pathname = props.pathname ?? browserRoute.pathname;
@@ -1308,26 +1400,19 @@ function SitemapApp(props) {
     }
   }, [decision, navigate]);
   if (state.status === "loading") {
-    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: props.loading ?? "\u52A0\u8F7D\u4E2D\u2026" });
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: props.loading ?? t("pactor.table.loading") });
   }
   if (state.status === "error") {
-    return props.renderError !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_jsx_runtime6.Fragment, { children: props.renderError(state.error) }) : /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(Centered, { children: [
-      "sitemap \u52A0\u8F7D\u5931\u8D25\uFF1A",
-      state.error.message
-    ] });
+    return props.renderError !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_jsx_runtime6.Fragment, { children: props.renderError(state.error) }) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: t("pactor.sitemap.loadError", { message: state.error.message }) });
   }
   if (sitemap === null || registry === null || resolution === null) {
     return null;
   }
   if (!decision.allow) {
-    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: "\u91CD\u5B9A\u5411\u2026" });
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: t("pactor.sitemap.redirecting") });
   }
   if (resolution.route === null) {
-    return props.renderNotFound !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_jsx_runtime6.Fragment, { children: props.renderNotFound(pathname) }) : /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(Centered, { children: [
-      "\u9875\u9762\u4E0D\u5B58\u5728\uFF08",
-      pathname,
-      "\uFF09"
-    ] });
+    return props.renderNotFound !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_jsx_runtime6.Fragment, { children: props.renderNotFound(pathname) }) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: t("pactor.sitemap.notFound", { path: pathname }) });
   }
   const { pageId, layoutName, highlightKey, params } = resolution.route;
   return (
@@ -1361,6 +1446,7 @@ function SitemapLayout({
   routeParams,
   props
 }) {
+  const { t } = (0, import_runtime6.useI18n)();
   const sessionService = props.sessionService ?? "session.context";
   const session = (0, import_react8.useMemo)(
     () => ({
@@ -1423,11 +1509,61 @@ function SitemapLayout({
     };
   }, [layoutDsl, layoutName, sessionService]);
   if (layoutDsl === void 0 || layoutPage === null) {
-    return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(Centered, { children: [
-      "\u5E03\u5C40\u672A\u5B9A\u4E49\uFF1A",
-      layoutName
-    ] });
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: t("pactor.sitemap.layoutMissing", { name: layoutName }) });
   }
+  const messagesSignature = JSON.stringify(props.messages ?? {});
+  const pageFactory = (0, import_react8.useMemo)(
+    () => createPactorPage({
+      loader,
+      services,
+      actions,
+      navigate,
+      httpAdapter: props.httpAdapter,
+      permissions: sitemap.permissions ?? [],
+      components: props.components,
+      locale: props.locale,
+      defaultLocale: props.defaultLocale,
+      messages: props.messages
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      loader,
+      services,
+      actions,
+      navigate,
+      props.httpAdapter,
+      props.components,
+      sitemap,
+      props.locale,
+      props.defaultLocale,
+      messagesSignature
+    ]
+  );
+  const layoutFactory = (0, import_react8.useMemo)(
+    () => createPactorPage({
+      services,
+      actions,
+      navigate,
+      httpAdapter: props.httpAdapter,
+      components: { PageOutlet, SitemapMenu, ...props.components },
+      locale: props.locale,
+      defaultLocale: props.defaultLocale,
+      messages: props.messages
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      services,
+      actions,
+      navigate,
+      props.httpAdapter,
+      props.components,
+      props.locale,
+      props.defaultLocale,
+      messagesSignature
+    ]
+  );
+  const Page = pageFactory;
+  const LayoutPage = layoutFactory;
   return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
     OutletContext.Provider,
     {
@@ -1435,32 +1571,15 @@ function SitemapLayout({
         // 页面实例：key 随 pageId + pathname 变化（route 参数变化需重建，
         // PactorPage 的 route prop 不参与运行时重建）——布局保持挂载
         /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
-          PactorPage,
+          Page,
           {
             pageId,
-            route: { params: routeParams, query },
-            loader,
-            services,
-            actions,
-            permissions: sitemap.permissions ?? [],
-            navigate,
-            httpAdapter: props.httpAdapter,
-            components: props.components
+            route: { params: routeParams, query }
           },
           `${pageId}@${pathname}`
         )
       ),
-      children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
-        PactorPage,
-        {
-          pageDsl: layoutPage,
-          services,
-          actions,
-          navigate,
-          httpAdapter: props.httpAdapter,
-          components: { PageOutlet, SitemapMenu, ...props.components }
-        }
-      )
+      children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(LayoutPage, { pageDsl: layoutPage })
     }
   );
 }
@@ -1490,6 +1609,7 @@ function Centered({ children }) {
   ReactRouterBinding,
   SitemapApp,
   createHttpHooks,
+  createLocalStorageLocaleStorage,
   createPactorApplication,
   createPactorPage,
   createRuntimeHttpAdapter,

package/dist/index.d.cts

@@ -55,6 +55,26 @@ interface PactorAssemblyOptions {
     navigate: (to: string) => void;
 }
 
+/**
+ * 语言偏好持久化适配器（设计 D4）：
+ * 框架缺省写入 localStorage，接入方可经 options.localeStorage
+ * 关闭（false）或替换为自定义实现（cookie / 服务端同步等）。
+ */
+/** 语言偏好存储适配器：读写当前语言代码 */
+interface LocaleStorage {
+    /** 读取持久化的语言代码（无记录返回 undefined） */
+    get(): string | undefined;
+    /** 写入语言代码（持久化不可用时静默降级，不抛异常） */
+    set(locale: string): void;
+}
+/**
+ * localStorage 实现的 LocaleStorage 工厂（key 缺省 'pactor.locale'，
+ * 可经参数更换）。读写前置 `typeof localStorage !== 'undefined'`
+ * 判断并 try/catch 包裹：SSR / 隐私模式 / 用户禁用存储时静默降级
+ * 为无持久化（行为等同未接入持久化）。
+ */
+declare function createLocalStorageLocaleStorage(key?: string): LocaleStorage;
+
 /** 认证令牌提供者：同步或异步返回 Bearer token（无令牌返回 undefined） */
 type AuthTokenProvider = () => string | undefined | Promise<string | undefined>;
 /** 路由配置（V1 支持 browser + basename；hash 预留） */
@@ -131,12 +151,18 @@ interface PactorApplicationOptions {
     authTokenProvider?: AuthTokenProvider;
     /** HTTP 钩子：加工页面运行时所有 HTTP 出口（request 改配置 / response 改数据） */
     httpAdapter?: PactorHttpHooks;
-    /** 当前语言代码（优先级高于 bootstrap.locale 与浏览器语言） */
+    /** 当前语言代码（优先级高于持久化值、bootstrap.locale 与浏览器语言） */
     locale?: string;
     /** 回退语言代码（缺省 'zh-CN'） */
     defaultLocale?: string;
     /** 翻译消息表（优先级高于 bootstrap.messages） */
     messages?: I18nMessages;
+    /**
+     * 语言偏好持久化适配器（设计 D4）：缺省
+     * `createLocalStorageLocaleStorage('pactor.locale')`；传 `false` 关闭
+     * 框架持久化（由调用方自管）；自定义实现可替换为 cookie / 服务端同步。
+     */
+    localeStorage?: LocaleStorage | false;
 }
 /**
  * bootstrap 会话（设计决策 D1/D2）：启动编排的产物，
@@ -166,6 +192,11 @@ interface PactorAppSession {
     defaultLocale: string;
     /** 翻译消息表 */
     messages: I18nMessages;
+    /**
+     * i18n 版本（设计 D3）：locale 或 messages 任一变化时 +1，
+     * 页面加载器 key 携带该版本以触发页面运行时重建。
+     */
+    i18nVersion: number;
 }
 /** 应用实例（设计决策 D4）：mount/unmount 与扩展注册 API */
 interface PactorApplication {
@@ -182,7 +213,17 @@ interface PactorApplication {
     registerService(name: string, handler: ServiceHandler): void;
     /** 注册业务能力（同名覆盖） */
     registerCapability(name: string, capability: unknown): void;
-    /** 运行时切换语言：更新应用级 i18n 配置并触发页面重建 */
+    /**
+     * 运行时切换语言（低频操作）：无整页刷新地更新应用级 i18n 配置——
+     * 布局与菜单保留，内置组件默认文案与页面表达式按新语言渲染，
+     * 语言偏好经 localeStorage 持久化（options.localeStorage 可关闭/替换）。
+     *
+     * - `messages` 未传时保留现有业务词条：内置文案立即切换，
+     *   业务文案经回退链（defaultLocale）继续展示，异步补齐后再调用一次即可；
+     * - 页面运行时按 i18n 版本重建：页面内 DataStore 快照与未提交表单
+     *   在此次切换中丢失（布局、菜单、路由、会话均保留）；
+     * - bootstrap 完成前调用会被暂存，会话就绪后自动应用。
+     */
     setLocale(locale: string, messages?: I18nMessages): void;
 }
 /**
@@ -211,6 +252,13 @@ interface PactorApplicationHandle {
     readonly navigation: ReactRouterBinding;
     /** 启动编排：加载 bootstrap 并组装会话（失败 reject，由组合层渲染重试页） */
     loadSession(): Promise<PactorAppSession>;
+    /**
+     * 订阅会话变化（设计 D1）：setLocale 更新会话时通知所有监听器
+     * （AppShell 经 useSyncExternalStore 消费）。返回取消订阅函数。
+     */
+    subscribeSession(listener: () => void): () => void;
+    /** 当前会话快照（bootstrap 完成前为 null） */
+    getSession(): PactorAppSession | null;
     /** 页面运行时工厂（设计决策 D2）：注入共享 registries / adapters / route / user / app */
     createPageRuntime(pageDsl: PageDsl, route: RouteContext): PageRuntime;
     /** OverlayHost 的 page overlay 页面加载（loader.loadPage → PageDsl） */
@@ -556,6 +604,15 @@ interface SitemapAppProps {
     guard?: SitemapGuard;
     /** 会话服务名（缺省 session.context） */
     sessionService?: string;
+    /** 当前语言代码（透传页面与布局运行时；缺省 'zh-CN'）。切换即重建页面 */
+    locale?: string;
+    /** 回退语言代码（缺省 'zh-CN'） */
+    defaultLocale?: string;
+    /**
+     * 翻译消息表（透传页面与布局运行时）。按值参与重建判定：
+     * 宿主每次渲染新建等值对象不会触发重建，但内容变化会。
+     */
+    messages?: I18nMessages;
     /** 加载中视图 */
     loading?: ReactNode;
     /** sitemap 加载失败视图 */
@@ -563,7 +620,11 @@ interface SitemapAppProps {
     /** 路由未命中视图 */
     renderNotFound?: (path: string) => ReactNode;
 }
-declare function SitemapApp(props: SitemapAppProps): react.JSX.Element | null;
+/**
+ * SitemapApp 外壳（设计 D7）：按 props 组装 i18n 上下文并经 Provider
+ * 包裹——自身状态文案与页面/布局运行时消费同一语言配置。
+ */
+declare function SitemapApp(props: SitemapAppProps): react.JSX.Element;
 
 /** createHttpHooks 配置 */
 interface CreateHttpHooksOptions {
@@ -625,4 +686,4 @@ interface SitemapSessionContext {
 /** 注册会话桥服务（缺省名 session.context，与 loader 注入的 dataSource 对应） */
 declare function createSitemapSessionServices(session: SitemapSessionContext, serviceName?: string): Record<string, ServiceHandler>;
 
-export { Application, type ApplicationProps, type AuthTokenProvider, type CreateHttpHooksOptions, DslPageLoader, type DslPageLoaderProps, type FetchSitemapOptions, type LayoutDsl, type PactorAppSession, type PactorApplication, type PactorApplicationHandle, type PactorApplicationOptions, type PactorHttpHooks, PactorPage, type PactorPageOptions, type PactorPageProps, type PactorRouterOptions, PageErrorBoundary, ReactRouterBinding, SitemapApp, type SitemapAppProps, type SitemapGuard, type SitemapGuardContext, type SitemapGuardDecision, type SitemapLoaderOptions, type SitemapMenuItem, type SitemapNavItem, type SitemapPageEntry, type SitemapResource, type SitemapRouteMatch, type SitemapRouteResolution, type SitemapSessionContext, createHttpHooks, createPactorApplication, createPactorPage, createRuntimeHttpAdapter, createSitemapLoader, createSitemapSessionServices, defaultSitemapActions, defaultSitemapGuard, fetchSitemap, mergeSitemapMenus, resolveSitemapRoute, toSitemapNavItems, withHttpHooks, wrapHttpAdapter };
+export { Application, type ApplicationProps, type AuthTokenProvider, type CreateHttpHooksOptions, DslPageLoader, type DslPageLoaderProps, type FetchSitemapOptions, type LayoutDsl, type LocaleStorage, type PactorAppSession, type PactorApplication, type PactorApplicationHandle, type PactorApplicationOptions, type PactorHttpHooks, PactorPage, type PactorPageOptions, type PactorPageProps, type PactorRouterOptions, PageErrorBoundary, ReactRouterBinding, SitemapApp, type SitemapAppProps, type SitemapGuard, type SitemapGuardContext, type SitemapGuardDecision, type SitemapLoaderOptions, type SitemapMenuItem, type SitemapNavItem, type SitemapPageEntry, type SitemapResource, type SitemapRouteMatch, type SitemapRouteResolution, type SitemapSessionContext, createHttpHooks, createLocalStorageLocaleStorage, createPactorApplication, createPactorPage, createRuntimeHttpAdapter, createSitemapLoader, createSitemapSessionServices, defaultSitemapActions, defaultSitemapGuard, fetchSitemap, mergeSitemapMenus, resolveSitemapRoute, toSitemapNavItems, withHttpHooks, wrapHttpAdapter };

package/dist/index.d.ts

@@ -55,6 +55,26 @@ interface PactorAssemblyOptions {
     navigate: (to: string) => void;
 }
 
+/**
+ * 语言偏好持久化适配器（设计 D4）：
+ * 框架缺省写入 localStorage，接入方可经 options.localeStorage
+ * 关闭（false）或替换为自定义实现（cookie / 服务端同步等）。
+ */
+/** 语言偏好存储适配器：读写当前语言代码 */
+interface LocaleStorage {
+    /** 读取持久化的语言代码（无记录返回 undefined） */
+    get(): string | undefined;
+    /** 写入语言代码（持久化不可用时静默降级，不抛异常） */
+    set(locale: string): void;
+}
+/**
+ * localStorage 实现的 LocaleStorage 工厂（key 缺省 'pactor.locale'，
+ * 可经参数更换）。读写前置 `typeof localStorage !== 'undefined'`
+ * 判断并 try/catch 包裹：SSR / 隐私模式 / 用户禁用存储时静默降级
+ * 为无持久化（行为等同未接入持久化）。
+ */
+declare function createLocalStorageLocaleStorage(key?: string): LocaleStorage;
+
 /** 认证令牌提供者：同步或异步返回 Bearer token（无令牌返回 undefined） */
 type AuthTokenProvider = () => string | undefined | Promise<string | undefined>;
 /** 路由配置（V1 支持 browser + basename；hash 预留） */
@@ -131,12 +151,18 @@ interface PactorApplicationOptions {
     authTokenProvider?: AuthTokenProvider;
     /** HTTP 钩子：加工页面运行时所有 HTTP 出口（request 改配置 / response 改数据） */
     httpAdapter?: PactorHttpHooks;
-    /** 当前语言代码（优先级高于 bootstrap.locale 与浏览器语言） */
+    /** 当前语言代码（优先级高于持久化值、bootstrap.locale 与浏览器语言） */
     locale?: string;
     /** 回退语言代码（缺省 'zh-CN'） */
     defaultLocale?: string;
     /** 翻译消息表（优先级高于 bootstrap.messages） */
     messages?: I18nMessages;
+    /**
+     * 语言偏好持久化适配器（设计 D4）：缺省
+     * `createLocalStorageLocaleStorage('pactor.locale')`；传 `false` 关闭
+     * 框架持久化（由调用方自管）；自定义实现可替换为 cookie / 服务端同步。
+     */
+    localeStorage?: LocaleStorage | false;
 }
 /**
  * bootstrap 会话（设计决策 D1/D2）：启动编排的产物，
@@ -166,6 +192,11 @@ interface PactorAppSession {
     defaultLocale: string;
     /** 翻译消息表 */
     messages: I18nMessages;
+    /**
+     * i18n 版本（设计 D3）：locale 或 messages 任一变化时 +1，
+     * 页面加载器 key 携带该版本以触发页面运行时重建。
+     */
+    i18nVersion: number;
 }
 /** 应用实例（设计决策 D4）：mount/unmount 与扩展注册 API */
 interface PactorApplication {
@@ -182,7 +213,17 @@ interface PactorApplication {
     registerService(name: string, handler: ServiceHandler): void;
     /** 注册业务能力（同名覆盖） */
     registerCapability(name: string, capability: unknown): void;
-    /** 运行时切换语言：更新应用级 i18n 配置并触发页面重建 */
+    /**
+     * 运行时切换语言（低频操作）：无整页刷新地更新应用级 i18n 配置——
+     * 布局与菜单保留，内置组件默认文案与页面表达式按新语言渲染，
+     * 语言偏好经 localeStorage 持久化（options.localeStorage 可关闭/替换）。
+     *
+     * - `messages` 未传时保留现有业务词条：内置文案立即切换，
+     *   业务文案经回退链（defaultLocale）继续展示，异步补齐后再调用一次即可；
+     * - 页面运行时按 i18n 版本重建：页面内 DataStore 快照与未提交表单
+     *   在此次切换中丢失（布局、菜单、路由、会话均保留）；
+     * - bootstrap 完成前调用会被暂存，会话就绪后自动应用。
+     */
     setLocale(locale: string, messages?: I18nMessages): void;
 }
 /**
@@ -211,6 +252,13 @@ interface PactorApplicationHandle {
     readonly navigation: ReactRouterBinding;
     /** 启动编排：加载 bootstrap 并组装会话（失败 reject，由组合层渲染重试页） */
     loadSession(): Promise<PactorAppSession>;
+    /**
+     * 订阅会话变化（设计 D1）：setLocale 更新会话时通知所有监听器
+     * （AppShell 经 useSyncExternalStore 消费）。返回取消订阅函数。
+     */
+    subscribeSession(listener: () => void): () => void;
+    /** 当前会话快照（bootstrap 完成前为 null） */
+    getSession(): PactorAppSession | null;
     /** 页面运行时工厂（设计决策 D2）：注入共享 registries / adapters / route / user / app */
     createPageRuntime(pageDsl: PageDsl, route: RouteContext): PageRuntime;
     /** OverlayHost 的 page overlay 页面加载（loader.loadPage → PageDsl） */
@@ -556,6 +604,15 @@ interface SitemapAppProps {
     guard?: SitemapGuard;
     /** 会话服务名（缺省 session.context） */
     sessionService?: string;
+    /** 当前语言代码（透传页面与布局运行时；缺省 'zh-CN'）。切换即重建页面 */
+    locale?: string;
+    /** 回退语言代码（缺省 'zh-CN'） */
+    defaultLocale?: string;
+    /**
+     * 翻译消息表（透传页面与布局运行时）。按值参与重建判定：
+     * 宿主每次渲染新建等值对象不会触发重建，但内容变化会。
+     */
+    messages?: I18nMessages;
     /** 加载中视图 */
     loading?: ReactNode;
     /** sitemap 加载失败视图 */
@@ -563,7 +620,11 @@ interface SitemapAppProps {
     /** 路由未命中视图 */
     renderNotFound?: (path: string) => ReactNode;
 }
-declare function SitemapApp(props: SitemapAppProps): react.JSX.Element | null;
+/**
+ * SitemapApp 外壳（设计 D7）：按 props 组装 i18n 上下文并经 Provider
+ * 包裹——自身状态文案与页面/布局运行时消费同一语言配置。
+ */
+declare function SitemapApp(props: SitemapAppProps): react.JSX.Element;
 
 /** createHttpHooks 配置 */
 interface CreateHttpHooksOptions {
@@ -625,4 +686,4 @@ interface SitemapSessionContext {
 /** 注册会话桥服务（缺省名 session.context，与 loader 注入的 dataSource 对应） */
 declare function createSitemapSessionServices(session: SitemapSessionContext, serviceName?: string): Record<string, ServiceHandler>;
 
-export { Application, type ApplicationProps, type AuthTokenProvider, type CreateHttpHooksOptions, DslPageLoader, type DslPageLoaderProps, type FetchSitemapOptions, type LayoutDsl, type PactorAppSession, type PactorApplication, type PactorApplicationHandle, type PactorApplicationOptions, type PactorHttpHooks, PactorPage, type PactorPageOptions, type PactorPageProps, type PactorRouterOptions, PageErrorBoundary, ReactRouterBinding, SitemapApp, type SitemapAppProps, type SitemapGuard, type SitemapGuardContext, type SitemapGuardDecision, type SitemapLoaderOptions, type SitemapMenuItem, type SitemapNavItem, type SitemapPageEntry, type SitemapResource, type SitemapRouteMatch, type SitemapRouteResolution, type SitemapSessionContext, createHttpHooks, createPactorApplication, createPactorPage, createRuntimeHttpAdapter, createSitemapLoader, createSitemapSessionServices, defaultSitemapActions, defaultSitemapGuard, fetchSitemap, mergeSitemapMenus, resolveSitemapRoute, toSitemapNavItems, withHttpHooks, wrapHttpAdapter };
+export { Application, type ApplicationProps, type AuthTokenProvider, type CreateHttpHooksOptions, DslPageLoader, type DslPageLoaderProps, type FetchSitemapOptions, type LayoutDsl, type LocaleStorage, type PactorAppSession, type PactorApplication, type PactorApplicationHandle, type PactorApplicationOptions, type PactorHttpHooks, PactorPage, type PactorPageOptions, type PactorPageProps, type PactorRouterOptions, PageErrorBoundary, ReactRouterBinding, SitemapApp, type SitemapAppProps, type SitemapGuard, type SitemapGuardContext, type SitemapGuardDecision, type SitemapLoaderOptions, type SitemapMenuItem, type SitemapNavItem, type SitemapPageEntry, type SitemapResource, type SitemapRouteMatch, type SitemapRouteResolution, type SitemapSessionContext, createHttpHooks, createLocalStorageLocaleStorage, createPactorApplication, createPactorPage, createRuntimeHttpAdapter, createSitemapLoader, createSitemapSessionServices, defaultSitemapActions, defaultSitemapGuard, fetchSitemap, mergeSitemapMenus, resolveSitemapRoute, toSitemapNavItems, withHttpHooks, wrapHttpAdapter };

package/dist/index.js

@@ -23,7 +23,11 @@ import { resolveLayout } from "@pactor-app/ui/layout";
 import { resolveRoute } from "@pactor-app/router";
 import { DynamicDslRoute, useReactRouterBridge } from "@pactor-app/router/react";
 import { I18nContextProvider } from "@pactor-app/runtime";
-import { useEffect as useEffect2, useState as useState2 } from "react";
+import {
+  useEffect as useEffect2,
+  useState as useState2,
+  useSyncExternalStore
+} from "react";
 import {
   BrowserRouter,
   HashRouter,
@@ -252,8 +256,13 @@ function Application({ app }) {
 }
 function AppShell({
   app,
-  session
+  session: initialSession
 }) {
+  const liveSession = useSyncExternalStore(
+    app.subscribeSession,
+    app.getSession
+  );
+  const session = liveSession ?? initialSession;
   const Router = app.routerOptions.type === "hash" ? HashRouter : BrowserRouter;
   const InteractionKit = app.interactionKit.Provider;
   const Providers = app.providers;
@@ -310,7 +319,7 @@ function ShellLayout({
               pageId,
               route: pageRoute
             },
-            pageLoaderKey(pageId, pageRoute)
+            pageLoaderKey(pageId, pageRoute, session.i18nVersion)
           )
         }
       )
@@ -347,8 +356,8 @@ function ShellLayout({
   }
   return /* @__PURE__ */ jsx4(LayoutComponent, { brand: session.brand, children: outlet });
 }
-function pageLoaderKey(pageId, route) {
-  return `${pageId}|${JSON.stringify(route.params)}|${JSON.stringify(route.query)}`;
+function pageLoaderKey(pageId, route, i18nVersion) {
+  return `${pageId}|${i18nVersion}|${JSON.stringify(route.params)}|${JSON.stringify(route.query)}`;
 }
 function NotFoundPage() {
   return /* @__PURE__ */ jsx4(
@@ -467,6 +476,32 @@ function createPactorAssembly(options) {
   };
 }
 
+// src/locale-storage.ts
+function createLocalStorageLocaleStorage(key = "pactor.locale") {
+  return {
+    get() {
+      if (typeof localStorage === "undefined") {
+        return void 0;
+      }
+      try {
+        const value = localStorage.getItem(key);
+        return typeof value === "string" && value !== "" ? value : void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    set(locale) {
+      if (typeof localStorage === "undefined") {
+        return;
+      }
+      try {
+        localStorage.setItem(key, locale);
+      } catch {
+      }
+    }
+  };
+}
+
 // src/application.ts
 var ReactRouterBinding = class {
   constructor() {
@@ -607,6 +642,15 @@ function createPactorApplication(options) {
   const permissionAdapter = createPermissionAdapter(permissionStore);
   const routerAdapter = createRouterAdapter(navigation);
   let session = null;
+  const sessionListeners = /* @__PURE__ */ new Set();
+  let pendingLocale = null;
+  function updateSession(next) {
+    session = next;
+    for (const listener of [...sessionListeners]) {
+      listener();
+    }
+  }
+  const localeStorage = options.localeStorage === false ? void 0 : options.localeStorage ?? createLocalStorageLocaleStorage();
   const handle = {
     appId,
     overlayManager,
@@ -637,10 +681,10 @@ function createPactorApplication(options) {
         logo: void 0
       };
       const browserLocale = typeof navigator !== "undefined" && typeof navigator.language === "string" ? navigator.language : "zh-CN";
-      const locale = options.locale ?? (typeof bootstrap.locale === "string" ? bootstrap.locale : void 0) ?? browserLocale;
+      const locale = options.locale ?? localeStorage?.get() ?? (typeof bootstrap.locale === "string" ? bootstrap.locale : void 0) ?? browserLocale;
       const defaultLocale = options.defaultLocale ?? (typeof bootstrap.defaultLocale === "string" ? bootstrap.defaultLocale : void 0) ?? "zh-CN";
       const messages = options.messages ?? (isRecord(bootstrap.messages) ? bootstrap.messages : void 0) ?? {};
-      const next = {
+      let next = {
         bootstrap,
         menuRegistry,
         layoutType,
@@ -650,11 +694,30 @@ function createPactorApplication(options) {
         app: appRecord,
         locale,
         defaultLocale,
-        messages
+        messages,
+        i18nVersion: 0
       };
-      session = next;
+      if (pendingLocale !== null) {
+        next = {
+          ...next,
+          locale: pendingLocale.locale,
+          messages: pendingLocale.messages ?? next.messages
+        };
+        pendingLocale = null;
+        localeStorage?.set(next.locale);
+      }
+      updateSession(next);
       return next;
     },
+    subscribeSession(listener) {
+      sessionListeners.add(listener);
+      return () => {
+        sessionListeners.delete(listener);
+      };
+    },
+    getSession() {
+      return session;
+    },
     createPageRuntime(pageDsl, route) {
       return createPageRuntime(pageDsl, {
         components,
@@ -712,11 +775,20 @@ function createPactorApplication(options) {
     },
     setLocale(locale, messages) {
       if (session === null) {
-        console.warn("[@pactor-app/app] setLocale \u5728 bootstrap \u5B8C\u6210\u524D\u8C03\u7528\u5DF2\u5FFD\u7565");
+        pendingLocale = { locale, messages };
+        return;
+      }
+      const nextMessages = messages ?? session.messages;
+      if (locale === session.locale && nextMessages === session.messages) {
         return;
       }
-      session = { ...session, locale, messages: messages ?? session.messages };
-      window.location.reload();
+      updateSession({
+        ...session,
+        locale,
+        messages: nextMessages,
+        i18nVersion: session.i18nVersion + 1
+      });
+      localeStorage?.set(locale);
     }
   };
 }
@@ -729,7 +801,8 @@ import {
   createPageRuntime as createPageRuntime2,
   DslSourceResolver,
   I18nContextProvider as I18nContextProvider2,
-  PageRuntimeView as PageRuntimeView2
+  PageRuntimeView as PageRuntimeView2,
+  useI18n
 } from "@pactor-app/runtime";
 import {
   useEffect as useEffect3,
@@ -779,7 +852,16 @@ function createPactorPage(options = {}) {
     });
   }
   return function ConfiguredPactorPage(props) {
-    return /* @__PURE__ */ jsx5(EmbeddedPage, { assembly, options, i18n, createRuntime, resolvePage: options.loader ? resolvePage : void 0, ...props });
+    return /* @__PURE__ */ jsx5(I18nContextProvider2, { value: i18n, children: /* @__PURE__ */ jsx5(
+      EmbeddedPage,
+      {
+        assembly,
+        options,
+        createRuntime,
+        resolvePage: options.loader ? resolvePage : void 0,
+        ...props
+      }
+    ) });
   };
   async function resolvePage(pageId) {
     if (!options.loader) {
@@ -801,13 +883,13 @@ function PactorPage(props) {
 function EmbeddedPage({
   assembly,
   options,
-  i18n,
   createRuntime,
   resolvePage,
   pageId,
   pageDsl,
   route
 }) {
+  const { t } = useI18n();
   const [state, setState] = useState3({ status: "loading" });
   const [retryTick, setRetryTick] = useState3(0);
   const onError = options.onError;
@@ -868,15 +950,15 @@ function EmbeddedPage({
       ResultView,
       {
         className: "pactor-app-page-load-error",
-        title: "\u9875\u9762\u52A0\u8F7D\u5931\u8D25",
+        title: t("pactor.page.loadFailed"),
         subTitle: state.error.message,
-        extra: /* @__PURE__ */ jsx5(PrimaryButton, { onClick: () => setRetryTick((n) => n + 1), children: "\u91CD\u8BD5" })
+        extra: /* @__PURE__ */ jsx5(PrimaryButton, { onClick: () => setRetryTick((n) => n + 1), children: t("pactor.page.retry") })
       }
     );
   } else {
     content = /* @__PURE__ */ jsx5(PageErrorBoundary, { children: /* @__PURE__ */ jsx5(PageRuntimeView2, { runtime: state.runtime, children: resolvePage !== void 0 ? /* @__PURE__ */ jsx5(OverlayHost2, { manager: assembly.overlayManager, resolvePage }) : /* @__PURE__ */ jsx5(OverlayHost2, { manager: assembly.overlayManager }) }) });
   }
-  return /* @__PURE__ */ jsx5(I18nContextProvider2, { value: i18n, children: /* @__PURE__ */ jsx5(InteractionProvider2, { bridge: assembly.uiBridge, children: content }) });
+  return /* @__PURE__ */ jsx5(InteractionProvider2, { bridge: assembly.uiBridge, children: content });
 }
 
 // src/sitemap/actions.ts
@@ -919,7 +1001,12 @@ var defaultSitemapActions = {
 };
 
 // src/sitemap/SitemapApp.tsx
+import { createI18nContext as createI18nContext3 } from "@pactor-app/core";
 import { MenuRegistry as MenuRegistry2 } from "@pactor-app/router";
+import {
+  I18nContextProvider as I18nContextProvider3,
+  useI18n as useI18n2
+} from "@pactor-app/runtime";
 import { Menu } from "@pactor-app/ui/components";
 import {
   createContext,
@@ -930,7 +1017,7 @@ import {
 } from "react";
 
 // src/sitemap/browser-route.ts
-import { useCallback, useMemo, useSyncExternalStore } from "react";
+import { useCallback, useMemo, useSyncExternalStore as useSyncExternalStore2 } from "react";
 var NAV_EVENT = "pactor:sitemap-navigate";
 function readLocation() {
   return `${window.location.pathname}${window.location.search}`;
@@ -944,7 +1031,7 @@ function subscribe(callback) {
   };
 }
 function useBrowserRoute() {
-  const location = useSyncExternalStore(
+  const location = useSyncExternalStore2(
     subscribe,
     readLocation,
     // SSR 快照：服务端无 window，宿主应注入 pathname / navigate
@@ -1231,7 +1318,7 @@ function createSitemapSessionServices(session, serviceName = "session.context")
 }
 
 // src/sitemap/SitemapApp.tsx
-import { Fragment, jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx6 } from "react/jsx-runtime";
 var OutletContext = createContext(null);
 function PageOutlet() {
   return use(OutletContext);
@@ -1254,6 +1341,18 @@ function SitemapMenu({
   );
 }
 function SitemapApp(props) {
+  const i18n = useMemo2(
+    () => createI18nContext3({
+      locale: props.locale,
+      defaultLocale: props.defaultLocale,
+      messages: props.messages
+    }),
+    [props.locale, props.defaultLocale, props.messages]
+  );
+  return /* @__PURE__ */ jsx6(I18nContextProvider3, { value: i18n, children: /* @__PURE__ */ jsx6(SitemapAppInner, { ...props }) });
+}
+function SitemapAppInner(props) {
+  const { t } = useI18n2();
   const { sources, fetcher, baseUrl } = props;
   const browserRoute = useBrowserRoute();
   const pathname = props.pathname ?? browserRoute.pathname;
@@ -1303,26 +1402,19 @@ function SitemapApp(props) {
     }
   }, [decision, navigate]);
   if (state.status === "loading") {
-    return /* @__PURE__ */ jsx6(Centered, { children: props.loading ?? "\u52A0\u8F7D\u4E2D\u2026" });
+    return /* @__PURE__ */ jsx6(Centered, { children: props.loading ?? t("pactor.table.loading") });
   }
   if (state.status === "error") {
-    return props.renderError !== void 0 ? /* @__PURE__ */ jsx6(Fragment, { children: props.renderError(state.error) }) : /* @__PURE__ */ jsxs3(Centered, { children: [
-      "sitemap \u52A0\u8F7D\u5931\u8D25\uFF1A",
-      state.error.message
-    ] });
+    return props.renderError !== void 0 ? /* @__PURE__ */ jsx6(Fragment, { children: props.renderError(state.error) }) : /* @__PURE__ */ jsx6(Centered, { children: t("pactor.sitemap.loadError", { message: state.error.message }) });
   }
   if (sitemap === null || registry === null || resolution === null) {
     return null;
   }
   if (!decision.allow) {
-    return /* @__PURE__ */ jsx6(Centered, { children: "\u91CD\u5B9A\u5411\u2026" });
+    return /* @__PURE__ */ jsx6(Centered, { children: t("pactor.sitemap.redirecting") });
   }
   if (resolution.route === null) {
-    return props.renderNotFound !== void 0 ? /* @__PURE__ */ jsx6(Fragment, { children: props.renderNotFound(pathname) }) : /* @__PURE__ */ jsxs3(Centered, { children: [
-      "\u9875\u9762\u4E0D\u5B58\u5728\uFF08",
-      pathname,
-      "\uFF09"
-    ] });
+    return props.renderNotFound !== void 0 ? /* @__PURE__ */ jsx6(Fragment, { children: props.renderNotFound(pathname) }) : /* @__PURE__ */ jsx6(Centered, { children: t("pactor.sitemap.notFound", { path: pathname }) });
   }
   const { pageId, layoutName, highlightKey, params } = resolution.route;
   return (
@@ -1356,6 +1448,7 @@ function SitemapLayout({
   routeParams,
   props
 }) {
+  const { t } = useI18n2();
   const sessionService = props.sessionService ?? "session.context";
   const session = useMemo2(
     () => ({
@@ -1418,11 +1511,61 @@ function SitemapLayout({
     };
   }, [layoutDsl, layoutName, sessionService]);
   if (layoutDsl === void 0 || layoutPage === null) {
-    return /* @__PURE__ */ jsxs3(Centered, { children: [
-      "\u5E03\u5C40\u672A\u5B9A\u4E49\uFF1A",
-      layoutName
-    ] });
+    return /* @__PURE__ */ jsx6(Centered, { children: t("pactor.sitemap.layoutMissing", { name: layoutName }) });
   }
+  const messagesSignature = JSON.stringify(props.messages ?? {});
+  const pageFactory = useMemo2(
+    () => createPactorPage({
+      loader,
+      services,
+      actions,
+      navigate,
+      httpAdapter: props.httpAdapter,
+      permissions: sitemap.permissions ?? [],
+      components: props.components,
+      locale: props.locale,
+      defaultLocale: props.defaultLocale,
+      messages: props.messages
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      loader,
+      services,
+      actions,
+      navigate,
+      props.httpAdapter,
+      props.components,
+      sitemap,
+      props.locale,
+      props.defaultLocale,
+      messagesSignature
+    ]
+  );
+  const layoutFactory = useMemo2(
+    () => createPactorPage({
+      services,
+      actions,
+      navigate,
+      httpAdapter: props.httpAdapter,
+      components: { PageOutlet, SitemapMenu, ...props.components },
+      locale: props.locale,
+      defaultLocale: props.defaultLocale,
+      messages: props.messages
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      services,
+      actions,
+      navigate,
+      props.httpAdapter,
+      props.components,
+      props.locale,
+      props.defaultLocale,
+      messagesSignature
+    ]
+  );
+  const Page = pageFactory;
+  const LayoutPage = layoutFactory;
   return /* @__PURE__ */ jsx6(
     OutletContext.Provider,
     {
@@ -1430,32 +1573,15 @@ function SitemapLayout({
         // 页面实例：key 随 pageId + pathname 变化（route 参数变化需重建，
         // PactorPage 的 route prop 不参与运行时重建）——布局保持挂载
         /* @__PURE__ */ jsx6(
-          PactorPage,
+          Page,
           {
             pageId,
-            route: { params: routeParams, query },
-            loader,
-            services,
-            actions,
-            permissions: sitemap.permissions ?? [],
-            navigate,
-            httpAdapter: props.httpAdapter,
-            components: props.components
+            route: { params: routeParams, query }
           },
           `${pageId}@${pathname}`
         )
       ),
-      children: /* @__PURE__ */ jsx6(
-        PactorPage,
-        {
-          pageDsl: layoutPage,
-          services,
-          actions,
-          navigate,
-          httpAdapter: props.httpAdapter,
-          components: { PageOutlet, SitemapMenu, ...props.components }
-        }
-      )
+      children: /* @__PURE__ */ jsx6(LayoutPage, { pageDsl: layoutPage })
     }
   );
 }
@@ -1484,6 +1610,7 @@ export {
   ReactRouterBinding,
   SitemapApp,
   createHttpHooks,
+  createLocalStorageLocaleStorage,
   createPactorApplication,
   createPactorPage,
   createRuntimeHttpAdapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/app",
-  "version": "1.41.0",
+  "version": "1.42.0",
   "description": "Pactor application: one-stop composition layer (createPactorApplication) wiring loader, bootstrap, registries, router, layout, interaction and page runtimes",
   "keywords": [
     "pactor",
@@ -46,14 +46,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@pactor-app/core": "1.41.0",
-    "@pactor-app/expression": "1.41.0",
-    "@pactor-app/resource": "1.41.0",
-    "@pactor-app/permission": "1.41.0",
-    "@pactor-app/runtime": "1.41.0",
-    "@pactor-app/schema": "1.41.0",
-    "@pactor-app/router": "1.41.0",
-    "@pactor-app/ui": "1.41.0"
+    "@pactor-app/expression": "1.42.0",
+    "@pactor-app/permission": "1.42.0",
+    "@pactor-app/router": "1.42.0",
+    "@pactor-app/runtime": "1.42.0",
+    "@pactor-app/schema": "1.42.0",
+    "@pactor-app/ui": "1.42.0",
+    "@pactor-app/core": "1.42.0",
+    "@pactor-app/resource": "1.42.0"
   },
   "peerDependencies": {
     "react": ">=18",