@scenetest/dashboard 0.11.0 → 0.12.0

package/dist/collections/projections.d.ts

@@ -0,0 +1,117 @@
+import type { TeamMeta } from '@scenetest/protocol';
+import type { RunProjection } from './types.js';
+/**
+ * Every event carries its own `runId` (producers stamp it; see
+ * `@scenetest/protocol`). Rows from every run of a PR live in one collection,
+ * partitioned by that id, so the picker / rollups / flaky detection are
+ * queries over the rows rather than separate fetches. A new `run:start` opens
+ * a new partition — it does **not** truncate (that was the single-run
+ * behaviour; see `docs/public/design/unified-console.md`). Because the id is
+ * on the event, projections are stateless and a collection can attach
+ * mid-stream without having seen the run's `run:start`.
+ */
+/**
+ * Derived current-state of one scene, scoped to its run. Folded from a
+ * scene's `scene:start` / `scene:end` pair. The live timeline is
+ * `where runId = <latest>`.
+ */
+export interface SceneRow {
+    /** `${runId}:${teamIndex}:${name}` — stable across the scene's start/end. */
+    id: string;
+    runId: string;
+    name: string;
+    file: string;
+    actors: string[];
+    status: 'running' | 'completed' | 'failed' | 'timeout' | string;
+    startTime: number;
+    endTime: number | null;
+    duration: number | null;
+    error: string | null;
+    team: TeamMeta;
+    teamIndex: number;
+}
+export declare function scenesProjection(): RunProjection<SceneRow, string>;
+/**
+ * One row per inline assertion — the append-only end of the stream, scoped
+ * to its run. Keyed by `${runId}:${n}` (a per-projection monotonic index;
+ * the stream carries no assertion id).
+ *
+ * `sceneId` is the owning scene's {@link SceneRow.id} when the producer stamped
+ * `scene`/`teamIndex` on the event (the precise path); it's `null` for runs
+ * recorded before producers did so, where the consumer attributes by
+ * actor+time-window instead (see {@link attributeToScene}).
+ */
+export interface AssertionRecord {
+    id: string;
+    runId: string;
+    actor: string | null;
+    description: string;
+    result: boolean;
+    timestamp: number;
+    sceneId: string | null;
+}
+export declare function assertionsProjection(): RunProjection<AssertionRecord, string>;
+/**
+ * Attribute an event row to a scene. Prefers the stamped `sceneId` (precise,
+ * concurrency-safe); falls back to actor + time-window for rows from older
+ * producers: the scene of the same run whose `actors` include `actor` and
+ * whose `[startTime, endTime]` window contains `timestamp`. The window is
+ * open-ended while a scene is still running (`endTime === null`). Returns the
+ * matching scene's id, or `null` when nothing attributes (e.g. an actor-less
+ * inline assertion on an old run).
+ */
+export declare function attributeToScene(row: {
+    sceneId: string | null;
+    runId: string;
+    actor: string | null;
+    timestamp: number;
+}, scenes: Iterable<SceneRow>): string | null;
+/**
+ * One row per DSL action, paired from its `action:start` / `action:end`. The
+ * projection mints an id on start and updates the same row on end, tracking
+ * open actions per `actor+action` (the stream carries no action id). `sceneId`
+ * comes from a stamped `scene`/`teamIndex` on the start event when present;
+ * otherwise the consumer attributes by actor+time-window like assertions.
+ */
+export interface ActionRecord {
+    id: string;
+    runId: string;
+    actor: string;
+    action: string;
+    target: string | null;
+    startTime: number;
+    endTime: number | null;
+    duration: number | null;
+    error: string | null;
+    status: 'running' | 'success' | 'error';
+    sceneId: string | null;
+    /** Start timestamp — the time used for actor+time-window attribution. */
+    timestamp: number;
+}
+export declare function actionsProjection(): RunProjection<ActionRecord, string>;
+/**
+ * One row per run — the picker, the "most recent" rollup, and (later) flaky
+ * detection are all live queries over this table. Folded from `run:start`
+ * (insert), `scene:end` (incremental pass/fail counts so the rollup is live),
+ * and `run:end` (authoritative counts + duration from the summary).
+ *
+ * `pr` / `branch` are stamped by the report loader from the filename
+ * (`pr-{num}-{timestamp}-…`), not the event stream, so they're absent for a
+ * live local run.
+ */
+export interface RunRow {
+    /** runId — the `run:start` timestamp. */
+    id: string;
+    startTime: number;
+    endTime: number | null;
+    duration: number | null;
+    status: 'running' | 'finished' | string;
+    /** Expected scene count from `run:start`. */
+    sceneCount: number;
+    completed: number;
+    failed: number;
+    pr?: number;
+    branch?: string;
+}
+export declare function runsProjection(): RunProjection<RunRow, string>;
+//# sourceMappingURL=projections.d.ts.map

package/dist/collections/projections.d.ts.map

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

package/dist/collections/projections.js

@@ -0,0 +1,228 @@
+function sceneKey(runId, teamIndex, name) {
+    return `${runId}:${teamIndex}:${name}`;
+}
+export function scenesProjection() {
+    return {
+        id: 'scenes',
+        getKey: (row) => row.id,
+        project(event, get) {
+            switch (event.type) {
+                case 'scene:start': {
+                    const row = {
+                        id: sceneKey(event.runId, event.teamIndex, event.name),
+                        runId: event.runId,
+                        name: event.name,
+                        file: event.file,
+                        actors: event.actors.slice(),
+                        status: 'running',
+                        startTime: event.timestamp,
+                        endTime: null,
+                        duration: null,
+                        error: null,
+                        team: event.team,
+                        teamIndex: event.teamIndex,
+                    };
+                    return [{ type: 'insert', value: row }];
+                }
+                case 'scene:end': {
+                    const prev = get(sceneKey(event.runId, event.teamIndex, event.name));
+                    if (!prev)
+                        return [];
+                    return [
+                        {
+                            type: 'update',
+                            value: {
+                                ...prev,
+                                status: event.status,
+                                endTime: event.timestamp,
+                                duration: event.duration,
+                                error: event.error ?? null,
+                            },
+                        },
+                    ];
+                }
+                default:
+                    return [];
+            }
+        },
+    };
+}
+export function assertionsProjection() {
+    let next = 0;
+    return {
+        id: 'assertions',
+        getKey: (row) => row.id,
+        project(event) {
+            if (event.type === 'assertion') {
+                return [
+                    {
+                        type: 'insert',
+                        value: {
+                            id: `${event.runId}:${next++}`,
+                            runId: event.runId,
+                            actor: event.actor ?? null,
+                            description: event.description,
+                            result: event.result,
+                            timestamp: event.timestamp,
+                            sceneId: event.scene !== undefined && event.teamIndex !== undefined
+                                ? sceneKey(event.runId, event.teamIndex, event.scene)
+                                : null,
+                        },
+                    },
+                ];
+            }
+            return [];
+        },
+    };
+}
+/**
+ * Attribute an event row to a scene. Prefers the stamped `sceneId` (precise,
+ * concurrency-safe); falls back to actor + time-window for rows from older
+ * producers: the scene of the same run whose `actors` include `actor` and
+ * whose `[startTime, endTime]` window contains `timestamp`. The window is
+ * open-ended while a scene is still running (`endTime === null`). Returns the
+ * matching scene's id, or `null` when nothing attributes (e.g. an actor-less
+ * inline assertion on an old run).
+ */
+export function attributeToScene(row, scenes) {
+    if (row.sceneId)
+        return row.sceneId;
+    if (!row.actor)
+        return null;
+    for (const scene of scenes) {
+        if (scene.runId !== row.runId)
+            continue;
+        if (!scene.actors.includes(row.actor))
+            continue;
+        if (row.timestamp < scene.startTime)
+            continue;
+        if (scene.endTime !== null && row.timestamp > scene.endTime)
+            continue;
+        return scene.id;
+    }
+    return null;
+}
+export function actionsProjection() {
+    let next = 0;
+    const open = new Map();
+    const openKey = (actor, action) => JSON.stringify([actor, action]);
+    return {
+        id: 'actions',
+        getKey: (row) => row.id,
+        project(event, get) {
+            if (event.type === 'action:start') {
+                const id = `${event.runId}:${next++}`;
+                open.set(openKey(event.actor, event.action), id);
+                const sceneId = event.scene !== undefined && event.teamIndex !== undefined
+                    ? sceneKey(event.runId, event.teamIndex, event.scene)
+                    : null;
+                return [
+                    {
+                        type: 'insert',
+                        value: {
+                            id,
+                            runId: event.runId,
+                            actor: event.actor,
+                            action: event.action,
+                            target: event.target ?? null,
+                            startTime: event.timestamp,
+                            endTime: null,
+                            duration: null,
+                            error: null,
+                            status: 'running',
+                            sceneId,
+                            timestamp: event.timestamp,
+                        },
+                    },
+                ];
+            }
+            if (event.type === 'action:end') {
+                const key = openKey(event.actor, event.action);
+                const id = open.get(key);
+                if (id === undefined)
+                    return [];
+                open.delete(key);
+                const prev = get(id);
+                if (!prev)
+                    return [];
+                return [
+                    {
+                        type: 'update',
+                        value: {
+                            ...prev,
+                            endTime: event.timestamp,
+                            duration: event.duration,
+                            error: event.error ?? null,
+                            status: event.error ? 'error' : 'success',
+                        },
+                    },
+                ];
+            }
+            return [];
+        },
+    };
+}
+export function runsProjection() {
+    return {
+        id: 'runs',
+        getKey: (row) => row.id,
+        project(event, get) {
+            switch (event.type) {
+                case 'run:start': {
+                    return [
+                        {
+                            type: 'insert',
+                            value: {
+                                id: event.runId,
+                                startTime: event.timestamp,
+                                endTime: null,
+                                duration: null,
+                                status: 'running',
+                                sceneCount: event.sceneCount,
+                                completed: 0,
+                                failed: 0,
+                            },
+                        },
+                    ];
+                }
+                case 'scene:end': {
+                    const prev = get(event.runId);
+                    if (!prev)
+                        return [];
+                    const passed = event.status === 'completed';
+                    return [
+                        {
+                            type: 'update',
+                            value: {
+                                ...prev,
+                                completed: prev.completed + (passed ? 1 : 0),
+                                failed: prev.failed + (passed ? 0 : 1),
+                            },
+                        },
+                    ];
+                }
+                case 'run:end': {
+                    const prev = get(event.runId);
+                    if (!prev)
+                        return [];
+                    return [
+                        {
+                            type: 'update',
+                            value: {
+                                ...prev,
+                                status: 'finished',
+                                endTime: event.timestamp,
+                                duration: event.duration,
+                                completed: event.summary?.completed ?? prev.completed,
+                                failed: event.summary?.failed ?? prev.failed,
+                            },
+                        },
+                    ];
+                }
+                default:
+                    return [];
+            }
+        },
+    };
+}
+//# sourceMappingURL=projections.js.map

package/dist/collections/projections.js.map

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

package/dist/collections/source.d.ts

@@ -0,0 +1,32 @@
+import type { Transport } from '../types.js';
+import type { RunSource } from './types.js';
+/**
+ * Wrap a {@link Transport} as a shared {@link RunSource}: one
+ * `transport.subscribe` fanned out to many collections.
+ *
+ * Why a layer over the transport at all? Each `createDevTransport()`
+ * subscription opens its own `EventSource`; a per-collection subscription
+ * would mean N SSE/WebSocket connections for N tables of the same run. The
+ * source opens exactly one and multiplexes it, and buffers the current run
+ * so a collection created mid-run replays the events it missed — the same
+ * catch-up the transports give a fresh connection, but shared.
+ *
+ * The underlying transport subscription starts lazily on the first
+ * `subscribe` and stays open (it does not drop when the last collection
+ * detaches, since TanStack DB pauses sync when a collection has no active
+ * subscribers, and we want the run to keep accumulating across those gaps).
+ * Call {@link RunSource.close} to tear it down for good.
+ *
+ * The buffer holds **every** event of the connection — across runs — so a
+ * collection attaching mid-session replays the full history (the multi-run
+ * read model wants prior runs, not just the current one). `run:start` does
+ * not clear it; it just marks a new run partition downstream. Cap/eviction
+ * is a future concern; today a session's history is bounded.
+ *
+ * History/ordering/de-duplication are the transport's contract — both the
+ * dev (SSE) and cloud (WebSocket) adapters replay on connect and deliver
+ * events in order. The source does not re-derive `seq`; it consumes whatever
+ * the subscription delivers.
+ */
+export declare function createRunSource(transport: Transport): RunSource;
+//# sourceMappingURL=source.d.ts.map

package/dist/collections/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/collections/source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAK3C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAwD/D"}

package/dist/collections/source.js

@@ -0,0 +1,84 @@
+/**
+ * Wrap a {@link Transport} as a shared {@link RunSource}: one
+ * `transport.subscribe` fanned out to many collections.
+ *
+ * Why a layer over the transport at all? Each `createDevTransport()`
+ * subscription opens its own `EventSource`; a per-collection subscription
+ * would mean N SSE/WebSocket connections for N tables of the same run. The
+ * source opens exactly one and multiplexes it, and buffers the current run
+ * so a collection created mid-run replays the events it missed — the same
+ * catch-up the transports give a fresh connection, but shared.
+ *
+ * The underlying transport subscription starts lazily on the first
+ * `subscribe` and stays open (it does not drop when the last collection
+ * detaches, since TanStack DB pauses sync when a collection has no active
+ * subscribers, and we want the run to keep accumulating across those gaps).
+ * Call {@link RunSource.close} to tear it down for good.
+ *
+ * The buffer holds **every** event of the connection — across runs — so a
+ * collection attaching mid-session replays the full history (the multi-run
+ * read model wants prior runs, not just the current one). `run:start` does
+ * not clear it; it just marks a new run partition downstream. Cap/eviction
+ * is a future concern; today a session's history is bounded.
+ *
+ * History/ordering/de-duplication are the transport's contract — both the
+ * dev (SSE) and cloud (WebSocket) adapters replay on connect and deliver
+ * events in order. The source does not re-derive `seq`; it consumes whatever
+ * the subscription delivers.
+ */
+export function createRunSource(transport) {
+    const eventListeners = new Set();
+    const statusListeners = new Set();
+    // Buffered events for the whole session, replayed to late subscribers.
+    let buffer = [];
+    let status = 'connecting';
+    let unsubscribeTransport = null;
+    let closed = false;
+    function onTransportEvent(event) {
+        buffer.push(event);
+        for (const listener of [...eventListeners])
+            listener(event);
+    }
+    function onTransportStatus(next) {
+        status = next;
+        for (const listener of [...statusListeners])
+            listener(next);
+    }
+    function ensureStarted() {
+        if (unsubscribeTransport || closed)
+            return;
+        unsubscribeTransport = transport.subscribe(onTransportEvent, onTransportStatus);
+    }
+    return {
+        get status() {
+            return status;
+        },
+        subscribe(onEvent, onStatus) {
+            if (closed)
+                return () => { };
+            eventListeners.add(onEvent);
+            if (onStatus)
+                statusListeners.add(onStatus);
+            // Replay the current run so a collection attaching mid-run catches up,
+            // then report the current liveness.
+            for (const event of buffer)
+                onEvent(event);
+            onStatus?.(status);
+            ensureStarted();
+            return () => {
+                eventListeners.delete(onEvent);
+                if (onStatus)
+                    statusListeners.delete(onStatus);
+            };
+        },
+        close() {
+            closed = true;
+            unsubscribeTransport?.();
+            unsubscribeTransport = null;
+            eventListeners.clear();
+            statusListeners.clear();
+            buffer = [];
+        },
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/collections/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/collections/source.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAA;IAC/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAA;IACjD,uEAAuE;IACvE,IAAI,MAAM,GAAe,EAAE,CAAA;IAC3B,IAAI,MAAM,GAAqB,YAAY,CAAA;IAC3C,IAAI,oBAAoB,GAAwB,IAAI,CAAA;IACpD,IAAI,MAAM,GAAG,KAAK,CAAA;IAElB,SAAS,gBAAgB,CAAC,KAAe;QACvC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,cAAc,CAAC;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7D,CAAC;IAED,SAAS,iBAAiB,CAAC,IAAsB;QAC/C,MAAM,GAAG,IAAI,CAAA;QACb,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,eAAe,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC7D,CAAC;IAED,SAAS,aAAa;QACpB,IAAI,oBAAoB,IAAI,MAAM;YAAE,OAAM;QAC1C,oBAAoB,GAAG,SAAS,CAAC,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAA;IACjF,CAAC;IAED,OAAO;QACL,IAAI,MAAM;YACR,OAAO,MAAM,CAAA;QACf,CAAC;QAED,SAAS,CAAC,OAAO,EAAE,QAAQ;YACzB,IAAI,MAAM;gBAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;YAC3B,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAC3B,IAAI,QAAQ;gBAAE,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAE3C,uEAAuE;YACvE,oCAAoC;YACpC,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAA;YAC1C,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAA;YAElB,aAAa,EAAE,CAAA;YAEf,OAAO,GAAG,EAAE;gBACV,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBAC9B,IAAI,QAAQ;oBAAE,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAChD,CAAC,CAAA;QACH,CAAC;QAED,KAAK;YACH,MAAM,GAAG,IAAI,CAAA;YACb,oBAAoB,EAAE,EAAE,CAAA;YACxB,oBAAoB,GAAG,IAAI,CAAA;YAC3B,cAAc,CAAC,KAAK,EAAE,CAAA;YACtB,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,MAAM,GAAG,EAAE,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/collections/types.d.ts

@@ -0,0 +1,87 @@
+import type { RunEvent } from '@scenetest/protocol';
+import type { ConnectionStatus, Transport } from '../types.js';
+/**
+ * One row operation a projection emits for a single event. The collection
+ * options factory translates these into TanStack DB sync writes:
+ *
+ * - `insert` / `update` → `write({ type, value })` (key derived via `getKey`)
+ * - `delete`            → `write({ type: 'delete', key })`
+ * - `reset`            → `truncate()` (drop every row)
+ *
+ * The multi-run projections don't emit `reset` (a new `run:start` opens a new
+ * partition rather than wiping), but it stays in the vocabulary for projections
+ * that need a hard clear — e.g. switching the PR/context a collection tracks.
+ *
+ * Projections never touch TanStack DB directly; they speak this small,
+ * pure vocabulary, which keeps them trivially testable.
+ */
+export type RowOp<T extends object, TKey extends string | number> = {
+    type: 'insert' | 'update';
+    value: T;
+} | {
+    type: 'delete';
+    key: TKey;
+} | {
+    type: 'reset';
+};
+/**
+ * A projection folds the read-only `RunEvent` stream into the rows of one
+ * collection — the "sync reducer" the proposal describes. It is the only
+ * writer for its table, and it is pure given the event and a reader for the
+ * rows it has already produced (`get`), so an `update` can be computed from
+ * the prior value.
+ *
+ * A projection may carry internal counter state (e.g. to mint ids for
+ * append-only rows), so create one per collection via a factory rather than
+ * sharing a singleton.
+ */
+export interface RunProjection<T extends object, TKey extends string | number = string> {
+    /** Stable identifier, used as the collection's default `id`. */
+    readonly id: string;
+    /** Key extractor for rows of this collection. */
+    getKey(row: T): TKey;
+    /**
+     * Fold one event into row operations. `get` reads a row this projection
+     * has already emitted (the synced state), so updates merge onto it.
+     * Returns an empty array for events this collection does not care about.
+     */
+    project(event: RunEvent, get: (key: TKey) => T | undefined): Array<RowOp<T, TKey>>;
+}
+/**
+ * A shared, read-only handle on a single run's event stream. It wraps one
+ * `Transport.subscribe` and fans it out to any number of collections, so
+ * several collections can "attach to the same websocket, different table"
+ * off one underlying connection.
+ *
+ * Late subscribers are replayed the current run's buffered events on
+ * `subscribe`, so a collection created after the run started still catches
+ * up. The buffer resets on `run:start`.
+ */
+export interface RunSource {
+    /**
+     * Attach a consumer. `onEvent` is first called synchronously for every
+     * buffered event of the current run, then for each live event.
+     * `onStatus`, if given, receives connection-liveness changes (and the
+     * current status immediately). Returns an unsubscribe function.
+     */
+    subscribe(onEvent: (event: RunEvent) => void, onStatus?: (status: ConnectionStatus) => void): () => void;
+    /** Latest connection liveness reported by the transport. */
+    readonly status: ConnectionStatus;
+    /** Tear down the underlying transport subscription and drop the buffer. */
+    close(): void;
+}
+/** Options for {@link runCollectionOptions}. */
+export interface RunCollectionOptions<T extends object, TKey extends string | number> {
+    /** The shared stream this collection reads from. */
+    source: RunSource;
+    /** The projection that folds events into this collection's rows. */
+    projection: RunProjection<T, TKey>;
+    /**
+     * Whether to begin syncing on collection creation rather than on first
+     * query. Defaults to `true` so the read model captures the run from the
+     * moment it is created, not from the first `useLiveQuery`.
+     */
+    startSync?: boolean;
+}
+export type { Transport };
+//# sourceMappingURL=types.d.ts.map

package/dist/collections/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/collections/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM,IAC5D;IAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAErB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM;IACpF,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;CACnF;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,SAAS,CACP,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,EAClC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC5C,MAAM,IAAI,CAAA;IACb,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAA;CACd;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM;IAClF,oDAAoD;IACpD,MAAM,EAAE,SAAS,CAAA;IACjB,oEAAoE;IACpE,UAAU,EAAE,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,YAAY,EAAE,SAAS,EAAE,CAAA"}

package/dist/collections/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/collections/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/collections/types.ts"],"names":[],"mappings":""}

package/dist/dashboard.d.ts

@@ -0,0 +1,20 @@
+import type { DashboardTheme, Transport } from './types.js';
+/**
+ * The Dashboard app — Home / Runner / Waterfall views over one read-only
+ * `@tanstack/db` read model, routed on `location.pathname`. A plain Preact
+ * component rendering into the light DOM under a single `.scenetest-dashboard`
+ * root class; the shipped stylesheet scopes everything to it. Dev and cloud
+ * render the same component — only the injected `transport` differs.
+ *
+ *   /__scenetest            → Home
+ *   /__scenetest/runner     → Runner (filterable scene log)
+ *   /__scenetest/waterfall  → Waterfall (live timeline)
+ *
+ * The collections are the single store: the component builds them from the run
+ * stream and every view reads from them (`selectWaterfall`, `selectSnapshot`).
+ */
+export declare function Dashboard({ transport, theme, }: {
+    transport: Transport;
+    theme?: DashboardTheme;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAoB,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAiE7E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,KAAK,GACN,EAAE;IACD,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB,gCAyDA"}