@embedpdf/plugin-annotation 2.2.0 → 2.3.0

package/dist/lib/actions.d.ts

@@ -8,6 +8,9 @@ export declare const SET_ACTIVE_DOCUMENT = "ANNOTATION/SET_ACTIVE_DOCUMENT";
 export declare const SET_ANNOTATIONS = "ANNOTATION/SET_ANNOTATIONS";
 export declare const SELECT_ANNOTATION = "ANNOTATION/SELECT_ANNOTATION";
 export declare const DESELECT_ANNOTATION = "ANNOTATION/DESELECT_ANNOTATION";
+export declare const ADD_TO_SELECTION = "ANNOTATION/ADD_TO_SELECTION";
+export declare const REMOVE_FROM_SELECTION = "ANNOTATION/REMOVE_FROM_SELECTION";
+export declare const SET_SELECTION = "ANNOTATION/SET_SELECTION";
 export declare const SET_ACTIVE_TOOL_ID = "ANNOTATION/SET_ACTIVE_TOOL_ID";
 export declare const CREATE_ANNOTATION = "ANNOTATION/CREATE_ANNOTATION";
 export declare const PATCH_ANNOTATION = "ANNOTATION/PATCH_ANNOTATION";
@@ -53,6 +56,28 @@ export interface DeselectAnnotationAction extends Action {
         documentId: string;
     };
 }
+export interface AddToSelectionAction extends Action {
+    type: typeof ADD_TO_SELECTION;
+    payload: {
+        documentId: string;
+        pageIndex: number;
+        id: string;
+    };
+}
+export interface RemoveFromSelectionAction extends Action {
+    type: typeof REMOVE_FROM_SELECTION;
+    payload: {
+        documentId: string;
+        id: string;
+    };
+}
+export interface SetSelectionAction extends Action {
+    type: typeof SET_SELECTION;
+    payload: {
+        documentId: string;
+        ids: string[];
+    };
+}
 export interface SetActiveToolIdAction extends Action {
     type: typeof SET_ACTIVE_TOOL_ID;
     payload: {
@@ -89,6 +114,7 @@ export interface CommitAction extends Action {
     type: typeof COMMIT_PENDING_CHANGES;
     payload: {
         documentId: string;
+        committedUids: string[];
     };
 }
 export interface PurgeAnnotationAction extends Action {
@@ -113,18 +139,21 @@ export interface AddToolAction extends Action {
     type: typeof ADD_TOOL;
     payload: AnnotationTool;
 }
-export type AnnotationAction = InitAnnotationStateAction | CleanupAnnotationStateAction | SetActiveDocumentAction | SetAnnotationsAction | SelectAnnotationAction | DeselectAnnotationAction | SetActiveToolIdAction | CreateAnnotationAction | PatchAnnotationAction | DeleteAnnotationAction | CommitAction | PurgeAnnotationAction | AddColorPresetAction | SetToolDefaultsAction | AddToolAction;
+export type AnnotationAction = InitAnnotationStateAction | CleanupAnnotationStateAction | SetActiveDocumentAction | SetAnnotationsAction | SelectAnnotationAction | DeselectAnnotationAction | AddToSelectionAction | RemoveFromSelectionAction | SetSelectionAction | SetActiveToolIdAction | CreateAnnotationAction | PatchAnnotationAction | DeleteAnnotationAction | CommitAction | PurgeAnnotationAction | AddColorPresetAction | SetToolDefaultsAction | AddToolAction;
 export declare function initAnnotationState(documentId: string, state: AnnotationDocumentState): InitAnnotationStateAction;
 export declare function cleanupAnnotationState(documentId: string): CleanupAnnotationStateAction;
 export declare function setActiveDocument(documentId: string | null): SetActiveDocumentAction;
 export declare const setAnnotations: (documentId: string, annotations: Record<number, PdfAnnotationObject[]>) => SetAnnotationsAction;
 export declare const selectAnnotation: (documentId: string, pageIndex: number, id: string) => SelectAnnotationAction;
 export declare const deselectAnnotation: (documentId: string) => DeselectAnnotationAction;
+export declare const addToSelection: (documentId: string, pageIndex: number, id: string) => AddToSelectionAction;
+export declare const removeFromSelection: (documentId: string, id: string) => RemoveFromSelectionAction;
+export declare const setSelection: (documentId: string, ids: string[]) => SetSelectionAction;
 export declare const setActiveToolId: (documentId: string, toolId: string | null) => SetActiveToolIdAction;
 export declare const createAnnotation: (documentId: string, pageIndex: number, annotation: PdfAnnotationObject) => CreateAnnotationAction;
 export declare const patchAnnotation: (documentId: string, pageIndex: number, id: string, patch: Partial<PdfAnnotationObject>) => PatchAnnotationAction;
 export declare const deleteAnnotation: (documentId: string, pageIndex: number, id: string) => DeleteAnnotationAction;
-export declare const commitPendingChanges: (documentId: string) => CommitAction;
+export declare const commitPendingChanges: (documentId: string, committedUids: string[]) => CommitAction;
 export declare const purgeAnnotation: (documentId: string, uid: string) => PurgeAnnotationAction;
 export declare const addColorPreset: (c: string) => AddColorPresetAction;
 export declare const setToolDefaults: (toolId: string, patch: Partial<any>) => SetToolDefaultsAction;

package/dist/lib/annotation-plugin.d.ts

@@ -1,6 +1,6 @@
 import { BasePlugin, PluginRegistry } from '@embedpdf/core';
-import { PdfAnnotationObject } from '@embedpdf/models';
-import { AnnotationCapability, AnnotationPluginConfig, AnnotationState } from './types';
+import { PdfAnnotationObject, Position, Rect } from '@embedpdf/models';
+import { AnnotationCapability, AnnotationPluginConfig, AnnotationState, UnifiedDragOptions, UnifiedDragState, UnifiedDragEvent, UnifiedResizeOptions, UnifiedResizeState, UnifiedResizeEvent } from './types';
 import { AnnotationAction } from './actions';
 import { AnnotationTool } from './tools/types';
 import { AnyPreviewState, HandlerServices } from './handlers/types';
@@ -15,11 +15,16 @@ export declare class AnnotationPlugin extends BasePlugin<AnnotationPluginConfig,
     private pendingContexts;
     private isInitialLoadComplete;
     private importQueue;
+    private commitInProgress;
     private handlerFactories;
     private readonly activeTool$;
     private readonly events$;
     private readonly toolsChange$;
     private readonly patchRegistry;
+    private readonly unifiedDragStates;
+    private readonly unifiedDrag$;
+    private readonly unifiedResizeStates;
+    private readonly unifiedResize$;
     constructor(id: string, registry: PluginRegistry, config: AnnotationPluginConfig);
     protected onDocumentLoadingStarted(documentId: string): void;
     protected onDocumentLoaded(documentId: string): void;
@@ -50,12 +55,182 @@ export declare class AnnotationPlugin extends BasePlugin<AnnotationPluginConfig,
     private buildPatch;
     private updateAnnotation;
     private deleteAnnotation;
+    private deleteAnnotationsMethod;
     private selectAnnotation;
     private deselectAnnotation;
+    private getSelectedAnnotationsMethod;
+    private getSelectedAnnotationIdsMethod;
+    private toggleSelectionMethod;
+    private addToSelectionMethod;
+    private removeFromSelectionMethod;
+    private setSelectionMethod;
+    private getAttachedLinksMethod;
+    private hasAttachedLinksMethod;
+    private deleteAttachedLinksMethod;
+    /**
+     * Group the currently selected annotations.
+     * The first selected annotation becomes the group leader.
+     * All other selected annotations get their IRT set to the leader's ID with RT = Group.
+     */
+    private groupAnnotationsMethod;
+    /**
+     * Ungroup all annotations in the group containing the specified annotation.
+     * Clears IRT and RT from all group members (the leader doesn't have them).
+     */
+    private ungroupAnnotationsMethod;
+    /**
+     * Get all annotations in the same group as the specified annotation.
+     */
+    private getGroupMembersMethod;
+    /**
+     * Check if an annotation is part of a group.
+     */
+    private isInGroupMethod;
+    /**
+     * Get the available grouping action for the current selection.
+     */
+    private getGroupingActionMethod;
+    /**
+     * Compute combined constraints from all selected annotations.
+     * This finds the "weakest link" in each direction - the annotation with the least
+     * room to move determines the group's limit.
+     */
+    private computeCombinedConstraints;
+    /**
+     * Clamp a delta to the combined constraints.
+     * Negative y = moving up, positive y = moving down
+     * Negative x = moving left, positive x = moving right
+     */
+    private clampDelta;
+    /**
+     * Start a unified drag operation.
+     * The plugin automatically expands the selection to include attached links.
+     * Framework components should call this instead of building their own logic.
+     *
+     * @param documentId - The document ID
+     * @param options - Drag options (annotationIds and pageSize)
+     */
+    startDrag(documentId: string, options: UnifiedDragOptions): void;
+    /**
+     * Compute preview patches for all drag participants.
+     * Uses transformAnnotation to properly handle vertices, inkList, etc.
+     */
+    private computeDragPreviewPatches;
+    /**
+     * Update the drag delta during a unified drag operation.
+     * Returns the clamped delta synchronously for the caller's preview.
+     *
+     * @param documentId - The document ID
+     * @param rawDelta - The unconstrained delta from the drag gesture
+     * @returns The clamped delta
+     */
+    updateDrag(documentId: string, rawDelta: Position): Position;
+    /**
+     * Commit the drag - plugin builds and applies ALL patches.
+     * This is the key method that centralizes patch building in the plugin.
+     *
+     * @param documentId - The document ID
+     */
+    commitDrag(documentId: string): void;
+    /**
+     * Cancel the drag without committing.
+     *
+     * @param documentId - The document ID
+     */
+    cancelDrag(documentId: string): void;
+    /**
+     * Get the current unified drag state for a document.
+     */
+    getDragState(documentId: string): UnifiedDragState | null;
+    /**
+     * Subscribe to unified drag state changes.
+     * Framework components use this for preview updates.
+     */
+    get onDragChange(): import('@embedpdf/core').EventHook<UnifiedDragEvent>;
+    /**
+     * Compute the union bounding box of multiple rects.
+     */
+    private computeUnifiedGroupBoundingBox;
+    /**
+     * Compute relative positions for annotations within a group bounding box.
+     */
+    private computeUnifiedRelativePositions;
+    /**
+     * Compute new rects for all annotations based on the new group bounding box.
+     */
+    private computeUnifiedResizedRects;
+    /**
+     * Compute preview patches for all resize participants.
+     * Uses transformAnnotation to properly handle vertices, inkList, etc.
+     */
+    private computeResizePreviewPatches;
+    /**
+     * Start a unified resize operation.
+     * The plugin automatically expands the selection to include attached links.
+     *
+     * @param documentId - The document ID
+     * @param options - Resize options
+     */
+    startResize(documentId: string, options: UnifiedResizeOptions): void;
+    /**
+     * Update the resize with a new group bounding box.
+     * Returns the computed rects synchronously for immediate preview use.
+     *
+     * @param documentId - The document ID
+     * @param newGroupBox - The new group bounding box
+     * @returns Record of annotation ID to new rect
+     */
+    updateResize(documentId: string, newGroupBox: Rect): Record<string, Rect>;
+    /**
+     * Commit the resize - plugin builds and applies ALL patches.
+     *
+     * @param documentId - The document ID
+     */
+    commitResize(documentId: string): void;
+    /**
+     * Cancel the resize without committing.
+     *
+     * @param documentId - The document ID
+     */
+    cancelResize(documentId: string): void;
+    /**
+     * Get the current unified resize state for a document.
+     */
+    getResizeState(documentId: string): UnifiedResizeState | null;
+    /**
+     * Subscribe to unified resize state changes.
+     * Framework components use this for preview updates.
+     */
+    get onResizeChange(): import('@embedpdf/core').EventHook<UnifiedResizeEvent>;
+    private updateAnnotationsMethod;
     getActiveTool(documentId?: string): AnnotationTool | null;
     setActiveTool(toolId: string | null, documentId?: string): void;
     getTool<T extends AnnotationTool>(toolId: string): T | undefined;
     findToolForAnnotation(annotation: PdfAnnotationObject): AnnotationTool | null;
+    /**
+     * Collects all pending annotation changes for a document into a batch.
+     * This separates the "what to commit" from "how to commit" for cleaner code.
+     */
+    private collectPendingChanges;
+    /**
+     * Executes a batch of pending changes by creating engine tasks.
+     * Returns a task that resolves when all operations complete.
+     */
+    private executeCommitBatch;
+    /**
+     * Emits commit events for all completed operations.
+     * Centralizes event emission for cleaner separation of concerns.
+     */
+    private emitCommitEvents;
+    /**
+     * Attempts to acquire the commit lock for a document.
+     * Returns true if acquired, false if a commit is already in progress.
+     */
+    private acquireCommitLock;
+    /**
+     * Releases the commit lock for a document.
+     */
+    private releaseCommitLock;
     private commit;
     /**
      * Gets the effective behavior setting for a tool, checking tool-specific config first,

package/dist/lib/handlers/types.d.ts

@@ -51,7 +51,7 @@ export interface InkPreviewData {
     rect: Rect;
     inkList: PdfInkListObject[];
     strokeWidth: number;
-    color: string;
+    strokeColor: string;
     opacity: number;
 }
 export interface FreeTextPreviewData {

package/dist/lib/helpers.d.ts

@@ -1,5 +1,9 @@
-import { PdfAnnotationSubtype, PdfAnnotationObject } from '@embedpdf/models';
+import { PdfAnnotationSubtype, PdfAnnotationObject, Rect } from '@embedpdf/models';
 import { TrackedAnnotation } from './types';
+/**
+ * Check if two rectangles intersect
+ */
+export declare function rectsIntersect(a: Rect, b: Rect): boolean;
 export type AnnoOf<S extends PdfAnnotationSubtype> = Extract<PdfAnnotationObject, {
     type: S;
 }>;
@@ -21,4 +25,5 @@ export declare function isTextMarkup(a: TrackedAnnotation): a is TrackedAnnotati
 export declare function isFreeText(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.FREETEXT>>;
 export declare function isStamp(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.STAMP>>;
 export declare function isText(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.TEXT>>;
+export declare function isLink(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<PdfAnnotationSubtype.LINK>>;
 export declare function isSidebarAnnotation(a: TrackedAnnotation): a is TrackedAnnotation<AnnoOf<SidebarSubtype>>;

package/dist/lib/selectors.d.ts

@@ -1,16 +1,32 @@
-import { AnnotationState, AnnotationDocumentState, SidebarAnnotationEntry, TrackedAnnotation } from './types';
+import { AnnotationState, AnnotationDocumentState, SidebarAnnotationEntry, TrackedAnnotation, GroupingAction } from './types';
+import { PdfAnnotationSubtype, PdfAnnotationObject } from '@embedpdf/models';
 import { ToolMap } from './tools/tools-utils';
 /** All annotations _objects_ on a single page (order preserved). */
-export declare const getAnnotationsByPageIndex: (s: AnnotationDocumentState, page: number) => TrackedAnnotation<import('@embedpdf/models').PdfAnnotationObject>[];
+export declare const getAnnotationsByPageIndex: (s: AnnotationDocumentState, page: number) => TrackedAnnotation<PdfAnnotationObject>[];
 /** Shortcut: every page → list of annotation objects. */
-export declare const getAnnotations: (s: AnnotationDocumentState) => Record<number, TrackedAnnotation<import('@embedpdf/models').PdfAnnotationObject>[]>;
-/** The full `TrackedAnnotation` for the current selection. */
-export declare const getSelectedAnnotation: (s: AnnotationDocumentState) => TrackedAnnotation<import('@embedpdf/models').PdfAnnotationObject> | null;
+export declare const getAnnotations: (s: AnnotationDocumentState) => Record<number, TrackedAnnotation<PdfAnnotationObject>[]>;
+/**
+ * The full `TrackedAnnotation` for the current selection.
+ * @deprecated Use getSelectedAnnotations() for multi-select support. Returns first selected or null.
+ */
+export declare const getSelectedAnnotation: (s: AnnotationDocumentState) => TrackedAnnotation | null;
+/** Get all selected TrackedAnnotations */
+export declare const getSelectedAnnotations: (s: AnnotationDocumentState) => TrackedAnnotation[];
+/** Get the IDs of all selected annotations */
+export declare const getSelectedAnnotationIds: (s: AnnotationDocumentState) => string[];
 /** Get a tracked annotation by its ID */
-export declare const getAnnotationByUid: (s: AnnotationDocumentState, uid: string) => TrackedAnnotation<import('@embedpdf/models').PdfAnnotationObject>;
-export declare const getSelectedAnnotationByPageIndex: (s: AnnotationDocumentState, pageIndex: number) => TrackedAnnotation<import('@embedpdf/models').PdfAnnotationObject> | null;
-/** Check if a given anno on a page is the current selection. */
+export declare const getAnnotationByUid: (s: AnnotationDocumentState, uid: string) => TrackedAnnotation<PdfAnnotationObject>;
+/**
+ * Get selected annotation on a specific page (single, for backward compatibility)
+ * @deprecated Use getSelectedAnnotationsByPageIndex() for multi-select support.
+ */
+export declare const getSelectedAnnotationByPageIndex: (s: AnnotationDocumentState, pageIndex: number) => TrackedAnnotation | null;
+/** Get all selected annotations on a specific page */
+export declare const getSelectedAnnotationsByPageIndex: (s: AnnotationDocumentState, pageIndex: number) => TrackedAnnotation[];
+/** Check if a given annotation is in the current selection. */
 export declare const isAnnotationSelected: (s: AnnotationDocumentState, id: string) => boolean;
+/** Check if multiple annotations are selected */
+export declare const hasMultipleSelected: (s: AnnotationDocumentState) => boolean;
 /**
  * Returns the current defaults for a specific tool by its ID.
  * This is fully type-safe and infers the correct return type.
@@ -43,3 +59,76 @@ export declare const getSidebarAnnotationsWithRepliesGroupedByPage: (s: Annotati
  * ]
  */
 export declare const getSidebarAnnotationsWithReplies: (s: AnnotationDocumentState) => SidebarAnnotationEntry[];
+/**
+ * Get all IRT child annotation info for cascade delete.
+ * Returns array of { id, pageIndex } for each annotation that references parentId.
+ */
+export declare const getIRTChildIds: (s: AnnotationDocumentState, parentId: string) => {
+    id: string;
+    pageIndex: number;
+}[];
+/**
+ * Check if an annotation has any IRT children (links, replies, etc.)
+ */
+export declare const hasIRTChildren: (s: AnnotationDocumentState, parentId: string) => boolean;
+/**
+ * Get IRT children filtered by annotation type (e.g., only LINK).
+ * @param s - The annotation document state
+ * @param parentId - The parent annotation ID
+ * @param types - Array of annotation subtypes to include
+ */
+export declare const getIRTChildrenByType: (s: AnnotationDocumentState, parentId: string, types: PdfAnnotationSubtype[]) => TrackedAnnotation[];
+/**
+ * Get link annotations attached to a parent annotation via IRT relationship.
+ * @param s - The annotation document state
+ * @param parentId - The parent annotation ID
+ */
+export declare const getAttachedLinks: (s: AnnotationDocumentState, parentId: string) => TrackedAnnotation[];
+/**
+ * Check if an annotation has attached link children.
+ * @param s - The annotation document state
+ * @param parentId - The parent annotation ID
+ */
+export declare const hasAttachedLinks: (s: AnnotationDocumentState, parentId: string) => boolean;
+/**
+ * Get the leader ID of a group.
+ * If the annotation has inReplyToId with replyType = Group, return the inReplyToId.
+ * Otherwise, the annotation itself is the leader.
+ *
+ * @param s - The annotation document state
+ * @param annotationId - The annotation ID to find the group leader for
+ * @returns The leader annotation ID, or undefined if annotation not found
+ */
+export declare const getGroupLeaderId: (s: AnnotationDocumentState, annotationId: string) => string | undefined;
+/**
+ * Get all annotations in the same group as the given annotation.
+ * Returns the leader plus all annotations with inReplyToId pointing to leader and replyType = Group.
+ * Note: LINK annotations are excluded - they use IRT/Group for attachment but are not "group members"
+ * in the user-facing sense.
+ *
+ * @param s - The annotation document state
+ * @param annotationId - Any annotation ID in the group
+ * @returns Array of TrackedAnnotations in the group (including the annotation itself)
+ */
+export declare const getGroupMembers: (s: AnnotationDocumentState, annotationId: string) => TrackedAnnotation<PdfAnnotationObject>[];
+/**
+ * Check if an annotation is part of a group.
+ * An annotation is in a group if:
+ * - It has inReplyToId with replyType = Group (it's a group member), OR
+ * - It has at least one other annotation pointing to it with replyType = Group (it's a group leader)
+ *
+ * Note: LINK annotations are excluded - they use IRT/Group for attachment but are not "group members"
+ * in the user-facing sense. An annotation with only attached links is NOT considered "in a group".
+ *
+ * @param s - The annotation document state
+ * @param annotationId - The annotation ID to check
+ * @returns true if the annotation is part of a group
+ */
+export declare const isInGroup: (s: AnnotationDocumentState, annotationId: string) => boolean;
+/**
+ * Determine what grouping action is available for the current selection.
+ *
+ * @param s - The annotation document state
+ * @returns The available grouping action
+ */
+export declare const getSelectionGroupingAction: (s: AnnotationDocumentState) => GroupingAction;

package/dist/lib/tools/default-tools.d.ts

@@ -8,17 +8,19 @@ export declare const defaultTools: ({
         textSelection: true;
         isDraggable: false;
         isResizable: false;
+        isGroupDraggable: false;
+        isGroupResizable: false;
         cursor?: undefined;
         lockAspectRatio?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.HIGHLIGHT;
+        strokeColor: string;
         color: string;
         opacity: number;
         blendMode: PdfBlendMode.Multiply;
         strokeWidth?: undefined;
         intent?: undefined;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -39,17 +41,19 @@ export declare const defaultTools: ({
         textSelection: true;
         isDraggable: false;
         isResizable: false;
+        isGroupDraggable: false;
+        isGroupResizable: false;
         cursor?: undefined;
         lockAspectRatio?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.UNDERLINE;
+        strokeColor: string;
         color: string;
         opacity: number;
         blendMode?: undefined;
         strokeWidth?: undefined;
         intent?: undefined;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -68,19 +72,21 @@ export declare const defaultTools: ({
     interaction: {
         exclusive: false;
         textSelection: true;
-        isDraggable?: undefined;
-        isResizable?: undefined;
+        isDraggable: false;
+        isResizable: false;
+        isGroupDraggable: false;
+        isGroupResizable: false;
         cursor?: undefined;
         lockAspectRatio?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.STRIKEOUT;
+        strokeColor: string;
         color: string;
         opacity: number;
         blendMode?: undefined;
         strokeWidth?: undefined;
         intent?: undefined;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -101,17 +107,19 @@ export declare const defaultTools: ({
         textSelection: true;
         isDraggable: false;
         isResizable: false;
+        isGroupDraggable: false;
+        isGroupResizable: false;
         cursor?: undefined;
         lockAspectRatio?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.SQUIGGLY;
+        strokeColor: string;
         color: string;
         opacity: number;
         blendMode?: undefined;
         strokeWidth?: undefined;
         intent?: undefined;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -134,15 +142,17 @@ export declare const defaultTools: ({
         isResizable: true;
         lockAspectRatio: false;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
+        isGroupResizable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.INK;
+        strokeColor: string;
         color: string;
         opacity: number;
         strokeWidth: number;
         blendMode?: undefined;
         intent?: undefined;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -165,15 +175,17 @@ export declare const defaultTools: ({
         isResizable: true;
         lockAspectRatio: false;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
+        isGroupResizable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.INK;
         intent: string;
+        strokeColor: string;
         color: string;
         opacity: number;
         strokeWidth: number;
         blendMode: PdfBlendMode.Multiply;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;
@@ -196,6 +208,8 @@ export declare const defaultTools: ({
         isResizable: true;
         lockAspectRatio: false;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
+        isGroupResizable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.CIRCLE;
@@ -236,6 +250,8 @@ export declare const defaultTools: ({
         isResizable: true;
         lockAspectRatio: false;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
+        isGroupResizable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.SQUARE;
@@ -275,7 +291,9 @@ export declare const defaultTools: ({
         isDraggable: true;
         isResizable: false;
         lockAspectRatio: false;
+        isGroupResizable: true;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.LINE;
@@ -312,7 +330,9 @@ export declare const defaultTools: ({
         isDraggable: true;
         isResizable: false;
         lockAspectRatio: false;
+        isGroupResizable: true;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.LINE;
@@ -352,7 +372,9 @@ export declare const defaultTools: ({
         isDraggable: true;
         isResizable: false;
         lockAspectRatio: false;
+        isGroupResizable: true;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.POLYLINE;
@@ -383,7 +405,9 @@ export declare const defaultTools: ({
         isDraggable: true;
         isResizable: false;
         lockAspectRatio: false;
+        isGroupResizable: true;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.POLYGON;
@@ -415,6 +439,8 @@ export declare const defaultTools: ({
         isResizable: true;
         lockAspectRatio: false;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
+        isGroupResizable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.FREETEXT;
@@ -424,13 +450,13 @@ export declare const defaultTools: ({
         fontFamily: PdfStandardFont.Helvetica;
         textAlign: PdfTextAlignment.Left;
         verticalAlign: PdfVerticalAlignment.Top;
+        color: string;
         backgroundColor: string;
         opacity: number;
-        color?: undefined;
+        strokeColor?: undefined;
         blendMode?: undefined;
         strokeWidth?: undefined;
         intent?: undefined;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
     };
@@ -455,15 +481,17 @@ export declare const defaultTools: ({
         isResizable: true;
         lockAspectRatio: true;
         textSelection?: undefined;
+        isGroupDraggable?: undefined;
+        isGroupResizable?: undefined;
     };
     defaults: {
         type: PdfAnnotationSubtype.STAMP;
+        strokeColor?: undefined;
         color?: undefined;
         opacity?: undefined;
         blendMode?: undefined;
         strokeWidth?: undefined;
         intent?: undefined;
-        strokeColor?: undefined;
         strokeStyle?: undefined;
         lineEndings?: undefined;
         contents?: undefined;

package/dist/lib/tools/types.d.ts

@@ -84,10 +84,16 @@ export type AnnotationTool<T extends PdfAnnotationObject = PdfAnnotationObject>
         cursor?: string;
         /** If true, this interaction mode is activated by selecting text. */
         textSelection?: boolean;
-        /** Annotation interaction behaviors */
+        /** Whether this annotation can be dragged when selected individually. */
         isDraggable?: boolean;
+        /** Whether this annotation can be resized when selected individually. */
         isResizable?: boolean;
+        /** Whether to maintain aspect ratio during resize. */
         lockAspectRatio?: boolean;
+        /** Whether this annotation can be dragged when part of a group. Defaults to isDraggable. */
+        isGroupDraggable?: boolean;
+        /** Whether this annotation can be resized when part of a group. Defaults to isResizable. */
+        isGroupResizable?: boolean;
     };
     /** Tool-specific behavior settings that override plugin defaults */
     behavior?: {