@deepseek-ai/dsh-client-test-runtime 0.1.3-alpha.2 → 0.1.5-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/test-support/client-runtime/README.md
-README.md: 4ab70ecb6db7ae7d1844d8141b34daf7bd19a3dc
-README.zh.md: c3265d7cdcadaf55c0744b13267ac5e64d6b47a6
+README.md: 0b6caf7237520ca1a10fe0bbdf3c12c6d793461f
+README.zh.md: 40d27ac534f0f93d539101e2006a37a918318a81

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-client-test-runtime` gives a browser feature spec a real jsdom test bench: it assembles a Cordis context, the renderer-owned slot registry, and the production `UiSession` adapter around typed Session and Workspace Controller doubles. A default file-upload stub satisfies features that declare the service and rejects if a test starts an upload without replacing it. Feature suites exercise declaration, registration, scoping, stores, injection, rendering, updates, and disposal without copying production renderer or adapter logic. Suites publish Session lifecycle state, Workspace state, projection values, and Conversation events through typed fixtures, then use local DOM snapshot roots, scoped Testing Library queries, and fail-loud service checks. It is not part of the product plugin graph (no `dsh.client`); feature packages depend on it in `devDependencies` only.
+`dsh-client-test-runtime` lets browser feature specs exercise production slot, store, rendering, update, and disposal behavior in jsdom without reimplementing the UI runtime. Test authors can publish typed Session, Workspace, projection, and Conversation fixtures, query slot-local DOM roots, and script Remote replies or failures. Missing services, unstubbed session behavior, and unexpected file uploads fail at the call site, while disposal is idempotent. Use it only from in-repository browser-oriented Vitest suites through `devDependencies`; it is not a product plugin or general Node test harness.
 
 ## Table of Contents
 
@@ -29,7 +29,7 @@ This package gives a browser feature spec a real runtime to mount against: creat
 
 ### Setting up a feature spec
 
-`SlotTestRuntime.create()` assembles the runtime, `declare(children)` registers an auto frame whose per-key `<div data-slot>` wrappers become snapshot roots, `mount(plugin)` runs the feature on a real fiber, and `renderSlot(key, owner)` returns the slot-local view with scoped queries and in-place updates:
+`SlotTestRuntime.create()` assembles the runtime, `declare(children)` registers an auto frame whose per-key `<div data-slot>` wrappers become snapshot roots, `mount(plugin)` runs the feature on a real fiber, and `renderSlot(key, owner, opts?)` returns the slot-local view with scoped queries and in-place updates:
 
 ```text
 const runtime = await SlotTestRuntime.create()
@@ -42,6 +42,8 @@ await runtime.dispose()
 
 `mount` prechecks required services and fails loud when one is missing — `provide(name, value)` supplies an extra service first. The runtime provides an unavailable `fileUpload` stub so assemblies can mount; replace `runtime.fileUpload.upload` before mounting when a test exercises upload behavior. `storeOf(key, scopeKey)` returns the live store instance the renderer hands a slot's component for identity and action-driven-write assertions.
 
+The optional render options select a keyed entry with `entryKey` or a list item with `only`; `view.update(owner)` retains that selection. `runtime.panelInfo` supplies the default `usePanelInfo` source with no global panel selected. Release it with `releasePanelInfoSource()` before mounting the production Layout owner. `dispose()` releases both default Workspace and panel-info root sources; early release is idempotent and does not remove replacement owners.
+
 ### Local DOM snapshots
 
 A registered snapshot serializer folds CSS-module class hashes (`_frame_a1b2c3` → `frame`) so `.snap` files stay structural, and collapses `<svg>` internals to a `data-content` fingerprint. Suites needing a custom page frame use `root.declare(children, Frame)` instead of the auto frame; `dispose()` tears down views, feature fibers, minted scopes, and persisted store state on one axis and is idempotent.

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-library"
 
 ## 概述
 
-`dsh-client-test-runtime` 让浏览器功能测试拥有真实的 jsdom 测试台：它把 Cordis 上下文、渲染器拥有的 slot 注册表与生产 `UiSession` 适配器组装在带类型的 Session 和 Workspace Controller 替身周围。默认文件上传替身可满足声明该服务的功能；测试若没有替换它却发起上传，就会明确失败。功能套件无需复制生产渲染器或适配器逻辑，即可检验声明、注册、作用域、store、注入、渲染、更新与销毁。套件通过带类型 fixture 发布 Session 生命周期状态、Workspace 状态、projection 值与 Conversation 事件，再使用局部 DOM 快照根、限定范围的 Testing Library 查询与自明的服务缺失检查。它不属于产品插件图（无 `dsh.client`）；feature 包仅以 `devDependencies` 依赖之。
+`dsh-client-test-runtime` 让浏览器功能测试在 jsdom 中检验生产 slot、store、渲染、更新与销毁行为，而无需重实现 UI 运行时。测试作者可以发布带类型的 Session、Workspace、projection 与 Conversation fixture，查询 slot 局部 DOM 根，并脚本化 Remote 应答或失败。缺失服务、未打桩的会话行为与意外文件上传都会在调用点失败，销毁则保持幂等。仅限仓内、面向浏览器的 Vitest 套件通过 `devDependencies` 使用本包；它不是产品插件或通用 Node 测试框架。
 
 ## 目录
 
@@ -29,7 +29,7 @@ kind: "package-library"
 
 ### 搭建功能测试
 
-`SlotTestRuntime.create()` 组装运行时，`declare(children)` 注册一个自动 frame，其逐 key 的 `<div data-slot>` 包裹层成为快照根，`mount(plugin)` 在真实 fiber 上运行功能，`renderSlot(key, owner)` 返回带限定查询与原位更新的 slot 局部视图：
+`SlotTestRuntime.create()` 组装运行时，`declare(children)` 注册一个自动 frame，其逐 key 的 `<div data-slot>` 包裹层成为快照根，`mount(plugin)` 在真实 fiber 上运行功能，`renderSlot(key, owner, opts?)` 返回带限定查询与原位更新的 slot 局部视图：
 
 ```text
 const runtime = await SlotTestRuntime.create()
@@ -42,6 +42,8 @@ await runtime.dispose()
 
 `mount` 会预检必需服务，缺失时自明报错——先用 `provide(name, value)` 提供额外服务。运行时会提供不可用的 `fileUpload` 替身，使装配可以挂载；测试上传行为时，需要在挂载前替换 `runtime.fileUpload.upload`。`storeOf(key, scopeKey)` 返回渲染器交给 slot 组件的实时 store 实例，用于身份与动作驱动写入断言。
 
+可选渲染参数通过 `entryKey` 选择 keyed 条目，或通过 `only` 选择 list 条目；`view.update(owner)` 保留该选择。`runtime.panelInfo` 提供默认的 `usePanelInfo` 数据源，初始不选中全局面板。挂载生产 Layout 所有者之前，先调用 `releasePanelInfoSource()` 释放该数据源。`dispose()` 同时释放默认的工作区与面板信息根数据源；提前释放是幂等的，不会移除替代它们的所有者。
+
 ### 局部 DOM 快照
 
 注册的快照序列化器把 CSS-module 哈希类名折回语义名（`_frame_a1b2c3` → `frame`），使 `.snap` 文件只含结构，并把 `<svg>` 内部折叠为 `data-content` 指纹。需要自定义页面 frame 的套件改用 `root.declare(children, Frame)` 而非自动 frame；`dispose()` 沿单一轴拆除视图、feature fiber、已铸 scope 与持久化 store 状态，且幂等。

package/lib/index.js

@@ -5,9 +5,9 @@ import { SlotRegistry } from "@deepseek-ai/dsh-client-ui-renderer/client";
 import { bindSnapshotSelector as bindSnapshotSelector$1 } from "@deepseek-ai/dsh-client-ui-renderer/src/client/bind.ts";
 import { createSlotRenderer as createSlotRenderer$1 } from "@deepseek-ai/dsh-client-ui-renderer/src/client/scoped-slots.tsx";
 import { apply, inject } from "@deepseek-ai/dsh-client-ui-session/client";
+import { createSnapshotStore } from "@deepseek-ai/dsh-client-store";
 import { afterEach, beforeEach, expect, vi } from "vitest";
 import { MutableSessionEventSource, SESSION_SEARCH_RESULT_LIMIT, createScope, scopeOf } from "@deepseek-ai/dsh-api-session-controller/client";
-import { createSnapshotStore } from "@deepseek-ai/dsh-client-store";
 import { EMPTY_CONVERSATION_SNAPSHOT } from "@deepseek-ai/dsh-client-ui-conversation/client";
 import { EMPTY_CHAT_SNAPSHOT } from "@deepseek-ai/dsh-client-ui-chat/client";
 import { RemoteError } from "@deepseek-ai/dsh-typert-protocol";
@@ -1115,9 +1115,13 @@ var OwnerPropsCell = class {
 	* caller wraps in act).
 	* @param key - slot key.
 	* @param owner - owner props share.
+	* @param opts - explicit keyed or list selection for the render site.
 	*/
-	set(key, owner) {
-		this.owners.set(key, owner);
+	set(key, owner, opts) {
+		this.owners.set(key, {
+			owner,
+			opts
+		});
 		this.version += 1;
 		for (const fn of [...this.listeners]) fn();
 	}
@@ -1182,6 +1186,8 @@ var SlotTestRuntime = class SlotTestRuntime {
 	sessions;
 	/** Workspaces double (list observable, recorded intent actions). */
 	workspaces;
+	/** Test-owned panel selection used by the framework's usePanelInfo hook. */
+	panelInfo = createSnapshotStore({ activePanelId: null });
 	/** Mutable file-upload stub; replace `upload` in suites that exercise the capability. */
 	fileUpload;
 	stabilizer = async (fn) => {
@@ -1198,6 +1204,7 @@ var SlotTestRuntime = class SlotTestRuntime {
 	autoDeclared = /* @__PURE__ */ new Set();
 	autoRootView;
 	disposeWorkspaceSource;
+	disposePanelInfoSource;
 	constructor(ctx, slots) {
 		this.ctx = ctx;
 		this.slots = slots;
@@ -1212,6 +1219,7 @@ var SlotTestRuntime = class SlotTestRuntime {
 		ctx.provide("workspaces", this.workspaces);
 		ctx.provide("fileUpload", this.fileUpload);
 		this.disposeWorkspaceSource = slots.provideRoot({ hooks: { workspaces: this.workspaces.list } });
+		this.disposePanelInfoSource = slots.provideRoot({ hooks: { panelInfo: this.panelInfo } });
 		const renderer = createSlotRenderer();
 		slots.install({ renderRoot: (host, ownerProps) => {
 			this.host = host;
@@ -1264,6 +1272,10 @@ var SlotTestRuntime = class SlotTestRuntime {
 	releaseWorkspaceSource() {
 		this.disposeWorkspaceSource();
 	}
+	/** Release the default panel hook before mounting the production Layout owner. */
+	releasePanelInfoSource() {
+		this.disposePanelInfoSource();
+	}
 	/**
 	* Render the root slot tree through the ctx-level entry (the shell's own
 	* entry point): `ctx.slots.renderSlot('root', {})` under Testing Library.
@@ -1289,7 +1301,7 @@ var SlotTestRuntime = class SlotTestRuntime {
 		const cell = this.ownerCell;
 		const AutoFrame = (props) => {
 			useSyncExternalStore(cell.subscribe, cell.getVersion);
-			return createElement(Fragment, null, cell.entries().map(([key, owner]) => createElement(Fragment, { key }, props.renderSlot(key, owner))));
+			return createElement(Fragment, null, cell.entries().map(([key, { owner, opts }]) => createElement(Fragment, { key }, props.renderSlot(key, owner, opts))));
 		};
 		await this.root.declare(children, AutoFrame);
 	}
@@ -1301,13 +1313,14 @@ var SlotTestRuntime = class SlotTestRuntime {
 	* slot of the same tree.
 	* @param key - a key declared through {@link SlotTestRuntime.declare}.
 	* @param owner - owner props share for the render site.
+	* @param opts - explicit keyed or list selection; retained by view updates.
 	* @returns the slot-local view (snapshot container, scoped queries, owner updates).
 	*/
-	renderSlot(key, owner) {
+	renderSlot(key, owner, opts) {
 		if (!this.autoDeclared.has(key)) throw new Error(`renderSlot('${key}') without declare() — declare the key first (or use root.declare for a custom frame)`);
 		const install = (next) => {
 			act(() => {
-				this.ownerCell.set(key, next);
+				this.ownerCell.set(key, next, opts);
 			});
 		};
 		install(owner);
@@ -1349,7 +1362,7 @@ var SlotTestRuntime = class SlotTestRuntime {
 	}
 	/**
 	* Tear down: unmount React trees first, then dispose feature fibers, the
-	* root registration, minted session scopes, and persisted test state.
+	* root registration and standard sources, minted session scopes, and persisted test state.
 	* Idempotent.
 	* @returns completion of the teardown.
 	*/
@@ -1360,6 +1373,8 @@ var SlotTestRuntime = class SlotTestRuntime {
 		for (const view of this.views.splice(0)) view.unmount();
 		for (const handle of this.handles.splice(0)) await handle.dispose();
 		this.root.release();
+		this.disposeWorkspaceSource();
+		this.disposePanelInfoSource();
 		await this.sessions.disposeScopes();
 		localStorage.clear();
 	}

package/lib/types/index.d.ts

@@ -17,7 +17,8 @@ import type { queries } from '@testing-library/dom';
 import type { BoundFunctions } from '@testing-library/dom';
 import { SlotRegistry } from '@deepseek-ai/dsh-client-ui-renderer/client';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { ChildrenDecl, ComposedProps, HostObservable, OwnerOf, SlotComponent, SlotMap, SlotRenderer, SnapshotSelectorHook, StoreInstanceLike } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PanelInfo } from '@deepseek-ai/dsh-client-ui-layout/client';
+import type { ChildrenDecl, ComposedProps, HostObservable, OwnerOf, RenderOpts, SlotComponent, SlotMap, SlotRenderer, SnapshotSelectorHook, StoreInstanceLike } from '@deepseek-ai/dsh-client-ui-slots';
 import { TestSessions } from './sessions.ts';
 import { TestWorkspaces } from './workspaces.ts';
 import type { Stabilizer } from './fixtures.ts';
@@ -128,6 +129,8 @@ export declare class SlotTestRuntime {
     readonly sessions: TestSessions;
     /** Workspaces double (list observable, recorded intent actions). */
     readonly workspaces: TestWorkspaces;
+    /** Test-owned panel selection used by the framework's usePanelInfo hook. */
+    readonly panelInfo: import("@deepseek-ai/dsh-client-store").SnapshotStore<PanelInfo>;
     /** Mutable file-upload stub; replace `upload` in suites that exercise the capability. */
     readonly fileUpload: TestFileUpload;
     private readonly stabilizer;
@@ -140,6 +143,7 @@ export declare class SlotTestRuntime {
     private readonly autoDeclared;
     private autoRootView;
     private readonly disposeWorkspaceSource;
+    private readonly disposePanelInfoSource;
     private constructor();
     /**
      * Assemble a runtime: real Context, mounted SlotRegistry, installed
@@ -157,6 +161,8 @@ export declare class SlotTestRuntime {
     mount(plugin: Plugin): Promise<FeatureHandle>;
     /** Release the default Workspace hook before mounting its production owner. */
     releaseWorkspaceSource(): void;
+    /** Release the default panel hook before mounting the production Layout owner. */
+    releasePanelInfoSource(): void;
     /**
      * Render the root slot tree through the ctx-level entry (the shell's own
      * entry point): `ctx.slots.renderSlot('root', {})` under Testing Library.
@@ -182,9 +188,10 @@ export declare class SlotTestRuntime {
      * slot of the same tree.
      * @param key - a key declared through {@link SlotTestRuntime.declare}.
      * @param owner - owner props share for the render site.
+     * @param opts - explicit keyed or list selection; retained by view updates.
      * @returns the slot-local view (snapshot container, scoped queries, owner updates).
      */
-    renderSlot<K extends keyof SlotMap & string>(key: K, owner: OwnerOf<K>): SlotView<K>;
+    renderSlot<K extends keyof SlotMap & string>(key: K, owner: OwnerOf<K>, opts?: RenderOpts): SlotView<K>;
     /**
      * Resolve the store instance the renderer would hand a slot's component
      * (identity assertions, action-driven writes). Requires a prior
@@ -203,7 +210,7 @@ export declare class SlotTestRuntime {
     flush(): Promise<void>;
     /**
      * Tear down: unmount React trees first, then dispose feature fibers, the
-     * root registration, minted session scopes, and persisted test state.
+     * root registration and standard sources, minted session scopes, and persisted test state.
      * Idempotent.
      * @returns completion of the teardown.
      */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/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.3-alpha.2",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -30,41 +30,42 @@
   "peerDependencies": {
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "files": [