@dsh-workbench/shared 0.3.11 → 1.0.0-beta.1

package/dist/lib/react.d.ts

@@ -1,54 +1,14 @@
 import type * as ReactTypes from 'react';
-/**
- * React 的 `createElement` 换个短名字再导出 —— 这套代码用 `h(...)` 写元素。
- */
 export declare const h: typeof ReactTypes.createElement;
-/**
- * React 的 `Fragment` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const Fragment: ReactTypes.ExoticComponent<ReactTypes.FragmentProps>;
-/**
- * React 的 `Component` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const Component: typeof ReactTypes.Component;
-/**
- * React 的 `createContext` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const createContext: typeof ReactTypes.createContext;
-/**
- * React 的 `useContext` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useContext: typeof ReactTypes.useContext;
-/**
- * React 的 `useState` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useState: typeof ReactTypes.useState;
-/**
- * React 的 `useEffect` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useEffect: typeof ReactTypes.useEffect;
-/**
- * React 的 `useLayoutEffect` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useLayoutEffect: typeof ReactTypes.useLayoutEffect;
-/**
- * React 的 `useMemo` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useMemo: typeof ReactTypes.useMemo;
-/**
- * React 的 `useCallback` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useCallback: typeof ReactTypes.useCallback;
-/**
- * React 的 `useRef` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useRef: typeof ReactTypes.useRef;
-/**
- * React 的 `useSyncExternalStore` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export declare const useSyncExternalStore: typeof ReactTypes.useSyncExternalStore;
-/**
- * 借来的三个类型从 `react-types.ts` 转一手：那份是**公开面**（模块 `import type` 从根入口拿），
- * 组件内部照旧从这里引，别在两处各写一遍名字。
- */
 export type { ReactNode, CSSProperties, ChangeEvent } from './react-types.js';

package/dist/lib/react.js

@@ -1,49 +1,13 @@
 const react = require('react');
-/**
- * React 的 `createElement` 换个短名字再导出 —— 这套代码用 `h(...)` 写元素。
- */
 export const h = react.createElement;
-/**
- * React 的 `Fragment` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const Fragment = react.Fragment;
-/**
- * React 的 `Component` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const Component = react.Component;
-/**
- * React 的 `createContext` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const createContext = react.createContext;
-/**
- * React 的 `useContext` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useContext = react.useContext;
-/**
- * React 的 `useState` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useState = react.useState;
-/**
- * React 的 `useEffect` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useEffect = react.useEffect;
-/**
- * React 的 `useLayoutEffect` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useLayoutEffect = react.useLayoutEffect;
-/**
- * React 的 `useMemo` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useMemo = react.useMemo;
-/**
- * React 的 `useCallback` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useCallback = react.useCallback;
-/**
- * React 的 `useRef` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useRef = react.useRef;
-/**
- * React 的 `useSyncExternalStore` 原样再导出 —— 共享包的哑组件用它；模块写 JSX 一律直接 import react（这一份不进公开入口）。
- */
 export const useSyncExternalStore = react.useSyncExternalStore;

package/dist/lib/ui.js

@@ -1,3 +1,4 @@
+import dayjs from 'dayjs';
 /**
  * 拼类名：只留真值、用空格连接（`false` / `null` / `undefined` / 空串都丢掉）。
  * @param parts - 若干类名或条件值。
@@ -79,14 +80,7 @@ export function relativeTime(epochMs, t) {
         return t('time.hours', { n: Math.floor(diff / (60 * MINUTE)) });
     if (diff < 7 * 24 * 60 * MINUTE)
         return t('time.days', { n: Math.floor(diff / (24 * 60 * MINUTE)) });
-    return new Date(epochMs).toLocaleString(undefined, {
-        year: 'numeric',
-        month: 'numeric',
-        day: 'numeric',
-        hour: '2-digit',
-        minute: '2-digit',
-        second: '2-digit',
-    });
+    return dayjs(epochMs).format('YYYY/M/D HH:mm:ss');
 }
 /**
  * 把 `/Users/<用户名>/…` 缩成 `~/…`，免得会话行里全是一样的长前缀。
@@ -109,5 +103,5 @@ export function parseLocalTimestamp(text) {
     const raw = String(text ?? '').trim();
     if (!LOCAL_TIMESTAMP.test(raw))
         return Number.NaN;
-    return new Date(raw.replace(' ', 'T')).getTime();
+    return dayjs(raw.replace(' ', 'T')).valueOf();
 }

package/dist/lib/version.d.ts

@@ -0,0 +1,4 @@
+export declare function isValidVersion(value: string): boolean;
+export declare function isPrereleaseVersion(value: string): boolean;
+export declare function compareVersions(left: string, right: string): number | undefined;
+export declare function isNewerVersion(latest: string, installed: string): boolean;

package/dist/lib/version.js

@@ -0,0 +1,21 @@
+import semver from 'semver';
+export function isValidVersion(value) {
+    return semver.valid(value.trim()) !== null;
+}
+export function isPrereleaseVersion(value) {
+    const parsed = semver.valid(value.trim());
+    return parsed !== null && semver.prerelease(parsed) !== null;
+}
+export function compareVersions(left, right) {
+    const a = semver.valid(left.trim());
+    const b = semver.valid(right.trim());
+    if (a === null || b === null)
+        return undefined;
+    return semver.compare(a, b);
+}
+export function isNewerVersion(latest, installed) {
+    if (latest === installed)
+        return false;
+    const compared = compareVersions(latest, installed);
+    return compared === undefined ? true : compared > 0;
+}

package/dist/testing/data.d.ts

@@ -0,0 +1,13 @@
+import type { CallOverrides, DataReader, DataRequest, RecipeCalls, RequestRecipe } from '../contract/data.js';
+export interface RecipeCall {
+    readonly kind: 'request' | 'submit' | 'many';
+    readonly recipe: RequestRecipe;
+    readonly overrides?: CallOverrides | undefined;
+    readonly calls?: RecipeCalls | undefined;
+}
+export declare function createNoopDataReader(): DataReader;
+export declare function createFakeDataReader(reply?: unknown | ((request: DataRequest, index: number) => unknown), recipeReply?: unknown | ((call: RecipeCall, index: number) => unknown)): DataReader & {
+    readonly requests: readonly DataRequest[];
+    readonly calls: readonly RecipeCall[];
+};
+export declare const fakeDataReader: typeof createFakeDataReader;

package/dist/testing/data.js

@@ -0,0 +1,46 @@
+const NO_DATA = {
+    ok: false,
+    error: { code: 'invalid-request', message: '测试没有注入 DataReader' },
+};
+function filled(names, value) {
+    const out = {};
+    for (const name of names)
+        out[name] = value;
+    return out;
+}
+export function createNoopDataReader() {
+    return {
+        read: async () => NO_DATA,
+        request: async () => NO_DATA,
+        requestMany: async (_recipe, calls) => filled(Object.keys(calls), NO_DATA),
+        submit: async () => NO_DATA,
+    };
+}
+export function createFakeDataReader(reply = { ok: true, data: null }, recipeReply = { ok: true, data: null }) {
+    const requests = [];
+    const calls = [];
+    const answer = (call) => typeof recipeReply === 'function' ? recipeReply(call, calls.length - 1) : recipeReply;
+    const reader = {
+        async read(request) {
+            requests.push(request);
+            return typeof reply === 'function' ? reply(request, requests.length - 1) : reply;
+        },
+        async request(recipe, overrides) {
+            calls.push({ kind: 'request', recipe, overrides });
+            return answer(calls[calls.length - 1]);
+        },
+        async requestMany(recipe, plan) {
+            calls.push({ kind: 'many', recipe, calls: plan });
+            const answered = answer(calls[calls.length - 1]);
+            return typeof answered === 'object' && answered !== null && !('ok' in answered)
+                ? answered
+                : filled(Object.keys(plan), answered);
+        },
+        async submit(recipe, overrides) {
+            calls.push({ kind: 'submit', recipe, overrides });
+            return answer(calls[calls.length - 1]);
+        },
+    };
+    return Object.assign(reader, { requests, calls });
+}
+export const fakeDataReader = createFakeDataReader;

package/dist/testing/declaration.d.ts

@@ -1,2 +1,2 @@
-import type { UnitManifest } from '../api/unit.js';
+import type { UnitManifest } from '../contract/unit.js';
 export declare function declarationOfPackage(pkg: string, packageJson: URL | string): UnitManifest;

package/dist/testing/declaration.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { readDeclaration } from '../host/unit-declaration.js';
+import { readDeclaration } from '../contract/unit-declaration.js';
 export function declarationOfPackage(pkg, packageJson) {
     const at = typeof packageJson === 'string' ? packageJson : fileURLToPath(packageJson);
     let parsed;

package/dist/testing/host-fakes.d.ts

@@ -1,5 +1,4 @@
 import type { DshShell } from '../api/dsh.js';
-import type { Opencli } from '../host/opencli.js';
 export interface ShellCall {
     command: string;
     workdir?: string;
@@ -21,18 +20,6 @@ export declare function createFakeShell(replies?: ShellReply[] | ((call: ShellCa
     peak: () => number;
     commands: () => string[];
 };
-export interface OpencliCall {
-    args: readonly string[];
-    key?: string;
-    workdir?: string;
-    session?: string;
-    refresh?: boolean;
-}
-export declare function createFakeOpencli(replies?: Array<unknown | Error> | ((call: OpencliCall, index: number) => unknown | Error)): {
-    opencli: Opencli;
-    calls: OpencliCall[];
-    keys: () => (string | undefined)[];
-};
 export declare function createFakeLogger(): {
     logger: {
         info: () => void;

package/dist/testing/host-fakes.js

@@ -39,30 +39,6 @@ export function createFakeShell(replies = []) {
         commands: () => calls.map((call) => call.command),
     };
 }
-export function createFakeOpencli(replies = []) {
-    const calls = [];
-    const opencli = {
-        async json(args, options = {}) {
-            const call = {
-                args,
-                ...(options.key === undefined ? {} : { key: options.key }),
-                ...(options.workdir === undefined ? {} : { workdir: options.workdir }),
-                ...(options.session === undefined ? {} : { session: options.session }),
-            };
-            calls.push(call);
-            const index = calls.length - 1;
-            const reply = typeof replies === 'function' ? replies(call, index) : (replies[index] ?? []);
-            if (reply instanceof Error)
-                throw reply;
-            return { value: reply, at: Date.now() };
-        },
-    };
-    return {
-        opencli,
-        calls,
-        keys: () => calls.map((call) => call.key),
-    };
-}
 export function createFakeLogger() {
     const warnings = [];
     return {

package/dist/testing/needs.d.ts

@@ -0,0 +1,16 @@
+import type { BinNeed, EnvNeed, ExtensionNeed, LibNeed, Need, SupplySource } from '../contract/needs.js';
+import type { NeedState } from '../contract/unit-capability.js';
+import type { UnitCapability } from '../contract/unit-capability.js';
+import type { UnitManifest } from '../contract/unit.js';
+export declare const fakeNpmSource: SupplySource;
+export declare function extensionNeedOf(name: string, extra?: Partial<ExtensionNeed>): ExtensionNeed;
+export declare function libNeedOf(name: string, extra?: Partial<LibNeed>): LibNeed;
+export declare function binNeedOf(name: string, extra?: Partial<BinNeed>): BinNeed;
+export declare function envNeedOf(name: string, extra?: Partial<EnvNeed>): EnvNeed;
+export declare function manifestOf(options?: {
+    readonly id?: string | undefined;
+    readonly needs?: readonly Need[] | undefined;
+    readonly card?: UnitManifest['card'];
+}): UnitManifest;
+export declare function needStateOf(need: Need, status?: NeedState['status'], extra?: Partial<NeedState>): NeedState;
+export declare function capabilityOf(unit: string, needs?: readonly NeedState[], extra?: Partial<UnitCapability>): UnitCapability;

package/dist/testing/needs.js

@@ -0,0 +1,46 @@
+export const fakeNpmSource = {
+    kind: 'npm',
+    registryEnv: 'WB_TEST_REGISTRY',
+    registryDefault: 'https://registry.invalid/',
+};
+export function extensionNeedOf(name, extra = {}) {
+    return {
+        kind: 'extension',
+        runtime: 'opencli',
+        name,
+        commands: [`${name}-read`],
+        purpose: '测试',
+        ...extra,
+    };
+}
+export function libNeedOf(name, extra = {}) {
+    return { kind: 'lib', name, purpose: '测试', ...extra };
+}
+export function binNeedOf(name, extra = {}) {
+    return { kind: 'bin', name, purpose: '测试', ...extra };
+}
+export function envNeedOf(name, extra = {}) {
+    return { kind: 'env', name, purpose: '测试', ...extra };
+}
+export function manifestOf(options = {}) {
+    return {
+        id: options.id ?? 'fixture',
+        card: options.card === undefined ? { titleKey: `${options.id ?? 'fixture'}.mine`, order: 10 } : options.card,
+        tools: [],
+        host: { inject: [] },
+        ...(options.needs === undefined ? {} : { needs: options.needs }),
+    };
+}
+export function needStateOf(need, status = 'ok', extra = {}) {
+    return {
+        id: need.id ?? `${need.kind}:${need.name}`,
+        kind: need.kind,
+        name: need.name,
+        status,
+        detail: `测试：${need.name}`,
+        ...extra,
+    };
+}
+export function capabilityOf(unit, needs = [], extra = {}) {
+    return { unit, status: needs.some((need) => need.status !== 'ok') ? 'missing' : 'ok', needs, ...extra };
+}

package/dist/testing.d.ts

@@ -1,2 +1,4 @@
 export * from './testing/host-fakes.js';
 export * from './testing/declaration.js';
+export * from './testing/needs.js';
+export * from './testing/data.js';

package/dist/testing.js

@@ -1,2 +1,4 @@
 export * from './testing/host-fakes.js';
 export * from './testing/declaration.js';
+export * from './testing/needs.js';
+export * from './testing/data.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.3.11",
+  "version": "1.0.0-beta.1",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",
@@ -16,6 +16,10 @@
     "./testing": {
       "types": "./dist/testing.d.ts",
       "default": "./dist/testing.js"
+    },
+    "./contract/*": {
+      "types": "./dist/contract/*.d.ts",
+      "default": "./dist/contract/*.js"
     }
   },
   "files": [
@@ -29,22 +33,36 @@
     "react": "*"
   },
   "devDependencies": {
-    "@arch-guard/core": "^0.11.0",
+    "@arch-guard/core": "^0.11.1",
     "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
     "@types/node": "^24.19.0",
     "@types/react": "^19.0.0",
+    "@types/semver": "^7.8.0",
     "@vitest/coverage-v8": "^5.0.2",
     "react": "^18.0.0",
     "typescript": "5.9",
     "vitest": "^5.0.2"
   },
+  "dependencies": {
+    "dayjs": "^1.11.23",
+    "semver": "^7.8.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/novaeth/dsh-workbench.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/novaeth/dsh-workbench#readme",
+  "bugs": {
+    "url": "https://github.com/novaeth/dsh-workbench/issues"
+  },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && node scripts/copy-css.mjs",
+    "build": "node scripts/gen-release-packages.mjs && tsc -p tsconfig.build.json && node scripts/copy-css.mjs",
     "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile node_modules/.cache/tsconfig.tsbuildinfo",
     "test": "vitest run",
     "coverage": "vitest run --coverage",
     "barrels": "node scripts/barrels.mjs",
-    "selfcheck": "node scripts/check-state.mjs",
+    "selfcheck": "node scripts/check-state.mjs && node scripts/gen-release-packages.mjs --check",
     "arch:report": "arch-guard --report-only",
     "arch": "arch-guard"
   }