@crazx/dsh-client-test-runtime 0.1.5-alpha.1.zw.3

package/lib/types/settings-remote.d.ts

@@ -0,0 +1,83 @@
+/** Test double for the `settings` Remote namespace a bench's plugins inject. */
+import { vi } from 'vitest';
+/** The minimum a scripted namespace view carries for the double's own bookkeeping. */
+export interface ScriptedNamespace {
+    /** Namespace key the write addresses. */
+    ns: string;
+}
+/** One scripted `settings` namespace face plus the controls a bench drives it with. */
+export interface ScriptedSettingsRemote<View extends ScriptedNamespace> {
+    /**
+     * The namespace face handed to `TestRemote` as `settings`. A plugin injecting
+     * `remote.settings` unparks on it, which is what most benches need; the
+     * describe answer is the same one the shared mirror would read.
+     */
+    settings: {
+        describe(): Promise<{
+            ok: true;
+            value: {
+                writable: boolean;
+                hasDocument: boolean;
+                namespaces: readonly View[];
+            };
+        }>;
+        update(ns: string, patch: unknown, expectedRevision: number | undefined): Promise<{
+            ok: true;
+            value: View;
+        } | {
+            ok: false;
+            error: {
+                code: string;
+                message: string;
+                details: object;
+            };
+        }>;
+        replace(ns: string, section: unknown, expectedRevision: number | undefined): Promise<{
+            ok: true;
+            value: View;
+        } | {
+            ok: false;
+            error: {
+                code: string;
+                message: string;
+                details: object;
+            };
+        }>;
+        mutate(ns: string, ops: unknown, expectedRevision: number | undefined): Promise<{
+            ok: true;
+            value: View;
+        } | {
+            ok: false;
+            error: {
+                code: string;
+                message: string;
+                details: object;
+            };
+        }>;
+    };
+    /** Spy behind `settings.update`, for argument assertions. */
+    update: ReturnType<typeof vi.fn>;
+    /** Spy behind `settings.replace`, for argument assertions. */
+    replace: ReturnType<typeof vi.fn>;
+    /** Spy behind `settings.mutate`, for argument assertions. */
+    mutate: ReturnType<typeof vi.fn>;
+    /**
+     * Replace what the next describe answers with, as a Host commit would.
+     * @param namespaces - the namespace views to serve from now on.
+     */
+    publish(namespaces: readonly View[]): void;
+}
+/**
+ * Build a scripted `settings` Remote namespace for a bench. Each write answers
+ * with the addressed namespace unchanged, so a bench that only needs its
+ * plugins to activate scripts nothing; one asserting a write reads the
+ * corresponding spy or replaces the face.
+ * @param namespaces - namespace views the first describe answers with.
+ * @param options - deployment facts the describe answer reports.
+ * @returns the face and its controls.
+ */
+export declare function scriptedSettingsRemote<View extends ScriptedNamespace>(namespaces?: readonly View[], options?: {
+    writable?: boolean;
+    hasDocument?: boolean;
+}): ScriptedSettingsRemote<View>;
+//# sourceMappingURL=settings-remote.d.ts.map

package/lib/types/settings-scope.d.ts

@@ -0,0 +1,29 @@
+/** Test double for the client settings-scope seam. */
+import { vi } from 'vitest';
+import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
+/** Handle over one stubbed scope: the scope, its write spy, and publication controls. */
+export interface StubSettingsScope<T> {
+    /** The scope face handed to the service under test. */
+    scope: SettingsScope<T>;
+    /** Spy behind `scope.set`; resolves immediately. */
+    set: ReturnType<typeof vi.fn>;
+    /** Spy behind `scope.mutate`; resolves immediately. */
+    mutate: ReturnType<typeof vi.fn>;
+    /** Spy behind `scope.unset`; resolves immediately. */
+    unset: ReturnType<typeof vi.fn>;
+    /** @returns how many listeners are currently subscribed (disposal assertions). */
+    listenerCount(): number;
+    /**
+     * Replace part of the snapshot and notify subscribers, as a Host
+     * acceptance would.
+     * @param next - snapshot fields to replace.
+     */
+    publish(next: Partial<SettingsScopeSnapshot<T>>): void;
+}
+/**
+ * Build an in-memory settings scope for service specs: starts in the host
+ * loading state, records writes, and lets the test publish Host acceptances.
+ * @returns the stub handle.
+ */
+export declare function stubSettingsScope<T>(): StubSettingsScope<T>;
+//# sourceMappingURL=settings-scope.d.ts.map

package/lib/types/snapshot.d.ts

@@ -0,0 +1,14 @@
+import type { SnapshotSerializer } from 'vitest';
+/**
+ * The serializer plugin. Matches DOM elements whose subtree carries a scoped
+ * class or svg internals; serializes a normalized clone, which no longer
+ * matches, so printing falls through to the built-in DOM element serializer.
+ */
+export declare const domSnapshotSerializer: SnapshotSerializer;
+/**
+ * Register {@link domSnapshotSerializer} with vitest's expect (idempotent).
+ * SlotTestRuntime.create() calls this; specs that snapshot DOM outside the
+ * runtime import and call it themselves.
+ */
+export declare function registerDomSnapshotSerializer(): void;
+//# sourceMappingURL=snapshot.d.ts.map

package/lib/types/translate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test double of the locale lookup chain: a translate stub over plain
+ * dictionaries, mirroring LocaleRuntime's resolution order (first dictionary
+ * that owns the key wins, then the key itself stays visible) and its
+ * `{name}` template interpolation. Specs stub the framework-injected `t`
+ * seat with `makeTranslate(zh, commonZh)` instead of re-implementing the
+ * chain per suite.
+ */
+/**
+ * Build a translate stub resolving through `dicts` in order (namespace
+ * first, then the shared common vocabulary), falling back to the key.
+ * @param dicts - dictionaries consulted in order.
+ * @returns the translate function (assignable to any `XxxProps['t']` seat).
+ */
+export declare function makeTranslate(...dicts: readonly Record<string, string>[]): (key: string, params?: Record<string, unknown>) => string;
+//# sourceMappingURL=translate.d.ts.map

package/lib/types/workspaces.d.ts

@@ -0,0 +1,89 @@
+import type { IWorkspaces, WorkspaceId, WorkspaceSnapshot, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { FixtureSnapshot, Stabilizer } from './fixtures.ts';
+/** Writable test representation of the immutable Workspace Controller snapshot. */
+type WorkspaceFixtureSnapshot = FixtureSnapshot<WorkspaceSnapshot>;
+/** Callable command names on the production Workspace Controller face. */
+type WorkspaceAction = {
+    [Key in keyof IWorkspaces]: IWorkspaces[Key] extends (...args: never[]) => unknown ? Key : never;
+}[keyof IWorkspaces];
+/** Test replacement retaining one Controller command's parameters and result. */
+type WorkspaceStub<Key extends WorkspaceAction> = (...args: Parameters<IWorkspaces[Key]>) => ReturnType<IWorkspaces[Key]>;
+/**
+ * Workspaces test double. Implements the same IWorkspaces face features
+ * receive as `ctx.workspaces`, so a production face change breaks this
+ * double at compile time. Every action records into {@link
+ * TestWorkspaces.calls}; defaults are inert echoes — feature tests needing
+ * richer behavior replace them via {@link TestWorkspaces.stub}.
+ */
+export declare class TestWorkspaces implements IWorkspaces {
+    private readonly stabilize;
+    /** The useWorkspaces standard feed. */
+    readonly list: SnapshotStore<WorkspaceFixtureSnapshot>;
+    /** Calls observed on the action face, newest last. */
+    readonly calls: {
+        method: string;
+        args: unknown[];
+    }[];
+    /** Replaceable action seat: feature tests may stub richer behavior. */
+    private readonly stubs;
+    /**
+     * @param stabilize - the owning runtime's act wrapper.
+     */
+    constructor(stabilize: Stabilizer);
+    /**
+     * Update the workspace list state through an immer draft.
+     * @param mutate - draft mutator.
+     */
+    update(mutate: (draft: WorkspaceFixtureSnapshot) => void): Promise<void>;
+    /**
+     * Replace an action's behavior (the recorded call is still appended first).
+     * @param method - Controller action name (e.g. 'create').
+     * @param impl - replacement behavior.
+     */
+    stub<Key extends WorkspaceAction>(method: Key, impl: WorkspaceStub<Key>): void;
+    /**
+     * Create a Workspace (recorded). The default echoes a view derived from
+     * the input; stub for failure or list-coupled flows.
+     * @param input - the Host create payload.
+     * @returns the created Workspace view.
+     */
+    create(input: {
+        path: string;
+    }): Promise<WorkspaceView>;
+    /**
+     * Rename a Workspace (recorded). The default echoes a minimal view.
+     * @param workspaceId - target workspace.
+     * @param title - new title.
+     * @returns the updated view.
+     */
+    rename(workspaceId: WorkspaceId, title: string): Promise<WorkspaceView>;
+    /**
+     * Delete a Workspace (recorded; default no-op).
+     * @param workspaceId - target workspace.
+     */
+    delete(workspaceId: WorkspaceId): Promise<void>;
+    /**
+     * Move a Workspace in display order (recorded; default no-op).
+     * @param workspaceId - Workspace to move.
+     * @param beforeWorkspaceId - Anchor; omitted appends.
+     */
+    insertBefore(workspaceId: WorkspaceId, beforeWorkspaceId?: WorkspaceId): Promise<void>;
+    /**
+     * Move an accounted session (recorded). The default echoes a minimal view.
+     * @param workspaceId - target workspace.
+     * @param sessionId - session to move.
+     * @param beforeSessionId - anchor; omitted appends.
+     * @returns the updated view.
+     */
+    insertSessionBefore(workspaceId: WorkspaceId, sessionId: SessionId, beforeSessionId?: SessionId): Promise<WorkspaceView>;
+    /**
+     * Archive a session (recorded). The default mirrors the production face's
+     * observable effect: the id joins the list state's archive set.
+     * @param sessionId - session to archive.
+     */
+    archiveSession(sessionId: SessionId): Promise<void>;
+}
+export {};
+//# sourceMappingURL=workspaces.d.ts.map

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@crazx/dsh-client-test-runtime",
+  "description": "jsdom slot test runtime: real Cordis Context + SlotRegistry + UI renderer with test-owned session/workspace doubles for feature specs",
+  "version": "0.1.5-alpha.1.zw.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aka-danielZhang/deepseek-harness.git",
+    "directory": "packages/test-support/client-runtime"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "vitest": "^4.1.8"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-api-session-controller": "npm:@crazx/dsh-api-session-controller@0.1.5-alpha.1.zw.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "npm:@crazx/dsh-client-ui-conversation@0.1.5-alpha.1.zw.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-api-session-controller": "npm:@crazx/dsh-api-session-controller@0.1.5-alpha.1.zw.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "npm:@crazx/dsh-client-ui-conversation@0.1.5-alpha.1.zw.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/types/**/*.d.ts"
+  ]
+}