@dsh-workbench/module-tools 0.3.0 → 0.3.1

package/README.md

@@ -103,9 +103,18 @@ dsh-wb-module design accept   # 用户逐条点头之后，把验收清单打勾
 | `minimal`（默认） | 空壳：卡壳、文案、测试接好了，没有数据源 |
 | `diy` | 一份真能跑的样板：宿主侧一条只读路由真读盘、卡片五态，**三张表也是填好的** |
 
-`init` 会连模板里的 `*.tpl` 一起拷过去、把 `__UNIT__` / `__NAME__` / `__DESC__` 填上、剥掉 `.tpl` 后缀，
+`init` 会连模板里的 `*.tpl` 一起拷过去、按**已知 token 名**逐个盖章
+（`__UNIT__` / `__NAME__` / `__DESC__` / `__SHELL_RANGE__`）、剥掉 `.tpl` 后缀，
 再用 `design.json` 生成 README 那一段。
 
+- `__UNIT__` / `__NAME__` / `__DESC__`：单元 id / 包名 / 一句描述。
+- `__SHELL_RANGE__`：模板里那三处 `@dsh-workbench/*` 声明的**范围**（peer 与 devDependency 用同一个值，
+  否则 `check:kit` 的"peer 下限不许比 devDependency 旧"当场红）。取 **init 所在工程里实装的那份**
+  `@dsh-workbench/core` 的版本（`node_modules/@dsh-workbench/core/package.json`）；读不到就退回
+  `module-tools` 自己的版本（同一次发布同版本）；两者都读不到才保持 `^0.1.0`，并在 stderr 上说一句。
+- 按 token 名盖章而不是按 `__[A-Z]+__` 的形状：名字里带下划线的 `__SHELL_RANGE__` 也要认，
+  DIY 模板 README 里真写着的 `workbench___UNIT___rebuild` 则仍只认内层那一个。
+
 ## 自己的自检
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/module-tools",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "模块包的构建与门禁工具：build（单文件 ESM 宿主侧 + 套 loader 壳的浏览器侧）、check（契约/产物边界/源码边界/卡片渲染）。模块包不再各带一份构建脚本。",
   "license": "MIT",
   "type": "module",
@@ -21,7 +21,7 @@
   },
   "dependencies": {
     "esbuild": "^0.28.2",
-    "@dsh-workbench/shared": "0.3.0"
+    "@dsh-workbench/shared": "0.3.1"
   },
   "scripts": {
     "selfcheck": "node scripts/selfcheck.mjs"

package/src/init.mjs

@@ -9,6 +9,33 @@ const TEMPLATES = {
 };
 const UNIT_ID = /^[a-z][a-z0-9-]*$/;
 
+// 模板里那三处 `@dsh-workbench/*` 声明的不是"某个死数"，而是**盖章那一刻的工具链范围**：
+// 优先 init 所在工程里实际装着的那份外壳（用户手上真正会跑的那个版本），退回 module-tools
+// 自己的版本（同一次发布同版本，`^0.3.0` 这类范围对得上），两者都读不到时保持旧模板的
+// `^0.1.0` 并说一句人话 —— 静默盖个空范围会让生成的 package.json 声明一个谁也不认的依赖。
+// 为什么两个 token 共用一个值：`check:kit` 的口径是 peer 下限不许低于 devDependency 下限。
+const FALLBACK_RANGE = '^0.1.0';
+
+const versionIn = (file) => {
+  try {
+    const version = JSON.parse(readFileSync(file, 'utf8')).version;
+    return typeof version === 'string' && version !== '' ? version : undefined;
+  } catch {
+    return undefined;
+  }
+};
+
+const shellRange = (root) => {
+  const installed = versionIn(join(root, 'node_modules/@dsh-workbench/core/package.json'));
+  if (installed !== undefined) return `^${installed}`;
+  const own = versionIn(fileURLToPath(new URL('../package.json', import.meta.url)));
+  if (own !== undefined) return `^${own}`;
+  console.error(
+    `读不到 @dsh-workbench/core 与 module-tools 的版本：模板里那三处 @dsh-workbench/* 保持 ${FALLBACK_RANGE}（与以前一样）；在装好依赖的工程里 init 就能盖上当下范围`,
+  );
+  return FALLBACK_RANGE;
+};
+
 export async function init({ root, args = [] }) {
   const unit = args[0];
   if (unit === undefined || !UNIT_ID.test(unit)) {
@@ -36,8 +63,13 @@ export async function init({ root, args = [] }) {
     __UNIT__: unit,
     __NAME__: `@dsh-workbench/module-${unit}`,
     __DESC__: description,
+    __SHELL_RANGE__: shellRange(root),
   };
-  const fill = (text) => text.replace(/__[A-Z]+__/g, (token) => tokens[token] ?? token);
+  // 按**已知 token 名**逐个盖章，而不是按 `__[A-Z]+__` 的形状：名字里带下划线的 token
+  // （`__SHELL_RANGE__`）也要认；同时 DIY 模板 README 里真写着的 `workbench___UNIT___rebuild`
+  // 仍然只认内层那一个（按形状宽匹配会把三重下划线整段吞掉，工具名就盖不成 `workbench_demo_rebuild`）。
+  const fill = (text) =>
+    text.replace(new RegExp(Object.keys(tokens).join('|'), 'g'), (token) => tokens[token]);
   const templateDir = fileURLToPath(new URL(template, import.meta.url));
   if (!existsSync(templateDir)) {
     console.error(`模板 ${which} 的目录不在：${templateDir}`);

package/template/package.json.tpl

@@ -32,11 +32,11 @@
     },
     "workbenchFaces": { "host": "src/host.ts", "client": "src/client.tsx" }
   },
-  "peerDependencies": { "@dsh-workbench/core": "^0.1.0", "react": "*" },
+  "peerDependencies": { "@dsh-workbench/core": "__SHELL_RANGE__", "react": "*" },
   "peerDependenciesMeta": { "react": { "optional": true } },
   "devDependencies": {
-    "@dsh-workbench/core": "^0.1.0",
-    "@dsh-workbench/module-tools": "^0.1.0",
+    "@dsh-workbench/core": "__SHELL_RANGE__",
+    "@dsh-workbench/module-tools": "__SHELL_RANGE__",
     "@types/node": "^24.19.0",
     "@types/react": "^19.3.0",
     "react": "^19.3.0",

package/template-diy/package.json.tpl

@@ -33,11 +33,11 @@
     },
     "workbenchFaces": { "host": "src/host.ts", "client": "src/client.tsx" }
   },
-  "peerDependencies": { "@dsh-workbench/core": "^0.1.0", "react": "*" },
+  "peerDependencies": { "@dsh-workbench/core": "__SHELL_RANGE__", "react": "*" },
   "peerDependenciesMeta": { "react": { "optional": true } },
   "devDependencies": {
-    "@dsh-workbench/core": "^0.1.0",
-    "@dsh-workbench/module-tools": "^0.1.0",
+    "@dsh-workbench/core": "__SHELL_RANGE__",
+    "@dsh-workbench/module-tools": "__SHELL_RANGE__",
     "@types/node": "^24.19.0",
     "@types/react": "^19.3.0",
     "react": "^19.3.0",