imperium-crawl 1.5.2 → 2.0.0

package/dist/snapshot/differ.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Dual diff system — text (Myers) + image (pixel comparison).
+ *
+ * Text diff: Line-level Myers algorithm on snapshot strings.
+ * Image diff: Canvas-based pixel comparison in an isolated browser page.
+ */
+type BrowserContext = import("rebrowser-playwright").BrowserContext;
+export interface TextDiffResult {
+    diff: string;
+    additions: number;
+    removals: number;
+    unchanged: number;
+    changed: boolean;
+}
+/**
+ * Myers diff algorithm (line-level).
+ * Returns unified diff format with +/- prefixes.
+ */
+export declare function diffSnapshots(before: string, after: string): TextDiffResult;
+export interface ImageDiffResult {
+    mismatchPercentage: number;
+    match: boolean;
+    diffImage: Buffer;
+    totalPixels: number;
+    changedPixels: number;
+}
+export interface ImageDiffOptions {
+    /** Color distance threshold (0-255). Default: 30 */
+    threshold?: number;
+    /** Match if mismatch is below this % (default: 1.0) */
+    matchThreshold?: number;
+}
+/**
+ * Pixel-level comparison of two screenshots.
+ * Opens an isolated page, loads images via intercepted routes,
+ * computes per-pixel color distance, generates diff PNG.
+ */
+export declare function diffScreenshots(context: BrowserContext, baseline: Buffer, current: Buffer, options?: ImageDiffOptions): Promise<ImageDiffResult>;
+export {};
+//# sourceMappingURL=differ.d.ts.map

package/dist/snapshot/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../src/snapshot/differ.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,KAAK,cAAc,GAAG,OAAO,sBAAsB,EAAE,cAAc,CAAC;AAIpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAwF3E;AAID,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAkH1B"}

package/dist/snapshot/differ.js

@@ -0,0 +1,194 @@
+/**
+ * Dual diff system — text (Myers) + image (pixel comparison).
+ *
+ * Text diff: Line-level Myers algorithm on snapshot strings.
+ * Image diff: Canvas-based pixel comparison in an isolated browser page.
+ */
+/**
+ * Myers diff algorithm (line-level).
+ * Returns unified diff format with +/- prefixes.
+ */
+export function diffSnapshots(before, after) {
+    const beforeLines = before.split("\n");
+    const afterLines = after.split("\n");
+    const n = beforeLines.length;
+    const m = afterLines.length;
+    const max = n + m;
+    // Shortcut: identical
+    if (before === after) {
+        return {
+            diff: beforeLines.map((l) => `  ${l}`).join("\n"),
+            additions: 0,
+            removals: 0,
+            unchanged: n,
+            changed: false,
+        };
+    }
+    // Myers shortest edit script
+    const v = { 1: { x: 0, history: [] } };
+    for (let d = 0; d <= max; d++) {
+        for (let k = -d; k <= d; k += 2) {
+            let path;
+            // Choose path: go down (insert) or go right (delete)
+            if (k === -d || (k !== d && v[k - 1].x < v[k + 1].x)) {
+                // Move down: insert from after
+                const prev = v[k + 1];
+                path = {
+                    x: prev.x,
+                    history: [...prev.history, { type: "add", line: afterLines[prev.x - k - 1] ?? "" }],
+                };
+            }
+            else {
+                // Move right: delete from before
+                const prev = v[k - 1];
+                path = {
+                    x: prev.x + 1,
+                    history: [...prev.history, { type: "remove", line: beforeLines[prev.x] ?? "" }],
+                };
+            }
+            // Follow diagonal (equal lines)
+            while (path.x < n && path.x - k < m && beforeLines[path.x] === afterLines[path.x - k]) {
+                path.history = [...path.history, { type: "equal", line: beforeLines[path.x] }];
+                path.x++;
+            }
+            // Check if we reached the end
+            if (path.x >= n && path.x - k >= m) {
+                let additions = 0;
+                let removals = 0;
+                let unchanged = 0;
+                const lines = [];
+                for (const entry of path.history) {
+                    switch (entry.type) {
+                        case "equal":
+                            lines.push(`  ${entry.line}`);
+                            unchanged++;
+                            break;
+                        case "add":
+                            lines.push(`+ ${entry.line}`);
+                            additions++;
+                            break;
+                        case "remove":
+                            lines.push(`- ${entry.line}`);
+                            removals++;
+                            break;
+                    }
+                }
+                return {
+                    diff: lines.join("\n"),
+                    additions,
+                    removals,
+                    unchanged,
+                    changed: additions > 0 || removals > 0,
+                };
+            }
+            v[k] = path;
+        }
+    }
+    // Should never reach here for valid inputs
+    return { diff: "", additions: 0, removals: 0, unchanged: 0, changed: false };
+}
+/**
+ * Pixel-level comparison of two screenshots.
+ * Opens an isolated page, loads images via intercepted routes,
+ * computes per-pixel color distance, generates diff PNG.
+ */
+export async function diffScreenshots(context, baseline, current, options = {}) {
+    const { threshold = 30, matchThreshold = 1.0 } = options;
+    const page = await context.newPage();
+    try {
+        // Intercept image routes to serve our buffers
+        await page.route("**/baseline.png", (route) => {
+            route.fulfill({
+                status: 200,
+                contentType: "image/png",
+                body: baseline,
+            });
+        });
+        await page.route("**/current.png", (route) => {
+            route.fulfill({
+                status: 200,
+                contentType: "image/png",
+                body: current,
+            });
+        });
+        // Canvas-based pixel diff in browser context
+        const result = await page.evaluate(async (thresh) => {
+            // Load images
+            const loadImage = (src) => new Promise((resolve, reject) => {
+                const img = new Image();
+                img.onload = () => resolve(img);
+                img.onerror = reject;
+                img.src = src;
+            });
+            const [img1, img2] = await Promise.all([
+                loadImage("/baseline.png"),
+                loadImage("/current.png"),
+            ]);
+            const width = Math.max(img1.width, img2.width);
+            const height = Math.max(img1.height, img2.height);
+            // Draw images to canvases
+            const canvas1 = document.createElement("canvas");
+            canvas1.width = width;
+            canvas1.height = height;
+            canvas1.getContext("2d").drawImage(img1, 0, 0);
+            const canvas2 = document.createElement("canvas");
+            canvas2.width = width;
+            canvas2.height = height;
+            canvas2.getContext("2d").drawImage(img2, 0, 0);
+            // Diff canvas
+            const diffCanvas = document.createElement("canvas");
+            diffCanvas.width = width;
+            diffCanvas.height = height;
+            const diffCtx = diffCanvas.getContext("2d");
+            const data1 = canvas1.getContext("2d").getImageData(0, 0, width, height).data;
+            const data2 = canvas2.getContext("2d").getImageData(0, 0, width, height).data;
+            const diffData = diffCtx.createImageData(width, height);
+            let changed = 0;
+            const totalPixels = width * height;
+            for (let i = 0; i < data1.length; i += 4) {
+                const dr = Math.abs(data1[i] - data2[i]);
+                const dg = Math.abs(data1[i + 1] - data2[i + 1]);
+                const db = Math.abs(data1[i + 2] - data2[i + 2]);
+                const dist = Math.sqrt(dr * dr + dg * dg + db * db);
+                if (dist > thresh) {
+                    // Highlight difference in red
+                    diffData.data[i] = 255;
+                    diffData.data[i + 1] = 0;
+                    diffData.data[i + 2] = 0;
+                    diffData.data[i + 3] = 200;
+                    changed++;
+                }
+                else {
+                    // Darken unchanged pixels
+                    diffData.data[i] = Math.floor(data2[i] * 0.3);
+                    diffData.data[i + 1] = Math.floor(data2[i + 1] * 0.3);
+                    diffData.data[i + 2] = Math.floor(data2[i + 2] * 0.3);
+                    diffData.data[i + 3] = 255;
+                }
+            }
+            diffCtx.putImageData(diffData, 0, 0);
+            // Export as data URL
+            const dataUrl = diffCanvas.toDataURL("image/png");
+            return {
+                totalPixels,
+                changedPixels: changed,
+                mismatchPercentage: (changed / totalPixels) * 100,
+                dataUrl,
+            };
+        }, threshold);
+        // Convert data URL to buffer
+        const base64Data = result.dataUrl.split(",")[1];
+        const diffImage = Buffer.from(base64Data, "base64");
+        return {
+            mismatchPercentage: result.mismatchPercentage,
+            match: result.mismatchPercentage <= matchThreshold,
+            diffImage,
+            totalPixels: result.totalPixels,
+            changedPixels: result.changedPixels,
+        };
+    }
+    finally {
+        await page.close();
+    }
+}
+//# sourceMappingURL=differ.js.map

package/dist/snapshot/differ.js.map

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

package/dist/snapshot/extractor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Snapshot Extractor — Core engine for ARIA-based page snapshots.
+ *
+ * Uses Playwright's locator.ariaSnapshot() for the ARIA tree,
+ * then post-processes to add [ref=eN] tags for interactive elements.
+ * Optionally detects cursor-interactive elements without ARIA roles.
+ *
+ * Inspired by agent-browser's approach but with:
+ * - Per-snapshot ref counter (thread-safe, no global state)
+ * - Hybrid cursor detection
+ * - Semantic locators (getByRole) for robust element targeting
+ */
+import type { EnhancedSnapshot, SnapshotOptions } from "./types.js";
+type Page = import("rebrowser-playwright").Page;
+/**
+ * Generate an enhanced ARIA snapshot with ref annotations.
+ *
+ * Flow:
+ * 1. Get ARIA tree from Playwright's ariaSnapshot()
+ * 2. Parse each line, identify roles
+ * 3. Two-pass ref assignment (count first for dedup, then assign)
+ * 4. Optionally detect cursor-interactive elements
+ * 5. Build RefMap and annotated tree string
+ */
+export declare function getEnhancedSnapshot(page: Page, options?: SnapshotOptions): Promise<EnhancedSnapshot>;
+export {};
+//# sourceMappingURL=extractor.d.ts.map

package/dist/snapshot/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/snapshot/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAU,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5E,KAAK,IAAI,GAAG,OAAO,sBAAsB,EAAE,IAAI,CAAC;AAkLhD;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAyH3B"}

package/dist/snapshot/extractor.js

@@ -0,0 +1,265 @@
+/**
+ * Snapshot Extractor — Core engine for ARIA-based page snapshots.
+ *
+ * Uses Playwright's locator.ariaSnapshot() for the ARIA tree,
+ * then post-processes to add [ref=eN] tags for interactive elements.
+ * Optionally detects cursor-interactive elements without ARIA roles.
+ *
+ * Inspired by agent-browser's approach but with:
+ * - Per-snapshot ref counter (thread-safe, no global state)
+ * - Hybrid cursor detection
+ * - Semantic locators (getByRole) for robust element targeting
+ */
+// ── Role classification ──
+const INTERACTIVE_ROLES = new Set([
+    "button", "link", "textbox", "checkbox", "radio",
+    "combobox", "listbox", "menuitem", "option", "searchbox",
+    "slider", "spinbutton", "switch", "tab", "treeitem",
+]);
+const CONTENT_ROLES = new Set([
+    "heading", "cell", "article", "region", "navigation",
+    "img", "figure", "blockquote", "code",
+]);
+const STRUCTURAL_ROLES = new Set([
+    "generic", "group", "list", "table", "row", "rowgroup",
+    "columnheader", "rowheader", "presentation", "none",
+    "separator", "toolbar", "banner", "contentinfo", "main",
+    "complementary", "form",
+]);
+/**
+ * Parse a single line from Playwright's ariaSnapshot output.
+ * Format: "  - role \"name\" [attributes]" or "  - role \"name\":"
+ * Also handles: "  - text: content here"
+ */
+function parseLine(line) {
+    // Count leading spaces for indentation
+    const stripped = line.replace(/^\s*/, "");
+    const indent = line.length - stripped.length;
+    // Must start with "- "
+    if (!stripped.startsWith("- "))
+        return null;
+    const content = stripped.slice(2);
+    // Match: role "name" or role "name": or just role:
+    const roleNameMatch = content.match(/^(\w+)\s+"([^"]*)"(.*)$/);
+    if (roleNameMatch) {
+        return {
+            indent,
+            role: roleNameMatch[1],
+            name: roleNameMatch[2],
+            rawLine: line,
+            attributes: roleNameMatch[3].trim(),
+        };
+    }
+    // Match: role (no name) — e.g. "- list:" or "- generic"
+    const roleOnlyMatch = content.match(/^(\w+):?\s*$/);
+    if (roleOnlyMatch) {
+        return {
+            indent,
+            role: roleOnlyMatch[1],
+            name: "",
+            rawLine: line,
+            attributes: "",
+        };
+    }
+    // Text node: "- text: some content"
+    if (content.startsWith("text:")) {
+        return {
+            indent,
+            role: "text",
+            name: content.slice(5).trim(),
+            rawLine: line,
+            attributes: "",
+        };
+    }
+    // Plain text line (e.g. "- Some text content")
+    return {
+        indent,
+        role: "text",
+        name: content.replace(/:$/, "").trim(),
+        rawLine: line,
+        attributes: "",
+    };
+}
+// ── Role+Name dedup tracker ──
+class RoleNameTracker {
+    counts = new Map();
+    assigned = new Map();
+    /** First pass: count occurrences */
+    count(role, name) {
+        const key = `${role}:::${name}`;
+        this.counts.set(key, (this.counts.get(key) ?? 0) + 1);
+    }
+    /** Second pass: get nth index (only if duplicates exist) */
+    getNth(role, name) {
+        const key = `${role}:::${name}`;
+        const total = this.counts.get(key) ?? 1;
+        if (total <= 1)
+            return undefined;
+        const idx = this.assigned.get(key) ?? 0;
+        this.assigned.set(key, idx + 1);
+        return idx;
+    }
+}
+// ── Selector builder ──
+function buildSelector(role, name, nth) {
+    const nameOpt = name ? `, { name: '${name.replace(/'/g, "\\'")}', exact: true }` : "";
+    const base = `getByRole('${role}'${nameOpt})`;
+    return nth !== undefined ? `${base}.nth(${nth})` : base;
+}
+async function findCursorInteractiveElements(page, scopeSelector) {
+    return page.evaluate((scope) => {
+        const root = scope
+            ? document.querySelector(scope) ?? document.body
+            : document.body;
+        const results = [];
+        const seen = new Set();
+        const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+        let node = walker.nextNode();
+        while (node) {
+            if (!seen.has(node)) {
+                const style = getComputedStyle(node);
+                const hasClick = node.hasAttribute("onclick") ||
+                    node.hasAttribute("tabindex") ||
+                    style.cursor === "pointer";
+                const role = node.getAttribute("role");
+                const tag = node.tagName.toLowerCase();
+                // Only capture elements that LOOK interactive but have no ARIA role
+                if (hasClick && !role && !["a", "button", "input", "select", "textarea"].includes(tag)) {
+                    results.push({
+                        role: "generic",
+                        name: node.getAttribute("aria-label") ||
+                            (node.textContent ?? "").trim().slice(0, 80) || "",
+                        tagName: tag,
+                        ariaLabel: node.getAttribute("aria-label") ?? "",
+                    });
+                    seen.add(node);
+                }
+            }
+            node = walker.nextNode();
+        }
+        return results;
+    }, scopeSelector);
+}
+// ── Main export ──
+/**
+ * Generate an enhanced ARIA snapshot with ref annotations.
+ *
+ * Flow:
+ * 1. Get ARIA tree from Playwright's ariaSnapshot()
+ * 2. Parse each line, identify roles
+ * 3. Two-pass ref assignment (count first for dedup, then assign)
+ * 4. Optionally detect cursor-interactive elements
+ * 5. Build RefMap and annotated tree string
+ */
+export async function getEnhancedSnapshot(page, options = {}) {
+    const { interactive = true, cursor = false, compact = true, selector, } = options;
+    // Get the ARIA tree from Playwright
+    const locator = selector
+        ? page.locator(selector)
+        : page.locator("body");
+    // ariaSnapshot() exists in playwright-core 1.49+ but types may not be in rebrowser-playwright
+    const ariaTree = await locator.ariaSnapshot();
+    const lines = ariaTree.split("\n");
+    const parsed = lines.map(parseLine);
+    // ── First pass: count role+name for dedup ──
+    const tracker = new RoleNameTracker();
+    for (const p of parsed) {
+        if (!p)
+            continue;
+        if (p.role === "text")
+            continue;
+        if (INTERACTIVE_ROLES.has(p.role) || CONTENT_ROLES.has(p.role)) {
+            tracker.count(p.role, p.name);
+        }
+    }
+    // ── Second pass: assign refs ──
+    let refCounter = 0;
+    const refs = {};
+    const annotatedLines = [];
+    let totalElements = 0;
+    let interactiveCount = 0;
+    let contentCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const p = parsed[i];
+        if (!p) {
+            // Keep raw lines that didn't parse (empty lines, etc.)
+            if (lines[i].trim())
+                annotatedLines.push(lines[i]);
+            continue;
+        }
+        totalElements++;
+        const isInteractive = INTERACTIVE_ROLES.has(p.role);
+        const isContent = CONTENT_ROLES.has(p.role);
+        const isStructural = STRUCTURAL_ROLES.has(p.role);
+        const isText = p.role === "text";
+        // Decide whether to assign a ref
+        let ref;
+        if (isInteractive) {
+            interactiveCount++;
+            ref = `e${++refCounter}`;
+            const nth = tracker.getNth(p.role, p.name);
+            refs[ref] = {
+                selector: buildSelector(p.role, p.name, nth),
+                role: p.role,
+                name: p.name,
+                ...(nth !== undefined && { nth }),
+            };
+        }
+        else if (isContent && !interactive) {
+            contentCount++;
+            ref = `e${++refCounter}`;
+            const nth = tracker.getNth(p.role, p.name);
+            refs[ref] = {
+                selector: buildSelector(p.role, p.name, nth),
+                role: p.role,
+                name: p.name,
+                ...(nth !== undefined && { nth }),
+            };
+        }
+        // Build annotated line
+        if (compact && isStructural && !ref) {
+            // In compact mode, skip structural elements without refs
+            // BUT keep them if they have children (indicated by trailing ":")
+            if (!p.rawLine.trimEnd().endsWith(":"))
+                continue;
+        }
+        if (ref) {
+            // Insert [ref=eN] after the role
+            const indent = " ".repeat(p.indent);
+            const nameStr = p.name ? ` "${p.name}"` : "";
+            const attrStr = p.attributes ? ` ${p.attributes}` : "";
+            annotatedLines.push(`${indent}- ${p.role}${nameStr} [ref=${ref}]${attrStr}`);
+        }
+        else if (isText || !compact || !isStructural) {
+            annotatedLines.push(p.rawLine);
+        }
+    }
+    // ── Cursor-interactive elements (optional) ──
+    if (cursor) {
+        const cursorElements = await findCursorInteractiveElements(page, selector);
+        for (const el of cursorElements) {
+            const ref = `e${++refCounter}`;
+            interactiveCount++;
+            // For cursor elements, build a CSS-based selector as fallback
+            const nameStr = el.ariaLabel || el.name;
+            refs[ref] = {
+                selector: nameStr
+                    ? `getByRole('${el.role}', { name: '${nameStr.replace(/'/g, "\\'")}', exact: true })`
+                    : `locator('${el.tagName}')`,
+                role: el.role || "generic",
+                name: nameStr,
+            };
+            annotatedLines.push(`- ${el.role || "generic"} "${nameStr}" [ref=${ref}] (cursor-interactive)`);
+        }
+    }
+    return {
+        tree: annotatedLines.join("\n"),
+        refs,
+        stats: {
+            totalElements,
+            interactiveElements: interactiveCount,
+            contentElements: contentCount,
+        },
+    };
+}
+//# sourceMappingURL=extractor.js.map

package/dist/snapshot/extractor.js.map

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

package/dist/snapshot/index.d.ts

@@ -0,0 +1,8 @@
+export type { RefMap, RefEntry, EnhancedSnapshot, SnapshotOptions } from "./types.js";
+export { getEnhancedSnapshot } from "./extractor.js";
+export { getSnapshotStore, resetSnapshotStore } from "./store.js";
+export { annotateScreenshot } from "./annotator.js";
+export { generateBoundary, wrapContent } from "./boundary.js";
+export { diffSnapshots, diffScreenshots } from "./differ.js";
+export type { TextDiffResult, ImageDiffResult, ImageDiffOptions } from "./differ.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/snapshot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/snapshot/index.js

@@ -0,0 +1,6 @@
+export { getEnhancedSnapshot } from "./extractor.js";
+export { getSnapshotStore, resetSnapshotStore } from "./store.js";
+export { annotateScreenshot } from "./annotator.js";
+export { generateBoundary, wrapContent } from "./boundary.js";
+export { diffSnapshots, diffScreenshots } from "./differ.js";
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/snapshot/store.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SnapshotStore — In-memory ref storage with LRU eviction.
+ *
+ * Stores RefMaps keyed by session_id (or auto-generated snapshot IDs).
+ * Refs are ephemeral — they exist only in memory and are invalidated
+ * when a new snapshot is taken for the same session.
+ */
+import type { RefMap, RefEntry } from "./types.js";
+declare class SnapshotStore {
+    private store;
+    /** Save a snapshot's refs, evicting oldest if at capacity */
+    save(id: string, refs: RefMap, url: string): void;
+    /** Resolve a ref string (e.g. "e5" or "@e5") to its locator info */
+    resolveRef(id: string, refString: string): RefEntry | null;
+    /** Get all refs for a snapshot */
+    getRefs(id: string): RefMap | null;
+    /** Invalidate a specific snapshot */
+    invalidate(id: string): void;
+    /** Clear all stored snapshots */
+    clear(): void;
+    /** Number of stored snapshots */
+    get size(): number;
+}
+export declare function getSnapshotStore(): SnapshotStore;
+/** Reset singleton (for testing) */
+export declare function resetSnapshotStore(): void;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/snapshot/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/snapshot/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AASnD,cAAM,aAAa;IACjB,OAAO,CAAC,KAAK,CAAqC;IAElD,6DAA6D;IAC7D,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAiBjD,oEAAoE;IACpE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAS1D,kCAAkC;IAClC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIlC,qCAAqC;IACrC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAIb,iCAAiC;IACjC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}