@dsh-workbench/module-tools 0.1.14 → 0.1.16

package/src/checks/cards.mjs

@@ -11,13 +11,15 @@
 // 手法与 packages/workbench/scripts/selfcheck.mjs 里那套一致：产物是
 // `window.__ModuleLoader__.load({id, factory})`，用假的 loader / require 把它拉起来。
 // 覆盖范围跟着 `dsh.workbench` 自述清单走 —— 新模块不用改这里。
+//
+// 形状（十条判据统一）：导出 `title` 与 `run()`，`run()` 返回三态结果；
+// 打印与退出码归 `../check.mjs` 那一层。
 
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { discoverModulePackages } from '../discover.mjs';
 
-
-const modulePackages = () => discoverModulePackages({ root: process.cwd() });
+export const title = '卡片渲染';
 
 // 任何属性都拿得到、任何调用都返回自己的替身 —— 这样「外壳还没给数据」的各种形状
 // 都不会让卡片因为我们**没桩到某个字段**而假红。真红只留给卡片自己的代码。
@@ -163,120 +165,130 @@ function render(node, depth, budget) {
   return count;
 }
 
-const problems = [];
-const rows = [];
+export async function run() {
+  const modulePackages = discoverModulePackages({ root: process.cwd() });
+  const problems = [];
+  const rows = [];
 
-for (const pkg of modulePackages()) {
-  const name = pkg.manifest.name;
-  const clientFile = join(pkg.dir, 'client.js');
-  if (!existsSync(clientFile)) {
-    problems.push(`${name}: 没有 client.js —— 先 build`);
-    continue;
-  }
+  for (const pkg of modulePackages) {
+    const name = pkg.manifest.name;
+    const clientFile = join(pkg.dir, 'client.js');
+    if (!existsSync(clientFile)) {
+      problems.push(`${name}: 没有 client.js —— 先 build`);
+      continue;
+    }
 
-  let face;
-  try {
-    const loaded = loadFace(clientFile);
-    face = loaded.exports;
-  } catch (error) {
-    problems.push(`${name}: 产物加载不起来 —— ${error.message}`);
-    continue;
-  }
+    let face;
+    try {
+      const loaded = loadFace(clientFile);
+      face = loaded.exports;
+    } catch (error) {
+      problems.push(`${name}: 产物加载不起来 —— ${error.message}`);
+      continue;
+    }
 
-  let registered;
-  const ctx = {
-    get: (key) =>
-      key === 'workbenchUnits'
-        ? {
-            registerUnit: (value) => {
-              registered = value;
-              return () => {};
-            },
-          }
-        : undefined,
-    effect: (fn) => {
-      fn();
-      return () => {};
-    },
-    provide: () => {},
-    logger: { info: () => {}, warn: () => {}, error: () => {} },
-  };
-  const apply = face?.apply ?? face?.default?.apply;
-  if (typeof apply !== 'function') {
-    problems.push(`${name}: 产物没有导出 apply（外壳挂不上这个模块）`);
-    continue;
-  }
-  try {
-    apply(ctx);
-  } catch (error) {
-    problems.push(`${name}: apply 抛了 —— ${error.message}`);
-    continue;
-  }
+    let registered;
+    const ctx = {
+      get: (key) =>
+        key === 'workbenchUnits'
+          ? {
+              registerUnit: (value) => {
+                registered = value;
+                return () => {};
+              },
+            }
+          : undefined,
+      effect: (fn) => {
+        fn();
+        return () => {};
+      },
+      provide: () => {},
+      logger: { info: () => {}, warn: () => {}, error: () => {} },
+    };
+    const apply = face?.apply ?? face?.default?.apply;
+    if (typeof apply !== 'function') {
+      problems.push(`${name}: 产物没有导出 apply（外壳挂不上这个模块）`);
+      continue;
+    }
+    try {
+      apply(ctx);
+    } catch (error) {
+      problems.push(`${name}: apply 抛了 —— ${error.message}`);
+      continue;
+    }
 
-  const card = registered?.card;
-  if (typeof card !== 'function') {
-    problems.push(`${name}: apply 之后没登记卡片（registerUnit 没拿到 card）`);
-    continue;
-  }
+    const card = registered?.card;
+    if (typeof card !== 'function') {
+      problems.push(`${name}: apply 之后没登记卡片（registerUnit 没拿到 card）`);
+      continue;
+    }
 
-  const props = {
-    world: { current: {} },
-    t: (key) => key,
-    refreshToken: 0,
-    onRefresh: () => {},
-    onNavigate: () => {},
-    onOpenMarket: () => {},
-    onSummary: () => {},
-  };
+    const props = {
+      world: { current: {} },
+      t: (key) => key,
+      refreshToken: 0,
+      onRefresh: () => {},
+      onNavigate: () => {},
+      onOpenMarket: () => {},
+      onSummary: () => {},
+    };
 
-  let tree;
-  try {
-    tree = card(props);
-  } catch (error) {
-    problems.push(`${name}: 空数据下卡片抛了 —— ${error.message}`);
-    continue;
-  }
+    let tree;
+    try {
+      tree = card(props);
+    } catch (error) {
+      problems.push(`${name}: 空数据下卡片抛了 —— ${error.message}`);
+      continue;
+    }
 
-  if (tree === null || tree === undefined) {
-    problems.push(`${name}: 空数据下卡片返回空（界面上就是一片空白）`);
-    continue;
-  }
+    if (tree === null || tree === undefined) {
+      problems.push(`${name}: 空数据下卡片返回空（界面上就是一片空白）`);
+      continue;
+    }
 
-  const budget = { left: 20000, maxDepth: 0, classNames: new Set(), stubs: new Set() };
-  let count;
-  try {
-    count = render(tree, 0, budget);
-  } catch (error) {
-    const where = (error.stack ?? '').split('\n').slice(1, 4).join(' | ');
-    problems.push(`${name}: 卡片体内的组件抛了 —— ${error.message}\n      ${where}`);
-    continue;
+    const budget = { left: 20000, maxDepth: 0, classNames: new Set(), stubs: new Set() };
+    let count;
+    try {
+      count = render(tree, 0, budget);
+    } catch (error) {
+      const where = (error.stack ?? '').split('\n').slice(1, 4).join(' | ');
+      problems.push(`${name}: 卡片体内的组件抛了 —— ${error.message}\n      ${where}`);
+      continue;
+    }
+    if (count <= 1) {
+      problems.push(`${name}: 卡片只画出一个节点 —— 卡片体没跑（或什么都没画）`);
+      continue;
+    }
+    // 卡片得**套上外壳给的卡壳**：要么用 `kit.components.Card` 这个组件（推荐、也是 hello 现在的做法），
+    // 要么自己写契约类 `wb-card`（`board.css` 里那条，兄弟模块现在还是这么写的）。
+    //
+    // 用户实测（2026-10-09）："我们的 hello module 怎么不是卡片" —— 面板里那块内容既没有底色也没有
+    // 描边，看着就是标题加一段话。原因是卡片函数没套壳：当时用的是 `wb-view`（那是面板列布局），
+    // 更早那份装进 profile 的产物还自己搓过 `wb-hello*`。两种都查得出来：组件走 stub 名，类名走 classNames。
+    const shelled = budget.classNames.has('wb-card') || budget.stubs.has('Card');
+    if (!shelled) {
+      problems.push(
+        `${name}: 卡片没套外壳的卡壳 —— 用 kit.components.Card（推荐），或自己写契约类 wb-card + ` +
+          `wb-cardBody；裸内容在面板里看起来就"不是一张卡片"`,
+      );
+      continue;
+    }
+    rows.push(`${name}: 空数据下画得出 ${count} 个节点（最深 ${budget.maxDepth} 层）`);
   }
-  if (count <= 1) {
-    problems.push(`${name}: 卡片只画出一个节点 —— 卡片体没跑（或什么都没画）`);
-    continue;
+
+  if (problems.length > 0) {
+    return { status: 'fail', notes: [], problems };
   }
-  // 卡片得**套上外壳给的卡壳**：要么用 `kit.components.Card` 这个组件（推荐、也是 hello 现在的做法），
-  // 要么自己写契约类 `wb-card`（`board.css` 里那条，兄弟模块现在还是这么写的）。
-  //
-  // 用户实测（2026-10-09）："我们的 hello module 怎么不是卡片" —— 面板里那块内容既没有底色也没有
-  // 描边，看着就是标题加一段话。原因是卡片函数没套壳：当时用的是 `wb-view`（那是面板列布局），
-  // 更早那份装进 profile 的产物还自己搓过 `wb-hello*`。两种都查得出来：组件走 stub 名，类名走 classNames。
-  const shelled = budget.classNames.has('wb-card') || budget.stubs.has('Card');
-  if (!shelled) {
-    problems.push(
-      `${name}: 卡片没套外壳的卡壳 —— 用 kit.components.Card（推荐），或自己写契约类 wb-card + ` +
-        `wb-cardBody；裸内容在面板里看起来就"不是一张卡片"`,
-    );
-    continue;
+  if (modulePackages.length === 0) {
+    return {
+      status: 'skip',
+      notes: ['没有模块包（没有声明 dsh.workbench 的包）—— 没有卡片可渲染'],
+      problems: [],
+    };
   }
-  rows.push(`${name}: 空数据下画得出 ${count} 个节点（最深 ${budget.maxDepth} 层）`);
-}
-
-if (problems.length > 0) {
-  console.error(`✖ 卡片渲染 ${problems.length} 条不过：`);
-  for (const problem of problems) console.error(`  · ${problem}`);
-  process.exit(1);
+  return {
+    status: 'pass',
+    notes: [`${rows.length} 张卡片在**空数据**下都画得出来（不许抛）`, ...rows],
+    problems: [],
+  };
 }
-
-console.log(`✔ 卡片渲染通过：${rows.length} 张卡片在**空数据**下都画得出来（不许抛）`);
-for (const row of rows) console.log(`  ${row}`);