@ubio/webvision 1.0.1

package/build/page.mjs

@@ -0,0 +1,267 @@
+// src/page/utils.ts
+function isHidden(element, options = {}) {
+  const {
+    checkOpacity = true,
+    checkVisibility = true,
+    checkTransform = true
+  } = options;
+  const style = getComputedStyle(element);
+  const opacity = Number(style.opacity);
+  const display = style.display;
+  const visibility = style.visibility;
+  const transform = style.transform;
+  if (display === "none" || checkOpacity && opacity < 0.1 || checkVisibility && visibility === "hidden" || checkTransform && transform.includes("scale(0)")) {
+    return true;
+  }
+  if (!element.checkVisibility()) {
+    return true;
+  }
+  return false;
+}
+function hasVisibleArea(element) {
+  const rect = element.getBoundingClientRect();
+  const area = rect.width * rect.height;
+  return area > 100;
+}
+function deepIsHidden(element, options = {}) {
+  if (isHidden(element, options)) {
+    return true;
+  }
+  if (!hasVisibleArea(element)) {
+    return [...element.children].every((el) => deepIsHidden(el, options));
+  }
+  return false;
+}
+function normalizeText(str) {
+  return str.replace(/\p{Cf}/gu, " ").replace(/\s+/g, " ").trim();
+}
+function containsImage(el) {
+  return el.matches("img") || !!el.querySelector("img");
+}
+function isRecursiveInline(el, ignoreTags = []) {
+  for (const child of el.childNodes) {
+    if (child instanceof Element) {
+      if (ignoreTags.includes(child.tagName.toLowerCase())) {
+        return false;
+      }
+      const display = getComputedStyle(child).display;
+      const inline = display === "inline" || display === "inline-block";
+      if (!inline) {
+        return false;
+      }
+      if (!isRecursiveInline(child, ignoreTags)) {
+        return false;
+      }
+    }
+  }
+  return true;
+}
+
+// src/page/snapshot.ts
+var DEFAULT_SKIP_TAGS = ["svg", "script", "noscript", "style", "link", "meta"];
+var DEFAULT_SEMANTIC_TAGS = [
+  "a",
+  "button",
+  "label",
+  "section",
+  "article",
+  "main",
+  "header",
+  "footer",
+  "nav",
+  "aside",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "ul",
+  "ol",
+  "li",
+  "dl",
+  "dt",
+  "dd",
+  "p",
+  "pre",
+  "code",
+  "blockquote",
+  "figure",
+  "figcaption",
+  "table",
+  "thead",
+  "tbody",
+  "tr",
+  "td",
+  "th",
+  "form",
+  "input",
+  "textarea",
+  "select",
+  "option",
+  "fieldset",
+  "legend",
+  "strong",
+  "em",
+  "sub",
+  "sup"
+];
+var DomSnapshot = class _DomSnapshot {
+  constructor(node, parent, options) {
+    this.node = node;
+    this.parent = parent;
+    this.children = [];
+    this.options = {
+      skipHidden: true,
+      skipEmptyText: true,
+      skipImages: false,
+      skipTags: DEFAULT_SKIP_TAGS,
+      tagPreference: DEFAULT_SEMANTIC_TAGS,
+      collapseInline: true,
+      ...options
+    };
+    this.classList = [...this.element?.classList ?? []];
+    if (this.element) {
+      this.parseTree(this.element);
+    }
+  }
+  get element() {
+    return this.node instanceof Element ? this.node : null;
+  }
+  get depth() {
+    return this.parent ? this.parent.depth + 1 : 0;
+  }
+  get inlineText() {
+    const text = this.node instanceof HTMLElement ? this.node.innerText : this.node.textContent;
+    return normalizeText(text ?? "");
+  }
+  get indent() {
+    return "  ".repeat(this.depth);
+  }
+  get isLeaf() {
+    return this.children.length === 0;
+  }
+  get tagName() {
+    return this.node instanceof Element ? this.node.tagName.toLowerCase() : "";
+  }
+  get href() {
+    return this.node instanceof HTMLAnchorElement ? this.node.href : "";
+  }
+  get src() {
+    return this.node instanceof HTMLImageElement ? this.node.src : "";
+  }
+  getFontSize() {
+    if (this.node instanceof Text) {
+      return this.parent?.getFontSize() ?? 0;
+    }
+    return Number(getComputedStyle(this.node).fontSize?.replace("px", ""));
+  }
+  getTextSize(rootFontSize) {
+    const ownFontSize = this.getFontSize();
+    if (ownFontSize > 1.2 * rootFontSize) {
+      return "large";
+    }
+    if (ownFontSize < 0.85 * rootFontSize) {
+      return "small";
+    }
+    return "normal";
+  }
+  parseTree(el) {
+    this.children = [];
+    const childNodes = this.getAcceptedChildren(el);
+    if (childNodes.length === 1) {
+      return this.collapseWrapper(el, childNodes[0]);
+    }
+    if (this.options.collapseInline && isRecursiveInline(el, this.options.tagPreference)) {
+      return;
+    }
+    for (const childNode of childNodes) {
+      const snapshot = new _DomSnapshot(childNode, this, this.options);
+      this.children.push(snapshot);
+    }
+  }
+  /**
+   * Collapses an element with only one visible child into one.
+   *
+   * Wrapper element is preferred if it's a link or a button,
+   * in other cases child element is preferred.
+   */
+  collapseWrapper(el, child) {
+    if (child instanceof Text) {
+      return;
+    }
+    this.classList.push(...child.classList);
+    const parentRank = this.options.tagPreference.indexOf(el.tagName.toLowerCase());
+    const childRank = this.options.tagPreference.indexOf(child.tagName.toLowerCase());
+    const preferParent = parentRank !== -1 && parentRank < childRank;
+    if (!preferParent) {
+      this.node = child;
+    }
+    this.parseTree(child);
+  }
+  getAcceptedChildren(el) {
+    const childNodes = [...el.childNodes];
+    return childNodes.filter((node) => {
+      if (!(node instanceof Element || node instanceof Text)) {
+        return false;
+      }
+      if (node instanceof Element) {
+        if (this.options.skipHidden && deepIsHidden(node, { checkOpacity: false })) {
+          return false;
+        }
+        if (!this.options.skipImages && containsImage(node)) {
+          return true;
+        }
+        if (this.options.skipTags.includes(node.tagName.toLowerCase())) {
+          return false;
+        }
+      }
+      if (this.options.skipEmptyText) {
+        const isEmptyText = normalizeText(node.textContent ?? "").length === 0;
+        if (isEmptyText) {
+          return false;
+        }
+      }
+      return true;
+    });
+  }
+  toIndentedText() {
+    const buffer = [
+      this.renderLine()
+    ];
+    for (const child of this.children) {
+      buffer.push(child.toIndentedText());
+    }
+    return buffer.join("\n");
+  }
+  renderLine() {
+    const indent = "  ".repeat(this.depth);
+    const components = [indent];
+    if (this.node instanceof Text) {
+      return [indent, this.inlineText].filter(Boolean).join(" ");
+    }
+    const { tagName, src, href } = this;
+    components.push(tagName);
+    if (src) {
+      components.push(`(${src})`);
+    }
+    if (href) {
+      components.push(`(${href})`);
+    }
+    if (this.isLeaf) {
+      components.push(" " + this.inlineText);
+    }
+    return components.filter(Boolean).join("");
+  }
+};
+export {
+  DEFAULT_SEMANTIC_TAGS,
+  DEFAULT_SKIP_TAGS,
+  DomSnapshot,
+  containsImage,
+  deepIsHidden,
+  hasVisibleArea,
+  isHidden,
+  isRecursiveInline,
+  normalizeText
+};

package/out/page/index.d.ts

@@ -0,0 +1,2 @@
+export * from './snapshot.js';
+export * from './utils.js';

package/out/page/index.js

@@ -0,0 +1,3 @@
+export * from './snapshot.js';
+export * from './utils.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,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/out/page/snapshot.d.ts

@@ -0,0 +1,39 @@
+export declare const DEFAULT_SKIP_TAGS: string[];
+export declare const DEFAULT_SEMANTIC_TAGS: string[];
+export interface DomSnapshotOptions {
+    skipHidden: boolean;
+    skipImages: boolean;
+    skipEmptyText: boolean;
+    skipTags: string[];
+    tagPreference: string[];
+    collapseInline: boolean;
+}
+export declare class DomSnapshot {
+    node: Element | Text;
+    parent: DomSnapshot | null;
+    options: DomSnapshotOptions;
+    classList: string[];
+    children: DomSnapshot[];
+    constructor(node: Element | Text, parent: DomSnapshot | null, options: Partial<DomSnapshotOptions>);
+    get element(): Element | null;
+    get depth(): number;
+    get inlineText(): string;
+    get indent(): string;
+    get isLeaf(): boolean;
+    get tagName(): string;
+    get href(): string;
+    get src(): string;
+    getFontSize(): number;
+    getTextSize(rootFontSize: number): "large" | "small" | "normal";
+    private parseTree;
+    /**
+     * Collapses an element with only one visible child into one.
+     *
+     * Wrapper element is preferred if it's a link or a button,
+     * in other cases child element is preferred.
+     */
+    private collapseWrapper;
+    private getAcceptedChildren;
+    toIndentedText(): string;
+    renderLine(): string;
+}

package/out/page/snapshot.js

@@ -0,0 +1,171 @@
+import { containsImage, deepIsHidden, isRecursiveInline, normalizeText } from './utils.js';
+export const DEFAULT_SKIP_TAGS = ['svg', 'script', 'noscript', 'style', 'link', 'meta'];
+export const DEFAULT_SEMANTIC_TAGS = [
+    'a', 'button', 'label', 'section',
+    'article', 'main', 'header', 'footer', 'nav', 'aside',
+    'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
+    'ul', 'ol', 'li', 'dl', 'dt', 'dd',
+    'p', 'pre', 'code', 'blockquote', 'figure', 'figcaption',
+    'table', 'thead', 'tbody', 'tr', 'td', 'th',
+    'form', 'input', 'textarea', 'select', 'option', 'fieldset', 'legend',
+    'strong', 'em', 'sub', 'sup',
+];
+export class DomSnapshot {
+    constructor(node, parent, options) {
+        this.node = node;
+        this.parent = parent;
+        this.children = [];
+        this.options = {
+            skipHidden: true,
+            skipEmptyText: true,
+            skipImages: false,
+            skipTags: DEFAULT_SKIP_TAGS,
+            tagPreference: DEFAULT_SEMANTIC_TAGS,
+            collapseInline: true,
+            ...options,
+        };
+        this.classList = [...(this.element?.classList ?? [])];
+        if (this.element) {
+            this.parseTree(this.element);
+        }
+    }
+    get element() {
+        return this.node instanceof Element ? this.node : null;
+    }
+    get depth() {
+        return this.parent ? this.parent.depth + 1 : 0;
+    }
+    get inlineText() {
+        const text = this.node instanceof HTMLElement ?
+            this.node.innerText :
+            this.node.textContent;
+        return normalizeText(text ?? '');
+    }
+    get indent() {
+        return '  '.repeat(this.depth);
+    }
+    get isLeaf() {
+        return this.children.length === 0;
+    }
+    get tagName() {
+        return this.node instanceof Element ? this.node.tagName.toLowerCase() : '';
+    }
+    get href() {
+        return this.node instanceof HTMLAnchorElement ? this.node.href : '';
+    }
+    get src() {
+        return this.node instanceof HTMLImageElement ? this.node.src : '';
+    }
+    getFontSize() {
+        if (this.node instanceof Text) {
+            return this.parent?.getFontSize() ?? 0;
+        }
+        return Number(getComputedStyle(this.node).fontSize?.replace('px', ''));
+    }
+    getTextSize(rootFontSize) {
+        const ownFontSize = this.getFontSize();
+        if (ownFontSize > 1.2 * rootFontSize) {
+            return 'large';
+        }
+        if (ownFontSize < 0.85 * rootFontSize) {
+            return 'small';
+        }
+        return 'normal';
+    }
+    parseTree(el) {
+        this.children = [];
+        const childNodes = this.getAcceptedChildren(el);
+        if (childNodes.length === 1) {
+            return this.collapseWrapper(el, childNodes[0]);
+        }
+        if (this.options.collapseInline && isRecursiveInline(el, this.options.tagPreference)) {
+            // Do not process more children
+            return;
+        }
+        for (const childNode of childNodes) {
+            const snapshot = new DomSnapshot(childNode, this, this.options);
+            this.children.push(snapshot);
+        }
+    }
+    /**
+     * Collapses an element with only one visible child into one.
+     *
+     * Wrapper element is preferred if it's a link or a button,
+     * in other cases child element is preferred.
+     */
+    collapseWrapper(el, child) {
+        if (child instanceof Text) {
+            return;
+        }
+        this.classList.push(...child.classList);
+        const parentRank = this.options.tagPreference.indexOf(el.tagName.toLowerCase());
+        const childRank = this.options.tagPreference.indexOf(child.tagName.toLowerCase());
+        const preferParent = parentRank !== -1 && (parentRank < childRank);
+        if (!preferParent) {
+            this.node = child;
+        }
+        // Continue parsing child element
+        this.parseTree(child);
+    }
+    getAcceptedChildren(el) {
+        const childNodes = [...el.childNodes];
+        return childNodes.filter((node) => {
+            // Ignore non-text and non-HTML nodes
+            if (!(node instanceof Element || node instanceof Text)) {
+                return false;
+            }
+            if (node instanceof Element) {
+                // Skip hidden elements (opacity, display, visibility, etc)
+                // TODO checkOpacity breaks PDF viewer
+                if (this.options.skipHidden && deepIsHidden(node, { checkOpacity: false })) {
+                    return false;
+                }
+                // Do not skip images even if other criteria are met
+                if (!this.options.skipImages && containsImage(node)) {
+                    return true;
+                }
+                // Skip listed tags
+                if (this.options.skipTags.includes(node.tagName.toLowerCase())) {
+                    return false;
+                }
+            }
+            // Skip nodes with empty text
+            if (this.options.skipEmptyText) {
+                const isEmptyText = normalizeText(node.textContent ?? '').length === 0;
+                if (isEmptyText) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    toIndentedText() {
+        const buffer = [
+            this.renderLine(),
+        ];
+        for (const child of this.children) {
+            buffer.push(child.toIndentedText());
+        }
+        return buffer.join('\n');
+    }
+    renderLine() {
+        const indent = '  '.repeat(this.depth);
+        const components = [indent];
+        if (this.node instanceof Text) {
+            return [indent, this.inlineText].filter(Boolean).join(' ');
+        }
+        const { tagName, src, href } = this;
+        components.push(tagName);
+        if (src) {
+            components.push(`(${src})`);
+        }
+        if (href) {
+            components.push(`(${href})`);
+        }
+        if (this.isLeaf) {
+            components.push(' ' + this.inlineText);
+        }
+        return components.filter(Boolean).join('');
+    }
+}
+//# 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":"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"}

package/out/page/utils.d.ts

@@ -0,0 +1,19 @@
+export interface VisibilityOptions {
+    checkOpacity: boolean;
+    checkVisibility: boolean;
+    checkTransform: boolean;
+}
+/**
+ * Element not visible with descendants if:
+ *
+ *   - opacity < 0.1
+ *   - display: none
+ *   - visibility: hidden
+ *   - transform: scale(0)
+ */
+export declare function isHidden(element: Element, options?: Partial<VisibilityOptions>): boolean;
+export declare function hasVisibleArea(element: Element): boolean;
+export declare function deepIsHidden(element: Element, options?: Partial<VisibilityOptions>): boolean;
+export declare function normalizeText(str: string): string;
+export declare function containsImage(el: Element): boolean;
+export declare function isRecursiveInline(el: Element, ignoreTags?: string[]): boolean;

package/out/page/utils.js

@@ -0,0 +1,68 @@
+/**
+ * Element not visible with descendants if:
+ *
+ *   - opacity < 0.1
+ *   - display: none
+ *   - visibility: hidden
+ *   - transform: scale(0)
+ */
+export function isHidden(element, options = {}) {
+    const { checkOpacity = true, checkVisibility = true, checkTransform = true, } = options;
+    const style = getComputedStyle(element);
+    const opacity = Number(style.opacity);
+    const display = style.display;
+    const visibility = style.visibility;
+    const transform = style.transform;
+    if (display === 'none' ||
+        (checkOpacity && opacity < 0.1) ||
+        (checkVisibility && (visibility === 'hidden')) ||
+        (checkTransform && transform.includes('scale(0)'))) {
+        return true;
+    }
+    if (!element.checkVisibility()) {
+        return true;
+    }
+    return false;
+}
+export function hasVisibleArea(element) {
+    const rect = element.getBoundingClientRect();
+    const area = rect.width * rect.height;
+    return area > 100;
+}
+export function deepIsHidden(element, options = {}) {
+    if (isHidden(element, options)) {
+        return true;
+    }
+    if (!hasVisibleArea(element)) {
+        return [...element.children].every(el => deepIsHidden(el, options));
+    }
+    return false;
+}
+export function normalizeText(str) {
+    return str
+        .replace(/\p{Cf}/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export function containsImage(el) {
+    return el.matches('img') || !!el.querySelector('img');
+}
+export function isRecursiveInline(el, ignoreTags = []) {
+    for (const child of el.childNodes) {
+        if (child instanceof Element) {
+            if (ignoreTags.includes(child.tagName.toLowerCase())) {
+                return false;
+            }
+            const display = getComputedStyle(child).display;
+            const inline = display === 'inline' || display === 'inline-block';
+            if (!inline) {
+                return false;
+            }
+            if (!isRecursiveInline(child, ignoreTags)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=utils.js.map

package/out/page/utils.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+    "name": "@ubio/webvision",
+    "version": "1.0.1",
+    "main": "out/main/index.js",
+    "type": "module",
+    "exports": {
+        "./page": "./out/page/index.js"
+    },
+    "files": [
+        "out/main",
+        "out/page",
+        "build/page.mjs"
+    ],
+    "scripts": {
+        "clean": "rm -rf out *.tsbuildinfo",
+        "dev": "npm run clean && tsc -b -w",
+        "compile": "npm run clean && tsc -b",
+        "compile:page": "esbuild src/page/index.ts --bundle --outfile=build/page.mjs --target=es2022 --format=esm",
+        "lint": "eslint --cache",
+        "test": "NODE_ENV=test mocha",
+        "version": "npm run compile",
+        "postversion": "npm publish --access=public && git push --tags origin main"
+    },
+    "pre-commit": [
+        "lint",
+        "compile",
+        "compile:page"
+    ],
+    "license": "ISC",
+    "devDependencies": {
+        "@nodescript/eslint-config": "^2.1.0",
+        "@types/node": "^22.13.1",
+        "esbuild": "^0.25.0",
+        "eslint": "^9.19.0",
+        "playwright": "^1.50.1",
+        "pre-commit": "^1.2.2",
+        "typescript": "^5.7.3"
+    }
+}