unpdf 1.8.0 → 1.9.0

package/README.md

@@ -91,7 +91,7 @@ console.log(await document.getMetadata())
 ## How It Works
 
 > [!NOTE]
-> The serverless PDF.js bundle is built from PDF.js v5.6.205.
+> The serverless PDF.js bundle is built from PDF.js v6.4.299. It requires the global `Iterator` constructor (Safari 18.4+); without it, importing the bundle throws.
 
 Heart and soul of this package is the [`pdfjs.rolldown.config.ts`](./pdfjs.rolldown.config.ts) file. It uses [Rolldown](https://rolldown.rs/) to bundle PDF.js into a single file for serverless environments. The key techniques:
 

package/dist/index.cjs

@@ -53,7 +53,7 @@ let resolvedModule;
 const isNode = globalThis.process?.release?.name === "node";
 const isBrowser = typeof window !== "undefined";
 /**
-* Returns a PDFDocumentProxy instance from a given binary data.
+* Returns a `PDFDocumentProxy` instance from a given binary data.
 *
 * Applies the following defaults:
 * - `useSystemFonts: true`

package/dist/index.d.cts

@@ -85,7 +85,7 @@ declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFD
   height?: number;
   toDataURL: true;
 }): Promise<string>;
-declare function createIsomorphicCanvasFactory(canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>): Promise<typeof DOMCanvasFactory | typeof NodeCanvasFactory>;
+export 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<{
@@ -115,7 +115,7 @@ interface StructuredTextItem {
   height: number;
   /** Font size derived from the transformation matrix. */
   fontSize: number;
-  /** Font family name. */
+  /** Font family resolved from the page's style table, empty when unknown. */
   fontFamily: string;
   /** Text direction: `"ltr"`, `"rtl"`, or `"ttb"`. */
   dir: string;
@@ -157,15 +157,15 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
  *
  * await definePDFJSModule(() => import('pdfjs-dist'))
  */
-declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
+export declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
 /** @deprecated Use `definePDFJSModule` instead. Will be removed in v2. */
-declare function configureUnPDF(options: {
+export declare function configureUnPDF(options: {
   pdfjs?: () => Promise<any>;
 }): Promise<void>;
 //#endregion
 //#region src/utils.d.ts
 /**
- * Returns a PDFDocumentProxy instance from a given binary data.
+ * Returns a `PDFDocumentProxy` instance from a given binary data.
  *
  * Applies the following defaults:
  * - `useSystemFonts: true`
@@ -175,18 +175,18 @@ declare function configureUnPDF(options: {
  * - `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 }?: {
+export declare function getDocumentProxy(data: DocumentInitParameters['data'], options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
+export declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
+export declare function resolvePDFJSImport(pdfjsResolver?: () => Promise<any>, { reload }?: {
   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 declare const getMeta: typeof getMeta$1;
+export declare const extractText: typeof extractText$1;
+export declare const extractTextItems: typeof extractTextItems$1;
+export declare const extractImages: typeof extractImages$1;
+export declare const renderPageAsImage: typeof renderPageAsImage$1;
+export declare const extractLinks: typeof extractLinks$1;
 //#endregion
-export { type StructuredTextItem, configureUnPDF, createIsomorphicCanvasFactory, definePDFJSModule, extractImages, extractLinks, extractText, extractTextItems, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };
+export type { StructuredTextItem };

package/dist/index.d.mts

@@ -85,7 +85,7 @@ declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFD
   height?: number;
   toDataURL: true;
 }): Promise<string>;
-declare function createIsomorphicCanvasFactory(canvasImport?: () => Promise<typeof import('@napi-rs/canvas')>): Promise<typeof DOMCanvasFactory | typeof NodeCanvasFactory>;
+export 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<{
@@ -115,7 +115,7 @@ interface StructuredTextItem {
   height: number;
   /** Font size derived from the transformation matrix. */
   fontSize: number;
-  /** Font family name. */
+  /** Font family resolved from the page's style table, empty when unknown. */
   fontFamily: string;
   /** Text direction: `"ltr"`, `"rtl"`, or `"ttb"`. */
   dir: string;
@@ -157,15 +157,15 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
  *
  * await definePDFJSModule(() => import('pdfjs-dist'))
  */
-declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
+export declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
 /** @deprecated Use `definePDFJSModule` instead. Will be removed in v2. */
-declare function configureUnPDF(options: {
+export declare function configureUnPDF(options: {
   pdfjs?: () => Promise<any>;
 }): Promise<void>;
 //#endregion
 //#region src/utils.d.ts
 /**
- * Returns a PDFDocumentProxy instance from a given binary data.
+ * Returns a `PDFDocumentProxy` instance from a given binary data.
  *
  * Applies the following defaults:
  * - `useSystemFonts: true`
@@ -175,18 +175,18 @@ declare function configureUnPDF(options: {
  * - `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 }?: {
+export declare function getDocumentProxy(data: DocumentInitParameters['data'], options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
+export declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
+export declare function resolvePDFJSImport(pdfjsResolver?: () => Promise<any>, { reload }?: {
   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 declare const getMeta: typeof getMeta$1;
+export declare const extractText: typeof extractText$1;
+export declare const extractTextItems: typeof extractTextItems$1;
+export declare const extractImages: typeof extractImages$1;
+export declare const renderPageAsImage: typeof renderPageAsImage$1;
+export declare const extractLinks: typeof extractLinks$1;
 //#endregion
-export { type StructuredTextItem, configureUnPDF, createIsomorphicCanvasFactory, definePDFJSModule, extractImages, extractLinks, extractText, extractTextItems, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };
+export type { StructuredTextItem };

package/dist/index.mjs

@@ -52,7 +52,7 @@ let resolvedModule;
 const isNode = globalThis.process?.release?.name === "node";
 const isBrowser = typeof window !== "undefined";
 /**
-* Returns a PDFDocumentProxy instance from a given binary data.
+* Returns a `PDFDocumentProxy` instance from a given binary data.
 *
 * Applies the following defaults:
 * - `useSystemFonts: true`