html2canvas-pro 2.4.4 → 2.5.0

package/dist/lib/core/config-assembler.js

@@ -1,88 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assembleRenderOptions = exports.assembleCloneOptions = exports.assembleWindowOptions = exports.assembleContextOptions = exports.assembleResourceOptions = exports.coerceNumberOptions = void 0;
-const constants_1 = require("./constants");
-/**
- * Coerce known numeric options from string (or other) values to actual numbers.
- * Mutates the opts object in place — this is intentionally a normalisation
- * (not pure) step that runs once at the beginning of renderElement.
- */
-const coerceNumberOptions = (opts) => {
-    const numKeys = [
-        'scale',
-        'width',
-        'height',
-        'imageTimeout',
-        'x',
-        'y',
-        'windowWidth',
-        'windowHeight',
-        'scrollX',
-        'scrollY'
-    ];
-    numKeys.forEach((key) => {
-        const v = opts[key];
-        if (v !== undefined && v !== null && typeof v !== 'number') {
-            const n = Number(v);
-            if (!Number.isNaN(n)) {
-                opts[key] = n;
-            }
-        }
-    });
-};
-exports.coerceNumberOptions = coerceNumberOptions;
-/** Assemble resource loading options from user-provided Options. */
-const assembleResourceOptions = (opts) => ({
-    allowTaint: opts.allowTaint ?? false,
-    imageTimeout: opts.imageTimeout ?? constants_1.DEFAULT_IMAGE_TIMEOUT_MS,
-    proxy: opts.proxy,
-    useCORS: opts.useCORS ?? false,
-    customIsSameOrigin: opts.customIsSameOrigin,
-    maxCacheSize: opts.maxCacheSize
-});
-exports.assembleResourceOptions = assembleResourceOptions;
-/** Assemble context (logging + cache) options, extending resource options. */
-const assembleContextOptions = (opts, config, resourceOptions) => ({
-    logging: opts.logging ?? true,
-    cache: opts.cache ?? config.cache,
-    ...resourceOptions
-});
-exports.assembleContextOptions = assembleContextOptions;
-const DEFAULT_WINDOW_WIDTH = 800;
-const DEFAULT_WINDOW_HEIGHT = 600;
-const DEFAULT_SCROLL = 0;
-const assembleWindowOptions = (opts, defaultView) => {
-    const win = defaultView;
-    return {
-        windowWidth: opts.windowWidth ?? win.innerWidth ?? DEFAULT_WINDOW_WIDTH,
-        windowHeight: opts.windowHeight ?? win.innerHeight ?? DEFAULT_WINDOW_HEIGHT,
-        scrollX: opts.scrollX ?? win.pageXOffset ?? DEFAULT_SCROLL,
-        scrollY: opts.scrollY ?? win.pageYOffset ?? DEFAULT_SCROLL
-    };
-};
-exports.assembleWindowOptions = assembleWindowOptions;
-/** Assemble DOM cloning options. */
-const assembleCloneOptions = (opts, config, foreignObjectRendering) => ({
-    allowTaint: opts.allowTaint ?? false,
-    onclone: opts.onclone,
-    ignoreElements: opts.ignoreElements,
-    iframeContainer: opts.iframeContainer,
-    inlineImages: foreignObjectRendering,
-    copyStyles: foreignObjectRendering,
-    cspNonce: opts.cspNonce ?? config.cspNonce
-});
-exports.assembleCloneOptions = assembleCloneOptions;
-/** Assemble canvas rendering options. */
-const assembleRenderOptions = (opts, backgroundColor, left, top, width, height, devicePixelRatio) => ({
-    canvas: opts.canvas,
-    backgroundColor,
-    signal: opts.signal,
-    scale: opts.scale ?? devicePixelRatio ?? 1,
-    x: (opts.x ?? 0) + left,
-    y: (opts.y ?? 0) + top,
-    width: opts.width ?? Math.ceil(width),
-    height: opts.height ?? Math.ceil(height),
-    imageSmoothing: opts.imageSmoothing,
-    imageSmoothingQuality: opts.imageSmoothingQuality
-});
-exports.assembleRenderOptions = assembleRenderOptions;

package/dist/lib/core/constants.js

@@ -1,25 +0,0 @@
-"use strict";
-/**
- * Shared numeric constants used across html2canvas-pro.
- * Centralising magic numbers for maintainability.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESOURCE_KEY_LOG_LENGTH = exports.INLINE_IMAGE_RESOLVE_DELAY_MS = exports.IFRAME_READY_POLL_MS = exports.SHADOW_MASK_OFFSET = exports.DEFAULT_IMAGE_TIMEOUT_MS = exports.MAX_IMAGE_CACHE_SIZE = exports.DEFAULT_IMAGE_CACHE_SIZE = exports.PATTERN_CACHE_MAX = exports.PARSE_CACHE_MAX_PER_DESCRIPTOR = void 0;
-/** Maximum entries in the CSS parse cache per descriptor (LRU). */
-exports.PARSE_CACHE_MAX_PER_DESCRIPTOR = 200;
-/** Maximum cached background-image patterns per render session (LRU). */
-exports.PATTERN_CACHE_MAX = 50;
-/** Maximum size of the image-resource cache (entries). */
-exports.DEFAULT_IMAGE_CACHE_SIZE = 100;
-/** Maximum allowed image-resource cache size. */
-exports.MAX_IMAGE_CACHE_SIZE = 10000;
-/** Default image-load timeout in milliseconds. */
-exports.DEFAULT_IMAGE_TIMEOUT_MS = 15000;
-/** Z-axis mask offset used during box-shadow rendering. */
-exports.SHADOW_MASK_OFFSET = 10000;
-/** Polling interval (ms) when waiting for the cloned iframe to become ready. */
-exports.IFRAME_READY_POLL_MS = 50;
-/** Deferred resolution delay (ms) for inline XML images that may fail to parse. */
-exports.INLINE_IMAGE_RESOLVE_DELAY_MS = 500;
-/** Maximum characters logged for image/resource keys. */
-exports.RESOURCE_KEY_LOG_LENGTH = 256;

package/dist/lib/core/context.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Context = void 0;
-const logger_1 = require("./logger");
-const cache_storage_1 = require("./cache-storage");
-const origin_checker_1 = require("./origin-checker");
-class Context {
-    constructor(options, windowBounds, config) {
-        this.windowBounds = windowBounds;
-        this.instanceName = `#${Context.instanceCount++}`;
-        this.config = config;
-        this.logger = new logger_1.Logger({ id: this.instanceName, enabled: options.logging });
-        this.originChecker = new origin_checker_1.OriginChecker(config.window);
-        this.cache = options.cache ?? config.cache ?? new cache_storage_1.Cache(this, options);
-        this.onError = options.onError;
-    }
-}
-exports.Context = Context;
-Context.instanceCount = 1;

package/dist/lib/core/debugger.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDebugging = void 0;
-const elementDebuggerAttribute = 'data-html2canvas-debug';
-const getElementDebugType = (element) => {
-    if (typeof element.getAttribute !== 'function') {
-        return 0 /* DebuggerType.NONE */;
-    }
-    const attribute = element.getAttribute(elementDebuggerAttribute);
-    switch (attribute) {
-        case 'all':
-            return 1 /* DebuggerType.ALL */;
-        case 'clone':
-            return 2 /* DebuggerType.CLONE */;
-        case 'parse':
-            return 3 /* DebuggerType.PARSE */;
-        case 'render':
-            return 4 /* DebuggerType.RENDER */;
-        default:
-            return 0 /* DebuggerType.NONE */;
-    }
-};
-const isDebugging = (element, type) => {
-    const elementType = getElementDebugType(element);
-    return elementType === 1 /* DebuggerType.ALL */ || type === elementType;
-};
-exports.isDebugging = isDebugging;

package/dist/lib/core/features.js

@@ -1,190 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FEATURES = exports.loadSerializedSVG = exports.createForeignObjectSVG = void 0;
-const css_line_break_1 = require("css-line-break");
-const testRangeBounds = (document) => {
-    const TEST_HEIGHT = 123;
-    if (document.createRange) {
-        const range = document.createRange();
-        if (range.getBoundingClientRect) {
-            const testElement = document.createElement('boundtest');
-            testElement.style.height = `${TEST_HEIGHT}px`;
-            testElement.style.display = 'block';
-            document.body.appendChild(testElement);
-            range.selectNode(testElement);
-            const rangeBounds = range.getBoundingClientRect();
-            const rangeHeight = Math.round(rangeBounds.height);
-            document.body.removeChild(testElement);
-            if (rangeHeight === TEST_HEIGHT) {
-                return true;
-            }
-        }
-    }
-    return false;
-};
-const testIOSLineBreak = (document) => {
-    const testElement = document.createElement('boundtest');
-    testElement.style.width = '50px';
-    testElement.style.display = 'block';
-    testElement.style.fontSize = '12px';
-    testElement.style.letterSpacing = '0px';
-    testElement.style.wordSpacing = '0px';
-    document.body.appendChild(testElement);
-    const range = document.createRange();
-    testElement.innerHTML = typeof ''.repeat === 'function' ? '👨'.repeat(10) : '';
-    const node = testElement.firstChild;
-    const textList = (0, css_line_break_1.toCodePoints)(node.data).map((i) => (0, css_line_break_1.fromCodePoint)(i));
-    let offset = 0;
-    let prev = {};
-    // ios 13 does not handle range getBoundingClientRect line changes correctly #2177
-    const supports = textList.every((text, i) => {
-        range.setStart(node, offset);
-        range.setEnd(node, offset + text.length);
-        const rect = range.getBoundingClientRect();
-        offset += text.length;
-        const boundAhead = rect.x > prev.x || rect.y > prev.y;
-        prev = rect;
-        if (i === 0) {
-            return true;
-        }
-        return boundAhead;
-    });
-    document.body.removeChild(testElement);
-    return supports;
-};
-const testCORS = () => typeof new Image().crossOrigin !== 'undefined';
-const testResponseType = () => typeof new XMLHttpRequest().responseType === 'string';
-const testSVG = (document) => {
-    const img = new Image();
-    const canvas = document.createElement('canvas');
-    const ctx = canvas.getContext('2d');
-    if (!ctx) {
-        return false;
-    }
-    img.src = `data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg'></svg>`;
-    try {
-        ctx.drawImage(img, 0, 0);
-        canvas.toDataURL();
-    }
-    catch (e) {
-        return false;
-    }
-    return true;
-};
-const isGreenPixel = (data) => data[0] === 0 && data[1] === 255 && data[2] === 0 && data[3] === 255;
-const testForeignObject = (document) => {
-    const canvas = document.createElement('canvas');
-    const size = 100;
-    canvas.width = size;
-    canvas.height = size;
-    const ctx = canvas.getContext('2d');
-    if (!ctx) {
-        return Promise.reject(new Error('Failed to get 2D rendering context'));
-    }
-    ctx.fillStyle = 'rgb(0, 255, 0)';
-    ctx.fillRect(0, 0, size, size);
-    const img = new Image();
-    const greenImageSrc = canvas.toDataURL();
-    img.src = greenImageSrc;
-    const svg = (0, exports.createForeignObjectSVG)(size, size, 0, 0, img);
-    ctx.fillStyle = 'red';
-    ctx.fillRect(0, 0, size, size);
-    return (0, exports.loadSerializedSVG)(svg)
-        .then((img) => {
-        ctx.drawImage(img, 0, 0);
-        const data = ctx.getImageData(0, 0, size, size).data;
-        ctx.fillStyle = 'red';
-        ctx.fillRect(0, 0, size, size);
-        const node = document.createElement('div');
-        node.style.backgroundImage = `url(${greenImageSrc})`;
-        node.style.height = `${size}px`;
-        // Firefox 55 does not render inline <img /> tags
-        return isGreenPixel(data)
-            ? (0, exports.loadSerializedSVG)((0, exports.createForeignObjectSVG)(size, size, 0, 0, node))
-            : Promise.reject(new Error('ForeignObject rendering not supported'));
-    })
-        .then((img) => {
-        ctx.drawImage(img, 0, 0);
-        // Edge does not render background-images
-        return isGreenPixel(ctx.getImageData(0, 0, size, size).data);
-    })
-        .catch(() => false);
-};
-const createForeignObjectSVG = (width, height, x, y, node) => {
-    const xmlns = 'http://www.w3.org/2000/svg';
-    const svg = document.createElementNS(xmlns, 'svg');
-    const foreignObject = document.createElementNS(xmlns, 'foreignObject');
-    svg.setAttributeNS(null, 'width', width.toString());
-    svg.setAttributeNS(null, 'height', height.toString());
-    foreignObject.setAttributeNS(null, 'width', '100%');
-    foreignObject.setAttributeNS(null, 'height', '100%');
-    foreignObject.setAttributeNS(null, 'x', x.toString());
-    foreignObject.setAttributeNS(null, 'y', y.toString());
-    foreignObject.setAttributeNS(null, 'externalResourcesRequired', 'true');
-    svg.appendChild(foreignObject);
-    foreignObject.appendChild(node);
-    return svg;
-};
-exports.createForeignObjectSVG = createForeignObjectSVG;
-const loadSerializedSVG = (svg) => {
-    return new Promise((resolve, reject) => {
-        const img = new Image();
-        img.onload = () => resolve(img);
-        img.onerror = reject;
-        img.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(new XMLSerializer().serializeToString(svg))}`;
-    });
-};
-exports.loadSerializedSVG = loadSerializedSVG;
-exports.FEATURES = {
-    get SUPPORT_RANGE_BOUNDS() {
-        'use strict';
-        const value = testRangeBounds(document);
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_RANGE_BOUNDS', { value });
-        return value;
-    },
-    get SUPPORT_WORD_BREAKING() {
-        'use strict';
-        const value = exports.FEATURES.SUPPORT_RANGE_BOUNDS && testIOSLineBreak(document);
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_WORD_BREAKING', { value });
-        return value;
-    },
-    get SUPPORT_SVG_DRAWING() {
-        'use strict';
-        const value = testSVG(document);
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_SVG_DRAWING', { value });
-        return value;
-    },
-    get SUPPORT_FOREIGNOBJECT_DRAWING() {
-        'use strict';
-        const value = typeof Array.from === 'function' && typeof window.fetch === 'function'
-            ? testForeignObject(document)
-            : Promise.resolve(false);
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_FOREIGNOBJECT_DRAWING', { value });
-        return value;
-    },
-    get SUPPORT_CORS_IMAGES() {
-        'use strict';
-        const value = testCORS();
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_CORS_IMAGES', { value });
-        return value;
-    },
-    get SUPPORT_RESPONSE_TYPE() {
-        'use strict';
-        const value = testResponseType();
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_RESPONSE_TYPE', { value });
-        return value;
-    },
-    get SUPPORT_CORS_XHR() {
-        'use strict';
-        const value = 'withCredentials' in new XMLHttpRequest();
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_CORS_XHR', { value });
-        return value;
-    },
-    get SUPPORT_NATIVE_TEXT_SEGMENTATION() {
-        'use strict';
-        // Intl.Segmenter is TC39 Stage 4 but not yet in TS lib types
-        const value = !!(typeof Intl !== 'undefined' && Intl.Segmenter);
-        Object.defineProperty(exports.FEATURES, 'SUPPORT_NATIVE_TEXT_SEGMENTATION', { value });
-        return value;
-    }
-};

package/dist/lib/core/logger.js

@@ -1,56 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = void 0;
-class Logger {
-    constructor({ id, enabled }) {
-        this.id = id;
-        this.enabled = enabled;
-        this.start = Date.now();
-    }
-    debug(...args) {
-        if (this.enabled) {
-            // eslint-disable-next-line no-console
-            if (typeof window !== 'undefined' && window.console && typeof console.debug === 'function') {
-                // eslint-disable-next-line no-console
-                console.debug(this.id, `${this.getTime()}ms`, ...args);
-            }
-            else {
-                this.info(...args);
-            }
-        }
-    }
-    getTime() {
-        return Date.now() - this.start;
-    }
-    info(...args) {
-        if (this.enabled) {
-            // eslint-disable-next-line no-console
-            if (typeof window !== 'undefined' && window.console && typeof console.info === 'function') {
-                // eslint-disable-next-line no-console
-                console.info(this.id, `${this.getTime()}ms`, ...args);
-            }
-        }
-    }
-    warn(...args) {
-        if (this.enabled) {
-            if (typeof window !== 'undefined' && window.console && typeof console.warn === 'function') {
-                console.warn(this.id, `${this.getTime()}ms`, ...args);
-            }
-            else {
-                this.info(...args);
-            }
-        }
-    }
-    error(...args) {
-        if (this.enabled) {
-            if (typeof window !== 'undefined' && window.console && typeof console.error === 'function') {
-                console.error(this.id, `${this.getTime()}ms`, ...args);
-            }
-            else {
-                this.info(...args);
-            }
-        }
-    }
-}
-exports.Logger = Logger;
-Logger.instances = {};

package/dist/lib/core/lru-map.js

@@ -1,66 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LRUMap = void 0;
-/**
- * Generic LRU (Least-Recently-Used) wrapper over a native `Map`.
- *
- * Both the CSS parse cache and the background pattern cache implement the
- * same LRU eviction pattern using Map's insertion-order guarantee.  This
- * tiny utility centralises that logic so it can be reused without
- * duplication.
- *
- * Usage:
- * ```ts
- * const cache = new LRUMap<string, CanvasPattern>(50);
- * const entry = cache.get(key); // promotes if found, returns undefined otherwise
- * cache.set(key, value);         // evicts oldest entry when at capacity
- * ```
- */
-class LRUMap {
-    constructor(maxSize) {
-        this.maxSize = maxSize;
-        this._map = new Map();
-    }
-    /**
-     * Get a value by key.
-     * On cache hit the entry is promoted to the end of the Map (most-recently-used).
-     * Returns `undefined` on miss.
-     */
-    get(key) {
-        if (!this._map.has(key)) {
-            return undefined;
-        }
-        // Delete-then-set promotes the entry to MRU position.
-        const value = this._map.get(key);
-        this._map.delete(key);
-        this._map.set(key, value);
-        return value;
-    }
-    /**
-     * Insert or update a key-value pair.
-     * If the key already exists it is moved to MRU position.  If the map is
-     * at capacity the least-recently-used entry (oldest insertion order) is
-     * evicted before inserting.
-     */
-    set(key, value) {
-        if (this._map.has(key)) {
-            this._map.delete(key);
-        }
-        else if (this._map.size >= this.maxSize) {
-            const oldestKey = this._map.keys().next().value;
-            if (oldestKey !== undefined) {
-                this._map.delete(oldestKey);
-            }
-        }
-        this._map.set(key, value);
-    }
-    /** Current number of entries. */
-    get size() {
-        return this._map.size;
-    }
-    /** Remove all entries. */
-    clear() {
-        this._map.clear();
-    }
-}
-exports.LRUMap = LRUMap;

package/dist/lib/core/origin-checker.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OriginChecker = void 0;
-/**
- * Origin Checker
- *
- * Provides origin checking functionality without global static state.
- * Each instance maintains its own anchor element and origin reference.
- *
- * Replaces the static methods in CacheStorage with instance-based approach.
- */
-class OriginChecker {
-    constructor(window) {
-        if (!window || !window.document) {
-            throw new Error('Valid window object required for OriginChecker');
-        }
-        if (!window.location || !window.location.href) {
-            throw new Error('Window object must have valid location');
-        }
-        this.link = window.document.createElement('a');
-        this.origin = this.getOrigin(window.location.href);
-    }
-    /**
-     * Get the origin (protocol + hostname + port) of a URL
-     *
-     * @param url - URL to parse
-     * @returns Origin string (e.g., "https://example.com:8080")
-     */
-    getOrigin(url) {
-        this.link.href = url;
-        // IE9 hack: accessing href twice to ensure it's properly parsed
-        this.link.href = this.link.href;
-        return this.link.protocol + this.link.hostname + this.link.port;
-    }
-    /**
-     * Check if a URL is from the same origin as the context
-     *
-     * @param src - URL to check
-     * @returns true if same origin, false otherwise
-     */
-    isSameOrigin(src) {
-        return this.getOrigin(src) === this.origin;
-    }
-    /**
-     * Get the current context origin
-     *
-     * @returns The origin of the context window
-     */
-    getContextOrigin() {
-        return this.origin;
-    }
-}
-exports.OriginChecker = OriginChecker;