@embedpdf/plugin-annotation 2.2.0 → 2.3.0

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

@@ -13,6 +13,8 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     trackedAnnotation: TrackedAnnotation<T>;
     children: JSX.Element | ((annotation: T) => JSX.Element);
     isSelected: boolean;
+    /** Whether multiple annotations are selected (container becomes passive) */
+    isMultiSelected?: boolean;
     isDraggable: boolean;
     isResizable: boolean;
     lockAspectRatio?: boolean;
@@ -28,5 +30,10 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     selectionOutlineColor?: string;
     customAnnotationRenderer?: CustomAnnotationRenderer<T>;
 }
-export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationContainerProps<T>): JSX.Element;
+/**
+ * AnnotationContainer wraps individual annotations with interaction handles.
+ * 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, isMultiSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationContainerProps<T>): JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { HTMLAttributes, CSSProperties } from '../../react/adapter.ts';
-import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn } from './types';
+import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn } from './types';
 import { PdfAnnotationObject } from '@embedpdf/models';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -9,6 +9,8 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     rotation?: number;
     /** Customize selection menu across all annotations on this layer */
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    /** Customize group selection menu across all annotations on this layer */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     style?: CSSProperties;
     /** Customize resize handles */
     resizeUI?: ResizeHandleUI;
@@ -19,5 +21,5 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
 };
-export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -3,8 +3,8 @@ import { PdfInkListObject, Rect } from '@embedpdf/models';
 interface InkProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
-    /** Stroke colour (falls back to PDFium default black) */
-    color?: string;
+    /** Stroke color */
+    strokeColor?: string;
     /** 0 – 1 */
     opacity?: number;
     /** Line width in PDF units */
@@ -21,5 +21,5 @@ interface InkProps {
 /**
  * Renders a PDF Ink annotation (free-hand drawing) as SVG.
  */
-export declare function Ink({ isSelected, color, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
+export declare function Ink({ isSelected, strokeColor, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
 export {};

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

@@ -0,0 +1,28 @@
+import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+interface LinkProps {
+    /** Whether the annotation is selected */
+    isSelected: boolean;
+    /** Stroke colour – defaults to blue when omitted */
+    strokeColor?: string;
+    /** Stroke width in PDF units */
+    strokeWidth?: number;
+    /** Stroke type – defaults to underline when omitted */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array – for dashed style */
+    strokeDashArray?: 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> | TouchEvent<SVGElement>) => void;
+    /** Whether this link has an IRT (In Reply To) reference - disables direct interaction */
+    hasIRT?: boolean;
+}
+/**
+ * Renders a PDF Link annotation as SVG.
+ * Supports underline (default), solid, and dashed border styles.
+ */
+export declare function Link({ isSelected, strokeColor, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, hasIRT, }: LinkProps): JSX.Element;
+export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -8,6 +8,7 @@ interface AnnotationsProps {
     pageWidth: number;
     pageHeight: number;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
     selectionOutlineColor?: string;

package/dist/shared/components/group-selection-box.d.ts

@@ -0,0 +1,32 @@
+import { TrackedAnnotation } from '../../index.ts';
+import { ResizeHandleUI, GroupSelectionMenuRenderFn } from './types';
+interface GroupSelectionBoxProps {
+    documentId: string;
+    pageIndex: number;
+    scale: number;
+    rotation: number;
+    pageWidth: number;
+    pageHeight: number;
+    /** All selected annotations on this page */
+    selectedAnnotations: TrackedAnnotation[];
+    /** Whether the group is draggable (all annotations must be group-draggable) */
+    isDraggable: boolean;
+    /** Whether the group is resizable (all annotations must be group-resizable) */
+    isResizable: boolean;
+    /** Resize handle UI customization */
+    resizeUI?: ResizeHandleUI;
+    /** Selection outline color */
+    selectionOutlineColor?: string;
+    /** Outline offset */
+    outlineOffset?: number;
+    /** Z-index for the group box */
+    zIndex?: number;
+    /** Group selection menu render function */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+}
+/**
+ * GroupSelectionBox renders a bounding box around all selected annotations
+ * with drag and resize handles for group manipulation.
+ */
+export declare function GroupSelectionBox({ documentId, pageIndex, scale, rotation, pageWidth, pageHeight, selectedAnnotations, isDraggable, isResizable, resizeUI, selectionOutlineColor, outlineOffset, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
+export {};

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

@@ -1 +1,2 @@
 export * from './annotation-layer';
+export * from './group-selection-box';

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type HighlightProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type HighlightProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Highlight({ color, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("react/jsx-runtime").JSX.Element;
+export declare function Highlight({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type SquigglyProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type SquigglyProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Squiggly({ color, opacity, segmentRects, rect, scale, onClick, style, }: SquigglyProps): import("react/jsx-runtime").JSX.Element;
+export declare function Squiggly({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: SquigglyProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type StrikeoutProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type StrikeoutProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Strikeout({ color, opacity, segmentRects, rect, scale, onClick, style, }: StrikeoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function Strikeout({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: StrikeoutProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type UnderlineProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type UnderlineProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Underline({ color, opacity, segmentRects, rect, scale, onClick, style, }: UnderlineProps): import("react/jsx-runtime").JSX.Element;
+export declare function Underline({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: UnderlineProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -10,6 +10,13 @@ export interface AnnotationSelectionContext {
 }
 export type AnnotationSelectionMenuProps = SelectionMenuPropsBase<AnnotationSelectionContext>;
 export type AnnotationSelectionMenuRenderFn = SelectionMenuRenderFn<AnnotationSelectionContext>;
+export interface GroupSelectionContext {
+    type: 'group';
+    annotations: TrackedAnnotation[];
+    pageIndex: number;
+}
+export type GroupSelectionMenuProps = SelectionMenuPropsBase<GroupSelectionContext>;
+export type GroupSelectionMenuRenderFn = SelectionMenuRenderFn<GroupSelectionContext>;
 export type HandleProps = HandleElementProps & {
     backgroundColor?: string;
 };

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

@@ -13,6 +13,8 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     trackedAnnotation: TrackedAnnotation<T>;
     children: JSX.Element | ((annotation: T) => JSX.Element);
     isSelected: boolean;
+    /** Whether multiple annotations are selected (container becomes passive) */
+    isMultiSelected?: boolean;
     isDraggable: boolean;
     isResizable: boolean;
     lockAspectRatio?: boolean;
@@ -28,5 +30,10 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     selectionOutlineColor?: string;
     customAnnotationRenderer?: CustomAnnotationRenderer<T>;
 }
-export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationContainerProps<T>): JSX.Element;
+/**
+ * AnnotationContainer wraps individual annotations with interaction handles.
+ * 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, isMultiSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationContainerProps<T>): JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { HTMLAttributes, CSSProperties } from '../../preact/adapter.ts';
-import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn } from './types';
+import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn } from './types';
 import { PdfAnnotationObject } from '@embedpdf/models';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -9,6 +9,8 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     rotation?: number;
     /** Customize selection menu across all annotations on this layer */
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    /** Customize group selection menu across all annotations on this layer */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     style?: CSSProperties;
     /** Customize resize handles */
     resizeUI?: ResizeHandleUI;
@@ -19,5 +21,5 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
 };
-export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("preact").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("preact").JSX.Element;
 export {};

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

@@ -3,8 +3,8 @@ import { PdfInkListObject, Rect } from '@embedpdf/models';
 interface InkProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
-    /** Stroke colour (falls back to PDFium default black) */
-    color?: string;
+    /** Stroke color */
+    strokeColor?: string;
     /** 0 – 1 */
     opacity?: number;
     /** Line width in PDF units */
@@ -21,5 +21,5 @@ interface InkProps {
 /**
  * Renders a PDF Ink annotation (free-hand drawing) as SVG.
  */
-export declare function Ink({ isSelected, color, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
+export declare function Ink({ isSelected, strokeColor, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
 export {};

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

@@ -0,0 +1,28 @@
+import { MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
+import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+interface LinkProps {
+    /** Whether the annotation is selected */
+    isSelected: boolean;
+    /** Stroke colour – defaults to blue when omitted */
+    strokeColor?: string;
+    /** Stroke width in PDF units */
+    strokeWidth?: number;
+    /** Stroke type – defaults to underline when omitted */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array – for dashed style */
+    strokeDashArray?: 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> | TouchEvent<SVGElement>) => void;
+    /** Whether this link has an IRT (In Reply To) reference - disables direct interaction */
+    hasIRT?: boolean;
+}
+/**
+ * Renders a PDF Link annotation as SVG.
+ * Supports underline (default), solid, and dashed border styles.
+ */
+export declare function Link({ isSelected, strokeColor, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, hasIRT, }: LinkProps): JSX.Element;
+export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -8,6 +8,7 @@ interface AnnotationsProps {
     pageWidth: number;
     pageHeight: number;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
     selectionOutlineColor?: string;

package/dist/shared-preact/components/group-selection-box.d.ts

@@ -0,0 +1,32 @@
+import { TrackedAnnotation } from '../../lib/index.ts';
+import { ResizeHandleUI, GroupSelectionMenuRenderFn } from './types';
+interface GroupSelectionBoxProps {
+    documentId: string;
+    pageIndex: number;
+    scale: number;
+    rotation: number;
+    pageWidth: number;
+    pageHeight: number;
+    /** All selected annotations on this page */
+    selectedAnnotations: TrackedAnnotation[];
+    /** Whether the group is draggable (all annotations must be group-draggable) */
+    isDraggable: boolean;
+    /** Whether the group is resizable (all annotations must be group-resizable) */
+    isResizable: boolean;
+    /** Resize handle UI customization */
+    resizeUI?: ResizeHandleUI;
+    /** Selection outline color */
+    selectionOutlineColor?: string;
+    /** Outline offset */
+    outlineOffset?: number;
+    /** Z-index for the group box */
+    zIndex?: number;
+    /** Group selection menu render function */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+}
+/**
+ * GroupSelectionBox renders a bounding box around all selected annotations
+ * with drag and resize handles for group manipulation.
+ */
+export declare function GroupSelectionBox({ documentId, pageIndex, scale, rotation, pageWidth, pageHeight, selectedAnnotations, isDraggable, isResizable, resizeUI, selectionOutlineColor, outlineOffset, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
+export {};

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

@@ -1 +1,2 @@
 export * from './annotation-layer';
+export * from './group-selection-box';

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type HighlightProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type HighlightProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Highlight({ color, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("preact").JSX.Element;
+export declare function Highlight({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("preact").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type SquigglyProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type SquigglyProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Squiggly({ color, opacity, segmentRects, rect, scale, onClick, style, }: SquigglyProps): import("preact").JSX.Element;
+export declare function Squiggly({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: SquigglyProps): import("preact").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type StrikeoutProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type StrikeoutProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Strikeout({ color, opacity, segmentRects, rect, scale, onClick, style, }: StrikeoutProps): import("preact").JSX.Element;
+export declare function Strikeout({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: StrikeoutProps): import("preact").JSX.Element;
 export {};

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../preact/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type UnderlineProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type UnderlineProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Underline({ color, opacity, segmentRects, rect, scale, onClick, style, }: UnderlineProps): import("preact").JSX.Element;
+export declare function Underline({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: UnderlineProps): import("preact").JSX.Element;
 export {};

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

@@ -10,6 +10,13 @@ export interface AnnotationSelectionContext {
 }
 export type AnnotationSelectionMenuProps = SelectionMenuPropsBase<AnnotationSelectionContext>;
 export type AnnotationSelectionMenuRenderFn = SelectionMenuRenderFn<AnnotationSelectionContext>;
+export interface GroupSelectionContext {
+    type: 'group';
+    annotations: TrackedAnnotation[];
+    pageIndex: number;
+}
+export type GroupSelectionMenuProps = SelectionMenuPropsBase<GroupSelectionContext>;
+export type GroupSelectionMenuRenderFn = SelectionMenuRenderFn<GroupSelectionContext>;
 export type HandleProps = HandleElementProps & {
     backgroundColor?: string;
 };

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

@@ -13,6 +13,8 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     trackedAnnotation: TrackedAnnotation<T>;
     children: JSX.Element | ((annotation: T) => JSX.Element);
     isSelected: boolean;
+    /** Whether multiple annotations are selected (container becomes passive) */
+    isMultiSelected?: boolean;
     isDraggable: boolean;
     isResizable: boolean;
     lockAspectRatio?: boolean;
@@ -28,5 +30,10 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     selectionOutlineColor?: string;
     customAnnotationRenderer?: CustomAnnotationRenderer<T>;
 }
-export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationContainerProps<T>): JSX.Element;
+/**
+ * AnnotationContainer wraps individual annotations with interaction handles.
+ * 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, isMultiSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationContainerProps<T>): JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { HTMLAttributes, CSSProperties } from '../../react/adapter.ts';
-import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn } from './types';
+import { ResizeHandleUI, VertexHandleUI, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn } from './types';
 import { PdfAnnotationObject } from '@embedpdf/models';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -9,6 +9,8 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     rotation?: number;
     /** Customize selection menu across all annotations on this layer */
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    /** Customize group selection menu across all annotations on this layer */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     style?: CSSProperties;
     /** Customize resize handles */
     resizeUI?: ResizeHandleUI;
@@ -19,5 +21,5 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
 };
-export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -3,8 +3,8 @@ import { PdfInkListObject, Rect } from '@embedpdf/models';
 interface InkProps {
     /** Whether the annotation is selected */
     isSelected: boolean;
-    /** Stroke colour (falls back to PDFium default black) */
-    color?: string;
+    /** Stroke color */
+    strokeColor?: string;
     /** 0 – 1 */
     opacity?: number;
     /** Line width in PDF units */
@@ -21,5 +21,5 @@ interface InkProps {
 /**
  * Renders a PDF Ink annotation (free-hand drawing) as SVG.
  */
-export declare function Ink({ isSelected, color, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
+export declare function Ink({ isSelected, strokeColor, opacity, strokeWidth, inkList, rect, scale, onClick, }: InkProps): JSX.Element;
 export {};

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

@@ -0,0 +1,28 @@
+import { MouseEvent, TouchEvent } from '../../../react/adapter.ts';
+import { PdfAnnotationBorderStyle, Rect } from '@embedpdf/models';
+interface LinkProps {
+    /** Whether the annotation is selected */
+    isSelected: boolean;
+    /** Stroke colour – defaults to blue when omitted */
+    strokeColor?: string;
+    /** Stroke width in PDF units */
+    strokeWidth?: number;
+    /** Stroke type – defaults to underline when omitted */
+    strokeStyle?: PdfAnnotationBorderStyle;
+    /** Stroke dash array – for dashed style */
+    strokeDashArray?: 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> | TouchEvent<SVGElement>) => void;
+    /** Whether this link has an IRT (In Reply To) reference - disables direct interaction */
+    hasIRT?: boolean;
+}
+/**
+ * Renders a PDF Link annotation as SVG.
+ * Supports underline (default), solid, and dashed border styles.
+ */
+export declare function Link({ isSelected, strokeColor, strokeWidth, strokeStyle, strokeDashArray, rect, scale, onClick, hasIRT, }: LinkProps): JSX.Element;
+export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -8,6 +8,7 @@ interface AnnotationsProps {
     pageWidth: number;
     pageHeight: number;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
     selectionOutlineColor?: string;

package/dist/shared-react/components/group-selection-box.d.ts

@@ -0,0 +1,32 @@
+import { TrackedAnnotation } from '../../lib/index.ts';
+import { ResizeHandleUI, GroupSelectionMenuRenderFn } from './types';
+interface GroupSelectionBoxProps {
+    documentId: string;
+    pageIndex: number;
+    scale: number;
+    rotation: number;
+    pageWidth: number;
+    pageHeight: number;
+    /** All selected annotations on this page */
+    selectedAnnotations: TrackedAnnotation[];
+    /** Whether the group is draggable (all annotations must be group-draggable) */
+    isDraggable: boolean;
+    /** Whether the group is resizable (all annotations must be group-resizable) */
+    isResizable: boolean;
+    /** Resize handle UI customization */
+    resizeUI?: ResizeHandleUI;
+    /** Selection outline color */
+    selectionOutlineColor?: string;
+    /** Outline offset */
+    outlineOffset?: number;
+    /** Z-index for the group box */
+    zIndex?: number;
+    /** Group selection menu render function */
+    groupSelectionMenu?: GroupSelectionMenuRenderFn;
+}
+/**
+ * GroupSelectionBox renders a bounding box around all selected annotations
+ * with drag and resize handles for group manipulation.
+ */
+export declare function GroupSelectionBox({ documentId, pageIndex, scale, rotation, pageWidth, pageHeight, selectedAnnotations, isDraggable, isResizable, resizeUI, selectionOutlineColor, outlineOffset, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
+export {};

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

@@ -1 +1,2 @@
 export * from './annotation-layer';
+export * from './group-selection-box';

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

@@ -1,7 +1,8 @@
 import { CSSProperties, MouseEvent, TouchEvent } from '../../../react/adapter.ts';
 import { Rect } from '@embedpdf/models';
 type HighlightProps = {
-    color?: string;
+    /** Stroke/markup color */
+    strokeColor?: string;
     opacity?: number;
     segmentRects: Rect[];
     rect?: Rect;
@@ -9,5 +10,5 @@ type HighlightProps = {
     onClick?: (e: MouseEvent<HTMLDivElement> | TouchEvent<HTMLDivElement>) => void;
     style?: CSSProperties;
 };
-export declare function Highlight({ color, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("react/jsx-runtime").JSX.Element;
+export declare function Highlight({ strokeColor, opacity, segmentRects, rect, scale, onClick, style, }: HighlightProps): import("react/jsx-runtime").JSX.Element;
 export {};