html2canvas-pro 2.1.1 → 2.2.1

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

@@ -0,0 +1,18 @@
+/**
+ * Text Decoration Renderer
+ *
+ * Handles rendering of text-decoration lines:
+ * - underline, overline, line-through
+ * - solid, double, dotted, dashed, wavy styles
+ * Extracted from TextRenderer to reduce file size.
+ */
+import { Bounds } from '../../../css/layout/bounds';
+import { CSSParsedDeclaration } from '../../../css';
+export declare class TextDecorationRenderer {
+    private readonly ctx;
+    constructor(ctx: CanvasRenderingContext2D);
+    render(bounds: Bounds, styles: CSSParsedDeclaration): void;
+    private draw;
+    private drawPattern;
+    private drawWavy;
+}

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

@@ -36,6 +36,7 @@ export declare const hasCJKCharacters: (text: string) => boolean;
 export declare class TextRenderer {
     private readonly ctx;
     private readonly options;
+    private readonly decorationRenderer;
     constructor(deps: TextRendererDependencies);
     /**
      * Iterate grapheme clusters one-by-one, applying correct letter-spacing and
@@ -71,12 +72,22 @@ export declare class TextRenderer {
      */
     private renderTextBoundWithPaintOrder;
     private renderTextDecoration;
-    private drawDecorationLine;
     private truncateTextWithEllipsis;
     /**
      * Create font style array
      * Public method used by list rendering
      */
     createFontStyle(styles: CSSParsedDeclaration): string[];
+    /**
+     * Render text with -webkit-line-clamp truncation.
+     * Groups text bounds by their Y position into visual lines, then renders
+     * only the first N-1 complete lines followed by an ellipsis on the Nth line.
+     */
+    private renderLineClampedText;
+    /**
+     * Render single-line text with text-overflow: ellipsis.
+     * Returns true if ellipsis was applied (caller should skip normal rendering).
+     */
+    private renderEllipsisText;
     renderTextNode(text: TextContainer, styles: CSSParsedDeclaration, containerBounds?: Bounds): Promise<void>;
 }

package/dist/types/render/effects.d.ts

@@ -1,11 +1,13 @@
 import { Matrix } from '../css/property-descriptors/transform';
+import { MixBlendMode } from '../css/property-descriptors/mix-blend-mode';
 import { Path } from './path';
 export declare const enum EffectType {
     TRANSFORM = 0,
     CLIP = 1,
     OPACITY = 2,
     CLIP_PATH = 3,
-    BLEND = 4
+    BLEND = 4,
+    FILTER = 5
 }
 export declare const enum EffectTarget {
     BACKGROUND_BORDERS = 2,
@@ -48,13 +50,21 @@ export declare class ClipPathEffect implements IElementEffect {
     constructor(applyClip: (ctx: CanvasRenderingContext2D) => void);
 }
 export declare class BlendEffect implements IElementEffect {
+    readonly mixBlendMode: MixBlendMode;
+    readonly type: EffectType;
+    readonly target: number;
     readonly compositeOperation: GlobalCompositeOperation;
+    constructor(mixBlendMode: MixBlendMode);
+}
+export declare class FilterEffect implements IElementEffect {
+    readonly filterString: string;
     readonly type: EffectType;
     readonly target: number;
-    constructor(compositeOperation: GlobalCompositeOperation);
+    constructor(filterString: string);
 }
 export declare const isTransformEffect: (effect: IElementEffect) => effect is TransformEffect;
 export declare const isClipEffect: (effect: IElementEffect) => effect is ClipEffect;
 export declare const isOpacityEffect: (effect: IElementEffect) => effect is OpacityEffect;
 export declare const isClipPathEffect: (effect: IElementEffect) => effect is ClipPathEffect;
 export declare const isBlendEffect: (effect: IElementEffect) => effect is BlendEffect;
+export declare const isFilterEffect: (effect: IElementEffect) => effect is FilterEffect;

package/dist/types/render/object-fit.d.ts

@@ -1,4 +1,5 @@
 import { ObjectFit } from '../css/property-descriptors/object-fit';
+import { LengthPercentage } from '../css/types/length-percentage';
 export interface ObjectFitBox {
     left: number;
     top: number;
@@ -15,4 +16,4 @@ export interface ObjectFitRendering {
     dw: number;
     dh: number;
 }
-export declare const calculateObjectFitRendering: (intrinsicWidth: number, intrinsicHeight: number, box: ObjectFitBox, objectFit: ObjectFit) => ObjectFitRendering;
+export declare const calculateObjectFitRendering: (intrinsicWidth: number, intrinsicHeight: number, box: ObjectFitBox, objectFit: ObjectFit, objectPosition?: [LengthPercentage, LengthPercentage]) => ObjectFitRendering;

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

@@ -1,23 +1,25 @@
 /**
- * Base interface for all specialized renderers
- * Each renderer is responsible for rendering a specific aspect of an element
+ * Base interface for all specialized renderers.
+ * Each renderer is responsible for rendering a specific aspect of an element.
+ *
+ * @internal This interface is a structural contract; prefer using concrete
+ *           renderer classes (BackgroundRenderer, BorderRenderer, etc.)
+ *           directly rather than relying on the generic IRenderer shape.
  */
 export interface IRenderer {
-    /**
-     * Render the specified aspect of the element
-     */
-    render(...args: any[]): void | Promise<void>;
+    render(...args: unknown[]): void | Promise<void>;
 }
 /**
- * Common dependencies required by renderers
+ * Common dependencies required by renderers.
+ * RenderConfigurations from canvas-renderer.ts provides a concrete type.
  */
 export interface RendererDependencies {
     ctx: CanvasRenderingContext2D;
     scale: number;
-    options: any;
+    options: Record<string, unknown>;
 }
 /**
- * Performance tracking for renderers
+ * Performance tracking for renderers.
  */
 export interface RenderMetrics {
     renderCount: number;

package/package.json

@@ -19,7 +19,7 @@
       "default": "./dist/html2canvas-pro.esm.js"
     }
   },
-  "version": "2.1.1",
+  "version": "2.2.1",
   "author": {
     "name": "yorickshan",
     "email": "yorickshan@gmail.com",
@@ -41,10 +41,6 @@
   "devDependencies": {
     "@commitlint/cli": "^20.3.0",
     "@commitlint/config-conventional": "^20.2.0",
-    "@rollup/plugin-commonjs": "^29.0.0",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.3.0",
     "@types/chai": "^5.2.3",
     "@types/express": "^5.0.6",
     "@types/karma": "^6.3.0",
@@ -91,8 +87,7 @@
     "puppeteer": "^24.34.0",
     "replace-in-file": "^8.4.0",
     "rimraf": "^6.0.1",
-    "rollup": "^4.24.2",
-    "rollup-plugin-sourcemaps": "^0.6.3",
+    "rolldown": "^1.1.2",
     "serve-index": "^1.9.1",
     "slash": "5.1.0",
     "ts-node": "^10.9.2",
@@ -116,8 +111,8 @@
   },
   "scripts": {
     "prebuild": "rimraf dist/ && rimraf build/ && mkdir -p dist && mkdir -p build",
-    "build": "tsc --module commonjs -p tsconfig.build.json && rollup --configPlugin typescript -c rollup.config.ts && pnpm build:create-reftest-list && rollup --configPlugin typescript -c tests/rollup.config.ts && pnpm build:minify",
-    "build:testrunner": "rollup --configPlugin typescript -c tests/rollup.config.ts",
+    "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 && pnpm build:minify",
+    "build:testrunner": "rolldown -c tests/rolldown.testrunner.config.ts",
     "build:minify": "uglifyjs --compress --comments /^!/ -o dist/html2canvas-pro.min.js --mangle -- dist/html2canvas-pro.js",
     "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",
@@ -131,7 +126,7 @@
     "reftests-diff": "mkdir -p tmp/snapshots && vitest run --config vitest.reftest.config.ts",
     "prekarma": "node scripts/ensure-karma-prereqs.mjs",
     "karma": "tsx tests/karma",
-    "watch": "rollup --configPlugin typescript -c rollup.config.ts -w",
+    "watch": "rolldown -w",
     "watch:unittest": "vitest",
     "start": "tsx tests/server --port=8080 --cors=8081",
     "commitlint": "commitlint --config .commitlintrc.json -e -V",