@pactor-app/app 1.10.0 → 1.12.0

package/README.md

@@ -83,7 +83,19 @@ const Page = createPactorPage({ loader, services, permissions: ['customer:view']
 ```
 
 - 交互层（confirm / message / overlay）与整应用模式一致；多实例状态互相隔离
-- 跳转为自然导航：`Link` 组件渲染原生 `<a href>`，`navigate` 动作退化为 `location.assign`——不注入宿主路由对象
+- 站内导航：`Link` / `Breadcrumb` 渲染原生 `<a href>` 并拦截站内左键点击，`navigate` 动作与链接点击共用同一实现——缺省退化为 `location.assign` 整页跳转，可经工厂选项 `navigate` 注入宿主路由（SPA 导航）：
+
+```tsx
+// Next.js（App Router）
+const router = useRouter();
+const Page = createPactorPage({ navigate: (to) => router.push(to) });
+
+// React Router
+const navigate = useNavigate();
+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`）
 
 ## 文档

package/dist/index.cjs

@@ -738,14 +738,14 @@ var import_runtime5 = require("@pactor-app/runtime");
 var import_react6 = require("react");
 var import_jsx_runtime5 = require("react/jsx-runtime");
 function createPactorPage(options = {}) {
+  const navigate = options.navigate ?? ((to) => {
+    if (typeof window !== "undefined") {
+      window.location.assign(to);
+    }
+  });
   const assembly = createPactorAssembly({
     ...options,
-    // 嵌入模式：navigate 退化为自然跳转（设计决策 D2，不注入宿主路由对象）
-    navigate: (to) => {
-      if (typeof window !== "undefined") {
-        window.location.assign(to);
-      }
-    }
+    navigate
   });
   let permission;
   if (options.permission !== void 0) {
@@ -769,6 +769,8 @@ function createPactorPage(options = {}) {
       services: assembly.services,
       capabilities: assembly.capabilities,
       permission,
+      // route.navigate 与 DSL navigate 动作共用同一实现（宿主注入或缺省整页跳转）
+      router: { navigate },
       http: assembly.httpAdapter,
       route: { params: route?.params ?? {}, query: route?.query ?? {} },
       locale: options.locale ?? "zh-CN",

package/dist/index.d.cts

@@ -49,7 +49,8 @@ interface PactorAssemblyOptions {
     httpAdapter?: PactorHttpHooks;
     /**
      * DSL `navigate` 动作的跳转实现（两种形态的差异点）：
-     * 整应用模式 = 导航桥 push（react-router）；嵌入模式 = location.assign
+     * 整应用模式 = 导航桥 push（react-router）；嵌入模式 = 宿主注入或
+     * 缺省 location.assign（embedded 层兜底）
      */
     navigate: (to: string) => void;
 }
@@ -328,6 +329,13 @@ interface PactorPageProps {
  * （无路由、无外壳布局）；route 上下文经 props 纯数据注入。
  */
 interface PactorPageOptions extends Omit<PactorAssemblyOptions, 'navigate'> {
+    /**
+     * 站内导航实现（D2：可选注入宿主路由，缺省退化）——如 Next.js
+     * `router.push` / react-router `navigate`；缺省以 `location.assign`
+     * 整页跳转。DSL `navigate` 动作与链接类组件的站内点击（`route.navigate`）
+     * 均走此实现。
+     */
+    navigate?: (to: string) => void;
     /** 资源加载器（按 pageId 加载页面时需要） */
     loader?: DslResourceLoader;
     /** 权限码列表（缺省全部放行；细粒度控制可传 permission 适配器） */

package/dist/index.d.ts

@@ -49,7 +49,8 @@ interface PactorAssemblyOptions {
     httpAdapter?: PactorHttpHooks;
     /**
      * DSL `navigate` 动作的跳转实现（两种形态的差异点）：
-     * 整应用模式 = 导航桥 push（react-router）；嵌入模式 = location.assign
+     * 整应用模式 = 导航桥 push（react-router）；嵌入模式 = 宿主注入或
+     * 缺省 location.assign（embedded 层兜底）
      */
     navigate: (to: string) => void;
 }
@@ -328,6 +329,13 @@ interface PactorPageProps {
  * （无路由、无外壳布局）；route 上下文经 props 纯数据注入。
  */
 interface PactorPageOptions extends Omit<PactorAssemblyOptions, 'navigate'> {
+    /**
+     * 站内导航实现（D2：可选注入宿主路由，缺省退化）——如 Next.js
+     * `router.push` / react-router `navigate`；缺省以 `location.assign`
+     * 整页跳转。DSL `navigate` 动作与链接类组件的站内点击（`route.navigate`）
+     * 均走此实现。
+     */
+    navigate?: (to: string) => void;
     /** 资源加载器（按 pageId 加载页面时需要） */
     loader?: DslResourceLoader;
     /** 权限码列表（缺省全部放行；细粒度控制可传 permission 适配器） */

package/dist/index.js

@@ -738,14 +738,14 @@ import {
 } from "react";
 import { jsx as jsx5 } from "react/jsx-runtime";
 function createPactorPage(options = {}) {
+  const navigate = options.navigate ?? ((to) => {
+    if (typeof window !== "undefined") {
+      window.location.assign(to);
+    }
+  });
   const assembly = createPactorAssembly({
     ...options,
-    // 嵌入模式：navigate 退化为自然跳转（设计决策 D2，不注入宿主路由对象）
-    navigate: (to) => {
-      if (typeof window !== "undefined") {
-        window.location.assign(to);
-      }
-    }
+    navigate
   });
   let permission;
   if (options.permission !== void 0) {
@@ -769,6 +769,8 @@ function createPactorPage(options = {}) {
       services: assembly.services,
       capabilities: assembly.capabilities,
       permission,
+      // route.navigate 与 DSL navigate 动作共用同一实现（宿主注入或缺省整页跳转）
+      router: { navigate },
       http: assembly.httpAdapter,
       route: { params: route?.params ?? {}, query: route?.query ?? {} },
       locale: options.locale ?? "zh-CN",

package/package.json

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