@pdfluent/sdk-wasm 1.0.0-beta.8 → 1.0.0

package/package.json

@@ -1,15 +1,24 @@
 {
   "name": "@pdfluent/sdk-wasm",
   "type": "module",
-  "description": "PDFluent browser SDK — read, edit, annotate, redact, sign, and validate PDFs (including XFA) entirely client-side via WASM.",
-  "version": "1.0.0-beta.8",
-  "license": "SEE LICENSE IN LICENSE",
+  "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.0.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",
     "xfa_wasm.d.ts",
     "snippets",
-    "xfa_wasm_bg.wasm.d.ts"
+    "xfa_wasm_bg.wasm.d.ts",
+    "LICENSE",
+    "LICENSE-COMMERCIAL",
+    "LICENSE-OFFER",
+    "NOTICE",
+    "THIRD_PARTY_LICENSES.txt"
   ],
   "main": "xfa_wasm.js",
   "types": "xfa_wasm.d.ts",
@@ -22,11 +31,23 @@
     "pdfluent",
     "browser",
     "sdk",
+    "pdf-text-replace",
+    "find-and-replace",
+    "edit-pdf-text",
+    "pdf-editor",
     "xfa",
+    "acroform",
+    "pades",
     "forms",
     "annotate",
     "redact"
   ],
   "homepage": "https://pdfluent.com",
-  "author": "Innovation Trigger BV <team@pdfluent.com>"
+  "author": "Innovation Trigger BV <team@pdfluent.com>",
+  "bugs": {
+    "url": "https://github.com/pdfluent/pdfluent-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/xfa_wasm.d.ts

@@ -23,27 +23,6 @@ export enum ChromaSampling {
     Cs400 = 3,
 }
 
-/**
- * Status of the currently-active license.
- */
-export class LicenseStatus {
-    private constructor();
-    free(): void;
-    [Symbol.dispose](): void;
-    /**
-     * Whether output is marked via `/Producer` metadata (Trial tier).
-     */
-    readonly outputIsMarked: boolean;
-    /**
-     * Source: `"Default" | "EnvVar" | "Explicit"`.
-     */
-    readonly source: string;
-    /**
-     * Tier name: `"Trial" | "Developer" | "Team" | "Business" | "Enterprise"`.
-     */
-    readonly tier: string;
-}
-
 /**
  * PDF document handle for analysis and text extraction.
  *
@@ -214,6 +193,22 @@ export class PdfDoc {
      * is permanently removed from every page.
      */
     redactSearch(query: string): Uint8Array;
+    /**
+     * Replace this document's content with new bytes in-place.
+     *
+     * Call this after [`PdfDocMut.save`] to update the render handle with
+     * the mutated PDF bytes so that subsequent [`renderPage`] calls reflect
+     * the changes, without needing to create a new `PdfDoc` object.
+     *
+     * ```js
+     * const handle = PdfDocMut.open(bytes);
+     * handle.replaceTextSpan(1, "old", "new");
+     * const newBytes = handle.save();
+     * doc.refresh(newBytes);          // engine now renders the edited content
+     * doc.renderPage(0, 1.5);         // ← shows "new" instead of "old"
+     * ```
+     */
+    refresh(data: Uint8Array): void;
     /**
      * Render a page to RGBA pixels.
      *
@@ -266,11 +261,18 @@ export class PdfDoc {
      */
     rotatePage(page_index: number, degrees: number): Uint8Array;
     /**
-     * Set a single AcroForm text-field value. Returns the new PDF bytes.
+     * Set a single AcroForm **text** field value. Returns the new PDF bytes.
+     *
+     * Updates `/V` (ASCII literal or UTF-16BE+BOM), per-widget `/AS`, and
+     * regenerates the `/AP` appearance stream so the fill is visible without
+     * `/NeedAppearances` processing. Read-only fields throw.
+     *
+     * **Text fields only.** For checkbox, radio, and choice fields use
+     * `PdfDocMut.setFormField`, which runs the full type-aware dispatch.
      */
     setFormField(path: string, value: string): Uint8Array;
     /**
-     * Bulk-set multiple AcroForm text fields from a JSON object
+     * Bulk-set multiple AcroForm **text** fields from a JSON object
      * `{"field.path": "value", ...}`. Returns the new PDF bytes.
      */
     setFormFields(fields_json: string): Uint8Array;
@@ -285,6 +287,25 @@ export class PdfDoc {
      * extraction fails.
      */
     text(page_index: number): string;
+    /**
+     * Convert this PDF to a Word `.docx` package.
+     *
+     * Returns the package as a `Uint8Array`.
+     *
+     * The browser SDK could not do this until 23-08-2026: the conversion
+     * crates were excluded from wasm32 by a comment that applied to the
+     * renderer, not to them.
+     */
+    toDocx(): Uint8Array;
+    /**
+     * Convert this PDF to a PowerPoint `.pptx` deck, one slide per page.
+     * See [`Self::to_docx`].
+     */
+    toPptx(): Uint8Array;
+    /**
+     * Convert this PDF to an Excel `.xlsx` workbook. See [`Self::to_docx`].
+     */
+    toXlsx(): Uint8Array;
     /**
      * Validate against a PDF/A level. Returns compliance report as JSON.
      */
@@ -449,26 +470,101 @@ export class PdfDocMut {
      */
     save(): Uint8Array;
     /**
-     * Set a single AcroForm text-field value.
+     * Set a single AcroForm field value (text, checkbox, radio, or choice).
      *
-     * Note: pdfluent's high-level `PdfFormMut` requires a
-     * `pdfluent::PdfDocument`. To stay in-place on this handle, we use
-     * the lower-level lopdf walk via the `pdf-forms` engine. For 1.0,
-     * this supports flat top-level field hierarchies (no `/Kids`
-     * recursion) — same constraint as the Rust core.
+     * 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.
      */
     setFormField(path: string, value: string): void;
     /**
-     * Bulk-set multiple AcroForm text fields from a JSON object
+     * Bulk-set multiple AcroForm fields from a JSON object
      * `{"field.path": "value", ...}`.
      */
     setFormFields(fields_json: string): void;
+    /**
+     * Select multiple options on a multi-select list box.
+     *
+     * Delegates to [`pdf_forms::apply_choice_multi`]: writes `/V` as an array
+     * of text strings and rebuilds `/I` (the sorted selected-index cache) to
+     * match what Adobe Acrobat produces. `values` is a JS array of strings;
+     * pass an empty array to clear the selection. The field must be a
+     * multi-select list box (`/Ff` MultiSelect flag); for non-editable list
+     * boxes every value must be one of the field's `/Opt` options.
+     */
+    setMultiSelect(path: string, values: string[]): void;
     /**
      * Apply bold/italic style to a text run on `page_num` (1-based).
      */
     setTextRunStyle(page_num: number, runs_json: string, run_index: number, bold?: boolean | null, italic?: boolean | null): string;
 }
 
+/**
+ * Find-and-replace editor over a PDF document (SDK surface).
+ */
+export class TextEditor {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Find text occurrences. `query_json` is a JSON object:
+     *
+     * ```json
+     * {
+     *   "text": "Acme B.V.",          // required
+     *   "caseInsensitive": false,      // optional
+     *   "pages": [1, 5],               // optional inclusive 1-based range
+     *   "region": {                    // optional
+     *     "page": 1,
+     *     "rect": [x0, y0, x1, y1],
+     *     "relation": "intersects"     // or "contained"
+     *   },
+     *   "limit": 100                   // optional
+     * }
+     * ```
+     *
+     * Returns a JSON array of matches; each match carries an opaque `id`
+     * token valid until the next applied edit on this document.
+     */
+    findText(query_json: string): string;
+    /**
+     * Open a PDF from raw bytes.
+     */
+    static open(data: Uint8Array): TextEditor;
+    /**
+     * Number of pages.
+     */
+    pageCount(): number;
+    /**
+     * Apply per-match replacements located earlier with `findText`.
+     *
+     * `edits_json` is a JSON array of `{"id": "<match token>", "text":
+     * "<replacement>"}`. All edits commit in one atomic transaction under
+     * `options_json` (see [`TextEditor::replace_text`]); the default is
+     * all-or-nothing. Returns the JSON replacement report.
+     */
+    replaceMatches(edits_json: string, options_json: string): string;
+    /**
+     * Find and replace in one call. Returns the JSON replacement report.
+     *
+     * `options_json` may be empty/`"{}"` for defaults, or:
+     *
+     * ```json
+     * {
+     *   "fontFallback": "deny" | "injectStandard" | {"explicit": "F1"},
+     *   "signaturePolicy": "reject" | "allowPostSignatureChange",
+     *   "commitPolicy": "allOrNothing" | "bestEffort"
+     * }
+     * ```
+     */
+    replaceText(query_json: string, replacement: string, options_json: string): string;
+    /**
+     * Serialize the (possibly edited) document to PDF bytes.
+     */
+    save(): Uint8Array;
+}
+
 /**
  * The main XFA processing engine for WASM.
  *
@@ -565,32 +661,14 @@ export class XfaEngine {
     static version(): string;
 }
 
-/**
- * Activate the process-global license from a key string.
- *
- * Throws on invalid key or if the process has already been activated to a
- * different tier this session.
- */
-export function activateLicenseKey(key: string): void;
-
-/**
- * Return the current license status. Always succeeds; defaults to Trial.
- */
-export function licenseStatus(): LicenseStatus;
-
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly __wbg_licensestatus_free: (a: number, b: number) => void;
     readonly __wbg_pdfdoc_free: (a: number, b: number) => void;
     readonly __wbg_pdfdocmut_free: (a: number, b: number) => void;
+    readonly __wbg_texteditor_free: (a: number, b: number) => void;
     readonly __wbg_xfaengine_free: (a: number, b: number) => void;
-    readonly activateLicenseKey: (a: number, b: number, c: number) => void;
-    readonly licenseStatus: () => number;
-    readonly licensestatus_outputIsMarked: (a: number) => number;
-    readonly licensestatus_source: (a: number, b: number) => void;
-    readonly licensestatus_tier: (a: number, b: number) => void;
     readonly pdfdoc_addFreeText: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
     readonly pdfdoc_addHighlight: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
     readonly pdfdoc_addStickyNote: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
@@ -612,6 +690,7 @@ export interface InitOutput {
     readonly pdfdoc_pageWidth: (a: number, b: number) => number;
     readonly pdfdoc_redactRegion: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly pdfdoc_redactSearch: (a: number, b: number, c: number, d: number) => void;
+    readonly pdfdoc_refresh: (a: number, b: number, c: number, d: number) => void;
     readonly pdfdoc_renderPage: (a: number, b: number, c: number, d: number) => void;
     readonly pdfdoc_renderPageToCanvas: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly pdfdoc_renderPageToCanvasVector: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -622,6 +701,9 @@ 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_toDocx: (a: number, b: number) => void;
+    readonly pdfdoc_toPptx: (a: number, b: number) => void;
+    readonly pdfdoc_toXlsx: (a: number, b: number) => void;
     readonly pdfdoc_validatePdfA: (a: number, b: number, c: number, d: number) => void;
     readonly pdfdoc_verifySignatures: (a: number, b: number) => void;
     readonly pdfdocmut_addFreeText: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
@@ -644,7 +726,14 @@ export interface InitOutput {
     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_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 texteditor_findText: (a: number, b: number, c: number, d: number) => void;
+    readonly texteditor_open: (a: number, b: number, c: number) => void;
+    readonly texteditor_pageCount: (a: number) => number;
+    readonly texteditor_replaceMatches: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly texteditor_replaceText: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly texteditor_save: (a: number, b: number) => void;
     readonly xfaengine_exportJson: (a: number, b: number) => void;
     readonly xfaengine_exportSchema: (a: number, b: number) => void;
     readonly xfaengine_fromFields: (a: number, b: number, c: number) => void;