@embedpdf/engines 2.4.0 → 2.5.0

package/dist/{direct-engine-6BoAmGsC.js → direct-engine-D8HGqcIt.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-D_Dua_6w.js";
-import { b as browserImageDataToBlobConverter } from "./browser-awZxztMA.js";
+import { P as PdfEngine } from "./pdf-engine-aJNoNMbt.js";
+import { b as browserImageDataToBlobConverter } from "./browser-qfUHZxQ6.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(
@@ -1560,10 +1570,11 @@ class PdfiumNative {
     let isSucceed = false;
     switch (annotation.type) {
       case PdfAnnotationSubtype.INK:
-        isSucceed = this.addInkStroke(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addInkStroke(doc, page, pageCtx.pagePtr, annotationPtr, annotation);
         break;
       case PdfAnnotationSubtype.STAMP:
         isSucceed = this.addStampContent(
+          doc,
           ctx.docPtr,
           page,
           pageCtx.pagePtr,
@@ -1579,11 +1590,11 @@ class PdfiumNative {
         isSucceed = this.addFreeTextContent(page, pageCtx.pagePtr, annotationPtr, annotation);
         break;
       case PdfAnnotationSubtype.LINE:
-        isSucceed = this.addLineContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addLineContent(doc, page, pageCtx.pagePtr, annotationPtr, annotation);
         break;
       case PdfAnnotationSubtype.POLYLINE:
       case PdfAnnotationSubtype.POLYGON:
-        isSucceed = this.addPolyContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addPolyContent(doc, page, pageCtx.pagePtr, annotationPtr, annotation);
         break;
       case PdfAnnotationSubtype.CIRCLE:
       case PdfAnnotationSubtype.SQUARE:
@@ -1593,13 +1604,19 @@ class PdfiumNative {
       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,
+          annotation
+        );
         break;
       case PdfAnnotationSubtype.LINK:
         isSucceed = this.addLinkContent(ctx.docPtr, pageCtx.pagePtr, annotationPtr, annotation);
         break;
       case PdfAnnotationSubtype.REDACT:
-        isSucceed = this.addRedactContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        isSucceed = this.addRedactContent(doc, page, pageCtx.pagePtr, annotationPtr, annotation);
         break;
     }
     if (!isSucceed) {
@@ -1679,7 +1696,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(
@@ -1699,12 +1716,12 @@ class PdfiumNative {
       /* ── 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, annotation);
         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, annotation);
         break;
       }
       case PdfAnnotationSubtype.TEXT: {
@@ -1724,13 +1741,13 @@ class PdfiumNative {
       }
       /* ── Line ─────────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.LINE: {
-        ok = this.addLineContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addLineContent(doc, page, pageCtx.pagePtr, annotPtr, annotation);
         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, annotation);
         break;
       }
       /* ── Text-markup family ──────────────────────────────────────────────── */
@@ -1738,7 +1755,7 @@ 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, annotation);
         break;
       }
       /* ── Link ─────────────────────────────────────────────────────────────── */
@@ -1748,7 +1765,7 @@ class PdfiumNative {
       }
       /* ── Redact ───────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.REDACT: {
-        ok = this.addRedactContent(page, pageCtx.pagePtr, annotPtr, annotation);
+        ok = this.addRedactContent(doc, page, pageCtx.pagePtr, annotPtr, annotation);
         break;
       }
       /* ── Unsupported edits – fall through to error ───────────────────────── */
@@ -2803,11 +2820,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)) {
@@ -2829,9 +2846,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,
@@ -2888,7 +2906,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 +2915,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)) {
@@ -3016,8 +3034,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)) {
@@ -3039,8 +3057,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)) {
@@ -3098,6 +3116,7 @@ class PdfiumNative {
   }
   /**
    * 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 +3127,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,7 +3138,7 @@ 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;
       }
     }
@@ -3130,6 +3149,7 @@ class PdfiumNative {
   }
   /**
    * 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 +3160,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 +3216,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 +3841,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 +3864,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 +3879,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 +3912,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 +3932,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 +3941,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,94 +3954,94 @@ 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;
     }
@@ -4539,11 +4562,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 +4583,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 +4620,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 +4643,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 +4656,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 +4664,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 +4737,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(
@@ -4857,7 +4884,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 +4892,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 +4910,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 +4932,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 +4943,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 +4959,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 +4980,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);
@@ -4981,9 +5010,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);
@@ -5021,13 +5050,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;
@@ -5069,9 +5098,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,
@@ -5091,9 +5120,9 @@ 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,
@@ -5111,13 +5140,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 {
@@ -5145,10 +5174,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,
@@ -5194,10 +5223,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,
@@ -5238,10 +5267,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(
@@ -5285,10 +5314,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);
@@ -5315,10 +5344,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);
@@ -5345,10 +5374,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);
@@ -5375,10 +5404,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);
@@ -5405,9 +5434,9 @@ 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,
@@ -5425,10 +5454,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,
@@ -5468,9 +5497,9 @@ 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,
@@ -5711,9 +5740,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
@@ -5751,9 +5780,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
@@ -5792,9 +5821,9 @@ 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,
@@ -6095,13 +6124,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 +6143,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 +6158,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 +6166,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");
     });
@@ -6894,16 +6925,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 +6951,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 +6977,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 +6985,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 +7056,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 +7064,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 +7115,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 +7125,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 +7139,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 +7183,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 +7213,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 +7257,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 +7342,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 +7361,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,
@@ -7600,4 +7636,4 @@ export {
   isValidCustomKey as i,
   readString as r
 };
-//# sourceMappingURL=direct-engine-6BoAmGsC.js.map
+//# sourceMappingURL=direct-engine-D8HGqcIt.js.map