@quillmark/wasm 0.62.0 → 0.64.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.
      *
@@ -240,14 +260,30 @@ export class Quill {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * Open an iterative render session for page-selective rendering.
+     * A blank form for a card of the given type — no document values supplied.
+     *
+     * Returns `null` if `cardType` is not declared in this quill's schema.
+     * Otherwise returns a plain JS object shaped like a single entry in
+     * [`Form::cards`].
+     *
+     * [`Form::cards`]: quillmark::form::Form::cards
      */
-    open(doc: Document): RenderSession;
+    blankCard(card_type: string): any;
+    /**
+     * A blank form for the main card — no document values supplied.
+     *
+     * Returns a plain JS object with the same shape as one entry in
+     * [`Form::main`]. Every declared field's `source` is `"default"` (when
+     * the schema declares a default) or `"missing"`.
+     *
+     * [`Form::main`]: quillmark::form::Form::main
+     */
+    blankMain(): any;
     /**
-     * Project a document through this quill's schema.
+     * The schema-aware form view of `doc`.
      *
      * Returns a plain JS object (not a class) that is immediately
-     * `JSON.stringify`-able. The shape mirrors [`FormProjection`]:
+     * `JSON.stringify`-able. The shape mirrors [`Form`]:
      *
      * ```json
      * {
@@ -258,12 +294,15 @@ export class Quill {
      * ```
      *
      * **Snapshot semantics.** This is a read-only snapshot of the document
-     * at call time. Subsequent edits to `doc` require calling `projectForm`
-     * again.
+     * at call time. Subsequent edits to `doc` require calling `form` again.
      *
-     * [`FormProjection`]: quillmark::form::FormProjection
+     * [`Form`]: quillmark::form::Form
      */
-    projectForm(doc: Document): any;
+    form(doc: Document): any;
+    /**
+     * Open an iterative render session for page-selective rendering.
+     */
+    open(doc: Document): RenderSession;
     /**
      * Render a document to final artifacts.
      */

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.
      *
@@ -448,58 +495,63 @@ export class Quill {
         }
     }
     /**
-     * Read-only snapshot of the loaded quill's engine info and declared schema.
+     * A blank form for a card of the given type — no document values supplied.
      *
-     * Returns a plain JS object with:
-     * - `schema` — the quill's public schema contract, identical to
-     *   `QuillConfig::public_schema()`. Top-level keys: `name`, `main`,
-     *   optional `card_types` (map keyed by card name, omitted when empty),
-     *   optional `example`. `main` and each card under `card_types` share
-     *   the same shape: `fields` (map keyed by field name), optional
-     *   `title`, `description`, `ui`.
-     * - `backend`, `version`, `author` — quill identity declared in
-     *   `Quill.yaml`'s `quill:` section.
-     * - `supportedFormats` — output formats the backend produces, as
-     *   lowercase strings.
-     * - Any additional unstructured keys declared under `quill:`.
-     *
-     * Consumers that need validation run their own validator against
-     * `metadata.schema`.
+     * Returns `null` if `cardType` is not declared in this quill's schema.
+     * Otherwise returns a plain JS object shaped like a single entry in
+     * [`Form::cards`].
      *
-     * Equivalent by value for the lifetime of the handle; the quill is
-     * immutable once constructed.
+     * [`Form::cards`]: quillmark::form::Form::cards
+     * @param {string} card_type
      * @returns {any}
      */
-    get metadata() {
-        const ret = wasm.quill_metadata(this.__wbg_ptr);
-        return takeObject(ret);
+    blankCard(card_type) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(card_type, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.quill_blankCard(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);
+        }
     }
     /**
-     * Open an iterative render session for page-selective rendering.
-     * @param {Document} doc
-     * @returns {RenderSession}
+     * A blank form for the main card — no document values supplied.
+     *
+     * Returns a plain JS object with the same shape as one entry in
+     * [`Form::main`]. Every declared field's `source` is `"default"` (when
+     * the schema declares a default) or `"missing"`.
+     *
+     * [`Form::main`]: quillmark::form::Form::main
+     * @returns {any}
      */
-    open(doc) {
+    blankMain() {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            _assertClass(doc, Document);
-            wasm.quill_open(retptr, this.__wbg_ptr, doc.__wbg_ptr);
+            wasm.quill_blankMain(retptr, this.__wbg_ptr);
             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 RenderSession.__wrap(r0);
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
-     * Project a document through this quill's schema.
+     * The schema-aware form view of `doc`.
      *
      * Returns a plain JS object (not a class) that is immediately
-     * `JSON.stringify`-able. The shape mirrors [`FormProjection`]:
+     * `JSON.stringify`-able. The shape mirrors [`Form`]:
      *
      * ```json
      * {
@@ -510,18 +562,17 @@ export class Quill {
      * ```
      *
      * **Snapshot semantics.** This is a read-only snapshot of the document
-     * at call time. Subsequent edits to `doc` require calling `projectForm`
-     * again.
+     * at call time. Subsequent edits to `doc` require calling `form` again.
      *
-     * [`FormProjection`]: quillmark::form::FormProjection
+     * [`Form`]: quillmark::form::Form
      * @param {Document} doc
      * @returns {any}
      */
-    projectForm(doc) {
+    form(doc) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             _assertClass(doc, Document);
-            wasm.quill_projectForm(retptr, this.__wbg_ptr, doc.__wbg_ptr);
+            wasm.quill_form(retptr, this.__wbg_ptr, doc.__wbg_ptr);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -533,6 +584,54 @@ export class Quill {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Read-only snapshot of the loaded quill's engine info and declared schema.
+     *
+     * Returns a plain JS object with:
+     * - `schema` — the quill's public schema contract, identical to
+     *   `QuillConfig::public_schema()`. Top-level keys: `name`, `main`,
+     *   optional `card_types` (map keyed by card name, omitted when empty),
+     *   optional `example`. `main` and each card under `card_types` share
+     *   the same shape: `fields` (map keyed by field name), optional
+     *   `title`, `description`, `ui`.
+     * - `backend`, `version`, `author` — quill identity declared in
+     *   `Quill.yaml`'s `quill:` section.
+     * - `supportedFormats` — output formats the backend produces, as
+     *   lowercase strings.
+     * - Any additional unstructured keys declared under `quill:`.
+     *
+     * Consumers that need validation run their own validator against
+     * `metadata.schema`.
+     *
+     * Equivalent by value for the lifetime of the handle; the quill is
+     * immutable once constructed.
+     * @returns {any}
+     */
+    get metadata() {
+        const ret = wasm.quill_metadata(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+     * Open an iterative render session for page-selective rendering.
+     * @param {Document} doc
+     * @returns {RenderSession}
+     */
+    open(doc) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(doc, Document);
+            wasm.quill_open(retptr, this.__wbg_ptr, doc.__wbg_ptr);
+            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 RenderSession.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Render a document to final artifacts.
      * @param {Document} doc

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;
@@ -26,9 +27,11 @@ export const document_updateCardField: (a: number, b: number, c: number, d: numb
 export const document_warnings: (a: number) => number;
 export const init: () => void;
 export const quill_backendId: (a: number, b: number) => void;
+export const quill_blankCard: (a: number, b: number, c: number, d: number) => void;
+export const quill_blankMain: (a: number, b: number) => void;
+export const quill_form: (a: number, b: number, c: number) => void;
 export const quill_metadata: (a: number) => number;
 export const quill_open: (a: number, b: number, c: number) => void;
-export const quill_projectForm: (a: number, b: number, c: number) => void;
 export const quill_render: (a: number, b: number, c: number, d: number) => void;
 export const quillmark_new: () => number;
 export const quillmark_quill: (a: number, b: number, c: 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.
      *
@@ -240,14 +260,30 @@ export class Quill {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * Open an iterative render session for page-selective rendering.
+     * A blank form for a card of the given type — no document values supplied.
+     *
+     * Returns `null` if `cardType` is not declared in this quill's schema.
+     * Otherwise returns a plain JS object shaped like a single entry in
+     * [`Form::cards`].
+     *
+     * [`Form::cards`]: quillmark::form::Form::cards
      */
-    open(doc: Document): RenderSession;
+    blankCard(card_type: string): any;
+    /**
+     * A blank form for the main card — no document values supplied.
+     *
+     * Returns a plain JS object with the same shape as one entry in
+     * [`Form::main`]. Every declared field's `source` is `"default"` (when
+     * the schema declares a default) or `"missing"`.
+     *
+     * [`Form::main`]: quillmark::form::Form::main
+     */
+    blankMain(): any;
     /**
-     * Project a document through this quill's schema.
+     * The schema-aware form view of `doc`.
      *
      * Returns a plain JS object (not a class) that is immediately
-     * `JSON.stringify`-able. The shape mirrors [`FormProjection`]:
+     * `JSON.stringify`-able. The shape mirrors [`Form`]:
      *
      * ```json
      * {
@@ -258,12 +294,15 @@ export class Quill {
      * ```
      *
      * **Snapshot semantics.** This is a read-only snapshot of the document
-     * at call time. Subsequent edits to `doc` require calling `projectForm`
-     * again.
+     * at call time. Subsequent edits to `doc` require calling `form` again.
      *
-     * [`FormProjection`]: quillmark::form::FormProjection
+     * [`Form`]: quillmark::form::Form
      */
-    projectForm(doc: Document): any;
+    form(doc: Document): any;
+    /**
+     * Open an iterative render session for page-selective rendering.
+     */
+    open(doc: Document): RenderSession;
     /**
      * Render a document to final artifacts.
      */

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.
      *
@@ -452,58 +499,63 @@ export class Quill {
         }
     }
     /**
-     * Read-only snapshot of the loaded quill's engine info and declared schema.
+     * A blank form for a card of the given type — no document values supplied.
      *
-     * Returns a plain JS object with:
-     * - `schema` — the quill's public schema contract, identical to
-     *   `QuillConfig::public_schema()`. Top-level keys: `name`, `main`,
-     *   optional `card_types` (map keyed by card name, omitted when empty),
-     *   optional `example`. `main` and each card under `card_types` share
-     *   the same shape: `fields` (map keyed by field name), optional
-     *   `title`, `description`, `ui`.
-     * - `backend`, `version`, `author` — quill identity declared in
-     *   `Quill.yaml`'s `quill:` section.
-     * - `supportedFormats` — output formats the backend produces, as
-     *   lowercase strings.
-     * - Any additional unstructured keys declared under `quill:`.
-     *
-     * Consumers that need validation run their own validator against
-     * `metadata.schema`.
+     * Returns `null` if `cardType` is not declared in this quill's schema.
+     * Otherwise returns a plain JS object shaped like a single entry in
+     * [`Form::cards`].
      *
-     * Equivalent by value for the lifetime of the handle; the quill is
-     * immutable once constructed.
+     * [`Form::cards`]: quillmark::form::Form::cards
+     * @param {string} card_type
      * @returns {any}
      */
-    get metadata() {
-        const ret = wasm.quill_metadata(this.__wbg_ptr);
-        return takeObject(ret);
+    blankCard(card_type) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(card_type, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.quill_blankCard(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);
+        }
     }
     /**
-     * Open an iterative render session for page-selective rendering.
-     * @param {Document} doc
-     * @returns {RenderSession}
+     * A blank form for the main card — no document values supplied.
+     *
+     * Returns a plain JS object with the same shape as one entry in
+     * [`Form::main`]. Every declared field's `source` is `"default"` (when
+     * the schema declares a default) or `"missing"`.
+     *
+     * [`Form::main`]: quillmark::form::Form::main
+     * @returns {any}
      */
-    open(doc) {
+    blankMain() {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            _assertClass(doc, Document);
-            wasm.quill_open(retptr, this.__wbg_ptr, doc.__wbg_ptr);
+            wasm.quill_blankMain(retptr, this.__wbg_ptr);
             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 RenderSession.__wrap(r0);
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
-     * Project a document through this quill's schema.
+     * The schema-aware form view of `doc`.
      *
      * Returns a plain JS object (not a class) that is immediately
-     * `JSON.stringify`-able. The shape mirrors [`FormProjection`]:
+     * `JSON.stringify`-able. The shape mirrors [`Form`]:
      *
      * ```json
      * {
@@ -514,18 +566,17 @@ export class Quill {
      * ```
      *
      * **Snapshot semantics.** This is a read-only snapshot of the document
-     * at call time. Subsequent edits to `doc` require calling `projectForm`
-     * again.
+     * at call time. Subsequent edits to `doc` require calling `form` again.
      *
-     * [`FormProjection`]: quillmark::form::FormProjection
+     * [`Form`]: quillmark::form::Form
      * @param {Document} doc
      * @returns {any}
      */
-    projectForm(doc) {
+    form(doc) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             _assertClass(doc, Document);
-            wasm.quill_projectForm(retptr, this.__wbg_ptr, doc.__wbg_ptr);
+            wasm.quill_form(retptr, this.__wbg_ptr, doc.__wbg_ptr);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -537,6 +588,54 @@ export class Quill {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Read-only snapshot of the loaded quill's engine info and declared schema.
+     *
+     * Returns a plain JS object with:
+     * - `schema` — the quill's public schema contract, identical to
+     *   `QuillConfig::public_schema()`. Top-level keys: `name`, `main`,
+     *   optional `card_types` (map keyed by card name, omitted when empty),
+     *   optional `example`. `main` and each card under `card_types` share
+     *   the same shape: `fields` (map keyed by field name), optional
+     *   `title`, `description`, `ui`.
+     * - `backend`, `version`, `author` — quill identity declared in
+     *   `Quill.yaml`'s `quill:` section.
+     * - `supportedFormats` — output formats the backend produces, as
+     *   lowercase strings.
+     * - Any additional unstructured keys declared under `quill:`.
+     *
+     * Consumers that need validation run their own validator against
+     * `metadata.schema`.
+     *
+     * Equivalent by value for the lifetime of the handle; the quill is
+     * immutable once constructed.
+     * @returns {any}
+     */
+    get metadata() {
+        const ret = wasm.quill_metadata(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+     * Open an iterative render session for page-selective rendering.
+     * @param {Document} doc
+     * @returns {RenderSession}
+     */
+    open(doc) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(doc, Document);
+            wasm.quill_open(retptr, this.__wbg_ptr, doc.__wbg_ptr);
+            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 RenderSession.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Render a document to final artifacts.
      * @param {Document} doc

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;
@@ -26,9 +27,11 @@ export const document_updateCardField: (a: number, b: number, c: number, d: numb
 export const document_warnings: (a: number) => number;
 export const init: () => void;
 export const quill_backendId: (a: number, b: number) => void;
+export const quill_blankCard: (a: number, b: number, c: number, d: number) => void;
+export const quill_blankMain: (a: number, b: number) => void;
+export const quill_form: (a: number, b: number, c: number) => void;
 export const quill_metadata: (a: number) => number;
 export const quill_open: (a: number, b: number, c: number) => void;
-export const quill_projectForm: (a: number, b: number, c: number) => void;
 export const quill_render: (a: number, b: number, c: number, d: number) => void;
 export const quillmark_new: () => number;
 export const quillmark_quill: (a: number, b: number, c: number) => void;

package/package.json

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