@quillmark/wasm 0.78.0 → 0.79.0

package/README.md

@@ -69,19 +69,19 @@ semantic equality.
 
 ### `doc.equals(other)`
 Structural equality between two `Document` handles. Compares `main` and
-`leaves` by value; parse-time `warnings` are intentionally excluded.
+`cards` by value; parse-time `warnings` are intentionally excluded.
 
 Use this to debounce upstream prop updates: keep the last parsed `Document`
 and compare instead of re-parsing on every keystroke.
 
-### `doc.leafCount`
-O(1) getter for the number of composable leaves (excluding the main leaf).
-Use this to validate indices before calling leaf mutators (`removeLeaf`,
-`updateLeafField`, etc.) without allocating the full `leaves` array.
+### `doc.cardCount`
+O(1) getter for the number of composable cards (excluding the main card).
+Use this to validate indices before calling card mutators (`removeCard`,
+`updateCardField`, etc.) without allocating the full `cards` array.
 
 ### `quill.form(doc)`
 
-Returns `{ main, leaves, diagnostics }` — a schema-aware snapshot of `doc`
+Returns `{ main, cards, diagnostics }` — a schema-aware snapshot of `doc`
 without invoking the backend. `diagnostics` contains validation errors and
 warnings; an empty array means the document is valid. Useful for validating
 content without rendering:
@@ -181,7 +181,7 @@ compilation failures. The same shape applies to every throw site:
 
 - `Document.fromMarkdown` — parse errors (missing `QUILL`, YAML errors,
   `parse::input_too_large` for inputs > 10 MB).
-- `Document` mutators (`setField`, `updateLeafField`, etc.) — `EditError`
+- `Document` mutators (`setField`, `updateCardField`, etc.) — `EditError`
   variants (`ReservedName`, `InvalidFieldName`, `InvalidTagName`,
   `IndexOutOfRange`) appear in `diagnostics[0].message` with the
   `[EditError::<Variant>]` prefix.

package/bundler/wasm.d.ts

@@ -2,11 +2,11 @@
 /* eslint-disable */
 
 /**
- * Input shape for `Document.pushLeaf` and `Document.insertLeaf`.
+ * Input shape for `Document.pushCard` and `Document.insertCard`.
  *
  * Only `tag` is required. `fields` defaults to `{}`, `body` to `""`.
  */
-export interface LeafInput {
+export interface CardInput {
     tag: string;
     fields?: Record<string, unknown>;
     body?: string;
@@ -93,16 +93,16 @@ export interface QuillFieldUi {
     multiline?: boolean;
 }
 
-/** UI layout hints for a leaf (main or named leaf type). */
-export interface QuillLeafUi {
+/** UI layout hints for a card (main or named card type). */
+export interface QuillCardUi {
     title?: string;
 }
 
-/** Body namespace for a leaf (main or named leaf type). */
-export interface QuillLeafBody {
-    /** When false, consumers must not accept or store body content for this leaf type. Defaults to true. */
+/** Body namespace for a card (main or named card type). */
+export interface QuillCardBody {
+    /** When false, consumers must not accept or store body content for this card type. Defaults to true. */
     enabled?: boolean;
-    /** Example body content embedded verbatim in the blueprint body region. Fallback is "Write <leaf> body here." */
+    /** Example body content embedded verbatim in the blueprint body region. Fallback is "Write <card> body here." */
     example?: string;
 }
 
@@ -119,29 +119,29 @@ export interface QuillFieldSchema {
     items?: QuillFieldSchema;
 }
 
-/** Schema entry for the main leaf or a named leaf type. */
-export interface QuillLeafSchema {
+/** Schema entry for the main card or a named card type. */
+export interface QuillCardSchema {
     description?: string;
     fields: Record<string, QuillFieldSchema>;
-    ui?: QuillLeafUi;
-    body?: QuillLeafBody;
+    ui?: QuillCardUi;
+    body?: QuillCardBody;
 }
 
 /**
  * Document schema returned by `Quill.schema`. Includes optional `ui` keys.
  *
- * `main.fields.QUILL` and `leaf_kinds[name].fields.KIND` are required
+ * `main.fields.QUILL` and `card_types[name].fields.CARD` are required
  * sentinels with `const` values telling consumers what to write.
  */
 export interface QuillSchema {
-    main: QuillLeafSchema;
-    /** Present only when the quill declares at least one named leaf type. */
-    leaf_kinds?: Record<string, QuillLeafSchema>;
+    main: QuillCardSchema;
+    /** Present only when the quill declares at least one named card type. */
+    card_types?: Record<string, QuillCardSchema>;
 }
 
 /**
  * Identity snapshot mirroring the `quill:` section of `Quill.yaml`.
- * The schema lives on `Quill.schema`; the example on `Quill.example`.
+ * The schema lives on `Quill.schema`.
  * Extra `quill:` keys appear as `unknown`.
  */
 export interface QuillMetadata {
@@ -158,7 +158,7 @@ export interface QuillMetadata {
 export type FormFieldSource = "document" | "default" | "missing";
 
 /**
- * A single field's view within a `FormLeaf`.
+ * A single field's view within a `FormCard`.
  *
  * - `value` — the document-supplied value (`null` when absent).
  * - `default` — the schema default (`null` when no default is declared).
@@ -171,24 +171,24 @@ export interface FormFieldValue {
 }
 
 /**
- * A leaf viewed through its schema, as returned by `Quill.form`,
- * `Quill.blankMain`, and `Quill.blankLeaf`.
+ * A card viewed through its schema, as returned by `Quill.form`,
+ * `Quill.blankMain`, and `Quill.blankCard`.
  */
-export interface FormLeaf {
-    schema: QuillLeafSchema;
+export interface FormCard {
+    schema: QuillCardSchema;
     values: Record<string, FormFieldValue>;
 }
 
 /**
  * Schema-aware form view of a document, returned by `Quill.form`.
  *
- * - `main` — the main leaf viewed through the quill's main schema.
- * - `leaves` — composable leaf blocks, in document order (unknown tags excluded).
- * - `diagnostics` — diagnostics from unknown leaf tags and validation.
+ * - `main` — the main card viewed through the quill's main schema.
+ * - `cards` — composable card blocks, in document order (unknown tags excluded).
+ * - `diagnostics` — diagnostics from unknown card tags and validation.
  */
 export interface Form {
-    main: FormLeaf;
-    leaves: FormLeaf[];
+    main: FormCard;
+    cards: FormCard[];
     diagnostics: Diagnostic[];
 }
 
@@ -199,6 +199,14 @@ export interface Artifact {
     mimeType: string;
 }
 
+export interface Card {
+    sentinel: string;
+    tag: string;
+    frontmatter: Record<string, unknown>;
+    frontmatterItems: FrontmatterItem[];
+    body: string;
+}
+
 export interface Diagnostic {
     severity: Severity;
     code?: string;
@@ -209,14 +217,6 @@ export interface Diagnostic {
     sourceChain: string[];
 }
 
-export interface Leaf {
-    sentinel: string;
-    tag: string;
-    frontmatter: Record<string, unknown>;
-    frontmatterItems: FrontmatterItem[];
-    body: string;
-}
-
 export interface Location {
     file: string;
     line: number;
@@ -250,7 +250,7 @@ export type Severity = "error" | "warning" | "note";
  * - `quillRef` (string)
  * - `frontmatter` (JS object/Record)
  * - `body` (string)
- * - `leaves` (array of Leaf objects)
+ * - `cards` (array of Card objects)
  * - `warnings` (array of Diagnostic objects)
  *
  * `toMarkdown()` emits canonical Quillmark Markdown that round-trips back to
@@ -272,7 +272,7 @@ export class Document {
     /**
      * Structural equality against another `Document`.
      *
-     * Compares `main` and `leaves` by value (matching core's [`PartialEq`]).
+     * Compares `main` and `cards` by value (matching core's [`PartialEq`]).
      * Parse-time `warnings` are intentionally excluded — they describe the
      * source text, not the document's content.
      *
@@ -288,38 +288,54 @@ export class Document {
      */
     static fromMarkdown(markdown: string): Document;
     /**
-     * Insert a leaf at the given index.
+     * Insert a card at the given index.
      *
-     * `index` must be in `0..=leaves.length`. Out-of-range throws an `Error`.
+     * `index` must be in `0..=cards.length`. Out-of-range throws an `Error`.
      *
      * Mutators never modify `warnings`.
      */
-    insertLeaf(index: number, leaf: LeafInput): void;
+    insertCard(index: number, card: CardInput): void;
     /**
-     * Move the leaf at `from` to position `to`.
+     * Move the card at `from` to position `to`.
      *
-     * `from == to` is a no-op. Both indices must be in `0..leaves.length`.
+     * `from == to` is a no-op. Both indices must be in `0..cards.length`.
      * Out-of-range throws an `Error`.
      *
      * Mutators never modify `warnings`.
      */
-    moveLeaf(from: number, to: number): void;
+    moveCard(from: number, to: number): void;
     /**
-     * Append a leaf to the end of the leaf list.
+     * Append a card to the end of the card list.
      *
-     * `leaf` must be a JS object with a `tag` string field and optional
+     * `card` must be a JS object with a `tag` string field and optional
      * `fields` (object) and `body` (string).
      *
-     * Throws an `Error` if `leaf.tag` is not a valid tag name.
+     * Throws an `Error` if `card.tag` is not a valid tag name.
+     *
+     * Mutators never modify `warnings`.
+     */
+    pushCard(card: CardInput): void;
+    /**
+     * Remove the card at `index` and return it, or `undefined` if out of range.
+     *
+     * 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`.
      */
-    pushLeaf(leaf: LeafInput): void;
+    removeCardField(index: number, name: string): any;
     /**
-     * Remove a frontmatter field on the main leaf, returning the removed value or `undefined`.
+     * 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`, `LEAVES`, `QUILL`, `KIND`)
+     * 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`.
      *
@@ -327,42 +343,40 @@ export class Document {
      */
     removeField(name: string): any;
     /**
-     * Remove the leaf at `index` and return it, or `undefined` if out of range.
+     * Replace the main card's body (the global Markdown body).
      *
      * Mutators never modify `warnings`.
      */
-    removeLeaf(index: number): Leaf | undefined;
+    replaceBody(body: string): void;
     /**
-     * Remove a frontmatter field on the leaf at `index`, returning the
-     * removed value or `undefined` if the field was absent.
+     * Replace the tag of the composable card at `index`.
      *
-     * Throws if `index` is out of range, `name` is reserved, or `name` does
-     * not match `[a-z_][a-z0-9_]*`.
+     * 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.
      *
-     * Mutators never modify `warnings`.
-     */
-    removeLeafField(index: number, name: string): any;
-    /**
-     * Replace the main leaf's body (the global Markdown body).
+     * Throws if `index` is out of range or if `newTag` does not match
+     * `[a-z_][a-z0-9_]*`.
      *
      * Mutators never modify `warnings`.
      */
-    replaceBody(body: string): void;
+    setCardTag(index: number, new_tag: string): void;
     /**
-     * Update a frontmatter field on the main leaf.
+     * Update a frontmatter field on the main card.
      *
      * Convenience method: equivalent to `doc.mainMut().setField(name, value)`.
      * Clears any existing `!fill` marker on the field.
      *
      * Throws an `Error` whose message includes the `EditError` variant name and
-     * details if `name` is reserved (`BODY`, `LEAVES`, `QUILL`, `KIND`) or does
+     * details if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`) or does
      * not match `[a-z_][a-z0-9_]*`.
      *
      * Mutators never modify `warnings`.
      */
     setField(name: string, value: any): void;
     /**
-     * Update a frontmatter field on the main leaf AND mark it as `!fill`.
+     * Update a frontmatter field on the main card AND mark it as `!fill`.
      *
      * Convenience method: equivalent to `doc.mainMut().setFill(name, value)`.
      *
@@ -371,20 +385,6 @@ export class Document {
      * Mutators never modify `warnings`.
      */
     setFill(name: string, value: any): void;
-    /**
-     * Replace the tag of the composable leaf at `index`.
-     *
-     * Mutates only the sentinel — the leaf's frontmatter and body are
-     * untouched. Schema-aware migration (clearing orphan fields, applying
-     * new defaults) is the caller's responsibility; `setLeafKind` 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`.
-     */
-    setLeafKind(index: number, new_tag: string): void;
     /**
      * Replace the QUILL reference string.
      *
@@ -402,37 +402,37 @@ export class Document {
      */
     toMarkdown(): string;
     /**
-     * Replace the body of the leaf at `index`.
+     * Replace the body of the card at `index`.
      *
      * Throws if `index` is out of range.
      *
      * Mutators never modify `warnings`.
      */
-    updateLeafBody(index: number, body: string): void;
+    updateCardBody(index: number, body: string): void;
     /**
-     * Update a field on the leaf at `index`.
+     * Update a field on the card at `index`.
      *
-     * Convenience method: equivalent to `doc.leaf_mut(index)?.set_field(name, value)`.
+     * Convenience method: equivalent to `doc.card_mut(index)?.set_field(name, value)`.
      *
      * Throws if `index` is out of range, `name` is reserved or invalid, or
      * `value` cannot be serialized.
      *
      * Mutators never modify `warnings`.
      */
-    updateLeafField(index: number, name: string, value: any): void;
+    updateCardField(index: number, name: string, value: any): void;
     /**
-     * Number of composable leaves (excludes the main leaf).
+     * Number of composable cards (excludes the main card).
      *
-     * O(1). Use this to validate indices before calling leaf mutators
-     * instead of allocating the full `leaves` array.
+     * O(1). Use this to validate indices before calling card mutators
+     * instead of allocating the full `cards` array.
      */
-    readonly leafCount: number;
+    readonly cardCount: number;
     /**
-     * Ordered list of composable leaf blocks as typed `Leaf` objects.
+     * Ordered list of composable card blocks as typed `Card` objects.
      */
-    readonly leaves: Leaf[];
+    readonly cards: Card[];
     /**
-     * The document's main (entry) leaf.
+     * The document's main (entry) card.
      *
      * Carries the QUILL sentinel, the document-level frontmatter, and the
      * global body. Frontmatter/body reads and mutations go through this
@@ -440,7 +440,7 @@ export class Document {
      *
      * Allocates and serializes on each call — cache locally if read in a hot loop.
      */
-    readonly main: Leaf;
+    readonly main: Card;
     /**
      * The QUILL reference string (e.g. `"usaf_memo@0.1"`).
      */
@@ -459,17 +459,17 @@ export class Quill {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * A blank form for a leaf of the given type — no document values supplied.
+     * A blank form for a card of the given type — no document values supplied.
      *
-     * Returns `null` if `leafKind` is not declared in this quill's 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::leaves`].
+     * [`Form::cards`].
      *
-     * [`Form::leaves`]: quillmark::form::Form::leaves
+     * [`Form::cards`]: quillmark::form::Form::cards
      */
-    blankLeaf(leaf_kind: string): FormLeaf | null;
+    blankCard(card_type: string): FormCard | null;
     /**
-     * A blank form for the main leaf — no document values supplied.
+     * 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
@@ -477,7 +477,7 @@ export class Quill {
      *
      * [`Form::main`]: quillmark::form::Form::main
      */
-    blankMain(): FormLeaf;
+    blankMain(): FormCard;
     /**
      * The schema-aware form view of `doc`.
      *
@@ -487,7 +487,7 @@ export class Quill {
      * ```json
      * {
      *   "main":  { "schema": {...}, "values": { "field": {...} } },
-     *   "leaves": [ ... ],
+     *   "cards": [ ... ],
      *   "diagnostics": [ ... ]
      * }
      * ```
@@ -514,10 +514,6 @@ export class Quill {
      * Auto-generated annotated Markdown blueprint for LLM consumers.
      */
     readonly blueprint: string;
-    /**
-     * Bundled example document, or `undefined` if none was declared.
-     */
-    readonly example: string | undefined;
     /**
      * Identity snapshot of the `quill:` section of `Quill.yaml`, plus
      * `supportedFormats` and any custom `quill:` keys.

package/bundler/wasm_bg.js

@@ -5,7 +5,7 @@
  * - `quillRef` (string)
  * - `frontmatter` (JS object/Record)
  * - `body` (string)
- * - `leaves` (array of Leaf objects)
+ * - `cards` (array of Card objects)
  * - `warnings` (array of Diagnostic objects)
  *
  * `toMarkdown()` emits canonical Quillmark Markdown that round-trips back to
@@ -29,6 +29,25 @@ export class Document {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_document_free(ptr, 0);
     }
+    /**
+     * Number of composable cards (excludes the main card).
+     *
+     * O(1). Use this to validate indices before calling card mutators
+     * instead of allocating the full `cards` array.
+     * @returns {number}
+     */
+    get cardCount() {
+        const ret = wasm.document_cardCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * Ordered list of composable card blocks as typed `Card` objects.
+     * @returns {Card[]}
+     */
+    get cards() {
+        const ret = wasm.document_cards(this.__wbg_ptr);
+        return takeObject(ret);
+    }
     /**
      * Return a fresh `Document` handle with the same parse state.
      *
@@ -45,7 +64,7 @@ export class Document {
     /**
      * Structural equality against another `Document`.
      *
-     * Compares `main` and `leaves` by value (matching core's [`PartialEq`]).
+     * Compares `main` and `cards` by value (matching core's [`PartialEq`]).
      * Parse-time `warnings` are intentionally excluded — they describe the
      * source text, not the document's content.
      *
@@ -85,18 +104,18 @@ export class Document {
         }
     }
     /**
-     * Insert a leaf at the given index.
+     * Insert a card at the given index.
      *
-     * `index` must be in `0..=leaves.length`. Out-of-range throws an `Error`.
+     * `index` must be in `0..=cards.length`. Out-of-range throws an `Error`.
      *
      * Mutators never modify `warnings`.
      * @param {number} index
-     * @param {LeafInput} leaf
+     * @param {CardInput} card
      */
-    insertLeaf(index, leaf) {
+    insertCard(index, card) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_insertLeaf(retptr, this.__wbg_ptr, index, addHeapObject(leaf));
+            wasm.document_insertCard(retptr, this.__wbg_ptr, index, addHeapObject(card));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -107,52 +126,33 @@ export class Document {
         }
     }
     /**
-     * Number of composable leaves (excludes the main leaf).
-     *
-     * O(1). Use this to validate indices before calling leaf mutators
-     * instead of allocating the full `leaves` array.
-     * @returns {number}
-     */
-    get leafCount() {
-        const ret = wasm.document_leafCount(this.__wbg_ptr);
-        return ret >>> 0;
-    }
-    /**
-     * Ordered list of composable leaf blocks as typed `Leaf` objects.
-     * @returns {Leaf[]}
-     */
-    get leaves() {
-        const ret = wasm.document_leaves(this.__wbg_ptr);
-        return takeObject(ret);
-    }
-    /**
-     * The document's main (entry) leaf.
+     * The document's main (entry) card.
      *
      * Carries the QUILL sentinel, the document-level frontmatter, and the
      * global body. Frontmatter/body reads and mutations go through this
      * handle — there are no document-level shortcuts after the rework.
      *
      * Allocates and serializes on each call — cache locally if read in a hot loop.
-     * @returns {Leaf}
+     * @returns {Card}
      */
     get main() {
         const ret = wasm.document_main(this.__wbg_ptr);
         return takeObject(ret);
     }
     /**
-     * Move the leaf at `from` to position `to`.
+     * Move the card at `from` to position `to`.
      *
-     * `from == to` is a no-op. Both indices must be in `0..leaves.length`.
+     * `from == to` is a no-op. Both indices must be in `0..cards.length`.
      * Out-of-range throws an `Error`.
      *
      * Mutators never modify `warnings`.
      * @param {number} from
      * @param {number} to
      */
-    moveLeaf(from, to) {
+    moveCard(from, to) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_moveLeaf(retptr, this.__wbg_ptr, from, to);
+            wasm.document_moveCard(retptr, this.__wbg_ptr, from, to);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -163,20 +163,20 @@ export class Document {
         }
     }
     /**
-     * Append a leaf to the end of the leaf list.
+     * Append a card to the end of the card list.
      *
-     * `leaf` must be a JS object with a `tag` string field and optional
+     * `card` must be a JS object with a `tag` string field and optional
      * `fields` (object) and `body` (string).
      *
-     * Throws an `Error` if `leaf.tag` is not a valid tag name.
+     * Throws an `Error` if `card.tag` is not a valid tag name.
      *
      * Mutators never modify `warnings`.
-     * @param {LeafInput} leaf
+     * @param {CardInput} card
      */
-    pushLeaf(leaf) {
+    pushCard(card) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_pushLeaf(retptr, this.__wbg_ptr, addHeapObject(leaf));
+            wasm.document_pushCard(retptr, this.__wbg_ptr, addHeapObject(card));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -207,23 +207,34 @@ export class Document {
         }
     }
     /**
-     * Remove a frontmatter field on the main leaf, returning the removed value or `undefined`.
+     * Remove the card at `index` and return it, or `undefined` if out of range.
      *
-     * Throws an `Error` whose message includes the `EditError` variant name
-     * and details if `name` is reserved (`BODY`, `LEAVES`, `QUILL`, `KIND`)
-     * or does not match `[a-z_][a-z0-9_]*`. Absence of an otherwise-valid
-     * name returns `undefined`.
+     * Mutators never modify `warnings`.
+     * @param {number} index
+     * @returns {Card | undefined}
+     */
+    removeCard(index) {
+        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}
      */
-    removeField(name) {
+    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_removeField(retptr, this.__wbg_ptr, ptr0, len0);
+            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);
@@ -236,34 +247,23 @@ export class Document {
         }
     }
     /**
-     * Remove the leaf at `index` and return it, or `undefined` if out of range.
-     *
-     * Mutators never modify `warnings`.
-     * @param {number} index
-     * @returns {Leaf | undefined}
-     */
-    removeLeaf(index) {
-        const ret = wasm.document_removeLeaf(this.__wbg_ptr, index);
-        return takeObject(ret);
-    }
-    /**
-     * Remove a frontmatter field on the leaf at `index`, returning the
-     * removed value or `undefined` if the field was absent.
+     * Remove a frontmatter field on the main card, returning the removed value or `undefined`.
      *
-     * Throws if `index` is out of range, `name` is reserved, or `name` does
-     * not match `[a-z_][a-z0-9_]*`.
+     * 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 {number} index
      * @param {string} name
      * @returns {any}
      */
-    removeLeafField(index, name) {
+    removeField(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_removeLeafField(retptr, this.__wbg_ptr, index, ptr0, len0);
+            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);
@@ -276,7 +276,7 @@ export class Document {
         }
     }
     /**
-     * Replace the main leaf's body (the global Markdown body).
+     * Replace the main card's body (the global Markdown body).
      *
      * Mutators never modify `warnings`.
      * @param {string} body
@@ -287,25 +287,26 @@ export class Document {
         wasm.document_replaceBody(this.__wbg_ptr, ptr0, len0);
     }
     /**
-     * Update a frontmatter field on the main leaf.
+     * Replace the tag of the composable card at `index`.
      *
-     * Convenience method: equivalent to `doc.mainMut().setField(name, value)`.
-     * Clears any existing `!fill` marker on the field.
+     * 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 an `Error` whose message includes the `EditError` variant name and
-     * details if `name` is reserved (`BODY`, `LEAVES`, `QUILL`, `KIND`) or does
-     * not match `[a-z_][a-z0-9_]*`.
+     * Throws if `index` is out of range or if `newTag` does not match
+     * `[a-z_][a-z0-9_]*`.
      *
      * Mutators never modify `warnings`.
-     * @param {string} name
-     * @param {any} value
+     * @param {number} index
+     * @param {string} new_tag
      */
-    setField(name, value) {
+    setCardTag(index, new_tag) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(new_tag, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_setField(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(value));
+            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) {
@@ -316,22 +317,25 @@ export class Document {
         }
     }
     /**
-     * Update a frontmatter field on the main leaf AND mark it as `!fill`.
+     * Update a frontmatter field on the main card.
      *
-     * Convenience method: equivalent to `doc.mainMut().setFill(name, value)`.
+     * Convenience method: equivalent to `doc.mainMut().setField(name, value)`.
+     * Clears any existing `!fill` marker on the field.
      *
-     * Throws on invalid name (see [`setField`](Document::set_field)).
+     * 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_]*`.
      *
      * Mutators never modify `warnings`.
      * @param {string} name
      * @param {any} value
      */
-    setFill(name, value) {
+    setField(name, value) {
         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_setFill(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(value));
+            wasm.document_setField(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(value));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -342,26 +346,22 @@ export class Document {
         }
     }
     /**
-     * Replace the tag of the composable leaf at `index`.
+     * Update a frontmatter field on the main card AND mark it as `!fill`.
      *
-     * Mutates only the sentinel — the leaf's frontmatter and body are
-     * untouched. Schema-aware migration (clearing orphan fields, applying
-     * new defaults) is the caller's responsibility; `setLeafKind` is a
-     * structural primitive.
+     * Convenience method: equivalent to `doc.mainMut().setFill(name, value)`.
      *
-     * Throws if `index` is out of range or if `newTag` does not match
-     * `[a-z_][a-z0-9_]*`.
+     * Throws on invalid name (see [`setField`](Document::set_field)).
      *
      * Mutators never modify `warnings`.
-     * @param {number} index
-     * @param {string} new_tag
+     * @param {string} name
+     * @param {any} value
      */
-    setLeafKind(index, new_tag) {
+    setFill(name, value) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(new_tag, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_setLeafKind(retptr, this.__wbg_ptr, index, ptr0, len0);
+            wasm.document_setFill(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(value));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -419,7 +419,7 @@ export class Document {
         }
     }
     /**
-     * Replace the body of the leaf at `index`.
+     * Replace the body of the card at `index`.
      *
      * Throws if `index` is out of range.
      *
@@ -427,12 +427,12 @@ export class Document {
      * @param {number} index
      * @param {string} body
      */
-    updateLeafBody(index, body) {
+    updateCardBody(index, body) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             const ptr0 = passStringToWasm0(body, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_updateLeafBody(retptr, this.__wbg_ptr, index, ptr0, len0);
+            wasm.document_updateCardBody(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) {
@@ -443,9 +443,9 @@ export class Document {
         }
     }
     /**
-     * Update a field on the leaf at `index`.
+     * Update a field on the card at `index`.
      *
-     * Convenience method: equivalent to `doc.leaf_mut(index)?.set_field(name, value)`.
+     * Convenience method: equivalent to `doc.card_mut(index)?.set_field(name, value)`.
      *
      * Throws if `index` is out of range, `name` is reserved or invalid, or
      * `value` cannot be serialized.
@@ -455,12 +455,12 @@ export class Document {
      * @param {string} name
      * @param {any} value
      */
-    updateLeafField(index, name, value) {
+    updateCardField(index, name, value) {
         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_updateLeafField(retptr, this.__wbg_ptr, index, ptr0, len0, addHeapObject(value));
+            wasm.document_updateCardField(retptr, this.__wbg_ptr, index, ptr0, len0, addHeapObject(value));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -523,22 +523,22 @@ export class Quill {
         }
     }
     /**
-     * A blank form for a leaf of the given type — no document values supplied.
+     * A blank form for a card of the given type — no document values supplied.
      *
-     * Returns `null` if `leafKind` is not declared in this quill's 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::leaves`].
+     * [`Form::cards`].
      *
-     * [`Form::leaves`]: quillmark::form::Form::leaves
-     * @param {string} leaf_kind
-     * @returns {FormLeaf | null}
+     * [`Form::cards`]: quillmark::form::Form::cards
+     * @param {string} card_type
+     * @returns {FormCard | null}
      */
-    blankLeaf(leaf_kind) {
+    blankCard(card_type) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(leaf_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(card_type, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.quill_blankLeaf(retptr, this.__wbg_ptr, ptr0, len0);
+            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);
@@ -551,14 +551,14 @@ export class Quill {
         }
     }
     /**
-     * A blank form for the main leaf — no document values supplied.
+     * 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 {FormLeaf}
+     * @returns {FormCard}
      */
     blankMain() {
         try {
@@ -595,26 +595,6 @@ export class Quill {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
-    /**
-     * Bundled example document, or `undefined` if none was declared.
-     * @returns {string | undefined}
-     */
-    get example() {
-        try {
-            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.quill_example(retptr, this.__wbg_ptr);
-            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            let v1;
-            if (r0 !== 0) {
-                v1 = getStringFromWasm0(r0, r1).slice();
-                wasm.__wbindgen_export4(r0, r1 * 1, 1);
-            }
-            return v1;
-        } finally {
-            wasm.__wbindgen_add_to_stack_pointer(16);
-        }
-    }
     /**
      * The schema-aware form view of `doc`.
      *
@@ -624,7 +604,7 @@ export class Quill {
      * ```json
      * {
      *   "main":  { "schema": {...}, "values": { "field": {...} } },
-     *   "leaves": [ ... ],
+     *   "cards": [ ... ],
      *   "diagnostics": [ ... ]
      * }
      * ```

package/bundler/wasm_bg.wasm.d.ts

@@ -1,66 +1,65 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const __wbg_quillmark_free: (a: number, b: number) => void;
+export const __wbg_document_free: (a: number, b: number) => void;
 export const __wbg_quill_free: (a: number, b: number) => void;
+export const __wbg_quillmark_free: (a: number, b: number) => void;
 export const __wbg_rendersession_free: (a: number, b: number) => void;
-export const __wbg_document_free: (a: number, b: number) => void;
-export const quillmark_new: () => number;
-export const quillmark_quill: (a: number, b: number, c: number) => void;
-export const quill_render: (a: number, b: number, c: number, d: number) => void;
-export const quill_open: (a: number, b: number, c: number) => void;
-export const quill_backendId: (a: number, b: number) => void;
-export const quill_supportsCanvas: (a: number) => number;
-export const quill_example: (a: number, b: number) => void;
-export const quill_blueprint: (a: number, b: number) => void;
-export const quill_schema: (a: number) => number;
-export const quill_metadata: (a: number) => number;
-export const quill_form: (a: number, b: number, c: number) => void;
-export const quill_blankMain: (a: number, b: number) => void;
-export const quill_blankLeaf: (a: number, b: number, c: number, d: number) => void;
-export const document_fromMarkdown: (a: number, b: number, c: number) => void;
-export const document_toMarkdown: (a: number, b: number) => void;
+export const document_cardCount: (a: number) => number;
+export const document_cards: (a: number) => number;
 export const document_clone: (a: number) => number;
-export const document_quillRef: (a: number, b: number) => void;
-export const document_main: (a: number) => number;
-export const document_leaves: (a: number) => number;
-export const document_leafCount: (a: number) => number;
 export const document_equals: (a: number, b: number) => number;
-export const document_warnings: (a: number) => number;
+export const document_fromMarkdown: (a: number, b: number, c: number) => void;
+export const document_insertCard: (a: number, b: number, c: number, d: number) => void;
+export const document_main: (a: number) => number;
+export const document_moveCard: (a: number, b: number, c: number, d: number) => void;
+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, 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_removeField: (a: number, b: number, c: number, d: number) => void;
 export const document_setQuillRef: (a: number, b: number, c: number, d: number) => void;
-export const document_replaceBody: (a: number, b: number, c: number) => void;
-export const document_pushLeaf: (a: number, b: number, c: number) => void;
-export const document_insertLeaf: (a: number, b: number, c: number, d: number) => void;
-export const document_removeLeaf: (a: number, b: number) => number;
-export const document_moveLeaf: (a: number, b: number, c: number, d: number) => void;
-export const document_setLeafKind: (a: number, b: number, c: number, d: number, e: number) => void;
-export const document_updateLeafField: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const document_removeLeafField: (a: number, b: number, c: number, d: number, e: number) => void;
-export const document_updateLeafBody: (a: number, b: number, c: number, d: number, e: number) => void;
-export const rendersession_pageCount: (a: number) => number;
+export const document_toMarkdown: (a: number, b: number) => void;
+export const document_updateCardBody: (a: number, b: number, c: number, d: number, e: number) => void;
+export const document_updateCardField: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+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_blueprint: (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_render: (a: number, b: number, c: number, d: number) => void;
+export const quill_schema: (a: number) => number;
+export const quill_supportsCanvas: (a: number) => number;
+export const quillmark_new: () => number;
+export const quillmark_quill: (a: number, b: number, c: number) => void;
 export const rendersession_backendId: (a: number, b: number) => void;
-export const rendersession_supportsCanvas: (a: number) => number;
-export const rendersession_warnings: (a: number) => number;
-export const rendersession_render: (a: number, b: number, c: number) => void;
+export const rendersession_pageCount: (a: number) => number;
 export const rendersession_pageSize: (a: number, b: number, c: number) => void;
 export const rendersession_paint: (a: number, b: number, c: number, d: number, e: number) => void;
-export const init: () => void;
-export const qcms_profile_is_bogus: (a: number) => number;
-export const qcms_white_point_sRGB: (a: number) => void;
+export const rendersession_render: (a: number, b: number, c: number) => void;
+export const rendersession_supportsCanvas: (a: number) => number;
+export const rendersession_warnings: (a: number) => number;
+export const lut_inverse_interp16: (a: number, b: number, c: number) => number;
 export const qcms_profile_precache_output_transform: (a: number) => void;
-export const qcms_transform_data_rgb_out_lut_precache: (a: number, b: number, c: number, d: number) => void;
-export const qcms_transform_data_rgba_out_lut_precache: (a: number, b: number, c: number, d: number) => void;
-export const qcms_transform_data_bgra_out_lut_precache: (a: number, b: number, c: number, d: number) => void;
+export const qcms_white_point_sRGB: (a: number) => void;
 export const qcms_transform_data_rgb_out_lut: (a: number, b: number, c: number, d: number) => void;
 export const qcms_transform_data_rgba_out_lut: (a: number, b: number, c: number, d: number) => void;
 export const qcms_transform_data_bgra_out_lut: (a: number, b: number, c: number, d: number) => void;
-export const qcms_transform_release: (a: number) => void;
-export const qcms_enable_iccv4: () => void;
+export const qcms_transform_data_rgb_out_lut_precache: (a: number, b: number, c: number, d: number) => void;
+export const qcms_transform_data_rgba_out_lut_precache: (a: number, b: number, c: number, d: number) => void;
+export const qcms_transform_data_bgra_out_lut_precache: (a: number, b: number, c: number, d: number) => void;
 export const lut_interp_linear16: (a: number, b: number, c: number) => number;
-export const lut_inverse_interp16: (a: number, b: number, c: number) => number;
+export const qcms_enable_iccv4: () => void;
+export const qcms_profile_is_bogus: (a: number) => number;
+export const qcms_transform_release: (a: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;

package/package.json

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