@embedpdf/plugin-annotation 2.15.0 → 3.0.0-next.1

package/dist/lib/types.d.ts

@@ -1,671 +0,0 @@
-import { BasePluginConfig, EventHook } from '@embedpdf/core';
-import { AnnotationContextMap, AnnotationCreateContext, AnnotationAppearanceMap, PdfAnnotationObject, PdfDestinationObject, PdfErrorReason, PdfLinkTarget, PdfRenderPageAnnotationOptions, PdfTextAnnoObject, Position, Rect, Size, Task } from '@embedpdf/models';
-import { AnnotationTool, AnnotationToolMap, ToolById, ToolId } from './tools/types';
-/**
- * Metadata attached to annotation history commands for filtering/purging.
- * Used by the history plugin's purgeByMetadata method to identify commands
- * that should be removed (e.g., after a permanent redaction commit).
- */
-export interface AnnotationCommandMetadata {
-    /** The annotation IDs affected by this command */
-    annotationIds: string[];
-}
-export type AnnotationEvent = {
-    type: 'create';
-    documentId: string;
-    annotation: PdfAnnotationObject;
-    pageIndex: number;
-    ctx?: AnnotationCreateContext<any>;
-    committed: boolean;
-    editAfterCreate?: boolean;
-} | {
-    type: 'update';
-    documentId: string;
-    annotation: PdfAnnotationObject;
-    pageIndex: number;
-    patch: Partial<PdfAnnotationObject>;
-    committed: boolean;
-} | {
-    type: 'delete';
-    documentId: string;
-    annotation: PdfAnnotationObject;
-    pageIndex: number;
-    committed: boolean;
-} | {
-    type: 'loaded';
-    documentId: string;
-    total: number;
-};
-export type AnnotationToolsChangeEvent = {
-    tools: AnnotationTool[];
-};
-export type CommitState = 'new' | 'dirty' | 'moved' | 'deleted' | 'synced' | 'ignored';
-export interface TrackedAnnotation<T extends PdfAnnotationObject = PdfAnnotationObject> {
-    commitState: CommitState;
-    object: T;
-    /** When true, render using dict-based SVG/CSS instead of appearance stream image */
-    dictMode?: boolean;
-}
-/**
- * Represents a batch of pending annotation changes to be committed.
- * Separates the collection of changes from their execution.
- */
-export interface CommitBatch {
-    /** Annotations that need to be created in the PDF */
-    creations: Array<{
-        uid: string;
-        ta: TrackedAnnotation;
-        ctx?: AnnotationCreateContext<PdfAnnotationObject>;
-    }>;
-    /** Annotations that need to be updated in the PDF */
-    updates: Array<{
-        uid: string;
-        ta: TrackedAnnotation;
-        /** When true, only positional data changed -- skip appearance regeneration */
-        moved?: boolean;
-    }>;
-    /** Annotations that need to be deleted from the PDF */
-    deletions: Array<{
-        uid: string;
-        ta: TrackedAnnotation;
-    }>;
-    /** All UIDs that are part of this commit batch */
-    committedUids: string[];
-    /** Whether this batch has any changes */
-    isEmpty: boolean;
-}
-export interface RenderAnnotationOptions {
-    pageIndex: number;
-    annotation: PdfAnnotationObject;
-    options?: PdfRenderPageAnnotationOptions;
-}
-export declare enum LockModeType {
-    None = "none",
-    All = "all",
-    Include = "include",
-    Exclude = "exclude"
-}
-/**
- * Controls which annotation categories are locked from UI interaction (selection, drag, resize).
- * Locked annotations let clicks pass through to layers below (e.g. form-filling).
- *
- * - `{ type: LockModeType.None }` -- nothing locked (default, full interaction)
- * - `{ type: LockModeType.All }` -- everything locked
- * - `{ type: LockModeType.Include, categories: [...] }` -- only listed categories are locked
- * - `{ type: LockModeType.Exclude, categories: [...] }` -- everything locked except listed categories
- */
-export type LockMode = {
-    type: LockModeType.None;
-} | {
-    type: LockModeType.All;
-} | {
-    type: LockModeType.Include;
-    categories: string[];
-} | {
-    type: LockModeType.Exclude;
-    categories: string[];
-};
-export interface AnnotationDocumentState {
-    pages: Record<number, string[]>;
-    byUid: Record<string, TrackedAnnotation>;
-    /** Array of selected annotation UIDs (supports multi-selection) */
-    selectedUids: string[];
-    /**
-     * @deprecated Use `selectedUids` array or `getSelectedAnnotation()` instead.
-     * Returns the UID only when exactly one annotation is selected, otherwise null.
-     * Will be removed in next major version.
-     */
-    selectedUid: string | null;
-    activeToolId: string | null;
-    activeToolContext?: Record<string, unknown>;
-    hasPendingChanges: boolean;
-    locked: LockMode;
-}
-export interface AnnotationState {
-    documents: Record<string, AnnotationDocumentState>;
-    activeDocumentId: string | null;
-    /** The complete list of available tools, including any user modifications. */
-    tools: AnnotationTool[];
-    colorPresets: string[];
-}
-/**
- * Partial tool definition for overriding default tools by ID.
- * When a tool with the same `id` as a default tool is provided, its properties
- * are deep-merged with the default (user values take precedence).
- */
-export type AnnotationToolOverride = {
-    id: string;
-} & Partial<Omit<AnnotationTool, 'id'>>;
-export interface AnnotationPluginConfig extends BasePluginConfig {
-    /**
-     * A list of tools to add or override. If a tool's `id` matches a default tool,
-     * it is deep-merged with the default (partial overrides are supported).
-     * New tools (unmatched `id`) are added as-is.
-     */
-    tools?: (AnnotationTool | AnnotationToolOverride)[];
-    colorPresets?: string[];
-    /** When true (default), automatically commit the annotation changes into the PDF document. */
-    autoCommit?: boolean;
-    /** The author of the annotation. */
-    annotationAuthor?: string;
-    /** When true (default false), deactivate the active tool after creating an annotation. */
-    deactivateToolAfterCreate?: boolean;
-    /** When true (default false), select the annotation immediately after creation. */
-    selectAfterCreate?: boolean;
-    /** Initial lock mode for new documents. Defaults to `{ type: LockModeType.None }` (nothing locked). */
-    locked?: LockMode;
-    /** When true (default false), automatically enter edit mode after creating an annotation. */
-    editAfterCreate?: boolean;
-    /** When true (default), the LinkLockedMode component auto-opens URI links via window.open. Set to false to handle URI navigation yourself via onNavigate. */
-    autoOpenLinks?: boolean;
-}
-/**
- * Options for transforming an annotation
- */
-export interface TransformOptions<T extends PdfAnnotationObject = PdfAnnotationObject> {
-    /** The type of transformation */
-    type: 'move' | 'resize' | 'vertex-edit' | 'rotate' | 'property-update';
-    /** The changes to apply */
-    changes: Partial<T>;
-    /** Optional metadata */
-    metadata?: {
-        maintainAspectRatio?: boolean;
-        /** Rotation angle in degrees (for 'rotate' transform type) */
-        rotationAngle?: number;
-        /** Delta from the initial rotation angle in degrees */
-        rotationDelta?: number;
-        /** Center point for rotation (defaults to rect center) */
-        rotationCenter?: {
-            x: number;
-            y: number;
-        };
-        /** Whether the rotation is currently snapped to a guide */
-        isSnapped?: boolean;
-        /** Snap target angle when isSnapped is true */
-        snappedAngle?: number;
-        [key: string]: any;
-    };
-}
-/**
- * @deprecated Use `AnnotationTransferItem` instead. This type has a generic
- * that resolves `ctx` to `undefined` for the base `PdfAnnotationObject` union,
- * making it impossible to pass stamp context at the base type level.
- */
-export type ImportAnnotationItem<T extends PdfAnnotationObject = PdfAnnotationObject> = {
-    annotation: T;
-    ctx?: AnnotationCreateContext<T>;
-};
-/**
- * A portable annotation item used for both import and export.
- * `exportAnnotations()` produces this type, `importAnnotations()` consumes it.
- *
- * For stamps, `ctx` carries the binary data needed for round-tripping:
- * - `{ data: ArrayBuffer, mimeType?: ImageMimeType }` — the preferred shape.
- *   Export always includes `mimeType` (typically `'application/pdf'`).
- *   On import, `mimeType` is optional; the engine detects format from magic bytes.
- *   Supported formats: PNG, JPEG, PDF appearance.
- * - `{ imageData: ImageData }` — raw bitmap for programmatic stamp creation.
- *
- * Legacy shape `{ appearance }` is still accepted on
- * import but is deprecated; prefer `{ data }` instead.
- *
- * Non-stamp annotations need no `ctx`.
- */
-export interface AnnotationTransferItem {
-    annotation: PdfAnnotationObject;
-    ctx?: AnnotationContextMap[keyof AnnotationContextMap];
-}
-/** @deprecated Use `AnnotationTransferItem` instead. */
-export type ExportedAnnotation = AnnotationTransferItem;
-export interface ExportAnnotationsOptions {
-    /** Export only annotations on a specific page. Omit to export all pages. */
-    pageIndex?: number;
-}
-export interface AnnotationStateChangeEvent {
-    documentId: string;
-    state: AnnotationDocumentState;
-}
-export interface AnnotationActiveToolChangeEvent {
-    documentId: string;
-    tool: AnnotationTool | null;
-}
-/**
- * Represents what grouping action is available for the current selection.
- * - 'group': Selection can be grouped (2+ annotations, not all in same group)
- * - 'ungroup': Selection is exactly one complete group that can be ungrouped
- * - 'disabled': No valid grouping action (0-1 annotations selected)
- */
-export type GroupingAction = 'group' | 'ungroup' | 'disabled';
-type ToolUnion<TTools extends AnnotationToolMap> = TTools[ToolId<TTools>] & AnnotationTool;
-type ToolEntry<TTools extends AnnotationToolMap, TId extends ToolId<TTools>> = ToolById<TTools, TId> & AnnotationTool;
-export type NavigateTargetResult = {
-    outcome: 'navigated';
-} | {
-    outcome: 'uri';
-    uri: string;
-} | {
-    outcome: 'destination';
-    destination: PdfDestinationObject;
-} | {
-    outcome: 'unsupported';
-};
-export interface NavigateEvent {
-    documentId: string;
-    result: NavigateTargetResult;
-    target: PdfLinkTarget;
-}
-export interface AnnotationScope<TTools extends AnnotationToolMap = AnnotationToolMap> {
-    getState(): AnnotationDocumentState;
-    getPageAnnotations(options: GetPageAnnotationsOptions): Task<PdfAnnotationObject[], PdfErrorReason>;
-    /** @deprecated Use getSelectedAnnotations() for multi-select support. Returns first selected or null. */
-    getSelectedAnnotation(): TrackedAnnotation | null;
-    /** Get all selected annotations */
-    getSelectedAnnotations(): TrackedAnnotation[];
-    /** Get the IDs of all selected annotations */
-    getSelectedAnnotationIds(): string[];
-    getAnnotationById(id: string): TrackedAnnotation | null;
-    /** Get all tracked annotations, optionally filtered by page */
-    getAnnotations(options?: GetAnnotationsOptions): TrackedAnnotation[];
-    /** Select a single annotation (clears previous selection) */
-    selectAnnotation(pageIndex: number, annotationId: string): void;
-    /** Toggle an annotation in/out of the current selection */
-    toggleSelection(pageIndex: number, annotationId: string): void;
-    /** Add an annotation to the current selection */
-    addToSelection(pageIndex: number, annotationId: string): void;
-    /** Remove an annotation from the current selection */
-    removeFromSelection(annotationId: string): void;
-    /** Set the selection to a specific set of annotation IDs (for marquee) */
-    setSelection(ids: string[]): void;
-    /** Clear all selection */
-    deselectAnnotation(): void;
-    getActiveTool(): ToolUnion<TTools> | null;
-    setActiveTool<TId extends ToolId<TTools>>(toolId: TId | null, context?: Record<string, unknown>): void;
-    setActiveTool(toolId: string | null, context?: Record<string, unknown>): void;
-    findToolForAnnotation(annotation: PdfAnnotationObject): ToolUnion<TTools> | null;
-    importAnnotations(items: AnnotationTransferItem[]): void;
-    exportAnnotations(options?: ExportAnnotationsOptions): Task<AnnotationTransferItem[], PdfErrorReason>;
-    createAnnotation<A extends PdfAnnotationObject>(pageIndex: number, annotation: A, context?: AnnotationCreateContext<A>): void;
-    updateAnnotation(pageIndex: number, annotationId: string, patch: Partial<PdfAnnotationObject>): void;
-    /** Batch update multiple annotations at once */
-    updateAnnotations(patches: Array<{
-        pageIndex: number;
-        id: string;
-        patch: Partial<PdfAnnotationObject>;
-    }>): void;
-    /** Move an annotation by delta or to an absolute position (preserves appearance stream) */
-    moveAnnotation(pageIndex: number, annotationId: string, position: Position, mode?: 'delta' | 'absolute'): void;
-    deleteAnnotation(pageIndex: number, annotationId: string): void;
-    /** Delete multiple annotations in batch */
-    deleteAnnotations(annotations: Array<{
-        pageIndex: number;
-        id: string;
-    }>): void;
-    /** Delete all annotations from the document */
-    deleteAllAnnotations(): void;
-    /** Remove an annotation from state without calling the engine (no PDF modification) */
-    purgeAnnotation(pageIndex: number, annotationId: string): void;
-    renderAnnotation(options: RenderAnnotationOptions): Task<Blob, PdfErrorReason>;
-    /** Batch-fetch rendered appearance stream images for all annotations on a page */
-    getPageAppearances(pageIndex: number, options?: PdfRenderPageAnnotationOptions): Task<AnnotationAppearanceMap<Blob>, PdfErrorReason>;
-    /** Clear cached appearance images for a page (e.g. on zoom change) */
-    invalidatePageAppearances(pageIndex: number): void;
-    commit(): Task<boolean, PdfErrorReason>;
-    /** Get link annotations attached to an annotation via IRT relationship */
-    getAttachedLinks(annotationId: string): TrackedAnnotation[];
-    /** Check if an annotation has attached link children */
-    hasAttachedLinks(annotationId: string): boolean;
-    /** Delete all link annotations attached to an annotation */
-    deleteAttachedLinks(annotationId: string): void;
-    /** Group the currently selected annotations (first selected becomes leader) */
-    groupAnnotations(): void;
-    /** Ungroup all annotations in the group containing the specified annotation */
-    ungroupAnnotations(annotationId: string): void;
-    /** Get all annotations in the same group as the specified annotation */
-    getGroupMembers(annotationId: string): TrackedAnnotation<PdfAnnotationObject>[];
-    /** Check if an annotation is part of a group */
-    isInGroup(annotationId: string): boolean;
-    /** Get the available grouping action for the current selection */
-    getGroupingAction(): GroupingAction;
-    /** Set which annotation categories are locked from UI interaction */
-    setLocked(mode: LockMode): void;
-    /** Get the current lock mode for this document */
-    getLocked(): LockMode;
-    /** Check if a specific annotation is locked (category-based or per-annotation flag).
-     * Legacy predicate kept for backward compatibility. Use `isAnnotationInteractive`,
-     * `isAnnotationStructurallyLocked`, or `isAnnotationContentLocked` for spec-aligned checks. */
-    isAnnotationLocked(annotation: PdfAnnotationObject): boolean;
-    /** Whether the annotation can be interacted with at all. False for `noView`, `hidden`,
-     * `readOnly`, or category-locked annotations. */
-    isAnnotationInteractive(annotation: PdfAnnotationObject): boolean;
-    /** Whether the annotation's structure (move/resize/rotate/vertex) is locked. True if
-     * non-interactive or the PDF `locked` flag is set. */
-    isAnnotationStructurallyLocked(annotation: PdfAnnotationObject): boolean;
-    /** Whether the annotation's content (e.g. FreeText text) is locked. True if
-     * non-interactive or the PDF `lockedContents` flag is set. */
-    isAnnotationContentLocked(annotation: PdfAnnotationObject): boolean;
-    /** Check if a single category is locked under the current mode */
-    isCategoryLocked(category: string): boolean;
-    /** Check if a tool (by ID) is locked under the current mode (resolves tool categories) */
-    isToolLocked(toolId: string): boolean;
-    /** Update annotation object state without marking dirty or triggering commits. Used by the form plugin to sync PDFium state to the UI. */
-    syncAnnotationObject(id: string, patch: Partial<PdfAnnotationObject>): void;
-    /** Navigate to a link target. Returns a result indicating whether the plugin handled it or the caller should open a URI. */
-    navigateTarget(target: PdfLinkTarget): Task<NavigateTargetResult, PdfErrorReason>;
-    onStateChange: EventHook<AnnotationDocumentState>;
-    onAnnotationEvent: EventHook<AnnotationEvent>;
-    onActiveToolChange: EventHook<ToolUnion<TTools> | null>;
-    onNavigate: EventHook<NavigateEvent>;
-}
-export interface AnnotationCapability<TTools extends AnnotationToolMap = AnnotationToolMap> {
-    getState: () => AnnotationDocumentState;
-    getPageAnnotations: (options: GetPageAnnotationsOptions) => Task<PdfAnnotationObject[], PdfErrorReason>;
-    /** @deprecated Use getSelectedAnnotations() for multi-select support. Returns first selected or null. */
-    getSelectedAnnotation: () => TrackedAnnotation | null;
-    /** Get all selected annotations */
-    getSelectedAnnotations: () => TrackedAnnotation[];
-    /** Get the IDs of all selected annotations */
-    getSelectedAnnotationIds: () => string[];
-    getAnnotationById(id: string): TrackedAnnotation | null;
-    /** Get all tracked annotations, optionally filtered by page */
-    getAnnotations: (options?: GetAnnotationsOptions) => TrackedAnnotation[];
-    /** Select a single annotation (clears previous selection) */
-    selectAnnotation: (pageIndex: number, annotationId: string) => void;
-    /** Toggle an annotation in/out of the current selection */
-    toggleSelection: (pageIndex: number, annotationId: string) => void;
-    /** Add an annotation to the current selection */
-    addToSelection: (pageIndex: number, annotationId: string) => void;
-    /** Remove an annotation from the current selection */
-    removeFromSelection: (annotationId: string) => void;
-    /** Set the selection to a specific set of annotation IDs (for marquee) */
-    setSelection: (ids: string[]) => void;
-    /** Clear all selection */
-    deselectAnnotation: () => void;
-    importAnnotations: (items: AnnotationTransferItem[]) => void;
-    exportAnnotations: (options?: ExportAnnotationsOptions, documentId?: string) => Task<AnnotationTransferItem[], PdfErrorReason>;
-    createAnnotation: <A extends PdfAnnotationObject>(pageIndex: number, annotation: A, context?: AnnotationCreateContext<A>) => void;
-    updateAnnotation: (pageIndex: number, annotationId: string, patch: Partial<PdfAnnotationObject>) => void;
-    /** Batch update multiple annotations at once */
-    updateAnnotations: (patches: Array<{
-        pageIndex: number;
-        id: string;
-        patch: Partial<PdfAnnotationObject>;
-    }>) => void;
-    /** Move an annotation by delta or to an absolute position (preserves appearance stream) */
-    moveAnnotation: (pageIndex: number, annotationId: string, position: Position, mode?: 'delta' | 'absolute', documentId?: string) => void;
-    deleteAnnotation: (pageIndex: number, annotationId: string) => void;
-    /** Delete multiple annotations in batch */
-    deleteAnnotations: (annotations: Array<{
-        pageIndex: number;
-        id: string;
-    }>, documentId?: string) => void;
-    /** Delete all annotations from the document */
-    deleteAllAnnotations: (documentId?: string) => void;
-    /** Remove an annotation from state without calling the engine (no PDF modification) */
-    purgeAnnotation: (pageIndex: number, annotationId: string, documentId?: string) => void;
-    renderAnnotation: (options: RenderAnnotationOptions) => Task<Blob, PdfErrorReason>;
-    /** Batch-fetch rendered appearance stream images for all annotations on a page */
-    getPageAppearances: (pageIndex: number, options?: PdfRenderPageAnnotationOptions, documentId?: string) => Task<AnnotationAppearanceMap<Blob>, PdfErrorReason>;
-    /** Clear cached appearance images for a page (e.g. on zoom change) */
-    invalidatePageAppearances: (pageIndex: number, documentId?: string) => void;
-    commit: () => Task<boolean, PdfErrorReason>;
-    /** Get link annotations attached to an annotation via IRT relationship */
-    getAttachedLinks: (annotationId: string, documentId?: string) => TrackedAnnotation[];
-    /** Check if an annotation has attached link children */
-    hasAttachedLinks: (annotationId: string, documentId?: string) => boolean;
-    /** Delete all link annotations attached to an annotation */
-    deleteAttachedLinks: (annotationId: string, documentId?: string) => void;
-    /** Group the currently selected annotations (first selected becomes leader) */
-    groupAnnotations: (documentId?: string) => void;
-    /** Ungroup all annotations in the group containing the specified annotation */
-    ungroupAnnotations: (annotationId: string, documentId?: string) => void;
-    /** Get all annotations in the same group as the specified annotation */
-    getGroupMembers: (annotationId: string, documentId?: string) => TrackedAnnotation<PdfAnnotationObject>[];
-    /** Check if an annotation is part of a group */
-    isInGroup: (annotationId: string, documentId?: string) => boolean;
-    /** Set which annotation categories are locked from UI interaction */
-    setLocked: (mode: LockMode, documentId?: string) => void;
-    /** Get the current lock mode */
-    getLocked: (documentId?: string) => LockMode;
-    /** Check if a specific annotation is locked (category-based or per-annotation flag).
-     * Legacy predicate kept for backward compatibility. */
-    isAnnotationLocked: (annotation: PdfAnnotationObject, documentId?: string) => boolean;
-    /** Whether the annotation can be interacted with at all. False for `noView`, `hidden`,
-     * `readOnly`, or category-locked annotations. */
-    isAnnotationInteractive: (annotation: PdfAnnotationObject, documentId?: string) => boolean;
-    /** Whether the annotation's structure (move/resize/rotate/vertex) is locked. */
-    isAnnotationStructurallyLocked: (annotation: PdfAnnotationObject, documentId?: string) => boolean;
-    /** Whether the annotation's content (e.g. FreeText text) is locked. */
-    isAnnotationContentLocked: (annotation: PdfAnnotationObject, documentId?: string) => boolean;
-    /** Check if a single category is locked under the current mode */
-    isCategoryLocked: (category: string, documentId?: string) => boolean;
-    /** Check if a tool (by ID) is locked under the current mode (resolves tool categories) */
-    isToolLocked: (toolId: string, documentId?: string) => boolean;
-    /** Update annotation object state without marking dirty or triggering commits. Used by the form plugin to sync PDFium state to the UI. */
-    syncAnnotationObject: (id: string, patch: Partial<PdfAnnotationObject>, documentId?: string) => void;
-    /** Navigate to a link target. Returns a result indicating whether the plugin handled it or the caller should open a URI. */
-    navigateTarget: (target: PdfLinkTarget, documentId?: string) => Task<NavigateTargetResult, PdfErrorReason>;
-    forDocument: (documentId: string) => AnnotationScope<TTools>;
-    getActiveTool: () => ToolUnion<TTools> | null;
-    setActiveTool: {
-        <TId extends ToolId<TTools>>(toolId: TId | null, context?: Record<string, unknown>): void;
-        (toolId: string | null, context?: Record<string, unknown>): void;
-    };
-    getTools: () => Array<ToolUnion<TTools>>;
-    getTool: {
-        <TId extends ToolId<TTools>>(toolId: TId): ToolEntry<TTools, TId> | undefined;
-        (toolId: string): AnnotationTool | undefined;
-    };
-    addTool: <T extends AnnotationTool<any> = AnnotationTool<any>>(tool: T) => void;
-    findToolForAnnotation: (annotation: PdfAnnotationObject) => ToolUnion<TTools> | null;
-    setToolDefaults: {
-        <TId extends ToolId<TTools>>(toolId: TId, patch: Partial<ToolById<TTools, TId>['defaults']>): void;
-        (toolId: string, patch: Partial<PdfAnnotationObject> & Record<string, unknown>): void;
-    };
-    getColorPresets: () => string[];
-    addColorPreset: (color: string) => void;
-    /**
-     * Transform an annotation based on interaction (move, resize, etc.)
-     * This applies annotation-specific logic to ensure consistency.
-     */
-    transformAnnotation: <T extends PdfAnnotationObject>(annotation: T, options: TransformOptions<T>) => Partial<T>;
-    onStateChange: EventHook<AnnotationStateChangeEvent>;
-    onActiveToolChange: EventHook<AnnotationActiveToolChangeEvent>;
-    onAnnotationEvent: EventHook<AnnotationEvent>;
-    onToolsChange: EventHook<AnnotationToolsChangeEvent>;
-    onNavigate: EventHook<NavigateEvent>;
-}
-export interface GetPageAnnotationsOptions {
-    pageIndex: number;
-}
-export interface GetAnnotationsOptions {
-    /** Filter annotations by page index. Omit to get all annotations. */
-    pageIndex?: number;
-}
-export interface SidebarAnnotationEntry {
-    page: number;
-    annotation: TrackedAnnotation;
-    replies: TrackedAnnotation<PdfTextAnnoObject>[];
-    groupMembers?: TrackedAnnotation[];
-}
-/**
- * Information about an annotation needed for constraint calculation.
- */
-export interface AnnotationConstraintInfo {
-    id: string;
-    rect: Rect;
-    pageIndex: number;
-    pageSize: Size;
-}
-/**
- * Combined constraints representing the intersection of all selected annotations' movement limits.
- * These are the maximum distances the group can move in each direction without any annotation
- * leaving its page bounds.
- */
-export interface CombinedConstraints {
-    /** Maximum distance we can move up (positive = can move up) */
-    maxUp: number;
-    /** Maximum distance we can move down */
-    maxDown: number;
-    /** Maximum distance we can move left */
-    maxLeft: number;
-    /** Maximum distance we can move right */
-    maxRight: number;
-}
-/**
- * Options for starting a unified drag operation.
- * The plugin will automatically expand to include attached links.
- */
-export interface UnifiedDragOptions {
-    /** The explicitly selected/dragged annotation IDs */
-    annotationIds: string[];
-    /** Page size for constraint calculation */
-    pageSize: Size;
-}
-/**
- * State of the unified drag operation.
- * Managed entirely by the plugin - framework components just subscribe.
- */
-export interface UnifiedDragState {
-    /** The document this drag belongs to */
-    documentId: string;
-    /** Whether a drag is currently in progress */
-    isDragging: boolean;
-    /** The explicitly selected annotation IDs (what the user selected) */
-    primaryIds: string[];
-    /** Auto-expanded attached link IDs */
-    attachedLinkIds: string[];
-    /** All participant IDs (primaryIds + attachedLinkIds) */
-    allParticipantIds: string[];
-    /** Original rects for all participants (for computing final patches) */
-    originalRects: Map<string, Rect>;
-    /** Current cumulative delta (already clamped to constraints) */
-    delta: Position;
-    /** Combined constraints computed at drag start */
-    combinedConstraints: CombinedConstraints;
-}
-/**
- * Event emitted when unified drag state changes.
- */
-export interface UnifiedDragEvent {
-    /** The document this event belongs to */
-    documentId: string;
-    /** The type of change */
-    type: 'start' | 'update' | 'end' | 'cancel';
-    /** Current state */
-    state: UnifiedDragState;
-    /** Pre-computed patches for ALL participants - components just apply directly! */
-    previewPatches: Record<string, Partial<PdfAnnotationObject>>;
-}
-/**
- * Options for starting a unified resize operation.
- * The plugin will automatically expand to include attached links.
- */
-export interface UnifiedResizeOptions {
-    /** The explicitly selected annotation IDs */
-    annotationIds: string[];
-    /** Page size for constraint calculation */
-    pageSize: Size;
-    /** Which resize handle is being used */
-    resizeHandle: string;
-}
-/**
- * Information about an annotation participating in unified resize.
- */
-export interface UnifiedResizeAnnotationInfo {
-    id: string;
-    originalRect: Rect;
-    /** The original unrotated rect at resize start (only for rotated annotations) */
-    originalUnrotatedRect?: Rect;
-    pageIndex: number;
-    /** Whether this is an attached link (auto-expanded) */
-    isAttachedLink: boolean;
-    /** The parent annotation ID (if this is an attached link) */
-    parentId?: string;
-    /** Relative X position within group (0-1) */
-    relativeX: number;
-    /** Relative Y position within group (0-1) */
-    relativeY: number;
-    /** Relative width within group (0-1) */
-    relativeWidth: number;
-    /** Relative height within group (0-1) */
-    relativeHeight: number;
-}
-/**
- * State of the unified resize operation.
- * Managed entirely by the plugin - framework components just subscribe.
- */
-export interface UnifiedResizeState {
-    /** The document this resize belongs to */
-    documentId: string;
-    /** Whether a resize is currently in progress */
-    isResizing: boolean;
-    /** Whether this is a group resize (multiple primary annotations) */
-    isGroupResize: boolean;
-    /** The explicitly selected annotation IDs (what the user selected) */
-    primaryIds: string[];
-    /** Auto-expanded attached link IDs */
-    attachedLinkIds: string[];
-    /** All participant IDs (primaryIds + attachedLinkIds) */
-    allParticipantIds: string[];
-    /** The original group bounding box at resize start */
-    originalGroupBox: Rect;
-    /** The current (resized) group bounding box */
-    currentGroupBox: Rect;
-    /** All annotations participating with their relative positions */
-    participatingAnnotations: UnifiedResizeAnnotationInfo[];
-    /** Which resize handle is being used */
-    resizeHandle: string;
-    /** Current computed rects for all participants */
-    computedRects: Map<string, Rect>;
-}
-/**
- * Event emitted when unified resize state changes.
- */
-export interface UnifiedResizeEvent {
-    /** The document this event belongs to */
-    documentId: string;
-    /** The type of change */
-    type: 'start' | 'update' | 'end' | 'cancel';
-    /** Current state */
-    state: UnifiedResizeState;
-    /** Per-annotation computed rects for convenience (id -> new rect) */
-    computedRects: Record<string, Rect>;
-    /** Pre-computed patches for ALL participants - components just apply directly! */
-    previewPatches: Record<string, Partial<PdfAnnotationObject>>;
-}
-export interface UnifiedRotateOptions {
-    /** The explicitly selected annotation IDs */
-    annotationIds: string[];
-    /** Angle reported by the interaction controller at gesture start */
-    cursorAngle: number;
-    /** Optional rotation center override (defaults to selection center) */
-    rotationCenter?: Position;
-}
-export interface UnifiedRotateParticipant {
-    id: string;
-    rect: Rect;
-    pageIndex: number;
-    rotation: number;
-    unrotatedRect?: Rect;
-    isAttachedLink: boolean;
-    parentId?: string;
-}
-export interface UnifiedRotateState {
-    documentId: string;
-    isRotating: boolean;
-    primaryIds: string[];
-    attachedLinkIds: string[];
-    allParticipantIds: string[];
-    rotationCenter: Position;
-    cursorStartAngle: number;
-    currentAngle: number;
-    delta: number;
-    participants: UnifiedRotateParticipant[];
-}
-export interface UnifiedRotateEvent {
-    documentId: string;
-    type: 'start' | 'update' | 'end' | 'cancel';
-    state: UnifiedRotateState;
-    previewPatches: Record<string, Partial<PdfAnnotationObject>>;
-}
-export {};

package/dist/lib/utils/index.d.ts

@@ -1 +0,0 @@
-export * from './use-state';

package/dist/lib/utils/use-state.d.ts

@@ -1,12 +0,0 @@
-/**
- * A simple, framework-agnostic state management utility for use within handlers.
- * It creates a closure to hold a value that persists across multiple calls
- * to the handler's methods (e.g., onPointerDown, onPointerMove).
- *
- * @param initialValue The initial value to store.
- * @returns A tuple containing:
- * - The current value.
- * - A function to set a new value.
- * - A function to get the current value without causing re-renders (useful inside closures).
- */
-export declare function useState<T>(initialValue: T): [() => T, (newValue: T) => void];