unpdf 1.4.0 → 1.5.0

package/dist/types/src/display/annotation_layer.d.ts

@@ -1,16 +1,16 @@
 export type PDFPageProxy = import("./api").PDFPageProxy;
 export type PageViewport = import("./display_utils").PageViewport;
 export type TextAccessibilityManager = import("../../web/text_accessibility.js").TextAccessibilityManager;
-export type IDownloadManager = import("../../web/interfaces").IDownloadManager;
-export type IPDFLinkService = import("../../web/interfaces").IPDFLinkService;
 export type AnnotationEditorUIManager = any;
 export type StructTreeLayerBuilder = import("../../web/struct_tree_layer_builder.js").StructTreeLayerBuilder;
 export type CommentManager = import("../../web/comment_manager.js").CommentManager;
+export type PDFLinkService = import("../../web/pdf_link_service.js").PDFLinkService;
+export type BaseDownloadManager = import("../../web/base_download_manager.js").BaseDownloadManager;
 export type AnnotationElementParameters = {
     data: Object;
     layer: HTMLDivElement;
-    linkService: IPDFLinkService;
-    downloadManager?: import("../../web/interfaces").IDownloadManager | undefined;
+    linkService: PDFLinkService;
+    downloadManager?: import("../../web/base_download_manager.js").BaseDownloadManager | undefined;
     annotationStorage?: AnnotationStorage | undefined;
     /**
      * - Path for image resources, mainly
@@ -28,8 +28,8 @@ export type AnnotationLayerParameters = {
     div: HTMLDivElement;
     annotations: any[];
     page: PDFPageProxy;
-    linkService: IPDFLinkService;
-    downloadManager?: import("../../web/interfaces").IDownloadManager | undefined;
+    linkService: PDFLinkService;
+    downloadManager?: import("../../web/base_download_manager.js").BaseDownloadManager | undefined;
     annotationStorage?: AnnotationStorage | undefined;
     /**
      * - Path for image resources, mainly
@@ -64,8 +64,8 @@ export type AnnotationLayerParameters = {
  * @property {HTMLDivElement} div
  * @property {Array} annotations
  * @property {PDFPageProxy} page
- * @property {IPDFLinkService} linkService
- * @property {IDownloadManager} [downloadManager]
+ * @property {PDFLinkService} linkService
+ * @property {BaseDownloadManager} [downloadManager]
  * @property {AnnotationStorage} [annotationStorage]
  * @property {string} [imageResourcesPath] - Path for image resources, mainly
  *   for annotation icons. Include trailing slash.
@@ -119,8 +119,6 @@ export class AnnotationLayer {
      * Add link annotations to the annotation layer.
      *
      * @param {Array<Object>} annotations
-     * @param {IPDFLinkService} linkService
-     * @memberof AnnotationLayer
      */
     addLinkAnnotations(annotations: Array<Object>): Promise<void>;
     /**
@@ -130,9 +128,12 @@ export class AnnotationLayer {
      * @memberof AnnotationLayer
      */
     update({ viewport }: AnnotationLayerParameters): void;
-    getEditableAnnotations(): any[];
+    getEditableAnnotations(): MapIterator<any>;
     getEditableAnnotation(id: any): any;
     addFakeAnnotation(editor: any): EditorAnnotationElement;
+    removeAnnotation(id: any): void;
+    updateFakeAnnotations(editors: any): void;
+    togglePointerEvents(enabled?: boolean): void;
     #private;
 }
 export class FreeTextAnnotationElement extends AnnotationElement {
@@ -193,6 +194,8 @@ declare class AnnotationElement {
     hasJSActions: any;
     _fieldObjects: any;
     parent: any;
+    hasOwnCommentButton: boolean;
+    contentElement: HTMLElement | undefined;
     container: HTMLElement | undefined;
     get _isEditable(): any;
     get hasPopupData(): any;

package/dist/types/src/display/annotation_storage.d.ts

@@ -2,9 +2,9 @@
  * Key/value storage for annotation data in forms.
  */
 export class AnnotationStorage {
-    onSetModified: any;
-    onResetModified: any;
-    onAnnotationEditor: any;
+    onSetModified: null;
+    onResetModified: null;
+    onAnnotationEditor: null;
     /**
      * Get the value for a given key if it exists, or return the default value.
      * @param {string} key
@@ -79,11 +79,11 @@ export class PrintAnnotationStorage extends AnnotationStorage {
      * PLEASE NOTE: Only intended for usage within the API itself.
      * @ignore
      */
-    get serializable(): {
-        map: any;
-        hash: any;
-        transfer: any;
-    };
+    get serializable(): Readonly<{
+        map: null;
+        hash: "";
+        transfer: undefined;
+    }>;
     get modifiedIds(): any;
     #private;
 }

package/dist/types/src/display/api.d.ts

@@ -36,11 +36,6 @@ export type DocumentInitParameters = {
      * - For decrypting password-protected PDFs.
      */
     password?: string | undefined;
-    /**
-     * - The PDF file length. It's used for progress
-     * reports and range requests operations.
-     */
-    length?: number | undefined;
     /**
      * - Allows for using a custom range
      * transport implementation.
@@ -77,12 +72,6 @@ export type DocumentInitParameters = {
      * packed or not. The default value is `true`.
      */
     cMapPacked?: boolean | undefined;
-    /**
-     * - The factory that will be used when
-     * reading built-in CMap files.
-     * The default value is {DOMCMapReaderFactory}.
-     */
-    CMapReaderFactory?: Object | undefined;
     /**
      * - The URL where the predefined ICC profiles are
      * located. Include the trailing slash.
@@ -101,28 +90,15 @@ export type DocumentInitParameters = {
      * files are located. Include the trailing slash.
      */
     standardFontDataUrl?: string | undefined;
-    /**
-     * - The factory that will be used
-     * when reading the standard font files.
-     * The default value is {DOMStandardFontDataFactory}.
-     */
-    StandardFontDataFactory?: Object | undefined;
     /**
      * - The URL where the wasm files are located.
      * Include the trailing slash.
      */
     wasmUrl?: string | undefined;
-    /**
-     * - The factory that will be used
-     * when reading the wasm files.
-     * The default value is {DOMWasmFactory}.
-     */
-    WasmFactory?: Object | undefined;
     /**
      * - Enable using the Fetch API in the
-     * worker-thread when reading CMap and standard font files. When `true`,
-     * the `CMapReaderFactory`, `StandardFontDataFactory`, and `WasmFactory`
-     * options are ignored.
+     * worker-thread when reading built-in CMap files, standard font files,
+     * and wasm files. If `true`, the `BinaryDataFactory` option is ignored.
      * The default value is `true` in web environments and `false` in Node.js.
      */
     useWorkerFetch?: boolean | undefined;
@@ -246,11 +222,24 @@ export type DocumentInitParameters = {
      * The default value is {DOMFilterFactory}.
      */
     FilterFactory?: Object | undefined;
+    /**
+     * - The factory that will be used when
+     * falling back to reading built-in CMap files, standard font files,
+     * and wasm files in the main-thread.
+     * The default value is {DOMBinaryDataFactory}.
+     */
+    BinaryDataFactory?: Object | undefined;
     /**
      * - Enables hardware acceleration for
      * rendering. The default value is `false`.
      */
     enableHWA?: boolean | undefined;
+    /**
+     * - The pages mapper that will be used to map
+     * page ids and page numbers. It's used when the page order is changed or some
+     * pages are removed, cloned, etc.
+     */
+    pagesMapper?: Object | undefined;
 };
 export type OnProgressParameters = {
     /**
@@ -261,6 +250,11 @@ export type OnProgressParameters = {
      * - Total number of bytes in the PDF file.
      */
     total: number;
+    /**
+     * - Currently loaded percentage, as an integer value
+     * in the [0, 100] range. If `total` is undefined, the percentage is `NaN`.
+     */
+    percent: number;
 };
 /**
  * Page getViewport parameters.
@@ -492,6 +486,10 @@ export type RenderParameters = {
      * - Render the page in editing mode.
      */
     isEditing?: boolean | undefined;
+    /**
+     * - Record the location of images in the PDF
+     */
+    recordImages?: boolean | undefined;
     /**
      * - Record the dependencies and bounding
      * boxes of all PDF operations that render onto the canvas.
@@ -624,8 +622,6 @@ export const build: string;
  *   cross-site Access-Control requests should be made using credentials such
  *   as cookies or authorization headers. The default is `false`.
  * @property {string} [password] - For decrypting password-protected PDFs.
- * @property {number} [length] - The PDF file length. It's used for progress
- *   reports and range requests operations.
  * @property {PDFDataRangeTransport} [range] - Allows for using a custom range
  *   transport implementation.
  * @property {number} [rangeChunkSize] - Specify maximum number of bytes fetched
@@ -641,9 +637,6 @@ export const build: string;
  *   located. Include the trailing slash.
  * @property {boolean} [cMapPacked] - Specifies if the Adobe CMaps are binary
  *   packed or not. The default value is `true`.
- * @property {Object} [CMapReaderFactory] - The factory that will be used when
- *   reading built-in CMap files.
- *   The default value is {DOMCMapReaderFactory}.
  * @property {string} [iccUrl] - The URL where the predefined ICC profiles are
  *   located. Include the trailing slash.
  * @property {boolean} [useSystemFonts] - When `true`, fonts that aren't
@@ -653,18 +646,11 @@ export const build: string;
  *   regardless of the environment (to prevent completely broken fonts).
  * @property {string} [standardFontDataUrl] - The URL where the standard font
  *   files are located. Include the trailing slash.
- * @property {Object} [StandardFontDataFactory] - The factory that will be used
- *   when reading the standard font files.
- *   The default value is {DOMStandardFontDataFactory}.
  * @property {string} [wasmUrl] - The URL where the wasm files are located.
  *   Include the trailing slash.
- * @property {Object} [WasmFactory] - The factory that will be used
- *   when reading the wasm files.
- *   The default value is {DOMWasmFactory}.
  * @property {boolean} [useWorkerFetch] - Enable using the Fetch API in the
- *   worker-thread when reading CMap and standard font files. When `true`,
- *   the `CMapReaderFactory`, `StandardFontDataFactory`, and `WasmFactory`
- *   options are ignored.
+ *   worker-thread when reading built-in CMap files, standard font files,
+ *   and wasm files. If `true`, the `BinaryDataFactory` option is ignored.
  *   The default value is `true` in web environments and `false` in Node.js.
  * @property {boolean} [useWasm] - Attempt to use WebAssembly in order to
  *    improve e.g. image decoding performance.
@@ -736,8 +722,15 @@ export const build: string;
  * @property {Object} [FilterFactory] - The factory that will be used to
  *    create SVG filters when rendering some images on the main canvas.
  *    The default value is {DOMFilterFactory}.
+ * @property {Object} [BinaryDataFactory] - The factory that will be used when
+ *   falling back to reading built-in CMap files, standard font files,
+ *   and wasm files in the main-thread.
+ *   The default value is {DOMBinaryDataFactory}.
  * @property {boolean} [enableHWA] - Enables hardware acceleration for
  *   rendering. The default value is `false`.
+ * @property {Object} [pagesMapper] - The pages mapper that will be used to map
+ *   page ids and page numbers. It's used when the page order is changed or some
+ *   pages are removed, cloned, etc.
  */
 /**
  * This is the main entry point for loading a PDF and interacting with it.
@@ -775,10 +768,6 @@ export class PDFDataRangeTransport {
      * @param {function} listener
      */
     addRangeListener(listener: Function): void;
-    /**
-     * @param {function} listener
-     */
-    addProgressListener(listener: Function): void;
     /**
      * @param {function} listener
      */
@@ -792,11 +781,6 @@ export class PDFDataRangeTransport {
      * @param {Uint8Array|null} chunk
      */
     onDataRange(begin: number, chunk: Uint8Array | null): void;
-    /**
-     * @param {number} loaded
-     * @param {number|undefined} total
-     */
-    onDataProgress(loaded: number, total: number | undefined): void;
     /**
      * @param {Uint8Array|null} chunk
      */
@@ -815,6 +799,8 @@ export class PDFDataRangeTransport {
  * @typedef {Object} OnProgressParameters
  * @property {number} loaded - Currently loaded number of bytes.
  * @property {number} total - Total number of bytes in the PDF file.
+ * @property {number} percent - Currently loaded percentage, as an integer value
+ *   in the [0, 100] range. If `total` is undefined, the percentage is `NaN`.
  */
 /**
  * The loading task controls the operations required to load a PDF document
@@ -822,7 +808,7 @@ export class PDFDataRangeTransport {
  * after which individual pages can be rendered.
  */
 export class PDFDocumentLoadingTask {
-    static #docId: number;
+    static "__#private@#docId": number;
     /**
      * @private
      */
@@ -885,6 +871,10 @@ export class PDFDocumentProxy {
     constructor(pdfInfo: any, transport: any);
     _pdfInfo: any;
     _transport: any;
+    /**
+     * @type {PagesMapper} The pages mapper instance.
+     */
+    get pagesMapper(): PagesMapper;
     /**
      * @type {AnnotationStorage} Storage for annotation data in forms.
      */
@@ -1100,6 +1090,30 @@ export class PDFDocumentProxy {
      *   {Uint8Array} containing the full data of the saved document.
      */
     saveDocument(): Promise<Uint8Array>;
+    /**
+     * @typedef {Object} PageInfo
+     * @property {null|Uint8Array} document
+     * @property {Array<Array<number>|number>} [includePages]
+     *  included ranges or indices.
+     * @property {Array<Array<number>|number>} [excludePages]
+     *  excluded ranges or indices.
+     */
+    /**
+     * @param {Array<PageInfo>} pageInfos - The pages to extract.
+     * @returns {Promise<Uint8Array>} A promise that is resolved with a
+     *   {Uint8Array} containing the full data of the saved document.
+     */
+    extractPages(pageInfos: Array<{
+        document: null | Uint8Array;
+        /**
+         * included ranges or indices.
+         */
+        includePages?: (number | number[])[] | undefined;
+        /**
+         * excluded ranges or indices.
+         */
+        excludePages?: (number | number[])[] | undefined;
+    }>): Promise<Uint8Array>;
     /**
      * @returns {Promise<{ length: number }>} A promise that is resolved when the
      *   document's data is loaded. It is resolved with an {Object} that contains
@@ -1108,6 +1122,7 @@ export class PDFDocumentProxy {
     getDownloadInfo(): Promise<{
         length: number;
     }>;
+    getRawData(data: any): any;
     /**
      * Cleans up resources allocated by the document on both the main and worker
      * threads.
@@ -1283,6 +1298,7 @@ export class PDFDocumentProxy {
  *   annotation ids with canvases used to render them.
  * @property {PrintAnnotationStorage} [printAnnotationStorage]
  * @property {boolean} [isEditing] - Render the page in editing mode.
+ * @property {boolean} [recordImages] - Record the location of images in the PDF
  * @property {boolean} [recordOperations] - Record the dependencies and bounding
  *   boxes of all PDF operations that render onto the canvas.
  * @property {OperationsFilter} [operationsFilter] - If provided, only
@@ -1343,7 +1359,7 @@ export class PDFDocumentProxy {
  * Proxy to a `PDFPage` in the worker thread.
  */
 export class PDFPageProxy {
-    constructor(pageIndex: any, pageInfo: any, transport: any, pdfBug?: boolean);
+    constructor(pageIndex: any, pageInfo: any, transport: any, pagesMapper: any, pdfBug?: boolean);
     _pageIndex: any;
     _pageInfo: any;
     _transport: any;
@@ -1355,6 +1371,12 @@ export class PDFPageProxy {
     _intentStates: Map<any, any>;
     destroyed: boolean;
     recordedBBoxes: any;
+    imageCoordinates: any;
+    clone(id: any): PDFPageProxy;
+    /**
+     * @param {number} value - The page number to set. First page is 1.
+     */
+    set pageNumber(value: number);
     /**
      * @type {number} Page number of the page. First page is 1.
      */
@@ -1415,7 +1437,7 @@ export class PDFPageProxy {
      * @returns {RenderTask} An object that contains a promise that is
      *   resolved when the page finishes rendering.
      */
-    render({ canvasContext, canvas, viewport, intent, annotationMode, transform, background, optionalContentConfigPromise, annotationCanvasMap, pageColors, printAnnotationStorage, isEditing, recordOperations, operationsFilter, }: RenderParameters): RenderTask;
+    render({ canvasContext, canvas, viewport, intent, annotationMode, transform, background, optionalContentConfigPromise, annotationCanvasMap, pageColors, printAnnotationStorage, isEditing, recordImages, recordOperations, operationsFilter, }: RenderParameters): RenderTask;
     /**
      * @param {GetOperatorListParameters} params - Page getOperatorList
      *   parameters.
@@ -1498,9 +1520,9 @@ export class PDFPageProxy {
  * @param {PDFWorkerParameters} params - The worker initialization parameters.
  */
 export class PDFWorker {
-    static #fakeWorkerId: number;
-    static #isWorkerDisabled: boolean;
-    static #workerPorts: WeakMap<object, any>;
+    static "__#private@#fakeWorkerId": number;
+    static "__#private@#isWorkerDisabled": boolean;
+    static "__#private@#workerPorts": WeakMap<object, any>;
     /**
      * @param {PDFWorkerParameters} params - The worker initialization parameters.
      * @returns {PDFWorker}
@@ -1511,7 +1533,7 @@ export class PDFWorker {
      * @type {string}
      */
     static get workerSrc(): string;
-    static get #mainThreadWorkerMessageHandler(): any;
+    static get "__#private@#mainThreadWorkerMessageHandler"(): any;
     static get _setupFakeWorkerGlobal(): any;
     constructor({ name, port, verbosity, }?: {
         name?: null | undefined;
@@ -1547,6 +1569,7 @@ export class PDFWorker {
  */
 export class RenderTask {
     constructor(internalRenderTask: any);
+    _internalRenderTask: null;
     /**
      * Callback for incremental rendering -- a function that will be called
      * each time the rendering is paused.  To continue rendering call the
@@ -1581,13 +1604,14 @@ export class RenderTask {
      * @type {boolean}
      */
     get separateAnnots(): boolean;
-    #private;
+    get imageCoordinates(): any;
 }
 /** @type {string} */
 export const version: string;
 import { PageViewport } from "./display_utils.js";
 import { OptionalContentConfig } from "./optional_content_config.js";
 import { PrintAnnotationStorage } from "./annotation_storage.js";
+import { PagesMapper } from "./pages_mapper.js";
 import { AnnotationStorage } from "./annotation_storage.js";
 import { Metadata } from "./metadata.js";
 import { StatTimer } from "./display_utils.js";

package/dist/types/src/display/api_utils.d.ts

@@ -1,6 +1,6 @@
 export function getDataProp(val: any): Uint8Array<any>;
 export function getFactoryUrlProp(val: any): string | null;
-export function getUrlProp(val: any): string | null;
+export function getUrlProp(val: any): URL | null;
 export function isNameProxy(v: any): boolean;
 export function isRefProxy(v: any): boolean;
 export const isValidExplicitDest: (dest?: any) => boolean;

package/dist/types/src/display/binary_data_factory.d.ts

@@ -0,0 +1,26 @@
+export class BaseBinaryDataFactory {
+    constructor({ cMapUrl, standardFontDataUrl, wasmUrl }: {
+        cMapUrl?: null | undefined;
+        standardFontDataUrl?: null | undefined;
+        wasmUrl?: null | undefined;
+    });
+    cMapUrl: any;
+    standardFontDataUrl: any;
+    wasmUrl: any;
+    fetch({ kind, filename }: {
+        kind: any;
+        filename: any;
+    }): Promise<Uint8Array<ArrayBufferLike>>;
+    /**
+     * @ignore
+     * @returns {Promise<Uint8Array>}
+     */
+    _fetch(url: any, kind: any): Promise<Uint8Array>;
+    #private;
+}
+export class DOMBinaryDataFactory extends BaseBinaryDataFactory {
+    /**
+     * @ignore
+     */
+    _fetch(url: any, kind: any): Promise<Uint8Array<any>>;
+}

package/dist/types/src/display/canvas.d.ts

@@ -2,14 +2,12 @@ export class CanvasGraphics {
     constructor(canvasCtx: any, commonObjs: any, objs: any, canvasFactory: any, filterFactory: any, { optionalContentConfig, markedContentStack }: {
         optionalContentConfig: any;
         markedContentStack?: null | undefined;
-    }, annotationCanvasMap: any, pageColors: any, dependencyTracker: any);
+    }, annotationCanvasMap: any, pageColors: any, dependencyTracker: any, imagesTracker: any);
     ctx: any;
     current: CanvasExtraState;
     stateStack: any[];
     pendingClip: {} | {} | null;
     pendingEOFill: boolean;
-    res: any;
-    xobjs: any;
     commonObjs: any;
     objs: any;
     canvasFactory: any;
@@ -21,11 +19,11 @@ export class CanvasGraphics {
     smaskStack: any[];
     smaskCounter: number;
     tempSMask: any;
+    smaskGroupCanvases: any[];
     suspendedCtx: any;
     contentVisible: boolean;
     markedContentStack: never[];
     optionalContentConfig: any;
-    cachedCanvases: CachedCanvases;
     cachedPatterns: Map<any, any>;
     annotationCanvasMap: any;
     viewportScale: number;
@@ -36,6 +34,7 @@ export class CanvasGraphics {
     _cachedGetSinglePixelWidth: number | null;
     _cachedBitmapsMap: Map<any, any>;
     dependencyTracker: any;
+    imagesTracker: any;
     getObject(opIdx: any, data: any, fallback?: null): any;
     beginDrawing({ transform, viewport, transparency, background, }: {
         transform: any;
@@ -43,19 +42,27 @@ export class CanvasGraphics {
         transparency?: boolean | undefined;
         background?: null | undefined;
     }): void;
+    transparentCanvasEntry: any;
     compositeCtx: any;
-    transparentCanvas: any;
     executeOperatorList(operatorList: any, executionStartIdx: any, continueCallback: any, stepper: any, operationsFilter: any): any;
+    transparentCanvas: any;
     endDrawing(): void;
     _scaleImage(img: any, inverseTransform: any): {
         img: any;
         paintWidth: any;
         paintHeight: any;
+        tmpCanvas: any;
     };
     _createMaskCanvas(opIdx: any, img: any): {
         canvas: any;
         offsetX: number;
         offsetY: number;
+        canvasEntry?: undefined;
+    } | {
+        canvas: any;
+        canvasEntry: any;
+        offsetX: number;
+        offsetY: number;
     };
     setLineWidth(opIdx: any, width: any): void;
     setLineCap(opIdx: any, style: any): void;
@@ -77,6 +84,7 @@ export class CanvasGraphics {
      * the right order on the canvas' graphics state stack.
      */
     beginSMaskMode(opIdx: any): void;
+    smaskScratchCanvas: any;
     endSMaskMode(): void;
     compose(dirtyBox: any): void;
     composeSMask(ctx: any, smask: any, layerCtx: any, layerBox: any): void;
@@ -142,7 +150,10 @@ export class CanvasGraphics {
     paintImageXObject(opIdx: any, objId: any): void;
     paintImageXObjectRepeat(opIdx: any, objId: any, scaleX: any, scaleY: any, positions: any): void;
     applyTransferMapsToCanvas(ctx: any): any;
-    applyTransferMapsToBitmap(imgData: any): any;
+    applyTransferMapsToBitmap(imgData: any): {
+        img: any;
+        canvasEntry: any;
+    };
     paintInlineImageXObject(opIdx: any, imgData: any): void;
     paintInlineImageXObjectGroup(opIdx: any, imgData: any, map: any): void;
     paintSolidColorImageMask(opIdx: any): void;
@@ -161,7 +172,7 @@ export class CanvasGraphics {
     #private;
 }
 declare class CanvasExtraState {
-    constructor(width: any, height: any, preInit: any);
+    constructor(width: any, height: any);
     alphaIsShape: boolean;
     fontSize: number;
     fontSizeScale: number;
@@ -187,8 +198,8 @@ declare class CanvasExtraState {
     lineWidth: number;
     activeSMask: null;
     transferMaps: string;
-    clipBox: Float32Array<ArrayBuffer>;
     minMax: Float32Array<ArrayBuffer>;
+    clipBox: Float32Array<ArrayBuffer>;
     clone(): any;
     getPathBoundingBox(pathType?: string, transform?: null): Float32Array<ArrayBuffer>;
     updateClipFromPath(): void;
@@ -196,12 +207,4 @@ declare class CanvasExtraState {
     startNewPathAndClipBox(box: any): void;
     getClippedPathBoundingBox(pathType?: string, transform?: null): number[] | null;
 }
-declare class CachedCanvases {
-    constructor(canvasFactory: any);
-    canvasFactory: any;
-    cache: any;
-    getCanvas(id: any, width: any, height: any): any;
-    delete(id: any): void;
-    clear(): void;
-}
 export {};