@reticlehq/browser 2.0.1 → 2.2.0

package/dist/dom/snapshot.js

@@ -35,7 +35,8 @@ function directText(el) {
     const collapsed = out.replace(/\s+/g, ' ').trim();
     return collapsed.length > TEXT_MAX ? `${collapsed.slice(0, TEXT_MAX)}…` : collapsed;
 }
-function skip(el) {
+/** Cheap skips that need no computed style (tags, overlays, aria-hidden, [hidden]). */
+function skipEarly(el) {
     if (SKIP_TAGS.has(el.tagName.toLowerCase()))
         return true;
     if (isIgnored(el))
@@ -44,12 +45,6 @@ function skip(el) {
         return true;
     if (el instanceof HTMLElement && el.hidden)
         return true;
-    const view = el.ownerDocument.defaultView;
-    if (view !== null) {
-        const style = view.getComputedStyle(el);
-        if (style.display === 'none')
-            return true;
-    }
     return false;
 }
 function stateSuffix(el) {
@@ -77,11 +72,9 @@ function formatTextLine(depth, text) {
  * regression (e.g. grid columns 2 -> 3) leaves the role+text tree identical, so a role-only
  * snapshot is blind to it; this line makes it visible. Empty for non-container elements.
  */
-function layoutSignature(el) {
-    const view = el.ownerDocument.defaultView;
-    if (view === null)
+function layoutSignature(style) {
+    if (style === null)
         return '';
-    const style = view.getComputedStyle(el);
     const display = style.display;
     // Grid track templates are the high-signal CLS case (column/row count + sizing) and there are
     // few grid containers per page. Flex is intentionally excluded: nearly every row is a flex
@@ -92,15 +85,44 @@ function layoutSignature(el) {
     }
     return '';
 }
+/**
+ * The children to walk under `parent`, piercing boundaries a plain `.children` misses: an OPEN shadow
+ * root renders as part of the element (web components / design systems), and a SAME-ORIGIN iframe's
+ * body is real content. Cross-origin frames throw on access and are skipped by design. Without this,
+ * an entire category of modern apps is invisible to reticle_snapshot (systematic false negative).
+ */
+function pierceChildren(parent) {
+    const out = [...parent.children];
+    const shadow = parent.shadowRoot;
+    if (shadow !== null)
+        out.push(...shadow.children);
+    if (parent instanceof HTMLIFrameElement) {
+        try {
+            const body = parent.contentDocument?.body;
+            if (body !== null && body !== undefined)
+                out.push(...body.children);
+        }
+        catch {
+            /* cross-origin frame — inaccessible by design */
+        }
+    }
+    return out;
+}
 function walk(parent, depth, ctx) {
     if (depth > ctx.maxDepth)
         return;
-    for (const child of parent.children) {
+    for (const child of pierceChildren(parent)) {
         if (ctx.nodes >= ctx.maxNodes) {
             ctx.truncated = true;
             return;
         }
-        if (skip(child))
+        if (skipEarly(child))
+            continue;
+        // Resolve computed style ONCE per node (the dominant snapshot cost) and thread it into both the
+        // display-none skip and the layout signature — was two forced style resolutions per node.
+        const view = child.ownerDocument.defaultView;
+        const style = view !== null ? view.getComputedStyle(child) : null;
+        if (style !== null && style.display === 'none')
             continue;
         const role = getRole(child);
         const name = getAccessibleName(child);
@@ -110,7 +132,7 @@ function walk(parent, depth, ctx) {
         const lean = ctx.mode === SnapshotMode.INTERACTIVE;
         const text = !lean && role === 'generic' && name.length === 0 ? directText(child) : '';
         // Layout signature for grid/flex containers — makes CLS/layout regressions visible.
-        const layout = lean ? '' : layoutSignature(child);
+        const layout = lean ? '' : layoutSignature(style);
         const meaningful = interactive || role !== 'generic' || name.length > 0 || text.length > 0 || layout.length > 0;
         const include = lean ? interactive : meaningful;
         if (include) {
@@ -141,14 +163,19 @@ function buildStatus(root) {
         visibleDialogs: collectDialogs(root),
     };
 }
-/** Build the semantic accessibility snapshot of the page or a subtree (plan/04). */
+/** Build the semantic accessibility snapshot of the page or a subtree. */
 export function buildSnapshot(options = {}) {
     const mode = options.mode ?? SnapshotMode.FULL;
     const scopeEl = options.scope !== undefined
         ? (refs.resolve(options.scope) ?? document.querySelector(options.scope))
         : document.body;
-    const root = scopeEl ?? document.body;
+    // A given-but-missing scope snapshots NOTHING and says so — never a silent whole-page fallback.
+    const scopeMissing = options.scope !== undefined && !(scopeEl instanceof Element);
+    const root = scopeEl instanceof Element ? scopeEl : document.body;
     const status = buildStatus(root);
+    if (scopeMissing) {
+        return { tree: '', status, nodes: 0, truncated: false, scopeMissing: true };
+    }
     if (mode === SnapshotMode.STATUS) {
         return { tree: '', status, nodes: 0, truncated: false };
     }

package/dist/dom/snapshot.js.map

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

package/dist/dom/source.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Where an element is defined in the codebase.
+ *
+ * This is the single most valuable thing Reticle can hand an agent that has to fix what Reticle just
+ * found. Locating the right FILE is what turns a report into an edit; without it the agent pays for a
+ * search loop that the instrumentation already knows the answer to.
+ *
+ * Two lookups, because the callers have very different cost budgets:
+ *
+ *   sourceFromDom  — reads the babel-stamped `data-reticle-source` off the nearest ancestor. One
+ *                    native upward walk, bounded by tree depth. Safe to call per element on paths
+ *                    that describe many elements at once (query results, snapshots).
+ *   sourceFor      — prefers a framework adapter's answer (which knows the component that RENDERED
+ *                    the element, not just the nearest stamped host) and falls back to the DOM. The
+ *                    adapter path walks the fiber tree, so this belongs on single-element paths
+ *                    (inspect, act, review) and not in a loop.
+ *
+ * Both report source independently of how the element is ANCHORED. Anchor answers "how do I find this
+ * again", source answers "where is it written" — collapsing the two once meant that adding a
+ * data-testid, which Reticle's own docs recommend, silently removed the source pointer.
+ */
+export interface SourceLocation {
+    file: string;
+    line: number;
+}
+/** Parse a `data-reticle-source="file:line:column"` value into `{ file, line }` (column dropped). */
+export declare function parseSourceAttr(value: string | null): SourceLocation | undefined;
+/** The nearest babel-stamped source at or above this element. Cheap enough to call in bulk. */
+export declare function sourceFromDom(el: Element): SourceLocation | undefined;
+/** Best source for the element: the framework adapter's, else the nearest babel-stamped attribute. */
+export declare function sourceFor(el: Element, adapterSource: SourceLocation | undefined): SourceLocation | undefined;
+/**
+ * `file:line` — the form an agent can act on directly.
+ *
+ * Deliberately a single compact string rather than an object: it costs a couple of dozen bytes on a
+ * descriptor that may repeat hundreds of times in one response, and every consumer of it is either
+ * opening an editor or printing it.
+ */
+export declare function formatSource(source: SourceLocation | undefined): string | undefined;
+//# sourceMappingURL=source.d.ts.map

package/dist/dom/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/dom/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,GAAG,SAAS,CAQhF;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAGrE;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CACvB,EAAE,EAAE,OAAO,EACX,aAAa,EAAE,cAAc,GAAG,SAAS,GACxC,cAAc,GAAG,SAAS,CAG5B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEnF"}

package/dist/dom/source.js

@@ -0,0 +1,59 @@
+/**
+ * Where an element is defined in the codebase.
+ *
+ * This is the single most valuable thing Reticle can hand an agent that has to fix what Reticle just
+ * found. Locating the right FILE is what turns a report into an edit; without it the agent pays for a
+ * search loop that the instrumentation already knows the answer to.
+ *
+ * Two lookups, because the callers have very different cost budgets:
+ *
+ *   sourceFromDom  — reads the babel-stamped `data-reticle-source` off the nearest ancestor. One
+ *                    native upward walk, bounded by tree depth. Safe to call per element on paths
+ *                    that describe many elements at once (query results, snapshots).
+ *   sourceFor      — prefers a framework adapter's answer (which knows the component that RENDERED
+ *                    the element, not just the nearest stamped host) and falls back to the DOM. The
+ *                    adapter path walks the fiber tree, so this belongs on single-element paths
+ *                    (inspect, act, review) and not in a loop.
+ *
+ * Both report source independently of how the element is ANCHORED. Anchor answers "how do I find this
+ * again", source answers "where is it written" — collapsing the two once meant that adding a
+ * data-testid, which Reticle's own docs recommend, silently removed the source pointer.
+ */
+import { DATA_RETICLE_SOURCE_ATTR } from '@reticlehq/core';
+/** Stamped by @reticlehq/babel-plugin / @reticlehq/vite-plugin in dev as `file:line:column`. */
+const SOURCE_ATTR = DATA_RETICLE_SOURCE_ATTR;
+/** Parse a `data-reticle-source="file:line:column"` value into `{ file, line }` (column dropped). */
+export function parseSourceAttr(value) {
+    if (value === null)
+        return undefined;
+    const m = /^(.*):(\d+):(\d+)$/.exec(value);
+    if (m === null)
+        return undefined;
+    const file = m[1];
+    const line = Number(m[2]);
+    if (file === undefined || file.length === 0 || !Number.isFinite(line))
+        return undefined;
+    return { file, line };
+}
+/** The nearest babel-stamped source at or above this element. Cheap enough to call in bulk. */
+export function sourceFromDom(el) {
+    const host = el.closest(`[${SOURCE_ATTR}]`);
+    return host !== null ? parseSourceAttr(host.getAttribute(SOURCE_ATTR)) : undefined;
+}
+/** Best source for the element: the framework adapter's, else the nearest babel-stamped attribute. */
+export function sourceFor(el, adapterSource) {
+    if (adapterSource !== undefined)
+        return { file: adapterSource.file, line: adapterSource.line };
+    return sourceFromDom(el);
+}
+/**
+ * `file:line` — the form an agent can act on directly.
+ *
+ * Deliberately a single compact string rather than an object: it costs a couple of dozen bytes on a
+ * descriptor that may repeat hundreds of times in one response, and every consumer of it is either
+ * opening an editor or printing it.
+ */
+export function formatSource(source) {
+    return source === undefined ? undefined : `${source.file}:${String(source.line)}`;
+}
+//# sourceMappingURL=source.js.map

package/dist/dom/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/dom/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,gGAAgG;AAChG,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAO7C,qGAAqG;AACrG,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,aAAa,CAAC,EAAW;IACvC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC;IAC5C,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,SAAS,CACvB,EAAW,EACX,aAAyC;IAEzC,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC;IAC/F,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkC;IAC7D,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AACpF,CAAC"}

package/dist/dom/theme.js

@@ -9,7 +9,7 @@
  * the matched token name is returned when there is one — so the agent can judge, not just trust a flag.
  */
 let cached = null;
-/** Resolve any CSS color string to canonical computed `rgb(...)`/`rgba(...)`, or null if not a color. */
+/** Resolve any CSS color string to canonical computed `rgb...)`/`rgba...)`, or null if not a color. */
 function toRgb(value) {
     if (value.length === 0)
         return null;
@@ -25,7 +25,7 @@ function toRgb(value) {
     probe.remove();
     return rgb;
 }
-/** Collect `--token: value` declarations from every :root/html rule across the app's stylesheets. */
+/** Collect `--token: value` declarations from every:root/html rule across the app's stylesheets. */
 function collectTokens() {
     const out = {};
     for (const sheet of Array.from(document.styleSheets)) {

package/dist/dom/theme.js.map

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

package/dist/index.d.ts

@@ -6,8 +6,10 @@ export { SESSION_AUTO } from '@reticlehq/core';
 export { setIgnoreSelectors } from './dom/dom-ignore.js';
 export { registerAdapter, identifyComponent, readComponentState, elementHasHoverHandlers, adapterNames, } from './registry/adapters.js';
 export type { ReticleAdapter, ComponentInfo, ComponentSource } from './registry/adapters.js';
-export { registerStore, unregisterStore, storeNames, readStores } from './registry/stores.js';
-export type { StoreGetter } from './registry/stores.js';
+export { registerStore, unregisterStore, storeNames, readStores, readStoresWithTruncation, } from './registry/stores.js';
+export type { StoreGetter, StoreLike, StoreSubscribe } from './registry/stores.js';
+export { tanstackQueryStore, jotaiStore, xstateStore, valtioStore, mobxStore, pushStore, } from './registry/store-adapters.js';
+export type { QuerySnapshot } from './registry/store-adapters.js';
 export { registerCapabilities, getCapabilities, hasCapabilities } from './registry/capabilities.js';
 export type { Capabilities, CapabilitiesInput, CapabilityFlow } from './registry/capabilities.js';
 export { createReticleEmitter } from './registry/emitter.js';
@@ -16,6 +18,8 @@ export { commitAndSignal } from './registry/commit-and-signal.js';
 export { registerReticleDomain } from './registry/domains.js';
 export type { ReticleDomain } from './registry/domains.js';
 export { buildSnapshot } from './dom/snapshot.js';
+export { inspectChart, canvasChartData } from './dom/chart.js';
+export type { ChartReport, ChartFinding, CanvasChartData } from './dom/chart.js';
 export { matchQuery, runQuery } from './dom/query.js';
 export { executeAction, executeSequence } from './actions/actions.js';
 export { describe, getRole, getAccessibleName, getStates, isVisible } from './dom/a11y.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQvC,eAAO,MAAM,OAAO,EAAE,OAA2D,CAAC;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG7F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9F,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACpG,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGlG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EACV,cAAc,EACd,aAAa,EACb,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQvC,eAAO,MAAM,OAAO,EAAE,OAA2D,CAAC;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG7F,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,UAAU,EACV,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKnF,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACpG,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGlG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EACV,cAAc,EACd,aAAa,EACb,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -14,7 +14,11 @@ export { setIgnoreSelectors } from './dom/dom-ignore.js';
 // Adapter API (used by @reticlehq/react and other framework adapters).
 export { registerAdapter, identifyComponent, readComponentState, elementHasHoverHandlers, adapterNames, } from './registry/adapters.js';
 // Store registry: pull live framework/store state on demand.
-export { registerStore, unregisterStore, storeNames, readStores } from './registry/stores.js';
+export { registerStore, unregisterStore, storeNames, readStores, readStoresWithTruncation, } from './registry/stores.js';
+// Adapters for state libraries that do not natively expose `{getState, subscribe}`. zustand and Redux
+// need none of these; TanStack Query is the one that matters most, because a stale-cache bug fires no
+// request and renders a plausible value, so the cache is the only witness.
+export { tanstackQueryStore, jotaiStore, xstateStore, valtioStore, mobxStore, pushStore, } from './registry/store-adapters.js';
 // Capability registry: the app self-describes its testable surface via reticle.describe.
 export { registerCapabilities, getCapabilities, hasCapabilities } from './registry/capabilities.js';
 // SDK helpers: adopt the recommended integration patterns without boilerplate.
@@ -23,6 +27,10 @@ export { commitAndSignal } from './registry/commit-and-signal.js';
 export { registerReticleDomain } from './registry/domains.js';
 // Lower-level building blocks (useful for tests and advanced embedding).
 export { buildSnapshot } from './dom/snapshot.js';
+// Chart inspection. Surfaced automatically on any element descriptor that contains faulty plot
+// geometry (see ElementDescriptor.chart), and exported for direct use — canvasChartData is the only
+// route to a canvas chart's data, since its pixels are not DOM.
+export { inspectChart, canvasChartData } from './dom/chart.js';
 export { matchQuery, runQuery } from './dom/query.js';
 export { executeAction, executeSequence } from './actions/actions.js';
 export { describe, getRole, getAccessibleName, getStates, isVisible } from './dom/a11y.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,GAAG,UAAwD,CAAC;AAC7E,MAAM,CAAC,MAAM,OAAO,GAAY,CAAC,WAAW,CAAC,iBAAiB,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,qGAAqG;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,yDAAyD;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,uEAAuE;AACvE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAGhC,6DAA6D;AAC7D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG9F,yFAAyF;AACzF,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGpG,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAM7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,yEAAyE;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAsB,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,GAAG,UAAwD,CAAC;AAC7E,MAAM,CAAC,MAAM,OAAO,GAAY,CAAC,WAAW,CAAC,iBAAiB,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,qGAAqG;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,yDAAyD;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,uEAAuE;AACvE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAGhC,6DAA6D;AAC7D,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,UAAU,EACV,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,sGAAsG;AACtG,sGAAsG;AACtG,2EAA2E;AAC3E,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,8BAA8B,CAAC;AAGtC,yFAAyF;AACzF,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGpG,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAM7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,yEAAyE;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,+FAA+F;AAC/F,oGAAoG;AACpG,gEAAgE;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAsB,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC"}

package/dist/observers/animation.d.ts

@@ -1,4 +1,4 @@
 import type { Emit, Teardown } from './types.js';
-/** Observe CSS animations + transitions and emit anim.start / anim.end (plan/03 §6). */
+/** Observe CSS animations + transitions and emit anim.start / anim.end. */
 export declare function installAnimation(emit: Emit): Teardown;
 //# sourceMappingURL=animation.d.ts.map

package/dist/observers/animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/observers/animation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAmCrD"}
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/observers/animation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAmCrD"}

package/dist/observers/animation.js

@@ -1,7 +1,7 @@
 import { EventType } from '@reticlehq/core';
 import { refs } from '../dom/refs.js';
 import { isReticleOverlay } from '../dom/dom-ignore.js';
-/** Observe CSS animations + transitions and emit anim.start / anim.end (plan/03 §6). */
+/** Observe CSS animations + transitions and emit anim.start / anim.end. */
 export function installAnimation(emit) {
     const onStart = (event) => {
         const target = event.target;

package/dist/observers/animation.js.map

@@ -1 +1 @@
-{"version":3,"file":"animation.js","sourceRoot":"","sources":["../../src/observers/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,MAAM,OAAO,GAAG,CAAC,KAAqB,EAAQ,EAAE;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,6FAA6F;QAC7F,wFAAwF;QACxF,IAAI,MAAM,YAAY,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACjF,CAAC;IACH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,KAAqB,EAAQ,EAAE;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,YAAY,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC;IACF,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAQ,EAAE;QACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,YAAY,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,IAAI,CACF,SAAS,CAAC,QAAQ,EAClB,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,EAChD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CACpB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACvD,QAAQ,CAAC,gBAAgB,CAAC,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IAElE,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9D,QAAQ,CAAC,mBAAmB,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,QAAQ,CAAC,mBAAmB,CAAC,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"animation.js","sourceRoot":"","sources":["../../src/observers/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,MAAM,OAAO,GAAG,CAAC,KAAqB,EAAQ,EAAE;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,6FAA6F;QAC7F,wFAAwF;QACxF,IAAI,MAAM,YAAY,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACjF,CAAC;IACH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,KAAqB,EAAQ,EAAE;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,YAAY,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC;IACF,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAQ,EAAE;QACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,YAAY,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,IAAI,CACF,SAAS,CAAC,QAAQ,EAClB,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,EAChD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CACpB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACvD,QAAQ,CAAC,gBAAgB,CAAC,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IAElE,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9D,QAAQ,CAAC,mBAAmB,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,QAAQ,CAAC,mBAAmB,CAAC,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC,CAAC;AACJ,CAAC"}

package/dist/observers/blind-spots.d.ts

@@ -0,0 +1,19 @@
+import type { Emit, Teardown } from './types.js';
+/**
+ * Blind-spot sensor. The SDK instruments the DOM, but a cross-origin iframe is a wall it cannot
+ * see through — its contents, network, and console are invisible. Left unstated, a green verdict would
+ * imply the whole page was verified. This detects cross-origin frames and emits a BLIND_SPOT event so the
+ * server can mark results `coverage: partial` instead of lying by omission. Closed shadow roots and
+ * virtualized-unmounted rows are the other kinds (detected elsewhere / by their tools); this sensor owns
+ * the iframe case, the one that is cheaply and reliably detectable from the page.
+ */
+/**
+ * Whether a frame is cross-origin (unobservable). A same-origin frame exposes its `contentDocument`; a
+ * cross-origin one returns null (or THROWS a SecurityError on access). A src-less / about:blank frame is
+ * same-origin and simply not navigated — not a blind spot.
+ */
+export declare function isCrossOriginFrame(frame: HTMLIFrameElement): boolean;
+/** How many of the given frames are cross-origin (unobservable). */
+export declare function countCrossOriginFrames(frames: readonly HTMLIFrameElement[]): number;
+export declare function installBlindSpots(emit: Emit): Teardown;
+//# sourceMappingURL=blind-spots.d.ts.map

package/dist/observers/blind-spots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blind-spots.d.ts","sourceRoot":"","sources":["../../src/observers/blind-spots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGjD;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAQpE;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CAInF;AAmBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAoCtD"}

package/dist/observers/blind-spots.js

@@ -0,0 +1,89 @@
+import { EventType, BlindSpotKind } from '@reticlehq/core';
+import { nativeClearTimeout, nativeSetTimeout } from '../timers/native-timers.js';
+/**
+ * Blind-spot sensor. The SDK instruments the DOM, but a cross-origin iframe is a wall it cannot
+ * see through — its contents, network, and console are invisible. Left unstated, a green verdict would
+ * imply the whole page was verified. This detects cross-origin frames and emits a BLIND_SPOT event so the
+ * server can mark results `coverage: partial` instead of lying by omission. Closed shadow roots and
+ * virtualized-unmounted rows are the other kinds (detected elsewhere / by their tools); this sensor owns
+ * the iframe case, the one that is cheaply and reliably detectable from the page.
+ */
+/**
+ * Whether a frame is cross-origin (unobservable). A same-origin frame exposes its `contentDocument`; a
+ * cross-origin one returns null (or THROWS a SecurityError on access). A src-less / about:blank frame is
+ * same-origin and simply not navigated — not a blind spot.
+ */
+export function isCrossOriginFrame(frame) {
+    const src = frame.getAttribute('src');
+    if (src === null || src.length === 0)
+        return false;
+    try {
+        return frame.contentDocument === null;
+    }
+    catch {
+        return true; // SecurityError on access is itself proof of cross-origin
+    }
+}
+/** How many of the given frames are cross-origin (unobservable). */
+export function countCrossOriginFrames(frames) {
+    let count = 0;
+    for (const frame of frames)
+        if (isCrossOriginFrame(frame))
+            count += 1;
+    return count;
+}
+function currentCount() {
+    return countCrossOriginFrames(Array.from(document.querySelectorAll('iframe')));
+}
+/**
+ * Watch the page for cross-origin iframes and emit BLIND_SPOT whenever the count CHANGES (install +
+ * on any added/removed frame). Only the delta is emitted — never a per-mutation flood — so a static
+ * embed reports once. Reversible: disconnects the observer on teardown.
+ */
+/**
+ * How long added/removed nodes are allowed to pile up before the frame count is re-checked.
+ *
+ * A blind spot is a coverage caveat on a verdict, not a live signal — noticing an embed a fraction of
+ * a second later costs nothing, while checking on every mutation costs a DOM scan per render.
+ */
+const RECHECK_DEBOUNCE_MS = 250;
+export function installBlindSpots(emit) {
+    let last = -1;
+    const report = () => {
+        const count = currentCount();
+        if (count === last)
+            return;
+        last = count;
+        if (count > 0) {
+            emit(EventType.BLIND_SPOT, { kind: BlindSpotKind.CROSS_ORIGIN_IFRAME, count });
+        }
+    };
+    report();
+    // Coalesce rather than gate.
+    //
+    // This used to try to skip unrelated churn by testing each added/removed node with
+    // `n.querySelector('iframe')` — but that is a full subtree scan per mutated node, so a React commit
+    // mounting a 500-node panel paid a 500-node scan to decide whether to do a document scan. The gate
+    // cost more than the work, and it scaled with exactly the thing a large app does most.
+    //
+    // Since report() emits only when the count CHANGES, running it late and rarely is free. One
+    // debounced document scan per quarter-second replaces per-node scanning, and it is also more
+    // correct: the old gate's `querySelector` missed an iframe added inside a subtree whose own root
+    // was a text or comment node.
+    let pending;
+    const observer = new MutationObserver(() => {
+        if (pending !== undefined)
+            return;
+        pending = nativeSetTimeout(() => {
+            pending = undefined;
+            report();
+        }, RECHECK_DEBOUNCE_MS);
+    });
+    observer.observe(document.documentElement, { childList: true, subtree: true });
+    return () => {
+        if (pending !== undefined)
+            nativeClearTimeout(pending);
+        observer.disconnect();
+    };
+}
+//# sourceMappingURL=blind-spots.js.map

package/dist/observers/blind-spots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blind-spots.js","sourceRoot":"","sources":["../../src/observers/blind-spots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAElF;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,0DAA0D;IACzE,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,MAAoC;IACzE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,IAAI,kBAAkB,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,UAAU,iBAAiB,CAAC,IAAU;IAC1C,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;QAC7B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QAC3B,IAAI,GAAG,KAAK,CAAC;QACb,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC,CAAC;IACF,MAAM,EAAE,CAAC;IAET,6BAA6B;IAC7B,EAAE;IACF,mFAAmF;IACnF,oGAAoG;IACpG,mGAAmG;IACnG,uFAAuF;IACvF,EAAE;IACF,4FAA4F;IAC5F,6FAA6F;IAC7F,iGAAiG;IACjG,8BAA8B;IAC9B,IAAI,OAAwD,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;QACzC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO;QAClC,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE;YAC9B,OAAO,GAAG,SAAS,CAAC;YACpB,MAAM,EAAE,CAAC;QACX,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,OAAO,GAAG,EAAE;QACV,IAAI,OAAO,KAAK,SAAS;YAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC"}

package/dist/observers/console.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/observers/console.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqBjD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAuCnD"}
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/observers/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyCjD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAqDnD"}

package/dist/observers/console.js

@@ -1,10 +1,13 @@
-/* eslint-disable no-console -- this module's whole purpose is to wrap console.{log,warn,error} */
-import { EventType } from '@reticlehq/core';
+import { EventType, TRANSPORT_LIMITS } from '@reticlehq/core';
 import { safeStringify } from '../security/serialization.js';
 const METHOD_EVENT = {
     log: EventType.CONSOLE_LOG,
     warn: EventType.CONSOLE_WARN,
     error: EventType.CONSOLE_ERROR,
+    // info/debug are captured for the raw console channel but excluded from summaries/deviation reports
+    // (low signal — most apps chatter here). Lean: no stack, like log/warn.
+    info: EventType.CONSOLE_INFO,
+    debug: EventType.CONSOLE_DEBUG,
 };
 function stringifyArgs(args) {
     return args
@@ -17,39 +20,69 @@ function stringifyArgs(args) {
     })
         .join(' ');
 }
+/** Stacks can be long; cap so a deep async trace never blows the event budget. */
+const MAX_STACK_LEN = TRANSPORT_LIMITS.MAX_STACK_LENGTH;
+function capStack(stack) {
+    if (stack === undefined || stack.length === 0)
+        return undefined;
+    return stack.length > MAX_STACK_LEN ? stack.slice(0, MAX_STACK_LEN) : stack;
+}
+/** The stack of the first Error argument, if any — the single biggest diagnosis upgrade, near-zero cost. */
+function firstErrorStack(args) {
+    for (const arg of args) {
+        if (arg instanceof Error)
+            return capStack(arg.stack);
+    }
+    return undefined;
+}
 /** Patch console.{log,warn,error} and window error events. Reversible. */
 export function installConsole(emit) {
-    const methods = ['log', 'warn', 'error'];
+    const methods = ['log', 'warn', 'error', 'info', 'debug'];
     const originals = new Map();
+    const patched = new Map();
     for (const method of methods) {
         // Store the true original for teardown identity; call through a bound copy.
         const original = console[method];
         originals.set(method, original);
         const callOriginal = original.bind(console);
-        console[method] = (...args) => {
-            emit(METHOD_EVENT[method], { message: stringifyArgs(args) });
+        const wrapper = (...args) => {
+            // Only console.error carries a stack — the diagnosis case; log/warn stay lean.
+            const stack = method === 'error' ? firstErrorStack(args) : undefined;
+            emit(METHOD_EVENT[method], {
+                message: stringifyArgs(args),
+                ...(stack === undefined ? {} : { stack }),
+            });
             callOriginal(...args);
         };
+        patched.set(method, wrapper);
+        console[method] = wrapper;
     }
     const onError = (event) => {
+        const stack = capStack(event.error instanceof Error ? event.error.stack : undefined);
         emit(EventType.ERROR_UNCAUGHT, {
             message: event.message,
             source: event.filename,
             line: event.lineno,
+            ...(stack === undefined ? {} : { stack }),
         });
     };
     const onRejection = (event) => {
         const reason = event.reason;
+        const stack = capStack(reason instanceof Error ? reason.stack : undefined);
         emit(EventType.ERROR_UNCAUGHT, {
             message: reason instanceof Error ? reason.message : String(reason),
             kind: 'unhandledrejection',
+            ...(stack === undefined ? {} : { stack }),
         });
     };
     window.addEventListener('error', onError);
     window.addEventListener('unhandledrejection', onRejection);
     return () => {
         for (const [method, original] of originals) {
-            console[method] = original;
+            // Restore only if console[method] still holds our wrapper — a logging SDK (Sentry, LogRocket)
+            // that wrapped console AFTER connect() must keep its instrumentation on teardown.
+            if (console[method] === patched.get(method))
+                console[method] = original;
         }
         window.removeEventListener('error', onError);
         window.removeEventListener('unhandledrejection', onRejection);