create-pactor-app 1.20.0

package/templates/spa/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "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",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "react-router-dom": "^7.18.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vitejs/plugin-react": "^5.0.0",
+    "typescript": "^5",
+    "vite": "^8.2.1"
+  }
+}

package/templates/spa/src/main.tsx

@@ -0,0 +1,12 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+// 默认 UI 为 @pactor-app/ui 内置实现，样式表导入为必需步骤
+import "@pactor-app/ui/styles.css";
+
+import { App } from "./pactor/App";
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/templates/spa/src/pactor/App.tsx

@@ -0,0 +1,27 @@
+import { SitemapApp } from "pactor-app";
+
+import { apiBaseUrl, sitemapSources } from "./config";
+
+/**
+ * 动态页面应用（design/dynamic-page.md）——纯前端 SPA 模式：
+ * 不传 pathname / navigate / query，框架内置浏览器路由
+ * （History API 导航 + popstate 前进后退）。路由解析 / 访问守卫 /
+ * DSL 布局（PageOutlet + SitemapMenu）/ 页面懒加载 / session.context 桥 /
+ * 缺省动作（app.reload / service.call）全部由 @pactor-app/app 内置；
+ * 此处只提供：sitemap 源、baseUrl（相对接口地址补全）与 HTTP 钩子。
+ *
+ * 登录 / 登出是普通 HTTP 调用，由 DSL 中的内置 request 动作直接表达
+ * （见服务端下发的登录页 / 布局 DSL），无需客户端注册服务。
+ * HTTP 钩子用框架默认实现 createHttpHooks：{ code, data, message } 拆包；
+ * 后端包裹协议不同 / 需公共头注入时传 options，需要代理改写时传
+ * proxyPrefix，或自行实现 PactorHttpHooks。
+ */
+
+export function App() {
+  return (
+    <SitemapApp
+      sources={sitemapSources}
+      baseUrl={apiBaseUrl}
+    />
+  );
+}

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

@@ -0,0 +1,18 @@
+/**
+ * 入口配置（design/dynamic-page.md）：开发者在此配置一个或多个
+ * 返回 sitemap 对象的接口 URL。多源时 pages / menus / layouts 按键合并
+ * （id / path 冲突后源覆盖前源并告警），app / user / permissions / auth
+ * 取第一个源。
+ *
+ * 本模板不自带后端：接口复用 next-app-starter 的 mock API
+ * （apiBaseUrl 指向其 dev server，已开通 CORS）。sources / pageEndpoint
+ * 只写相对路径，由 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}`;

package/templates/spa/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "useDefineForClassFields": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "types": ["node"]
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/templates/spa/vite.config.ts

@@ -0,0 +1,14 @@
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    // pactor 依赖经 link: 指向本仓 packages/*，去重避免多份 React 实例
+    dedupe: ["react", "react-dom", "react-router-dom"],
+  },
+  server: {
+    port: 9012,
+    strictPort: true,
+  },
+});