pdf-oxide-wasm 0.3.38 → 0.3.39

package/bundler/pdf_oxide_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const __wbg_artifactstyle_free: (a: number, b: number) => void;
+export const __wbg_streamingtable_free: (a: number, b: number) => void;
 export const __wbg_wasmartifact_free: (a: number, b: number) => void;
 export const __wbg_wasmcertificate_free: (a: number, b: number) => void;
 export const __wbg_wasmdocumentbuilder_free: (a: number, b: number) => void;
@@ -15,6 +16,11 @@ export const __wbg_wasmpdfpageregion_free: (a: number, b: number) => void;
 export const __wbg_wasmsignature_free: (a: number, b: number) => void;
 export const __wbg_wasmtimestamp_free: (a: number, b: number) => void;
 export const setLogLevel: (a: number, b: number, c: number) => void;
+export const signPdfBytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+export const streamingtable_columnCount: (a: number) => number;
+export const streamingtable_finish: (a: number, b: number) => void;
+export const streamingtable_pushRow: (a: number, b: number, c: number, d: number) => void;
+export const streamingtable_pushRowSpan: (a: number, b: number, c: number) => void;
 export const wasmartifact_center: (a: number, b: number) => number;
 export const wasmartifact_left: (a: number, b: number) => number;
 export const wasmartifact_new: () => number;
@@ -28,6 +34,8 @@ export const wasmartifactstyle_new: () => number;
 export const wasmcertificate_isValid: (a: number, b: number) => void;
 export const wasmcertificate_issuer: (a: number, b: number) => void;
 export const wasmcertificate_load: (a: number, b: number, c: number) => void;
+export const wasmcertificate_loadPem: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmcertificate_loadPkcs12: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmcertificate_serial: (a: number, b: number) => void;
 export const wasmcertificate_subject: (a: number, b: number) => void;
 export const wasmcertificate_validity: (a: number, b: number) => void;
@@ -37,41 +45,72 @@ export const wasmdocumentbuilder_build: (a: number, b: number) => void;
 export const wasmdocumentbuilder_commitPage: (a: number, b: number, c: number) => void;
 export const wasmdocumentbuilder_creator: (a: number, b: number, c: number, d: number) => void;
 export const wasmdocumentbuilder_keywords: (a: number, b: number, c: number, d: number) => void;
+export const wasmdocumentbuilder_language: (a: number, b: number, c: number, d: number) => void;
 export const wasmdocumentbuilder_letterPage: (a: number, b: number) => void;
 export const wasmdocumentbuilder_new: () => number;
+export const wasmdocumentbuilder_onOpen: (a: number, b: number, c: number, d: number) => void;
 export const wasmdocumentbuilder_page: (a: number, b: number, c: number, d: number) => void;
 export const wasmdocumentbuilder_registerEmbeddedFont: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmdocumentbuilder_roleMap: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmdocumentbuilder_subject: (a: number, b: number, c: number, d: number) => void;
+export const wasmdocumentbuilder_taggedPdfUa1: (a: number, b: number) => void;
 export const wasmdocumentbuilder_title: (a: number, b: number, c: number, d: number) => void;
 export const wasmdocumentbuilder_toBytesEncrypted: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmembeddedfont_fromBytes: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmembeddedfont_name: (a: number, b: number) => void;
 export const wasmfluentpagebuilder_at: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_barcode1d: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+export const wasmfluentpagebuilder_barcodeQr: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const wasmfluentpagebuilder_checkbox: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+export const wasmfluentpagebuilder_columns: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmfluentpagebuilder_comboBox: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
 export const wasmfluentpagebuilder_done: (a: number, b: number, c: number) => void;
+export const wasmfluentpagebuilder_fieldCalculate: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_fieldFormat: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_fieldKeystroke: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_fieldValidate: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_filledRect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const wasmfluentpagebuilder_font: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmfluentpagebuilder_footnote: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmfluentpagebuilder_freeText: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const wasmfluentpagebuilder_heading: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmfluentpagebuilder_highlight: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmfluentpagebuilder_horizontalRule: (a: number, b: number) => void;
+export const wasmfluentpagebuilder_imageArtifact: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+export const wasmfluentpagebuilder_imageWithAlt: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const wasmfluentpagebuilder_inline: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_inlineBold: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_inlineColor: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const wasmfluentpagebuilder_inlineItalic: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_line: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmfluentpagebuilder_linkJavascript: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_linkNamed: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_linkPage: (a: number, b: number, c: number) => void;
 export const wasmfluentpagebuilder_linkUrl: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_measure: (a: number, b: number, c: number) => number;
+export const wasmfluentpagebuilder_newPageSameSize: (a: number, b: number) => void;
+export const wasmfluentpagebuilder_newline: (a: number, b: number) => void;
+export const wasmfluentpagebuilder_onClose: (a: number, b: number, c: number, d: number) => void;
+export const wasmfluentpagebuilder_onOpen: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_paragraph: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_pushButton: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
 export const wasmfluentpagebuilder_radioGroup: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number) => void;
 export const wasmfluentpagebuilder_rect: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmfluentpagebuilder_remainingSpace: (a: number) => number;
+export const wasmfluentpagebuilder_signatureField: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const wasmfluentpagebuilder_space: (a: number, b: number, c: number) => void;
 export const wasmfluentpagebuilder_squiggly: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmfluentpagebuilder_stamp: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_stickyNote: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_stickyNoteAt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmfluentpagebuilder_streamingTable: (a: number, b: number, c: number) => void;
 export const wasmfluentpagebuilder_strikeout: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmfluentpagebuilder_strokeLine: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const wasmfluentpagebuilder_strokeRect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const wasmfluentpagebuilder_table: (a: number, b: number, c: number) => void;
 export const wasmfluentpagebuilder_text: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_textField: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const wasmfluentpagebuilder_textInRect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const wasmfluentpagebuilder_underline: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmfluentpagebuilder_watermark: (a: number, b: number, c: number, d: number) => void;
 export const wasmfluentpagebuilder_watermarkConfidential: (a: number, b: number) => void;
@@ -126,6 +165,7 @@ export const wasmpdfdocument_flattenAllAnnotations: (a: number, b: number) => vo
 export const wasmpdfdocument_flattenForms: (a: number, b: number) => void;
 export const wasmpdfdocument_flattenFormsOnPage: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_flattenPageAnnotations: (a: number, b: number, c: number) => void;
+export const wasmpdfdocument_flattenWarnings: (a: number, b: number) => void;
 export const wasmpdfdocument_getAnnotations: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_getFormFieldValue: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_getFormFields: (a: number, b: number) => void;
@@ -150,6 +190,7 @@ export const wasmpdfdocument_rotateAllPages: (a: number, b: number, c: number) =
 export const wasmpdfdocument_rotatePage: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_save: (a: number, b: number) => void;
 export const wasmpdfdocument_saveEncryptedToBytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const wasmpdfdocument_saveWithOptions: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_search: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const wasmpdfdocument_searchPage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const wasmpdfdocument_setAuthor: (a: number, b: number, c: number, d: number) => void;
@@ -213,8 +254,8 @@ export const wasmfooter_new: () => number;
 export const wasmheader_new: () => number;
 export const __wbg_wasmocrengine_free: (a: number, b: number) => void;
 export const disableLogging: () => void;
-export const __wbg_wasmfooter_free: (a: number, b: number) => void;
 export const __wbg_wasmheader_free: (a: number, b: number) => void;
+export const __wbg_wasmfooter_free: (a: number, b: number) => void;
 export const lut_inverse_interp16: (a: number, b: number, c: number) => number;
 export const qcms_profile_precache_output_transform: (a: number) => void;
 export const lut_interp_linear16: (a: number, b: number, c: number) => number;

package/nodejs/pdf_oxide.d.ts

@@ -1,6 +1,26 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Horizontal-alignment enum shared by `textInRect`, buffered `table`, and
+ * `streamingTable`. Maps 1:1 onto [`crate::writer::TextAlign`] /
+ * [`crate::writer::CellAlign`]. Exported to JS as `Align` via `js_name`.
+ */
+export enum Align {
+    /**
+     * Align to the left edge.
+     */
+    Left = 0,
+    /**
+     * Center horizontally.
+     */
+    Center = 1,
+    /**
+     * Align to the right edge.
+     */
+    Right = 2,
+}
+
 /**
  * Style configuration for header/footer text.
  */
@@ -25,6 +45,45 @@ export class ArtifactStyle {
     constructor();
 }
 
+/**
+ * WASM handle to a streaming-table building session. Created by
+ * `FluentPageBuilder.streamingTable()`; rows are pushed via `pushRow`,
+ * and the session is sealed with `finish()`.
+ *
+ * Single-use: `finish()` twice throws, and `pushRow` after `finish()`
+ * throws. The rows are buffered and replayed against the real Rust
+ * `StreamingTable` at `WasmFluentPageBuilder.done()` commit time —
+ * preserving the FluentPageBuilder borrow-lifetime invariant that can't
+ * cross the wasm-bindgen boundary.
+ */
+export class StreamingTable {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Number of columns configured on this streaming table.
+     */
+    columnCount(): number;
+    /**
+     * Seal the streaming table — the buffered rows are flushed onto the
+     * parent page's op queue, to be replayed against the real Rust
+     * `StreamingTable` at `done()` commit time. Calling `finish()` twice
+     * throws.
+     */
+    finish(): void;
+    /**
+     * Push one row as an array of cell strings (all rowspan=1). Returns an
+     * error if the table has already been finished or if the row's cell count
+     * does not match the column count.
+     */
+    pushRow(cells: string[]): void;
+    /**
+     * Push one row with per-cell rowspan values. `cells` is a JS array of
+     * `[text, rowspan]` two-element arrays. `rowspan == 1` is a normal cell.
+     */
+    pushRowSpan(cells: any): void;
+}
+
 /**
  * A header or footer artifact definition.
  */
@@ -71,6 +130,17 @@ export class WasmCertificate {
      * the DER doesn't parse.
      */
     static load(data: Uint8Array): WasmCertificate;
+    /**
+     * Load a signer certificate + private key from PEM strings.
+     * `certPem` must begin `-----BEGIN CERTIFICATE-----`.
+     * `keyPem` must begin `-----BEGIN PRIVATE KEY-----` or `-----BEGIN RSA PRIVATE KEY-----`.
+     */
+    static loadPem(cert_pem: string, key_pem: string): WasmCertificate;
+    /**
+     * Load a signer certificate + private key from a PKCS#12 (.p12/.pfx) blob.
+     * `password` is the passphrase protecting the key bag.
+     */
+    static loadPkcs12(data: Uint8Array, password: string): WasmCertificate;
     /**
      * Whether the certificate is currently within its validity
      * window. Does NOT verify chain, trust-root, or revocation.
@@ -141,6 +211,12 @@ export class WasmDocumentBuilder {
      * Set document keywords (comma-separated per PDF convention).
      */
     keywords(keywords: string): void;
+    /**
+     * Set the document's natural language tag (e.g. `"en-US"`).
+     *
+     * Emitted as `/Lang` in the catalog when `taggedPdfUa1()` is set.
+     */
+    language(lang: string): void;
     /**
      * Start a new US Letter page.
      */
@@ -151,6 +227,10 @@ export class WasmDocumentBuilder {
      * chains off the instance returned here.
      */
     constructor();
+    /**
+     * Run a JavaScript script when the document is opened (`/OpenAction`).
+     */
+    onOpen(script: string): void;
     /**
      * Start a new page with custom dimensions in PDF points
      * (72 pt = 1 inch).
@@ -161,10 +241,24 @@ export class WasmDocumentBuilder {
      * **Consumes** `font` — reusing the `WasmEmbeddedFont` throws.
      */
     registerEmbeddedFont(name: string, font: WasmEmbeddedFont): void;
+    /**
+     * Add a role-map entry: custom structure type → standard PDF structure type.
+     *
+     * Emitted in `/RoleMap` inside the StructTreeRoot when `taggedPdfUa1()`
+     * is set. Multiple calls accumulate entries.
+     */
+    roleMap(custom: string, standard: string): void;
     /**
      * Set document subject.
      */
     subject(subject: string): void;
+    /**
+     * Enable PDF/UA-1 tagged PDF mode.
+     *
+     * When enabled, `build()` emits `/MarkInfo`, `/StructTreeRoot`, `/Lang`,
+     * and `/ViewerPreferences` in the catalog. Opt-in — no effect unless called.
+     */
+    taggedPdfUa1(): void;
     /**
      * Set document title.
      */
@@ -207,7 +301,22 @@ export class WasmFluentPageBuilder {
     free(): void;
     [Symbol.dispose](): void;
     at(x: number, y: number): void;
+    /**
+     * Place a 1-D barcode image at `(x, y, w, h)` on the page.
+     * `barcodeType`: 0=Code128 1=Code39 2=EAN13 3=EAN8 4=UPCA 5=ITF
+     * 6=Code93 7=Codabar.
+     */
+    barcode1d(barcode_type: number, data: string, x: number, y: number, w: number, h: number): void;
+    /**
+     * Place a QR-code image at `(x, y, size, size)` on the page.
+     */
+    barcodeQr(data: string, x: number, y: number, size: number): void;
     checkbox(name: string, x: number, y: number, w: number, h: number, checked: boolean): void;
+    /**
+     * Lay out `text` as balanced multi-column flow (`columnCount` columns,
+     * `gapPt` points between columns). Paragraphs in `text` are separated by `"\n\n"`.
+     */
+    columns(column_count: number, gap_pt: number, text: string): void;
     /**
      * Add a dropdown combo-box.
      */
@@ -224,22 +333,77 @@ export class WasmFluentPageBuilder {
      * ```
      */
     done(builder: WasmDocumentBuilder): void;
+    fieldCalculate(script: string): void;
+    fieldFormat(script: string): void;
+    fieldKeystroke(script: string): void;
+    fieldValidate(script: string): void;
     /**
      * Draw a filled rectangle. RGB channels in 0.0-1.0.
      */
     filledRect(x: number, y: number, w: number, h: number, r: number, g: number, b: number): void;
     font(name: string, size: number): void;
+    /**
+     * Add a footnote: inline `refMark` at the cursor and `noteText` body
+     * near the page bottom with a separator artifact line.
+     */
+    footnote(ref_mark: string, note_text: string): void;
     freeText(x: number, y: number, w: number, h: number, text: string): void;
     heading(level: number, text: string): void;
     highlight(r: number, g: number, b: number): void;
     horizontalRule(): void;
+    /**
+     * Embed a decorative image (JPEG/PNG/WebP bytes) as an /Artifact (no alt text).
+     */
+    imageArtifact(bytes: Uint8Array, x: number, y: number, w: number, h: number): void;
+    /**
+     * Embed an image (JPEG/PNG/WebP bytes) with an accessibility alt text.
+     */
+    imageWithAlt(bytes: Uint8Array, x: number, y: number, w: number, h: number, alt_text: string): void;
+    /**
+     * Emit `text` inline (advances cursorX only, not cursorY).
+     */
+    inline(text: string): void;
+    /**
+     * Inline bold run.
+     */
+    inlineBold(text: string): void;
+    /**
+     * Inline colored run (RGB 0.0–1.0).
+     */
+    inlineColor(r: number, g: number, b: number, text: string): void;
+    /**
+     * Inline italic run.
+     */
+    inlineItalic(text: string): void;
     /**
      * Draw a line from (x1, y1) to (x2, y2) with 1pt black stroke.
      */
     line(x1: number, y1: number, x2: number, y2: number): void;
+    linkJavascript(script: string): void;
     linkNamed(destination: string): void;
     linkPage(page: number): void;
     linkUrl(url: string): void;
+    /**
+     * Measure the rendered width of `text` in the builder's current font
+     * and size, in PDF points. Pure query — does not mutate state.
+     *
+     * Thin JS view over [`crate::writer::FluentPageBuilder::measure`]. The
+     * WASM class tracks the current font/size independently of the
+     * buffered ops so this query is served without a live builder.
+     */
+    measure(text: string): number;
+    /**
+     * Finish the current page and start a new one with the same page
+     * size. Cursor resets to the top-left margin (72, height-72). The
+     * builder's font carries over.
+     */
+    newPageSameSize(): void;
+    /**
+     * Advance cursorY by one line-height and reset cursorX to 72 pt.
+     */
+    newline(): void;
+    onClose(script: string): void;
+    onOpen(script: string): void;
     paragraph(text: string): void;
     /**
      * Add a clickable push button with a visible caption.
@@ -255,14 +419,67 @@ export class WasmFluentPageBuilder {
      * Draw a stroked rectangle outline (1pt black).
      */
     rect(x: number, y: number, w: number, h: number): void;
+    /**
+     * Points remaining on the current page below the cursor (down to the
+     * 72 pt bottom margin). Mirrors
+     * [`crate::writer::FluentPageBuilder::remaining_space`] using the WASM
+     * class's independently-tracked cursor — accurate after `at`, `text`,
+     * `space`, `newPageSameSize`, `textInRect` and the table helpers.
+     */
+    remainingSpace(): number;
+    /**
+     * Add an unsigned signature placeholder field at the given bounds.
+     */
+    signatureField(name: string, x: number, y: number, w: number, h: number): void;
     space(points: number): void;
     squiggly(r: number, g: number, b: number): void;
     stamp(name: string): void;
     stickyNote(text: string): void;
     stickyNoteAt(x: number, y: number, text: string): void;
+    /**
+     * Open a streaming table. Returns a `StreamingTable` handle the caller
+     * pushes rows into; call `finish()` when done. The streamed rows are
+     * buffered per-table and replayed against the real Rust
+     * `StreamingTable` at `done()` commit time — avoiding the
+     * FluentPageBuilder-lifetime problem that otherwise can't cross the
+     * wasm-bindgen boundary.
+     */
+    streamingTable(spec: any): StreamingTable;
     strikeout(r: number, g: number, b: number): void;
+    /**
+     * Draw a straight line with explicit stroke width and RGB colour.
+     */
+    strokeLine(x1: number, y1: number, x2: number, y2: number, width: number, r: number, g: number, b: number): void;
+    /**
+     * Draw a stroked rectangle with explicit stroke width and RGB colour.
+     */
+    strokeRect(x: number, y: number, w: number, h: number, width: number, r: number, g: number, b: number): void;
+    /**
+     * Render a buffered table from a JS object:
+     *
+     * ```javascript
+     * page.table({
+     *   columns: [
+     *     { header: "SKU", width: 100, align: Align.Left },
+     *     { header: "Qty", width: 60,  align: Align.Right },
+     *   ],
+     *   rows: [["A-1","12"], ["B-2","3"]],
+     *   hasHeader: true,
+     * });
+     * ```
+     *
+     * Uses `serde-wasm-bindgen` for deserialisation. Replays against the
+     * Rust `Table` builder at `done()` commit time.
+     */
+    table(spec: any): void;
     text(text: string): void;
     textField(name: string, x: number, y: number, w: number, h: number, default_value?: string | null): void;
+    /**
+     * Place wrapped text inside a rectangle with horizontal alignment.
+     * `align` is the `Align` enum (0 = Left, 1 = Center, 2 = Right) — also
+     * accepts a raw integer for JS callers that pre-date the enum import.
+     */
+    textInRect(x: number, y: number, w: number, h: number, text: string, align: number): void;
     underline(r: number, g: number, b: number): void;
     watermark(text: string): void;
     watermarkConfidential(): void;
@@ -682,6 +899,15 @@ export class WasmPdfDocument {
      * Flatten annotations on a page into the page content.
      */
     flattenPageAnnotations(page_index: number): void;
+    /**
+     * Return warnings collected during the last form-flattening save.
+     *
+     * Each entry names a widget field that had no `/AP` appearance stream;
+     * flattening such a field produces a blank rectangle.
+     *
+     * @returns Array of warning strings
+     */
+    flattenWarnings(): string[];
     /**
      * Get annotations from a page.
      *
@@ -838,6 +1064,16 @@ export class WasmPdfDocument {
      * @returns Uint8Array containing the modified PDF
      */
     saveToBytes(): Uint8Array;
+    /**
+     * Save with options (compress, garbage_collect, linearize) and return bytes.
+     *
+     * @param {Object} [options] - Optional save options.
+     * @param {boolean} [options.compress=true] - Compress raw streams with FlateDecode.
+     * @param {boolean} [options.garbageCollect=true] - Remove unreachable objects.
+     * @param {boolean} [options.linearize=false] - Linearize (reserved, no-op).
+     * @returns Uint8Array containing the modified PDF
+     */
+    saveWithOptions(compress?: boolean | null, garbage_collect?: boolean | null, linearize?: boolean | null): Uint8Array;
     /**
      * Search for text across all pages.
      *
@@ -1153,3 +1389,11 @@ export function disableLogging(): void;
  * ```
  */
 export function setLogLevel(level: string): void;
+
+/**
+ * Sign raw PDF bytes and return the signed PDF as a `Uint8Array`.
+ *
+ * `cert` must carry a private key (loaded via `Certificate.loadPem` or
+ * `Certificate.loadPkcs12`).
+ */
+export function signPdfBytes(pdf_data: Uint8Array, cert: WasmCertificate, reason?: string | null, location?: string | null): Uint8Array;