@qilin-agent/client-test-runtime 3.1.7 → 3.1.9

package/README.i18n.yaml

@@ -6,8 +6,8 @@
   en: 6fd77b7a27000bf1
   zh: 4a9606aa75285111
 /qilin-agent-client-test-runtime:
-  en: 98930800a1b3f9df
-  zh: 40284d89485f924e
+  en: d67e576407527114
+  zh: ff4b26a96adb4c5d
 /qilin-agent-client-test-runtime/summary:
   en: 7f54f8cd8f6bce97
   zh: 90527ba60f855dc2
@@ -30,8 +30,8 @@
   en: f089ab96a088895d
   zh: 31852d191de6604d
 /qilin-agent-client-test-runtime/use-this-package/roster-and-startup-behavior:
-  en: bb3ec77a5fb158e7
-  zh: e2251ec69a305feb
+  en: 15466d568bd44194
+  zh: 86f0b47679a0c2dd
 /qilin-agent-client-test-runtime/use-this-package/when-to-use-it:
   en: eb2f9bc90acb7a62
   zh: cb59a2134bc83106
@@ -45,7 +45,7 @@
   en: d9d7e2f11d3dfbc9
   zh: bfddde279a836900
 /qilin-agent-client-test-runtime/understand-the-implementation/source-map:
-  en: bf31d10735c9a3b3
+  en: 20e3be303554ead3
   zh: 095ac3e7a8361383
 /qilin-agent-client-test-runtime/understand-the-implementation/lifecycle:
   en: b42779f364504719

package/README.md

@@ -7,6 +7,8 @@ kind: "package-library"
 
 English | [中文](README.zh.md)
 
+Direct component fixtures use `contextMenuHook(open)` to supply the global menu hook with production gesture handling. An unstubbed activation throws; Slot composition tests mount the menu plugin itself.
+
 ## Summary
 
 `SlotTestRuntime.create()` lets Vitest suites drive production slots, stores, typed Session and Workspace fixtures, and local DOM assertions in jsdom. For plugin activation, reload, reconnect, and cleanup tests, `createClientTest` starts the web profile's bundle roster with endpoint-named Remote mocks, without a business Host. Missing services and unstubbed calls fail explicitly. The whole-client fixture owns startup and disposal; the local runtime provides idempotent disposal. Use this package through `devDependencies` for client tests; it is not a product plugin.
@@ -87,7 +89,7 @@ The [generic Remote proxy](../remote-mock/README.md#remote-proxy) supports every
 
 ### Roster and startup behavior
 
-`webApp` is the `web` profile's browser roster, read when the assembly entry is first imported from its bundles (`qilin-base`, then `qilin-web-app`) as the launcher composes them, except that a patch matching nothing throws here where the launcher warns: each bundle's `qilin.bundle.patch` list is parsed with the include plugin's YAML dialect and composed by its `applyEntryPatches`, and every enabled row whose package declares `qilin.client.platform === 'web'` becomes a row carrying that declaration's `inject` and `immediately`; `bundleRoster(bundles)` does the same for any bundle list. Nothing is copied from the bundles, so a bundle change is visible at the next test run. `webApp.closure(names)` keeps the named rows plus everything they inject, transitively (the rows a spec needs to boot those plugins as the bundle composes them), `webApp.pick(names)` and `webApp.without(names)` cut it down by hand, all three throw on unknown names, and `ClientRoster.of(rows)` builds one inline. `remoteDefaultResponses` holds default responses for exactly the Remote endpoints the roster calls while booting with no sessions, no workspaces, and default settings; a spec layers its own `RemoteTable` on top with `mock.load(table)`, and any call without a rule fails the test at `dispose()` through `mock.assertNoUnmatched()`. `mount` requires a roster that provides `uiRenderer`; `start` fails loud otherwise instead of returning an empty container. `client.connection` is the roster's Connection service (no `Context` augmentation declares it), and `connectTimeoutMs` bounds the readiness wait, whose failure message lists the mock log. `reload(name)` rebuilds one Loader entry through the shared Client Modules helper (registry-first teardown, then `entry.refresh()`); each client retains its own module system and instance-bound Connection replacement, so starts and reloads can overlap without changing a page global. `unload(name)` removes an entry and waits for plugin cleanup; `flush()` settles React inside `act`. jsdom implements neither `EventSource` (client-hmr opens one at apply) nor `ResizeObserver` (layout components observe size at mount), so `start` reference-counts inert stubs for whichever global is absent and `dispose` removes exactly those — a jsdom gap, not a client identity channel. The `@qilin-agent/api-remotes` row is dropped from every roster: its generated Remote clients exist only in built `lib/`, and `remote.<ns>` is what the tier replaces anyway. `start` instead provides one contract-free proxy per `remote.<ns>` service the roster injects (plus the namespaces the mock has rules for at that point; a namespace first registered later has no proxy); `ctx.remote.<ns>.<method>(...args)` becomes a call on the endpoint `<ns>/<method>` carrying the positional args, a stream when the mock registered a `stream()` script and a unary call otherwise, with the generated client's outcome folding (`gateway/internal` for carrier throws, `gateway/cancelled` on abort). An endpoint without a rule is still dispatched, so the mock logs it and `dispose()` fails the test.
+`webApp` is the `web` profile's browser roster, read when the assembly entry is first imported from its bundles (`qilin-base`, then `qilin-web-app`) as the launcher composes them, except that a patch matching nothing throws here where the launcher warns: each bundle's `qilin.bundle.patch` list is parsed with the include plugin's YAML dialect and composed by its `applyEntryPatches`, and every enabled row whose package declares `qilin.client.platform === 'web'` becomes a row carrying that declaration's `inject` and `immediately`; `bundleRoster(bundles)` does the same for any bundle list. Nothing is copied from the bundles, so a bundle change is visible at the next test run. `webApp.closure(names)` keeps the named rows plus everything they inject, transitively (the rows a spec needs to boot those plugins as the bundle composes them), `webApp.pick(names)` and `webApp.without(names)` cut it down by hand, all three throw on unknown names, and `ClientRoster.of(rows)` builds one inline. `remoteDefaultResponses` holds default responses for exactly the Remote endpoints the roster calls while booting with no sessions, no workspaces, and default settings; a spec layers its own `RemoteTable` on top with `mock.load(table)`, and any call without a rule fails the test at `dispose()` through `mock.assertNoUnmatched()`. `mount` requires a roster that provides `uiRenderer`; `start` fails loud otherwise instead of returning an empty container. `client.connection` is the roster's Connection service (no `Context` augmentation declares it), and `connectTimeoutMs` bounds the readiness wait, whose failure message lists the mock log. `reload(name)` rebuilds one Loader entry through the shared Client Modules helper (registry-first teardown, then `entry.refresh()`); each client retains its own module system and instance-bound Connection replacement, so starts and reloads can overlap without changing a page global. `unload(name)` removes an entry and waits for plugin cleanup; `flush()` settles React inside `act`. jsdom implements neither `EventSource` (client-hmr opens one at apply) nor `ResizeObserver` or `matchMedia` (layout components observe size and media queries at mount), so `start` reference-counts inert stubs for whichever global is absent and `dispose` removes exactly those — a jsdom gap, not a client identity channel. The `@qilin-agent/api-remotes` row is dropped from every roster: its generated Remote clients exist only in built `lib/`, and `remote.<ns>` is what the tier replaces anyway. `start` instead provides one contract-free proxy per `remote.<ns>` service the roster injects (plus the namespaces the mock has rules for at that point; a namespace first registered later has no proxy); `ctx.remote.<ns>.<method>(...args)` becomes a call on the endpoint `<ns>/<method>` carrying the positional args, a stream when the mock registered a `stream()` script and a unary call otherwise, with the generated client's outcome folding (`gateway/internal` for carrier throws, `gateway/cancelled` on abort). An endpoint without a rule is still dispatched, so the mock logs it and `dispose()` fails the test.
 
 ### When to use it
 
@@ -124,7 +126,7 @@ The bench copies no production logic: it mounts the production `SlotRegistry`, p
 | [`src/remote.ts`](src/remote.ts) | `TestRemote` double for host RPC, `RemoteError` value re-export |
 | [`src/translate.ts`](src/translate.ts) + [`src/locale-env.ts`](src/locale-env.ts) | Translation and pinned-browser-language test helpers |
 | [`src/config-form.ts`](src/config-form.ts) | `stubConfigForm` with test-driven publications and write spies |
-| [`src/access.ts`](src/access.ts) | `allowAllAccess`: the access-Hook share hand-built component props spread |
+| [`src/access.ts`](src/access.ts) | `allowAllAccess`: the root and Session access-Hook share hand-built component props spread |
 | [`src/assembly/roster.ts`](src/assembly/roster.ts) | `ClientRosterRow`, `ClientRoster` (`of`/`closure`/`pick`/`without`), the `AssemblyPlan` it annotates, and `graphFromRoster` |
 | [`src/assembly/modules.ts`](src/assembly/modules.ts) | Source `/client` imports and replacements, registered through the production module facade's pending factory queue |
 | [`src/assembly/test-client.ts`](src/assembly/test-client.ts) | `TestClient`: instance-bound Connection, shared jsdom shims, `bootClient`, mount, readiness wait, `reload`/`unload`/`dispose` |

package/README.zh.md

@@ -7,6 +7,8 @@ kind: "package-library"
 
 [English](README.md) | 中文
 
+直接挂载组件的夹具使用 `contextMenuHook(open)` 提供全局菜单 hook，并复用生产手势处理。未提供行为的触发会抛错；Slot 组合测试挂载菜单插件本身。
+
 ## 概述
 
 `SlotTestRuntime.create()` 让 Vitest 套件在 jsdom 中驱动生产 slot、store、带类型的 Session 与 Workspace fixture，并对局部 DOM 断言。面向插件激活、重载、重连与清理的测试，`createClientTest` 使用具名端点 Remote mock 启动 web profile 的 bundle roster，无需业务 Host。缺失服务与未打桩调用会明确失败。整机 fixture 拥有启动和销毁，局部 runtime 提供幂等销毁。通过 `devDependencies` 将本包用于客户端测试；它不是产品插件。
@@ -87,7 +89,7 @@ test('registers into the sidebar', async ({ remote, start }) => {
 
 ### Roster 与启动行为
 
-`webApp` 是 `web` profile 的浏览器 roster，首次 import 装配入口时从它的 bundle（先 `qilin-base`、再 `qilin-web-app`）按启动器的方式现读，只是匹配不到任何行的补丁在这里抛错、启动器只警告：每个 bundle 的 `qilin.bundle.patch` 列表用 include 插件的 YAML 方言解析、用它的 `applyEntryPatches` 合成，每个未禁用且其包声明 `qilin.client.platform === 'web'` 的行成为一行，带上该声明的 `inject` 与 `immediately`；`bundleRoster(bundles)` 对任意 bundle 列表做同样的事。没有任何东西从 bundle 拷贝出来，bundle 一改下次跑测试就能看见。`webApp.closure(names)` 保留点名的行及其传递注入的全部行（即按 bundle 组合方式起这些插件所需的行），`webApp.pick(names)` 与 `webApp.without(names)` 手工裁剪，三者都对未知名字抛错，`ClientRoster.of(rows)` 内联构造一份。`remoteDefaultResponses` 是 roster 在没有 session、没有 workspace、默认设置下启动时恰好会打的那些 Remote 端点的默认响应；测试用 `mock.load(table)` 在其上叠加自己的 `RemoteTable`，任何没有规则的调用都会在 `dispose()` 时经 `mock.assertNoUnmatched()` 让测试失败。`mount` 要求 roster 提供 `uiRenderer`；否则 `start` 响亮失败而不是返回一个空容器。`client.connection` 是 roster 的 Connection 服务（没有任何 `Context` 增强声明它），`connectTimeoutMs` 限定等就绪的时长，超时消息列出 mock log。`reload(name)` 通过共享的 Client Modules 辅助函数重建一个 Loader entry（先拆 registry，再 `entry.refresh()`）；每个客户端都保留自己的模块系统和绑定实例的 Connection 替换，因此启动与重载可以重叠而无需改写页面全局变量。`unload(name)` 移除 entry 并等待插件清理完成，`flush()` 在 `act` 内让 React 落定。jsdom 既没有 `EventSource`（client-hmr 在 apply 时打开一个）也没有 `ResizeObserver`（布局组件挂载时观察尺寸），所以 `start` 对缺失的全局惰性桩做引用计数，`dispose` 只移除它装的那些——这是 jsdom 的缺口，不是客户端身份通道。每个 roster 里的 `@qilin-agent/api-remotes` 行都会被去掉：它生成的 Remote 客户端只存在于构建后的 `lib/`，而 `remote.<ns>` 正是本档要替掉的东西。`start` 改为给 roster 注入的每个 `remote.<ns>` 服务（加上此刻 mock 登记过规则的命名空间；之后才首次登记的命名空间没有代理）提供一个无契约代理；`ctx.remote.<ns>.<method>(...args)` 变成对端点 `<ns>/<method>` 的调用，携带位置参数，mock 登记了 `stream()` 脚本的走流、否则走一元，并沿用生成客户端的结果折叠（载体抛错折成 `gateway/internal`，中止折成 `gateway/cancelled`）。没有规则的端点照样发出，所以 mock 会记下它、`dispose()` 让测试失败。
+`webApp` 是 `web` profile 的浏览器 roster，首次 import 装配入口时从它的 bundle（先 `qilin-base`、再 `qilin-web-app`）按启动器的方式现读，只是匹配不到任何行的补丁在这里抛错、启动器只警告：每个 bundle 的 `qilin.bundle.patch` 列表用 include 插件的 YAML 方言解析、用它的 `applyEntryPatches` 合成，每个未禁用且其包声明 `qilin.client.platform === 'web'` 的行成为一行，带上该声明的 `inject` 与 `immediately`；`bundleRoster(bundles)` 对任意 bundle 列表做同样的事。没有任何东西从 bundle 拷贝出来，bundle 一改下次跑测试就能看见。`webApp.closure(names)` 保留点名的行及其传递注入的全部行（即按 bundle 组合方式起这些插件所需的行），`webApp.pick(names)` 与 `webApp.without(names)` 手工裁剪，三者都对未知名字抛错，`ClientRoster.of(rows)` 内联构造一份。`remoteDefaultResponses` 是 roster 在没有 session、没有 workspace、默认设置下启动时恰好会打的那些 Remote 端点的默认响应；测试用 `mock.load(table)` 在其上叠加自己的 `RemoteTable`，任何没有规则的调用都会在 `dispose()` 时经 `mock.assertNoUnmatched()` 让测试失败。`mount` 要求 roster 提供 `uiRenderer`；否则 `start` 响亮失败而不是返回一个空容器。`client.connection` 是 roster 的 Connection 服务（没有任何 `Context` 增强声明它），`connectTimeoutMs` 限定等就绪的时长，超时消息列出 mock log。`reload(name)` 通过共享的 Client Modules 辅助函数重建一个 Loader entry（先拆 registry，再 `entry.refresh()`）；每个客户端都保留自己的模块系统和绑定实例的 Connection 替换，因此启动与重载可以重叠而无需改写页面全局变量。`unload(name)` 移除 entry 并等待插件清理完成，`flush()` 在 `act` 内让 React 落定。jsdom 既没有 `EventSource`（client-hmr 在 apply 时打开一个）也没有 `ResizeObserver` 和 `matchMedia`（布局组件挂载时观察尺寸与媒体查询），所以 `start` 对缺失的全局惰性桩做引用计数，`dispose` 只移除它装的那些——这是 jsdom 的缺口，不是客户端身份通道。每个 roster 里的 `@qilin-agent/api-remotes` 行都会被去掉：它生成的 Remote 客户端只存在于构建后的 `lib/`，而 `remote.<ns>` 正是本档要替掉的东西。`start` 改为给 roster 注入的每个 `remote.<ns>` 服务（加上此刻 mock 登记过规则的命名空间；之后才首次登记的命名空间没有代理）提供一个无契约代理；`ctx.remote.<ns>.<method>(...args)` 变成对端点 `<ns>/<method>` 的调用，携带位置参数，mock 登记了 `stream()` 脚本的走流、否则走一元，并沿用生成客户端的结果折叠（载体抛错折成 `gateway/internal`，中止折成 `gateway/cancelled`）。没有规则的端点照样发出，所以 mock 会记下它、`dispose()` 让测试失败。
 
 ### 何时使用
 

package/lib/index.js

@@ -1,4 +1,4 @@
-import { Context, Inject } from "@qilin-agent/kylin";
+import { Context, Inject, Service } from "@qilin-agent/kylin";
 import { Fragment, createElement, useSyncExternalStore } from "react";
 import { act, render, within } from "@testing-library/react";
 import { SlotRegistry } from "@qilin-agent/client-ui-renderer/client";
@@ -12,6 +12,7 @@ import { MutableSessionEventSource, SESSION_SEARCH_RESULT_LIMIT, createScope, sc
 import { scopeIdentityOf } from "@qilin-agent/api-session-controller/src/client/scope.ts";
 import { EMPTY_CONVERSATION_SNAPSHOT } from "@qilin-agent/client-ui-conversation/client";
 import { EMPTY_CHAT_SNAPSHOT } from "@qilin-agent/client-ui-chat/client";
+import { createContextMenuBindings } from "@qilin-agent/client-ui-context-menu/src/client/trigger.ts";
 //#region lib/types/snapshot.js
 /**
 * DOM snapshot hygiene: a vitest snapshot serializer that keeps `.snap`
@@ -1272,6 +1273,19 @@ function scriptedSettingsRemote(namespaces = [], options = {}) {
 	};
 }
 //#endregion
+//#region lib/types/context-menu.js
+/**
+* Supply the global hook to a component mounted outside the Slot renderer.
+* @param open - Observe captured targets; an unstubbed activation throws.
+* @returns Stable hook using the production pointer and keyboard handlers.
+*/
+function contextMenuHook(open = () => {
+	throw new Error("Unexpected context menu");
+}) {
+	const bindings = createContextMenuBindings(open, () => true);
+	return () => bindings;
+}
+//#endregion
 //#region lib/types/translate.js
 /**
 * Test double of the locale lookup chain: a translate stub over plain
@@ -1305,13 +1319,57 @@ function makeTranslate(...dicts) {
 //#region lib/types/access.js
 /**
 * Allow-all access for client specs. Production pages receive the
-* `remoteAccess` Client service and the global-resource `useRemoteAccess` Hook
-* from the remote-access Client plugin. Hand-built component props spread
+* `remoteAccess` Client service, the global-resource `useRemoteAccess` Hook
+* from the remote-access Client plugin, the Session list `useSessionAccess`
+* Hook from the session Client plugin, and the bound Session's `useAccess`
+* Hook as a standard prop. Hand-built component props spread
 * {@link allowAllAccess}; a spec of a refused path overrides the Hook.
 * @module @qilin-agent/client-test-runtime/src/access
 */
 /** Access Hooks that allow every action on every resource, for hand-built component props. */
-const allowAllAccess = { useRemoteAccess: () => true };
+const allowAllAccess = {
+	useRemoteAccess: () => true,
+	useSessionAccess: () => true,
+	useAccess: () => true
+};
+const ALLOWED = {
+	getSnapshot: () => true,
+	subscribe: () => () => {}
+};
+const REFUSED = {
+	getSnapshot: () => false,
+	subscribe: () => () => {}
+};
+/**
+* A `remoteAccess` Client service whose answers never change: `allows`
+* decides each action on every resource once. `whenAccess` installs an
+* allowed action's effects in the caller's fiber at once and never installs a
+* refused action's effects.
+*/
+var StaticRemoteAccess = class extends Service {
+	allows;
+	/**
+	* @param ctx - Context the service is provided on.
+	* @param allows - the fixed answer for each action; allows everything when omitted.
+	*/
+	constructor(ctx, allows = () => true) {
+		super(ctx, "remoteAccess");
+		this.allows = allows;
+	}
+	source(_kind, _id, action) {
+		return this.allows(action) ? ALLOWED : REFUSED;
+	}
+	whenAccess(action, callback) {
+		if (!this.allows(action)) return () => {};
+		const dispose = this.ctx.effect(callback, `remoteAccess.whenAccess(${JSON.stringify(action)})`);
+		return () => {
+			dispose();
+		};
+	}
+	whenResourceAccess(_kind, _id, action, callback) {
+		return this.whenAccess(action, callback);
+	}
+};
 //#endregion
 //#region lib/types/locale-env.js
 /**
@@ -1730,4 +1788,4 @@ var SlotTestRuntime = class SlotTestRuntime {
 	}
 };
 //#endregion
-export { FixtureSession, RemoteError, SlotTestRuntime, TestRemote, TestRoot, TestSessions, TestWorkspaces, allowAllAccess, bindSnapshotSelector, chatSnapshot, conversationSnapshot, createSlotRenderer, domSnapshotSerializer, makeTranslate, registerDomSnapshotSerializer, scriptedSettingsRemote, sessionSnapshot, stubConfigForm, usePinnedBrowserLanguages, workspaceSnapshot };
+export { FixtureSession, RemoteError, SlotTestRuntime, StaticRemoteAccess, TestRemote, TestRoot, TestSessions, TestWorkspaces, allowAllAccess, bindSnapshotSelector, chatSnapshot, contextMenuHook, conversationSnapshot, createSlotRenderer, domSnapshotSerializer, makeTranslate, registerDomSnapshotSerializer, scriptedSettingsRemote, sessionSnapshot, stubConfigForm, usePinnedBrowserLanguages, workspaceSnapshot };

package/lib/types/access.d.ts

@@ -1,13 +1,40 @@
 /**
  * Allow-all access for client specs. Production pages receive the
- * `remoteAccess` Client service and the global-resource `useRemoteAccess` Hook
- * from the remote-access Client plugin. Hand-built component props spread
+ * `remoteAccess` Client service, the global-resource `useRemoteAccess` Hook
+ * from the remote-access Client plugin, the Session list `useSessionAccess`
+ * Hook from the session Client plugin, and the bound Session's `useAccess`
+ * Hook as a standard prop. Hand-built component props spread
  * {@link allowAllAccess}; a spec of a refused path overrides the Hook.
  * @module @qilin-agent/client-test-runtime/src/access
  */
-import type { GlobalStandardProps } from '@qilin-agent/client-ui-slots';
-/** The access Hooks every Slot component receives. */
-export type AccessStandardProps = Pick<GlobalStandardProps, 'useRemoteAccess'>;
+import { Service, type Context } from '@qilin-agent/kylin';
+import type { AccessEffect, ClientRemoteAccess, RemoteEndpoint } from '@qilin-agent/api-remote-access/client/types';
+import type { GlobalStandardProps, HostObservable, SessionStandardProps } from '@qilin-agent/client-ui-slots';
+import type { TypertResourceKind } from '@qilin-agent/typert-protocol';
+/**
+ * The access Hooks a root- or session-scoped Slot component receives: the two
+ * GlobalStandardProps Hooks plus the SessionStandardProps `useAccess`, whose
+ * `boolean` result also satisfies the `session-maybe` seat's
+ * `boolean | undefined` result.
+ */
+export type AccessStandardProps = Pick<GlobalStandardProps, 'useRemoteAccess' | 'useSessionAccess'> & Pick<SessionStandardProps, 'useAccess'>;
 /** Access Hooks that allow every action on every resource, for hand-built component props. */
 export declare const allowAllAccess: AccessStandardProps;
+/**
+ * A `remoteAccess` Client service whose answers never change: `allows`
+ * decides each action on every resource once. `whenAccess` installs an
+ * allowed action's effects in the caller's fiber at once and never installs a
+ * refused action's effects.
+ */
+export declare class StaticRemoteAccess extends Service implements ClientRemoteAccess {
+    private readonly allows;
+    /**
+     * @param ctx - Context the service is provided on.
+     * @param allows - the fixed answer for each action; allows everything when omitted.
+     */
+    constructor(ctx: Context, allows?: (action: string) => boolean);
+    source(_kind: TypertResourceKind, _id: string, action: string): HostObservable<boolean>;
+    whenAccess(action: RemoteEndpoint, callback: () => AccessEffect): () => void;
+    whenResourceAccess(_kind: TypertResourceKind, _id: string, action: RemoteEndpoint, callback: () => AccessEffect): () => void;
+}
 //# sourceMappingURL=access.d.ts.map

package/lib/types/context-menu.d.ts

@@ -0,0 +1,11 @@
+/** Gesture bindings for direct component fixtures, using the production adapter. */
+import type { ContextMenuTriggerProps, MenuPoint, ContextMenuTarget } from '@qilin-agent/client-ui-context-menu/client';
+/**
+ * Supply the global hook to a component mounted outside the Slot renderer.
+ * @param open - Observe captured targets; an unstubbed activation throws.
+ * @returns Stable hook using the production pointer and keyboard handlers.
+ */
+export declare function contextMenuHook<Target extends object = ContextMenuTarget>(open?: (target: Target, point: MenuPoint) => void): () => {
+    getTriggerProps: (target: Target | (() => Target) | undefined, handlers?: ContextMenuTriggerProps) => ContextMenuTriggerProps;
+};
+//# sourceMappingURL=context-menu.d.ts.map

package/lib/types/index.d.ts

@@ -35,8 +35,9 @@ export { TestWorkspaces } from './workspaces.ts';
 export { RemoteError, TestRemote } from './remote.ts';
 export { chatSnapshot, conversationSnapshot, sessionSnapshot, workspaceSnapshot, } from './fixtures.ts';
 export type { FixtureSnapshot, SessionBehaviorOverrides, SessionFixture, SessionFixtureSnapshot, Stabilizer, } from './fixtures.ts';
+export { contextMenuHook } from './context-menu.ts';
 export { makeTranslate } from './translate.ts';
-export { allowAllAccess } from './access.ts';
+export { allowAllAccess, StaticRemoteAccess } from './access.ts';
 export type { AccessStandardProps } from './access.ts';
 export { usePinnedBrowserLanguages } from './locale-env.ts';
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-test-runtime",
   "description": "Browser test runtimes: a jsdom slot bench with test-owned Session and Workspace doubles, and a whole-client tier that boots the web roster through the production bootClient over an endpoint-named Remote mock",
-  "version": "3.1.7",
+  "version": "3.1.9",
   "publishConfig": {
     "access": "public"
   },
@@ -26,123 +26,124 @@
   },
   "license": "MIT",
   "dependencies": {
+    "@qilin-agent/dsh-compat": "3.1.9",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "js-yaml": "^4.3.2",
-    "vitest": "^4.1.8",
-    "@qilin-agent/dsh-compat": "3.1.7"
+    "vitest": "^4.1.8"
   },
   "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.7",
+    "@qilin-agent/kylin-plugin-include": "~1.0.12",
+    "@qilin-agent/kylin-plugin-loader": "~1.0.8",
+    "@qilin-agent/api-gateway": "3.1.9",
+    "@qilin-agent/api-session-controller": "3.1.9",
+    "@qilin-agent/api-workspace-controller": "3.1.9",
+    "@qilin-agent/attachment": "3.1.9",
+    "@qilin-agent/client-connection": "3.1.9",
+    "@qilin-agent/client-hmr": "3.1.9",
+    "@qilin-agent/client-modules": "3.1.9",
+    "@qilin-agent/client-store": "3.1.9",
+    "@qilin-agent/client-ui-chat": "3.1.9",
+    "@qilin-agent/client-ui-context-menu": "3.1.9",
+    "@qilin-agent/client-ui-conversation": "3.1.9",
+    "@qilin-agent/client-ui-renderer": "3.1.9",
+    "@qilin-agent/client-ui-session": "3.1.9",
+    "@qilin-agent/client-ui-settings": "3.1.9",
+    "@qilin-agent/client-ui-slots": "3.1.9",
+    "@qilin-agent/client-web": "3.1.9",
+    "@qilin-agent/remote-mock": "3.1.9",
+    "@qilin-agent/session": "3.1.9",
+    "@qilin-agent/subagent": "3.1.9",
+    "@qilin-agent/typert-protocol": "3.1.9",
     "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "@qilin-agent/kylin": "~4.0.5",
-    "@qilin-agent/kylin-plugin-loader": "~1.0.6",
-    "@qilin-agent/kylin-plugin-include": "~1.0.10",
-    "@qilin-agent/api-gateway": "3.1.7",
-    "@qilin-agent/api-session-controller": "3.1.7",
-    "@qilin-agent/api-workspace-controller": "3.1.7",
-    "@qilin-agent/attachment": "3.1.7",
-    "@qilin-agent/client-connection": "3.1.7",
-    "@qilin-agent/client-hmr": "3.1.7",
-    "@qilin-agent/client-store": "3.1.7",
-    "@qilin-agent/client-ui-chat": "3.1.7",
-    "@qilin-agent/client-ui-conversation": "3.1.7",
-    "@qilin-agent/client-modules": "3.1.7",
-    "@qilin-agent/client-ui-renderer": "3.1.7",
-    "@qilin-agent/client-ui-session": "3.1.7",
-    "@qilin-agent/client-ui-slots": "3.1.7",
-    "@qilin-agent/client-web": "3.1.7",
-    "@qilin-agent/remote-mock": "3.1.7",
-    "@qilin-agent/client-ui-settings": "3.1.7",
-    "@qilin-agent/session": "3.1.7",
-    "@qilin-agent/typert-protocol": "3.1.7",
-    "@qilin-agent/subagent": "3.1.7"
+    "react-dom": "^18.2.0"
   },
   "devDependencies": {
+    "@qilin-agent/api-gateway": "3.1.9",
+    "@qilin-agent/api-remote-access": "3.1.9",
+    "@qilin-agent/api-remotes": "3.1.9",
+    "@qilin-agent/api-session-controller": "3.1.9",
+    "@qilin-agent/api-terminal-controller": "3.1.9",
+    "@qilin-agent/api-workspace-controller": "3.1.9",
+    "@qilin-agent/api-workspace-files": "3.1.9",
+    "@qilin-agent/attachment": "3.1.9",
+    "@qilin-agent/base": "3.1.9",
+    "@qilin-agent/client-connection": "3.1.9",
+    "@qilin-agent/client-file-upload": "3.1.9",
+    "@qilin-agent/client-hmr": "3.1.9",
+    "@qilin-agent/client-locale": "3.1.9",
+    "@qilin-agent/client-modules": "3.1.9",
+    "@qilin-agent/client-resources": "3.1.9",
+    "@qilin-agent/client-store": "3.1.9",
+    "@qilin-agent/client-ui-account": "3.1.9",
+    "@qilin-agent/client-ui-agent-preset": "3.1.9",
+    "@qilin-agent/client-ui-approval": "3.1.9",
+    "@qilin-agent/client-ui-attachment": "3.1.9",
+    "@qilin-agent/client-ui-brand": "3.1.9",
+    "@qilin-agent/client-ui-chat": "3.1.9",
+    "@qilin-agent/client-ui-commands": "3.1.9",
+    "@qilin-agent/client-ui-context-menu": "3.1.9",
+    "@qilin-agent/client-ui-conversation": "3.1.9",
+    "@qilin-agent/client-ui-deliverables": "3.1.9",
+    "@qilin-agent/client-ui-goal": "3.1.9",
+    "@qilin-agent/client-ui-input-trigger": "3.1.9",
+    "@qilin-agent/client-ui-jobs": "3.1.9",
+    "@qilin-agent/client-ui-kylin": "3.1.9",
+    "@qilin-agent/client-ui-layout": "3.1.9",
+    "@qilin-agent/client-ui-message-feedback": "3.1.9",
+    "@qilin-agent/client-ui-model-selection": "3.1.9",
+    "@qilin-agent/client-ui-open-in-app": "3.1.9",
+    "@qilin-agent/client-ui-permission-presets": "3.1.9",
+    "@qilin-agent/client-ui-plan": "3.1.9",
+    "@qilin-agent/client-ui-plugin-manager": "3.1.9",
+    "@qilin-agent/client-ui-reference": "3.1.9",
+    "@qilin-agent/client-ui-renderer": "3.1.9",
+    "@qilin-agent/client-ui-schedule": "3.1.9",
+    "@qilin-agent/client-ui-session": "3.1.9",
+    "@qilin-agent/client-ui-settings": "3.1.9",
+    "@qilin-agent/client-ui-settings-general": "3.1.9",
+    "@qilin-agent/client-ui-settings-mcp": "3.1.9",
+    "@qilin-agent/client-ui-settings-models": "3.1.9",
+    "@qilin-agent/client-ui-settings-plugins": "3.1.9",
+    "@qilin-agent/client-ui-settings-skills": "3.1.9",
+    "@qilin-agent/client-ui-settings-unarchive-sessions": "3.1.9",
+    "@qilin-agent/client-ui-sidebar": "3.1.9",
+    "@qilin-agent/client-ui-sidebar-browser": "3.1.9",
+    "@qilin-agent/client-ui-sidebar-documentpreview": "3.1.9",
+    "@qilin-agent/client-ui-sidebar-files": "3.1.9",
+    "@qilin-agent/client-ui-sidebar-plans": "3.1.9",
+    "@qilin-agent/client-ui-sidebar-right": "3.1.9",
+    "@qilin-agent/client-ui-sidebar-tasks": "3.1.9",
+    "@qilin-agent/client-ui-sidebar-terminal": "3.1.9",
+    "@qilin-agent/client-ui-skill": "3.1.9",
+    "@qilin-agent/client-ui-slots": "3.1.9",
+    "@qilin-agent/client-ui-subagent": "3.1.9",
+    "@qilin-agent/client-ui-theme": "3.1.9",
+    "@qilin-agent/client-ui-theme-brand": "3.1.9",
+    "@qilin-agent/client-ui-tool": "3.1.9",
+    "@qilin-agent/client-ui-trajectory": "3.1.9",
+    "@qilin-agent/client-ui-user-questions": "3.1.9",
+    "@qilin-agent/client-ui-workflow-run": "3.1.9",
+    "@qilin-agent/client-ui-workspace": "3.1.9",
+    "@qilin-agent/client-web": "3.1.9",
+    "@qilin-agent/kylin": "~4.0.7",
+    "@qilin-agent/kylin-client-runner": "3.1.9",
+    "@qilin-agent/kylin-plugin-include": "~1.0.12",
+    "@qilin-agent/kylin-plugin-loader": "~1.0.8",
+    "@qilin-agent/remote-mock": "3.1.9",
+    "@qilin-agent/session": "3.1.9",
+    "@qilin-agent/session-log-export": "3.1.9",
+    "@qilin-agent/settings": "3.1.9",
+    "@qilin-agent/subagent": "3.1.9",
+    "@qilin-agent/typert-protocol": "3.1.9",
+    "@qilin-agent/typert-registry": "3.1.9",
+    "@qilin-agent/web-app": "3.1.9",
     "@types/js-yaml": "^4.0.9",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "@qilin-agent/api-remote-access": "3.1.7",
-    "@qilin-agent/api-terminal-controller": "3.1.7",
-    "@qilin-agent/api-gateway": "3.1.7",
-    "@qilin-agent/api-session-controller": "3.1.7",
-    "@qilin-agent/api-remotes": "3.1.7",
-    "@qilin-agent/api-workspace-controller": "3.1.7",
-    "@qilin-agent/attachment": "3.1.7",
-    "@qilin-agent/client-connection": "3.1.7",
-    "@qilin-agent/api-workspace-files": "3.1.7",
-    "@qilin-agent/client-file-upload": "3.1.7",
-    "@qilin-agent/client-hmr": "3.1.7",
-    "@qilin-agent/client-locale": "3.1.7",
-    "@qilin-agent/client-modules": "3.1.7",
-    "@qilin-agent/client-resources": "3.1.7",
-    "@qilin-agent/base": "3.1.7",
-    "@qilin-agent/client-store": "3.1.7",
-    "@qilin-agent/client-ui-agent-preset": "3.1.7",
-    "@qilin-agent/client-ui-account": "3.1.7",
-    "@qilin-agent/client-ui-attachment": "3.1.7",
-    "@qilin-agent/client-ui-brand": "3.1.7",
-    "@qilin-agent/client-ui-approval": "3.1.7",
-    "@qilin-agent/client-ui-chat": "3.1.7",
-    "@qilin-agent/client-ui-conversation": "3.1.7",
-    "@qilin-agent/client-ui-commands": "3.1.7",
-    "@qilin-agent/client-ui-deliverables": "3.1.7",
-    "@qilin-agent/client-ui-goal": "3.1.7",
-    "@qilin-agent/client-ui-input-trigger": "3.1.7",
-    "@qilin-agent/client-ui-kylin": "3.1.7",
-    "@qilin-agent/client-ui-model-selection": "3.1.7",
-    "@qilin-agent/client-ui-layout": "3.1.7",
-    "@qilin-agent/client-ui-open-in-app": "3.1.7",
-    "@qilin-agent/client-ui-permission-presets": "3.1.7",
-    "@qilin-agent/client-ui-message-feedback": "3.1.7",
-    "@qilin-agent/client-ui-plugin-manager": "3.1.7",
-    "@qilin-agent/client-ui-plan": "3.1.7",
-    "@qilin-agent/client-ui-reference": "3.1.7",
-    "@qilin-agent/client-ui-renderer": "3.1.7",
-    "@qilin-agent/client-ui-jobs": "3.1.7",
-    "@qilin-agent/client-ui-session": "3.1.7",
-    "@qilin-agent/client-ui-settings": "3.1.7",
-    "@qilin-agent/client-ui-settings-general": "3.1.7",
-    "@qilin-agent/client-ui-settings-models": "3.1.7",
-    "@qilin-agent/client-ui-settings-mcp": "3.1.7",
-    "@qilin-agent/client-ui-settings-unarchive-sessions": "3.1.7",
-    "@qilin-agent/client-ui-settings-plugin-inventory": "3.1.7",
-    "@qilin-agent/client-ui-sidebar": "3.1.7",
-    "@qilin-agent/client-ui-sidebar-browser": "3.1.7",
-    "@qilin-agent/client-ui-sidebar-documentpreview": "3.1.7",
-    "@qilin-agent/client-ui-settings-skills": "3.1.7",
-    "@qilin-agent/client-ui-schedule": "3.1.7",
-    "@qilin-agent/client-ui-sidebar-plans": "3.1.7",
-    "@qilin-agent/client-ui-sidebar-files": "3.1.7",
-    "@qilin-agent/client-ui-sidebar-right": "3.1.7",
-    "@qilin-agent/client-ui-sidebar-tasks": "3.1.7",
-    "@qilin-agent/client-ui-sidebar-terminal": "3.1.7",
-    "@qilin-agent/client-ui-skill": "3.1.7",
-    "@qilin-agent/client-ui-slots": "3.1.7",
-    "@qilin-agent/client-ui-theme-brand": "3.1.7",
-    "@qilin-agent/client-ui-settings-plugins": "3.1.7",
-    "@qilin-agent/client-ui-subagent": "3.1.7",
-    "@qilin-agent/client-ui-theme": "3.1.7",
-    "@qilin-agent/client-ui-tool": "3.1.7",
-    "@qilin-agent/client-ui-trajectory": "3.1.7",
-    "@qilin-agent/client-ui-user-questions": "3.1.7",
-    "@qilin-agent/client-ui-workflow-run": "3.1.7",
-    "@qilin-agent/client-ui-workspace": "3.1.7",
-    "@qilin-agent/client-web": "3.1.7",
-    "@qilin-agent/kylin": "~4.0.5",
-    "@qilin-agent/kylin-client-runner": "3.1.7",
-    "@qilin-agent/kylin-plugin-include": "~1.0.10",
-    "@qilin-agent/kylin-plugin-loader": "~1.0.6",
-    "@qilin-agent/session": "3.1.7",
-    "@qilin-agent/session-log-export": "3.1.7",
-    "@qilin-agent/remote-mock": "3.1.7",
-    "@qilin-agent/subagent": "3.1.7",
-    "@qilin-agent/typert-protocol": "3.1.7",
-    "@qilin-agent/settings": "3.1.7",
-    "@qilin-agent/web-app": "3.1.7",
-    "@qilin-agent/typert-registry": "3.1.7"
+    "react-dom": "^18.2.0"
   },
   "files": [
     "lib/index.js",