html2canvas-pro 2.4.5 → 2.5.0

package/dist/types/render/canvas/text-renderer.d.ts

@@ -35,6 +35,13 @@ export declare class TextRenderer {
     private readonly ctx;
     private readonly options;
     private readonly decorationRenderer;
+    /**
+     * Baseline ascent per font string. Consecutive text nodes overwhelmingly
+     * share a font, and each measureBaseline call issues a canvas measureText,
+     * so repeated fonts are memoised (bounded; cleared if the working set
+     * exceeds the cap).
+     */
+    private readonly baselineCache;
     /**
      * Per-render glyph width cache. Keyed by glyph + font string,
      * avoids redundant `measureText` calls when letter-spacing is non-zero.
@@ -90,6 +97,13 @@ export declare class TextRenderer {
      * Public method used by list rendering
      */
     createFontStyle(styles: CSSParsedDeclaration): string[];
+    /**
+     * -webkit-text-fill-color overrides the fill colour while leaving
+     * decorations and strokes on `color` (e.g. the classic transparent-fill
+     * gradient text). Falls back to `color` when the computed value could not
+     * be resolved (currentcolor).
+     */
+    private resolveFillColor;
     /**
      * Render text with -webkit-line-clamp truncation.
      * Groups text bounds by their Y position into visual lines, then renders
@@ -101,5 +115,13 @@ export declare class TextRenderer {
      * Returns true if ellipsis was applied (caller should skip normal rendering).
      */
     private renderEllipsisText;
+    private measureBaselineCached;
     renderTextNode(text: TextContainer, styles: CSSParsedDeclaration, containerBounds?: Bounds): Promise<void>;
+    /**
+     * Draw text-emphasis marks over (or under) each grapheme cluster.
+     *
+     * Vertical writing modes are skipped in the current scope: marks would
+     * need to sit beside vertical glyph runs rather than above them.
+     */
+    private renderTextEmphasis;
 }

package/dist/types/render/stacking-context.d.ts

@@ -20,11 +20,14 @@ export declare class ElementPaint {
     readonly effects: IElementEffect[];
     readonly curves: BoundCurves;
     listValue?: string;
+    /** Memoised getEffects results for the plain (surfaceRoot-less) render path. */
+    private plainEffectsCache;
     constructor(container: ElementContainer, parent: ElementPaint | null);
     getEffects(target: EffectTarget, surfaceRoot?: ElementPaint): IElementEffect[];
+    private computeEffects;
 }
 /** @internal – exported for testing only. */
-export declare const hasOverflowClip: (styles: ElementContainer["styles"]) => boolean;
+export declare const hasOverflowClip: (styles: ElementContainer['styles']) => boolean;
 /**
  * Resolve a `closest-side` or `farthest-side` shape-radius keyword to pixels
  * for a single axis. Used by both `circle()` (per-axis) and `ellipse()`.

package/package.json

@@ -19,7 +19,7 @@
       "default": "./dist/html2canvas-pro.esm.js"
     }
   },
-  "version": "2.4.5",
+  "version": "2.5.0",
   "author": {
     "name": "yorickshan",
     "email": "yorickshan@gmail.com",
@@ -39,66 +39,65 @@
     "url": "https://github.com/yorickshan/html2canvas-pro"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.3.0",
-    "@commitlint/config-conventional": "^20.2.0",
+    "@commitlint/cli": "^21.2.3",
+    "@commitlint/config-conventional": "^21.2.3",
     "@types/chai": "^5.2.3",
     "@types/express": "^5.0.6",
-    "@types/karma": "^6.3.0",
-    "@types/mocha": "^10.0.7",
-    "@types/node": "^25.0.3",
-    "@types/platform": "^1.3.4",
+    "@types/karma": "^6.3.9",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^26.6.3",
+    "@types/platform": "^1.3.6",
     "@types/pngjs": "^6.0.5",
     "@types/serve-index": "^1.9.4",
-    "@typescript-eslint/eslint-plugin": "^8.50.0",
-    "@typescript-eslint/parser": "^8.50.0",
-    "@vitest/coverage-v8": "^3.2.6",
-    "appium-ios-simulator": "^8.0.9",
+    "@typescript-eslint/eslint-plugin": "^8.70.1",
+    "@typescript-eslint/parser": "^8.70.1",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "@vitest/coverage-v8": "^5.0.2",
+    "appium-ios-simulator": "^8.2.8",
     "base64-arraybuffer": "1.0.2",
-    "body-parser": "^2.2.1",
+    "body-parser": "^2.3.0",
     "chai": "6.2.2",
     "change-case": "^5.4.4",
-    "conventional-changelog": "^7.2.1",
-    "conventional-changelog-conventionalcommits": "^9.3.1",
-    "cors": "^2.8.5",
+    "conventional-changelog": "^8.1.3",
+    "conventional-changelog-conventionalcommits": "^10.4.0",
+    "cors": "^2.8.6",
     "cz-conventional-changelog": "^3.3.0",
-    "eslint": "^9.13.0",
+    "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-prettier": "^5.5.6",
     "express": "^5.2.1",
     "filenamify-url": "4.0.0",
-    "glob": "^13.0.0",
-    "html2canvas-pro-baseline": "npm:html2canvas-pro@2.4.3",
+    "glob": "^13.0.6",
     "husky": "^9.1.7",
-    "jsdom": "^29.1.1",
-    "karma": "^6.3.2",
-    "karma-chrome-launcher": "^3.1.0",
+    "jsdom": "^30.1.1",
+    "karma": "^6.4.4",
+    "karma-chrome-launcher": "^3.2.0",
     "karma-edge-launcher": "^0.4.2",
-    "karma-firefox-launcher": "^2.1.0",
+    "karma-firefox-launcher": "^2.1.3",
     "karma-ie-launcher": "^1.0.0",
     "karma-junit-reporter": "^2.0.1",
     "karma-mocha": "^2.0.1",
     "karma-safarinative-launcher": "^1.1.0",
-    "lint-staged": "^16.2.7",
-    "mocha": "^11.7.5",
-    "node-simctl": "^8.1.2",
+    "lint-staged": "^17.6.0",
+    "mocha": "^12.0.2",
+    "node-simctl": "^8.2.9",
     "pixelmatch": "^7.2.0",
     "platform": "^1.3.6",
-    "playwright": "1.60.0",
+    "playwright": "1.63.0",
     "pngjs": "^7.0.0",
-    "prettier": "^3.3.3",
-    "puppeteer": "^24.34.0",
-    "replace-in-file": "^8.4.0",
-    "rimraf": "^6.0.1",
-    "rolldown": "^1.2.0",
-    "serve-index": "^1.9.1",
+    "prettier": "^3.9.9",
+    "puppeteer": "^25.12.0",
+    "rimraf": "^6.1.3",
+    "rolldown": "^1.2.11",
+    "serve-index": "^1.9.2",
     "slash": "5.1.0",
-    "ts-node": "^10.9.2",
-    "tsx": "^4.22.3",
-    "typedoc": "^0.28.19",
-    "typescript": "^5.5.4",
+    "tsx": "^4.23.15",
+    "typedoc": "^0.28.20",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "vite": "^8.3.1",
     "vitepress": "^1.6.4",
-    "vitest": "^3.2.6",
-    "yargs": "^18.0.0"
+    "vitest": "^5.0.2",
+    "yargs": "^18.2.0"
   },
   "dependencies": {
     "css-line-break": "^2.1.0",
@@ -112,7 +111,7 @@
   },
   "scripts": {
     "prebuild": "rimraf dist/ && rimraf build/ && mkdir -p dist && mkdir -p build",
-    "build": "tsc --module commonjs -p tsconfig.build.json && rolldown -c rolldown.config.ts && pnpm build:create-reftest-list && rolldown -c tests/rolldown.testrunner.config.ts && node scripts/copy-filter-baseline.mjs",
+    "build": "tsc -p tsconfig.build.json && rolldown -c rolldown.config.ts && pnpm build:create-reftest-list && rolldown -c tests/rolldown.testrunner.config.ts && node scripts/bundle-filter-surface.mjs",
     "build:testrunner": "rolldown -c tests/rolldown.testrunner.config.ts",
     "build:reftest-result-list": "tsx scripts/create-reftest-result-list.ts",
     "build:create-reftest-list": "tsx scripts/create-reftest-list.ts tests/reftests/ignore.txt build/reftests.js",

package/dist/lib/config.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Html2CanvasConfig = void 0;
-/**
- * Html2Canvas Configuration
- *
- * Manages configuration state for html2canvas rendering.
- * Eliminates the need for global static variables.
- */
-class Html2CanvasConfig {
-    constructor(options = {}) {
-        const resolvedWindow = options.window || (typeof window !== 'undefined' ? window : undefined);
-        if (!resolvedWindow) {
-            throw new Error('Window object is required but not available');
-        }
-        this.window = resolvedWindow;
-        this.cspNonce = options.cspNonce;
-        this.cache = options.cache;
-    }
-    /**
-     * Create configuration from an element
-     * Extracts window from element's owner document
-     */
-    static fromElement(element, options = {}) {
-        const ownerDocument = element.ownerDocument;
-        if (!ownerDocument) {
-            throw new Error('Element is not attached to a document');
-        }
-        const defaultView = ownerDocument.defaultView;
-        if (!defaultView) {
-            throw new Error('Document is not attached to a window');
-        }
-        return new Html2CanvasConfig({
-            window: defaultView,
-            ...options
-        });
-    }
-    /**
-     * Clone configuration with override options
-     */
-    clone(options = {}) {
-        return new Html2CanvasConfig({
-            window: options.window || this.window,
-            cspNonce: options.cspNonce ?? this.cspNonce,
-            cache: options.cache ?? this.cache
-        });
-    }
-}
-exports.Html2CanvasConfig = Html2CanvasConfig;

package/dist/lib/core/abort-helper.js

@@ -1,20 +0,0 @@
-"use strict";
-/**
- * AbortSignal helper utilities.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.throwIfAborted = void 0;
-/**
- * Throw a DOMException if the given AbortSignal is already aborted.
- * Used at checkpoints throughout the rendering pipeline to support
- * cancellable renders.
- *
- * @param signal - The AbortSignal to check. If undefined or not aborted, this is a no-op.
- * @throws {DOMException} With name 'AbortError' if the signal has been aborted.
- */
-const throwIfAborted = (signal) => {
-    if (signal?.aborted) {
-        throw new DOMException('The operation was aborted.', 'AbortError');
-    }
-};
-exports.throwIfAborted = throwIfAborted;

package/dist/lib/core/background-parser.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseBackgroundColor = void 0;
-const color_1 = require("../css/types/color");
-const color_utilities_1 = require("../css/types/color-utilities");
-/**
- * Resolve the background colour for the rendered canvas, following CSS
- * background propagation rules:
- *
- * 1. If the target element is `<html>`, inherit the first opaque ancestor
- *    (doc → body → fallback).
- * 2. Otherwise use the user-supplied backgroundColor, or opaque white.
- *
- * @param context               - Current rendering context.
- * @param element               - The root element being rendered.
- * @param backgroundColorOverride - User-supplied override (string | null).
- * @returns A resolved colour value suitable for filling the canvas.
- */
-const parseBackgroundColor = (context, element, backgroundColorOverride) => {
-    const ownerDocument = element.ownerDocument;
-    // http://www.w3.org/TR/css3-background/#special-backgrounds
-    const documentBackgroundColor = ownerDocument.documentElement
-        ? (0, color_1.parseColor)(context, getComputedStyle(ownerDocument.documentElement).backgroundColor)
-        : color_1.COLORS.TRANSPARENT;
-    const bodyBackgroundColor = ownerDocument.body
-        ? (0, color_1.parseColor)(context, getComputedStyle(ownerDocument.body).backgroundColor)
-        : color_1.COLORS.TRANSPARENT;
-    const defaultBackgroundColor = typeof backgroundColorOverride === 'string'
-        ? (0, color_1.parseColor)(context, backgroundColorOverride)
-        : backgroundColorOverride === null
-            ? color_1.COLORS.TRANSPARENT
-            : 0xffffffff;
-    return element === ownerDocument.documentElement
-        ? (0, color_utilities_1.isTransparent)(documentBackgroundColor)
-            ? (0, color_utilities_1.isTransparent)(bodyBackgroundColor)
-                ? defaultBackgroundColor
-                : bodyBackgroundColor
-            : documentBackgroundColor
-        : defaultBackgroundColor;
-};
-exports.parseBackgroundColor = parseBackgroundColor;

package/dist/lib/core/bitwise.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.contains = void 0;
-const contains = (bit, value) => (bit & value) !== 0;
-exports.contains = contains;

package/dist/lib/core/cache-storage.js

@@ -1,283 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Cache = void 0;
-const features_1 = require("./features");
-class Cache {
-    constructor(context, _options) {
-        this.context = context;
-        this._options = _options;
-        this._cache = new Map();
-        this._pendingOperations = new Map();
-        /** When true, addImage() collects URLs without starting loads. */
-        this._deferMode = false;
-        /** URLs collected during defer mode, pending batch preload. */
-        this._collectedUrls = new Set();
-        // Default cache size: 100 items
-        this.maxSize = _options.maxCacheSize ?? 100;
-        if (this.maxSize < 1) {
-            throw new Error('Cache maxSize must be at least 1');
-        }
-        if (this.maxSize > 10000) {
-            this.context.logger.warn(`Cache maxSize ${this.maxSize} is very large and may cause memory issues. ` +
-                `Consider using a smaller value (recommended: 100-1000).`);
-        }
-    }
-    /**
-     * Enter defer mode: subsequent addImage() calls only collect URLs.
-     * Call preloadAll() to exit defer mode and batch-load all URLs.
-     */
-    startDefer() {
-        this._deferMode = true;
-    }
-    /**
-     * Exit defer mode and load all collected URLs in parallel, respecting
-     * an optional concurrency cap to avoid overwhelming the browser's network
-     * stack (default: 10 concurrent loads).
-     * After this call returns, all images are either loaded (cache hit) or
-     * failed (logged). Subsequent cache.match() calls return immediately.
-     *
-     * @param concurrency - Max concurrent image loads (1–100, default 10).
-     */
-    async preloadAll(concurrency = 10) {
-        this._deferMode = false;
-        const urls = Array.from(this._collectedUrls);
-        this._collectedUrls.clear();
-        if (urls.length === 0) {
-            return;
-        }
-        const limit = Math.max(1, Math.min(concurrency, 100));
-        this.context.logger.debug(`Preloading ${urls.length} image(s) with concurrency ${limit}`);
-        // Load in batches to respect the concurrency cap while maximising
-        // parallelism within each batch.
-        for (let i = 0; i < urls.length; i += limit) {
-            const batch = urls.slice(i, i + limit);
-            const operations = batch.map((url) => this._addImageWithPending(url));
-            await Promise.allSettled(operations);
-        }
-    }
-    addImage(src) {
-        // ── Defer mode: collect only ──────────────────────────────
-        if (this._deferMode) {
-            if (!this.has(src) && (isBlobImage(src) || isRenderable(src))) {
-                this._collectedUrls.add(src);
-            }
-            return Promise.resolve();
-        }
-        // ── Normal mode: immediate load ───────────────────────────
-        // Wait for any pending operations on this key
-        const pending = this._pendingOperations.get(src);
-        if (pending) {
-            return pending;
-        }
-        if (this.has(src)) {
-            // Move to end for LRU ordering
-            const entry = this._cache.get(src);
-            this._cache.delete(src);
-            this._cache.set(src, entry);
-            return Promise.resolve();
-        }
-        if (isBlobImage(src) || isRenderable(src)) {
-            return this._addImageWithPending(src);
-        }
-        return Promise.resolve();
-    }
-    /**
-     * Shared helper: enqueues loading for a single URL with pending-operation
-     * deduplication and error swallowing. Used by both addImage() (normal mode)
-     * and preloadAll() (batch mode).
-     */
-    _addImageWithPending(src) {
-        const pending = this._pendingOperations.get(src);
-        if (pending) {
-            return pending;
-        }
-        const operation = this._addImageInternal(src);
-        this._pendingOperations.set(src, operation);
-        operation.finally(() => {
-            this._pendingOperations.delete(src);
-        });
-        return operation;
-    }
-    async _addImageInternal(src) {
-        const timeoutMs = this._options.imageTimeout ?? 15000;
-        const imageWithTimeout = this.withTimeout(this.loadImage(src), timeoutMs, `Timed out (${timeoutMs}ms) loading image`);
-        // Handle errors to prevent unhandled rejections
-        imageWithTimeout.catch((error) => {
-            this.context.logger.error(`Failed to load image ${src}: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        });
-        // Store the promise with timeout in cache
-        this.set(src, imageWithTimeout);
-    }
-    withTimeout(promise, timeoutMs, message) {
-        if (timeoutMs <= 0) {
-            return promise;
-        }
-        let timeoutId;
-        const timeout = new Promise((_, reject) => {
-            timeoutId = setTimeout(() => reject(new Error(message)), timeoutMs);
-        });
-        return Promise.race([promise, timeout]).finally(() => {
-            if (timeoutId !== undefined) {
-                clearTimeout(timeoutId);
-            }
-        });
-    }
-    match(src) {
-        const entry = this._cache.get(src);
-        if (entry) {
-            // Move to end for LRU ordering (O(1))
-            this._cache.delete(src);
-            this._cache.set(src, entry);
-            return entry.value;
-        }
-        return undefined;
-    }
-    /**
-     * Set a value in cache with LRU eviction (O(1) via Map insertion order).
-     * Map preserves insertion order; delete+set on access moves items to the end.
-     * The first key in Map.keys() is always the least recently used.
-     */
-    set(key, value) {
-        if (this._cache.has(key)) {
-            // Update existing entry: move to end of Map
-            this._cache.delete(key);
-        }
-        else if (this._cache.size >= this.maxSize) {
-            // Evict LRU (first key = least recently used) — O(1)
-            const lruKey = this._cache.keys().next().value;
-            if (lruKey !== undefined) {
-                this._cache.delete(lruKey);
-                this.context.logger.debug(`Cache: Evicted LRU entry: ${lruKey}`);
-            }
-        }
-        this._cache.set(key, { value });
-    }
-    /**
-     * Get cache size
-     */
-    size() {
-        return this._cache.size;
-    }
-    /**
-     * Get max cache size
-     */
-    getMaxSize() {
-        return this.maxSize;
-    }
-    /**
-     * Clear all cache entries
-     */
-    clear() {
-        this._cache.clear();
-    }
-    async loadImage(key) {
-        const originChecker = this.context.originChecker;
-        const defaultIsSameOrigin = (src) => originChecker.isSameOrigin(src);
-        const isSameOrigin = typeof this._options.customIsSameOrigin === 'function'
-            ? await this._options.customIsSameOrigin(key, defaultIsSameOrigin)
-            : defaultIsSameOrigin(key);
-        // With allowTaint disabled (the default), a cross-origin image is safe to
-        // draw only when the server sends CORS headers. Instead of skipping such
-        // images outright, still ATTEMPT a CORS load: it succeeds for CORS-enabled
-        // hosts (CDNs, avatar services, picsum, ...) and fails cleanly for hosts
-        // without CORS headers, where the image is skipped exactly as before
-        // (issue #229). An explicit proxy takes precedence so existing setups
-        // that rely on proxying keep working.
-        const canAttemptCors = !isSameOrigin &&
-            this._options.allowTaint === false &&
-            !isInlineImage(key) &&
-            !isBlobImage(key) &&
-            typeof this._options.proxy !== 'string';
-        const useCORS = !isInlineImage(key) &&
-            (this._options.useCORS === true || canAttemptCors) &&
-            features_1.FEATURES.SUPPORT_CORS_IMAGES &&
-            !isSameOrigin;
-        const useProxy = !isInlineImage(key) &&
-            !isSameOrigin &&
-            !isBlobImage(key) &&
-            typeof this._options.proxy === 'string' &&
-            features_1.FEATURES.SUPPORT_CORS_XHR &&
-            !useCORS;
-        if (!isSameOrigin &&
-            this._options.allowTaint === false &&
-            !isInlineImage(key) &&
-            !isBlobImage(key) &&
-            !useProxy &&
-            !useCORS) {
-            return;
-        }
-        let src = key;
-        if (useProxy) {
-            src = await this.proxy(src);
-        }
-        this.context.logger.debug(`Added image ${key.substring(0, 256)}`);
-        return await new Promise((resolve, reject) => {
-            const img = new Image();
-            img.onload = () => resolve(img);
-            img.onerror = reject;
-            //ios safari 10.3 taints canvas with data urls unless crossOrigin is set to anonymous
-            if (isInlineBase64Image(src) || useCORS) {
-                img.crossOrigin = 'anonymous';
-            }
-            img.src = src;
-            if (img.complete === true) {
-                // Inline XML images may fail to parse, throwing an Error later on
-                setTimeout(() => resolve(img), 500);
-            }
-        });
-    }
-    has(key) {
-        return this._cache.has(key);
-    }
-    keys() {
-        return Promise.resolve(Array.from(this._cache.keys()));
-    }
-    proxy(src) {
-        const proxy = this._options.proxy;
-        if (!proxy) {
-            throw new Error('No proxy defined');
-        }
-        const key = src.substring(0, 256);
-        return new Promise((resolve, reject) => {
-            const responseType = features_1.FEATURES.SUPPORT_RESPONSE_TYPE ? 'blob' : 'text';
-            const xhr = new XMLHttpRequest();
-            xhr.onload = () => {
-                if (xhr.status === 200) {
-                    if (responseType === 'text') {
-                        resolve(xhr.response);
-                    }
-                    else {
-                        const reader = new FileReader();
-                        reader.addEventListener('load', () => resolve(reader.result), false);
-                        reader.addEventListener('error', (e) => reject(e), false);
-                        reader.readAsDataURL(xhr.response);
-                    }
-                }
-                else {
-                    reject(`Failed to proxy resource ${key} with status code ${xhr.status}`);
-                }
-            };
-            xhr.onerror = reject;
-            const queryString = proxy.indexOf('?') > -1 ? '&' : '?';
-            xhr.open('GET', `${proxy}${queryString}url=${encodeURIComponent(src)}&responseType=${responseType}`);
-            if (responseType !== 'text' && xhr instanceof XMLHttpRequest) {
-                xhr.responseType = responseType;
-            }
-            if (this._options.imageTimeout) {
-                const timeout = this._options.imageTimeout;
-                xhr.timeout = timeout;
-                xhr.ontimeout = () => reject(`Timed out (${timeout}ms) proxying ${key}`);
-            }
-            xhr.send();
-        });
-    }
-}
-exports.Cache = Cache;
-const INLINE_SVG = /^data:image\/svg\+xml/i;
-const INLINE_BASE64 = /^data:image\/.*;base64,/i;
-const INLINE_IMG = /^data:image\/.*/i;
-const isRenderable = (src) => features_1.FEATURES.SUPPORT_SVG_DRAWING || !isSVG(src);
-const isInlineImage = (src) => INLINE_IMG.test(src);
-const isInlineBase64Image = (src) => INLINE_BASE64.test(src);
-const isBlobImage = (src) => src.substring(0, 4) === 'blob';
-const isSVG = (src) => src.slice(-3).toLowerCase() === 'svg' || INLINE_SVG.test(src);

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;