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

package/package.json

@@ -1,90 +1,50 @@
 {
   "name": "@embedpdf/plugin-annotation",
-  "version": "2.15.0",
+  "version": "3.0.0-next.0",
+  "private": false,
+  "description": "Annotation feature plugin: the pure annotation-core wired to the engine repository (optimistic create/patch/delete) + the interaction hub (ambient edit + draw tools). Behaviors (forms) plug in here.",
   "type": "module",
-  "license": "MIT",
-  "main": "./dist/index.cjs",
+  "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./preact": {
-      "types": "./dist/preact/index.d.ts",
-      "import": "./dist/preact/index.js",
-      "require": "./dist/preact/index.cjs"
+    "./internal": {
+      "import": "./dist/internal.js",
+      "require": "./dist/internal.cjs"
     },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js",
-      "require": "./dist/react/index.cjs"
-    },
-    "./vue": {
-      "types": "./dist/vue/index.d.ts",
-      "import": "./dist/vue/index.js",
-      "require": "./dist/vue/index.cjs"
-    },
-    "./svelte": {
-      "types": "./dist/svelte/index.d.ts",
-      "svelte": "./dist/svelte/index.js",
-      "import": "./dist/svelte/index.js",
-      "require": "./dist/svelte/index.cjs"
-    }
+    "./package.json": "./package.json"
   },
+  "files": [
+    "dist"
+  ],
   "dependencies": {
-    "@embedpdf/models": "2.15.0",
-    "@embedpdf/utils": "2.15.0"
+    "@embedpdf/engine-core": "3.0.0-next.0",
+    "@embedpdf/plugin-interaction": "3.0.0-next.0",
+    "@embedpdf/core-annotation": "3.0.0-next.0",
+    "@embedpdf/plugin-selection": "3.0.0-next.0",
+    "@embedpdf/core": "3.0.0-next.0",
+    "@embedpdf/core-geometry": "3.0.0-next.0"
   },
   "devDependencies": {
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
     "typescript": "^5.0.0",
-    "@embedpdf/build": "1.1.0",
-    "@embedpdf/plugin-interaction-manager": "2.15.0",
-    "@embedpdf/plugin-history": "2.15.0",
-    "@embedpdf/plugin-scroll": "2.15.0",
-    "@embedpdf/plugin-selection": "2.15.0"
-  },
-  "peerDependencies": {
-    "react": ">=16.8.0",
-    "react-dom": ">=16.8.0",
-    "preact": "^10.26.4",
-    "vue": ">=3.2.0",
-    "svelte": ">=5 <6",
-    "@embedpdf/core": "2.15.0",
-    "@embedpdf/plugin-selection": "2.15.0",
-    "@embedpdf/plugin-interaction-manager": "2.15.0",
-    "@embedpdf/plugin-scroll": "2.15.0",
-    "@embedpdf/plugin-history": "2.15.0"
+    "vitest": "^2.1.9",
+    "@embedpdf/tooling-build": "0.0.0"
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
+  "license": "Apache-2.0",
+  "sideEffects": false,
   "repository": {
     "type": "git",
-    "url": "https://github.com/embedpdf/embed-pdf-viewer",
-    "directory": "packages/plugin-annotation"
-  },
-  "homepage": "https://www.embedpdf.com/docs",
-  "bugs": {
-    "url": "https://github.com/embedpdf/embed-pdf-viewer/issues"
-  },
-  "publishConfig": {
-    "access": "public"
+    "url": "git+https://github.com/embedpdf/embed-pdf-viewer.git",
+    "directory": "packages/plugin/annotation"
   },
   "scripts": {
-    "build:base": "vite build --mode base",
-    "build:react": "vite build --mode react",
-    "build:preact": "vite build --mode preact",
-    "build:vue": "vite build --mode vue",
-    "build:svelte": "vite build --mode svelte",
-    "build": "pnpm run clean && concurrently -c auto -n base,react,preact,vue,svelte \"vite build --mode base\" \"vite build --mode react\" \"vite build --mode preact\" \"vite build --mode vue\" \"vite build --mode svelte\"",
+    "build": "epdf-build",
     "clean": "rimraf dist",
-    "lint": "eslint src --color",
-    "lint:fix": "eslint src --color --fix"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
   }
 }

package/dist/lib/actions.d.ts

@@ -1,192 +0,0 @@
-import { Action } from '@embedpdf/core';
-import { PdfAnnotationObject } from '@embedpdf/models';
-import { AnnotationTool } from './tools/types';
-import { AnnotationDocumentState, LockMode } from './types';
-export declare const INIT_ANNOTATION_STATE = "ANNOTATION/INIT_STATE";
-export declare const CLEANUP_ANNOTATION_STATE = "ANNOTATION/CLEANUP_STATE";
-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";
-export declare const MOVE_ANNOTATION = "ANNOTATION/MOVE_ANNOTATION";
-export declare const DELETE_ANNOTATION = "ANNOTATION/DELETE_ANNOTATION";
-export declare const COMMIT_PENDING_CHANGES = "ANNOTATION/COMMIT";
-export declare const PURGE_ANNOTATION = "ANNOTATION/PURGE_ANNOTATION";
-export declare const SET_LOCKED = "ANNOTATION/SET_LOCKED";
-export declare const SYNC_ANNOTATION_OBJECT = "ANNOTATION/SYNC_OBJECT";
-export declare const ADD_COLOR_PRESET = "ANNOTATION/ADD_COLOR_PRESET";
-export declare const SET_TOOL_DEFAULTS = "ANNOTATION/SET_TOOL_DEFAULTS";
-export declare const ADD_TOOL = "ANNOTATION/ADD_TOOL";
-export interface InitAnnotationStateAction extends Action {
-    type: typeof INIT_ANNOTATION_STATE;
-    payload: {
-        documentId: string;
-        state: AnnotationDocumentState;
-    };
-}
-export interface CleanupAnnotationStateAction extends Action {
-    type: typeof CLEANUP_ANNOTATION_STATE;
-    payload: string;
-}
-export interface SetActiveDocumentAction extends Action {
-    type: typeof SET_ACTIVE_DOCUMENT;
-    payload: string | null;
-}
-export interface SetAnnotationsAction extends Action {
-    type: typeof SET_ANNOTATIONS;
-    payload: {
-        documentId: string;
-        annotations: Record<number, PdfAnnotationObject[]>;
-    };
-}
-export interface SelectAnnotationAction extends Action {
-    type: typeof SELECT_ANNOTATION;
-    payload: {
-        documentId: string;
-        pageIndex: number;
-        id: string;
-    };
-}
-export interface DeselectAnnotationAction extends Action {
-    type: typeof DESELECT_ANNOTATION;
-    payload: {
-        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: {
-        documentId: string;
-        toolId: string | null;
-        context?: Record<string, unknown>;
-    };
-}
-export interface CreateAnnotationAction extends Action {
-    type: typeof CREATE_ANNOTATION;
-    payload: {
-        documentId: string;
-        pageIndex: number;
-        annotation: PdfAnnotationObject;
-    };
-}
-export interface PatchAnnotationAction extends Action {
-    type: typeof PATCH_ANNOTATION;
-    payload: {
-        documentId: string;
-        pageIndex: number;
-        id: string;
-        patch: Partial<PdfAnnotationObject>;
-    };
-}
-export interface MoveAnnotationAction extends Action {
-    type: typeof MOVE_ANNOTATION;
-    payload: {
-        documentId: string;
-        pageIndex: number;
-        id: string;
-        patch: Partial<PdfAnnotationObject>;
-    };
-}
-export interface DeleteAnnotationAction extends Action {
-    type: typeof DELETE_ANNOTATION;
-    payload: {
-        documentId: string;
-        pageIndex: number;
-        id: string;
-    };
-}
-export interface CommitAction extends Action {
-    type: typeof COMMIT_PENDING_CHANGES;
-    payload: {
-        documentId: string;
-        committedUids: string[];
-    };
-}
-export interface PurgeAnnotationAction extends Action {
-    type: typeof PURGE_ANNOTATION;
-    payload: {
-        documentId: string;
-        pageIndex: number;
-        uid: string;
-    };
-}
-export interface SetLockedAction extends Action {
-    type: typeof SET_LOCKED;
-    payload: {
-        documentId: string;
-        mode: LockMode;
-    };
-}
-export interface SyncAnnotationObjectAction extends Action {
-    type: typeof SYNC_ANNOTATION_OBJECT;
-    payload: {
-        documentId: string;
-        id: string;
-        patch: Partial<PdfAnnotationObject>;
-    };
-}
-export interface AddColorPresetAction extends Action {
-    type: typeof ADD_COLOR_PRESET;
-    payload: string;
-}
-export interface SetToolDefaultsAction extends Action {
-    type: typeof SET_TOOL_DEFAULTS;
-    payload: {
-        toolId: string;
-        patch: Partial<PdfAnnotationObject> & Record<string, unknown>;
-    };
-}
-export interface AddToolAction extends Action {
-    type: typeof ADD_TOOL;
-    payload: AnnotationTool<any>;
-}
-export type AnnotationAction = InitAnnotationStateAction | CleanupAnnotationStateAction | SetActiveDocumentAction | SetAnnotationsAction | SelectAnnotationAction | DeselectAnnotationAction | AddToSelectionAction | RemoveFromSelectionAction | SetSelectionAction | SetActiveToolIdAction | CreateAnnotationAction | PatchAnnotationAction | MoveAnnotationAction | DeleteAnnotationAction | CommitAction | PurgeAnnotationAction | SetLockedAction | SyncAnnotationObjectAction | 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, context?: Record<string, unknown>) => 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 moveAnnotation: (documentId: string, pageIndex: number, id: string, patch: Partial<PdfAnnotationObject>) => MoveAnnotationAction;
-export declare const deleteAnnotation: (documentId: string, pageIndex: number, id: string) => DeleteAnnotationAction;
-export declare const commitPendingChanges: (documentId: string, committedUids: string[]) => CommitAction;
-export declare const purgeAnnotation: (documentId: string, pageIndex: number, uid: string) => PurgeAnnotationAction;
-export declare const setLockedAction: (documentId: string, mode: LockMode) => SetLockedAction;
-export declare const syncAnnotationObject: (documentId: string, id: string, patch: Partial<PdfAnnotationObject>) => SyncAnnotationObjectAction;
-export declare const addColorPreset: (c: string) => AddColorPresetAction;
-export declare const setToolDefaults: (toolId: string, patch: Partial<PdfAnnotationObject> & Record<string, unknown>) => SetToolDefaultsAction;
-export declare const addTool: (tool: AnnotationTool<any>) => AddToolAction;

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

@@ -1,310 +0,0 @@
-import { BasePlugin, PluginRegistry } from '@embedpdf/core';
-import { PdfAnnotationObject, Position, Rect } from '@embedpdf/models';
-import { AnnotationCapability, AnnotationPluginConfig, AnnotationState, UnifiedDragOptions, UnifiedDragState, UnifiedDragEvent, UnifiedResizeOptions, UnifiedResizeState, UnifiedResizeEvent, UnifiedRotateOptions, UnifiedRotateState, UnifiedRotateEvent, LockMode } from './types';
-import { AnnotationAction } from './actions';
-import { AnnotationTool, AnnotationToolMap, ToolById, ToolId } from './tools/types';
-import { PreviewState, HandlerServices } from './handlers/types';
-export declare class AnnotationPlugin extends BasePlugin<AnnotationPluginConfig, AnnotationCapability, AnnotationState, AnnotationAction> {
-    static readonly id: "annotation";
-    private readonly ANNOTATION_HISTORY_TOPIC;
-    private static readonly defaultHandlerFactories;
-    readonly config: AnnotationPluginConfig;
-    private readonly state$;
-    private readonly interactionManager;
-    private readonly selection;
-    private readonly history;
-    private readonly scroll;
-    private pendingContexts;
-    private isInitialLoadComplete;
-    private importQueue;
-    private commitInProgress;
-    private readonly activeTool$;
-    private readonly events$;
-    private readonly toolsChange$;
-    private readonly appearanceCache;
-    private readonly unifiedDragStates;
-    private readonly unifiedDrag$;
-    private readonly unifiedResizeStates;
-    private readonly unifiedResize$;
-    private readonly unifiedRotateStates;
-    private readonly unifiedRotate$;
-    private readonly navigate$;
-    constructor(id: string, registry: PluginRegistry, config: AnnotationPluginConfig);
-    protected onDocumentLoadingStarted(documentId: string): void;
-    protected onDocumentLoaded(documentId: string): void;
-    protected onDocumentClosed(documentId: string): void;
-    initialize(): Promise<void>;
-    private registerInteractionForTool;
-    protected buildCapability(): AnnotationCapability;
-    private createAnnotationScope;
-    onStoreUpdated(prev: AnnotationState, next: AnnotationState): void;
-    private transformAnnotation;
-    registerPageHandlers(documentId: string, pageIndex: number, scale: number, callbacks: {
-        services: HandlerServices;
-        onPreview: (toolId: string, state: PreviewState | null) => void;
-    }): () => void;
-    private getDocumentState;
-    private getAllAnnotations;
-    private getPageAnnotations;
-    private getSelectedAnnotation;
-    private getAnnotationById;
-    private getAnnotationsMethod;
-    private renderAnnotation;
-    /**
-     * Batch-fetch rendered appearance stream images for all annotations on a page.
-     * Results are cached per document + page. Call invalidatePageAppearances to clear.
-     */
-    private getPageAppearances;
-    /**
-     * Clear cached appearances for a specific page (e.g. on zoom change).
-     */
-    private invalidatePageAppearances;
-    /**
-     * Remove a single annotation's entry from the page appearance cache.
-     * Used after committing changes that regenerate the annotation's appearance.
-     */
-    private invalidateAnnotationAppearance;
-    private exportAnnotationsMethod;
-    private importAnnotations;
-    private processImportQueue;
-    private processImportItems;
-    private createAnnotation;
-    private buildPatch;
-    private updateAnnotation;
-    private deleteAnnotation;
-    private deleteAnnotationsMethod;
-    private deleteAllAnnotationsMethod;
-    private purgeAnnotationMethod;
-    private selectAnnotation;
-    private deselectAnnotation;
-    /**
-     * Derive page activity from the current annotation selection.
-     * Called from onStoreUpdated whenever selectedUids changes,
-     * so ALL selection code paths are covered automatically.
-     */
-    private updateAnnotationSelectionActivity;
-    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 cloneRect;
-    private translateRect;
-    private normalizeAngle;
-    private normalizeDelta;
-    private buildRotationParticipants;
-    private computeRotatePreviewPatches;
-    startRotation(documentId: string, options: UnifiedRotateOptions): void;
-    updateRotation(documentId: string, cursorAngle: number, rotationDelta?: number): void;
-    commitRotation(documentId: string): void;
-    cancelRotation(documentId: string): void;
-    getRotateState(documentId: string): UnifiedRotateState | null;
-    /**
-     * Subscribe to unified rotation state changes.
-     */
-    get onRotateChange(): import('@embedpdf/core').EventHook<UnifiedRotateEvent>;
-    private updateAnnotationsMethod;
-    private moveAnnotationsMethod;
-    private moveAnnotationMethod;
-    getActiveTool(documentId?: string): AnnotationTool | null;
-    setActiveTool(toolId: string | null, documentId?: string, context?: Record<string, unknown>): void;
-    getTool<TId extends ToolId<AnnotationToolMap>>(toolId: TId): (ToolById<AnnotationToolMap, TId> & AnnotationTool) | undefined;
-    getTool(toolId: string): AnnotationTool | undefined;
-    findToolForAnnotation(annotation: PdfAnnotationObject): AnnotationTool | null;
-    setLocked(mode: LockMode, documentId?: string): void;
-    getLocked(documentId?: string): LockMode;
-    isAnnotationLocked(annotation: PdfAnnotationObject, documentId?: string): boolean;
-    /**
-     * Whether the annotation can be interacted with at all (selected, edited, menu shown).
-     * Returns false for `noView`, `hidden`, `readOnly`, or category-locked annotations.
-     * This is the spec-compliant "can the user do anything with this?" predicate.
-     */
-    isAnnotationInteractive(annotation: PdfAnnotationObject, documentId?: string): boolean;
-    /**
-     * Whether the annotation's structure (position, size, rotation, vertices) is locked.
-     * Non-interactive annotations are treated as structurally locked. PDF `locked` flag
-     * makes an otherwise-interactive annotation structurally locked while still selectable.
-     */
-    isAnnotationStructurallyLocked(annotation: PdfAnnotationObject, documentId?: string): boolean;
-    /**
-     * Whether the annotation's content (e.g. FreeText text) is locked.
-     * Non-interactive annotations are treated as content-locked. PDF `lockedContents`
-     * flag blocks content edits while still allowing move/resize.
-     */
-    isAnnotationContentLocked(annotation: PdfAnnotationObject, documentId?: string): boolean;
-    /**
-     * Whether a specific annotation is eligible to be added to the selection store.
-     * Differs from the subtype-based `isSelectableAnnotation` helper: that answers
-     * "is this subtype ever selectable?", while this answers "is this specific
-     * annotation selectable right now given its flags and document lock state?".
-     */
-    private isAnnotationSelectable;
-    isCategoryLockedMethod(category: string, documentId?: string): boolean;
-    isToolLockedMethod(toolId: string, documentId?: string): boolean;
-    syncAnnotationObject(id: string, patch: Partial<PdfAnnotationObject>, documentId?: string): void;
-    private navigateTargetMethod;
-    /**
-     * 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;
-}