@molecule/app-ide-react 1.12.1 → 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

@@ -73,6 +73,36 @@
  * - A custom card is a critical event only when its factory sets
  *   `critical: true` (a failure, a blocked action, a limit that stopped work) —
  *   the package never infers it from tone or copy.
+ * - `ChatPanel` owns no pricing or auth routes, so every limit/upgrade button
+ *   comes from the host's `buildUpgradeCta(context)`. The context forwards the
+ *   backend's whole description of the refusal: `requiresSignup`, `limitType`
+ *   (the rule that fired), `billingAction` (the remedy it resolved — e.g.
+ *   `add_funds`, `add_payment_method`, `raise_spend_cap`, `upgrade`, `none`) and
+ *   `upgradeTier` (`null` = no higher plan). Branch on `billingAction` first;
+ *   every field is optional, so keep a fallback. A live limit banner and a
+ *   recorded card that declares the same `coversLimitType` state one fact, so
+ *   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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;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

@@ -73,6 +73,36 @@
  * - A custom card is a critical event only when its factory sets
  *   `critical: true` (a failure, a blocked action, a limit that stopped work) —
  *   the package never infers it from tone or copy.
+ * - `ChatPanel` owns no pricing or auth routes, so every limit/upgrade button
+ *   comes from the host's `buildUpgradeCta(context)`. The context forwards the
+ *   backend's whole description of the refusal: `requiresSignup`, `limitType`
+ *   (the rule that fired), `billingAction` (the remedy it resolved — e.g.
+ *   `add_funds`, `add_payment_method`, `raise_spend_cap`, `upgrade`, `none`) and
+ *   `upgradeTier` (`null` = no higher plan). Branch on `billingAction` first;
+ *   every field is optional, so keep a fallback. A live limit banner and a
+ *   recorded card that declares the same `coversLimitType` state one fact, so
+ *   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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;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"}