@embedpdf/plugin-annotation 2.6.2 → 2.8.0

package/dist/index.js

@@ -28,6 +28,7 @@ const SET_SELECTION = "ANNOTATION/SET_SELECTION";
 const SET_ACTIVE_TOOL_ID = "ANNOTATION/SET_ACTIVE_TOOL_ID";
 const CREATE_ANNOTATION = "ANNOTATION/CREATE_ANNOTATION";
 const PATCH_ANNOTATION = "ANNOTATION/PATCH_ANNOTATION";
+const MOVE_ANNOTATION = "ANNOTATION/MOVE_ANNOTATION";
 const DELETE_ANNOTATION = "ANNOTATION/DELETE_ANNOTATION";
 const COMMIT_PENDING_CHANGES = "ANNOTATION/COMMIT";
 const PURGE_ANNOTATION = "ANNOTATION/PURGE_ANNOTATION";
@@ -76,6 +77,10 @@ const patchAnnotation = (documentId, pageIndex, id, patch) => ({
   type: PATCH_ANNOTATION,
   payload: { documentId, pageIndex, id, patch }
 });
+const moveAnnotation = (documentId, pageIndex, id, patch) => ({
+  type: MOVE_ANNOTATION,
+  payload: { documentId, pageIndex, id, patch }
+});
 const deleteAnnotation = (documentId, pageIndex, id) => ({
   type: DELETE_ANNOTATION,
   payload: { documentId, pageIndex, id }
@@ -151,8 +156,11 @@ function isLink(a) {
 function isRedact(a) {
   return a.object.type === PdfAnnotationSubtype.REDACT;
 }
+function isCaret(a) {
+  return a.object.type === PdfAnnotationSubtype.CARET;
+}
 function isSidebarAnnotation(a) {
-  return isTextMarkup(a) || isInk(a) || isSquare(a) || isCircle(a) || isPolygon(a) || isLine(a) || isPolyline(a) || isFreeText(a) || isStamp(a) || isRedact(a);
+  return isText(a) && !a.object.inReplyToId || isTextMarkup(a) || isInk(a) || isSquare(a) || isCircle(a) || isPolygon(a) || isLine(a) || isPolyline(a) || isFreeText(a) || isStamp(a) || isRedact(a) || isCaret(a);
 }
 const getAnnotationsByPageIndex = (s, page) => (s.pages[page] ?? []).map((uid) => s.byUid[uid]);
 const getAnnotations = (s) => {
@@ -194,19 +202,33 @@ const getSidebarAnnotationsWithRepliesGroupedByPage = (s) => {
       }
     }
   }
+  const membersByLeader = {};
+  const consumedAsGroupMember = /* @__PURE__ */ new Set();
+  for (const uidList of Object.values(s.pages)) {
+    for (const uid of uidList) {
+      const ta = s.byUid[uid];
+      if (ta && ta.object.inReplyToId && ta.object.replyType === PdfAnnotationReplyType.Group && ta.object.type !== PdfAnnotationSubtype.LINK && isSidebarAnnotation(ta)) {
+        const leaderId = ta.object.inReplyToId;
+        (membersByLeader[leaderId] || (membersByLeader[leaderId] = [])).push(ta);
+        consumedAsGroupMember.add(ta.object.id);
+      }
+    }
+  }
   const out = {};
   for (const [pageStr, uidList] of Object.entries(s.pages)) {
     const page = Number(pageStr);
     const pageAnnotations = [];
     for (const uid of uidList) {
       const ta = s.byUid[uid];
-      if (ta && isSidebarAnnotation(ta)) {
-        pageAnnotations.push({
-          page,
-          annotation: ta,
-          replies: repliesByParent[ta.object.id] ?? []
-        });
-      }
+      if (!ta || !isSidebarAnnotation(ta)) continue;
+      if (consumedAsGroupMember.has(ta.object.id)) continue;
+      const members = membersByLeader[ta.object.id];
+      pageAnnotations.push({
+        page,
+        annotation: ta,
+        replies: repliesByParent[ta.object.id] ?? [],
+        ...members && members.length > 0 ? { groupMembers: members } : {}
+      });
     }
     if (pageAnnotations.length > 0) {
       out[page] = pageAnnotations;
@@ -329,6 +351,7 @@ const defaultTools = [
       textSelection: true,
       isDraggable: false,
       isResizable: false,
+      isRotatable: false,
       // Text markup annotations are anchored to text and should not move/resize in groups
       isGroupDraggable: false,
       isGroupResizable: false
@@ -351,6 +374,7 @@ const defaultTools = [
       textSelection: true,
       isDraggable: false,
       isResizable: false,
+      isRotatable: false,
       isGroupDraggable: false,
       isGroupResizable: false
     },
@@ -371,6 +395,7 @@ const defaultTools = [
       textSelection: true,
       isDraggable: false,
       isResizable: false,
+      isRotatable: false,
       isGroupDraggable: false,
       isGroupResizable: false
     },
@@ -391,6 +416,7 @@ const defaultTools = [
       textSelection: true,
       isDraggable: false,
       isResizable: false,
+      isRotatable: false,
       isGroupDraggable: false,
       isGroupResizable: false
     },
@@ -402,6 +428,59 @@ const defaultTools = [
       opacity: 1
     }
   },
+  // Insert Text (Caret with intent Insert)
+  {
+    id: "insertText",
+    name: "Insert Text",
+    matchScore: (a) => {
+      var _a;
+      if (a.type !== PdfAnnotationSubtype.CARET) return 0;
+      return ((_a = a.intent) == null ? void 0 : _a.includes("Insert")) ? 2 : 1;
+    },
+    interaction: {
+      exclusive: false,
+      textSelection: true,
+      showSelectionRects: true,
+      isDraggable: false,
+      isResizable: false,
+      isRotatable: false,
+      isGroupDraggable: false,
+      isGroupResizable: false
+    },
+    defaults: {
+      type: PdfAnnotationSubtype.CARET,
+      strokeColor: "#E44234",
+      opacity: 1,
+      intent: "Insert"
+    }
+  },
+  // Replace Text (StrikeOut + Caret group)
+  {
+    id: "replaceText",
+    name: "Replace Text",
+    matchScore: (a) => {
+      var _a, _b;
+      if (a.type === PdfAnnotationSubtype.STRIKEOUT && ((_a = a.intent) == null ? void 0 : _a.includes("StrikeOutTextEdit")))
+        return 2;
+      if (a.type === PdfAnnotationSubtype.CARET && ((_b = a.intent) == null ? void 0 : _b.includes("Replace"))) return 2;
+      return 0;
+    },
+    interaction: {
+      exclusive: false,
+      textSelection: true,
+      isDraggable: false,
+      isResizable: false,
+      isRotatable: false,
+      isGroupDraggable: false,
+      isGroupResizable: false
+    },
+    defaults: {
+      type: PdfAnnotationSubtype.STRIKEOUT,
+      strokeColor: "#E44234",
+      opacity: 1,
+      intent: "StrikeOutTextEdit"
+    }
+  },
   // Drawing Tools
   {
     id: "ink",
@@ -626,6 +705,26 @@ const defaultTools = [
     }
   },
   // Text & Stamp
+  {
+    id: "textComment",
+    name: "Comment",
+    matchScore: (a) => a.type === PdfAnnotationSubtype.TEXT && !a.inReplyToId ? 1 : 0,
+    interaction: {
+      exclusive: false,
+      cursor: "crosshair",
+      isDraggable: true,
+      isResizable: false,
+      isRotatable: false
+    },
+    defaults: {
+      type: PdfAnnotationSubtype.TEXT,
+      strokeColor: "#FFCD45",
+      opacity: 1
+    },
+    behavior: {
+      selectAfterCreate: true
+    }
+  },
   {
     id: "freeText",
     name: "Free Text",
@@ -681,7 +780,8 @@ const defaultTools = [
       // No imageSrc by default, which tells the UI to open a file picker
     },
     behavior: {
-      insertUpright: true
+      insertUpright: true,
+      useAppearanceStream: false
     }
   }
 ];
@@ -715,7 +815,25 @@ const patchAnno = (docState, uid, patch) => {
       ...docState.byUid,
       [uid]: {
         ...prev,
-        commitState: prev.commitState === "synced" ? "dirty" : prev.commitState,
+        commitState: prev.commitState === "synced" || prev.commitState === "moved" ? "dirty" : prev.commitState,
+        object: { ...prev.object, ...patch },
+        dictMode: true
+      }
+    },
+    hasPendingChanges: true
+  };
+};
+const moveAnno = (docState, uid, patch) => {
+  const prev = docState.byUid[uid];
+  if (!prev) return docState;
+  return {
+    ...docState,
+    byUid: {
+      ...docState.byUid,
+      [uid]: {
+        ...prev,
+        // synced -> moved, moved -> moved, dirty stays dirty, new stays new
+        commitState: prev.commitState === "synced" ? "moved" : prev.commitState,
         object: { ...prev.object, ...patch }
       }
     },
@@ -928,7 +1046,7 @@ const reducer = (state, action) => {
             },
             byUid: {
               ...docState.byUid,
-              [uid]: { commitState: "new", object: annotation }
+              [uid]: { commitState: "new", object: annotation, dictMode: true }
             },
             hasPendingChanges: true
           }
@@ -970,6 +1088,18 @@ const reducer = (state, action) => {
         }
       };
     }
+    case MOVE_ANNOTATION: {
+      const { documentId, id, patch } = action.payload;
+      const docState = state.documents[documentId];
+      if (!docState) return state;
+      return {
+        ...state,
+        documents: {
+          ...state.documents,
+          [documentId]: moveAnno(docState, id, patch)
+        }
+      };
+    }
     case COMMIT_PENDING_CHANGES: {
       const { documentId, committedUids } = action.payload;
       const docState = state.documents[documentId];
@@ -981,11 +1111,11 @@ const reducer = (state, action) => {
         if (committedSet.has(uid)) {
           cleaned[uid] = {
             ...ta,
-            commitState: ta.commitState === "dirty" || ta.commitState === "new" ? "synced" : ta.commitState
+            commitState: ta.commitState === "dirty" || ta.commitState === "new" || ta.commitState === "moved" ? "synced" : ta.commitState
           };
         } else {
           cleaned[uid] = ta;
-          if (ta.commitState === "new" || ta.commitState === "dirty" || ta.commitState === "deleted") {
+          if (ta.commitState === "new" || ta.commitState === "dirty" || ta.commitState === "moved" || ta.commitState === "deleted") {
             stillHasPending = true;
           }
         }
@@ -1146,45 +1276,6 @@ const inkHandlerFactory = {
     };
   }
 };
-function useClickDetector({
-  threshold = 5,
-  getTool,
-  onClickDetected
-}) {
-  const [getStartPos, setStartPos] = useState(null);
-  const [getHasMoved, setHasMoved] = useState(false);
-  return {
-    onStart: (pos) => {
-      setStartPos(pos);
-      setHasMoved(false);
-    },
-    onMove: (pos) => {
-      const start = getStartPos();
-      if (!start || getHasMoved()) return;
-      const distance = Math.sqrt(Math.pow(pos.x - start.x, 2) + Math.pow(pos.y - start.y, 2));
-      if (distance > threshold) {
-        setHasMoved(true);
-      }
-    },
-    onEnd: (pos) => {
-      var _a;
-      const start = getStartPos();
-      if (start && !getHasMoved()) {
-        const tool = getTool();
-        if (tool && "clickBehavior" in tool && ((_a = tool.clickBehavior) == null ? void 0 : _a.enabled)) {
-          onClickDetected(pos, tool);
-        }
-      }
-      setStartPos(null);
-      setHasMoved(false);
-    },
-    hasMoved: getHasMoved,
-    reset: () => {
-      setStartPos(null);
-      setHasMoved(false);
-    }
-  };
-}
 function createArrowHandler(isClosed) {
   const calculateGeometry = (sw) => {
     const len = sw * 9;
@@ -1565,6 +1656,75 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   rotatePointAroundCenter: rotatePointAround,
   rotateVertices
 }, Symbol.toStringTag, { value: "Module" }));
+const COMMENT_SIZE = 24;
+const textHandlerFactory = {
+  annotationType: PdfAnnotationSubtype.TEXT,
+  create(context) {
+    const { onCommit, getTool, pageSize } = context;
+    return {
+      onPointerDown: (pos) => {
+        const tool = getTool();
+        if (!tool) return;
+        const rect = {
+          origin: { x: pos.x - COMMENT_SIZE / 2, y: pos.y - COMMENT_SIZE / 2 },
+          size: { width: COMMENT_SIZE, height: COMMENT_SIZE }
+        };
+        let anno = {
+          ...tool.defaults,
+          rect,
+          type: PdfAnnotationSubtype.TEXT,
+          icon: tool.defaults.icon ?? PdfAnnotationIcon.Comment,
+          contents: tool.defaults.contents ?? "",
+          flags: tool.defaults.flags ?? ["print", "noRotate", "noZoom"],
+          pageIndex: context.pageIndex,
+          id: uuidV4(),
+          created: /* @__PURE__ */ new Date()
+        };
+        anno = clampAnnotationToPage(anno, pageSize);
+        onCommit(anno);
+      }
+    };
+  }
+};
+function useClickDetector({
+  threshold = 5,
+  getTool,
+  onClickDetected
+}) {
+  const [getStartPos, setStartPos] = useState(null);
+  const [getHasMoved, setHasMoved] = useState(false);
+  return {
+    onStart: (pos) => {
+      setStartPos(pos);
+      setHasMoved(false);
+    },
+    onMove: (pos) => {
+      const start = getStartPos();
+      if (!start || getHasMoved()) return;
+      const distance = Math.sqrt(Math.pow(pos.x - start.x, 2) + Math.pow(pos.y - start.y, 2));
+      if (distance > threshold) {
+        setHasMoved(true);
+      }
+    },
+    onEnd: (pos) => {
+      var _a;
+      const start = getStartPos();
+      if (start && !getHasMoved()) {
+        const tool = getTool();
+        if (tool && "clickBehavior" in tool && ((_a = tool.clickBehavior) == null ? void 0 : _a.enabled)) {
+          onClickDetected(pos, tool);
+        }
+      }
+      setStartPos(null);
+      setHasMoved(false);
+    },
+    hasMoved: getHasMoved,
+    reset: () => {
+      setStartPos(null);
+      setHasMoved(false);
+    }
+  };
+}
 const freeTextHandlerFactory = {
   annotationType: PdfAnnotationSubtype.FREETEXT,
   create(context) {
@@ -2417,6 +2577,135 @@ const circleHandlerFactory = {
     };
   }
 };
+const textMarkupSelectionHandler = {
+  toolId: "__textMarkup__",
+  handle(context, selections, getText) {
+    const tool = context.getTool();
+    if (!tool) return;
+    for (const selection of selections) {
+      const id = uuidV4();
+      getText().then((text) => {
+        var _a;
+        context.createAnnotation(selection.pageIndex, {
+          ...tool.defaults,
+          rect: selection.rect,
+          segmentRects: selection.segmentRects,
+          pageIndex: selection.pageIndex,
+          created: /* @__PURE__ */ new Date(),
+          id,
+          ...text != null && { custom: { text } }
+        });
+        if ((_a = tool.behavior) == null ? void 0 : _a.selectAfterCreate) {
+          context.selectAnnotation(selection.pageIndex, id);
+        }
+      });
+    }
+  }
+};
+function computeCaretRect(lastSegRect) {
+  const lineHeight = lastSegRect.size.height;
+  const height = lineHeight / 2;
+  const width = height;
+  const lineEndX = lastSegRect.origin.x + lastSegRect.size.width;
+  return {
+    origin: {
+      x: lineEndX - width / 2,
+      y: lastSegRect.origin.y + lineHeight / 2
+    },
+    size: { width, height }
+  };
+}
+const insertTextSelectionHandler = {
+  toolId: "insertText",
+  handle(context, selections, getText) {
+    const tool = context.getTool();
+    if (!tool) return;
+    const getDefaults = () => ({
+      strokeColor: tool.defaults.strokeColor ?? "#E44234",
+      opacity: tool.defaults.opacity ?? 1,
+      flags: tool.defaults.flags ?? ["print"]
+    });
+    for (const selection of selections) {
+      const lastSegRect = selection.segmentRects[selection.segmentRects.length - 1];
+      if (!lastSegRect) continue;
+      const caretRect = computeCaretRect(lastSegRect);
+      const caretId = uuidV4();
+      const defaults = getDefaults();
+      getText().then((text) => {
+        var _a;
+        context.createAnnotation(selection.pageIndex, {
+          type: PdfAnnotationSubtype.CARET,
+          id: caretId,
+          pageIndex: selection.pageIndex,
+          rect: caretRect,
+          strokeColor: defaults.strokeColor,
+          opacity: defaults.opacity,
+          intent: "Insert",
+          rectangleDifferences: { left: 0.5, top: 0.5, right: 0.5, bottom: 0.5 },
+          created: /* @__PURE__ */ new Date(),
+          flags: defaults.flags,
+          ...text != null && { custom: { text } }
+        });
+        if ((_a = tool.behavior) == null ? void 0 : _a.selectAfterCreate) {
+          context.selectAnnotation(selection.pageIndex, caretId);
+        }
+      });
+    }
+  }
+};
+const replaceTextSelectionHandler = {
+  toolId: "replaceText",
+  handle(context, selections, getText) {
+    const tool = context.getTool();
+    if (!tool) return;
+    const getDefaults = () => ({
+      strokeColor: tool.defaults.strokeColor ?? "#E44234",
+      opacity: tool.defaults.opacity ?? 1,
+      flags: tool.defaults.flags ?? ["print"]
+    });
+    for (const selection of selections) {
+      const lastSegRect = selection.segmentRects[selection.segmentRects.length - 1];
+      if (!lastSegRect) continue;
+      const caretRect = computeCaretRect(lastSegRect);
+      const caretId = uuidV4();
+      const strikeoutId = uuidV4();
+      const defaults = getDefaults();
+      getText().then((text) => {
+        var _a;
+        context.createAnnotation(selection.pageIndex, {
+          type: PdfAnnotationSubtype.CARET,
+          id: caretId,
+          pageIndex: selection.pageIndex,
+          rect: caretRect,
+          strokeColor: defaults.strokeColor,
+          opacity: defaults.opacity,
+          intent: "Replace",
+          rectangleDifferences: { left: 0.5, top: 0.5, right: 0.5, bottom: 0.5 },
+          created: /* @__PURE__ */ new Date(),
+          flags: defaults.flags
+        });
+        context.createAnnotation(selection.pageIndex, {
+          type: PdfAnnotationSubtype.STRIKEOUT,
+          id: strikeoutId,
+          pageIndex: selection.pageIndex,
+          rect: selection.rect,
+          segmentRects: selection.segmentRects,
+          strokeColor: defaults.strokeColor,
+          opacity: defaults.opacity,
+          intent: "StrikeOutTextEdit",
+          inReplyToId: caretId,
+          replyType: PdfAnnotationReplyType.Group,
+          created: /* @__PURE__ */ new Date(),
+          flags: defaults.flags,
+          ...text != null && { custom: { text } }
+        });
+        if ((_a = tool.behavior) == null ? void 0 : _a.selectAfterCreate) {
+          context.selectAnnotation(selection.pageIndex, caretId);
+        }
+      });
+    }
+  }
+};
 const patchInk = (original, ctx) => {
   switch (ctx.type) {
     case "vertex-edit":
@@ -2845,10 +3134,12 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
     this.importQueue = /* @__PURE__ */ new Map();
     this.commitInProgress = /* @__PURE__ */ new Map();
     this.handlerFactories = /* @__PURE__ */ new Map();
+    this.selectionHandlerFactories = /* @__PURE__ */ new Map();
     this.activeTool$ = createBehaviorEmitter();
     this.events$ = createBehaviorEmitter();
     this.toolsChange$ = createBehaviorEmitter();
     this.patchRegistry = new PatchRegistry();
+    this.appearanceCache = /* @__PURE__ */ new Map();
     this.unifiedDragStates = /* @__PURE__ */ new Map();
     this.unifiedDrag$ = createBehaviorEmitter();
     this.unifiedResizeStates = /* @__PURE__ */ new Map();
@@ -2860,6 +3151,7 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
     this.history = ((_b = registry.getPlugin("history")) == null ? void 0 : _b.provides()) ?? null;
     this.interactionManager = ((_c = registry.getPlugin("interaction-manager")) == null ? void 0 : _c.provides()) ?? null;
     this.registerHandlerFactories();
+    this.registerSelectionHandlerFactories();
     this.registerBuiltInPatches();
   }
   // ─────────────────────────────────────────────────────────
@@ -2885,7 +3177,7 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
       for (const tool of this.state.tools) {
         if (tool.interaction.textSelection) {
           this.selection.enableForMode(tool.interaction.mode ?? tool.id, {
-            showSelectionRects: false,
+            showSelectionRects: tool.interaction.showSelectionRects ?? false,
             enableSelection: true,
             enableMarquee: false
           });
@@ -2898,6 +3190,7 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
     this.pendingContexts.delete(documentId);
     this.isInitialLoadComplete.delete(documentId);
     this.importQueue.delete(documentId);
+    this.appearanceCache.delete(documentId);
     this.logger.debug(
       "AnnotationPlugin",
       "DocumentClosed",
@@ -2913,6 +3206,11 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
     this.handlerFactories.set(PdfAnnotationSubtype.LINE, lineHandlerFactory);
     this.handlerFactories.set(PdfAnnotationSubtype.INK, inkHandlerFactory);
     this.handlerFactories.set(PdfAnnotationSubtype.FREETEXT, freeTextHandlerFactory);
+    this.handlerFactories.set(PdfAnnotationSubtype.TEXT, textHandlerFactory);
+  }
+  registerSelectionHandlerFactories() {
+    this.selectionHandlerFactories.set("insertText", insertTextSelectionHandler);
+    this.selectionHandlerFactories.set("replaceText", replaceTextSelectionHandler);
   }
   registerBuiltInPatches() {
     this.patchRegistry.register(PdfAnnotationSubtype.INK, patchInk);
@@ -2946,7 +3244,7 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
       if (modeId !== "pointerMode") return;
       const docState = this.state.documents[documentId];
       if (!docState) return;
-      const pageAnnotations = (docState.pages[pageIndex] ?? []).map((uid) => docState.byUid[uid]).filter((ta) => ta !== void 0).filter((ta) => !isLink(ta));
+      const pageAnnotations = (docState.pages[pageIndex] ?? []).map((uid) => docState.byUid[uid]).filter((ta) => ta !== void 0).filter((ta) => isSidebarAnnotation(ta));
       const selectedIds = pageAnnotations.filter((ta) => rectsIntersect(rect, ta.object.rect)).map((ta) => ta.object.id);
       if (selectedIds.length > 0) {
         const expandedIds = /* @__PURE__ */ new Set();
@@ -2964,44 +3262,32 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
       }
     });
     (_c = this.selection) == null ? void 0 : _c.onEndSelection(({ documentId }) => {
-      var _a2, _b2, _c2;
-      if (!this.checkPermission(documentId, PdfPermissionFlag.ModifyAnnotations)) {
-        return;
-      }
+      var _a2, _b2, _c2, _d;
+      if (!this.checkPermission(documentId, PdfPermissionFlag.ModifyAnnotations)) return;
       const activeTool = this.getActiveTool(documentId);
       if (!activeTool || !activeTool.interaction.textSelection) return;
       const formattedSelection = (_a2 = this.selection) == null ? void 0 : _a2.getFormattedSelection();
       const selectionText = (_b2 = this.selection) == null ? void 0 : _b2.getSelectedText();
       if (!formattedSelection || !selectionText) return;
-      for (const selection of formattedSelection) {
-        selectionText.wait((text) => {
-          var _a3, _b3;
-          const annotationId = uuidV4();
-          this.createAnnotation(
-            selection.pageIndex,
-            {
-              ...activeTool.defaults,
-              rect: selection.rect,
-              segmentRects: selection.segmentRects,
-              pageIndex: selection.pageIndex,
-              created: /* @__PURE__ */ new Date(),
-              id: annotationId,
-              custom: {
-                text: text.join("\n")
-              }
-            },
-            void 0,
-            documentId
-          );
-          if ((_a3 = activeTool.behavior) == null ? void 0 : _a3.deactivateToolAfterCreate) {
-            this.setActiveTool(null, documentId);
-          }
-          if ((_b3 = activeTool.behavior) == null ? void 0 : _b3.selectAfterCreate) {
-            this.selectAnnotation(selection.pageIndex, annotationId, documentId);
-          }
-        }, ignore);
+      const getText = () => new Promise((resolve) => {
+        selectionText.wait(
+          (text) => resolve(text.join("\n")),
+          () => resolve(void 0)
+        );
+      });
+      const context = {
+        toolId: activeTool.id,
+        documentId,
+        getTool: () => this.getActiveTool(documentId) ?? null,
+        createAnnotation: (pageIndex, annotation) => this.createAnnotation(pageIndex, annotation, void 0, documentId),
+        selectAnnotation: (pageIndex, id) => this.selectAnnotation(pageIndex, id, documentId)
+      };
+      const handler = this.selectionHandlerFactories.get(activeTool.id) ?? textMarkupSelectionHandler;
+      handler.handle(context, formattedSelection, getText);
+      if ((_c2 = activeTool.behavior) == null ? void 0 : _c2.deactivateToolAfterCreate) {
+        this.setActiveTool(null, documentId);
       }
-      (_c2 = this.selection) == null ? void 0 : _c2.clear();
+      (_d = this.selection) == null ? void 0 : _d.clear();
     });
   }
   registerInteractionForTool(tool) {
@@ -3034,10 +3320,13 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
       createAnnotation: (pageIndex, anno, ctx) => this.createAnnotation(pageIndex, anno, ctx),
       updateAnnotation: (pageIndex, id, patch) => this.updateAnnotation(pageIndex, id, patch),
       updateAnnotations: (patches) => this.updateAnnotationsMethod(patches),
+      moveAnnotation: (pageIndex, id, position, mode, documentId) => this.moveAnnotationMethod(pageIndex, id, position, mode, documentId),
       deleteAnnotation: (pageIndex, id) => this.deleteAnnotation(pageIndex, id),
       deleteAnnotations: (annotations, documentId) => this.deleteAnnotationsMethod(annotations, documentId),
       purgeAnnotation: (pageIndex, id, documentId) => this.purgeAnnotationMethod(pageIndex, id, documentId),
       renderAnnotation: (options) => this.renderAnnotation(options),
+      getPageAppearances: (pageIndex, options, documentId) => this.getPageAppearances(pageIndex, options, documentId),
+      invalidatePageAppearances: (pageIndex, documentId) => this.invalidatePageAppearances(pageIndex, documentId),
       commit: () => this.commit(),
       // Attached links (IRT link children)
       getAttachedLinks: (id, documentId) => this.getAttachedLinksMethod(id, documentId),
@@ -3094,10 +3383,13 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
       createAnnotation: (pageIndex, anno, ctx) => this.createAnnotation(pageIndex, anno, ctx, documentId),
       updateAnnotation: (pageIndex, id, patch) => this.updateAnnotation(pageIndex, id, patch, documentId),
       updateAnnotations: (patches) => this.updateAnnotationsMethod(patches, documentId),
+      moveAnnotation: (pageIndex, id, position, mode) => this.moveAnnotationMethod(pageIndex, id, position, mode, documentId),
       deleteAnnotation: (pageIndex, id) => this.deleteAnnotation(pageIndex, id, documentId),
       deleteAnnotations: (annotations) => this.deleteAnnotationsMethod(annotations, documentId),
       purgeAnnotation: (pageIndex, id) => this.purgeAnnotationMethod(pageIndex, id, documentId),
       renderAnnotation: (options) => this.renderAnnotation(options, documentId),
+      getPageAppearances: (pageIndex, options) => this.getPageAppearances(pageIndex, options, documentId),
+      invalidatePageAppearances: (pageIndex) => this.invalidatePageAppearances(pageIndex, documentId),
       commit: () => this.commit(documentId),
       getAttachedLinks: (id) => this.getAttachedLinksMethod(id, documentId),
       hasAttachedLinks: (id) => this.hasAttachedLinksMethod(id, documentId),
@@ -3269,6 +3561,67 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
     }
     return this.engine.renderPageAnnotation(doc, page, annotation, options);
   }
+  /**
+   * Batch-fetch rendered appearance stream images for all annotations on a page.
+   * Results are cached per document + page. Call invalidatePageAppearances to clear.
+   */
+  getPageAppearances(pageIndex, options, documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    const docState = this.getCoreDocument(id);
+    const doc = docState == null ? void 0 : docState.document;
+    if (!doc) {
+      return PdfTaskHelper.reject({ code: PdfErrorCode.NotFound, message: "Document not found" });
+    }
+    const page = doc.pages.find((p) => p.index === pageIndex);
+    if (!page) {
+      return PdfTaskHelper.reject({ code: PdfErrorCode.NotFound, message: "Page not found" });
+    }
+    let docCache = this.appearanceCache.get(id);
+    if (!docCache) {
+      docCache = /* @__PURE__ */ new Map();
+      this.appearanceCache.set(id, docCache);
+    }
+    const cached = docCache.get(pageIndex);
+    if (cached && !options) {
+      const task = new Task();
+      task.resolve(cached);
+      return task;
+    }
+    const engineTask = this.engine.renderPageAnnotations(doc, page, options);
+    const resultTask = new Task();
+    engineTask.wait(
+      (result) => {
+        docCache.set(pageIndex, result);
+        resultTask.resolve(result);
+      },
+      (error) => {
+        resultTask.fail(error);
+      }
+    );
+    return resultTask;
+  }
+  /**
+   * Clear cached appearances for a specific page (e.g. on zoom change).
+   */
+  invalidatePageAppearances(pageIndex, documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    const docCache = this.appearanceCache.get(id);
+    if (docCache) {
+      docCache.delete(pageIndex);
+    }
+  }
+  /**
+   * Remove a single annotation's entry from the page appearance cache.
+   * Used after committing changes that regenerate the annotation's appearance.
+   */
+  invalidateAnnotationAppearance(annotId, pageIndex, documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    const docCache = this.appearanceCache.get(id);
+    if (!docCache) return;
+    const pageMap = docCache.get(pageIndex);
+    if (!pageMap) return;
+    delete pageMap[annotId];
+  }
   importAnnotations(items, documentId) {
     const id = documentId ?? this.getActiveDocumentId();
     if (!this.isInitialLoadComplete.get(id)) {
@@ -3840,7 +4193,7 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
         patches.push({ pageIndex: ta.object.pageIndex, id, patch });
       }
       if (patches.length > 0) {
-        this.updateAnnotationsMethod(patches, documentId);
+        this.moveAnnotationsMethod(patches, documentId);
       }
     }
     const endPatches = this.computeDragPreviewPatches(state, documentId);
@@ -4424,6 +4777,87 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
     const historyScope = this.history.forDocument(docId);
     historyScope.register(command, this.ANNOTATION_HISTORY_TOPIC);
   }
+  moveAnnotationsMethod(patches, documentId) {
+    const docId = documentId ?? this.getActiveDocumentId();
+    if (!this.checkPermission(docId, PdfPermissionFlag.ModifyAnnotations)) {
+      this.logger.debug(
+        "AnnotationPlugin",
+        "MoveAnnotations",
+        `Cannot move annotations: document ${docId} lacks ModifyAnnotations permission`
+      );
+      return;
+    }
+    const docState = this.getDocumentState(docId);
+    const moveData = patches.map(({ pageIndex, id, patch }) => {
+      var _a;
+      const originalObject = (_a = docState.byUid[id]) == null ? void 0 : _a.object;
+      if (!originalObject) return null;
+      return { pageIndex, id, patch, originalObject };
+    }).filter((p) => p !== null);
+    if (moveData.length === 0) return;
+    const execute = () => {
+      for (const { pageIndex, id, patch, originalObject } of moveData) {
+        this.dispatch(moveAnnotation(docId, pageIndex, id, patch));
+        this.events$.emit({
+          type: "update",
+          documentId: docId,
+          annotation: originalObject,
+          pageIndex,
+          patch,
+          committed: false
+        });
+      }
+    };
+    if (!this.history) {
+      execute();
+      if (this.config.autoCommit !== false) {
+        this.commit(docId);
+      }
+      return;
+    }
+    const undoData = moveData.map(({ pageIndex, id, patch, originalObject }) => ({
+      pageIndex,
+      id,
+      originalPatch: Object.fromEntries(
+        Object.keys(patch).map((key) => [key, originalObject[key]])
+      ),
+      originalObject
+    }));
+    const command = {
+      execute,
+      undo: () => {
+        for (const { pageIndex, id, originalPatch, originalObject } of undoData) {
+          this.dispatch(moveAnnotation(docId, pageIndex, id, originalPatch));
+          this.events$.emit({
+            type: "update",
+            documentId: docId,
+            annotation: originalObject,
+            pageIndex,
+            patch: originalPatch,
+            committed: false
+          });
+        }
+      },
+      metadata: { annotationIds: moveData.map((p) => p.id) }
+    };
+    const historyScope = this.history.forDocument(docId);
+    historyScope.register(command, this.ANNOTATION_HISTORY_TOPIC);
+  }
+  moveAnnotationMethod(pageIndex, annotationId, position, mode = "delta", documentId) {
+    const docId = documentId ?? this.getActiveDocumentId();
+    const ta = this.getAnnotationById(annotationId, docId);
+    if (!ta) return;
+    const currentRect = ta.object.rect;
+    const newRect = {
+      ...currentRect,
+      origin: mode === "absolute" ? { x: position.x, y: position.y } : { x: currentRect.origin.x + position.x, y: currentRect.origin.y + position.y }
+    };
+    const patch = this.transformAnnotation(ta.object, {
+      type: "move",
+      changes: { rect: newRect }
+    });
+    this.moveAnnotationsMethod([{ pageIndex, id: annotationId, patch }], docId);
+  }
   getActiveTool(documentId) {
     const docState = this.getDocumentState(documentId);
     if (!docState.activeToolId) return null;
@@ -4493,6 +4927,9 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
             ctx: contexts == null ? void 0 : contexts.get(ta.object.id)
           });
           break;
+        case "moved":
+          batch.updates.push({ uid, ta, moved: true });
+          break;
         case "dirty":
           batch.updates.push({ uid, ta });
           break;
@@ -4517,11 +4954,11 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
       const createTask = this.engine.createPageAnnotation(doc, page, ta.object, ctx);
       pendingOps.push({ type: "create", task: createTask, ta, uid, ctx });
     }
-    for (const { uid, ta } of batch.updates) {
+    for (const { uid, ta, moved } of batch.updates) {
       const page = doc.pages.find((p) => p.index === ta.object.pageIndex);
       if (!page) continue;
-      const updateTask = this.engine.updatePageAnnotation(doc, page, ta.object);
-      pendingOps.push({ type: "update", task: updateTask, ta, uid });
+      const updateTask = moved ? this.engine.updatePageAnnotation(doc, page, ta.object, { regenerateAppearance: false }) : this.engine.updatePageAnnotation(doc, page, ta.object);
+      pendingOps.push({ type: "update", task: updateTask, ta, uid, moved });
     }
     for (const { uid, ta } of batch.deletions) {
       const page = doc.pages.find((p) => p.index === ta.object.pageIndex);
@@ -4539,6 +4976,12 @@ const _AnnotationPlugin = class _AnnotationPlugin extends BasePlugin {
     Task.allSettled(allTasks).wait(
       () => {
         this.emitCommitEvents(docId, pendingOps, contexts);
+        for (const op of pendingOps) {
+          if (op.type === "update" && op.moved) continue;
+          if (op.type === "create" || op.type === "update" || op.type === "delete") {
+            this.invalidateAnnotationAppearance(op.ta.object.id, op.ta.object.pageIndex, docId);
+          }
+        }
         this.dispatch(commitPendingChanges(docId, batch.committedUids));
         task.resolve(true);
       },
@@ -4672,6 +5115,8 @@ const isPolylineTool = createToolPredicate("polyline");
 const isPolygonTool = createToolPredicate("polygon");
 const isFreeTextTool = createToolPredicate("freeText");
 const isStampTool = createToolPredicate("stamp");
+const isInsertTextTool = createToolPredicate("insertText");
+const isReplaceTextTool = createToolPredicate("replaceText");
 const AnnotationPluginPackage = {
   manifest,
   create: (registry, config) => new AnnotationPlugin(ANNOTATION_PLUGIN_ID, registry, config),
@@ -4711,6 +5156,7 @@ export {
   initialDocumentState,
   initialState,
   isAnnotationSelected,
+  isCaret,
   isCircle,
   isCircleTool,
   isFreeText,
@@ -4721,6 +5167,7 @@ export {
   isInk,
   isInkHighlighterTool,
   isInkTool,
+  isInsertTextTool,
   isLine,
   isLineTool,
   isLink,
@@ -4729,6 +5176,7 @@ export {
   isPolyline,
   isPolylineTool,
   isRedact,
+  isReplaceTextTool,
   isSidebarAnnotation,
   isSquare,
   isSquareTool,