@embedpdf/engines 2.6.2 → 2.8.0

package/dist/{direct-engine-CmsmBgWP.js → direct-engine-BOkKwXM0.js}

@@ -1,6 +1,6 @@
 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-C07l7iNd.js";
+import { Rotation, NoopLogger, PdfTaskHelper, PdfErrorCode, pdfDateToDate, isUuidV4, uuidV4, PdfAnnotationSubtype, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationColorType, PdfAnnotationBorderStyle, PdfAnnotationLineEnding, PdfStandardFont, PdfStampFit, PdfTrappedStatus, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, PdfAnnotationReplyType, dateToPdfDate, quadToRect, rectToQuad, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, Task, toIntRect, transformRect, buildUserToDeviceMatrix, AP_MODE_NORMAL, AP_MODE_ROLLOVER, AP_MODE_DOWN, PdfZoomMode, PdfActionType } from "@embedpdf/models";
+import { P as PdfEngine } from "./pdf-engine-ZvReuoDb.js";
 import { b as browserImageDataToBlobConverter } from "./browser-BISJ9naB.js";
 function readString(wasmModule, readChars, parseChars, defaultLength = 100) {
   let buffer = wasmModule.wasmExports.malloc(defaultLength);
@@ -1653,6 +1653,15 @@ class PdfiumNative {
           saveAnnotation
         );
         break;
+      case PdfAnnotationSubtype.CARET:
+        isSucceed = this.addCaretContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotationPtr,
+          saveAnnotation
+        );
+        break;
       case PdfAnnotationSubtype.REDACT:
         isSucceed = this.addRedactContent(
           doc,
@@ -1704,7 +1713,7 @@ class PdfiumNative {
    *
    * @returns PdfTask<boolean>  –  true on success
    */
-  updatePageAnnotation(doc, page, annotation) {
+  updatePageAnnotation(doc, page, annotation, options) {
     this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "updatePageAnnotation", doc, page, annotation);
     this.logger.perf(
       LOG_SOURCE,
@@ -1858,6 +1867,17 @@ class PdfiumNative {
         );
         break;
       }
+      /* ── Caret ────────────────────────────────────────────────────────────── */
+      case PdfAnnotationSubtype.CARET: {
+        ok = this.addCaretContent(
+          doc,
+          page,
+          pageCtx.pagePtr,
+          annotPtr,
+          saveAnnotation
+        );
+        break;
+      }
       /* ── Redact ───────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.REDACT: {
         ok = this.addRedactContent(
@@ -1873,7 +1893,7 @@ class PdfiumNative {
       default:
         ok = false;
     }
-    if (ok) {
+    if (ok && (options == null ? void 0 : options.regenerateAppearance) !== false) {
       if (annotation.blendMode !== void 0) {
         this.pdfiumModule.EPDFAnnot_GenerateAppearanceWithBlend(annotPtr, annotation.blendMode);
       } else {
@@ -2860,6 +2880,13 @@ class PdfiumNative {
     if (annotation.stateModel && !this.setAnnotString(annotationPtr, "StateModel", annotation.stateModel)) {
       return false;
     }
+    if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
+      return false;
+    }
+    const strokeColor = annotation.strokeColor ?? annotation.color ?? "#FFFF00";
+    if (!this.setAnnotationColor(annotationPtr, strokeColor, PdfAnnotationColorType.Color)) {
+      return false;
+    }
     if (!annotation.flags) {
       if (!this.setAnnotationFlags(annotationPtr, ["print", "noZoom", "noRotate"])) {
         return false;
@@ -2867,6 +2894,30 @@ class PdfiumNative {
     }
     return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
+  /**
+   * Add caret content to annotation
+   * @param doc - document object
+   * @param page - page info
+   * @param pagePtr - pointer to page object
+   * @param annotationPtr - pointer to caret annotation
+   * @param annotation - caret annotation
+   * @returns whether caret content is added to annotation
+   *
+   * @private
+   */
+  addCaretContent(doc, page, pagePtr, annotationPtr, annotation) {
+    if (annotation.strokeColor) {
+      this.setAnnotationColor(annotationPtr, annotation.strokeColor, PdfAnnotationColorType.Color);
+    }
+    if (annotation.opacity !== void 0) {
+      this.setAnnotationOpacity(annotationPtr, annotation.opacity);
+    }
+    if (annotation.intent) {
+      this.setAnnotIntent(annotationPtr, annotation.intent);
+    }
+    this.setRectangleDifferences(annotationPtr, annotation.rectangleDifferences);
+    return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
+  }
   /**
    * Add free text content to annotation
    * @param page - page info
@@ -2909,6 +2960,7 @@ class PdfiumNative {
     } else if (!this.setAnnotationColor(annotationPtr, bgColor ?? "#FFFFFF", PdfAnnotationColorType.Color)) {
       return false;
     }
+    this.setRectangleDifferences(annotationPtr, annotation.rectangleDifferences);
     return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
@@ -3049,6 +3101,12 @@ class PdfiumNative {
     )) {
       return false;
     }
+    if (annotation.type === PdfAnnotationSubtype.POLYGON) {
+      this.setRectangleDifferences(
+        annotationPtr,
+        annotation.rectangleDifferences
+      );
+    }
     return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
@@ -3124,6 +3182,7 @@ class PdfiumNative {
     )) {
       return false;
     }
+    this.setRectangleDifferences(annotationPtr, annotation.rectangleDifferences);
     return this.applyBaseAnnotationProperties(doc, page, pagePtr, annotationPtr, annotation);
   }
   /**
@@ -4392,6 +4451,10 @@ class PdfiumNative {
     }
     if (annotation) {
       annotation = this.reverseRotateAnnotationOnLoad(annotation);
+      const apModes = this.pdfiumModule.EPDFAnnot_GetAvailableAppearanceModes(annotationPtr);
+      if (apModes) {
+        annotation.appearanceModes = apModes;
+      }
     }
     return annotation;
   }
@@ -4935,6 +4998,25 @@ class PdfiumNative {
     this.memoryManager.free(bPtr);
     return { ok, left, top, right, bottom };
   }
+  /**
+   * Sets the /RD array on an annotation.
+   *
+   * @param annotationPtr  pointer to an `FPDF_ANNOTATION`
+   * @param rd  the four inset values, or `undefined` to clear
+   * @returns `true` on success
+   */
+  setRectangleDifferences(annotationPtr, rd) {
+    if (!rd) {
+      return this.pdfiumModule.EPDFAnnot_ClearRectangleDifferences(annotationPtr);
+    }
+    return this.pdfiumModule.EPDFAnnot_SetRectangleDifferences(
+      annotationPtr,
+      rd.left,
+      rd.top,
+      rd.right,
+      rd.bottom
+    );
+  }
   /**
    * Get the date of the annotation
    *
@@ -5512,6 +5594,7 @@ class PdfiumNative {
       id: index,
       type: PdfAnnotationSubtype.TEXT,
       rect,
+      strokeColor: color ?? "#FFFF00",
       color: color ?? "#FFFF00",
       opacity,
       state,
@@ -5539,6 +5622,7 @@ class PdfiumNative {
     const verticalAlign = this.getAnnotationVerticalAlignment(annotationPtr);
     const opacity = this.getAnnotationOpacity(annotationPtr);
     const richContent = this.getAnnotRichContent(annotationPtr);
+    const rd = this.getRectangleDifferences(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
@@ -5556,6 +5640,14 @@ class PdfiumNative {
       textAlign,
       defaultStyle,
       richContent,
+      ...rd.ok && {
+        rectangleDifferences: {
+          left: rd.left,
+          top: rd.top,
+          right: rd.right,
+          bottom: rd.bottom
+        }
+      },
       ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
@@ -5718,6 +5810,7 @@ class PdfiumNative {
         vertices.pop();
       }
     }
+    const rd = this.getRectangleDifferences(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
@@ -5730,6 +5823,14 @@ class PdfiumNative {
       strokeStyle,
       strokeDashArray,
       vertices,
+      ...rd.ok && {
+        rectangleDifferences: {
+          left: rd.left,
+          top: rd.top,
+          right: rd.right,
+          bottom: rd.bottom
+        }
+      },
       ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
@@ -5956,11 +6057,26 @@ class PdfiumNative {
   readPdfCaretAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
     const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const strokeColor = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
+    const intent = this.getAnnotIntent(annotationPtr);
+    const rd = this.getRectangleDifferences(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.CARET,
       rect,
+      strokeColor,
+      opacity,
+      intent,
+      ...rd.ok && {
+        rectangleDifferences: {
+          left: rd.left,
+          top: rd.top,
+          right: rd.right,
+          bottom: rd.bottom
+        }
+      },
       ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
@@ -6276,6 +6392,7 @@ class PdfiumNative {
         strokeDashArray = pattern;
       }
     }
+    const rd = this.getRectangleDifferences(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
@@ -6287,6 +6404,14 @@ class PdfiumNative {
       strokeColor: strokeColor ?? "#FF0000",
       strokeStyle,
       ...strokeDashArray !== void 0 && { strokeDashArray },
+      ...rd.ok && {
+        rectangleDifferences: {
+          left: rd.left,
+          top: rd.top,
+          right: rd.right,
+          bottom: rd.bottom
+        }
+      },
       ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
@@ -6316,6 +6441,7 @@ class PdfiumNative {
         strokeDashArray = pattern;
       }
     }
+    const rd = this.getRectangleDifferences(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
@@ -6327,6 +6453,14 @@ class PdfiumNative {
       strokeWidth,
       strokeStyle,
       ...strokeDashArray !== void 0 && { strokeDashArray },
+      ...rd.ok && {
+        rectangleDifferences: {
+          left: rd.left,
+          top: rd.top,
+          right: rd.right,
+          bottom: rd.bottom
+        }
+      },
       ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
@@ -6363,7 +6497,13 @@ class PdfiumNative {
   getInReplyToId(annotationPtr) {
     const parentPtr = this.pdfiumModule.FPDFAnnot_GetLinkedAnnot(annotationPtr, "IRT");
     if (!parentPtr) return;
-    return this.getAnnotString(parentPtr, "NM");
+    let nm = this.getAnnotString(parentPtr, "NM");
+    if (!nm || !isUuidV4(nm)) {
+      nm = uuidV4();
+      this.setAnnotString(parentPtr, "NM", nm);
+    }
+    this.pdfiumModule.FPDFPage_CloseAnnot(parentPtr);
+    return nm;
   }
   /**
    * Set the in reply to id of the annotation
@@ -7053,6 +7193,150 @@ class PdfiumNative {
     this.memoryManager.free(heapPtr);
     return task;
   }
+  /**
+   * Batch-render all annotation appearance streams for a page in one call.
+   * Returns a map of annotation ID -> rendered appearances (Normal/Rollover/Down).
+   * Skips annotations that have rotation + unrotatedRect (EmbedPDF-rotated)
+   * and annotations without any appearance stream.
+   *
+   * @public
+   */
+  renderPageAnnotationsRaw(doc, page, options) {
+    const { scaleFactor = 1, rotation = Rotation.Degree0, dpr = 1 } = options ?? {};
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "renderPageAnnotationsRaw", doc, page, options);
+    this.logger.perf(
+      LOG_SOURCE,
+      LOG_CATEGORY,
+      "RenderPageAnnotationsRaw",
+      "Begin",
+      `${doc.id}-${page.index}`
+    );
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(
+        LOG_SOURCE,
+        LOG_CATEGORY,
+        "RenderPageAnnotationsRaw",
+        "End",
+        `${doc.id}-${page.index}`
+      );
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    const pageCtx = ctx.acquirePage(page.index);
+    const result = {};
+    const finalScale = Math.max(0.01, scaleFactor * dpr);
+    const annotCount = this.pdfiumModule.FPDFPage_GetAnnotCount(pageCtx.pagePtr);
+    for (let i = 0; i < annotCount; i++) {
+      const annotPtr = this.pdfiumModule.FPDFPage_GetAnnot(pageCtx.pagePtr, i);
+      if (!annotPtr) continue;
+      try {
+        const nm = this.getAnnotString(annotPtr, "NM");
+        if (!nm) continue;
+        const extRotation = this.getAnnotExtendedRotation(annotPtr);
+        if (extRotation !== 0) {
+          const unrotatedRaw = this.readAnnotUnrotatedRect(annotPtr);
+          if (unrotatedRaw) continue;
+        }
+        const apModes = this.pdfiumModule.EPDFAnnot_GetAvailableAppearanceModes(annotPtr);
+        if (!apModes) continue;
+        const appearances = {};
+        const modesToRender = [
+          { bit: AP_MODE_NORMAL, mode: AppearanceMode.Normal, key: "normal" },
+          { bit: AP_MODE_ROLLOVER, mode: AppearanceMode.Rollover, key: "rollover" },
+          { bit: AP_MODE_DOWN, mode: AppearanceMode.Down, key: "down" }
+        ];
+        for (const { bit, mode, key } of modesToRender) {
+          if (!(apModes & bit)) continue;
+          const rendered = this.renderSingleAnnotAppearance(
+            doc,
+            page,
+            pageCtx,
+            annotPtr,
+            mode,
+            rotation,
+            finalScale
+          );
+          if (rendered) {
+            appearances[key] = rendered;
+          }
+        }
+        if (appearances.normal || appearances.rollover || appearances.down) {
+          result[nm] = appearances;
+        }
+      } finally {
+        this.pdfiumModule.FPDFPage_CloseAnnot(annotPtr);
+      }
+    }
+    pageCtx.release();
+    this.logger.perf(
+      LOG_SOURCE,
+      LOG_CATEGORY,
+      "RenderPageAnnotationsRaw",
+      "End",
+      `${doc.id}-${page.index}`
+    );
+    const task = new Task();
+    task.resolve(result);
+    return task;
+  }
+  /**
+   * Render a single annotation's appearance for a given mode.
+   * Returns the image data and rect, or null on failure.
+   * @private
+   */
+  renderSingleAnnotAppearance(doc, page, pageCtx, annotPtr, mode, rotation, finalScale) {
+    const pageRect = this.readPageAnnoRect(annotPtr);
+    const annotRect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const rect = toIntRect(annotRect);
+    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);
+    const stride = wDev * 4;
+    const bytes = stride * hDev;
+    const heapPtr = this.memoryManager.malloc(bytes);
+    const bitmapPtr = this.pdfiumModule.FPDFBitmap_CreateEx(
+      wDev,
+      hDev,
+      4,
+      heapPtr,
+      stride
+    );
+    this.pdfiumModule.FPDFBitmap_FillRect(bitmapPtr, 0, 0, wDev, hDev, 0);
+    const M = buildUserToDeviceMatrix(rect, rotation, wDev, hDev);
+    const mPtr = this.memoryManager.malloc(6 * 4);
+    const mView = new Float32Array(this.pdfiumModule.pdfium.HEAPF32.buffer, mPtr, 6);
+    mView.set([M.a, M.b, M.c, M.d, M.e, M.f]);
+    const FLAGS = 16;
+    let ok = false;
+    try {
+      ok = !!this.pdfiumModule.EPDF_RenderAnnotBitmap(
+        bitmapPtr,
+        pageCtx.pagePtr,
+        annotPtr,
+        mode,
+        mPtr,
+        FLAGS
+      );
+    } finally {
+      this.memoryManager.free(mPtr);
+      this.pdfiumModule.FPDFBitmap_Destroy(bitmapPtr);
+    }
+    if (!ok) {
+      this.memoryManager.free(heapPtr);
+      return null;
+    }
+    const data = this.pdfiumModule.pdfium.HEAPU8.subarray(heapPtr, heapPtr + bytes);
+    const imageData = {
+      data: new Uint8ClampedArray(data),
+      width: wDev,
+      height: hDev
+    };
+    this.memoryManager.free(heapPtr);
+    return { data: imageData, rect: annotRect };
+  }
   renderRectEncoded(doc, page, rect, options) {
     const task = new Task();
     const rotation = (options == null ? void 0 : options.rotation) ?? Rotation.Degree0;
@@ -8264,4 +8548,4 @@ export {
   isValidCustomKey as i,
   readArrayBuffer as r
 };
-//# sourceMappingURL=direct-engine-CmsmBgWP.js.map
+//# sourceMappingURL=direct-engine-BOkKwXM0.js.map