@pactor-app/app 1.18.0 → 1.20.0

package/dist/index.js

@@ -878,14 +878,623 @@ function EmbeddedPage({
   }
   return /* @__PURE__ */ jsx5(I18nContextProvider2, { value: i18n, children: /* @__PURE__ */ jsx5(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
+import { MenuRegistry as MenuRegistry2 } from "@pactor-app/router";
+import { Menu } from "@pactor-app/ui/components";
+import {
+  createContext,
+  use,
+  useEffect as useEffect4,
+  useMemo as useMemo2,
+  useState as useState4
+} from "react";
+
+// src/sitemap/browser-route.ts
+import { useCallback, useMemo, useSyncExternalStore } from "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 = useSyncExternalStore(
+    subscribe,
+    readLocation,
+    // SSR 快照：服务端无 window，宿主应注入 pathname / navigate
+    () => "/"
+  );
+  const navigate = useCallback((to) => {
+    window.history.pushState(null, "", to);
+    window.dispatchEvent(new Event(NAV_EVENT));
+  }, []);
+  return 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
+import { Fragment, jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
+var OutletContext = createContext(null);
+function PageOutlet() {
+  return use(OutletContext);
+}
+var NavHighlightContext = createContext("");
+function SitemapMenu({
+  items,
+  collapsible,
+  onSelect
+}) {
+  const highlight = use(NavHighlightContext);
+  return /* @__PURE__ */ jsx6(
+    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] = useState4({ status: "loading" });
+  useEffect4(() => {
+    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 = useMemo2(
+    () => state.status === "ready" ? new MenuRegistry2(mergeSitemapMenus(state.sitemap)) : null,
+    [state]
+  );
+  const resolution = useMemo2(
+    () => 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 = useMemo2(
+    () => sitemap !== null && resolution !== null ? guard({ sitemap, pathname, menu: resolution.menu }) : { allow: true },
+    [sitemap, resolution, guard, pathname]
+  );
+  useEffect4(() => {
+    if (!decision.allow) {
+      navigate(decision.redirectTo);
+    }
+  }, [decision, navigate]);
+  if (state.status === "loading") {
+    return /* @__PURE__ */ jsx6(Centered, { children: props.loading ?? "\u52A0\u8F7D\u4E2D\u2026" });
+  }
+  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
+    ] });
+  }
+  if (sitemap === null || registry === null || resolution === null) {
+    return null;
+  }
+  if (!decision.allow) {
+    return /* @__PURE__ */ jsx6(Centered, { children: "\u91CD\u5B9A\u5411\u2026" });
+  }
+  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"
+    ] });
+  }
+  const { pageId, layoutName, highlightKey, params } = resolution.route;
+  return (
+    // key 只随布局名变化：切换导航（同布局）时布局常驻，
+    // 仅 PageOutlet 内的页面随路由重建
+    /* @__PURE__ */ jsx6(NavHighlightContext.Provider, { value: highlightKey, children: /* @__PURE__ */ jsx6(
+      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 = useMemo2(
+    () => ({
+      user: sitemap.user,
+      app: { name: "Pactor App", ...sitemap.app },
+      menus: toSitemapNavItems(registry.tree())
+    }),
+    [sitemap, registry]
+  );
+  const navigate = useMemo2(
+    () => (to) => {
+      if (/^https?:\/\//.test(to)) {
+        window.open(to, "_blank", "noopener");
+      } else {
+        hostNavigate(to);
+      }
+    },
+    [hostNavigate]
+  );
+  const loader = useMemo2(
+    () => 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 = useMemo2(
+    () => ({
+      ...createSitemapSessionServices(session, sessionService),
+      ...props.services
+    }),
+    [session, sessionService, props.services]
+  );
+  const actions = useMemo2(
+    () => ({ ...defaultSitemapActions, ...props.actions }),
+    [props.actions]
+  );
+  const layoutDsl = sitemap.layouts[layoutName];
+  const layoutPage = useMemo2(() => {
+    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__ */ jsxs3(Centered, { children: [
+      "\u5E03\u5C40\u672A\u5B9A\u4E49\uFF1A",
+      layoutName
+    ] });
+  }
+  return /* @__PURE__ */ jsx6(
+    OutletContext.Provider,
+    {
+      value: (
+        // 页面实例：key 随 pageId + pathname 变化（route 参数变化需重建，
+        // PactorPage 的 route prop 不参与运行时重建）——布局保持挂载
+        /* @__PURE__ */ jsx6(
+          PactorPage,
+          {
+            pageId,
+            route: { params: routeParams, query },
+            loader,
+            services,
+            actions,
+            permissions: sitemap.permissions ?? [],
+            navigate,
+            httpAdapter: props.httpAdapter,
+            components: props.components
+          },
+          `${pageId}@${pathname}`
+        )
+      ),
+      children: /* @__PURE__ */ jsx6(
+        PactorPage,
+        {
+          pageDsl: layoutPage,
+          services,
+          actions,
+          navigate,
+          httpAdapter: props.httpAdapter,
+          components: { PageOutlet, SitemapMenu, ...props.components }
+        }
+      )
+    }
+  );
+}
+function Centered({ children }) {
+  return /* @__PURE__ */ jsx6(
+    "div",
+    {
+      style: {
+        minHeight: "60vh",
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 8,
+        color: "var(--muted-foreground, #6b7280)"
+      },
+      children
+    }
+  );
+}
 export {
   Application,
   DslPageLoader,
   PactorPage,
   PageErrorBoundary,
   ReactRouterBinding,
+  SitemapApp,
+  createHttpHooks,
   createPactorApplication,
   createPactorPage,
   createRuntimeHttpAdapter,
+  createSitemapLoader,
+  createSitemapSessionServices,
+  defaultSitemapActions,
+  defaultSitemapGuard,
+  fetchSitemap,
+  mergeSitemapMenus,
+  resolveSitemapRoute,
+  toSitemapNavItems,
+  withHttpHooks,
   wrapHttpAdapter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/app",
-  "version": "1.18.0",
+  "version": "1.20.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.18.0",
-    "@pactor-app/resource": "1.18.0",
-    "@pactor-app/expression": "1.18.0",
-    "@pactor-app/permission": "1.18.0",
-    "@pactor-app/router": "1.18.0",
-    "@pactor-app/schema": "1.18.0",
-    "@pactor-app/ui": "1.18.0",
-    "@pactor-app/runtime": "1.18.0"
+    "@pactor-app/core": "1.20.0",
+    "@pactor-app/permission": "1.20.0",
+    "@pactor-app/resource": "1.20.0",
+    "@pactor-app/schema": "1.20.0",
+    "@pactor-app/runtime": "1.20.0",
+    "@pactor-app/ui": "1.20.0",
+    "@pactor-app/expression": "1.20.0",
+    "@pactor-app/router": "1.20.0"
   },
   "peerDependencies": {
     "react": ">=18",