modern-pdf-lib 0.14.0 → 0.15.0

package/dist/index.d.mts

@@ -3162,6 +3162,15 @@ declare class PdfEncryptionHandler {
   private readonly perms?;
   /** The file ID (first element of /ID array). */
   private readonly fileId;
+  /**
+   * Cache for per-object derived keys (V=1-4 only).
+   * Key: `(objNum << 16) | genNum` — unique integer per object.
+   * Value: the derived encryption key.
+   *
+   * Avoids recomputing MD5(fileKey + objNum + genNum [+ sAlT]) for
+   * every string and stream in the same object.
+   */
+  private readonly objectKeyCache;
   private constructor();
   /**
    * Create a new encryption handler for encrypting a document.
@@ -3580,6 +3589,33 @@ declare class PdfViewerPreferences {
  *
  * @packageDocumentation
  */
+/**
+ * Options for a visible signature appearance on the page.
+ */
+interface VisibleSignatureOptions {
+  /** Zero-based page index where the signature should appear. Default: 0. */
+  pageIndex?: number | undefined;
+  /** Rectangle [x, y, width, height] in PDF points from the bottom-left corner. */
+  rect: [number, number, number, number];
+  /**
+   * Text lines to display in the signature box.
+   * Each string becomes a separate line. If omitted, auto-generates
+   * from the signer name, reason, location, and date.
+   */
+  text?: string[] | undefined;
+  /** Font size for the text. Default: 10. */
+  fontSize?: number | undefined;
+  /**
+   * Background color as [r, g, b] values (0–1). Default: transparent.
+   */
+  backgroundColor?: [number, number, number] | undefined;
+  /**
+   * Border color as [r, g, b] values (0–1). Default: [0, 0, 0] (black).
+   */
+  borderColor?: [number, number, number] | undefined;
+  /** Border width in points. Default: 1. Set to 0 for no border. */
+  borderWidth?: number | undefined;
+}
 /**
  * Options for signing a PDF.
  */
@@ -3598,6 +3634,12 @@ interface SignOptions {
   contactInfo?: string | undefined;
   /** RFC 3161 TSA URL for timestamping (optional). */
   timestampUrl?: string | undefined;
+  /**
+   * Visible signature appearance options. When provided, the signature
+   * field is rendered visibly on the specified page with text and
+   * optional styling. When omitted, the signature is invisible.
+   */
+  appearance?: VisibleSignatureOptions | undefined;
 }
 /**
  * Information about an existing signature in a PDF.
@@ -4738,6 +4780,24 @@ declare class PdfDocument {
    * @returns         An {@link ImageRef}.
    */
   embedJpeg(jpegData: Uint8Array | ArrayBuffer): Promise<ImageRef>;
+  /**
+   * Embed an image, auto-detecting the format from file headers.
+   *
+   * Inspects the first bytes to determine whether the data is PNG or JPEG,
+   * then delegates to {@link embedPng} or {@link embedJpeg} accordingly.
+   *
+   * @param imageData  Raw image file bytes (PNG or JPEG).
+   * @returns          An {@link ImageRef} to pass to `page.drawImage()`.
+   * @throws           If the image format cannot be detected.
+   *
+   * @example
+   * ```ts
+   * const bytes = new Uint8Array(await readFile('photo.jpg'));
+   * const image = await pdf.embedImage(bytes);
+   * page.drawImage(image, { x: 50, y: 400, width: 200, height: 150 });
+   * ```
+   */
+  embedImage(imageData: Uint8Array | ArrayBuffer): Promise<ImageRef>;
   /**
    * Embed pages from another PDF as Form XObjects.
    *
@@ -6724,6 +6784,9 @@ interface EncryptDictValues {
  * Tries the password as both user and owner password. Returns the key
  * on the first successful match, or throws if neither works.
  *
+ * Results are cached so that re-opening the same PDF with the same
+ * password skips the expensive key derivation.
+ *
  * @param password  The password to try.
  * @param dict      Encryption dictionary values.
  * @param fileId    The first element of the /ID array (unused for R>=5).
@@ -7459,6 +7522,151 @@ declare class PdfRedactAnnotation extends PdfAnnotation {
   setQuadPoints(points: number[]): void;
 }
 //#endregion
+//#region src/annotation/types/popupAnnotation.d.ts
+/**
+ * A popup annotation (subtype /Popup).
+ *
+ * Displays a floating window containing the text of its parent
+ * annotation. The parent annotation references this popup via its
+ * `/Popup` entry, and this popup references its parent via `/Parent`.
+ */
+declare class PdfPopupAnnotation extends PdfAnnotation {
+  constructor(dict: PdfDict);
+  /**
+   * Create a new popup annotation.
+   *
+   * @param options.open  Whether the popup is initially open. Default: false.
+   * @param options.parent  Reference to the parent annotation (set after registration).
+   */
+  static create(options: AnnotationOptions & {
+    open?: boolean | undefined;
+  }): PdfPopupAnnotation;
+  /**
+   * Create a PdfPopupAnnotation from an existing dictionary.
+   */
+  static fromDict(dict: PdfDict, _resolver?: (ref: PdfRef) => PdfObject | undefined): PdfPopupAnnotation;
+  /** Whether the popup is initially open. */
+  isOpen(): boolean;
+  /** Set the initial open state. */
+  setOpen(open: boolean): void;
+  /**
+   * Set the parent annotation reference.
+   * The parent is the annotation whose text this popup displays.
+   */
+  setParent(parentRef: PdfRef): void;
+  /** Get the parent annotation reference, if set. */
+  getParent(): PdfRef | undefined;
+}
+//#endregion
+//#region src/annotation/types/caretAnnotation.d.ts
+/**
+ * Symbol displayed by the caret annotation.
+ *
+ * - `'None'` — No symbol (just the caret marker).
+ * - `'P'` — A paragraph symbol, indicating a new paragraph should
+ *   be inserted at this location.
+ */
+type CaretSymbol = 'None' | 'P';
+/**
+ * A caret annotation (subtype /Caret).
+ *
+ * Marks an insertion point in the text. Used in review workflows
+ * to indicate where new content should be added.
+ */
+declare class PdfCaretAnnotation extends PdfAnnotation {
+  constructor(dict: PdfDict);
+  /**
+   * Create a new caret annotation.
+   *
+   * @param options.symbol  The caret symbol. Default: 'None'.
+   * @param options.caretRect  The inner rectangle (RD) that describes
+   *   the difference between the annotation rect and the actual caret
+   *   position. Format: [left, bottom, right, top] insets.
+   */
+  static create(options: AnnotationOptions & {
+    symbol?: CaretSymbol | undefined;
+    caretRect?: [number, number, number, number] | undefined;
+  }): PdfCaretAnnotation;
+  /**
+   * Create a PdfCaretAnnotation from an existing dictionary.
+   */
+  static fromDict(dict: PdfDict, _resolver?: (ref: PdfRef) => PdfObject | undefined): PdfCaretAnnotation;
+  /** Get the caret symbol. Defaults to 'None'. */
+  getSymbol(): CaretSymbol;
+  /** Set the caret symbol. */
+  setSymbol(symbol: CaretSymbol): void;
+  /**
+   * Get the inner rectangle differences (RD entry).
+   * Returns [left, bottom, right, top] insets from the annotation rect.
+   */
+  getCaretRect(): [number, number, number, number] | undefined;
+  /** Set the inner rectangle differences (RD entry). */
+  setCaretRect(rd: [number, number, number, number]): void;
+}
+//#endregion
+//#region src/annotation/types/fileAttachmentAnnotation.d.ts
+/**
+ * Standard icon names for file attachment annotations.
+ *
+ * - `'GraphPushPin'` — A push pin on a graph (default).
+ * - `'PaperclipTag'` — A paper clip with a tag.
+ * - `'Paperclip'` — A paper clip.
+ * - `'Tag'` — A tag label.
+ */
+type FileAttachmentIcon = 'GraphPushPin' | 'PaperclipTag' | 'Paperclip' | 'Tag';
+/**
+ * A file attachment annotation (subtype /FileAttachment).
+ *
+ * Embeds a file directly in the annotation, rendered as a clickable
+ * icon on the page. When the user clicks the icon, the PDF viewer
+ * allows them to open or save the embedded file.
+ */
+declare class PdfFileAttachmentAnnotation extends PdfAnnotation {
+  /** The raw file data to embed. */
+  private fileData;
+  /** The filename to display. */
+  private fileName;
+  /** Optional MIME type. */
+  private mimeType;
+  /** Optional file description. */
+  private fileDescription;
+  constructor(dict: PdfDict);
+  /**
+   * Create a new file attachment annotation.
+   *
+   * @param options.file       The file data to embed.
+   * @param options.fileName   The filename (e.g., 'invoice.xml').
+   * @param options.mimeType   Optional MIME type (e.g., 'application/xml').
+   * @param options.description Optional description of the file.
+   * @param options.icon       Icon to display. Default: 'GraphPushPin'.
+   */
+  static create(options: AnnotationOptions & {
+    file: Uint8Array;
+    fileName: string;
+    mimeType?: string | undefined;
+    description?: string | undefined;
+    icon?: FileAttachmentIcon | undefined;
+  }): PdfFileAttachmentAnnotation;
+  /**
+   * Create a PdfFileAttachmentAnnotation from an existing dictionary.
+   */
+  static fromDict(dict: PdfDict, _resolver?: (ref: PdfRef) => PdfObject | undefined): PdfFileAttachmentAnnotation;
+  /** Get the icon name. Defaults to 'GraphPushPin'. */
+  getIcon(): FileAttachmentIcon;
+  /** Set the icon name. */
+  setIcon(icon: FileAttachmentIcon): void;
+  /** Get the filename, if set. */
+  getFileName(): string | undefined;
+  /**
+   * Build the file specification dictionary and register the embedded
+   * file stream. Call this before serializing the annotation.
+   *
+   * @param registry  The document's object registry.
+   * @returns  The annotation dict with `/FS` referencing the file.
+   */
+  buildFileSpec(registry: PdfObjectRegistry): PdfDict;
+}
+//#endregion
 //#region src/annotation/appearanceGenerator.d.ts
 /**
  * Generate appearance stream for a Square annotation.
@@ -7680,7 +7888,25 @@ interface ByteRangeResult {
  * @param placeholderSize    Size in bytes for the signature. Default 8192.
  * @returns                  The prepared PDF and ByteRange info.
  */
-declare function prepareForSigning(pdfBytes: Uint8Array, signatureFieldName: string, placeholderSize?: number): {
+/**
+ * Options for visible signature appearance within the byte-range preparation.
+ * @internal
+ */
+interface PrepareAppearanceOptions {
+  /** Page rectangle [x, y, width, height]. */
+  rect: [number, number, number, number];
+  /** Lines of text to render inside the signature box. */
+  textLines: string[];
+  /** Font size. Default: 10. */
+  fontSize?: number | undefined;
+  /** Background [r,g,b]. Default: none. */
+  backgroundColor?: [number, number, number] | undefined;
+  /** Border [r,g,b]. Default: [0,0,0]. */
+  borderColor?: [number, number, number] | undefined;
+  /** Border width. Default: 1. */
+  borderWidth?: number | undefined;
+}
+declare function prepareForSigning(pdfBytes: Uint8Array, signatureFieldName: string, placeholderSize?: number, appearance?: PrepareAppearanceOptions | undefined): {
   preparedPdf: Uint8Array;
   byteRange: ByteRangeResult;
 };
@@ -8080,6 +8306,650 @@ declare function validatePdfA(pdfBytes: Uint8Array, level: PdfALevel): PdfAValid
  */
 declare function enforcePdfA(pdfBytes: Uint8Array, level: PdfALevel): Promise<Uint8Array>;
 //#endregion
+//#region src/wasm/jpeg/bridge.d.ts
+/**
+ * @module wasm/jpeg/bridge
+ *
+ * TypeScript bridge for the JPEG WASM encoder/decoder module.
+ *
+ * Provides JPEG encoding (raw pixels → JPEG bytes) and decoding (JPEG bytes →
+ * raw pixels) via a Rust WASM module compiled with wasm-bindgen.
+ *
+ * If the WASM module is not available, all functions fail gracefully and
+ * callers should fall back to JS alternatives.
+ *
+ * No Buffer — uses Uint8Array exclusively.
+ */
+/** Pre-built wasm-bindgen module interface (when passed directly). */
+interface JpegWasmModule {
+  encode_jpeg(pixels: Uint8Array, width: number, height: number, channels: number, quality: number, progressive: boolean, chroma_subsampling: number): Uint8Array;
+  decode_jpeg(data: Uint8Array): Uint8Array;
+}
+/**
+ * Chroma subsampling modes for JPEG encoding.
+ *
+ * - `'4:4:4'`: No subsampling — best quality, largest file.
+ * - `'4:2:2'`: Horizontal subsampling — good balance.
+ * - `'4:2:0'`: Both directions — smallest file, default for most encoders.
+ */
+type ChromaSubsampling = '4:4:4' | '4:2:2' | '4:2:0';
+/** Result of decoding a JPEG image. */
+interface JpegDecodeResult {
+  /** Raw pixel data (row-major, channel-interleaved). */
+  readonly pixels: Uint8Array;
+  /** Image width in pixels. */
+  readonly width: number;
+  /** Image height in pixels. */
+  readonly height: number;
+  /** Number of channels (1=grayscale, 3=RGB). */
+  readonly channels: number;
+}
+/**
+ * Initialize the JPEG WASM module.
+ *
+ * @param wasmSource - The WASM binary as `Uint8Array`, URL, `Response`,
+ *                     or a pre-built wasm-bindgen module.  When omitted,
+ *                     the function uses the universal WASM loader.
+ */
+declare function initJpegWasm(wasmSource?: JpegWasmModule | Uint8Array | URL | string | Response): Promise<void>;
+/**
+ * Check whether the JPEG WASM module has been initialized.
+ *
+ * @returns `true` if {@link initJpegWasm} completed successfully.
+ */
+declare function isJpegWasmReady(): boolean;
+/**
+ * Encode raw pixel data to JPEG using the WASM encoder.
+ *
+ * @param pixels   - Raw pixel data (row-major, channel-interleaved).
+ * @param width    - Image width in pixels.
+ * @param height   - Image height in pixels.
+ * @param channels - Number of channels: 1 (grayscale), 3 (RGB), or 4 (RGBA).
+ * @param quality  - JPEG quality 1–100.
+ * @param progressive - Encode as progressive JPEG (default: false).
+ * @param chroma   - Chroma subsampling mode (default: '4:2:0').
+ * @returns JPEG-encoded bytes, or `undefined` if WASM is not available.
+ */
+declare function encodeJpegWasm(pixels: Uint8Array, width: number, height: number, channels: 1 | 3 | 4, quality: number, progressive?: boolean, chroma?: ChromaSubsampling): Uint8Array | undefined;
+/**
+ * Decode JPEG bytes to raw pixel data using the WASM decoder.
+ *
+ * The WASM module returns a flat byte array with layout:
+ * `[width_u32_le, height_u32_le, channels_u8, ...pixels]`.
+ *
+ * @param jpegBytes - JPEG-encoded image data.
+ * @returns Decoded pixel data with metadata, or `undefined` if WASM is not
+ *          available or decoding failed.
+ */
+declare function decodeJpegWasm(jpegBytes: Uint8Array): JpegDecodeResult | undefined;
+//#endregion
+//#region src/assets/image/imageOptimize.d.ts
+/**
+ * Options for image downscaling.
+ */
+interface DownscaleOptions {
+  /** Target maximum width in pixels.  The image is scaled proportionally. */
+  readonly maxWidth?: number;
+  /** Target maximum height in pixels.  The image is scaled proportionally. */
+  readonly maxHeight?: number;
+  /**
+   * Target DPI for the image at its intended print size.  If specified
+   * along with `printWidth` / `printHeight`, the image is downscaled
+   * to match the target DPI.
+   *
+   * For example, a 3000×2000 image printed at 10×6.67 inches would be
+   * 300 DPI.  Setting `targetDpi: 150` would downscale to 1500×1000.
+   */
+  readonly targetDpi?: number;
+  /**
+   * Intended print width in points (1/72 inch).
+   * Used together with `targetDpi` to compute the target pixel dimensions.
+   */
+  readonly printWidth?: number;
+  /**
+   * Intended print height in points (1/72 inch).
+   * Used together with `targetDpi` to compute the target pixel dimensions.
+   */
+  readonly printHeight?: number;
+  /**
+   * Resampling algorithm.
+   * - `'nearest'`: Nearest-neighbor (fast, blocky)
+   * - `'bilinear'`: Bilinear interpolation (good quality, moderate speed)
+   * - `'lanczos'`: Lanczos-3 resampling (best quality, slowest)
+   *
+   * Default: `'bilinear'`.
+   */
+  readonly algorithm?: 'nearest' | 'bilinear' | 'lanczos';
+}
+/**
+ * Options for image recompression.
+ */
+interface RecompressOptions {
+  /**
+   * Output format.
+   * - `'jpeg'`: JPEG compression (lossy, good for photographs)
+   * - `'deflate'`: Deflate/zlib compression (lossless, used in PDF FlateDecode)
+   *
+   * Default: `'deflate'`.
+   */
+  readonly format?: 'jpeg' | 'deflate';
+  /**
+   * JPEG quality (1–100).  Only used when `format` is `'jpeg'`.
+   * Higher values produce larger files with better quality.
+   *
+   * Default: `85`.
+   */
+  readonly quality?: number;
+  /**
+   * Deflate compression level (1–9).  Only used when `format` is `'deflate'`.
+   * Higher values produce smaller files but take longer.
+   *
+   * Default: `6`.
+   */
+  readonly compressionLevel?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+  /**
+   * Encode as progressive JPEG.  Only used when `format` is `'jpeg'`.
+   *
+   * Progressive JPEGs render in multiple passes (low-res → full-res)
+   * which improves perceived loading speed on slow connections.
+   * They are also often slightly smaller than baseline JPEGs.
+   *
+   * Requires the JPEG WASM module to be initialized.
+   *
+   * Default: `false`.
+   */
+  readonly progressive?: boolean;
+  /**
+   * Chroma subsampling mode.  Only used when `format` is `'jpeg'`.
+   *
+   * - `'4:4:4'`: No subsampling — best color fidelity, largest file.
+   * - `'4:2:2'`: Horizontal subsampling — good balance.
+   * - `'4:2:0'`: Both horizontal and vertical — smallest file.
+   *
+   * Requires the JPEG WASM module to be initialized.
+   *
+   * Default: `'4:2:0'`.
+   */
+  readonly chromaSubsampling?: ChromaSubsampling;
+}
+/**
+ * Combined options for the full optimization pipeline.
+ */
+interface ImageOptimizeOptions extends DownscaleOptions, RecompressOptions {
+  /**
+   * Skip optimization if the input data is already smaller than this
+   * threshold (in bytes).
+   *
+   * Default: `0` (always optimize).
+   */
+  readonly skipBelowBytes?: number;
+}
+/**
+ * Raw image pixel data with metadata.
+ */
+interface RawImageData {
+  /** Pixel data in row-major order, channel-interleaved. */
+  readonly pixels: Uint8Array;
+  /** Image width in pixels. */
+  readonly width: number;
+  /** Image height in pixels. */
+  readonly height: number;
+  /**
+   * Number of channels:
+   * - 1: Grayscale
+   * - 2: Grayscale + Alpha
+   * - 3: RGB
+   * - 4: RGBA or CMYK (see `colorSpace`)
+   */
+  readonly channels: 1 | 2 | 3 | 4;
+  /** Bits per channel (typically 8). */
+  readonly bitsPerChannel: number;
+  /**
+   * Color space of the pixel data.
+   *
+   * - `'rgb'` — Channels are R, G, B (and optionally A).
+   * - `'cmyk'` — Channels are C, M, Y, K (only when `channels` is 4).
+   *   CMYK pixels are converted to RGB before JPEG encoding.
+   * - `'gray'` — Grayscale (only when `channels` is 1 or 2).
+   *
+   * Default: inferred from channel count (`1|2 → 'gray'`, `3|4 → 'rgb'`).
+   */
+  readonly colorSpace?: 'rgb' | 'cmyk' | 'gray';
+}
+/**
+ * The result of an optimization operation.
+ */
+interface OptimizeResult {
+  /** The optimized pixel data (or compressed data if recompressed). */
+  readonly data: Uint8Array;
+  /** Output width in pixels. */
+  readonly width: number;
+  /** Output height in pixels. */
+  readonly height: number;
+  /** Number of channels in the output. */
+  readonly channels: number;
+  /** The compression format applied, if any. */
+  readonly format: 'raw' | 'jpeg' | 'deflate';
+  /** Whether any actual optimization was performed. */
+  readonly wasOptimized: boolean;
+}
+/**
+ * Downscale an image to fit within the specified dimensions.
+ *
+ * If the image is already smaller than the target dimensions, it is
+ * returned unchanged.
+ *
+ * @param image   - The raw image pixel data.
+ * @param options - Downscaling options (target dimensions, algorithm).
+ * @returns The downscaled image, or the original if no scaling needed.
+ *
+ * @example
+ * ```ts
+ * const result = downscaleImage(rawImage, {
+ *   maxWidth: 1024,
+ *   maxHeight: 768,
+ *   algorithm: 'bilinear',
+ * });
+ * ```
+ */
+declare function downscaleImage(image: RawImageData, options?: DownscaleOptions): RawImageData;
+/**
+ * Recompress raw image pixel data using the specified format.
+ *
+ * @param image   - The raw image pixel data.
+ * @param options - Recompression options (format, quality).
+ * @returns The compressed image data.
+ *
+ * @example
+ * ```ts
+ * const result = await recompressImage(rawImage, {
+ *   format: 'deflate',
+ *   compressionLevel: 9,
+ * });
+ * ```
+ */
+declare function recompressImage(image: RawImageData, options?: RecompressOptions): Promise<OptimizeResult>;
+/**
+ * Run the full image optimization pipeline: downscale then recompress.
+ *
+ * @param image   - The raw image pixel data.
+ * @param options - Combined optimization options.
+ * @returns The optimized result.
+ */
+declare function optimizeImage(image: RawImageData, options?: ImageOptimizeOptions): Promise<OptimizeResult>;
+/**
+ * Estimate the JPEG quality level (1–100) from the quantization tables
+ * embedded in a JPEG file.
+ *
+ * Parses the DQT (Define Quantization Table, marker 0xFFDB) segments
+ * from the raw JPEG bytes and compares the table values against the
+ * standard JPEG luminance quantization table to estimate the quality
+ * factor that was used during encoding.
+ *
+ * If no DQT marker is found, returns `undefined`.
+ *
+ * @param jpegBytes - Raw JPEG file bytes.
+ * @returns Estimated quality 1–100, or `undefined` if no DQT is found.
+ *
+ * @example
+ * ```ts
+ * import { estimateJpegQuality } from 'modern-pdf-lib';
+ *
+ * const quality = estimateJpegQuality(jpegBytes);
+ * if (quality !== undefined) {
+ *   console.log(`Estimated JPEG quality: ${quality}`);
+ * }
+ * ```
+ */
+declare function estimateJpegQuality(jpegBytes: Uint8Array): number | undefined;
+//#endregion
+//#region src/assets/image/imageExtract.d.ts
+/**
+ * Information about a single image XObject in a PDF document.
+ */
+interface ImageInfo {
+  /** The PdfStream object for this image (can be mutated for in-place optimization). */
+  readonly stream: PdfStream;
+  /** The indirect reference to this stream in the registry. */
+  readonly ref: PdfRef;
+  /** Resource name on the page (e.g. '/Im1'). */
+  readonly name: string;
+  /** Zero-based page index where this image appears. */
+  readonly pageIndex: number;
+  /** Image width in pixels. */
+  readonly width: number;
+  /** Image height in pixels. */
+  readonly height: number;
+  /** Bits per component (typically 8). */
+  readonly bitsPerComponent: number;
+  /** PDF color space name (e.g. 'DeviceRGB', 'DeviceGray', 'DeviceCMYK'). */
+  readonly colorSpace: string;
+  /** Number of color channels (1, 3, or 4). */
+  readonly channels: number;
+  /** PDF filter name(s) applied to this stream. */
+  readonly filters: readonly string[];
+  /** Size of the compressed stream data in bytes. */
+  readonly compressedSize: number;
+}
+/**
+ * Extract all image XObjects from a PDF document.
+ *
+ * Walks every page's `/Resources /XObject` dictionary and collects
+ * metadata for each image XObject found.
+ *
+ * @param doc - A parsed `PdfDocument`.
+ * @returns An array of `ImageInfo` objects, one per image XObject.
+ *
+ * @example
+ * ```ts
+ * import { loadPdf, extractImages } from 'modern-pdf-lib';
+ *
+ * const doc = await loadPdf(pdfBytes);
+ * const images = extractImages(doc);
+ *
+ * for (const img of images) {
+ *   console.log(`${img.name}: ${img.width}x${img.height} ${img.colorSpace} (${img.compressedSize} bytes)`);
+ * }
+ * ```
+ */
+declare function extractImages(doc: PdfDocument): ImageInfo[];
+/**
+ * Decode image stream data into raw pixels.
+ *
+ * For DCTDecode (JPEG) streams, returns the raw JPEG bytes (not decoded
+ * to pixels) since JPEG decoding requires the WASM module.
+ *
+ * For FlateDecode and other filters, fully decodes the stream.
+ *
+ * @param imageInfo - An `ImageInfo` from `extractImages()`.
+ * @returns The decoded stream data.
+ */
+declare function decodeImageStream(imageInfo: ImageInfo): Uint8Array;
+//#endregion
+//#region src/assets/image/batchOptimize.d.ts
+/**
+ * Options for batch image optimization.
+ */
+interface BatchOptimizeOptions {
+  /**
+   * JPEG quality (1–100) for recompressed images.
+   *
+   * Default: `80`.
+   */
+  readonly quality?: number;
+  /**
+   * Maximum DPI for images.  Images exceeding this DPI at their
+   * display size will be downscaled before recompression.
+   *
+   * Default: `150`.
+   */
+  readonly maxDpi?: number;
+  /**
+   * Encode as progressive JPEG.
+   *
+   * Default: `false`.
+   */
+  readonly progressive?: boolean;
+  /**
+   * Chroma subsampling mode for JPEG encoding.
+   *
+   * Default: `'4:2:0'`.
+   */
+  readonly chromaSubsampling?: ChromaSubsampling;
+  /**
+   * Skip images smaller than this threshold (in bytes).
+   *
+   * Default: `false` (process all images).
+   */
+  readonly skipSmallImages?: boolean;
+  /**
+   * Minimum savings percentage required to replace an image.
+   * If the recompressed image is not at least this much smaller,
+   * the original is kept.
+   *
+   * Default: `10`.
+   */
+  readonly minSavingsPercent?: number;
+  /**
+   * Auto-detect and convert pseudo-grayscale RGB images to true
+   * grayscale before encoding.
+   *
+   * Default: `false`.
+   */
+  readonly autoGrayscale?: boolean;
+}
+/**
+ * Per-image optimization report entry.
+ */
+interface ImageOptimizeEntry {
+  /** Resource name (e.g. '/Im1'). */
+  readonly name: string;
+  /** Page index where this image appears. */
+  readonly pageIndex: number;
+  /** Original compressed size in bytes. */
+  readonly originalSize: number;
+  /** New compressed size in bytes (same as original if skipped). */
+  readonly newSize: number;
+  /** Whether this image was skipped. */
+  readonly skipped: boolean;
+  /** Reason for skipping, if applicable. */
+  readonly reason?: string;
+}
+/**
+ * Summary report from batch image optimization.
+ */
+interface OptimizationReport {
+  /** Total number of image XObjects found. */
+  readonly totalImages: number;
+  /** Number of images that were recompressed. */
+  readonly optimizedImages: number;
+  /** Total original compressed size (all images). */
+  readonly originalTotalBytes: number;
+  /** Total new compressed size (all images). */
+  readonly optimizedTotalBytes: number;
+  /** Overall savings percentage. */
+  readonly savings: number;
+  /** Per-image details. */
+  readonly perImage: readonly ImageOptimizeEntry[];
+}
+/**
+ * Optimize all images in a PDF document by recompressing them as JPEG.
+ *
+ * Walks every image XObject in the document, decodes its pixel data,
+ * recompresses it as JPEG using the WASM encoder (if available), and
+ * replaces the stream data in-place when the result is smaller.
+ *
+ * **Requires the JPEG WASM module to be initialized** via
+ * `initJpegWasm()` or `initWasm({ jpeg: true })`.  Without it,
+ * no images will be optimized (all will be skipped).
+ *
+ * @param doc     - A parsed `PdfDocument` (from `loadPdf()`).
+ * @param options - Optimization settings.
+ * @returns A report summarizing the optimization results.
+ *
+ * @example
+ * ```ts
+ * import { loadPdf, initWasm, optimizeAllImages } from 'modern-pdf-lib';
+ *
+ * await initWasm({ jpeg: true });
+ *
+ * const doc = await loadPdf(pdfBytes);
+ * const report = await optimizeAllImages(doc);
+ *
+ * console.log(`Optimized ${report.optimizedImages} of ${report.totalImages} images`);
+ * console.log(`Savings: ${report.savings.toFixed(1)}%`);
+ *
+ * const optimizedBytes = await doc.save();
+ * ```
+ */
+declare function optimizeAllImages(doc: PdfDocument, options?: BatchOptimizeOptions): Promise<OptimizationReport>;
+//#endregion
+//#region src/assets/image/deduplicateImages.d.ts
+/**
+ * Report from image deduplication.
+ */
+interface DeduplicationReport {
+  /** Total number of image XObjects found. */
+  readonly totalImages: number;
+  /** Number of unique images (after deduplication). */
+  readonly uniqueImages: number;
+  /** Number of duplicate references replaced. */
+  readonly duplicatesRemoved: number;
+  /** Estimated bytes saved by deduplication. */
+  readonly bytesSaved: number;
+}
+/**
+ * Deduplicate identical images in a PDF document.
+ *
+ * Scans all image XObjects, hashes their compressed stream data (plus
+ * dimensions and filter), and replaces duplicate references in page
+ * resource dictionaries with the canonical (first-seen) copy.
+ *
+ * This operation modifies the document in-place. Duplicate streams
+ * are not removed from the object registry (they become unreferenced
+ * and will be omitted on save if the writer supports garbage collection).
+ *
+ * @param doc - A parsed `PdfDocument` (from `loadPdf()`).
+ * @returns A report summarizing deduplication results.
+ *
+ * @example
+ * ```ts
+ * import { loadPdf, deduplicateImages } from 'modern-pdf-lib';
+ *
+ * const doc = await loadPdf(pdfBytes);
+ * const report = await deduplicateImages(doc);
+ *
+ * console.log(`Removed ${report.duplicatesRemoved} duplicate images`);
+ * console.log(`Saved ~${(report.bytesSaved / 1024).toFixed(0)} KB`);
+ *
+ * const optimizedBytes = await doc.save();
+ * ```
+ */
+declare function deduplicateImages(doc: PdfDocument): DeduplicationReport;
+//#endregion
+//#region src/assets/image/grayscaleDetect.d.ts
+/**
+ * @module assets/image/grayscaleDetect
+ *
+ * Grayscale detection and conversion for image optimization.
+ *
+ * Detects RGB images where all pixels are effectively grayscale
+ * (R ≈ G ≈ B) and converts them to single-channel grayscale,
+ * reducing data size by ~66%.
+ *
+ * No Buffer — uses Uint8Array exclusively.
+ */
+/**
+ * Check whether an RGB/RGBA image is effectively grayscale.
+ *
+ * Scans all pixels and checks if R, G, and B channels are within
+ * `tolerance` of each other. If ≥99% of pixels pass, the image
+ * is considered grayscale.
+ *
+ * @param pixels    - Raw pixel data (row-major, channel-interleaved).
+ * @param width     - Image width in pixels.
+ * @param height    - Image height in pixels.
+ * @param channels  - Number of channels: 3 (RGB) or 4 (RGBA).
+ * @param tolerance - Maximum allowed difference between R, G, and B
+ *                    values for a pixel to be considered gray.
+ *                    Default: `2`.
+ * @returns `true` if the image is effectively grayscale.
+ *
+ * @example
+ * ```ts
+ * import { isGrayscaleImage, convertToGrayscale } from 'modern-pdf-lib';
+ *
+ * if (isGrayscaleImage(pixels, width, height, 3)) {
+ *   const grayPixels = convertToGrayscale(pixels, width, height, 3);
+ *   // grayPixels has 1 byte per pixel instead of 3
+ * }
+ * ```
+ */
+declare function isGrayscaleImage(pixels: Uint8Array, width: number, height: number, channels: 3 | 4, tolerance?: number): boolean;
+/**
+ * Convert an RGB/RGBA image to single-channel grayscale.
+ *
+ * Uses the ITU-R BT.601 luma formula:
+ * ```
+ * gray = 0.299 × R + 0.587 × G + 0.114 × B
+ * ```
+ *
+ * The alpha channel (if present) is discarded.
+ *
+ * @param pixels   - Raw pixel data (row-major, channel-interleaved).
+ * @param width    - Image width in pixels.
+ * @param height   - Image height in pixels.
+ * @param channels - Number of channels: 3 (RGB) or 4 (RGBA).
+ * @returns Grayscale pixel data (1 byte per pixel).
+ */
+declare function convertToGrayscale(pixels: Uint8Array, width: number, height: number, channels: 3 | 4): Uint8Array;
+//#endregion
+//#region src/assets/image/dpiAnalyze.d.ts
+/**
+ * @module assets/image/dpiAnalyze
+ *
+ * DPI analysis for PDF image XObjects.
+ *
+ * Computes the effective DPI of an image based on its pixel dimensions
+ * and its display size in the PDF (determined by the content stream's
+ * current transformation matrix).
+ *
+ * No Buffer — uses Uint8Array exclusively.
+ */
+/**
+ * DPI information for an image.
+ */
+interface ImageDpi {
+  /** Horizontal DPI. */
+  readonly xDpi: number;
+  /** Vertical DPI. */
+  readonly yDpi: number;
+  /** Effective DPI (minimum of xDpi and yDpi). */
+  readonly effectiveDpi: number;
+}
+/**
+ * Compute the effective DPI of an image given its pixel dimensions
+ * and display dimensions in points.
+ *
+ * PDF uses 72 points per inch, so:
+ * ```
+ * DPI = imagePixels / (displayPoints / 72)
+ * ```
+ *
+ * @param imageWidth    - Image width in pixels.
+ * @param imageHeight   - Image height in pixels.
+ * @param displayWidth  - Display width in PDF points (1/72 inch).
+ * @param displayHeight - Display height in PDF points (1/72 inch).
+ * @returns DPI information.
+ *
+ * @example
+ * ```ts
+ * import { computeImageDpi } from 'modern-pdf-lib';
+ *
+ * // A 3000×2000 image displayed at 4.17×2.78 inches (300×200 points)
+ * const dpi = computeImageDpi(3000, 2000, 300, 200);
+ * console.log(dpi.effectiveDpi); // 720
+ * ```
+ */
+declare function computeImageDpi(imageWidth: number, imageHeight: number, displayWidth: number, displayHeight: number): ImageDpi;
+/**
+ * Compute the target pixel dimensions for downscaling an image
+ * to a maximum DPI at a given display size.
+ *
+ * @param imageWidth    - Current image width in pixels.
+ * @param imageHeight   - Current image height in pixels.
+ * @param displayWidth  - Display width in PDF points.
+ * @param displayHeight - Display height in PDF points.
+ * @param maxDpi        - Maximum allowed DPI.
+ * @returns Target dimensions, or the original dimensions if no
+ *          downscaling is needed.
+ */
+declare function computeTargetDimensions(imageWidth: number, imageHeight: number, displayWidth: number, displayHeight: number, maxDpi: number): {
+  width: number;
+  height: number;
+  downscaled: boolean;
+};
+//#endregion
 //#region src/utils/base64.d.ts
 /**
  * @module utils/base64
@@ -8250,6 +9120,12 @@ interface InitWasmOptions {
    * Pre-loaded WASM bytes for the font subsetting module.
    */
   fontWasm?: Uint8Array | undefined;
+  /** Initialize the JPEG encoding/decoding WASM module. Default: `false`. */
+  jpeg?: boolean | undefined;
+  /**
+   * Pre-loaded WASM bytes for the JPEG encoding/decoding module.
+   */
+  jpegWasm?: Uint8Array | undefined;
 }
 /**
  * Initialize the optional WASM acceleration modules.
@@ -8271,5 +9147,5 @@ interface InitWasmOptions {
  */
 declare function initWasm(options?: string | URL | InitWasmOptions): Promise<void>;
 //#endregion
-export { type AccessibilityIssue, type Angle, AnnotationFlags, type AnnotationOptions, type AnnotationType, type AppearanceProviderFor, BlendMode, type ButtonAppearanceOptions, type ByteRangeResult, type ByteWriter, type CIDFontData, type CIDSystemInfoData, type CatalogOptions, ChangeTracker, type CheckboxAppearanceOptions, type CmykColor, type Color, type ColorStop, CombedTextLayoutError, type ComputeFontSizeOptions, type ContentStreamOperator, type CropBox, type Degrees, type DocumentMetadata, type DocumentStructure, type DrawCircleOptions, type DrawEllipseOptions, type DrawImageOptions, type DrawLineOptions, type DrawPageOptions, type DrawRectangleOptions, type DrawSquareOptions, type DrawSvgPathOptions, type DrawTextOptions, type DropdownAppearanceOptions, type EmbedFontOptions, type EmbedPageOptions, type EmbeddedFile, EmbeddedFont, type EmbeddedPdfPage, type EncryptAlgorithm, type EncryptDictValues, type EncryptOptions, EncryptedPdfError, ExceededMaxLengthError, FieldAlreadyExistsError, FieldExistsAsNonTerminalError, FieldFlags, type FieldType, type FontDescriptorData, type FontEmbeddingResult, type FontMetrics, FontNotEmbeddedError, type FontRef, ForeignPageError, type FreeTextAlignment, type GradientFill, type GrayscaleColor, ImageAlignment, type ImageRef, type IncrementalSaveResult, InitWasmOptions, InvalidFieldNamePartError, type LayoutCombedOptions, type LayoutMultilineOptions, type LayoutMultilineResult, type LayoutSinglelineOptions, type LayoutSinglelineResult, LineCapStyle, type LineEndingStyle, LineJoinStyle, type LinearGradientOptions, type LinearizationOptions, type LinkHighlightMode, type ListboxAppearanceOptions, type LoadPdfOptions, type MarkedContentScope, MissingOnValueCheckError, NoSuchFieldError, type NormalizedStop, type Operand, type OutlineDestination, type OutlineItemOptions, PDFOperator, type PageEntry, type PageRange, type PageSize, PageSizes, ParseSpeeds, type PatternFill, type PdfAIssue, type PdfALevel, type PdfAValidationResult, PdfAnnotation, PdfArray, PdfBool, PdfButtonField, PdfCheckboxField, PdfCircleAnnotation, PdfDict, PdfDocument, PdfDropdownField, PdfEncryptionHandler, PdfField, PdfForm, PdfFreeTextAnnotation, PdfHighlightAnnotation, PdfInkAnnotation, PdfLayer, PdfLayerManager, PdfLineAnnotation, PdfLinkAnnotation, PdfListboxField, PdfName, PdfNull, PdfNumber, type PdfObject, PdfObjectRegistry, PdfOutlineItem, PdfOutlineTree, PdfPage, PdfParseError, type PdfPermissionFlags, PdfPolyLineAnnotation, PdfPolygonAnnotation, PdfRadioGroup, PdfRedactAnnotation, PdfRef, type PdfSaveOptions, PdfSignatureField, type PdfSignatureInfo, PdfSquareAnnotation, PdfSquigglyAnnotation, PdfStampAnnotation, PdfStream, PdfStreamWriter, PdfStrikeOutAnnotation, PdfString, PdfStructureElement, PdfStructureTree, PdfTextAnnotation, PdfTextField, PdfUnderlineAnnotation, PdfViewerPreferences, PdfWriter, type RadialGradientFill, type RadialGradientOptions, type Radians, type RadioAppearanceOptions, type RedactionMark, type RedactionOptions, type RefResolver, type RegistryEntry, RemovePageFromEmptyDocumentError, type RgbColor, RichTextFieldReadError, type SetTitleOptions, type SignOptions, type SignatureAppearanceOptions, type SignatureOptions, type SignatureVerificationResult, type SignerInfo, type SoftMaskBuilder, type SoftMaskRef, type StandardFontName, StandardFonts, type StandardStampName, type StructureElementOptions, type StructureType, type SubsetCmap, type SubsetResult, type SvgDrawCommand, type SvgElement, type SvgRenderOptions, TextAlignment, type TextAnnotationIcon, type TextAppearanceOptions, type TextExtractionOptions, type TextItem, TextRenderingMode, type TilingPatternOptions, type TimestampResult, type TransparencyGroupOptions, type Type0FontData, UnexpectedFieldTypeError, type ViewerPreferences, type WatermarkOptions, type WidgetAnnotationHost, type WidthEntry, addWatermark, addWatermarkToPage, aesDecryptCBC, aesEncryptCBC, annotationFromDict, applyFillColor, applyRedactions, applyStrokeColor, asNumber, asPDFName, asPDFNumber, attachFile, base64Decode, base64Encode, beginArtifact, beginArtifactWithType, beginLayerContent, beginMarkedContent, beginMarkedContentSequence, beginMarkedContentWithProperties, beginText, buildAnnotationDict, buildCatalog, buildDocumentStructure, buildEmbeddedFilesNameTree, buildGradientObjects, buildInfoDict, buildPageTree, buildPatternObjects, buildPkcs7Signature, buildTimestampRequest, buildViewerPreferencesDict, buildXmpMetadata, checkAccessibility, circlePath, clipEvenOdd, clip as clipOp, closeAndStroke, closeFillAndStroke, closeFillEvenOddAndStroke, closePath as closePathOp, cmyk, colorToComponents, componentsToColor, computeFileEncryptionKey, computeFontSize, computeSignatureHash, concatMatrix, concatMatrix as concatTransformationMatrix, copyPages, createAnnotation, createMarkedContentScope, createPdf, createXmpStream, cropPage, curveToFinal, curveToInitial, curveTo as curveToOp, decodePermissions, decodeStream, degrees, degreesToRadians, drawImageWithMatrix, drawImageXObject, drawXObject as drawObject, drawXObject, drawSvgOnPage, ellipsePath, embedPageAsFormXObject, embedSignature, encodeContextTag, encodeInteger, encodeLength, encodeOID, encodeOctetString, encodePermissions, encodePrintableString, encodeSequence, encodeSet, encodeUTCTime, encodeUtf8String, endArtifact, endLayerContent, endMarkedContent, endPath as endPathOp, endText, enforcePdfA, extractMetrics, extractText, extractTextWithPositions, fillAndStroke as fillAndStrokeOp, fillEvenOdd, fillEvenOddAndStroke, fill as fillOp, findSignatures, formatHexContext, formatPdfDate, generateButtonAppearance, generateCheckboxAppearance, generateCircleAppearance, generateDropdownAppearance, generateFreeTextAppearance, generateHighlightAppearance, generateInkAppearance, generateLineAppearance, generateListboxAppearance, generateRadioAppearance, generateSignatureAppearance, generateSquareAppearance, generateSquigglyAppearance, generateStrikeOutAppearance, generateTextAppearance, generateUnderlineAppearance, getAttachments, getPageSize, getRedactionMarks, getSignatures, grayscale, initWasm, insertPage, isAccessible, isLinearized, isOpenTypeCFF, isTrueType, layoutCombedText, layoutMultilineText, layoutSinglelineText, lineTo as lineToOp, linearGradient, linearizePdf, loadPdf, markForRedaction, md5, mergePdfs, movePage, moveText as moveTextOp, moveTextSetLeading, moveTo as moveToOp, nextLine as nextLineOp, parseContentStream, parseSvg, parseSvgColor, parseSvgPath, parseSvgTransform, parseTimestampResponse, parseViewerPreferences, parseXmpMetadata, restoreState as popGraphicsState, restoreState, prepareForSigning, saveState as pushGraphicsState, saveState, radialGradient, radians, radiansToDegrees, rc4, rectangle as rectangleOp, removePage, removePages, requestTimestamp, resizePage, reversePages, rgb, rotateAllPages, rotate as rotateOp, rotatePage, rotationMatrix, saveDocumentIncremental, saveIncremental, scale as scaleOp, serializePdf, setCharacterSpacing as setCharacterSpacingOp, setCharacterSpacing as setCharacterSqueeze, setColorSpace, setDashPattern as setDashPatternOp, setFillColor, setFillColorCmyk, setFillColorGray, setFillColorRgb, setFillingColor, setFlatness, setFont as setFontAndSize, setFont as setFontOp, setFontSize as setFontSizeOp, setGraphicsState as setGraphicsStateOp, setLeading as setLeadingOp, setLeading as setLineHeight, setLineCap as setLineCapOp, setLineJoin as setLineJoinOp, setLineWidth as setLineWidthOp, setMiterLimit, setStrokeColor, setStrokeColorCmyk, setStrokeColorGray, setStrokeColorRgb, setStrokeColorSpace, setStrokingColor, setTextMatrix as setTextMatrixOp, setTextRenderingMode as setTextRenderingModeOp, setTextRise as setTextRiseOp, setWordSpacing as setWordSpacingOp, sha256, sha384, sha512, showTextArray, showTextHex, showTextNextLine, showText as showTextOp, showTextWithSpacing, signPdf, skew as skewOp, splitPdf, stroke as strokeOp, summarizeIssues, svgToPdfOperators, tilingPattern, translate as translateOp, validatePdfA, verifyOwnerPassword, verifySignature, verifySignatures, verifyUserPassword, wrapInMarkedContent };
+export { type AccessibilityIssue, type Angle, AnnotationFlags, type AnnotationOptions, type AnnotationType, type AppearanceProviderFor, type BatchOptimizeOptions, BlendMode, type ButtonAppearanceOptions, type ByteRangeResult, type ByteWriter, type CIDFontData, type CIDSystemInfoData, type CaretSymbol, type CatalogOptions, ChangeTracker, type CheckboxAppearanceOptions, type ChromaSubsampling, type CmykColor, type Color, type ColorStop, CombedTextLayoutError, type ComputeFontSizeOptions, type ContentStreamOperator, type CropBox, type DeduplicationReport, type Degrees, type DocumentMetadata, type DocumentStructure, type DownscaleOptions, type DrawCircleOptions, type DrawEllipseOptions, type DrawImageOptions, type DrawLineOptions, type DrawPageOptions, type DrawRectangleOptions, type DrawSquareOptions, type DrawSvgPathOptions, type DrawTextOptions, type DropdownAppearanceOptions, type EmbedFontOptions, type EmbedPageOptions, type EmbeddedFile, EmbeddedFont, type EmbeddedPdfPage, type EncryptAlgorithm, type EncryptDictValues, type EncryptOptions, EncryptedPdfError, ExceededMaxLengthError, FieldAlreadyExistsError, FieldExistsAsNonTerminalError, FieldFlags, type FieldType, type FileAttachmentIcon, type FontDescriptorData, type FontEmbeddingResult, type FontMetrics, FontNotEmbeddedError, type FontRef, ForeignPageError, type FreeTextAlignment, type GradientFill, type GrayscaleColor, ImageAlignment, type ImageDpi, type ImageInfo, type ImageOptimizeEntry, type ImageOptimizeOptions, type ImageRef, type IncrementalSaveResult, InitWasmOptions, InvalidFieldNamePartError, type JpegDecodeResult, type LayoutCombedOptions, type LayoutMultilineOptions, type LayoutMultilineResult, type LayoutSinglelineOptions, type LayoutSinglelineResult, LineCapStyle, type LineEndingStyle, LineJoinStyle, type LinearGradientOptions, type LinearizationOptions, type LinkHighlightMode, type ListboxAppearanceOptions, type LoadPdfOptions, type MarkedContentScope, MissingOnValueCheckError, NoSuchFieldError, type NormalizedStop, type Operand, type OptimizationReport, type OptimizeResult, type OutlineDestination, type OutlineItemOptions, PDFOperator, type PageEntry, type PageRange, type PageSize, PageSizes, ParseSpeeds, type PatternFill, type PdfAIssue, type PdfALevel, type PdfAValidationResult, PdfAnnotation, PdfArray, PdfBool, PdfButtonField, PdfCaretAnnotation, PdfCheckboxField, PdfCircleAnnotation, PdfDict, PdfDocument, PdfDropdownField, PdfEncryptionHandler, PdfField, PdfFileAttachmentAnnotation, PdfForm, PdfFreeTextAnnotation, PdfHighlightAnnotation, PdfInkAnnotation, PdfLayer, PdfLayerManager, PdfLineAnnotation, PdfLinkAnnotation, PdfListboxField, PdfName, PdfNull, PdfNumber, type PdfObject, PdfObjectRegistry, PdfOutlineItem, PdfOutlineTree, PdfPage, PdfParseError, type PdfPermissionFlags, PdfPolyLineAnnotation, PdfPolygonAnnotation, PdfPopupAnnotation, PdfRadioGroup, PdfRedactAnnotation, PdfRef, type PdfSaveOptions, PdfSignatureField, type PdfSignatureInfo, PdfSquareAnnotation, PdfSquigglyAnnotation, PdfStampAnnotation, PdfStream, PdfStreamWriter, PdfStrikeOutAnnotation, PdfString, PdfStructureElement, PdfStructureTree, PdfTextAnnotation, PdfTextField, PdfUnderlineAnnotation, PdfViewerPreferences, PdfWriter, type RadialGradientFill, type RadialGradientOptions, type Radians, type RadioAppearanceOptions, type RawImageData, type RecompressOptions, type RedactionMark, type RedactionOptions, type RefResolver, type RegistryEntry, RemovePageFromEmptyDocumentError, type RgbColor, RichTextFieldReadError, type SetTitleOptions, type SignOptions, type SignatureAppearanceOptions, type SignatureOptions, type SignatureVerificationResult, type SignerInfo, type SoftMaskBuilder, type SoftMaskRef, type StandardFontName, StandardFonts, type StandardStampName, type StructureElementOptions, type StructureType, type SubsetCmap, type SubsetResult, type SvgDrawCommand, type SvgElement, type SvgRenderOptions, TextAlignment, type TextAnnotationIcon, type TextAppearanceOptions, type TextExtractionOptions, type TextItem, TextRenderingMode, type TilingPatternOptions, type TimestampResult, type TransparencyGroupOptions, type Type0FontData, UnexpectedFieldTypeError, type ViewerPreferences, type VisibleSignatureOptions, type WatermarkOptions, type WidgetAnnotationHost, type WidthEntry, addWatermark, addWatermarkToPage, aesDecryptCBC, aesEncryptCBC, annotationFromDict, applyFillColor, applyRedactions, applyStrokeColor, asNumber, asPDFName, asPDFNumber, attachFile, base64Decode, base64Encode, beginArtifact, beginArtifactWithType, beginLayerContent, beginMarkedContent, beginMarkedContentSequence, beginMarkedContentWithProperties, beginText, buildAnnotationDict, buildCatalog, buildDocumentStructure, buildEmbeddedFilesNameTree, buildGradientObjects, buildInfoDict, buildPageTree, buildPatternObjects, buildPkcs7Signature, buildTimestampRequest, buildViewerPreferencesDict, buildXmpMetadata, checkAccessibility, circlePath, clipEvenOdd, clip as clipOp, closeAndStroke, closeFillAndStroke, closeFillEvenOddAndStroke, closePath as closePathOp, cmyk, colorToComponents, componentsToColor, computeFileEncryptionKey, computeFontSize, computeImageDpi, computeSignatureHash, computeTargetDimensions, concatMatrix, concatMatrix as concatTransformationMatrix, convertToGrayscale, copyPages, createAnnotation, createMarkedContentScope, createPdf, createXmpStream, cropPage, curveToFinal, curveToInitial, curveTo as curveToOp, decodeImageStream, decodeJpegWasm, decodePermissions, decodeStream, deduplicateImages, degrees, degreesToRadians, downscaleImage, drawImageWithMatrix, drawImageXObject, drawXObject as drawObject, drawXObject, drawSvgOnPage, ellipsePath, embedPageAsFormXObject, embedSignature, encodeContextTag, encodeInteger, encodeJpegWasm, encodeLength, encodeOID, encodeOctetString, encodePermissions, encodePrintableString, encodeSequence, encodeSet, encodeUTCTime, encodeUtf8String, endArtifact, endLayerContent, endMarkedContent, endPath as endPathOp, endText, enforcePdfA, estimateJpegQuality, extractImages, extractMetrics, extractText, extractTextWithPositions, fillAndStroke as fillAndStrokeOp, fillEvenOdd, fillEvenOddAndStroke, fill as fillOp, findSignatures, formatHexContext, formatPdfDate, generateButtonAppearance, generateCheckboxAppearance, generateCircleAppearance, generateDropdownAppearance, generateFreeTextAppearance, generateHighlightAppearance, generateInkAppearance, generateLineAppearance, generateListboxAppearance, generateRadioAppearance, generateSignatureAppearance, generateSquareAppearance, generateSquigglyAppearance, generateStrikeOutAppearance, generateTextAppearance, generateUnderlineAppearance, getAttachments, getPageSize, getRedactionMarks, getSignatures, grayscale, initJpegWasm, initWasm, insertPage, isAccessible, isGrayscaleImage, isJpegWasmReady, isLinearized, isOpenTypeCFF, isTrueType, layoutCombedText, layoutMultilineText, layoutSinglelineText, lineTo as lineToOp, linearGradient, linearizePdf, loadPdf, markForRedaction, md5, mergePdfs, movePage, moveText as moveTextOp, moveTextSetLeading, moveTo as moveToOp, nextLine as nextLineOp, optimizeAllImages, optimizeImage, parseContentStream, parseSvg, parseSvgColor, parseSvgPath, parseSvgTransform, parseTimestampResponse, parseViewerPreferences, parseXmpMetadata, restoreState as popGraphicsState, restoreState, prepareForSigning, saveState as pushGraphicsState, saveState, radialGradient, radians, radiansToDegrees, rc4, recompressImage, rectangle as rectangleOp, removePage, removePages, requestTimestamp, resizePage, reversePages, rgb, rotateAllPages, rotate as rotateOp, rotatePage, rotationMatrix, saveDocumentIncremental, saveIncremental, scale as scaleOp, serializePdf, setCharacterSpacing as setCharacterSpacingOp, setCharacterSpacing as setCharacterSqueeze, setColorSpace, setDashPattern as setDashPatternOp, setFillColor, setFillColorCmyk, setFillColorGray, setFillColorRgb, setFillingColor, setFlatness, setFont as setFontAndSize, setFont as setFontOp, setFontSize as setFontSizeOp, setGraphicsState as setGraphicsStateOp, setLeading as setLeadingOp, setLeading as setLineHeight, setLineCap as setLineCapOp, setLineJoin as setLineJoinOp, setLineWidth as setLineWidthOp, setMiterLimit, setStrokeColor, setStrokeColorCmyk, setStrokeColorGray, setStrokeColorRgb, setStrokeColorSpace, setStrokingColor, setTextMatrix as setTextMatrixOp, setTextRenderingMode as setTextRenderingModeOp, setTextRise as setTextRiseOp, setWordSpacing as setWordSpacingOp, sha256, sha384, sha512, showTextArray, showTextHex, showTextNextLine, showText as showTextOp, showTextWithSpacing, signPdf, skew as skewOp, splitPdf, stroke as strokeOp, summarizeIssues, svgToPdfOperators, tilingPattern, translate as translateOp, validatePdfA, verifyOwnerPassword, verifySignature, verifySignatures, verifyUserPassword, wrapInMarkedContent };
 //# sourceMappingURL=index.d.mts.map