create-pactor-app 1.21.0 → 1.22.0

package/package.json

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

package/templates/next-app/README.md

@@ -57,7 +57,6 @@ const httpHooks = createHttpHooks();
   pathname={pathname}
   query={query}
   navigate={(to) => router.push(to)}
-  pageEndpoint={pageEndpoint}
   httpAdapter={httpHooks}
 />
 ```
@@ -77,8 +76,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 +86,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/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/src/pactor/config.ts

@@ -4,14 +4,11 @@
  * （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}`;

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/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}`;