@ubio/webvision 2.3.0 → 2.4.0

package/build/page.mjs

@@ -14,7 +14,7 @@ var Counter = class {
 
 // src/page/dom.ts
 var ORIGINAL_STYLE_SYMBOL = Symbol("vx:originalStyle");
-var INTERACTIVE_TAGS = ["a", "button", "input", "textarea", "select", "label"];
+var INTERACTIVE_TAGS = ["a", "button", "input", "textarea", "select", "label", "option", "optgroup"];
 var INTERACTIVE_ROLES = [
   "button",
   "link",
@@ -292,7 +292,7 @@ var VX_TAG_PREFERENCE = [
   "sub",
   "sup"
 ];
-var VX_KEEP_SELECTOR = "a, button, input, textarea, select, label, iframe";
+var VX_KEEP_SELECTOR = "a, button, input, textarea, select, label, iframe, option, optgroup";
 var VxTreeParser = class {
   constructor(options = {}) {
     this.options = options;
@@ -324,7 +324,7 @@ var VxTreeParser = class {
     return this.domRefMap;
   }
   parseNode(node, parent) {
-    if (node[VX_IGNORE_SYMBOL]) {
+    if (!node || node[VX_IGNORE_SYMBOL]) {
       return null;
     }
     if (node instanceof Text) {
@@ -595,32 +595,17 @@ function* traverseVxNode(vxNode, depth = 0) {
 function renderVxNode(scope, options = {}) {
   const buffer = [];
   const whitelistRefs = options.whitelistRefs ?? [];
-  const stack = [];
   for (const { vxNode, depth } of traverseVxNode(scope)) {
     if (whitelistRefs.length > 0) {
       if (!whitelistRefs.includes(vxNode.ref)) {
         continue;
       }
     }
-    while (depth < stack.length) {
-      stack.pop();
+    if (options.skipNonInteractive && !vxNode.isInteractive) {
+      continue;
     }
-    const parentState = stack[depth - 1];
-    const parentIndentLevel = parentState?.indentLevel ?? 0;
-    const parentContributes = parentState?.contributes ?? false;
-    let currentIndentLevel;
-    if (depth === 0) {
-      currentIndentLevel = 0;
-    } else {
-      currentIndentLevel = parentIndentLevel + (parentContributes ? 1 : 0);
-    }
-    const indent = "    ".repeat(currentIndentLevel);
-    const line = renderIndentedLine(indent, vxNode, options);
-    if (line.trim()) {
-      buffer.push(line);
-    }
-    const contributes = !!(options.renderNonInteractive || vxNode.isInteractive);
-    stack.push({ indentLevel: currentIndentLevel, contributes });
+    const indent = options.skipNonInteractive ? "" : "    ".repeat(depth);
+    buffer.push(renderIndentedLine(indent, vxNode, options));
   }
   return buffer.join("\n");
 }
@@ -628,7 +613,7 @@ function renderIndentedLine(indent, vxNode, options = {}) {
   if (!vxNode.tagName) {
     return [indent, vxNode.textContent].filter(Boolean).join("");
   }
-  const tagLine = !options.renderNonInteractive && !vxNode.isInteractive ? "" : renderTagLine(vxNode, options);
+  const tagLine = renderTagLine(vxNode, options);
   const htmlStyle = options.renderStyle === "html";
   return [
     indent,
@@ -757,6 +742,14 @@ var VxTreeView = class {
     }
     return refs;
   }
+  highlightRefs(refs) {
+    for (const ref of refs) {
+      const el = resolveDomNode(ref);
+      if (el instanceof Element) {
+        highlightEl(el, ref);
+      }
+    }
+  }
   collectRefs(leafOnly = true, filterRefs) {
     const refs = [];
     for (const { vxNode } of this.traverse()) {

package/out/page/counter.d.ts

@@ -0,0 +1,6 @@
+export declare class Counter {
+    value: number;
+    constructor(value?: number);
+    next(): number;
+    current(): number;
+}

package/out/page/counter.js

@@ -0,0 +1,13 @@
+export class Counter {
+    constructor(value = 0) {
+        this.value = value;
+    }
+    next() {
+        this.value += 1;
+        return this.value;
+    }
+    current() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=counter.js.map

package/out/page/counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.js","sourceRoot":"","sources":["../../src/page/counter.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,OAAO;IAEhB,YAAmB,QAAQ,CAAC;QAAT,UAAK,GAAL,KAAK,CAAI;IAAG,CAAC;IAEhC,IAAI;QACA,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CAEJ"}

package/out/page/dom.d.ts

@@ -0,0 +1,21 @@
+export declare const INTERACTIVE_TAGS: string[];
+export declare const INTERACTIVE_ROLES: string[];
+export interface Viewport {
+    width: number;
+    height: number;
+}
+export declare function isHidden(el: Element): boolean;
+export declare function getNormalizedText(el: Element): string;
+export declare function normalizeText(str: string): string;
+export declare function truncateAttrValue(value: string, limit?: number): string;
+export declare function escapeAttribute(value: string): string;
+export declare function containsSelector(el: Element, selector: string): boolean;
+export declare function getOffsetTop(node: Node): number;
+export declare function hasVisibleArea(element: Element): boolean;
+export declare function isDeepHidden(element: Element): boolean;
+export declare function isInteractive(el: Element): boolean;
+export declare function getViewportSize(): Viewport;
+export declare function isRectInViewport(rect: DOMRect, viewport: Viewport): boolean;
+export declare function makeOverlaysOpaque(el: HTMLElement): void;
+export declare function isRandomIdentifier(str: string): boolean;
+export declare function fixZIndex(el: HTMLElement): void;

package/out/page/dom.js

@@ -0,0 +1,172 @@
+const ORIGINAL_STYLE_SYMBOL = Symbol('vx:originalStyle');
+export const INTERACTIVE_TAGS = ['a', 'button', 'input', 'textarea', 'select', 'label', 'option', 'optgroup'];
+export const INTERACTIVE_ROLES = [
+    'button', 'link', 'checkbox', 'radio', 'textbox', 'combobox', 'listbox', 'menu', 'menuitem', 'menuitemcheckbox', 'menuitemradio', 'option', 'optgroup', 'progressbar', 'scrollbar', 'slider', 'spinbutton', 'switch', 'tab', 'tablist', 'timer', 'toolbar'
+];
+export function isHidden(el) {
+    const style = getComputedStyle(el);
+    if (style.display === 'none') {
+        return true;
+    }
+    if (style.visibility === 'hidden') {
+        return true;
+    }
+    if (style.opacity === '0') {
+        return true;
+    }
+    return false;
+}
+export function getNormalizedText(el) {
+    return normalizeText(el.textContent ?? '');
+}
+export function normalizeText(str) {
+    return str
+        .replace(/\p{Cf}/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export function truncateAttrValue(value, limit = 100) {
+    if (value.match(/^(javascript:)?void/)) {
+        return '';
+    }
+    if (value.startsWith('data:')) {
+        return '';
+    }
+    if (value.length > limit) {
+        return value.slice(0, limit) + '…';
+    }
+    return value;
+}
+export function escapeAttribute(value) {
+    return value
+        .replace(/&/g, '&') // Escape ampersand first!
+        .replace(/"/g, '"') // Escape double quotes
+        .replace(/'/g, ''') // Escape single quotes
+        .replace(/</g, '&lt;') // Escape less than
+        .replace(/>/g, '&gt;') // Escape greater than
+        .replace(/\r?\n/g, ' '); // Replace newlines with space
+}
+export function containsSelector(el, selector) {
+    return el.matches(selector) || !!el.querySelector(selector);
+}
+export function getOffsetTop(node) {
+    let y = 0;
+    let current = node;
+    while (current) {
+        y += current.offsetTop ?? 0;
+        current = current.offsetParent;
+    }
+    return y;
+}
+export function hasVisibleArea(element) {
+    const rect = element.getBoundingClientRect();
+    const area = rect.width * rect.height;
+    return area > 64;
+}
+export function isDeepHidden(element) {
+    if (isHidden(element)) {
+        return true;
+    }
+    if (!hasVisibleArea(element)) {
+        return [...element.children].every(el => isDeepHidden(el));
+    }
+    return false;
+}
+export function isInteractive(el) {
+    const htmlEl = el;
+    if (INTERACTIVE_TAGS.includes(el.tagName.toLowerCase())) {
+        return true;
+    }
+    const tabindex = htmlEl.getAttribute('tabindex');
+    if (tabindex && parseInt(tabindex) >= 0) {
+        return true;
+    }
+    const role = htmlEl.getAttribute('role') ?? htmlEl.getAttribute('aria-role') ?? '';
+    if (INTERACTIVE_ROLES.includes(role)) {
+        return true;
+    }
+    if (htmlEl.onclick != null) {
+        return true;
+    }
+    return false;
+}
+export function getViewportSize() {
+    return {
+        width: window.innerWidth,
+        height: window.innerHeight,
+    };
+}
+export function isRectInViewport(rect, viewport) {
+    return rect.left < viewport.width &&
+        rect.right > 0 &&
+        rect.top < viewport.height &&
+        rect.bottom > 0;
+}
+export function makeOverlaysOpaque(el) {
+    if (!el[ORIGINAL_STYLE_SYMBOL]) {
+        el[ORIGINAL_STYLE_SYMBOL] = el.getAttribute('style');
+    }
+    // Only apply to big elements
+    const rect = el.getBoundingClientRect();
+    if (rect.width < 500 || rect.height < 500) {
+        return;
+    }
+    const style = getComputedStyle(el);
+    if (style.pointerEvents === 'none') {
+        return;
+    }
+    el.style.setProperty('animation', 'none', 'important');
+    el.style.setProperty('transition', 'none', 'important');
+    el.style.setProperty('backdrop-filter', 'none', 'important');
+    el.style.setProperty('mix-blend-mode', 'normal', 'important');
+    el.style.setProperty('opacity', '1', 'important');
+    el.style.setProperty('filter', 'none', 'important');
+    const bg = style.backgroundColor;
+    el.style.setProperty('background-color', removeAlpha(bg));
+}
+function removeAlpha(color) {
+    const rgba = color.match(/^rgba\((.*)\)$/);
+    if (!rgba) {
+        return color;
+    }
+    const [r, g, b, a] = rgba[1].split(',').map(parseFloat);
+    if (a > 0 && a < 1) {
+        return `rgba(${r},${g},${b},1)`;
+    }
+    return color;
+}
+export function isRandomIdentifier(str) {
+    const words = str.split(/[_-]/g);
+    return !words.some(w => isWordLike(w)) || words.some(w => isRandomString(w));
+}
+function isWordLike(str) {
+    if (str.length <= 2) {
+        return false;
+    }
+    // Words don't usually have a lot of vowels or consonants in a row
+    if (/[^eyuioa]{4,}/.test(str)) {
+        return false;
+    }
+    if (/[eyuioa]{4,}/.test(str)) {
+        return false;
+    }
+    return true;
+}
+function isRandomString(str) {
+    // Hex strings will often consist of at least one digit and A-F letters
+    if (/^[0-9a-f]+$/i.test(str) && /[0-9]/.test(str)) {
+        return true;
+    }
+    // Digits separated by non-digits are a sign of random ids
+    if (/[0-9][^0-9]+[0-9]/.test(str)) {
+        return true;
+    }
+    return false;
+}
+export function fixZIndex(el) {
+    const style = getComputedStyle(el);
+    if (Number(style.zIndex) > 2147483600) {
+        el.style.setProperty('z-index', '2147483600', 'important');
+    }
+}
+//# sourceMappingURL=dom.js.map

package/out/page/dom.js.map

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

package/out/page/frame.d.ts

@@ -0,0 +1,22 @@
+import { VxNode } from './parser.js';
+import { VxRenderOptions } from './render.js';
+export interface VxFrame {
+    frameId: number;
+    iframeRef?: number;
+    refRange: [number, number];
+    nodes: VxNode[];
+    isOmitted?: boolean;
+}
+export declare class VxPageView<T extends VxFrame> {
+    readonly vxFrames: T[];
+    private vxFrameMap;
+    private vxTreeMap;
+    constructor(vxFrames: T[]);
+    findFrameByFrameId(frameId: number): T | null;
+    getFrameByFrameId(frameId: number): T;
+    findFrameByRef(ref: number): T | null;
+    getFrameByRef(ref: number): T;
+    findParentFrame(frameId: number): T | null;
+    isFrameShown(frameId: number): boolean;
+    renderAll(options: VxRenderOptions): string;
+}

package/out/page/frame.js

@@ -0,0 +1,69 @@
+import { VxTreeView } from './tree.js';
+export class VxPageView {
+    constructor(vxFrames) {
+        this.vxFrames = vxFrames;
+        this.vxFrameMap = new Map();
+        this.vxTreeMap = new Map();
+        for (const frame of vxFrames) {
+            this.vxFrameMap.set(frame.frameId, frame);
+            this.vxTreeMap.set(frame.frameId, new VxTreeView(frame.nodes, frame.refRange));
+        }
+    }
+    findFrameByFrameId(frameId) {
+        return this.vxFrameMap.get(frameId) ?? null;
+    }
+    getFrameByFrameId(frameId) {
+        const vxFrame = this.vxFrameMap.get(frameId);
+        if (vxFrame == null) {
+            throw new Error(`[VX] Frame not found for [frameId=${frameId}]`);
+        }
+        return vxFrame;
+    }
+    findFrameByRef(ref) {
+        const vxFrame = this.vxFrames.find(frame => ref >= frame.refRange[0] && ref <= frame.refRange[1]);
+        if (!vxFrame) {
+            return null;
+        }
+        return this.vxFrameMap.get(vxFrame.frameId) ?? null;
+    }
+    getFrameByRef(ref) {
+        const vxFrame = this.findFrameByRef(ref);
+        if (vxFrame == null) {
+            throw new Error(`[VX] Frame not found for [ref=${ref}]`);
+        }
+        return vxFrame;
+    }
+    findParentFrame(frameId) {
+        const frame = this.getFrameByFrameId(frameId);
+        const iframeRef = frame?.iframeRef;
+        if (iframeRef == null) {
+            return null;
+        }
+        return this.findFrameByRef(iframeRef);
+    }
+    isFrameShown(frameId) {
+        const frame = this.getFrameByFrameId(frameId);
+        if (!frame) {
+            return false;
+        }
+        const parentFrame = this.findParentFrame(frameId);
+        const { iframeRef } = frame;
+        if (parentFrame == null || iframeRef == null) {
+            return true;
+        }
+        const vxTree = this.vxTreeMap.get(frameId);
+        const existsInParent = !!vxTree?.findNode(iframeRef);
+        return existsInParent ? this.isFrameShown(parentFrame.frameId) : false;
+    }
+    renderAll(options) {
+        return this.vxFrames.map(frame => {
+            const vxTree = this.vxTreeMap.get(frame.frameId);
+            const rendered = vxTree?.render(options);
+            return [
+                `FRAME ${frame.frameId}`,
+                rendered,
+            ].join('\n\n');
+        }).join('\n\n');
+    }
+}
+//# sourceMappingURL=frame.js.map

package/out/page/frame.js.map

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

package/out/page/index.d.ts

@@ -0,0 +1,11 @@
+export * from './counter.js';
+export * from './dom.js';
+export * from './frame.js';
+export * from './overlay.js';
+export * from './parser.js';
+export * from './probe.js';
+export * from './render.js';
+export * from './snapshot.js';
+export * from './traverse.js';
+export * from './tree.js';
+export * from './util.js';

package/out/page/index.js

@@ -0,0 +1,12 @@
+export * from './counter.js';
+export * from './dom.js';
+export * from './frame.js';
+export * from './overlay.js';
+export * from './parser.js';
+export * from './probe.js';
+export * from './render.js';
+export * from './snapshot.js';
+export * from './traverse.js';
+export * from './tree.js';
+export * from './util.js';
+//# sourceMappingURL=index.js.map

package/out/page/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/page/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/out/page/overlay.d.ts

@@ -0,0 +1,3 @@
+export declare function showPoint(x: number, y: number, clear?: boolean): void;
+export declare function clearOverlay(): void;
+export declare function highlightEl(el: Element, ref?: number): void;

package/out/page/overlay.js

@@ -0,0 +1,75 @@
+import { VX_IGNORE_SYMBOL } from './parser.js';
+export function showPoint(x, y, clear = true) {
+    if (clear) {
+        clearOverlay();
+    }
+    const point = document.createElement('div');
+    point.style.position = 'absolute';
+    point.style.left = `${x}px`;
+    point.style.top = `${y}px`;
+    point.style.width = '32px';
+    point.style.height = '32px';
+    point.style.transform = 'translate(-50%, -50%)';
+    point.style.backgroundColor = 'red';
+    point.style.borderRadius = '100%';
+    point.style.opacity = '0.5';
+    const container = getOverlayContainer();
+    container.appendChild(point);
+}
+export function clearOverlay() {
+    const container = getOverlayContainer();
+    container.remove();
+}
+export function highlightEl(el, ref = 0) {
+    if (!(el instanceof Element)) {
+        return;
+    }
+    const container = getOverlayContainer();
+    const color = getColor(ref);
+    const rect = el.getBoundingClientRect();
+    const overlay = document.createElement('div');
+    container.appendChild(overlay);
+    overlay.style.position = 'absolute';
+    overlay.style.top = `${rect.top}px`;
+    overlay.style.left = `${rect.left}px`;
+    overlay.style.width = `${rect.width}px`;
+    overlay.style.height = `${rect.height}px`;
+    overlay.style.border = `2px solid ${color}`;
+    const label = document.createElement('div');
+    overlay.appendChild(label);
+    label.style.position = 'absolute';
+    label.style.bottom = `100%`;
+    label.style.left = `0`;
+    label.style.backgroundColor = color;
+    label.style.color = 'white';
+    label.style.fontSize = '10px';
+    label.style.fontFamily = 'monospace';
+    label.style.fontWeight = 'normal';
+    label.style.fontStyle = 'normal';
+    label.style.opacity = '0.8';
+    label.style.padding = '0 2px';
+    label.style.transform = 'translateY(50%)';
+    label.textContent = String(ref);
+}
+function getOverlayContainer() {
+    let container = document.querySelector('#webvision-overlay');
+    if (!container) {
+        container = document.createElement('div');
+        container[VX_IGNORE_SYMBOL] = true;
+        container.id = 'webvision-overlay';
+        container.style.position = 'fixed';
+        container.style.top = '0';
+        container.style.left = '0';
+        container.style.bottom = '0';
+        container.style.right = '0';
+        container.style.zIndex = '2147483647'; // Maximum z-index value
+        container.style.pointerEvents = 'none';
+        document.body.appendChild(container);
+    }
+    return container;
+}
+function getColor(index) {
+    const hue = (index * 120 * .382) % 360;
+    return `hsl(${hue}, 85%, 50%)`;
+}
+//# sourceMappingURL=overlay.js.map

package/out/page/overlay.js.map

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

package/out/page/parser.d.ts

@@ -0,0 +1,61 @@
+import { VxTreeView } from './tree.js';
+export declare const VX_NODE_SYMBOL: unique symbol;
+export declare const VX_IGNORE_SYMBOL: unique symbol;
+export declare const VX_IGNORE_TAGS: string[];
+export declare const VX_LABEL_ATTRS: string[];
+export declare const VX_VALUE_ATTRS: string[];
+export declare const VX_SRC_ATTRS: string[];
+export declare const VX_TAG_PREFERENCE: string[];
+export type VxDomNode = Element | Text;
+export interface VxNode {
+    ref: number;
+    tagName?: string;
+    children?: VxNode[];
+    id?: string;
+    classList?: string[];
+    textContent?: string;
+    hasVisibleArea?: boolean;
+    isInteractive?: boolean;
+    isOutsideViewport?: boolean;
+    isProbeHit?: boolean;
+    isKept?: boolean;
+    srcAttrs?: Record<string, string>;
+    labelAttrs?: Record<string, string>;
+    valueAttrs?: Record<string, string>;
+}
+export interface VxTreeOptions {
+    startRef?: number;
+    skipImages?: boolean;
+    viewportOnly?: boolean;
+    probeViewport?: boolean;
+    opaqueOverlays?: boolean;
+    unnestDivs?: boolean;
+}
+export type VxTransform = (vxNode: VxNode) => VxNode;
+export declare class VxTreeParser {
+    options: VxTreeOptions;
+    private counter;
+    private viewport;
+    private refRange;
+    private vxNodes;
+    private probeElements;
+    private domRefMap;
+    constructor(options?: VxTreeOptions);
+    private parseDocument;
+    getTree(): VxTreeView;
+    getNodes(): VxNode[];
+    getRefRange(): [number, number];
+    getDomMap(): Map<number, Node>;
+    private parseNode;
+    private parseElement;
+    private makeNode;
+    private pruneRecursive;
+    private collapseSingleChild;
+    private collapsePreferParent;
+    private collapseMerge;
+    private shouldOmit;
+    private isProbeHit;
+    private collectLabelAttrs;
+    private collectValueAttrs;
+    private collectSrcAttrs;
+}

package/out/page/parser.js

@@ -0,0 +1,253 @@
+import { Counter } from './counter.js';
+import { fixZIndex, getViewportSize, hasVisibleArea, isInteractive, isRandomIdentifier, isRectInViewport, makeOverlaysOpaque, normalizeText, truncateAttrValue } from './dom.js';
+import { isHidden } from './dom.js';
+import { probeViewport } from './probe.js';
+import { VxTreeView } from './tree.js';
+import { isObjectEmpty } from './util.js';
+export const VX_NODE_SYMBOL = Symbol('vx:node');
+export const VX_IGNORE_SYMBOL = Symbol('vx:ignore');
+export const VX_IGNORE_TAGS = ['svg', 'script', 'noscript', 'style', 'link', 'meta'];
+export const VX_LABEL_ATTRS = ['title', 'alt', 'placeholder', 'aria-label'];
+export const VX_VALUE_ATTRS = ['value', 'checked', 'selected', 'disabled', 'readonly'];
+export const VX_SRC_ATTRS = ['src', 'href'];
+export const VX_TAG_PREFERENCE = [
+    'a', 'iframe', 'input', 'button', 'select', 'textarea', 'img', 'label',
+    'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
+    'ul', 'ol', 'li', 'dl', 'dt', 'dd',
+    'section', 'article', 'main', 'header', 'footer', 'nav', 'aside',
+    'form', 'input', 'textarea', 'select', 'option', 'fieldset', 'legend',
+    'p', 'pre', 'code', 'blockquote', 'figure', 'figcaption',
+    'table', 'thead', 'tbody', 'tr', 'td', 'th',
+    'strong', 'em', 'sub', 'sup',
+];
+const VX_KEEP_SELECTOR = 'a, button, input, textarea, select, label, iframe, option, optgroup';
+export class VxTreeParser {
+    constructor(options = {}) {
+        this.options = options;
+        this.probeElements = [];
+        this.domRefMap = new Map();
+        const { startRef = 0 } = options;
+        this.viewport = getViewportSize();
+        this.counter = new Counter(startRef);
+        if (options.probeViewport) {
+            this.probeElements = probeViewport(8);
+        }
+        const vxRoot = this.parseDocument();
+        this.refRange = [startRef, this.counter.current()];
+        this.vxNodes = this.pruneRecursive(vxRoot);
+    }
+    parseDocument() {
+        return this.parseNode(document.documentElement, null);
+    }
+    getTree() {
+        return new VxTreeView(this.vxNodes, this.refRange);
+    }
+    getNodes() {
+        return this.vxNodes;
+    }
+    getRefRange() {
+        return this.refRange;
+    }
+    getDomMap() {
+        return this.domRefMap;
+    }
+    parseNode(node, parent) {
+        if (!node || node[VX_IGNORE_SYMBOL]) {
+            return null;
+        }
+        if (node instanceof Text) {
+            // Single instances of Text nodes can only occur in "text"
+            // (e.g. when regular text is interspersed with links and other elements)
+            const textContent = normalizeText(node.textContent ?? '');
+            if (textContent) {
+                return this.makeNode(node, {
+                    textContent,
+                    hasVisibleArea: parent?.hasVisibleArea,
+                    isOutsideViewport: parent?.isOutsideViewport,
+                    isProbeHit: parent?.isProbeHit,
+                });
+            }
+            return null;
+        }
+        if (node instanceof Element) {
+            if (this.options.opaqueOverlays) {
+                makeOverlaysOpaque(node);
+            }
+            fixZIndex(node);
+            return this.parseElement(node);
+        }
+        return null;
+    }
+    parseElement(el) {
+        if (VX_IGNORE_TAGS.includes(el.tagName.toLowerCase())) {
+            return null;
+        }
+        if (isHidden(el)) {
+            return null;
+        }
+        const rect = el.getBoundingClientRect();
+        const id = el.getAttribute('id') ?? '';
+        const vxNode = this.makeNode(el, {
+            tagName: el.tagName.toLowerCase(),
+            id: isRandomIdentifier(id) ? undefined : id,
+            classList: Array.from(el.classList)
+                .filter(cls => !isRandomIdentifier(cls))
+                .slice(0, 4),
+            labelAttrs: this.collectLabelAttrs(el),
+            valueAttrs: this.collectValueAttrs(el),
+            srcAttrs: this.collectSrcAttrs(el),
+            hasVisibleArea: hasVisibleArea(el),
+            isInteractive: isInteractive(el),
+            isOutsideViewport: !isRectInViewport(rect, this.viewport),
+            isProbeHit: this.isProbeHit(el),
+            isKept: el.matches(VX_KEEP_SELECTOR),
+        });
+        const children = [...el.childNodes]
+            .map(child => this.parseNode(child, vxNode))
+            .filter(_ => _ != null);
+        // Special case: if the only child is a text node, return a single node with the text content
+        if (children.length === 1 && !children[0]?.tagName) {
+            vxNode.textContent = normalizeText(children[0].textContent ?? '');
+        }
+        else {
+            vxNode.children = children;
+        }
+        return vxNode;
+    }
+    makeNode(node, spec) {
+        const ref = this.counter.next();
+        const vxNode = {
+            ...spec,
+            ref,
+        };
+        this.domRefMap.set(ref, node);
+        node[VX_NODE_SYMBOL] = vxNode;
+        return vxNode;
+    }
+    pruneRecursive(vxNode) {
+        if (!vxNode) {
+            return [];
+        }
+        const children = vxNode.children ?? [];
+        // Recursively prune children
+        const newChildren = children.flatMap(child => this.pruneRecursive(child));
+        // If the node itself is omitted, replace it with children
+        if (this.shouldOmit(vxNode)) {
+            return newChildren;
+        }
+        vxNode.children = newChildren;
+        // Collapse single-child elements
+        if (newChildren.length === 1) {
+            const child = newChildren[0];
+            return this.collapseSingleChild(vxNode, child);
+        }
+        return [vxNode];
+    }
+    collapseSingleChild(parent, child) {
+        const preferParent = this.collapsePreferParent(parent, child);
+        const merged = preferParent ?
+            this.collapseMerge(parent, child) :
+            this.collapseMerge(child, parent);
+        return this.pruneRecursive({
+            ...merged,
+            children: child.children,
+            textContent: child.textContent,
+        });
+    }
+    collapsePreferParent(parent, child) {
+        const parentRank = VX_TAG_PREFERENCE.indexOf(parent.tagName ?? '');
+        const childRank = VX_TAG_PREFERENCE.indexOf(child.tagName ?? '');
+        if (parentRank === -1 && childRank === -1) {
+            const parentAttrCount = Object.keys({
+                ...parent.labelAttrs,
+                ...parent.valueAttrs,
+                ...parent.srcAttrs,
+            }).length;
+            const childAttrCount = Object.keys({
+                ...child.labelAttrs,
+                ...child.valueAttrs,
+                ...child.srcAttrs,
+            }).length;
+            return parentAttrCount > childAttrCount;
+        }
+        return parentRank !== -1 && (childRank === -1 || parentRank < childRank);
+    }
+    collapseMerge(a, b) {
+        return {
+            ...b,
+            ...a,
+            labelAttrs: { ...b.labelAttrs, ...a.labelAttrs },
+            valueAttrs: { ...b.valueAttrs, ...a.valueAttrs },
+            srcAttrs: { ...b.srcAttrs, ...a.srcAttrs },
+        };
+    }
+    shouldOmit(vxNode) {
+        const tagName = vxNode.tagName ?? '';
+        if (!vxNode.hasVisibleArea) {
+            return true;
+        }
+        if (this.options.viewportOnly && vxNode.isOutsideViewport) {
+            return true;
+        }
+        if (this.options.probeViewport && !vxNode.isProbeHit) {
+            return true;
+        }
+        if (this.options.skipImages && vxNode.tagName === 'img') {
+            return true;
+        }
+        const hasText = !!vxNode.textContent;
+        const hasChildren = (vxNode.children ?? []).length > 0;
+        const hasAttrs = [vxNode.labelAttrs, vxNode.valueAttrs, vxNode.srcAttrs]
+            .some(attrs => !isObjectEmpty(attrs ?? {}));
+        if (this.options.unnestDivs) {
+            const isDivOrSpan = ['div', 'span'].includes(tagName);
+            if (isDivOrSpan && hasChildren && !hasAttrs) {
+                return true;
+            }
+        }
+        if (vxNode.isKept) {
+            return false;
+        }
+        return !hasText && !hasAttrs && !hasChildren;
+    }
+    isProbeHit(el) {
+        // TODO this is a bit brute-forcish, consider improving
+        for (const probeEl of this.probeElements) {
+            if (el.contains(probeEl) || probeEl.contains(el)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    collectLabelAttrs(el) {
+        const attrs = {};
+        for (const attr of VX_LABEL_ATTRS) {
+            const value = truncateAttrValue(el.getAttribute(attr) ?? '');
+            if (value) {
+                attrs[attr] = value;
+            }
+        }
+        return attrs;
+    }
+    collectValueAttrs(el) {
+        const attrs = {};
+        for (const attr of VX_VALUE_ATTRS) {
+            const value = el[attr] ?? '';
+            if (value) {
+                attrs[attr] = String(value);
+            }
+        }
+        return attrs;
+    }
+    collectSrcAttrs(el) {
+        const attrs = {};
+        for (const attr of VX_SRC_ATTRS) {
+            const value = truncateAttrValue(el[attr] ?? '');
+            if (value) {
+                attrs[attr] = value;
+            }
+        }
+        return attrs;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/out/page/parser.js.map

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

package/out/page/probe.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scans the viewport by picking elements in regular intervals.
+ */
+export declare function probeViewport(gridSize?: number): Element[];
+export declare function checkOccluded(element: Element, gridSize?: number): boolean;

package/out/page/probe.js

@@ -0,0 +1,36 @@
+import { getViewportSize } from './dom.js';
+/**
+ * Scans the viewport by picking elements in regular intervals.
+ */
+export function probeViewport(gridSize = 32) {
+    const { width, height } = getViewportSize();
+    const elements = [];
+    for (let y = (gridSize / 2); y < height; y += gridSize) {
+        for (let x = (gridSize / 2); x < width; x += gridSize) {
+            const element = document.elementFromPoint(x, y);
+            if (element && !elements.includes(element)) {
+                elements.push(element);
+            }
+        }
+    }
+    return elements;
+}
+export function checkOccluded(element, gridSize = 8) {
+    let total = 0;
+    let hits = 0;
+    const { top, left, width, height } = element.getBoundingClientRect();
+    for (let x = left + (gridSize / 2); x < left + width; x += gridSize) {
+        for (let y = top + (gridSize / 2); y < top + height; y += gridSize) {
+            total++;
+            const el = document.elementFromPoint(x, y);
+            if (!el) {
+                continue;
+            }
+            if (element.contains(el) || el.contains(element)) {
+                hits++;
+            }
+        }
+    }
+    return (hits / total) < 0.5;
+}
+//# sourceMappingURL=probe.js.map

package/out/page/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/page/probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,EAAE;IACvC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrD,KAAK,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChD,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,QAAQ,GAAG,CAAC;IACxD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IACrE,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;QAClE,KAAK,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,MAAM,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;YACjE,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,EAAE,CAAC;gBACN,SAAS;YACb,CAAC;YACD,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/C,IAAI,EAAE,CAAC;YACX,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AAChC,CAAC"}

package/out/page/render.d.ts

@@ -0,0 +1,14 @@
+import { VxNode } from './parser.js';
+export interface VxRenderOptions {
+    renderStyle?: 'html' | 'text';
+    renderTagNames?: boolean;
+    renderIds?: boolean;
+    renderClassNames?: boolean;
+    renderRefs?: boolean | 'all';
+    renderLabelAttrs?: boolean;
+    renderValueAttrs?: boolean;
+    renderSrcAttrs?: boolean;
+    whitelistRefs?: number[];
+    skipNonInteractive?: boolean;
+}
+export declare function renderVxNode(scope: VxNode, options?: VxRenderOptions): string;

package/out/page/render.js

@@ -0,0 +1,89 @@
+import { truncateAttrValue } from './dom.js';
+import { traverseVxNode } from './traverse.js';
+import { isContainerNode } from './util.js';
+export function renderVxNode(scope, options = {}) {
+    const buffer = [];
+    const whitelistRefs = options.whitelistRefs ?? [];
+    for (const { vxNode, depth } of traverseVxNode(scope)) {
+        if (whitelistRefs.length > 0) {
+            if (!whitelistRefs.includes(vxNode.ref)) {
+                continue;
+            }
+        }
+        if (options.skipNonInteractive && !vxNode.isInteractive) {
+            continue;
+        }
+        const indent = options.skipNonInteractive ? '' : '    '.repeat(depth);
+        buffer.push(renderIndentedLine(indent, vxNode, options));
+    }
+    return buffer.join('\n');
+}
+function renderIndentedLine(indent, vxNode, options = {}) {
+    if (!vxNode.tagName) {
+        return [indent, vxNode.textContent].filter(Boolean).join('');
+    }
+    const tagLine = renderTagLine(vxNode, options);
+    const htmlStyle = options.renderStyle === 'html';
+    return [
+        indent,
+        tagLine,
+        htmlStyle ? '' : ' ',
+        vxNode.textContent ?? '',
+    ].join('');
+}
+function renderTagLine(vxNode, options) {
+    const htmlStyle = options.renderStyle === 'html';
+    const components = [];
+    if (options.renderTagNames && vxNode.tagName) {
+        components.push(vxNode.tagName);
+    }
+    if (options.renderIds && vxNode.id) {
+        if (htmlStyle) {
+            components.push(`id="${vxNode.id}"`);
+        }
+        else {
+            components.push(`#${vxNode.id}`);
+        }
+    }
+    if (options.renderClassNames && vxNode.classList?.length) {
+        if (htmlStyle) {
+            components.push(`class="${vxNode.classList.join(' ')}"`);
+        }
+        else {
+            components.push('.' + vxNode.classList.join('.'));
+        }
+    }
+    if (options.renderRefs) {
+        const isRenderRef = [
+            options.renderRefs === 'all',
+            options.renderRefs === true && !isContainerNode(vxNode),
+        ].some(Boolean);
+        if (isRenderRef) {
+            components.push(`[@${vxNode.ref}]`);
+        }
+    }
+    const attrs = [];
+    if (options.renderLabelAttrs) {
+        for (const [attr, value] of Object.entries(vxNode.labelAttrs ?? {})) {
+            attrs.push(`${attr}="${truncateAttrValue(value)}"`);
+        }
+    }
+    if (options.renderValueAttrs) {
+        for (const [attr, value] of Object.entries(vxNode.valueAttrs ?? {})) {
+            attrs.push(`${attr}="${truncateAttrValue(value)}"`);
+        }
+    }
+    if (options.renderSrcAttrs) {
+        for (const [attr, value] of Object.entries(vxNode.srcAttrs ?? {})) {
+            attrs.push(`${attr}="${truncateAttrValue(value)}"`);
+        }
+    }
+    if (htmlStyle) {
+        components.push(...attrs);
+    }
+    else {
+        components.push(...attrs.map(attr => `[${attr}]`));
+    }
+    return htmlStyle ? `<${components.join(' ')}>` : components.join('');
+}
+//# sourceMappingURL=render.js.map

package/out/page/render.js.map

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

package/out/page/snapshot.d.ts

@@ -0,0 +1,7 @@
+import { VxTreeOptions } from './parser.js';
+import { VxTreeView } from './tree.js';
+export declare const VX_DOM_SYMBOL: unique symbol;
+export declare const VX_TREE_SYMBOL: unique symbol;
+export declare function captureSnapshot(options?: VxTreeOptions): VxTreeView;
+export declare function getSnapshot(): VxTreeView;
+export declare function resolveDomNode(ref: number): Node | null;

package/out/page/snapshot.js

@@ -0,0 +1,26 @@
+import { VxTreeParser } from './parser.js';
+export const VX_DOM_SYMBOL = Symbol('vx:dom');
+export const VX_TREE_SYMBOL = Symbol('vx:tree');
+export function captureSnapshot(options = {}) {
+    const parser = new VxTreeParser(options);
+    const domMap = parser.getDomMap();
+    const vxTree = parser.getTree();
+    globalThis[VX_DOM_SYMBOL] = domMap;
+    globalThis[VX_TREE_SYMBOL] = vxTree;
+    return vxTree;
+}
+export function getSnapshot() {
+    const vxTree = globalThis[VX_TREE_SYMBOL];
+    if (!vxTree) {
+        throw new Error('[VX] Snapshot not found');
+    }
+    return vxTree;
+}
+export function resolveDomNode(ref) {
+    const domMap = globalThis[VX_DOM_SYMBOL];
+    if (!domMap) {
+        return null;
+    }
+    return domMap.get(ref) ?? null;
+}
+//# sourceMappingURL=snapshot.js.map

package/out/page/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/page/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAEhD,MAAM,UAAU,eAAe,CAAC,UAAyB,EAAE;IACvD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/B,UAAkB,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC;IAC3C,UAAkB,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;IAC7C,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW;IACvB,MAAM,MAAM,GAAI,UAAkB,CAAC,cAAc,CAAe,CAAC;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACtC,MAAM,MAAM,GAAI,UAAkB,CAAC,aAAa,CAAsB,CAAC;IACvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC"}

package/out/page/traverse.d.ts

@@ -0,0 +1,5 @@
+import { VxNode } from './parser.js';
+export declare function traverseVxNode(vxNode: VxNode, depth?: number): IterableIterator<{
+    vxNode: VxNode;
+    depth: number;
+}>;

package/out/page/traverse.js

@@ -0,0 +1,7 @@
+export function* traverseVxNode(vxNode, depth = 0) {
+    yield { vxNode, depth };
+    for (const child of vxNode.children ?? []) {
+        yield* traverseVxNode(child, depth + 1);
+    }
+}
+//# sourceMappingURL=traverse.js.map

package/out/page/traverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../../src/page/traverse.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,CAAC,CAAC,cAAc,CAAC,MAAc,EAAE,KAAK,GAAG,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACxB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC"}

package/out/page/tree.d.ts

@@ -0,0 +1,24 @@
+import { VxNode } from './parser.js';
+import { VxRenderOptions } from './render.js';
+export interface VxHighlightOptions {
+    highlight?: boolean;
+    clearOverlay?: boolean;
+    includeAll?: boolean;
+    filterRefs?: number[];
+}
+export declare class VxTreeView {
+    readonly nodes: VxNode[];
+    readonly refRange: [number, number];
+    private refMap;
+    constructor(nodes: VxNode[], refRange: [number, number]);
+    traverse(): IterableIterator<{
+        vxNode: VxNode;
+        depth: number;
+    }>;
+    private buildRefMap;
+    findNode(ref: number): VxNode | null;
+    render(options?: VxRenderOptions): string;
+    highlight(options?: VxHighlightOptions): number[];
+    highlightRefs(refs: number[]): void;
+    collectRefs(leafOnly?: boolean, filterRefs?: number[]): number[];
+}

package/out/page/tree.js

@@ -0,0 +1,68 @@
+import { clearOverlay, highlightEl } from './overlay.js';
+import { renderVxNode } from './render.js';
+import { resolveDomNode } from './snapshot.js';
+import { traverseVxNode } from './traverse.js';
+import { isContainerNode } from './util.js';
+export class VxTreeView {
+    constructor(nodes, refRange) {
+        this.nodes = nodes;
+        this.refRange = refRange;
+        this.refMap = new Map();
+        this.buildRefMap(nodes);
+    }
+    *traverse() {
+        for (const vxNode of this.nodes) {
+            yield* traverseVxNode(vxNode, 0);
+        }
+    }
+    buildRefMap(nodes) {
+        for (const node of nodes) {
+            this.refMap.set(node.ref, node);
+            this.buildRefMap(node.children ?? []);
+        }
+    }
+    findNode(ref) {
+        return this.refMap.get(ref) ?? null;
+    }
+    render(options = {}) {
+        return this.nodes.map(node => {
+            return renderVxNode(node, options);
+        }).join('\n');
+    }
+    highlight(options = {}) {
+        if (options.clearOverlay) {
+            clearOverlay();
+        }
+        const leafOnly = !options.includeAll;
+        const refs = this.collectRefs(leafOnly, options.filterRefs);
+        for (const ref of refs) {
+            const el = resolveDomNode(ref);
+            if (el instanceof Element) {
+                highlightEl(el, ref);
+            }
+        }
+        return refs;
+    }
+    highlightRefs(refs) {
+        for (const ref of refs) {
+            const el = resolveDomNode(ref);
+            if (el instanceof Element) {
+                highlightEl(el, ref);
+            }
+        }
+    }
+    collectRefs(leafOnly = true, filterRefs) {
+        const refs = [];
+        for (const { vxNode } of this.traverse()) {
+            if (leafOnly && isContainerNode(vxNode)) {
+                continue;
+            }
+            if (filterRefs && !filterRefs.includes(vxNode.ref)) {
+                continue;
+            }
+            refs.push(vxNode.ref);
+        }
+        return refs;
+    }
+}
+//# sourceMappingURL=tree.js.map

package/out/page/tree.js.map

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

package/out/page/util.d.ts

@@ -0,0 +1,3 @@
+import { VxNode } from './parser.js';
+export declare function isContainerNode(vxNode: VxNode): boolean;
+export declare function isObjectEmpty(obj: Record<string, any>): boolean;

package/out/page/util.js

@@ -0,0 +1,9 @@
+export function isContainerNode(vxNode) {
+    const children = vxNode.children ?? [];
+    const hasTextChildren = children.some(child => !child.tagName);
+    return children.length > 0 && !hasTextChildren;
+}
+export function isObjectEmpty(obj) {
+    return !Object.values(obj).some(value => !!value);
+}
+//# sourceMappingURL=util.js.map

package/out/page/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/page/util.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,MAAc;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAwB;IAClD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ubio/webvision",
-    "version": "2.3.0",
+    "version": "2.4.0",
     "main": "out/main/index.js",
     "type": "module",
     "exports": {