@embedpdf/engines 1.0.13 → 1.0.15

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

@@ -1,4 +1,4 @@
-import { NoopLogger, PdfTaskHelper, PdfErrorCode, Rotation, Task, PdfAnnotationSubtype, stripPdfUnwantedMarkers, PdfAnnotationBorderStyle, dateToPdfDate, PdfAnnotationColorType, PdfAnnotationLineEnding, PdfPageObjectType, pdfAlphaColorToWebAlphaColor, webAlphaColorToPdfAlphaColor, quadToRect, pdfDateToDate, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, toIntRect, transformRect, makeMatrix, toIntSize, transformSize, PdfActionType, PdfZoomMode, MatchFlag, rectToQuad } from "@embedpdf/models";
+import { NoopLogger, PdfTaskHelper, PdfErrorCode, Rotation, Task, PdfAnnotationSubtype, stripPdfUnwantedMarkers, PdfAnnotationBorderStyle, dateToPdfDate, PdfAnnotationColorType, PdfAnnotationLineEnding, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, quadToRect, pdfDateToDate, PdfStandardFont, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, toIntRect, transformRect, makeMatrix, toIntSize, transformSize, PdfActionType, PdfZoomMode, MatchFlag, rectToQuad } from "@embedpdf/models";
 function readString(wasmModule, readChars, parseChars, defaultLength = 100) {
   let buffer = wasmModule.wasmExports.malloc(defaultLength);
   for (let i = 0; i < defaultLength; i++) {
@@ -913,7 +913,7 @@ class PdfiumEngine {
    *
    * @public
    */
-  createPageAnnotation(doc, page, annotation) {
+  createPageAnnotation(doc, page, annotation, context) {
     this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "createPageAnnotation", doc, page, annotation);
     this.logger.perf(
       LOG_SOURCE,
@@ -978,10 +978,13 @@ class PdfiumEngine {
           page,
           pageCtx.pagePtr,
           annotationPtr,
-          annotation.rect,
-          annotation.contents
+          annotation,
+          context == null ? void 0 : context.imageData
         );
         break;
+      case PdfAnnotationSubtype.FREETEXT:
+        isSucceed = this.addFreeTextContent(page, pageCtx.pagePtr, annotationPtr, annotation);
+        break;
       case PdfAnnotationSubtype.LINE:
         isSucceed = this.addLineContent(page, pageCtx.pagePtr, annotationPtr, annotation);
         break;
@@ -1106,17 +1109,12 @@ class PdfiumEngine {
       }
       /* ── Stamp ───────────────────────────────────────────────────────────── */
       case PdfAnnotationSubtype.STAMP: {
-        for (let i = this.pdfiumModule.FPDFAnnot_GetObjectCount(annotPtr) - 1; i >= 0; i--) {
-          this.pdfiumModule.FPDFAnnot_RemoveObject(annotPtr, i);
-        }
-        ok = this.addStampContent(
-          ctx.docPtr,
-          page,
-          pageCtx.pagePtr,
-          annotPtr,
-          annotation.rect,
-          annotation.contents
-        );
+        ok = this.addStampContent(ctx.docPtr, page, pageCtx.pagePtr, annotPtr, annotation);
+        break;
+      }
+      /* ── Free text ────────────────────────────────────────────────────────── */
+      case PdfAnnotationSubtype.FREETEXT: {
+        ok = this.addFreeTextContent(page, pageCtx.pagePtr, annotPtr, annotation);
         break;
       }
       /* ── Shape ───────────────────────────────────────────────────────────── */
@@ -1920,6 +1918,55 @@ class PdfiumEngine {
   free(ptr) {
     this.pdfiumModule.pdfium.wasmExports.free(ptr);
   }
+  addFreeTextContent(page, pagePtr, annotationPtr, annotation) {
+    if (!this.setBorderStyle(annotationPtr, PdfAnnotationBorderStyle.SOLID, 0)) {
+      return false;
+    }
+    if (!this.setAnnotString(annotationPtr, "Contents", annotation.contents ?? "")) {
+      return false;
+    }
+    if (!this.setPageAnnoRect(page, pagePtr, annotationPtr, annotation.rect)) {
+      return false;
+    }
+    if (!this.setAnnotString(annotationPtr, "T", annotation.author || "")) {
+      return false;
+    }
+    if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
+      return false;
+    }
+    if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
+      return false;
+    }
+    if (!this.setAnnotationTextAlignment(annotationPtr, annotation.textAlign)) {
+      return false;
+    }
+    if (!this.setAnnotationVerticalAlignment(annotationPtr, annotation.verticalAlign)) {
+      return false;
+    }
+    if (!this.setAnnotationDefaultAppearance(
+      annotationPtr,
+      annotation.fontFamily,
+      annotation.fontSize,
+      annotation.fontColor
+    )) {
+      return false;
+    }
+    if (annotation.intent && !this.setAnnotIntent(annotationPtr, annotation.intent)) {
+      return false;
+    }
+    if (!annotation.backgroundColor || annotation.backgroundColor === "transparent") {
+      if (!this.pdfiumModule.EPDFAnnot_ClearColor(annotationPtr, PdfAnnotationColorType.Color)) {
+        return false;
+      }
+    } else if (!this.setAnnotationColor(
+      annotationPtr,
+      annotation.backgroundColor ?? "#FFFFFF",
+      PdfAnnotationColorType.Color
+    )) {
+      return false;
+    }
+    return true;
+  }
   /**
    * Set the rect of specified annotation
    * @param page - page info that the annotation is belonged to
@@ -1946,12 +1993,12 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
       return false;
     }
+    if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
+      return false;
+    }
     if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.color ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.color ?? "#FFFF00",
       PdfAnnotationColorType.Color
     )) {
       return false;
@@ -2012,20 +2059,17 @@ class PdfiumEngine {
       }
     } else if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.color ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.color ?? "#FFFF00",
       PdfAnnotationColorType.InteriorColor
     )) {
       return false;
     }
+    if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
+      return false;
+    }
     if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.strokeColor ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.strokeColor ?? "#FFFF00",
       PdfAnnotationColorType.Color
     )) {
       return false;
@@ -2081,20 +2125,17 @@ class PdfiumEngine {
       }
     } else if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.color ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.color ?? "#FFFF00",
       PdfAnnotationColorType.InteriorColor
     )) {
       return false;
     }
+    if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
+      return false;
+    }
     if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.strokeColor ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.strokeColor ?? "#FFFF00",
       PdfAnnotationColorType.Color
     )) {
       return false;
@@ -2139,20 +2180,17 @@ class PdfiumEngine {
       }
     } else if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.color ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.color ?? "#FFFF00",
       PdfAnnotationColorType.InteriorColor
     )) {
       return false;
     }
+    if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
+      return false;
+    }
     if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.strokeColor ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.strokeColor ?? "#FFFF00",
       PdfAnnotationColorType.Color
     )) {
       return false;
@@ -2184,12 +2222,12 @@ class PdfiumEngine {
     if (!this.setAnnotString(annotationPtr, "M", dateToPdfDate(annotation.modified))) {
       return false;
     }
+    if (!this.setAnnotationOpacity(annotationPtr, annotation.opacity ?? 1)) {
+      return false;
+    }
     if (!this.setAnnotationColor(
       annotationPtr,
-      {
-        color: annotation.color ?? "#FFFF00",
-        opacity: annotation.opacity ?? 1
-      },
+      annotation.color ?? "#FFFF00",
       PdfAnnotationColorType.Color
     )) {
       return false;
@@ -2208,21 +2246,21 @@ class PdfiumEngine {
    *
    * @private
    */
-  addStampContent(docPtr, page, pagePtr, annotationPtr, rect, contents) {
-    for (const content of contents) {
-      switch (content.type) {
-        case PdfPageObjectType.IMAGE:
-          return this.addImageObject(
-            docPtr,
-            page,
-            pagePtr,
-            annotationPtr,
-            rect.origin,
-            content.imageData
-          );
+  addStampContent(docPtr, page, pagePtr, annotationPtr, annotation, imageData) {
+    if (imageData) {
+      for (let i = this.pdfiumModule.FPDFAnnot_GetObjectCount(annotationPtr) - 1; i >= 0; i--) {
+        this.pdfiumModule.FPDFAnnot_RemoveObject(annotationPtr, i);
       }
+      return this.addImageObject(
+        docPtr,
+        page,
+        pagePtr,
+        annotationPtr,
+        annotation.rect.origin,
+        imageData
+      );
     }
-    return false;
+    return true;
   }
   /**
    * Add image object to annotation
@@ -2292,14 +2330,18 @@ class PdfiumEngine {
       return false;
     }
     this.free(matrixPtr);
-    this.pdfiumModule.FPDFPageObj_Transform(imageObjectPtr, 1, 0, 0, 1, position.x, position.y);
+    const pagePos = this.convertDevicePointToPagePoint(page, {
+      x: position.x,
+      y: position.y + imageData.height
+      // shift down by the image height
+    });
+    this.pdfiumModule.FPDFPageObj_Transform(imageObjectPtr, 1, 0, 0, 1, pagePos.x, pagePos.y);
     if (!this.pdfiumModule.FPDFAnnot_AppendObject(annotationPtr, imageObjectPtr)) {
       this.pdfiumModule.FPDFBitmap_Destroy(bitmapPtr);
       this.pdfiumModule.FPDFPageObj_Destroy(imageObjectPtr);
       this.free(bitmapBufferPtr);
       return false;
     }
-    this.pdfiumModule.FPDFPage_GenerateContent(pagePtr);
     this.pdfiumModule.FPDFBitmap_Destroy(bitmapPtr);
     this.free(bitmapBufferPtr);
     return true;
@@ -2953,41 +2995,32 @@ class PdfiumEngine {
     const rPtr = this.malloc(4);
     const gPtr = this.malloc(4);
     const bPtr = this.malloc(4);
-    const aPtr = this.malloc(4);
-    const ok = this.pdfiumModule.EPDFAnnot_GetColor(
-      annotationPtr,
-      colorType,
-      rPtr,
-      gPtr,
-      bPtr,
-      aPtr
-    );
+    const ok = this.pdfiumModule.EPDFAnnot_GetColor(annotationPtr, colorType, rPtr, gPtr, bPtr);
     let colour;
     if (ok) {
       colour = {
         red: this.pdfiumModule.pdfium.getValue(rPtr, "i32") & 255,
         green: this.pdfiumModule.pdfium.getValue(gPtr, "i32") & 255,
-        blue: this.pdfiumModule.pdfium.getValue(bPtr, "i32") & 255,
-        alpha: this.pdfiumModule.pdfium.getValue(aPtr, "i32") & 255
-        // 0 = transparent, 255 = opaque
+        blue: this.pdfiumModule.pdfium.getValue(bPtr, "i32") & 255
       };
     }
     this.free(rPtr);
     this.free(gPtr);
     this.free(bPtr);
-    this.free(aPtr);
     return colour;
   }
-  // 2) Implementation
-  resolveAnnotationColor(annotationPtr, colorType = PdfAnnotationColorType.Color, fallback) {
+  /**
+   * Get the fill/stroke colour annotation.
+   *
+   * @param annotationPtr - pointer to the annotation whose colour is being set
+   * @param colorType - which colour to get (0 = fill, 1 = stroke)
+   * @returns WebColor with hex color
+   *
+   * @private
+   */
+  getAnnotationColor(annotationPtr, colorType = PdfAnnotationColorType.Color) {
     const annotationColor = this.readAnnotationColor(annotationPtr, colorType);
-    if (annotationColor) {
-      return pdfAlphaColorToWebAlphaColor(annotationColor);
-    }
-    if (fallback !== void 0) {
-      return pdfAlphaColorToWebAlphaColor(fallback);
-    }
-    return void 0;
+    return annotationColor ? pdfColorToWebColor(annotationColor) : void 0;
   }
   /**
    * Set the fill/stroke colour for a **Highlight / Underline / StrikeOut / Squiggly** markup annotation.
@@ -3000,15 +3033,143 @@ class PdfiumEngine {
    *
    * @private
    */
-  setAnnotationColor(annotationPtr, webAlphaColor, colorType = PdfAnnotationColorType.Color) {
-    const pdfAlphaColor = webAlphaColorToPdfAlphaColor(webAlphaColor);
+  setAnnotationColor(annotationPtr, webColor, colorType = PdfAnnotationColorType.Color) {
+    const pdfColor = webColorToPdfColor(webColor);
     return this.pdfiumModule.EPDFAnnot_SetColor(
       annotationPtr,
       colorType,
-      pdfAlphaColor.red & 255,
-      pdfAlphaColor.green & 255,
-      pdfAlphaColor.blue & 255,
-      (pdfAlphaColor.alpha ?? 255) & 255
+      pdfColor.red & 255,
+      pdfColor.green & 255,
+      pdfColor.blue & 255
+    );
+  }
+  /**
+   * Get the opacity of the annotation.
+   *
+   * @param annotationPtr - pointer to the annotation whose opacity is being set
+   * @returns opacity (0-1)
+   *
+   * @private
+   */
+  getAnnotationOpacity(annotationPtr) {
+    const opacityPtr = this.malloc(4);
+    const ok = this.pdfiumModule.EPDFAnnot_GetOpacity(annotationPtr, opacityPtr);
+    const opacity = ok ? this.pdfiumModule.pdfium.getValue(opacityPtr, "i32") : 255;
+    this.free(opacityPtr);
+    return pdfAlphaToWebOpacity(opacity);
+  }
+  /**
+   * Set the opacity of the annotation.
+   *
+   * @param annotationPtr - pointer to the annotation whose opacity is being set
+   * @param opacity - opacity (0-1)
+   * @returns true on success
+   *
+   * @private
+   */
+  setAnnotationOpacity(annotationPtr, opacity) {
+    const pdfOpacity = webOpacityToPdfAlpha(opacity);
+    return this.pdfiumModule.EPDFAnnot_SetOpacity(annotationPtr, pdfOpacity & 255);
+  }
+  /**
+   * Fetch the `/Q` text-alignment value from a **FreeText** annotation.
+   *
+   * @param annotationPtr pointer returned by `FPDFPage_GetAnnot`
+   * @returns `PdfTextAlignment`
+   */
+  getAnnotationTextAlignment(annotationPtr) {
+    return this.pdfiumModule.EPDFAnnot_GetTextAlignment(annotationPtr);
+  }
+  /**
+   * Write the `/Q` text-alignment value into a **FreeText** annotation
+   * and clear the existing appearance stream so it can be regenerated.
+   *
+   * @param annotationPtr pointer returned by `FPDFPage_GetAnnot`
+   * @param alignment     `PdfTextAlignment`
+   * @returns `true` on success
+   */
+  setAnnotationTextAlignment(annotationPtr, alignment) {
+    return !!this.pdfiumModule.EPDFAnnot_SetTextAlignment(annotationPtr, alignment);
+  }
+  /**
+   * Fetch the `/EPDF:VerticalAlignment` vertical-alignment value from a **FreeText** annotation.
+   *
+   * @param annotationPtr pointer returned by `FPDFPage_GetAnnot`
+   * @returns `PdfVerticalAlignment`
+   */
+  getAnnotationVerticalAlignment(annotationPtr) {
+    return this.pdfiumModule.EPDFAnnot_GetVerticalAlignment(annotationPtr);
+  }
+  /**
+   * Write the `/EPDF:VerticalAlignment` vertical-alignment value into a **FreeText** annotation
+   * and clear the existing appearance stream so it can be regenerated.
+   *
+   * @param annotationPtr pointer returned by `FPDFPage_GetAnnot`
+   * @param alignment     `PdfVerticalAlignment`
+   * @returns `true` on success
+   */
+  setAnnotationVerticalAlignment(annotationPtr, alignment) {
+    return !!this.pdfiumModule.EPDFAnnot_SetVerticalAlignment(annotationPtr, alignment);
+  }
+  /**
+   * Return the **default appearance** (font, size, colour) declared in the
+   * `/DA` string of a **FreeText** annotation.
+   *
+   * @param annotationPtr  pointer to `FPDF_ANNOTATION`
+   * @returns `{ font, fontSize, color }` or `undefined` when PDFium returns false
+   *
+   * NOTE – `font` is the raw `FPDF_STANDARD_FONT` enum value that PDFium uses
+   *        (same range as the C API: 0 = Courier, 12 = ZapfDingbats, …).
+   */
+  getAnnotationDefaultAppearance(annotationPtr) {
+    const fontPtr = this.malloc(4);
+    const sizePtr = this.malloc(4);
+    const rPtr = this.malloc(4);
+    const gPtr = this.malloc(4);
+    const bPtr = this.malloc(4);
+    const ok = !!this.pdfiumModule.EPDFAnnot_GetDefaultAppearance(
+      annotationPtr,
+      fontPtr,
+      sizePtr,
+      rPtr,
+      gPtr,
+      bPtr
+    );
+    if (!ok) {
+      [fontPtr, sizePtr, rPtr, gPtr, bPtr].forEach((p) => this.free(p));
+      return;
+    }
+    const pdf = this.pdfiumModule.pdfium;
+    const font = pdf.getValue(fontPtr, "i32");
+    const fontSize = pdf.getValue(sizePtr, "float");
+    const red = pdf.getValue(rPtr, "i32") & 255;
+    const green = pdf.getValue(gPtr, "i32") & 255;
+    const blue = pdf.getValue(bPtr, "i32") & 255;
+    [fontPtr, sizePtr, rPtr, gPtr, bPtr].forEach((p) => this.free(p));
+    return {
+      fontFamily: font,
+      fontSize,
+      fontColor: pdfColorToWebColor({ red, green, blue })
+    };
+  }
+  /**
+   * Write a **default appearance** (`/DA`) into a FreeText annotation.
+   *
+   * @param annotationPtr pointer to `FPDF_ANNOTATION`
+   * @param font          `FPDF_STANDARD_FONT` enum value
+   * @param fontSize      size in points (≥ 0)
+   * @param color         CSS-style `#rrggbb` string (alpha ignored)
+   * @returns `true` on success
+   */
+  setAnnotationDefaultAppearance(annotationPtr, font, fontSize, color) {
+    const { red, green, blue } = webColorToPdfColor(color);
+    return !!this.pdfiumModule.EPDFAnnot_SetDefaultAppearance(
+      annotationPtr,
+      font,
+      fontSize,
+      red & 255,
+      green & 255,
+      blue & 255
     );
   }
   /**
@@ -3397,14 +3558,18 @@ class PdfiumEngine {
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const state = this.getAnnotString(annotationPtr, "State");
     const stateModel = this.getAnnotString(annotationPtr, "StateModel");
-    const webAlphaColor = this.resolveAnnotationColor(annotationPtr);
+    const color = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     const inReplyToId = this.getInReplyToId(pagePtr, annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.TEXT,
+      flags,
       contents,
-      ...webAlphaColor,
+      color: color ?? "#FFFF00",
+      opacity,
       rect,
       inReplyToId,
       author,
@@ -3429,12 +3594,28 @@ class PdfiumEngine {
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
+    const defaultStyle = this.getAnnotString(annotationPtr, "DS");
+    const da = this.getAnnotationDefaultAppearance(annotationPtr);
+    const backgroundColor = this.getAnnotationColor(annotationPtr);
+    const textAlign = this.getAnnotationTextAlignment(annotationPtr);
+    const verticalAlign = this.getAnnotationVerticalAlignment(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     const modified = pdfDateToDate(modifiedRaw);
     const richContent = this.getAnnotRichContent(annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.FREETEXT,
+      fontFamily: (da == null ? void 0 : da.fontFamily) ?? PdfStandardFont.Unknown,
+      fontSize: (da == null ? void 0 : da.fontSize) ?? 12,
+      fontColor: (da == null ? void 0 : da.fontColor) ?? "#000000",
+      verticalAlign,
+      backgroundColor,
+      flags,
+      opacity,
+      textAlign,
+      defaultStyle,
       richContent,
       contents,
       author,
@@ -3465,6 +3646,7 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
+    const flags = this.getAnnotationFlags(annotationPtr);
     const utf16Length = this.pdfiumModule.FPDFText_GetBoundedText(
       textPagePtr,
       left,
@@ -3500,6 +3682,7 @@ class PdfiumEngine {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.LINK,
+      flags,
       text,
       target,
       rect,
@@ -3524,11 +3707,13 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
+    const flags = this.getAnnotationFlags(annotationPtr);
     const field = this.readPdfWidgetAnnoField(formHandle, annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.WIDGET,
+      flags,
       rect,
       field,
       author,
@@ -3551,10 +3736,12 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.FILEATTACHMENT,
+      flags,
       rect,
       author,
       modified
@@ -3576,19 +3763,23 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
-    const webAlphaColor = this.resolveAnnotationColor(annotationPtr);
+    const color = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     const { width: strokeWidth } = this.getBorderStyle(annotationPtr);
     const inkList = this.getInkList(page, annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
     const intent = this.getAnnotIntent(annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.INK,
       ...intent && { intent },
       blendMode,
-      ...webAlphaColor,
-      strokeWidth,
+      flags,
+      color: color ?? "#FF0000",
+      opacity,
+      strokeWidth: strokeWidth === 0 ? 1 : strokeWidth,
       rect,
       inkList,
       author,
@@ -3613,12 +3804,13 @@ class PdfiumEngine {
     const modified = pdfDateToDate(modifiedRaw);
     const vertices = this.readPdfAnnoVertices(page, pagePtr, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
-    const strokeColor = this.resolveAnnotationColor(annotationPtr);
-    const interiorColor = this.resolveAnnotationColor(
+    const flags = this.getAnnotationFlags(annotationPtr);
+    const strokeColor = this.getAnnotationColor(annotationPtr);
+    const interiorColor = this.getAnnotationColor(
       annotationPtr,
-      PdfAnnotationColorType.InteriorColor,
-      void 0
+      PdfAnnotationColorType.InteriorColor
     );
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     let { style: strokeStyle, width: strokeWidth } = this.getBorderStyle(annotationPtr);
     let strokeDashArray;
     if (strokeStyle === PdfAnnotationBorderStyle.DASHED) {
@@ -3639,9 +3831,10 @@ class PdfiumEngine {
       id: index,
       type: PdfAnnotationSubtype.POLYGON,
       contents,
-      strokeColor: strokeColor.color,
-      color: (interiorColor == null ? void 0 : interiorColor.color) ?? "transparent",
-      opacity: (interiorColor == null ? void 0 : interiorColor.opacity) ?? strokeColor.opacity,
+      flags,
+      strokeColor: strokeColor ?? "#FF0000",
+      color: interiorColor ?? "transparent",
+      opacity,
       strokeWidth: strokeWidth === 0 ? 1 : strokeWidth,
       strokeStyle,
       strokeDashArray,
@@ -3669,12 +3862,13 @@ class PdfiumEngine {
     const modified = pdfDateToDate(modifiedRaw);
     const vertices = this.readPdfAnnoVertices(page, pagePtr, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
-    const strokeColor = this.resolveAnnotationColor(annotationPtr);
-    const interiorColor = this.resolveAnnotationColor(
+    const strokeColor = this.getAnnotationColor(annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
+    const interiorColor = this.getAnnotationColor(
       annotationPtr,
-      PdfAnnotationColorType.InteriorColor,
-      void 0
+      PdfAnnotationColorType.InteriorColor
     );
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     let { style: strokeStyle, width: strokeWidth } = this.getBorderStyle(annotationPtr);
     let strokeDashArray;
     if (strokeStyle === PdfAnnotationBorderStyle.DASHED) {
@@ -3689,9 +3883,10 @@ class PdfiumEngine {
       id: index,
       type: PdfAnnotationSubtype.POLYLINE,
       contents,
-      strokeColor: strokeColor.color,
-      color: (interiorColor == null ? void 0 : interiorColor.color) ?? "transparent",
-      opacity: (interiorColor == null ? void 0 : interiorColor.opacity) ?? strokeColor.opacity,
+      flags,
+      strokeColor: strokeColor ?? "#FF0000",
+      color: interiorColor ?? "transparent",
+      opacity,
       strokeWidth: strokeWidth === 0 ? 1 : strokeWidth,
       strokeStyle,
       strokeDashArray,
@@ -3721,12 +3916,13 @@ class PdfiumEngine {
     const linePoints = this.getLinePoints(annotationPtr, page);
     const lineEndings = this.getLineEndings(annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
-    const strokeColor = this.resolveAnnotationColor(annotationPtr);
-    const interiorColor = this.resolveAnnotationColor(
+    const strokeColor = this.getAnnotationColor(annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
+    const interiorColor = this.getAnnotationColor(
       annotationPtr,
-      PdfAnnotationColorType.InteriorColor,
-      void 0
+      PdfAnnotationColorType.InteriorColor
     );
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     let { style: strokeStyle, width: strokeWidth } = this.getBorderStyle(annotationPtr);
     let strokeDashArray;
     if (strokeStyle === PdfAnnotationBorderStyle.DASHED) {
@@ -3739,14 +3935,15 @@ class PdfiumEngine {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.LINE,
+      flags,
       rect,
       contents,
       strokeWidth: strokeWidth === 0 ? 1 : strokeWidth,
       strokeStyle,
       strokeDashArray,
-      strokeColor: strokeColor.color,
-      color: (interiorColor == null ? void 0 : interiorColor.color) ?? "transparent",
-      opacity: (interiorColor == null ? void 0 : interiorColor.opacity) ?? strokeColor.opacity,
+      strokeColor: strokeColor ?? "#FF0000",
+      color: interiorColor ?? "transparent",
+      opacity,
       linePoints: linePoints || { start: { x: 0, y: 0 }, end: { x: 0, y: 0 } },
       lineEndings: lineEndings || {
         start: PdfAnnotationLineEnding.None,
@@ -3770,21 +3967,25 @@ class PdfiumEngine {
     const pageRect = this.readPageAnnoRect(annotationPtr);
     const rect = this.convertPageRectToDeviceRect(page, pagePtr, pageRect);
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
-    const webAlphaColor = this.resolveAnnotationColor(annotationPtr);
+    const color = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.HIGHLIGHT,
       rect,
+      flags,
       contents,
       segmentRects,
-      ...webAlphaColor,
+      color: color ?? "#FFFF00",
+      opacity,
       author,
       modified
     };
@@ -3807,17 +4008,21 @@ class PdfiumEngine {
     const modified = pdfDateToDate(modifiedRaw);
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
-    const webAlphaColor = this.resolveAnnotationColor(annotationPtr);
+    const color = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.UNDERLINE,
       rect,
+      flags,
       contents,
       segmentRects,
-      ...webAlphaColor,
+      color: color ?? "#FF0000",
+      opacity,
       author,
       modified
     };
@@ -3840,17 +4045,21 @@ class PdfiumEngine {
     const modified = pdfDateToDate(modifiedRaw);
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
-    const webAlphaColor = this.resolveAnnotationColor(annotationPtr);
+    const color = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.STRIKEOUT,
+      flags,
       rect,
       contents,
       segmentRects,
-      ...webAlphaColor,
+      color: color ?? "#FF0000",
+      opacity,
       author,
       modified
     };
@@ -3873,17 +4082,21 @@ class PdfiumEngine {
     const modified = pdfDateToDate(modifiedRaw);
     const segmentRects = this.getQuadPointsAnno(page, annotationPtr);
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
-    const webAlphaColor = this.resolveAnnotationColor(annotationPtr);
+    const color = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     const blendMode = this.pdfiumModule.EPDFAnnot_GetBlendMode(annotationPtr);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       blendMode,
       type: PdfAnnotationSubtype.SQUIGGLY,
       rect,
+      flags,
       contents,
       segmentRects,
-      ...webAlphaColor,
+      color: color ?? "#FF0000",
+      opacity,
       author,
       modified
     };
@@ -3904,11 +4117,13 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.CARET,
       rect,
+      flags,
       author,
       modified
     };
@@ -3930,23 +4145,15 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
-    const contents = [];
-    const objectCount = this.pdfiumModule.FPDFAnnot_GetObjectCount(annotationPtr);
-    for (let i = 0; i < objectCount; i++) {
-      const annotationObjectPtr = this.pdfiumModule.FPDFAnnot_GetObject(annotationPtr, i);
-      const pageObj = this.readPdfPageObject(annotationObjectPtr);
-      if (pageObj) {
-        contents.push(pageObj);
-      }
-    }
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.STAMP,
       rect,
-      contents,
       author,
-      modified
+      modified,
+      flags
     };
   }
   /**
@@ -4113,6 +4320,25 @@ class PdfiumEngine {
     this.free(matrixPtr);
     return { a: 1, b: 0, c: 0, d: 1, e: 0, f: 0 };
   }
+  /**
+   * Read contents of a stamp annotation
+   * @param annotationPtr - pointer to pdf annotation
+   * @returns contents of the stamp annotation
+   *
+   * @private
+   */
+  readStampAnnotationContents(annotationPtr) {
+    const contents = [];
+    const objectCount = this.pdfiumModule.FPDFAnnot_GetObjectCount(annotationPtr);
+    for (let i = 0; i < objectCount; i++) {
+      const annotationObjectPtr = this.pdfiumModule.FPDFAnnot_GetObject(annotationPtr, i);
+      const pageObj = this.readPdfPageObject(annotationObjectPtr);
+      if (pageObj) {
+        contents.push(pageObj);
+      }
+    }
+    return contents;
+  }
   /**
    * Return the stroke-width declared in the annotation’s /Border or /BS entry.
    * Falls back to 1 pt when nothing is defined.
@@ -4166,12 +4392,12 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
-    const interiorColor = this.resolveAnnotationColor(
+    const interiorColor = this.getAnnotationColor(
       annotationPtr,
-      PdfAnnotationColorType.InteriorColor,
-      void 0
+      PdfAnnotationColorType.InteriorColor
     );
-    const { color: strokeColor, opacity: strokeOpacity } = this.resolveAnnotationColor(annotationPtr);
+    const strokeColor = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     let { style: strokeStyle, width: strokeWidth } = this.getBorderStyle(annotationPtr);
     let strokeDashArray;
     if (strokeStyle === PdfAnnotationBorderStyle.DASHED) {
@@ -4185,10 +4411,10 @@ class PdfiumEngine {
       id: index,
       type: PdfAnnotationSubtype.CIRCLE,
       flags,
-      color: (interiorColor == null ? void 0 : interiorColor.color) ?? "transparent",
-      opacity: (interiorColor == null ? void 0 : interiorColor.opacity) ?? strokeOpacity,
+      color: interiorColor ?? "transparent",
+      opacity,
       strokeWidth,
-      strokeColor,
+      strokeColor: strokeColor ?? "#FF0000",
       strokeStyle,
       rect,
       author,
@@ -4213,12 +4439,12 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
-    const interiorColor = this.resolveAnnotationColor(
+    const interiorColor = this.getAnnotationColor(
       annotationPtr,
-      PdfAnnotationColorType.InteriorColor,
-      void 0
+      PdfAnnotationColorType.InteriorColor
     );
-    const { color: strokeColor, opacity: strokeOpacity } = this.resolveAnnotationColor(annotationPtr);
+    const strokeColor = this.getAnnotationColor(annotationPtr);
+    const opacity = this.getAnnotationOpacity(annotationPtr);
     let { style: strokeStyle, width: strokeWidth } = this.getBorderStyle(annotationPtr);
     let strokeDashArray;
     if (strokeStyle === PdfAnnotationBorderStyle.DASHED) {
@@ -4232,9 +4458,9 @@ class PdfiumEngine {
       id: index,
       type: PdfAnnotationSubtype.SQUARE,
       flags,
-      color: (interiorColor == null ? void 0 : interiorColor.color) ?? "transparent",
-      opacity: (interiorColor == null ? void 0 : interiorColor.opacity) ?? strokeOpacity,
-      strokeColor,
+      color: interiorColor ?? "transparent",
+      opacity,
+      strokeColor: strokeColor ?? "#FF0000",
       strokeWidth,
       strokeStyle,
       rect,
@@ -4260,9 +4486,11 @@ class PdfiumEngine {
     const author = this.getAnnotString(annotationPtr, "T");
     const modifiedRaw = this.getAnnotString(annotationPtr, "M");
     const modified = pdfDateToDate(modifiedRaw);
+    const flags = this.getAnnotationFlags(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
+      flags,
       type,
       rect,
       author,
@@ -5069,70 +5297,6 @@ class PdfiumEngine {
     this.free(bufferPtr);
     return ap;
   }
-  /**
-   * Change the visible colour (and opacity) of an existing annotation.
-   *
-   * For markup annotations (highlight / underline / strikeout / squiggly) we
-   * first clear the AP dictionary entry, otherwise the stored appearance stream
-   * will override the new tint.  For all other sub-types we keep the existing
-   * AP so custom artwork isn't lost.
-   *
-   * @param doc         logical document object
-   * @param page        logical page object
-   * @param annotation  the annotation we want to recolour
-   * @param colour      RGBA tuple (0-255 per channel)
-   * @param which       0 = stroke/fill colour  (PDFium's "colourType" param)
-   *
-   * @returns `true` when the operation succeeded
-   */
-  updateAnnotationColor(doc, page, annotation, color, which = 0) {
-    this.logger.debug(
-      LOG_SOURCE,
-      LOG_CATEGORY,
-      "setAnnotationColor",
-      doc,
-      page,
-      annotation,
-      color,
-      which
-    );
-    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor", "Begin", doc.id);
-    const task = PdfTaskHelper.create();
-    try {
-      const ctx = this.cache.getContext(doc.id);
-      if (!ctx) {
-        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor", "End", doc.id);
-        this.logger.warn(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor: doc closed");
-        task.resolve(false);
-        return task;
-      }
-      const pageCtx = ctx.acquirePage(page.index);
-      const annotPtr = this.pdfiumModule.FPDFPage_GetAnnot(pageCtx.pagePtr, annotation.id);
-      if (!annotPtr) {
-        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor", "End", doc.id);
-        this.logger.warn(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor: annot not found");
-        pageCtx.release();
-        task.resolve(false);
-        return task;
-      }
-      const ok = this.setAnnotationColor(annotPtr, color, which);
-      if (ok) {
-        this.pdfiumModule.FPDFPage_GenerateContent(pageCtx.pagePtr);
-      }
-      this.pdfiumModule.FPDFPage_CloseAnnot(annotPtr);
-      pageCtx.release();
-      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor", "End", doc.id);
-      task.resolve(!!ok);
-    } catch (error) {
-      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor", "End", doc.id);
-      this.logger.error(LOG_SOURCE, LOG_CATEGORY, "setAnnotationColor: error", error);
-      task.reject({
-        code: PdfErrorCode.Unknown,
-        message: `Failed to set annotation color: ${error instanceof Error ? error.message : String(error)}`
-      });
-    }
-    return task;
-  }
   /**
    * Set the rect of specified annotation
    * @param page - page info that the annotation is belonged to
@@ -5438,4 +5602,4 @@ export {
   readArrayBuffer as c,
   readString as r
 };
-//# sourceMappingURL=engine-B0ZTENqz.js.map
+//# sourceMappingURL=engine-B11yoQGd.js.map