@reactra/devtools 0.1.0-alpha.0

package/dist/serialize.js

@@ -0,0 +1,217 @@
+// @reactra/devtools — shared value serializer.
+//
+// Owner: reactra-devtools-spec.md §7 (binding-card data layer). Replaces
+// the unbounded JSON.parse(JSON.stringify(...)) round-trip in `dataBindings`
+// with a depth-limited, size-capped walk that also handles resource handles
+// (DVT-LIM-04 resolution: status projection instead of "[unserializable]").
+//
+// Rules:
+//   - Functions are dropped (never serialized — the action-invoke path
+//     handles them separately via callableNames).
+//   - Cyclic values become the sentinel (no throw).
+//   - Objects/arrays past `maxDepth` become summary placeholders.
+//   - Objects/arrays with more than `maxKeys` entries are truncated.
+//   - A resource handle (object with a `status` string property equal to
+//     "pending", "resolved", or "error") emits { status, value? } — the
+//     resource-status projection (DVT-LIM-04).
+/** Sentinel for values that can't be serialized cleanly. */
+export const SENTINEL = "[unserializable]";
+const RESOURCE_STATUSES = new Set(["pending", "resolved", "error"]);
+/**
+ * Detect a genuine Reactra resource handle (DVT-LIM-04 resource projection).
+ *
+ * Tightened from the old duck-typed `status`-only check: any plain data object
+ * with a `status: "error"` field (e.g. `{status:"error", message, code}`) was
+ * silently reduced to `{status}`, dropping all extra fields. The fix: only
+ * apply the projection when the object positively identifies as a
+ * `ResourceHandle<T>` — it must carry the `promise` field (a Promise), which
+ * is structurally unique to the resource handle returned by `useResource`. A
+ * plain state object may have a `status` string but will never carry a live
+ * Promise on its `promise` field. This avoids false-positives while keeping
+ * the DVT-LIM-04 projection for real handles.
+ *
+ * References: Resource v1 §2 (`ResourceHandle<T>` surface — `data`, `error`,
+ * `isPending`, `refetch`, `promise`).
+ */
+const isResourceHandle = (v) => {
+    const rec = v;
+    const s = rec.status;
+    if (typeof s !== "string" || !RESOURCE_STATUSES.has(s))
+        return false;
+    // Require a `promise` property that is a Promise — the structural differentiator
+    // between a ResourceHandle and an ordinary data object with a status field.
+    const p = rec.promise;
+    return p !== null && p !== undefined && typeof p.then === "function";
+};
+/**
+ * Serialize a single value to a depth/size-capped representation.
+ * Functions are dropped from objects; cyclic references become `SENTINEL`.
+ *
+ * @param value - The value to serialize.
+ * @param caps - Optional depth/size caps (defaults: depth=5, keys=50).
+ * @returns A plain JSON-compatible representation, or `SENTINEL`/summary.
+ */
+export const serialize = (value, caps) => {
+    const maxDepth = caps?.maxDepth ?? 5;
+    const maxKeys = caps?.maxKeys ?? 50;
+    // Cycle detection — tracks object identity through the recursion stack.
+    const seen = new Set();
+    const walk = (v, depth) => {
+        if (v === null)
+            return null;
+        if (v === undefined)
+            return undefined;
+        if (typeof v === "boolean" || typeof v === "number" || typeof v === "string")
+            return v;
+        if (typeof v === "function")
+            return undefined; // dropped
+        if (typeof v === "bigint")
+            return String(v) + "n";
+        if (typeof v === "symbol")
+            return String(v);
+        if (typeof v === "object") {
+            if (seen.has(v))
+                return SENTINEL; // cyclic
+            seen.add(v);
+            try {
+                // Resource-status projection (DVT-LIM-04): only genuine handles
+                // (those that carry a `promise` Promise field) are projected.
+                if (isResourceHandle(v)) {
+                    const r = v;
+                    const proj = { status: r.status };
+                    if (r.status === "resolved" && "value" in r) {
+                        proj.value = walk(r.value, depth + 1) ?? null;
+                    }
+                    return proj;
+                }
+                // Fix 2 — explicit branches for built-in types that Object.entries
+                // renders as `{}` (empty or numeric-index keys), making them look like
+                // empty objects in the panel.
+                if (v instanceof Date) {
+                    return v.toISOString();
+                }
+                if (v instanceof Error) {
+                    return { name: v.name, message: v.message };
+                }
+                if (v instanceof Map) {
+                    if (depth >= maxDepth)
+                        return `Map(${v.size})`;
+                    const entries = [];
+                    let count = 0;
+                    for (const [mk, mv] of v) {
+                        if (count >= maxKeys) {
+                            entries.push(`…${v.size - maxKeys} more`);
+                            break;
+                        }
+                        entries.push([walk(mk, depth + 1) ?? null, walk(mv, depth + 1) ?? null]);
+                        count++;
+                    }
+                    return entries;
+                }
+                if (v instanceof Set) {
+                    if (depth >= maxDepth)
+                        return `Set(${v.size})`;
+                    const items = [];
+                    let count = 0;
+                    for (const sv of v) {
+                        if (count >= maxKeys) {
+                            items.push(`…${v.size - maxKeys} more`);
+                            break;
+                        }
+                        items.push(walk(sv, depth + 1) ?? null);
+                        count++;
+                    }
+                    return items;
+                }
+                // TypedArray detection: ArrayBuffer views like Uint8Array, Float32Array, etc.
+                if (ArrayBuffer.isView(v) && !(v instanceof DataView)) {
+                    const ta = v;
+                    if (depth >= maxDepth)
+                        return `TypedArray(${ta.length})`;
+                    const truncated = ta.length > maxKeys;
+                    const items = [];
+                    const len = truncated ? maxKeys : ta.length;
+                    for (let i = 0; i < len; i++)
+                        items.push(ta[i]);
+                    if (truncated)
+                        items.push(`…${ta.length - maxKeys} more`);
+                    return items;
+                }
+                if (depth >= maxDepth) {
+                    // Summarize rather than truncate to avoid misleading data.
+                    if (Array.isArray(v))
+                        return `[…${v.length} items]`;
+                    return `{…${Object.keys(v).length} keys}`;
+                }
+                if (Array.isArray(v)) {
+                    const truncated = v.length > maxKeys;
+                    const items = v.slice(0, maxKeys);
+                    const out = items.map((item) => walk(item, depth + 1) ?? null);
+                    if (truncated)
+                        out.push(`…${v.length - maxKeys} more`);
+                    return out;
+                }
+                // Plain object — enumerate entries with per-key getter guard so a
+                // single throwing accessor only sentinels that key, not the whole object.
+                const keys = Object.keys(v);
+                const truncated = keys.length > maxKeys;
+                const kept = truncated ? keys.slice(0, maxKeys) : keys;
+                const out = {};
+                for (const k of kept) {
+                    let val;
+                    try {
+                        val = v[k];
+                    }
+                    catch {
+                        // Throwing getter — sentinel THIS key only, don't abort the object.
+                        out[k] = SENTINEL;
+                        continue;
+                    }
+                    if (typeof val === "function")
+                        continue; // drop functions
+                    const serialized = walk(val, depth + 1);
+                    if (serialized !== undefined)
+                        out[k] = serialized;
+                }
+                if (truncated) {
+                    out["…"] = `${keys.length - maxKeys} more keys`;
+                }
+                return out;
+            }
+            finally {
+                seen.delete(v);
+            }
+        }
+        // Unknown type — stringify as best effort, never throw.
+        try {
+            return String(v);
+        }
+        catch {
+            return SENTINEL;
+        }
+    };
+    try {
+        return walk(value, 0);
+    }
+    catch {
+        return SENTINEL;
+    }
+};
+/**
+ * Serialize a bindings object for display: functions are dropped, values
+ * are depth/size-capped, unserializable values become `SENTINEL`.
+ * Mirrors the old `dataBindings` contract but with proper caps and resource
+ * projection (DVT-LIM-04 resolution). Exposed for use by helpers.ts.
+ */
+export const serializeBindings = (bindings, caps) => {
+    const out = {};
+    for (const [k, v] of Object.entries(bindings)) {
+        if (typeof v === "function")
+            continue;
+        const s = serialize(v, caps);
+        // Keep undefined-valued keys (they render as undefined in the panel).
+        out[k] = s ?? SENTINEL;
+    }
+    return out;
+};
+//# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

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

package/dist/storeRecorder.d.ts

@@ -0,0 +1,25 @@
+import type { HookRecorder } from "./hookRecorder.ts";
+export interface AttachStoreRecorderOptions {
+    /**
+     * Re-enumeration interval in ms — catches stores instantiated after attach
+     * (a session store registered late, or a route store promoted; v1 only
+     * export/session subscribe). Mirrors the panel ticker cadence (default 700).
+     * Tests pass a tiny value or drive `refresh()` directly.
+     */
+    refreshIntervalMs?: number;
+}
+/** Handle returned by `attachStoreRecorder`. */
+export interface StoreRecorderHandle {
+    /** Re-enumerate stores now and subscribe to any newly-instantiated ones. */
+    refresh(): void;
+    /** Unsubscribe from every store and stop the re-enumeration interval. */
+    dispose(): void;
+}
+/**
+ * Subscribe every instantiated export/session store and fold its snapshots into
+ * the recorder's passive ring. Returns a handle whose `dispose()` unsubscribes
+ * all + stops the re-enumeration interval. Folding is gated by
+ * `recorder.recording()` — frozen/replay-mode is a full no-op.
+ */
+export declare const attachStoreRecorder: (recorder: HookRecorder, opts?: AttachStoreRecorderOptions) => StoreRecorderHandle;
+//# sourceMappingURL=storeRecorder.d.ts.map

package/dist/storeRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeRecorder.d.ts","sourceRoot":"","sources":["../src/storeRecorder.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAKrD,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,OAAO,IAAI,IAAI,CAAA;IACf,yEAAyE;IACzE,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,YAAY,EACtB,OAAM,0BAA+B,KACpC,mBA2DF,CAAA"}

package/dist/storeRecorder.js

@@ -0,0 +1,94 @@
+// @reactra/devtools — the store recorder: folds export/session store snapshots
+// into the passive time-travel ring (Devtools spec §7; plan store-time-travel
+// §3.2; architect C6).
+//
+// Subscribes every instantiated export/session store via the Stores-tab data
+// layer and, on each change, folds a `store:<name>#1` full-state snapshot into
+// the same `HookRecorder` ring the component commits + Route snapshots use.
+// Gated by `recorder.recording()` — a full no-op while frozen/replaying (the
+// ring must not grow during scrub). The snapshot runs through `recordSnapshot`,
+// which serializes via `dataBindings` — the SAME depth/size-cap serializer as
+// component commits (C6: shared serialization path, not a PII redactor — neither
+// store nor component snapshots redact by field name). Re-drive uses the recorder's
+// RAW store stash (not this serialized copy) so a `Map`/`Date`/large value
+// round-trips losslessly.
+//
+// All store kinds record (route stores included — DVT-LIM-05 narrowed). A route
+// store re-drives once its route re-instantiates it (driveAt re-drives the URL
+// FIRST, which fires onEnter → StoreRegistry.instantiate synchronously on the
+// fast path); on a middleware-gated / not-yet-loaded route the instance is async,
+// so the snapshot degrades to a `view` card (replayStoreState returns 0). Subs to
+// disposed route stores are dropped on route exit. Browser globals: none at module
+// level (setInterval lives inside `attach`, started only when called).
+import { listStores, storeInstanceToken, storeSnapshot, subscribeStore } from "./storeWatcher.js";
+/** The id a store folds under in the ring (`store:` + name + the `#1` singleton suffix). */
+const storeId = (name) => `store:${name}#1`;
+/**
+ * Subscribe every instantiated export/session store and fold its snapshots into
+ * the recorder's passive ring. Returns a handle whose `dispose()` unsubscribes
+ * all + stops the re-enumeration interval. Folding is gated by
+ * `recorder.recording()` — frozen/replay-mode is a full no-op.
+ */
+export const attachStoreRecorder = (recorder, opts = {}) => {
+    const refreshIntervalMs = opts.refreshIntervalMs ?? 700;
+    // name → { unsubscribe, instance-identity }. The instance token lets refresh
+    // detect an HMR `replace` swap and re-subscribe — a subscription made before
+    // the swap is bound to the dead instance and would silently stop folding.
+    const subs = new Map();
+    const fold = (name) => {
+        // recordSnapshot itself no-ops when recording is off (C6 + freeze gate),
+        // but check here too so we never read a snapshot we won't use.
+        if (!recorder.recording())
+            return;
+        const snap = storeSnapshot(name);
+        if (snap === undefined)
+            return;
+        recorder.recordSnapshot(storeId(name), snap);
+    };
+    const refresh = () => {
+        // All store kinds now record (route stores incl. — DVT-LIM-05 narrowed). A
+        // route store re-drives once its route re-instantiates it (driveAt Pass A);
+        // until then its snapshot is a `view` card.
+        const liveNames = new Set();
+        for (const row of listStores()) {
+            if (!row.instantiated)
+                continue;
+            liveNames.add(row.name);
+            const inst = storeInstanceToken(row.name);
+            const existing = subs.get(row.name);
+            // Already subscribed to the SAME instance → nothing to do. After an HMR
+            // `replace` (or a route-store re-enter) the token differs → drop the dead
+            // subscription + re-subscribe to the new instance.
+            if (existing && existing.inst === inst)
+                continue;
+            if (existing)
+                existing.off();
+            const off = subscribeStore(row.name, () => fold(row.name));
+            subs.set(row.name, { off, inst });
+            // Fold the current value immediately so the store has a baseline in the
+            // ring (mirrors the panel's mount-time Route#1 fold).
+            fold(row.name);
+        }
+        // C5 — drop subscriptions to stores no longer instantiated (a route store
+        // disposed on route exit). The recorded snapshots stay in the ring; we just
+        // stop holding a dead subscription. A re-enter re-subscribes above.
+        for (const name of [...subs.keys()]) {
+            if (!liveNames.has(name)) {
+                subs.get(name).off();
+                subs.delete(name);
+            }
+        }
+    };
+    refresh();
+    const intervalId = setInterval(refresh, refreshIntervalMs);
+    return {
+        refresh,
+        dispose: () => {
+            clearInterval(intervalId);
+            for (const { off } of subs.values())
+                off();
+            subs.clear();
+        },
+    };
+};
+//# sourceMappingURL=storeRecorder.js.map

package/dist/storeRecorder.js.map

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

package/dist/storeWatcher.d.ts

@@ -0,0 +1,26 @@
+/** One Stores-tab row (Devtools §5). */
+export interface StoreRow {
+    name: string;
+    kind: "export" | "session" | "route";
+    instantiated: boolean;
+    preservedFields: readonly string[];
+    subtreePath?: string;
+}
+/** Snapshot of every registered binding (fresh read — call per render tick). */
+export declare const listStores: () => readonly StoreRow[];
+/** A live store's current snapshot; `undefined` when not instantiated. */
+export declare const storeSnapshot: (name: string) => Record<string, unknown> | undefined;
+/**
+ * Subscribe to one live store's changes. No-op unsubscriber when the store
+ * isn't instantiated (route store before entry) — the panel re-lists on its
+ * own cadence and re-subscribes when the instance appears.
+ */
+export declare const subscribeStore: (name: string, onChange: () => void) => (() => void);
+/**
+ * An identity token for a store's CURRENT instance (or undefined when not
+ * instantiated). HMR `StoreRegistry.replace` swaps the instance object, so a
+ * watcher can compare this token to detect the swap and re-subscribe — without
+ * it, a subscription made before the swap stays bound to the dead instance.
+ */
+export declare const storeInstanceToken: (name: string) => object | undefined;
+//# sourceMappingURL=storeWatcher.d.ts.map

package/dist/storeWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeWatcher.d.ts","sourceRoot":"","sources":["../src/storeWatcher.ts"],"names":[],"mappings":"AAQA,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;IACpC,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,gFAAgF;AAChF,eAAO,MAAM,UAAU,QAAO,SAAS,QAAQ,EAA2B,CAAA;AAE1E,0EAA0E;AAC1E,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SACM,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CACG,CAAA;AAElF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAC2B,CAAA"}

package/dist/storeWatcher.js

@@ -0,0 +1,24 @@
+// @reactra/devtools — the Stores-tab data layer.
+//
+// Owner: reactra-devtools-spec.md §5. Thin reads over `@reactra/store`'s
+// registry: the internal `__listStoreBindings` enumeration (Runtime §1
+// internal tier — diagnostics) + per-instance subscribe/getSnapshot.
+import { StoreRegistry, __listStoreBindings } from "@reactra/store";
+/** Snapshot of every registered binding (fresh read — call per render tick). */
+export const listStores = () => __listStoreBindings();
+/** A live store's current snapshot; `undefined` when not instantiated. */
+export const storeSnapshot = (name) => StoreRegistry.has(name) ? StoreRegistry.get(name).getSnapshot() : undefined;
+/**
+ * Subscribe to one live store's changes. No-op unsubscriber when the store
+ * isn't instantiated (route store before entry) — the panel re-lists on its
+ * own cadence and re-subscribes when the instance appears.
+ */
+export const subscribeStore = (name, onChange) => StoreRegistry.has(name) ? StoreRegistry.get(name).subscribe(onChange) : () => { };
+/**
+ * An identity token for a store's CURRENT instance (or undefined when not
+ * instantiated). HMR `StoreRegistry.replace` swaps the instance object, so a
+ * watcher can compare this token to detect the swap and re-subscribe — without
+ * it, a subscription made before the swap stays bound to the dead instance.
+ */
+export const storeInstanceToken = (name) => StoreRegistry.has(name) ? StoreRegistry.get(name) : undefined;
+//# sourceMappingURL=storeWatcher.js.map

package/dist/storeWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeWatcher.js","sourceRoot":"","sources":["../src/storeWatcher.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,qEAAqE;AAErE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAWnE,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAwB,EAAE,CAAC,mBAAmB,EAAE,CAAA;AAE1E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAuC,EAAE,CACjF,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,QAAoB,EAAgB,EAAE,CACjF,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAA;AAElF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAsB,EAAE,CACrE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAuB,CAAC,CAAC,CAAC,SAAS,CAAA"}

package/dist/styles.d.ts

@@ -0,0 +1,5 @@
+/** Append the devtools stylesheet once per document. No-op outside a browser. */
+export declare const ensureStyles: (target?: Document) => void;
+/** Test hook: lets unit tests assert single-injection semantics. */
+export declare const __resetStylesForTest: () => void;
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAkBA,iFAAiF;AACjF,eAAO,MAAM,YAAY,GAAI,SAAS,QAAQ,KAAG,IAUhD,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,QAAO,IAEvC,CAAA"}