@quillmark/wasm 0.61.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

@@ -129,9 +129,24 @@ export class Document {
      * Mutators never modify `warnings`.
      */
     removeCard(index: number): Card | undefined;
+    /**
+     * 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, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     */
+    removeCardField(index: number, name: string): any;
     /**
      * 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;
@@ -141,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

@@ -189,18 +189,63 @@ export class Document {
         const ret = wasm.document_removeCard(this.__wbg_ptr, index);
         return takeObject(ret);
     }
+    /**
+     * 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, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     * @param {number} index
+     * @param {string} name
+     * @returns {any}
+     */
+    removeCardField(index, name) {
+        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_removeCardField(retptr, this.__wbg_ptr, index, 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);
+        }
+    }
     /**
      * 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).
@@ -213,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.
      *
@@ -936,11 +1011,16 @@ export function __wbindgen_cast_0000000000000002(arg0) {
     return addHeapObject(ret);
 }
 export function __wbindgen_cast_0000000000000003(arg0, arg1) {
+    // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8Array")`.
+    const ret = getArrayU8FromWasm0(arg0, arg1);
+    return addHeapObject(ret);
+}
+export function __wbindgen_cast_0000000000000004(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);
     return addHeapObject(ret);
 }
-export function __wbindgen_cast_0000000000000004(arg0) {
+export function __wbindgen_cast_0000000000000005(arg0) {
     // Cast intrinsic for `U64 -> Externref`.
     const ret = BigInt.asUintN(64, arg0);
     return addHeapObject(ret);

package/bundler/wasm_bg.wasm.d.ts

@@ -14,8 +14,10 @@ export const document_moveCard: (a: number, b: number, c: number, d: number) =>
 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_removeField: (a: number, b: number, c: 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, 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

@@ -129,9 +129,24 @@ export class Document {
      * Mutators never modify `warnings`.
      */
     removeCard(index: number): Card | undefined;
+    /**
+     * 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, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     */
+    removeCardField(index: number, name: string): any;
     /**
      * 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;
@@ -141,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

@@ -193,18 +193,63 @@ export class Document {
         const ret = wasm.document_removeCard(this.__wbg_ptr, index);
         return takeObject(ret);
     }
+    /**
+     * 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, `name` is reserved, or `name` does
+     * not match `[a-z_][a-z0-9_]*`.
+     *
+     * Mutators never modify `warnings`.
+     * @param {number} index
+     * @param {string} name
+     * @returns {any}
+     */
+    removeCardField(index, name) {
+        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_removeCardField(retptr, this.__wbg_ptr, index, 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);
+        }
+    }
     /**
      * 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).
@@ -217,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.
      *
@@ -943,11 +1018,16 @@ function __wbg_get_imports() {
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8Array")`.
+            const ret = getArrayU8FromWasm0(arg0, arg1);
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000004: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return addHeapObject(ret);
         },
-        __wbindgen_cast_0000000000000004: function(arg0) {
+        __wbindgen_cast_0000000000000005: function(arg0) {
             // Cast intrinsic for `U64 -> Externref`.
             const ret = BigInt.asUintN(64, arg0);
             return addHeapObject(ret);

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

@@ -14,8 +14,10 @@ export const document_moveCard: (a: number, b: number, c: number, d: number) =>
 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_removeField: (a: number, b: number, c: 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, 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.61.0",
+  "version": "0.63.0",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",