@oj-module/cli 0.1.14 → 0.1.15

package/devkit/framework-dev.md

@@ -19,7 +19,7 @@
 
 > ⚠️ 那两份 guide 有**已知陈旧处**，以源码为准：
 > dev 端口实际是 **3333**（guide 写的 5173 已过时）；包版本以
-> `packages/*/package.json` 为准（guide 内部 0.1.6 / 0.1.8 不一致，实际 **0.1.8**）。
+> `packages/*/package.json` 为准（guide 内部 0.1.6 / 0.1.8 不一致，实际 **0.1.15**）。
 
 ## §2 两包结构与依赖方向
 
@@ -132,7 +132,7 @@ pnpm test tests/shell                       # 宿主全量
 **一键发布**：`node scripts/publish-packages.mjs`（lockstep 四包校验 → 构建 → 守卫测试 →
 runtime → cli → registry 复核；`--dry-run` 只演练）。下面的手动步骤是它的展开参考。
 
-- 两包**同版本号**（当前 `0.1.8`），后续发版保持 lockstep。
+- 两包**同版本号**（当前 `0.1.15`），后续发版保持 lockstep。
 - **必须 `pnpm publish`**——用 `npm publish` 会漏出 `workspace:*` / `catalog:` 字面量。
 - **顺序：先 `runtime` 后 `cli`**。`runtime` 未公开时，新 `cli` 的精确依赖会悬空，
   消费者直接装不上。

package/devkit/manual.md

@@ -227,11 +227,42 @@ export default defineModule({
 `react-countup`、`ahooks`、`ky`、`clsx`、`tailwind-merge`、`pinyin-pro`。
 查实际矩阵：`pnpm exec ojm info`。
 
+### 2.7 本版本共享依赖钉版（0.1.15 快照）
+
+宿主经 importmap 提供以下单例（模块 `devDependencies` 须对齐，供 `tsc` 用）；完整 66 项矩阵以
+`pnpm exec ojm info` 或 `packages/cli/shell-dist/versions.json`（构建期生成）为准。
+
+| 包 | 钉版 |
+| --- | --- |
+| `react` / `react-dom` | 19.2.8 |
+| `react-router` | 7.18.2 |
+| `@tanstack/react-query` | 5.102.8 |
+| `antd` | 6.6.1 |
+| `@ant-design/icons` | 6.3.2 |
+| `@ant-design/pro-components` | 3.1.12-0 |
+| `i18next` / `react-i18next` | 26.4.0 / 17.0.12 |
+| `zustand` | 5.0.15 |
+| `dayjs` | 1.11.23 |
+| `echarts` / `echarts-for-react` | 6.1.0 / 3.0.6 |
+| `motion` | 12.43.0 |
+| `@dnd-kit/core` | 6.3.1 |
+| `keepalive-for-react` | 5.0.11 |
+| `simplebar-react` | 3.3.2 |
+| `nprogress` | 0.2.0 |
+| `react-countup` | 6.5.3 |
+| `ahooks` | 3.9.7 |
+| `ky` | 2.0.2 |
+| `clsx` / `tailwind-merge` | 2.1.1 / 3.6.0 |
+| `pinyin-pro` | 3.29.3 |
+
+框架包版本：`@oj-module/runtime` / `@oj-module/cli` / `@plane/kit` / `@plane/editor` 均为 `0.1.15`
+（lockstep）；`oj` 二进制最低版本门禁 `MIN_OJ_VERSION = 0.1.50`。
+
 > **`@oj-module/runtime` 到底导出哪些东西？** 权威清单随包发布在
 > `node_modules/@oj-module/runtime/dist/index.d.ts`——直接 Read 它，或在编辑器里
 > 对 `from "@oj-module/runtime"` 用「跳转到定义 / 自动补全」。**别靠猜**：
 > `BasicContent` / `BasicTable` / `AccessControl` / `useAuthStore` / `useUserStore` /
-> `usePreferences` 都在里面（详见 §6.3）。猜不到的常见后果是白白退回 antd 原生
+> `usePreferences` / `useTabsStore` 都在里面（详见 §6.3）。猜不到的常见后果是白白退回 antd 原生
 > `Table` 重新造轮子。
 
 ---
@@ -857,6 +888,29 @@ t("menu.books")         // ❌ 会去 common namespace 找
 | `AccessControl` | 按角色/权限控制按钮可见性 |
 | `window.$message` | 全局 toast（runtime 的 antd-app 注入，模块内直接用，**无需 import**） |
 | `useAuthStore` / `useUserStore` / `usePreferences` | 读 token / 用户 / 偏好 |
+| `useTabsStore` | 页签（`setTableTitle(routePath, title)` / `resetTableTitle(routePath)`） |
+
+**页签标题跟随内容**：页签文案默认取路由 `handle.title`（静态 i18n key），要让它跟随当前文档名等
+**运行期数据**，在页面里把数据拿到后覆盖：
+
+```tsx
+import { useTabsStore } from "@oj-module/runtime";
+
+const setTableTitle = useTabsStore(s => s.setTableTitle);
+const { pathname } = useLocation();
+
+useEffect(() => {
+	if (doc?.name) setTableTitle(pathname, doc.name);
+}, [doc?.name, pathname, setTableTitle]);
+```
+
+三点约束：
+
+1. 路径必须与导航路径**逐字一致**——页签 key 是 `removeTrailingSlash(location.pathname)` 归一后的值；
+2. `setTableTitle` 只改**已打开**的页签，故要在页面渲染后（数据就绪时）调用，不能提前于路由挂载；
+3. 只在页签 key 与内容**一一对应**时这样用（如 `/doc/:id`——一个 id 一个页签）。若同一路径会被
+   复用展示不同内容（列表页/`index` 路由），离开时必须 `resetTableTitle(pathname)`，否则再进来看到
+   上一个内容的标题。
 
 推荐形态（照 `web/src/home/pages/`、`web/src/personal-center/pages/my-profile/` 抄）：
 `BasicContent` 包一层 → 搜索区 + `BasicTable` → 新增/编辑用 antd `Modal` + `Form`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oj-module/cli",
   "type": "module",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "React Antd Admin 模块工程命令行工具（含预构建宿主 shell-dist）",
   "license": "MIT",
   "exports": {
@@ -49,7 +49,7 @@
   ],
   "dependencies": {
     "@faker-js/faker": "^10.4.0",
-    "@oj-module/runtime": "0.1.14",
+    "@oj-module/runtime": "0.1.15",
     "@redocly/cli": "^2.51.0",
     "@tailwindcss/vite": "^4.3.0",
     "esbuild": "^0.28.2",

package/shell-dist/assets/runtime.js

@@ -225,10 +225,10 @@ function getAppInfo() {
 	return {
 		"pkg": {
 			"name": "@oj-module/runtime",
-			"version": "0.1.14",
+			"version": "0.1.15",
 			"license": "MIT"
 		},
-		"lastBuildTime": "2026-10-12 10:52:03"
+		"lastBuildTime": "2026-10-12 19:08:32"
 	};
 }
 var init_get_app_info = __esmMin((() => {}));
@@ -8711,11 +8711,10 @@ function ensureReq() {
 /** ky HTTPError → ContractApiError（错误体为信封时取 code/msg）；契约违例与原错误原样透传 */
 async function toApiError(e) {
 	if (e instanceof ContractApiError) return e;
-	const res = e?.response;
-	if (res instanceof Response) try {
-		const env = await res.clone().json();
-		if (env && typeof env.code === "number") return new ContractApiError(env.code, env.msg ?? res.statusText);
-	} catch {}
+	const err = e;
+	const res = err?.response;
+	const d = err?.data;
+	if (res instanceof Response && d && typeof d.code === "number") return new ContractApiError(d.code, d.msg ?? res.statusText);
 	return e;
 }
 async function fetchAddRoleItem$1(body) {
@@ -27407,6 +27406,7 @@ init_locales();
 init_module_loader();
 init_slots();
 init_auth();
+init_tabs();
 init_user();
 init_get_app_info();
 init_get_redirect_path();
@@ -27416,4 +27416,4 @@ init_ri();
 init_menu_icons();
 init_tree();
 //#endregion
-export { AccessControl, AccessControlRoles, AntdApp, BasicButton, BasicContent, BasicTable, EmbeddedIcon, ErrorBoundary, ExternalIcon, FormAvatarItem, FormTreeItem, Iframe, LayoutCenterIcon, LayoutEffects, LayoutLeftIcon, LayoutRightIcon, MixedNavigationIcon, OutsidePageIcon, PageError, ProfileCardIcon, RiAccountCircleLine, RiContrastFill, RiFullscreenExitLine, RiFullscreenLine, RiMailCheckLine, RiMoonIcon, RiReactjsLine, RiSunIcon, RiUserSettingsLine, ServerErrorIcon, SideNavigationIcon, TopNavigationIcon, TwoColumnNavigationIcon, accessControlCodes, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLogin, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, handleTree, loadAll, mapTree, menuIcons, permissionPrefix, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useUserStore, external_exports as z };
+export { AccessControl, AccessControlRoles, AntdApp, BasicButton, BasicContent, BasicTable, EmbeddedIcon, ErrorBoundary, ExternalIcon, FormAvatarItem, FormTreeItem, Iframe, LayoutCenterIcon, LayoutEffects, LayoutLeftIcon, LayoutRightIcon, MixedNavigationIcon, OutsidePageIcon, PageError, ProfileCardIcon, RiAccountCircleLine, RiContrastFill, RiFullscreenExitLine, RiFullscreenLine, RiMailCheckLine, RiMoonIcon, RiReactjsLine, RiSunIcon, RiUserSettingsLine, ServerErrorIcon, SideNavigationIcon, TopNavigationIcon, TwoColumnNavigationIcon, accessControlCodes, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLogin, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, handleTree, loadAll, mapTree, menuIcons, permissionPrefix, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useTabsStore, useUserStore, external_exports as z };

package/shell-dist/index.html

@@ -5,9 +5,9 @@
 		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
 		<link rel="icon" href="/favicon.ico" />
 		<title>React Antd Admin · Shell</title>
-		<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self' https://modules.cdn.example.com 'wasm-unsafe-eval' 'nonce-ZmMlBNnCqyPnmo1SvWejxA=='; script-src-attr 'none'; connect-src 'self' data: https://modules.cdn.example.com; style-src 'self' https://modules.cdn.example.com 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; frame-src https://ant.design https://react.dev https://condorheroblog.github.io; form-action 'none'; base-uri 'none'; object-src 'none'; upgrade-insecure-requests" />
+		<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self' https://modules.cdn.example.com 'wasm-unsafe-eval' 'nonce-BbpdKqCvQY8/k+rypZmAnw=='; script-src-attr 'none'; connect-src 'self' data: https://modules.cdn.example.com; style-src 'self' https://modules.cdn.example.com 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; frame-src https://ant.design https://react.dev https://condorheroblog.github.io; form-action 'none'; base-uri 'none'; object-src 'none'; upgrade-insecure-requests" />
 
-		<script type="importmap" nonce="ZmMlBNnCqyPnmo1SvWejxA==">{
+		<script type="importmap" nonce="BbpdKqCvQY8/k+rypZmAnw==">{
   "imports": {
     "react": "/assets/react.js",
     "react/jsx-runtime": "/assets/jsx-runtime.js",

package/shell-dist/versions.json

@@ -7,11 +7,11 @@
   "react-router": "7.18.2",
   "react-router/dom": "7.18.2",
   "@tanstack/react-query": "5.102.8",
-  "@oj-module/runtime": "0.1.14",
-  "@oj-module/runtime/contract": "0.1.14",
-  "@oj-module/runtime/contract/errors": "0.1.14",
-  "@plane/kit": "0.1.14",
-  "@plane/editor": "0.1.14",
+  "@oj-module/runtime": "0.1.15",
+  "@oj-module/runtime/contract": "0.1.15",
+  "@oj-module/runtime/contract/errors": "0.1.15",
+  "@plane/kit": "0.1.15",
+  "@plane/editor": "0.1.15",
   "antd": "6.6.1",
   "antd/locale/en_US": "6.6.1",
   "antd/locale/zh_CN": "6.6.1",

package/src/build.ts

@@ -72,6 +72,7 @@ export const permissionPrefix = "permission:button";
 // store
 export const useAuthStore = _fn;
 export const useUserStore = _fn;
+export const useTabsStore = _fn;
 // 图标
 export const menuIcons = _obj;
 export const EmbeddedIcon = _fn;

package/src/contract/emit-client.ts

@@ -286,15 +286,13 @@ ${binding}
 async function toApiError(e: unknown): Promise<unknown> {
 	if (e instanceof ContractApiError)
 		return e;
-	const res = (e as { response?: Response } | null)?.response;
-	if (res instanceof Response) {
-		try {
-			const env = await res.clone().json() as { code?: number, msg?: string } | null;
-			if (env && typeof env.code === "number")
-				return new ContractApiError(env.code, env.msg ?? res.statusText);
-		}
-		catch { /* 非 JSON 错误体——回退原错误 */ }
-	}
+	// ky 2.x 构造 HTTPError 时已用 getReader() 消费掉原 response 体（res.clone().json() 按规范抛 TypeError，
+	// 体方法一律失效），解析好的错误体在公开字段 error.data——故读 error.data，勿改回 clone().json()。
+	const err = e as { data?: { code?: unknown, msg?: string }, response?: Response } | null;
+	const res = err?.response;
+	const d = err?.data;
+	if (res instanceof Response && d && typeof d.code === "number")
+		return new ContractApiError(d.code, d.msg ?? res.statusText);
 	return e;
 }`;
 }

package/templates/web/src/notification/client/api.ts

@@ -54,15 +54,13 @@ function ensureReq(): ScopedRequestLike {
 async function toApiError(e: unknown): Promise<unknown> {
 	if (e instanceof ContractApiError)
 		return e;
-	const res = (e as { response?: Response } | null)?.response;
-	if (res instanceof Response) {
-		try {
-			const env = await res.clone().json() as { code?: number, msg?: string } | null;
-			if (env && typeof env.code === "number")
-				return new ContractApiError(env.code, env.msg ?? res.statusText);
-		}
-		catch { /* 非 JSON 错误体——回退原错误 */ }
-	}
+	// ky 2.x 构造 HTTPError 时已用 getReader() 消费掉原 response 体（res.clone().json() 按规范抛 TypeError，
+	// 体方法一律失效），解析好的错误体在公开字段 error.data——故读 error.data，勿改回 clone().json()。
+	const err = e as { data?: { code?: unknown, msg?: string }, response?: Response } | null;
+	const res = err?.response;
+	const d = err?.data;
+	if (res instanceof Response && d && typeof d.code === "number")
+		return new ContractApiError(d.code, d.msg ?? res.statusText);
 	return e;
 }
 

package/vendor/host-versions.json

@@ -8,11 +8,11 @@
 		"react-router": "7.18.2",
 		"react-router/dom": "7.18.2",
 		"@tanstack/react-query": "5.102.8",
-		"@oj-module/runtime": "0.1.14",
-		"@oj-module/runtime/contract": "0.1.14",
-		"@oj-module/runtime/contract/errors": "0.1.14",
-		"@plane/kit": "0.1.14",
-		"@plane/editor": "0.1.14",
+		"@oj-module/runtime": "0.1.15",
+		"@oj-module/runtime/contract": "0.1.15",
+		"@oj-module/runtime/contract/errors": "0.1.15",
+		"@plane/kit": "0.1.15",
+		"@plane/editor": "0.1.15",
 		"antd": "6.6.1",
 		"antd/locale/en_US": "6.6.1",
 		"antd/locale/zh_CN": "6.6.1",