@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/skills/llm-wiki-skill/workbench/web/test/graph-reader-request.test.ts

@@ -0,0 +1,32 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import type { GraphOpenPagePayload } from "@llm-wiki/graph-engine";
+import { graphReaderDrawer, shouldApplyGraphReaderResult } from "../src/lib/drawer-state";
+
+describe("graph reader async request guards", () => {
+	it("only applies a page read result to the matching open graph reader", () => {
+		const first = graphPayload("a", "wiki/entities/A.md");
+		const second = graphPayload("b", "wiki/entities/B.md");
+
+		assert.equal(shouldApplyGraphReaderResult(graphReaderDrawer(first, { loading: true }), first), true);
+		assert.equal(shouldApplyGraphReaderResult(graphReaderDrawer(second, { loading: true }), first), false);
+	});
+});
+
+function graphPayload(id: string, path: string): GraphOpenPagePayload {
+	return {
+		path,
+		node: {
+			id,
+			title: id.toUpperCase(),
+			type: "entity",
+			typeLabel: "实体",
+			sourcePath: path,
+			community: "test",
+			date: null,
+			source: null,
+			isolated: false,
+		},
+	};
+}

package/skills/llm-wiki-skill/workbench/web/test/graph-reader.test.ts

@@ -0,0 +1,62 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import type { GraphOpenPagePayload } from "@llm-wiki/graph-engine";
+import {
+	graphReaderActionLabels,
+	graphReaderActions,
+	graphReaderMetaItems,
+} from "../src/lib/graph-reader";
+
+describe("graph reader", () => {
+	it("uses graph metadata for reader meta and actions without legacy reading sections", () => {
+		const payload: GraphOpenPagePayload = {
+			path: "wiki/sources/source-a.md",
+			node: {
+				id: "source-a",
+				title: "Source A",
+				type: "source",
+				typeLabel: "来源",
+				sourcePath: "wiki/sources/source-a.md",
+				community: "sources",
+				date: "2026-06-13",
+				source: "Archive",
+				isolated: true,
+			},
+		};
+
+		assert.deepEqual(graphReaderMetaItems(payload), [
+			"来源",
+			"2026-06-13",
+			"Archive",
+			"wiki/sources/source-a.md",
+		]);
+		assert.deepEqual(graphReaderActions(), [
+			{ id: "quote_page", label: "在对话中引用" },
+			{ id: "find_related_pages", label: "它和谁有关" },
+		]);
+		assert.deepEqual(graphReaderActionLabels(payload), ["在对话中引用", "它和谁有关"]);
+		assert.equal(graphReaderActionLabels(payload).includes("学习队列"), false);
+		assert.equal(graphReaderActionLabels(payload).includes("摘要"), false);
+		assert.equal(graphReaderActionLabels(payload).includes("相邻节点"), false);
+	});
+
+	it("only exposes source path as a source link for source pages", () => {
+		const topicPayload: GraphOpenPagePayload = {
+			path: "wiki/topics/topic-a.md",
+			node: {
+				id: "topic-a",
+				title: "Topic A",
+				type: "topic",
+				typeLabel: "主题",
+				sourcePath: "wiki/topics/topic-a.md",
+				community: "topics",
+				date: null,
+				source: null,
+				isolated: false,
+			},
+		};
+
+		assert.deepEqual(graphReaderMetaItems(topicPayload), ["主题"]);
+	});
+});

package/skills/llm-wiki-skill/workbench/web/test/graph-selection-drawer.test.ts

@@ -0,0 +1,56 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import type { Selection } from "@llm-wiki/graph-engine";
+import { graphSelectionViewModel } from "../src/lib/graph-selection-drawer";
+
+describe("graph selection drawer", () => {
+	it("hides structural facts for a single node and keeps unrelated group actions out", () => {
+		const view = graphSelectionViewModel(selectionFixture({
+			nodeIds: ["a"],
+			facts: { pageCount: 1, internalLinkCount: 0, communityCount: 1, isolatedCount: 0 },
+			actions: [
+				{ id: "summarize_page", label: "总结这一页", tone: "digest" },
+				{ id: "find_related_pages", label: "它和谁有关", tone: "bridge" },
+			],
+		}));
+
+		assert.equal(view.hint, "Shift+点击 增删节点");
+		assert.equal(view.showFacts, false);
+		assert.equal(view.canExpandNeighbors, true);
+		assert.deepEqual(view.facts, []);
+		assert.deepEqual(view.actionLabels, ["总结这一页", "它和谁有关"]);
+		assert.equal(view.actionLabels.includes("探索潜在联系"), false);
+	});
+
+	it("shows structural facts and the shift hint for multi-node selections", () => {
+		const view = graphSelectionViewModel(selectionFixture({
+			nodeIds: ["a", "b"],
+			facts: { pageCount: 2, internalLinkCount: 1, communityCount: 1, isolatedCount: 0 },
+			actions: [
+				{ id: "summarize_group", label: "总结这一组", tone: "digest" },
+				{ id: "explore_group_relationships", label: "探索它们的关系", tone: "bridge" },
+			],
+		}));
+
+		assert.equal(view.hint, "Shift+点击 增删节点");
+		assert.equal(view.showFacts, true);
+		assert.equal(view.canExpandNeighbors, false);
+		assert.deepEqual(view.facts, [
+			{ label: "页", value: 2 },
+			{ label: "链接", value: 1 },
+			{ label: "社区", value: 1 },
+		]);
+		assert.deepEqual(view.actionLabels, ["总结这一组", "探索它们的关系"]);
+	});
+});
+
+function selectionFixture(input: Pick<Selection, "nodeIds" | "facts" | "actions">): Selection {
+	return {
+		id: "selection-test",
+		nodeIds: input.nodeIds,
+		communityIds: [],
+		facts: input.facts,
+		actions: input.actions,
+	};
+}

package/skills/llm-wiki-skill/workbench/web/test/graph-selection.test.ts

@@ -0,0 +1,83 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import { resolveSelection, type GraphData } from "@llm-wiki/graph-engine";
+import { buildSelectionPromptPayload } from "../src/lib/graph-selection";
+
+describe("graph selection prompt payload", () => {
+	it("expands a community selection into page list, links, and communities", () => {
+		const data = fixtureGraph();
+		const selection = resolveSelection(data, { kind: "community", id: "alpha" });
+		const action = selection.actions?.find((item) => item.id === "summarize_cluster") ?? null;
+		const payload = buildSelectionPromptPayload(data, selection, action);
+
+		assert.match(payload.displayText, /@\[选区:Alpha Group · 2页\] 总结这一簇/);
+		assert.match(payload.expandedText, /动作：总结这一簇/);
+		assert.match(payload.expandedText, /页面清单：/);
+		assert.match(payload.expandedText, /1\. \[\[wiki\/topics\/alpha-a\.md\]\] - Alpha A - 社区 alpha/);
+		assert.match(payload.expandedText, /2\. \[\[wiki\/entities\/alpha-b\.md\]\] - Alpha B - 社区 alpha/);
+		assert.match(payload.expandedText, /链接关系：/);
+		assert.match(payload.expandedText, /- a -> b \(EXTRACTED\)/);
+		assert.match(payload.expandedText, /请基于上面的选区信息回答/);
+	});
+
+	it("uses stored synthesis session paths when sending graph nodes into chat", () => {
+		const data = fixtureGraph();
+		data.nodes = [
+			{
+				id: "session-a",
+				label: "Session A",
+				type: "synthesis",
+				community: "alpha",
+				source_path: "wiki/synthesis/sessions/session-a.md",
+			},
+		];
+		data.edges = [];
+		const learning = data.learning;
+		assert.ok(learning);
+		data.learning = {
+			...learning,
+			views: {
+				...learning.views,
+				global: { enabled: true, node_ids: ["session-a"], degraded: false },
+			},
+			communities: [{ id: "alpha", label: "Alpha Group", node_count: 1, color_index: 0 }],
+		};
+
+		const selection = resolveSelection(data, { kind: "node", id: "session-a" });
+		const payload = buildSelectionPromptPayload(data, selection, null);
+
+		assert.match(payload.expandedText, /1\. \[\[wiki\/synthesis\/sessions\/session-a\.md\]\] - Session A - 社区 alpha/);
+		assert.doesNotMatch(payload.expandedText, /wiki\/synthesis\/session-a\.md/);
+	});
+});
+
+function fixtureGraph(): GraphData {
+	return {
+		meta: {
+			build_date: "2026-06-12T00:00:00.000Z",
+			wiki_title: "Selection Fixture",
+			total_nodes: 2,
+			total_edges: 1
+		},
+		nodes: [
+			{ id: "a", label: "Alpha A", type: "topic", community: "alpha", source_path: "wiki/topics/alpha-a.md" },
+			{ id: "b", label: "Alpha B", type: "entity", community: "alpha", source_path: "wiki/entities/alpha-b.md" }
+		],
+		edges: [
+			{ id: "a-b", from: "a", to: "b", type: "EXTRACTED", weight: 1 }
+		],
+		learning: {
+			version: 1,
+			entry: { recommended_start_node_id: "a", recommended_start_reason: "community_hub", default_mode: "global" },
+			views: {
+				path: { enabled: false, start_node_id: null, node_ids: [], degraded: true },
+				community: { enabled: false, community_id: null, label: null, node_ids: [], is_weak: false, degraded: true },
+				global: { enabled: true, node_ids: ["a", "b"], degraded: false }
+			},
+			communities: [
+				{ id: "alpha", label: "Alpha Group", node_count: 2, color_index: 0 }
+			]
+		}
+	};
+}

package/skills/llm-wiki-skill/workbench/web/test/graph-summary-actions.test.ts

@@ -0,0 +1,188 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import {
+	drawerForExcludedGraphObject,
+	drawerForGraphSelection,
+	drawerForGraphSummaryNode,
+	drawerForUnavailableGraphObject,
+	graphOpenPagePayloadForCommand,
+	graphObjectVisibilityReason,
+	graphSelectionCommandForOpenDetail,
+} from "../src/lib/graph-summary-actions";
+import { closedDrawer } from "../src/lib/drawer-state";
+import type { GraphData, GraphSummaryCommand, Selection } from "@llm-wiki/graph-engine";
+
+describe("graph summary actions", () => {
+	it("turns a single node selection into a lightweight node summary drawer", () => {
+		const drawer = drawerForGraphSelection(graphFixture(), nodeSelection(), closedDrawer());
+
+		assert.equal(drawer.mode, "graph-node-summary");
+		assert.equal(drawer.mode === "graph-node-summary" ? drawer.payload.nodeId : null, "a");
+		assert.equal(drawer.mode === "graph-node-summary" ? drawer.payload.label : null, "Alpha");
+		assert.deepEqual(
+			drawer.mode === "graph-node-summary" ? drawer.payload.commands.map((command) => command.kind) : [],
+			["open-detail-read", "set-fixed-position", "enter-community"],
+		);
+	});
+
+	it("turns a single community selection into a lightweight community summary drawer", () => {
+		const drawer = drawerForGraphSelection(graphFixture(), communitySelection(), closedDrawer());
+
+		assert.equal(drawer.mode, "graph-community-summary");
+		assert.equal(drawer.mode === "graph-community-summary" ? drawer.payload.communityId : null, "c1");
+		assert.deepEqual(
+			drawer.mode === "graph-community-summary" ? drawer.payload.commands.map((command) => command.kind) : [],
+			["enter-community"],
+		);
+	});
+
+	it("switches a community core node list click to node summary without entering community", () => {
+		const drawer = drawerForGraphSummaryNode(graphFixture(), "b", communitySummaryDrawer());
+
+		assert.equal(drawer.mode, "graph-node-summary");
+		assert.equal(drawer.mode === "graph-node-summary" ? drawer.payload.nodeId : null, "b");
+	});
+
+	it("keeps open detail/read as an explicit graph-reader payload", () => {
+		const payload = graphOpenPagePayloadForCommand(graphFixture(), {
+			kind: "open-detail-read",
+			nodeId: "a",
+			path: "wiki/a.md",
+			label: "打开详情",
+		});
+
+		assert.deepEqual(payload, {
+			path: "wiki/a.md",
+			node: {
+				id: "a",
+				title: "Alpha",
+				type: "topic",
+				typeLabel: "主题",
+				sourcePath: "wiki/a.md",
+				community: "c1",
+				date: null,
+				source: null,
+				isolated: false,
+			},
+		});
+	});
+
+	it("returns null for graph summary commands that should not open full reading", () => {
+		const command: GraphSummaryCommand = { kind: "enter-community", communityId: "c1", label: "进入社区" };
+
+		assert.equal(graphOpenPagePayloadForCommand(graphFixture(), command), null);
+	});
+
+	it("turns open detail/read into community focus with the node selected", () => {
+		const command: GraphSummaryCommand = {
+			kind: "open-detail-read",
+			nodeId: "a",
+			path: "wiki/a.md",
+			label: "打开详情",
+		};
+
+		assert.deepEqual(graphSelectionCommandForOpenDetail(graphFixture(), command), {
+			id: "c1",
+			nodeId: "a",
+			type: "enter-community-node",
+		});
+	});
+
+	it("classifies selected objects excluded by filters or search without clearing state", () => {
+		const data = graphFixture();
+		const object = { kind: "node" as const, nodeId: "b" };
+		const filteredState = {
+			searchQuery: "",
+			searchResultIds: [],
+			typeFilters: { topic: true, entity: false, source: true },
+			temporaryObject: null,
+		};
+		const searchedState = {
+			searchQuery: "Alpha",
+			searchResultIds: ["a"],
+			typeFilters: { topic: true, entity: true, source: true },
+			temporaryObject: null,
+		};
+
+		assert.equal(graphObjectVisibilityReason(data, filteredState, object), "filter");
+		assert.equal(graphObjectVisibilityReason(data, searchedState, object), "search");
+
+		const excluded = drawerForExcludedGraphObject(data, object, "filter", closedDrawer(), {
+			selection: { kind: "node", id: "b" },
+			searchResultIds: ["a"],
+		});
+		assert.equal(excluded.mode, "graph-excluded-object");
+		assert.deepEqual(
+			excluded.mode === "graph-excluded-object" ? excluded.payload.commands.map((command) => command.kind) : [],
+			["show-this-object", "clear-temporary-object-display"],
+		);
+
+		const unavailable = drawerForUnavailableGraphObject({ ...data, nodes: data.nodes.filter((node) => node.id !== "b") }, object, "missing-node", closedDrawer());
+		assert.equal(unavailable.mode, "graph-unavailable-object");
+	});
+});
+
+function nodeSelection(): Selection {
+	return {
+		id: "node:a",
+		nodeIds: ["a"],
+		communityIds: ["c1"],
+		facts: {
+			pageCount: 1,
+			internalLinkCount: 0,
+			communityCount: 1,
+			isolatedCount: 0,
+		},
+		actions: [],
+	};
+}
+
+function communitySelection(): Selection {
+	return {
+		id: "community:a,b",
+		nodeIds: ["a", "b"],
+		communityIds: ["c1"],
+		facts: {
+			pageCount: 2,
+			internalLinkCount: 1,
+			communityCount: 1,
+			isolatedCount: 0,
+		},
+		actions: [],
+	};
+}
+
+function communitySummaryDrawer() {
+	return drawerForGraphSelection(graphFixture(), communitySelection(), closedDrawer());
+}
+
+function graphFixture(): GraphData {
+	return {
+		meta: {
+			build_date: "2026-06-18T00:00:00.000Z",
+			wiki_title: "Graph summary action test",
+			total_nodes: 2,
+			total_edges: 1,
+		},
+		nodes: [
+			{ id: "a", label: "Alpha", type: "topic", community: "c1", source_path: "wiki/a.md" },
+			{ id: "b", label: "Beta", type: "entity", community: "c1", source_path: "wiki/b.md" },
+		],
+		edges: [
+			{ id: "a-b", from: "a", to: "b", type: "EXTRACTED", relation_type: "实现", weight: 1 },
+		],
+		learning: {
+			version: 1,
+			entry: { recommended_start_node_id: "a", recommended_start_reason: "hub", default_mode: "global" },
+			views: {
+				path: { enabled: false, start_node_id: null, node_ids: [], degraded: true },
+				community: { enabled: false, community_id: null, label: null, node_ids: [], is_weak: false, degraded: true },
+				global: { enabled: true, node_ids: ["a", "b"], degraded: false },
+			},
+			communities: [
+				{ id: "c1", label: "Community", node_count: 2, color_index: 0, members: ["a", "b"] },
+			],
+		},
+	};
+}

package/skills/llm-wiki-skill/workbench/web/test/main-view-tabs.test.tsx

@@ -0,0 +1,34 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import React from "react";
+
+import { MainViewTabs } from "../src/components/MainViewTabs";
+import { click, render, screen } from "./render";
+
+describe("MainViewTabs", () => {
+	it("renders the V2 main view switcher and changes views from the main area", async () => {
+		const selected: string[] = [];
+		render(
+			<MainViewTabs
+				activeView="chat"
+				graphHasPendingUpdate
+				onSelectView={(view) => selected.push(view)}
+			/>,
+		);
+
+		const tablist = screen.getByRole("tablist", { name: "主视图切换" });
+		const chatTab = screen.getByRole("tab", { name: "对话" });
+		const graphTab = screen.getByRole("tab", { name: "图谱" });
+
+		assert.ok(tablist.contains(chatTab));
+		assert.ok(tablist.contains(graphTab));
+		assert.equal(chatTab.getAttribute("aria-selected"), "true");
+		assert.equal(graphTab.getAttribute("aria-selected"), "false");
+		assert.ok(graphTab.querySelector(".main-view-tab-dot"), "graph tab should show pending graph updates");
+
+		await click(graphTab);
+		await click(chatTab);
+
+		assert.deepEqual(selected, ["graph", "chat"]);
+	});
+});

package/skills/llm-wiki-skill/workbench/web/test/markdown-view.test.tsx

@@ -0,0 +1,34 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import React from "react";
+
+import { MarkdownView } from "../src/components/MarkdownView";
+import { click, render, screen } from "./render";
+
+describe("MarkdownView Paper styling", () => {
+	it("renders wiki links with the Paper concept-link class and preserves open-page clicks", async () => {
+		const opened: string[] = [];
+		render(
+			<MarkdownView
+				content="See [[wiki/topics/paper.md]] next."
+				onOpenPage={(path) => opened.push(path)}
+				autoEmitWikiLinks={false}
+			/>,
+		);
+
+		const link = screen.getByRole("link", { name: "wiki/topics/paper.md" });
+		assert.equal(link.getAttribute("href"), "wiki/topics/paper.md");
+		assert.match(link.className, /\bat\b/);
+
+		await click(link);
+		assert.deepEqual(opened, ["wiki/topics/paper.md"]);
+	});
+
+	it("renders double-equals highlights as Paper marker spans", () => {
+		render(<MarkdownView content="This is ==important context== for synthesis." autoEmitWikiLinks={false} />);
+
+		const highlight = screen.getByText("important context");
+		assert.equal(highlight.tagName, "MARK");
+		assert.match(highlight.className, /\bhl\b/);
+	});
+});

package/skills/llm-wiki-skill/workbench/web/test/popup-menus.test.tsx

@@ -0,0 +1,85 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import React from "react";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+import { CommandMenu } from "../src/components/CommandMenu";
+import { RefMenu } from "../src/components/RefMenu";
+import type { CommandItem, PageRef } from "../src/lib/api";
+import { render, screen } from "./render";
+
+describe("Paper popup menus", () => {
+	it("renders RefMenu as a Paper listbox with selected page state and empty state", () => {
+		const selected: PageRef[] = [];
+		render(
+			<RefMenu
+				open
+				query="paper"
+				items={[
+					{ path: "wiki/paper-ui.md", name: "paper-ui", title: "Paper UI", category: "wiki" },
+					{ path: "raw/design.md", name: "design", title: "Design Notes", category: "raw" },
+				]}
+				selectedIndex={1}
+				onSelect={(item) => selected.push(item)}
+			/>,
+		);
+
+		const menu = screen.getByRole("listbox", { name: "@ 引用页面" });
+		assert.match(menu.className, /popup-menu-ref/);
+		assert.match(menu.textContent ?? "", /引用页面/);
+		assert.equal(screen.getByRole("option", { name: /Design Notes/ }).getAttribute("aria-selected"), "true");
+		assert.match(screen.getByText("wiki").className, /popup-item-kind/);
+
+		render(<RefMenu open query="none" items={[]} selectedIndex={0} onSelect={() => {}} />);
+		assert.match(screen.getByText("没有匹配页面").className, /popup-item-empty/);
+	});
+
+	it("renders CommandMenu groups, command pills, source chips, and selected state", () => {
+		render(
+			<CommandMenu
+				open
+				query="dig"
+				items={[
+					command({ slug: "/digest", name: "消化素材", source: "builtin", skillPath: null }),
+					command({ slug: "/llm-wiki", name: "llm-wiki", source: "builtin", skillPath: "/skills/llm-wiki" }),
+					command({ slug: "/help", name: "帮助", source: "pi-default", skillPath: null }),
+				]}
+				selectedIndex={1}
+				onSelect={() => {}}
+			/>,
+		);
+
+		const menu = screen.getByRole("listbox", { name: "/ 调用命令" });
+		assert.match(menu.className, /popup-menu-command/);
+		assert.match(menu.textContent ?? "", /内置/);
+		assert.match(menu.textContent ?? "", /项目 Skill/);
+		assert.match(menu.textContent ?? "", /pi 默认/);
+		assert.equal(screen.getByRole("option", { name: /llm-wiki/ }).getAttribute("aria-selected"), "true");
+		assert.match(screen.getByText("/digest").className, /popup-item-command/);
+		assert.match(screen.getByText("项目").className, /popup-source/);
+	});
+
+	it("keeps the popup Paper styling contract", () => {
+		const css = readFileSync(resolve(import.meta.dirname, "../src/index.css"), "utf8");
+
+		assert.match(css, /\.popup-menu\s*\{/);
+		assert.match(css, /\.popup-menu[\s\S]*var\(--paper-grain\)/);
+		assert.match(css, /\.popup-menu-heading\s*\{/);
+		assert.match(css, /\.popup-menu-symbol[\s\S]*var\(--app-accent-soft\)/);
+		assert.match(css, /\.popup-item-selected[\s\S]*inset 3px 0 0 var\(--app-accent\)/);
+		assert.match(css, /\.popup-item-command\s*\{/);
+		assert.match(css, /\.popup-item-empty\s*\{/);
+	});
+});
+
+function command(overrides: Partial<CommandItem>): CommandItem {
+	return {
+		slug: "/command",
+		name: "Command",
+		description: "Runs a command",
+		source: "builtin",
+		skillPath: null,
+		...overrides,
+	};
+}

package/skills/llm-wiki-skill/workbench/web/test/render.test.tsx

@@ -0,0 +1,30 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import React, { useState } from "react";
+
+import { click, render, screen } from "./render";
+
+describe("DOM test helpers", () => {
+	it("starts each test with a clean browser-like document", () => {
+		assert.equal(document.body.innerHTML, "");
+		assert.equal(localStorage.length, 0);
+		assert.deepEqual({ ...document.documentElement.dataset }, {});
+	});
+
+	it("renders React components and dispatches real click events", async () => {
+		render(React.createElement(CounterButton));
+
+		const button = screen.getByRole("button", { name: "Count 0" });
+		await click(button);
+
+		assert.equal(screen.getByRole("button").textContent, "Count 1");
+	});
+});
+
+function CounterButton() {
+	const [count, setCount] = useState(0);
+	return React.createElement("button", {
+		type: "button",
+		onClick: () => setCount((value) => value + 1),
+	}, `Count ${count}`);
+}

package/skills/llm-wiki-skill/workbench/web/test/render.tsx

@@ -0,0 +1,38 @@
+import React from "react";
+import {
+	fireEvent,
+	render as renderWithTestingLibrary,
+	screen,
+	waitFor,
+	within,
+	type RenderOptions,
+} from "@testing-library/react";
+
+export { screen, waitFor, within };
+
+export function render(ui: React.ReactElement, options?: RenderOptions) {
+	return renderWithTestingLibrary(ui, options);
+}
+
+export async function click(element: Element) {
+	fireEvent.pointerDown(element);
+	fireEvent.mouseDown(element);
+	fireEvent.pointerUp(element);
+	fireEvent.mouseUp(element);
+	fireEvent.click(element);
+	await flushMicrotasks();
+}
+
+export async function pressKey(element: Element | Document, key: string, init: KeyboardEventInit = {}) {
+	fireEvent.keyDown(element, { key, code: init.code ?? key, ...init });
+	await flushMicrotasks();
+}
+
+export async function changeText(element: HTMLElement, value: string) {
+	fireEvent.change(element, { target: { value } });
+	await flushMicrotasks();
+}
+
+export async function flushMicrotasks() {
+	await Promise.resolve();
+}