@pdfluent/sdk-wasm 1.1.0 → 1.2.0

package/README.md

@@ -295,4 +295,4 @@ add-on). The two texts are `LICENSE` and `LICENSE-COMMERCIAL` in this package.
 - **Documentation:** <https://pdfluent.com/docs>
 - **Pricing:** <https://pdfluent.com/sdk/pricing>
 - **PDFluent editor** (source-available): <https://github.com/pdfluent/pdfluent>. The free desktop app this SDK powers.
-- Built by [Innovation Trigger BV](https://pdfluent.com)
+- Built by [Innovation Trigger B.V.](https://pdfluent.com)

package/THIRD_PARTY_LICENSES.txt

@@ -321,7 +321,8 @@ unic-char-range, unic-common, unic-ucd-ident, unic-ucd-version, unicode-bidi,
 unicode-normalization, unicode-properties, unicode-segmentation, unicode-width,
 unicode-xid, url, utf-8, utf8_iter, utf8parse, uuid, vello_common, vello_cpu,
 wasm-bindgen, wasm-bindgen-futures, wasm-bindgen-macro,
-wasm-bindgen-macro-support, wasm-bindgen-shared, wasm-streams, web-sys,
+wasm-bindgen-macro-support, wasm-bindgen-shared, wasm-streams, wasmi, wasmi_collections, wasmi_core,
+wasmi_ir, web-sys,
 web-time, web_atoms, weezl, winapi, winapi-i686-pc-windows-gnu,
 winapi-x86_64-pc-windows-gnu, window-vibrancy, windows, windows-collections,
 windows-core, windows-future, windows-implement, windows-interface,
@@ -412,8 +413,7 @@ new_debug_unreachable, nom, nom_locate, noop_proc_macro, nu-ansi-term,
 number_prefix, objc2, objc2-encode, objc2-foundation, open, openssl-sys,
 os_pipe, pango, pango-sys, pdf-bench, pdf-desktop, pdf-diff, pdf-java,
 pdfluent-lopdf, phf, phf_generator, phf_macros, phf_shared, plist,
-precomputed-hash, quick-xml, redox_syscall, redox_users, rfd, rgb, rquickjs,
-rquickjs-core, rquickjs-macro, rquickjs-sys, rusqlite, schannel, schemars,
+precomputed-hash, quick-xml, redox_syscall, redox_users, rfd, rgb, rusqlite, schannel, schemars,
 schemars_derive, sharded-slab, shared_child, sigchld, simd-adler32,
 simd_helpers, slab, soup3, soup3-sys, spin, strsim, synstructure, tiff,
 tokio, tokio-macros, tokio-native-tls, tokio-util, tower, tower-http,
@@ -731,6 +731,44 @@ CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
+================================================================================
+QuickJS-ng — the script engine, compiled into xfa-js-sandboxed's WebAssembly module
+https://github.com/quickjs-ng/quickjs   (version 0.7.0)
+================================================================================
+
+QuickJS (MIT) is a component of crates/xfa-js-sandboxed/wasm-guest/qjs_guest.wasm:
+the module is compiled from the C sources in wasm-guest/quickjs/ (two changes,
+listed in wasm-guest/PATCHES.md) and is interpreted by the wasmi crate. No native
+C code runs. The module also contains code from wasi-libc (Apache-2.0 WITH
+LLVM-exception; MIT and BSD-2-Clause parts derived from musl) and LLVM
+compiler-rt (Apache-2.0 WITH LLVM-exception), linked in by the toolchain
+(zig 0.16.0, build tooling only, not shipped). See wasm-guest/NOTICE.
+
+The MIT License (MIT)
+ 
+Copyright (c) 2017-2021 Fabrice Bellard
+Copyright (c) 2017-2021 Charlie Gordon
+Copyright (c) 2023 Ben Noordhuis
+Copyright (c) 2023 Saúl Ibarra Corretgé
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
 ================================================================================
 tract — ONNX inference for the optional vision layer (#636)
 https://github.com/sonos/tract

package/package.json

@@ -2,8 +2,12 @@
   "name": "@pdfluent/sdk-wasm",
   "type": "module",
   "description": "PDFluent browser SDK — find and replace PDF text programmatically while preserving fonts and layout, plus edit, annotate, redact, sign and validate PDFs (including XFA), entirely client-side via WASM.",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "license": "SEE LICENSE IN LICENSE-OFFER",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pdfluent/pdfluent-sdk"
+  },
   "files": [
     "xfa_wasm_bg.wasm",
     "xfa_wasm.js",
@@ -14,7 +18,8 @@
     "LICENSE-COMMERCIAL",
     "LICENSE-OFFER",
     "NOTICE",
-    "THIRD_PARTY_LICENSES.txt"
+    "THIRD_PARTY_LICENSES.txt",
+    "xfa_wasm.augment.d.ts"
   ],
   "main": "xfa_wasm.js",
   "types": "xfa_wasm.d.ts",
@@ -39,9 +44,21 @@
     "redact"
   ],
   "homepage": "https://pdfluent.com",
-  "author": "Innovation Trigger BV <team@pdfluent.com>",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pdfluent/pdfluent-sdk"
+  "author": "Innovation Trigger B.V. <team@pdfluent.com>",
+  "bugs": {
+    "url": "https://github.com/pdfluent/pdfluent-sdk/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./xfa_wasm.d.ts",
+      "import": "./xfa_wasm.js",
+      "default": "./xfa_wasm.js"
+    },
+    "./augment": {
+      "types": "./xfa_wasm.augment.d.ts"
+    },
+    "./xfa_wasm_bg.wasm": "./xfa_wasm_bg.wasm",
+    "./package.json": "./package.json",
+    "./*": "./*"
   }
 }

package/xfa_wasm.augment.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Hand-maintained TypeScript supplement for `@pdfluent/sdk-wasm`.
+ *
+ * Augments the generated `xfa_wasm.d.ts` with:
+ * - `PdfluentError` class declaration (errors thrown by all WASM methods)
+ * - `XfaWasmError` legacy alias (kept for older consumer code that imported
+ *   the pre-1.0 type name)
+ * - `free()` lifecycle documentation for `PdfDoc` and `XfaEngine`
+ *
+ * Usage: import this file alongside the main module in projects that need
+ * strict error handling:
+ *
+ * ```ts
+ * import init, { PdfDoc } from '@pdfluent/sdk-wasm';
+ * import type { PdfluentError } from '@pdfluent/sdk-wasm/pkg-types/xfa_wasm.augment';
+ * ```
+ *
+ * Or add this file to your `tsconfig.json` `types` array for global augmentation.
+ */
+
+/* --- Typed error class ----------------------------------------------------- */
+
+/**
+ * Structured error thrown by every fallible PDFluent WASM operation.
+ *
+ * `PdfluentError` is a real `class` (extends `Error`) registered on
+ * `globalThis.__PdfluentError` the first time the WASM module loads. The
+ * thrown instance is a true subclass of `Error`, so
+ * `error instanceof PdfluentError` works in user code.
+ *
+ * ## Example
+ *
+ * ```ts
+ * import init, { PdfDoc, PdfluentError } from '@pdfluent/sdk-wasm';
+ * await init();
+ *
+ * try {
+ *   using doc = PdfDoc.open(corruptBytes);
+ * } catch (e) {
+ *   if (e instanceof PdfluentError) {
+ *     console.error(`[${e.code}] ${e.message} (in ${e.operation})`);
+ *     if (e.code === 'E-PARSE-INVALID-PDF') {
+ *       // show "not a valid PDF" UI feedback
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * ## Properties
+ *
+ * | Property | Type | Description |
+ * |----------|------|-------------|
+ * | `code` | `string` | Stable C8 catalogue code, format `E-<CATEGORY>-<SPECIFIC>`. |
+ * | `message` | `string` | Human-readable description. |
+ * | `operation` | `string` | API call that failed (e.g. `"PdfDoc.open"`). |
+ * | `help` | `string` | Optional actionable hint (may be empty). |
+ * | `docsUrl` | `string` | Deep-link to documentation at `https://pdfluent.com/errors/<code>`. |
+ * | `legacyCode` | `string` | Pre-1.0 SCREAMING_SNAKE_CASE identifier, preserved for backward compatibility. |
+ *
+ * ## C8 Error codes (canonical, from `docs/error_catalogue.md`)
+ *
+ * | Code | Thrown by |
+ * |------|-----------|
+ * | `E-PARSE-INVALID-PDF` | `PdfDoc.open` — bytes are not a valid PDF |
+ * | `E-IO-GENERIC` | I/O failure |
+ * | `E-PARSE-UNSUPPORTED-VERSION` | `PdfDoc.open` — PDF version too new |
+ * | `E-COMPLIANCE-PDFA-INVALID` | `convertToPdfa`, `validatePdfA` |
+ * | `E-ENV-UNSUPPORTED-ON-WASM` | Native-only operation invoked from WASM |
+ * | `E-INTERNAL` | Internal safety-net |
+ * | `E-WASM-INVALID-ARGUMENT` | Argument validation (e.g. `validatePdfA("xyz")`) |
+ * | `E-WASM-PAGE-OUT-OF-RANGE` | Page index outside `0..page_count` |
+ * | `E-WASM-RENDER-FAILED` | `renderPage`, `renderPageToCanvas` |
+ * | `E-WASM-RENDER-FALLBACK` | Vector renderer hit unsupported feature |
+ * | `E-WASM-TEXT-EXTRACT-FAILED` | `getTextPositions` |
+ * | `E-WASM-XFA-FAILED` | `flattenXfa` |
+ * | `E-WASM-MERGE-FAILED` | `merge` |
+ * | `E-WASM-SAVE-FAILED` | Internal save / serialize |
+ * | `E-WASM-INVALID-JSON` | `fromFields`, `fromJson`, `importJson`, schema export |
+ * | `E-WASM-FORMCALC-FAILED` | `runCalculations` |
+ * | `E-SECURITY-DECRYPTION-FAILED` | `decryptPdf`, `signPdf`: wrong password, or one that does not entitle the call |
+ * | `E-WASM-SIGN-FAILED` | `signPdf` |
+ *
+ * ## Backward compatibility
+ *
+ * Before 1.0 the WASM binding threw `XfaWasmError` with a SCREAMING_SNAKE_CASE
+ * `.code` property. That identifier is preserved on the new `.legacyCode`
+ * property and on the `XfaWasmError` type alias (see below) so existing
+ * consumer code keeps working. Newly-written code should use `.code` with the
+ * `E-<CATEGORY>-<SPECIFIC>` strings.
+ */
+export declare class PdfluentError extends Error {
+  /** Stable C8 catalogue code in `E-<CATEGORY>-<SPECIFIC>` format. */
+  readonly code: string;
+  /** Short identifier of the API call that failed (e.g. `"PdfDoc.open"`). */
+  readonly operation: string;
+  /** Optional actionable hint for developers. May be empty string. */
+  readonly help: string;
+  /** Deep-link into the error documentation. */
+  readonly docsUrl: string;
+  /** Pre-1.0 SCREAMING_SNAKE_CASE identifier, kept for backward compatibility. */
+  readonly legacyCode: string;
+}
+
+/**
+ * Legacy alias for `PdfluentError`. Existing code that does
+ * `import { XfaWasmError }` keeps compiling; new code should use
+ * `PdfluentError`.
+ *
+ * @deprecated Use {@link PdfluentError}.
+ */
+export type XfaWasmError = PdfluentError;
+
+/* --- Type guards ----------------------------------------------------------- */
+
+/**
+ * Type guard: returns `true` when `e` is a `PdfluentError` thrown by the WASM module.
+ *
+ * ```ts
+ * try {
+ *   doc.flattenXfa();
+ * } catch (e) {
+ *   if (isPdfluentError(e)) {
+ *     console.error(e.code, e.help);
+ *   }
+ * }
+ * ```
+ */
+export declare function isPdfluentError(e: unknown): e is PdfluentError;
+
+/**
+ * Legacy alias for {@link isPdfluentError}.
+ * @deprecated Use {@link isPdfluentError}.
+ */
+export declare function isXfaWasmError(e: unknown): e is PdfluentError;
+
+/* --- Lifecycle augmentation ----------------------------------------------- */
+
+/**
+ * Lifecycle contract for WASM objects that hold native memory.
+ *
+ * Both `PdfDoc` and `XfaEngine` allocate memory in the WASM heap. The JavaScript
+ * garbage collector does **not** free WASM heap memory — you must call `free()`
+ * explicitly, or use the `using` keyword (TypeScript 5.2+, requires `--target ES2022`
+ * or newer and `lib: ["ESNext.Disposable"]`).
+ *
+ * ### Option 1 — `using` (recommended, TypeScript 5.2+)
+ *
+ * ```ts
+ * {
+ *   using doc = PdfDoc.open(bytes);
+ *   const count = doc.pageCount();
+ * } // doc.free() called automatically here
+ * ```
+ *
+ * ### Option 2 — explicit `free()`
+ *
+ * ```ts
+ * const doc = PdfDoc.open(bytes);
+ * try {
+ *   const count = doc.pageCount();
+ * } finally {
+ *   doc.free();
+ * }
+ * ```
+ *
+ * ### After `free()`
+ *
+ * Once `free()` is called, the object's native pointer is invalidated. Any
+ * subsequent method call throws a `PdfluentError` with code `"E-INTERNAL"`.
+ */
+export interface WasmLifecycle {
+  /**
+   * Release all native WASM heap memory owned by this object.
+   *
+   * - Must be called when you are done with the object, unless you used `using`.
+   * - After calling `free()`, all methods throw.
+   * - Calling `free()` twice is safe (no-op).
+   * - Equivalent to `[Symbol.dispose]()`.
+   */
+  free(): void;
+
+  /**
+   * Alias for `free()`, called automatically by the `using` statement.
+   *
+   * See {@link WasmLifecycle.free} for full lifecycle documentation.
+   */
+  [Symbol.dispose](): void;
+}

package/xfa_wasm.d.ts

@@ -330,6 +330,10 @@ export class PdfDoc {
     /**
      * Search-and-redact: every match of `query` (literal text, case-sensitive)
      * is permanently removed from every page.
+     *
+     * Throws `E-PARSE-INVALID-PDF` when a page's text could not be read:
+     * that page was not searched, so returning bytes would read as "no
+     * matches there" (#698).
      */
     redactSearch(query: string): Uint8Array;
     /**
@@ -426,6 +430,16 @@ export class PdfDoc {
      * extraction fails.
      */
     text(page_index: number): string;
+    /**
+     * Every text block of the document with its page and enclosing box, as
+     * JSON (#416): `[{"text": "...", "bbox": [xMin, yMin, xMax, yMax], "page": 0}]`.
+     *
+     * `page` is 0-based like every page index in this binding; `bbox` is in PDF
+     * points with the origin at the bottom left (PDF space, not the y-down CSS
+     * space `getTextPositions` returns). An XFA form is read from its flattened
+     * form, as `text` and `getTextPositions` do.
+     */
+    textWithLayout(): string;
     /**
      * Convert this PDF to a Word `.docx` package.
      *
@@ -532,6 +546,15 @@ export class PdfDocMut {
      * `formatted = false`, `bytesChanged = 0`, no error.
      */
     formatTextSpan(page_num: number, run_index: number, font_size?: number | null, color?: string | null): string;
+    /**
+     * The images drawn on a page (0-based `pageIndex`) as JSON, in drawing
+     * order, form-nested and inline images included:
+     * `[{"formPath":[…],"opIndex":n,"kind":"xobject"|"inline","resourceName":…,
+     * "formNames":[…],"ctm":[6],"bbox":[x0,y0,x1,y1],"pixelWidth":…,
+     * "pixelHeight":…,"hasSmask":…}]`. `bbox` is in page space, origin at the
+     * bottom left. An entry is the handle the three edit methods take.
+     */
+    imagePlacements(page_index: number): string;
     /**
      * Open a PDF for editing.
      */
@@ -547,12 +570,26 @@ export class PdfDocMut {
     /**
      * Search-and-redact: every literal match of `query` is permanently
      * removed from every page.
+     *
+     * Throws `E-PARSE-INVALID-PDF` when a page's text could not be read:
+     * that page was not searched, so success would read as "no matches
+     * there" (#698). The document is then left as it was.
      */
     redactSearch(query: string): void;
+    /**
+     * Remove one placed image. The image data leaves the file when nothing
+     * else uses it.
+     */
+    removeImage(page_index: number, handle_json: string): void;
     /**
      * Re-order pages. `new_order` is a permutation of `0..page_count`.
      */
     reorderPages(new_order: Uint32Array): void;
+    /**
+     * Swap the picture of one placed image for JPEG or PNG `data`, fitted
+     * inside the old placement and centred. Returns the new handle as JSON.
+     */
+    replaceImage(page_index: number, handle_json: string, data: Uint8Array): string;
     /**
      * G3 — Replace a text span on a page.
      *
@@ -622,6 +659,13 @@ export class PdfDocMut {
      * `{"field.path": "value", ...}`.
      */
     setFormFields(fields_json: string): void;
+    /**
+     * Move or resize one placed image so its bounding box becomes
+     * `[x0, y0, x1, y1]` in page space. `handleJson` is an entry of
+     * `imagePlacements`. Returns the new handle as JSON. An edit inside a Form
+     * XObject copies the form for this page, so other pages keep the original.
+     */
+    setImageRect(page_index: number, handle_json: string, x0: number, y0: number, x1: number, y1: number): string;
     /**
      * Select multiple options on a multi-select list box.
      *
@@ -893,6 +937,7 @@ export interface InitOutput {
     readonly pdfdoc_setFormFields: (a: number, b: number, c: number, d: number) => void;
     readonly pdfdoc_signatures: (a: number, b: number) => void;
     readonly pdfdoc_text: (a: number, b: number, c: number) => void;
+    readonly pdfdoc_textWithLayout: (a: number, b: number) => void;
     readonly pdfdoc_toDocx: (a: number, b: number) => void;
     readonly pdfdoc_toPptx: (a: number, b: number) => void;
     readonly pdfdoc_toXlsx: (a: number, b: number) => void;
@@ -908,16 +953,20 @@ export interface InitOutput {
     readonly pdfdocmut_deletePages: (a: number, b: number, c: number, d: number) => void;
     readonly pdfdocmut_extractPages: (a: number, b: number, c: number, d: number) => void;
     readonly pdfdocmut_formatTextSpan: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly pdfdocmut_imagePlacements: (a: number, b: number, c: number) => void;
     readonly pdfdocmut_open: (a: number, b: number, c: number) => void;
     readonly pdfdocmut_pageCount: (a: number) => number;
     readonly pdfdocmut_redactRegion: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly pdfdocmut_redactSearch: (a: number, b: number, c: number, d: number) => void;
+    readonly pdfdocmut_removeImage: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly pdfdocmut_reorderPages: (a: number, b: number, c: number, d: number) => void;
+    readonly pdfdocmut_replaceImage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly pdfdocmut_replaceTextSpan: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly pdfdocmut_rotatePage: (a: number, b: number, c: number, d: number) => void;
     readonly pdfdocmut_save: (a: number, b: number) => void;
     readonly pdfdocmut_setFormField: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly pdfdocmut_setFormFields: (a: number, b: number, c: number, d: number) => void;
+    readonly pdfdocmut_setImageRect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
     readonly pdfdocmut_setMultiSelect: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly pdfdocmut_setTextRunStyle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly signPdf: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;

package/xfa_wasm.js

@@ -1,5 +1,5 @@
 /* @ts-self-types="./xfa_wasm.d.ts" */
-import { __pdfluent_error_ctor } from './snippets/xfa-wasm-d1985887593da269/inline0.js';
+import { __pdfluent_error_ctor } from './snippets/xfa-wasm-0357326a9eb2f21e/inline0.js';
 
 
 /**
@@ -725,6 +725,10 @@ export class PdfDoc {
     /**
      * Search-and-redact: every match of `query` (literal text, case-sensitive)
      * is permanently removed from every page.
+     *
+     * Throws `E-PARSE-INVALID-PDF` when a page's text could not be read:
+     * that page was not searched, so returning bytes would read as "no
+     * matches there" (#698).
      * @param {string} query
      * @returns {Uint8Array}
      */
@@ -1048,6 +1052,40 @@ export class PdfDoc {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Every text block of the document with its page and enclosing box, as
+     * JSON (#416): `[{"text": "...", "bbox": [xMin, yMin, xMax, yMax], "page": 0}]`.
+     *
+     * `page` is 0-based like every page index in this binding; `bbox` is in PDF
+     * points with the origin at the bottom left (PDF space, not the y-down CSS
+     * space `getTextPositions` returns). An XFA form is read from its flattened
+     * form, as `text` and `getTextPositions` do.
+     * @returns {string}
+     */
+    textWithLayout() {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.pdfdoc_textWithLayout(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr1 = r0;
+            var len1 = r1;
+            if (r3) {
+                ptr1 = 0; len1 = 0;
+                throw takeObject(r2);
+            }
+            deferred2_0 = ptr1;
+            deferred2_1 = len1;
+            return getStringFromWasm0(ptr1, len1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+        }
+    }
     /**
      * Convert this PDF to a Word `.docx` package.
      *
@@ -1469,6 +1507,40 @@ export class PdfDocMut {
             wasm.__wbindgen_export4(deferred3_0, deferred3_1, 1);
         }
     }
+    /**
+     * The images drawn on a page (0-based `pageIndex`) as JSON, in drawing
+     * order, form-nested and inline images included:
+     * `[{"formPath":[…],"opIndex":n,"kind":"xobject"|"inline","resourceName":…,
+     * "formNames":[…],"ctm":[6],"bbox":[x0,y0,x1,y1],"pixelWidth":…,
+     * "pixelHeight":…,"hasSmask":…}]`. `bbox` is in page space, origin at the
+     * bottom left. An entry is the handle the three edit methods take.
+     * @param {number} page_index
+     * @returns {string}
+     */
+    imagePlacements(page_index) {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.pdfdocmut_imagePlacements(retptr, this.__wbg_ptr, page_index);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr1 = r0;
+            var len1 = r1;
+            if (r3) {
+                ptr1 = 0; len1 = 0;
+                throw takeObject(r2);
+            }
+            deferred2_0 = ptr1;
+            deferred2_1 = len1;
+            return getStringFromWasm0(ptr1, len1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+        }
+    }
     /**
      * Open a PDF for editing.
      * @param {Uint8Array} bytes
@@ -1523,6 +1595,10 @@ export class PdfDocMut {
     /**
      * Search-and-redact: every literal match of `query` is permanently
      * removed from every page.
+     *
+     * Throws `E-PARSE-INVALID-PDF` when a page's text could not be read:
+     * that page was not searched, so success would read as "no matches
+     * there" (#698). The document is then left as it was.
      * @param {string} query
      */
     redactSearch(query) {
@@ -1540,6 +1616,27 @@ export class PdfDocMut {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Remove one placed image. The image data leaves the file when nothing
+     * else uses it.
+     * @param {number} page_index
+     * @param {string} handle_json
+     */
+    removeImage(page_index, handle_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(handle_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.pdfdocmut_removeImage(retptr, this.__wbg_ptr, page_index, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Re-order pages. `new_order` is a permutation of `0..page_count`.
      * @param {Uint32Array} new_order
@@ -1559,6 +1656,42 @@ export class PdfDocMut {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Swap the picture of one placed image for JPEG or PNG `data`, fitted
+     * inside the old placement and centred. Returns the new handle as JSON.
+     * @param {number} page_index
+     * @param {string} handle_json
+     * @param {Uint8Array} data
+     * @returns {string}
+     */
+    replaceImage(page_index, handle_json, data) {
+        let deferred4_0;
+        let deferred4_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(handle_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passArray8ToWasm0(data, wasm.__wbindgen_export);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.pdfdocmut_replaceImage(retptr, this.__wbg_ptr, page_index, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr3 = r0;
+            var len3 = r1;
+            if (r3) {
+                ptr3 = 0; len3 = 0;
+                throw takeObject(r2);
+            }
+            deferred4_0 = ptr3;
+            deferred4_1 = len3;
+            return getStringFromWasm0(ptr3, len3);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred4_0, deferred4_1, 1);
+        }
+    }
     /**
      * G3 — Replace a text span on a page.
      *
@@ -1724,6 +1857,45 @@ export class PdfDocMut {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Move or resize one placed image so its bounding box becomes
+     * `[x0, y0, x1, y1]` in page space. `handleJson` is an entry of
+     * `imagePlacements`. Returns the new handle as JSON. An edit inside a Form
+     * XObject copies the form for this page, so other pages keep the original.
+     * @param {number} page_index
+     * @param {string} handle_json
+     * @param {number} x0
+     * @param {number} y0
+     * @param {number} x1
+     * @param {number} y1
+     * @returns {string}
+     */
+    setImageRect(page_index, handle_json, x0, y0, x1, y1) {
+        let deferred3_0;
+        let deferred3_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(handle_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.pdfdocmut_setImageRect(retptr, this.__wbg_ptr, page_index, ptr0, len0, x0, y0, x1, y1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr2 = r0;
+            var len2 = r1;
+            if (r3) {
+                ptr2 = 0; len2 = 0;
+                throw takeObject(r2);
+            }
+            deferred3_0 = ptr2;
+            deferred3_1 = len2;
+            return getStringFromWasm0(ptr2, len2);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+        }
+    }
     /**
      * Select multiple options on a multi-select list box.
      *
@@ -2416,7 +2588,7 @@ export function signPdf(bytes, pkcs12, password, options) {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg___pdfluent_error_ctor_17e86bb485874967: function() {
+        __wbg___pdfluent_error_ctor_9f2854a17b02ffba: function() {
             const ret = __pdfluent_error_ctor();
             return addHeapObject(ret);
         },

package/xfa_wasm_bg.wasm.d.ts

@@ -44,6 +44,7 @@ export const pdfdoc_setFormField: (a: number, b: number, c: number, d: number, e
 export const pdfdoc_setFormFields: (a: number, b: number, c: number, d: number) => void;
 export const pdfdoc_signatures: (a: number, b: number) => void;
 export const pdfdoc_text: (a: number, b: number, c: number) => void;
+export const pdfdoc_textWithLayout: (a: number, b: number) => void;
 export const pdfdoc_toDocx: (a: number, b: number) => void;
 export const pdfdoc_toPptx: (a: number, b: number) => void;
 export const pdfdoc_toXlsx: (a: number, b: number) => void;
@@ -59,16 +60,20 @@ export const pdfdocmut_compress: (a: number, b: number) => void;
 export const pdfdocmut_deletePages: (a: number, b: number, c: number, d: number) => void;
 export const pdfdocmut_extractPages: (a: number, b: number, c: number, d: number) => void;
 export const pdfdocmut_formatTextSpan: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const pdfdocmut_imagePlacements: (a: number, b: number, c: number) => void;
 export const pdfdocmut_open: (a: number, b: number, c: number) => void;
 export const pdfdocmut_pageCount: (a: number) => number;
 export const pdfdocmut_redactRegion: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const pdfdocmut_redactSearch: (a: number, b: number, c: number, d: number) => void;
+export const pdfdocmut_removeImage: (a: number, b: number, c: number, d: number, e: number) => void;
 export const pdfdocmut_reorderPages: (a: number, b: number, c: number, d: number) => void;
+export const pdfdocmut_replaceImage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const pdfdocmut_replaceTextSpan: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const pdfdocmut_rotatePage: (a: number, b: number, c: number, d: number) => void;
 export const pdfdocmut_save: (a: number, b: number) => void;
 export const pdfdocmut_setFormField: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const pdfdocmut_setFormFields: (a: number, b: number, c: number, d: number) => void;
+export const pdfdocmut_setImageRect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const pdfdocmut_setMultiSelect: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const pdfdocmut_setTextRunStyle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const signPdf: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;