@molecule/app-ide-react 1.13.0 → 1.14.0

package/dist/components/tests-card-utilities.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Pure state + grouping helpers for the {@link TestsCard}.
+ *
+ * Everything here is a plain function over plain data, so the card's behaviour
+ * (which rows a group runs, how a streamed event moves the run forward, what
+ * the collapsed summary says) is unit-testable without rendering anything.
+ *
+ * @module
+ */
+import type { TestItem, TestKind, TestRunEvent, TestRunOutcome, TestStatus, TestWorkspace } from '../types.js';
+/** One rendered group of rows: a kind within a project directory. */
+export interface TestGroup {
+    kind: TestKind;
+    workspace: TestWorkspace;
+    /** The directory's name for the heading; `null` for the workspace root. */
+    label: string | null;
+    items: TestItem[];
+}
+/** What one test file ended as in the last run. */
+export interface TestResultEntry {
+    status: TestStatus;
+    durationMs?: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    /** The runner's output, kept for a FAILURE so the row can keep showing it. */
+    output?: string;
+}
+/** Everything the card knows about the run it is showing. */
+export interface TestsRunState {
+    runId: string | null;
+    running: boolean;
+    /** The ids this run covers, in run order. */
+    queued: string[];
+    /** The id whose output is streaming right now, when the host says which. */
+    currentId: string | null;
+    /** The live output lines, newest last, capped at {@link MAX_OUTPUT_LINES}. */
+    output: string[];
+    /** Per-id outcome from this run (and from earlier runs, until re-run). */
+    results: Record<string, TestResultEntry>;
+    /** How the run ended, once it has. */
+    outcome: TestRunOutcome | null;
+    /** A run-level failure message (timeout, transport error) shown in the card. */
+    error: string | null;
+    startedAt: number | null;
+    durationMs: number | null;
+}
+/** Live output lines retained — enough to read, bounded so a chatty run cannot grow forever. */
+export declare const MAX_OUTPUT_LINES = 400;
+/** A run that has not started. */
+export declare const EMPTY_RUN_STATE: TestsRunState;
+/**
+ * Group tests for display: by kind (end-to-end first), then by project
+ * directory (whatever directories are present — `app`, `my-app/app`,
+ * `packages/web`, the root last), with the files sorted inside each group.
+ *
+ * @param tests - Every discovered test.
+ * @returns The groups, in display order. Empty groups are never produced.
+ */
+export declare function groupTests(tests: readonly TestItem[]): TestGroup[];
+/**
+ * How many tests there are of each kind.
+ *
+ * @param tests - Every discovered test.
+ * @returns The per-kind counts.
+ */
+export declare function countByKind(tests: readonly TestItem[]): Record<TestKind, number>;
+/**
+ * The tallies of the last run, over the tests that are still listed. Counted
+ * per FILE (one row, one verdict) so the collapsed summary matches the rows.
+ *
+ * @param tests - The currently listed tests.
+ * @param results - The per-id outcomes.
+ * @returns Passed/failed/skipped file counts.
+ */
+export declare function summarizeResults(tests: readonly TestItem[], results: Record<string, TestResultEntry>): {
+    passed: number;
+    failed: number;
+    skipped: number;
+    reported: number;
+};
+/**
+ * Fold one streamed event into the run state.
+ *
+ * Deliberately total: an event for an id the card no longer lists is recorded
+ * anyway (a re-list may be in flight), and an unknown event type leaves the
+ * state untouched rather than throwing inside a stream handler.
+ *
+ * @param state - The current state.
+ * @param event - The event just received.
+ * @returns The next state (a new object whenever anything changed).
+ */
+export declare function applyTestRunEvent(state: TestsRunState, event: TestRunEvent): TestsRunState;
+/**
+ * The state after a run that never produced a `done` event — the host's stream
+ * died, or its request failed before the server could answer.
+ *
+ * @param state - The current state.
+ * @param message - What to show in the card.
+ * @returns The next state, no longer running.
+ */
+export declare function failRun(state: TestsRunState, message: string): TestsRunState;
+/**
+ * Whether a row should render as "running": the run is live and either the host
+ * named this row as current, or it is in the queue and has no verdict yet.
+ *
+ * @param state - The run state.
+ * @param id - The row's test id.
+ * @returns True when the row is part of the live run and still undecided.
+ */
+export declare function isRowRunning(state: TestsRunState, id: string): boolean;
+/**
+ * The label for a row: the host's title when it gave one, else the file path.
+ *
+ * @param item - The test.
+ * @returns The label to render.
+ */
+export declare function testRowLabel(item: TestItem): string;
+/**
+ * Filters tests by a free-text query, matching (case-insensitively) against the
+ * file path, the row title, and the project directory. A blank query returns
+ * every test in input order — the same contract as `filterScripts`.
+ *
+ * @param tests - The tests to filter.
+ * @param query - The search query.
+ * @returns The matching tests, in input order.
+ */
+export declare function filterTests(tests: readonly TestItem[], query: string): TestItem[];
+/**
+ * Parses a `/test [query | all]` command (`/tests` is the registered alias).
+ *
+ * `all` is the one argument that ACTS: it runs everything immediately. Every
+ * other argument only filters the list, exactly the way `/scripts <query>` seeds
+ * the scripts browser — running ONE test by name is what the per-row Run button
+ * is for, and giving the argument a second meaning would make `/test <thing>`
+ * sometimes list and sometimes execute.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ query, runAll }` when it is a `/test` command, else `null`.
+ */
+export declare function parseTestCommand(input: string): {
+    query: string;
+    runAll: boolean;
+} | null;
+//# sourceMappingURL=tests-card-utilities.d.ts.map

package/dist/components/tests-card-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests-card-utilities.d.ts","sourceRoot":"","sources":["../../src/components/tests-card-utilities.ts"],"names":[],"mappings":"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"}

package/dist/components/tests-card-utilities.js

@@ -0,0 +1,262 @@
+/**
+ * Pure state + grouping helpers for the {@link TestsCard}.
+ *
+ * Everything here is a plain function over plain data, so the card's behaviour
+ * (which rows a group runs, how a streamed event moves the run forward, what
+ * the collapsed summary says) is unit-testable without rendering anything.
+ *
+ * @module
+ */
+/** Live output lines retained — enough to read, bounded so a chatty run cannot grow forever. */
+export const MAX_OUTPUT_LINES = 400;
+/** Display order of the kinds: the preview-driven specs lead, unit tests follow. */
+const KIND_ORDER = ['e2e', 'unit'];
+/**
+ * Display order of the project directories within a kind: by path, with the
+ * workspace root (`.`) last — it is the least specific place a test can live.
+ *
+ * @param a - One directory.
+ * @param b - The other.
+ * @returns The sort order.
+ */
+function compareWorkspaces(a, b) {
+    if (a === b)
+        return 0;
+    if (a === '.')
+        return 1;
+    if (b === '.')
+        return -1;
+    return a.localeCompare(b);
+}
+/**
+ * The heading name for a directory: the host's label when it sent one, else
+ * the path itself, and `null` for the root either way.
+ *
+ * @param item - Any test in the group.
+ * @returns The label, or `null` for the workspace root.
+ */
+function labelFor(item) {
+    if (item.workspaceLabel !== undefined)
+        return item.workspaceLabel;
+    return item.workspace === '.' ? null : item.workspace;
+}
+/** A run that has not started. */
+export const EMPTY_RUN_STATE = {
+    runId: null,
+    running: false,
+    queued: [],
+    currentId: null,
+    output: [],
+    results: {},
+    outcome: null,
+    error: null,
+    startedAt: null,
+    durationMs: null,
+};
+/**
+ * Group tests for display: by kind (end-to-end first), then by project
+ * directory (whatever directories are present — `app`, `my-app/app`,
+ * `packages/web`, the root last), with the files sorted inside each group.
+ *
+ * @param tests - Every discovered test.
+ * @returns The groups, in display order. Empty groups are never produced.
+ */
+export function groupTests(tests) {
+    const groups = [];
+    for (const kind of KIND_ORDER) {
+        const workspaces = [
+            ...new Set(tests.filter((t) => t.kind === kind).map((t) => t.workspace)),
+        ].sort(compareWorkspaces);
+        for (const workspace of workspaces) {
+            const items = tests
+                .filter((t) => t.kind === kind && t.workspace === workspace)
+                .slice()
+                .sort((a, b) => a.file.localeCompare(b.file));
+            if (items.length > 0)
+                groups.push({ kind, workspace, label: labelFor(items[0]), items });
+        }
+    }
+    return groups;
+}
+/**
+ * How many tests there are of each kind.
+ *
+ * @param tests - Every discovered test.
+ * @returns The per-kind counts.
+ */
+export function countByKind(tests) {
+    return {
+        e2e: tests.filter((t) => t.kind === 'e2e').length,
+        unit: tests.filter((t) => t.kind === 'unit').length,
+    };
+}
+/**
+ * The tallies of the last run, over the tests that are still listed. Counted
+ * per FILE (one row, one verdict) so the collapsed summary matches the rows.
+ *
+ * @param tests - The currently listed tests.
+ * @param results - The per-id outcomes.
+ * @returns Passed/failed/skipped file counts.
+ */
+export function summarizeResults(tests, results) {
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    for (const test of tests) {
+        const entry = results[test.id];
+        if (!entry)
+            continue;
+        if (entry.status === 'passed')
+            passed += 1;
+        else if (entry.status === 'failed')
+            failed += 1;
+        else
+            skipped += 1;
+    }
+    return { passed, failed, skipped, reported: passed + failed + skipped };
+}
+/**
+ * Fold one streamed event into the run state.
+ *
+ * Deliberately total: an event for an id the card no longer lists is recorded
+ * anyway (a re-list may be in flight), and an unknown event type leaves the
+ * state untouched rather than throwing inside a stream handler.
+ *
+ * @param state - The current state.
+ * @param event - The event just received.
+ * @returns The next state (a new object whenever anything changed).
+ */
+export function applyTestRunEvent(state, event) {
+    switch (event.type) {
+        case 'start': {
+            // A new run clears the previous run's verdicts for the ids it covers, so
+            // a stale green pill never sits next to a row that is running again.
+            const results = { ...state.results };
+            for (const id of event.ids)
+                delete results[id];
+            return {
+                ...state,
+                runId: event.runId,
+                running: true,
+                queued: [...event.ids],
+                currentId: null,
+                output: [],
+                results,
+                outcome: null,
+                error: null,
+                startedAt: Date.now(),
+                durationMs: null,
+            };
+        }
+        case 'output': {
+            const output = [...state.output, ...event.chunk.split('\n')];
+            return {
+                ...state,
+                currentId: event.id ?? state.currentId,
+                output: output.length > MAX_OUTPUT_LINES ? output.slice(-MAX_OUTPUT_LINES) : output,
+            };
+        }
+        case 'result': {
+            return {
+                ...state,
+                results: {
+                    ...state.results,
+                    [event.id]: {
+                        status: event.status,
+                        ...(event.durationMs != null ? { durationMs: event.durationMs } : {}),
+                        passed: event.passed ?? 0,
+                        failed: event.failed ?? 0,
+                        skipped: event.skipped ?? 0,
+                        ...(event.output ? { output: event.output } : {}),
+                    },
+                },
+            };
+        }
+        case 'done': {
+            return {
+                ...state,
+                running: false,
+                currentId: null,
+                outcome: event.outcome,
+                error: event.error ?? null,
+                durationMs: event.durationMs ?? (state.startedAt ? Date.now() - state.startedAt : null),
+            };
+        }
+        default:
+            return state;
+    }
+}
+/**
+ * The state after a run that never produced a `done` event — the host's stream
+ * died, or its request failed before the server could answer.
+ *
+ * @param state - The current state.
+ * @param message - What to show in the card.
+ * @returns The next state, no longer running.
+ */
+export function failRun(state, message) {
+    return { ...state, running: false, currentId: null, outcome: 'error', error: message };
+}
+/**
+ * Whether a row should render as "running": the run is live and either the host
+ * named this row as current, or it is in the queue and has no verdict yet.
+ *
+ * @param state - The run state.
+ * @param id - The row's test id.
+ * @returns True when the row is part of the live run and still undecided.
+ */
+export function isRowRunning(state, id) {
+    if (!state.running)
+        return false;
+    if (state.currentId === id)
+        return true;
+    return state.queued.includes(id) && state.results[id] == null;
+}
+/**
+ * The label for a row: the host's title when it gave one, else the file path.
+ *
+ * @param item - The test.
+ * @returns The label to render.
+ */
+export function testRowLabel(item) {
+    return item.title?.trim() || item.file;
+}
+/**
+ * Filters tests by a free-text query, matching (case-insensitively) against the
+ * file path, the row title, and the project directory. A blank query returns
+ * every test in input order — the same contract as `filterScripts`.
+ *
+ * @param tests - The tests to filter.
+ * @param query - The search query.
+ * @returns The matching tests, in input order.
+ */
+export function filterTests(tests, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return [...tests];
+    return tests.filter((t) => t.file.toLowerCase().includes(q) ||
+        (t.title ?? '').toLowerCase().includes(q) ||
+        String(t.workspace).toLowerCase().includes(q));
+}
+/**
+ * Parses a `/test [query | all]` command (`/tests` is the registered alias).
+ *
+ * `all` is the one argument that ACTS: it runs everything immediately. Every
+ * other argument only filters the list, exactly the way `/scripts <query>` seeds
+ * the scripts browser — running ONE test by name is what the per-row Run button
+ * is for, and giving the argument a second meaning would make `/test <thing>`
+ * sometimes list and sometimes execute.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ query, runAll }` when it is a `/test` command, else `null`.
+ */
+export function parseTestCommand(input) {
+    const match = input.trim().match(/^\/tests?(?:\s+(.*))?$/i);
+    if (!match)
+        return null;
+    const argument = (match[1] ?? '').trim();
+    if (argument.toLowerCase() === 'all')
+        return { query: '', runAll: true };
+    return { query: argument, runAll: false };
+}
+//# sourceMappingURL=tests-card-utilities.js.map

package/dist/components/tests-card-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests-card-utilities.js","sourceRoot":"","sources":["../../src/components/tests-card-utilities.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -84,6 +84,25 @@
  *   the card steps aside while the banner is up — which only reads as one
  *   consistent message if the banner's button is resolved from the same
  *   `billingAction` the card used.
+ * - **`/test` lists and runs the project's tests** (`TestsCard`, opened by the
+ *   `/test` command — `/tests` is a registered alias — in the same closeable
+ *   overlay as `/scripts` and `/skills`, and renderable in the timeline as the
+ *   `tests` system card). It owns no routes: pass `listTests` and `runTests`
+ *   and the command works; omit either and it has nothing to run.
+ *   `runTests(selection, onEvent)` returns a handle whose `cancel()` must
+ *   really stop the run, and it must deliver exactly one `done` event however
+ *   the run ends — including when the request never opened — or the card spins
+ *   forever. `canRunTests` (a viewer: false) and `testsAvailable` (the
+ *   environment is up) each disable the run controls and state their own
+ *   reason in the card. The RUN is owned by `ChatPanel`, not the card, so it
+ *   keeps streaming while the overlay is closed. `/test all` runs everything;
+ *   any other argument only filters the list.
+ * - **End-to-end specs are meant to run against the LIVE PREVIEW.** The host
+ *   should drive them through `@molecule/app-e2e-preview` (what every
+ *   `mlcl create` app already bonds in `e2e/bonds.ts`), not a browser binary —
+ *   in a sandbox there is none. That bond drives the page the person is
+ *   actually looking at, so **a preview must be open** somewhere or the driver
+ *   waits and fails; the card says so next to the end-to-end group.
  * - Text routes through `t('ide.*')` — `@molecule/app-locales-ide` supplies
  *   translations.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,mBAAmB,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,mBAAmB,YAAY,CAAA"}

package/dist/index.js

@@ -84,6 +84,25 @@
  *   the card steps aside while the banner is up — which only reads as one
  *   consistent message if the banner's button is resolved from the same
  *   `billingAction` the card used.
+ * - **`/test` lists and runs the project's tests** (`TestsCard`, opened by the
+ *   `/test` command — `/tests` is a registered alias — in the same closeable
+ *   overlay as `/scripts` and `/skills`, and renderable in the timeline as the
+ *   `tests` system card). It owns no routes: pass `listTests` and `runTests`
+ *   and the command works; omit either and it has nothing to run.
+ *   `runTests(selection, onEvent)` returns a handle whose `cancel()` must
+ *   really stop the run, and it must deliver exactly one `done` event however
+ *   the run ends — including when the request never opened — or the card spins
+ *   forever. `canRunTests` (a viewer: false) and `testsAvailable` (the
+ *   environment is up) each disable the run controls and state their own
+ *   reason in the card. The RUN is owned by `ChatPanel`, not the card, so it
+ *   keeps streaming while the overlay is closed. `/test all` runs everything;
+ *   any other argument only filters the list.
+ * - **End-to-end specs are meant to run against the LIVE PREVIEW.** The host
+ *   should drive them through `@molecule/app-e2e-preview` (what every
+ *   `mlcl create` app already bonds in `e2e/bonds.ts`), not a browser binary —
+ *   in a sandbox there is none. That bond drives the page the person is
+ *   actually looking at, so **a preview must be open** somewhere or the driver
+ *   waits and fails; the card says so next to the end-to-end group.
  * - Text routes through `t('ide.*')` — `@molecule/app-locales-ide` supplies
  *   translations.
  *

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/dist/types.d.ts

@@ -65,6 +65,103 @@ export interface ChatUserIdentity {
     /** The clicked user's avatar value (data-URI / URL), if any. */
     avatar?: string | null;
 }
+/**
+ * Which project directory a test file belongs to: the directory that OWNS the
+ * file (the nearest ancestor holding the runner's config or a `package.json`),
+ * as a path relative to the workspace root — `app`, `api`, `my-app/app`,
+ * `packages/web` — or `.` for the workspace root itself. Nothing guarantees
+ * `app/` or `api/` at the root: the executor names its project directory, so
+ * the value is a path, not an enum.
+ */
+export type TestWorkspace = 'app' | 'api' | '.' | (string & {});
+/**
+ * What a test file is: an end-to-end spec driven against the LIVE PREVIEW (the
+ * `@molecule/app-e2e-preview` bond every scaffolded app carries), or a plain
+ * unit test run by the project's own runner.
+ */
+export type TestKind = 'e2e' | 'unit';
+/** One test file the host discovered in the project. */
+export interface TestItem {
+    /** Stable id, unique across workspaces — used as the row key and to select by. */
+    id: string;
+    /** Path relative to its workspace, e.g. `e2e/home.spec.ts`. */
+    file: string;
+    kind: TestKind;
+    workspace: TestWorkspace;
+    /**
+     * The group's project name, ready to render: the same path as `workspace`,
+     * or `null` for the workspace root, which has no name of its own. Hosts that
+     * omit it get the path itself (and the translated "Project" for the root).
+     */
+    workspaceLabel?: string | null;
+    /** Human label for the row; the bar falls back to the file path without one. */
+    title?: string;
+}
+/** Which runner drives each kind in one workspace (`null` = none installed). */
+export interface TestRunners {
+    e2e: string | null;
+    unit: string | null;
+}
+/** What {@link ChatPanelProps.listTests} resolves with. */
+export interface TestList {
+    tests: TestItem[];
+    /**
+     * Per project directory (keyed like {@link TestItem.workspace}), the runners
+     * the host found. Only directories that hold a listed test appear.
+     */
+    runners: Record<string, TestRunners>;
+}
+/** What the bar asks the host to run. */
+export interface TestSelection {
+    /** Specific {@link TestItem.id}s. Takes precedence over `kind`. */
+    ids?: string[];
+    /** Everything of this kind when no `ids` are given. */
+    kind?: TestKind | 'all';
+}
+/** How one test file ended. */
+export type TestStatus = 'passed' | 'failed' | 'skipped';
+/** How a whole run ended. */
+export type TestRunOutcome = 'completed' | 'cancelled' | 'timeout' | 'error';
+/**
+ * One event from a run in progress. The host streams these to the bar (over SSE
+ * in molecule.dev) in the order the run produces them: one `start`, then
+ * interleaved `output`/`result`, then exactly one `done`.
+ */
+export type TestRunEvent = {
+    type: 'start';
+    runId: string;
+    ids: string[];
+    startedAt?: string;
+} | {
+    type: 'output';
+    id?: string;
+    stream?: 'stdout' | 'stderr';
+    chunk: string;
+} | {
+    type: 'result';
+    id: string;
+    status: TestStatus;
+    durationMs?: number;
+    passed?: number;
+    failed?: number;
+    skipped?: number;
+    /** The runner's output for a FAILURE, which the bar keeps visible. */
+    output?: string;
+} | {
+    type: 'done';
+    runId?: string;
+    outcome: TestRunOutcome;
+    passed?: number;
+    failed?: number;
+    skipped?: number;
+    durationMs?: number;
+    error?: string;
+};
+/** Handle to a run in flight, so the bar can stop it. */
+export interface TestRunHandle {
+    /** Stop the run — the host aborts its stream, which cancels the work. */
+    cancel(): void;
+}
 /**
  * Props for the {@link ChatPanel} component — the IDE chat surface plus the
  * callbacks the host app uses to react to AI activity (file changes, boot, client
@@ -401,6 +498,45 @@ export interface ChatPanelProps {
      * modal — which POSTs to the project's own backend — is unaffected.
      */
     feedbackUrl?: string;
+    /**
+     * Lists the project's tests for the `/test` browser. Omit it (the default)
+     * and `/test` has nothing to show — the shared IDE owns no test-discovery
+     * route of its own.
+     *
+     * molecule.dev implements it over `GET /projects/:id/tests`. It is called
+     * on every `/test` invocation and once more when a run finishes, so a spec
+     * the agent just wrote shows up the next time the browser is opened.
+     */
+    listTests?: () => Promise<TestList>;
+    /**
+     * Runs the selected tests, streaming {@link TestRunEvent}s back as they
+     * happen. Required alongside {@link ChatPanelProps.listTests} for the
+     * browser's run controls to work.
+     *
+     * The returned handle's `cancel()` must stop the run (molecule.dev aborts the
+     * SSE request, and the server kills the process tree on disconnect). The host
+     * is responsible for running the e2e specs through the preview bond chain —
+     * in a sandbox that means `npx playwright test` with
+     * `@molecule/app-e2e-preview` as the browser, so the spec drives the live
+     * preview rather than a browser binary that is not installed there.
+     *
+     * The run is owned by `ChatPanel`, not by the card, so it keeps streaming
+     * while the browser is closed and is still there when it is re-opened.
+     */
+    runTests?: (selection: TestSelection, onEvent: (event: TestRunEvent) => void) => TestRunHandle;
+    /**
+     * Whether this viewer may RUN tests. `false` still lets them open `/test`
+     * and read what the project tests (the platform serves the listing to
+     * viewers) but disables every run control and shows why. Defaults to
+     * `canEdit !== false`.
+     */
+    canRunTests?: boolean;
+    /**
+     * Whether the environment the tests run in is up — a running sandbox.
+     * `false` makes `/test` say to start the project instead of listing an empty
+     * browser or letting a Run click fail. Defaults to `true`.
+     */
+    testsAvailable?: boolean;
     className?: string;
 }
 /**