create-pactor-app 1.20.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pactor Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# create-pactor-app
+
+Pactor 应用脚手架：一条命令从内置模板生成业务工程。
+
+## 用法
+
+```bash
+pnpm create pactor-app my-app            # 交互选择模板（非 TTY 默认 next-app）
+pnpm create pactor-app my-app -t next-app  # Next.js 全栈模板（含 mock API）
+pnpm create pactor-app my-app -t spa       # Vite 纯前端模板
+```
+
+等价于运行 npm 包 `create-pactor-app` 的 bin（`npm create` / `pnpm create` 约定）。
+
+生成后：
+
+```bash
+cd my-app
+pnpm install
+pnpm dev
+```
+
+## 模板
+
+- `next-app`：Next.js 全栈动态页面工程，含 mock API（dev 端口 9011）
+- `spa`：Vite + React 纯前端工程（dev 端口 9012）
+
+模板由 `pnpm sync-templates` 从仓库 `starters/` 同步生成，依赖中的 `link:` 会被改写为已发布的 `^<version>`。
+
+## 退出码
+
+- `0` 成功
+- `2` 用法错误 / 目标目录已存在且非空（不覆盖任何内容）

package/dist/cli.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { createInterface } from "readline";
+import { pathToFileURL } from "url";
+
+// src/create.ts
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  statSync,
+  writeFileSync
+} from "fs";
+import { basename, dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+var APP_NAME_PLACEHOLDER = /__APP_NAME__/g;
+var TEMPLATES = [
+  { id: "next-app", label: "Next.js \u5168\u6808\uFF08\u542B mock API\uFF0Cdev \u7AEF\u53E3 9011\uFF09" },
+  { id: "spa", label: "Vite \u7EAF\u524D\u7AEF\uFF08dev \u7AEF\u53E3 9012\uFF09" }
+];
+var DEFAULT_TEMPLATE = "next-app";
+function defaultTemplatesDir(template) {
+  const here = dirname(fileURLToPath(import.meta.url));
+  for (const candidate of [
+    join(here, "../templates", template),
+    join(here, "../../templates", template)
+  ]) {
+    if (existsSync(candidate)) return candidate;
+  }
+  return join(here, "../templates", template);
+}
+function copyTemplate(src, dest, appName) {
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    const from = join(src, entry);
+    const to = join(dest, entry);
+    if (statSync(from).isDirectory()) {
+      copyTemplate(from, to, appName);
+      continue;
+    }
+    const content = readFileSync(from);
+    if (content.includes("__APP_NAME__")) {
+      writeFileSync(
+        to,
+        content.toString("utf8").replace(APP_NAME_PLACEHOLDER, () => appName),
+        "utf8"
+      );
+    } else {
+      writeFileSync(to, content);
+    }
+  }
+}
+function scaffold(target, template, templatesDir = defaultTemplatesDir(template)) {
+  const appName = basename(target);
+  copyTemplate(templatesDir, target, appName);
+  return appName;
+}
+function checkTarget(target, io) {
+  if (!existsSync(target)) return true;
+  if (!statSync(target).isDirectory()) {
+    io.err(`\u76EE\u6807\u5DF2\u5B58\u5728\u4E14\u4E0D\u662F\u76EE\u5F55: ${target}`);
+    return false;
+  }
+  if (readdirSync(target).length > 0) {
+    io.err(`\u76EE\u6807\u76EE\u5F55\u975E\u7A7A\uFF0C\u62D2\u7EDD\u8986\u76D6: ${target}`);
+    return false;
+  }
+  return true;
+}
+function resolveTarget(name) {
+  return resolve(name);
+}
+var DEV_HINTS = {
+  "next-app": "  pnpm dev        # http://localhost:9011",
+  spa: "  pnpm dev        # http://localhost:9012"
+};
+function printNextSteps(io, name, template) {
+  io.out("\u4E0B\u4E00\u6B65:");
+  io.out(`  cd ${name}`);
+  io.out("  pnpm install");
+  io.out(DEV_HINTS[template]);
+}
+
+// src/cli.ts
+var HELP_TEXT = `create-pactor-app \u2014 \u4ECE\u6A21\u677F\u521B\u5EFA Pactor \u5E94\u7528
+
+\u7528\u6CD5: create-pactor-app <name> [-t next-app|spa]
+
+\u53C2\u6570:
+  <name>                \u76EE\u6807\u76EE\u5F55\uFF08\u53EF\u4E3A\u76F8\u5BF9/\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5E94\u7528\u540D\u53D6\u76EE\u5F55\u540D\uFF09
+  -t, --template <id>   \u6A21\u677F\uFF1Anext-app\uFF08Next.js \u5168\u6808\uFF09/ spa\uFF08Vite \u7EAF\u524D\u7AEF\uFF09
+  -h, --help            \u663E\u793A\u5E2E\u52A9
+
+\u672A\u6307\u5B9A -t \u65F6\uFF1A\u4EA4\u4E92\u7EC8\u7AEF\u7F16\u53F7\u9009\u62E9\uFF08\u9ED8\u8BA4 next-app\uFF09\uFF0C\u975E TTY \u76F4\u63A5\u7528 next-app\u3002
+\u9000\u51FA\u7801: 0 \u6210\u529F\uFF1B2 \u7528\u6CD5/\u76EE\u6807\u9519\u8BEF
+`;
+var UsageError = class extends Error {
+};
+function parseArgs(argv) {
+  const result = { help: false };
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (token === "-h" || token === "--help") {
+      result.help = true;
+      continue;
+    }
+    if (token === "-t" || token === "--template") {
+      const value = argv[i + 1];
+      if (value === void 0) throw new UsageError(`\u9009\u9879 ${token} \u7F3A\u5C11\u503C`);
+      result.template = value;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--template=")) {
+      result.template = token.slice("--template=".length);
+      continue;
+    }
+    if (token.startsWith("-")) {
+      throw new UsageError(`\u672A\u77E5\u9009\u9879: ${token}`);
+    }
+    if (result.name !== void 0) {
+      throw new UsageError(`\u591A\u4F59\u53C2\u6570: ${token}\uFF08\u4EC5\u63A5\u53D7\u4E00\u4E2A <name>\uFF09`);
+    }
+    result.name = token;
+  }
+  return result;
+}
+function parseTemplateId(value) {
+  if (TEMPLATES.some((t) => t.id === value)) return value;
+  throw new UsageError(
+    `\u672A\u77E5\u6A21\u677F: ${value}\uFF08\u53EF\u9009: ${TEMPLATES.map((t) => t.id).join(" | ")}\uFF09`
+  );
+}
+async function selectTemplateInteractive(io) {
+  io.out("\u8BF7\u9009\u62E9\u6A21\u677F:");
+  TEMPLATES.forEach((t, index) => io.out(`  ${index + 1}) ${t.id} \u2014 ${t.label}`));
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await new Promise((resolvePromise) => {
+      rl.question(`\u8BF7\u8F93\u5165\u7F16\u53F7 [1]: `, resolvePromise);
+    });
+    const trimmed = answer.trim();
+    if (trimmed === "") return DEFAULT_TEMPLATE;
+    const index = Number.parseInt(trimmed, 10) - 1;
+    const picked = TEMPLATES[index];
+    if (picked === void 0) {
+      throw new UsageError(`\u65E0\u6548\u7F16\u53F7: ${trimmed}`);
+    }
+    return picked.id;
+  } finally {
+    rl.close();
+  }
+}
+async function runCli(argv, io, options = {}) {
+  let args;
+  try {
+    args = parseArgs(argv);
+  } catch (error) {
+    if (error instanceof UsageError) {
+      io.err(`\u53C2\u6570\u9519\u8BEF: ${error.message}`);
+      io.err(HELP_TEXT);
+      return 2;
+    }
+    throw error;
+  }
+  if (args.help) {
+    io.out(HELP_TEXT);
+    return 0;
+  }
+  if (args.name === void 0) {
+    io.err("\u7F3A\u5C11\u53C2\u6570 <name>");
+    io.err(HELP_TEXT);
+    return 2;
+  }
+  let template;
+  try {
+    if (args.template !== void 0) {
+      template = parseTemplateId(args.template);
+    } else if (options.selectTemplate !== void 0) {
+      template = await options.selectTemplate();
+    } else if (process.stdin.isTTY && process.stdout.isTTY) {
+      template = await selectTemplateInteractive(io);
+    } else {
+      template = DEFAULT_TEMPLATE;
+    }
+  } catch (error) {
+    if (error instanceof UsageError) {
+      io.err(error.message);
+      return 2;
+    }
+    throw error;
+  }
+  const target = resolveTarget(args.name);
+  if (!checkTarget(target, io)) return 2;
+  const templatesDir = options.templatesDir ?? defaultTemplatesDir;
+  scaffold(target, template, templatesDir(template));
+  io.out(`\u5DF2\u521B\u5EFA\u5DE5\u7A0B: ${target}`);
+  printNextSteps(io, args.name, template);
+  return 0;
+}
+var isMain = process.argv[1] !== void 0 && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isMain) {
+  const io = {
+    out: (line) => process.stdout.write(`${line}
+`),
+    err: (line) => process.stderr.write(`${line}
+`)
+  };
+  void runCli(process.argv.slice(2), io).then((code) => process.exit(code));
+}
+export {
+  HELP_TEXT,
+  UsageError,
+  parseArgs,
+  parseTemplateId,
+  runCli,
+  selectTemplateInteractive
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "create-pactor-app",
+  "version": "1.20.0",
+  "description": "Create a Pactor app from starter templates (pnpm create pactor-app)",
+  "keywords": [
+    "pactor",
+    "create",
+    "scaffold",
+    "starter",
+    "server-driven-ui"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/426-330/pactor.git",
+    "directory": "packages/create-app"
+  },
+  "homepage": "https://github.com/426-330/pactor/tree/main/packages/create-app",
+  "bugs": "https://github.com/426-330/pactor/issues",
+  "type": "module",
+  "bin": {
+    "create-pactor-app": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "build": "tsup",
+    "sync-templates": "node scripts/sync-templates.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/templates/next-app/README.md

@@ -0,0 +1,112 @@
+# __APP_NAME__
+
+按 `design/dynamic-page.md`（方案 B）实现的动态页面 starter：开发者在入口配置
+一个或多个返回 **sitemap 对象**的接口 URL，应用的页面 url、页面名称、导航结构、
+布局与页面 DSL 全部由该对象驱动。核心能力由框架 `@pactor-app/app` 的
+**`SitemapApp`** 组件内置（路由解析 / 匿名守卫 / DSL 布局 / 页面加载 /
+session 桥），模板只做宿主接线。
+
+## 快速开始
+
+```bash
+pnpm install
+pnpm dev   # http://localhost:9011
+```
+
+演示账号（登录页可见）：
+
+| 账号 | 密码 | 角色差异 |
+| --- | --- | --- |
+| `admin` | `pactor123` | 可见「报表」菜单（`report:view`），月报页懒加载 |
+| `guest` | `guest123` | 仅可见首页 |
+
+匿名访问任意非 public 路径会重定向到 `/login`；登录 / 登出后整页重载，
+sitemap 端点按新会话重新裁剪内容。
+
+## 结构
+
+```
+app/
+  layout.tsx               # PactorApp 挂载点（Next layout 跨导航常驻：
+                           # 切换导航只刷新内容区，sitemap 不重复拉取）
+  [[...slug]]/page.tsx     # 可选 catch-all：匹配全部站内路径，渲染为空
+  api/
+    sitemap/route.ts       # sitemap 端点（会话感知：匿名 / 角色裁剪）
+    pages/[id]/route.ts    # 懒加载页面端点（PageResource envelope，接口侧鉴权）
+    auth/login/route.ts    # 演示登录（写会话 cookie）
+    auth/logout/route.ts   # 演示登出（清 cookie）
+src/
+  pactor/
+    config.ts              # ★ 入口配置：sitemapSources 接口 URL 列表
+    App.tsx                # 薄壳：框架 SitemapApp + 宿主路由（pathname / navigate）
+  server/
+    accounts.ts            # 演示账号与会话 cookie
+    cors.ts                # CORS 头（演示放开跨源，含预检响应）
+    sitemap.ts             # mock sitemap 数据源（layouts / pages / menus 按角色裁剪；
+                           # 登录 / 登出在 DSL 中用内置 request 动作表达）
+```
+
+`App.tsx` 全部内容即：
+
+```tsx
+const httpHooks = createHttpHooks();
+
+<SitemapApp
+  sources={sitemapSources}
+  baseUrl={apiBaseUrl}
+  pathname={pathname}
+  query={query}
+  navigate={(to) => router.push(to)}
+  pageEndpoint={pageEndpoint}
+  httpAdapter={httpHooks}
+/>
+```
+
+> 依赖说明：`SitemapApp` 于 `@pactor-app/app` v1.19.0 引入。本模板开发期间
+> pactor 依赖经 `link:../../packages/*` 指向本仓；`v1.19.0` 发布到 npm 后
+> 改回 `^1.19.0` 版本号即可独立使用。
+
+## 接入真实后端
+
+1. 把 `src/pactor/config.ts` 的 `sitemapSources` 改成你的接口 URL（可多个，
+   冲突后源覆盖前源；相对路径由 `apiBaseUrl` 补全，见「跨域与 HTTP 钩子」）。
+2. 服务端按 `SitemapResource`（自 `pactor-app` 导入类型）返回 JSON：
+   - `layouts`：DSL 布局（`PageOutlet` 为页面出口，`SitemapMenu` 渲染导航，
+     `${data.session.*}` 读会话数据）
+   - `pages`：页面定义（`pageDsl` 内联或缺省，`version` 参与缓存键 `id@version`）
+   - `menus`：导航 / 路由树（`pageId` 引用页面、`layout` 引用布局、
+     `public` 免登录；`path` / `title` 缺省从引用页面继承）
+   - `auth.loginPath`：未登录重定向目标
+3. 懒加载页：实现 `GET {pageEndpoint}/{id}` 返回 PageResource envelope
+   （缺省 `/api/pages/{id}`，可在 `config.ts` 调整）。
+4. 登录 / 登出等接口调用直接在 DSL 中用内置 `request` 动作表达（参考
+   `src/server/sitemap.ts` 的登录页 / 布局 DSL，URL 指向你的真实接口）；
+   有客户端服务层时可用内置 `service.call` 动作桥接，`session.context`
+   会话桥由框架内置，均无需自行注册。
+
+## 跨域与 HTTP 钩子
+
+模板的外部接口以 `apiBaseUrl`（`src/pactor/config.ts`，缺省
+`http://localhost:9011`）为基准：`sitemapSources` / `pageEndpoint`
+只写相对路径，由 `SitemapApp` 的 `baseUrl` 补全为外部绝对地址。
+**假定服务端已开通 CORS，浏览器直连，无需项目内代理**——本模板的
+mock API 已在路由层放开跨源（`src/server/cors.ts`：Allow-Origin 回显
+请求源 + Allow-Credentials，POST 预检经 `OPTIONS` 响应；cookie 会话
+跨源可达，框架 fetch 均带 `credentials: 'include'`）。
+
+**HTTP 钩子**（框架默认实现 `createHttpHooks`，`src/pactor/App.tsx`）：
+接入框架的全部 HTTP 出口（sitemap 源、页面懒加载端点、DSL `request`
+动作、http 类型 dataSource、动态 DSL 引用）——
+- `request`：缺省不改写地址（CORS 直连）；服务端不开 CORS 时传
+  `proxyPrefix`，把跨域地址改写到项目内代理前缀（需自行配置
+  Next rewrites / nginx 转发）；可注入公共头（Authorization 等）
+- `response`：`{ code, data, message }` 包裹结构拆包为 `data`，业务错误码
+  抛错（DSL 动作按失败处理）；后端包裹协议不同传 `envelope: false`
+  或自行实现 `PactorHttpHooks`
+
+## 与设计文档的差异
+
+`design/dynamic-page.md` 的目标态是布局 / 页面 DSL 直接读 `${user}` /
+`${app}` / `${menus}` 作用域（框架尚未原生开放）。当前由 `SitemapApp` 内置的
+`session.context` 服务桥接，DSL 中写作 `${data.session.user.name}`、
+`${data.session.menus}`；框架支持原生作用域后可平滑迁回。

package/templates/next-app/app/[[...slug]]/page.tsx

@@ -0,0 +1,7 @@
+/**
+ * 可选 catch-all：匹配全部站内路径，但渲染为空——应用本体挂在
+ * app/layout.tsx 的 PactorApp（layout 跨导航常驻，page 会被重挂载）。
+ */
+export default function CatchAllPage() {
+  return null;
+}

package/templates/next-app/app/api/auth/login/route.ts

@@ -0,0 +1,32 @@
+import { NextResponse } from "next/server";
+
+import { findAccount, SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+
+/** 演示登录：校验账号 → 写会话 cookie → 返回用户信息 */
+export async function POST(request: Request) {
+  const body = (await request.json().catch(() => ({}))) as {
+    username?: string;
+    password?: string;
+  };
+  const user = findAccount(body.username ?? "", body.password ?? "");
+  if (!user) {
+    return Response.json(
+      { error: "用户名或密码错误" },
+      { status: 401, headers: corsHeaders(request) },
+    );
+  }
+  const response = NextResponse.json(
+    { token: `demo-${user.id}`, user },
+    { headers: corsHeaders(request) },
+  );
+  response.cookies.set(SESSION_COOKIE, user.username, {
+    httpOnly: true,
+    sameSite: "lax",
+    path: "/",
+  });
+  return response;
+}
+
+/** 预检（跨源 POST JSON） */
+export const OPTIONS = corsPreflight;

package/templates/next-app/app/api/auth/logout/route.ts

@@ -0,0 +1,22 @@
+import { NextResponse } from "next/server";
+
+import { SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+
+/** 演示登出：清会话 cookie */
+export async function POST(request: Request) {
+  const response = NextResponse.json(
+    { ok: true },
+    { headers: corsHeaders(request) },
+  );
+  response.cookies.set(SESSION_COOKIE, "", {
+    httpOnly: true,
+    sameSite: "lax",
+    path: "/",
+    maxAge: 0,
+  });
+  return response;
+}
+
+/** 预检（跨源 POST JSON） */
+export const OPTIONS = corsPreflight;

package/templates/next-app/app/api/pages/[id]/route.ts

@@ -0,0 +1,40 @@
+import { cookies } from "next/headers";
+
+import { findUserBySession, SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+import { getLazyPage } from "@/server/sitemap";
+
+/**
+ * 懒加载页面端点：sitemap 中未内联 pageDsl 的页面按需获取。
+ * 返回 PageResource envelope（id / version / dslVersion / schema），
+ * 接口侧鉴权——前端隐藏菜单不等于安全。
+ */
+export async function GET(
+  request: Request,
+  context: RouteContext<"/api/pages/[id]">,
+) {
+  const { id } = await context.params;
+  const store = await cookies();
+  const user = findUserBySession(store.get(SESSION_COOKIE)?.value);
+  const entry = getLazyPage(id, user);
+  if (!entry) {
+    return Response.json(
+      { error: "页面不存在或无权限" },
+      { status: 404, headers: corsHeaders(request) },
+    );
+  }
+  return Response.json(
+    {
+      id,
+      resourceType: "page",
+      version: entry.version,
+      dslVersion: "1.0",
+      schema: entry.pageDsl,
+      updatedAt: new Date().toISOString(),
+    },
+    { headers: { "cache-control": "no-store", ...corsHeaders(request) } },
+  );
+}
+
+/** 预检（跨源带凭据 / 自定义头时） */
+export const OPTIONS = corsPreflight;

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

@@ -0,0 +1,21 @@
+import { cookies } from "next/headers";
+
+import { findUserBySession, SESSION_COOKIE } from "@/server/accounts";
+import { corsPreflight, corsHeaders } from "@/server/cors";
+import { buildSitemap } from "@/server/sitemap";
+
+/**
+ * Sitemap 端点（design/dynamic-page.md）：
+ * 会话感知——同一 URL，匿名与不同角色拿到不同 sitemap。
+ * 入口可配置多个此类 URL（src/pactor/config.ts 的 sources）。
+ */
+export async function GET(request: Request) {
+  const store = await cookies();
+  const user = findUserBySession(store.get(SESSION_COOKIE)?.value);
+  return Response.json(buildSitemap(user), {
+    headers: { "cache-control": "no-store", ...corsHeaders(request) },
+  });
+}
+
+/** 预检（跨源带凭据 / 自定义头时） */
+export const OPTIONS = corsPreflight;

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

@@ -0,0 +1,12 @@
+@import "tailwindcss";
+
+@theme inline {
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+body {
+  margin: 0;
+  background: var(--background, #ffffff);
+  color: var(--foreground, #171717);
+}

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

@@ -0,0 +1,28 @@
+import type { Metadata } from "next";
+import { PactorApp } from "@/pactor/App";
+import "@pactor-app/ui/styles.css";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "Pactor 动态页面 Starter",
+  description: "Sitemap 驱动的动态页面应用模板（design/dynamic-page.md）",
+};
+
+export default function RootLayout({ children }: LayoutProps<"/">) {
+  return (
+    <html
+      lang="zh-CN"
+      className={`h-full antialiased`}
+    >
+      <body className="min-h-full flex flex-col">
+        {/*
+         * PactorApp 挂在 Next layout 而非 page：App Router 导航时 page 会
+         * 重挂载、layout 常驻——sitemap 只拉取一次，切换导航只刷新内容区。
+         * children（page）恒为 null，路由由 PactorApp 内部按 sitemap 解析。
+         */}
+        <PactorApp />
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates/next-app/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/templates/next-app/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev -p 9011",
+    "build": "next build",
+    "start": "next start -p 9011",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "@pactor-app/core": "^1.20.0",
+    "@pactor-app/runtime": "^1.20.0",
+    "@pactor-app/ui": "^1.20.0",
+    "next": "16.3.5",
+    "pactor-app": "^1.20.0",
+    "react": "19.2.8",
+    "react-dom": "19.2.8"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.3.5",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

package/templates/next-app/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/templates/next-app/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/templates/next-app/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>