@dsh-workbench/module-tools 0.3.10 → 1.0.0-beta.0

package/template-diy/src/host.ts.tpl

@@ -1,5 +1,6 @@
 import { readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
+import type { HostContext, UnitModuleFace, UnitRegistry } from '@dsh-workbench/core/contract';
 import type { OverviewFile, OverviewPayload } from './model/overview';
 
 const UNIT_ID = '__UNIT__';
@@ -43,21 +44,6 @@ function limitOf(search: URLSearchParams): number {
   return Math.min(MAX_LIMIT, Math.max(1, Math.trunc(parsed)));
 }
 
-interface UnitModuleFace {
-  readonly unit: string;
-  mount(): { routes: Record<string, RouteHandler>; registerTools(): Array<() => void> };
-}
-
-interface UnitRegistry {
-  register(face: UnitModuleFace): () => void;
-}
-
-interface HostContext {
-  get<T = unknown>(name: string): T | undefined;
-  effect(effect: () => void | (() => void), label?: string): () => void;
-  logger?: { warn?(message: string): void } | undefined;
-}
-
 const face: UnitModuleFace = {
   unit: UNIT_ID,
   mount: () => ({

package/template-diy/src/messages.ts.tpl

@@ -3,9 +3,9 @@ export const messages = {
     '__UNIT__.cardTitle': '目录概览',
     '__UNIT__.needProject': '先打开一个项目',
     '__UNIT__.loading': '正在读目录…',
-    '__UNIT__.loadingHint': '宿主侧真读盘：文件数 / 目录数 / 总字节 / 最大的几个文件',
+    '__UNIT__.loadingHint': '正在统计文件数、目录数与最大的几个文件',
     '__UNIT__.errorTitle': '读不到这个目录',
-    '__UNIT__.errorHint': '点右上角刷新重试；路径不存在、没权限、不是目录都会走到这里',
+    '__UNIT__.errorHint': '先确认这个目录还在、你也能读它，然后点右上角刷新重试',
     '__UNIT__.empty': '这个目录是空的：没有文件，也没有子目录',
     '__UNIT__.largest': '最大的几个文件',
     '__UNIT__.fileUnit': ' 个文件',
@@ -15,9 +15,9 @@ export const messages = {
     '__UNIT__.cardTitle': 'Directory overview',
     '__UNIT__.needProject': 'Open a project first',
     '__UNIT__.loading': 'Reading the directory…',
-    '__UNIT__.loadingHint': 'The host really reads the disk: files / dirs / bytes / largest files',
+    '__UNIT__.loadingHint': 'Counting files, folders, and the largest files',
     '__UNIT__.errorTitle': 'Cannot read this directory',
-    '__UNIT__.errorHint': 'Hit refresh in the header; a missing path, no permission, or a non-directory lands here',
+    '__UNIT__.errorHint': 'Check that the folder still exists and you can read it, then hit refresh in the header',
     '__UNIT__.empty': 'This directory is empty: no files and no subdirectories',
     '__UNIT__.largest': 'Largest files',
     '__UNIT__.fileUnit': ' files',

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

@@ -131,7 +131,7 @@ describe('宿主侧的只读路由', () => {
     expect(answer.bytes).toBe(160);
     expect(answer.largest.map((file) => file.name)).toEqual(['big.bin', 'mid.log']);
     expect(answer.largest[0]?.bytes).toBe(100);
-    expect(Number.isNaN(Date.parse(answer.largest[0]?.mtime ?? ''))).toBe(false);
+    expect(answer.largest[0]?.mtime).toMatch(/^\d{4}-\d{2}-\d{2}T/);
   });
 
   it('limit 由查询参数管，越界会夹住', async () => {

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

@@ -1,16 +1,3 @@
-/**
- * 浏览器半侧的运行时垫片。
- *
- * dsh 的客户端模块格式是 `window.__ModuleLoader__.load({ id, factory(require) })`，
- * 所以 `require` 不来自模块系统，而是宿主给的作用域。
- */
-
-/**
- * React 19 的 `@types/react` 移除了全局 `JSX` 命名空间，而本工程用的是
- * **经典 JSX 运行时**（`jsxFactory: "h"`）：`react/jsx-runtime` 不在浏览器模块表里，
- * 所以不能切到自动运行时。这里把全局命名空间接到 `React.JSX` 上 —— 这是官方迁移说明
- * 给经典运行时的做法，写完 JSX 就有完整类型，产出仍是 `h(...)`。
- */
 import type * as ReactTypes from 'react';
 
 declare global {
@@ -18,7 +5,7 @@ declare global {
     interface Element extends ReactTypes.JSX.Element {}
     interface ElementClass extends ReactTypes.JSX.ElementClass {}
     interface IntrinsicElements extends ReactTypes.JSX.IntrinsicElements {}
-    /** 有了它，返回 ReactNode 的组件（含 Fragment）才合法 —— React 19 的类型靠这条判断。 */
+
     type ElementType = ReactTypes.JSX.ElementType;
     interface IntrinsicAttributes extends ReactTypes.JSX.IntrinsicAttributes {}
     interface ElementAttributesProperty extends ReactTypes.JSX.ElementAttributesProperty {}

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

@@ -1,13 +1,3 @@
-/**
- * 组件样式（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;