html2canvas-pro 1.6.7 → 2.0.1

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

@@ -0,0 +1,65 @@
+/**
+ * Effects Renderer
+ *
+ * Handles rendering effects including:
+ * - Opacity effects
+ * - Transform effects (matrix transformations)
+ * - Clip effects (overflow / border-radius clipping via Path[])
+ * - Clip-path effects (CSS clip-path shapes: inset, circle, ellipse, polygon, path)
+ */
+import { IElementEffect } from '../effects';
+import { Path } from '../path';
+/**
+ * Dependencies required for EffectsRenderer
+ */
+export interface EffectsRendererDependencies {
+    ctx: CanvasRenderingContext2D;
+}
+/**
+ * Path callback for clip effects
+ */
+export interface EffectsPathCallback {
+    path(paths: Path[]): void;
+}
+/**
+ * Effects Renderer
+ *
+ * Manages rendering effects stack including opacity, transforms, and clipping.
+ * Extracted from CanvasRenderer to improve code organization and maintainability.
+ */
+export declare class EffectsRenderer {
+    private readonly ctx;
+    private readonly pathCallback;
+    private readonly activeEffects;
+    constructor(deps: EffectsRendererDependencies, pathCallback: EffectsPathCallback);
+    /**
+     * Apply multiple effects
+     * Clears existing effects and applies new ones
+     *
+     * @param effects - Array of effects to apply
+     */
+    applyEffects(effects: IElementEffect[]): void;
+    /**
+     * Apply a single effect
+     *
+     * @param effect - Effect to apply
+     */
+    applyEffect(effect: IElementEffect): void;
+    /**
+     * Remove the most recent effect
+     * Restores the canvas state before the effect was applied
+     */
+    popEffect(): void;
+    /**
+     * Get the current number of active effects
+     *
+     * @returns Number of active effects
+     */
+    getActiveEffectCount(): number;
+    /**
+     * Check if there are any active effects
+     *
+     * @returns True if there are active effects
+     */
+    hasActiveEffects(): boolean;
+}

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

@@ -0,0 +1,75 @@
+/**
+ * Text Renderer
+ *
+ * Handles rendering of text content including:
+ * - Text with letter spacing
+ * - Text decorations (underline, overline, line-through)
+ * - Text shadows
+ * - Webkit line clamp
+ * - Text overflow ellipsis
+ * - Paint order (fill/stroke)
+ * - Font styles
+ */
+import { Context } from '../../core/context';
+import { TextContainer } from '../../dom/text-container';
+import { CSSParsedDeclaration } from '../../css';
+import { Bounds } from '../../css/layout/bounds';
+import { TextBounds } from '../../css/layout/text';
+/**
+ * Dependencies required for TextRenderer
+ */
+export interface TextRendererDependencies {
+    ctx: CanvasRenderingContext2D;
+    context: Context;
+    options: {
+        scale: number;
+    };
+}
+export declare const hasCJKCharacters: (text: string) => boolean;
+/**
+ * Text Renderer
+ *
+ * Specialized renderer for text content.
+ * Extracted from CanvasRenderer to improve code organization and maintainability.
+ */
+export declare class TextRenderer {
+    private readonly ctx;
+    private readonly options;
+    constructor(deps: TextRendererDependencies);
+    /**
+     * Iterate grapheme clusters one-by-one, applying correct letter-spacing and
+     * per-script baseline for each character.
+     *
+     * Issue #73: When letter-spacing is non-zero, text must be rendered character by
+     * character. This helper centralises two fixes applied during that iteration:
+     *   1. Add `letterSpacing` to each character's advance width (was previously
+     *      omitted, causing characters to render without any spacing).
+     *   2. Switch to the ideographic baseline for CJK glyphs so their vertical
+     *      position matches how browsers lay them out in the DOM.
+     *
+     * The `renderFn` callback receives (letter, x, y) and performs the actual draw
+     * call (fillText or strokeText), allowing fill and stroke paths to share one
+     * implementation.
+     */
+    private iterateLettersWithLetterSpacing;
+    /**
+     * Render text with letter-spacing applied (fill pass).
+     * When letterSpacing is 0 the whole string is drawn in one call; otherwise each
+     * grapheme is drawn individually so spacing and CJK baseline are applied correctly.
+     */
+    renderTextWithLetterSpacing(text: TextBounds, letterSpacing: number, baseline: number): void;
+    /**
+     * Helper method to render text with paint order support
+     * Reduces code duplication in line-clamp and normal rendering
+     */
+    private renderTextBoundWithPaintOrder;
+    private renderTextDecoration;
+    private drawDecorationLine;
+    private truncateTextWithEllipsis;
+    /**
+     * Create font style array
+     * Public method used by list rendering
+     */
+    createFontStyle(styles: CSSParsedDeclaration): string[];
+    renderTextNode(text: TextContainer, styles: CSSParsedDeclaration, containerBounds?: Bounds): Promise<void>;
+}

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

@@ -3,7 +3,8 @@ import { Path } from './path';
 export declare const enum EffectType {
     TRANSFORM = 0,
     CLIP = 1,
-    OPACITY = 2
+    OPACITY = 2,
+    CLIP_PATH = 3
 }
 export declare const enum EffectTarget {
     BACKGROUND_BORDERS = 2,
@@ -33,6 +34,19 @@ export declare class OpacityEffect implements IElementEffect {
     readonly target: number;
     constructor(opacity: number);
 }
+/**
+ * Clips the element and all its descendants to an arbitrary canvas-drawn shape.
+ * The `applyClip` callback is responsible for calling beginPath, the shape
+ * operations, and ctx.clip() — giving each shape type full control over how
+ * the path is constructed (arc, ellipse, lineTo, Path2D, etc.).
+ */
+export declare class ClipPathEffect implements IElementEffect {
+    readonly applyClip: (ctx: CanvasRenderingContext2D) => void;
+    readonly type: EffectType;
+    readonly target: number;
+    constructor(applyClip: (ctx: CanvasRenderingContext2D) => void);
+}
 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;

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

@@ -0,0 +1,26 @@
+/**
+ * Base interface for all specialized renderers
+ * Each renderer is responsible for rendering a specific aspect of an element
+ */
+export interface IRenderer {
+    /**
+     * Render the specified aspect of the element
+     */
+    render(...args: any[]): void | Promise<void>;
+}
+/**
+ * Common dependencies required by renderers
+ */
+export interface RendererDependencies {
+    ctx: CanvasRenderingContext2D;
+    scale: number;
+    options: any;
+}
+/**
+ * Performance tracking for renderers
+ */
+export interface RenderMetrics {
+    renderCount: number;
+    totalTime: number;
+    averageTime: number;
+}

package/package.json

@@ -14,7 +14,7 @@
       "default": "./dist/html2canvas-pro.esm.js"
     }
   },
-  "version": "1.6.7",
+  "version": "2.0.1",
   "author": {
     "name": "yorickshan",
     "email": "yorickshan@gmail.com",
@@ -58,6 +58,7 @@
     "appium-ios-simulator": "^8.0.9",
     "base64-arraybuffer": "1.0.2",
     "body-parser": "^2.2.1",
+    "change-case": "^5.4.4",
     "chai": "6.2.2",
     "conventional-changelog-cli": "^5.0.0",
     "cors": "^2.8.5",