create-pactor-app 1.20.0

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

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

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

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

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

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/templates/next-app/src/pactor/App.tsx

@@ -0,0 +1,47 @@
+"use client";
+
+import { usePathname, useRouter, useSearchParams } from "next/navigation";
+import { Suspense } from "react";
+import { SitemapApp } from "pactor-app";
+
+import { apiBaseUrl, sitemapSources } from "./config";
+
+/**
+ * 动态页面应用（design/dynamic-page.md）：框架 SitemapApp + 宿主接线。
+ * 路由解析 / 访问守卫 / DSL 布局（PageOutlet + SitemapMenu）/ 页面加载 /
+ * session.context 桥 / 缺省动作（app.reload / service.call）全部由
+ * @pactor-app/app 内置；此处只提供：sitemap 源、宿主路由
+ * （pathname / navigate）与 HTTP 钩子。
+ *
+ * 登录 / 登出是普通 HTTP 调用，由 DSL 中的内置 request 动作直接表达
+ * （见 src/server/sitemap.ts 下发的登录页 / 布局 DSL），无需客户端注册服务。
+ *
+ * 挂载在 app/layout.tsx（Next layout 跨导航常驻，切换导航只刷新内容区）。
+ *
+ * HTTP 钩子用框架默认实现 createHttpHooks：{ code, data, message } 拆包；
+ * 后端包裹协议不同 / 需公共头注入时传 options，需要代理改写时传
+ * proxyPrefix，或自行实现 PactorHttpHooks。
+ */
+
+export function PactorApp() {
+  return (
+    <Suspense fallback={null}>
+      <PactorAppInner />
+    </Suspense>
+  );
+}
+
+function PactorAppInner() {
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
+  const router = useRouter();
+  return (
+    <SitemapApp
+      sources={sitemapSources}
+      baseUrl={apiBaseUrl}
+      pathname={pathname}
+      query={Object.fromEntries(searchParams.entries())}
+      navigate={(to) => router.push(to)}
+    />
+  );
+}

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

@@ -0,0 +1,17 @@
+/**
+ * 入口配置（design/dynamic-page.md）：开发者在此配置一个或多个
+ * 返回 sitemap 对象的接口 URL。多源时 pages / menus / layouts 按键合并
+ * （id / path 冲突后源覆盖前源并告警），app / user / permissions / auth
+ * 取第一个源。
+ *
+ * 外部接口：sources / pageEndpoint 只写相对路径，由 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}`;

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

@@ -0,0 +1,63 @@
+/**
+ * 演示账号（mock）：真实项目由后端用户体系替换。
+ * 会话经 httpOnly cookie 传递（pactor_demo_session），sitemap 端点据此裁剪内容。
+ */
+export interface DemoUser {
+  id: string;
+  username: string;
+  name: string;
+  roles: string[];
+  permissions: string[];
+}
+
+export const DEMO_ACCOUNTS: (DemoUser & { password: string })[] = [
+  {
+    id: "u-1",
+    username: "admin",
+    password: "pactor123",
+    name: "演示管理员",
+    roles: ["admin"],
+    permissions: ["report:view"],
+  },
+  {
+    id: "u-2",
+    username: "guest",
+    password: "guest123",
+    name: "访客",
+    roles: ["guest"],
+    permissions: [],
+  },
+];
+
+export const SESSION_COOKIE = "pactor_demo_session";
+
+function toDemoUser(account: (typeof DEMO_ACCOUNTS)[number]): DemoUser {
+  return {
+    id: account.id,
+    username: account.username,
+    name: account.name,
+    roles: account.roles,
+    permissions: account.permissions,
+  };
+}
+
+export function findAccount(
+  username: string,
+  password: string,
+): DemoUser | null {
+  const hit = DEMO_ACCOUNTS.find(
+    (a) => a.username === username && a.password === password,
+  );
+  return hit ? toDemoUser(hit) : null;
+}
+
+/** 会话 cookie 值 = username（演示环境明文，生产换成签名 token / session id） */
+export function findUserBySession(
+  cookieValue: string | undefined,
+): DemoUser | null {
+  if (!cookieValue) {
+    return null;
+  }
+  const hit = DEMO_ACCOUNTS.find((a) => a.username === cookieValue);
+  return hit ? toDemoUser(hit) : null;
+}

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

@@ -0,0 +1,34 @@
+import { NextResponse } from "next/server";
+
+/**
+ * CORS（演示环境放开跨源）：真实项目由后端框架 / 网关统一配置。
+ * 会话经 cookie 传递——Allow-Origin 必须回显请求源（带凭据时不能用 *）
+ * 且带 Allow-Credentials；POST JSON 会触发预检（OPTIONS）。
+ */
+export function corsHeaders(request: Request): Record<string, string> {
+  const origin = request.headers.get("origin");
+  return {
+    "access-control-allow-origin": origin ?? "*",
+    "access-control-allow-credentials": "true",
+    "access-control-allow-methods": "GET, POST, OPTIONS",
+    "access-control-allow-headers": "content-type, authorization",
+    vary: "origin",
+  };
+}
+
+export function corsJson(
+  request: Request,
+  data: unknown,
+  init?: ResponseInit,
+): NextResponse {
+  const response = NextResponse.json(data, init);
+  for (const [key, value] of Object.entries(corsHeaders(request))) {
+    response.headers.set(key, value);
+  }
+  return response;
+}
+
+/** 预检响应（路由中 `export const OPTIONS = corsPreflight`） */
+export function corsPreflight(request: Request): Response {
+  return new Response(null, { status: 204, headers: corsHeaders(request) });
+}