@pactor-app/app 1.18.0 → 1.20.0

package/README.md

@@ -98,6 +98,49 @@ const Page = createPactorPage({ navigate: (to) => navigate(to) });
 需要完全自定义链接渲染（prefetch、scroll restoration 等）时，可经 `components` 注册表覆盖同名组件，样式子组件从 `@pactor-app/ui/ui` 导入（`BreadcrumbLink` 支持 `render` prop 换成宿主路由组件）。
 - `route.params` / `route.query` 经 props 纯数据注入（如 Next.js 的 `searchParams`）
 
+## Sitemap 动态页面（SitemapApp）
+
+`design/dynamic-page.md` 的框架实现：一个 sitemap 对象（页面 url / 名称 / 结构 / DSL / DSL 布局）驱动整个应用。两种路由模式：**纯前端 SPA** 不传路由 props（内置浏览器路由：History API 导航 + popstate 前进后退）；**宿主路由**（Next.js App Router、react-router 等）注入 `pathname` / `navigate`：
+
+```tsx
+import { SitemapApp } from '@pactor-app/app';
+
+// 纯前端 SPA：只配 sitemap 源即可
+<SitemapApp
+  sources={['/api/sitemap']}
+  services={{ 'auth.login': login }}
+/>
+
+// Next.js（App Router）：挂在 layout.tsx（跨导航常驻，切换导航只刷新内容区）
+<SitemapApp
+  sources={['/api/sitemap']}        // sitemap 接口 URL（可多源合并）
+  baseUrl="https://api.example.com" // 可选：sources / pageEndpoint 相对路径基准
+  pathname={usePathname()}
+  navigate={(to) => router.push(to)}
+  services={{ 'auth.login': login }} // 业务服务（session.context 自动注册）
+  httpAdapter={httpHooks}            // 可选：跨域改写 / 响应拆包
+/>
+```
+
+内置能力（无需自行拼装）：多源拉取合并（冲突后源覆盖前源）、`menus × pages` 继承（`path` / `title` 缺省自引用页面）、MenuRegistry 路由解析（含 `:param`）、访问守卫（缺省匿名守卫：非 `public` 且无 user → `navigate(auth.loginPath)`，`guard` prop 可替换为角色鉴权等策略）、DSL 布局渲染（`PageOutlet` 页面出口、`SitemapMenu` 选中态与 `activeMenu` 高亮）、页面内联 / 懒加载（`id@version` 缓存，`pageEndpoint` 可配）、`session.context` 服务桥（DSL 经 `${data.session.*}` 读 user / app / menus）、缺省动作（`app.reload` 整页重载、`service.call` 服务调用，宿主 `actions` 同名覆盖）、布局常驻（同布局名切换导航仅内容区重建）。布局名解析链：`menu.layout` → 顶层 `layout` → `layouts` 首键。
+
+| Props | 说明 |
+| --- | --- |
+| `sources`（必填） | sitemap 接口 URL 列表（相对路径以 `baseUrl` 补全） |
+| `baseUrl` | 接口基准地址：`sources` / `pageEndpoint` 只写相对路径时以此为基准补全 |
+| `pathname` / `navigate` | 宿主路由注入；缺省用内置浏览器路由（纯前端 SPA 零配置）；http(s) 外链自动新标签打开 |
+| `query` | 当前 query（`${route.query.x}` 可读）；缺省自 `location.search` 解析 |
+| `pageEndpoint` | 懒加载页面端点（缺省 `/api/pages/{id}`） |
+| `services` / `components` | 业务扩展（`components` 中 `PageOutlet` / `SitemapMenu` 为布局保留名） |
+| `actions` | 业务动作；内置 `app.reload` / `service.call` 默认值，同名覆盖 |
+| `guard` | 访问守卫（缺省 `defaultSitemapGuard`：匿名访问非 `public` 页 → 重定向 `auth.loginPath`） |
+| `httpAdapter` | `PactorHttpHooks`：所有 HTTP 出口（sitemap 源 / 页面端点 / 页面运行时）的 request / response 统一加工；`createHttpHooks()` 为默认实现（`{ code, data, message }` 拆包；可选 `proxyPrefix` 代理改写 / `headers` 公共头） |
+| `fetcher` | fetch 实现注入（SSR / 测试） |
+| `sessionService` | 会话桥服务名（缺省 `session.context`） |
+| `loading` / `renderError` / `renderNotFound` | 状态视图定制 |
+
+配套导出（高级用法）：`fetchSitemap`、`createSitemapLoader`、`mergeSitemapMenus`、`toSitemapNavItems`、`resolveSitemapRoute`、`defaultSitemapGuard`、`defaultSitemapActions`、`createHttpHooks`、`withHttpHooks`、`createSitemapSessionServices` 与类型 `SitemapResource` / `SitemapMenuItem` / `SitemapPageEntry` / `LayoutDsl` / `SitemapRouteMatch` / `SitemapRouteResolution` / `SitemapGuard` / `SitemapSessionContext`。完整示例工程见 `starters/next-app-starter`（宿主路由模式）与 `starters/spa-starter`（纯前端内置路由模式）。
+
 ## 文档
 
 完整文档见 <https://github.com/426-330/pactor/tree/main/docs>（`pnpm docs:dev` 本地启动文档站）。

package/dist/index.cjs

@@ -25,9 +25,20 @@ __export(index_exports, {
   PactorPage: () => PactorPage,
   PageErrorBoundary: () => PageErrorBoundary,
   ReactRouterBinding: () => ReactRouterBinding,
+  SitemapApp: () => SitemapApp,
+  createHttpHooks: () => createHttpHooks,
   createPactorApplication: () => createPactorApplication,
   createPactorPage: () => createPactorPage,
   createRuntimeHttpAdapter: () => createRuntimeHttpAdapter,
+  createSitemapLoader: () => createSitemapLoader,
+  createSitemapSessionServices: () => createSitemapSessionServices,
+  defaultSitemapActions: () => defaultSitemapActions,
+  defaultSitemapGuard: () => defaultSitemapGuard,
+  fetchSitemap: () => fetchSitemap,
+  mergeSitemapMenus: () => mergeSitemapMenus,
+  resolveSitemapRoute: () => resolveSitemapRoute,
+  toSitemapNavItems: () => toSitemapNavItems,
+  withHttpHooks: () => withHttpHooks,
   wrapHttpAdapter: () => wrapHttpAdapter
 });
 module.exports = __toCommonJS(index_exports);
@@ -878,6 +889,598 @@ function EmbeddedPage({
   }
   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 }) });
 }
+
+// src/sitemap/actions.ts
+var defaultSitemapActions = {
+  "app.reload": (action) => {
+    const to = action.params?.["to"];
+    if (typeof window !== "undefined") {
+      window.location.assign(typeof to === "string" && to !== "" ? to : "/");
+    }
+    return { ok: true };
+  },
+  "service.call": async (action, ctx) => {
+    const name = action.params?.["service"];
+    if (typeof name !== "string" || name === "") {
+      return {
+        ok: false,
+        error: new Error("[@pactor-app/app] service.call \u7F3A\u5C11 params.service")
+      };
+    }
+    const handler = ctx.context.services.get(name);
+    if (!handler) {
+      return {
+        ok: false,
+        error: new Error(`[@pactor-app/app] service \u672A\u6CE8\u518C: ${name}`)
+      };
+    }
+    try {
+      const callParams = action.params?.["params"];
+      const data = await handler(
+        typeof callParams === "object" && callParams !== null ? callParams : {}
+      );
+      return { ok: true, data };
+    } catch (cause) {
+      return {
+        ok: false,
+        error: cause instanceof Error ? cause : new Error(String(cause))
+      };
+    }
+  }
+};
+
+// src/sitemap/SitemapApp.tsx
+var import_router3 = require("@pactor-app/router");
+var import_components2 = require("@pactor-app/ui/components");
+var import_react8 = require("react");
+
+// src/sitemap/browser-route.ts
+var import_react7 = require("react");
+var NAV_EVENT = "pactor:sitemap-navigate";
+function readLocation() {
+  return `${window.location.pathname}${window.location.search}`;
+}
+function subscribe(callback) {
+  window.addEventListener("popstate", callback);
+  window.addEventListener(NAV_EVENT, callback);
+  return () => {
+    window.removeEventListener("popstate", callback);
+    window.removeEventListener(NAV_EVENT, callback);
+  };
+}
+function useBrowserRoute() {
+  const location = (0, import_react7.useSyncExternalStore)(
+    subscribe,
+    readLocation,
+    // SSR 快照：服务端无 window，宿主应注入 pathname / navigate
+    () => "/"
+  );
+  const navigate = (0, import_react7.useCallback)((to) => {
+    window.history.pushState(null, "", to);
+    window.dispatchEvent(new Event(NAV_EVENT));
+  }, []);
+  return (0, import_react7.useMemo)(() => {
+    const qIndex = location.indexOf("?");
+    return {
+      pathname: qIndex >= 0 ? location.slice(0, qIndex) : location,
+      query: Object.fromEntries(
+        new URLSearchParams(qIndex >= 0 ? location.slice(qIndex + 1) : "")
+      ),
+      navigate
+    };
+  }, [location, navigate]);
+}
+
+// src/sitemap/http.ts
+function createHttpHooks(options = {}) {
+  const { proxyPrefix } = options;
+  const envelope = options.envelope ?? true;
+  return {
+    request(config) {
+      let url = config.url;
+      if (proxyPrefix !== void 0 && /^https?:\/\//.test(url) && typeof window !== "undefined" && !url.startsWith(window.location.origin)) {
+        const target = new URL(url);
+        url = `${proxyPrefix}${target.pathname}${target.search}`;
+      }
+      const extra = typeof options.headers === "function" ? options.headers() : options.headers;
+      return {
+        ...config,
+        url,
+        headers: { ...config.headers, ...extra }
+      };
+    },
+    response(data) {
+      if (!envelope) {
+        return data;
+      }
+      if (typeof data === "object" && data !== null && "code" in data && "data" in data) {
+        const wrapped = data;
+        if (wrapped.code !== 0) {
+          throw new Error(wrapped.message ?? `\u4E1A\u52A1\u9519\u8BEF\u7801 ${wrapped.code}`);
+        }
+        return wrapped.data;
+      }
+      return data;
+    }
+  };
+}
+function withHttpHooks(fetcher, hooks) {
+  if (hooks === void 0) {
+    return fetcher;
+  }
+  return (async (input, init) => {
+    let url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    let requestInit = init;
+    if (hooks.request !== void 0) {
+      const config = await hooks.request({
+        method: init?.method ?? "GET",
+        url,
+        headers: headersToRecord(init?.headers),
+        body: init?.body ?? void 0
+      });
+      url = config.url;
+      requestInit = {
+        ...init,
+        method: config.method ?? init?.method ?? "GET",
+        headers: config.headers,
+        body: config.body === void 0 ? init?.body ?? null : config.body
+      };
+    }
+    const res = await fetcher(url, requestInit);
+    if (hooks.response === void 0 || !res.ok) {
+      return res;
+    }
+    const data = await hooks.response(await res.json());
+    return new Response(JSON.stringify(data), {
+      status: res.status,
+      statusText: res.statusText,
+      headers: res.headers
+    });
+  });
+}
+function headersToRecord(headers) {
+  if (headers === void 0) {
+    return void 0;
+  }
+  if (headers instanceof Headers) {
+    return Object.fromEntries(headers.entries());
+  }
+  if (Array.isArray(headers)) {
+    return Object.fromEntries(headers);
+  }
+  return { ...headers };
+}
+
+// src/sitemap/url.ts
+function resolveUrl(url, baseUrl) {
+  if (baseUrl === void 0 || baseUrl === "" || /^(https?:)?\/\//i.test(url)) {
+    return url;
+  }
+  return `${baseUrl.replace(/\/+$/, "")}/${url.replace(/^\/+/, "")}`;
+}
+
+// src/sitemap/fetch.ts
+async function fetchSitemap(sources, options = {}) {
+  const fetcher = withHttpHooks(options.fetcher ?? fetch, options.httpHooks);
+  const responses = await Promise.all(
+    sources.map(async (url) => {
+      const res = await fetcher(resolveUrl(url, options.baseUrl), {
+        cache: "no-store",
+        // 跨源 cookie 会话（服务端开通 CORS + Allow-Credentials 时生效；
+        // 同源行为不变）
+        credentials: "include"
+      });
+      if (!res.ok) {
+        throw new Error(`[@pactor-app/app] sitemap \u6E90 ${url} \u8BF7\u6C42\u5931\u8D25\uFF1AHTTP ${res.status}`);
+      }
+      return await res.json();
+    })
+  );
+  if (responses.length === 0) {
+    throw new Error("[@pactor-app/app] sources \u4E3A\u7A7A\uFF1A\u8BF7\u914D\u7F6E\u81F3\u5C11\u4E00\u4E2A sitemap \u63A5\u53E3 URL");
+  }
+  const [first, ...rest] = responses;
+  const merged = {
+    ...first,
+    layouts: { ...first.layouts },
+    pages: [...first.pages],
+    menus: [...first.menus]
+  };
+  for (const source of rest) {
+    mergeById(merged.pages, source.pages, "pages");
+    mergeById(merged.menus, source.menus, "menus");
+    for (const [name, layout] of Object.entries(source.layouts ?? {})) {
+      if (merged.layouts[name] !== void 0) {
+        console.warn(`[@pactor-app/app] sitemap layouts \u952E\u51B2\u7A81\uFF1A${name}\uFF0C\u540E\u6E90\u8986\u76D6\u524D\u6E90`);
+      }
+      merged.layouts[name] = layout;
+    }
+  }
+  return merged;
+}
+function mergeById(target, incoming, label) {
+  for (const item of incoming) {
+    const index = target.findIndex(
+      (t) => t.id === item.id || item.path !== void 0 && t.path === item.path
+    );
+    if (index >= 0) {
+      console.warn(`[@pactor-app/app] sitemap ${label} \u51B2\u7A81\uFF1A${item.id}\uFF0C\u540E\u6E90\u8986\u76D6\u524D\u6E90`);
+      target[index] = item;
+    } else {
+      target.push(item);
+    }
+  }
+}
+
+// src/sitemap/loader.ts
+var defaultPageEndpoint = (pageId) => `/api/pages/${pageId}`;
+function createSitemapLoader(sitemap, options = {}) {
+  const pageEndpoint = options.pageEndpoint ?? defaultPageEndpoint;
+  const sessionService = options.sessionService ?? "session.context";
+  const fetcher = withHttpHooks(options.fetcher ?? fetch, options.httpHooks);
+  const pageById = new Map(sitemap.pages.map((p) => [p.id, p]));
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    async loadPage(pageId) {
+      const entry = pageById.get(pageId);
+      const version = entry?.version ?? 1;
+      const cacheKey = `${pageId}@${version}`;
+      const hit = cache.get(cacheKey);
+      if (hit) {
+        return hit;
+      }
+      let resource;
+      if (entry?.pageDsl !== void 0) {
+        resource = {
+          id: pageId,
+          resourceType: "page",
+          version,
+          dslVersion: entry.pageDsl.dsl ?? "1.0",
+          schema: entry.pageDsl
+        };
+      } else {
+        const res = await fetcher(resolveUrl(pageEndpoint(pageId), options.baseUrl), {
+          cache: "no-store",
+          credentials: "include"
+        });
+        if (!res.ok) {
+          throw new Error(
+            `[@pactor-app/app] \u9875\u9762 ${pageId} \u52A0\u8F7D\u5931\u8D25\uFF1AHTTP ${res.status}`
+          );
+        }
+        resource = await res.json();
+      }
+      if (typeof resource.schema === "object" && resource.schema !== null) {
+        const schema = resource.schema;
+        schema.dataSources = {
+          session: { type: "service", service: sessionService, autoLoad: true },
+          ...schema.dataSources
+        };
+      }
+      cache.set(cacheKey, resource);
+      return resource;
+    },
+    async loadFragment(fragmentId) {
+      throw new Error(`[@pactor-app/app] \u672A\u5B9E\u73B0\u7684 fragment \u52A0\u8F7D\uFF1A${fragmentId}`);
+    },
+    async loadBootstrap() {
+      return sitemap;
+    }
+  };
+}
+
+// src/sitemap/merge.ts
+function mergeSitemapMenus(sitemap) {
+  const pageById = new Map(sitemap.pages.map((p) => [p.id, p]));
+  const walk = (items) => items.map((item) => {
+    const page = item.pageId !== void 0 ? pageById.get(item.pageId) : void 0;
+    const merged = {
+      ...item,
+      path: item.path ?? page?.path,
+      title: item.title ?? page?.title ?? item.id
+    };
+    if (item.children !== void 0) {
+      merged.children = walk(item.children);
+    }
+    return merged;
+  });
+  return walk(sitemap.menus ?? []);
+}
+function toSitemapNavItems(menuTree) {
+  return menuTree.map((item) => ({
+    key: item.path ?? item.id,
+    label: item.title,
+    icon: item.icon,
+    disabled: item.disabled,
+    children: item.children !== void 0 ? toSitemapNavItems(item.children) : void 0
+  }));
+}
+
+// src/sitemap/route.ts
+function resolveSitemapRoute(sitemap, registry, pathname) {
+  const match = registry.findByPath(pathname);
+  const menu = match?.menu ?? null;
+  if (match === null || menu === null || menu.pageId === void 0) {
+    return { menu, route: null };
+  }
+  const layoutName = menu.layout ?? sitemap.layout ?? Object.keys(sitemap.layouts)[0] ?? "";
+  const highlightId = menu.activeMenu ?? menu.id;
+  const highlightItem = registry.findById(highlightId);
+  return {
+    menu,
+    route: {
+      pageId: menu.pageId,
+      layoutName,
+      highlightKey: highlightItem?.path ?? highlightId,
+      params: match.params
+    }
+  };
+}
+var defaultSitemapGuard = ({
+  sitemap,
+  pathname,
+  menu
+}) => {
+  const loginPath = sitemap.auth?.loginPath ?? "/login";
+  if (sitemap.user === void 0 && pathname !== loginPath && (menu === null || menu.public !== true)) {
+    return { allow: false, redirectTo: loginPath };
+  }
+  return { allow: true };
+};
+
+// src/sitemap/session.ts
+function createSitemapSessionServices(session, serviceName = "session.context") {
+  return {
+    [serviceName]: () => Promise.resolve(session)
+  };
+}
+
+// src/sitemap/SitemapApp.tsx
+var import_jsx_runtime6 = require("react/jsx-runtime");
+var OutletContext = (0, import_react8.createContext)(null);
+function PageOutlet() {
+  return (0, import_react8.use)(OutletContext);
+}
+var NavHighlightContext = (0, import_react8.createContext)("");
+function SitemapMenu({
+  items,
+  collapsible,
+  onSelect
+}) {
+  const highlight = (0, import_react8.use)(NavHighlightContext);
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+    import_components2.Menu,
+    {
+      items,
+      collapsible,
+      selectedKey: highlight,
+      onSelect
+    }
+  );
+}
+function SitemapApp(props) {
+  const { sources, fetcher, baseUrl } = props;
+  const browserRoute = useBrowserRoute();
+  const pathname = props.pathname ?? browserRoute.pathname;
+  const query = props.query ?? browserRoute.query;
+  const navigate = props.navigate ?? browserRoute.navigate;
+  const [state, setState] = (0, import_react8.useState)({ status: "loading" });
+  (0, import_react8.useEffect)(() => {
+    let cancelled = false;
+    setState({ status: "loading" });
+    fetchSitemap(sources, {
+      fetcher,
+      baseUrl,
+      httpHooks: props.httpAdapter
+    }).then((sitemap2) => {
+      if (!cancelled) {
+        setState({ status: "ready", sitemap: sitemap2 });
+      }
+    }).catch((error) => {
+      if (!cancelled) {
+        setState({
+          status: "error",
+          error: error instanceof Error ? error : new Error(String(error))
+        });
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [fetcher, baseUrl, props.httpAdapter, JSON.stringify(sources)]);
+  const registry = (0, import_react8.useMemo)(
+    () => state.status === "ready" ? new import_router3.MenuRegistry(mergeSitemapMenus(state.sitemap)) : null,
+    [state]
+  );
+  const resolution = (0, import_react8.useMemo)(
+    () => state.status === "ready" && registry !== null ? resolveSitemapRoute(state.sitemap, registry, pathname) : null,
+    [state, registry, pathname]
+  );
+  const sitemap = state.status === "ready" ? state.sitemap : null;
+  const guard = props.guard ?? defaultSitemapGuard;
+  const decision = (0, import_react8.useMemo)(
+    () => sitemap !== null && resolution !== null ? guard({ sitemap, pathname, menu: resolution.menu }) : { allow: true },
+    [sitemap, resolution, guard, pathname]
+  );
+  (0, import_react8.useEffect)(() => {
+    if (!decision.allow) {
+      navigate(decision.redirectTo);
+    }
+  }, [decision, navigate]);
+  if (state.status === "loading") {
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Centered, { children: props.loading ?? "\u52A0\u8F7D\u4E2D\u2026" });
+  }
+  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
+    ] });
+  }
+  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" });
+  }
+  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"
+    ] });
+  }
+  const { pageId, layoutName, highlightKey, params } = resolution.route;
+  return (
+    // key 只随布局名变化：切换导航（同布局）时布局常驻，
+    // 仅 PageOutlet 内的页面随路由重建
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(NavHighlightContext.Provider, { value: highlightKey, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+      SitemapLayout,
+      {
+        sitemap,
+        registry,
+        pageId,
+        layoutName,
+        pathname,
+        query,
+        navigate,
+        routeParams: params,
+        props
+      },
+      layoutName
+    ) })
+  );
+}
+function SitemapLayout({
+  sitemap,
+  registry,
+  pageId,
+  layoutName,
+  pathname,
+  query,
+  navigate: hostNavigate,
+  routeParams,
+  props
+}) {
+  const sessionService = props.sessionService ?? "session.context";
+  const session = (0, import_react8.useMemo)(
+    () => ({
+      user: sitemap.user,
+      app: { name: "Pactor App", ...sitemap.app },
+      menus: toSitemapNavItems(registry.tree())
+    }),
+    [sitemap, registry]
+  );
+  const navigate = (0, import_react8.useMemo)(
+    () => (to) => {
+      if (/^https?:\/\//.test(to)) {
+        window.open(to, "_blank", "noopener");
+      } else {
+        hostNavigate(to);
+      }
+    },
+    [hostNavigate]
+  );
+  const loader = (0, import_react8.useMemo)(
+    () => createSitemapLoader(sitemap, {
+      pageEndpoint: props.pageEndpoint,
+      fetcher: props.fetcher,
+      sessionService,
+      baseUrl: props.baseUrl,
+      httpHooks: props.httpAdapter
+    }),
+    [
+      sitemap,
+      props.pageEndpoint,
+      props.fetcher,
+      props.baseUrl,
+      props.httpAdapter,
+      sessionService
+    ]
+  );
+  const services = (0, import_react8.useMemo)(
+    () => ({
+      ...createSitemapSessionServices(session, sessionService),
+      ...props.services
+    }),
+    [session, sessionService, props.services]
+  );
+  const actions = (0, import_react8.useMemo)(
+    () => ({ ...defaultSitemapActions, ...props.actions }),
+    [props.actions]
+  );
+  const layoutDsl = sitemap.layouts[layoutName];
+  const layoutPage = (0, import_react8.useMemo)(() => {
+    if (layoutDsl === void 0) {
+      return null;
+    }
+    return {
+      dsl: layoutDsl.dsl,
+      page: { id: `layout:${layoutName}`, title: layoutName },
+      dataSources: {
+        session: { type: "service", service: sessionService, autoLoad: true }
+      },
+      body: layoutDsl.body
+    };
+  }, [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)(
+    OutletContext.Provider,
+    {
+      value: (
+        // 页面实例：key 随 pageId + pathname 变化（route 参数变化需重建，
+        // PactorPage 的 route prop 不参与运行时重建）——布局保持挂载
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+          PactorPage,
+          {
+            pageId,
+            route: { params: routeParams, query },
+            loader,
+            services,
+            actions,
+            permissions: sitemap.permissions ?? [],
+            navigate,
+            httpAdapter: props.httpAdapter,
+            components: props.components
+          },
+          `${pageId}@${pathname}`
+        )
+      ),
+      children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+        PactorPage,
+        {
+          pageDsl: layoutPage,
+          services,
+          actions,
+          navigate,
+          httpAdapter: props.httpAdapter,
+          components: { PageOutlet, SitemapMenu, ...props.components }
+        }
+      )
+    }
+  );
+}
+function Centered({ children }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+    "div",
+    {
+      style: {
+        minHeight: "60vh",
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 8,
+        color: "var(--muted-foreground, #6b7280)"
+      },
+      children
+    }
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Application,
@@ -885,8 +1488,19 @@ function EmbeddedPage({
   PactorPage,
   PageErrorBoundary,
   ReactRouterBinding,
+  SitemapApp,
+  createHttpHooks,
   createPactorApplication,
   createPactorPage,
   createRuntimeHttpAdapter,
+  createSitemapLoader,
+  createSitemapSessionServices,
+  defaultSitemapActions,
+  defaultSitemapGuard,
+  fetchSitemap,
+  mergeSitemapMenus,
+  resolveSitemapRoute,
+  toSitemapNavItems,
+  withHttpHooks,
   wrapHttpAdapter
 });