@embedpdf/engines 1.0.11 → 1.0.13

package/dist/{pdfium.d.ts → lib/pdfium/engine.d.ts}

@@ -1,10 +1,9 @@
-import { SearchTarget, PdfImage, ImageConversionTypes, PdfEngine, Logger, Task, PdfErrorReason, PdfFileUrl, PdfUrlOptions, PdfDocumentObject, PdfFile, PdfFileLoader, PdfSignatureObject, PdfBookmarkObject, PdfPageObject, Rotation, PdfRenderOptions, PdfTask, Rect, PdfAnnotationObject, PdfTextRectObject, PdfAttachmentObject, PdfWidgetAnnoObject, FormFieldValue, PdfPageFlattenFlag, PdfPageFlattenResult, PageTextSlice, PdfInkAnnoObject, PdfHighlightAnnoObject, PdfUnderlineAnnoObject, PdfStrikeOutAnnoObject, PdfSquigglyAnnoObject, PdfStampAnnoObjectContents, Position, PdfPageGeometry, PdfGlyphObject, AppearanceMode, PdfAnnotationObjectBase, WebAlphaColor, MatchFlag, SearchAllPagesResult, PdfEngineMethodName, PdfEngineMethodArgs, TaskReturn, PdfEngineMethodReturnType } from '@embedpdf/models';
-import { WrappedPdfiumModule, PdfiumRuntimeMethods, PdfiumModule } from '@embedpdf/pdfium';
-
+import { PdfAnnotationObject, PdfTextRectObject, PdfWidgetAnnoObject, Logger, SearchTarget, MatchFlag, PdfBookmarkObject, PdfDocumentObject, PdfEngine, PdfPageObject, Rotation, Rect, PdfAttachmentObject, PdfSignatureObject, PdfRenderOptions, PdfInkAnnoObject, Position, PdfCircleAnnoObject, PdfSquareAnnoObject, PdfSquigglyAnnoObject, PdfStrikeOutAnnoObject, PdfUnderlineAnnoObject, PdfFile, AppearanceMode, PdfHighlightAnnoObject, PdfStampAnnoObjectContents, FormFieldValue, PdfPageFlattenFlag, PdfPageFlattenResult, PdfTask, PdfFileLoader, SearchAllPagesResult, PdfUrlOptions, PdfFileUrl, Task, PdfErrorReason, PdfGlyphObject, PdfPageGeometry, PdfImage, ImageConversionTypes, PdfAnnotationObjectBase, PageTextSlice, WebAlphaColor } from '@embedpdf/models';
+import { WrappedPdfiumModule } from '@embedpdf/pdfium';
 /**
  * Format of bitmap
  */
-declare enum BitmapFormat {
+export declare enum BitmapFormat {
     Bitmap_Gray = 1,
     Bitmap_BGR = 2,
     Bitmap_BGRx = 3,
@@ -13,7 +12,7 @@ declare enum BitmapFormat {
 /**
  * Pdf rendering flag
  */
-declare enum RenderFlag {
+export declare enum RenderFlag {
     ANNOT = 1,// Set if annotations are to be rendered.
     LCD_TEXT = 2,// Set if using text rendering optimized for LCD display.
     NO_NATIVETEXT = 4,// Don't use the native text output available on some platforms
@@ -28,7 +27,7 @@ declare enum RenderFlag {
 /**
  * Context used for searching
  */
-interface SearchContext {
+export interface SearchContext {
     /**
      * search target
      */
@@ -45,7 +44,7 @@ interface SearchContext {
 /**
  * Error code of pdfium library
  */
-declare enum PdfiumErrorCode {
+export declare enum PdfiumErrorCode {
     Success = 0,
     Unknown = 1,
     File = 2,
@@ -61,12 +60,12 @@ declare enum PdfiumErrorCode {
  * In browser: uses OffscreenCanvas
  * In Node.js: can use Sharp or other image processing libraries
  */
-type ImageDataConverter<T = Blob> = (imageData: PdfImage, imageType?: ImageConversionTypes) => Promise<T>;
-declare const browserImageDataToBlobConverter: ImageDataConverter<Blob>;
+export type ImageDataConverter<T = Blob> = (imageData: PdfImage, imageType?: ImageConversionTypes) => Promise<T>;
+export declare const browserImageDataToBlobConverter: ImageDataConverter<Blob>;
 /**
  * Pdf engine that based on pdfium wasm
  */
-declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
+export declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
     private pdfiumModule;
     private logger;
     private imageDataConverter;
@@ -334,6 +333,39 @@ declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @private
      */
     addInkStroke(page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfInkAnnoObject): boolean;
+    /**
+     * Add line content to annotation
+     * @param page - page info
+     * @param pagePtr - pointer to page object
+     * @param annotationPtr - pointer to line annotation
+     * @param annotation - line annotation
+     * @returns whether line content is added to annotation
+     *
+     * @private
+     */
+    private addLineContent;
+    /**
+     * Add polygon or polyline content to annotation
+     * @param page - page info
+     * @param pagePtr - pointer to page object
+     * @param annotationPtr - pointer to polygon or polyline annotation
+     * @param annotation - polygon or polyline annotation
+     * @returns whether polygon or polyline content is added to annotation
+     *
+     * @private
+     */
+    private addPolyContent;
+    /**
+     * Add shape content to annotation
+     * @param page - page info
+     * @param pagePtr - pointer to page object
+     * @param annotationPtr - pointer to shape annotation
+     * @param annotation - shape annotation
+     * @returns whether shape content is added to annotation
+     *
+     * @private
+     */
+    addShapeContent(page: PdfPageObject, pagePtr: number, annotationPtr: number, annotation: PdfCircleAnnoObject | PdfSquareAnnoObject): boolean;
     /**
      * Add highlight content to annotation
      * @param page - page info
@@ -578,6 +610,51 @@ declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *          • `pattern`  – numeric array of dash/space lengths (empty when `ok` is false)
      */
     private getBorderDashPattern;
+    /**
+     * Write the /BS /D dash pattern array for an annotation border.
+     *
+     * @param annotationPtr Pointer to FPDF_ANNOTATION
+     * @param pattern       Array of dash/space lengths in *points* (e.g. [3, 2])
+     *                      Empty array clears the pattern (solid line).
+     * @returns true on success
+     *
+     * @private
+     */
+    private setBorderDashPattern;
+    /**
+     * Return the `/LE` array (start/end line-ending styles) for a LINE / POLYLINE annot.
+     *
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @returns `{ start, end }` or `undefined` when PDFium can't read them
+     *
+     * @private
+     */
+    private getLineEndings;
+    /**
+     * Write the `/LE` array (start/end line-ending styles) for a LINE / POLYLINE annot.
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @param start - start line ending style
+     * @param end - end line ending style
+     * @returns `true` on success
+     */
+    private setLineEndings;
+    /**
+     * Get the start and end points of a LINE / POLYLINE annot.
+     * @param annotationPtr - pointer to an `FPDF_ANNOTATION`
+     * @param page - logical page info object (`PdfPageObject`)
+     * @returns `{ start, end }` or `undefined` when PDFium can't read them
+     */
+    private getLinePoints;
+    /**
+     * Set the two end‑points of a **Line** annotation
+     * by writing a new /L array `[ x1 y1 x2 y2 ]`.
+     * @param page - logical page info object (`PdfPageObject`)
+     * @param annotPtr - pointer to the annotation whose line points are needed
+     * @param start - start point
+     * @param end - end point
+     * @returns true on success
+     */
+    private setLinePoints;
     /**
      * Read `/QuadPoints` from any annotation and convert each quadrilateral to
      * device-space coordinates.
@@ -857,6 +934,7 @@ declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      *          • `flags` – object with individual booleans
      */
     private getAnnotationFlags;
+    private setAnnotationFlags;
     /**
      * Read circle annotation
      * @param page  - pdf page infor
@@ -909,6 +987,31 @@ declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @private
      */
     private getAnnotString;
+    /**
+     * Fetches the /IT (Intent) name from an annotation as a UTF-8 JS string.
+     *
+     * Mirrors getAnnotString(): calls EPDFAnnot_GetIntent twice (length probe + copy).
+     * Returns `undefined` if no intent present.
+     */
+    private getAnnotIntent;
+    /**
+     * Write the `/IT` (Intent) name into an annotation dictionary.
+     *
+     * Mirrors EPDFAnnot_SetIntent in PDFium (expects a UTF‑8 FPDF_BYTESTRING).
+     *
+     * @param annotationPtr Pointer returned by FPDFPage_GetAnnot
+     * @param intent        Name without leading slash, e.g. `"PolygonCloud"`
+     *                      A leading “/” will be stripped for convenience.
+     * @returns             true on success, false otherwise
+     */
+    private setAnnotIntent;
+    /**
+     * Returns the rich‑content string stored in the annotation’s `/RC` entry.
+     *
+     * Works like `getAnnotIntent()`: first probe for length, then copy.
+     * `undefined` when the annotation has no rich content.
+     */
+    private getAnnotRichContent;
     /**
      * Set a string value (`/T`, `/M`, `/State`, …) to an annotation.
      *
@@ -927,6 +1030,17 @@ declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @private
      */
     private readPdfAnnoVertices;
+    /**
+     * Sync the vertices of a polygon or polyline annotation.
+     *
+     * @param page  - pdf page infor
+     * @param annotPtr - pointer to pdf annotation
+     * @param vertices - the vertices to be set
+     * @returns true on success
+     *
+     * @private
+     */
+    private setPdfAnnoVertices;
     /**
      * Read the target of pdf bookmark
      * @param docPtr - pointer to pdf document object
@@ -1141,171 +1255,3 @@ declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      */
     private searchAllInPage;
 }
-
-/**
- * Read string from WASM heap
- * @param wasmModule - pdfium wasm module instance
- * @param readChars - function to read chars
- * @param parseChars - function to parse chars
- * @param defaultLength - default length of chars that needs to read
- * @returns string from the heap
- *
- * @public
- */
-declare function readString(wasmModule: PdfiumRuntimeMethods & PdfiumModule, readChars: (buffer: number, bufferLength: number) => number, parseChars: (buffer: number) => string, defaultLength?: number): string;
-/**
- * Read arraybyffer from WASM heap
- * @param wasmModule - pdfium wasm module instance
- * @param readChars - function to read chars
- * @returns arraybuffer from the heap
- *
- * @public
- */
-declare function readArrayBuffer(wasmModule: PdfiumRuntimeMethods & PdfiumModule, readChars: (buffer: number, bufferLength: number) => number): ArrayBuffer;
-
-/**
- * Request body that represent method calls of PdfEngine, it contains the
- * method name and arguments
- */
-type PdfEngineMethodRequestBody = {
-    [P in PdfEngineMethodName]: {
-        name: P;
-        args: PdfEngineMethodArgs<P>;
-    };
-}[PdfEngineMethodName];
-/**
- * Response body that represent return value of PdfEngine
- */
-type PdfEngineMethodResponseBody = {
-    [P in PdfEngineMethodName]: TaskReturn<PdfEngineMethodReturnType<P>>;
-}[PdfEngineMethodName];
-/**
- * Request that abort the specified task
- */
-interface AbortRequest {
-    /**
-     * message id
-     */
-    id: string;
-    /**
-     * request type
-     */
-    type: 'AbortRequest';
-}
-/**
- * Request that execute pdf engine method
- */
-interface ExecuteRequest {
-    /**
-     * message id
-     */
-    id: string;
-    /**
-     * request type
-     */
-    type: 'ExecuteRequest';
-    /**
-     * request body
-     */
-    data: PdfEngineMethodRequestBody;
-}
-/**
- * Response that execute pdf engine method
- */
-interface ExecuteResponse {
-    /**
-     * message id
-     */
-    id: string;
-    /**
-     * response type
-     */
-    type: 'ExecuteResponse';
-    /**
-     * response body
-     */
-    data: PdfEngineMethodResponseBody;
-}
-/**
- * Response that indicate engine is ready
- */
-interface ReadyResponse {
-    /**
-     * message id
-     */
-    id: string;
-    /**
-     * response type
-     */
-    type: 'ReadyResponse';
-}
-/**
- * Request type
- */
-type Request = ExecuteRequest | AbortRequest;
-/**
- * Response type
- */
-type Response = ExecuteResponse | ReadyResponse;
-/**
- * Pdf engine runner, it will execute pdf engine based on the request it received and
- * send back the response with post message
- */
-declare class EngineRunner {
-    logger: Logger;
-    engine: PdfEngine | undefined;
-    /**
-     * Create instance of EngineRunnder
-     * @param logger - logger instance
-     */
-    constructor(logger?: Logger);
-    /**
-     * Listening on post message
-     */
-    listen(): void;
-    /**
-     * Handle post message
-     */
-    handle(evt: MessageEvent<Request>): void;
-    /**
-     * Send the ready response when pdf engine is ready
-     * @returns
-     *
-     * @protected
-     */
-    ready(): void;
-    /**
-     * Execute the request
-     * @param request - request that represent the pdf engine call
-     * @returns
-     *
-     * @protected
-     */
-    execute: (request: ExecuteRequest) => void;
-    /**
-     * Send back the response
-     * @param response - response that needs sent back
-     *
-     * @protected
-     */
-    respond(response: Response): void;
-}
-
-/**
- * EngineRunner for pdfium-based wasm engine
- */
-declare class PdfiumEngineRunner extends EngineRunner {
-    private wasmBinary;
-    /**
-     * Create an instance of PdfiumEngineRunner
-     * @param wasmBinary - wasm binary that contains the pdfium wasm file
-     */
-    constructor(wasmBinary: ArrayBuffer);
-    /**
-     * Initialize runner
-     */
-    prepare(): Promise<void>;
-}
-
-export { BitmapFormat, PdfiumEngine, PdfiumEngineRunner, PdfiumErrorCode, RenderFlag, browserImageDataToBlobConverter, readArrayBuffer, readString };
-export type { ImageDataConverter, SearchContext };

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

@@ -0,0 +1,21 @@
+import { PdfiumRuntimeMethods, PdfiumModule } from '@embedpdf/pdfium';
+/**
+ * Read string from WASM heap
+ * @param wasmModule - pdfium wasm module instance
+ * @param readChars - function to read chars
+ * @param parseChars - function to parse chars
+ * @param defaultLength - default length of chars that needs to read
+ * @returns string from the heap
+ *
+ * @public
+ */
+export declare function readString(wasmModule: PdfiumRuntimeMethods & PdfiumModule, readChars: (buffer: number, bufferLength: number) => number, parseChars: (buffer: number) => string, defaultLength?: number): string;
+/**
+ * Read arraybyffer from WASM heap
+ * @param wasmModule - pdfium wasm module instance
+ * @param readChars - function to read chars
+ * @returns arraybuffer from the heap
+ *
+ * @public
+ */
+export declare function readArrayBuffer(wasmModule: PdfiumRuntimeMethods & PdfiumModule, readChars: (buffer: number, bufferLength: number) => number): ArrayBuffer;

package/dist/lib/pdfium/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../../engine-BB5n-Wej.cjs"),e=require("../../runner-BBBtCHic.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.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

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

@@ -0,0 +1,3 @@
+export * from './engine';
+export * from './helper';
+export * from './runner';

package/dist/lib/pdfium/index.js

@@ -0,0 +1,13 @@
+import { B, a, P, R, b, c, r } from "../../engine-B0ZTENqz.js";
+import { P as P2 } from "../../runner-B-s0R7NN.js";
+export {
+  B as BitmapFormat,
+  a as PdfiumEngine,
+  P2 as PdfiumEngineRunner,
+  P as PdfiumErrorCode,
+  R as RenderFlag,
+  b as browserImageDataToBlobConverter,
+  c as readArrayBuffer,
+  r as readString
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/pdfium/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

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

@@ -0,0 +1,16 @@
+import { EngineRunner } from '../webworker/runner';
+/**
+ * EngineRunner for pdfium-based wasm engine
+ */
+export declare class PdfiumEngineRunner extends EngineRunner {
+    private wasmBinary;
+    /**
+     * Create an instance of PdfiumEngineRunner
+     * @param wasmBinary - wasm binary that contains the pdfium wasm file
+     */
+    constructor(wasmBinary: ArrayBuffer);
+    /**
+     * Initialize runner
+     */
+    prepare(): Promise<void>;
+}

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

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/pdfium"),i=require("../../../engine-BB5n-Wej.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.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-engine.cjs","sources":["../../../../src/lib/pdfium/web/direct-engine.ts"],"sourcesContent":["import { Logger } from '@embedpdf/models';\nimport { init } from '@embedpdf/pdfium';\n\nimport { PdfiumEngine } from '../engine';\n\nexport async function createPdfiumEngine(wasmUrl: string, logger?: Logger): Promise<PdfiumEngine> {\n  const response = await fetch(wasmUrl);\n  const wasmBinary = await response.arrayBuffer();\n  const wasmModule = await init({ wasmBinary });\n  return new PdfiumEngine(wasmModule, logger);\n}\n"],"names":["async","wasmUrl","logger","response","fetch","wasmBinary","arrayBuffer","wasmModule","init","PdfiumEngine"],"mappings":"yLAKsBA,eAAmBC,EAAiBC,GAClD,MAAAC,QAAiBC,MAAMH,GACvBI,QAAmBF,EAASG,cAC5BC,QAAmBC,OAAK,CAAEH,eACzB,OAAA,IAAII,EAAAA,aAAaF,EAAYL,EACtC"}

package/dist/lib/pdfium/web/direct-engine.d.ts

@@ -0,0 +1,3 @@
+import { Logger } from '@embedpdf/models';
+import { PdfiumEngine } from '../engine';
+export declare function createPdfiumEngine(wasmUrl: string, logger?: Logger): Promise<PdfiumEngine>;

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

@@ -0,0 +1,12 @@
+import { init } from "@embedpdf/pdfium";
+import { a as PdfiumEngine } from "../../../engine-B0ZTENqz.js";
+async function createPdfiumEngine(wasmUrl, logger) {
+  const response = await fetch(wasmUrl);
+  const wasmBinary = await response.arrayBuffer();
+  const wasmModule = await init({ wasmBinary });
+  return new PdfiumEngine(wasmModule, logger);
+}
+export {
+  createPdfiumEngine
+};
+//# sourceMappingURL=direct-engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"direct-engine.js","sources":["../../../../src/lib/pdfium/web/direct-engine.ts"],"sourcesContent":["import { Logger } from '@embedpdf/models';\nimport { init } from '@embedpdf/pdfium';\n\nimport { PdfiumEngine } from '../engine';\n\nexport async function createPdfiumEngine(wasmUrl: string, logger?: Logger): Promise<PdfiumEngine> {\n  const response = await fetch(wasmUrl);\n  const wasmBinary = await response.arrayBuffer();\n  const wasmModule = await init({ wasmBinary });\n  return new PdfiumEngine(wasmModule, logger);\n}\n"],"names":[],"mappings":";;AAKsB,eAAA,mBAAmB,SAAiB,QAAwC;AAC1F,QAAA,WAAW,MAAM,MAAM,OAAO;AAC9B,QAAA,aAAa,MAAM,SAAS,YAAY;AAC9C,QAAM,aAAa,MAAM,KAAK,EAAE,YAAY;AACrC,SAAA,IAAI,aAAa,YAAY,MAAM;AAC5C;"}