@reactra/devtools 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akhil Shastri and the Reactra contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# @reactra/devtools
+
+The Reactra **developer panel** — a drop-in devtools drawer for any Reactra
+app. Mount it once in your root layout behind a dev guard:
+
+```tsx
+import { ReactraDevtools } from "@reactra/devtools"
+
+// in _layout.tsx (or your root wrapper):
+{import.meta.env.DEV && <ReactraDevtools defaultOpen />}
+```
+
+It is a **UI companion** package (Runtime spec §2 / §3): hand-mounted, never
+imported by compiler-emitted code — an app that doesn't mount it ships none
+of it.
+
+## What you get
+
+- **Components** — live hook-slot snapshot per component: state, derived,
+  service, action, resource binding groups; changed-key flash on each commit;
+  `[▶ run]` rows to invoke actions directly (0-arg and multi-arg JSON);
+  inline DVT004 error on bad JSON or action throw.
+- **Stores** — all registered stores with kind chips (export / session / route);
+  live snapshots that update in real time; idle/live lifecycle badge for route
+  stores; `preserved` badge on Store §6 preserved-state fields; `[▶ run]`
+  rows for store actions.
+- **Router** — current-route card (id / pattern / pathname / raw + coerced
+  params + query); full route manifest with highlight on the active route;
+  timestamped nav log of every transition.
+- **⏪ Time Travel** — scrub the app's passive commit history; REPLAYING banner
+  while traveling; ⏮/⏵/▶ transport; `⟲ live` badge on components that
+  support live re-drive, `(view)` on commit-only components; ⏎ live exits
+  replay mode and re-arms recording.
+
+To unlock **live re-drive** on a component, add `uses replayable` to it
+(Replay spec §4). Without it the Time Travel tab is view-only (DVT003 teaching
+chip shows when no replayable component is mounted on the current route).
+
+## Props (`ReactraDevtoolsProps`)
+
+| Prop | Type | Default | Purpose |
+|---|---|---|---|
+| `defaultOpen` | `boolean` | `false` | Open the drawer on mount (collapsed pill otherwise) |
+| `historyLimit` | `number` | `5000` | Passive-history ring capacity in commits; DVT005 alert fires on eviction |
+| `record` | `boolean` | `true` | Arm the passive recorder at mount; set `false` to start paused |
+
+## DVT001 degradation
+
+If `globalThis.__REACTRA_TEST__` is already installed by another consumer
+(e.g. `@reactra/testing`'s `renderReactra`) when the panel mounts, the panel
+degrades gracefully: the **Components** tab and passive **Time Travel** ring
+are disabled (DVT001 warning shown); the **Stores** and **Router** tabs
+continue to work normally. The occupant is never overwritten.
+
+## Hybrid Time Travel
+
+The Time Travel tab uses the app's passive commit ring (recorded via the
+`__REACTRA_TEST__` hook) as its timeline source. Live re-drive is capability-
+based: the panel calls `applyReplayState` on each scrub stop, and components
+that carry `uses replayable` apply the state to their live React hooks (⟲ live
+badge); components that don't are shown as `(view)`. Both modes coexist in the
+same scrub session — you can have one replayable page component and several
+view-only child components.
+
+See `examples/devtools-tour` for a full tour of all four tabs.
+
+## Spec references
+
+- Devtools spec (`reactra-devtools-spec.md`) — DVT001–DVT005, four-tab design,
+  popup-out, hybrid time travel
+- Runtime spec §2 (UI-companion tier) / §3 (hook-slot data sources)
+
+## Node-portability
+
+No JSX in source (written against `React.createElement`), no `.css` imports
+(one `<style>` tag injected behind a `typeof document` guard), browser globals
+only inside handlers. `import("@reactra/devtools")` works under plain
+Node ≥ 22.18.

package/dist/ValueTree.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode } from "react";
+import type { Serialized } from "./serialize.ts";
+/**
+ * Props for a single value-tree node.
+ * `changed` is passed through from the parent to highlight top-level keys.
+ */
+export interface ValueNodeProps {
+    /** The label/key name for this node (undefined for top-level roots). */
+    label?: string;
+    /** The serialized value to render. */
+    value: Serialized;
+    /** Whether this node's value has changed since the last render. */
+    changed?: boolean;
+    /** Nesting depth — used to limit initial expansion. */
+    depth?: number;
+}
+/** A single tree node — may recurse for objects/arrays. */
+export declare const ValueNode: (props: ValueNodeProps) => ReactNode;
+/**
+ * Render a Record<string, Serialized> as a value tree — the top-level
+ * replacement for the flat key-value list in Components + Stores + Router
+ * + Time Travel cards.
+ *
+ * `changed` is a Set of top-level key names that changed since the last
+ * render (drives the yellow highlight / fade animation).
+ */
+export interface ValueTreeProps {
+    /** The data to display (output of serialize.ts). */
+    data: Record<string, Serialized>;
+    /** Keys that changed since the last render (optional). */
+    changed?: ReadonlySet<string>;
+}
+/**
+ * Value tree root — renders each key as a collapsible ValueNode. Replaces
+ * the flat `JSON.stringify(v)` row list in all four tabs.
+ */
+export declare const ValueTree: (props: ValueTreeProps) => ReactNode;
+//# sourceMappingURL=ValueTree.d.ts.map

package/dist/ValueTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueTree.d.ts","sourceRoot":"","sources":["../src/ValueTree.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACpE,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,gBAAgB,CAAA;AA2B1E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,KAAK,EAAE,UAAU,CAAA;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AA6BD,2DAA2D;AAC3D,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,KAAG,SA2HjD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAChC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,KAAG,SAiBjD,CAAA"}

package/dist/ValueTree.js

@@ -0,0 +1,178 @@
+// @reactra/devtools — recursive value-tree renderer (T1.2).
+//
+// Owner: reactra-devtools-spec.md §4 (binding cards). Renders a serialized
+// value (from serialize.ts) as collapsible tree nodes: objects → `{N keys}`
+// summary, arrays → `[N items]`, primitives inline. The tree replaces
+// the flat JSON.stringify(v) rendering in Components / Stores / Router /
+// Time Travel cards.
+//
+// UI-companion tier rules: createElement ONLY (no JSX); browser globals
+// (clipboard) only inside handlers.
+import { createElement as h, useState } from "react";
+/** Whether a serialized value is a resource-status projection. */
+const isResourceProj = (v) => v !== null &&
+    typeof v === "object" &&
+    !Array.isArray(v) &&
+    typeof v.status === "string" &&
+    ["pending", "resolved", "error"].includes(v.status);
+/** Determine if a value should render as a collapsible container. */
+const isExpandable = (v) => {
+    if (v === null || v === undefined)
+        return false;
+    if (isResourceProj(v))
+        return v.status === "resolved" && "value" in v;
+    if (Array.isArray(v))
+        return v.length > 0;
+    if (typeof v === "object")
+        return Object.keys(v).length > 0;
+    return false;
+};
+/** Inline summary for collapsed containers. */
+const summary = (v) => {
+    if (Array.isArray(v))
+        return `[${v.length}]`;
+    if (isResourceProj(v))
+        return `(${v.status})`;
+    if (typeof v === "object" && v !== null)
+        return `{${Object.keys(v).length}}`;
+    return String(v);
+};
+/** The copy-to-clipboard affordance (UX#6). */
+const CopyButton = ({ value }) => {
+    const [copied, setCopied] = useState(false);
+    const copy = () => {
+        // navigator.clipboard is only available in secure contexts + browser.
+        // Guarded per plan constraint: browser globals only in handlers.
+        if (typeof navigator === "undefined" || !navigator.clipboard)
+            return;
+        const text = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+        navigator.clipboard.writeText(text).then(() => {
+            setCopied(true);
+            setTimeout(() => setCopied(false), 1200);
+        }).catch(() => { });
+    };
+    return h("button", {
+        className: "rdt-copy",
+        onClick: copy,
+        title: "Copy value",
+        "aria-label": "Copy value to clipboard",
+    }, copied ? "✓" : "⎘");
+};
+/** A single tree node — may recurse for objects/arrays. */
+export const ValueNode = (props) => {
+    const { label, value, changed = false, depth = 0 } = props;
+    // Auto-expand the first level; deeper levels start collapsed.
+    const [expanded, setExpanded] = useState(depth < 1);
+    const expandable = isExpandable(value);
+    // ---- Primitive / leaf rendering ----------------------------------------
+    if (!expandable) {
+        let valClass = "rdt-tree-val";
+        let displayVal;
+        if (value === null) {
+            valClass += " rdt-tree-val--null";
+            displayVal = "null";
+        }
+        else if (value === undefined) {
+            valClass += " rdt-tree-val--null";
+            displayVal = "undefined";
+        }
+        else if (typeof value === "string") {
+            if (value === "[unserializable]") {
+                valClass += " rdt-tree-val--sentinel";
+                displayVal = value;
+            }
+            else {
+                valClass += " rdt-tree-val--str";
+                displayVal = JSON.stringify(value);
+            }
+        }
+        else if (typeof value === "number") {
+            valClass += " rdt-tree-val--num";
+            displayVal = String(value);
+        }
+        else if (typeof value === "boolean") {
+            valClass += " rdt-tree-val--bool";
+            displayVal = String(value);
+        }
+        else if (isResourceProj(value)) {
+            valClass += " rdt-tree-val--resource";
+            displayVal = `(${value.status})`;
+        }
+        else if (Array.isArray(value)) {
+            // Empty array (non-empty arrays are expandable) — render `[]`, not "".
+            displayVal = "[]";
+        }
+        else if (typeof value === "object" && value !== null) {
+            // Empty object (non-empty objects are expandable) — render `{}`, not
+            // String({}) === "[object Object]".
+            displayVal = "{}";
+        }
+        else {
+            displayVal = String(value);
+        }
+        const changedClass = changed ? " rdt-v--changed" : "";
+        return h("div", { className: "rdt-tree-node" }, label !== undefined && h("span", { className: "rdt-tree-key" }, `${label}: `), h("span", { className: `${valClass}${changedClass}` }, displayVal), h(CopyButton, { value }));
+    }
+    // ---- Expandable container rendering ------------------------------------
+    const toggleLabel = expanded ? "▾" : "▸";
+    // Build children based on value type.
+    const children = [];
+    if (Array.isArray(value)) {
+        ;
+        value.forEach((item, i) => {
+            children.push(h(ValueNode, {
+                key: String(i),
+                label: String(i),
+                value: item,
+                depth: depth + 1,
+            }));
+        });
+    }
+    else if (isResourceProj(value) && value.status === "resolved") {
+        const rp = value;
+        if ("value" in rp) {
+            children.push(h(ValueNode, {
+                key: "value",
+                label: "value",
+                value: rp.value,
+                depth: depth + 1,
+            }));
+        }
+    }
+    else if (typeof value === "object" && value !== null) {
+        for (const [k, v] of Object.entries(value)) {
+            children.push(h(ValueNode, {
+                key: k,
+                label: k,
+                value: v,
+                depth: depth + 1,
+            }));
+        }
+    }
+    const changedClass = changed ? " rdt-v--changed" : "";
+    const sumText = summary(value);
+    return h("div", { className: "rdt-tree-node" }, h("span", { style: { display: "inline-flex", alignItems: "center", gap: 2 } }, h("button", {
+        className: "rdt-tree-toggle",
+        onClick: () => setExpanded((e) => !e),
+        "aria-expanded": expanded,
+        "aria-label": expanded ? "Collapse" : "Expand",
+    }, toggleLabel), label !== undefined && h("span", { className: "rdt-tree-key" }, `${label}: `), h("span", { className: `rdt-tree-val${changedClass}` }, sumText), h(CopyButton, { value })), expanded && h("div", { className: "rdt-tree-children" }, ...children));
+};
+/**
+ * Value tree root — renders each key as a collapsible ValueNode. Replaces
+ * the flat `JSON.stringify(v)` row list in all four tabs.
+ */
+export const ValueTree = (props) => {
+    const { data, changed = new Set() } = props;
+    const entries = Object.entries(data);
+    if (entries.length === 0)
+        return null;
+    return h("div", { className: "rdt-tree" }, ...entries.map(([k, v]) => h(ValueNode, {
+        key: k,
+        label: k,
+        value: v,
+        changed: changed.has(k),
+        depth: 0,
+    })));
+};
+//# sourceMappingURL=ValueTree.js.map

package/dist/ValueTree.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,59 @@
+import type { SessionBundle } from "@reactra/behaviours/replayable";
+/**
+ * The data-valued projection of a hook bindings object (Devtools §7):
+ * function values are dropped (actions/setters aren't state). Values are
+ * depth/size-capped (serialize.ts) and resource handles emit a
+ * status-projection (DVT-LIM-04 resolution). One bad binding never poisons
+ * a commit — unserializable values become the `"[unserializable]"` sentinel.
+ */
+export declare const dataBindings: (bindings: Record<string, unknown>) => Record<string, unknown>;
+/** Names of the function-valued bindings — the §4 `▶ run` candidates. */
+export declare const callableNames: (bindings: Record<string, unknown>) => string[];
+/**
+ * Grouped bindings — separates data members from callable members (T1.3).
+ * Preserves the Testing §2 normative order within each bucket:
+ *   data: props, state, derived, behaviour (non-callable by nature), resource
+ *   actions: action functions
+ *
+ * The split is structural: function-valued keys go to `actions`, everything
+ * else to `data`. This matches the §4 intent (data section above actions).
+ */
+export declare const groupBindings: (bindings: Record<string, unknown>) => {
+    data: Record<string, unknown>;
+    actions: Record<string, unknown>;
+};
+/**
+ * RELATIVE staleness heuristic (DVT-LIM-01; T2.2 re-disposition): an entry
+ * is stale ONLY if it missed the latest commit wave while other components
+ * committed in that wave. This prevents static pages (where nothing commits)
+ * from incorrectly flagging everything as stale.
+ *
+ * `lastSeen` — wall-clock time of the component's last commit.
+ * `latestWaveTime` — wall-clock time of the most recent commit across ALL
+ *    tracked components (the "wave front"). Pass 0 / undefined to disable
+ *    relative staleness (nothing is stale when no new commits arrived).
+ * `thresholdMs` — a component is stale if it's older than `latestWaveTime`
+ *    by at least this many ms AND another component committed recently (default 2000ms).
+ *
+ * Back-compat: the two-argument form `isStale(lastSeen, now)` still works —
+ * it passes `now` as `latestWaveTime` so the absolute-threshold behavior is
+ * preserved for callers that haven't migrated yet.
+ */
+export declare const isStale: (lastSeen: number, latestWaveTime: number, thresholdMs?: number) => boolean;
+/**
+ * Parse the action-invoke args field (Devtools §4): empty → no args; a JSON
+ * array → the args spread. Anything else is a user error surfaced inline —
+ * never thrown (the DVT004 path covers the call itself).
+ */
+export declare const parseInvokeArgs: (text: string) => {
+    args: unknown[];
+} | {
+    error: string;
+};
+/**
+ * Wrap a passive-history event ring into a Replay §3 `SessionBundle` —
+ * `"2.0"` / `"state-snapshot"`, snapshots + mount markers only (Devtools §7;
+ * format cited, not extended). `null` when nothing was recorded.
+ */
+export declare const passiveBundle: (events: ReadonlyArray<SessionBundle["events"][number]>, sessionId?: string) => SessionBundle | null;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAGnE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAIxB,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM,EACA,CAAA;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAWnE,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,GAClB,UAAU,MAAM,EAChB,gBAAgB,MAAM,EACtB,oBAAkB,KACjB,OAOF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,KACX;IAAE,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAUvC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EACtD,kBAA8B,KAC7B,aAAa,GAAG,IAclB,CAAA"}

package/dist/helpers.js

@@ -0,0 +1,110 @@
+// @reactra/devtools — pure panel logic (no React, no DOM).
+//
+// Owner: reactra-devtools-spec.md (internal tier — exported for tests).
+// The recorded structures are Replay spec §3 types — consumed via
+// `@reactra/behaviours/replayable`, never redefined or extended
+// (architect condition 5).
+import { serializeBindings } from "./serialize.js";
+/**
+ * The data-valued projection of a hook bindings object (Devtools §7):
+ * function values are dropped (actions/setters aren't state). Values are
+ * depth/size-capped (serialize.ts) and resource handles emit a
+ * status-projection (DVT-LIM-04 resolution). One bad binding never poisons
+ * a commit — unserializable values become the `"[unserializable]"` sentinel.
+ */
+export const dataBindings = (bindings) => {
+    // Delegate to the shared serializer; the return type is Record<string,
+    // Serialized> which is structurally assignable to Record<string, unknown>.
+    return serializeBindings(bindings);
+};
+/** Names of the function-valued bindings — the §4 `▶ run` candidates. */
+export const callableNames = (bindings) => Object.keys(bindings).filter((k) => typeof bindings[k] === "function");
+/**
+ * Grouped bindings — separates data members from callable members (T1.3).
+ * Preserves the Testing §2 normative order within each bucket:
+ *   data: props, state, derived, behaviour (non-callable by nature), resource
+ *   actions: action functions
+ *
+ * The split is structural: function-valued keys go to `actions`, everything
+ * else to `data`. This matches the §4 intent (data section above actions).
+ */
+export const groupBindings = (bindings) => {
+    const data = {};
+    const actions = {};
+    for (const [k, v] of Object.entries(bindings)) {
+        if (typeof v === "function") {
+            actions[k] = v;
+        }
+        else {
+            data[k] = v;
+        }
+    }
+    return { data, actions };
+};
+/**
+ * RELATIVE staleness heuristic (DVT-LIM-01; T2.2 re-disposition): an entry
+ * is stale ONLY if it missed the latest commit wave while other components
+ * committed in that wave. This prevents static pages (where nothing commits)
+ * from incorrectly flagging everything as stale.
+ *
+ * `lastSeen` — wall-clock time of the component's last commit.
+ * `latestWaveTime` — wall-clock time of the most recent commit across ALL
+ *    tracked components (the "wave front"). Pass 0 / undefined to disable
+ *    relative staleness (nothing is stale when no new commits arrived).
+ * `thresholdMs` — a component is stale if it's older than `latestWaveTime`
+ *    by at least this many ms AND another component committed recently (default 2000ms).
+ *
+ * Back-compat: the two-argument form `isStale(lastSeen, now)` still works —
+ * it passes `now` as `latestWaveTime` so the absolute-threshold behavior is
+ * preserved for callers that haven't migrated yet.
+ */
+export const isStale = (lastSeen, latestWaveTime, thresholdMs = 2000) => {
+    // If nothing has committed recently (latestWaveTime is 0 or old), nothing
+    // is stale — a static page should not dim all components.
+    const waveAge = Date.now() - latestWaveTime;
+    if (waveAge > thresholdMs)
+        return false;
+    // Relative check: stale if this component missed the latest wave.
+    return latestWaveTime - lastSeen > thresholdMs;
+};
+/**
+ * Parse the action-invoke args field (Devtools §4): empty → no args; a JSON
+ * array → the args spread. Anything else is a user error surfaced inline —
+ * never thrown (the DVT004 path covers the call itself).
+ */
+export const parseInvokeArgs = (text) => {
+    const trimmed = text.trim();
+    if (trimmed === "")
+        return { args: [] };
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!Array.isArray(parsed))
+            return { error: "args must be a JSON array, e.g. [\"x\", 1]" };
+        return { args: parsed };
+    }
+    catch (err) {
+        return { error: `invalid JSON: ${String(err)}` };
+    }
+};
+/**
+ * Wrap a passive-history event ring into a Replay §3 `SessionBundle` —
+ * `"2.0"` / `"state-snapshot"`, snapshots + mount markers only (Devtools §7;
+ * format cited, not extended). `null` when nothing was recorded.
+ */
+export const passiveBundle = (events, sessionId = "devtools-passive") => {
+    if (events.length === 0)
+        return null;
+    const startTime = events[0].timestamp;
+    const endTime = events[events.length - 1].timestamp;
+    const components = [...new Set(events.map((e) => e.componentId.split("#")[0] ?? e.componentId))];
+    return {
+        version: "2.0",
+        mode: "state-snapshot",
+        startTime,
+        duration: endTime - startTime,
+        sessionId,
+        components,
+        events: [...events],
+    };
+};
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/hookRecorder.d.ts

@@ -0,0 +1,72 @@
+import type { ReplayEvent } from "@reactra/behaviours/replayable";
+/** The Testing §2 hook interface (structural — cited, not re-owned). */
+export interface ReactraTestHook {
+    update(componentName: string, bindings: Record<string, unknown>): void;
+}
+/** Latest-commit info per component name (Components tab rows). */
+export interface CommitInfo {
+    /** The raw latest bindings — function values included (action invoke). */
+    bindings: Record<string, unknown>;
+    /** Wall-clock time of the last commit (staleness dimming, DVT-LIM-01). */
+    lastSeen: number;
+    /** Commits observed since the recorder installed. */
+    commits: number;
+}
+/** What `install()` found in the global slot. */
+export type InstallResult = "installed" | "occupied";
+export interface HookRecorderOptions {
+    /** Passive-history ring capacity in commits (Devtools §2; default 5000). */
+    historyLimit?: number;
+    /** Clock injection for tests. */
+    now?: () => number;
+    /** Global object carrying the `__REACTRA_TEST__` slot (tests pass a stub). */
+    globalObject?: Record<string, unknown>;
+}
+/** The recorder handle — see `createHookRecorder`. */
+export interface HookRecorder {
+    /**
+     * Install into the `__REACTRA_TEST__` slot. `"occupied"` = DVT001: the
+     * occupant is NEVER overwritten or wrapped; the caller degrades the
+     * hook-dependent surfaces (Devtools §3).
+     */
+    install(): InstallResult;
+    /** Clear the slot — only if it still holds this recorder's own hook. */
+    uninstall(): void;
+    /** Subscribe to commit notifications (panel re-render). */
+    subscribe(fn: () => void): () => void;
+    /** Latest commit per component name, first-seen order. */
+    components(): ReadonlyMap<string, CommitInfo>;
+    /**
+     * Record a synthetic snapshot into the ring under a caller-chosen
+     * `componentId` WITHOUT adding it to the Components-tab map. Used to fold
+     * non-component sources (e.g. route changes — `"Route#1"`) into the same
+     * passive time-travel timeline. Respects the ⏺ arm state and eviction, and
+     * notifies subscribers. The `componentId` should follow the `Name#N`
+     * convention (Replay §4.3) so the Time Travel cards strip it consistently.
+     */
+    recordSnapshot(componentId: string, state: Record<string, unknown>): void;
+    /**
+     * The RAW (un-serialized) store snapshot folded under `componentId` at or
+     * before `atTime`, or undefined if none. Stores re-drive from this — NOT from
+     * the ring's `state`, which is depth/size-capped + type-projected by the
+     * display serializer (a `Map`/`Date`/`>50`-key value would be written back as
+     * a lossy string/truncation, corrupting the live store). Only `store:` ids are
+     * stashed (re-drive targets; components self-heal on next commit).
+     */
+    rawStoreStateAt(componentId: string, atTime: number): Record<string, unknown> | undefined;
+    /** Arm / disarm the passive ring (the ⏺ toggle). */
+    setRecording(on: boolean): void;
+    recording(): boolean;
+    /** The passive ring — Replay §3 events, oldest first. */
+    events(): readonly ReplayEvent[];
+    /** True once eviction has occurred (the DVT005 one-time notice). */
+    evicted(): boolean;
+    /** Drop the ring + the eviction flag (a fresh ⏺ arm). */
+    clearHistory(): void;
+}
+/**
+ * Create the devtools hook recorder. Pure logic — no DOM, no React — so the
+ * DT-01…03 scenarios run renderer-free.
+ */
+export declare const createHookRecorder: (opts?: HookRecorderOptions) => HookRecorder;
+//# sourceMappingURL=hookRecorder.d.ts.map

package/dist/hookRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookRecorder.d.ts","sourceRoot":"","sources":["../src/hookRecorder.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAGjE,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACvE;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAA;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;AAEpD,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,IAAI,aAAa,CAAA;IACxB,wEAAwE;IACxE,SAAS,IAAI,IAAI,CAAA;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IACrC,0DAA0D;IAC1D,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC7C;;;;;;;OAOG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACzE;;;;;;;OAOG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACzF,oDAAoD;IACpD,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,SAAS,IAAI,OAAO,CAAA;IACpB,yDAAyD;IACzD,MAAM,IAAI,SAAS,WAAW,EAAE,CAAA;IAChC,oEAAoE;IACpE,OAAO,IAAI,OAAO,CAAA;IAClB,yDAAyD;IACzD,YAAY,IAAI,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAM,mBAAwB,KAAG,YA+HnE,CAAA"}