@reactra/devtools 0.1.0-alpha.0

package/dist/hookRecorder.js

@@ -0,0 +1,142 @@
+// @reactra/devtools — the hook recorder: a conforming `__REACTRA_TEST__`
+// implementation feeding the Components tab + the passive time-travel ring.
+//
+// Owner: reactra-devtools-spec.md §3 (hook coexistence — DVT001) + §7
+// (passive history). The hook INTERFACE is Testing spec §2 — consumed as-is,
+// never extended. Recorded events are Replay §3 types (architect
+// condition 5): full-state `StateSnapshotEvent`s + synthesized mount
+// markers, instance ids `Name#1` (no instance identity on the hook —
+// DVT-LIM-02).
+import { dataBindings } from "./helpers.js";
+/**
+ * Create the devtools hook recorder. Pure logic — no DOM, no React — so the
+ * DT-01…03 scenarios run renderer-free.
+ */
+export const createHookRecorder = (opts = {}) => {
+    const historyLimit = opts.historyLimit ?? 5000;
+    const now = opts.now ?? Date.now;
+    const g = opts.globalObject ?? globalThis;
+    const components = new Map();
+    const listeners = new Set();
+    // The ring counts COMMITS (snapshot events); synthesized mount markers
+    // ride along and are evicted with their era, never counted.
+    let ring = [];
+    let snapshotCount = 0;
+    let recordingOn = true;
+    let evictedFlag = false;
+    let warnedEviction = false;
+    // componentIds already mount-marked in the CURRENT ring era (cleared with it).
+    let mounted = new Set();
+    // RAW store snapshots for lossless re-drive (the ring's `state` is serialized
+    // and lossy). Keyed by store componentId → [timestamp, raw] oldest-first,
+    // trimmed to historyLimit per id. Only `store:` ids are stashed.
+    const rawStore = new Map();
+    // Shared ring-append logic for both component commits and synthetic
+    // (route) snapshots: synthesize the first-seen mount marker, push the
+    // full-state snapshot, count it, and evict oldest-first past the cap.
+    const appendSnapshot = (componentId, state, t) => {
+        if (!mounted.has(componentId)) {
+            mounted.add(componentId);
+            ring.push({ type: "mount", componentId, phase: "mount", timestamp: t });
+        }
+        ring.push({ type: "state_snapshot", componentId, state, timestamp: t });
+        snapshotCount++;
+        if (snapshotCount > historyLimit) {
+            // Evict the oldest snapshot (and any mount marker stranded ahead of it) —
+            // "2.0" snapshots are full state, so dropping history never corrupts
+            // later folds.
+            const idx = ring.findIndex((e) => e.type === "state_snapshot");
+            ring.splice(0, idx + 1);
+            snapshotCount--;
+            evictedFlag = true;
+            if (!warnedEviction) {
+                warnedEviction = true;
+                console.warn(`[reactra:devtools] DVT005: passive history reached ${historyLimit} commits — oldest evicted (raise historyLimit to keep more)`);
+            }
+        }
+    };
+    const hook = {
+        update: (componentName, bindings) => {
+            const t = now();
+            const prev = components.get(componentName);
+            components.set(componentName, {
+                bindings,
+                lastSeen: t,
+                commits: (prev?.commits ?? 0) + 1,
+            });
+            if (recordingOn)
+                appendSnapshot(`${componentName}#1`, dataBindings(bindings), t);
+            for (const l of listeners)
+                l();
+        },
+    };
+    return {
+        install: () => {
+            const slot = g.__REACTRA_TEST__;
+            if (slot !== undefined && slot !== hook) {
+                console.warn("[reactra:devtools] DVT001: __REACTRA_TEST__ is already installed by another consumer — Components + passive time travel disabled (the occupant is never overwritten)");
+                return "occupied";
+            }
+            g.__REACTRA_TEST__ = hook;
+            return "installed";
+        },
+        uninstall: () => {
+            if (g.__REACTRA_TEST__ === hook)
+                delete g.__REACTRA_TEST__;
+        },
+        subscribe: (fn) => {
+            listeners.add(fn);
+            return () => listeners.delete(fn);
+        },
+        components: () => components,
+        recordSnapshot: (componentId, state) => {
+            // Respects the arm state (paused / frozen-while-traveling → full no-op,
+            // including no listener notification so scrub-driven route changes don't
+            // spuriously re-render). Serializes through the same depth/size-capped
+            // path as commits so the synthetic snapshot folds identically.
+            if (!recordingOn)
+                return;
+            const t = now();
+            appendSnapshot(componentId, dataBindings(state), t);
+            // Stash the RAW value for stores so re-drive is lossless (see rawStoreStateAt).
+            if (componentId.startsWith("store:")) {
+                const hist = rawStore.get(componentId) ?? [];
+                hist.push({ t, raw: state });
+                if (hist.length > historyLimit)
+                    hist.shift();
+                rawStore.set(componentId, hist);
+            }
+            for (const l of listeners)
+                l();
+        },
+        rawStoreStateAt: (componentId, atTime) => {
+            const hist = rawStore.get(componentId);
+            if (hist === undefined)
+                return undefined;
+            // Latest raw snapshot at or before atTime (fold semantics, single id).
+            let found;
+            for (const entry of hist) {
+                if (entry.t <= atTime)
+                    found = entry.raw;
+                else
+                    break;
+            }
+            return found;
+        },
+        setRecording: (on) => {
+            recordingOn = on;
+        },
+        recording: () => recordingOn,
+        events: () => ring,
+        evicted: () => evictedFlag,
+        clearHistory: () => {
+            ring = [];
+            snapshotCount = 0;
+            mounted = new Set();
+            evictedFlag = false;
+            warnedEviction = false;
+            rawStore.clear();
+        },
+    };
+};
+//# sourceMappingURL=hookRecorder.js.map

package/dist/hookRecorder.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { ReactraDevtools, type ReactraDevtoolsProps } from "./panel.ts";
+export { callableNames as __callableNames, dataBindings as __dataBindings, isStale as __isStale, parseInvokeArgs as __parseInvokeArgs, passiveBundle as __passiveBundle, } from "./helpers.ts";
+export { __resetStylesForTest, ensureStyles as __ensureStyles } from "./styles.ts";
+export { createHookRecorder as __createHookRecorder, type CommitInfo as __CommitInfo, type HookRecorder as __HookRecorder, } from "./hookRecorder.ts";
+export { listStores as __listStores, storeSnapshot as __storeSnapshot, subscribeStore as __subscribeStore, } from "./storeWatcher.ts";
+export { attachStoreRecorder as __attachStoreRecorder, type StoreRecorderHandle as __StoreRecorderHandle, } from "./storeRecorder.ts";
+export { createNavLog as __createNavLog, currentRoute as __currentRoute, listRoutes as __listRoutes, subscribeRouter as __subscribeRouter, } from "./routerWatcher.ts";
+export { createDevtoolsModel as __createDevtoolsModel, type DevtoolsModel } from "./model.ts";
+export { serialize as __serialize, serializeBindings as __serializeBindings } from "./serialize.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAGvE,OAAO,EACL,aAAa,IAAI,eAAe,EAChC,YAAY,IAAI,cAAc,EAC9B,OAAO,IAAI,SAAS,EACpB,eAAe,IAAI,iBAAiB,EACpC,aAAa,IAAI,eAAe,GACjC,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,oBAAoB,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EACL,kBAAkB,IAAI,oBAAoB,EAC1C,KAAK,UAAU,IAAI,YAAY,EAC/B,KAAK,YAAY,IAAI,cAAc,GACpC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,UAAU,IAAI,YAAY,EAC1B,aAAa,IAAI,eAAe,EAChC,cAAc,IAAI,gBAAgB,GACnC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,mBAAmB,IAAI,qBAAqB,EAC5C,KAAK,mBAAmB,IAAI,qBAAqB,GAClD,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,YAAY,IAAI,cAAc,EAC9B,YAAY,IAAI,cAAc,EAC9B,UAAU,IAAI,YAAY,EAC1B,eAAe,IAAI,iBAAiB,GACrC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,mBAAmB,IAAI,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAC7F,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,iBAAiB,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// @reactra/devtools — public surface.
+//
+// Owner: reactra-devtools-spec.md + reactra-runtime-spec.md §3. User-facing:
+// the `<ReactraDevtools>` panel. The data layer below is internal tier —
+// re-exported __-prefixed for tests only, never documented as user API.
+export { ReactraDevtools } from "./panel.js";
+// Internal tier (tests only — Runtime spec §1 visibility tiers).
+export { callableNames as __callableNames, dataBindings as __dataBindings, isStale as __isStale, parseInvokeArgs as __parseInvokeArgs, passiveBundle as __passiveBundle, } from "./helpers.js";
+export { __resetStylesForTest, ensureStyles as __ensureStyles } from "./styles.js";
+export { createHookRecorder as __createHookRecorder, } from "./hookRecorder.js";
+export { listStores as __listStores, storeSnapshot as __storeSnapshot, subscribeStore as __subscribeStore, } from "./storeWatcher.js";
+export { attachStoreRecorder as __attachStoreRecorder, } from "./storeRecorder.js";
+export { createNavLog as __createNavLog, currentRoute as __currentRoute, listRoutes as __listRoutes, subscribeRouter as __subscribeRouter, } from "./routerWatcher.js";
+export { createDevtoolsModel as __createDevtoolsModel } from "./model.js";
+export { serialize as __serialize, serializeBindings as __serializeBindings } from "./serialize.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,eAAe,EAA6B,MAAM,YAAY,CAAA;AAEvE,iEAAiE;AACjE,OAAO,EACL,aAAa,IAAI,eAAe,EAChC,YAAY,IAAI,cAAc,EAC9B,OAAO,IAAI,SAAS,EACpB,eAAe,IAAI,iBAAiB,EACpC,aAAa,IAAI,eAAe,GACjC,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,oBAAoB,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EACL,kBAAkB,IAAI,oBAAoB,GAG3C,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,UAAU,IAAI,YAAY,EAC1B,aAAa,IAAI,eAAe,EAChC,cAAc,IAAI,gBAAgB,GACnC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,mBAAmB,IAAI,qBAAqB,GAE7C,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,YAAY,IAAI,cAAc,EAC9B,YAAY,IAAI,cAAc,EAC9B,UAAU,IAAI,YAAY,EAC1B,eAAe,IAAI,iBAAiB,GACrC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,mBAAmB,IAAI,qBAAqB,EAAsB,MAAM,YAAY,CAAA;AAC7F,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,iBAAiB,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/invoke.d.ts

@@ -0,0 +1,35 @@
+/** Result of a successful invoke. */
+export interface InvokeOk {
+    ok: true;
+}
+/** Result of a failed invoke (DVT004 — bad args string or thrown action). */
+export interface InvokeError {
+    ok: false;
+    /** The full DVT004-prefixed error message for inline display. */
+    error: string;
+}
+/** Return type of `runInvoke`. */
+export type InvokeResult = InvokeOk | InvokeError;
+/**
+ * Invoke an action function with the args text from the input field.
+ *
+ * - Empty `argsText` (or absent) → zero-arg call: `fn()` — the "▶ run"
+ *   shortcut that doesn't require the JSON-array input.
+ * - Non-empty `argsText` must be a JSON array string; anything else yields a
+ *   `DVT004: invalid JSON` error (no throw into the host app).
+ * - A thrown action is caught and returned as `DVT004: <message>`.
+ * - Fix 6b: an async action that returns a rejected promise is also caught and
+ *   surfaced as `DVT004: …` via `Promise.resolve(...).catch(...)` — prevents
+ *   the rejection from escaping to `window.unhandledrejection`.
+ *
+ * @param fn - The action function to invoke (from bindings or snap).
+ * @param argsText - The raw text from the args input field (may be empty).
+ * @param onAsyncError - Optional callback for async DVT004 errors. Called if
+ *   the action returns a rejected promise. Defaults to a no-op (callers that
+ *   want to show async errors must pass this).
+ * @returns `{ ok: true }` on success (sync), or `{ ok: false, error: "DVT004: …" }`
+ *   on a bad-args string or synchronous throw. Async rejections are routed to
+ *   `onAsyncError` and the synchronous return is `{ ok: true }`.
+ */
+export declare const runInvoke: (fn: unknown, argsText?: string, onAsyncError?: (error: string) => void) => InvokeResult;
+//# sourceMappingURL=invoke.d.ts.map

package/dist/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAUA,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,IAAI,CAAA;CACT;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,KAAK,CAAA;IACT,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS,GACpB,IAAI,OAAO,EACX,WAAW,MAAM,EACjB,eAAe,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,KACrC,YAqCF,CAAA"}

package/dist/invoke.js

@@ -0,0 +1,67 @@
+// @reactra/devtools — action-invoke helper (T1.4).
+//
+// Owner: reactra-devtools-spec.md §4 (action invoke, DVT004). Extracts the
+// duplicated DVT004 invoke block from panel.ts and stores.ts into one shared
+// helper. Adds a zero-arg shortcut (when argsText is empty or absent, the
+// action is called with no arguments — no input field needed). The per-param
+// labeled-input feature is gated (Testing §2 param metadata) — NOT here.
+import { parseInvokeArgs } from "./helpers.js";
+/**
+ * Invoke an action function with the args text from the input field.
+ *
+ * - Empty `argsText` (or absent) → zero-arg call: `fn()` — the "▶ run"
+ *   shortcut that doesn't require the JSON-array input.
+ * - Non-empty `argsText` must be a JSON array string; anything else yields a
+ *   `DVT004: invalid JSON` error (no throw into the host app).
+ * - A thrown action is caught and returned as `DVT004: <message>`.
+ * - Fix 6b: an async action that returns a rejected promise is also caught and
+ *   surfaced as `DVT004: …` via `Promise.resolve(...).catch(...)` — prevents
+ *   the rejection from escaping to `window.unhandledrejection`.
+ *
+ * @param fn - The action function to invoke (from bindings or snap).
+ * @param argsText - The raw text from the args input field (may be empty).
+ * @param onAsyncError - Optional callback for async DVT004 errors. Called if
+ *   the action returns a rejected promise. Defaults to a no-op (callers that
+ *   want to show async errors must pass this).
+ * @returns `{ ok: true }` on success (sync), or `{ ok: false, error: "DVT004: …" }`
+ *   on a bad-args string or synchronous throw. Async rejections are routed to
+ *   `onAsyncError` and the synchronous return is `{ ok: true }`.
+ */
+export const runInvoke = (fn, argsText, onAsyncError) => {
+    const text = argsText?.trim() ?? "";
+    let args;
+    if (text === "") {
+        // Zero-arg shortcut — no parse needed.
+        args = [];
+    }
+    else {
+        const parsed = parseInvokeArgs(text);
+        if ("error" in parsed) {
+            // Bad args string — DVT004 (same prefix as the thrown-error path;
+            // both are invoke failures, Devtools §4).
+            return { ok: false, error: `DVT004: ${parsed.error}` };
+        }
+        args = parsed.args;
+    }
+    let result;
+    try {
+        result = fn(...args);
+    }
+    catch (err) {
+        // Synchronous throw — DVT004, surfaced inline, never rethrown.
+        return { ok: false, error: `DVT004: ${String(err)}` };
+    }
+    // Fix 6b: if the action returned a Promise, attach a rejection handler so
+    // an async failure surfaces as DVT004 rather than escaping to the host as
+    // an unhandledrejection. The synchronous return is still { ok: true }
+    // (we can't know sync whether the promise will reject).
+    if (result !== null && result !== undefined && typeof result.then === "function") {
+        Promise.resolve(result).catch((err) => {
+            const msg = `DVT004: ${String(err)}`;
+            if (onAsyncError)
+                onAsyncError(msg);
+        });
+    }
+    return { ok: true };
+};
+//# sourceMappingURL=invoke.js.map

package/dist/invoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAiB9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,EAAW,EACX,QAAiB,EACjB,YAAsC,EACxB,EAAE;IAChB,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACnC,IAAI,IAAe,CAAA;IAEnB,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,uCAAuC;QACvC,IAAI,GAAG,EAAE,CAAA;IACX,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,kEAAkE;YAClE,0CAA0C;YAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,MAAM,CAAC,KAAK,EAAE,EAAE,CAAA;QACxD,CAAC;QACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAI,EAAmC,CAAC,GAAG,IAAI,CAAC,CAAA;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,+DAA+D;QAC/D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAA;IACvD,CAAC;IAED,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,wDAAwD;IACxD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAQ,MAAkC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9G,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YAC7C,MAAM,GAAG,GAAG,WAAW,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;YACpC,IAAI,YAAY;gBAAE,YAAY,CAAC,GAAG,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;AACrB,CAAC,CAAA"}

package/dist/model.d.ts

@@ -0,0 +1,99 @@
+import type { HookRecorder } from "./hookRecorder.ts";
+import type { CommitInfo } from "./hookRecorder.ts";
+import { type NavLog } from "./routerWatcher.ts";
+import type { ReplayEvent } from "@reactra/behaviours/replayable";
+/** One store snapshot row for the model surface (facade over StoreRow). */
+export interface ModelStoreEntry {
+    /** Registered store name. */
+    name: string;
+    /** Store kind as registered. */
+    kind: "export" | "session" | "route";
+    /** True when the store instance is live. */
+    instantiated: boolean;
+    /** Preserved state field names (Store §6). */
+    preservedFields: readonly string[];
+    /** Subtree path when applicable. */
+    subtreePath?: string;
+    /** Current snapshot — undefined when not instantiated. */
+    snapshot?: Record<string, unknown>;
+}
+/** Current router state for the model surface. */
+export interface ModelRoute {
+    /** Matched route id, or null on no match. */
+    routeId: string | null;
+    /** Matched route path pattern, or null. */
+    path: string | null;
+    /** Current pathname. */
+    pathname: string;
+    /** Extracted path params. */
+    params: Record<string, string>;
+    /** Coerced query params. */
+    query: Record<string, string | string[]>;
+}
+/** The DevtoolsModel facade — one plain-reads object wrapping the data layer. */
+export interface DevtoolsModel {
+    /**
+     * Latest-commit info per component name (mirrors `HookRecorder.components()`).
+     * Empty map when the hook is occupied (DVT001).
+     */
+    components(): ReadonlyMap<string, CommitInfo>;
+    /**
+     * All registered store rows plus their live snapshots.
+     * Fresh read each call (same as listStores() + storeSnapshot()).
+     */
+    stores(): readonly ModelStoreEntry[];
+    /**
+     * Current router state derived from RouterRegistry.
+     */
+    route(): ModelRoute;
+    /**
+     * The passive-history ring from the recorder (Devtools §7).
+     */
+    timeline(): readonly ReplayEvent[];
+    /**
+     * Subscribe to data changes: recorder commits, store value changes, and
+     * route transitions all fire `fn`. Returns an unsubscribe function.
+     * Ticker-based: subscribing starts a single consolidated interval for
+     * store/route polling; unsubscribing the last subscriber stops it.
+     */
+    subscribe(fn: () => void): () => void;
+    /**
+     * The current active subscriber count — exposed for test assertions.
+     */
+    subscriberCount(): number;
+    /**
+     * Dispose the model: unsubscribe from the recorder and the router registry,
+     * stop the consolidated ticker, and clear all remaining listeners.
+     *
+     * Call from the panel's unmount effect to prevent the module-singleton
+     * `RouterRegistry` from accumulating a listener per panel mount (Fix 3 —
+     * subscription leak). After dispose, subscribe() becomes a no-op unsubscriber.
+     */
+    dispose(): void;
+}
+/**
+ * Options for `createDevtoolsModel` (injectable for tests).
+ */
+export interface DevtoolsModelOptions {
+    /** The hook recorder instance from the panel. */
+    recorder: HookRecorder;
+    /**
+     * The panel-owned nav log (records navigations while the panel is alive).
+     * Currently unused in the model interface — passed for future use.
+     */
+    navLog?: NavLog;
+    /**
+     * Polling interval in ms for the consolidated ticker (arch#2a; default 700ms).
+     * This controls how often store-registry + route changes are polled for
+     * subscribers. Exact millisecond timing isn't critical — delivery is
+     * best-effort, not guaranteed.
+     */
+    tickIntervalMs?: number;
+}
+/**
+ * Create the DevtoolsModel facade (arch#8). One per panel instance — the
+ * panel creates it in its `useRef` alongside the recorder. Additive: no
+ * existing tab code is changed by this module.
+ */
+export declare const createDevtoolsModel: (opts: DevtoolsModelOptions) => DevtoolsModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAQnD,OAAO,EAA6C,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAEjE,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;IACpC,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAA;IACrB,8CAA8C;IAC9C,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;CACzC;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC7C;;;OAGG;IACH,MAAM,IAAI,SAAS,eAAe,EAAE,CAAA;IACpC;;OAEG;IACH,KAAK,IAAI,UAAU,CAAA;IACnB;;OAEG;IACH,QAAQ,IAAI,SAAS,WAAW,EAAE,CAAA;IAClC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IACrC;;OAEG;IACH,eAAe,IAAI,MAAM,CAAA;IACzB;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,EAAE,YAAY,CAAA;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,oBAAoB,KAAG,aAuJhE,CAAA"}

package/dist/model.js

@@ -0,0 +1,160 @@
+// @reactra/devtools — the DevtoolsModel facade.
+//
+// Owner: reactra-devtools-spec.md §3 (data sources). A plain-reads object
+// exposing components(), stores(), route(), timeline() + subscribe(fn),
+// wrapping the existing recorder + watchers. Additive only — no existing
+// tab code is rewired here; tabs still consume the raw recorder/watchers
+// until each migrates in a later phase.
+//
+// Browser globals: NONE at module level. subscribe() starts the store/router
+// polls inside the registered handler via the ticker; stoppers are returned.
+import { listStores, storeInstanceToken, storeSnapshot, subscribeStore, } from "./storeWatcher.js";
+import { currentRoute, listRoutes, subscribeRouter } from "./routerWatcher.js";
+/**
+ * Create the DevtoolsModel facade (arch#8). One per panel instance — the
+ * panel creates it in its `useRef` alongside the recorder. Additive: no
+ * existing tab code is changed by this module.
+ */
+export const createDevtoolsModel = (opts) => {
+    const { recorder } = opts;
+    const tickIntervalMs = opts.tickIntervalMs ?? 700;
+    const listeners = new Set();
+    // The ONE shared interval for the consolidated ticker (arch#2a).
+    // Exists only while there are subscribers — created on first subscribe,
+    // cleared on last unsubscribe.
+    let tickerId = null;
+    const notify = () => {
+        for (const fn of listeners)
+            fn();
+    };
+    // QW-7: a SINGLE shared map of store subscriptions, keyed by store name. Each
+    // entry holds the store's unsubscribe fn plus the instance-identity token at
+    // subscribe time. Every subscription calls `notify` (NOT a per-listener fn), so
+    // a store is wired exactly ONCE regardless of how many panel listeners exist —
+    // this is what guarantees no double-fire (the old per-listener subscribeStore
+    // path is gone). `notify` already fans out to all listeners.
+    const storeSubs = new Map();
+    /**
+     * QW-7: reconcile `storeSubs` against the live registry. Called on subscribe
+     * and on every tick, so a store instantiated AFTER subscribe-time (a route
+     * store entering on navigation) gets a live subscription by the next tick
+     * (≤ tickIntervalMs) instead of waiting on poll cadence forever.
+     *
+     * - Newcomer (instantiated, not in the map): subscribe via `notify`, record
+     *   `{ off, token }`. Dedup — never double-subscribe an already-tracked store.
+     * - HMR swap (token changed): the old subscription is bound to the dead
+     *   instance — drop it and re-subscribe to the new one (preserves the
+     *   devtools' existing HMR-resubscribe behavior).
+     * - Gone (de-instantiated on nav exit, or token now undefined): unsubscribe
+     *   and remove — keeps the map from growing without bound across navigations.
+     */
+    const reconcileStoreSubs = () => {
+        const live = new Map();
+        for (const r of listStores()) {
+            if (r.instantiated)
+                live.set(r.name, storeInstanceToken(r.name));
+        }
+        // Drop subs for stores no longer live, or whose instance was swapped (HMR).
+        for (const [name, entry] of storeSubs) {
+            const token = live.get(name);
+            if (token === undefined || token !== entry.token) {
+                entry.off();
+                storeSubs.delete(name);
+            }
+        }
+        // Add subs for newly-live stores not already tracked.
+        for (const [name, token] of live) {
+            if (storeSubs.has(name))
+                continue;
+            storeSubs.set(name, { off: subscribeStore(name, notify), token });
+        }
+    };
+    /** Tear down every shared store subscription and empty the map. */
+    const clearStoreSubs = () => {
+        for (const entry of storeSubs.values())
+            entry.off();
+        storeSubs.clear();
+    };
+    // Fix 3: capture both unsubscribers so dispose() can call them.
+    // RouterRegistry is a module singleton — failing to call routerOff leaks a
+    // listener per panel mount/unmount cycle.
+    const recOff = recorder.subscribe(notify);
+    const routerOff = subscribeRouter(notify);
+    // Tracks whether dispose() has been called — prevents double-dispose.
+    let disposed = false;
+    return {
+        components: () => recorder.components(),
+        stores: () => {
+            const rows = [...listStores()];
+            return rows.map((r) => ({
+                name: r.name,
+                kind: r.kind,
+                instantiated: r.instantiated,
+                preservedFields: r.preservedFields,
+                subtreePath: r.subtreePath,
+                snapshot: storeSnapshot(r.name),
+            }));
+        },
+        route: () => {
+            const s = currentRoute();
+            return {
+                routeId: s.route?.id ?? null,
+                path: s.route?.path ?? null,
+                pathname: s.pathname,
+                params: s.params,
+                query: s.query,
+            };
+        },
+        timeline: () => recorder.events(),
+        subscribe: (fn) => {
+            listeners.add(fn);
+            if (listeners.size === 1) {
+                // First subscriber — start the consolidated ticker. Each tick reconciles
+                // store subscriptions FIRST (so a route store that just instantiated gets
+                // a live sub) THEN notifies. The registry has no registration event
+                // (arch#2b deferred), so the tick is also the catch-up for newcomers —
+                // but now they're wired for INSTANT delivery thereafter, not polled.
+                tickerId = setInterval(() => {
+                    reconcileStoreSubs();
+                    notify();
+                }, tickIntervalMs);
+            }
+            // QW-7: reconcile on subscribe so stores already live at subscribe-time are
+            // wired immediately (not only on the first tick). Subscriptions are shared
+            // (keyed by store name, calling `notify`), so this is per-model, not
+            // per-listener — adding a second listener does NOT re-subscribe any store.
+            reconcileStoreSubs();
+            return () => {
+                listeners.delete(fn);
+                if (listeners.size === 0) {
+                    // Last subscriber gone — tear down the shared store subs + the ticker.
+                    clearStoreSubs();
+                    if (tickerId !== null) {
+                        clearInterval(tickerId);
+                        tickerId = null;
+                    }
+                }
+            };
+        },
+        subscriberCount: () => listeners.size,
+        dispose: () => {
+            if (disposed)
+                return;
+            disposed = true;
+            // Stop the ticker.
+            if (tickerId !== null) {
+                clearInterval(tickerId);
+                tickerId = null;
+            }
+            // QW-7: tear down every shared store subscription (else they leak past the
+            // panel's life — the store registry is a module singleton).
+            clearStoreSubs();
+            // Remove all panel listeners so stale refs don't fire after unmount.
+            listeners.clear();
+            // Unsubscribe from the module-level singletons.
+            recOff();
+            routerOff();
+        },
+    };
+};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/panel.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from "react";
+/** Props of the developer panel (Devtools spec §2). */
+export interface ReactraDevtoolsProps {
+    /** Open the drawer on mount (default false — collapsed pill). */
+    defaultOpen?: boolean;
+    /** Passive-history ring capacity in commits (default 5000; DVT005 on eviction). */
+    historyLimit?: number;
+    /** Arm the passive recorder at mount (default true). */
+    record?: boolean;
+}
+/**
+ * The Reactra developer panel: Components / Stores / Router / Time Travel
+ * tabs over the shipped runtime surfaces (Devtools spec §3 — zero new
+ * compiler emission). Hand-mounted; the mount is the sole opt-in.
+ */
+export declare const ReactraDevtools: (props: ReactraDevtoolsProps) => ReactNode;
+//# sourceMappingURL=panel.d.ts.map

package/dist/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../src/panel.ts"],"names":[],"mappings":"AAYA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAoBd,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAWD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,KAAG,SAuhB7D,CAAA"}