create-pactor-app 1.21.0 → 1.22.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pactor-app",
-  "version": "1.21.0",
+  "version": "1.22.1",
   "description": "Create a Pactor app from starter templates (pnpm create pactor-app)",
   "keywords": [
     "pactor",

package/templates/next-app/README.md

@@ -44,6 +44,8 @@ src/
     cors.ts                # CORS 头（演示放开跨源，含预检响应）
     sitemap.ts             # mock sitemap 数据源（layouts / pages / menus 按角色裁剪；
                            # 登录 / 登出在 DSL 中用内置 request 动作表达）
+    yaml/                  # DSL 文件：sitemap.yaml（入口元数据 + 布局 + 页面/菜单全量声明）
+      pages/               # 页面 DSL（每页一个 *.page.yaml，按 id 约定加载）
 ```
 
 `App.tsx` 全部内容即：
@@ -57,7 +59,6 @@ const httpHooks = createHttpHooks();
   pathname={pathname}
   query={query}
   navigate={(to) => router.push(to)}
-  pageEndpoint={pageEndpoint}
   httpAdapter={httpHooks}
 />
 ```
@@ -77,8 +78,8 @@ const httpHooks = createHttpHooks();
    - `menus`：导航 / 路由树（`pageId` 引用页面、`layout` 引用布局、
      `public` 免登录；`path` / `title` 缺省从引用页面继承）
    - `auth.loginPath`：未登录重定向目标
-3. 懒加载页：实现 `GET {pageEndpoint}/{id}` 返回 PageResource envelope
-   （缺省 `/api/pages/{id}`，可在 `config.ts` 调整）。
+3. 懒加载页：实现 `GET /api/pages/{id}` 返回 PageResource envelope
+   （路径为框架缺省；需自定义时给 `SitemapApp` 传 `pageEndpoint` prop）。
 4. 登录 / 登出等接口调用直接在 DSL 中用内置 `request` 动作表达（参考
    `src/server/sitemap.ts` 的登录页 / 布局 DSL，URL 指向你的真实接口）；
    有客户端服务层时可用内置 `service.call` 动作桥接，`session.context`
@@ -87,7 +88,7 @@ const httpHooks = createHttpHooks();
 ## 跨域与 HTTP 钩子
 
 模板的外部接口以 `apiBaseUrl`（`src/pactor/config.ts`，缺省
-`http://localhost:9011`）为基准：`sitemapSources` / `pageEndpoint`
+`http://localhost:9011`）为基准：`sitemapSources`
 只写相对路径，由 `SitemapApp` 的 `baseUrl` 补全为外部绝对地址。
 **假定服务端已开通 CORS，浏览器直连，无需项目内代理**——本模板的
 mock API 已在路由层放开跨源（`src/server/cors.ts`：Allow-Origin 回显

package/templates/next-app/app/api/users/route.ts

@@ -0,0 +1,57 @@
+import { cookies } from "next/headers";
+
+import { findUserBySession, SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+
+/** 演示用户数据（mock）：真实项目由后端用户体系提供 */
+const MOCK_USERS = [
+  { id: "u-1", username: "admin", name: "演示管理员", role: "admin", email: "admin@example.com", createdAt: "2026-01-05" },
+  { id: "u-2", username: "guest", name: "访客", role: "guest", email: "guest@example.com", createdAt: "2026-02-11" },
+  { id: "u-3", username: "zhangwei", name: "张伟", role: "member", email: "zhangwei@example.com", createdAt: "2026-03-02" },
+  { id: "u-4", username: "liuyang", name: "刘洋", role: "member", email: "liuyang@example.com", createdAt: "2026-03-18" },
+  { id: "u-5", username: "chenjing", name: "陈静", role: "member", email: "chenjing@example.com", createdAt: "2026-04-07" },
+  { id: "u-6", username: "wangfang", name: "王芳", role: "member", email: "wangfang@example.com", createdAt: "2026-05-21" },
+  { id: "u-7", username: "zhaolei", name: "赵磊", role: "guest", email: "zhaolei@example.com", createdAt: "2026-06-13" },
+  { id: "u-8", username: "sunna", name: "孙娜", role: "member", email: "sunna@example.com", createdAt: "2026-07-30" },
+];
+
+/**
+ * 用户列表：users.page.yaml 的 http 数据源。
+ * 支持 keyword（姓名 / 用户名模糊匹配）与 role（精确匹配）过滤。
+ * 接口侧鉴权——前端隐藏菜单不等于安全。
+ */
+export async function GET(request: Request) {
+  const store = await cookies();
+  const user = findUserBySession(store.get(SESSION_COOKIE)?.value);
+  if (!user || !user.permissions.includes("user:view")) {
+    return Response.json(
+      { error: "未登录或无权限" },
+      { status: 401, headers: corsHeaders(request) },
+    );
+  }
+
+  const { searchParams } = new URL(request.url);
+  const keyword = (searchParams.get("keyword") ?? "").trim().toLowerCase();
+  const role = searchParams.get("role") ?? "";
+
+  const list = MOCK_USERS.filter((row) => {
+    if (role && row.role !== role) {
+      return false;
+    }
+    if (
+      keyword &&
+      !row.name.toLowerCase().includes(keyword) &&
+      !row.username.toLowerCase().includes(keyword)
+    ) {
+      return false;
+    }
+    return true;
+  });
+
+  return Response.json(list, {
+    headers: { "cache-control": "no-store", ...corsHeaders(request) },
+  });
+}
+
+/** 预检（跨源带凭据 / 自定义头时） */
+export const OPTIONS = corsPreflight;

package/templates/next-app/app/layout.tsx

@@ -2,6 +2,7 @@ import type { Metadata } from "next";
 import { PactorApp } from "@/pactor/App";
 import "@pactor-app/ui/styles.css";
 import "./globals.css";
+import "./theme.css";
 
 export const metadata: Metadata = {
   title: "Pactor 动态页面 Starter",
@@ -10,10 +11,7 @@ export const metadata: Metadata = {
 
 export default function RootLayout({ children }: LayoutProps<"/">) {
   return (
-    <html
-      lang="zh-CN"
-      className={`h-full antialiased`}
-    >
+    <html lang="zh-CN" className={`h-full antialiased`}>
       <body className="min-h-full flex flex-col">
         {/*
          * PactorApp 挂在 Next layout 而非 page：App Router 导航时 page 会

package/templates/next-app/app/theme.css

@@ -0,0 +1,111 @@
+/**
+ * pactor 皮肤文件 —— 由 Theme Studio 生成（基于预置主题「晨雾奶芙」）
+ * 用法：在 `@pactor-app/ui/styles.css` 之后加载本文件（后加载者胜出）。
+ */
+:root:not([data-pactor-theme='dark']) {
+  color-scheme: light;
+  --background: #f8f3ea;
+  --foreground: #4a3f33;
+  --card: #fffdf8;
+  --card-foreground: #4a3f33;
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: #c98a5e;
+  --primary-foreground: #fff8f0;
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --accent: #f3e4d3;
+  --accent-foreground: #6b4f35;
+  --muted: #f1e9dd;
+  --muted-foreground: #8a7a68;
+  --destructive: #c0564a;
+  --destructive-foreground: oklch(0.985 0 0);
+  --success: #7d9b5f;
+  --warning: #d9a03f;
+  --info: #8a9bb5;
+  --border: #e8dccb;
+  --input: #e8dccb;
+  --ring: #c98a5e;
+  --chart-1: #c98a5e;
+  --chart-2: #e0b48a;
+  --chart-3: #a8c3a0;
+  --chart-4: #d98c7a;
+  --chart-5: #8a9bb5;
+  --sidebar: var(--card);
+  --sidebar-foreground: var(--card-foreground);
+  --sidebar-primary: var(--primary);
+  --sidebar-primary-foreground: var(--primary-foreground);
+  --sidebar-accent: var(--accent);
+  --sidebar-accent-foreground: var(--accent-foreground);
+  --sidebar-border: var(--border);
+  --sidebar-ring: var(--ring);
+  --switch-track: var(--input);
+  --switch-track-checked: var(--primary);
+  --switch-thumb: var(--card);
+  --slider-track: var(--muted);
+  --slider-range: var(--primary);
+  --slider-thumb: var(--card);
+  --radio-border: var(--input);
+  --radio-checked: var(--primary);
+  --progress-track: var(--muted);
+  --progress-indicator: var(--primary);
+  --pagination-active-background: var(--card);
+  --pagination-active-border: var(--border);
+  --menu-hover-background: var(--accent);
+  --menu-hover-foreground: var(--accent-foreground);
+  --menu-active-background: var(--accent);
+  --menu-active-foreground: var(--accent-foreground);
+  --bubble-background: oklch(from var(--primary) 0.93 calc(c * 0.4) h);
+  --bubble-hover-background: oklch(from var(--primary) 0.88 calc(c * 0.5) h);
+  --calendar-day-hover-background: var(--accent);
+  --calendar-day-hover-foreground: var(--accent-foreground);
+  --calendar-selected-background: var(--primary);
+  --calendar-selected-foreground: var(--primary-foreground);
+  --calendar-today-background: var(--accent);
+  --calendar-today-foreground: var(--accent-foreground);
+  --calendar-today-border: var(--primary);
+  --calendar-range-background: var(--accent);
+  --calendar-range-foreground: var(--accent-foreground);
+  --radius: 12px;
+  --flex-gap: 12px;
+  --flex-gap-sm: calc(var(--flex-gap) * 0.67);
+  --flex-gap-md: calc(var(--flex-gap) * 1.33);
+  --flex-gap-lg: calc(var(--flex-gap) * 2);
+  --grid-gap: 16px;
+  --pagination-active-radius: calc(var(--radius) * 0.8);
+  --font-sans: ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --background-image: none;
+  --card-shadow: 0 8px 24px rgb(120 90 60 / 10%);
+  --overlay-background: oklch(0 0 0 / 50%);
+  --shadow-color: oklch(0 0 0 / 10%);
+  --sidebar-width: 16rem;
+  --sidebar-width-icon: 3rem;
+}
+
+[data-pactor-theme='dark'] {
+  color-scheme: dark;
+  --background: #221c16;
+  --foreground: #f3e9dc;
+  --card: #2b241c;
+  --card-foreground: #f3e9dc;
+  --popover: #2b241c;
+  --popover-foreground: #f3e9dc;
+  --muted: #322a21;
+  --muted-foreground: #a89480;
+  --primary: #d9a075;
+  --primary-foreground: #2b2016;
+  --accent: #453a2e;
+  --accent-foreground: #f0dcc8;
+  --border: #453b30;
+  --input: #453b30;
+  --ring: #d9a075;
+  --chart-1: #d9a075;
+  --chart-2: #e8c8a8;
+  --chart-3: #a8c3a0;
+  --chart-4: #d98c7a;
+  --chart-5: #8a9bb5;
+  --destructive: #d98c7a;
+  --success: #a8c3a0;
+  --warning: #e0b484;
+  --info: #a9b8cc;
+}

package/templates/next-app/next.config.js

@@ -0,0 +1,32 @@
+/**
+ * Next.js 构建配置。
+ *
+ * API_BASE_URLS：各环境默认的外部接口基准地址（SitemapApp baseUrl）。
+ * - 环境由构建命令注入（scripts/build.mjs 设置 APP_ENV：
+ *   build / build:dev / build:test → production / development / test）；
+ * - 解析结果经 env 配置内联进客户端包（src/pactor/config.ts 消费）；
+ * - test / production 为占位域名，接入真实环境时替换；
+ * - 构建环境可设 NEXT_PUBLIC_API_BASE_URL 显式覆盖（域名不符合约定时）。
+ */
+const API_BASE_URLS = {
+  /** 本地开发：dev 端口 9011 */
+  development: 'http://localhost:9011',
+  /** 测试环境：替换为实际测试环境 API 域名 */
+  test: 'https://api-test.example.com',
+  /** 生产环境：替换为实际生产 API 域名 */
+  production: 'https://api.example.com',
+};
+
+const appEnv = ['development', 'test', 'production'].includes(process.env.APP_ENV)
+  ? process.env.APP_ENV
+  : 'development';
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  env: {
+    NEXT_PUBLIC_API_BASE_URL:
+      process.env.NEXT_PUBLIC_API_BASE_URL ?? API_BASE_URLS[appEnv],
+  },
+};
+
+module.exports = nextConfig;

package/templates/next-app/package.json

@@ -4,18 +4,21 @@
   "private": true,
   "scripts": {
     "dev": "next dev -p 9011",
-    "build": "next build",
+    "build": "node scripts/build.mjs production",
     "start": "next start -p 9011",
-    "lint": "eslint"
+    "lint": "eslint",
+    "build:dev": "node scripts/build.mjs development",
+    "build:test": "node scripts/build.mjs test"
   },
   "dependencies": {
-    "@pactor-app/core": "^1.20.0",
-    "@pactor-app/runtime": "^1.20.0",
-    "@pactor-app/ui": "^1.20.0",
+    "@pactor-app/core": "^1.22.0",
+    "@pactor-app/runtime": "^1.22.0",
+    "@pactor-app/ui": "^1.22.0",
     "next": "16.3.5",
-    "pactor-app": "^1.20.0",
+    "pactor-app": "^1.22.0",
     "react": "19.2.8",
-    "react-dom": "19.2.8"
+    "react-dom": "19.2.8",
+    "yaml": "^2.9.1"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",

package/templates/next-app/pnpm-workspace.yaml

@@ -0,0 +1,7 @@
+# 模板独立安装（pnpm install）时批准运行构建脚本的原生依赖：
+# sharp（Next.js 图片优化可选依赖）与 unrs-resolver（eslint-config-next
+# 依赖链上的原生解析器）。显式批准而非 ignoredBuiltDependencies 静默，
+# 避免 strict-dep-builds / CI 环境下报 ERR_PNPM_IGNORED_BUILDS
+onlyBuiltDependencies:
+  - sharp
+  - unrs-resolver

package/templates/next-app/scripts/build.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * 按目标环境打包：
+ *   node scripts/build.mjs <development|test|production>
+ * 对应 package.json 的 build / build:dev / build:test 命令。
+ * 环境经 APP_ENV 注入（构建期由 next.config.js 读取并解析
+ * API_BASE_URLS，结果内联进客户端包，见 src/pactor/config.ts）。
+ * 跨平台：Windows 下经 shell 解析 next.cmd。
+ */
+import { spawn } from 'node:child_process';
+
+const ENVS = ['development', 'test', 'production'];
+const env = process.argv[2];
+
+if (!ENVS.includes(env)) {
+  console.error(`用法: node scripts/build.mjs <${ENVS.join('|')}>`);
+  process.exit(2);
+}
+
+process.env.APP_ENV = env;
+console.log(`\n构建目标环境: ${env}（APP_ENV=${env}）\n`);
+
+const child = spawn('next', ['build'], {
+  stdio: 'inherit',
+  shell: process.platform === 'win32',
+});
+
+child.on('error', (error) => {
+  console.error('启动 next build 失败:', error.message);
+  process.exit(1);
+});
+
+child.on('exit', (code) => {
+  process.exit(code ?? 1);
+});

package/templates/next-app/src/pactor/config.ts

@@ -4,14 +4,17 @@
  * （id / path 冲突后源覆盖前源并告警），app / user / permissions / auth
  * 取第一个源。
  *
- * 外部接口：sources / pageEndpoint 只写相对路径，由 apiBaseUrl 补全为
- * 外部绝对地址；服务端已开通 CORS（cookie 会话见 src/server/cors.ts），
- * 浏览器直连，无需项目内代理。
+ * 外部接口：sources 只写相对路径，由 apiBaseUrl 补全为外部绝对地址；
+ * 服务端已开通 CORS（cookie 会话见 src/server/cors.ts），浏览器直连，
+ * 无需项目内代理。
  */
 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}`;
+/**
+ * 外部接口基准地址（SitemapApp baseUrl）。
+ * 由 next.config.js 的 API_BASE_URLS 按构建环境（APP_ENV：
+ * build / build:dev / build:test → production / development / test）
+ * 解析，经 env 配置内联进客户端包；缺省回退本地开发地址。
+ */
+export const apiBaseUrl =
+  process.env.NEXT_PUBLIC_API_BASE_URL ?? "http://localhost:9011";

package/templates/next-app/src/server/accounts.ts

@@ -17,7 +17,7 @@ export const DEMO_ACCOUNTS: (DemoUser & { password: string })[] = [
     password: "pactor123",
     name: "演示管理员",
     roles: ["admin"],
-    permissions: ["report:view"],
+    permissions: ["report:view", "user:view"],
   },
   {
     id: "u-2",