@reticlehq/browser 2.0.1 → 2.2.0

package/dist/dom/a11y.js

@@ -1,6 +1,8 @@
 import { ElementState, REDACTED_VALUE } from '@reticlehq/core';
 import { refs } from './refs.js';
+import { inspectChart } from './chart.js';
 import { isSensitiveKey } from '../security/serialization.js';
+import { formatSource, sourceFromDom } from './source.js';
 /** Roles whose accessible name comes from their text content. */
 const NAME_FROM_CONTENT = new Set([
     'button',
@@ -154,13 +156,13 @@ function ariaBool(el, attr) {
         return undefined;
     return value === 'true';
 }
-/** The set of states relevant to assertions (plan/06). */
-export function getStates(el) {
+/**
+ * The set of states relevant to assertions. `visible` is an O(depth) forced-style walk; callers that
+ * already computed it (describe) pass it in so it isn't resolved twice per element.
+ */
+export function getStates(el, visible = isVisible(el)) {
     const states = [ElementState.PRESENT];
-    if (isVisible(el))
-        states.push(ElementState.VISIBLE);
-    else
-        states.push(ElementState.HIDDEN);
+    states.push(visible ? ElementState.VISIBLE : ElementState.HIDDEN);
     const disabledProp = (el instanceof HTMLButtonElement ||
         el instanceof HTMLInputElement ||
         el instanceof HTMLSelectElement ||
@@ -212,52 +214,86 @@ export function getValue(el) {
     const valueNow = el.getAttribute('aria-valuenow');
     return valueNow ?? undefined;
 }
-/** Whether the element is actually visible (not display:none/hidden/aria-hidden/opacity:0). */
-export function isVisible(el) {
-    if (!el.isConnected)
-        return false;
-    let node = el;
-    while (node !== null) {
-        if (node.getAttribute('aria-hidden') === 'true')
-            return false;
-        if (node instanceof HTMLElement && node.hidden)
-            return false;
-        const view = node.ownerDocument.defaultView;
-        if (view !== null) {
-            const style = view.getComputedStyle(node);
-            if (style.display === 'none' ||
-                style.visibility === 'hidden' ||
-                style.visibility === 'collapse') {
-                return false;
-            }
-            if (Number.parseFloat(style.opacity || '1') === 0)
-                return false;
+/** Whether the element's OWN box hides it — one forced-style resolution, no ancestor walk. */
+function selfHidden(el) {
+    if (el.getAttribute('aria-hidden') === 'true')
+        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' ||
+            style.visibility === 'hidden' ||
+            style.visibility === 'collapse') {
+            return true;
         }
-        node = node.parentElement;
+        if (Number.parseFloat(style.opacity || '1') === 0)
+            return true;
     }
-    return true;
+    return false;
+}
+/**
+ * Whether the element is actually visible (not display:none/hidden/aria-hidden/opacity:0), walking to
+ * root. This is an O(depth) forced-style walk PER node; `memo` (optional, scoped to ONE synchronous
+ * query pass) caches the full inherited result per element so a broad state-filtered query stops
+ * re-resolving getComputedStyle up the same ancestor chain for every sibling. Sound because the DOM is
+ * static for the pass's duration — the cache MUST be a per-call Map, never module-level (that would go
+ * stale the instant the app mutates, the same trap the shadow-root note in query.ts documents).
+ */
+export function isVisible(el, memo) {
+    if (!el.isConnected)
+        return false;
+    const cached = memo?.get(el);
+    if (cached !== undefined)
+        return cached;
+    const parent = el.parentElement;
+    // Each cached boolean already folds in that node's own aria-hidden/[hidden]/display/visibility/opacity,
+    // so inherited visibility composes by AND up the chain and a sibling short-circuits at the first
+    // cached ancestor.
+    const result = !selfHidden(el) && (parent === null || isVisible(parent, memo));
+    if (memo !== undefined)
+        memo.set(el, result);
+    return result;
 }
 const MAX_TEXT = 80;
 function getVisibleText(el) {
     const text = collapse(el.textContent ?? '');
     return text.length > MAX_TEXT ? `${text.slice(0, MAX_TEXT)}…` : text;
 }
-/** Build the compact descriptor surfaced to the agent. */
-export function describe(el) {
+/** Build the compact descriptor surfaced to the agent. `memo` (optional) shares the per-call
+ * visibility cache with the query's state filter so ancestors aren't re-walked per element. */
+export function describe(el, memo) {
     const value = getValue(el);
     const text = getVisibleText(el);
     const name = getAccessibleName(el);
+    const visible = isVisible(el, memo); // O(depth) style walk — computed ONCE and reused by getStates
     const base = {
         ref: refs.refFor(el),
         role: getRole(el),
         name,
-        states: getStates(el),
-        visible: isVisible(el),
+        states: getStates(el, visible),
+        visible,
     };
     if (value !== undefined && value.length > 0)
         base.value = value;
     if (text.length > 0 && text !== name)
         base.text = text;
+    // DOM-only lookup on purpose: describe() runs once per matched element, so the adapter's fiber walk
+    // would turn a broad query into thousands of tree traversals. The stamped attribute answers the
+    // same question for a fraction of the cost, and single-element paths that can afford the better
+    // answer (inspect, act, review) use sourceFor() instead.
+    const source = formatSource(sourceFromDom(el));
+    if (source !== undefined)
+        base.source = source;
+    // Chart faults, only when there are any. Gated on the element actually containing plot geometry so
+    // the common case — every non-chart element on the page — pays one querySelector miss and nothing
+    // else, and a HEALTHY chart adds no bytes to the wire either.
+    if (el.querySelector('path, polyline, polygon') !== null) {
+        const faults = inspectChart(el).findings;
+        if (faults.length > 0)
+            base.chart = faults;
+    }
     return base;
 }
 //# sourceMappingURL=a11y.js.map

package/dist/dom/a11y.js.map

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

package/dist/dom/auto-anchor.d.ts

@@ -8,16 +8,16 @@
  * adapter, fills it in) and returns the chosen anchor + whether it is stable. No DOM, no fiber here.
  *
  * Priority (most → least durable). Each tier is only used when the one above is unavailable:
- *   1. testid           — explicit, author-chosen, the gold standard. Stable.
- *   2. component@source  — component display name + source file:line. Survives text/markup/style
- *                          changes; uniquely identifies WHERE in the source the element comes from.
- *                          Stable (a move that changes the source line is a real change worth re-pinning).
- *   3. component+role/name — component name plus role/accessible-name when no source is available.
- *                          Stable enough: the component identity anchors it, role/name disambiguate.
- *   4. role+name         — semantic but content-dependent: an accessible name can change with copy.
- *                          NOT marked stable (a healed locator could drift to a renamed element).
- *   5. role / position   — last resort. NOT stable; surfaced so the element is still addressable, but
- *                          a flow built on it should be flagged (the recorder marks the step degraded).
+ * 1. testid — explicit, author-chosen, the gold standard. Stable.
+ * 2. component@source — component display name + source file:line. Survives text/markup/style
+ * changes; uniquely identifies WHERE in the source the element comes from.
+ * Stable (a move that changes the source line is a real change worth re-pinning).
+ * 3. component+role/name — component name plus role/accessible-name when no source is available.
+ * Stable enough: the component identity anchors it, role/name disambiguate.
+ * 4. role+name — semantic but content-dependent: an accessible name can change with copy.
+ * NOT marked stable (a healed locator could drift to a renamed element).
+ * 5. role / position — last resort. NOT stable; surfaced so the element is still addressable, but
+ * a flow built on it should be flagged (the recorder marks the step degraded).
  *
  * The point: tiers 1–3 are "stable" (a flow anchored on them can be trusted to re-resolve to the
  * same element); tiers 4–5 are best-effort. Today most elements without a testid fall to role/text

package/dist/dom/auto-anchor.js

@@ -8,16 +8,16 @@
  * adapter, fills it in) and returns the chosen anchor + whether it is stable. No DOM, no fiber here.
  *
  * Priority (most → least durable). Each tier is only used when the one above is unavailable:
- *   1. testid           — explicit, author-chosen, the gold standard. Stable.
- *   2. component@source  — component display name + source file:line. Survives text/markup/style
- *                          changes; uniquely identifies WHERE in the source the element comes from.
- *                          Stable (a move that changes the source line is a real change worth re-pinning).
- *   3. component+role/name — component name plus role/accessible-name when no source is available.
- *                          Stable enough: the component identity anchors it, role/name disambiguate.
- *   4. role+name         — semantic but content-dependent: an accessible name can change with copy.
- *                          NOT marked stable (a healed locator could drift to a renamed element).
- *   5. role / position   — last resort. NOT stable; surfaced so the element is still addressable, but
- *                          a flow built on it should be flagged (the recorder marks the step degraded).
+ * 1. testid — explicit, author-chosen, the gold standard. Stable.
+ * 2. component@source — component display name + source file:line. Survives text/markup/style
+ * changes; uniquely identifies WHERE in the source the element comes from.
+ * Stable (a move that changes the source line is a real change worth re-pinning).
+ * 3. component+role/name — component name plus role/accessible-name when no source is available.
+ * Stable enough: the component identity anchors it, role/name disambiguate.
+ * 4. role+name — semantic but content-dependent: an accessible name can change with copy.
+ * NOT marked stable (a healed locator could drift to a renamed element).
+ * 5. role / position — last resort. NOT stable; surfaced so the element is still addressable, but
+ * a flow built on it should be flagged (the recorder marks the step degraded).
  *
  * The point: tiers 1–3 are "stable" (a flow anchored on them can be trusted to re-resolve to the
  * same element); tiers 4–5 are best-effort. Today most elements without a testid fall to role/text

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

@@ -0,0 +1,14 @@
+/**
+ * Blind-spot detection, the detectable half). Cross-origin iframes are a real observation gap — the
+ * SDK cannot see inside them (same-origin policy). We COUNT them so a result can say "coverage: partial —
+ * 2 cross-origin frames unobserved" instead of implying it saw the whole page. Closed shadow roots are a
+ * blind spot too, but undetectable by design (element.shadowRoot === null), so they are not counted here.
+ */
+/** Pure: how many frames are cross-origin, given each frame's same-origin flag + whether it has a src. */
+export declare function classifyCrossOriginFrames(frames: ReadonlyArray<{
+    sameOrigin: boolean;
+    hasSrc: boolean;
+}>): number;
+/** Probe the live document: count iframes whose document is unreachable (cross-origin). */
+export declare function countCrossOriginFrames(): number;
+//# sourceMappingURL=blind-spots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blind-spots.d.ts","sourceRoot":"","sources":["../../src/dom/blind-spots.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0GAA0G;AAC1G,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,GAC9D,MAAM,CAER;AAED,2FAA2F;AAC3F,wBAAgB,sBAAsB,IAAI,MAAM,CAe/C"}

package/dist/dom/blind-spots.js

@@ -0,0 +1,30 @@
+/**
+ * Blind-spot detection, the detectable half). Cross-origin iframes are a real observation gap — the
+ * SDK cannot see inside them (same-origin policy). We COUNT them so a result can say "coverage: partial —
+ * 2 cross-origin frames unobserved" instead of implying it saw the whole page. Closed shadow roots are a
+ * blind spot too, but undetectable by design (element.shadowRoot === null), so they are not counted here.
+ */
+/** Pure: how many frames are cross-origin, given each frame's same-origin flag + whether it has a src. */
+export function classifyCrossOriginFrames(frames) {
+    return frames.filter((f) => f.hasSrc && !f.sameOrigin).length;
+}
+/** Probe the live document: count iframes whose document is unreachable (cross-origin). */
+export function countCrossOriginFrames() {
+    if (typeof document === 'undefined')
+        return 0;
+    const frames = [];
+    for (const frame of document.querySelectorAll('iframe')) {
+        const hasSrc = frame.getAttribute('src') !== null && frame.getAttribute('src') !== '';
+        let sameOrigin = true;
+        try {
+            // Reaching contentDocument throws (or yields null) for a cross-origin frame.
+            sameOrigin = frame.contentDocument !== null;
+        }
+        catch {
+            sameOrigin = false;
+        }
+        frames.push({ sameOrigin, hasSrc });
+    }
+    return classifyCrossOriginFrames(frames);
+}
+//# sourceMappingURL=blind-spots.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blind-spots.js","sourceRoot":"","sources":["../../src/dom/blind-spots.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0GAA0G;AAC1G,MAAM,UAAU,yBAAyB,CACvC,MAA+D;IAE/D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;AAChE,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,sBAAsB;IACpC,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAoD,EAAE,CAAC;IACnE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACtF,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC;YACH,6EAA6E;YAC7E,UAAU,GAAG,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/dom/chart.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Chart inspection — the one dashboard surface Reticle could not previously see.
+ *
+ * A chart is where the store and the screen diverge most easily and most silently. Everything else on
+ * a dashboard is text: a KPI card renders a number you can read, a table renders rows you can count,
+ * and if the store disagrees with either, a state-vs-DOM comparison catches it. A chart renders
+ * GEOMETRY — the data has been through a scale function into `points`/`d` coordinates — and geometry
+ * is not text. `series` can be perfectly correct in the store while the polyline is blank, flat, or
+ * full of NaN, and no reader of either side would notice.
+ *
+ * Two failure classes are worth detecting, and they are chosen because they are DECIDABLE from the
+ * element alone — no baseline image, no per-library scale inversion, no false positives from a chart
+ * that is merely ugly:
+ *
+ *  1. **Non-finite coordinates.** `NaN`/`Infinity` in a path reaches the DOM whenever the scale math
+ *     divides by a zero range — an empty series, a single-point series, or min === max. The browser
+ *     silently renders nothing. This is a genuine bug every time; there is no chart for which NaN
+ *     coordinates are correct.
+ *  2. **Degenerate geometry.** A chart element that exists but encloses no area: no points at all, or
+ *     every point identical. Distinguishes "the chart is missing" (already catchable — the element is
+ *     absent) from "the chart is present and empty", which looks healthy to a presence check and to a
+ *     screenshot diff against a baseline that was also empty.
+ *
+ * Deliberately NOT attempted: comparing plotted geometry against the source data. That needs the
+ * chart's scale functions inverted per library, is a large surface to get wrong, and `chartInstance`
+ * below obsoletes it for the libraries people actually use — Chart.js and ECharts both hang their
+ * instance off the canvas element, so their data can be read directly rather than reverse-engineered
+ * from pixels.
+ */
+export interface ChartFinding {
+    /** What is wrong, as a stable machine-readable kind. */
+    kind: 'non-finite-coordinates' | 'empty-geometry' | 'degenerate-geometry';
+    /** The offending element's tag, so the agent can find it. */
+    tag: string;
+    /** Which attribute carried the fault. */
+    attr: string;
+    /** A short excerpt of the offending value — bounded; the full path can be thousands of chars. */
+    sample: string;
+}
+export interface ChartReport {
+    /** How many data-bearing geometry elements were examined. */
+    examined: number;
+    findings: ChartFinding[];
+    /** True when a canvas is present, i.e. the geometry is NOT in the DOM and this report cannot see it. */
+    canvas: boolean;
+}
+/**
+ * Every number embedded in a geometry attribute. Path data interleaves single-letter drawing
+ * commands with coordinate pairs, so this extracts numeric-looking tokens rather than parsing the
+ * path grammar — the question here is only "is any coordinate non-finite", which does not need a
+ * full parser.
+ */
+export declare function geometryNumbers(value: string): number[];
+/** True when the attribute contains a coordinate the browser cannot render. */
+export declare function hasNonFiniteCoordinate(value: string): boolean;
+/** True when the geometry encloses no area — no coordinates, or every coordinate pair identical. */
+export declare function isDegenerate(value: string): boolean;
+/**
+ * Inspect a subtree for chart geometry faults. Pure over the element — no events, no globals — so it
+ * can back a tool call, an assertion, or a snapshot annotation without any of them owning it.
+ */
+export declare function inspectChart(root: Element): ChartReport;
+/** The shape a canvas charting library hangs off its canvas element, once located. */
+export interface CanvasChartData {
+    library: 'chartjs' | 'echarts';
+    /** The library's own data structure — series/datasets — read directly, not inferred from pixels. */
+    data: unknown;
+}
+/**
+ * Read the data behind a CANVAS chart.
+ *
+ * Canvas is the one place where "instrument from inside the app" is not merely cheaper than pixels but
+ * is the only option at all: the chart is a bitmap, so the DOM shows an empty `<canvas>` and a
+ * screenshot shows colours no assertion can interpret. Both major canvas libraries keep their live
+ * instance reachable from the element — Chart.js via its registry, ECharts via a per-DOM lookup — so
+ * the series data is READABLE rather than reverse-engineerable.
+ *
+ * Takes the globals as arguments rather than reaching for `window`, so this stays pure and testable
+ * and the SDK never depends on either library being present.
+ */
+export declare function canvasChartData(canvas: Element, globals: {
+    Chart?: {
+        getChart?: (el: Element) => {
+            data?: unknown;
+        } | undefined;
+    };
+    echarts?: {
+        getInstanceByDom?: (el: Element) => {
+            getOption?: () => unknown;
+        } | undefined;
+    };
+}): CanvasChartData | null;
+//# sourceMappingURL=chart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../src/dom/chart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AASH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,wBAAwB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;IAC1E,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,wGAAwG;IACxG,MAAM,EAAE,OAAO,CAAC;CACjB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAGvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAwBvD;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,oGAAoG;IACpG,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE;IACP,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK;YAAE,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IACvE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK;YAAE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;CAC7F,GACA,eAAe,GAAG,IAAI,CAUxB"}

package/dist/dom/chart.js

@@ -0,0 +1,119 @@
+/**
+ * Chart inspection — the one dashboard surface Reticle could not previously see.
+ *
+ * A chart is where the store and the screen diverge most easily and most silently. Everything else on
+ * a dashboard is text: a KPI card renders a number you can read, a table renders rows you can count,
+ * and if the store disagrees with either, a state-vs-DOM comparison catches it. A chart renders
+ * GEOMETRY — the data has been through a scale function into `points`/`d` coordinates — and geometry
+ * is not text. `series` can be perfectly correct in the store while the polyline is blank, flat, or
+ * full of NaN, and no reader of either side would notice.
+ *
+ * Two failure classes are worth detecting, and they are chosen because they are DECIDABLE from the
+ * element alone — no baseline image, no per-library scale inversion, no false positives from a chart
+ * that is merely ugly:
+ *
+ *  1. **Non-finite coordinates.** `NaN`/`Infinity` in a path reaches the DOM whenever the scale math
+ *     divides by a zero range — an empty series, a single-point series, or min === max. The browser
+ *     silently renders nothing. This is a genuine bug every time; there is no chart for which NaN
+ *     coordinates are correct.
+ *  2. **Degenerate geometry.** A chart element that exists but encloses no area: no points at all, or
+ *     every point identical. Distinguishes "the chart is missing" (already catchable — the element is
+ *     absent) from "the chart is present and empty", which looks healthy to a presence check and to a
+ *     screenshot diff against a baseline that was also empty.
+ *
+ * Deliberately NOT attempted: comparing plotted geometry against the source data. That needs the
+ * chart's scale functions inverted per library, is a large surface to get wrong, and `chartInstance`
+ * below obsoletes it for the libraries people actually use — Chart.js and ECharts both hang their
+ * instance off the canvas element, so their data can be read directly rather than reverse-engineered
+ * from pixels.
+ */
+/** Elements whose geometry encodes data. `line`/`circle`/`rect` are excluded: they are used for axes,
+ *  gridlines and backgrounds, where a zero-extent element is normal rather than a fault. */
+const GEOMETRY_TAGS = ['path', 'polyline', 'polygon'];
+/** Attributes carrying that geometry, per tag. */
+const GEOMETRY_ATTRS = ['d', 'points'];
+const SAMPLE_MAX = 120;
+/**
+ * Every number embedded in a geometry attribute. Path data interleaves single-letter drawing
+ * commands with coordinate pairs, so this extracts numeric-looking tokens rather than parsing the
+ * path grammar — the question here is only "is any coordinate non-finite", which does not need a
+ * full parser.
+ */
+export function geometryNumbers(value) {
+    const tokens = value.match(/-?\d*\.?\d+(?:e[-+]?\d+)?|NaN|Infinity|-Infinity/gi) ?? [];
+    return tokens.map((t) => Number(t));
+}
+/** True when the attribute contains a coordinate the browser cannot render. */
+export function hasNonFiniteCoordinate(value) {
+    // Checked textually first: `NaN` and `Infinity` survive into the attribute as literal words, and a
+    // string scan catches them without depending on how the number extractor tokenises.
+    if (/NaN|Infinity/i.test(value))
+        return true;
+    return geometryNumbers(value).some((n) => !Number.isFinite(n));
+}
+/** True when the geometry encloses no area — no coordinates, or every coordinate pair identical. */
+export function isDegenerate(value) {
+    const nums = geometryNumbers(value).filter((n) => Number.isFinite(n));
+    if (nums.length === 0)
+        return true;
+    // A polyline of one repeated point draws nothing. Compare pairs, not raw numbers, so a legitimately
+    // flat line (varying x, constant y) is NOT flagged — that is a real chart of constant data.
+    const xs = nums.filter((_, i) => i % 2 === 0);
+    const ys = nums.filter((_, i) => i % 2 === 1);
+    const allSame = (arr) => arr.every((v) => v === arr[0]);
+    return xs.length > 1 && allSame(xs) && allSame(ys);
+}
+/**
+ * Inspect a subtree for chart geometry faults. Pure over the element — no events, no globals — so it
+ * can back a tool call, an assertion, or a snapshot annotation without any of them owning it.
+ */
+export function inspectChart(root) {
+    const findings = [];
+    let examined = 0;
+    for (const tag of GEOMETRY_TAGS) {
+        for (const el of Array.from(root.querySelectorAll(tag))) {
+            for (const attr of GEOMETRY_ATTRS) {
+                const value = el.getAttribute(attr);
+                if (value === null)
+                    continue;
+                examined += 1;
+                const sample = value.length > SAMPLE_MAX ? `${value.slice(0, SAMPLE_MAX)}…` : value;
+                if (hasNonFiniteCoordinate(value)) {
+                    findings.push({ kind: 'non-finite-coordinates', tag, attr, sample });
+                }
+                else if (value.trim().length === 0) {
+                    findings.push({ kind: 'empty-geometry', tag, attr, sample });
+                }
+                else if (isDegenerate(value)) {
+                    findings.push({ kind: 'degenerate-geometry', tag, attr, sample });
+                }
+            }
+        }
+    }
+    const canvas = root.querySelectorAll('canvas').length > 0;
+    return { examined, findings, canvas };
+}
+/**
+ * Read the data behind a CANVAS chart.
+ *
+ * Canvas is the one place where "instrument from inside the app" is not merely cheaper than pixels but
+ * is the only option at all: the chart is a bitmap, so the DOM shows an empty `<canvas>` and a
+ * screenshot shows colours no assertion can interpret. Both major canvas libraries keep their live
+ * instance reachable from the element — Chart.js via its registry, ECharts via a per-DOM lookup — so
+ * the series data is READABLE rather than reverse-engineerable.
+ *
+ * Takes the globals as arguments rather than reaching for `window`, so this stays pure and testable
+ * and the SDK never depends on either library being present.
+ */
+export function canvasChartData(canvas, globals) {
+    const chartjs = globals.Chart?.getChart?.(canvas);
+    if (chartjs !== undefined && chartjs !== null) {
+        return { library: 'chartjs', data: chartjs.data ?? null };
+    }
+    const echart = globals.echarts?.getInstanceByDom?.(canvas);
+    if (echart !== undefined && echart !== null) {
+        return { library: 'echarts', data: echart.getOption?.() ?? null };
+    }
+    return null;
+}
+//# sourceMappingURL=chart.js.map

package/dist/dom/chart.js.map

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

package/dist/dom/dom-ignore.d.ts

@@ -2,6 +2,8 @@
 export declare function setIgnoreSelectors(selectors: string[]): void;
 /** True if the element is part of Reticle's own presenter overlay. */
 export declare function isReticleOverlay(el: Element): boolean;
+/** Walk ancestors: true iff any element in the chain carries a data-reticle* attribute (Reticle's own UI). */
+export declare function isReticleUi(node: Element | null): boolean;
 /** True if the element should be excluded from snapshots/queries (Reticle overlay or dev overlay). */
 export declare function isIgnored(el: Element): boolean;
 //# sourceMappingURL=dom-ignore.d.ts.map

package/dist/dom/dom-ignore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-ignore.d.ts","sourceRoot":"","sources":["../../src/dom/dom-ignore.ts"],"names":[],"mappings":"AAUA,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAE5D;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAM9C"}
+{"version":3,"file":"dom-ignore.d.ts","sourceRoot":"","sources":["../../src/dom/dom-ignore.ts"],"names":[],"mappings":"AAeA,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAE5D;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,8GAA8G;AAC9G,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAOzD;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAM9C"}

package/dist/dom/dom-ignore.js

@@ -1,5 +1,10 @@
-/** Selectors for Reticle's own presenter overlay (cursor, HUD, glow) — never observed/snapshotted. */
-const RETICLE_OVERLAY = '[data-reticle-overlay],[data-reticle-cursor],[data-reticle-hud],[data-reticle-glow]';
+/**
+ * Selectors for Reticle's own presenter overlay (cursor, HUD, glow) + the annotator's "flag a bug"
+ * UI (`data-reticle-mark`) — never observed/snapshotted. The annotator mounts by DEFAULT with the
+ * presenter, so omitting its selector here leaked a phantom `<button>Flag a bug</button>` into every
+ * snapshot and streamed its highlight-box mutations/transitions as if the APP had rendered them.
+ */
+const RETICLE_OVERLAY = '[data-reticle-overlay],[data-reticle-cursor],[data-reticle-hud],[data-reticle-glow],[data-reticle-mark]';
 /** Known third-party dev overlays to keep out of snapshots (Agentation, Next dev UI). */
 const DEV_OVERLAYS = '[data-agentation],#__next-build-watcher,nextjs-portal,[data-nextjs-dialog],[data-nextjs-toast]';
 let extraIgnore = '';
@@ -11,6 +16,16 @@ export function setIgnoreSelectors(selectors) {
 export function isReticleOverlay(el) {
     return el.closest(RETICLE_OVERLAY) !== null;
 }
+/** Walk ancestors: true iff any element in the chain carries a data-reticle* attribute (Reticle's own UI). */
+export function isReticleUi(node) {
+    for (let n = node; n !== null; n = n.parentElement) {
+        for (const attr of Array.from(n.attributes)) {
+            if (attr.name.startsWith('data-reticle'))
+                return true;
+        }
+    }
+    return false;
+}
 /** True if the element should be excluded from snapshots/queries (Reticle overlay or dev overlay). */
 export function isIgnored(el) {
     const sel = extraIgnore.length > 0

package/dist/dom/dom-ignore.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom-ignore.js","sourceRoot":"","sources":["../../src/dom/dom-ignore.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,eAAe,GACnB,qFAAqF,CAAC;AAExF,yFAAyF;AACzF,MAAM,YAAY,GAChB,gGAAgG,CAAC;AAEnG,IAAI,WAAW,GAAG,EAAE,CAAC;AAErB,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,SAAmB;IACpD,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,EAAW;IAC1C,OAAO,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,EAAW;IACnC,MAAM,GAAG,GACP,WAAW,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,GAAG,eAAe,IAAI,YAAY,IAAI,WAAW,EAAE;QACrD,CAAC,CAAC,GAAG,eAAe,IAAI,YAAY,EAAE,CAAC;IAC3C,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAClC,CAAC"}
+{"version":3,"file":"dom-ignore.js","sourceRoot":"","sources":["../../src/dom/dom-ignore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,eAAe,GACnB,yGAAyG,CAAC;AAE5G,yFAAyF;AACzF,MAAM,YAAY,GAChB,gGAAgG,CAAC;AAEnG,IAAI,WAAW,GAAG,EAAE,CAAC;AAErB,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,SAAmB;IACpD,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,EAAW;IAC1C,OAAO,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,WAAW,CAAC,IAAoB;IAC9C,KAAK,IAAI,CAAC,GAAmB,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,EAAW;IACnC,MAAM,GAAG,GACP,WAAW,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,GAAG,eAAe,IAAI,YAAY,IAAI,WAAW,EAAE;QACrD,CAAC,CAAC,GAAG,eAAe,IAAI,YAAY,EAAE,CAAC;IAC3C,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAClC,CAAC"}

package/dist/dom/occlusion.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Center-point hit-test, shared by click-geometry (actions) and occlusion detection (commands) so the
+ * two can't drift. Returns the top NON-Reticle element covering `el`'s center, or null when nothing
+ * foreign is on top — i.e. `el` itself, an ancestor wrapping it, or a descendant is on top (all "not
+ * occluded"). A zero-area or unlayouted box (jsdom / detached node) returns null: we cannot tell, so
+ * we never false-positive an occlusion. Reticle's own HUD is never treated as an occluder.
+ */
+export declare function hitTestOccluder(el: Element, rect: DOMRect): Element | null;
+//# sourceMappingURL=occlusion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"occlusion.d.ts","sourceRoot":"","sources":["../../src/dom/occlusion.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAQ1E"}

package/dist/dom/occlusion.js

@@ -0,0 +1,21 @@
+import { isReticleUi } from './dom-ignore.js';
+/**
+ * Center-point hit-test, shared by click-geometry (actions) and occlusion detection (commands) so the
+ * two can't drift. Returns the top NON-Reticle element covering `el`'s center, or null when nothing
+ * foreign is on top — i.e. `el` itself, an ancestor wrapping it, or a descendant is on top (all "not
+ * occluded"). A zero-area or unlayouted box (jsdom / detached node) returns null: we cannot tell, so
+ * we never false-positive an occlusion. Reticle's own HUD is never treated as an occluder.
+ */
+export function hitTestOccluder(el, rect) {
+    if (rect.width === 0 || rect.height === 0)
+        return null;
+    const doc = el.ownerDocument;
+    if (typeof doc.elementFromPoint !== 'function')
+        return null;
+    const top = doc.elementFromPoint(rect.left + rect.width / 2, rect.top + rect.height / 2);
+    if (top === null || isReticleUi(top))
+        return null;
+    const lands = top === el || el.contains(top) || top.contains(el);
+    return lands ? null : top;
+}
+//# sourceMappingURL=occlusion.js.map

package/dist/dom/occlusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occlusion.js","sourceRoot":"","sources":["../../src/dom/occlusion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,EAAW,EAAE,IAAa;IACxD,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC;IAC7B,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzF,IAAI,GAAG,KAAK,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,KAAK,GAAG,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5B,CAAC"}