@embedpdf/engines 2.4.1 → 2.6.0

package/dist/{direct-engine-5RWKENek.js → direct-engine-CvfzIn2D.js}

@@ -1,7 +1,7 @@
 import { init } from "@embedpdf/pdfium";
 import { Rotation, NoopLogger, PdfTaskHelper, PdfErrorCode, pdfDateToDate, isUuidV4, uuidV4, PdfAnnotationSubtype, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationBorderStyle, PdfAnnotationColorType, PdfAnnotationLineEnding, PdfStandardFont, PdfStampFit, PdfTrappedStatus, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, PdfAnnotationReplyType, dateToPdfDate, quadToRect, rectToQuad, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, Task, toIntRect, transformRect, buildUserToDeviceMatrix, PdfZoomMode, PdfActionType } from "@embedpdf/models";
-import { P as PdfEngine } from "./pdf-engine-CVXuu1xQ.js";
-import { b as browserImageDataToBlobConverter } from "./browser-qfUHZxQ6.js";
+import { P as PdfEngine } from "./pdf-engine-aJNoNMbt.js";
+import { b as browserImageDataToBlobConverter } from "./browser-BISJ9naB.js";
 function readString(wasmModule, readChars, parseChars, defaultLength = 100) {
   let buffer = wasmModule.wasmExports.malloc(defaultLength);
   for (let i = 0; i < defaultLength; i++) {
@@ -98,7 +98,8 @@ const WasmPointer = (ptr) => ptr;
 const DEFAULT_CONFIG = {
   pageTtl: 5e3,
   // 5 seconds
-  maxPagesPerDocument: 10
+  maxPagesPerDocument: 10,
+  normalizeRotation: false
 };
 class PdfCache {
   constructor(pdfium, memoryManager, config = {}) {
@@ -108,10 +109,11 @@ class PdfCache {
     this.config = { ...DEFAULT_CONFIG, ...config };
   }
   /** Open (or re-use) a document */
-  setDocument(id, filePtr, docPtr) {
+  setDocument(id, filePtr, docPtr, normalizeRotation = false) {
     let ctx = this.docs.get(id);
     if (!ctx) {
-      ctx = new DocumentContext(filePtr, docPtr, this.pdfium, this.memoryManager, this.config);
+      const docConfig = { ...this.config, normalizeRotation };
+      ctx = new DocumentContext(filePtr, docPtr, this.pdfium, this.memoryManager, docConfig);
       this.docs.set(id, ctx);
     }
   }
@@ -162,6 +164,7 @@ class DocumentContext {
     this.filePtr = filePtr;
     this.docPtr = docPtr;
     this.memoryManager = memoryManager;
+    this.normalizeRotation = config.normalizeRotation;
     this.pageCache = new PageCache(pdfium, docPtr, config);
   }
   /** Main accessor for pages */
@@ -199,7 +202,12 @@ class PageCache {
     let ctx = this.cache.get(pageIdx);
     if (!ctx) {
       this.evictIfNeeded();
-      const pagePtr = this.pdf.FPDF_LoadPage(this.docPtr, pageIdx);
+      let pagePtr;
+      if (this.config.normalizeRotation) {
+        pagePtr = this.pdf.EPDF_LoadPageNormalized(this.docPtr, pageIdx, 0);
+      } else {
+        pagePtr = this.pdf.FPDF_LoadPage(this.docPtr, pageIdx);
+      }
       ctx = new PageContext(this.pdf, this.docPtr, pageIdx, pagePtr, this.config.pageTtl, () => {
         this.cache.delete(pageIdx);
         this.removeFromAccessOrder(pageIdx);
@@ -1054,6 +1062,7 @@ class PdfiumNative {
   openDocumentBuffer(file, options) {
     this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "openDocumentBuffer", file, options);
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `OpenDocumentBuffer`, "Begin", file.id);
+    const normalizeRotation = (options == null ? void 0 : options.normalizeRotation) ?? false;
     const array = new Uint8Array(file.content);
     const length = array.length;
     const filePtr = this.memoryManager.malloc(length);
@@ -1073,13 +1082,13 @@ class PdfiumNative {
     const pages = [];
     const sizePtr = this.memoryManager.malloc(8);
     for (let index = 0; index < pageCount; index++) {
-      const result = this.pdfiumModule.FPDF_GetPageSizeByIndexF(docPtr, index, sizePtr);
+      const result = normalizeRotation ? this.pdfiumModule.EPDF_GetPageSizeByIndexNormalized(docPtr, index, sizePtr) : this.pdfiumModule.FPDF_GetPageSizeByIndexF(docPtr, index, sizePtr);
       if (!result) {
         const lastError = this.pdfiumModule.FPDF_GetLastError();
         this.logger.error(
           LOG_SOURCE,
           LOG_CATEGORY,
-          `FPDF_GetPageSizeByIndexF failed with ${lastError}`
+          `${normalizeRotation ? "EPDF_GetPageSizeByIndexNormalized" : "FPDF_GetPageSizeByIndexF"} failed with ${lastError}`
         );
         this.memoryManager.free(sizePtr);
         this.pdfiumModule.FPDF_CloseDocument(docPtr);
@@ -1087,7 +1096,7 @@ class PdfiumNative {
         this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `OpenDocumentBuffer`, "End", file.id);
         return PdfTaskHelper.reject({
           code: lastError,
-          message: `FPDF_GetPageSizeByIndexF failed`
+          message: `${normalizeRotation ? "EPDF_GetPageSizeByIndexNormalized" : "FPDF_GetPageSizeByIndexF"} failed`
         });
       }
       const rotation = this.pdfiumModule.EPDF_GetPageRotationByIndex(docPtr, index);
@@ -1111,9 +1120,10 @@ class PdfiumNative {
       pages,
       isEncrypted,
       isOwnerUnlocked,
-      permissions
+      permissions,
+      normalizedRotation: normalizeRotation
     };
-    this.cache.setDocument(file.id, filePtr, docPtr);
+    this.cache.setDocument(file.id, filePtr, docPtr, normalizeRotation);
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `OpenDocumentBuffer`, "End", file.id);
     return PdfTaskHelper.resolve(pdfDoc);
   }
@@ -1470,7 +1480,7 @@ class PdfiumNative {
         message: "document does not open"
       });
     }
-    const annotations = this.readPageAnnotations(ctx, page);
+    const annotations = this.readPageAnnotations(doc, ctx, page);
     this.logger.perf(
       LOG_SOURCE,
       LOG_CATEGORY,
@@ -1542,7 +1552,7 @@ class PdfiumNative {
         message: "can not set the name of the annotation"
       });
     }
-    if (!this.setPageAnnoRect(page, annotationPtr, annotation.rect)) {
+    if (!this.setPageAnnoRect(doc, page, annotationPtr, annotation.rect)) {
       this.pdfiumModule.FPDFPage_CloseAnnot(annotationPtr);
       pageCtx.release();
       this.logger.perf(
@@ -1557,49 +1567,100 @@ class PdfiumNative {
         message: "can not set the rect of the annotation"
       });
     }
+    const saveAnnotation = this.prepareAnnotationForSave(annotation);
     let isSucceed = false;
-    switch (annotation.type) {
+    switch (saveAnnotation.type) {
       case PdfAnnotationSubtype.INK:
-        isSucceed = this.addInkStroke(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addInkStroke(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
       case PdfAnnotationSubtype.STAMP:
         isSucceed = this.addStampContent(
+          doc,
           ctx.docPtr,
           page,
           pageCtx.pagePtr,
           annotationPtr,
-          annotation,
+          saveAnnotation,
           context == null ? void 0 : context.imageData
         );
         break;
       case PdfAnnotationSubtype.TEXT:
-        isSucceed = this.addTextContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addTextContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
       case PdfAnnotationSubtype.FREETEXT:
-        isSucceed = this.addFreeTextContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addFreeTextContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
       case PdfAnnotationSubtype.LINE:
-        isSucceed = this.addLineContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addLineContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
       case PdfAnnotationSubtype.POLYLINE:
       case PdfAnnotationSubtype.POLYGON:
-        isSucceed = this.addPolyContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addPolyContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
       case PdfAnnotationSubtype.CIRCLE:
       case PdfAnnotationSubtype.SQUARE:
-        isSucceed = this.addShapeContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addShapeContent(doc, page, pageCtx.pagePtr, annotationPtr, saveAnnotation);
         break;
       case PdfAnnotationSubtype.UNDERLINE:
       case PdfAnnotationSubtype.STRIKEOUT:
       case PdfAnnotationSubtype.SQUIGGLY:
       case PdfAnnotationSubtype.HIGHLIGHT:
-        isSucceed = this.addTextMarkupContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addTextMarkupContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
       case PdfAnnotationSubtype.LINK:
-        isSucceed = this.addLinkContent(ctx.docPtr, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addLinkContent(
+          doc,
+          page,
+          ctx.docPtr,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
       case PdfAnnotationSubtype.REDACT:
-        isSucceed = this.addRedactContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addRedactContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
         break;
     }
     if (!isSucceed) {
@@ -1679,7 +1740,7 @@ class PdfiumNative {
       );
       return PdfTaskHelper.reject({ code: PdfErrorCode.NotFound, message: "annotation not found" });
     }
-    if (!this.setPageAnnoRect(page, annotPtr, annotation.rect)) {
+    if (!this.setPageAnnoRect(doc, page, annotPtr, annotation.rect)) {
       this.pdfiumModule.FPDFPage_CloseAnnot(annotPtr);
       pageCtx.release();
       this.logger.perf(
@@ -1694,43 +1755,81 @@ class PdfiumNative {
         message: "failed to move annotation"
       });
     }
+    const saveAnnotation = this.prepareAnnotationForSave(annotation);
     let ok = false;
-    switch (annotation.type) {
+    switch (saveAnnotation.type) {
       /* ── Ink ─────────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.INK: {
         if (!this.pdfiumModule.FPDFAnnot_RemoveInkList(annotPtr)) break;
-        ok = this.addInkStroke(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addInkStroke(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Stamp ───────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.STAMP: {
-        ok = this.addStampContent(ctx.docPtr, page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addStampContent(
+          doc,
+          ctx.docPtr,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       case PdfAnnotationSubtype.TEXT: {
-        ok = this.addTextContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addTextContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Free text ────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.FREETEXT: {
-        ok = this.addFreeTextContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addFreeTextContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Shape ───────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.CIRCLE:
       case PdfAnnotationSubtype.SQUARE: {
-        ok = this.addShapeContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addShapeContent(doc, page, pageCtx.pagePtr, annotPtr, saveAnnotation);
         break;
       }
       /* ── Line ─────────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.LINE: {
-        ok = this.addLineContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addLineContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Polygon / Polyline ───────────────────────────────────────────────── */
       case PdfAnnotationSubtype.POLYGON:
       case PdfAnnotationSubtype.POLYLINE: {
-        ok = this.addPolyContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addPolyContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Text-markup family ──────────────────────────────────────────────── */
@@ -1738,17 +1837,36 @@ class PdfiumNative {
       case PdfAnnotationSubtype.UNDERLINE:
       case PdfAnnotationSubtype.STRIKEOUT:
       case PdfAnnotationSubtype.SQUIGGLY: {
-        ok = this.addTextMarkupContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addTextMarkupContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Link ─────────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.LINK: {
-        ok = this.addLinkContent(ctx.docPtr, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addLinkContent(
+          doc,
+          page,
+          ctx.docPtr,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Redact ───────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.REDACT: {
-        ok = this.addRedactContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addRedactContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
         break;
       }
       /* ── Unsupported edits – fall through to error ───────────────────────── */
@@ -2732,7 +2850,7 @@ class PdfiumNative {
    *
    * @private
    */
-  addTextContent(page, pagePtr, annotationPtr, annotation) {
+  addTextContent(doc, page, pagePtr, annotationPtr, annotation) {
     if (!this.setAnnotationIcon(annotationPtr, annotation.icon || PdfAnnotationIcon.Comment)) {
       return false;
     }
@@ -2747,7 +2865,7 @@ class PdfiumNative {
         return false;
       }
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add free text content to annotation
@@ -2759,7 +2877,7 @@ class PdfiumNative {
    *
    * @private
    */
-  addFreeTextContent(page, pagePtr, annotationPtr, annotation) {
+  addFreeTextContent(doc, page, pagePtr, annotationPtr, annotation) {
     if (!this.setBorderStyle(annotationPtr, PdfAnnotationBorderStyle.SOLID, 0)) {
       return false;
     }
@@ -2791,7 +2909,7 @@ class PdfiumNative {
     } else if (!this.setAnnotationColor(annotationPtr, bgColor ?? "#FFFFFF", PdfAnnotationColorType.Color)) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Set the rect of specified annotation
@@ -2803,11 +2921,11 @@ class PdfiumNative {
    *
    * @private
    */
-  addInkStroke(page, pagePtr, annotationPtr, annotation) {
+  addInkStroke(doc, page, pagePtr, annotationPtr, annotation) {
     if (!this.setBorderStyle(annotationPtr, PdfAnnotationBorderStyle.SOLID, annotation.strokeWidth)) {
       return false;
     }
-    if (!this.setInkList(page, annotationPtr, annotation.inkList)) {
+    if (!this.setInkList(doc, page, annotationPtr, annotation.inkList)) {
       return false;
     }
     if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
@@ -2817,7 +2935,7 @@ class PdfiumNative {
     if (!this.setAnnotationColor(annotationPtr, strokeColor, PdfAnnotationColorType.Color)) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add line content to annotation
@@ -2829,9 +2947,10 @@ class PdfiumNative {
    *
    * @private
    */
-  addLineContent(page, pagePtr, annotationPtr, annotation) {
+  addLineContent(doc, page, pagePtr, annotationPtr, annotation) {
     var _a, _b;
     if (!this.setLinePoints(
+      doc,
       page,
       annotationPtr,
       annotation.linePoints.start,
@@ -2876,7 +2995,7 @@ class PdfiumNative {
     )) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add polygon or polyline content to annotation
@@ -2888,7 +3007,7 @@ class PdfiumNative {
    *
    * @private
    */
-  addPolyContent(page, pagePtr, annotationPtr, annotation) {
+  addPolyContent(doc, page, pagePtr, annotationPtr, annotation) {
     var _a, _b;
     if (annotation.type === PdfAnnotationSubtype.POLYLINE && !this.setLineEndings(
       annotationPtr,
@@ -2897,7 +3016,7 @@ class PdfiumNative {
     )) {
       return false;
     }
-    if (!this.setPdfAnnoVertices(page, annotationPtr, annotation.vertices)) {
+    if (!this.setPdfAnnoVertices(doc, page, annotationPtr, annotation.vertices)) {
       return false;
     }
     if (!this.setBorderStyle(annotationPtr, annotation.strokeStyle, annotation.strokeWidth)) {
@@ -2930,7 +3049,7 @@ class PdfiumNative {
     )) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add link content (action or destination) to a link annotation
@@ -2942,7 +3061,7 @@ class PdfiumNative {
    *
    * @private
    */
-  addLinkContent(docPtr, pagePtr, annotationPtr, annotation) {
+  addLinkContent(doc, page, docPtr, pagePtr, annotationPtr, annotation) {
     const style = annotation.strokeStyle ?? PdfAnnotationBorderStyle.UNDERLINE;
     const width = annotation.strokeWidth ?? 2;
     if (!this.setBorderStyle(annotationPtr, style, width)) {
@@ -2965,7 +3084,7 @@ class PdfiumNative {
         return false;
       }
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add shape content to annotation
@@ -2977,7 +3096,7 @@ class PdfiumNative {
    *
    * @private
    */
-  addShapeContent(page, pagePtr, annotationPtr, annotation) {
+  addShapeContent(doc, page, pagePtr, annotationPtr, annotation) {
     if (!this.setBorderStyle(annotationPtr, annotation.strokeStyle, annotation.strokeWidth)) {
       return false;
     }
@@ -3005,7 +3124,7 @@ class PdfiumNative {
     )) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add highlight content to annotation
@@ -3016,8 +3135,8 @@ class PdfiumNative {
    *
    * @private
    */
-  addTextMarkupContent(page, pagePtr, annotationPtr, annotation) {
-    if (!this.syncQuadPointsAnno(page, annotationPtr, annotation.segmentRects)) {
+  addTextMarkupContent(doc, page, pagePtr, annotationPtr, annotation) {
+    if (!this.syncQuadPointsAnno(doc, page, annotationPtr, annotation.segmentRects)) {
       return false;
     }
     if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
@@ -3027,7 +3146,7 @@ class PdfiumNative {
     if (!this.setAnnotationColor(annotationPtr, strokeColor, PdfAnnotationColorType.Color)) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add content to redact annotation
@@ -3039,8 +3158,8 @@ class PdfiumNative {
    *
    * @private
    */
-  addRedactContent(page, pagePtr, annotationPtr, annotation) {
-    if (!this.syncQuadPointsAnno(page, annotationPtr, annotation.segmentRects)) {
+  addRedactContent(doc, page, pagePtr, annotationPtr, annotation) {
+    if (!this.syncQuadPointsAnno(doc, page, annotationPtr, annotation.segmentRects)) {
       return false;
     }
     if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
@@ -3094,10 +3213,11 @@ class PdfiumNative {
     if (annotation.textAlign !== void 0 && !this.setAnnotationTextAlignment(annotationPtr, annotation.textAlign)) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
    * Add contents to stamp annotation
+   * @param doc - pdf document object
    * @param docPtr - pointer to pdf document object
    * @param page - page info
    * @param pagePtr - pointer to page object
@@ -3108,7 +3228,7 @@ class PdfiumNative {
    *
    * @private
    */
-  addStampContent(docPtr, page, pagePtr, annotationPtr, annotation, imageData) {
+  addStampContent(doc, docPtr, page, pagePtr, annotationPtr, annotation, imageData) {
     if (annotation.icon && !this.setAnnotationIcon(annotationPtr, annotation.icon)) {
       return false;
     }
@@ -3119,17 +3239,18 @@ class PdfiumNative {
       for (let i = this.pdfiumModule.FPDFAnnot_GetObjectCount(annotationPtr) - 1; i >= 0; i--) {
         this.pdfiumModule.FPDFAnnot_RemoveObject(annotationPtr, i);
       }
-      if (!this.addImageObject(docPtr, page, pagePtr, annotationPtr, annotation.rect, imageData)) {
+      if (!this.addImageObject(doc, docPtr, page, pagePtr, annotationPtr, annotation.rect, imageData)) {
         return false;
       }
     }
-    if (!this.pdfiumModule.EPDFAnnot_UpdateAppearanceToRect(annotationPtr, PdfStampFit.Cover)) {
+    if (!this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation)) {
       return false;
     }
-    return this.applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation);
+    return !!this.pdfiumModule.EPDFAnnot_UpdateAppearanceToRect(annotationPtr, PdfStampFit.Cover);
   }
   /**
    * Add image object to annotation
+   * @param doc - pdf document object
    * @param docPtr - pointer to pdf document object
    * @param page - page info
    * @param pagePtr - pointer to page object
@@ -3140,7 +3261,7 @@ class PdfiumNative {
    *
    * @private
    */
-  addImageObject(docPtr, page, pagePtr, annotationPtr, rect, imageData) {
+  addImageObject(doc, docPtr, page, pagePtr, annotationPtr, rect, imageData) {
     const bytesPerPixel = 4;
     const pixelCount = imageData.width * imageData.height;
     const bitmapBufferPtr = this.memoryManager.malloc(bytesPerPixel * pixelCount);
@@ -3196,7 +3317,7 @@ class PdfiumNative {
       return false;
     }
     this.memoryManager.free(matrixPtr);
-    const pagePos = this.convertDevicePointToPagePoint(page, {
+    const pagePos = this.convertDevicePointToPagePoint(doc, page, {
       x: rect.origin.x,
       y: rect.origin.y + imageData.height
       // shift down by the image height
@@ -3821,19 +3942,20 @@ class PdfiumNative {
   /**
    * Read page annotations
    *
+   * @param doc - pdf document object
    * @param ctx - document context
    * @param page - page info
    * @returns annotations on the pdf page
    *
    * @private
    */
-  readPageAnnotations(ctx, page) {
+  readPageAnnotations(doc, ctx, page) {
     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);
+          const anno = this.readPageAnnotation(doc, ctx.docPtr, page, annotPtr, pageCtx);
           if (anno) annotations.push(anno);
         });
       }
@@ -3843,13 +3965,14 @@ class PdfiumNative {
   /**
    * Read page annotations without loading the page (raw approach)
    *
+   * @param doc - pdf document object
    * @param ctx - document context
    * @param page - page info
    * @returns annotations on the pdf page
    *
    * @private
    */
-  readPageAnnotationsRaw(ctx, page) {
+  readPageAnnotationsRaw(doc, ctx, page) {
     const count = this.pdfiumModule.EPDFPage_GetAnnotCountRaw(ctx.docPtr, page.index);
     if (count <= 0) return [];
     const out = [];
@@ -3857,7 +3980,7 @@ class PdfiumNative {
       const annotPtr = this.pdfiumModule.EPDFPage_GetAnnotRaw(ctx.docPtr, page.index, i);
       if (!annotPtr) continue;
       try {
-        const anno = this.readPageAnnotation(ctx.docPtr, page, annotPtr);
+        const anno = this.readPageAnnotation(doc, ctx.docPtr, page, annotPtr);
         if (anno) out.push(anno);
       } finally {
         this.pdfiumModule.FPDFPage_CloseAnnot(annotPtr);
@@ -3890,7 +4013,7 @@ class PdfiumNative {
         message: "document does not open"
       });
     }
-    const out = this.readPageAnnotationsRaw(ctx, page);
+    const out = this.readPageAnnotationsRaw(doc, ctx, page);
     this.logger.perf(
       LOG_SOURCE,
       LOG_CATEGORY,
@@ -3910,6 +4033,7 @@ class PdfiumNative {
   /**
    * Read pdf annotation from pdf document
    *
+   * @param doc - pdf document object
    * @param docPtr - pointer to pdf document
    * @param page - page info
    * @param annotationPtr - pointer to pdf annotation
@@ -3918,7 +4042,7 @@ class PdfiumNative {
    *
    * @private
    */
-  readPageAnnotation(docPtr, page, annotationPtr, pageCtx) {
+  readPageAnnotation(doc, docPtr, page, annotationPtr, pageCtx) {
     let index = this.getAnnotString(annotationPtr, "NM");
     if (!index || !isUuidV4(index)) {
       index = uuidV4();
@@ -3931,99 +4055,153 @@ class PdfiumNative {
     switch (subType) {
       case PdfAnnotationSubtype.TEXT:
         {
-          annotation = this.readPdfTextAnno(page, annotationPtr, index);
+          annotation = this.readPdfTextAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.FREETEXT:
         {
-          annotation = this.readPdfFreeTextAnno(page, annotationPtr, index);
+          annotation = this.readPdfFreeTextAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.LINK:
         {
-          annotation = this.readPdfLinkAnno(page, docPtr, annotationPtr, index);
+          annotation = this.readPdfLinkAnno(doc, page, docPtr, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.WIDGET:
         if (pageCtx) {
-          return this.readPdfWidgetAnno(page, annotationPtr, pageCtx.getFormHandle(), index);
+          return this.readPdfWidgetAnno(doc, page, annotationPtr, pageCtx.getFormHandle(), index);
         }
       case PdfAnnotationSubtype.FILEATTACHMENT:
         {
-          annotation = this.readPdfFileAttachmentAnno(page, annotationPtr, index);
+          annotation = this.readPdfFileAttachmentAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.INK:
         {
-          annotation = this.readPdfInkAnno(page, annotationPtr, index);
+          annotation = this.readPdfInkAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.POLYGON:
         {
-          annotation = this.readPdfPolygonAnno(page, annotationPtr, index);
+          annotation = this.readPdfPolygonAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.POLYLINE:
         {
-          annotation = this.readPdfPolylineAnno(page, annotationPtr, index);
+          annotation = this.readPdfPolylineAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.LINE:
         {
-          annotation = this.readPdfLineAnno(page, annotationPtr, index);
+          annotation = this.readPdfLineAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.HIGHLIGHT:
-        annotation = this.readPdfHighlightAnno(page, annotationPtr, index);
+        annotation = this.readPdfHighlightAnno(doc, page, annotationPtr, index);
         break;
       case PdfAnnotationSubtype.STAMP:
         {
-          annotation = this.readPdfStampAnno(page, annotationPtr, index);
+          annotation = this.readPdfStampAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.SQUARE:
         {
-          annotation = this.readPdfSquareAnno(page, annotationPtr, index);
+          annotation = this.readPdfSquareAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.CIRCLE:
         {
-          annotation = this.readPdfCircleAnno(page, annotationPtr, index);
+          annotation = this.readPdfCircleAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.UNDERLINE:
         {
-          annotation = this.readPdfUnderlineAnno(page, annotationPtr, index);
+          annotation = this.readPdfUnderlineAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.SQUIGGLY:
         {
-          annotation = this.readPdfSquigglyAnno(page, annotationPtr, index);
+          annotation = this.readPdfSquigglyAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.STRIKEOUT:
         {
-          annotation = this.readPdfStrikeOutAnno(page, annotationPtr, index);
+          annotation = this.readPdfStrikeOutAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.CARET:
         {
-          annotation = this.readPdfCaretAnno(page, annotationPtr, index);
+          annotation = this.readPdfCaretAnno(doc, page, annotationPtr, index);
         }
         break;
       case PdfAnnotationSubtype.REDACT:
         {
-          annotation = this.readPdfRedactAnno(page, annotationPtr, index);
+          annotation = this.readPdfRedactAnno(doc, page, annotationPtr, index);
         }
         break;
       default:
         {
-          annotation = this.readPdfAnno(page, subType, annotationPtr, index);
+          annotation = this.readPdfAnno(doc, page, subType, annotationPtr, index);
         }
         break;
     }
+    if (annotation) {
+      annotation = this.reverseRotateAnnotationOnLoad(annotation);
+    }
     return annotation;
   }
+  /**
+   * On load, if a vertex-type annotation has rotation metadata in EPDFCustom,
+   * reverse-rotate the PDF's physically rotated vertices by -rotation to recover
+   * the unrotated vertices for runtime editing.
+   */
+  reverseRotateAnnotationOnLoad(annotation) {
+    const rotation = annotation.rotation;
+    const unrotatedRect = annotation.unrotatedRect;
+    if (!rotation || rotation === 0 || !unrotatedRect) {
+      return annotation;
+    }
+    const center = {
+      x: unrotatedRect.origin.x + unrotatedRect.size.width / 2,
+      y: unrotatedRect.origin.y + unrotatedRect.size.height / 2
+    };
+    switch (annotation.type) {
+      case PdfAnnotationSubtype.INK: {
+        const ink = annotation;
+        const unrotatedInkList = ink.inkList.map((stroke) => ({
+          points: stroke.points.map((p) => this.rotatePointForSave(p, center, -rotation))
+        }));
+        return { ...ink, inkList: unrotatedInkList };
+      }
+      case PdfAnnotationSubtype.LINE: {
+        const line = annotation;
+        return {
+          ...line,
+          linePoints: {
+            start: this.rotatePointForSave(line.linePoints.start, center, -rotation),
+            end: this.rotatePointForSave(line.linePoints.end, center, -rotation)
+          }
+        };
+      }
+      case PdfAnnotationSubtype.POLYGON: {
+        const poly = annotation;
+        return {
+          ...poly,
+          vertices: poly.vertices.map((v) => this.rotatePointForSave(v, center, -rotation))
+        };
+      }
+      case PdfAnnotationSubtype.POLYLINE: {
+        const polyline = annotation;
+        return {
+          ...polyline,
+          vertices: polyline.vertices.map((v) => this.rotatePointForSave(v, center, -rotation))
+        };
+      }
+      default:
+        return annotation;
+    }
+  }
   /**
    * Return the colour stored directly in the annotation dictionary's `/C` entry.
    *
@@ -4116,6 +4294,125 @@ class PdfiumNative {
     const pdfOpacity = webOpacityToPdfAlpha(opacity);
     return this.pdfiumModule.EPDFAnnot_SetOpacity(annotationPtr, pdfOpacity & 255);
   }
+  /**
+   * Get the rotation angle (in degrees) from the annotation's /Rotate entry.
+   * Returns 0 if no rotation is set or on error.
+   *
+   * @param annotationPtr - pointer to the annotation
+   * @returns rotation in degrees (0 if not set)
+   */
+  getAnnotationRotation(annotationPtr) {
+    const rotationPtr = this.memoryManager.malloc(4);
+    const ok = this.pdfiumModule.EPDFAnnot_GetRotate(annotationPtr, rotationPtr);
+    if (!ok) {
+      this.memoryManager.free(rotationPtr);
+      return 0;
+    }
+    const rotation = this.pdfiumModule.pdfium.getValue(rotationPtr, "float");
+    this.memoryManager.free(rotationPtr);
+    return rotation;
+  }
+  /**
+   * Set the rotation angle (in degrees) on the annotation's /Rotate entry.
+   * A value of 0 removes the /Rotate key.
+   *
+   * @param annotationPtr - pointer to the annotation
+   * @param rotation - rotation in degrees (clockwise)
+   * @returns true on success
+   */
+  setAnnotationRotation(annotationPtr, rotation) {
+    return !!this.pdfiumModule.EPDFAnnot_SetRotate(annotationPtr, rotation);
+  }
+  /**
+   * Get the EmbedPDF extended rotation (in degrees) from the annotation's
+   * /EPDFRotate entry. Returns 0 if not set or on error.
+   *
+   * @param annotationPtr - pointer to the annotation
+   * @returns rotation in degrees (0 if not set)
+   */
+  getAnnotExtendedRotation(annotationPtr) {
+    const rotationPtr = this.memoryManager.malloc(4);
+    const ok = this.pdfiumModule.EPDFAnnot_GetExtendedRotation(annotationPtr, rotationPtr);
+    if (!ok) {
+      this.memoryManager.free(rotationPtr);
+      return 0;
+    }
+    const rotation = this.pdfiumModule.pdfium.getValue(rotationPtr, "float");
+    this.memoryManager.free(rotationPtr);
+    return rotation;
+  }
+  /**
+   * Set the EmbedPDF extended rotation (in degrees) on the annotation's
+   * /EPDFRotate entry. A value of 0 removes the key.
+   *
+   * @param annotationPtr - pointer to the annotation
+   * @param rotation - rotation in degrees
+   * @returns true on success
+   */
+  setAnnotExtendedRotation(annotationPtr, rotation) {
+    return !!this.pdfiumModule.EPDFAnnot_SetExtendedRotation(annotationPtr, rotation);
+  }
+  /**
+   * Read the EmbedPDF unrotated rect from the annotation's /EPDFUnrotatedRect
+   * entry. Returns the raw page-space rect (same format as `readPageAnnoRect`)
+   * or null if not set.
+   *
+   * @param annotationPtr - pointer to the annotation
+   * @returns raw `{ left, top, right, bottom }` in page coords, or null
+   */
+  readAnnotUnrotatedRect(annotationPtr) {
+    const rectPtr = this.memoryManager.malloc(4 * 4);
+    const ok = this.pdfiumModule.EPDFAnnot_GetUnrotatedRect(annotationPtr, rectPtr);
+    if (!ok) {
+      this.memoryManager.free(rectPtr);
+      return null;
+    }
+    const left = this.pdfiumModule.pdfium.getValue(rectPtr, "float");
+    const top = this.pdfiumModule.pdfium.getValue(rectPtr + 4, "float");
+    const right = this.pdfiumModule.pdfium.getValue(rectPtr + 8, "float");
+    const bottom = this.pdfiumModule.pdfium.getValue(rectPtr + 12, "float");
+    this.memoryManager.free(rectPtr);
+    if (left === 0 && top === 0 && right === 0 && bottom === 0) {
+      return null;
+    }
+    return { left, top, right, bottom };
+  }
+  /**
+   * Write the EmbedPDF unrotated rect (/EPDFUnrotatedRect) for an annotation.
+   * Accepts a device-space `Rect` and converts to page coordinates internally,
+   * following the same pattern as `setPageAnnoRect`.
+   *
+   * @param doc  - pdf document object
+   * @param page - pdf page object
+   * @param annotPtr - pointer to the annotation
+   * @param rect - device-space rect to store as the unrotated rect
+   * @returns true on success
+   */
+  setAnnotUnrotatedRect(doc, page, annotPtr, rect) {
+    const x0d = Math.floor(rect.origin.x);
+    const y0d = Math.floor(rect.origin.y);
+    const x1d = Math.floor(rect.origin.x + rect.size.width);
+    const y1d = Math.floor(rect.origin.y + rect.size.height);
+    const TL = this.convertDevicePointToPagePoint(doc, page, { x: x0d, y: y0d });
+    const TR = this.convertDevicePointToPagePoint(doc, page, { x: x1d, y: y0d });
+    const BR = this.convertDevicePointToPagePoint(doc, page, { x: x1d, y: y1d });
+    const BL = this.convertDevicePointToPagePoint(doc, page, { x: x0d, y: y1d });
+    let left = Math.min(TL.x, TR.x, BR.x, BL.x);
+    let right = Math.max(TL.x, TR.x, BR.x, BL.x);
+    let bottom = Math.min(TL.y, TR.y, BR.y, BL.y);
+    let top = Math.max(TL.y, TR.y, BR.y, BL.y);
+    if (left > right) [left, right] = [right, left];
+    if (bottom > top) [bottom, top] = [top, bottom];
+    const ptr = this.memoryManager.malloc(16);
+    const pdf = this.pdfiumModule.pdfium;
+    pdf.setValue(ptr + 0, left, "float");
+    pdf.setValue(ptr + 4, top, "float");
+    pdf.setValue(ptr + 8, right, "float");
+    pdf.setValue(ptr + 12, bottom, "float");
+    const ok = this.pdfiumModule.EPDFAnnot_SetUnrotatedRect(annotPtr, ptr);
+    this.memoryManager.free(ptr);
+    return !!ok;
+  }
   /**
    * Fetch the `/Q` text-alignment value from a **FreeText** annotation.
    *
@@ -4265,10 +4562,11 @@ class PdfiumNative {
    * @returns `true` on success
    */
   setAnnotationDefaultAppearance(annotationPtr, font, fontSize, color) {
+    const resolvedFont = font === PdfStandardFont.Unknown ? PdfStandardFont.Helvetica : font;
     const { red, green, blue } = webColorToPdfColor(color);
     return !!this.pdfiumModule.EPDFAnnot_SetDefaultAppearance(
       annotationPtr,
-      font,
+      resolvedFont,
       fontSize,
       red & 255,
       green & 255,
@@ -4539,11 +4837,12 @@ class PdfiumNative {
   }
   /**
    * Get the start and end points of a LINE / POLYLINE annot.
+   * @param doc - pdf document object
    * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
    * @param page - logical page info object (`PdfPageObject`)
    * @returns `{ start, end }` or `undefined` when PDFium can't read them
    */
-  getLinePoints(page, annotationPtr) {
+  getLinePoints(doc, page, annotationPtr) {
     const startPtr = this.memoryManager.malloc(8);
     const endPtr = this.memoryManager.malloc(8);
     const ok = this.pdfiumModule.FPDFAnnot_GetLine(annotationPtr, startPtr, endPtr);
@@ -4559,22 +4858,23 @@ class PdfiumNative {
     const ey = pdf.getValue(endPtr + 4, "float");
     this.memoryManager.free(startPtr);
     this.memoryManager.free(endPtr);
-    const start = this.convertPagePointToDevicePoint(page, { x: sx, y: sy });
-    const end = this.convertPagePointToDevicePoint(page, { x: ex, y: ey });
+    const start = this.convertPagePointToDevicePoint(doc, page, { x: sx, y: sy });
+    const end = this.convertPagePointToDevicePoint(doc, page, { x: ex, y: ey });
     return { start, end };
   }
   /**
    * Set the two end‑points of a **Line** annotation
    * by writing a new /L array `[ x1 y1 x2 y2 ]`.
+   * @param doc - pdf document object
    * @param page - logical page info object (`PdfPageObject`)
    * @param annotPtr - pointer to the annotation whose line points are needed
    * @param start - start point
    * @param end - end point
    * @returns true on success
    */
-  setLinePoints(page, annotPtr, start, end) {
-    const p1 = this.convertDevicePointToPagePoint(page, start);
-    const p2 = this.convertDevicePointToPagePoint(page, end);
+  setLinePoints(doc, page, annotPtr, start, end) {
+    const p1 = this.convertDevicePointToPagePoint(doc, page, start);
+    const p2 = this.convertDevicePointToPagePoint(doc, page, end);
     if (!p1 || !p2) return false;
     const buf = this.memoryManager.malloc(16);
     const pdf = this.pdfiumModule.pdfium;
@@ -4595,13 +4895,14 @@ class PdfiumNative {
    * This preserves the true shape for rotated / skewed text, whereas callers
    * that only need axis-aligned boxes can collapse each quad themselves.
    *
+   * @param doc           - pdf document object
    * @param page          - logical page info object (`PdfPageObject`)
    * @param annotationPtr - pointer to the annotation whose quads are needed
    * @returns Array of `Rect` objects (`[]` if the annotation has no quads)
    *
    * @private
    */
-  getQuadPointsAnno(page, annotationPtr) {
+  getQuadPointsAnno(doc, page, annotationPtr) {
     const quadCount = this.pdfiumModule.FPDFAnnot_CountAttachmentPoints(annotationPtr);
     if (quadCount === 0) return [];
     const FS_QUADPOINTSF_SIZE = 8 * 4;
@@ -4617,10 +4918,10 @@ class PdfiumNative {
           xs.push(this.pdfiumModule.pdfium.getValue(base, "float"));
           ys.push(this.pdfiumModule.pdfium.getValue(base + 4, "float"));
         }
-        const p1 = this.convertPagePointToDevicePoint(page, { x: xs[0], y: ys[0] });
-        const p2 = this.convertPagePointToDevicePoint(page, { x: xs[1], y: ys[1] });
-        const p3 = this.convertPagePointToDevicePoint(page, { x: xs[2], y: ys[2] });
-        const p4 = this.convertPagePointToDevicePoint(page, { x: xs[3], y: ys[3] });
+        const p1 = this.convertPagePointToDevicePoint(doc, page, { x: xs[0], y: ys[0] });
+        const p2 = this.convertPagePointToDevicePoint(doc, page, { x: xs[1], y: ys[1] });
+        const p3 = this.convertPagePointToDevicePoint(doc, page, { x: xs[2], y: ys[2] });
+        const p4 = this.convertPagePointToDevicePoint(doc, page, { x: xs[3], y: ys[3] });
         quads.push({ p1, p2, p3, p4 });
       }
       this.memoryManager.free(quadPtr);
@@ -4630,6 +4931,7 @@ class PdfiumNative {
   /**
    * Set the quadrilaterals for a **Highlight / Underline / StrikeOut / Squiggly** markup annotation.
    *
+   * @param doc           - pdf document object
    * @param page          - logical page info object (`PdfPageObject`)
    * @param annotationPtr - pointer to the annotation whose quads are needed
    * @param rects         - array of `Rect` objects (`[]` if the annotation has no quads)
@@ -4637,17 +4939,17 @@ class PdfiumNative {
    *
    * @private
    */
-  syncQuadPointsAnno(page, annotPtr, rects) {
+  syncQuadPointsAnno(doc, page, annotPtr, rects) {
     const FS_QUADPOINTSF_SIZE = 8 * 4;
     const pdf = this.pdfiumModule.pdfium;
     const count = this.pdfiumModule.FPDFAnnot_CountAttachmentPoints(annotPtr);
     const buf = this.memoryManager.malloc(FS_QUADPOINTSF_SIZE);
     const writeQuad = (r) => {
       const q = rectToQuad(r);
-      const p1 = this.convertDevicePointToPagePoint(page, q.p1);
-      const p2 = this.convertDevicePointToPagePoint(page, q.p2);
-      const p3 = this.convertDevicePointToPagePoint(page, q.p3);
-      const p4 = this.convertDevicePointToPagePoint(page, q.p4);
+      const p1 = this.convertDevicePointToPagePoint(doc, page, q.p1);
+      const p2 = this.convertDevicePointToPagePoint(doc, page, q.p2);
+      const p3 = this.convertDevicePointToPagePoint(doc, page, q.p3);
+      const p4 = this.convertDevicePointToPagePoint(doc, page, q.p4);
       pdf.setValue(buf + 0, p1.x, "float");
       pdf.setValue(buf + 4, p1.y, "float");
       pdf.setValue(buf + 8, p2.x, "float");
@@ -4710,7 +5012,7 @@ class PdfiumNative {
       return PdfTaskHelper.resolve(false);
     }
     const pageCtx = ctx.acquirePage(page.index);
-    const { ptr, count } = this.allocFSQuadsBufferFromRects(page, clean);
+    const { ptr, count } = this.allocFSQuadsBufferFromRects(doc, page, clean);
     let ok = false;
     try {
       ok = !!this.pdfiumModule.EPDFText_RedactInQuads(
@@ -4718,7 +5020,7 @@ class PdfiumNative {
         ptr,
         count,
         recurseForms ? true : false,
-        drawBlackBoxes ? true : false
+        false
       );
     } finally {
       this.memoryManager.free(ptr);
@@ -4857,7 +5159,7 @@ class PdfiumNative {
     return PdfTaskHelper.resolve(!!ok);
   }
   /** Pack device-space Rects into an FS_QUADPOINTSF[] buffer (page space). */
-  allocFSQuadsBufferFromRects(page, rects) {
+  allocFSQuadsBufferFromRects(doc, page, rects) {
     const STRIDE = 32;
     const count = rects.length;
     const ptr = this.memoryManager.malloc(STRIDE * count);
@@ -4865,10 +5167,10 @@ class PdfiumNative {
     for (let i = 0; i < count; i++) {
       const r = rects[i];
       const q = rectToQuad(r);
-      const p1 = this.convertDevicePointToPagePoint(page, q.p1);
-      const p2 = this.convertDevicePointToPagePoint(page, q.p2);
-      const p3 = this.convertDevicePointToPagePoint(page, q.p3);
-      const p4 = this.convertDevicePointToPagePoint(page, q.p4);
+      const p1 = this.convertDevicePointToPagePoint(doc, page, q.p1);
+      const p2 = this.convertDevicePointToPagePoint(doc, page, q.p2);
+      const p3 = this.convertDevicePointToPagePoint(doc, page, q.p3);
+      const p4 = this.convertDevicePointToPagePoint(doc, page, q.p4);
       const base = ptr + i * STRIDE;
       pdf.setValue(base + 0, p1.x, "float");
       pdf.setValue(base + 4, p1.y, "float");
@@ -4883,12 +5185,13 @@ class PdfiumNative {
   }
   /**
    * Read ink list from annotation
+   * @param doc - pdf document object
    * @param page  - logical page info object (`PdfPageObject`)
    * @param pagePtr - pointer to the page
    * @param annotationPtr - pointer to the annotation whose ink list is needed
    * @returns ink list
    */
-  getInkList(page, annotationPtr) {
+  getInkList(doc, page, annotationPtr) {
     const inkList = [];
     const pathCount = this.pdfiumModule.FPDFAnnot_GetInkListCount(annotationPtr);
     if (pathCount <= 0) return inkList;
@@ -4904,7 +5207,7 @@ class PdfiumNative {
           const base = buf + j * POINT_STRIDE;
           const px = pdf.getValue(base + 0, "float");
           const py = pdf.getValue(base + 4, "float");
-          const d = this.convertPagePointToDevicePoint(page, { x: px, y: py });
+          const d = this.convertPagePointToDevicePoint(doc, page, { x: px, y: py });
           points.push({ x: d.x, y: d.y });
         }
         this.memoryManager.free(buf);
@@ -4915,13 +5218,14 @@ class PdfiumNative {
   }
   /**
    * Add ink list to annotation
+   * @param doc - pdf document object
    * @param page  - logical page info object (`PdfPageObject`)
    * @param pagePtr - pointer to the page
    * @param annotationPtr - pointer to the annotation whose ink list is needed
    * @param inkList - ink list array of `PdfInkListObject`
    * @returns `true` if the operation was successful
    */
-  setInkList(page, annotationPtr, inkList) {
+  setInkList(doc, page, annotationPtr, inkList) {
     const pdf = this.pdfiumModule.pdfium;
     const POINT_STRIDE = 8;
     for (const stroke of inkList) {
@@ -4930,7 +5234,7 @@ class PdfiumNative {
       const buf = this.memoryManager.malloc(n * POINT_STRIDE);
       for (let i = 0; i < n; i++) {
         const pDev = stroke.points[i];
-        const pPage = this.convertDevicePointToPagePoint(page, pDev);
+        const pPage = this.convertDevicePointToPagePoint(doc, page, pDev);
         pdf.setValue(buf + i * POINT_STRIDE + 0, pPage.x, "float");
         pdf.setValue(buf + i * POINT_STRIDE + 4, pPage.y, "float");
       }
@@ -4951,9 +5255,9 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfTextAnno(page, annotationPtr, index) {
+  readPdfTextAnno(doc, page, annotationPtr, index) {
     const annoRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, annoRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, annoRect);
     const state = this.getAnnotString(annotationPtr, "State");
     const stateModel = this.getAnnotString(annotationPtr, "StateModel");
     const color = this.getAnnotationColor(annotationPtr);
@@ -4969,7 +5273,7 @@ class PdfiumNative {
       state,
       stateModel,
       icon,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -4981,9 +5285,9 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfFreeTextAnno(page, annotationPtr, index) {
+  readPdfFreeTextAnno(doc, page, annotationPtr, index) {
     const annoRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, annoRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, annoRect);
     const defaultStyle = this.getAnnotString(annotationPtr, "DS");
     const da = this.getAnnotationDefaultAppearance(annotationPtr);
     const bgColor = this.getAnnotationColor(annotationPtr);
@@ -5008,7 +5312,7 @@ class PdfiumNative {
       textAlign,
       defaultStyle,
       richContent,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5021,13 +5325,13 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfLinkAnno(page, docPtr, annotationPtr, index) {
+  readPdfLinkAnno(doc, page, docPtr, annotationPtr, index) {
     const linkPtr = this.pdfiumModule.FPDFAnnot_GetLink(annotationPtr);
     if (!linkPtr) {
       return;
     }
     const annoRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, annoRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, annoRect);
     const { style: strokeStyle, width: strokeWidth } = this.getBorderStyle(annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr, PdfAnnotationColorType.Color);
     let strokeDashArray;
@@ -5056,7 +5360,7 @@ class PdfiumNative {
       strokeWidth,
       strokeStyle,
       strokeDashArray,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5069,9 +5373,9 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfWidgetAnno(page, annotationPtr, formHandle, index) {
+  readPdfWidgetAnno(doc, page, annotationPtr, formHandle, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     const field = this.readPdfWidgetAnnoField(formHandle, annotationPtr);
     return {
       pageIndex: page.index,
@@ -5079,7 +5383,7 @@ class PdfiumNative {
       type: PdfAnnotationSubtype.WIDGET,
       rect,
       field,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5091,15 +5395,15 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfFileAttachmentAnno(page, annotationPtr, index) {
+  readPdfFileAttachmentAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.FILEATTACHMENT,
       rect,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5111,13 +5415,13 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfInkAnno(page, annotationPtr, index) {
+  readPdfInkAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     const strokeColor = this.getAnnotationColor(annotationPtr) ?? "#FF0000";
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const { width: strokeWidth } = this.getBorderStyle(annotationPtr);
-    const inkList = this.getInkList(page, annotationPtr);
+    const inkList = this.getInkList(doc, page, annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
     const intent = this.getAnnotIntent(annotationPtr);
     return {
@@ -5133,7 +5437,7 @@ class PdfiumNative {
       opacity,
       strokeWidth: strokeWidth === 0 ? 1 : strokeWidth,
       inkList,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5145,10 +5449,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfPolygonAnno(page, annotationPtr, index) {
+  readPdfPolygonAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const vertices = this.readPdfAnnoVertices(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const vertices = this.readPdfAnnoVertices(doc, page, annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr);
     const interiorColor = this.getAnnotationColor(
       annotationPtr,
@@ -5182,7 +5486,7 @@ class PdfiumNative {
       strokeStyle,
       strokeDashArray,
       vertices,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5194,10 +5498,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfPolylineAnno(page, annotationPtr, index) {
+  readPdfPolylineAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const vertices = this.readPdfAnnoVertices(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const vertices = this.readPdfAnnoVertices(doc, page, annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr);
     const interiorColor = this.getAnnotationColor(
       annotationPtr,
@@ -5226,7 +5530,7 @@ class PdfiumNative {
       strokeDashArray,
       lineEndings,
       vertices,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5238,10 +5542,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfLineAnno(page, annotationPtr, index) {
+  readPdfLineAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const linePoints = this.getLinePoints(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const linePoints = this.getLinePoints(doc, page, annotationPtr);
     const lineEndings = this.getLineEndings(annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr);
     const interiorColor = this.getAnnotationColor(
@@ -5273,7 +5577,7 @@ class PdfiumNative {
         start: PdfAnnotationLineEnding.None,
         end: PdfAnnotationLineEnding.None
       },
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5285,10 +5589,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfHighlightAnno(page, annotationPtr, index) {
+  readPdfHighlightAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const segmentRects = this.getQuadPointsAnno(doc, page, annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr) ?? "#FFFF00";
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
@@ -5303,7 +5607,7 @@ class PdfiumNative {
       color: strokeColor,
       // deprecated alias
       opacity,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5315,10 +5619,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfUnderlineAnno(page, annotationPtr, index) {
+  readPdfUnderlineAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const segmentRects = this.getQuadPointsAnno(doc, page, annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr) ?? "#FF0000";
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
@@ -5333,7 +5637,7 @@ class PdfiumNative {
       color: strokeColor,
       // deprecated alias
       opacity,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5345,10 +5649,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfStrikeOutAnno(page, annotationPtr, index) {
+  readPdfStrikeOutAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const segmentRects = this.getQuadPointsAnno(doc, page, annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr) ?? "#FF0000";
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
@@ -5363,7 +5667,7 @@ class PdfiumNative {
       color: strokeColor,
       // deprecated alias
       opacity,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5375,10 +5679,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfSquigglyAnno(page, annotationPtr, index) {
+  readPdfSquigglyAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const segmentRects = this.getQuadPointsAnno(doc, page, annotationPtr);
     const strokeColor = this.getAnnotationColor(annotationPtr) ?? "#FF0000";
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
@@ -5393,7 +5697,7 @@ class PdfiumNative {
       color: strokeColor,
       // deprecated alias
       opacity,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5405,15 +5709,15 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfCaretAnno(page, annotationPtr, index) {
+  readPdfCaretAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.CARET,
       rect,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5425,10 +5729,10 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfRedactAnno(page, annotationPtr, index) {
+  readPdfRedactAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
-    const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const segmentRects = this.getQuadPointsAnno(doc, page, annotationPtr);
     const color = this.getAnnotationColor(annotationPtr, PdfAnnotationColorType.InteriorColor);
     const overlayColor = this.getAnnotationColor(
       annotationPtr,
@@ -5456,7 +5760,7 @@ class PdfiumNative {
       fontSize: da == null ? void 0 : da.fontSize,
       fontColor: da == null ? void 0 : da.fontColor,
       textAlign,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5468,15 +5772,15 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfStampAnno(page, annotationPtr, index) {
+  readPdfStampAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.STAMP,
       rect,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5711,9 +6015,9 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfCircleAnno(page, annotationPtr, index) {
+  readPdfCircleAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     const interiorColor = this.getAnnotationColor(
       annotationPtr,
       PdfAnnotationColorType.InteriorColor
@@ -5739,7 +6043,7 @@ class PdfiumNative {
       strokeColor: strokeColor ?? "#FF0000",
       strokeStyle,
       ...strokeDashArray !== void 0 && { strokeDashArray },
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5751,9 +6055,9 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfSquareAnno(page, annotationPtr, index) {
+  readPdfSquareAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     const interiorColor = this.getAnnotationColor(
       annotationPtr,
       PdfAnnotationColorType.InteriorColor
@@ -5779,7 +6083,7 @@ class PdfiumNative {
       strokeWidth,
       strokeStyle,
       ...strokeDashArray !== void 0 && { strokeDashArray },
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5792,15 +6096,15 @@ class PdfiumNative {
    *
    * @private
    */
-  readPdfAnno(page, type, annotationPtr, index) {
+  readPdfAnno(doc, page, type, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
-    const rect = this.convertPageRectToDeviceRect(page, pageRect);
+    const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
     return {
       pageIndex: page.index,
       id: index,
       type,
       rect,
-      ...this.readBaseAnnotationProperties(annotationPtr)
+      ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
   /**
@@ -5832,6 +6136,73 @@ class PdfiumNative {
     if (!parentPtr) return false;
     return this.pdfiumModule.EPDFAnnot_SetLinkedAnnot(annotationPtr, "IRT", parentPtr);
   }
+  /**
+   * Rotate a point around a center by the given angle in degrees.
+   * Used to rotate vertices for PDF storage.
+   */
+  rotatePointForSave(point, center, angleDegrees) {
+    const rad = angleDegrees * Math.PI / 180;
+    const cos = Math.cos(rad);
+    const sin = Math.sin(rad);
+    const dx = point.x - center.x;
+    const dy = point.y - center.y;
+    return {
+      x: center.x + dx * cos - dy * sin,
+      y: center.y + dx * sin + dy * cos
+    };
+  }
+  /**
+   * Prepare an annotation for saving to PDF.
+   * For vertex types (ink, line, polygon, polyline) with rotation,
+   * physically rotates the vertices by +rotation so that other PDF viewers
+   * see the correct visual result. Our viewer reverse-rotates on load.
+   */
+  prepareAnnotationForSave(annotation) {
+    const rotation = annotation.rotation;
+    const unrotatedRect = annotation.unrotatedRect;
+    if (!rotation || rotation === 0 || !unrotatedRect) {
+      return annotation;
+    }
+    const center = {
+      x: unrotatedRect.origin.x + unrotatedRect.size.width / 2,
+      y: unrotatedRect.origin.y + unrotatedRect.size.height / 2
+    };
+    switch (annotation.type) {
+      case PdfAnnotationSubtype.INK: {
+        const ink = annotation;
+        const rotatedInkList = ink.inkList.map((stroke) => ({
+          points: stroke.points.map((p) => this.rotatePointForSave(p, center, rotation))
+        }));
+        return { ...ink, inkList: rotatedInkList };
+      }
+      case PdfAnnotationSubtype.LINE: {
+        const line = annotation;
+        return {
+          ...line,
+          linePoints: {
+            start: this.rotatePointForSave(line.linePoints.start, center, rotation),
+            end: this.rotatePointForSave(line.linePoints.end, center, rotation)
+          }
+        };
+      }
+      case PdfAnnotationSubtype.POLYGON: {
+        const poly = annotation;
+        return {
+          ...poly,
+          vertices: poly.vertices.map((v) => this.rotatePointForSave(v, center, rotation))
+        };
+      }
+      case PdfAnnotationSubtype.POLYLINE: {
+        const polyline = annotation;
+        return {
+          ...polyline,
+          vertices: polyline.vertices.map((v) => this.rotatePointForSave(v, center, rotation))
+        };
+      }
+      default:
+        return annotation;
+    }
+  }
   /**
    * Apply all base annotation properties from PdfAnnotationObjectBase.
    * The setInReplyToId and setReplyType functions handle clearing when undefined.
@@ -5841,7 +6212,7 @@ class PdfiumNative {
    * @param annotation - the annotation object containing properties to apply
    * @returns `true` on success
    */
-  applyBaseAnnotationProperties(pagePtr, annotationPtr, annotation) {
+  applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation) {
     if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
       return false;
     }
@@ -5863,11 +6234,32 @@ class PdfiumNative {
         return false;
       }
     }
-    if (annotation.custom) {
-      if (!this.setAnnotCustom(annotationPtr, annotation.custom)) {
+    const existingCustom = this.getAnnotCustom(annotationPtr) ?? {};
+    const customData = {
+      ...existingCustom,
+      ...annotation.custom ?? {}
+    };
+    delete customData.unrotatedRect;
+    delete customData.rotation;
+    const hasCustomData = Object.keys(customData).length > 0;
+    if (hasCustomData) {
+      if (!this.setAnnotCustom(annotationPtr, customData)) {
+        return false;
+      }
+    } else if (Object.keys(existingCustom).length > 0) {
+      if (!this.setAnnotCustom(annotationPtr, null)) {
         return false;
       }
     }
+    if (annotation.rotation !== void 0) {
+      const pdfRotation = annotation.rotation ? (360 - annotation.rotation) % 360 : 0;
+      this.setAnnotExtendedRotation(annotationPtr, pdfRotation);
+    }
+    if (annotation.unrotatedRect) {
+      this.setAnnotUnrotatedRect(doc, page, annotationPtr, annotation.unrotatedRect);
+    } else if (annotation.rotation && annotation.rotation !== 0) {
+      this.setAnnotUnrotatedRect(doc, page, annotationPtr, annotation.rect);
+    }
     if (!this.setInReplyToId(pagePtr, annotationPtr, annotation.inReplyToId)) {
       return false;
     }
@@ -5880,10 +6272,12 @@ class PdfiumNative {
    * Read all base annotation properties from PdfAnnotationObjectBase.
    * Returns an object that can be spread into the annotation return value.
    *
+   * @param doc - pdf document object
+   * @param page - pdf page object
    * @param annotationPtr - pointer to annotation object
    * @returns object with base annotation properties
    */
-  readBaseAnnotationProperties(annotationPtr) {
+  readBaseAnnotationProperties(doc, page, annotationPtr) {
     const author = this.getAnnotString(annotationPtr, "T");
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const modified = this.getAnnotationDate(annotationPtr, "M");
@@ -5892,6 +6286,10 @@ class PdfiumNative {
     const custom = this.getAnnotCustom(annotationPtr);
     const inReplyToId = this.getInReplyToId(annotationPtr);
     const replyType = this.getReplyType(annotationPtr);
+    const pdfRotation = this.getAnnotExtendedRotation(annotationPtr);
+    const rotation = pdfRotation !== 0 ? (360 - pdfRotation) % 360 : 0;
+    const rawUnrotatedRect = this.readAnnotUnrotatedRect(annotationPtr);
+    const unrotatedRect = rawUnrotatedRect ? this.convertPageRectToDeviceRect(doc, page, rawUnrotatedRect) : void 0;
     return {
       author,
       contents,
@@ -5902,7 +6300,9 @@ class PdfiumNative {
       // Only include IRT if present
       ...inReplyToId && { inReplyToId },
       // Only include RT if present and not the default (Reply)
-      ...replyType && replyType !== PdfAnnotationReplyType.Reply && { replyType }
+      ...replyType && replyType !== PdfAnnotationReplyType.Reply && { replyType },
+      ...rotation !== 0 && { rotation },
+      ...unrotatedRect !== void 0 && { unrotatedRect }
     };
   }
   /**
@@ -6095,13 +6495,14 @@ class PdfiumNative {
   }
   /**
    * Read vertices of pdf annotation
+   * @param doc - pdf document object
    * @param page  - pdf page infor
    * @param annotationPtr - pointer to pdf annotation
    * @returns vertices of pdf annotation
    *
    * @private
    */
-  readPdfAnnoVertices(page, annotationPtr) {
+  readPdfAnnoVertices(doc, page, annotationPtr) {
     const vertices = [];
     const count = this.pdfiumModule.FPDFAnnot_GetVertices(annotationPtr, 0, 0);
     const pointMemorySize = 8;
@@ -6113,7 +6514,7 @@ class PdfiumNative {
         pointsPtr + i * pointMemorySize + 4,
         "float"
       );
-      const { x, y } = this.convertPagePointToDevicePoint(page, {
+      const { x, y } = this.convertPagePointToDevicePoint(doc, page, {
         x: pointX,
         y: pointY
       });
@@ -6128,6 +6529,7 @@ class PdfiumNative {
   /**
    * Sync the vertices of a polygon or polyline annotation.
    *
+   * @param doc - pdf document object
    * @param page  - pdf page infor
    * @param annotPtr - pointer to pdf annotation
    * @param vertices - the vertices to be set
@@ -6135,12 +6537,12 @@ class PdfiumNative {
    *
    * @private
    */
-  setPdfAnnoVertices(page, annotPtr, vertices) {
+  setPdfAnnoVertices(doc, page, annotPtr, vertices) {
     const pdf = this.pdfiumModule.pdfium;
     const FS_POINTF_SIZE = 8;
     const buf = this.memoryManager.malloc(FS_POINTF_SIZE * vertices.length);
     vertices.forEach((v, i) => {
-      const pagePt = this.convertDevicePointToPagePoint(page, v);
+      const pagePt = this.convertDevicePointToPagePoint(doc, page, v);
       pdf.setValue(buf + i * FS_POINTF_SIZE + 0, pagePt.x, "float");
       pdf.setValue(buf + i * FS_POINTF_SIZE + 4, pagePt.y, "float");
     });
@@ -6328,7 +6730,9 @@ class PdfiumNative {
       return PdfTaskHelper.reject({ code: PdfErrorCode.NotFound, message: "annotation not found" });
     }
     const finalScale = Math.max(0.01, scaleFactor * dpr);
-    const rect = toIntRect(annotation.rect);
+    const unrotated = !!(options == null ? void 0 : options.unrotated) && !!annotation.unrotatedRect;
+    const renderRect = unrotated ? annotation.unrotatedRect : annotation.rect;
+    const rect = toIntRect(renderRect);
     const devRect = toIntRect(transformRect(page.size, rect, rotation, finalScale));
     const wDev = Math.max(1, devRect.size.width);
     const hDev = Math.max(1, devRect.size.height);
@@ -6356,14 +6760,25 @@ class PdfiumNative {
     const FLAGS = 16;
     let ok = false;
     try {
-      ok = !!this.pdfiumModule.EPDF_RenderAnnotBitmap(
-        bitmapPtr,
-        pageCtx.pagePtr,
-        annotPtr,
-        mode,
-        mPtr,
-        FLAGS
-      );
+      if (unrotated) {
+        ok = !!this.pdfiumModule.EPDF_RenderAnnotBitmapUnrotated(
+          bitmapPtr,
+          pageCtx.pagePtr,
+          annotPtr,
+          mode,
+          mPtr,
+          FLAGS
+        );
+      } else {
+        ok = !!this.pdfiumModule.EPDF_RenderAnnotBitmap(
+          bitmapPtr,
+          pageCtx.pagePtr,
+          annotPtr,
+          mode,
+          mPtr,
+          FLAGS
+        );
+      }
     } finally {
       this.memoryManager.free(mPtr);
       this.pdfiumModule.FPDFBitmap_Destroy(bitmapPtr);
@@ -6894,16 +7309,17 @@ class PdfiumNative {
   }
   /**
    * Convert coordinate of point from device coordinate to page coordinate
+   * @param doc - pdf document object
    * @param page  - pdf page infor
    * @param position - position of point
    * @returns converted position
    *
    * @private
    */
-  convertDevicePointToPagePoint(page, position) {
+  convertDevicePointToPagePoint(doc, page, position) {
     const DW = page.size.width;
     const DH = page.size.height;
-    const r = page.rotation & 3;
+    const r = doc.normalizedRotation ? 0 : page.rotation & 3;
     if (r === 0) {
       return { x: position.x, y: DH - position.y };
     }
@@ -6919,16 +7335,17 @@ class PdfiumNative {
   }
   /**
    * Convert coordinate of point from page coordinate to device coordinate
+   * @param doc - pdf document object
    * @param page  - pdf page infor
    * @param position - position of point
    * @returns converted position
    *
    * @private
    */
-  convertPagePointToDevicePoint(page, position) {
+  convertPagePointToDevicePoint(doc, page, position) {
     const DW = page.size.width;
     const DH = page.size.height;
-    const r = page.rotation & 3;
+    const r = doc.normalizedRotation ? 0 : page.rotation & 3;
     if (r === 0) {
       return { x: position.x, y: DH - position.y };
     }
@@ -6944,6 +7361,7 @@ class PdfiumNative {
   }
   /**
    * Convert coordinate of rectangle from page coordinate to device coordinate
+   * @param doc - pdf document object
    * @param page  - pdf page infor
    * @param pagePtr - pointer to pdf page object
    * @param pageRect - rectangle that needs to be converted
@@ -6951,8 +7369,8 @@ class PdfiumNative {
    *
    * @private
    */
-  convertPageRectToDeviceRect(page, pageRect) {
-    const { x, y } = this.convertPagePointToDevicePoint(page, {
+  convertPageRectToDeviceRect(doc, page, pageRect) {
+    const { x, y } = this.convertPagePointToDevicePoint(doc, page, {
       x: pageRect.left,
       y: pageRect.top
     });
@@ -7022,6 +7440,7 @@ class PdfiumNative {
   }
   /**
    * Set the rect of specified annotation
+   * @param doc - pdf document object
    * @param page - page info that the annotation is belonged to
    * @param annotationPtr - pointer to annotation object
    * @param rect - target rectangle
@@ -7029,15 +7448,15 @@ class PdfiumNative {
    *
    * @private
    */
-  setPageAnnoRect(page, annotPtr, rect) {
+  setPageAnnoRect(doc, page, annotPtr, rect) {
     const x0d = Math.floor(rect.origin.x);
     const y0d = Math.floor(rect.origin.y);
     const x1d = Math.floor(rect.origin.x + rect.size.width);
     const y1d = Math.floor(rect.origin.y + rect.size.height);
-    const TL = this.convertDevicePointToPagePoint(page, { x: x0d, y: y0d });
-    const TR = this.convertDevicePointToPagePoint(page, { x: x1d, y: y0d });
-    const BR = this.convertDevicePointToPagePoint(page, { x: x1d, y: y1d });
-    const BL = this.convertDevicePointToPagePoint(page, { x: x0d, y: y1d });
+    const TL = this.convertDevicePointToPagePoint(doc, page, { x: x0d, y: y0d });
+    const TR = this.convertDevicePointToPagePoint(doc, page, { x: x1d, y: y0d });
+    const BR = this.convertDevicePointToPagePoint(doc, page, { x: x1d, y: y1d });
+    const BL = this.convertDevicePointToPagePoint(doc, page, { x: x0d, y: y1d });
     let left = Math.min(TL.x, TR.x, BR.x, BL.x);
     let right = Math.max(TL.x, TR.x, BR.x, BL.x);
     let bottom = Math.min(TL.y, TR.y, BR.y, BL.y);
@@ -7080,6 +7499,7 @@ class PdfiumNative {
   }
   /**
    * Get highlight rects for a specific character range (for search highlighting)
+   * @param doc - pdf document object
    * @param page - pdf page info
    * @param pagePtr - pointer to pdf page
    * @param textPagePtr - pointer to pdf text page
@@ -7089,7 +7509,7 @@ class PdfiumNative {
    *
    * @private
    */
-  getHighlightRects(page, textPagePtr, startIndex, charCount) {
+  getHighlightRects(doc, page, textPagePtr, startIndex, charCount) {
     const rectsCount = this.pdfiumModule.FPDFText_CountRects(textPagePtr, startIndex, charCount);
     const highlightRects = [];
     const l = this.memoryManager.malloc(8);
@@ -7103,10 +7523,10 @@ class PdfiumNative {
       const top = this.pdfiumModule.pdfium.getValue(t, "double");
       const right = this.pdfiumModule.pdfium.getValue(r, "double");
       const bottom = this.pdfiumModule.pdfium.getValue(b, "double");
-      const p1 = this.convertPagePointToDevicePoint(page, { x: left, y: top });
-      const p2 = this.convertPagePointToDevicePoint(page, { x: right, y: top });
-      const p3 = this.convertPagePointToDevicePoint(page, { x: right, y: bottom });
-      const p4 = this.convertPagePointToDevicePoint(page, { x: left, y: bottom });
+      const p1 = this.convertPagePointToDevicePoint(doc, page, { x: left, y: top });
+      const p2 = this.convertPagePointToDevicePoint(doc, page, { x: right, y: top });
+      const p3 = this.convertPagePointToDevicePoint(doc, page, { x: right, y: bottom });
+      const p4 = this.convertPagePointToDevicePoint(doc, page, { x: left, y: bottom });
       const xs = [p1.x, p2.x, p3.x, p4.x];
       const ys = [p1.y, p2.y, p3.y, p4.y];
       const x = Math.min(...xs);
@@ -7147,7 +7567,7 @@ class PdfiumNative {
     const keywordPtr = this.memoryManager.malloc(length);
     this.pdfiumModule.pdfium.stringToUTF16(keyword, keywordPtr, length);
     try {
-      const results = this.searchAllInPage(ctx, page, keywordPtr, flags);
+      const results = this.searchAllInPage(doc, ctx, page, keywordPtr, flags);
       return PdfTaskHelper.resolve(results);
     } finally {
       this.memoryManager.free(keywordPtr);
@@ -7177,7 +7597,7 @@ class PdfiumNative {
       const total = pages.length;
       for (let i = 0; i < pages.length; i++) {
         const page = pages[i];
-        const annotations = this.readPageAnnotationsRaw(ctx, page);
+        const annotations = this.readPageAnnotationsRaw(doc, ctx, page);
         results[page.index] = annotations;
         task.progress({
           pageIndex: page.index,
@@ -7221,7 +7641,7 @@ class PdfiumNative {
         const total = pages.length;
         for (let i = 0; i < pages.length; i++) {
           const page = pages[i];
-          const pageResults = this.searchAllInPage(ctx, page, keywordPtr, flags);
+          const pageResults = this.searchAllInPage(doc, ctx, page, keywordPtr, flags);
           results[page.index] = pageResults;
           task.progress({
             pageIndex: page.index,
@@ -7306,7 +7726,7 @@ class PdfiumNative {
    *
    * @private
    */
-  searchAllInPage(ctx, page, keywordPtr, flag) {
+  searchAllInPage(doc, ctx, page, keywordPtr, flag) {
     return ctx.borrowPage(page.index, (pageCtx) => {
       const textPagePtr = pageCtx.getTextPage();
       const total = this.pdfiumModule.FPDFText_CountChars(textPagePtr);
@@ -7325,7 +7745,7 @@ class PdfiumNative {
       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, textPagePtr, charIndex, charCount);
+        const rects = this.getHighlightRects(doc, page, textPagePtr, charIndex, charCount);
         const context = this.buildContext(fullText, charIndex, charCount);
         pageResults.push({
           pageIndex: page.index,
@@ -7593,11 +8013,11 @@ export {
   PdfiumErrorCode as P,
   RenderFlag as R,
   PdfiumNative as a,
-  readArrayBuffer as b,
-  createPdfiumEngine as c,
-  computeFormDrawParams as d,
-  createNodeFontLoader as e,
+  createNodeFontLoader as b,
+  computeFormDrawParams as c,
+  createPdfiumEngine as d,
+  readString as e,
   isValidCustomKey as i,
-  readString as r
+  readArrayBuffer as r
 };
-//# sourceMappingURL=direct-engine-5RWKENek.js.map
+//# sourceMappingURL=direct-engine-CvfzIn2D.js.map