@llui/dom 0.0.18 → 0.0.19

package/dist/tracking/coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/tracking/coverage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgD,CAAA;IACrE,OAAO;QACL,MAAM,CAAC,OAAO,EAAE,YAAY;YAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACnC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,KAAK,EAAE,CAAA;gBAChB,QAAQ,CAAC,SAAS,GAAG,YAAY,CAAA;YACnC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAA;YAC3D,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,aAAa;YACpB,MAAM,QAAQ,GAAyD,EAAE,CAAA;YACzE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK;gBAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;YAClD,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAClF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;QACxC,CAAC;QACD,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * Per-variant Msg coverage tracker — dev-only.\n *\n * Records each dispatched message's discriminant (or `<non-discriminant>`\n * for objects missing a `type` field) along with the message index it\n * fired at. Consumed by the `llui_coverage` MCP tool to surface untested\n * Msg variants: any variant declared in the compiled `__msgSchema` that\n * never fired in the current session shows up in `neverFired`.\n *\n * Zero cost in production: `installDevTools` is the only caller, and it\n * never runs in prod builds. Hot path is one optional-chain read per\n * dispatched message (`ci._coverage?.record(...)`).\n */\n\nexport interface CoverageSnapshot {\n  fired: Record<string, { count: number; lastIndex: number }>\n  neverFired: string[]\n}\n\nexport interface CoverageTracker {\n  record(variant: string, messageIndex: number): void\n  snapshot(knownVariants?: string[]): CoverageSnapshot\n  clear(): void\n}\n\nexport function createCoverageTracker(): CoverageTracker {\n  const fired = new Map<string, { count: number; lastIndex: number }>()\n  return {\n    record(variant, messageIndex) {\n      const existing = fired.get(variant)\n      if (existing) {\n        existing.count++\n        existing.lastIndex = messageIndex\n      } else {\n        fired.set(variant, { count: 1, lastIndex: messageIndex })\n      }\n    },\n    snapshot(knownVariants) {\n      const firedObj: Record<string, { count: number; lastIndex: number }> = {}\n      for (const [k, v] of fired) firedObj[k] = { ...v }\n      const neverFired = knownVariants ? knownVariants.filter((v) => !fired.has(v)) : []\n      return { fired: firedObj, neverFired }\n    },\n    clear() {\n      fired.clear()\n    },\n  }\n}\n"]}

package/dist/tracking/disposer-log.d.ts

@@ -0,0 +1,22 @@
+import { createRingBuffer, type RingBuffer } from './each-diff.js';
+/**
+ * Dev-only disposer log entry, emitted once per `disposeScope` call
+ * when the owning component instance has an `_disposerLog` ring buffer
+ * installed by `installDevTools`.
+ *
+ * `cause` is set by the structural primitive (each / branch / child)
+ * immediately before calling `disposeScope`. When no cause was
+ * explicitly set, `disposeScope` falls back to `'component-unmount'`.
+ * `'app-unmount'` is reserved for the top-level `mountApp` teardown.
+ *
+ * Used by the `llui_disposer_log` MCP tool to diagnose leaks on
+ * structural transitions (e.g., branch swap that fails to release a
+ * subscription registered in the old arm).
+ */
+export interface DisposerEvent {
+    scopeId: string;
+    cause: 'branch-swap' | 'each-remove' | 'show-hide' | 'child-unmount' | 'app-unmount' | 'component-unmount';
+    timestamp: number;
+}
+export { createRingBuffer, type RingBuffer };
+//# sourceMappingURL=disposer-log.d.ts.map

package/dist/tracking/disposer-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposer-log.d.ts","sourceRoot":"","sources":["../../src/tracking/disposer-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EACD,aAAa,GACb,aAAa,GACb,WAAW,GACX,eAAe,GACf,aAAa,GACb,mBAAmB,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,CAAA"}

package/dist/tracking/disposer-log.js

@@ -0,0 +1,3 @@
+import { createRingBuffer } from './each-diff.js';
+export { createRingBuffer };
+//# sourceMappingURL=disposer-log.js.map

package/dist/tracking/disposer-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposer-log.js","sourceRoot":"","sources":["../../src/tracking/disposer-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,gBAAgB,CAAA;AA4BlE,OAAO,EAAE,gBAAgB,EAAmB,CAAA","sourcesContent":["import { createRingBuffer, type RingBuffer } from './each-diff.js'\n\n/**\n * Dev-only disposer log entry, emitted once per `disposeScope` call\n * when the owning component instance has an `_disposerLog` ring buffer\n * installed by `installDevTools`.\n *\n * `cause` is set by the structural primitive (each / branch / child)\n * immediately before calling `disposeScope`. When no cause was\n * explicitly set, `disposeScope` falls back to `'component-unmount'`.\n * `'app-unmount'` is reserved for the top-level `mountApp` teardown.\n *\n * Used by the `llui_disposer_log` MCP tool to diagnose leaks on\n * structural transitions (e.g., branch swap that fails to release a\n * subscription registered in the old arm).\n */\nexport interface DisposerEvent {\n  scopeId: string\n  cause:\n    | 'branch-swap'\n    | 'each-remove'\n    | 'show-hide'\n    | 'child-unmount'\n    | 'app-unmount'\n    | 'component-unmount'\n  timestamp: number\n}\n\nexport { createRingBuffer, type RingBuffer }\n"]}

package/dist/tracking/each-diff.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Per-each-block reconciliation diff, recorded once per update that
+ * mutates an each() block's key set. Dev-only — populated when
+ * `installDevTools` has initialized an `_eachDiffLog` on the instance.
+ *
+ * `updateIndex` correlates with the message-history index recorded by
+ * `devtools.ts` so tools can join diffs back to the message that caused
+ * them. `eachSiteId` identifies the each() call site stably across
+ * updates (currently derived from the block's index in the instance's
+ * `structuralBlocks` array at creation time).
+ */
+export interface EachDiff {
+    /**
+     * Message-history index at the time the diff was emitted. When messages are
+     * batched (multiple send() calls coalescing into one microtask), this is
+     * the index of the LAST message in the batch — not necessarily the one that
+     * caused the structural change. For per-message correlation, use
+     * getMessageHistory with this index as an upper bound.
+     */
+    updateIndex: number;
+    /**
+     * Stable-ish identifier for the each() call site. Currently derived from the
+     * position of the block in `ComponentInstance.structuralBlocks` at the moment
+     * of registration, formatted as `each#${N}`.
+     *
+     * Caveats for consumers:
+     * - The counter includes ALL structural blocks (branches, shows, portals,
+     *   eaches), not just eaches. So `each#3` means "the 4th structural block",
+     *   not "the 4th each".
+     * - Blocks registered inside a `branch` arm that switches away are spliced
+     *   out; a subsequent each registration can reuse the same N.
+     * - Across HMR reloads the ID may drift if the view's structural-block
+     *   order changed.
+     *
+     * For precise correlation across updates, pair with `updateIndex` and the
+     * enclosing component's state at that index (retrievable via
+     * getMessageHistory).
+     */
+    eachSiteId: string;
+    added: string[];
+    removed: string[];
+    moved: Array<{
+        key: string;
+        from: number;
+        to: number;
+    }>;
+    reused: string[];
+}
+export interface RingBuffer<T> {
+    push(entry: T): void;
+    toArray(): T[];
+    clear(): void;
+    size(): number;
+}
+/**
+ * Minimal ring buffer: unbounded `push` trimmed to `maxSize` via shift.
+ * Kept tiny on purpose — any fancier implementation would pay interest
+ * for an allocation-cost saving that only matters under unrealistic
+ * dev-only churn. If we ever need it, replace with a circular array.
+ */
+export declare function createRingBuffer<T>(maxSize: number): RingBuffer<T>;
+//# sourceMappingURL=each-diff.d.ts.map

package/dist/tracking/each-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"each-diff.d.ts","sourceRoot":"","sources":["../../src/tracking/each-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvD,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACpB,OAAO,IAAI,CAAC,EAAE,CAAA;IACd,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAiBlE"}

package/dist/tracking/each-diff.js

@@ -0,0 +1,26 @@
+/**
+ * Minimal ring buffer: unbounded `push` trimmed to `maxSize` via shift.
+ * Kept tiny on purpose — any fancier implementation would pay interest
+ * for an allocation-cost saving that only matters under unrealistic
+ * dev-only churn. If we ever need it, replace with a circular array.
+ */
+export function createRingBuffer(maxSize) {
+    const buf = [];
+    return {
+        push(entry) {
+            if (buf.length >= maxSize)
+                buf.shift();
+            buf.push(entry);
+        },
+        toArray() {
+            return buf.slice();
+        },
+        clear() {
+            buf.length = 0;
+        },
+        size() {
+            return buf.length;
+        },
+    };
+}
+//# sourceMappingURL=each-diff.js.map

package/dist/tracking/each-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"each-diff.js","sourceRoot":"","sources":["../../src/tracking/each-diff.ts"],"names":[],"mappings":"AAoDA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAI,OAAe;IACjD,MAAM,GAAG,GAAQ,EAAE,CAAA;IACnB,OAAO;QACL,IAAI,CAAC,KAAK;YACR,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO;gBAAE,GAAG,CAAC,KAAK,EAAE,CAAA;YACtC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,CAAC;QACD,OAAO;YACL,OAAO,GAAG,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC;QACD,KAAK;YACH,GAAG,CAAC,MAAM,GAAG,CAAC,CAAA;QAChB,CAAC;QACD,IAAI;YACF,OAAO,GAAG,CAAC,MAAM,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * Per-each-block reconciliation diff, recorded once per update that\n * mutates an each() block's key set. Dev-only — populated when\n * `installDevTools` has initialized an `_eachDiffLog` on the instance.\n *\n * `updateIndex` correlates with the message-history index recorded by\n * `devtools.ts` so tools can join diffs back to the message that caused\n * them. `eachSiteId` identifies the each() call site stably across\n * updates (currently derived from the block's index in the instance's\n * `structuralBlocks` array at creation time).\n */\nexport interface EachDiff {\n  /**\n   * Message-history index at the time the diff was emitted. When messages are\n   * batched (multiple send() calls coalescing into one microtask), this is\n   * the index of the LAST message in the batch — not necessarily the one that\n   * caused the structural change. For per-message correlation, use\n   * getMessageHistory with this index as an upper bound.\n   */\n  updateIndex: number\n  /**\n   * Stable-ish identifier for the each() call site. Currently derived from the\n   * position of the block in `ComponentInstance.structuralBlocks` at the moment\n   * of registration, formatted as `each#${N}`.\n   *\n   * Caveats for consumers:\n   * - The counter includes ALL structural blocks (branches, shows, portals,\n   *   eaches), not just eaches. So `each#3` means \"the 4th structural block\",\n   *   not \"the 4th each\".\n   * - Blocks registered inside a `branch` arm that switches away are spliced\n   *   out; a subsequent each registration can reuse the same N.\n   * - Across HMR reloads the ID may drift if the view's structural-block\n   *   order changed.\n   *\n   * For precise correlation across updates, pair with `updateIndex` and the\n   * enclosing component's state at that index (retrievable via\n   * getMessageHistory).\n   */\n  eachSiteId: string\n  added: string[]\n  removed: string[]\n  moved: Array<{ key: string; from: number; to: number }>\n  reused: string[]\n}\n\nexport interface RingBuffer<T> {\n  push(entry: T): void\n  toArray(): T[]\n  clear(): void\n  size(): number\n}\n\n/**\n * Minimal ring buffer: unbounded `push` trimmed to `maxSize` via shift.\n * Kept tiny on purpose — any fancier implementation would pay interest\n * for an allocation-cost saving that only matters under unrealistic\n * dev-only churn. If we ever need it, replace with a circular array.\n */\nexport function createRingBuffer<T>(maxSize: number): RingBuffer<T> {\n  const buf: T[] = []\n  return {\n    push(entry) {\n      if (buf.length >= maxSize) buf.shift()\n      buf.push(entry)\n    },\n    toArray() {\n      return buf.slice()\n    },\n    clear() {\n      buf.length = 0\n    },\n    size() {\n      return buf.length\n    },\n  }\n}\n"]}

package/dist/tracking/effect-timeline.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Effect timeline + pending-effects list + mock registry — the three
+ * trackers that back the `llui_pending_effects`, `llui_effect_timeline`,
+ * `llui_mock_effect`, and `llui_resolve_effect` MCP tools.
+ *
+ * Dev-only — populated on `ComponentInstance` when `installDevTools`
+ * runs. Zero cost in production (the `dispatchEffectDev` wrapper in
+ * `update-loop.ts` short-circuits when `_effectTimeline` is undefined).
+ *
+ * The mock registry stores match-to-response pairs; the actual
+ * response delivery (i.e., converting a mocked response back into a
+ * Msg via the effect's `onSuccess` callback) is the responsibility of
+ * the MCP `llui_resolve_effect` tool — not this module.
+ */
+import { createRingBuffer, type RingBuffer } from './each-diff.js';
+export interface EffectTimelineEntry {
+    effectId: string;
+    type: string;
+    phase: 'dispatched' | 'in-flight' | 'resolved' | 'resolved-mocked' | 'cancelled';
+    timestamp: number;
+    /** Populated on `resolved` / `resolved-mocked` / `cancelled` entries; undefined on open phases. */
+    durationMs?: number;
+}
+export interface PendingEffect {
+    id: string;
+    type: string;
+    dispatchedAt: number;
+    status: 'queued' | 'in-flight';
+    payload: unknown;
+}
+/**
+ * Match predicate for the mock registry. All provided fields must
+ * match for the mock to fire:
+ * - `type`: exact-match against the effect's `type` discriminant.
+ * - `payloadPath`: dotted path into the effect object (e.g. `'url'` or
+ *   `'body.key'`). When present without `payloadEquals`, presence of
+ *   the path is sufficient.
+ * - `payloadEquals`: strict (`===`) equality check at `payloadPath`.
+ *
+ * An empty match (no fields) matches every effect — callers should
+ * set at least `type` to avoid accidental catch-all.
+ */
+export interface EffectMatch {
+    type?: string;
+    payloadPath?: string;
+    payloadEquals?: unknown;
+}
+export interface EffectMock {
+    mockId: string;
+    match: EffectMatch;
+    response: unknown;
+    /** When false, the mock is removed after the first match (one-shot). */
+    persist: boolean;
+}
+export interface MockRegistry {
+    add(match: EffectMatch, response: unknown, persist: boolean): string;
+    match(effect: unknown): {
+        response: unknown;
+        mockId: string;
+    } | null;
+    clear(): void;
+    list(): EffectMock[];
+}
+export declare function createMockRegistry(): MockRegistry;
+export interface PendingEffectsList {
+    push(p: PendingEffect): void;
+    findById(id: string): PendingEffect | undefined;
+    remove(id: string): void;
+    list(): PendingEffect[];
+}
+export declare function createPendingEffectsList(): PendingEffectsList;
+export { createRingBuffer, type RingBuffer };
+//# sourceMappingURL=effect-timeline.d.ts.map

package/dist/tracking/effect-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-timeline.d.ts","sourceRoot":"","sources":["../../src/tracking/effect-timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAElE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,iBAAiB,GAAG,WAAW,CAAA;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;IACpE,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACpE,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,UAAU,EAAE,CAAA;CACrB;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAqDjD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,IAAI,aAAa,EAAE,CAAA;CACxB;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAa7D;AAED,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,CAAA"}

package/dist/tracking/effect-timeline.js

@@ -0,0 +1,89 @@
+/**
+ * Effect timeline + pending-effects list + mock registry — the three
+ * trackers that back the `llui_pending_effects`, `llui_effect_timeline`,
+ * `llui_mock_effect`, and `llui_resolve_effect` MCP tools.
+ *
+ * Dev-only — populated on `ComponentInstance` when `installDevTools`
+ * runs. Zero cost in production (the `dispatchEffectDev` wrapper in
+ * `update-loop.ts` short-circuits when `_effectTimeline` is undefined).
+ *
+ * The mock registry stores match-to-response pairs; the actual
+ * response delivery (i.e., converting a mocked response back into a
+ * Msg via the effect's `onSuccess` callback) is the responsibility of
+ * the MCP `llui_resolve_effect` tool — not this module.
+ */
+import { createRingBuffer } from './each-diff.js';
+export function createMockRegistry() {
+    const mocks = [];
+    let nextId = 1;
+    function resolvePath(obj, path) {
+        const parts = path.split('.');
+        let v = obj;
+        for (const p of parts) {
+            if (v == null || typeof v !== 'object')
+                return undefined;
+            v = v[p];
+        }
+        return v;
+    }
+    function matches(m, effect) {
+        if (effect == null || typeof effect !== 'object')
+            return false;
+        const eff = effect;
+        if (m.match.type !== undefined && eff.type !== m.match.type)
+            return false;
+        if (m.match.payloadPath !== undefined) {
+            const v = resolvePath(eff, m.match.payloadPath);
+            if (m.match.payloadEquals !== undefined && v !== m.match.payloadEquals)
+                return false;
+            // Presence-only check: path must resolve to something other than undefined.
+            if (m.match.payloadEquals === undefined && v === undefined)
+                return false;
+        }
+        return true;
+    }
+    return {
+        add(match, response, persist) {
+            const mockId = `mock-${nextId++}`;
+            mocks.push({ mockId, match, response, persist });
+            return mockId;
+        },
+        match(effect) {
+            for (let i = 0; i < mocks.length; i++) {
+                const m = mocks[i];
+                if (matches(m, effect)) {
+                    const response = m.response;
+                    const mockId = m.mockId;
+                    if (!m.persist)
+                        mocks.splice(i, 1);
+                    return { response, mockId };
+                }
+            }
+            return null;
+        },
+        clear() {
+            mocks.length = 0;
+            nextId = 1;
+        },
+        list() {
+            return mocks.slice();
+        },
+    };
+}
+export function createPendingEffectsList() {
+    const items = [];
+    return {
+        push(p) {
+            items.push(p);
+        },
+        findById: (id) => items.find((p) => p.id === id),
+        remove(id) {
+            const i = items.findIndex((p) => p.id === id);
+            if (i >= 0)
+                items.splice(i, 1);
+        },
+        list: () => items.slice(),
+    };
+}
+export { createRingBuffer };
+//# sourceMappingURL=effect-timeline.js.map

package/dist/tracking/effect-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-timeline.js","sourceRoot":"","sources":["../../src/tracking/effect-timeline.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Effect timeline + pending-effects list + mock registry — the three\n * trackers that back the `llui_pending_effects`, `llui_effect_timeline`,\n * `llui_mock_effect`, and `llui_resolve_effect` MCP tools.\n *\n * Dev-only — populated on `ComponentInstance` when `installDevTools`\n * runs. Zero cost in production (the `dispatchEffectDev` wrapper in\n * `update-loop.ts` short-circuits when `_effectTimeline` is undefined).\n *\n * The mock registry stores match-to-response pairs; the actual\n * response delivery (i.e., converting a mocked response back into a\n * Msg via the effect's `onSuccess` callback) is the responsibility of\n * the MCP `llui_resolve_effect` tool — not this module.\n */\nimport { createRingBuffer, type RingBuffer } from './each-diff.js'\n\nexport interface EffectTimelineEntry {\n  effectId: string\n  type: string\n  phase: 'dispatched' | 'in-flight' | 'resolved' | 'resolved-mocked' | 'cancelled'\n  timestamp: number\n  /** Populated on `resolved` / `resolved-mocked` / `cancelled` entries; undefined on open phases. */\n  durationMs?: number\n}\n\nexport interface PendingEffect {\n  id: string\n  type: string\n  dispatchedAt: number\n  status: 'queued' | 'in-flight'\n  payload: unknown\n}\n\n/**\n * Match predicate for the mock registry. All provided fields must\n * match for the mock to fire:\n * - `type`: exact-match against the effect's `type` discriminant.\n * - `payloadPath`: dotted path into the effect object (e.g. `'url'` or\n *   `'body.key'`). When present without `payloadEquals`, presence of\n *   the path is sufficient.\n * - `payloadEquals`: strict (`===`) equality check at `payloadPath`.\n *\n * An empty match (no fields) matches every effect — callers should\n * set at least `type` to avoid accidental catch-all.\n */\nexport interface EffectMatch {\n  type?: string\n  payloadPath?: string\n  payloadEquals?: unknown\n}\n\nexport interface EffectMock {\n  mockId: string\n  match: EffectMatch\n  response: unknown\n  /** When false, the mock is removed after the first match (one-shot). */\n  persist: boolean\n}\n\nexport interface MockRegistry {\n  add(match: EffectMatch, response: unknown, persist: boolean): string\n  match(effect: unknown): { response: unknown; mockId: string } | null\n  clear(): void\n  list(): EffectMock[]\n}\n\nexport function createMockRegistry(): MockRegistry {\n  const mocks: EffectMock[] = []\n  let nextId = 1\n\n  function resolvePath(obj: Record<string, unknown>, path: string): unknown {\n    const parts = path.split('.')\n    let v: unknown = obj\n    for (const p of parts) {\n      if (v == null || typeof v !== 'object') return undefined\n      v = (v as Record<string, unknown>)[p]\n    }\n    return v\n  }\n\n  function matches(m: EffectMock, effect: unknown): boolean {\n    if (effect == null || typeof effect !== 'object') return false\n    const eff = effect as Record<string, unknown>\n    if (m.match.type !== undefined && eff.type !== m.match.type) return false\n    if (m.match.payloadPath !== undefined) {\n      const v = resolvePath(eff, m.match.payloadPath)\n      if (m.match.payloadEquals !== undefined && v !== m.match.payloadEquals) return false\n      // Presence-only check: path must resolve to something other than undefined.\n      if (m.match.payloadEquals === undefined && v === undefined) return false\n    }\n    return true\n  }\n\n  return {\n    add(match, response, persist) {\n      const mockId = `mock-${nextId++}`\n      mocks.push({ mockId, match, response, persist })\n      return mockId\n    },\n    match(effect) {\n      for (let i = 0; i < mocks.length; i++) {\n        const m = mocks[i]!\n        if (matches(m, effect)) {\n          const response = m.response\n          const mockId = m.mockId\n          if (!m.persist) mocks.splice(i, 1)\n          return { response, mockId }\n        }\n      }\n      return null\n    },\n    clear() {\n      mocks.length = 0\n      nextId = 1\n    },\n    list() {\n      return mocks.slice()\n    },\n  }\n}\n\nexport interface PendingEffectsList {\n  push(p: PendingEffect): void\n  findById(id: string): PendingEffect | undefined\n  remove(id: string): void\n  list(): PendingEffect[]\n}\n\nexport function createPendingEffectsList(): PendingEffectsList {\n  const items: PendingEffect[] = []\n  return {\n    push(p) {\n      items.push(p)\n    },\n    findById: (id) => items.find((p) => p.id === id),\n    remove(id) {\n      const i = items.findIndex((p) => p.id === id)\n      if (i >= 0) items.splice(i, 1)\n    },\n    list: () => items.slice(),\n  }\n}\n\nexport { createRingBuffer, type RingBuffer }\n"]}

package/dist/types.d.ts

@@ -137,7 +137,24 @@ export interface Scope {
     /** Per-item updaters — called directly by each() when item changes, bypassing Phase 2 */
     itemUpdaters: Array<() => void>;
 }
-export type BindingKind = 'text' | 'prop' | 'attr' | 'class' | 'style';
+export interface ScopeNode {
+    scopeId: string;
+    kind: 'root' | 'show' | 'each' | 'branch' | 'child' | 'portal' | 'foreign';
+    active: boolean;
+    children: ScopeNode[];
+}
+/**
+ * Binding output kinds.
+ *
+ * `'text' | 'prop' | 'attr' | 'class' | 'style'` write their accessor's
+ * return value to the DOM. `'effect'` is a side-effect-only watcher:
+ * the accessor is invoked every Phase 2 tick its mask is hit, but its
+ * return value is discarded and `applyBinding` is a no-op. Used by
+ * `child()` to fire the prop-diff/propsMsg cascade on parent updates
+ * without the cost of stringifying the returned props bag onto a
+ * detached anchor node every render.
+ */
+export type BindingKind = 'text' | 'prop' | 'attr' | 'class' | 'style' | 'effect';
 export interface Binding {
     mask: number;
     accessor: (state: unknown) => unknown;

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qEAAqE","sourcesContent":["// ── Component Definition ──────────────────────────────────────────\n\nimport type { View } from './view-helpers.js'\nimport type { StructuralBlock } from './structural.js'\n\nexport interface ComponentDef<S, M, E = never, D = void> {\n  name: string\n  init: (data: D) => [S, E[]]\n  update: (state: S, msg: M) => [S, E[]]\n  view: (h: View<S, M>) => Node[]\n  onEffect?: (ctx: { effect: E; send: Send<M>; signal: AbortSignal }) => void\n\n  // Level 2 composition\n  propsMsg?: (props: Record<string, unknown>) => M\n  receives?: Record<string, (params: unknown) => M>\n\n  /** @internal Compiler-injected */\n  __dirty?: (oldState: S, newState: S) => number | [number, number]\n  /** @internal Compiler-injected */\n  __renderToString?: (state: S) => string\n  /** @internal Compiler-injected */\n  __msgSchema?: object\n  /** @internal Compiler-injected — maps top-level state field → dirty-mask bit(s) */\n  __maskLegend?: Record<string, number>\n  /** @internal Compiler-injected — source-file location of the component() call */\n  __componentMeta?: { file: string; line: number }\n  /** @internal Compiler-injected — shape of the State type (for introspection) */\n  __stateSchema?: object\n  /** @internal Compiler-injected — Effect union schema (for introspection) */\n  __effectSchema?: object\n  /** @internal Compiler-injected — replaces generic Phase 1 + Phase 2 loop */\n  __update?: (\n    state: S,\n    dirty: number,\n    bindings: Binding[],\n    blocks: StructuralBlock[],\n    bindingsBeforePhase1: number,\n  ) => void\n  /** @internal Compiler-injected — per-message-type specialized handlers.\n   *  Bypass the entire processMessages pipeline for single-message updates. */\n  __handlers?: Record<string, (inst: object, msg: unknown) => [S, E[]]>\n}\n\nexport type Send<M> = (msg: M) => void\n\n/**\n * Type-erased component definition for use at module boundaries where\n * the consumer's `S`, `M`, `E` are internal and invisible to the caller.\n *\n * Why this exists: `ComponentDef<S, M, E, D>` uses property syntax for\n * its callable fields (`init: (data: D) => ...`), and TypeScript\n * checks property syntax with strict (contravariant) variance. That's\n * the right call for user-facing type safety when authoring a\n * component (a narrower `Msg` type can't accidentally satisfy the\n * `update`'s param), but it means `ComponentDef<MyState, MyMsg, MyEffect, MyData>`\n * is NOT structurally assignable to `ComponentDef<unknown, unknown, unknown, unknown>`\n * — the `init: (data: MyData) => ...` field is contravariant in `MyData`,\n * so widening to `unknown` is rejected.\n *\n * `AnyComponentDef` (and `LazyDef<D>` below) declare the same fields\n * using **method syntax** (`init(data: D): ...`), which TypeScript\n * checks bivariantly. Concrete `ComponentDef<S, M, E, D>` assigns into\n * these structurally without any `widenDef` helper at the callsite.\n *\n * Used by every API that accepts an opaque component definition at a\n * module boundary:\n *\n * - `child({ def })`\n * - `lazy({ loader })` — returns `LazyDef<D>` so the loader's `D` survives\n * - `createOnRenderClient({ Layout })` (from `@llui/vike`)\n * - `createOnRenderHtml({ Layout })` (from `@llui/vike`)\n *\n * The `D` parameter is `unknown` here — `child()` doesn't pass init\n * data through, and `Layout` callers pass route-supplied data whose\n * shape is unknown at the type-erased boundary. Use `LazyDef<D>` when\n * you need to preserve the init data shape (the lazy loader case).\n */\nexport interface AnyComponentDef {\n  name: string\n  init(data: unknown): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Type-erased component definition for use at module boundaries where the\n * loaded component's S, M, E are internal and invisible to the caller.\n * Only `D` (init data) survives because the caller provides it.\n *\n * `ComponentDef<S, M, E, D>` is structurally assignable to `LazyDef<D>`\n * for any S, M, E — `view: (h: unknown) => Node[]` accepts any View via\n * contravariance, and all other fields widen to `unknown` return types.\n *\n * Used by `lazy()` as the loader's return type. Use `AnyComponentDef`\n * (above) when D is also opaque — most other adapter-layer APIs.\n */\nexport interface LazyDef<D = void> {\n  name: string\n  // Method syntax — TypeScript checks methods bivariantly, so\n  // ComponentDef<S, M, E, D>'s concrete (state: S, msg: M) => ...\n  // assigns here even though S/M ≠ unknown. Property syntax would\n  // be contravariant and reject the assignment.\n  init(data: D): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Maps a value shape to a reactive-props shape: every field becomes an accessor\n * `(s: S) => V`. Use for Level-1 view function signatures.\n *\n * ```ts\n * type ToolbarData = { tools: Tool[]; theme: 'light' | 'dark' }\n *\n * export function toolbar<S>(props: Props<ToolbarData, S>, send: Send<Msg>) {\n *   return [div({ class: props.theme }, [each({ items: props.tools, ... })])]\n * }\n *\n * // Caller — TypeScript enforces per-field accessors; passing a raw value errors:\n * toolbar({ tools: (s: State) => s.tools, theme: (s) => s.theme }, send)\n * ```\n */\nexport type Props<T, S> = {\n  [K in keyof T]: (s: S) => T[K]\n}\n\n// ── App Handle ────────────────────────────────────────────────────\n\nexport interface AppHandle {\n  dispose(): void\n  flush(): void\n  /**\n   * Dispatch a message into the mounted instance from outside its\n   * normal view-bound `send` channel. Useful for adapter layers that\n   * need to push updates into a long-lived instance — e.g.\n   * `@llui/vike`'s persistent-layout chain pushes layout-data updates\n   * into surviving layer instances on client navigation when their\n   * `propsMsg` translates the new data into a state-update message.\n   *\n   * Messages are queued through the same path as `view`-side `send`\n   * calls — they batch into the next microtask and process via the\n   * normal update loop. Calling `send` after `dispose` is a no-op.\n   */\n  send(msg: unknown): void\n}\n\n// ── Scope ─────────────────────────────────────────────────────────\n\nexport interface Scope {\n  id: number\n  parent: Scope | null\n  children: Scope[]\n  disposers: Array<() => void>\n  bindings: Binding[]\n  /** Per-item updaters — called directly by each() when item changes, bypassing Phase 2 */\n  itemUpdaters: Array<() => void>\n}\n\n// ── Binding ───────────────────────────────────────────────────────\n\nexport type BindingKind = 'text' | 'prop' | 'attr' | 'class' | 'style'\n\nexport interface Binding {\n  mask: number\n  accessor: (state: unknown) => unknown\n  lastValue: unknown\n  kind: BindingKind\n  node: Node\n  key?: string\n  ownerScope: Scope\n  perItem: boolean\n  dead: boolean\n}\n\n// ── Structural Primitives ─────────────────────────────────────────\n\nexport interface TransitionOptions {\n  enter?: (nodes: Node[]) => void | Promise<void>\n  leave?: (nodes: Node[]) => void | Promise<void>\n  onTransition?: (ctx: { entering: Node[]; leaving: Node[]; parent: Node }) => void | Promise<void>\n}\n\nexport interface BranchOptions<S, M = unknown> extends TransitionOptions {\n  on: (s: S) => string | number | boolean\n  cases: Record<string | number, (h: View<S, M>) => Node[]>\n}\n\nexport interface ShowOptions<S, M = unknown> extends TransitionOptions {\n  when: (s: S) => boolean\n  render: (h: View<S, M>) => Node[]\n  fallback?: (h: View<S, M>) => Node[]\n}\n\n/**\n * Options for `each()`. The inherited `enter` / `leave` callbacks fire **per item**:\n * `enter(nodes)` runs after an item's DOM is inserted (including initial mount);\n * `leave(nodes)` runs before an item's DOM is removed and may return a Promise\n * to hold the DOM until the animation resolves. Setting `leave` disables the\n * bulk-clear / full-replace fast paths.\n */\n/**\n * Per-item accessor. Two access forms:\n * - `item.field` — shorthand, returns accessor for `item.current[field]`\n * - `item(t => t.expr)` — computed expressions\n *\n * In both cases the returned value is a `() => V` accessor.\n * Invoke it (`item.field()`) to read the current value imperatively.\n */\nexport type ItemAccessor<T> = {\n  <R>(selector: (t: T) => R): () => R\n} & {\n  [K in keyof T]-?: () => T[K]\n}\n\nexport interface EachOptions<S, T, M = unknown> extends TransitionOptions {\n  items: (s: S) => T[]\n  key: (item: T) => string | number\n  render: (opts: {\n    send: Send<M>\n    item: ItemAccessor<T>\n    /**\n     * Plain (non-Proxy) accessor factory. Compiler-output path; avoid in user code\n     * (use `item.field` / `item(fn)` — more ergonomic and bypasses Proxy when compiled).\n     */\n    acc: <R>(selector: (t: T) => R) => () => R\n    index: () => number\n    /** @internal Compiler-injected — entry reference for row factory */\n    entry?: Record<string, unknown>\n  }) => Node[]\n}\n\nexport interface PortalOptions {\n  target: HTMLElement | string\n  render: () => Node[]\n}\n\nexport interface ForeignOptions<S, M, T extends Record<string, unknown>, Instance> {\n  mount: (ctx: { container: HTMLElement; send: Send<M> }) => Instance\n  props: (s: S) => T\n  sync:\n    | ((ctx: { instance: Instance; props: T; prev: T | undefined }) => void)\n    | {\n        [K in keyof T]?: (ctx: { instance: Instance; value: T[K]; prev: T[K] | undefined }) => void\n      }\n  destroy: (instance: Instance) => void\n  container?: { tag?: string; attrs?: Record<string, string> }\n}\n\nexport interface ChildOptions<S, ChildM> {\n  // Type-erased via AnyComponentDef so callers can pass any concrete\n  // ComponentDef<S, M, E, D> without a widening helper. The runtime\n  // narrows the message shape via the user-supplied `onMsg` callback,\n  // which keeps `ChildM` typed at this boundary even though the def\n  // itself is opaque.\n  def: AnyComponentDef\n  key: string | number\n  props: (s: S) => Record<string, unknown>\n  onMsg?: (msg: ChildM) => unknown | null\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qEAAqE","sourcesContent":["// ── Component Definition ──────────────────────────────────────────\n\nimport type { View } from './view-helpers.js'\nimport type { StructuralBlock } from './structural.js'\nimport type { ComponentInstance } from './update-loop.js'\nimport type { DisposerEvent } from './tracking/disposer-log.js'\n\nexport interface ComponentDef<S, M, E = never, D = void> {\n  name: string\n  init: (data: D) => [S, E[]]\n  update: (state: S, msg: M) => [S, E[]]\n  view: (h: View<S, M>) => Node[]\n  onEffect?: (ctx: { effect: E; send: Send<M>; signal: AbortSignal }) => void\n\n  // Level 2 composition\n  propsMsg?: (props: Record<string, unknown>) => M\n  receives?: Record<string, (params: unknown) => M>\n\n  /** @internal Compiler-injected */\n  __dirty?: (oldState: S, newState: S) => number | [number, number]\n  /** @internal Compiler-injected */\n  __renderToString?: (state: S) => string\n  /** @internal Compiler-injected */\n  __msgSchema?: object\n  /** @internal Compiler-injected — maps top-level state field → dirty-mask bit(s) */\n  __maskLegend?: Record<string, number>\n  /** @internal Compiler-injected — source-file location of the component() call */\n  __componentMeta?: { file: string; line: number }\n  /** @internal Compiler-injected — shape of the State type (for introspection) */\n  __stateSchema?: object\n  /** @internal Compiler-injected — Effect union schema (for introspection) */\n  __effectSchema?: object\n  /** @internal Compiler-injected — replaces generic Phase 1 + Phase 2 loop */\n  __update?: (\n    state: S,\n    dirty: number,\n    bindings: Binding[],\n    blocks: StructuralBlock[],\n    bindingsBeforePhase1: number,\n  ) => void\n  /** @internal Compiler-injected — per-message-type specialized handlers.\n   *  Bypass the entire processMessages pipeline for single-message updates. */\n  __handlers?: Record<string, (inst: object, msg: unknown) => [S, E[]]>\n}\n\nexport type Send<M> = (msg: M) => void\n\n/**\n * Type-erased component definition for use at module boundaries where\n * the consumer's `S`, `M`, `E` are internal and invisible to the caller.\n *\n * Why this exists: `ComponentDef<S, M, E, D>` uses property syntax for\n * its callable fields (`init: (data: D) => ...`), and TypeScript\n * checks property syntax with strict (contravariant) variance. That's\n * the right call for user-facing type safety when authoring a\n * component (a narrower `Msg` type can't accidentally satisfy the\n * `update`'s param), but it means `ComponentDef<MyState, MyMsg, MyEffect, MyData>`\n * is NOT structurally assignable to `ComponentDef<unknown, unknown, unknown, unknown>`\n * — the `init: (data: MyData) => ...` field is contravariant in `MyData`,\n * so widening to `unknown` is rejected.\n *\n * `AnyComponentDef` (and `LazyDef<D>` below) declare the same fields\n * using **method syntax** (`init(data: D): ...`), which TypeScript\n * checks bivariantly. Concrete `ComponentDef<S, M, E, D>` assigns into\n * these structurally without any `widenDef` helper at the callsite.\n *\n * Used by every API that accepts an opaque component definition at a\n * module boundary:\n *\n * - `child({ def })`\n * - `lazy({ loader })` — returns `LazyDef<D>` so the loader's `D` survives\n * - `createOnRenderClient({ Layout })` (from `@llui/vike`)\n * - `createOnRenderHtml({ Layout })` (from `@llui/vike`)\n *\n * The `D` parameter is `unknown` here — `child()` doesn't pass init\n * data through, and `Layout` callers pass route-supplied data whose\n * shape is unknown at the type-erased boundary. Use `LazyDef<D>` when\n * you need to preserve the init data shape (the lazy loader case).\n */\nexport interface AnyComponentDef {\n  name: string\n  init(data: unknown): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Type-erased component definition for use at module boundaries where the\n * loaded component's S, M, E are internal and invisible to the caller.\n * Only `D` (init data) survives because the caller provides it.\n *\n * `ComponentDef<S, M, E, D>` is structurally assignable to `LazyDef<D>`\n * for any S, M, E — `view: (h: unknown) => Node[]` accepts any View via\n * contravariance, and all other fields widen to `unknown` return types.\n *\n * Used by `lazy()` as the loader's return type. Use `AnyComponentDef`\n * (above) when D is also opaque — most other adapter-layer APIs.\n */\nexport interface LazyDef<D = void> {\n  name: string\n  // Method syntax — TypeScript checks methods bivariantly, so\n  // ComponentDef<S, M, E, D>'s concrete (state: S, msg: M) => ...\n  // assigns here even though S/M ≠ unknown. Property syntax would\n  // be contravariant and reject the assignment.\n  init(data: D): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Maps a value shape to a reactive-props shape: every field becomes an accessor\n * `(s: S) => V`. Use for Level-1 view function signatures.\n *\n * ```ts\n * type ToolbarData = { tools: Tool[]; theme: 'light' | 'dark' }\n *\n * export function toolbar<S>(props: Props<ToolbarData, S>, send: Send<Msg>) {\n *   return [div({ class: props.theme }, [each({ items: props.tools, ... })])]\n * }\n *\n * // Caller — TypeScript enforces per-field accessors; passing a raw value errors:\n * toolbar({ tools: (s: State) => s.tools, theme: (s) => s.theme }, send)\n * ```\n */\nexport type Props<T, S> = {\n  [K in keyof T]: (s: S) => T[K]\n}\n\n// ── App Handle ────────────────────────────────────────────────────\n\nexport interface AppHandle {\n  dispose(): void\n  flush(): void\n  /**\n   * Dispatch a message into the mounted instance from outside its\n   * normal view-bound `send` channel. Useful for adapter layers that\n   * need to push updates into a long-lived instance — e.g.\n   * `@llui/vike`'s persistent-layout chain pushes layout-data updates\n   * into surviving layer instances on client navigation when their\n   * `propsMsg` translates the new data into a state-update message.\n   *\n   * Messages are queued through the same path as `view`-side `send`\n   * calls — they batch into the next microtask and process via the\n   * normal update loop. Calling `send` after `dispose` is a no-op.\n   */\n  send(msg: unknown): void\n}\n\n// ── Scope ─────────────────────────────────────────────────────────\n\nexport interface Scope {\n  id: number\n  parent: Scope | null\n  children: Scope[]\n  disposers: Array<() => void>\n  bindings: Binding[]\n  /** Per-item updaters — called directly by each() when item changes, bypassing Phase 2 */\n  itemUpdaters: Array<() => void>\n  /**\n   * @internal dev-only back-reference to the owning ComponentInstance.\n   * Populated on the root scope by `installDevTools` so `disposeScope`\n   * can walk up the scope chain and emit DisposerEvents into the\n   * instance's `_disposerLog`. Undefined in production.\n   */\n  instance?: ComponentInstance\n  /**\n   * @internal dev-only cause hint. Structural primitives (branch, each,\n   * child, mountApp teardown) set this field immediately before calling\n   * `disposeScope`; the dispose path reads it once to stamp the emitted\n   * DisposerEvent. Left undefined, `disposeScope` falls back to\n   * `'component-unmount'`. Undefined in production.\n   */\n  disposalCause?: DisposerEvent['cause']\n  /** @internal dev-only — populated by structural primitives for scope-tree classification */\n  _kind?: 'root' | 'show' | 'each' | 'branch' | 'child' | 'portal' | 'foreign'\n}\n\nexport interface ScopeNode {\n  scopeId: string\n  kind: 'root' | 'show' | 'each' | 'branch' | 'child' | 'portal' | 'foreign'\n  active: boolean\n  children: ScopeNode[]\n}\n\n// ── Binding ───────────────────────────────────────────────────────\n\n/**\n * Binding output kinds.\n *\n * `'text' | 'prop' | 'attr' | 'class' | 'style'` write their accessor's\n * return value to the DOM. `'effect'` is a side-effect-only watcher:\n * the accessor is invoked every Phase 2 tick its mask is hit, but its\n * return value is discarded and `applyBinding` is a no-op. Used by\n * `child()` to fire the prop-diff/propsMsg cascade on parent updates\n * without the cost of stringifying the returned props bag onto a\n * detached anchor node every render.\n */\nexport type BindingKind = 'text' | 'prop' | 'attr' | 'class' | 'style' | 'effect'\n\nexport interface Binding {\n  mask: number\n  accessor: (state: unknown) => unknown\n  lastValue: unknown\n  kind: BindingKind\n  node: Node\n  key?: string\n  ownerScope: Scope\n  perItem: boolean\n  dead: boolean\n}\n\n// ── Structural Primitives ─────────────────────────────────────────\n\nexport interface TransitionOptions {\n  enter?: (nodes: Node[]) => void | Promise<void>\n  leave?: (nodes: Node[]) => void | Promise<void>\n  onTransition?: (ctx: { entering: Node[]; leaving: Node[]; parent: Node }) => void | Promise<void>\n}\n\nexport interface BranchOptions<S, M = unknown> extends TransitionOptions {\n  on: (s: S) => string | number | boolean\n  cases: Record<string | number, (h: View<S, M>) => Node[]>\n  /**\n   * @internal Set by `show()` when it delegates to `branch()`, so the\n   * dev-only disposer log can report `'show-hide'` instead of the\n   * default `'branch-swap'` for the leaving arm. User code should not\n   * set this directly.\n   */\n  __disposalCause?: DisposerEvent['cause']\n}\n\nexport interface ShowOptions<S, M = unknown> extends TransitionOptions {\n  when: (s: S) => boolean\n  render: (h: View<S, M>) => Node[]\n  fallback?: (h: View<S, M>) => Node[]\n}\n\n/**\n * Options for `each()`. The inherited `enter` / `leave` callbacks fire **per item**:\n * `enter(nodes)` runs after an item's DOM is inserted (including initial mount);\n * `leave(nodes)` runs before an item's DOM is removed and may return a Promise\n * to hold the DOM until the animation resolves. Setting `leave` disables the\n * bulk-clear / full-replace fast paths.\n */\n/**\n * Per-item accessor. Two access forms:\n * - `item.field` — shorthand, returns accessor for `item.current[field]`\n * - `item(t => t.expr)` — computed expressions\n *\n * In both cases the returned value is a `() => V` accessor.\n * Invoke it (`item.field()`) to read the current value imperatively.\n */\nexport type ItemAccessor<T> = {\n  <R>(selector: (t: T) => R): () => R\n} & {\n  [K in keyof T]-?: () => T[K]\n}\n\nexport interface EachOptions<S, T, M = unknown> extends TransitionOptions {\n  items: (s: S) => T[]\n  key: (item: T) => string | number\n  render: (opts: {\n    send: Send<M>\n    item: ItemAccessor<T>\n    /**\n     * Plain (non-Proxy) accessor factory. Compiler-output path; avoid in user code\n     * (use `item.field` / `item(fn)` — more ergonomic and bypasses Proxy when compiled).\n     */\n    acc: <R>(selector: (t: T) => R) => () => R\n    index: () => number\n    /** @internal Compiler-injected — entry reference for row factory */\n    entry?: Record<string, unknown>\n  }) => Node[]\n}\n\nexport interface PortalOptions {\n  target: HTMLElement | string\n  render: () => Node[]\n}\n\nexport interface ForeignOptions<S, M, T extends Record<string, unknown>, Instance> {\n  mount: (ctx: { container: HTMLElement; send: Send<M> }) => Instance\n  props: (s: S) => T\n  sync:\n    | ((ctx: { instance: Instance; props: T; prev: T | undefined }) => void)\n    | {\n        [K in keyof T]?: (ctx: { instance: Instance; value: T[K]; prev: T[K] | undefined }) => void\n      }\n  destroy: (instance: Instance) => void\n  container?: { tag?: string; attrs?: Record<string, string> }\n}\n\nexport interface ChildOptions<S, ChildM> {\n  // Type-erased via AnyComponentDef so callers can pass any concrete\n  // ComponentDef<S, M, E, D> without a widening helper. The runtime\n  // narrows the message shape via the user-supplied `onMsg` callback,\n  // which keeps `ChildM` typed at this boundary even though the def\n  // itself is opaque.\n  def: AnyComponentDef\n  key: string | number\n  props: (s: S) => Record<string, unknown>\n  onMsg?: (msg: ChildM) => unknown | null\n}\n"]}

package/dist/update-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-loop.d.ts","sourceRoot":"","sources":["../src/update-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAKtD,eAAO,MAAM,SAAS,QAAiB,CAAA;AAMvC,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,CAAC,GAAG,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,GAClE,IAAI,CAEN;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACtE,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1B,KAAK,EAAE,CAAC,CAAA;IACR,cAAc,EAAE,CAAC,EAAE,CAAA;IACnB,SAAS,EAAE,KAAK,CAAA;IAChB,WAAW,EAAE,OAAO,EAAE,CAAA;IACtB,gBAAgB,EAAE,eAAe,EAAE,CAAA;IACnC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,CAAC,EAAE,CAAA;IAChB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAA;IACtB,MAAM,EAAE,WAAW,CAAA;IACnB,eAAe,EAAE,eAAe,CAAA;CACjC;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC7C,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,GAAE,KAAK,GAAG,IAAW,GAC/B,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAsC5B;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAiCxF;AA0GD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAoCtB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EAAE,EACnB,oBAAoB,EAAE,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAuCN"}
+{"version":3,"file":"update-loop.d.ts","sourceRoot":"","sources":["../src/update-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAatD,eAAO,MAAM,SAAS,QAAiB,CAAA;AAMvC,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,CAAC,GAAG,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,GAClE,IAAI,CAEN;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACtE,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1B,KAAK,EAAE,CAAC,CAAA;IACR,cAAc,EAAE,CAAC,EAAE,CAAA;IACnB,SAAS,EAAE,KAAK,CAAA;IAChB,WAAW,EAAE,OAAO,EAAE,CAAA;IACtB,gBAAgB,EAAE,eAAe,EAAE,CAAA;IACnC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,CAAC,EAAE,CAAA;IAChB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAA;IACtB,MAAM,EAAE,WAAW,CAAA;IACnB,eAAe,EAAE,eAAe,CAAA;CAiCjC;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC7C,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,GAAE,KAAK,GAAG,IAAW,GAC/B,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAwC5B;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAqCxF;AA0GD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAoCtB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EAAE,EACnB,oBAAoB,EAAE,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAuDN"}

package/dist/update-loop.js

@@ -40,6 +40,7 @@ export function createComponentInstance(def, data, parentScope = null) {
             }
         },
     };
+    inst.rootScope._kind = 'root';
     return inst;
 }
 export function flushInstance(inst) {
@@ -78,6 +79,10 @@ export function _forceState(inst, newState) {
         const binding = bindings[i];
         if (binding.dead)
             continue;
+        if (binding.kind === 'effect') {
+            binding.accessor(state);
+            continue;
+        }
         const newValue = binding.accessor(state);
         if (Object.is(newValue, binding.lastValue))
             continue;
@@ -238,6 +243,19 @@ export function _runPhase2(state, dirty, bindings, bindingsBeforePhase1, compone
                 const binding = bindings[i];
                 if (binding.dead || (binding.mask & dirty) === 0)
                     continue;
+                if (binding.kind === 'effect') {
+                    // Side-effect-only: run accessor, discard return, skip the
+                    // Object.is diff and `applyBinding` entirely. Used by child()'s
+                    // prop-watch binding so fresh-object props accessors don't
+                    // stringify onto a detached anchor every update.
+                    try {
+                        binding.accessor(state);
+                    }
+                    catch (e) {
+                        throw enhanceBindingError(e, binding, componentName);
+                    }
+                    continue;
+                }
                 let newValue;
                 try {
                     newValue = binding.accessor(state);
@@ -257,6 +275,10 @@ export function _runPhase2(state, dirty, bindings, bindingsBeforePhase1, compone
                 const binding = bindings[i];
                 if (binding.dead || (binding.mask & dirty) === 0)
                     continue;
+                if (binding.kind === 'effect') {
+                    binding.accessor(state);
+                    continue;
+                }
                 const newValue = binding.accessor(state);
                 const last = binding.lastValue;
                 if (newValue === last || (newValue !== newValue && last !== last))
@@ -326,9 +348,65 @@ function dispatchEffect(inst, effect) {
         console.log(eff.message);
         return;
     }
+    // Dev-only: record on the timeline / consult the mock registry.
+    // Short-circuits real dispatch when a mock matches. Zero cost in
+    // production — the guard on `_effectTimeline` is undefined unless
+    // `installDevTools` populated the trackers.
+    if (inst._effectTimeline !== undefined && dispatchEffectDev(inst, effect))
+        return;
     // User onEffect handler
     if (inst.def.onEffect) {
         inst.def.onEffect({ effect, send: inst.send, signal: inst.signal });
     }
 }
+/**
+ * Dev-only effect dispatch wrapper. Records the `dispatched` phase and,
+ * when a mock matches, auto-delivers the mocked response through the
+ * effect's own `onSuccess` callback on a microtask (same timing contract
+ * as a real async resolve). Non-matched effects are tracked as pending
+ * so `llui_pending_effects` / `llui_resolve_effect` can observe them.
+ *
+ * @returns `true` when a mock matched (caller should skip the real
+ *   dispatch) or `false` to proceed with the user-provided onEffect.
+ */
+function dispatchEffectDev(inst, effect) {
+    const timeline = inst._effectTimeline;
+    if (timeline === undefined)
+        return false;
+    const eff = effect;
+    const id = newEffectId();
+    const type = typeof eff.type === 'string' ? eff.type : '<unknown>';
+    const dispatchedAt = Date.now();
+    const mock = inst._effectMocks?.match(effect);
+    if (mock) {
+        timeline.push({ effectId: id, type, phase: 'dispatched', timestamp: dispatchedAt });
+        // Auto-deliver the mocked response via the effect's onSuccess callback (if any).
+        // This mirrors what the real dispatch would do, so the component receives a Msg
+        // from the mocked effect without any network/IO happening.
+        const payload = effect;
+        if (typeof payload.onSuccess === 'function') {
+            const msg = payload.onSuccess(mock.response);
+            // Schedule delivery as a microtask so it runs after the current update
+            // cycle completes (same timing contract as a real async effect resolve).
+            Promise.resolve().then(() => inst.send(msg));
+        }
+        timeline.push({
+            effectId: id,
+            type,
+            phase: 'resolved-mocked',
+            timestamp: dispatchedAt,
+            durationMs: 0,
+        });
+        return true;
+    }
+    timeline.push({ effectId: id, type, phase: 'dispatched', timestamp: dispatchedAt });
+    inst._pendingEffects?.push({ id, type, dispatchedAt, status: 'queued', payload: effect });
+    return false;
+}
+function newEffectId() {
+    const cryptoObj = globalThis.crypto;
+    if (cryptoObj?.randomUUID)
+        return cryptoObj.randomUUID();
+    return `eff-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
 //# sourceMappingURL=update-loop.js.map