unpdf 1.6.2 → 1.8.0

package/dist/index.d.cts

@@ -1,12 +1,10 @@
-import * as _napi_rs_canvas from '@napi-rs/canvas';
-import { Canvas, CanvasRenderingContext2D } from '@napi-rs/canvas';
-import { DocumentInitParameters, PDFDocumentProxy } from './types/src/display/api';
-import * as pdfjs_dist_types_src_display_metadata from './types/src/display/metadata';
-import * as PDFJS from './types/src/pdf';
-
+import { DocumentInitParameters, PDFDocumentProxy } from "./types/src/display/api.js";
+import { Canvas, SKRSContext2D } from "@napi-rs/canvas";
+import * as PDFJS from "./types/src/pdf.js";
+//#region src/_internal/canvas.d.ts
 interface CanvasFactoryContext {
-    canvas?: HTMLCanvasElement | Canvas;
-    context?: CanvasRenderingContext2D | CanvasRenderingContext2D;
+  canvas?: HTMLCanvasElement | Canvas;
+  context?: CanvasRenderingContext2D | SKRSContext2D | null;
 }
 /**
  * Derived from the PDF.js project by the Mozilla Foundation.
@@ -14,17 +12,17 @@ interface CanvasFactoryContext {
  * @license Apache-2.0
  */
 declare class BaseCanvasFactory {
-    #private;
-    constructor({ enableHWA }?: {
-        enableHWA?: boolean | undefined;
-    });
-    create(width: number, height: number): {
-        canvas: Canvas | HTMLCanvasElement;
-        context: _napi_rs_canvas.SKRSContext2D | globalThis.CanvasRenderingContext2D | null;
-    };
-    reset({ canvas }: CanvasFactoryContext, width: number, height: number): void;
-    destroy(context: CanvasFactoryContext): void;
-    _createCanvas(width: number, height: number): HTMLCanvasElement | Canvas;
+  #private;
+  constructor({ enableHWA }?: {
+    enableHWA?: boolean | undefined;
+  });
+  create(width: number, height: number): {
+    canvas: Canvas | HTMLCanvasElement;
+    context: SKRSContext2D | CanvasRenderingContext2D | null;
+  };
+  reset({ canvas }: CanvasFactoryContext, width: number, height: number): void;
+  destroy(context: CanvasFactoryContext): void;
+  _createCanvas(width: number, height: number): HTMLCanvasElement | Canvas;
 }
 /**
  * Derived from the PDF.js project by the Mozilla Foundation.
@@ -32,26 +30,27 @@ declare class BaseCanvasFactory {
  * @license Apache-2.0
  */
 declare class DOMCanvasFactory extends BaseCanvasFactory {
-    _document: Document;
-    constructor({ ownerDocument, enableHWA }?: {
-        ownerDocument?: Document | undefined;
-        enableHWA?: boolean | undefined;
-    });
-    _createCanvas(width: number, height: number): HTMLCanvasElement;
+  _document: Document;
+  constructor({ ownerDocument, enableHWA }?: {
+    ownerDocument?: Document | undefined;
+    enableHWA?: boolean | undefined;
+  });
+  _createCanvas(width: number, height: number): HTMLCanvasElement;
 }
 declare class NodeCanvasFactory extends BaseCanvasFactory {
-    constructor({ enableHWA }?: {
-        enableHWA?: boolean | undefined;
-    });
-    _createCanvas(width: number, height: number): Canvas;
+  constructor({ enableHWA }?: {
+    enableHWA?: boolean | undefined;
+  });
+  _createCanvas(width: number, height: number): Canvas;
 }
-
+//#endregion
+//#region src/image.d.ts
 interface ExtractedImageObject {
-    data: Uint8ClampedArray;
-    width: number;
-    height: number;
-    channels: 1 | 3 | 4;
-    key: string;
+  data: Uint8ClampedArray;
+  width: number;
+  height: number;
+  channels: 1 | 3 | 4;
+  key: string;
 }
 /**
  * Extracts images from a specific page of a PDF document, including necessary metadata,
@@ -71,72 +70,82 @@ interface ExtractedImageObject {
  */
 declare function extractImages$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number): Promise<ExtractedImageObject[]>;
 declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number, options?: {
-    canvasImport?: () => Promise<typeof _napi_rs_canvas>;
-    /** @default 1.0 */
-    scale?: number;
-    width?: number;
-    height?: number;
-    toDataURL?: false;
+  canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>;
+  /** @default 1.0 */
+  scale?: number;
+  width?: number;
+  height?: number;
+  toDataURL?: false;
 }): Promise<ArrayBuffer>;
 declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number, options: {
-    canvasImport?: () => Promise<typeof _napi_rs_canvas>;
-    /** @default 1.0 */
-    scale?: number;
-    width?: number;
-    height?: number;
-    toDataURL: true;
+  canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>;
+  /** @default 1.0 */
+  scale?: number;
+  width?: number;
+  height?: number;
+  toDataURL: true;
 }): Promise<string>;
-declare function createIsomorphicCanvasFactory(canvasImport?: () => Promise<typeof _napi_rs_canvas>): Promise<typeof DOMCanvasFactory | typeof NodeCanvasFactory>;
-
+declare function createIsomorphicCanvasFactory(canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>): Promise<typeof DOMCanvasFactory | typeof NodeCanvasFactory>;
+//#endregion
+//#region src/links.d.ts
 declare function extractLinks$1(data: DocumentInitParameters['data'] | PDFDocumentProxy): Promise<{
-    totalPages: number;
-    links: string[];
+  totalPages: number;
+  links: string[];
 }>;
-
+//#endregion
+//#region src/meta.d.ts
 declare function getMeta$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options?: {
-    parseDates?: boolean;
+  parseDates?: boolean;
 }): Promise<{
-    info: Record<string, any>;
-    metadata: pdfjs_dist_types_src_display_metadata.Metadata;
+  info: Record<string, any>;
+  metadata: import("./types/src/display/metadata.js").Metadata;
 }>;
-
+//#endregion
+//#region src/text.d.ts
 interface StructuredTextItem {
-    /** Text content. */
-    str: string;
-    /** X position in PDF coordinate space (origin: bottom-left). */
-    x: number;
-    /** Y position in PDF coordinate space (origin: bottom-left). */
-    y: number;
-    /** Width in device space. */
-    width: number;
-    /** Height in device space. */
-    height: number;
-    /** Font size derived from the transformation matrix. */
-    fontSize: number;
-    /** Font family name. */
-    fontFamily: string;
-    /** Text direction: `"ltr"`, `"rtl"`, or `"ttb"`. */
-    dir: string;
-    /** Whether the text item is followed by a line break. */
-    hasEOL: boolean;
+  /** Text content. */
+  str: string;
+  /** X position in PDF coordinate space (origin: bottom-left). */
+  x: number;
+  /** Y position in PDF coordinate space (origin: bottom-left). */
+  y: number;
+  /** Width in device space. */
+  width: number;
+  /** Height in device space. */
+  height: number;
+  /** Font size derived from the transformation matrix. */
+  fontSize: number;
+  /** Font family name. */
+  fontFamily: string;
+  /** Text direction: `"ltr"`, `"rtl"`, or `"ttb"`. */
+  dir: string;
+  /** Whether the text item is followed by a line break. */
+  hasEOL: boolean;
 }
 declare function extractTextItems$1(data: DocumentInitParameters['data'] | PDFDocumentProxy): Promise<{
-    totalPages: number;
-    items: StructuredTextItem[][];
+  totalPages: number;
+  items: StructuredTextItem[][];
 }>;
 declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options?: {
-    mergePages?: false;
+  mergePages?: false;
 }): Promise<{
-    totalPages: number;
-    text: string[];
+  totalPages: number;
+  text: string[];
 }>;
 declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options: {
-    mergePages: true;
+  mergePages: true;
 }): Promise<{
-    totalPages: number;
-    text: string;
+  totalPages: number;
+  text: string;
 }>;
-
+declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options?: {
+  mergePages?: boolean;
+}): Promise<{
+  totalPages: number;
+  text: string | string[];
+}>;
+//#endregion
+//#region src/config.d.ts
 /**
  * By default, unpdf will use the latest version of PDF.js compiled for
  * serverless environments. If you want to use a different version, you can
@@ -151,32 +160,33 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
 declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
 /** @deprecated Use `definePDFJSModule` instead. Will be removed in v2. */
 declare function configureUnPDF(options: {
-    pdfjs?: () => Promise<any>;
+  pdfjs?: () => Promise<any>;
 }): Promise<void>;
-
+//#endregion
+//#region src/utils.d.ts
 /**
  * Returns a PDFDocumentProxy instance from a given binary data.
  *
  * Applies the following defaults:
- * - `isEvalSupported: false`
  * - `useSystemFonts: true`
  *
  * In Node.js environments, additionally applies:
  * - `disableFontFace: true`
  * - `standardFontDataUrl` resolved from the local `pdfjs-dist` package
+ * - `cMapUrl` and `cMapPacked` resolved from the local `pdfjs-dist` package
  */
 declare function getDocumentProxy(data: DocumentInitParameters['data'], options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
 declare function resolvePDFJSImport(pdfjsResolver?: () => Promise<any>, { reload }?: {
-    reload?: boolean | undefined;
+  reload?: boolean | undefined;
 }): Promise<void>;
-
+//#endregion
+//#region src/index.d.ts
 declare const getMeta: typeof getMeta$1;
 declare const extractText: typeof extractText$1;
 declare const extractTextItems: typeof extractTextItems$1;
 declare const extractImages: typeof extractImages$1;
 declare const renderPageAsImage: typeof renderPageAsImage$1;
 declare const extractLinks: typeof extractLinks$1;
-
-export { configureUnPDF, createIsomorphicCanvasFactory, definePDFJSModule, extractImages, extractLinks, extractText, extractTextItems, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };
-export type { StructuredTextItem };
+//#endregion
+export { type StructuredTextItem, configureUnPDF, createIsomorphicCanvasFactory, definePDFJSModule, extractImages, extractLinks, extractText, extractTextItems, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };

package/dist/index.d.mts

@@ -1,12 +1,10 @@
-import * as _napi_rs_canvas from '@napi-rs/canvas';
-import { Canvas, CanvasRenderingContext2D } from '@napi-rs/canvas';
-import { DocumentInitParameters, PDFDocumentProxy } from './types/src/display/api';
-import * as pdfjs_dist_types_src_display_metadata from './types/src/display/metadata';
-import * as PDFJS from './types/src/pdf';
-
+import { DocumentInitParameters, PDFDocumentProxy } from "./types/src/display/api.js";
+import { Canvas, SKRSContext2D } from "@napi-rs/canvas";
+import * as PDFJS from "./types/src/pdf.js";
+//#region src/_internal/canvas.d.ts
 interface CanvasFactoryContext {
-    canvas?: HTMLCanvasElement | Canvas;
-    context?: CanvasRenderingContext2D | CanvasRenderingContext2D;
+  canvas?: HTMLCanvasElement | Canvas;
+  context?: CanvasRenderingContext2D | SKRSContext2D | null;
 }
 /**
  * Derived from the PDF.js project by the Mozilla Foundation.
@@ -14,17 +12,17 @@ interface CanvasFactoryContext {
  * @license Apache-2.0
  */
 declare class BaseCanvasFactory {
-    #private;
-    constructor({ enableHWA }?: {
-        enableHWA?: boolean | undefined;
-    });
-    create(width: number, height: number): {
-        canvas: Canvas | HTMLCanvasElement;
-        context: _napi_rs_canvas.SKRSContext2D | globalThis.CanvasRenderingContext2D | null;
-    };
-    reset({ canvas }: CanvasFactoryContext, width: number, height: number): void;
-    destroy(context: CanvasFactoryContext): void;
-    _createCanvas(width: number, height: number): HTMLCanvasElement | Canvas;
+  #private;
+  constructor({ enableHWA }?: {
+    enableHWA?: boolean | undefined;
+  });
+  create(width: number, height: number): {
+    canvas: Canvas | HTMLCanvasElement;
+    context: SKRSContext2D | CanvasRenderingContext2D | null;
+  };
+  reset({ canvas }: CanvasFactoryContext, width: number, height: number): void;
+  destroy(context: CanvasFactoryContext): void;
+  _createCanvas(width: number, height: number): HTMLCanvasElement | Canvas;
 }
 /**
  * Derived from the PDF.js project by the Mozilla Foundation.
@@ -32,26 +30,27 @@ declare class BaseCanvasFactory {
  * @license Apache-2.0
  */
 declare class DOMCanvasFactory extends BaseCanvasFactory {
-    _document: Document;
-    constructor({ ownerDocument, enableHWA }?: {
-        ownerDocument?: Document | undefined;
-        enableHWA?: boolean | undefined;
-    });
-    _createCanvas(width: number, height: number): HTMLCanvasElement;
+  _document: Document;
+  constructor({ ownerDocument, enableHWA }?: {
+    ownerDocument?: Document | undefined;
+    enableHWA?: boolean | undefined;
+  });
+  _createCanvas(width: number, height: number): HTMLCanvasElement;
 }
 declare class NodeCanvasFactory extends BaseCanvasFactory {
-    constructor({ enableHWA }?: {
-        enableHWA?: boolean | undefined;
-    });
-    _createCanvas(width: number, height: number): Canvas;
+  constructor({ enableHWA }?: {
+    enableHWA?: boolean | undefined;
+  });
+  _createCanvas(width: number, height: number): Canvas;
 }
-
+//#endregion
+//#region src/image.d.ts
 interface ExtractedImageObject {
-    data: Uint8ClampedArray;
-    width: number;
-    height: number;
-    channels: 1 | 3 | 4;
-    key: string;
+  data: Uint8ClampedArray;
+  width: number;
+  height: number;
+  channels: 1 | 3 | 4;
+  key: string;
 }
 /**
  * Extracts images from a specific page of a PDF document, including necessary metadata,
@@ -71,72 +70,82 @@ interface ExtractedImageObject {
  */
 declare function extractImages$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number): Promise<ExtractedImageObject[]>;
 declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number, options?: {
-    canvasImport?: () => Promise<typeof _napi_rs_canvas>;
-    /** @default 1.0 */
-    scale?: number;
-    width?: number;
-    height?: number;
-    toDataURL?: false;
+  canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>;
+  /** @default 1.0 */
+  scale?: number;
+  width?: number;
+  height?: number;
+  toDataURL?: false;
 }): Promise<ArrayBuffer>;
 declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number, options: {
-    canvasImport?: () => Promise<typeof _napi_rs_canvas>;
-    /** @default 1.0 */
-    scale?: number;
-    width?: number;
-    height?: number;
-    toDataURL: true;
+  canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>;
+  /** @default 1.0 */
+  scale?: number;
+  width?: number;
+  height?: number;
+  toDataURL: true;
 }): Promise<string>;
-declare function createIsomorphicCanvasFactory(canvasImport?: () => Promise<typeof _napi_rs_canvas>): Promise<typeof DOMCanvasFactory | typeof NodeCanvasFactory>;
-
+declare function createIsomorphicCanvasFactory(canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>): Promise<typeof DOMCanvasFactory | typeof NodeCanvasFactory>;
+//#endregion
+//#region src/links.d.ts
 declare function extractLinks$1(data: DocumentInitParameters['data'] | PDFDocumentProxy): Promise<{
-    totalPages: number;
-    links: string[];
+  totalPages: number;
+  links: string[];
 }>;
-
+//#endregion
+//#region src/meta.d.ts
 declare function getMeta$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options?: {
-    parseDates?: boolean;
+  parseDates?: boolean;
 }): Promise<{
-    info: Record<string, any>;
-    metadata: pdfjs_dist_types_src_display_metadata.Metadata;
+  info: Record<string, any>;
+  metadata: import("./types/src/display/metadata.js").Metadata;
 }>;
-
+//#endregion
+//#region src/text.d.ts
 interface StructuredTextItem {
-    /** Text content. */
-    str: string;
-    /** X position in PDF coordinate space (origin: bottom-left). */
-    x: number;
-    /** Y position in PDF coordinate space (origin: bottom-left). */
-    y: number;
-    /** Width in device space. */
-    width: number;
-    /** Height in device space. */
-    height: number;
-    /** Font size derived from the transformation matrix. */
-    fontSize: number;
-    /** Font family name. */
-    fontFamily: string;
-    /** Text direction: `"ltr"`, `"rtl"`, or `"ttb"`. */
-    dir: string;
-    /** Whether the text item is followed by a line break. */
-    hasEOL: boolean;
+  /** Text content. */
+  str: string;
+  /** X position in PDF coordinate space (origin: bottom-left). */
+  x: number;
+  /** Y position in PDF coordinate space (origin: bottom-left). */
+  y: number;
+  /** Width in device space. */
+  width: number;
+  /** Height in device space. */
+  height: number;
+  /** Font size derived from the transformation matrix. */
+  fontSize: number;
+  /** Font family name. */
+  fontFamily: string;
+  /** Text direction: `"ltr"`, `"rtl"`, or `"ttb"`. */
+  dir: string;
+  /** Whether the text item is followed by a line break. */
+  hasEOL: boolean;
 }
 declare function extractTextItems$1(data: DocumentInitParameters['data'] | PDFDocumentProxy): Promise<{
-    totalPages: number;
-    items: StructuredTextItem[][];
+  totalPages: number;
+  items: StructuredTextItem[][];
 }>;
 declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options?: {
-    mergePages?: false;
+  mergePages?: false;
 }): Promise<{
-    totalPages: number;
-    text: string[];
+  totalPages: number;
+  text: string[];
 }>;
 declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options: {
-    mergePages: true;
+  mergePages: true;
 }): Promise<{
-    totalPages: number;
-    text: string;
+  totalPages: number;
+  text: string;
 }>;
-
+declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, options?: {
+  mergePages?: boolean;
+}): Promise<{
+  totalPages: number;
+  text: string | string[];
+}>;
+//#endregion
+//#region src/config.d.ts
 /**
  * By default, unpdf will use the latest version of PDF.js compiled for
  * serverless environments. If you want to use a different version, you can
@@ -151,32 +160,33 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
 declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
 /** @deprecated Use `definePDFJSModule` instead. Will be removed in v2. */
 declare function configureUnPDF(options: {
-    pdfjs?: () => Promise<any>;
+  pdfjs?: () => Promise<any>;
 }): Promise<void>;
-
+//#endregion
+//#region src/utils.d.ts
 /**
  * Returns a PDFDocumentProxy instance from a given binary data.
  *
  * Applies the following defaults:
- * - `isEvalSupported: false`
  * - `useSystemFonts: true`
  *
  * In Node.js environments, additionally applies:
  * - `disableFontFace: true`
  * - `standardFontDataUrl` resolved from the local `pdfjs-dist` package
+ * - `cMapUrl` and `cMapPacked` resolved from the local `pdfjs-dist` package
  */
 declare function getDocumentProxy(data: DocumentInitParameters['data'], options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
 declare function resolvePDFJSImport(pdfjsResolver?: () => Promise<any>, { reload }?: {
-    reload?: boolean | undefined;
+  reload?: boolean | undefined;
 }): Promise<void>;
-
+//#endregion
+//#region src/index.d.ts
 declare const getMeta: typeof getMeta$1;
 declare const extractText: typeof extractText$1;
 declare const extractTextItems: typeof extractTextItems$1;
 declare const extractImages: typeof extractImages$1;
 declare const renderPageAsImage: typeof renderPageAsImage$1;
 declare const extractLinks: typeof extractLinks$1;
-
-export { configureUnPDF, createIsomorphicCanvasFactory, definePDFJSModule, extractImages, extractLinks, extractText, extractTextItems, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };
-export type { StructuredTextItem };
+//#endregion
+export { type StructuredTextItem, configureUnPDF, createIsomorphicCanvasFactory, definePDFJSModule, extractImages, extractLinks, extractText, extractTextItems, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };