html2canvas-pro 2.4.4 → 2.5.0

package/dist/lib/core/performance-monitor.js

@@ -1,185 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PerformanceMonitor = void 0;
-/**
- * Performance Monitor
- *
- * Tracks performance metrics throughout the rendering pipeline.
- * Provides insights into where time is spent during rendering.
- *
- * Usage:
- * ```typescript
- * const monitor = new PerformanceMonitor(context);
- *
- * monitor.start('clone');
- * await cloneDocument();
- * monitor.end('clone');
- *
- * const summary = monitor.getSummary();
- * ```
- */
-class PerformanceMonitor {
-    constructor(context, enabled = true) {
-        this.context = context;
-        this.activeMetrics = new Map();
-        this.completedMetrics = [];
-        this.enabled = enabled;
-        // Fallback for environments without performance.now()
-        this.getTime =
-            typeof performance !== 'undefined' && typeof performance.now === 'function'
-                ? () => performance.now()
-                : () => Date.now();
-    }
-    /**
-     * Start measuring a performance metric
-     *
-     * @param name - Unique name for this metric
-     * @param metadata - Optional metadata to attach
-     */
-    start(name, metadata) {
-        if (!this.enabled) {
-            return;
-        }
-        if (this.activeMetrics.has(name)) {
-            this.context?.logger.warn(`Performance metric '${name}' already started. Overwriting.`);
-        }
-        this.activeMetrics.set(name, {
-            name,
-            startTime: this.getTime(),
-            metadata
-        });
-    }
-    /**
-     * End measuring a performance metric
-     *
-     * @param name - Name of the metric to end
-     * @returns The completed metric, or undefined if not found
-     */
-    end(name) {
-        if (!this.enabled) {
-            return undefined;
-        }
-        const metric = this.activeMetrics.get(name);
-        if (!metric) {
-            this.context?.logger.warn(`Performance metric '${name}' not found. Was start() called?`);
-            return undefined;
-        }
-        metric.endTime = this.getTime();
-        metric.duration = metric.endTime - metric.startTime;
-        this.completedMetrics.push(metric);
-        this.activeMetrics.delete(name);
-        this.context?.logger.debug(`⏱️  ${name}: ${metric.duration.toFixed(2)}ms`, metric.metadata);
-        return metric;
-    }
-    /**
-     * Measure a synchronous function
-     *
-     * @param name - Name for this measurement
-     * @param fn - Function to measure
-     * @param metadata - Optional metadata
-     * @returns The function's return value
-     */
-    measure(name, fn, metadata) {
-        this.start(name, metadata);
-        try {
-            const result = fn();
-            this.end(name);
-            return result;
-        }
-        catch (error) {
-            this.end(name);
-            throw error;
-        }
-    }
-    /**
-     * Measure an asynchronous function
-     *
-     * @param name - Name for this measurement
-     * @param fn - Async function to measure
-     * @param metadata - Optional metadata
-     * @returns Promise resolving to the function's return value
-     */
-    async measureAsync(name, fn, metadata) {
-        this.start(name, metadata);
-        try {
-            const result = await fn();
-            this.end(name);
-            return result;
-        }
-        catch (error) {
-            this.end(name);
-            throw error;
-        }
-    }
-    /**
-     * Get all completed metrics
-     *
-     * @returns Array of completed performance metrics
-     */
-    getMetrics() {
-        return [...this.completedMetrics];
-    }
-    /**
-     * Get a specific metric by name
-     *
-     * @param name - Metric name
-     * @returns The metric, or undefined if not found
-     */
-    getMetric(name) {
-        return this.completedMetrics.find((m) => m.name === name);
-    }
-    /**
-     * Get performance summary
-     *
-     * @returns Aggregated performance data
-     */
-    getSummary() {
-        const totalDuration = this.completedMetrics.reduce((sum, metric) => sum + (metric.duration || 0), 0);
-        const breakdown = this.completedMetrics.map((metric) => ({
-            name: metric.name,
-            duration: metric.duration || 0,
-            percentage: totalDuration > 0 ? (((metric.duration || 0) / totalDuration) * 100).toFixed(1) + '%' : '0%'
-        }));
-        return {
-            totalDuration,
-            metrics: this.getMetrics(),
-            breakdown
-        };
-    }
-    /**
-     * Log performance summary to console
-     */
-    logSummary() {
-        if (!this.enabled || this.completedMetrics.length === 0 || !this.context) {
-            return;
-        }
-        const summary = this.getSummary();
-        this.context.logger.info(`\n📊 Performance Summary (Total: ${summary.totalDuration.toFixed(2)}ms):`);
-        summary.breakdown
-            .sort((a, b) => b.duration - a.duration)
-            .forEach((item) => {
-            this.context.logger.info(`  ${item.name.padEnd(20)} ${item.duration.toFixed(2).padStart(8)}ms  ${item.percentage.padStart(6)}`);
-        });
-    }
-    /**
-     * Clear all metrics
-     */
-    clear() {
-        this.activeMetrics.clear();
-        this.completedMetrics.splice(0);
-    }
-    /**
-     * Check if monitoring is enabled
-     */
-    isEnabled() {
-        return this.enabled;
-    }
-    /**
-     * Get active (uncompleted) metrics
-     * Useful for debugging leaked measurements
-     */
-    getActiveMetrics() {
-        return Array.from(this.activeMetrics.keys());
-    }
-}
-exports.PerformanceMonitor = PerformanceMonitor;

package/dist/lib/core/render-element.js

@@ -1,131 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderElement = void 0;
-const bounds_1 = require("../css/layout/bounds");
-const color_1 = require("../css/types/color");
-const document_cloner_1 = require("../dom/document-cloner");
-const node_type_guards_1 = require("../dom/node-type-guards");
-const node_parser_1 = require("../dom/node-parser");
-const canvas_renderer_1 = require("../render/canvas/canvas-renderer");
-const foreignobject_renderer_1 = require("../render/canvas/foreignobject-renderer");
-const context_1 = require("./context");
-const validator_1 = require("./validator");
-const performance_monitor_1 = require("./performance-monitor");
-const abort_helper_1 = require("./abort-helper");
-const config_assembler_1 = require("./config-assembler");
-const background_parser_1 = require("./background-parser");
-const renderElement = async (element, opts, config) => {
-    (0, config_assembler_1.coerceNumberOptions)(opts);
-    // Input validation (unless explicitly skipped)
-    if (!opts.skipValidation) {
-        const validator = opts.validator || (0, validator_1.createDefaultValidator)();
-        const elementValidation = validator.validateElement(element);
-        if (!elementValidation.valid) {
-            throw new Error(elementValidation.error);
-        }
-        const optionsValidation = validator.validateOptions(opts);
-        if (!optionsValidation.valid) {
-            throw new Error(`Invalid options: ${optionsValidation.error}`);
-        }
-    }
-    if (!element || typeof element !== 'object') {
-        throw new Error('Invalid element provided as first argument');
-    }
-    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`);
-    }
-    const resourceOptions = (0, config_assembler_1.assembleResourceOptions)(opts);
-    const contextOptions = (0, config_assembler_1.assembleContextOptions)(opts, config, resourceOptions);
-    const windowOptions = (0, config_assembler_1.assembleWindowOptions)(opts, defaultView);
-    const windowBounds = new bounds_1.Bounds(windowOptions.scrollX, windowOptions.scrollY, windowOptions.windowWidth, windowOptions.windowHeight);
-    const context = new context_1.Context(contextOptions, windowBounds, config);
-    const performanceMonitoring = opts.enablePerformanceMonitoring ?? opts.logging ?? false;
-    const perfMonitor = new performance_monitor_1.PerformanceMonitor(context, performanceMonitoring);
-    perfMonitor.start('total', {
-        width: windowOptions.windowWidth,
-        height: windowOptions.windowHeight
-    });
-    const signal = opts.signal;
-    (0, abort_helper_1.throwIfAborted)(signal);
-    const foreignObjectRendering = opts.foreignObjectRendering ?? false;
-    const cloneOptions = (0, config_assembler_1.assembleCloneOptions)(opts, config, foreignObjectRendering);
-    context.logger.debug(`Starting document clone with size ${windowBounds.width}x${windowBounds.height} scrolled to ${-windowBounds.left},${-windowBounds.top}`);
-    perfMonitor.start('clone');
-    const documentCloner = new document_cloner_1.DocumentCloner(context, element, cloneOptions);
-    const clonedElement = documentCloner.clonedReferenceElement;
-    if (!clonedElement) {
-        throw new Error('Unable to find element in cloned iframe');
-    }
-    const container = await documentCloner.toIFrame(ownerDocument, windowBounds);
-    perfMonitor.end('clone');
-    if (signal?.aborted) {
-        if (opts.removeContainer ?? true) {
-            document_cloner_1.DocumentCloner.destroy(container);
-        }
-        (0, abort_helper_1.throwIfAborted)(signal);
-    }
-    const { width, height, left, top } = (0, node_type_guards_1.isBodyElement)(clonedElement) || (0, node_type_guards_1.isHTMLElement)(clonedElement)
-        ? (0, bounds_1.parseDocumentSize)(clonedElement.ownerDocument)
-        : (0, bounds_1.parseBounds)(context, clonedElement);
-    const backgroundColor = (0, background_parser_1.parseBackgroundColor)(context, clonedElement, opts.backgroundColor);
-    const renderOptions = (0, config_assembler_1.assembleRenderOptions)(opts, backgroundColor, left, top, width, height, defaultView.devicePixelRatio ?? 1);
-    let canvas;
-    let root;
-    try {
-        if (foreignObjectRendering) {
-            context.logger.debug(`Document cloned, using foreign object rendering`);
-            perfMonitor.start('render-foreignobject');
-            const renderer = new foreignobject_renderer_1.ForeignObjectRenderer(context, renderOptions);
-            canvas = await renderer.render(clonedElement);
-            perfMonitor.end('render-foreignobject');
-        }
-        else {
-            context.logger.debug(`Document cloned, element located at ${left},${top} with size ${width}x${height} using computed rendering`);
-            context.logger.debug(`Starting DOM parsing`);
-            perfMonitor.start('parse');
-            (0, abort_helper_1.throwIfAborted)(signal);
-            // Enter defer mode: collect all image URLs during parse without
-            // starting individual loads. This avoids serialised loading in
-            // DOM-traversal order.
-            context.cache.startDefer();
-            root = (0, node_parser_1.parseTree)(context, clonedElement);
-            perfMonitor.end('parse');
-            // Batch-preload all collected images in parallel before rendering.
-            perfMonitor.start('preload');
-            await context.cache.preloadAll();
-            perfMonitor.end('preload');
-            if (backgroundColor === root.styles.backgroundColor) {
-                root.styles.backgroundColor = color_1.COLORS.TRANSPARENT;
-            }
-            context.logger.debug(`Starting renderer for element at ${renderOptions.x},${renderOptions.y} with size ${renderOptions.width}x${renderOptions.height}`);
-            perfMonitor.start('render');
-            (0, abort_helper_1.throwIfAborted)(signal);
-            const renderer = new canvas_renderer_1.CanvasRenderer(context, renderOptions);
-            canvas = await renderer.render(root);
-            perfMonitor.end('render');
-        }
-    }
-    finally {
-        perfMonitor.start('cleanup');
-        try {
-            if (root)
-                root.restoreTree();
-        }
-        finally {
-            if (opts.removeContainer ?? true)
-                document_cloner_1.DocumentCloner.destroy(container);
-            perfMonitor.end('cleanup');
-        }
-    }
-    perfMonitor.end('total');
-    context.logger.debug(`Finished rendering`);
-    if (performanceMonitoring)
-        perfMonitor.logSummary();
-    return canvas;
-};
-exports.renderElement = renderElement;

package/dist/lib/core/util.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SMALL_IMAGE = void 0;
-exports.SMALL_IMAGE = 'data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7';