create-pactor-app 1.21.0 → 1.22.1

package/templates/next-app/src/server/yaml/pages/login.page.yaml

@@ -0,0 +1,69 @@
+# 登录页 DSL：内联在 sitemap 中下发（public 页，匿名可见）。
+# 登录 / 登出是普通 HTTP 调用，用内置 request 动作表达；
+# 登录成功整页重载，sitemap 端点按已登录会话重新裁剪内容。
+dsl: "1.0"
+page:
+  id: login
+  title: 登录
+
+state:
+  submitting: false
+
+body:
+  type: Form
+  events:
+    onSubmit:
+      - action: setState
+        params: { submitting: true }
+      - id: loginResult
+        action: request
+        params:
+          method: POST
+          url: http://localhost:9011/api/auth/login
+          body:
+            username: ${event.username}
+            password: ${event.password}
+      - action: setState
+        params: { submitting: false }
+      - action: if
+        params:
+          condition: ${actions.loginResult.token}
+          then:
+            - action: app.reload
+              params: { to: / }
+          else:
+            - action: message
+              params:
+                messageType: error
+                text: 登录失败：用户名或密码错误
+  children:
+    - type: Alert
+      props:
+        variant: info
+        message: 演示账号 admin / pactor123，guest / guest123
+        description: admin 可见「报表」菜单（report:view）；guest 仅可见首页。登录后 sitemap 按角色重新下发。
+        style: { marginBottom: 16 }
+    - type: Input
+      props:
+        name: username
+        label: 用户名
+        placeholder: 请输入用户名
+        rules:
+          - { required: true, message: 请输入用户名 }
+    - type: Input
+      props:
+        name: password
+        label: 密码
+        type: password
+        placeholder: 请输入密码
+        rules:
+          - { required: true, message: 请输入密码 }
+    - type: Flex
+      props: { justify: end }
+      children:
+        - type: Button
+          props:
+            text: 登 录
+            variant: primary
+            submit: true
+            loading: ${state.submitting}

package/templates/next-app/src/server/yaml/pages/monthly-detail.page.yaml

@@ -0,0 +1,23 @@
+# 月报详情页 DSL：内联在 sitemap 中下发（需 report:view）。
+# 隐藏页（不出现在菜单），经列表页跳转进入；${route.params.id} 演示路径参数。
+dsl: "1.0"
+page:
+  id: monthly-detail
+  title: 月报详情
+
+body:
+  type: Page
+  props: { title: 月报详情 }
+  children:
+    - type: Alert
+      props:
+        variant: info
+        message: 路径参数演示：id = ${route.params.id}
+        description: 隐藏页（不出现在菜单），经列表页跳转进入。
+        style: { marginBottom: 16 }
+    - type: Button
+      props: { text: 返回月报 }
+      events:
+        onClick:
+          - action: navigate
+            params: { to: /reports/monthly }

package/templates/next-app/src/server/yaml/pages/monthly.page.yaml

@@ -0,0 +1,41 @@
+# 月报页 DSL：懒加载页——sitemap 中仅声明 id / path / version（monthly@7），
+# 本文件由 /api/pages/monthly 按需下发（见 src/server/sitemap.ts 的 lazyPages）。
+dsl: "1.0"
+page:
+  id: monthly
+  title: 月报
+
+body:
+  type: Page
+  props: { title: 本月经营月报 }
+  children:
+    - type: Flex
+      props: { gap: 16, style: { marginBottom: 16 } }
+      children:
+        - type: Card
+          props: { title: 营收 }
+          children:
+            - type: Statistic
+              props: { title: 本月（万元）, value: 128.6 }
+        - type: Card
+          props: { title: 新增客户 }
+          children:
+            - type: Statistic
+              props: { title: 本月（家）, value: 342 }
+        - type: Card
+          props: { title: 转化率 }
+          children:
+            - type: Statistic
+              props: { title: 本月（%）, value: 23.8 }
+    - type: Alert
+      props:
+        variant: success
+        message: 本页 DSL 由 /api/pages/monthly 懒加载下发
+        description: sitemap 中该页仅声明 id / path / version（monthly@7），点击进入时才请求页面 DSL。
+        style: { marginBottom: 16 }
+    - type: Button
+      props: { text: 查看详情（隐藏页 + 路径参数） }
+      events:
+        onClick:
+          - action: navigate
+            params: { to: /reports/monthly/2026-09 }

package/templates/next-app/src/server/yaml/pages/register.page.yaml

@@ -0,0 +1,23 @@
+# 注册页 DSL：内联在 sitemap 中下发（public 页，匿名可见）。
+# 演示环境不开放注册，仅作多 public 页示例。
+dsl: "1.0"
+page:
+  id: register
+  title: 注册
+
+body:
+  type: Page
+  props: { title: 注册 }
+  children:
+    - type: Alert
+      props:
+        variant: warning
+        message: 演示环境不开放注册
+        description: 请使用登录页的演示账号体验不同角色的菜单差异。
+        style: { marginBottom: 16 }
+    - type: Button
+      props: { text: 返回登录, variant: primary }
+      events:
+        onClick:
+          - action: navigate
+            params: { to: /login }

package/templates/next-app/src/server/yaml/pages/users.page.yaml

@@ -0,0 +1,85 @@
+# 用户列表页 DSL：由 /api/pages/users 懒加载下发（见 src/server/sitemap.ts）。
+# 数据来自 /api/users（接口侧鉴权，需登录且具备 user:view 权限）。
+dsl: "1.0"
+page:
+  id: users
+  title: 用户列表
+  permission: user:view
+
+state:
+  keyword: ""
+  role: ""
+
+dataSources:
+  users:
+    type: http
+    autoLoad: true
+    request:
+      method: GET
+      url: http://localhost:9011/api/users
+      params:
+        keyword: ${state.keyword}
+        role: ${state.role}
+
+body:
+  type: Page
+  props: { title: 用户列表 }
+  children:
+    - type: Card
+      props: { title: 筛选 }
+      children:
+        - type: Form
+          props: { layout: inline }
+          events:
+            onSubmit:
+              - action: setState
+                params:
+                  keyword: ${event.keyword}
+                  role: ${event.role}
+              - action: reload
+                params: { dataSource: users }
+          children:
+            - type: Input
+              props: { name: keyword, label: 关键词, placeholder: 姓名 / 用户名 }
+            - type: Select
+              props:
+                name: role
+                label: 角色
+                placeholder: 请选择角色
+                options:
+                  - { label: 管理员, value: admin }
+                  - { label: 成员, value: member }
+                  - { label: 访客, value: guest }
+            - type: Button
+              props: { text: 查询, variant: primary, submit: true }
+    - type: Card
+      props: { title: 用户数据 }
+      children:
+        - type: Table
+          props:
+            dataSource: ${data.users}
+            loading: ${dataStatus.users.loading}
+            rowKey: id
+            pagination: { pageSize: 5 }
+            columns:
+              - { title: 姓名, dataIndex: name }
+              - { title: 用户名, dataIndex: username }
+              - title: 角色
+                dataIndex: role
+                cell:
+                  type: Badge
+                  props:
+                    text: ${row.role}
+                    variant: secondary
+              - { title: 邮箱, dataIndex: email }
+              - { title: 创建时间, dataIndex: createdAt }
+              - title: 操作
+                cell:
+                  type: Button
+                  props: { text: 查看, variant: primary, size: small }
+                  events:
+                    onClick:
+                      - action: message
+                        params:
+                          messageType: info
+                          text: 用户 ${row.name}（${row.username}）

package/templates/next-app/src/server/yaml/sitemap.yaml

@@ -0,0 +1,148 @@
+# Sitemap 入口数据（design/dynamic-page.md 方案 B）：元数据 + 布局 + 页面 + 菜单全量。
+# 本文件是会话无关的超集；可见性由 src/server/sitemap.ts 按会话裁剪：
+#   public: true   → 匿名可见（登录/注册页）
+#   permission: x  → 需登录且具备对应权限
+#   无标记         → 需登录
+# 页面 DSL 按 id 约定从 pages/<id>.page.yaml 加载；lazy: true 不随 sitemap
+# 内联下发，客户端经 /api/pages/{id} 懒加载。updatedAt / user / permissions
+# 为会话动态字段，由服务端在响应时注入。
+
+id: site
+resourceType: sitemap
+version: 13
+dslVersion: "1.0"
+app: { name: 动态页面 Starter }
+layout: admin
+auth: { loginPath: /login }
+
+pages:
+  - { id: login, path: /login, title: 登录, version: 1, public: true }
+  - { id: register, path: /register, title: 注册, version: 1, public: true }
+  - { id: home, path: /, title: 首页, version: 3 }
+  - { id: users, path: /users, title: 用户列表, version: 1, permission: user:view, lazy: true }
+  - { id: monthly, path: /reports/monthly, title: 月报, version: 7, permission: report:view, lazy: true }
+  - { id: monthly-detail, path: /reports/monthly/:id, title: 月报详情, version: 2, permission: report:view }
+
+menus:
+  - { id: login, type: page, pageId: login, title: 登录, layout: login, public: true, hidden: true }
+  - { id: register, type: page, pageId: register, title: 注册, layout: login, public: true, hidden: true }
+  - { id: home, type: page, pageId: home, title: 首页, icon: home, layout: admin, order: 1 }
+  - { id: users, type: page, pageId: users, title: 用户列表, icon: users, layout: admin, permission: user:view, order: 2 }
+  - id: reports
+    type: group
+    title: 报表
+    icon: chart
+    order: 3
+    children:
+      - { id: monthly, type: page, pageId: monthly, title: 报表中心, icon: chart, layout: admin, permission: report:view }
+      - { id: monthly-detail, type: page, pageId: monthly-detail, title: 月报详情, layout: admin, hidden: true, activeMenu: monthly, permission: report:view }
+  - { id: help, type: link, title: 帮助, path: https://github.com/, external: true, permission: report:view, order: 4 }
+
+# 布局 DSL（PageOutlet 为页面内容出口）。
+# 布局 body 内 ${data.session.*} 由客户端注入的 session dataSource 提供
+#（user / app / menus）；${route.params.pathname} 为当前路径（客户端注入）。
+# 登录 / 登出是普通 HTTP 调用，DSL 用内置 request 动作表达（跨域绝对地址，
+# 客户端 httpHooks 自动改写进项目内代理前缀），无需客户端注册服务。
+layouts:
+  # 管理端外壳：左侧 SitemapMenu 导航 + 顶栏用户菜单 + PageOutlet
+  admin:
+    dsl: "1.0"
+    body:
+      type: Flex
+      props: { gap: 0, direction: horizontal, style: { height: 100vh } }
+      children:
+        - type: Flex
+          props:
+            direction: vertical
+            style:
+              width: 224
+              flexShrink: 0
+              borderRight: 1px solid var(--border)
+          children:
+            - type: Flex
+              props:
+                style:
+                  padding: 16px 16px
+                  fontWeight: 600
+                  borderBottom: 1px solid var(--border)
+              children:
+                - type: Text
+                  props: { text: "${data.session.app.name}" }
+            - type: SitemapMenu
+              props:
+                items: ${data.session.menus}
+                collapsible: true
+              events:
+                onSelect:
+                  - action: navigate
+                    params: { to: "${event}" }
+        - type: Flex
+          props:
+            direction: vertical
+            style: { flex: 1, minWidth: 0 }
+          children:
+            - type: Flex
+              props:
+                justify: end
+                align: center
+                style:
+                  padding: 10px 20px
+                  borderBottom: 1px solid var(--border)
+              children:
+                - type: DropdownMenu
+                  props:
+                    items:
+                      - { label: 个人设置, value: settings, icon: settings }
+                      - { label: 退出登录, value: logout, icon: log-out }
+                  events:
+                    onSelect:
+                      - action: if
+                        params:
+                          condition: ${event == 'logout'}
+                          then:
+                            - action: request
+                              params:
+                                method: POST
+                                url: http://localhost:9011/api/auth/logout
+                            - action: app.reload
+                              params: { to: /login }
+                          else:
+                            - action: message
+                              params: { text: 演示环境未实现个人设置 }
+                  children:
+                    - type: Button
+                      props:
+                        text: ${data.session.user.name}
+                        variant: text
+            - type: Flex
+              props:
+                direction: vertical
+                style: { flex: 1, minHeight: 0, overflow: auto }
+              children:
+                - type: PageOutlet
+  # 登录 / 注册页外壳：居中卡片
+  login:
+    dsl: "1.0"
+    body:
+      type: Flex
+      props:
+        direction: vertical
+        justify: center
+        align: center
+        style: { minHeight: 100vh, padding: 24 }
+      children:
+        - type: Flex
+          props:
+            direction: vertical
+            style:
+              width: 380
+              padding: 24
+              border: 1px solid var(--border)
+              borderRadius: 12
+          children:
+            - type: PageOutlet
+  # 裸布局：无外壳，页面铺满
+  blank:
+    dsl: "1.0"
+    body:
+      type: PageOutlet

package/templates/spa/README.md

@@ -10,7 +10,6 @@ popstate 前进后退）接管全部路由：
 <SitemapApp
   sources={sitemapSources}    // sitemap 接口（相对路径）
   baseUrl={apiBaseUrl}        // 外部接口基准地址（相对路径补全）
-  pageEndpoint={pageEndpoint} // 懒加载页面端点
   httpAdapter={httpHooks}     // 框架 createHttpHooks：跨域改写 + 响应拆包
 />
 ```
@@ -38,7 +37,7 @@ src/
   main.tsx               # React 入口（导入 @pactor-app/ui/styles.css，必需）
   pactor/
     App.tsx              # SitemapApp 装配（纯前端模式：零路由配置；HTTP 钩子用框架 createHttpHooks）
-    config.ts            # sitemapSources / apiBaseUrl / pageEndpoint
+    config.ts            # sitemapSources / apiBaseUrl
 vite.config.ts           # react 插件（无代理：接口服务端已开通 CORS，直连）
 ```
 
@@ -61,7 +60,7 @@ vite.config.ts           # react 插件（无代理：接口服务端已开通 C
 
 外部接口以 `apiBaseUrl`（`src/pactor/config.ts`，缺省
 `http://localhost:9011`，即 next-app-starter 的 dev server）为基准：
-`sitemapSources` / `pageEndpoint` 只写相对路径，由 `baseUrl` 补全为
+`sitemapSources` 只写相对路径，由 `baseUrl` 补全为
 外部绝对地址。**假定服务端已开通 CORS，浏览器直连，无需项目内代理**——
 接口方（next-app-starter）已在路由层放开跨源并支持凭据
 （Allow-Origin 回显 + Allow-Credentials + 预检响应），cookie 会话跨源
@@ -85,8 +84,8 @@ vite.config.ts           # react 插件（无代理：接口服务端已开通 C
    - `menus`：导航 / 路由树（`pageId` 引用页面、`layout` 引用布局、
      `public` 免登录；`path` / `title` 缺省从引用页面继承）
    - `auth.loginPath`：未登录重定向目标
-3. 懒加载页：实现 `GET {pageEndpoint}/{id}` 返回 PageResource envelope
-   （缺省 `/api/pages/{id}`）。
+3. 懒加载页：实现 `GET /api/pages/{id}` 返回 PageResource envelope
+   （路径为框架缺省；需自定义时给 `SitemapApp` 传 `pageEndpoint` prop）。
 4. 登录 / 登出等接口调用直接在 DSL 中用内置 `request` 动作表达（URL
    指向你的真实接口）；有客户端服务层时可用内置 `service.call` 动作
    桥接，`session.context` 会话桥由框架内置，均无需自行注册。

package/templates/spa/package.json

@@ -10,10 +10,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pactor-app/core": "^1.20.0",
-    "@pactor-app/runtime": "^1.20.0",
-    "@pactor-app/ui": "^1.20.0",
-    "pactor-app": "^1.20.0",
+    "@pactor-app/core": "^1.22.0",
+    "@pactor-app/runtime": "^1.22.0",
+    "@pactor-app/ui": "^1.22.0",
+    "pactor-app": "^1.22.0",
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "react-router-dom": "^7.18.2"

package/templates/spa/pnpm-workspace.yaml

@@ -0,0 +1,6 @@
+# 模板独立安装（pnpm install）时批准运行构建脚本的原生依赖：
+# esbuild（vite 依赖链上的原生二进制）。显式批准而非
+# ignoredBuiltDependencies 静默，避免 strict-dep-builds / CI 环境下报
+# ERR_PNPM_IGNORED_BUILDS
+onlyBuiltDependencies:
+  - esbuild

package/templates/spa/src/pactor/config.ts

@@ -5,14 +5,10 @@
  * 取第一个源。
  *
  * 本模板不自带后端：接口复用 next-app-starter 的 mock API
- * （apiBaseUrl 指向其 dev server，已开通 CORS）。sources / pageEndpoint
- * 只写相对路径，由 apiBaseUrl 补全为外部绝对地址，浏览器直连，
- * 无需项目内代理。
+ * （apiBaseUrl 指向其 dev server，已开通 CORS）。sources 只写相对路径，
+ * 由 apiBaseUrl 补全为外部绝对地址，浏览器直连，无需项目内代理。
  */
 export const sitemapSources: string[] = ["/api/sitemap"];
 
 /** 外部接口基准地址（SitemapApp baseUrl）：相对接口路径以此为基准补全 */
 export const apiBaseUrl = "http://localhost:9011";
-
-/** 懒加载页面端点（pages[].pageDsl 缺省时按 id 获取） */
-export const pageEndpoint = (pageId: string): string => `/api/pages/${pageId}`;