@embedpdf/plugin-annotation 2.4.1 → 2.6.0

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../index.ts';
 import { JSX, CSSProperties } from '../../react/adapter.ts';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer, SelectionOutline } from './types';
 import { VertexConfig } from '../types';
 interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     scale: number;
@@ -17,21 +17,29 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     isMultiSelected?: boolean;
     isDraggable: boolean;
     isResizable: boolean;
+    isRotatable?: boolean;
     lockAspectRatio?: boolean;
     style?: CSSProperties;
     vertexConfig?: VertexConfig<T>;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    /** @deprecated Use `selectionOutline.offset` instead */
     outlineOffset?: number;
     onDoubleClick?: (event: any) => void;
     onSelect: (event: any) => void;
     zIndex?: number;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline.color` instead */
     selectionOutlineColor?: string;
+    /** Customize the selection outline (color, style, width, offset) */
+    selectionOutline?: SelectionOutline;
     customAnnotationRenderer?: CustomAnnotationRenderer<T>;
     /** Passed from parent but not used - destructured to prevent DOM spread */
     groupSelectionMenu?: GroupSelectionMenuRenderFn;
     /** Passed from parent but not used - destructured to prevent DOM spread */
+    groupSelectionOutline?: SelectionOutline;
+    /** Passed from parent but not used - destructured to prevent DOM spread */
     annotationRenderers?: BoxedAnnotationRenderer[];
 }
 /**
@@ -39,5 +47,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, isMultiSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
+export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...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, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
+import { ResizeHandleUI, VertexHandleUI, RotationHandleUI, SelectionOutline, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
 import { PdfAnnotationObject } from '@embedpdf/models';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -16,12 +16,18 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     resizeUI?: ResizeHandleUI;
     /** Customize vertex handles */
     vertexUI?: VertexHandleUI;
-    /** Customize selection outline color */
+    /** Customize rotation handle */
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline` instead */
     selectionOutlineColor?: string;
+    /** Customize the selection outline for individual annotations */
+    selectionOutline?: SelectionOutline;
+    /** Customize the selection outline for the group selection box (falls back to selectionOutline) */
+    groupSelectionOutline?: SelectionOutline;
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
     /** Custom renderers for specific annotation types (provided by external plugins) */
     annotationRenderers?: BoxedAnnotationRenderer[];
 };
-export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, groupSelectionOutline, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, BoxedAnnotationRenderer } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, RotationHandleUI, SelectionOutline, BoxedAnnotationRenderer } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -11,7 +11,10 @@ interface AnnotationsProps {
     groupSelectionMenu?: GroupSelectionMenuRenderFn;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
+    rotationUI?: RotationHandleUI;
     selectionOutlineColor?: string;
+    selectionOutline?: SelectionOutline;
+    groupSelectionOutline?: SelectionOutline;
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
     /** Custom renderers for specific annotation types (provided by external plugins) */
     annotationRenderers?: BoxedAnnotationRenderer[];

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

@@ -1,5 +1,5 @@
 import { TrackedAnnotation } from '../../index.ts';
-import { ResizeHandleUI, GroupSelectionMenuRenderFn } from './types';
+import { ResizeHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, SelectionOutline } from './types';
 interface GroupSelectionBoxProps {
     documentId: string;
     pageIndex: number;
@@ -13,12 +13,20 @@ interface GroupSelectionBoxProps {
     isDraggable: boolean;
     /** Whether the group is resizable (all annotations must be group-resizable) */
     isResizable: boolean;
+    /** Whether the group can be rotated */
+    isRotatable?: boolean;
+    /** Whether to lock aspect ratio during group resize */
+    lockAspectRatio?: boolean;
     /** Resize handle UI customization */
     resizeUI?: ResizeHandleUI;
-    /** Selection outline color */
+    /** Rotation handle UI customization */
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline.color` instead */
     selectionOutlineColor?: string;
-    /** Outline offset */
+    /** @deprecated Use `selectionOutline.offset` instead */
     outlineOffset?: number;
+    /** Customize the selection outline (color, style, width, offset) */
+    selectionOutline?: SelectionOutline;
     /** Z-index for the group box */
     zIndex?: number;
     /** Group selection menu render function */
@@ -28,5 +36,5 @@ interface GroupSelectionBoxProps {
  * 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 declare function GroupSelectionBox({ documentId, pageIndex, scale, rotation, pageWidth, pageHeight, selectedAnnotations, isDraggable, isResizable, isRotatable, lockAspectRatio, resizeUI, rotationUI, selectionOutlineColor, outlineOffset, selectionOutline, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
 export {};

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

@@ -7,6 +7,7 @@ type RenderAnnotationProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {
     scaleFactor?: number;
     dpr?: number;
     style?: CSSProperties;
+    unrotated?: boolean;
 };
-export declare function RenderAnnotation({ documentId, pageIndex, annotation, scaleFactor, style, ...props }: RenderAnnotationProps): import("react/jsx-runtime").JSX.Element;
+export declare function RenderAnnotation({ documentId, pageIndex, annotation, scaleFactor, unrotated, style, ...props }: RenderAnnotationProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../react/utils.ts';
-import { JSX, MouseEvent, TouchEvent } from '../../react/adapter.ts';
+import { JSX, CSSProperties, MouseEvent, TouchEvent } from '../../react/adapter.ts';
 export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
 export interface AnnotationSelectionContext {
     type: 'annotation';
@@ -38,6 +38,56 @@ export interface VertexHandleUI {
     /** Custom renderer for each vertex (overrides default) */
     component?: (p: HandleProps) => JSX.Element;
 }
+/** Props for the rotation handle component */
+export interface RotationHandleComponentProps extends HandleProps {
+    /** Props for the connector line element */
+    connectorStyle?: CSSProperties;
+    /** Whether to show the connector line */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Resolved border configuration */
+    border?: RotationHandleBorder;
+}
+export type BorderStyle = 'solid' | 'dashed' | 'dotted';
+export interface SelectionOutline {
+    /** Outline color (default: '#007ACC') */
+    color?: string;
+    /** Outline style (default: 'solid' for single, 'dashed' for group) */
+    style?: BorderStyle;
+    /** Outline width in px (default: 1 for single, 2 for group) */
+    width?: number;
+    /** Outline offset in px (default: 1 for single, 2 for group) */
+    offset?: number;
+}
+/** Border configuration for the rotation handle */
+export interface RotationHandleBorder {
+    /** Border color (default: '#007ACC') */
+    color?: string;
+    /** Border style (default: 'solid') */
+    style?: BorderStyle;
+    /** Border width in px (default: 1) */
+    width?: number;
+}
+/** UI customization for rotation handle */
+export interface RotationHandleUI {
+    /** Handle size in CSS px (default: 16) */
+    size?: number;
+    /** Gap in CSS px between the bounding box edge and the rotation handle center (default: 20) */
+    margin?: number;
+    /** Default background color for the handle (default: 'white') */
+    color?: string;
+    /** Color for the connector line (default: '#007ACC') */
+    connectorColor?: string;
+    /** Whether to show the connector line (default: true) */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Border configuration for the handle */
+    border?: RotationHandleBorder;
+    /** Custom renderer for the rotation handle (overrides default) */
+    component?: (p: RotationHandleComponentProps) => JSX.Element;
+}
 /**
  * Props for the custom annotation renderer
  */

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { JSX, CSSProperties } from '../../preact/adapter.ts';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer, SelectionOutline } from './types';
 import { VertexConfig } from '../types';
 interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     scale: number;
@@ -17,21 +17,29 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     isMultiSelected?: boolean;
     isDraggable: boolean;
     isResizable: boolean;
+    isRotatable?: boolean;
     lockAspectRatio?: boolean;
     style?: CSSProperties;
     vertexConfig?: VertexConfig<T>;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    /** @deprecated Use `selectionOutline.offset` instead */
     outlineOffset?: number;
     onDoubleClick?: (event: any) => void;
     onSelect: (event: any) => void;
     zIndex?: number;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline.color` instead */
     selectionOutlineColor?: string;
+    /** Customize the selection outline (color, style, width, offset) */
+    selectionOutline?: SelectionOutline;
     customAnnotationRenderer?: CustomAnnotationRenderer<T>;
     /** Passed from parent but not used - destructured to prevent DOM spread */
     groupSelectionMenu?: GroupSelectionMenuRenderFn;
     /** Passed from parent but not used - destructured to prevent DOM spread */
+    groupSelectionOutline?: SelectionOutline;
+    /** Passed from parent but not used - destructured to prevent DOM spread */
     annotationRenderers?: BoxedAnnotationRenderer[];
 }
 /**
@@ -39,5 +47,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, isMultiSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
+export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...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, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
+import { ResizeHandleUI, VertexHandleUI, RotationHandleUI, SelectionOutline, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
 import { PdfAnnotationObject } from '@embedpdf/models';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -16,12 +16,18 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     resizeUI?: ResizeHandleUI;
     /** Customize vertex handles */
     vertexUI?: VertexHandleUI;
-    /** Customize selection outline color */
+    /** Customize rotation handle */
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline` instead */
     selectionOutlineColor?: string;
+    /** Customize the selection outline for individual annotations */
+    selectionOutline?: SelectionOutline;
+    /** Customize the selection outline for the group selection box (falls back to selectionOutline) */
+    groupSelectionOutline?: SelectionOutline;
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
     /** Custom renderers for specific annotation types (provided by external plugins) */
     annotationRenderers?: BoxedAnnotationRenderer[];
 };
-export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("preact").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, groupSelectionOutline, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("preact").JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, BoxedAnnotationRenderer } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, RotationHandleUI, SelectionOutline, BoxedAnnotationRenderer } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -11,7 +11,10 @@ interface AnnotationsProps {
     groupSelectionMenu?: GroupSelectionMenuRenderFn;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
+    rotationUI?: RotationHandleUI;
     selectionOutlineColor?: string;
+    selectionOutline?: SelectionOutline;
+    groupSelectionOutline?: SelectionOutline;
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
     /** Custom renderers for specific annotation types (provided by external plugins) */
     annotationRenderers?: BoxedAnnotationRenderer[];

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

@@ -1,5 +1,5 @@
 import { TrackedAnnotation } from '../../lib/index.ts';
-import { ResizeHandleUI, GroupSelectionMenuRenderFn } from './types';
+import { ResizeHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, SelectionOutline } from './types';
 interface GroupSelectionBoxProps {
     documentId: string;
     pageIndex: number;
@@ -13,12 +13,20 @@ interface GroupSelectionBoxProps {
     isDraggable: boolean;
     /** Whether the group is resizable (all annotations must be group-resizable) */
     isResizable: boolean;
+    /** Whether the group can be rotated */
+    isRotatable?: boolean;
+    /** Whether to lock aspect ratio during group resize */
+    lockAspectRatio?: boolean;
     /** Resize handle UI customization */
     resizeUI?: ResizeHandleUI;
-    /** Selection outline color */
+    /** Rotation handle UI customization */
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline.color` instead */
     selectionOutlineColor?: string;
-    /** Outline offset */
+    /** @deprecated Use `selectionOutline.offset` instead */
     outlineOffset?: number;
+    /** Customize the selection outline (color, style, width, offset) */
+    selectionOutline?: SelectionOutline;
     /** Z-index for the group box */
     zIndex?: number;
     /** Group selection menu render function */
@@ -28,5 +36,5 @@ interface GroupSelectionBoxProps {
  * 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 declare function GroupSelectionBox({ documentId, pageIndex, scale, rotation, pageWidth, pageHeight, selectedAnnotations, isDraggable, isResizable, isRotatable, lockAspectRatio, resizeUI, rotationUI, selectionOutlineColor, outlineOffset, selectionOutline, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
 export {};

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

@@ -7,6 +7,7 @@ type RenderAnnotationProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {
     scaleFactor?: number;
     dpr?: number;
     style?: CSSProperties;
+    unrotated?: boolean;
 };
-export declare function RenderAnnotation({ documentId, pageIndex, annotation, scaleFactor, style, ...props }: RenderAnnotationProps): import("preact").JSX.Element;
+export declare function RenderAnnotation({ documentId, pageIndex, annotation, scaleFactor, unrotated, style, ...props }: RenderAnnotationProps): import("preact").JSX.Element;
 export {};

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../preact/utils.ts';
-import { JSX, MouseEvent, TouchEvent } from '../../preact/adapter.ts';
+import { JSX, CSSProperties, MouseEvent, TouchEvent } from '../../preact/adapter.ts';
 export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
 export interface AnnotationSelectionContext {
     type: 'annotation';
@@ -38,6 +38,56 @@ export interface VertexHandleUI {
     /** Custom renderer for each vertex (overrides default) */
     component?: (p: HandleProps) => JSX.Element;
 }
+/** Props for the rotation handle component */
+export interface RotationHandleComponentProps extends HandleProps {
+    /** Props for the connector line element */
+    connectorStyle?: CSSProperties;
+    /** Whether to show the connector line */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Resolved border configuration */
+    border?: RotationHandleBorder;
+}
+export type BorderStyle = 'solid' | 'dashed' | 'dotted';
+export interface SelectionOutline {
+    /** Outline color (default: '#007ACC') */
+    color?: string;
+    /** Outline style (default: 'solid' for single, 'dashed' for group) */
+    style?: BorderStyle;
+    /** Outline width in px (default: 1 for single, 2 for group) */
+    width?: number;
+    /** Outline offset in px (default: 1 for single, 2 for group) */
+    offset?: number;
+}
+/** Border configuration for the rotation handle */
+export interface RotationHandleBorder {
+    /** Border color (default: '#007ACC') */
+    color?: string;
+    /** Border style (default: 'solid') */
+    style?: BorderStyle;
+    /** Border width in px (default: 1) */
+    width?: number;
+}
+/** UI customization for rotation handle */
+export interface RotationHandleUI {
+    /** Handle size in CSS px (default: 16) */
+    size?: number;
+    /** Gap in CSS px between the bounding box edge and the rotation handle center (default: 20) */
+    margin?: number;
+    /** Default background color for the handle (default: 'white') */
+    color?: string;
+    /** Color for the connector line (default: '#007ACC') */
+    connectorColor?: string;
+    /** Whether to show the connector line (default: true) */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Border configuration for the handle */
+    border?: RotationHandleBorder;
+    /** Custom renderer for the rotation handle (overrides default) */
+    component?: (p: RotationHandleComponentProps) => JSX.Element;
+}
 /**
  * Props for the custom annotation renderer
  */

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { JSX, CSSProperties } from '../../react/adapter.ts';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, VertexHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer, SelectionOutline } from './types';
 import { VertexConfig } from '../types';
 interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     scale: number;
@@ -17,21 +17,29 @@ interface AnnotationContainerProps<T extends PdfAnnotationObject> {
     isMultiSelected?: boolean;
     isDraggable: boolean;
     isResizable: boolean;
+    isRotatable?: boolean;
     lockAspectRatio?: boolean;
     style?: CSSProperties;
     vertexConfig?: VertexConfig<T>;
     selectionMenu?: AnnotationSelectionMenuRenderFn;
+    /** @deprecated Use `selectionOutline.offset` instead */
     outlineOffset?: number;
     onDoubleClick?: (event: any) => void;
     onSelect: (event: any) => void;
     zIndex?: number;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline.color` instead */
     selectionOutlineColor?: string;
+    /** Customize the selection outline (color, style, width, offset) */
+    selectionOutline?: SelectionOutline;
     customAnnotationRenderer?: CustomAnnotationRenderer<T>;
     /** Passed from parent but not used - destructured to prevent DOM spread */
     groupSelectionMenu?: GroupSelectionMenuRenderFn;
     /** Passed from parent but not used - destructured to prevent DOM spread */
+    groupSelectionOutline?: SelectionOutline;
+    /** Passed from parent but not used - destructured to prevent DOM spread */
     annotationRenderers?: BoxedAnnotationRenderer[];
 }
 /**
@@ -39,5 +47,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, isMultiSelected, isDraggable, isResizable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, annotationRenderers: _annotationRenderers, ...props }: AnnotationContainerProps<T>): JSX.Element;
+export declare function AnnotationContainer<T extends PdfAnnotationObject>({ scale, documentId, pageIndex, rotation, pageWidth, pageHeight, trackedAnnotation, children, isSelected, isMultiSelected, isDraggable, isResizable, isRotatable, lockAspectRatio, style, vertexConfig, selectionMenu, outlineOffset, onDoubleClick, onSelect, zIndex, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, customAnnotationRenderer, groupSelectionMenu: _groupSelectionMenu, groupSelectionOutline: _groupSelectionOutline, annotationRenderers: _annotationRenderers, ...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, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
+import { ResizeHandleUI, VertexHandleUI, RotationHandleUI, SelectionOutline, CustomAnnotationRenderer, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, BoxedAnnotationRenderer } from './types';
 import { PdfAnnotationObject } from '@embedpdf/models';
 type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     /** The ID of the document that this layer displays annotations for */
@@ -16,12 +16,18 @@ type AnnotationLayerProps = Omit<HTMLAttributes<HTMLDivElement>, 'style'> & {
     resizeUI?: ResizeHandleUI;
     /** Customize vertex handles */
     vertexUI?: VertexHandleUI;
-    /** Customize selection outline color */
+    /** Customize rotation handle */
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline` instead */
     selectionOutlineColor?: string;
+    /** Customize the selection outline for individual annotations */
+    selectionOutline?: SelectionOutline;
+    /** Customize the selection outline for the group selection box (falls back to selectionOutline) */
+    groupSelectionOutline?: SelectionOutline;
     /** Customize annotation renderer */
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
     /** Custom renderers for specific annotation types (provided by external plugins) */
     annotationRenderers?: BoxedAnnotationRenderer[];
 };
-export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, selectionOutlineColor, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnnotationLayer({ style, documentId, pageIndex, scale: overrideScale, rotation: overrideRotation, selectionMenu, groupSelectionMenu, resizeUI, vertexUI, rotationUI, selectionOutlineColor, selectionOutline, groupSelectionOutline, customAnnotationRenderer, annotationRenderers, ...props }: AnnotationLayerProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
-import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, BoxedAnnotationRenderer } from './types';
+import { CustomAnnotationRenderer, ResizeHandleUI, AnnotationSelectionMenuRenderFn, GroupSelectionMenuRenderFn, VertexHandleUI, RotationHandleUI, SelectionOutline, BoxedAnnotationRenderer } from './types';
 interface AnnotationsProps {
     documentId: string;
     pageIndex: number;
@@ -11,7 +11,10 @@ interface AnnotationsProps {
     groupSelectionMenu?: GroupSelectionMenuRenderFn;
     resizeUI?: ResizeHandleUI;
     vertexUI?: VertexHandleUI;
+    rotationUI?: RotationHandleUI;
     selectionOutlineColor?: string;
+    selectionOutline?: SelectionOutline;
+    groupSelectionOutline?: SelectionOutline;
     customAnnotationRenderer?: CustomAnnotationRenderer<PdfAnnotationObject>;
     /** Custom renderers for specific annotation types (provided by external plugins) */
     annotationRenderers?: BoxedAnnotationRenderer[];

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

@@ -1,5 +1,5 @@
 import { TrackedAnnotation } from '../../lib/index.ts';
-import { ResizeHandleUI, GroupSelectionMenuRenderFn } from './types';
+import { ResizeHandleUI, RotationHandleUI, GroupSelectionMenuRenderFn, SelectionOutline } from './types';
 interface GroupSelectionBoxProps {
     documentId: string;
     pageIndex: number;
@@ -13,12 +13,20 @@ interface GroupSelectionBoxProps {
     isDraggable: boolean;
     /** Whether the group is resizable (all annotations must be group-resizable) */
     isResizable: boolean;
+    /** Whether the group can be rotated */
+    isRotatable?: boolean;
+    /** Whether to lock aspect ratio during group resize */
+    lockAspectRatio?: boolean;
     /** Resize handle UI customization */
     resizeUI?: ResizeHandleUI;
-    /** Selection outline color */
+    /** Rotation handle UI customization */
+    rotationUI?: RotationHandleUI;
+    /** @deprecated Use `selectionOutline.color` instead */
     selectionOutlineColor?: string;
-    /** Outline offset */
+    /** @deprecated Use `selectionOutline.offset` instead */
     outlineOffset?: number;
+    /** Customize the selection outline (color, style, width, offset) */
+    selectionOutline?: SelectionOutline;
     /** Z-index for the group box */
     zIndex?: number;
     /** Group selection menu render function */
@@ -28,5 +36,5 @@ interface GroupSelectionBoxProps {
  * 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 declare function GroupSelectionBox({ documentId, pageIndex, scale, rotation, pageWidth, pageHeight, selectedAnnotations, isDraggable, isResizable, isRotatable, lockAspectRatio, resizeUI, rotationUI, selectionOutlineColor, outlineOffset, selectionOutline, zIndex, groupSelectionMenu, }: GroupSelectionBoxProps): JSX.Element | null;
 export {};

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

@@ -7,6 +7,7 @@ type RenderAnnotationProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {
     scaleFactor?: number;
     dpr?: number;
     style?: CSSProperties;
+    unrotated?: boolean;
 };
-export declare function RenderAnnotation({ documentId, pageIndex, annotation, scaleFactor, style, ...props }: RenderAnnotationProps): import("react/jsx-runtime").JSX.Element;
+export declare function RenderAnnotation({ documentId, pageIndex, annotation, scaleFactor, unrotated, style, ...props }: RenderAnnotationProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,7 @@
 import { PdfAnnotationObject } from '@embedpdf/models';
 import { TrackedAnnotation } from '../../lib/index.ts';
 import { HandleElementProps, SelectionMenuPropsBase, SelectionMenuRenderFn } from '../../react/utils.ts';
-import { JSX, MouseEvent, TouchEvent } from '../../react/adapter.ts';
+import { JSX, CSSProperties, MouseEvent, TouchEvent } from '../../react/adapter.ts';
 export type ResizeDirection = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'none';
 export interface AnnotationSelectionContext {
     type: 'annotation';
@@ -38,6 +38,56 @@ export interface VertexHandleUI {
     /** Custom renderer for each vertex (overrides default) */
     component?: (p: HandleProps) => JSX.Element;
 }
+/** Props for the rotation handle component */
+export interface RotationHandleComponentProps extends HandleProps {
+    /** Props for the connector line element */
+    connectorStyle?: CSSProperties;
+    /** Whether to show the connector line */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Resolved border configuration */
+    border?: RotationHandleBorder;
+}
+export type BorderStyle = 'solid' | 'dashed' | 'dotted';
+export interface SelectionOutline {
+    /** Outline color (default: '#007ACC') */
+    color?: string;
+    /** Outline style (default: 'solid' for single, 'dashed' for group) */
+    style?: BorderStyle;
+    /** Outline width in px (default: 1 for single, 2 for group) */
+    width?: number;
+    /** Outline offset in px (default: 1 for single, 2 for group) */
+    offset?: number;
+}
+/** Border configuration for the rotation handle */
+export interface RotationHandleBorder {
+    /** Border color (default: '#007ACC') */
+    color?: string;
+    /** Border style (default: 'solid') */
+    style?: BorderStyle;
+    /** Border width in px (default: 1) */
+    width?: number;
+}
+/** UI customization for rotation handle */
+export interface RotationHandleUI {
+    /** Handle size in CSS px (default: 16) */
+    size?: number;
+    /** Gap in CSS px between the bounding box edge and the rotation handle center (default: 20) */
+    margin?: number;
+    /** Default background color for the handle (default: 'white') */
+    color?: string;
+    /** Color for the connector line (default: '#007ACC') */
+    connectorColor?: string;
+    /** Whether to show the connector line (default: true) */
+    showConnector?: boolean;
+    /** Color for the icon inside the handle (default: '#007ACC') */
+    iconColor?: string;
+    /** Border configuration for the handle */
+    border?: RotationHandleBorder;
+    /** Custom renderer for the rotation handle (overrides default) */
+    component?: (p: RotationHandleComponentProps) => JSX.Element;
+}
 /**
  * Props for the custom annotation renderer
  */