@embedpdf/engines 1.0.16 → 1.0.17

package/dist/{engine-B11yoQGd.js → engine-uSZXjmb5.js}

@@ -1,4 +1,4 @@
-import { NoopLogger, PdfTaskHelper, PdfErrorCode, Rotation, Task, PdfAnnotationSubtype, stripPdfUnwantedMarkers, PdfAnnotationBorderStyle, dateToPdfDate, PdfAnnotationColorType, PdfAnnotationLineEnding, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, quadToRect, pdfDateToDate, PdfStandardFont, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, toIntRect, transformRect, makeMatrix, toIntSize, transformSize, PdfActionType, PdfZoomMode, MatchFlag, rectToQuad } from "@embedpdf/models";
+import { NoopLogger, PdfTaskHelper, PdfErrorCode, Rotation, Task, ignore, PdfAnnotationSubtype, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationBorderStyle, PdfAnnotationColorType, PdfAnnotationLineEnding, isUuidV4, uuidV4, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, pdfDateToDate, dateToPdfDate, quadToRect, PdfStandardFont, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, toIntRect, transformRect, makeMatrix, toIntSize, transformSize, PdfActionType, PdfZoomMode, MatchFlag, rectToQuad } from "@embedpdf/models";
 function readString(wasmModule, readChars, parseChars, defaultLength = 100) {
   let buffer = wasmModule.wasmExports.malloc(defaultLength);
   for (let i = 0; i < defaultLength; i++) {
@@ -68,6 +68,10 @@ class DocumentContext {
   acquirePage(pageIdx) {
     return this.pageCache.acquire(pageIdx);
   }
+  /** Scoped accessor for one-off / bulk operations */
+  borrowPage(pageIdx, fn) {
+    return this.pageCache.borrowPage(pageIdx, fn);
+  }
   /** Tear down all pages + this document */
   dispose() {
     this.pageCache.forceReleaseAll();
@@ -94,6 +98,19 @@ class PageCache {
     ctx.bumpRefCount();
     return ctx;
   }
+  /** Helper: run a function “scoped” to a page.
+   *    – if the page was already cached  → .release() (keeps TTL logic)
+   *    – if the page was loaded just now → .disposeImmediate() (free right away)
+   */
+  borrowPage(pageIdx, fn) {
+    const existed = this.cache.has(pageIdx);
+    const ctx = this.acquire(pageIdx);
+    try {
+      return fn(ctx);
+    } finally {
+      existed ? ctx.release() : ctx.disposeImmediate();
+    }
+  }
   forceReleaseAll() {
     for (const ctx of this.cache.values()) {
       ctx.disposeImmediate();
@@ -841,19 +858,41 @@ class PdfiumEngine {
    * @public
    */
   getAllAnnotations(doc) {
-    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "getAllAnnotations", doc);
-    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `GetAllAnnotations`, "Begin", doc.id);
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "getAllAnnotations-with-progress", doc);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "GetAllAnnotations", "Begin", doc.id);
+    const task = PdfTaskHelper.create();
+    let cancelled = false;
+    task.wait(ignore, (err) => {
+      if (err.type === "abort") cancelled = true;
+    });
     const ctx = this.cache.getContext(doc.id);
     if (!ctx) {
-      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `GetAllAnnotations`, "End", doc.id);
-      return PdfTaskHelper.reject({
-        code: PdfErrorCode.DocNotOpen,
-        message: "document does not open"
-      });
-    }
-    const annotations = this.readAllAnnotations(doc, ctx);
-    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `GetAllAnnotations`, "End", doc.id);
-    return PdfTaskHelper.resolve(annotations);
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "GetAllAnnotations", "End", doc.id);
+      task.reject({ code: PdfErrorCode.DocNotOpen, message: "document does not open" });
+      return task;
+    }
+    const CHUNK_SIZE = 100;
+    const out = {};
+    const processChunk = (startIdx) => {
+      if (cancelled) return;
+      const endIdx = Math.min(startIdx + CHUNK_SIZE, doc.pageCount);
+      for (let pageIdx = startIdx; pageIdx < endIdx && !cancelled; ++pageIdx) {
+        this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "GetAllAnnotations", "Begin", doc.id, pageIdx);
+        const annots = this.readPageAnnotationsRaw(ctx, doc.pages[pageIdx]);
+        out[pageIdx] = annots;
+        this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "GetAllAnnotations", "End", doc.id, pageIdx);
+        task.progress({ page: pageIdx, annotations: annots });
+      }
+      if (cancelled) return;
+      if (endIdx >= doc.pageCount) {
+        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "GetAllAnnotations", "End", doc.id);
+        task.resolve(out);
+        return;
+      }
+      setTimeout(() => processChunk(endIdx), 0);
+    };
+    processChunk(0);
+    return task;
   }
   readAllAnnotations(doc, ctx) {
     const annotationsByPage = {};
@@ -937,7 +976,7 @@ class PdfiumEngine {
       });
     }
     const pageCtx = ctx.acquirePage(page.index);
-    const annotationPtr = this.pdfiumModule.FPDFPage_CreateAnnot(pageCtx.pagePtr, annotation.type);
+    const annotationPtr = this.pdfiumModule.EPDFPage_CreateAnnot(pageCtx.pagePtr, annotation.type);
     if (!annotationPtr) {
       this.logger.perf(
         LOG_SOURCE,
@@ -952,6 +991,14 @@ class PdfiumEngine {
         message: "can not create annotation with specified type"
       });
     }
+    if (!this.setAnnotString(annotationPtr, "NM", annotation.id)) {
+      this.pdfiumModule.FPDFPage_CloseAnnot(annotationPtr);
+      pageCtx.release();
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.CantSetAnnotString,
+        message: "can not set the name of the annotation"
+      });
+    }
     if (!this.setPageAnnoRect(page, pageCtx.pagePtr, annotationPtr, annotation.rect)) {
       this.pdfiumModule.FPDFPage_CloseAnnot(annotationPtr);
       pageCtx.release();
@@ -982,6 +1029,9 @@ class PdfiumEngine {
           context == null ? void 0 : context.imageData
         );
         break;
+      case PdfAnnotationSubtype.TEXT:
+        isSucceed = this.addTextContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        break;
       case PdfAnnotationSubtype.FREETEXT:
         isSucceed = this.addFreeTextContent(page, pageCtx.pagePtr, annotationPtr, annotation);
         break;
@@ -1072,7 +1122,7 @@ class PdfiumEngine {
       });
     }
     const pageCtx = ctx.acquirePage(page.index);
-    const annotPtr = this.pdfiumModule.FPDFPage_GetAnnot(pageCtx.pagePtr, annotation.id);
+    const annotPtr = this.getAnnotationByName(pageCtx.pagePtr, annotation.id);
     if (!annotPtr) {
       pageCtx.release();
       this.logger.perf(
@@ -1112,6 +1162,10 @@ class PdfiumEngine {
         ok = this.addStampContent(ctx.docPtr, page, pageCtx.pagePtr, annotPtr, annotation);
         break;
       }
+      case PdfAnnotationSubtype.TEXT: {
+        ok = this.addTextContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        break;
+      }
       /* ── Free text ────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.FREETEXT: {
         ok = this.addFreeTextContent(page, pageCtx.pagePtr, annotPtr, annotation);
@@ -1198,7 +1252,7 @@ class PdfiumEngine {
     }
     const pageCtx = ctx.acquirePage(page.index);
     let result = false;
-    result = this.pdfiumModule.FPDFPage_RemoveAnnot(pageCtx.pagePtr, annotation.id);
+    result = this.removeAnnotationByName(pageCtx.pagePtr, annotation.id);
     if (!result) {
       this.logger.error(
         LOG_SOURCE,
@@ -1429,7 +1483,18 @@ class PdfiumEngine {
     );
     const pageCtx = ctx.acquirePage(page.index);
     this.pdfiumModule.FORM_OnAfterLoadPage(pageCtx.pagePtr, formHandle);
-    const annotationPtr = this.pdfiumModule.FPDFPage_GetAnnot(pageCtx.pagePtr, annotation.id);
+    const annotationPtr = this.getAnnotationByName(pageCtx.pagePtr, annotation.id);
+    if (!annotationPtr) {
+      pageCtx.release();
+      this.logger.perf(
+        LOG_SOURCE,
+        LOG_CATEGORY,
+        "SetFormFieldValue",
+        "End",
+        `${doc.id}-${page.index}`
+      );
+      return PdfTaskHelper.reject({ code: PdfErrorCode.NotFound, message: "annotation not found" });
+    }
     if (!this.pdfiumModule.FORM_SetFocusedAnnot(formHandle, annotationPtr)) {
       this.logger.debug(
         LOG_SOURCE,
@@ -1918,7 +1983,66 @@ class PdfiumEngine {
   free(ptr) {
     this.pdfiumModule.pdfium.wasmExports.free(ptr);
   }
+  /**
+   * Add text content to annotation
+   * @param page - page info
+   * @param pagePtr - pointer to page object
+   * @param annotationPtr - pointer to text annotation
+   * @param annotation - text annotation
+   * @returns whether text content is added to annotation
+   *
+   * @private
+   */
+  addTextContent(page, pagePtr, annotationPtr, annotation) {
+    if (!this.setPageAnnoRect(page, pagePtr, annotationPtr, annotation.rect)) {
+      return false;
+    }
+    if (!this.setAnnotString(annotationPtr, "Contents", annotation.contents ?? "")) {
+      return false;
+    }
+    if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.inReplyToId && !this.setInReplyToId(pagePtr, annotationPtr, annotation.inReplyToId)) {
+      return false;
+    }
+    if (!this.setAnnotationIcon(annotationPtr, annotation.icon || PdfAnnotationIcon.Comment)) {
+      return false;
+    }
+    if (!this.setAnnotationFlags(annotationPtr, annotation.flags || ["print", "noZoom", "noRotate"])) {
+      return false;
+    }
+    if (annotation.state && !this.setAnnotString(annotationPtr, "State", annotation.state)) {
+      return false;
+    }
+    if (annotation.stateModel && !this.setAnnotString(annotationPtr, "StateModel", annotation.stateModel)) {
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Add free text content to annotation
+   * @param page - page info
+   * @param pagePtr - pointer to page object
+   * @param annotationPtr - pointer to free text annotation
+   * @param annotation - free text annotation
+   * @returns whether free text content is added to annotation
+   *
+   * @private
+   */
   addFreeTextContent(page, pagePtr, annotationPtr, annotation) {
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
     if (!this.setBorderStyle(annotationPtr, PdfAnnotationBorderStyle.SOLID, 0)) {
       return false;
     }
@@ -1931,9 +2055,6 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
       return false;
     }
-    if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
-      return false;
-    }
     if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
       return false;
     }
@@ -1978,6 +2099,15 @@ class PdfiumEngine {
    * @private
    */
   addInkStroke(page, pagePtr, annotationPtr, annotation) {
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
+    if (!this.setAnnotString(annotationPtr, "Contents", annotation.contents ?? "")) {
+      return false;
+    }
     if (!this.setBorderStyle(annotationPtr, PdfAnnotationBorderStyle.SOLID, annotation.strokeWidth)) {
       return false;
     }
@@ -1990,9 +2120,6 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
       return false;
     }
-    if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
-      return false;
-    }
     if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
       return false;
     }
@@ -2017,6 +2144,12 @@ class PdfiumEngine {
    */
   addLineContent(page, pagePtr, annotationPtr, annotation) {
     var _a, _b;
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
     if (!this.setPageAnnoRect(page, pagePtr, annotationPtr, annotation.rect)) {
       return false;
     }
@@ -2041,9 +2174,6 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
       return false;
     }
-    if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
-      return false;
-    }
     if (!this.setBorderStyle(annotationPtr, annotation.strokeStyle, annotation.strokeWidth)) {
       return false;
     }
@@ -2088,6 +2218,12 @@ class PdfiumEngine {
    */
   addPolyContent(page, pagePtr, annotationPtr, annotation) {
     var _a, _b;
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
     if (!this.setPageAnnoRect(page, pagePtr, annotationPtr, annotation.rect)) {
       return false;
     }
@@ -2107,9 +2243,6 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
       return false;
     }
-    if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
-      return false;
-    }
     if (!this.setBorderStyle(annotationPtr, annotation.strokeStyle, annotation.strokeWidth)) {
       return false;
     }
@@ -2153,6 +2286,12 @@ class PdfiumEngine {
    * @private
    */
   addShapeContent(page, pagePtr, annotationPtr, annotation) {
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
     if (!this.setPageAnnoRect(page, pagePtr, annotationPtr, annotation.rect)) {
       return false;
     }
@@ -2162,9 +2301,6 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
       return false;
     }
-    if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
-      return false;
-    }
     if (!this.setBorderStyle(annotationPtr, annotation.strokeStyle, annotation.strokeWidth)) {
       return false;
     }
@@ -2207,6 +2343,12 @@ class PdfiumEngine {
    * @private
    */
   addTextMarkupContent(page, pagePtr, annotationPtr, annotation) {
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
     if (!this.setPageAnnoRect(page, pagePtr, annotationPtr, annotation.rect)) {
       return false;
     }
@@ -2219,9 +2361,6 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
       return false;
     }
-    if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
-      return false;
-    }
     if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
       return false;
     }
@@ -2247,6 +2386,15 @@ class PdfiumEngine {
    * @private
    */
   addStampContent(docPtr, page, pagePtr, annotationPtr, annotation, imageData) {
+    if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
+      return false;
+    }
+    if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
+      return false;
+    }
+    if (!this.setAnnotString(annotationPtr, "Contents", annotation.contents ?? "")) {
+      return false;
+    }
     if (imageData) {
       for (let i = this.pdfiumModule.FPDFAnnot_GetObjectCount(annotationPtr) - 1; i >= 0; i--) {
         this.pdfiumModule.FPDFAnnot_RemoveObject(annotationPtr, i);
@@ -2836,18 +2984,33 @@ class PdfiumEngine {
    * @private
    */
   readPageAnnotations(ctx, page) {
-    const pageCtx = ctx.acquirePage(page.index);
-    const annotationCount = this.pdfiumModule.FPDFPage_GetAnnotCount(pageCtx.pagePtr);
-    const annotations = [];
-    for (let i = 0; i < annotationCount; i++) {
-      pageCtx.withAnnotation(i, (annotPtr) => {
-        const annotation = this.readPageAnnotation(page, pageCtx, annotPtr, i);
-        if (annotation) {
-          annotations.push(annotation);
-        }
-      });
+    return ctx.borrowPage(page.index, (pageCtx) => {
+      const annotationCount = this.pdfiumModule.FPDFPage_GetAnnotCount(pageCtx.pagePtr);
+      const annotations = [];
+      for (let i = 0; i < annotationCount; i++) {
+        pageCtx.withAnnotation(i, (annotPtr) => {
+          const anno = this.readPageAnnotation(ctx.docPtr, page, annotPtr, pageCtx);
+          if (anno) annotations.push(anno);
+        });
+      }
+      return annotations;
+    });
+  }
+  readPageAnnotationsRaw(ctx, page) {
+    const count = this.pdfiumModule.EPDFPage_GetAnnotCountRaw(ctx.docPtr, page.index);
+    if (count <= 0) return [];
+    const out = [];
+    for (let i = 0; i < count; ++i) {
+      const annotPtr = this.pdfiumModule.EPDFPage_GetAnnotRaw(ctx.docPtr, page.index, i);
+      if (!annotPtr) continue;
+      try {
+        const anno = this.readPageAnnotation(ctx.docPtr, page, annotPtr);
+        if (anno) out.push(anno);
+      } finally {
+        this.pdfiumModule.FPDFPage_CloseAnnot(annotPtr);
+      }
     }
-    return annotations;
+    return out;
   }
   /**
    * Read pdf annotation from pdf document
@@ -2863,7 +3026,12 @@ class PdfiumEngine {
    *
    * @private
    */
-  readPageAnnotation(page, pageCtx, annotationPtr, index) {
+  readPageAnnotation(docPtr, page, annotationPtr, pageCtx) {
+    let index = this.getAnnotString(annotationPtr, "NM");
+    if (!index || !isUuidV4(index)) {
+      index = uuidV4();
+      this.setAnnotString(annotationPtr, "NM", index);
+    }
     const subType = this.pdfiumModule.FPDFAnnot_GetSubtype(
       annotationPtr
     );
@@ -2871,109 +3039,89 @@ class PdfiumEngine {
     switch (subType) {
       case PdfAnnotationSubtype.TEXT:
         {
-          annotation = this.readPdfTextAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfTextAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.FREETEXT:
         {
-          annotation = this.readPdfFreeTextAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfFreeTextAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.LINK:
         {
-          annotation = this.readPdfLinkAnno(
-            page,
-            pageCtx.docPtr,
-            pageCtx.pagePtr,
-            pageCtx.getTextPage(),
-            annotationPtr,
-            index
-          );
+          annotation = this.readPdfLinkAnno(page, docPtr, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.WIDGET:
-        {
-          annotation = this.readPdfWidgetAnno(
-            page,
-            pageCtx.pagePtr,
-            annotationPtr,
-            pageCtx.getFormHandle(),
-            index
-          );
+        if (pageCtx) {
+          return this.readPdfWidgetAnno(page, annotationPtr, pageCtx.getFormHandle(), index);
         }
-        break;
       case PdfAnnotationSubtype.FILEATTACHMENT:
         {
-          annotation = this.readPdfFileAttachmentAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfFileAttachmentAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.INK:
         {
-          annotation = this.readPdfInkAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfInkAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.POLYGON:
         {
-          annotation = this.readPdfPolygonAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfPolygonAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.POLYLINE:
         {
-          annotation = this.readPdfPolylineAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfPolylineAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.LINE:
         {
-          annotation = this.readPdfLineAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfLineAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.HIGHLIGHT:
-        annotation = this.readPdfHighlightAnno(page, pageCtx.pagePtr, annotationPtr, index);
+        annotation = this.readPdfHighlightAnno(page, annotationPtr, index);
         break;
       case PdfAnnotationSubtype.STAMP:
         {
-          annotation = this.readPdfStampAnno(
-            pageCtx.docPtr,
-            page,
-            pageCtx.pagePtr,
-            annotationPtr,
-            index
-          );
+          annotation = this.readPdfStampAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.SQUARE:
         {
-          annotation = this.readPdfSquareAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfSquareAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.CIRCLE:
         {
-          annotation = this.readPdfCircleAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfCircleAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.UNDERLINE:
         {
-          annotation = this.readPdfUnderlineAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfUnderlineAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.SQUIGGLY:
         {
-          annotation = this.readPdfSquigglyAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfSquigglyAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.STRIKEOUT:
         {
-          annotation = this.readPdfStrikeOutAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfStrikeOutAnno(page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.CARET:
         {
-          annotation = this.readPdfCaretAnno(page, pageCtx.pagePtr, annotationPtr, index);
+          annotation = this.readPdfCaretAnno(page, annotationPtr, index);
         }
         break;
       default:
         {
-          annotation = this.readPdfAnno(page, pageCtx.pagePtr, subType, annotationPtr, index);
+          annotation = this.readPdfAnno(page, subType, annotationPtr, index);
         }
         break;
     }
@@ -3198,6 +3346,25 @@ class PdfiumEngine {
   setBorderStyle(annotationPtr, style, width) {
     return this.pdfiumModule.EPDFAnnot_SetBorderStyle(annotationPtr, style, width);
   }
+  /**
+   * Get the icon of the annotation
+   *
+   * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+   * @returns `PdfAnnotationIcon`
+   */
+  getAnnotationIcon(annotationPtr) {
+    return this.pdfiumModule.EPDFAnnot_GetIcon(annotationPtr);
+  }
+  /**
+   * Set the icon of the annotation
+   *
+   * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+   * @param icon - `PdfAnnotationIcon`
+   * @returns `true` on success
+   */
+  setAnnotationIcon(annotationPtr, icon) {
+    return this.pdfiumModule.EPDFAnnot_SetIcon(annotationPtr, icon);
+  }
   /**
    * Border-effect (“cloudy”) helper
    *
@@ -3249,6 +3416,29 @@ class PdfiumEngine {
     this.free(bPtr);
     return { ok, left, top, right, bottom };
   }
+  /**
+   * Get the date of the annotation
+   *
+   * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+   * @param key - 'M' for modified date, 'CreationDate' for creation date
+   * @returns `Date` or `undefined` when PDFium can't read the date
+   */
+  getAnnotationDate(annotationPtr, key) {
+    const raw = this.getAnnotString(annotationPtr, key);
+    return raw ? pdfDateToDate(raw) : void 0;
+  }
+  /**
+   * Set the date of the annotation
+   *
+   * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+   * @param key - 'M' for modified date, 'CreationDate' for creation date
+   * @param date - `Date` to set
+   * @returns `true` on success
+   */
+  setAnnotationDate(annotationPtr, key, date) {
+    const raw = dateToPdfDate(date);
+    return this.setAnnotString(annotationPtr, key, raw);
+  }
   /**
    * Dash-pattern helper ( /BS → /D array, dashed borders only )
    *
@@ -3542,28 +3732,30 @@ class PdfiumEngine {
   /**
    * Read pdf text annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf text annotation
    *
    * @private
    */
-  readPdfTextAnno(page, pagePtr, annotationPtr, index) {
+  readPdfTextAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const annoRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, annoRect);
+    const rect = this.convertPageRectToDeviceRect(page, annoRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const state = this.getAnnotString(annotationPtr, "State");
     const stateModel = this.getAnnotString(annotationPtr, "StateModel");
     const color = this.getAnnotationColor(annotationPtr);
     const opacity = this.getAnnotationOpacity(annotationPtr);
-    const inReplyToId = this.getInReplyToId(pagePtr, annotationPtr);
+    const inReplyToId = this.getInReplyToId(annotationPtr);
     const flags = this.getAnnotationFlags(annotationPtr);
+    const icon = this.getAnnotationIcon(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.TEXT,
       flags,
@@ -3574,37 +3766,40 @@ class PdfiumEngine {
       inReplyToId,
       author,
       modified,
+      created,
       state,
-      stateModel
+      stateModel,
+      icon
     };
   }
   /**
    * Read pdf freetext annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf freetext annotation
    *
    * @private
    */
-  readPdfFreeTextAnno(page, pagePtr, annotationPtr, index) {
+  readPdfFreeTextAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const annoRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, annoRect);
+    const rect = this.convertPageRectToDeviceRect(page, annoRect);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const defaultStyle = this.getAnnotString(annotationPtr, "DS");
     const da = this.getAnnotationDefaultAppearance(annotationPtr);
     const backgroundColor = this.getAnnotationColor(annotationPtr);
     const textAlign = this.getAnnotationTextAlignment(annotationPtr);
     const verticalAlign = this.getAnnotationVerticalAlignment(annotationPtr);
     const opacity = this.getAnnotationOpacity(annotationPtr);
-    const modified = pdfDateToDate(modifiedRaw);
     const richContent = this.getAnnotRichContent(annotationPtr);
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.FREETEXT,
       fontFamily: (da == null ? void 0 : da.fontFamily) ?? PdfStandardFont.Unknown,
@@ -3620,6 +3815,7 @@ class PdfiumEngine {
       contents,
       author,
       modified,
+      created,
       rect
     };
   }
@@ -3627,48 +3823,24 @@ class PdfiumEngine {
    * Read pdf link annotation from pdf document
    * @param page  - pdf page infor
    * @param docPtr - pointer to pdf document object
-   * @param pagePtr - pointer to pdf page object
-   * @param  textPagePtr - pointer to pdf text page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf link annotation
    *
    * @private
    */
-  readPdfLinkAnno(page, docPtr, pagePtr, textPagePtr, annotationPtr, index) {
+  readPdfLinkAnno(page, docPtr, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const linkPtr = this.pdfiumModule.FPDFAnnot_GetLink(annotationPtr);
     if (!linkPtr) {
       return;
     }
     const annoRect = this.readPageAnnoRect(annotationPtr);
-    const { left, top, right, bottom } = annoRect;
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, annoRect);
+    const rect = this.convertPageRectToDeviceRect(page, annoRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const flags = this.getAnnotationFlags(annotationPtr);
-    const utf16Length = this.pdfiumModule.FPDFText_GetBoundedText(
-      textPagePtr,
-      left,
-      top,
-      right,
-      bottom,
-      0,
-      0
-    );
-    const bytesCount = (utf16Length + 1) * 2;
-    const textBufferPtr = this.malloc(bytesCount);
-    this.pdfiumModule.FPDFText_GetBoundedText(
-      textPagePtr,
-      left,
-      top,
-      right,
-      bottom,
-      textBufferPtr,
-      utf16Length
-    );
-    const text = this.pdfiumModule.pdfium.UTF16ToString(textBufferPtr);
-    this.free(textBufferPtr);
     const target = this.readPdfLinkAnnoTarget(
       docPtr,
       () => {
@@ -3680,20 +3852,20 @@ class PdfiumEngine {
     );
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.LINK,
       flags,
-      text,
       target,
       rect,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf widget annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param formHandle - form handle
    * @param index  - index of annotation in the pdf page
@@ -3701,68 +3873,73 @@ class PdfiumEngine {
    *
    * @private
    */
-  readPdfWidgetAnno(page, pagePtr, annotationPtr, formHandle, index) {
+  readPdfWidgetAnno(page, annotationPtr, formHandle, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const flags = this.getAnnotationFlags(annotationPtr);
     const field = this.readPdfWidgetAnnoField(formHandle, annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.WIDGET,
       flags,
       rect,
       field,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf file attachment annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf file attachment annotation
    *
    * @private
    */
-  readPdfFileAttachmentAnno(page, pagePtr, annotationPtr, index) {
+  readPdfFileAttachmentAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.FILEATTACHMENT,
       flags,
       rect,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf ink annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf ink annotation
    *
    * @private
    */
-  readPdfInkAnno(page, pagePtr, annotationPtr, index) {
+  readPdfInkAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const color = this.getAnnotationColor(annotationPtr);
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const { width: strokeWidth } = this.getBorderStyle(annotationPtr);
@@ -3770,11 +3947,14 @@ class PdfiumEngine {
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
     const intent = this.getAnnotIntent(annotationPtr);
     const flags = this.getAnnotationFlags(annotationPtr);
+    const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.INK,
       ...intent && { intent },
+      contents,
       blendMode,
       flags,
       color: color ?? "#FF0000",
@@ -3783,26 +3963,27 @@ class PdfiumEngine {
       rect,
       inkList,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf polygon annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf polygon annotation
    *
    * @private
    */
-  readPdfPolygonAnno(page, pagePtr, annotationPtr, index) {
+  readPdfPolygonAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
-    const vertices = this.readPdfAnnoVertices(page, pagePtr, annotationPtr);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
+    const vertices = this.readPdfAnnoVertices(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const flags = this.getAnnotationFlags(annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr);
@@ -3828,6 +4009,7 @@ class PdfiumEngine {
     }
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.POLYGON,
       contents,
@@ -3841,26 +4023,27 @@ class PdfiumEngine {
       rect,
       vertices,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf polyline annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf polyline annotation
    *
    * @private
    */
-  readPdfPolylineAnno(page, pagePtr, annotationPtr, index) {
+  readPdfPolylineAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
-    const vertices = this.readPdfAnnoVertices(page, pagePtr, annotationPtr);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
+    const vertices = this.readPdfAnnoVertices(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const strokeColor = this.getAnnotationColor(annotationPtr);
     const flags = this.getAnnotationFlags(annotationPtr);
@@ -3880,6 +4063,7 @@ class PdfiumEngine {
     const lineEndings = this.getLineEndings(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.POLYLINE,
       contents,
@@ -3894,25 +4078,26 @@ class PdfiumEngine {
       rect,
       vertices,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf line annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf line annotation
    *
    * @private
    */
-  readPdfLineAnno(page, pagePtr, annotationPtr, index) {
+  readPdfLineAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const linePoints = this.getLinePoints(annotationPtr, page);
     const lineEndings = this.getLineEndings(annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
@@ -3933,6 +4118,7 @@ class PdfiumEngine {
     }
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.LINE,
       flags,
@@ -3950,33 +4136,35 @@ class PdfiumEngine {
         end: PdfAnnotationLineEnding.None
       },
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf highlight annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf highlight annotation
    *
    * @private
    */
-  readPdfHighlightAnno(page, pagePtr, annotationPtr, index) {
+  readPdfHighlightAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
     const color = this.getAnnotationColor(annotationPtr);
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.HIGHLIGHT,
@@ -3987,25 +4175,26 @@ class PdfiumEngine {
       color: color ?? "#FFFF00",
       opacity,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf underline annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf underline annotation
    *
    * @private
    */
-  readPdfUnderlineAnno(page, pagePtr, annotationPtr, index) {
+  readPdfUnderlineAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const color = this.getAnnotationColor(annotationPtr);
@@ -4014,6 +4203,7 @@ class PdfiumEngine {
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.UNDERLINE,
@@ -4024,25 +4214,26 @@ class PdfiumEngine {
       color: color ?? "#FF0000",
       opacity,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read strikeout annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf strikeout annotation
    *
    * @private
    */
-  readPdfStrikeOutAnno(page, pagePtr, annotationPtr, index) {
+  readPdfStrikeOutAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const color = this.getAnnotationColor(annotationPtr);
@@ -4051,6 +4242,7 @@ class PdfiumEngine {
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.STRIKEOUT,
@@ -4061,25 +4253,26 @@ class PdfiumEngine {
       color: color ?? "#FF0000",
       opacity,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf squiggly annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf squiggly annotation
    *
    * @private
    */
-  readPdfSquigglyAnno(page, pagePtr, annotationPtr, index) {
+  readPdfSquigglyAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const color = this.getAnnotationColor(annotationPtr);
@@ -4088,6 +4281,7 @@ class PdfiumEngine {
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.SQUIGGLY,
@@ -4098,61 +4292,67 @@ class PdfiumEngine {
       color: color ?? "#FF0000",
       opacity,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf caret annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf caret annotation
    *
    * @private
    */
-  readPdfCaretAnno(page, pagePtr, annotationPtr, index) {
+  readPdfCaretAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.CARET,
       rect,
       flags,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
    * Read pdf stamp annotation
-   * @param docPtr - pointer to pdf document object
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf stamp annotation
    *
    * @private
    */
-  readPdfStampAnno(docPtr, page, pagePtr, annotationPtr, index) {
+  readPdfStampAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const flags = this.getAnnotationFlags(annotationPtr);
+    const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.STAMP,
+      contents,
       rect,
       author,
       modified,
+      created,
       flags
     };
   }
@@ -4378,20 +4578,21 @@ class PdfiumEngine {
   /**
    * Read circle annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf circle annotation
    *
    * @private
    */
-  readPdfCircleAnno(page, pagePtr, annotationPtr, index) {
+  readPdfCircleAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const flags = this.getAnnotationFlags(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
+    const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const interiorColor = this.getAnnotationColor(
       annotationPtr,
       PdfAnnotationColorType.InteriorColor
@@ -4408,37 +4609,41 @@ class PdfiumEngine {
     }
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.CIRCLE,
       flags,
       color: interiorColor ?? "transparent",
       opacity,
+      contents,
       strokeWidth,
       strokeColor: strokeColor ?? "#FF0000",
       strokeStyle,
       rect,
       author,
       modified,
+      created,
       ...strokeDashArray !== void 0 && { strokeDashArray }
     };
   }
   /**
    * Read square annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
    * @returns pdf square annotation
    *
    * @private
    */
-  readPdfSquareAnno(page, pagePtr, annotationPtr, index) {
+  readPdfSquareAnno(page, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const flags = this.getAnnotationFlags(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
+    const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const interiorColor = this.getAnnotationColor(
       annotationPtr,
       PdfAnnotationColorType.InteriorColor
@@ -4455,24 +4660,26 @@ class PdfiumEngine {
     }
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       type: PdfAnnotationSubtype.SQUARE,
       flags,
       color: interiorColor ?? "transparent",
       opacity,
+      contents,
       strokeColor: strokeColor ?? "#FF0000",
       strokeWidth,
       strokeStyle,
       rect,
       author,
       modified,
+      created,
       ...strokeDashArray !== void 0 && { strokeDashArray }
     };
   }
   /**
    * Read basic info of unsupported pdf annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param type - type of annotation
    * @param annotationPtr - pointer to pdf annotation
    * @param index  - index of annotation in the pdf page
@@ -4480,21 +4687,24 @@ class PdfiumEngine {
    *
    * @private
    */
-  readPdfAnno(page, pagePtr, type, annotationPtr, index) {
+  readPdfAnno(page, type, annotationPtr, index) {
+    const custom = this.getAnnotCustom(annotationPtr);
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
+    const rect = this.convertPageRectToDeviceRect(page, pageRect);
     const author = this.getAnnotString(annotationPtr, "T");
-    const modifiedRaw = this.getAnnotString(annotationPtr, "M");
-    const modified = pdfDateToDate(modifiedRaw);
+    const modified = this.getAnnotationDate(annotationPtr, "M");
+    const created = this.getAnnotationDate(annotationPtr, "CreationDate");
     const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
+      custom,
       id: index,
       flags,
       type,
       rect,
       author,
-      modified
+      modified,
+      created
     };
   }
   /**
@@ -4506,11 +4716,22 @@ class PdfiumEngine {
    *
    * @private
    */
-  getInReplyToId(pagePtr, annotationPtr) {
+  getInReplyToId(annotationPtr) {
     const parentPtr = this.pdfiumModule.FPDFAnnot_GetLinkedAnnot(annotationPtr, "IRT");
     if (!parentPtr) return;
-    const idx = this.pdfiumModule.FPDFPage_GetAnnotIndex(pagePtr, parentPtr);
-    return idx >= 0 ? idx : void 0;
+    return this.getAnnotString(parentPtr, "NM");
+  }
+  /**
+   * Set the in reply to id of the annotation
+   *
+   * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+   * @param id - the id of the parent annotation
+   * @returns `true` on success
+   */
+  setInReplyToId(pagePtr, annotationPtr, id) {
+    const parentPtr = this.getAnnotationByName(pagePtr, id);
+    if (!parentPtr) return false;
+    return this.pdfiumModule.EPDFAnnot_SetLinkedAnnot(annotationPtr, "IRT", parentPtr);
   }
   /**
    * Fetch a string value (`/T`, `/M`, `/State`, …) from an annotation.
@@ -4529,6 +4750,41 @@ class PdfiumEngine {
     this.free(ptr);
     return value || void 0;
   }
+  /**
+   * Get custom data of the annotation
+   * @param annotationPtr - pointer to pdf annotation
+   * @returns custom data of the annotation
+   *
+   * @private
+   */
+  getAnnotCustom(annotationPtr) {
+    const custom = this.getAnnotString(annotationPtr, "EPDFCustom");
+    if (!custom) return;
+    try {
+      return JSON.parse(custom);
+    } catch (error) {
+      console.warn("Failed to parse annotation custom data as JSON:", error);
+      console.warn("Invalid JSON string:", custom);
+      return void 0;
+    }
+  }
+  /**
+   * Sets custom data for an annotation by safely stringifying and storing JSON
+   * @private
+   */
+  setAnnotCustom(annotationPtr, data) {
+    if (data === void 0 || data === null) {
+      return this.setAnnotString(annotationPtr, "EPDFCustom", "");
+    }
+    try {
+      const jsonString = JSON.stringify(data);
+      return this.setAnnotString(annotationPtr, "EPDFCustom", jsonString);
+    } catch (error) {
+      console.warn("Failed to stringify annotation custom data as JSON:", error);
+      console.warn("Invalid data object:", data);
+      return false;
+    }
+  }
   /**
    * Fetches the /IT (Intent) name from an annotation as a UTF-8 JS string.
    *
@@ -4576,6 +4832,38 @@ class PdfiumEngine {
     this.free(ptr);
     return value || void 0;
   }
+  /**
+   * Get annotation by name
+   * @param pagePtr - pointer to pdf page object
+   * @param name - name of annotation
+   * @returns pointer to pdf annotation
+   *
+   * @private
+   */
+  getAnnotationByName(pagePtr, name) {
+    const bytes = 2 * (name.length + 1);
+    const ptr = this.malloc(bytes);
+    this.pdfiumModule.pdfium.stringToUTF16(name, ptr, bytes);
+    const ok = this.pdfiumModule.EPDFPage_GetAnnotByName(pagePtr, ptr);
+    this.free(ptr);
+    return ok;
+  }
+  /**
+   * Remove annotation by name
+   * @param pagePtr - pointer to pdf page object
+   * @param name - name of annotation
+   * @returns true on success
+   *
+   * @private
+   */
+  removeAnnotationByName(pagePtr, name) {
+    const bytes = 2 * (name.length + 1);
+    const ptr = this.malloc(bytes);
+    this.pdfiumModule.pdfium.stringToUTF16(name, ptr, bytes);
+    const ok = this.pdfiumModule.EPDFPage_RemoveAnnotByName(pagePtr, ptr);
+    this.free(ptr);
+    return ok;
+  }
   /**
    * Set a string value (`/T`, `/M`, `/State`, …) to an annotation.
    *
@@ -4594,13 +4882,12 @@ class PdfiumEngine {
   /**
    * Read vertices of pdf annotation
    * @param page  - pdf page infor
-   * @param pagePtr - pointer to pdf page object
    * @param annotationPtr - pointer to pdf annotation
    * @returns vertices of pdf annotation
    *
    * @private
    */
-  readPdfAnnoVertices(page, pagePtr, annotationPtr) {
+  readPdfAnnoVertices(page, annotationPtr) {
     const vertices = [];
     const count = this.pdfiumModule.FPDFAnnot_GetVertices(annotationPtr, 0, 0);
     const pointMemorySize = 8;
@@ -4812,7 +5099,7 @@ class PdfiumEngine {
       });
     }
     const pageCtx = ctx.acquirePage(page.index);
-    const annotPtr = this.pdfiumModule.FPDFPage_GetAnnot(pageCtx.pagePtr, annotation.id);
+    const annotPtr = this.getAnnotationByName(pageCtx.pagePtr, annotation.id);
     if (!annotPtr) {
       pageCtx.release();
       this.logger.perf(
@@ -5248,7 +5535,7 @@ class PdfiumEngine {
    *
    * @private
    */
-  convertPageRectToDeviceRect(page, pagePtr, pageRect) {
+  convertPageRectToDeviceRect(page, pageRect) {
     const { x, y } = this.convertPagePointToDevicePoint(page, {
       x: pageRect.left,
       y: pageRect.top
@@ -5436,53 +5723,82 @@ class PdfiumEngine {
     return highlightRects;
   }
   /**
-   * Search for a keyword across all pages in the document
-   * Returns all search results throughout the entire document
+   * {@inheritDoc @embedpdf/models!PdfEngine.searchAllPages}
    *
-   * @param doc - Pdf document object
-   * @param keyword - Search keyword
-   * @param flags - Match flags for search
-   * @returns Promise of all search results in the document
+   * Runs inside the worker.
+   * Emits per-page progress: { page, results }
    *
    * @public
    */
   searchAllPages(doc, keyword, flags = []) {
     this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "searchAllPages", doc, keyword, flags);
-    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SearchAllPages`, "Begin", doc.id);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "SearchAllPages", "Begin", doc.id);
     const ctx = this.cache.getContext(doc.id);
     if (!ctx) {
-      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SearchAllPages`, "End", doc.id);
-      return PdfTaskHelper.resolve({ results: [], total: 0 });
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "SearchAllPages", "End", doc.id);
+      return PdfTaskHelper.resolve({
+        results: [],
+        total: 0
+      });
     }
     const length = 2 * (keyword.length + 1);
     const keywordPtr = this.malloc(length);
     this.pdfiumModule.pdfium.stringToUTF16(keyword, keywordPtr, length);
-    const flag = flags.reduce((flag2, currFlag) => {
-      return flag2 | currFlag;
-    }, MatchFlag.None);
-    const results = [];
-    const searchAllPagesTask = PdfTaskHelper.create();
-    const executeSearch = async () => {
-      for (let pageIndex = 0; pageIndex < doc.pageCount; pageIndex++) {
-        const pageResults = this.searchAllInPage(ctx, doc.pages[pageIndex], keywordPtr, flag);
-        results.push(...pageResults);
+    const flag = flags.reduce((acc, f) => acc | f, MatchFlag.None);
+    const task = PdfTaskHelper.create();
+    let cancelled = false;
+    task.wait(
+      () => {
+      },
+      (err) => {
+        if (err.type === "abort") cancelled = true;
       }
-      this.free(keywordPtr);
-      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SearchAllPages`, "End", doc.id);
-      searchAllPagesTask.resolve({
-        results,
-        total: results.length
-      });
+    );
+    const CHUNK_SIZE = 100;
+    const allResults = [];
+    const processChunk = (startIdx) => {
+      if (cancelled) return;
+      const endIdx = Math.min(startIdx + CHUNK_SIZE, doc.pageCount);
+      try {
+        for (let pageIndex = startIdx; pageIndex < endIdx && !cancelled; pageIndex++) {
+          const pageResults = this.searchAllInPage(ctx, doc.pages[pageIndex], keywordPtr, flag);
+          allResults.push(...pageResults);
+          task.progress({ page: pageIndex, results: pageResults });
+        }
+      } catch (e) {
+        if (!cancelled) {
+          this.free(keywordPtr);
+          this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "SearchAllPages", "End", doc.id);
+          task.reject({
+            code: PdfErrorCode.Unknown,
+            message: `Error searching document: ${e}`
+          });
+        }
+        return;
+      }
+      if (cancelled) return;
+      if (endIdx >= doc.pageCount) {
+        this.free(keywordPtr);
+        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "SearchAllPages", "End", doc.id);
+        task.resolve({ results: allResults, total: allResults.length });
+        return;
+      }
+      setTimeout(() => processChunk(endIdx), 0);
     };
-    executeSearch().catch((error) => {
-      this.free(keywordPtr);
-      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SearchAllPages`, "End", doc.id);
-      searchAllPagesTask.reject({
-        code: PdfErrorCode.Unknown,
-        message: `Error searching document: ${error}`
-      });
-    });
-    return searchAllPagesTask;
+    setTimeout(() => processChunk(0), 0);
+    task.wait(
+      () => {
+      },
+      (err) => {
+        if (err.type === "abort") {
+          try {
+            this.free(keywordPtr);
+          } catch {
+          }
+        }
+      }
+    );
+    return task;
   }
   /**
    * Extract word-aligned context for a search hit.
@@ -5553,44 +5869,43 @@ class PdfiumEngine {
    * @private
    */
   searchAllInPage(ctx, page, keywordPtr, flag) {
-    const pageIndex = page.index;
-    const pageCtx = ctx.acquirePage(pageIndex);
-    const textPagePtr = pageCtx.getTextPage();
-    const total = this.pdfiumModule.FPDFText_CountChars(textPagePtr);
-    const bufPtr = this.malloc(2 * (total + 1));
-    this.pdfiumModule.FPDFText_GetText(textPagePtr, 0, total, bufPtr);
-    const fullText = this.pdfiumModule.pdfium.UTF16ToString(bufPtr);
-    this.free(bufPtr);
-    const pageResults = [];
-    const searchHandle = this.pdfiumModule.FPDFText_FindStart(
-      textPagePtr,
-      keywordPtr,
-      flag,
-      0
-      // Start from the beginning of the page
-    );
-    while (this.pdfiumModule.FPDFText_FindNext(searchHandle)) {
-      const charIndex = this.pdfiumModule.FPDFText_GetSchResultIndex(searchHandle);
-      const charCount = this.pdfiumModule.FPDFText_GetSchCount(searchHandle);
-      const rects = this.getHighlightRects(
-        page,
-        pageCtx.pagePtr,
+    return ctx.borrowPage(page.index, (pageCtx) => {
+      const textPagePtr = pageCtx.getTextPage();
+      const total = this.pdfiumModule.FPDFText_CountChars(textPagePtr);
+      const bufPtr = this.malloc(2 * (total + 1));
+      this.pdfiumModule.FPDFText_GetText(textPagePtr, 0, total, bufPtr);
+      const fullText = this.pdfiumModule.pdfium.UTF16ToString(bufPtr);
+      this.free(bufPtr);
+      const pageResults = [];
+      const searchHandle = this.pdfiumModule.FPDFText_FindStart(
         textPagePtr,
-        charIndex,
-        charCount
+        keywordPtr,
+        flag,
+        0
+        // Start from the beginning of the page
       );
-      const context = this.buildContext(fullText, charIndex, charCount);
-      pageResults.push({
-        pageIndex,
-        charIndex,
-        charCount,
-        rects,
-        context
-      });
-    }
-    this.pdfiumModule.FPDFText_FindClose(searchHandle);
-    pageCtx.release();
-    return pageResults;
+      while (this.pdfiumModule.FPDFText_FindNext(searchHandle)) {
+        const charIndex = this.pdfiumModule.FPDFText_GetSchResultIndex(searchHandle);
+        const charCount = this.pdfiumModule.FPDFText_GetSchCount(searchHandle);
+        const rects = this.getHighlightRects(
+          page,
+          pageCtx.pagePtr,
+          textPagePtr,
+          charIndex,
+          charCount
+        );
+        const context = this.buildContext(fullText, charIndex, charCount);
+        pageResults.push({
+          pageIndex: page.index,
+          charIndex,
+          charCount,
+          rects,
+          context
+        });
+      }
+      this.pdfiumModule.FPDFText_FindClose(searchHandle);
+      return pageResults;
+    });
   }
 }
 export {
@@ -5602,4 +5917,4 @@ export {
   readArrayBuffer as c,
   readString as r
 };
-//# sourceMappingURL=engine-B11yoQGd.js.map
+//# sourceMappingURL=engine-uSZXjmb5.js.map