@ubio/webvision 1.2.6 → 2.1.0

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'];
+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));
+        }
+    }
+    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

@@ -1,5 +1,11 @@
-export * from './highlight.js';
-export * from './html.js';
+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 './utils.js';
+export * from './traverse.js';
+export * from './tree.js';
+export * from './util.js';

package/out/page/index.js

@@ -1,6 +1,12 @@
-export * from './highlight.js';
-export * from './html.js';
+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 './utils.js';
+export * from './traverse.js';
+export * from './tree.js';
+export * from './util.js';
 //# sourceMappingURL=index.js.map

package/out/page/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/page/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
+{"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,59 @@
+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;
+    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;
+}