@embedpdf/plugin-annotation 2.8.0 → 2.9.0

package/dist/shared/components/annotation-container.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject, AnnotationAppearances } from '@embedpdf/models';
+import { PdfAnnotationObject, AnnotationAppearances, CssBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../index.ts';
 import { JSX, CSSProperties } from '../../react/adapter.ts';
 import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, AnnotationInteractionEvent, VertexHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer, SelectionOutline } from './types';
@@ -32,6 +32,8 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     onSelect: (event: AnnotationInteractionEvent) => void;
     /** Pre-rendered appearance stream images for AP mode rendering */
     appearance?: AnnotationAppearances<Blob> | null;
+    /** Blend mode applied only to the visual content (children + AP image), not to interaction handles */
+    blendMode?: CssBlendMode;
     zIndex?: number;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
@@ -53,5 +55,5 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
  * When isMultiSelected is true, the container becomes passive - drag/resize
  * is handled by the GroupSelectionBox instead.
  */
-export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isEditing, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, appearance, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
+export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isEditing, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, blendMode, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, appearance, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
 export {};

package/dist/shared/components/annotations/circle.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent } from '../../../react/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface CircleProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -23,9 +23,13 @@ interface CircleProps {
     onClick?: (e: MouseEvent<SVGElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
+    /** Rectangle differences – inset from Rect to drawn area */
+    rectangleDifferences?: PdfRectDifferences;
 }
 /**
  * Renders a PDF Circle annotation (ellipse) as SVG.
  */
-export declare function Circle({ color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, isSelected, appearanceActive, }: CircleProps): JSX.Element;
+export declare function Circle({ color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, isSelected, appearanceActive, cloudyBorderIntensity, rectangleDifferences, }: CircleProps): JSX.Element;
 export {};

package/dist/shared/components/annotations/polygon.d.ts

@@ -16,6 +16,8 @@ interface PolygonProps {
     handleSize?: number;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
 }
-export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, currentVertex, handleSize, appearanceActive, }: PolygonProps): JSX.Element;
+export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, currentVertex, handleSize, appearanceActive, cloudyBorderIntensity, }: PolygonProps): JSX.Element;
 export {};

package/dist/shared/components/annotations/square.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent } from '../../../react/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface SquareProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -23,9 +23,13 @@ interface SquareProps {
     onClick?: (e: MouseEvent<SVGElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
+    /** Rectangle differences – inset from Rect to drawn area */
+    rectangleDifferences?: PdfRectDifferences;
 }
 /**
  * Renders a PDF Square annotation (rectangle) as SVG.
  */
-export declare function Square({ isSelected, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, appearanceActive, }: SquareProps): JSX.Element;
+export declare function Square({ isSelected, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, appearanceActive, cloudyBorderIntensity, rectangleDifferences, }: SquareProps): JSX.Element;
 export {};

package/dist/shared/components/types.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../react/utils.ts';
 import { JSX, CSSProperties, MouseEvent } from '../../react/adapter.ts';
@@ -152,7 +152,9 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     vertexConfig?: VertexConfig<T>;
     /** z-index for the annotation container (default: 1, text markup uses 0) */
     zIndex?: number;
-    /** Style applied to the annotation container (overrides default blendMode style) */
+    /** Default blend mode for this annotation type (used when annotation.blendMode is not set) */
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: T) => CSSProperties;
     /** Type-specific interaction fallbacks used when the tool doesn't define a property */
     interactionDefaults?: {
@@ -184,6 +186,8 @@ export interface BoxedAnnotationRenderer {
     render: (props: AnnotationRendererProps) => JSX.Element;
     vertexConfig?: VertexConfig<PdfAnnotationObject>;
     zIndex?: number;
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: PdfAnnotationObject) => CSSProperties;
     interactionDefaults?: {
         isDraggable?: boolean;

package/dist/shared-preact/components/annotation-container.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject, AnnotationAppearances } from '@embedpdf/models';
+import { PdfAnnotationObject, AnnotationAppearances, CssBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { JSX, CSSProperties } from '../../preact/adapter.ts';
 import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, AnnotationInteractionEvent, VertexHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer, SelectionOutline } from './types';
@@ -32,6 +32,8 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     onSelect: (event: AnnotationInteractionEvent) => void;
     /** Pre-rendered appearance stream images for AP mode rendering */
     appearance?: AnnotationAppearances<Blob> | null;
+    /** Blend mode applied only to the visual content (children + AP image), not to interaction handles */
+    blendMode?: CssBlendMode;
     zIndex?: number;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
@@ -53,5 +55,5 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
  * When isMultiSelected is true, the container becomes passive - drag/resize
  * is handled by the GroupSelectionBox instead.
  */
-export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isEditing, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, appearance, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
+export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isEditing, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, blendMode, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, appearance, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
 export {};

package/dist/shared-preact/components/annotations/circle.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent } from '../../../preact/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface CircleProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -23,9 +23,13 @@ interface CircleProps {
     onClick?: (e: MouseEvent<SVGElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
+    /** Rectangle differences – inset from Rect to drawn area */
+    rectangleDifferences?: PdfRectDifferences;
 }
 /**
  * Renders a PDF Circle annotation (ellipse) as SVG.
  */
-export declare function Circle({ color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, isSelected, appearanceActive, }: CircleProps): JSX.Element;
+export declare function Circle({ color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, isSelected, appearanceActive, cloudyBorderIntensity, rectangleDifferences, }: CircleProps): JSX.Element;
 export {};

package/dist/shared-preact/components/annotations/polygon.d.ts

@@ -16,6 +16,8 @@ interface PolygonProps {
     handleSize?: number;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
 }
-export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, currentVertex, handleSize, appearanceActive, }: PolygonProps): JSX.Element;
+export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, currentVertex, handleSize, appearanceActive, cloudyBorderIntensity, }: PolygonProps): JSX.Element;
 export {};

package/dist/shared-preact/components/annotations/square.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent } from '../../../preact/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface SquareProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -23,9 +23,13 @@ interface SquareProps {
     onClick?: (e: MouseEvent<SVGElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
+    /** Rectangle differences – inset from Rect to drawn area */
+    rectangleDifferences?: PdfRectDifferences;
 }
 /**
  * Renders a PDF Square annotation (rectangle) as SVG.
  */
-export declare function Square({ isSelected, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, appearanceActive, }: SquareProps): JSX.Element;
+export declare function Square({ isSelected, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, appearanceActive, cloudyBorderIntensity, rectangleDifferences, }: SquareProps): JSX.Element;
 export {};

package/dist/shared-preact/components/types.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../preact/utils.ts';
 import { JSX, CSSProperties, MouseEvent } from '../../preact/adapter.ts';
@@ -152,7 +152,9 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     vertexConfig?: VertexConfig<T>;
     /** z-index for the annotation container (default: 1, text markup uses 0) */
     zIndex?: number;
-    /** Style applied to the annotation container (overrides default blendMode style) */
+    /** Default blend mode for this annotation type (used when annotation.blendMode is not set) */
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: T) => CSSProperties;
     /** Type-specific interaction fallbacks used when the tool doesn't define a property */
     interactionDefaults?: {
@@ -184,6 +186,8 @@ export interface BoxedAnnotationRenderer {
     render: (props: AnnotationRendererProps) => JSX.Element;
     vertexConfig?: VertexConfig<PdfAnnotationObject>;
     zIndex?: number;
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: PdfAnnotationObject) => CSSProperties;
     interactionDefaults?: {
         isDraggable?: boolean;

package/dist/shared-react/components/annotation-container.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject, AnnotationAppearances } from '@embedpdf/models';
+import { PdfAnnotationObject, AnnotationAppearances, CssBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { JSX, CSSProperties } from '../../react/adapter.ts';
 import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, AnnotationInteractionEvent, VertexHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer, SelectionOutline } from './types';
@@ -32,6 +32,8 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     onSelect: (event: AnnotationInteractionEvent) => void;
     /** Pre-rendered appearance stream images for AP mode rendering */
     appearance?: AnnotationAppearances<Blob> | null;
+    /** Blend mode applied only to the visual content (children + AP image), not to interaction handles */
+    blendMode?: CssBlendMode;
     zIndex?: number;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
@@ -53,5 +55,5 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
  * When isMultiSelected is true, the container becomes passive - drag/resize
  * is handled by the GroupSelectionBox instead.
  */
-export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isEditing, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, appearance, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
+export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isEditing, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, blendMode, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, appearance, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
 export {};

package/dist/shared-react/components/annotations/circle.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent } from '../../../react/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface CircleProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -23,9 +23,13 @@ interface CircleProps {
     onClick?: (e: MouseEvent<SVGElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
+    /** Rectangle differences – inset from Rect to drawn area */
+    rectangleDifferences?: PdfRectDifferences;
 }
 /**
  * Renders a PDF Circle annotation (ellipse) as SVG.
  */
-export declare function Circle({ color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, isSelected, appearanceActive, }: CircleProps): JSX.Element;
+export declare function Circle({ color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, isSelected, appearanceActive, cloudyBorderIntensity, rectangleDifferences, }: CircleProps): JSX.Element;
 export {};

package/dist/shared-react/components/annotations/polygon.d.ts

@@ -16,6 +16,8 @@ interface PolygonProps {
     handleSize?: number;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
 }
-export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, currentVertex, handleSize, appearanceActive, }: PolygonProps): JSX.Element;
+export declare function Polygon({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, currentVertex, handleSize, appearanceActive, cloudyBorderIntensity, }: PolygonProps): JSX.Element;
 export {};

package/dist/shared-react/components/annotations/square.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent } from '../../../react/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface SquareProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -23,9 +23,13 @@ interface SquareProps {
     onClick?: (e: MouseEvent<SVGElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
+    /** Cloudy border intensity (0 = no cloud, typically 1 or 2) */
+    cloudyBorderIntensity?: number;
+    /** Rectangle differences – inset from Rect to drawn area */
+    rectangleDifferences?: PdfRectDifferences;
 }
 /**
  * Renders a PDF Square annotation (rectangle) as SVG.
  */
-export declare function Square({ isSelected, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, appearanceActive, }: SquareProps): JSX.Element;
+export declare function Square({ isSelected, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, appearanceActive, cloudyBorderIntensity, rectangleDifferences, }: SquareProps): JSX.Element;
 export {};

package/dist/shared-react/components/types.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../react/utils.ts';
 import { JSX, CSSProperties, MouseEvent } from '../../react/adapter.ts';
@@ -152,7 +152,9 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     vertexConfig?: VertexConfig<T>;
     /** z-index for the annotation container (default: 1, text markup uses 0) */
     zIndex?: number;
-    /** Style applied to the annotation container (overrides default blendMode style) */
+    /** Default blend mode for this annotation type (used when annotation.blendMode is not set) */
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: T) => CSSProperties;
     /** Type-specific interaction fallbacks used when the tool doesn't define a property */
     interactionDefaults?: {
@@ -184,6 +186,8 @@ export interface BoxedAnnotationRenderer {
     render: (props: AnnotationRendererProps) => JSX.Element;
     vertexConfig?: VertexConfig<PdfAnnotationObject>;
     zIndex?: number;
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: PdfAnnotationObject) => CSSProperties;
     interactionDefaults?: {
         isDraggable?: boolean;

package/dist/svelte/components/annotations/Circle.svelte.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface CircleProps {
     isSelected: boolean;
     color?: string;
@@ -11,6 +11,8 @@ interface CircleProps {
     scale: number;
     onClick?: (e: PointerEvent) => void;
     appearanceActive?: boolean;
+    cloudyBorderIntensity?: number;
+    rectangleDifferences?: PdfRectDifferences;
 }
 declare const Circle: import('svelte', { with: { "resolution-mode": "import" } }).Component<CircleProps, {}, "">;
 type Circle = ReturnType<typeof Circle>;

package/dist/svelte/components/annotations/Polygon.svelte.d.ts

@@ -14,6 +14,7 @@ interface PolygonProps {
     currentVertex?: Position;
     handleSize?: number;
     appearanceActive?: boolean;
+    cloudyBorderIntensity?: number;
 }
 declare const Polygon: import('svelte', { with: { "resolution-mode": "import" } }).Component<PolygonProps, {}, "">;
 type Polygon = ReturnType<typeof Polygon>;

package/dist/svelte/components/annotations/Square.svelte.d.ts

@@ -1,4 +1,4 @@
-import { Rect, PdfAnnotationBorderStyle } from '@embedpdf/models';
+import { Rect, PdfRectDifferences, PdfAnnotationBorderStyle } from '@embedpdf/models';
 interface SquareProps {
     isSelected: boolean;
     color?: string;
@@ -11,6 +11,8 @@ interface SquareProps {
     scale: number;
     onClick?: (e: MouseEvent) => void;
     appearanceActive?: boolean;
+    cloudyBorderIntensity?: number;
+    rectangleDifferences?: PdfRectDifferences;
 }
 declare const Square: import('svelte', { with: { "resolution-mode": "import" } }).Component<SquareProps, {}, "">;
 type Square = ReturnType<typeof Square>;

package/dist/svelte/components/types.d.ts

@@ -1,7 +1,7 @@
 import { Snippet } from 'svelte';
 import { CustomAnnotationRenderer, ResizeHandleUI, VertexHandleUI, RotationHandleUI, SelectionOutline, AnnotationSelectionMenuRenderFn, AnnotationSelectionMenuProps, GroupSelectionMenuRenderFn } from '../types';
 import { VertexConfig } from '../../shared-svelte/types';
-import { PdfAnnotationObject, AnnotationAppearances } from '@embedpdf/models';
+import { PdfAnnotationObject, AnnotationAppearances, CssBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { BoxedAnnotationRenderer } from '../context';
 export interface AnnotationContainerProps<T extends PdfAnnotationObject> {
@@ -26,6 +26,7 @@ export interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     lockAspectRatio?: boolean;
     class?: string;
     style?: string;
+    blendMode?: CssBlendMode;
     vertexConfig?: VertexConfig<T>;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
     selectionMenuSnippet?: Snippet<[AnnotationSelectionMenuProps]>;

package/dist/svelte/context/types.d.ts

@@ -1,5 +1,5 @@
 import { Component } from 'svelte';
-import { PdfAnnotationObject } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfBlendMode } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { VertexConfig } from '../../shared-svelte/types';
 /**
@@ -46,7 +46,9 @@ export interface AnnotationRendererEntry<T extends PdfAnnotationObject = PdfAnno
     vertexConfig?: VertexConfig<T>;
     /** z-index for the annotation container (default: 1, text markup uses 0) */
     zIndex?: number;
-    /** Style applied to the annotation container (overrides default blendMode style) */
+    /** Default blend mode for this annotation type (used when the annotation object has no blendMode set) */
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: T) => string;
     /** Type-specific interaction fallbacks used when the tool doesn't define a property */
     interactionDefaults?: {
@@ -77,6 +79,8 @@ export interface BoxedAnnotationRenderer {
     component: Component<AnnotationRendererProps>;
     vertexConfig?: VertexConfig<PdfAnnotationObject>;
     zIndex?: number;
+    defaultBlendMode?: PdfBlendMode;
+    /** Style applied to the annotation container — overrides the default blend-mode style. */
     containerStyle?: (annotation: PdfAnnotationObject) => string;
     interactionDefaults?: {
         isDraggable?: boolean;