@embedpdf/engines 2.10.0 → 2.11.0

package/dist/{direct-engine-4LZYs06h.js → direct-engine-cyecHjwI.js}

@@ -1,6 +1,6 @@
 import { init } from "@embedpdf/pdfium";
-import { Rotation, NoopLogger, PdfTaskHelper, PdfErrorCode, pdfDateToDate, PdfJavaScriptActionTrigger, PdfAnnotationSubtype, isUuidV4, uuidV4, PdfJavaScriptWidgetEventType, PDF_ANNOT_AACTION_EVENT, PDF_FORM_FIELD_TYPE, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationColorType, PdfAnnotationBorderStyle, PdfStandardFont, PDF_FORM_FIELD_FLAG, webColorToPdfColor, pdfColorToWebColor, PdfAnnotationLineEnding, PdfStampFit, PdfTrappedStatus, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, PdfAnnotationReplyType, dateToPdfDate, quadToRect, rectToQuad, PdfPageObjectType, flagsToNames, namesToFlags, 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-sORqXhQk.js";
+import { Rotation, NoopLogger, PdfTaskHelper, PdfErrorCode, pdfDateToDate, PdfJavaScriptActionTrigger, PdfAnnotationSubtype, isUuidV4, uuidV4, PdfJavaScriptWidgetEventType, PDF_ANNOT_AACTION_EVENT, PDF_FORM_FIELD_TYPE, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationName, PdfAnnotationColorType, PdfAnnotationBorderStyle, PdfStandardFont, PDF_FORM_FIELD_FLAG, webColorToPdfColor, pdfColorToWebColor, PdfAnnotationLineEnding, PdfStampFit, PdfTrappedStatus, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, PdfAnnotationReplyType, dateToPdfDate, quadToRect, rectToQuad, PdfPageObjectType, flagsToNames, namesToFlags, 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-Dj-haWhC.js";
 import { b as browserImageDataToBlobConverter } from "./browser-BISJ9naB.js";
 function readString(wasmModule, readChars, parseChars, defaultLength = 100) {
   let buffer = wasmModule.wasmExports.malloc(defaultLength);
@@ -125,8 +125,8 @@ class PdfCache {
   closeDocument(docId) {
     const ctx = this.docs.get(docId);
     if (!ctx) return false;
-    ctx.dispose();
     this.docs.delete(docId);
+    ctx.dispose();
     return true;
   }
   /** Close all documents */
@@ -164,6 +164,7 @@ class DocumentContext {
     this.filePtr = filePtr;
     this.docPtr = docPtr;
     this.memoryManager = memoryManager;
+    this.disposed = false;
     this.normalizeRotation = config.normalizeRotation;
     this.pageCache = new PageCache(pdfium, docPtr, config);
   }
@@ -185,6 +186,8 @@ class DocumentContext {
   }
   /** Tear down all pages + this document */
   dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
     this.pageCache.forceReleaseAll();
     this.pageCache.pdf.FPDF_CloseDocument(this.docPtr);
     this.memoryManager.free(WasmPointer(this.filePtr));
@@ -1127,6 +1130,36 @@ class PdfiumNative {
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `OpenDocumentBuffer`, "End", file.id);
     return PdfTaskHelper.resolve(pdfDoc);
   }
+  /**
+   * Create a new empty PDF document and register it in the cache.
+   *
+   * @param id - unique document identifier
+   * @returns task containing the empty PdfDocumentObject
+   */
+  createDocument(id) {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "createDocument", id);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "CreateDocument", "Begin", id);
+    const docPtr = this.pdfiumModule.FPDF_CreateNewDocument();
+    if (!docPtr) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "CreateDocument", "End", id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.CantCreateNewDoc,
+        message: "can not create new document"
+      });
+    }
+    const pdfDoc = {
+      id,
+      pageCount: 0,
+      pages: [],
+      isEncrypted: false,
+      isOwnerUnlocked: true,
+      permissions: 4294967295,
+      normalizedRotation: false
+    };
+    this.cache.setDocument(id, 0, docPtr, false);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "CreateDocument", "End", id);
+    return PdfTaskHelper.resolve(pdfDoc);
+  }
   /**
    * {@inheritDoc @embedpdf/models!PdfEngine.getMetadata}
    *
@@ -1807,7 +1840,7 @@ class PdfiumNative {
           pageCtx.pagePtr,
           annotationPtr,
           saveAnnotation,
-          context == null ? void 0 : context.imageData
+          context
         );
         break;
       case PdfAnnotationSubtype.TEXT:
@@ -2969,6 +3002,115 @@ class PdfiumNative {
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `ExtractPages`, "End", doc.id);
     return PdfTaskHelper.resolve(buffer);
   }
+  /**
+   * Import pages from a source document into a destination document.
+   *
+   * @param destDoc - destination document (must be open in cache)
+   * @param srcDoc - source document (must be open in cache)
+   * @param srcPageIndices - zero-based page indices in the source document
+   * @param insertIndex - position to insert at in destination (defaults to end)
+   * @returns task containing the newly added PdfPageObjects
+   */
+  importPages(destDoc, srcDoc, srcPageIndices, insertIndex) {
+    this.logger.debug(
+      LOG_SOURCE,
+      LOG_CATEGORY,
+      "importPages",
+      destDoc.id,
+      srcDoc.id,
+      srcPageIndices
+    );
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "ImportPages", "Begin", destDoc.id);
+    const destCtx = this.cache.getContext(destDoc.id);
+    if (!destCtx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "ImportPages", "End", destDoc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "destination document is not open"
+      });
+    }
+    const srcCtx = this.cache.getContext(srcDoc.id);
+    if (!srcCtx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "ImportPages", "End", destDoc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "source document is not open"
+      });
+    }
+    const destInsertIndex = insertIndex ?? this.pdfiumModule.FPDF_GetPageCount(destCtx.docPtr);
+    const indicesPtr = this.memoryManager.malloc(srcPageIndices.length * 4);
+    for (let i = 0; i < srcPageIndices.length; i++) {
+      this.pdfiumModule.pdfium.setValue(indicesPtr + i * 4, srcPageIndices[i], "i32");
+    }
+    if (!this.pdfiumModule.FPDF_ImportPagesByIndex(
+      destCtx.docPtr,
+      srcCtx.docPtr,
+      indicesPtr,
+      srcPageIndices.length,
+      destInsertIndex
+    )) {
+      this.memoryManager.free(indicesPtr);
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "ImportPages", "End", destDoc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.CantImportPages,
+        message: "can not import pages into destination document"
+      });
+    }
+    this.memoryManager.free(indicesPtr);
+    const newPages = [];
+    const sizePtr = this.memoryManager.malloc(8);
+    const normalizeRotation = destCtx.normalizeRotation;
+    for (let i = 0; i < srcPageIndices.length; i++) {
+      const newPageIndex = destInsertIndex + i;
+      const result = normalizeRotation ? this.pdfiumModule.EPDF_GetPageSizeByIndexNormalized(destCtx.docPtr, newPageIndex, sizePtr) : this.pdfiumModule.FPDF_GetPageSizeByIndexF(destCtx.docPtr, newPageIndex, sizePtr);
+      if (!result) {
+        this.memoryManager.free(sizePtr);
+        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "ImportPages", "End", destDoc.id);
+        return PdfTaskHelper.reject({
+          code: PdfErrorCode.Unknown,
+          message: `failed to read metadata for imported page ${newPageIndex}`
+        });
+      }
+      const rotation = this.pdfiumModule.EPDF_GetPageRotationByIndex(
+        destCtx.docPtr,
+        newPageIndex
+      );
+      newPages.push({
+        index: newPageIndex,
+        size: {
+          width: this.pdfiumModule.pdfium.getValue(sizePtr, "float"),
+          height: this.pdfiumModule.pdfium.getValue(sizePtr + 4, "float")
+        },
+        rotation
+      });
+    }
+    this.memoryManager.free(sizePtr);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "ImportPages", "End", destDoc.id);
+    return PdfTaskHelper.resolve(newPages);
+  }
+  deletePage(doc, pageIndex) {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "deletePage", doc.id, pageIndex);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "DeletePage", "Begin", doc.id);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "DeletePage", "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document is not open"
+      });
+    }
+    const pageCount = this.pdfiumModule.FPDF_GetPageCount(ctx.docPtr);
+    if (pageIndex < 0 || pageIndex >= pageCount) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "DeletePage", "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.CantDeletePage,
+        message: `page index ${pageIndex} out of range (0..${pageCount - 1})`
+      });
+    }
+    this.pdfiumModule.FPDFPage_Delete(ctx.docPtr, pageIndex);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "DeletePage", "End", doc.id);
+    return PdfTaskHelper.resolve(true);
+  }
   /**
    * {@inheritDoc @embedpdf/models!PdfEngine.extractText}
    *
@@ -3332,9 +3474,7 @@ class PdfiumNative {
   closeDocument(doc) {
     this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "closeDocument", doc);
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `CloseDocument`, "Begin", doc.id);
-    const ctx = this.cache.getContext(doc.id);
-    if (!ctx) return PdfTaskHelper.resolve(true);
-    ctx.dispose();
+    this.cache.closeDocument(doc.id);
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `CloseDocument`, "End", doc.id);
     return PdfTaskHelper.resolve(true);
   }
@@ -3361,7 +3501,10 @@ class PdfiumNative {
    * @private
    */
   addTextContent(doc, page, pagePtr, annotationPtr, annotation) {
-    if (!this.setAnnotationIcon(annotationPtr, annotation.icon || PdfAnnotationIcon.Comment)) {
+    if (!this.setAnnotationName(
+      annotationPtr,
+      annotation.name ?? annotation.icon ?? PdfAnnotationName.Comment
+    )) {
       return false;
     }
     if (annotation.state && !this.setAnnotString(annotationPtr, "State", annotation.state)) {
@@ -3956,18 +4099,28 @@ class PdfiumNative {
    *
    * @private
    */
-  addStampContent(doc, docPtr, page, pagePtr, annotationPtr, annotation, imageData) {
-    if (annotation.icon && !this.setAnnotationIcon(annotationPtr, annotation.icon)) {
-      return false;
-    }
-    if (annotation.subject && !this.setAnnotString(annotationPtr, "Subj", annotation.subject)) {
+  addStampContent(doc, docPtr, page, pagePtr, annotationPtr, annotation, context) {
+    const stampName = annotation.name ?? annotation.icon;
+    if (stampName && !this.setAnnotationName(annotationPtr, stampName)) {
       return false;
     }
-    if (imageData) {
+    if (context && "appearance" in context && context.appearance) {
+      if (!this.setAppearanceFromPdf(docPtr, annotationPtr, context.appearance)) {
+        return false;
+      }
+    } else if (context && "imageData" in context && context.imageData) {
       for (let i = this.pdfiumModule.FPDFAnnot_GetObjectCount(annotationPtr) - 1; i >= 0; i--) {
         this.pdfiumModule.FPDFAnnot_RemoveObject(annotationPtr, i);
       }
-      if (!this.addImageObject(doc, docPtr, page, pagePtr, annotationPtr, annotation.rect, imageData)) {
+      if (!this.addImageObject(
+        doc,
+        docPtr,
+        page,
+        pagePtr,
+        annotationPtr,
+        annotation.rect,
+        context.imageData
+      )) {
         return false;
       }
     }
@@ -3976,6 +4129,25 @@ class PdfiumNative {
     }
     return !!this.pdfiumModule.EPDFAnnot_UpdateAppearanceToRect(annotationPtr, PdfStampFit.Cover);
   }
+  /**
+   * Set an annotation's appearance from a single-page PDF document.
+   * Loads the PDF into WASM memory, calls the native SetAppearanceFromPage,
+   * then cleans up.
+   */
+  setAppearanceFromPdf(docPtr, annotationPtr, appearance) {
+    const data = new Uint8Array(appearance);
+    const filePtr = this.memoryManager.malloc(data.byteLength);
+    this.pdfiumModule.pdfium.HEAPU8.set(data, filePtr);
+    const tempDocPtr = this.pdfiumModule.FPDF_LoadMemDocument(filePtr, data.byteLength, "");
+    if (!tempDocPtr) {
+      this.memoryManager.free(filePtr);
+      return false;
+    }
+    const ok = this.pdfiumModule.EPDFAnnot_SetAppearanceFromPage(annotationPtr, tempDocPtr, 0);
+    this.pdfiumModule.FPDF_CloseDocument(tempDocPtr);
+    this.memoryManager.free(filePtr);
+    return !!ok;
+  }
   /**
    * Add image object to annotation
    * @param doc - pdf document object
@@ -5635,23 +5807,23 @@ class PdfiumNative {
     return this.pdfiumModule.EPDFAnnot_SetBorderStyle(annotationPtr, style, width);
   }
   /**
-   * Get the icon of the annotation
+   * Get the /Name entry of the annotation
    *
    * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
-   * @returns `PdfAnnotationIcon`
+   * @returns `PdfAnnotationName`
    */
-  getAnnotationIcon(annotationPtr) {
-    return this.pdfiumModule.EPDFAnnot_GetIcon(annotationPtr);
+  getAnnotationName(annotationPtr) {
+    return this.pdfiumModule.EPDFAnnot_GetName(annotationPtr);
   }
   /**
-   * Set the icon of the annotation
+   * Set the /Name entry of the annotation
    *
    * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
-   * @param icon - `PdfAnnotationIcon`
+   * @param name - `PdfAnnotationName`
    * @returns `true` on success
    */
-  setAnnotationIcon(annotationPtr, icon) {
-    return this.pdfiumModule.EPDFAnnot_SetIcon(annotationPtr, icon);
+  setAnnotationName(annotationPtr, name) {
+    return this.pdfiumModule.EPDFAnnot_SetName(annotationPtr, name);
   }
   /**
    * Get the reply type of the annotation (RT property per ISO 32000-2)
@@ -6225,6 +6397,143 @@ class PdfiumNative {
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
     return PdfTaskHelper.resolve(!!ok);
   }
+  /**
+   * Export an annotation's appearance as a standalone single-page PDF.
+   *
+   * @param doc - document object
+   * @param page - page object
+   * @param annotation - the annotation to export
+   * @returns a PDF buffer containing the annotation appearance
+   */
+  exportAnnotationAppearanceAsPdf(doc, page, annotation) {
+    this.logger.debug(
+      LOG_SOURCE,
+      LOG_CATEGORY,
+      "exportAnnotationAppearanceAsPdf",
+      doc.id,
+      page.index,
+      annotation.id
+    );
+    const label = "ExportAnnotationAppearanceAsPdf";
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "Begin", `${doc.id}-${page.index}`);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    const pageCtx = ctx.acquirePage(page.index);
+    const annotPtr = this.getAnnotationByName(pageCtx.pagePtr, annotation.id);
+    if (!annotPtr) {
+      pageCtx.release();
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.NotFound,
+        message: "annotation not found"
+      });
+    }
+    const exportedDocPtr = this.pdfiumModule.EPDFAnnot_ExportAppearanceAsDocument(annotPtr);
+    this.pdfiumModule.FPDFPage_CloseAnnot(annotPtr);
+    if (!exportedDocPtr) {
+      pageCtx.release();
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.CantCreateNewDoc,
+        message: "can not export annotation as pdf"
+      });
+    }
+    try {
+      return PdfTaskHelper.resolve(this.saveDocument(exportedDocPtr));
+    } finally {
+      this.pdfiumModule.FPDF_CloseDocument(exportedDocPtr);
+      pageCtx.release();
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+    }
+  }
+  /**
+   * Export multiple annotations' appearances as a standalone single-page PDF.
+   * All annotations must be on the same page. The resulting page is sized to
+   * the union of all annotation rects, with each appearance positioned correctly.
+   *
+   * @param doc - document object
+   * @param page - page object
+   * @param annotations - the annotations to export
+   * @returns a PDF buffer containing the combined appearances
+   */
+  exportAnnotationsAppearanceAsPdf(doc, page, annotations) {
+    this.logger.debug(
+      LOG_SOURCE,
+      LOG_CATEGORY,
+      "exportAnnotationsAppearanceAsPdf",
+      doc.id,
+      page.index,
+      annotations.map((a) => a.id)
+    );
+    const label = "ExportAnnotationsAppearanceAsPdf";
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "Begin", `${doc.id}-${page.index}`);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    if (annotations.length === 0) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.NotFound,
+        message: "no annotations provided"
+      });
+    }
+    const pageCtx = ctx.acquirePage(page.index);
+    const annotPtrs = [];
+    for (const annotation of annotations) {
+      const annotPtr = this.getAnnotationByName(pageCtx.pagePtr, annotation.id);
+      if (!annotPtr) {
+        for (const ptr of annotPtrs) {
+          this.pdfiumModule.FPDFPage_CloseAnnot(ptr);
+        }
+        pageCtx.release();
+        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+        return PdfTaskHelper.reject({
+          code: PdfErrorCode.NotFound,
+          message: `annotation not found: ${annotation.id}`
+        });
+      }
+      annotPtrs.push(annotPtr);
+    }
+    const ptrArraySize = annotPtrs.length * 4;
+    const ptrArrayPtr = this.memoryManager.malloc(ptrArraySize);
+    for (let i = 0; i < annotPtrs.length; i++) {
+      this.pdfiumModule.pdfium.setValue(ptrArrayPtr + i * 4, annotPtrs[i], "i32");
+    }
+    const exportedDocPtr = this.pdfiumModule.EPDFAnnot_ExportMultipleAppearancesAsDocument(
+      ptrArrayPtr,
+      annotPtrs.length
+    );
+    this.memoryManager.free(ptrArrayPtr);
+    for (const ptr of annotPtrs) {
+      this.pdfiumModule.FPDFPage_CloseAnnot(ptr);
+    }
+    if (!exportedDocPtr) {
+      pageCtx.release();
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.CantCreateNewDoc,
+        message: "can not export annotations as pdf"
+      });
+    }
+    try {
+      return PdfTaskHelper.resolve(this.saveDocument(exportedDocPtr));
+    } finally {
+      this.pdfiumModule.FPDF_CloseDocument(exportedDocPtr);
+      pageCtx.release();
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, label, "End", `${doc.id}-${page.index}`);
+    }
+  }
   /** Pack device-space Rects into an FS_QUADPOINTSF[] buffer (page space). */
   allocFSQuadsBufferFromRects(doc, page, rects) {
     const STRIDE = 32;
@@ -6329,7 +6638,7 @@ class PdfiumNative {
     const stateModel = this.getAnnotString(annotationPtr, "StateModel");
     const color = this.getAnnotationColor(annotationPtr);
     const opacity = this.getAnnotationOpacity(annotationPtr);
-    const icon = this.getAnnotationIcon(annotationPtr);
+    const name = this.getAnnotationName(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
@@ -6340,7 +6649,8 @@ class PdfiumNative {
       opacity,
       state,
       stateModel,
-      icon,
+      name,
+      icon: name,
       ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
@@ -6881,11 +7191,14 @@ class PdfiumNative {
   readPdfStampAnno(doc, page, annotationPtr, index) {
     const pageRect = this.readPageAnnoRect(annotationPtr);
     const rect = this.convertPageRectToDeviceRect(doc, page, pageRect);
+    const name = this.getAnnotationName(annotationPtr);
     return {
       pageIndex: page.index,
       id: index,
       type: PdfAnnotationSubtype.STAMP,
       rect,
+      name,
+      icon: name,
       ...this.readBaseAnnotationProperties(doc, page, annotationPtr)
     };
   }
@@ -7353,6 +7666,9 @@ class PdfiumNative {
     if (!this.setAnnotString(annotationPtr, "Contents", annotation.contents ?? "")) {
       return false;
     }
+    if (annotation.subject && !this.setAnnotString(annotationPtr, "Subj", annotation.subject)) {
+      return false;
+    }
     if (annotation.modified) {
       if (!this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
         return false;
@@ -7416,6 +7732,7 @@ class PdfiumNative {
     const contents = this.getAnnotString(annotationPtr, "Contents") || "";
     const modified = this.getAnnotationDate(annotationPtr, "M");
     const created = this.getAnnotationDate(annotationPtr, "CreationDate");
+    const subject = this.getAnnotString(annotationPtr, "Subj");
     const flags = this.getAnnotationFlags(annotationPtr);
     const custom = this.getAnnotCustom(annotationPtr);
     const inReplyToId = this.getInReplyToId(annotationPtr);
@@ -7433,6 +7750,7 @@ class PdfiumNative {
       flags,
       custom,
       blendMode,
+      ...subject && { subject },
       // Only include IRT if present
       ...inReplyToId && { inReplyToId },
       // Only include RT if present and not the default (Reply)
@@ -8174,7 +8492,8 @@ class PdfiumNative {
       heapPtr,
       stride
     );
-    this.pdfiumModule.FPDFBitmap_FillRect(bitmapPtr, 0, 0, wDev, hDev, 4294967295);
+    const bgColor = (options == null ? void 0 : options.transparentBackground) ? 0 : 4294967295;
+    this.pdfiumModule.FPDFBitmap_FillRect(bitmapPtr, 0, 0, wDev, hDev, bgColor);
     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);
@@ -9366,4 +9685,4 @@ export {
   isValidCustomKey as i,
   readArrayBuffer as r
 };
-//# sourceMappingURL=direct-engine-4LZYs06h.js.map
+//# sourceMappingURL=direct-engine-cyecHjwI.js.map