@embedpdf/plugin-annotation 2.7.0 → 2.9.0

package/dist/shared/annotation-bounds.d.ts

@@ -0,0 +1,14 @@
+import { Rotation } from '@embedpdf/models';
+import { TrackedAnnotation } from '../index.ts';
+export interface ScreenBounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+/**
+ * Compute the screen-space bounding box of an annotation, correctly accounting
+ * for `noZoom` (constant pixel size regardless of zoom) and `noRotate`
+ * (visually upright regardless of page rotation) annotation flags.
+ */
+export declare function getAnnotationScreenBounds(annotation: TrackedAnnotation, scale: number, rotation: Rotation): ScreenBounds;

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/caret.d.ts

@@ -0,0 +1,24 @@
+import { MouseEvent } from '../../../react/adapter.ts';
+import { Rect } from '@embedpdf/models';
+interface CaretProps {
+    /** Whether the annotation is selected */
+    isSelected: boolean;
+    /** Stroke colour */
+    strokeColor?: string;
+    /** 0 – 1 */
+    opacity?: number;
+    /** Bounding box of the annotation (PDF units) */
+    rect: Rect;
+    /** Current page zoom factor */
+    scale: number;
+    /** Click handler (used for selection) */
+    onClick?: (e: MouseEvent<SVGElement>) => void;
+    /** When true, AP canvas provides the visual; only render hit area */
+    appearanceActive?: boolean;
+}
+/**
+ * Renders a PDF Caret annotation as an SVG ^ symbol using bezier curves
+ * that mirror the C++ appearance stream.
+ */
+export declare function Caret({ isSelected, strokeColor, opacity, rect, scale, onClick, appearanceActive, }: CaretProps): JSX.Element;
+export {};

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

@@ -1,5 +1,5 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { MouseEvent } from '../../../react/adapter.ts';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface CircleProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -20,12 +20,16 @@ interface CircleProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    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/free-text.d.ts

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { MouseEvent } from '../../../react/adapter.ts';
 import { PdfFreeTextAnnoObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../../index.ts';
 interface FreeTextProps {
@@ -8,7 +8,7 @@ interface FreeTextProps {
     annotation: TrackedAnnotation<PdfFreeTextAnnoObject>;
     pageIndex: number;
     scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
     onDoubleClick?: (event: MouseEvent<HTMLDivElement>) => void;
     /** When true, AP canvas provides the visual; hide text content */
     appearanceActive?: boolean;

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { MouseEvent } from '../../../react/adapter.ts';
 import { PdfInkListObject, Rect } from '@embedpdf/models';
 interface InkProps {
     /** Whether the annotation is selected */
@@ -16,7 +16,7 @@ interface InkProps {
     /** Page zoom factor */
     scale: number;
     /** Callback for when the annotation is clicked */
-    onClick?: (e: MouseEvent<SVGPathElement> | TouchEvent<SVGPathElement>) => void;
+    onClick?: (e: MouseEvent<SVGPathElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
 }

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { MouseEvent } from '../../../react/adapter.ts';
 import { Rect, LinePoints, LineEndings, PdfAnnotationBorderStyle } from '@embedpdf/models';
 interface LineProps {
     /** interior colour */
@@ -22,7 +22,7 @@ interface LineProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     /** Whether the annotation is selected */
     isSelected: boolean;
     /** When true, AP canvas provides the visual; only render hit area */

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { MouseEvent } from '../../../react/adapter.ts';
 import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
 interface LinkProps {
     /** Whether the annotation is selected */
@@ -16,7 +16,7 @@ interface LinkProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     /** Whether this link has an IRT (In Reply To) reference - disables direct interaction */
     hasIRT?: boolean;
 }

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { MouseEvent } from '../../../react/adapter.ts';
 import { Rect, Position, PdfAnnotationBorderStyle } from '@embedpdf/models';
 interface PolygonProps {
     rect: Rect;
@@ -11,11 +11,13 @@ interface PolygonProps {
     strokeDashArray?: number[];
     scale: number;
     isSelected: boolean;
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     currentVertex?: Position;
     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/polyline.d.ts

@@ -1,5 +1,5 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
-import { Rect, Position, LineEndings } from '@embedpdf/models';
+import { MouseEvent } from '../../../react/adapter.ts';
+import { Rect, Position, LineEndings, PdfAnnotationBorderStyle } from '@embedpdf/models';
 interface PolylineProps {
     rect: Rect;
     vertices: Position[];
@@ -7,13 +7,17 @@ interface PolylineProps {
     strokeColor?: string;
     opacity?: number;
     strokeWidth: number;
+    /** Stroke style */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array */
+    strokeDashArray?: number[];
     scale: number;
     isSelected: boolean;
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     /** Optional start & end endings */
     lineEndings?: LineEndings;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
 }
-export declare function Polyline({ rect, vertices, color, strokeColor, opacity, strokeWidth, scale, isSelected, onClick, lineEndings, appearanceActive, }: PolylineProps): JSX.Element;
+export declare function Polyline({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, lineEndings, appearanceActive, }: PolylineProps): JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { MouseEvent } from '../../../react/adapter.ts';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface SquareProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -20,12 +20,16 @@ interface SquareProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    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/annotations/stamp.d.ts

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { MouseEvent } from '../../../react/adapter.ts';
 import { PdfStampAnnoObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../../index.ts';
 interface StampProps {
@@ -7,7 +7,7 @@ interface StampProps {
     documentId: string;
     pageIndex: number;
     scale: number;
-    onClick: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick: (e: MouseEvent<HTMLDivElement>) => void;
 }
 export declare function Stamp({ isSelected, annotation, documentId, pageIndex, scale, onClick, }: StampProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,14 @@
+import { MouseEvent } from '../../../react/adapter.ts';
+interface TextProps {
+    isSelected: boolean;
+    color?: string;
+    opacity?: number;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
+    appearanceActive?: boolean;
+}
+/**
+ * Renders a fallback sticky-note icon for PDF Text annotations when no
+ * appearance stream image is available.
+ */
+export declare function Text({ isSelected, color, opacity, onClick, appearanceActive, }: TextProps): JSX.Element;
+export {};

package/dist/shared/components/text-markup/highlight.d.ts

@@ -1,4 +1,4 @@
-import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { CSSProperties, MouseEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type HighlightProps = {
     /** Stroke/markup color */
@@ -7,7 +7,7 @@ type HighlightProps = {
     segmentRects: Rect[];
     rect?: Rect;
     scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
     /** When true, AP image provides the visual; only render hit area */
     appearanceActive?: boolean;

package/dist/shared/components/text-markup/squiggly.d.ts

@@ -1,4 +1,4 @@
-import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { CSSProperties, MouseEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type SquigglyProps = {
     /** Stroke/markup color */
@@ -7,7 +7,7 @@ type SquigglyProps = {
     segmentRects: Rect[];
     rect?: Rect;
     scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
     /** When true, AP image provides the visual; only render hit area */
     appearanceActive?: boolean;

package/dist/shared/components/text-markup/strikeout.d.ts

@@ -1,4 +1,4 @@
-import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { CSSProperties, MouseEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type StrikeoutProps = {
     /** Stroke/markup color */
@@ -7,7 +7,7 @@ type StrikeoutProps = {
     segmentRects: Rect[];
     rect?: Rect;
     scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
     /** When true, AP image provides the visual; only render hit area */
     appearanceActive?: boolean;

package/dist/shared/components/text-markup/underline.d.ts

@@ -1,4 +1,4 @@
-import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { CSSProperties, MouseEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type UnderlineProps = {
     /** Stroke/markup color */
@@ -7,7 +7,7 @@ type UnderlineProps = {
     segmentRects: Rect[];
     rect?: Rect;
     scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
     /** When true, AP image provides the visual; only render hit area */
     appearanceActive?: boolean;

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

@@ -1,7 +1,7 @@
-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, TouchEvent } from '../../react/adapter.ts';
+import { JSX, CSSProperties, MouseEvent } from '../../react/adapter.ts';
 import { VertexConfig } from '../types';
 export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
 export interface AnnotationSelectionContext {
@@ -110,7 +110,7 @@ export type CustomAnnotationRenderer<T extends PdfAnnotationObject> = (props: Cu
 /**
  * Properly typed event for annotation interactions (click, select, etc.)
  */
-export type AnnotationInteractionEvent = MouseEvent<Element> | TouchEvent<Element>;
+export type AnnotationInteractionEvent = MouseEvent<Element>;
 /**
  * Props for an annotation renderer entry
  */
@@ -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/annotation-bounds.d.ts

@@ -0,0 +1,14 @@
+import { Rotation } from '@embedpdf/models';
+import { TrackedAnnotation } from '../lib/index.ts';
+export interface ScreenBounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+/**
+ * Compute the screen-space bounding box of an annotation, correctly accounting
+ * for `noZoom` (constant pixel size regardless of zoom) and `noRotate`
+ * (visually upright regardless of page rotation) annotation flags.
+ */
+export declare function getAnnotationScreenBounds(annotation: TrackedAnnotation, scale: number, rotation: Rotation): ScreenBounds;

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/caret.d.ts

@@ -0,0 +1,24 @@
+import { MouseEvent } from '../../../preact/adapter.ts';
+import { Rect } from '@embedpdf/models';
+interface CaretProps {
+    /** Whether the annotation is selected */
+    isSelected: boolean;
+    /** Stroke colour */
+    strokeColor?: string;
+    /** 0 – 1 */
+    opacity?: number;
+    /** Bounding box of the annotation (PDF units) */
+    rect: Rect;
+    /** Current page zoom factor */
+    scale: number;
+    /** Click handler (used for selection) */
+    onClick?: (e: MouseEvent<SVGElement>) => void;
+    /** When true, AP canvas provides the visual; only render hit area */
+    appearanceActive?: boolean;
+}
+/**
+ * Renders a PDF Caret annotation as an SVG ^ symbol using bezier curves
+ * that mirror the C++ appearance stream.
+ */
+export declare function Caret({ isSelected, strokeColor, opacity, rect, scale, onClick, appearanceActive, }: CaretProps): JSX.Element;
+export {};

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

@@ -1,5 +1,5 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { MouseEvent } from '../../../preact/adapter.ts';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface CircleProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -20,12 +20,16 @@ interface CircleProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    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/free-text.d.ts

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
+import { MouseEvent } from '../../../preact/adapter.ts';
 import { PdfFreeTextAnnoObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../../lib/index.ts';
 interface FreeTextProps {
@@ -8,7 +8,7 @@ interface FreeTextProps {
     annotation: TrackedAnnotation<PdfFreeTextAnnoObject>;
     pageIndex: number;
     scale: number;
-    onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
     onDoubleClick?: (event: MouseEvent<HTMLDivElement>) => void;
     /** When true, AP canvas provides the visual; hide text content */
     appearanceActive?: boolean;

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
+import { MouseEvent } from '../../../preact/adapter.ts';
 import { PdfInkListObject, Rect } from '@embedpdf/models';
 interface InkProps {
     /** Whether the annotation is selected */
@@ -16,7 +16,7 @@ interface InkProps {
     /** Page zoom factor */
     scale: number;
     /** Callback for when the annotation is clicked */
-    onClick?: (e: MouseEvent<SVGPathElement> | TouchEvent<SVGPathElement>) => void;
+    onClick?: (e: MouseEvent<SVGPathElement>) => void;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
 }

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
+import { MouseEvent } from '../../../preact/adapter.ts';
 import { Rect, LinePoints, LineEndings, PdfAnnotationBorderStyle } from '@embedpdf/models';
 interface LineProps {
     /** interior colour */
@@ -22,7 +22,7 @@ interface LineProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     /** Whether the annotation is selected */
     isSelected: boolean;
     /** When true, AP canvas provides the visual; only render hit area */

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
+import { MouseEvent } from '../../../preact/adapter.ts';
 import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
 interface LinkProps {
     /** Whether the annotation is selected */
@@ -16,7 +16,7 @@ interface LinkProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     /** Whether this link has an IRT (In Reply To) reference - disables direct interaction */
     hasIRT?: boolean;
 }

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

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
+import { MouseEvent } from '../../../preact/adapter.ts';
 import { Rect, Position, PdfAnnotationBorderStyle } from '@embedpdf/models';
 interface PolygonProps {
     rect: Rect;
@@ -11,11 +11,13 @@ interface PolygonProps {
     strokeDashArray?: number[];
     scale: number;
     isSelected: boolean;
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     currentVertex?: Position;
     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/polyline.d.ts

@@ -1,5 +1,5 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
-import { Rect, Position, LineEndings } from '@embedpdf/models';
+import { MouseEvent } from '../../../preact/adapter.ts';
+import { Rect, Position, LineEndings, PdfAnnotationBorderStyle } from '@embedpdf/models';
 interface PolylineProps {
     rect: Rect;
     vertices: Position[];
@@ -7,13 +7,17 @@ interface PolylineProps {
     strokeColor?: string;
     opacity?: number;
     strokeWidth: number;
+    /** Stroke style */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array */
+    strokeDashArray?: number[];
     scale: number;
     isSelected: boolean;
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    onClick?: (e: MouseEvent<SVGElement>) => void;
     /** Optional start & end endings */
     lineEndings?: LineEndings;
     /** When true, AP canvas provides the visual; only render hit area */
     appearanceActive?: boolean;
 }
-export declare function Polyline({ rect, vertices, color, strokeColor, opacity, strokeWidth, scale, isSelected, onClick, lineEndings, appearanceActive, }: PolylineProps): JSX.Element;
+export declare function Polyline({ rect, vertices, color, strokeColor, opacity, strokeWidth, strokeStyle, strokeDashArray, scale, isSelected, onClick, lineEndings, appearanceActive, }: PolylineProps): JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
-import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+import { MouseEvent } from '../../../preact/adapter.ts';
+import { PdfAnnotationBorderStyle, PdfRectDifferences, Rect } from '@embedpdf/models';
 interface SquareProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
@@ -20,12 +20,16 @@ interface SquareProps {
     /** Current page zoom factor */
     scale: number;
     /** Click handler (used for selection) */
-    onClick?: (e: MouseEvent<SVGElement> | TouchEvent<SVGElement>) => void;
+    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/annotations/stamp.d.ts

@@ -1,4 +1,4 @@
-import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
+import { MouseEvent } from '../../../preact/adapter.ts';
 import { PdfStampAnnoObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../../lib/index.ts';
 interface StampProps {
@@ -7,7 +7,7 @@ interface StampProps {
     documentId: string;
     pageIndex: number;
     scale: number;
-    onClick: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
+    onClick: (e: MouseEvent<HTMLDivElement>) => void;
 }
 export declare function Stamp({ isSelected, annotation, documentId, pageIndex, scale, onClick, }: StampProps): import("preact").JSX.Element;
 export {};