html2canvas-pro 2.5.0 → 2.5.1

package/dist/types/core/cache-storage.d.ts

@@ -5,6 +5,11 @@ export interface ResourceOptions {
     allowTaint: boolean;
     proxy?: string;
     customIsSameOrigin?: (this: void, src: string, oldFn: (src: string) => boolean) => boolean | Promise<boolean>;
+    /**
+     * LRU cap for normal-mode (immediate) loads. Default: 100.
+     * Suspended between startDefer() and preloadAll() so every image collected
+     * during a render stays available to the renderer, which never reloads.
+     */
     maxCacheSize?: number;
 }
 export declare class Cache {
@@ -17,6 +22,19 @@ export declare class Cache {
     private _deferMode;
     /** URLs collected during defer mode, pending batch preload. */
     private _collectedUrls;
+    /**
+     * Eviction is suspended between startDefer() and the end of preloadAll():
+     * the render pipeline loads every image it is going to paint inside that
+     * window, and match() never reloads, so an LRU eviction there would
+     * silently drop images from the output on pages with more unique images
+     * than maxSize.
+     *
+     * A counter (not a flag) keeps nested/overlapping defer windows — e.g.
+     * two renders sharing one cache via `config.cache` — suspended until the
+     * last one finishes preloading.
+     */
+    private _evictionSuspendCount;
+    private get _evictionEnabled();
     constructor(context: Context, _options: ResourceOptions);
     /**
      * Enter defer mode: subsequent addImage() calls only collect URLs.

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

@@ -3,9 +3,6 @@ export interface LoggerOptions {
     enabled: boolean;
 }
 export declare class Logger {
-    static instances: {
-        [key: string]: Logger;
-    };
     private readonly id;
     private readonly enabled;
     private readonly start;

package/dist/types/css/types/functions/conic-gradient.d.ts

@@ -9,3 +9,9 @@ import { Context } from '../../../core/context';
  * may carry the from/at clauses; every following group is a color stop.
  */
 export declare const conicGradient: (context: Context, tokens: CSSValue[]) => CSSConicGradientImage;
+/**
+ * repeating-conic-gradient shares the conic-gradient grammar exactly; only
+ * the image type differs, which switches the renderer to periodic stops
+ * stacked across the full sweep.
+ */
+export declare const repeatingConicGradient: (context: Context, tokens: CSSValue[]) => CSSConicGradientImage;

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

@@ -8,13 +8,15 @@ export declare const enum CSSImageType {
     RADIAL_GRADIENT = 2,
     REPEATING_LINEAR_GRADIENT = 3,
     REPEATING_RADIAL_GRADIENT = 4,
-    CONIC_GRADIENT = 5
+    CONIC_GRADIENT = 5,
+    REPEATING_CONIC_GRADIENT = 6
 }
 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 declare const isRepeatingRadialGradient: (background: ICSSImage) => background is CSSRadialGradientImage;
 export declare const isConicGradient: (background: ICSSImage) => background is CSSConicGradientImage;
+export declare const isRepeatingConicGradient: (background: ICSSImage) => background is CSSConicGradientImage;
 export interface UnprocessedGradientColorStop {
     color: Color;
     stop: LengthPercentage | null;
@@ -60,7 +62,7 @@ export interface CSSRadialGradientImage extends ICSSGradientImage {
  * `angle` is the `from` angle in radians, measured clockwise from 12 o'clock.
  */
 export interface CSSConicGradientImage extends ICSSGradientImage {
-    type: CSSImageType.CONIC_GRADIENT;
+    type: CSSImageType.CONIC_GRADIENT | CSSImageType.REPEATING_CONIC_GRADIENT;
     angle: number;
     position: LengthPercentage[];
 }

package/dist/types/dom/replaced-elements/input-element-container.d.ts

@@ -3,7 +3,7 @@ import { Context } from '../../core/context';
 export declare const CHECKBOX = "checkbox";
 export declare const RADIO = "radio";
 export declare const PASSWORD = "password";
-export declare const INPUT_COLOR = 707406591;
+export declare const INPUT_COLOR = 7733247;
 export declare const PLACEHOLDER_COLOR = 1970632191;
 export declare class InputElementContainer extends ElementContainer {
     readonly type: string;

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

@@ -85,6 +85,15 @@ export declare class BackgroundRenderer {
      * CSS `from <angle>`.
      */
     private renderConicGradient;
+    /**
+     * Render a repeating conic gradient background.
+     *
+     * Canvas conic gradient stops span the full 2π sweep as [0, 1], so the
+     * one-cycle stop list is stacked k·period + s for k = 0..cycles-1 over the
+     * whole sweep — the same periodic-stop stacking the repeating linear and
+     * radial renderers use along their gradient lines.
+     */
+    private renderRepeatingConicGradient;
     /**
      * Render a repeating pattern with offset
      *

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

@@ -81,6 +81,14 @@ export declare class CanvasRenderer {
      * offset outwards. Outlines paint atop content and do not affect layout.
      */
     private renderOutline;
+    /**
+     * Rasterise a gradient border-image-source across the border image area.
+     * CSS allows any <image> as the border-image source; gradients are painted
+     * over the whole border-image box and then sliced by the regular 9-slice
+     * pipeline, matching browser behaviour for `border-image: linear-gradient()`.
+     * Returns null when the gradient could not be painted.
+     */
+    private rasterizeGradientSource;
     /**
      * Filter the already-painted content beneath the element's border box and
      * paint the result back, approximating CSS backdrop-filter for the

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

@@ -16,6 +16,13 @@ import { Path } from '../path';
  */
 export interface EffectsRendererDependencies {
     ctx: CanvasRenderingContext2D;
+    /**
+     * Device-pixel ratio of the bound context. Canvas shadow metrics
+     * (offset/blur) live in device space, unaffected by the context
+     * transform, so drop-shadow() blur must be scaled like the offsets.
+     * Defaults to 1.
+     */
+    scale?: number;
 }
 /**
  * Path callback for clip effects
@@ -57,6 +64,7 @@ export interface EffectsPathCallback {
 export declare class EffectsRenderer {
     private readonly ctx;
     private readonly pathCallback;
+    private readonly scale;
     private readonly activeEffects;
     /** Whether a canvas state save was performed for the current batch. */
     private didSave;

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

@@ -9,8 +9,15 @@
  * Extracted from CanvasRenderer to keep paint orchestration separate from
  * this self-contained compositing algorithm.
  *
- * The offscreen canvas uses CSS-pixel dimensions (not device-pixel) because the
- * background renderer handles scaling internally via BackgroundRenderer options.
+ * The offscreen and mask canvases are backed at device-pixel resolution
+ * (bounds × scale) with their contexts scaled to CSS pixels, so the
+ * composite back onto the main canvas maps 1:1 onto the backing store and
+ * stays sharp at devicePixelRatio > 1.
+ *
+ * Matching browser paint order for clipped text:
+ * - text shadows render *beneath* the clipped background (silhouettes in
+ *   the shadow colour), they are not part of the clip region;
+ * - -webkit-text-stroke is part of the clip region (fill ∪ stroke band).
  */
 import { ElementPaint } from '../stacking-context';
 import { CSSParsedDeclaration } from '../../css';
@@ -19,18 +26,31 @@ export interface TextClipRendererDependencies {
     /** Main canvas context the clipped background is composited onto. */
     ctx: CanvasRenderingContext2D;
     context: Context;
+    /** Device-pixel ratio shared with the main renderer. */
+    scale: number;
     /** Font builder shared with the text renderer so both use identical fonts. */
     createFontStyle: (styles: CSSParsedDeclaration) => string[];
 }
 export declare class TextClipRenderer {
     private readonly ctx;
     private readonly context;
+    private readonly scale;
     private readonly createFontStyle;
     constructor(deps: TextClipRendererDependencies);
     render(paint: ElementPaint): Promise<void>;
+    private createLayer;
+    private createGlyphLayer;
+    /**
+     * Draw one text bound onto a glyph layer, splitting into per-glyph draws
+     * when letter-spacing is in effect so the layout matches the main text
+     * renderer. Vertical writing modes fall back to a single draw call.
+     */
+    private drawGlyphs;
     /**
-     * Render text glyphs one-by-one as a mask, applying letter-spacing between characters.
-     * This ensures the mask matches how the text renderer lays out the characters.
+     * Paint the text-shadow silhouettes for every glyph, one canvas per
+     * shadow, returned front-to-back (the last shadow sits deepest). Returns
+     * null when the element has no text shadows.
      */
-    private renderTextMaskWithLetterSpacing;
+    private renderShadowSilhouettes;
+    private getTextStrokeLineJoin;
 }

package/package.json

@@ -19,7 +19,7 @@
       "default": "./dist/html2canvas-pro.esm.js"
     }
   },
-  "version": "2.5.0",
+  "version": "2.5.1",
   "author": {
     "name": "yorickshan",
     "email": "yorickshan@gmail.com",
@@ -31,7 +31,7 @@
     "screenshot"
   ],
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=24.0.0"
   },
   "homepage": "https://yorickshan.github.io/html2canvas-pro/",
   "repository": {
@@ -117,7 +117,7 @@
     "build:create-reftest-list": "tsx scripts/create-reftest-list.ts tests/reftests/ignore.txt build/reftests.js",
     "release": "sh scripts/version-upgrade.sh",
     "format": "prettier --write \"{src,tests,scripts}/**/*.ts\"",
-    "lint": "eslint src/**/*.ts --max-warnings 0",
+    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" \"scripts/**/*.ts\" \"scripts/**/*.mjs\" --max-warnings 0",
     "test": "pnpm lint && pnpm unittest && pnpm karma",
     "unittest": "vitest run",
     "unittest:coverage": "vitest run --coverage",