@pdfluent/sdk-wasm 1.2.0 → 1.3.0

package/README.md

@@ -3,11 +3,11 @@
 [Source on GitHub](https://github.com/pdfluent/pdfluent-sdk) · [Documentation](https://pdfluent.com/docs) · [Report an issue](https://github.com/pdfluent/pdfluent-sdk/issues)
 
 WebAssembly distribution of the PDFluent PDF engine. Read, edit, annotate,
-redact, sign, and validate PDFs (including XFA) entirely in the browser —
+redact, sign, and validate PDFs (including XFA) entirely in the browser -
 zero bytes go to a server.
 
 Published as `@pdfluent/sdk-wasm` on npm. (The crate directory is named
-`xfa-wasm` for historical XFA roots — the published npm package covers the
+`xfa-wasm` for historical XFA roots - the published npm package covers the
 full SDK surface needed for an in-browser PDF editor. Previously known as
 `@pdfluent/xfa-wasm`; renamed to `@pdfluent/sdk-wasm`.)
 
@@ -22,7 +22,7 @@ full SDK surface needed for an in-browser PDF editor. Previously known as
 - **Text watermark**: diagonal text watermark with configurable opacity
 - **Redaction**: by region (rectangle) or by search query (permanent removal: the content is gone, not covered)
 - **Stream compression**: re-deflate content streams for smaller file size
-- **`PdfDocMut`**: stateful editing handle — open once, mutate in place,
+- **`PdfDocMut`**: stateful editing handle - open once, mutate in place,
   save once. One parse and one serialise for a whole editing session instead
   of one per operation, with identical output bytes.
 
@@ -216,7 +216,7 @@ wasm-pack build crates/xfa-wasm --target web -- --no-default-features
 | `redactSearch(query)` | Find all literal matches of `query` and redact each |
 | `compress()` | Re-deflate content streams; returns optimised bytes |
 
-### PdfDocMut — **recommended for editor workflows**
+### PdfDocMut - **recommended for editor workflows**
 
 `PdfDocMut` is a stateful editing handle. Open once, mutate in place,
 save once. The `PdfDoc` class above is great for inspection and
@@ -229,14 +229,14 @@ serialise per step.
 |--------|-------------|
 | `PdfDocMut.open(bytes)` | Open for editing |
 | `pageCount()` | Live page count after any mutations so far |
-| `save()` | Serialise current state to `Uint8Array`. Non-consuming — keep editing after |
+| `save()` | Serialise current state to `Uint8Array`. Non-consuming - keep editing after |
 | `free()` | Release the WASM-side memory deterministically |
 | `deletePages(pages)` | In place |
 | `rotatePage(pageIndex, degrees)` | In place |
 | `reorderPages(newOrder)` | In place |
 | `extractPages(pages)` | Returns bytes for a NEW subdocument; current editor unchanged |
-| `setFormField(path, value)` | In place — text, checkbox, radio, and choice; updates `/V`, `/AS`, and `/AP` |
-| `setFormFields(jsonObject)` | In place, bulk — same full chain for each entry |
+| `setFormField(path, value)` | In place - text, checkbox, radio, and choice; updates `/V`, `/AS`, and `/AP` |
+| `setFormFields(jsonObject)` | In place, bulk - same full chain for each entry |
 | `addHighlight(pageIndex, x, y, w, h, colorHex?)` | In place (feature: annotate) |
 | `addStickyNote(pageIndex, x, y, contents)` | In place (feature: annotate) |
 | `addFreeText(pageIndex, x, y, w, h, contents)` | In place (feature: annotate) |
@@ -254,7 +254,7 @@ await init();
 const bytes  = new Uint8Array(await (await fetch('/document.pdf')).arrayBuffer());
 const editor = PdfDocMut.open(bytes);
 
-// All edits operate on the same internal lopdf::Document — no re-parse.
+// All edits operate on the same internal lopdf::Document - no re-parse.
 editor.reorderPages(new Uint32Array([1, 0, 2]));
 editor.addTextWatermark('CONCEPT', 0.3);
 editor.addHighlight(0, 100, 700, 200, 20, '#ffeb3b');

package/THIRD_PARTY_LICENSES.txt

@@ -133,8 +133,27 @@ Two vendored files, both Adobe's own CMap resources, both BSD-3-Clause:
                                              form, read by the PDF/A fixups for
                                              EUC-encoded CID text
                                              Copyright 1990-2019 Adobe
+  crates/pdf-manip/resources/predefined-cmaps/pack.z
+                                             the 61 predefined CMaps of the PDF
+                                             specification as one compressed
+                                             pack, built by
+                                             scripts/pdfa/build_cmap_pack.py
+                                             from github.com/adobe-type-tools/
+                                             cmap-resources, commit f5cf3bca
+                                             (BSD-3-Clause); read by the PDF/A
+                                             conversion so it needs no
+                                             poppler-data on the host
+                                             Copyright 1990-2023 Adobe
+  crates/pdf-manip/resources/predefined-cmaps/PROVENANCE.sha256
+                                             ours: the SHA-256 of each source
+                                             file and of the pack built from
+                                             them
+  crates/pdf-manip/resources/predefined-cmaps/LICENSE-Adobe-CMap.txt
+                                             the full BSD-3-Clause text and
+                                             Adobe's notice for the pack above
 
 Upstream licence texts in the tree:
+  crates/pdf-manip/resources/predefined-cmaps/LICENSE-Adobe-CMap.txt  (BSD-3-Clause, full text)
   crates/pdf-font/assets/LICENSE.txt              (BSD-3-Clause, full text)
   crates/pdf-manip/resources/cmap/GB-EUC-H        (the notice is the file's own
                                                    header, as Adobe ships it)
@@ -880,3 +899,27 @@ SOFTWARE
 ================================================================================
 END OF THIRD PARTY LICENSES
 ================================================================================
+
+================================================================================
+qrcodegen 1.8.0 — QR Code generator library (MIT)
+https://www.nayuki.io/page/qr-code-generator-library
+================================================================================
+
+Copyright (c) Project Nayuki. (MIT License)
+https://www.nayuki.io/page/qr-code-generator-library
+
+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.

package/package.json

@@ -2,7 +2,7 @@
   "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.2.0",
+  "version": "1.3.0",
   "license": "SEE LICENSE IN LICENSE-OFFER",
   "repository": {
     "type": "git",

package/xfa_wasm.d.ts

@@ -122,7 +122,7 @@ export enum ChromaSampling {
  *
  * # Errors
  *
- * All fallible methods throw a `PdfluentError` — a standard `Error` subclass with
+ * All fallible methods throw a `PdfluentError` - a standard `Error` subclass with
  * these properties:
  * - `code`: stable C8 catalogue identifier in `E-<CATEGORY>-<SPECIFIC>` format
  *   (e.g. `"E-PARSE-INVALID-PDF"`). Use this for programmatic dispatch.
@@ -372,7 +372,7 @@ export class PdfDoc {
      * Render a page directly to an HTML canvas element (wasm32 only).
      *
      * Calls `canvas.getContext("2d")`, sets the canvas dimensions to the
-     * rendered pixel size, and calls `putImageData` — no round-trip through
+     * rendered pixel size, and calls `putImageData` - no round-trip through
      * a JS Uint8Array.  XFA documents are auto-flattened before rendering.
      *
      * ```js
@@ -489,7 +489,7 @@ export class PdfDocMut {
     addFreeText(page_index: number, x: number, y: number, w: number, h: number, contents: string): void;
     /**
      * Add a highlight annotation over the given page rectangle.
-     * `color_hex` like `"#ffeb3b"` — defaults to yellow when `None`.
+     * `color_hex` like `"#ffeb3b"` - defaults to yellow when `None`.
      */
     addHighlight(page_index: number, x: number, y: number, w: number, h: number, color_hex?: string | null): void;
     /**
@@ -591,14 +591,14 @@ export class PdfDocMut {
      */
     replaceImage(page_index: number, handle_json: string, data: Uint8Array): string;
     /**
-     * G3 — Replace a text span on a page.
+     * G3 - Replace a text span on a page.
      *
      * The editor passes the **exact** text it extracted from
      * `getTextPositions()` as `original_text`, and the desired
      * replacement as `replacement_text`. The replacement is
      * re-encoded into the same font used by the matched span
      * (subset-font fallback applies when the original font cannot
-     * encode the replacement — see
+     * encode the replacement - see
      * `pdf-manip::text_replace::replace_text`).
      *
      * `page_num` is **1-based** to match the rest of the
@@ -619,11 +619,11 @@ export class PdfDocMut {
      *
      * Typed unsupported codes (all set `replaced=false`):
      *
-     * - `"NO_MATCH"` — `original_text` not found on the page.
-     * - `"ENCODING_UNSUPPORTED"` — replacement contains characters
+     * - `"NO_MATCH"` - `original_text` not found on the page.
+     * - `"ENCODING_UNSUPPORTED"` - replacement contains characters
      *   the matched font cannot encode and no fallback font is
      *   available.
-     * - `"REPLACE_FAILED"` — anything else (lopdf I/O,
+     * - `"REPLACE_FAILED"` - anything else (lopdf I/O,
      *   serialisation, FontMap construction, …). `reason` carries
      *   the lower-level error message.
      *
@@ -648,7 +648,7 @@ export class PdfDocMut {
     /**
      * Set a single AcroForm field value (text, checkbox, radio, or choice).
      *
-     * Delegates to [`pdf_forms::apply_field_value`] — the single SDK
+     * Delegates to [`pdf_forms::apply_field_value`] - the single SDK
      * writeback chain. It keeps `/V` (ASCII literal else UTF-16BE+BOM),
      * per-widget `/AS`, and regenerated `/AP` streams consistent, resolves
      * fully-qualified names through `/Kids`, and rejects read-only fields.
@@ -767,7 +767,7 @@ export class TextEditor {
  *
  * # Errors
  *
- * All fallible methods throw a `PdfluentError` — a standard `Error` subclass with
+ * All fallible methods throw a `PdfluentError` - a standard `Error` subclass with
  * these properties:
  * - `code`: stable C8 catalogue identifier in `E-<CATEGORY>-<SPECIFIC>` format
  *   (e.g. `"E-PARSE-INVALID-PDF"`). Use this for programmatic dispatch.

package/xfa_wasm.js

@@ -1,5 +1,5 @@
 /* @ts-self-types="./xfa_wasm.d.ts" */
-import { __pdfluent_error_ctor } from './snippets/xfa-wasm-0357326a9eb2f21e/inline0.js';
+import { __pdfluent_error_ctor } from './snippets/xfa-wasm-d23d7ce846a87fdd/inline0.js';
 
 
 /**
@@ -45,7 +45,7 @@ export const ChromaSampling = Object.freeze({
  *
  * # Errors
  *
- * All fallible methods throw a `PdfluentError` — a standard `Error` subclass with
+ * All fallible methods throw a `PdfluentError` - a standard `Error` subclass with
  * these properties:
  * - `code`: stable C8 catalogue identifier in `E-<CATEGORY>-<SPECIFIC>` format
  *   (e.g. `"E-PARSE-INVALID-PDF"`). Use this for programmatic dispatch.
@@ -823,7 +823,7 @@ export class PdfDoc {
      * Render a page directly to an HTML canvas element (wasm32 only).
      *
      * Calls `canvas.getContext("2d")`, sets the canvas dimensions to the
-     * rendered pixel size, and calls `putImageData` — no round-trip through
+     * rendered pixel size, and calls `putImageData` - no round-trip through
      * a JS Uint8Array.  XFA documents are auto-flattened before rendering.
      *
      * ```js
@@ -1266,7 +1266,7 @@ export class PdfDocMut {
     }
     /**
      * Add a highlight annotation over the given page rectangle.
-     * `color_hex` like `"#ffeb3b"` — defaults to yellow when `None`.
+     * `color_hex` like `"#ffeb3b"` - defaults to yellow when `None`.
      * @param {number} page_index
      * @param {number} x
      * @param {number} y
@@ -1693,14 +1693,14 @@ export class PdfDocMut {
         }
     }
     /**
-     * G3 — Replace a text span on a page.
+     * G3 - Replace a text span on a page.
      *
      * The editor passes the **exact** text it extracted from
      * `getTextPositions()` as `original_text`, and the desired
      * replacement as `replacement_text`. The replacement is
      * re-encoded into the same font used by the matched span
      * (subset-font fallback applies when the original font cannot
-     * encode the replacement — see
+     * encode the replacement - see
      * `pdf-manip::text_replace::replace_text`).
      *
      * `page_num` is **1-based** to match the rest of the
@@ -1721,11 +1721,11 @@ export class PdfDocMut {
      *
      * Typed unsupported codes (all set `replaced=false`):
      *
-     * - `"NO_MATCH"` — `original_text` not found on the page.
-     * - `"ENCODING_UNSUPPORTED"` — replacement contains characters
+     * - `"NO_MATCH"` - `original_text` not found on the page.
+     * - `"ENCODING_UNSUPPORTED"` - replacement contains characters
      *   the matched font cannot encode and no fallback font is
      *   available.
-     * - `"REPLACE_FAILED"` — anything else (lopdf I/O,
+     * - `"REPLACE_FAILED"` - anything else (lopdf I/O,
      *   serialisation, FontMap construction, …). `reason` carries
      *   the lower-level error message.
      *
@@ -1813,7 +1813,7 @@ export class PdfDocMut {
     /**
      * Set a single AcroForm field value (text, checkbox, radio, or choice).
      *
-     * Delegates to [`pdf_forms::apply_field_value`] — the single SDK
+     * Delegates to [`pdf_forms::apply_field_value`] - the single SDK
      * writeback chain. It keeps `/V` (ASCII literal else UTF-16BE+BOM),
      * per-widget `/AS`, and regenerated `/AP` streams consistent, resolves
      * fully-qualified names through `/Kids`, and rejects read-only fields.
@@ -2191,7 +2191,7 @@ if (Symbol.dispose) TextEditor.prototype[Symbol.dispose] = TextEditor.prototype.
  *
  * # Errors
  *
- * All fallible methods throw a `PdfluentError` — a standard `Error` subclass with
+ * All fallible methods throw a `PdfluentError` - a standard `Error` subclass with
  * these properties:
  * - `code`: stable C8 catalogue identifier in `E-<CATEGORY>-<SPECIFIC>` format
  *   (e.g. `"E-PARSE-INVALID-PDF"`). Use this for programmatic dispatch.
@@ -2588,7 +2588,7 @@ export function signPdf(bytes, pkcs12, password, options) {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg___pdfluent_error_ctor_9f2854a17b02ffba: function() {
+        __wbg___pdfluent_error_ctor_ed1ceb6e41324c5c: function() {
             const ret = __pdfluent_error_ctor();
             return addHeapObject(ret);
         },