@llui/dom 0.0.17 → 0.0.19

package/dist/binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACnC,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAID,wBAAgB,eAAe,IAAI,OAAO,EAAE,GAAG,IAAI,CAElD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAiB5E;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,KAAK,EAAE,OAAO,GACb,IAAI,CAyDN"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACnC,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAID,wBAAgB,eAAe,IAAI,OAAO,EAAE,GAAG,IAAI,CAElD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAiB5E;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,KAAK,EAAE,OAAO,GACb,IAAI,CA+DN"}

package/dist/binding.js

@@ -39,6 +39,11 @@ export function applyBinding(target, value) {
             `would have been serialized into the DOM otherwise. Offender: ${value.toString().slice(0, 120)}`);
     }
     switch (target.kind) {
+        case 'effect':
+            // Side-effect-only binding — the accessor already ran for its
+            // side effects in Phase 2. We keep `applyBinding` callable for
+            // type-uniform call sites, but there is no DOM write to perform.
+            break;
         case 'text':
             target.node.nodeValue = String(value);
             break;

package/dist/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Scope, Binding, BindingKind } from './types.js'\nimport { addBinding } from './scope.js'\n\nexport interface CreateBindingOpts {\n  mask: number\n  accessor: (state: never) => unknown\n  kind: BindingKind\n  node: Node\n  key?: string\n  perItem: boolean\n}\n\nlet flatBindings: Binding[] | null = null\n\nexport function getFlatBindings(): Binding[] | null {\n  return flatBindings\n}\n\nexport function setFlatBindings(arr: Binding[] | null): void {\n  flatBindings = arr\n}\n\nexport function createBinding(scope: Scope, opts: CreateBindingOpts): Binding {\n  const binding: Binding = {\n    mask: opts.mask,\n    accessor: opts.accessor as (state: unknown) => unknown,\n    lastValue: undefined,\n    kind: opts.kind,\n    node: opts.node,\n    key: opts.key,\n    ownerScope: scope,\n    perItem: opts.perItem,\n    dead: false,\n  }\n\n  addBinding(scope, binding)\n  if (flatBindings) flatBindings.push(binding)\n\n  return binding\n}\n\nexport function applyBinding(\n  target: { kind: BindingKind; node: Node; key?: string },\n  value: unknown,\n): void {\n  // Defensive guard: if a reactive accessor leaks through as a raw\n  // function value, emitting its `.toString()` into the DOM (e.g. as\n  // an attribute) would be a silent correctness bug that only surfaces\n  // on server-rendered pages. Throw loudly so the callsite is obvious.\n  // Event handlers (onXxx → 'prop' kind) are NOT handled here; events\n  // are registered via addEventListener in the element helpers, not\n  // via applyBinding.\n  if (typeof value === 'function') {\n    throw new TypeError(\n      `[LLui] applyBinding(${target.kind}${target.key ? `, '${target.key}'` : ''}) received ` +\n        `a function as its value. This means an accessor wasn't invoked before ` +\n        `reaching the binding layer — usually a bug in a compiled binding tuple or ` +\n        `in a helper that forwards props without calling them. The arrow's source ` +\n        `would have been serialized into the DOM otherwise. Offender: ${value.toString().slice(0, 120)}`,\n    )\n  }\n\n  switch (target.kind) {\n    case 'text':\n      target.node.nodeValue = String(value)\n      break\n\n    case 'prop': {\n      const el = target.node as HTMLElement\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(el as any)[target.key!] = value\n      break\n    }\n\n    case 'attr':\n      if (value == null) {\n        ;(target.node as Element).removeAttribute(target.key!)\n      } else if (value === false) {\n        // ARIA attributes need explicit \"false\"; others are removed\n        if (target.key!.startsWith('aria-')) {\n          ;(target.node as Element).setAttribute(target.key!, 'false')\n        } else {\n          ;(target.node as Element).removeAttribute(target.key!)\n        }\n      } else {\n        ;(target.node as Element).setAttribute(target.key!, String(value))\n      }\n      break\n\n    case 'class':\n      ;(target.node as Element).setAttribute('class', value as string)\n      break\n\n    case 'style':\n      if (value == null) {\n        ;(target.node as HTMLElement).style.removeProperty(target.key!)\n      } else {\n        ;(target.node as HTMLElement).style.setProperty(target.key!, value as string)\n      }\n      break\n  }\n}\n"]}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Scope, Binding, BindingKind } from './types.js'\nimport { addBinding } from './scope.js'\n\nexport interface CreateBindingOpts {\n  mask: number\n  accessor: (state: never) => unknown\n  kind: BindingKind\n  node: Node\n  key?: string\n  perItem: boolean\n}\n\nlet flatBindings: Binding[] | null = null\n\nexport function getFlatBindings(): Binding[] | null {\n  return flatBindings\n}\n\nexport function setFlatBindings(arr: Binding[] | null): void {\n  flatBindings = arr\n}\n\nexport function createBinding(scope: Scope, opts: CreateBindingOpts): Binding {\n  const binding: Binding = {\n    mask: opts.mask,\n    accessor: opts.accessor as (state: unknown) => unknown,\n    lastValue: undefined,\n    kind: opts.kind,\n    node: opts.node,\n    key: opts.key,\n    ownerScope: scope,\n    perItem: opts.perItem,\n    dead: false,\n  }\n\n  addBinding(scope, binding)\n  if (flatBindings) flatBindings.push(binding)\n\n  return binding\n}\n\nexport function applyBinding(\n  target: { kind: BindingKind; node: Node; key?: string },\n  value: unknown,\n): void {\n  // Defensive guard: if a reactive accessor leaks through as a raw\n  // function value, emitting its `.toString()` into the DOM (e.g. as\n  // an attribute) would be a silent correctness bug that only surfaces\n  // on server-rendered pages. Throw loudly so the callsite is obvious.\n  // Event handlers (onXxx → 'prop' kind) are NOT handled here; events\n  // are registered via addEventListener in the element helpers, not\n  // via applyBinding.\n  if (typeof value === 'function') {\n    throw new TypeError(\n      `[LLui] applyBinding(${target.kind}${target.key ? `, '${target.key}'` : ''}) received ` +\n        `a function as its value. This means an accessor wasn't invoked before ` +\n        `reaching the binding layer — usually a bug in a compiled binding tuple or ` +\n        `in a helper that forwards props without calling them. The arrow's source ` +\n        `would have been serialized into the DOM otherwise. Offender: ${value.toString().slice(0, 120)}`,\n    )\n  }\n\n  switch (target.kind) {\n    case 'effect':\n      // Side-effect-only binding — the accessor already ran for its\n      // side effects in Phase 2. We keep `applyBinding` callable for\n      // type-uniform call sites, but there is no DOM write to perform.\n      break\n\n    case 'text':\n      target.node.nodeValue = String(value)\n      break\n\n    case 'prop': {\n      const el = target.node as HTMLElement\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(el as any)[target.key!] = value\n      break\n    }\n\n    case 'attr':\n      if (value == null) {\n        ;(target.node as Element).removeAttribute(target.key!)\n      } else if (value === false) {\n        // ARIA attributes need explicit \"false\"; others are removed\n        if (target.key!.startsWith('aria-')) {\n          ;(target.node as Element).setAttribute(target.key!, 'false')\n        } else {\n          ;(target.node as Element).removeAttribute(target.key!)\n        }\n      } else {\n        ;(target.node as Element).setAttribute(target.key!, String(value))\n      }\n      break\n\n    case 'class':\n      ;(target.node as Element).setAttribute('class', value as string)\n      break\n\n    case 'style':\n      if (value == null) {\n        ;(target.node as HTMLElement).style.removeProperty(target.key!)\n      } else {\n        ;(target.node as HTMLElement).style.setProperty(target.key!, value as string)\n      }\n      break\n  }\n}\n"]}

package/dist/devtools.d.ts

@@ -1,3 +1,16 @@
+import type { ScopeNode } from './types.js';
+import { type EachDiff } from './tracking/each-diff.js';
+import { type DisposerEvent } from './tracking/disposer-log.js';
+import { type CoverageSnapshot } from './tracking/coverage.js';
+import { type PendingEffect, type EffectTimelineEntry, type EffectMatch } from './tracking/effect-timeline.js';
+export interface StateDiff {
+    added: Record<string, unknown>;
+    removed: Record<string, unknown>;
+    changed: Record<string, {
+        from: unknown;
+        to: unknown;
+    }>;
+}
 /**
  * Enable devtools auto-installation for every mountApp call. Called by
  * compiler-generated dev code — never imported in production builds.
@@ -106,6 +119,102 @@ export interface LluiDebugAPI {
     restoreState(snap: unknown): void;
     /** Find all bindings whose target node matches or is a child of the selector. */
     getBindingsFor(selector: string): BindingLocation[];
+    /** Return a rich structural + style + binding report for the first element matching selector. Returns null if no element matches or document is unavailable. */
+    inspectElement(selector: string): ElementReport | null;
+    /** Get the outerHTML of the mounted component or a specific element. Pass a selector for a specific node (defaults to the mount root). Pass maxLength to truncate output. */
+    getRenderedHtml(selector?: string, maxLength?: number): string;
+    /** Synthesize and dispatch a browser event at a DOM element matched by selector. Returns dispatched status, the history indices of any Msgs the handler produced, and the resulting state. */
+    dispatchDomEvent(selector: string, type: string, init?: EventInit): {
+        dispatched: boolean;
+        messagesProducedIndices: number[];
+        resultingState: unknown | null;
+    };
+    /** Return info about the currently focused element: { selector (if it has an id), tagName, selectionStart, selectionEnd }. Useful for catching "focus lost on re-render" bugs. */
+    getFocus(): {
+        selector: string | null;
+        tagName: string | null;
+        selectionStart: number | null;
+        selectionEnd: number | null;
+    };
+    /** Re-evaluate every binding's accessor against the current state, apply values that changed to the DOM, and return indices of bindings that changed. */
+    forceRerender(): {
+        changedBindings: number[];
+    };
+    /** Per-each-site reconciliation diffs (added/removed/moved/reused keys) from the dev-time diff log. Pass sinceIndex to filter to entries after a specific message history index. */
+    getEachDiff(sinceIndex?: number): EachDiff[];
+    /** Walk the component's scope tree and return a nested ScopeNode with kind classification. Pass depth to limit traversal depth, scopeId to start from a specific scope. */
+    getScopeTree(opts?: {
+        depth?: number;
+        scopeId?: string;
+    }): ScopeNode;
+    /** Recent onDispose firings with scope id and cause. Pass 'limit' to cap results to the N most recent entries. Catches 'leak on branch swap' class bugs. */
+    getDisposerLog(limit?: number): DisposerEvent[];
+    /** Edge list: state path → binding indices that depend on it. Inverts the compiler-emitted mask legend to show, for each top-level state field, which bindings will re-evaluate when it changes. */
+    getBindingGraph(): Array<{
+        statePath: string;
+        bindingIndices: number[];
+    }>;
+    /** Current queued and in-flight effects. Each entry has { id, type, dispatchedAt, status, payload }. Use 'id' with llui_resolve_effect to manually resolve one. */
+    getPendingEffects(): PendingEffect[];
+    /** Phased log of effect events: dispatched -> in-flight -> resolved/cancelled/resolved-mocked. Each entry has { effectId, type, phase, timestamp, durationMs? }. Pass 'limit' to cap the tail. */
+    getEffectTimeline(limit?: number): EffectTimelineEntry[];
+    /** Register a mock for an effect matching 'match'. The next matching effect resolves with 'response' instead of running. Mocks are one-shot by default; pass { persist: true } to keep across matches. Returns { mockId } for later reference. */
+    mockEffect(match: EffectMatch, response: unknown, opts?: {
+        persist?: boolean;
+    }): {
+        mockId: string;
+    };
+    /** Manually resolve a pending effect with a given response. The effect's onSuccess callback (if any) runs as if it had actually resolved. Pass effectId from llui_pending_effects. */
+    resolveEffect(effectId: string, response: unknown): {
+        resolved: boolean;
+    };
+    /** Rewind state by replaying from init() with the last N messages excluded. mode='pure' suppresses effects; mode='live' re-fires them. Returns the new state and rewind depth. */
+    stepBack(n: number, mode: 'pure' | 'live'): {
+        state: unknown;
+        rewindDepth: number;
+    };
+    /** Per-Msg-variant coverage for the current session. Shows which message types have run and which haven't. */
+    getCoverage(): CoverageSnapshot;
+    /** Run arbitrary JS in page context and return { result, sideEffects }. result is the expression's return value or { error }. sideEffects captures state diff, new history entries, new pending effects, and dirty binding indices. Phase 1 does not support async expressions. */
+    evalInPage(code: string): {
+        result: unknown | {
+            error: string;
+        };
+        sideEffects: {
+            stateChanged: StateDiff | null;
+            newHistoryEntries: number;
+            newPendingEffects: PendingEffect[];
+            dirtyBindingIndices: number[];
+        };
+    };
+}
+export interface ElementReport {
+    selector: string;
+    tagName: string;
+    attributes: Record<string, string>;
+    classes: string[];
+    dataset: Record<string, string>;
+    text: string;
+    computed: {
+        display: string;
+        visibility: string;
+        position: string;
+        width: number;
+        height: number;
+    };
+    boundingBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    bindings: Array<{
+        bindingIndex: number;
+        kind: string;
+        mask: number;
+        lastValue: unknown;
+        relation: 'self' | 'text-child' | 'comment-child';
+    }>;
 }
 export interface BindingLocation {
     bindingIndex: number;

package/dist/devtools.d.ts.map

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

package/dist/devtools.js

@@ -1,5 +1,35 @@
 import { flushInstance, _forceState } from './update-loop.js';
 import { _setDevToolsInstall } from './mount.js';
+import { _markDisposerLogInstalled } from './scope.js';
+import { applyBinding } from './binding.js';
+import { createRingBuffer } from './tracking/each-diff.js';
+import { createRingBuffer as createDisposerBuffer, } from './tracking/disposer-log.js';
+import { createCoverageTracker } from './tracking/coverage.js';
+import { createRingBuffer as createTimelineBuffer, createMockRegistry, createPendingEffectsList, } from './tracking/effect-timeline.js';
+function diffStateInternal(a, b) {
+    const out = { added: {}, removed: {}, changed: {} };
+    if (a == null ||
+        b == null ||
+        typeof a !== 'object' ||
+        typeof b !== 'object' ||
+        Array.isArray(a) !== Array.isArray(b)) {
+        if (a !== b)
+            out.changed['<root>'] = { from: a, to: b };
+        return out;
+    }
+    const aObj = a;
+    const bObj = b;
+    const keys = new Set([...Object.keys(aObj), ...Object.keys(bObj)]);
+    for (const k of keys) {
+        if (!(k in aObj))
+            out.added[k] = bObj[k];
+        else if (!(k in bObj))
+            out.removed[k] = aObj[k];
+        else if (!Object.is(aObj[k], bObj[k]))
+            out.changed[k] = { from: aObj[k], to: bObj[k] };
+    }
+    return out;
+}
 /**
  * Enable devtools auto-installation for every mountApp call. Called by
  * compiler-generated dev code — never imported in production builds.
@@ -151,11 +181,62 @@ export function startRelay(port = 5200) {
     }
 }
 const MAX_HISTORY = 1000;
+function findScopeById(root, id) {
+    const n = Number(id);
+    if (root.id === n)
+        return root;
+    for (const c of root.children) {
+        const found = findScopeById(c, id);
+        if (found)
+            return found;
+    }
+    return null;
+}
+function walkScope(s, depth, maxDepth) {
+    const node = {
+        scopeId: String(s.id),
+        kind: s._kind ?? 'root',
+        active: true,
+        children: [],
+    };
+    if (depth < maxDepth) {
+        for (const c of s.children)
+            node.children.push(walkScope(c, depth + 1, maxDepth));
+    }
+    return node;
+}
 export function installDevTools(inst) {
     const ci = inst;
     const history = [];
     let idx = 0;
     let lastDirtyMask = 0;
+    // Tracker storage — populated by primitives when they detect dev-mode
+    // is active (via `inst._eachDiffLog !== undefined` guard). Zero cost in
+    // production where installDevTools never runs.
+    ci._eachDiffLog = createRingBuffer(100);
+    ci._updateCounter = 0;
+    // Disposer log — consumed by `llui_disposer_log` MCP tool. Stamped by
+    // `disposeScope` via `findInstance(scope)` — which only works when the
+    // rootScope carries an `instance` back-reference.
+    ci._disposerLog = createDisposerBuffer(500);
+    // Coverage tracker — consumed by `llui_coverage` MCP tool. Records the
+    // discriminant of each dispatched message along with the message index
+    // it fired at, allowing the tool to surface Msg variants that never
+    // fired this session. Recorded inside the update interceptor below.
+    ci._coverage = createCoverageTracker();
+    // Effect timeline / pending / mocks — consumed by the
+    // `llui_effect_timeline`, `llui_pending_effects`, `llui_mock_effect`,
+    // and `llui_resolve_effect` MCP tools. Populated by the
+    // `dispatchEffectDev` wrapper in `update-loop.ts`; zero cost in
+    // production where `_effectTimeline` stays undefined.
+    ci._effectTimeline = createTimelineBuffer(500);
+    ci._effectMocks = createMockRegistry();
+    ci._pendingEffects = createPendingEffectsList();
+    ci.rootScope.instance = ci;
+    // Flip the scope-module flag so disposeScope starts walking the parent
+    // chain to emit disposer events. Before the first installDevTools call
+    // the flag stays false and disposeScope skips findInstance entirely.
+    _markDisposerLogInstalled();
     const api = {
         getState: () => ci.state,
         send: (msg) => ci.send(msg),
@@ -191,6 +272,16 @@ export function installDevTools(inst) {
         clearLog() {
             history.length = 0;
             idx = 0;
+            ci._updateCounter = 0;
+            ci._eachDiffLog?.clear();
+            ci._disposerLog?.clear();
+            ci._coverage?.clear();
+            ci._effectTimeline?.clear();
+            ci._effectMocks?.clear();
+            // NB: `_pendingEffects` is intentionally NOT cleared — pending
+            // entries represent in-flight effects that still have to land
+            // resolution/cancellation phases. Dropping them here would leak
+            // the ids that MCP tools hold onto for `llui_resolve_effect`.
         },
         validateMessage(msg) {
             const schema = ci.def.__msgSchema;
@@ -398,6 +489,301 @@ export function installDevTools(inst) {
             }
             return results;
         },
+        inspectElement(selector) {
+            if (typeof document === 'undefined')
+                return null;
+            const el = document.querySelector(selector);
+            if (!el)
+                return null;
+            const attributes = {};
+            for (const attr of Array.from(el.attributes)) {
+                attributes[attr.name] = attr.value;
+            }
+            const classes = Array.from(el.classList);
+            const dataset = {};
+            if (el instanceof HTMLElement) {
+                for (const [key, value] of Object.entries(el.dataset)) {
+                    if (typeof value === 'string')
+                        dataset[key] = value;
+                }
+            }
+            const rawText = el.textContent ?? '';
+            const text = rawText.length > 1000 ? rawText.slice(0, 1000) : rawText;
+            const rect = el.getBoundingClientRect();
+            const boundingBox = { x: rect.x, y: rect.y, width: rect.width, height: rect.height };
+            let computed;
+            try {
+                const cs = window.getComputedStyle(el);
+                computed = {
+                    display: cs.display,
+                    visibility: cs.visibility,
+                    position: cs.position,
+                    width: rect.width,
+                    height: rect.height,
+                };
+            }
+            catch {
+                computed = {
+                    display: 'unknown',
+                    visibility: 'unknown',
+                    position: 'unknown',
+                    width: 0,
+                    height: 0,
+                };
+            }
+            const rawBindings = api.getBindingsFor(selector);
+            const bindings = rawBindings.map((b) => ({
+                bindingIndex: b.bindingIndex,
+                kind: b.kind,
+                mask: b.mask,
+                lastValue: b.lastValue,
+                relation: b.relation,
+            }));
+            return {
+                selector,
+                tagName: el.tagName.toLowerCase(),
+                attributes,
+                classes,
+                dataset,
+                text,
+                computed,
+                boundingBox,
+                bindings,
+            };
+        },
+        getRenderedHtml(selector, maxLength) {
+            if (typeof document === 'undefined')
+                return '';
+            const el = selector ? document.querySelector(selector) : document.body;
+            if (!(el instanceof Element))
+                return '';
+            const html = el.outerHTML;
+            if (typeof maxLength === 'number' && html.length > maxLength) {
+                return html.slice(0, maxLength) + `<!-- truncated; total ${html.length} chars -->`;
+            }
+            return html;
+        },
+        dispatchDomEvent(selector, type, init) {
+            const noOp = { dispatched: false, messagesProducedIndices: [], resultingState: null };
+            if (typeof document === 'undefined')
+                return noOp;
+            const el = document.querySelector(selector);
+            if (!el)
+                return noOp;
+            const preIndex = history.length > 0 ? history[history.length - 1].index : -1;
+            let event;
+            if (type === 'click' || type === 'mousedown' || type === 'mouseup') {
+                event = new MouseEvent(type, {
+                    bubbles: true,
+                    cancelable: true,
+                    ...init,
+                });
+            }
+            else if (type === 'keydown' || type === 'keyup' || type === 'keypress') {
+                event = new KeyboardEvent(type, {
+                    bubbles: true,
+                    cancelable: true,
+                    ...init,
+                });
+            }
+            else {
+                event = new Event(type, { bubbles: true, cancelable: true, ...init });
+            }
+            el.dispatchEvent(event);
+            flushInstance(ci);
+            const messagesProducedIndices = history.filter((r) => r.index > preIndex).map((r) => r.index);
+            return {
+                dispatched: true,
+                messagesProducedIndices,
+                resultingState: ci.state,
+            };
+        },
+        getFocus() {
+            if (typeof document === 'undefined') {
+                return { selector: null, tagName: null, selectionStart: null, selectionEnd: null };
+            }
+            const el = document.activeElement;
+            if (!el || el === document.body) {
+                return { selector: null, tagName: null, selectionStart: null, selectionEnd: null };
+            }
+            const id = el.id ? `#${el.id}` : null;
+            const tagName = el.tagName.toLowerCase();
+            let selectionStart = null;
+            let selectionEnd = null;
+            if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+                selectionStart = el.selectionStart ?? null;
+                selectionEnd = el.selectionEnd ?? null;
+            }
+            return { selector: id, tagName, selectionStart, selectionEnd };
+        },
+        forceRerender() {
+            const changed = [];
+            const allBindings = ci.allBindings;
+            for (let i = 0; i < allBindings.length; i++) {
+                const b = allBindings[i];
+                if (b.dead)
+                    continue;
+                const next = b.accessor(ci.state);
+                if (!Object.is(next, b.lastValue)) {
+                    changed.push(i);
+                    b.lastValue = next;
+                    applyBinding(b, next);
+                }
+            }
+            return { changedBindings: changed };
+        },
+        getEachDiff(sinceIndex) {
+            const all = ci._eachDiffLog?.toArray() ?? [];
+            if (sinceIndex === undefined)
+                return all;
+            return all.filter((e) => e.updateIndex >= sinceIndex);
+        },
+        getScopeTree(opts) {
+            const maxDepth = opts?.depth ?? Infinity;
+            const startScope = opts?.scopeId ? findScopeById(ci.rootScope, opts.scopeId) : ci.rootScope;
+            if (!startScope) {
+                return { scopeId: '0', kind: 'root', active: false, children: [] };
+            }
+            return walkScope(startScope, 0, maxDepth);
+        },
+        getDisposerLog(limit) {
+            const all = ci._disposerLog?.toArray() ?? [];
+            if (limit === undefined)
+                return all;
+            return all.slice(-Math.max(0, limit));
+        },
+        getBindingGraph() {
+            const legend = ci.def.__maskLegend;
+            if (!legend)
+                return [];
+            const result = [];
+            for (const [path, bit] of Object.entries(legend)) {
+                const indices = [];
+                for (let i = 0; i < ci.allBindings.length; i++) {
+                    const b = ci.allBindings[i];
+                    if ((b.mask & bit) !== 0)
+                        indices.push(i);
+                }
+                result.push({ statePath: path, bindingIndices: indices });
+            }
+            return result;
+        },
+        getPendingEffects() {
+            return ci._pendingEffects?.list() ?? [];
+        },
+        getEffectTimeline(limit) {
+            const all = ci._effectTimeline?.toArray() ?? [];
+            if (limit === undefined)
+                return all;
+            return all.slice(-Math.max(0, limit));
+        },
+        mockEffect(match, response, opts) {
+            if (!ci._effectMocks)
+                return { mockId: '' };
+            return { mockId: ci._effectMocks.add(match, response, Boolean(opts?.persist)) };
+        },
+        resolveEffect(effectId, response) {
+            const pending = ci._pendingEffects?.findById(effectId);
+            if (!pending)
+                return { resolved: false };
+            const payload = pending.payload;
+            if (payload?.onSuccess) {
+                const msg = payload.onSuccess(response);
+                ci.send(msg);
+            }
+            ci._pendingEffects?.remove(effectId);
+            ci._effectTimeline?.push({
+                effectId,
+                type: pending.type,
+                phase: 'resolved',
+                timestamp: Date.now(),
+                durationMs: Date.now() - pending.dispatchedAt,
+            });
+            return { resolved: true };
+        },
+        stepBack(n, mode) {
+            const rewindDepth = Math.min(Math.max(0, n), history.length);
+            const keep = history.slice(0, history.length - rewindDepth);
+            const [initialState] = ci.def.init(undefined);
+            let state = initialState;
+            const collectedEffects = [];
+            for (const record of keep) {
+                const [newState, newEffects] = ci.def.update(state, record.msg);
+                state = newState;
+                if (mode === 'live')
+                    collectedEffects.push(...newEffects);
+            }
+            _forceState(ci, state);
+            history.length = keep.length;
+            if (mode === 'live') {
+                for (const eff of collectedEffects) {
+                    if (ci.def.onEffect)
+                        ci.def.onEffect({ effect: eff, send: ci.send, signal: ci.signal });
+                }
+            }
+            return { state, rewindDepth };
+        },
+        getCoverage() {
+            if (!ci._coverage)
+                return { fired: {}, neverFired: [] };
+            const schema = ci.def.__msgSchema;
+            const known = schema?.variants ? Object.keys(schema.variants) : undefined;
+            return ci._coverage.snapshot(known);
+        },
+        evalInPage(code) {
+            const stateBefore = JSON.parse(JSON.stringify(ci.state));
+            const historyLenBefore = history.length;
+            const pendingBefore = new Set((ci._pendingEffects?.list() ?? []).map((p) => p.id));
+            const dirtyMaskBefore = lastDirtyMask;
+            let result;
+            try {
+                const fn = new Function(`return (${code})`);
+                const rv = fn();
+                if (rv && typeof rv === 'object' && 'then' in rv) {
+                    result = {
+                        error: 'llui_eval does not support async expressions in Phase 1. Wrap awaits in an IIFE and expose the result synchronously via globalThis.',
+                    };
+                }
+                else {
+                    result = rv;
+                }
+            }
+            catch (err) {
+                result = { error: err instanceof Error ? err.message : String(err) };
+            }
+            try {
+                flushInstance(ci);
+            }
+            catch {
+                // Best-effort; user's eval may have left the instance in a weird state
+            }
+            const stateAfter = ci.state;
+            const stateDiff = diffStateInternal(stateBefore, stateAfter);
+            const stateChanged = Object.keys(stateDiff.added).length === 0 &&
+                Object.keys(stateDiff.removed).length === 0 &&
+                Object.keys(stateDiff.changed).length === 0
+                ? null
+                : stateDiff;
+            const newHistoryEntries = history.length - historyLenBefore;
+            const pendingNow = ci._pendingEffects?.list() ?? [];
+            const newPendingEffects = pendingNow.filter((p) => !pendingBefore.has(p.id));
+            const dirtyBindingIndices = [];
+            const maskDiff = lastDirtyMask ^ dirtyMaskBefore;
+            for (let i = 0; i < ci.allBindings.length; i++) {
+                const b = ci.allBindings[i];
+                if ((b.mask & maskDiff) !== 0)
+                    dirtyBindingIndices.push(i);
+            }
+            return {
+                result,
+                sideEffects: {
+                    stateChanged,
+                    newHistoryEntries,
+                    newPendingEffects,
+                    dirtyBindingIndices,
+                },
+            };
+        },
     };
     // Intercept update to record transitions
     const originalUpdate = ci.def.update;
@@ -408,7 +794,7 @@ export function installDevTools(inst) {
             : -1;
         lastDirtyMask = typeof dirty === 'number' ? dirty : -1;
         const record = {
-            index: idx++,
+            index: idx,
             timestamp: Date.now(),
             msg,
             stateBefore: state,
@@ -416,6 +802,20 @@ export function installDevTools(inst) {
             effects,
             dirtyMask: lastDirtyMask,
         };
+        // _updateCounter and the history index track the same thing —
+        // tie them so EachDiff entries emitted during the ensuing Phase 1
+        // reconcile carry the same updateIndex as the message record that
+        // caused the reconcile. `each.ts` reads `inst._updateCounter` when
+        // stamping EachDiff entries.
+        ci._updateCounter = idx;
+        // Coverage: record the discriminant of this message at the SAME
+        // index stamped on the MessageRecord above, so tools can cross-
+        // reference `getMessageHistory()[i]` with `coverage.fired[v].lastIndex`.
+        const variant = msg && typeof msg === 'object' && 'type' in msg
+            ? String(msg.type)
+            : '<non-discriminant>';
+        ci._coverage?.record(variant, idx);
+        idx++;
         if (history.length >= MAX_HISTORY)
             history.shift();
         history.push(record);