@rindle/devtools 0.1.6

package/dist/core.js

@@ -0,0 +1,351 @@
+// DevtoolsCore — the framework-agnostic engine (DEBUG-TOOLS-BROWSER-DESIGN.md §6.1). It attaches to
+// a running client through the read-only seams (`Store.__attachDevtools` / `__inspect`, and the
+// optimistic backend's `__inspect`), then maintains the §4 read-model: the mutation TIMELINE
+// (reconstructed by diffing successive pending-stack snapshots), the QUERIES inspector, and the
+// DELTA stream (off the raw per-query `ChangeEvent` tap). No DOM, no app-code changes, no hot path.
+import { collectTables, summarizeAst } from "./ast.js";
+/** Narrow a candidate backend to the optimistic capability (the `__inspect` probe, §6.2). */
+function asOptimisticBackend(backend) {
+    return backend && typeof backend.__inspect === "function"
+        ? backend
+        : undefined;
+}
+const EMPTY_STATE = {
+    timeline: [],
+    queries: [],
+    deltas: [],
+    optimistic: undefined,
+    capabilities: { optimistic: false },
+};
+export class DevtoolsCore {
+    store;
+    backend;
+    detachStore;
+    timelineCap;
+    deltaCap;
+    sampleRows;
+    autoFlush;
+    now;
+    pollHandle;
+    // Timeline state: entries by stable id + an insertion-ordered id list (newest last).
+    timeline = new Map();
+    order = [];
+    /** The pending keys seen at the previous recompute — the diff basis for lifecycle transitions. */
+    prevPendingKeys = new Set();
+    // Delta ring.
+    deltas = [];
+    deltaSeq = 0;
+    /** Set by a `batch` delta, consumed by the next recompute: did view churn coincide with a
+     *  confirmation this turn? (the §4.1 snap-back heuristic). */
+    churnSeen = false;
+    queries = [];
+    optimistic;
+    listeners = new Set();
+    dirty = false;
+    flushScheduled = false;
+    snapshot = EMPTY_STATE;
+    /** Optional deregistration from the global hub (set by {@link attachDevtools}). */
+    onDetach;
+    constructor(target, opts = {}) {
+        this.store = target.store;
+        this.backend = asOptimisticBackend(target.backend);
+        this.timelineCap = opts.timelineCap ?? 200;
+        this.deltaCap = opts.deltaCap ?? 500;
+        this.sampleRows = opts.sampleRows ?? 25;
+        this.autoFlush = opts.autoFlush ?? true;
+        this.now = opts.now ?? (() => Date.now());
+        this.detachStore = this.store.__attachDevtools({
+            onDelta: (qid, ev) => this.onDelta(qid, ev),
+            onResultType: (qid, rt) => this.onResultType(qid, rt),
+        });
+        const pollMs = opts.pollMs ?? 0;
+        if (pollMs > 0) {
+            this.pollHandle = setInterval(() => this.refresh(), pollMs);
+            // Don't keep a Node process alive on the poll timer (no-op in the browser).
+            this.pollHandle.unref?.();
+        }
+        // Seed the initial snapshot from whatever the app already holds (e.g. queries mounted before
+        // the pane attached).
+        this.refresh();
+    }
+    // --- public surface ----------------------------------------------------------
+    /** The current read-model. Reference-stable between updates (rebuilt only on recompute), so it is
+     *  safe to feed a `useSyncExternalStore`-style binding. */
+    getState() {
+        return this.snapshot;
+    }
+    /** Subscribe to updates; fires immediately with the current state, then after each recompute. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener();
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** Force a synchronous recompute (also used by the safety-net poll and by tests). */
+    refresh() {
+        this.dirty = true;
+        this.flush();
+    }
+    /** Clear the delta stream ring (a panel "clear" affordance). */
+    clearDeltas() {
+        this.deltas = [];
+        this.refresh();
+    }
+    /** Drop every SETTLED timeline row (confirmed/dropped), keeping live pending ones + the deltas. */
+    clearHistory() {
+        for (let i = this.order.length - 1; i >= 0; i--) {
+            const id = this.order[i];
+            const e = this.timeline.get(id);
+            if (e && e.state !== "pending") {
+                this.timeline.delete(id);
+                this.order.splice(i, 1);
+            }
+        }
+        this.refresh();
+    }
+    /** Detach from the client: stop the poll, drop the store tap, deregister from the global hub. */
+    detach() {
+        if (this.pollHandle)
+            clearInterval(this.pollHandle);
+        this.detachStore();
+        this.onDetach?.();
+        this.listeners.clear();
+    }
+    // --- event taps --------------------------------------------------------------
+    onDelta(qid, ev) {
+        this.pushDelta(qid, ev);
+        // A `batch` carrying real changes is view churn — the signal the snap-back heuristic keys on.
+        if (ev.type === "batch" && ev.events.length > 0)
+            this.churnSeen = true;
+        this.markDirty();
+    }
+    onResultType(_qid, _rt) {
+        this.markDirty();
+    }
+    markDirty() {
+        this.dirty = true;
+        if (this.autoFlush && !this.flushScheduled) {
+            this.flushScheduled = true;
+            queueMicrotask(() => {
+                this.flushScheduled = false;
+                this.flush();
+            });
+        }
+    }
+    flush() {
+        if (!this.dirty)
+            return;
+        this.dirty = false;
+        this.recompute();
+        for (const l of this.listeners)
+            l();
+    }
+    // --- recompute ---------------------------------------------------------------
+    recompute() {
+        let opt;
+        if (this.backend) {
+            try {
+                opt = this.backend.__inspect();
+            }
+            catch {
+                opt = undefined; // a malformed/throwing dev hook never breaks the pane
+            }
+        }
+        if (opt)
+            this.reconcileTimeline(opt);
+        this.rebuildQueries(opt);
+        this.optimistic = opt;
+        this.churnSeen = false;
+        this.snapshot = {
+            timeline: this.order.map((id) => this.timeline.get(id)).filter((e) => !!e),
+            queries: this.queries,
+            deltas: this.deltas.slice(),
+            optimistic: opt,
+            capabilities: { optimistic: !!this.backend },
+        };
+    }
+    /** Reconstruct the fork/rebase lifecycle by diffing this pending snapshot against the previous
+     *  one (DEBUG-TOOLS-BROWSER-DESIGN §4.1): new keys → invoked; vanished keys → confirmed (mid ≤
+     *  confirmedLmid) or dropped; a fold's `f:<foldKey>` → `m:<mid>` transition is linked, not double
+     *  counted. */
+    reconcileTimeline(opt) {
+        const now = this.now();
+        const cur = opt.pending;
+        const curKeys = new Set(cur.map((p) => p.key));
+        const removed = [];
+        for (const k of this.prevPendingKeys)
+            if (!curKeys.has(k))
+                removed.push(k);
+        const added = cur.filter((p) => !this.prevPendingKeys.has(p.key));
+        // Fold-flush linking: an `f:<foldKey>` that vanished as an `m:<mid>` of the same (name, args)
+        // appeared is one logical mutation crossing the wire — relabel in place (FOLDED-MUTATIONS §4.1).
+        const linkedF = new Set();
+        const linkedM = new Set();
+        for (const fkey of removed) {
+            if (!fkey.startsWith("f:"))
+                continue;
+            const fEntry = this.timeline.get(fkey);
+            if (!fEntry)
+                continue;
+            const match = added.find((p) => p.key.startsWith("m:") && !linkedM.has(p.key) && p.name === fEntry.name && argsEqual(p.args, fEntry.args));
+            if (!match)
+                continue;
+            this.renameEntry(fkey, match.key);
+            const e = this.timeline.get(match.key);
+            if (e) {
+                e.mid = match.mid;
+                e.tables = match.tables;
+                e.folded = true;
+                // A flushed fold has already left `folds`, so the m:<mid> snapshot carries no `fold` window —
+                // keep the one captured while it was debouncing and just mark it flushed.
+                const window = match.fold ?? e.fold;
+                e.fold = window ? { ...window, flushed: true } : undefined;
+            }
+            linkedF.add(fkey);
+            linkedM.add(match.key);
+        }
+        // Freshly invoked entries (not the m: side of a link).
+        for (const p of added) {
+            if (linkedM.has(p.key) || this.timeline.has(p.key))
+                continue;
+            this.addEntry({
+                id: p.key,
+                mid: p.mid,
+                name: p.name,
+                args: p.args,
+                tables: p.tables,
+                state: "pending",
+                folded: !!p.fold,
+                fold: p.fold,
+                invokedAt: now,
+                reconciledWithChurn: false,
+                affectedQueries: [],
+            });
+        }
+        // Refresh still-pending entries (a rebase re-invoke can change touched tables / args / mid).
+        for (const p of cur) {
+            const e = this.timeline.get(p.key);
+            if (!e || e.state !== "pending")
+                continue;
+            e.mid = p.mid;
+            e.args = p.args;
+            e.tables = p.tables;
+            if (p.fold) {
+                e.folded = true;
+                e.fold = p.fold;
+            }
+        }
+        // Settle vanished entries (those not consumed by a fold link).
+        for (const k of removed) {
+            if (linkedF.has(k))
+                continue;
+            const e = this.timeline.get(k);
+            if (!e || e.state !== "pending")
+                continue;
+            const confirmed = e.mid != null && e.mid <= opt.confirmedLmid;
+            e.state = confirmed ? "confirmed" : "dropped";
+            e.settledAt = now;
+            e.reconciledWithChurn = confirmed && this.churnSeen;
+        }
+        this.prevPendingKeys = curKeys;
+    }
+    rebuildQueries(opt) {
+        const pendingTables = new Set(opt?.pendingTables ?? []);
+        const queries = this.store.__inspect(this.sampleRows).queries.map((q) => {
+            const tables = [...collectTables(q.ast)];
+            return {
+                qid: q.qid,
+                ast: q.ast,
+                table: q.ast.table,
+                summary: summarizeAst(q.ast),
+                tables,
+                resultType: q.resultType,
+                rowCount: q.rowCount,
+                sample: q.sample,
+                pending: tables.some((t) => pendingTables.has(t)),
+            };
+        });
+        this.queries = queries;
+        // Recompute each timeline entry's affected queries against the CURRENT live views.
+        if (this.timeline.size > 0) {
+            for (const e of this.timeline.values()) {
+                const touched = new Set(e.tables);
+                e.affectedQueries = queries.filter((q) => q.tables.some((t) => touched.has(t))).map((q) => q.qid);
+            }
+        }
+    }
+    // --- delta ring --------------------------------------------------------------
+    pushDelta(qid, ev) {
+        if (ev.type === "hello") {
+            this.appendDelta(qid, "hello", 0, `hello · ${ev.schema.columns.length} col${ev.schema.columns.length === 1 ? "" : "s"}`);
+        }
+        else if (ev.type === "snapshot") {
+            const n = ev.adds.length;
+            this.appendDelta(qid, "snapshot", 0, `snapshot · +${n} row${n === 1 ? "" : "s"}${ev.last ? "" : " (chunk)"}`);
+        }
+        else {
+            for (const ch of ev.events) {
+                const depth = ch.path.length;
+                this.appendDelta(qid, ch.op.tag, depth, describeOp(ch.op) + (depth > 0 ? `  (child @${depth})` : ""));
+            }
+        }
+    }
+    appendDelta(qid, kind, depth, label) {
+        this.deltas.push({ seq: this.deltaSeq++, at: this.now(), qid, kind, depth, label });
+        if (this.deltas.length > this.deltaCap)
+            this.deltas.splice(0, this.deltas.length - this.deltaCap);
+    }
+    // --- timeline map bookkeeping ------------------------------------------------
+    addEntry(entry) {
+        this.timeline.set(entry.id, entry);
+        this.order.push(entry.id);
+        // Cap: evict the oldest SETTLED rows first; never drop a live pending row.
+        while (this.order.length > this.timelineCap) {
+            const idx = this.order.findIndex((id) => this.timeline.get(id)?.state !== "pending");
+            if (idx < 0)
+                break;
+            const [evicted] = this.order.splice(idx, 1);
+            this.timeline.delete(evicted);
+        }
+    }
+    renameEntry(oldId, newId) {
+        const e = this.timeline.get(oldId);
+        if (!e)
+            return;
+        this.timeline.delete(oldId);
+        e.id = newId;
+        this.timeline.set(newId, e);
+        const i = this.order.indexOf(oldId);
+        if (i >= 0)
+            this.order[i] = newId;
+    }
+}
+/** Structural args equality for fold-flush linking (args are JSON-serializable mutator inputs). */
+function argsEqual(a, b) {
+    if (a === b)
+        return true;
+    try {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    catch {
+        return false;
+    }
+}
+function describeOp(op) {
+    if (op.tag === "add")
+        return `add ${rowPreview(op.node.row)}`;
+    if (op.tag === "remove")
+        return `remove ${rowPreview(op.row)}`;
+    return `edit ${rowPreview(op.old)} → ${rowPreview(op.new)}`;
+}
+function rowPreview(row) {
+    const head = row.slice(0, 3).map(cellStr).join(", ");
+    return `[${head}${row.length > 3 ? ", …" : ""}]`;
+}
+function cellStr(v) {
+    if (typeof v === "string")
+        return v.length > 16 ? `"${v.slice(0, 15)}…"` : `"${v}"`;
+    return String(v);
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/global.d.ts

@@ -0,0 +1,22 @@
+import { DevtoolsCore } from "./core.ts";
+import type { DevtoolsCoreOptions, DevtoolsTarget } from "./types.ts";
+/** The discovery surface a panel binds to: the set of attached cores + a change subscription. */
+export interface DevtoolsHub {
+    readonly version: number;
+    readonly cores: readonly DevtoolsCore[];
+    /** Fires whenever a core attaches or detaches (so a panel can pick one up). */
+    subscribe(listener: () => void): () => void;
+    /** Register a core; returns its deregistration function. */
+    register(core: DevtoolsCore): () => void;
+}
+/** Get (creating on first use) the global devtools hub. A panel calls this to discover attached
+ *  clients; it is safe to call before any `attachDevtools`. */
+export declare function getDevtoolsHub(): DevtoolsHub;
+/** The most recently attached core, or `undefined` — the common single-app convenience a panel uses. */
+export declare function getDevtoolsCore(): DevtoolsCore | undefined;
+/** Attach a devtools pane to a running client (DEBUG-TOOLS-BROWSER-DESIGN §6.2). Call this ONLY in a
+ *  dev build (e.g. behind `import.meta.env.DEV` with a dynamic `import("@rindle/devtools")`) so the
+ *  pane, its core, and this registration tree-shake out of production. Returns the {@link DevtoolsCore}
+ *  (also discoverable via {@link getDevtoolsHub}); call `core.detach()` to unwind. */
+export declare function attachDevtools(target: DevtoolsTarget, opts?: DevtoolsCoreOptions): DevtoolsCore;
+//# sourceMappingURL=global.d.ts.map

package/dist/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAItE,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,+EAA+E;IAC/E,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,IAAI,CAAC;CAC1C;AAmCD;+DAC+D;AAC/D,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,wGAAwG;AACxG,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAG1D;AAED;;;sFAGsF;AACtF,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAM/F"}

package/dist/global.js

@@ -0,0 +1,60 @@
+// The opt-in global registry (DEBUG-TOOLS-BROWSER-DESIGN.md §6.2). The client core stays clean —
+// no global mutable singleton lives in `@rindle/client`/`@rindle/optimistic`. Instead a dev build
+// calls `attachDevtools(app)`, which constructs a {@link DevtoolsCore} and registers it on
+// `globalThis.__RINDLE_DEVTOOLS__`, the same discovery pattern TanStack/Redux DevTools use. A panel
+// finds the hub with {@link getDevtoolsHub} and subscribes — so it works whether it mounts before or
+// after the app attaches.
+import { DevtoolsCore } from "./core.js";
+const GLOBAL_KEY = "__RINDLE_DEVTOOLS__";
+class Hub {
+    version = 1;
+    cores = [];
+    listeners = new Set();
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    register(core) {
+        this.cores.push(core);
+        this.emit();
+        return () => {
+            const i = this.cores.indexOf(core);
+            if (i >= 0) {
+                this.cores.splice(i, 1);
+                this.emit();
+            }
+        };
+    }
+    emit() {
+        for (const l of this.listeners)
+            l();
+    }
+}
+function globalSlot() {
+    return globalThis;
+}
+/** Get (creating on first use) the global devtools hub. A panel calls this to discover attached
+ *  clients; it is safe to call before any `attachDevtools`. */
+export function getDevtoolsHub() {
+    const slot = globalSlot();
+    return (slot[GLOBAL_KEY] ??= new Hub());
+}
+/** The most recently attached core, or `undefined` — the common single-app convenience a panel uses. */
+export function getDevtoolsCore() {
+    const cores = getDevtoolsHub().cores;
+    return cores[cores.length - 1];
+}
+/** Attach a devtools pane to a running client (DEBUG-TOOLS-BROWSER-DESIGN §6.2). Call this ONLY in a
+ *  dev build (e.g. behind `import.meta.env.DEV` with a dynamic `import("@rindle/devtools")`) so the
+ *  pane, its core, and this registration tree-shake out of production. Returns the {@link DevtoolsCore}
+ *  (also discoverable via {@link getDevtoolsHub}); call `core.detach()` to unwind. */
+export function attachDevtools(target, opts) {
+    // Default the safety-net poll on for real apps (a fold's debounced flush / a pending flip on an
+    // already-`complete` query move state with no event); tests construct DevtoolsCore directly.
+    const core = new DevtoolsCore(target, { pollMs: 500, ...opts });
+    core.onDetach = getDevtoolsHub().register(core);
+    return core;
+}
+//# sourceMappingURL=global.js.map

package/dist/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,kGAAkG;AAClG,2FAA2F;AAC3F,oGAAoG;AACpG,qGAAqG;AACrG,0BAA0B;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAYzC,MAAM,GAAG;IACE,OAAO,GAAG,CAAC,CAAC;IACZ,KAAK,GAAmB,EAAE,CAAC;IACnB,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD,SAAS,CAAC,QAAoB;QAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,IAAkB;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxB,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAEO,IAAI;QACV,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,EAAE,CAAC;IACtC,CAAC;CACF;AAED,SAAS,UAAU;IACjB,OAAO,UAAmE,CAAC;AAC7E,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,KAAK,CAAC;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;sFAGsF;AACtF,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,IAA0B;IAC/E,gGAAgG;IAChG,6FAA6F;IAC7F,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DevtoolsCore } from "./core.ts";
+export { attachDevtools, getDevtoolsCore, getDevtoolsHub } from "./global.ts";
+export type { DevtoolsHub } from "./global.ts";
+export { collectTables, summarizeAst } from "./ast.ts";
+export type { DeltaEntry, DeltaKind, DevtoolsBackend, DevtoolsCoreOptions, DevtoolsState, DevtoolsStore, DevtoolsTarget, FoldInspect, MutationState, OptimisticInspect, PendingInspect, QueryEntry, TimelineEntry, } from "./types.ts";
+export type { Ast, ChangeEvent, QueryId, ResultType, StoreDevObserver, StoreInspect } from "@rindle/client";
+//# 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":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,YAAY,EACV,UAAU,EACV,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AAIpB,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @rindle/devtools — the framework-agnostic in-browser devtools core (DEBUG-TOOLS-BROWSER-DESIGN.md).
+// Attaches to a running client over the read-only seams and maintains the §4 read-model: a mutation
+// TIMELINE (the fork/rebase loop made visible), a QUERIES inspector, and a DELTA stream. Dev-only;
+// pair it with a panel (`@rindle/react-devtools`) or read `getDevtoolsCore().getState()` directly.
+export { DevtoolsCore } from "./core.js";
+export { attachDevtools, getDevtoolsCore, getDevtoolsHub } from "./global.js";
+export { collectTables, summarizeAst } from "./ast.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,sGAAsG;AACtG,oGAAoG;AACpG,mGAAmG;AACnG,mGAAmG;AAEnG,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,137 @@
+import type { Ast, ResultType, StoreDevObserver, StoreInspect } from "@rindle/client";
+export type { Ast, ChangeEvent, FlatChange, FlatOp, QueryId, ResultType, StoreDevObserver, StoreInspect } from "@rindle/client";
+/** One folded entry's debounce window — mirror of `@rindle/optimistic`'s `FoldInspect`. */
+export interface FoldInspect {
+    foldKey: string;
+    debounceMs: number;
+    maxWaitMs?: number;
+    deferAcrossWrites: boolean;
+    flushed: boolean;
+}
+/** One pending mutation — mirror of `@rindle/optimistic`'s `PendingInspect`. */
+export interface PendingInspect {
+    key: string;
+    mid: number | null;
+    name: string;
+    args: unknown;
+    tables: string[];
+    fold?: FoldInspect;
+}
+/** A snapshot of the optimistic loop — mirror of `@rindle/optimistic`'s `OptimisticInspect`. */
+export interface OptimisticInspect {
+    pending: PendingInspect[];
+    confirmedLmid: number;
+    nextMid: number;
+    appliedCv: number;
+    bufferedFrames: number;
+    pendingTables: string[];
+}
+/** The Store surface the core reads (a structural subset of `@rindle/client`'s `Store`). */
+export interface DevtoolsStore {
+    __attachDevtools(observer: StoreDevObserver): () => void;
+    __inspect(sampleRows?: number): StoreInspect;
+}
+/** The optional optimistic-backend capability — present on `OptimisticBackend`, absent on a plain
+ *  wasm/replica backend (then there is no mutation timeline, but queries + deltas still work). */
+export interface DevtoolsBackend {
+    __inspect(): OptimisticInspect;
+}
+/** What {@link attachDevtools} binds to: a `createRindleClient` app, or any `{ store, backend }`. */
+export interface DevtoolsTarget {
+    store: DevtoolsStore;
+    /** Narrowed to {@link DevtoolsBackend} at runtime when it carries `__inspect` (capability probe). */
+    backend?: unknown;
+}
+/** A mutation's place in the fork/rebase lifecycle (DEBUG-TOOLS-BROWSER-DESIGN §4.1). */
+export type MutationState = "pending" | "confirmed" | "dropped";
+/** One row of the mutation timeline — the optimistic loop made visible. */
+export interface TimelineEntry {
+    /** Stable identity across snapshots: the pending key (`m:<mid>` once a mid is dealt, else
+     *  `f:<foldKey>` while a fold debounces). Retained after the entry settles. */
+    id: string;
+    /** The wire mutation id, or `null` for a still-folding entry. */
+    mid: number | null;
+    name: string;
+    args: unknown;
+    /** Tables the mutator touched (its pending-axis footprint). */
+    tables: string[];
+    state: MutationState;
+    /** True for a debounced/folded write; `fold` carries its window while it is live. */
+    folded: boolean;
+    fold?: FoldInspect;
+    /** Devtools-clock ms at first observation (invoke). */
+    invokedAt: number;
+    /** Devtools-clock ms when it left the pending stack (confirmed or dropped). */
+    settledAt?: number;
+    /** Heuristic (§4.1): view churn coincided with this mutation's confirmation — a POSSIBLE
+     *  snap-back (the optimistic prediction diverged from the authoritative server result). Labeled
+     *  "possible" because unrelated server data released in the same coherent batch also shows churn;
+     *  a precise signal needs a reconcile-boundary event (a future engine seam). */
+    reconciledWithChurn: boolean;
+    /** qids of live queries whose tables this mutation touches (computed against the current views). */
+    affectedQueries: number[];
+}
+/** One materialized view in the queries inspector (DEBUG-TOOLS-BROWSER-DESIGN §4.2). */
+export interface QueryEntry {
+    qid: number;
+    ast: Ast;
+    /** The root table (`ast.table`). */
+    table: string;
+    /** A one-line human summary of the AST (table, filters, order, limit, relationships). */
+    summary: string;
+    /** Every base table the query reads (root + correlated subqueries). */
+    tables: string[];
+    resultType: ResultType;
+    rowCount: number;
+    sample: readonly unknown[];
+    /** Does any pending mutation touch this query's tables? (the §7.2 pending axis). */
+    pending: boolean;
+}
+/** The kind of a delta-stream row. `child` is an Add/Remove/Edit addressed at a NESTED path
+ *  (`depth > 0`) — rindle's relationship-level change (DEBUG-TOOLS-BROWSER-DESIGN §4.3). */
+export type DeltaKind = "hello" | "snapshot" | "add" | "remove" | "edit";
+/** One entry of the live delta stream — the IVM change primitive made visible (§4.3). */
+export interface DeltaEntry {
+    seq: number;
+    at: number;
+    qid: number;
+    kind: DeltaKind;
+    /** Nesting depth of the change path: 0 = top-level row, >0 = a child (relationship) change. */
+    depth: number;
+    /** A compact, human-readable description of the change. */
+    label: string;
+}
+/** The whole devtools snapshot a panel renders. Reference-stable arrays between updates where the
+ *  underlying data did not change is NOT guaranteed — panels should treat each `getState()` as fresh. */
+export interface DevtoolsState {
+    /** Newest-last mutation timeline (capped). */
+    timeline: TimelineEntry[];
+    /** Every live materialized view. */
+    queries: QueryEntry[];
+    /** Newest-last delta stream ring (capped). */
+    deltas: DeltaEntry[];
+    /** The raw optimistic-loop snapshot, when the backend exposes one (a "loop" summary line). */
+    optimistic?: OptimisticInspect;
+    capabilities: {
+        optimistic: boolean;
+    };
+}
+/** Construction options for {@link DevtoolsCore}. */
+export interface DevtoolsCoreOptions {
+    /** Max timeline rows retained (oldest settled rows drop first). Default 200. */
+    timelineCap?: number;
+    /** Max delta-stream rows retained. Default 500. */
+    deltaCap?: number;
+    /** Per-query row sample size pulled from the store. Default 25. */
+    sampleRows?: number;
+    /** Safety-net poll interval (ms) that catches state moves with no event — a fold's debounced
+     *  flush, or a pending flip on an already-`complete` query. Default 0 (off); {@link attachDevtools}
+     *  turns it on. */
+    pollMs?: number;
+    /** Coalesce event-driven recomputes onto a microtask. Default true; tests pass `false` and drive
+     *  recomputes explicitly via {@link DevtoolsCore.refresh}. */
+    autoFlush?: boolean;
+    /** Injectable clock (ms). Default `Date.now`; tests inject a deterministic counter. */
+    now?: () => number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+// The devtools read-model (DEBUG-TOOLS-BROWSER-DESIGN.md §4) and the read-only seams the core
+// attaches to. Everything here is derived, in dev, from state the client already holds — the core
+// adds no hot-path instrumentation (§1.1 "surface, not instrument").
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,kGAAkG;AAClG,qEAAqE"}