@laminapdf/wasm 0.2.0-alpha.6 → 0.2.0

package/dist/lamina_pdf_text.js

@@ -75,6 +75,30 @@ export class WasmBuilder {
         }
         return WasmDocument.__wrap(ret[0]);
     }
+    /**
+     * Lays `document` out as tagged pages that flow, after any pages already added, filled from
+     * `options.data` first when it is given. The document's profiles are the builder's to set
+     * (`profiles` in its options); its warnings are the finished document's.
+     *
+     * # Errors
+     * `builder-finished`; `unknown-option`, `invalid-argument`; `invalid-document` with the JSON
+     * Pointer at fault and the closest keys in `didYouMean`; `template-data-missing`,
+     * `template-data-type`, `template-too-large`; `unknown-font` and `unknown-image` for a name
+     * `resources` lacks; `missing-glyph`, `flow-content-too-large`.
+     * @param {unknown} document
+     * @param {WasmFlowResources} resources
+     * @param {FlowOptionsInit | undefined} options
+     * @returns {FlowReportJs}
+     */
+    flow(document, resources, options) {
+        _assertClass(resources, WasmFlowResources);
+        let ret;
+        ret = wasm.wasmbuilder_flow(this.__wbg_ptr, document, resources.__wbg_ptr, options);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Loads a font from its bytes (TrueType or OpenType/CFF) and registers it; it is
      * subset to the glyphs drawn.
@@ -287,6 +311,25 @@ export class WasmDocument {
         wasm.__wbg_wasmdocument_free(ptr, 0);
 
     }
+    /**
+     * Makes `bytes`, the whole output of `saveCopy`, the document's saved file (it rebases onto
+     * them), once they are written where the document lives; `historyCleared` is the copy's
+     * report's.
+     *
+     * # Errors
+     * `nested-transaction`, `saved-not-rebased`; `not-rebased` when `bytes` can't be read.
+     * @param {Uint8Array} bytes
+     * @param {boolean} historyCleared
+     */
+    adoptCopy(bytes, historyCleared) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        let ret;
+        ret = wasm.wasmdocument_adoptCopy(this.__wbg_ptr, ptr0, len0, historyCleared);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Applies an op log (`{ "v": 1, "ops": [ … ] }`) as one transaction.
      *
@@ -418,6 +461,22 @@ export class WasmDocument {
         }
         return ret[0] !== 0;
     }
+    /**
+     * The document's metadata, read from Info and XMP together, with the fields where they
+     * disagree.
+     *
+     * # Errors
+     * Reading errors.
+     * @returns {DocumentMetadata}
+     */
+    metadata() {
+        let ret;
+        ret = wasm.wasmdocument_metadata(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * The named destination `name`, or `undefined` when the document has none by that name or
      * it names no page here (the extract and text modules).
@@ -589,6 +648,22 @@ export class WasmDocument {
         }
         return WasmPage.__wrap(ret[0]);
     }
+    /**
+     * How a save with `options` would go, without saving.
+     *
+     * # Errors
+     * `invalid-argument` / `unknown-option` for bad options; reading errors.
+     * @param {SaveOptionsInit | undefined} options
+     * @returns {PlannedSaveJs}
+     */
+    plan(options) {
+        let ret;
+        ret = wasm.wasmdocument_plan(this.__wbg_ptr, options);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * The document's properties (the extract and text modules). Reads every object once.
      *
@@ -636,6 +711,23 @@ export class WasmDocument {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Writes what `save` would and leaves the document as it was: not rebased, its changes
+     * still unsaved, the save-time stamp in the copy only (Save a copy).
+     *
+     * # Errors
+     * As `save`; the document is unchanged either way.
+     * @param {SaveOptionsInit | undefined} options
+     * @returns {{ bytes: Uint8Array<ArrayBuffer>; report: SaveReportJs }}
+     */
+    saveCopy(options) {
+        let ret;
+        ret = wasm.wasmdocument_saveCopy(this.__wbg_ptr, options);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * A save as a job, stepped with a budget of work units (ADR 0028 §3, §4).
      *
@@ -709,6 +801,22 @@ export class WasmDocument {
         ret = wasm.wasmdocument_warnings(this.__wbg_ptr);
         return WasmWarningCursor.__wrap(ret);
     }
+    /**
+     * The signature restrictions `op` would break if it were applied and saved.
+     *
+     * # Errors
+     * `invalid-argument` for a value that isn't an op; reading errors.
+     * @param {Op} op
+     * @returns {ViolationJs[]}
+     */
+    wouldViolate(op) {
+        let ret;
+        ret = wasm.wasmdocument_wouldViolate(this.__wbg_ptr, op);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
 }
 if (Symbol.dispose) WasmDocument.prototype[Symbol.dispose] = WasmDocument.prototype.free;
 
@@ -779,6 +887,57 @@ export class WasmExtractJob {
 }
 if (Symbol.dispose) WasmExtractJob.prototype[Symbol.dispose] = WasmExtractJob.prototype.free;
 
+/**
+ * The fonts and images a document names, by the names it gives them.
+ */
+export class WasmFlowResources {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        WasmFlowResourcesFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_wasmflowresources_free(ptr, 0);
+
+    }
+    /**
+     * `font` for the styles that name `name`; the same name again replaces it.
+     * @param {string} name
+     * @param {WasmFont} font
+     */
+    font(name, font) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        _assertClass(font, WasmFont);
+        wasm.wasmflowresources_font(this.__wbg_ptr, ptr0, len0, font.__wbg_ptr);
+    }
+    /**
+     * `image` for the figures that name `name`; the same name again replaces it.
+     * @param {string} name
+     * @param {WasmImage} image
+     */
+    image(name, image) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        _assertClass(image, WasmImage);
+        wasm.wasmflowresources_image(this.__wbg_ptr, ptr0, len0, image.__wbg_ptr);
+    }
+    /**
+     * No fonts and no images.
+     */
+    constructor() {
+        let ret;
+        ret = wasm.wasmflowresources_new();
+        this.__wbg_ptr = ret;
+        Object.defineProperty(this, '__wbg_inst', { value: __wbg_instance_id, writable: true });
+        WasmFlowResourcesFinalization.register(this, { ptr: ret, instance: __wbg_instance_id }, this);
+        return this;
+    }
+}
+if (Symbol.dispose) WasmFlowResources.prototype[Symbol.dispose] = WasmFlowResources.prototype.free;
+
 /**
  * A font registered with a [`WasmBuilder`].
  */
@@ -1951,6 +2110,11 @@ const WasmExtractJobFinalization = (typeof FinalizationRegistry === 'undefined')
     : new FinalizationRegistry(({ ptr, instance }) => {
     if (instance === __wbg_instance_id) wasm.__wbg_wasmextractjob_free(ptr, 1);
 });
+const WasmFlowResourcesFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(({ ptr, instance }) => {
+    if (instance === __wbg_instance_id) wasm.__wbg_wasmflowresources_free(ptr, 1);
+});
 const WasmFontFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(({ ptr, instance }) => {

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@laminapdf/wasm",
-  "version": "0.2.0-alpha.6",
-  "description": "Lamina PDF's WebAssembly modules and their wasm-bindgen glue: lamina_pdf_base (open, read, edit, save, vector and image pages), lamina_pdf_text (all of base plus fonts and text) and lamina_pdf_extract (all of base plus text extraction); and lamina_pdf_render_hayro, laminapdf-render's hayro adapter, which @laminapdf/render-hayro wraps. Generated into dist/ by `cargo xtask wasm`; @laminapdf/sdk is the API to use.",
+  "version": "0.2.0",
+  "description": "The WebAssembly build of Lamina PDF's Rust core, which @laminapdf/sdk runs on: create, read, edit and save PDFs and extract their text. Use @laminapdf/sdk; this package holds its compiled modules.",
   "license": "MIT OR Apache-2.0",
   "homepage": "https://laminapdf.com",
+  "bugs": {
+    "url": "https://github.com/laudebugs/laminapdf/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/laudebugs/laminapdf.git",
@@ -12,7 +15,10 @@
   "keywords": [
     "pdf",
     "wasm",
-    "webassembly"
+    "webassembly",
+    "pdf-generation",
+    "pdf-editing",
+    "text-extraction"
   ],
   "type": "module",
   "sideEffects": false,