@dsh-workbench/module-tools 0.3.2 → 0.3.3

package/template-diy/src/plugin.test.ts.tpl

@@ -3,35 +3,23 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { afterAll, describe, expect, it, vi } from 'vitest';
 
-const shell = vi.hoisted(() => ({
-  resource: { phase: 'loading' } as {
-    readonly phase: string;
-    readonly value?: unknown;
-    readonly error?: { readonly code: string; readonly message: string };
-  },
-  readEnabled: undefined as boolean | undefined,
-}));
-
 vi.mock('@dsh-workbench/core/client', () => ({
   kit: {
-    hooks: {
-      useApiResource: (_route: string, _query: unknown, _refreshToken: number, options?: { readonly enabled?: boolean }) => {
-        shell.readEnabled = options?.enabled;
-        return shell.resource;
-      },
-    },
+    hooks: { useApiResource: () => ({ phase: 'loading' }) },
     components: {
       Card: () => null,
       CenteredState: () => null,
       EmptyState: () => null,
       StateBlock: () => null,
       IconPanelScreen: () => null,
+      Rows: () => null,
+      Row: () => null,
     },
   },
 }));
 
 import { apply, inject, name, OVERVIEW_ROUTE, readOverview } from './host';
-import { apply as applyClient, formatBytes, inject as injectClient, overviewStateOf } from './client';
+import { apply as applyClient, inject as injectClient } from './client';
 
 interface HostFace {
   readonly unit: string;
@@ -99,42 +87,11 @@ function overview(search: Record<string, string>): Promise<unknown> {
   return hostFace().mount().routes[OVERVIEW_ROUTE](new URLSearchParams(search));
 }
 
-function textOf(value: unknown, out: string[] = []): string[] {
-  if (typeof value === 'string') {
-    out.push(value);
-    return out;
-  }
-  if (typeof value === 'number') {
-    out.push(String(value));
-    return out;
-  }
-  if (typeof value === 'boolean' || value === null || value === undefined) return out;
-  if (Array.isArray(value)) {
-    for (const one of value) textOf(one, out);
-    return out;
-  }
-  if (typeof value === 'object') {
-    const record = value as Record<string, unknown>;
-    const source = 'type' in record && 'props' in record ? (record.props as Record<string, unknown>) : record;
-    for (const one of Object.values(source)) {
-      if (typeof one !== 'function') textOf(one, out);
-    }
-  }
-  return out;
-}
-
 const scratch = mkdtempSync(join(tmpdir(), 'dsh-wb-diy-'));
 afterAll(() => {
   rmSync(scratch, { recursive: true, force: true });
 });
 
-const cardProps = {
-  world: { current: { workspace: { path: '/tmp/__UNIT__-workspace' } } },
-  refreshToken: 1,
-  onRefresh: () => {},
-  t: (key: string) => key,
-};
-
 describe('__NAME__ 的面', () => {
   it('插件名就是包名', () => {
     expect(name).toBe('__NAME__');
@@ -200,96 +157,3 @@ describe('宿主侧的只读路由', () => {
     expect(readOverview(join(scratch, 'sample'), 5).bytes).toBe(160);
   });
 });
-
-describe('卡片：待机 / 加载 / 就绪 / 就绪但空 / 出错', () => {
-  it('没有选中工作区时不发请求，画待机那一屏', () => {
-    const face = clientFace();
-    shell.resource = { phase: 'idle' };
-    const withoutProject = { ...cardProps, world: { current: { workspace: null } } };
-
-    expect(textOf(face.card(withoutProject)).join(' ')).toContain('__UNIT__.needProject');
-    expect(shell.readEnabled).toBe(false);
-
-    shell.resource = { phase: 'loading' };
-    expect(textOf(face.card(cardProps)).join(' ')).not.toContain('__UNIT__.needProject');
-    expect(shell.readEnabled).toBe(true);
-  });
-
-  it('四态各画得出来', () => {
-    const face = clientFace();
-
-    shell.resource = { phase: 'loading' };
-    expect(textOf(face.card(cardProps)).join(' ')).toContain('__UNIT__.loading');
-
-    shell.resource = { phase: 'error', error: { code: 'internal', message: 'boom' } };
-    expect(textOf(face.card(cardProps)).join(' ')).toContain('internal: boom');
-
-    shell.resource = {
-      phase: 'ready',
-      value: {
-        ok: true,
-        path: '/real/workbench',
-        files: 2,
-        dirs: 1,
-        bytes: 2048,
-        largest: [{ name: 'big.bin', bytes: 2048, mtime: '2026-01-02T03:04:05.000Z' }],
-      },
-    };
-    const ready = textOf(face.card(cardProps)).join(' ');
-    expect(ready).toContain('/real/workbench');
-    expect(ready).toContain('big.bin');
-    expect(ready).toContain('2.0 KB');
-    expect(ready).toContain('__UNIT__.fileUnit');
-    expect(ready).toContain('__UNIT__.largest');
-
-    shell.resource = {
-      phase: 'ready',
-      value: { ok: true, path: '/real/empty', files: 0, dirs: 0, bytes: 0, largest: [] },
-    };
-    expect(textOf(face.card(cardProps)).join(' ')).toContain('__UNIT__.empty');
-  });
-
-  it('刷新中旧数据还在（不退回加载态）', () => {
-    const face = clientFace();
-    shell.resource = {
-      phase: 'loading',
-      value: { ok: true, path: '/real/workbench', files: 1, dirs: 0, bytes: 10, largest: [] },
-    };
-    const text = textOf(face.card(cardProps)).join(' ');
-    expect(text).toContain('/real/workbench');
-    expect(text).not.toContain('__UNIT__.loading');
-  });
-
-});
-
-describe('状态映射', () => {
-  it('phase 与读数一起解出那一屏（待机 / 加载 / 就绪 / 就绪但空 / 出错）', () => {
-    const at = (input: Parameters<typeof overviewStateOf>[0]): string => overviewStateOf(input).kind;
-
-    expect(at({ phase: 'idle', value: undefined, error: undefined })).toBe('idle');
-    expect(at({ phase: 'loading', value: undefined, error: undefined })).toBe('loading');
-    expect(
-      at({
-        phase: 'ready',
-        value: { ok: true, path: '/p', files: 2, dirs: 1, bytes: 10, largest: [] },
-        error: undefined,
-      }),
-    ).toBe('ready');
-    expect(
-      at({
-        phase: 'ready',
-        value: { ok: true, path: '/p', files: 0, dirs: 0, bytes: 0, largest: [] },
-        error: undefined,
-      }),
-    ).toBe('empty');
-    expect(at({ phase: 'error', value: undefined, error: { code: 'internal', message: 'boom' } })).toBe('error');
-  });
-});
-
-describe('格式化', () => {
-  it('字节格式化不炸也不乱', () => {
-    expect(formatBytes(0)).toBe('0 B');
-    expect(formatBytes(2048)).toBe('2.0 KB');
-    expect(formatBytes(3145728)).toBe('3.0 MB');
-  });
-});

package/template-diy/types/styles.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 组件样式（CSS Modules）的类名表。
+ *
+ * 构建时类名会被哈希，`import styles from './X.module.css'` 拿到的是**表**而不是文本
+ * （构建让它进产物里的那份内联样式）；少了这条声明，`styles.xxx` 会被当成 string 的属性，
+ * `pnpm typecheck` 直接红。
+ *
+ * 单独一个文件：`types/globals.d.ts` 里有 import，是模块，里面的 `declare module`
+ * 会变成模块增强而不是环境声明 —— 与外壳 `packages/workbench/types/assets.d.ts` 同一个理由。
+ */
+declare module '*.module.css' {
+  const classes: Record<string, string>;
+  export default classes;
+}