@embedpdf/engines 1.0.16 → 1.0.17

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./engine-v2kq6ghL.cjs"),r=require("./runner-Dnb6tfxR.cjs"),t=require("./lib/webworker/engine.cjs"),n=require("@embedpdf/models");exports.BitmapFormat=e.BitmapFormat,exports.PdfiumEngine=e.PdfiumEngine,exports.PdfiumErrorCode=e.PdfiumErrorCode,exports.RenderFlag=e.RenderFlag,exports.browserImageDataToBlobConverter=e.browserImageDataToBlobConverter,exports.readArrayBuffer=e.readArrayBuffer,exports.readString=e.readString,exports.EngineRunner=r.EngineRunner,exports.PdfiumEngineRunner=r.PdfiumEngineRunner,exports.WebWorkerEngine=t.WebWorkerEngine,exports.WorkerTask=t.WorkerTask,exports.createMockPdfDocument=function(e){const r=[];for(let t=0;t<10;t++)r.push({index:t,size:{width:100,height:200}});return{id:"id",pageCount:10,pages:r,...e}},exports.createMockPdfEngine=function(e){return{openDocumentUrl:jest.fn(((e,r)=>n.PdfTaskHelper.create())),openDocumentFromBuffer:jest.fn(((e,r)=>n.PdfTaskHelper.create())),openDocumentFromLoader:jest.fn(((e,r)=>n.PdfTaskHelper.create())),getMetadata:()=>n.PdfTaskHelper.resolve({title:"title",author:"author",subject:"subject",keywords:"keywords",producer:"producer",creator:"creator",creationDate:"creationDate",modificationDate:"modificationDate"}),getDocPermissions:e=>n.PdfTaskHelper.resolve(4294967295),getDocUserPermissions:e=>n.PdfTaskHelper.resolve(4294967295),getSignatures:e=>n.PdfTaskHelper.resolve([]),getBookmarks:e=>{const r=[];return r.push({title:"Page 1",target:{type:"destination",destination:{pageIndex:1,zoom:{mode:n.PdfZoomMode.FitPage},view:[]}}},{title:"Page 2",target:{type:"destination",destination:{pageIndex:2,zoom:{mode:n.PdfZoomMode.FitPage},view:[]}},children:[{title:"Page 3",target:{type:"destination",destination:{pageIndex:3,zoom:{mode:n.PdfZoomMode.FitPage},view:[]}}}]}),n.PdfTaskHelper.resolve({bookmarks:r})},renderPage:jest.fn(((e,r,t,o,a,s)=>{const i=o%2==0?r.size:n.swap(r.size),d=Math.ceil(i.width*t)*Math.ceil(i.height*t),f=new Uint8ClampedArray(4*d),l=r.index%255;for(let n=0;n<d;n++){for(let e=0;e<3;e++){f[4*n+e]=l}f[4*n+3]=255}const p=f.buffer,c=p instanceof ArrayBuffer?p:new Uint8Array(f).buffer,g=new Blob([c],{type:"application/octet-stream"});return n.PdfTaskHelper.resolve(g)})),renderPageRect:jest.fn(((e,r,t,o,a,s,i)=>{const d=o%2==0?r.size:n.swap(r.size),f=Math.ceil(d.width*t)*Math.ceil(d.height*t),l=new Uint8ClampedArray(4*f),p=r.index%255;for(let n=0;n<f;n++){for(let e=0;e<3;e++){l[4*n+e]=p}l[4*n+3]=255}const c=l.buffer,g=c instanceof ArrayBuffer?c:new Uint8Array(l).buffer,u=new Blob([g],{type:"application/octet-stream"});return n.PdfTaskHelper.resolve(u)})),renderThumbnail:jest.fn(((e,r)=>{const t=r.size.width/4*(r.size.height/4),o=new Uint8ClampedArray(4*t),a=r.index%255;for(let n=0;n<t;n++){for(let e=0;e<3;e++){o[4*n+e]=a}o[4*n+3]=255}const s=o.buffer,i=s instanceof ArrayBuffer?s:new Uint8Array(o).buffer,d=new Blob([i],{type:"image/png"});return n.PdfTaskHelper.resolve(d)})),renderAnnotation:jest.fn(((e,r,t,o,a,s,i,d)=>n.PdfTaskHelper.resolve(new Blob([],{type:"image/png"})))),getAllAnnotations:jest.fn((e=>n.PdfTaskHelper.resolve({}))),getPageAnnotations:jest.fn(((e,r)=>{const t={pageIndex:r.index,id:r.index+1,type:n.PdfAnnotationSubtype.LINK,target:{type:"action",action:{type:n.PdfActionType.URI,uri:"https://localhost"}},text:"localhost",rect:{origin:{x:0,y:0},size:{width:100,height:100}}},o=[];return o.push(t),n.PdfTaskHelper.resolve(o)})),createPageAnnotation:jest.fn((()=>n.PdfTaskHelper.resolve(1))),updatePageAnnotation:jest.fn((()=>n.PdfTaskHelper.resolve(!0))),removePageAnnotation:jest.fn((()=>n.PdfTaskHelper.resolve(!0))),getPageTextRects:jest.fn(((e,r,t,o)=>n.PdfTaskHelper.resolve([{content:"pdf text",font:{family:"sans-serif",size:12},rect:{origin:{x:0,y:0},size:{width:100,height:100}}}]))),closeDocument:e=>n.PdfTaskHelper.resolve(!0),saveAsCopy:e=>n.PdfTaskHelper.resolve(new ArrayBuffer(0)),flattenPage:(e,r,t)=>n.PdfTaskHelper.resolve(n.PdfPageFlattenResult.Success),extractPages:(e,r)=>n.PdfTaskHelper.resolve(new ArrayBuffer(0)),extractText:(e,r)=>n.PdfTaskHelper.resolve(""),getTextSlices:(e,r)=>n.PdfTaskHelper.resolve([]),getPageGlyphs:(e,r)=>n.PdfTaskHelper.resolve([]),getPageGeometry:(e,r)=>n.PdfTaskHelper.resolve({runs:[]}),merge:e=>n.PdfTaskHelper.resolve({id:"id",content:new ArrayBuffer(0)}),mergePages:e=>n.PdfTaskHelper.resolve({id:"id",content:new ArrayBuffer(0)}),searchAllPages:(e,r,t)=>{const o={pageIndex:0,charIndex:0,charCount:r.length,rects:[{origin:{x:0,y:0},size:{width:50,height:20}}],context:{before:"",match:"",after:"",truncatedLeft:!1,truncatedRight:!1}};return n.PdfTaskHelper.resolve({results:[o],total:1})},getAttachments:e=>n.PdfTaskHelper.resolve([]),readAttachmentContent:(e,r)=>n.PdfTaskHelper.resolve(new ArrayBuffer(0)),setFormFieldValue:(e,r,t,o)=>n.PdfTaskHelper.resolve(!0),...e}},exports.createMockPdfFile=function(e){return{id:"id",content:new ArrayBuffer(0)}};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./engine-Bcr-xNy6.cjs"),r=require("./runner-C64KrEhP.cjs"),t=require("./lib/webworker/engine.cjs"),n=require("@embedpdf/models");exports.BitmapFormat=e.BitmapFormat,exports.PdfiumEngine=e.PdfiumEngine,exports.PdfiumErrorCode=e.PdfiumErrorCode,exports.RenderFlag=e.RenderFlag,exports.browserImageDataToBlobConverter=e.browserImageDataToBlobConverter,exports.readArrayBuffer=e.readArrayBuffer,exports.readString=e.readString,exports.EngineRunner=r.EngineRunner,exports.PdfiumEngineRunner=r.PdfiumEngineRunner,exports.WebWorkerEngine=t.WebWorkerEngine,exports.WorkerTask=t.WorkerTask,exports.createMockPdfDocument=function(e){const r=[];for(let t=0;t<10;t++)r.push({index:t,size:{width:100,height:200}});return{id:"id",pageCount:10,pages:r,...e}},exports.createMockPdfEngine=function(e){return{openDocumentUrl:jest.fn(((e,r)=>n.PdfTaskHelper.create())),openDocumentFromBuffer:jest.fn(((e,r)=>n.PdfTaskHelper.create())),openDocumentFromLoader:jest.fn(((e,r)=>n.PdfTaskHelper.create())),getMetadata:()=>n.PdfTaskHelper.resolve({title:"title",author:"author",subject:"subject",keywords:"keywords",producer:"producer",creator:"creator",creationDate:"creationDate",modificationDate:"modificationDate"}),getDocPermissions:e=>n.PdfTaskHelper.resolve(4294967295),getDocUserPermissions:e=>n.PdfTaskHelper.resolve(4294967295),getSignatures:e=>n.PdfTaskHelper.resolve([]),getBookmarks:e=>{const r=[];return r.push({title:"Page 1",target:{type:"destination",destination:{pageIndex:1,zoom:{mode:n.PdfZoomMode.FitPage},view:[]}}},{title:"Page 2",target:{type:"destination",destination:{pageIndex:2,zoom:{mode:n.PdfZoomMode.FitPage},view:[]}},children:[{title:"Page 3",target:{type:"destination",destination:{pageIndex:3,zoom:{mode:n.PdfZoomMode.FitPage},view:[]}}}]}),n.PdfTaskHelper.resolve({bookmarks:r})},renderPage:jest.fn(((e,r,t,o,a,s)=>{const i=o%2==0?r.size:n.swap(r.size),d=Math.ceil(i.width*t)*Math.ceil(i.height*t),f=new Uint8ClampedArray(4*d),l=r.index%255;for(let n=0;n<d;n++){for(let e=0;e<3;e++){f[4*n+e]=l}f[4*n+3]=255}const p=f.buffer,c=p instanceof ArrayBuffer?p:new Uint8Array(f).buffer,g=new Blob([c],{type:"application/octet-stream"});return n.PdfTaskHelper.resolve(g)})),renderPageRect:jest.fn(((e,r,t,o,a,s,i)=>{const d=o%2==0?r.size:n.swap(r.size),f=Math.ceil(d.width*t)*Math.ceil(d.height*t),l=new Uint8ClampedArray(4*f),p=r.index%255;for(let n=0;n<f;n++){for(let e=0;e<3;e++){l[4*n+e]=p}l[4*n+3]=255}const c=l.buffer,g=c instanceof ArrayBuffer?c:new Uint8Array(l).buffer,u=new Blob([g],{type:"application/octet-stream"});return n.PdfTaskHelper.resolve(u)})),renderThumbnail:jest.fn(((e,r)=>{const t=r.size.width/4*(r.size.height/4),o=new Uint8ClampedArray(4*t),a=r.index%255;for(let n=0;n<t;n++){for(let e=0;e<3;e++){o[4*n+e]=a}o[4*n+3]=255}const s=o.buffer,i=s instanceof ArrayBuffer?s:new Uint8Array(o).buffer,d=new Blob([i],{type:"image/png"});return n.PdfTaskHelper.resolve(d)})),renderAnnotation:jest.fn(((e,r,t,o,a,s,i,d)=>n.PdfTaskHelper.resolve(new Blob([],{type:"image/png"})))),getAllAnnotations:jest.fn((e=>n.PdfTaskHelper.resolve({}))),getPageAnnotations:jest.fn(((e,r)=>{const t={pageIndex:r.index,id:r.index+1,type:n.PdfAnnotationSubtype.LINK,target:{type:"action",action:{type:n.PdfActionType.URI,uri:"https://localhost"}},text:"localhost",rect:{origin:{x:0,y:0},size:{width:100,height:100}}},o=[];return o.push(t),n.PdfTaskHelper.resolve(o)})),createPageAnnotation:jest.fn((()=>n.PdfTaskHelper.resolve(1))),updatePageAnnotation:jest.fn((()=>n.PdfTaskHelper.resolve(!0))),removePageAnnotation:jest.fn((()=>n.PdfTaskHelper.resolve(!0))),getPageTextRects:jest.fn(((e,r,t,o)=>n.PdfTaskHelper.resolve([{content:"pdf text",font:{family:"sans-serif",size:12},rect:{origin:{x:0,y:0},size:{width:100,height:100}}}]))),closeDocument:e=>n.PdfTaskHelper.resolve(!0),saveAsCopy:e=>n.PdfTaskHelper.resolve(new ArrayBuffer(0)),flattenPage:(e,r,t)=>n.PdfTaskHelper.resolve(n.PdfPageFlattenResult.Success),extractPages:(e,r)=>n.PdfTaskHelper.resolve(new ArrayBuffer(0)),extractText:(e,r)=>n.PdfTaskHelper.resolve(""),getTextSlices:(e,r)=>n.PdfTaskHelper.resolve([]),getPageGlyphs:(e,r)=>n.PdfTaskHelper.resolve([]),getPageGeometry:(e,r)=>n.PdfTaskHelper.resolve({runs:[]}),merge:e=>n.PdfTaskHelper.resolve({id:"id",content:new ArrayBuffer(0)}),mergePages:e=>n.PdfTaskHelper.resolve({id:"id",content:new ArrayBuffer(0)}),searchAllPages:(e,r,t)=>{const o={pageIndex:0,charIndex:0,charCount:r.length,rects:[{origin:{x:0,y:0},size:{width:50,height:20}}],context:{before:"",match:"",after:"",truncatedLeft:!1,truncatedRight:!1}};return n.PdfTaskHelper.resolve({results:[o],total:1})},getAttachments:e=>n.PdfTaskHelper.resolve([]),readAttachmentContent:(e,r)=>n.PdfTaskHelper.resolve(new ArrayBuffer(0)),setFormFieldValue:(e,r,t,o)=>n.PdfTaskHelper.resolve(!0),...e}},exports.createMockPdfFile=function(e){return{id:"id",content:new ArrayBuffer(0)}};
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -1,5 +1,5 @@
-import { B, a, P, R, b, c, r } from "./engine-B11yoQGd.js";
-import { E, P as P2 } from "./runner-D9_9TvyZ.js";
+import { B, a, P, R, b, c, r } from "./engine-uSZXjmb5.js";
+import { E, P as P2 } from "./runner-BOJ4naYI.js";
 import { WebWorkerEngine, WorkerTask } from "./lib/webworker/engine.js";
 import { PdfTaskHelper, PdfActionType, PdfAnnotationSubtype, swap, PdfPageFlattenResult, PdfZoomMode } from "@embedpdf/models";
 function createMockPdfEngine(partialEngine) {

package/dist/lib/pdfium/cache.d.ts

@@ -17,6 +17,8 @@ export declare class DocumentContext {
     constructor(filePtr: number, docPtr: number, pdfium: WrappedPdfiumModule);
     /** Main accessor for pages */
     acquirePage(pageIdx: number): PageContext;
+    /** Scoped accessor for one-off / bulk operations */
+    borrowPage<T>(pageIdx: number, fn: (ctx: PageContext) => T): T;
     /** Tear down all pages + this document */
     dispose(): void;
 }
@@ -26,6 +28,11 @@ export declare class PageCache {
     private readonly cache;
     constructor(pdf: WrappedPdfiumModule, docPtr: number);
     acquire(pageIdx: number): PageContext;
+    /** Helper: run a function “scoped” to a page.
+     *    – if the page was already cached  → .release() (keeps TTL logic)
+     *    – if the page was loaded just now → .disposeImmediate() (free right away)
+     */
+    borrowPage<T>(pageIdx: number, fn: (ctx: PageContext) => T): T;
     forceReleaseAll(): void;
 }
 export declare class PageContext {

package/dist/lib/pdfium/engine.d.ts

@@ -1,4 +1,4 @@
-import { PdfAnnotationObject, PdfTextRectObject, PdfWidgetAnnoObject, Logger, SearchTarget, MatchFlag, PdfBookmarkObject, PdfDocumentObject, PdfEngine, PdfPageObject, Rotation, Rect, PdfAttachmentObject, PdfSignatureObject, PdfRenderOptions, PdfInkAnnoObject, Position, PdfStampAnnoObject, PdfCircleAnnoObject, PdfSquareAnnoObject, PdfFreeTextAnnoObject, PdfSquigglyAnnoObject, PdfStrikeOutAnnoObject, PdfUnderlineAnnoObject, PdfFile, AppearanceMode, PdfHighlightAnnoObject, FormFieldValue, PdfPageFlattenFlag, PdfPageFlattenResult, PdfTask, PdfFileLoader, SearchAllPagesResult, PdfUrlOptions, PdfFileUrl, Task, PdfErrorReason, PdfGlyphObject, PdfPageGeometry, PdfImage, ImageConversionTypes, PageTextSlice, AnnotationCreateContext } from '@embedpdf/models';
+import { PdfAnnotationObject, PdfTextRectObject, PdfWidgetAnnoObject, Logger, SearchTarget, MatchFlag, PdfBookmarkObject, PdfDocumentObject, PdfEngine, PdfPageObject, Rotation, Rect, PdfAttachmentObject, PdfSignatureObject, PdfRenderOptions, Position, PdfStampAnnoObject, PdfCircleAnnoObject, PdfSquareAnnoObject, PdfSquigglyAnnoObject, PdfStrikeOutAnnoObject, PdfUnderlineAnnoObject, PdfFile, AppearanceMode, PdfHighlightAnnoObject, FormFieldValue, PdfPageFlattenFlag, PdfPageFlattenResult, PdfTask, PdfFileLoader, SearchAllPagesResult, PdfUrlOptions, PdfFileUrl, Task, PdfErrorReason, PdfGlyphObject, PdfPageGeometry, PdfImage, ImageConversionTypes, PageTextSlice, AnnotationCreateContext, PdfPageSearchProgress } from '@embedpdf/models';
 import { WrappedPdfiumModule } from '@embedpdf/pdfium';
 /**
  * Format of bitmap
@@ -85,19 +85,19 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @public
      */
-    initialize(): Task<boolean, PdfErrorReason>;
+    initialize(): Task<boolean, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.destroy}
      *
      * @public
      */
-    destroy(): Task<boolean, PdfErrorReason>;
+    destroy(): Task<boolean, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.openDocumentUrl}
      *
      * @public
      */
-    openDocumentUrl(file: PdfFileUrl, options?: PdfUrlOptions): Task<PdfDocumentObject, PdfErrorReason>;
+    openDocumentUrl(file: PdfFileUrl, options?: PdfUrlOptions): Task<PdfDocumentObject, PdfErrorReason, unknown>;
     /**
      * Check if the server supports range requests:
      * Sends a HEAD request and sees if 'Accept-Ranges: bytes'.
@@ -129,19 +129,19 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @public
      */
-    openDocumentFromBuffer(file: PdfFile, password?: string): Task<PdfDocumentObject, PdfErrorReason>;
+    openDocumentFromBuffer(file: PdfFile, password?: string): Task<PdfDocumentObject, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.openDocumentFromLoader}
      *
      * @public
      */
-    openDocumentFromLoader(fileLoader: PdfFileLoader, password?: string): Task<PdfDocumentObject, PdfErrorReason>;
+    openDocumentFromLoader(fileLoader: PdfFileLoader, password?: string): Task<PdfDocumentObject, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getMetadata}
      *
      * @public
      */
-    getMetadata(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<{
+    getMetadata(doc: PdfDocumentObject): Task<any, PdfErrorReason, unknown> | Task<{
         title: string;
         author: string;
         subject: string;
@@ -150,33 +150,33 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
         creator: string;
         creationDate: string;
         modificationDate: string;
-    }, PdfErrorReason>;
+    }, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getDocPermissions}
      *
      * @public
      */
-    getDocPermissions(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<number, PdfErrorReason>;
+    getDocPermissions(doc: PdfDocumentObject): Task<any, PdfErrorReason, unknown> | Task<number, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getDocUserPermissions}
      *
      * @public
      */
-    getDocUserPermissions(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<number, PdfErrorReason>;
+    getDocUserPermissions(doc: PdfDocumentObject): Task<any, PdfErrorReason, unknown> | Task<number, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getSignatures}
      *
      * @public
      */
-    getSignatures(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<PdfSignatureObject[], PdfErrorReason>;
+    getSignatures(doc: PdfDocumentObject): Task<any, PdfErrorReason, unknown> | Task<PdfSignatureObject[], PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getBookmarks}
      *
      * @public
      */
-    getBookmarks(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<{
+    getBookmarks(doc: PdfDocumentObject): Task<any, PdfErrorReason, unknown> | Task<{
         bookmarks: PdfBookmarkObject[];
-    }, PdfErrorReason>;
+    }, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.renderPage}
      *
@@ -194,14 +194,18 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @public
      */
-    getAllAnnotations(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<Record<number, PdfAnnotationObject[]>, PdfErrorReason>;
+    getAllAnnotations(doc: PdfDocumentObject): PdfTask<Record<number, PdfAnnotationObject[]>, // final result
+    {
+        page: number;
+        annotations: PdfAnnotationObject[];
+    }>;
     private readAllAnnotations;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getPageAnnotations}
      *
      * @public
      */
-    getPageAnnotations(doc: PdfDocumentObject, page: PdfPageObject): Task<any, PdfErrorReason> | Task<PdfAnnotationObject[], PdfErrorReason>;
+    getPageAnnotations(doc: PdfDocumentObject, page: PdfPageObject): Task<any, PdfErrorReason, unknown> | Task<PdfAnnotationObject[], PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.createPageAnnotation}
      *
@@ -223,13 +227,13 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @public
      */
-    removePageAnnotation(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject): Task<boolean, PdfErrorReason> | Task<any, PdfErrorReason>;
+    removePageAnnotation(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject): Task<boolean, PdfErrorReason, unknown> | Task<any, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getPageTextRects}
      *
      * @public
      */
-    getPageTextRects(doc: PdfDocumentObject, page: PdfPageObject, scaleFactor: number, rotation: Rotation): Task<any, PdfErrorReason> | Task<PdfTextRectObject[], PdfErrorReason>;
+    getPageTextRects(doc: PdfDocumentObject, page: PdfPageObject, scaleFactor: number, rotation: Rotation): Task<any, PdfErrorReason, unknown> | Task<PdfTextRectObject[], PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.renderThumbnail}
      *
@@ -241,19 +245,19 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @public
      */
-    getAttachments(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<PdfAttachmentObject[], PdfErrorReason>;
+    getAttachments(doc: PdfDocumentObject): Task<any, PdfErrorReason, unknown> | Task<PdfAttachmentObject[], PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.readAttachmentContent}
      *
      * @public
      */
-    readAttachmentContent(doc: PdfDocumentObject, attachment: PdfAttachmentObject): Task<any, PdfErrorReason> | Task<ArrayBuffer, PdfErrorReason>;
+    readAttachmentContent(doc: PdfDocumentObject, attachment: PdfAttachmentObject): Task<any, PdfErrorReason, unknown> | Task<ArrayBuffer, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.setFormFieldValue}
      *
      * @public
      */
-    setFormFieldValue(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfWidgetAnnoObject, value: FormFieldValue): Task<boolean, PdfErrorReason> | Task<any, PdfErrorReason>;
+    setFormFieldValue(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfWidgetAnnoObject, value: FormFieldValue): Task<boolean, PdfErrorReason, unknown> | Task<any, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.flattenPage}
      *
@@ -265,13 +269,13 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @public
      */
-    extractPages(doc: PdfDocumentObject, pageIndexes: number[]): Task<any, PdfErrorReason> | Task<ArrayBuffer, PdfErrorReason>;
+    extractPages(doc: PdfDocumentObject, pageIndexes: number[]): Task<any, PdfErrorReason, unknown> | Task<ArrayBuffer, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.extractText}
      *
      * @public
      */
-    extractText(doc: PdfDocumentObject, pageIndexes: number[]): Task<any, PdfErrorReason> | Task<string, PdfErrorReason>;
+    extractText(doc: PdfDocumentObject, pageIndexes: number[]): Task<any, PdfErrorReason, unknown> | Task<string, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getTextSlices}
      *
@@ -283,7 +287,7 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @public
      */
-    merge(files: PdfFile[]): Task<any, PdfErrorReason> | Task<PdfFile, PdfErrorReason>;
+    merge(files: PdfFile[]): Task<any, PdfErrorReason, unknown> | Task<PdfFile, PdfErrorReason, unknown>;
     /**
      * Merges specific pages from multiple PDF documents in a custom order
      *
@@ -294,19 +298,19 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     mergePages(mergeConfigs: Array<{
         docId: string;
         pageIndices: number[];
-    }>): Task<any, PdfErrorReason> | Task<PdfFile, PdfErrorReason>;
+    }>): Task<any, PdfErrorReason, unknown> | Task<PdfFile, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.saveAsCopy}
      *
      * @public
      */
-    saveAsCopy(doc: PdfDocumentObject): Task<any, PdfErrorReason> | Task<ArrayBuffer, PdfErrorReason>;
+    saveAsCopy(doc: PdfDocumentObject): Task<any, PdfErrorReason, unknown> | Task<ArrayBuffer, PdfErrorReason, unknown>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.closeDocument}
      *
      * @public
      */
-    closeDocument(doc: PdfDocumentObject): Task<boolean, PdfErrorReason> | Task<any, PdfErrorReason>;
+    closeDocument(doc: PdfDocumentObject): Task<boolean, PdfErrorReason, unknown> | Task<any, PdfErrorReason, unknown>;
     /**
      * Memory allocation
      * @param size - size of memory space
@@ -322,7 +326,28 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @public
      */
     free(ptr: number): void;
-    addFreeTextContent(page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfFreeTextAnnoObject): boolean;
+    /**
+     * Add text content to annotation
+     * @param page - page info
+     * @param pagePtr - pointer to page object
+     * @param annotationPtr - pointer to text annotation
+     * @param annotation - text annotation
+     * @returns whether text content is added to annotation
+     *
+     * @private
+     */
+    private addTextContent;
+    /**
+     * Add free text content to annotation
+     * @param page - page info
+     * @param pagePtr - pointer to page object
+     * @param annotationPtr - pointer to free text annotation
+     * @param annotation - free text annotation
+     * @returns whether free text content is added to annotation
+     *
+     * @private
+     */
+    private addFreeTextContent;
     /**
      * Set the rect of specified annotation
      * @param page - page info that the annotation is belonged to
@@ -333,7 +358,7 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *
      * @private
      */
-    addInkStroke(page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfInkAnnoObject): boolean;
+    private addInkStroke;
     /**
      * Add line content to annotation
      * @param page - page info
@@ -504,6 +529,7 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @private
      */
     private readPageAnnotations;
+    private readPageAnnotationsRaw;
     /**
      * Read pdf annotation from pdf document
      * @param page  - pdf page infor
@@ -640,6 +666,21 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      */
     private getBorderStyle;
     private setBorderStyle;
+    /**
+     * Get the icon of the annotation
+     *
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @returns `PdfAnnotationIcon`
+     */
+    private getAnnotationIcon;
+    /**
+     * Set the icon of the annotation
+     *
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @param icon - `PdfAnnotationIcon`
+     * @returns `true` on success
+     */
+    private setAnnotationIcon;
     /**
      * Border-effect (“cloudy”) helper
      *
@@ -663,6 +704,23 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *          • the four floats are 0 when `ok` is false
      */
     private getRectangleDifferences;
+    /**
+     * Get the date of the annotation
+     *
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @param key - 'M' for modified date, 'CreationDate' for creation date
+     * @returns `Date` or `undefined` when PDFium can't read the date
+     */
+    private getAnnotationDate;
+    /**
+     * Set the date of the annotation
+     *
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @param key - 'M' for modified date, 'CreationDate' for creation date
+     * @param date - `Date` to set
+     * @returns `true` on success
+     */
+    private setAnnotationDate;
     /**
      * Dash-pattern helper ( /BS → /D array, dashed borders only )
      *
@@ -767,7 +825,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf text annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf text annotation
@@ -778,7 +835,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf freetext annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf freetext annotation
@@ -790,8 +846,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * Read pdf link annotation from pdf document
      * @param page  - pdf page infor
      * @param docPtr - pointer to pdf document object
-     * @param pagePtr - pointer to pdf page object
-     * @param  textPagePtr - pointer to pdf text page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf link annotation
@@ -802,7 +856,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf widget annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param formHandle - form handle
      * @param index  - index of annotation in the pdf page
@@ -814,7 +867,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf file attachment annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf file attachment annotation
@@ -825,7 +877,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf ink annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf ink annotation
@@ -836,7 +887,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf polygon annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf polygon annotation
@@ -847,7 +897,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf polyline annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf polyline annotation
@@ -858,7 +907,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf line annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf line annotation
@@ -869,7 +917,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf highlight annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf highlight annotation
@@ -880,7 +927,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf underline annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf underline annotation
@@ -891,7 +937,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read strikeout annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf strikeout annotation
@@ -902,7 +947,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf squiggly annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf squiggly annotation
@@ -913,7 +957,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read pdf caret annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf caret annotation
@@ -923,9 +966,7 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     private readPdfCaretAnno;
     /**
      * Read pdf stamp annotation
-     * @param docPtr - pointer to pdf document object
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf stamp annotation
@@ -1013,7 +1054,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read circle annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf circle annotation
@@ -1024,7 +1064,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read square annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
      * @returns pdf square annotation
@@ -1035,7 +1074,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read basic info of unsupported pdf annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param type - type of annotation
      * @param annotationPtr - pointer to pdf annotation
      * @param index  - index of annotation in the pdf page
@@ -1054,6 +1092,14 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @private
      */
     private getInReplyToId;
+    /**
+     * Set the in reply to id of the annotation
+     *
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @param id - the id of the parent annotation
+     * @returns `true` on success
+     */
+    private setInReplyToId;
     /**
      * Fetch a string value (`/T`, `/M`, `/State`, …) from an annotation.
      *
@@ -1062,6 +1108,19 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @private
      */
     private getAnnotString;
+    /**
+     * Get custom data of the annotation
+     * @param annotationPtr - pointer to pdf annotation
+     * @returns custom data of the annotation
+     *
+     * @private
+     */
+    private getAnnotCustom;
+    /**
+     * Sets custom data for an annotation by safely stringifying and storing JSON
+     * @private
+     */
+    private setAnnotCustom;
     /**
      * Fetches the /IT (Intent) name from an annotation as a UTF-8 JS string.
      *
@@ -1087,6 +1146,24 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * `undefined` when the annotation has no rich content.
      */
     private getAnnotRichContent;
+    /**
+     * Get annotation by name
+     * @param pagePtr - pointer to pdf page object
+     * @param name - name of annotation
+     * @returns pointer to pdf annotation
+     *
+     * @private
+     */
+    private getAnnotationByName;
+    /**
+     * Remove annotation by name
+     * @param pagePtr - pointer to pdf page object
+     * @param name - name of annotation
+     * @returns true on success
+     *
+     * @private
+     */
+    private removeAnnotationByName;
     /**
      * Set a string value (`/T`, `/M`, `/State`, …) to an annotation.
      *
@@ -1098,7 +1175,6 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     /**
      * Read vertices of pdf annotation
      * @param page  - pdf page infor
-     * @param pagePtr - pointer to pdf page object
      * @param annotationPtr - pointer to pdf annotation
      * @returns vertices of pdf annotation
      *
@@ -1270,17 +1346,14 @@ export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      */
     private getHighlightRects;
     /**
-     * Search for a keyword across all pages in the document
-     * Returns all search results throughout the entire document
+     * {@inheritDoc @embedpdf/models!PdfEngine.searchAllPages}
      *
-     * @param doc - Pdf document object
-     * @param keyword - Search keyword
-     * @param flags - Match flags for search
-     * @returns Promise of all search results in the document
+     * Runs inside the worker.
+     * Emits per-page progress: { page, results }
      *
      * @public
      */
-    searchAllPages(doc: PdfDocumentObject, keyword: string, flags?: MatchFlag[]): Task<SearchAllPagesResult, PdfErrorReason>;
+    searchAllPages(doc: PdfDocumentObject, keyword: string, flags?: MatchFlag[]): PdfTask<SearchAllPagesResult, PdfPageSearchProgress>;
     /**
      * Extract word-aligned context for a search hit.
      *

package/dist/lib/pdfium/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../../engine-v2kq6ghL.cjs"),e=require("../../runner-Dnb6tfxR.cjs");exports.BitmapFormat=r.BitmapFormat,exports.PdfiumEngine=r.PdfiumEngine,exports.PdfiumErrorCode=r.PdfiumErrorCode,exports.RenderFlag=r.RenderFlag,exports.browserImageDataToBlobConverter=r.browserImageDataToBlobConverter,exports.readArrayBuffer=r.readArrayBuffer,exports.readString=r.readString,exports.PdfiumEngineRunner=e.PdfiumEngineRunner;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../../engine-Bcr-xNy6.cjs"),e=require("../../runner-C64KrEhP.cjs");exports.BitmapFormat=r.BitmapFormat,exports.PdfiumEngine=r.PdfiumEngine,exports.PdfiumErrorCode=r.PdfiumErrorCode,exports.RenderFlag=r.RenderFlag,exports.browserImageDataToBlobConverter=r.browserImageDataToBlobConverter,exports.readArrayBuffer=r.readArrayBuffer,exports.readString=r.readString,exports.PdfiumEngineRunner=e.PdfiumEngineRunner;
 //# sourceMappingURL=index.cjs.map

package/dist/lib/pdfium/index.js

@@ -1,5 +1,5 @@
-import { B, a, P, R, b, c, r } from "../../engine-B11yoQGd.js";
-import { P as P2 } from "../../runner-D9_9TvyZ.js";
+import { B, a, P, R, b, c, r } from "../../engine-uSZXjmb5.js";
+import { P as P2 } from "../../runner-BOJ4naYI.js";
 export {
   B as BitmapFormat,
   a as PdfiumEngine,

package/dist/lib/pdfium/web/direct-engine.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/pdfium"),i=require("../../../engine-v2kq6ghL.cjs");exports.createPdfiumEngine=async function(t,n){const r=await fetch(t),a=await r.arrayBuffer(),u=await e.init({wasmBinary:a});return new i.PdfiumEngine(u,n)};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/pdfium"),i=require("../../../engine-Bcr-xNy6.cjs");exports.createPdfiumEngine=async function(t,n){const r=await fetch(t),a=await r.arrayBuffer(),u=await e.init({wasmBinary:a});return new i.PdfiumEngine(u,n)};
 //# sourceMappingURL=direct-engine.cjs.map

package/dist/lib/pdfium/web/direct-engine.js

@@ -1,5 +1,5 @@
 import { init } from "@embedpdf/pdfium";
-import { a as PdfiumEngine } from "../../../engine-B11yoQGd.js";
+import { a as PdfiumEngine } from "../../../engine-uSZXjmb5.js";
 async function createPdfiumEngine(wasmUrl, logger) {
   const response = await fetch(wasmUrl);
   const wasmBinary = await response.arrayBuffer();