html2canvas-pro 2.1.1 → 2.2.1

package/dist/types/core/validator.d.ts

@@ -10,11 +10,8 @@
 export interface ValidationResult {
     valid: boolean;
     error?: string;
-    sanitized?: any;
-    /**
-     * Indicates if runtime validation is recommended
-     * (e.g., for proxy URLs to prevent DNS rebinding attacks)
-     */
+    sanitized?: unknown;
+    /** Indicates if runtime validation is recommended (e.g. for proxy URLs against DNS rebinding) */
     requiresRuntimeCheck?: boolean;
 }
 /**
@@ -42,7 +39,8 @@ export interface ValidatorConfig {
     /**
      * Custom validation function
      */
-    customValidator?: (value: any, type: string) => ValidationResult;
+    /** Custom validation function. Receives the raw value and its semantic type. */
+    customValidator?: (value: unknown, type: string) => ValidationResult;
 }
 /**
  * Input Validator
@@ -113,14 +111,14 @@ export declare class Validator {
      * @param element - Element to validate
      * @returns Validation result
      */
-    validateElement(element: any): ValidationResult;
+    validateElement(element: unknown): ValidationResult;
     /**
      * Validate entire options object
      *
      * @param options - Options to validate
      * @returns Validation result with all errors
      */
-    validateOptions(options: any): ValidationResult;
+    validateOptions(options: Record<string, unknown>): ValidationResult;
 }
 /**
  * Create a default validator instance

package/dist/types/css/grouped/background-styles.d.ts

@@ -0,0 +1,16 @@
+import type { CSSParsedDeclaration } from '../index';
+/**
+ * Read-only grouped accessor for background-related CSS properties.
+ */
+export declare class BackgroundStyles {
+    private readonly styles;
+    constructor(styles: CSSParsedDeclaration);
+    get color(): number;
+    get image(): import("../types/image").ICSSImage[];
+    get clip(): import("../property-descriptors/background-clip").BackgroundClip;
+    get origin(): import("../property-descriptors/background-origin").BackgroundOrigin;
+    get position(): import("../property-descriptors/background-position").BackgroundPosition;
+    get repeat(): import("../property-descriptors/background-repeat").BackgroundRepeat;
+    get size(): import("../property-descriptors/background-size").BackgroundSize;
+    get blendMode(): import("../property-descriptors/background-blend-mode").BackgroundBlendMode;
+}

package/dist/types/css/grouped/border-styles.d.ts

@@ -0,0 +1,31 @@
+import type { CSSParsedDeclaration } from '../index';
+/**
+ * Read-only grouped accessor for border-related CSS properties.
+ *
+ * Provides structured access: `styles.border.topColor` as an alternative
+ * to the flat `styles.borderTopColor`. Both forms remain valid.
+ */
+export declare class BorderStyles {
+    private readonly styles;
+    constructor(styles: CSSParsedDeclaration);
+    get topColor(): number;
+    get rightColor(): number;
+    get bottomColor(): number;
+    get leftColor(): number;
+    get topStyle(): import("../property-descriptors/border-style").BORDER_STYLE;
+    get rightStyle(): import("../property-descriptors/border-style").BORDER_STYLE;
+    get bottomStyle(): import("../property-descriptors/border-style").BORDER_STYLE;
+    get leftStyle(): import("../property-descriptors/border-style").BORDER_STYLE;
+    get topWidth(): number;
+    get rightWidth(): number;
+    get bottomWidth(): number;
+    get leftWidth(): number;
+    get topLeftRadius(): import("../types/length-percentage").LengthPercentageTuple;
+    get topRightRadius(): import("../types/length-percentage").LengthPercentageTuple;
+    get bottomRightRadius(): import("../types/length-percentage").LengthPercentageTuple;
+    get bottomLeftRadius(): import("../types/length-percentage").LengthPercentageTuple;
+    get imageSource(): import("../property-descriptors/border-image-source").BorderImageSource;
+    get imageSlice(): import("../property-descriptors/border-image-slice").BorderImageSlice;
+    get imageRepeat(): import("../property-descriptors/border-image-repeat").BorderImageRepeat;
+    get boxShadow(): import("../property-descriptors/box-shadow").BoxShadow;
+}

package/dist/types/css/grouped/font-styles.d.ts

@@ -0,0 +1,35 @@
+import type { CSSParsedDeclaration } from '../index';
+/**
+ * Read-only grouped accessor for font/text-related CSS properties.
+ */
+export declare class FontStyles {
+    private readonly styles;
+    constructor(styles: CSSParsedDeclaration);
+    get family(): import("../property-descriptors/font-family").FontFamily;
+    get size(): import("../types/length-percentage").LengthPercentage;
+    get style(): import("../property-descriptors/font-style").FONT_STYLE;
+    get variant(): string[];
+    get weight(): number;
+    get ligatures(): import("../property-descriptors/font-variant-ligatures").FONT_VARIANT_LIGATURES;
+    get color(): number;
+    get letterSpacing(): number;
+    get lineHeight(): import("../syntax/parser").CSSValue;
+    get textAlign(): import("../property-descriptors/text-align").TEXT_ALIGN;
+    get textTransform(): import("../property-descriptors/text-transform").TEXT_TRANSFORM;
+    get textOverflow(): import("../property-descriptors/text-overflow").TEXT_OVERFLOW;
+    get textShadow(): import("../property-descriptors/text-shadow").TextShadow;
+    get textDecorationColor(): number;
+    get textDecorationLine(): import("../property-descriptors/text-decoration-line").TextDecorationLine;
+    get textDecorationStyle(): import("../property-descriptors/text-decoration-style").TEXT_DECORATION_STYLE;
+    get textDecorationThickness(): import("../property-descriptors/text-decoration-thickness").TextDecorationThickness;
+    get textUnderlineOffset(): import("../property-descriptors/text-underline-offset").TextUnderlineOffset;
+    get wordBreak(): import("../property-descriptors/word-break").WORD_BREAK;
+    get lineBreak(): import("../property-descriptors/line-break").LINE_BREAK;
+    get overflowWrap(): import("../property-descriptors/overflow-wrap").OVERFLOW_WRAP;
+    get writingMode(): import("../property-descriptors/writing-mode").WRITING_MODE;
+    get direction(): import("../property-descriptors/direction").DIRECTION;
+    get webkitTextStrokeColor(): number;
+    get webkitTextStrokeWidth(): number;
+    get webkitLineClamp(): number;
+    get paintOrder(): import("../property-descriptors/paint-order").PaintOrder;
+}

package/dist/types/css/grouped/layout-styles.d.ts

@@ -0,0 +1,46 @@
+import type { CSSParsedDeclaration } from '../index';
+/**
+ * Read-only grouped accessor for layout/display/positioning CSS properties.
+ */
+export declare class LayoutStyles {
+    private readonly styles;
+    constructor(styles: CSSParsedDeclaration);
+    get display(): number;
+    get position(): import("../property-descriptors/position").POSITION;
+    get float(): import("../property-descriptors/float").FLOAT;
+    get zIndex(): CSSParsedDeclaration['zIndex'];
+    get marginTop(): import("../syntax/parser").CSSValue;
+    get marginRight(): import("../syntax/parser").CSSValue;
+    get marginBottom(): import("../syntax/parser").CSSValue;
+    get marginLeft(): import("../syntax/parser").CSSValue;
+    get paddingTop(): import("../types/length-percentage").LengthPercentage;
+    get paddingRight(): import("../types/length-percentage").LengthPercentage;
+    get paddingBottom(): import("../types/length-percentage").LengthPercentage;
+    get paddingLeft(): import("../types/length-percentage").LengthPercentage;
+    get overflowX(): import("../property-descriptors/overflow").OVERFLOW;
+    get overflowY(): import("../property-descriptors/overflow").OVERFLOW;
+    get opacity(): number;
+    get visibility(): import("../property-descriptors/visibility").VISIBILITY;
+    get transform(): import("../property-descriptors/transform").Transform;
+    get transformOrigin(): import("../property-descriptors/transform-origin").TransformOrigin;
+    get rotate(): import("../property-descriptors/rotate").Rotate;
+    get zoom(): number;
+    get clipPath(): import("../property-descriptors/clip-path").ClipPathValue;
+    get mixBlendMode(): import("../property-descriptors/mix-blend-mode").MixBlendMode;
+    get filter(): import("../property-descriptors/filter").FilterValue;
+    get imageRendering(): import("../property-descriptors/image-rendering").IMAGE_RENDERING;
+    get objectFit(): number;
+    get objectPosition(): import("../property-descriptors/object-position").ObjectPosition;
+    get boxDecorationBreak(): import("../property-descriptors/box-decoration-break").BOX_DECORATION_BREAK;
+    get listStyleImage(): import("../types/image").ICSSImage | null;
+    get listStylePosition(): import("../property-descriptors/list-style-position").LIST_STYLE_POSITION;
+    get listStyleType(): import("../property-descriptors/list-style-type").LIST_STYLE_TYPE;
+    get animationDuration(): number[];
+    isVisible(): boolean;
+    isTransparent(): boolean;
+    isTransformed(): boolean;
+    isPositioned(): boolean;
+    isPositionedWithZIndex(): boolean;
+    isFloating(): boolean;
+    isInlineLevel(): boolean;
+}

package/dist/types/css/index.d.ts

@@ -55,6 +55,19 @@ import { objectFit } from './property-descriptors/object-fit';
 import { textOverflow } from './property-descriptors/text-overflow';
 import { imageRendering } from './property-descriptors/image-rendering';
 import { MixBlendMode } from './property-descriptors/mix-blend-mode';
+import { filter } from './property-descriptors/filter';
+import { fontVariantLigatures } from './property-descriptors/font-variant-ligatures';
+import { zoom } from './property-descriptors/zoom';
+import { objectPosition } from './property-descriptors/object-position';
+import { backgroundBlendMode } from './property-descriptors/background-blend-mode';
+import { borderImageSource } from './property-descriptors/border-image-source';
+import { borderImageSlice } from './property-descriptors/border-image-slice';
+import { borderImageRepeat } from './property-descriptors/border-image-repeat';
+import { boxDecorationBreak } from './property-descriptors/box-decoration-break';
+import { BorderStyles } from './grouped/border-styles';
+import { BackgroundStyles } from './grouped/background-styles';
+import { FontStyles } from './grouped/font-styles';
+import { LayoutStyles } from './grouped/layout-styles';
 export declare class CSSParsedDeclaration {
     animationDuration: ReturnType<typeof duration.parse>;
     backgroundClip: ReturnType<typeof backgroundClip.parse>;
@@ -133,6 +146,23 @@ export declare class CSSParsedDeclaration {
     objectFit: ReturnType<typeof objectFit.parse>;
     imageRendering: ReturnType<typeof imageRendering.parse>;
     mixBlendMode: MixBlendMode;
+    filter: ReturnType<typeof filter.parse>;
+    fontVariantLigatures: ReturnType<typeof fontVariantLigatures.parse>;
+    zoom: ReturnType<typeof zoom.parse>;
+    objectPosition: ReturnType<typeof objectPosition.parse>;
+    backgroundBlendMode: ReturnType<typeof backgroundBlendMode.parse>;
+    borderImageSource: ReturnType<typeof borderImageSource.parse>;
+    borderImageSlice: ReturnType<typeof borderImageSlice.parse>;
+    borderImageRepeat: ReturnType<typeof borderImageRepeat.parse>;
+    boxDecorationBreak: ReturnType<typeof boxDecorationBreak.parse>;
+    private _border?;
+    private _background?;
+    private _font?;
+    private _layout?;
+    get border(): BorderStyles;
+    get background(): BackgroundStyles;
+    get font(): FontStyles;
+    get layout(): LayoutStyles;
     private static readonly standardProps;
     constructor(context: Context, declaration: CSSStyleDeclaration);
     isVisible(): boolean;

package/dist/types/css/property-descriptors/background-blend-mode.d.ts

@@ -0,0 +1,23 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+export declare const MIX_BLEND_MODE: {
+    readonly NORMAL: "normal";
+    readonly MULTIPLY: "multiply";
+    readonly SCREEN: "screen";
+    readonly OVERLAY: "overlay";
+    readonly DARKEN: "darken";
+    readonly LIGHTEN: "lighten";
+    readonly COLOR_DODGE: "color-dodge";
+    readonly COLOR_BURN: "color-burn";
+    readonly HARD_LIGHT: "hard-light";
+    readonly SOFT_LIGHT: "soft-light";
+    readonly DIFFERENCE: "difference";
+    readonly EXCLUSION: "exclusion";
+    readonly HUE: "hue";
+    readonly SATURATION: "saturation";
+    readonly COLOR: "color";
+    readonly LUMINOSITY: "luminosity";
+};
+export type BackgroundBlendMode = BlendModeValue[];
+type BlendModeValue = (typeof MIX_BLEND_MODE)[keyof typeof MIX_BLEND_MODE];
+export declare const backgroundBlendMode: IPropertyListDescriptor<BackgroundBlendMode>;
+export {};

package/dist/types/css/property-descriptors/border-image-repeat.d.ts

@@ -0,0 +1,12 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+export declare enum BORDER_IMAGE_REPEAT {
+    STRETCH = 0,
+    REPEAT = 1,
+    ROUND = 2,
+    SPACE = 3
+}
+export interface BorderImageRepeat {
+    horizontal: BORDER_IMAGE_REPEAT;
+    vertical: BORDER_IMAGE_REPEAT;
+}
+export declare const borderImageRepeat: IPropertyListDescriptor<BorderImageRepeat>;

package/dist/types/css/property-descriptors/border-image-slice.d.ts

@@ -0,0 +1,10 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+export interface BorderImageSlice {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    fill: boolean;
+    unit: 'number' | 'percent';
+}
+export declare const borderImageSlice: IPropertyListDescriptor<BorderImageSlice>;

package/dist/types/css/property-descriptors/border-image-source.d.ts

@@ -0,0 +1,4 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+import { ICSSImage } from '../types/image';
+export type BorderImageSource = ICSSImage | null;
+export declare const borderImageSource: IPropertyListDescriptor<BorderImageSource>;

package/dist/types/css/property-descriptors/box-decoration-break.d.ts

@@ -0,0 +1,6 @@
+import { IPropertyIdentValueDescriptor } from '../property-descriptor';
+export declare const enum BOX_DECORATION_BREAK {
+    SLICE = 0,
+    CLONE = 1
+}
+export declare const boxDecorationBreak: IPropertyIdentValueDescriptor<BOX_DECORATION_BREAK>;

package/dist/types/css/property-descriptors/counter-increment.d.ts

@@ -1,7 +1,10 @@
 import { IPropertyListDescriptor } from '../property-descriptor';
+import { CSSValue } from '../syntax/parser';
 export interface COUNTER_INCREMENT {
     counter: string;
     increment: number;
 }
 export type CounterIncrement = COUNTER_INCREMENT[] | null;
+/** Shared counter-ID parsing: returns next number or a fallback default. */
+export declare const parseCounterValue: (tokens: CSSValue[], defaultNumber: number) => [string, number][];
 export declare const counterIncrement: IPropertyListDescriptor<CounterIncrement>;

package/dist/types/css/property-descriptors/filter.d.ts

@@ -0,0 +1,3 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+export type FilterValue = string | null;
+export declare const filter: IPropertyListDescriptor<FilterValue>;

package/dist/types/css/property-descriptors/font-variant-ligatures.d.ts

@@ -0,0 +1,14 @@
+import { IPropertyIdentValueDescriptor } from '../property-descriptor';
+export declare const enum FONT_VARIANT_LIGATURES {
+    NORMAL = 0,
+    NONE = 1,
+    COMMON_LIGATURES = 2,
+    NO_COMMON_LIGATURES = 3,
+    DISCRETIONARY_LIGATURES = 4,
+    NO_DISCRETIONARY_LIGATURES = 5,
+    HISTORICAL_LIGATURES = 6,
+    NO_HISTORICAL_LIGATURES = 7,
+    CONTEXTUAL = 8,
+    NO_CONTEXTUAL = 9
+}
+export declare const fontVariantLigatures: IPropertyIdentValueDescriptor<FONT_VARIANT_LIGATURES>;

package/dist/types/css/property-descriptors/object-position.d.ts

@@ -0,0 +1,4 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+import { LengthPercentage } from '../types/length-percentage';
+export type ObjectPosition = [LengthPercentage, LengthPercentage];
+export declare const objectPosition: IPropertyListDescriptor<ObjectPosition>;

package/dist/types/css/property-descriptors/zoom.d.ts

@@ -0,0 +1,3 @@
+import { IPropertyValueDescriptor } from '../property-descriptor';
+export type Zoom = number;
+export declare const zoom: IPropertyValueDescriptor<Zoom>;

package/dist/types/css/types/functions/repeating-linear-gradient.d.ts

@@ -0,0 +1,4 @@
+import { CSSValue } from '../../syntax/parser';
+import { CSSLinearGradientImage } from '../image';
+import { Context } from '../../../core/context';
+export declare const repeatingLinearGradient: (context: Context, tokens: CSSValue[]) => CSSLinearGradientImage;

package/dist/types/css/types/image.d.ts

@@ -5,10 +5,12 @@ import { LengthPercentage } from './length-percentage';
 export declare const enum CSSImageType {
     URL = 0,
     LINEAR_GRADIENT = 1,
-    RADIAL_GRADIENT = 2
+    RADIAL_GRADIENT = 2,
+    REPEATING_LINEAR_GRADIENT = 3
 }
 export declare const isLinearGradient: (background: ICSSImage) => background is CSSLinearGradientImage;
 export declare const isRadialGradient: (background: ICSSImage) => background is CSSRadialGradientImage;
+export declare const isRepeatingLinearGradient: (background: ICSSImage) => background is CSSLinearGradientImage;
 export interface UnprocessedGradientColorStop {
     color: Color;
     stop: LengthPercentage | null;
@@ -30,7 +32,7 @@ interface ICSSGradientImage extends ICSSImage {
 }
 export interface CSSLinearGradientImage extends ICSSGradientImage {
     angle: number | GradientCorner;
-    type: CSSImageType.LINEAR_GRADIENT;
+    type: CSSImageType.LINEAR_GRADIENT | CSSImageType.REPEATING_LINEAR_GRADIENT;
 }
 export declare const enum CSSRadialShape {
     CIRCLE = 0,

package/dist/types/css/types/safe-eval.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Safe arithmetic expression evaluator — replaces `new Function()`.
+ *
+ * Supports only: numbers, +, -, *, /, parentheses.
+ * Does NOT execute arbitrary code. Returns NaN on any illegal token.
+ */
+declare const safeEvalArithmetic: (expr: string) => number;
+export default safeEvalArithmetic;

package/dist/types/dom/document-cloner.d.ts

@@ -25,6 +25,7 @@ export declare class DocumentCloner {
     clonedReferenceElement?: HTMLElement;
     private readonly documentElement;
     private readonly counters;
+    private readonly slotCloner;
     private quoteDepth;
     constructor(context: Context, element: HTMLElement, options: CloneConfigurations);
     toIFrame(ownerDocument: Document, windowSize: Bounds): Promise<HTMLIFrameElement>;
@@ -35,50 +36,8 @@ export declare class DocumentCloner {
     createVideoClone(video: HTMLVideoElement): HTMLCanvasElement;
     appendChildNode(clone: HTMLElement | SVGElement, child: Node, copyStyles: boolean): void;
     /**
-     * Check if a child node should be cloned based on filtering rules
-     * Filters out: scripts, ignored elements, and optionally styles
-     */
-    private shouldCloneChild;
-    /**
-     * Check if a style element should be cloned based on copyStyles option
-     */
-    private shouldCloneStyleElement;
-    /**
-     * Safely append a cloned child to a target, applying all filtering rules
-     */
-    private safeAppendClonedChild;
-    /**
-     * Clone assigned nodes from a slot element to the target
-     */
-    private cloneAssignedNodes;
-    /**
-     * Clone fallback content from a slot element when no nodes are assigned
-     */
-    private cloneSlotFallbackContent;
-    /**
-     * Handle cloning of a slot element, including assigned nodes or fallback content
-     */
-    private cloneSlotElement;
-    /**
-     * Clone shadow DOM children to the target shadow root
-     */
-    private cloneShadowDOMChildren;
-    /**
-     * Clone light DOM children to the target element
-     */
-    private cloneLightDOMChildren;
-    /**
-     * Clone slot element as light DOM when shadow root creation failed
-     */
-    private cloneSlotElementAsLightDOM;
-    /**
-     * Clone shadow DOM content as light DOM when shadow root creation failed
-     * This is a fallback mechanism to ensure content is not lost
-     */
-    private cloneShadowDOMAsLightDOM;
-    /**
-     * Clone child nodes from source element to clone element
-     * Handles shadow DOM, slots, and light DOM appropriately
+     * Clone child nodes from source element to clone element.
+     * Delegates to SlotCloner which handles shadow DOM, slots, and light DOM.
      */
     cloneChildNodes(node: Element, clone: HTMLElement | SVGElement, copyStyles: boolean): void;
     cloneNode(node: Node, copyStyles: boolean): Node;

package/dist/types/dom/slot-cloner.d.ts

@@ -0,0 +1,66 @@
+import { Context } from '../core/context';
+/** Options subset needed by SlotCloner */
+export interface SlotClonerOptions {
+    ignoreElements?: (element: Element) => boolean;
+    copyStyles: boolean;
+}
+/** Exported for reuse in document-cloner.ts */
+export declare const IGNORE_ATTRIBUTE = "data-html2canvas-ignore";
+/**
+ * Handles shadow DOM child cloning, slot assignment, and light DOM traversal.
+ * Extracted from DocumentCloner to reduce file size and improve separation of concerns.
+ */
+export declare class SlotCloner {
+    private readonly cloneNodeFn;
+    private readonly options;
+    private readonly context;
+    constructor(cloneNodeFn: (node: Node, copyStyles: boolean) => Node, options: SlotClonerOptions, context: Context);
+    appendChildNode(clone: HTMLElement | SVGElement, child: Node, copyStyles: boolean): void;
+    /**
+     * Clone child nodes from source element to clone element.
+     * Handles shadow DOM, slots, and light DOM appropriately.
+     */
+    cloneChildNodes(node: Element, clone: HTMLElement | SVGElement, copyStyles: boolean): void;
+    /**
+     * Check if a child node should be cloned based on filtering rules.
+     * Filters out: scripts, ignored elements, and optionally styles.
+     */
+    private shouldCloneChild;
+    /**
+     * Check if a style element should be cloned based on copyStyles option.
+     */
+    private shouldCloneStyleElement;
+    /**
+     * Safely append a cloned child to a target, applying all filtering rules.
+     */
+    private safeAppendClonedChild;
+    /**
+     * Clone assigned nodes from a slot element to the target.
+     */
+    private cloneAssignedNodes;
+    /**
+     * Clone fallback content from a slot element when no nodes are assigned.
+     */
+    private cloneSlotFallbackContent;
+    /**
+     * Handle cloning of a slot element, including assigned nodes or fallback content.
+     */
+    private cloneSlotElement;
+    /**
+     * Clone shadow DOM children to the target shadow root.
+     */
+    private cloneShadowDOMChildren;
+    /**
+     * Clone light DOM children to the target element.
+     */
+    private cloneLightDOMChildren;
+    /**
+     * Clone slot element as light DOM when shadow root creation failed.
+     */
+    private cloneSlotElementAsLightDOM;
+    /**
+     * Clone shadow DOM content as light DOM when shadow root creation failed.
+     * This is a fallback mechanism to ensure content is not lost.
+     */
+    private cloneShadowDOMAsLightDOM;
+}

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-import { Html2CanvasConfig, ConfigOptions } from './config';
-import { createDefaultValidator, Validator, ValidationResult } from './core/validator';
+import { Html2CanvasConfig, type ConfigOptions } from './config';
+import { createDefaultValidator, Validator, type ValidationResult } from './core/validator';
 import { PerformanceMonitor } from './core/performance-monitor';
 import type { Options } from './options';
 export type { Options };
@@ -31,10 +31,6 @@ export type { Options };
  * @throws {Error} If the element is not attached to a document.
  * @throws {DOMException} If an {@link Options.signal|AbortSignal} was provided and the operation was aborted.
  */
-declare const html2canvas: {
-    (element: HTMLElement, options?: Partial<Options>, config?: Html2CanvasConfig): Promise<HTMLCanvasElement>;
-    setCspNonce: (nonce: string) => void;
-};
+declare const html2canvas: (element: HTMLElement, options?: Partial<Options>, config?: Html2CanvasConfig) => Promise<HTMLCanvasElement>;
 export default html2canvas;
 export { html2canvas, Html2CanvasConfig, ConfigOptions, Validator, ValidationResult, createDefaultValidator, PerformanceMonitor };
-export { IMAGE_RENDERING } from './css/property-descriptors/image-rendering';

package/dist/types/options.d.ts

@@ -48,4 +48,15 @@ export type Options = CloneOptions & WindowOptions & RenderOptions & ContextOpti
      * @default browser default (usually 'low' or 'medium')
      */
     imageSmoothingQuality?: 'low' | 'medium' | 'high';
+    /**
+     * Called when a resource fails to load (image, font, iframe, etc.).
+     * The render continues — this is a notification hook, not an abort.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called at key milestones during the render pipeline.
+     * `phase` is one of: 'clone', 'parse', 'layout', 'render'.
+     * `progress` is 0..100 percentage estimate.
+     */
+    onProgress?: (phase: string, progress: number) => void;
 };

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

@@ -33,6 +33,17 @@ export declare class BackgroundRenderer {
     private readonly ctx;
     private readonly context;
     private readonly canvas;
+    /**
+     * Instance-level LRU cache for background-image patterns.
+     * CanvasPatterns are tied to the rendering context and must not be
+     * shared across different render passes. This cache lives for the
+     * duration of one html2canvas() call.
+     *
+     * Also reused for linear-gradient and repeating-linear-gradient
+     * pattern canvases to avoid redundant offscreen canvas allocation.
+     */
+    private readonly patternCache;
+    private static readonly PATTERN_CACHE_MAX;
     constructor(deps: BackgroundRendererDependencies);
     /**
      * Render background images for a container
@@ -45,6 +56,12 @@ export declare class BackgroundRenderer {
      * Render a URL-based background image
      */
     private renderBackgroundURLImage;
+    /**
+     * Render a repeating linear gradient background.
+     * Renders one cycle of the gradient to a pattern canvas, then fills
+     * the background area using createPattern('repeat').
+     */
+    private renderRepeatingLinearGradient;
     /**
      * Render a linear gradient background
      */
@@ -78,4 +95,10 @@ export declare class BackgroundRenderer {
      * @param paths - Array of path points
      */
     private path;
+    /**
+     * LRU-aware get: returns value and promotes the entry to end of Map.
+     */
+    private lruGet;
+    /** LRU-aware set for CanvasPattern caches. Evicts oldest entry on overflow. */
+    private lruSet;
 }

package/dist/types/render/canvas/border-image-renderer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Border Image Renderer
+ *
+ * Renders CSS border-image using 9-slice scaling.
+ * The source image is divided into 9 regions (4 corners, 4 edges, 1 center)
+ * based on border-image-slice values, then each region is drawn to the
+ * corresponding area of the element's border box.
+ */
+import { BorderImageSlice } from '../../css/property-descriptors/border-image-slice';
+import { BorderImageRepeat } from '../../css/property-descriptors/border-image-repeat';
+import { Bounds } from '../../css/layout/bounds';
+export declare class BorderImageRenderer {
+    private readonly ctx;
+    constructor(ctx: CanvasRenderingContext2D);
+    renderBorderImage(bounds: Bounds, image: HTMLImageElement, slice: BorderImageSlice, repeat: BorderImageRepeat, borderTopWidth: number, borderRightWidth: number, borderBottomWidth: number, borderLeftWidth: number): void;
+    private drawRegion;
+    private drawRepeatedEdge;
+}

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

@@ -40,6 +40,7 @@ export declare class CanvasRenderer {
     private readonly fontMetrics;
     private readonly backgroundRenderer;
     private readonly borderRenderer;
+    private readonly borderImageRenderer;
     private readonly effectsRenderer;
     private readonly textRenderer;
     constructor(context: Context, options: RenderConfigurations);

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

@@ -0,0 +1,44 @@
+import { ElementPaint } from '../stacking-context';
+import { ReplacedElementContainer } from '../../dom/replaced-elements';
+import { ElementContainer } from '../../dom/element-container';
+import { BoundCurves } from '../bound-curves';
+import { Vector } from '../vector';
+import { Context } from '../../core/context';
+import { TextRenderer } from './text-renderer';
+import { FontMetrics } from '../font-metrics';
+import { Color } from '../../css/types/color';
+import { CSSParsedDeclaration } from '../../css/index';
+/**
+ * Factory type for creating an iframe canvas renderer — avoids circular import
+ * from canvas-renderer.ts which in turn imports content-renderer.ts.
+ */
+type IframeRendererFactory = (context: Context, options: {
+    scale: number;
+    backgroundColor: Color | null;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}) => {
+    render: (element: ElementContainer) => Promise<HTMLCanvasElement>;
+};
+/**
+ * Render replaced elements: Image, Canvas, SVG, IFrame.
+ */
+export declare function renderReplacedElements(ctx: CanvasRenderingContext2D, context: Context, options: {
+    scale: number;
+    backgroundColor: Color | null;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, iframeRendererFactory: IframeRendererFactory, container: ElementContainer, curves: BoundCurves, styles: CSSParsedDeclaration, renderReplacedElementFn: (container: ReplacedElementContainer, curves: BoundCurves, image: HTMLImageElement | HTMLCanvasElement) => void): Promise<void>;
+/**
+ * Render form element content: checkbox, radio, text input.
+ */
+export declare function renderFormElements(ctx: CanvasRenderingContext2D, fontMetrics: FontMetrics, textRenderer: TextRenderer, pathFn: (paths: Vector[]) => void, container: ElementContainer, styles: CSSParsedDeclaration): void;
+/**
+ * Render list-item marker (image or text).
+ */
+export declare function renderListMarker(ctx: CanvasRenderingContext2D, context: Context, textRenderer: TextRenderer, paint: ElementPaint, container: ElementContainer, styles: CSSParsedDeclaration): Promise<void>;
+export {};