@dsh-workbench/module-tools 0.1.18 → 0.2.1

package/package.json

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

package/src/checks/cards.mjs

@@ -218,8 +218,25 @@ export async function run() {
     }
 
     const card = registered?.card;
+    // 清单说"没有卡片"（`"card": null`）与产物说"没有卡片"必须是同一件事 —— 两处说法不一致就是
+    // 声明与代码打架：登记了的那张卡没人会画（外壳只认清单），它只会一直烂在产物里。
+    // 这条判据的名字就是它防的事：gitops 当初为了哄旧判据挂了一张"我这张卡片就是说我没有卡片"的占位卡。
+    const declared = pkg.manifest.dsh?.workbench?.card ?? null;
+    const declaresCard =
+      declared !== null && typeof declared.titleKey === 'string' && declared.titleKey !== '';
+    if (!declaresCard) {
+      if (typeof card === 'function') {
+        problems.push(
+          `${name}: 清单写的是 "card": null，产物却登记了一张卡片 —— 两处说法不一致：` +
+            '要么把清单补成一张卡（titleKey + order），要么把这张卡从产物里去掉',
+        );
+        continue;
+      }
+      rows.push(`${name}: 清单写的是 "card": null —— 这个模块没有卡片，产物里也确实没登记（跳过渲染判定）`);
+      continue;
+    }
     if (typeof card !== 'function') {
-      problems.push(`${name}: apply 之后没登记卡片（registerUnit 没拿到 card）`);
+      problems.push(`${name}: 清单写了 card.titleKey，apply 之后却没登记卡片（registerUnit 没拿到 card）`);
       continue;
     }
 
@@ -310,7 +327,11 @@ export async function run() {
   }
   return {
     status: 'pass',
-    notes: [`${rows.length} 张卡片在**空数据**下都画得出来（不许抛）；清单的 card.titleKey 在字典里都有落点`, ...rows],
+    notes: [
+      `${rows.length} 个模块过了卡片这一关：有卡片的都在**空数据**下画得出来（不许抛）、清单的 titleKey 在字典里都有落点；` +
+        '清单写 "card": null 的，产物里也确实没登记卡片（声明与代码同一句话）',
+      ...rows,
+    ],
     problems: [],
   };
 }

package/src/checks/kit.mjs

@@ -81,7 +81,7 @@ function shellKitOf(clientPath) {
     });
   };
   const window = { __ModuleLoader__: { load } };
-  // eslint-disable-next-line no-new-func -- 要的就是"按浏览器加载器那样把这份产物跑一遍"，静态解析会骗人
+  // 要的就是"按浏览器加载器那样把这份产物跑一遍"，静态解析会骗人（no-new-func 在本仓的 eslint 配置里没开）
   new Function('window', readFileSync(clientPath, 'utf8'))(window);
   return exports?.kit ?? {};
 }