@quillmark/wasm 0.62.0 → 0.63.0

package/README.md

@@ -63,9 +63,22 @@ Render with a pre-parsed `Document`.
 ### `quill.open(parsed)` + `session.render(opts?)`
 Open once, render all or selected pages (`opts.pages`).
 
+### Errors
+
+Every method that can fail throws a JS `Error` with a flat shape:
+
+```ts
+{ message: string, diagnostics: Diagnostic[] }
+```
+
+`diagnostics` is always non-empty — length 1 for most failures, length N for
+backend compilation errors. Read `err.diagnostics[0]` for the primary
+diagnostic; iterate the array for compilation failures.
+
 ## Notes
 
-- Parsed markdown requires top-level `QUILL` in frontmatter.
+- Parsed markdown requires top-level `QUILL` in frontmatter. Empty input
+  surfaces a dedicated "Empty markdown input cannot be parsed" message.
 - QUILL mismatch during `quill.render(parsed)` is a warning (`quill::ref_mismatch`), not an error.
 - Output schema APIs are no longer engine-level in WASM.
 

package/bundler/wasm.d.ts

@@ -133,7 +133,8 @@ export class Document {
      * Remove a frontmatter field on the card at `index`, returning the
      * removed value or `undefined` if the field was absent.
      *
-     * Throws if `index` is out of range.
+     * Throws if `index` is out of range, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
      *
      * Mutators never modify `warnings`.
      */
@@ -141,6 +142,11 @@ export class Document {
     /**
      * Remove a frontmatter field on the main card, returning the removed value or `undefined`.
      *
+     * Throws an `Error` whose message includes the `EditError` variant name
+     * and details if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`)
+     * or does not match `[a-z_][a-z0-9_]*`. Absence of an otherwise-valid
+     * name returns `undefined`.
+     *
      * Mutators never modify `warnings`.
      */
     removeField(name: string): any;
@@ -150,6 +156,20 @@ export class Document {
      * Mutators never modify `warnings`.
      */
     replaceBody(body: string): void;
+    /**
+     * Replace the tag of the composable card at `index`.
+     *
+     * Mutates only the sentinel — the card's frontmatter and body are
+     * untouched. Schema-aware migration (clearing orphan fields, applying
+     * new defaults) is the caller's responsibility; `setCardTag` is a
+     * structural primitive.
+     *
+     * Throws if `index` is out of range or if `newTag` does not match
+     * `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     */
+    setCardTag(index: number, new_tag: string): void;
     /**
      * Update a frontmatter field on the main card.
      *

package/bundler/wasm_bg.js

@@ -193,7 +193,8 @@ export class Document {
      * Remove a frontmatter field on the card at `index`, returning the
      * removed value or `undefined` if the field was absent.
      *
-     * Throws if `index` is out of range.
+     * Throws if `index` is out of range, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
      *
      * Mutators never modify `warnings`.
      * @param {number} index
@@ -220,15 +221,31 @@ export class Document {
     /**
      * Remove a frontmatter field on the main card, returning the removed value or `undefined`.
      *
+     * Throws an `Error` whose message includes the `EditError` variant name
+     * and details if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`)
+     * or does not match `[a-z_][a-z0-9_]*`. Absence of an otherwise-valid
+     * name returns `undefined`.
+     *
      * Mutators never modify `warnings`.
      * @param {string} name
      * @returns {any}
      */
     removeField(name) {
-        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.document_removeField(this.__wbg_ptr, ptr0, len0);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_removeField(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * Replace the main card's body (the global Markdown body).
@@ -241,6 +258,36 @@ export class Document {
         const len0 = WASM_VECTOR_LEN;
         wasm.document_replaceBody(this.__wbg_ptr, ptr0, len0);
     }
+    /**
+     * Replace the tag of the composable card at `index`.
+     *
+     * Mutates only the sentinel — the card's frontmatter and body are
+     * untouched. Schema-aware migration (clearing orphan fields, applying
+     * new defaults) is the caller's responsibility; `setCardTag` is a
+     * structural primitive.
+     *
+     * Throws if `index` is out of range or if `newTag` does not match
+     * `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     * @param {number} index
+     * @param {string} new_tag
+     */
+    setCardTag(index, new_tag) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(new_tag, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_setCardTag(retptr, this.__wbg_ptr, 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);
+        }
+    }
     /**
      * Update a frontmatter field on the main card.
      *

package/bundler/wasm_bg.wasm.d.ts

@@ -15,8 +15,9 @@ export const document_pushCard: (a: number, b: number, c: number) => void;
 export const document_quillRef: (a: number, b: number) => void;
 export const document_removeCard: (a: number, b: number) => number;
 export const document_removeCardField: (a: number, b: number, c: number, d: number, e: number) => void;
-export const document_removeField: (a: number, b: number, c: number) => number;
+export const document_removeField: (a: number, b: number, c: number, d: number) => void;
 export const document_replaceBody: (a: number, b: number, c: number) => void;
+export const document_setCardTag: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setField: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setFill: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setQuillRef: (a: number, b: number, c: number, d: number) => void;

package/node-esm/wasm.d.ts

@@ -133,7 +133,8 @@ export class Document {
      * Remove a frontmatter field on the card at `index`, returning the
      * removed value or `undefined` if the field was absent.
      *
-     * Throws if `index` is out of range.
+     * Throws if `index` is out of range, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
      *
      * Mutators never modify `warnings`.
      */
@@ -141,6 +142,11 @@ export class Document {
     /**
      * Remove a frontmatter field on the main card, returning the removed value or `undefined`.
      *
+     * Throws an `Error` whose message includes the `EditError` variant name
+     * and details if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`)
+     * or does not match `[a-z_][a-z0-9_]*`. Absence of an otherwise-valid
+     * name returns `undefined`.
+     *
      * Mutators never modify `warnings`.
      */
     removeField(name: string): any;
@@ -150,6 +156,20 @@ export class Document {
      * Mutators never modify `warnings`.
      */
     replaceBody(body: string): void;
+    /**
+     * Replace the tag of the composable card at `index`.
+     *
+     * Mutates only the sentinel — the card's frontmatter and body are
+     * untouched. Schema-aware migration (clearing orphan fields, applying
+     * new defaults) is the caller's responsibility; `setCardTag` is a
+     * structural primitive.
+     *
+     * Throws if `index` is out of range or if `newTag` does not match
+     * `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     */
+    setCardTag(index: number, new_tag: string): void;
     /**
      * Update a frontmatter field on the main card.
      *

package/node-esm/wasm.js

@@ -197,7 +197,8 @@ export class Document {
      * Remove a frontmatter field on the card at `index`, returning the
      * removed value or `undefined` if the field was absent.
      *
-     * Throws if `index` is out of range.
+     * Throws if `index` is out of range, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
      *
      * Mutators never modify `warnings`.
      * @param {number} index
@@ -224,15 +225,31 @@ export class Document {
     /**
      * Remove a frontmatter field on the main card, returning the removed value or `undefined`.
      *
+     * Throws an `Error` whose message includes the `EditError` variant name
+     * and details if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`)
+     * or does not match `[a-z_][a-z0-9_]*`. Absence of an otherwise-valid
+     * name returns `undefined`.
+     *
      * Mutators never modify `warnings`.
      * @param {string} name
      * @returns {any}
      */
     removeField(name) {
-        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.document_removeField(this.__wbg_ptr, ptr0, len0);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_removeField(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * Replace the main card's body (the global Markdown body).
@@ -245,6 +262,36 @@ export class Document {
         const len0 = WASM_VECTOR_LEN;
         wasm.document_replaceBody(this.__wbg_ptr, ptr0, len0);
     }
+    /**
+     * Replace the tag of the composable card at `index`.
+     *
+     * Mutates only the sentinel — the card's frontmatter and body are
+     * untouched. Schema-aware migration (clearing orphan fields, applying
+     * new defaults) is the caller's responsibility; `setCardTag` is a
+     * structural primitive.
+     *
+     * Throws if `index` is out of range or if `newTag` does not match
+     * `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     * @param {number} index
+     * @param {string} new_tag
+     */
+    setCardTag(index, new_tag) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(new_tag, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_setCardTag(retptr, this.__wbg_ptr, 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);
+        }
+    }
     /**
      * Update a frontmatter field on the main card.
      *

package/node-esm/wasm_bg.wasm.d.ts

@@ -15,8 +15,9 @@ export const document_pushCard: (a: number, b: number, c: number) => void;
 export const document_quillRef: (a: number, b: number) => void;
 export const document_removeCard: (a: number, b: number) => number;
 export const document_removeCardField: (a: number, b: number, c: number, d: number, e: number) => void;
-export const document_removeField: (a: number, b: number, c: number) => number;
+export const document_removeField: (a: number, b: number, c: number, d: number) => void;
 export const document_replaceBody: (a: number, b: number, c: number) => void;
+export const document_setCardTag: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setField: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setFill: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setQuillRef: (a: number, b: number, c: number, d: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.62.0",
+  "version": "0.63.0",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",