@quillmark/wasm 0.90.0 → 0.92.0

package/core/wasm_bg.js

@@ -21,8 +21,9 @@ export class Document {
     }
     /**
      * Authoring-ergonomics header introducing a blueprint to an LLM/MCP
-     * consumer for the given `quillName`. Surfaced verbatim by every binding
-     * so the wording stays uniform across CLI / Python / MCP.
+     * consumer for the given `quillName`. Re-exposes core's canonical text for
+     * JS consumers; any surface that draws from the same core source stays
+     * uniform.
      * @param {string} quill_name
      * @returns {string}
      */
@@ -56,8 +57,19 @@ export class Document {
      * @returns {Card[]}
      */
     get cards() {
-        const ret = wasm.document_cards(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_cards(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * @returns {Document}
@@ -100,8 +112,8 @@ export class Document {
         return ret !== 0;
     }
     /**
-     * Render a Diagnostic as the canonical pretty-printed text every binding
-     * shows (CLI, Python, MCP). Single source of truth so a Diagnostic looks
+     * Render a Diagnostic as the canonical pretty-printed text (core's
+     * `Diagnostic::fmt_pretty`). Single source of truth so a Diagnostic looks
      * identical no matter which consumer surfaces it.
      * @param {Diagnostic} diag
      * @returns {string}
@@ -123,10 +135,11 @@ export class Document {
         }
     }
     /**
-     * Authoring-format rules for the card-yaml markdown surface — the same
-     * text every binding (CLI, Python, MCP) shows so callers reading errors
-     * from one binding can use the rules from any other. Read once at
-     * startup and cache; the value never changes between calls.
+     * Authoring-format rules for the card-yaml markdown surface. The canonical
+     * text is core's (`quillmark_core::document::FORMAT_RULES`), re-exposed
+     * here for JS consumers so it matches any other surface that draws from the
+     * same source. Read once at startup and cache; the value never changes
+     * between calls.
      * @returns {string}
      */
     static formatRules() {
@@ -219,8 +232,19 @@ export class Document {
      * @returns {Card}
      */
     get main() {
-        const ret = wasm.document_main(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_main(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * Build a fresh `Card` from a kind and a flat field map — the ergonomic
@@ -310,11 +334,11 @@ export class Document {
         }
     }
     /**
-     * The canonical `$quill` reference grammar as author-facing text. Single
-     * source of truth (CLI, Python, MCP): drive schema `describe` and
-     * validation messages from this instead of re-stating the rule — it
-     * matches the `hint` on `parse::invalid_quill_reference`. Cache it; the
-     * value never changes.
+     * The canonical `$quill` reference grammar as author-facing text. Core is
+     * the single source of truth: drive schema `describe` and validation
+     * messages from this instead of re-stating the rule — it matches the
+     * `hint` on `parse::invalid_quill_reference`. Cache it; the value never
+     * changes.
      * @returns {string}
      */
     static quillRefHint() {
@@ -338,8 +362,19 @@ export class Document {
      * @returns {Card | undefined}
      */
     removeCard(index) {
-        const ret = wasm.document_removeCard(this.__wbg_ptr, index);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_removeCard(retptr, this.__wbg_ptr, index);
+            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 the `$ext` map from the composable card at `index` *entirely*,
@@ -420,8 +455,19 @@ export class Document {
      * @returns {Record<string, unknown> | undefined}
      */
     removeExt() {
-        const ret = wasm.document_removeExt(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_removeExt(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * Remove `namespace` from the main card's `$ext` map, returning the value
@@ -432,10 +478,21 @@ export class Document {
      * @returns {any}
      */
     removeExtNamespace(namespace) {
-        const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.document_removeExtNamespace(this.__wbg_ptr, ptr0, len0);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_removeExtNamespace(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);
+        }
     }
     /**
      * Remove a payload field on the main card, returning the removed value or
@@ -460,6 +517,30 @@ export class Document {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Remove `cardKind` from the main card's `$seed` map, returning its
+     * overlay or `undefined`; drops `$seed` entirely once empty. Sibling
+     * kinds survive.
+     * @param {string} card_kind
+     * @returns {any}
+     */
+    removeSeedNamespace(card_kind) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(card_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_removeSeedNamespace(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);
+        }
+    }
     /**
      * @param {string} body
      */
@@ -603,7 +684,7 @@ export class Document {
         }
     }
     /**
-     * Update a payload field on the main card. Clears any existing `!fill` marker.
+     * Update a payload field on the main card. Clears any existing `!must_fill` marker.
      *
      * Throws if `name` does not match `[a-z_][a-z0-9_]*`.
      * @param {string} name
@@ -625,7 +706,7 @@ export class Document {
         }
     }
     /**
-     * Update a payload field on the main card and mark it as `!fill`.
+     * Update a payload field on the main card and mark it as `!must_fill`.
      * Throws on invalid name (see [`setField`](Document::set_field)).
      * @param {string} name
      * @param {any} value
@@ -664,6 +745,29 @@ export class Document {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Merge a card-kind's seed `overlay` into the main card's `$seed` map
+     * under `cardKind`, preserving sibling kinds. Sets the starting values
+     * new cards of that kind spawn with. Throws if `overlay` cannot be
+     * serialized or nests too deep.
+     * @param {string} card_kind
+     * @param {any} overlay
+     */
+    setSeedNamespace(card_kind, overlay) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(card_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_setSeedNamespace(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(overlay));
+            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);
+        }
+    }
     /**
      * Serialize this document to a versioned storage DTO string.
      *
@@ -773,8 +877,19 @@ export class Document {
      * @returns {Diagnostic[]}
      */
     get warnings() {
-        const ret = wasm.document_warnings(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_warnings(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
 }
 if (Symbol.dispose) Document.prototype[Symbol.dispose] = Document.prototype.free;
@@ -872,8 +987,19 @@ export class Quill {
      * @returns {QuillMetadata}
      */
     get metadata() {
-        const ret = wasm.quill_metadata(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.quill_metadata(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * Document schema for the quill: the user-fillable fields plus their
@@ -883,23 +1009,51 @@ export class Quill {
      * @returns {QuillSchema}
      */
     get schema() {
-        const ret = wasm.quill_schema(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.quill_schema(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * Seed a starter composable `Card` of the given kind (carries `$kind`),
-     * committing its fields' `example:` values and leaving every other field
-     * absent. Returns `undefined` if `cardKind` is not declared in this
-     * quill's schema, else a `Card` that feeds straight into
-     * `Document.pushCard` / `insertCard`.
+     * layering an optional per-kind seed `overlay` over the schema-example
+     * base (`overlay › example › absent`). Returns `undefined` if `cardKind`
+     * is not declared in this quill's schema, else a `Card` that feeds
+     * straight into `Document.pushCard` / `insertCard`.
+     *
+     * Pass `document.main.seed?.[cardKind]` as `overlay` so a card added to a
+     * template-derived document inherits its curated starting values; omit it
+     * (or pass `undefined` / `null`) for the bare schema seed. `overlay` is a
+     * plain object — this reads the document, it does not mutate it.
      * @param {string} card_kind
+     * @param {Record<string, unknown> | undefined} overlay
      * @returns {Card | undefined}
      */
-    seedCard(card_kind) {
-        const ptr0 = passStringToWasm0(card_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.quill_seedCard(this.__wbg_ptr, ptr0, len0);
-        return takeObject(ret);
+    seedCard(card_kind, overlay) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(card_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.quill_seedCard(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(overlay));
+            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);
+        }
     }
     /**
      * Seed a starter `Document` from the schema — the main card plus one
@@ -922,8 +1076,19 @@ export class Quill {
      * @returns {Card}
      */
     seedMain() {
-        const ret = wasm.quill_seedMain(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.quill_seedMain(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 takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
      * Flatten this quill back into its canonical file tree — the inverse of

package/core/wasm_bg.wasm.d.ts

@@ -5,7 +5,7 @@ export const __wbg_document_free: (a: number, b: number) => void;
 export const __wbg_quill_free: (a: number, b: number) => void;
 export const document_blueprintInstruction: (a: number, b: number, c: number) => void;
 export const document_cardCount: (a: number) => number;
-export const document_cards: (a: number) => number;
+export const document_cards: (a: number, b: number) => void;
 export const document_clone: (a: number) => number;
 export const document_currentSchemaVersion: (a: number) => void;
 export const document_equals: (a: number, b: number) => number;
@@ -14,19 +14,20 @@ export const document_formatRules: (a: number) => void;
 export const document_fromJson: (a: number, b: number, c: number) => void;
 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_main: (a: number, b: number) => void;
 export const document_makeCard: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 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_quillRefHint: (a: number) => void;
-export const document_removeCard: (a: number, b: number) => number;
+export const document_removeCard: (a: number, b: number, c: number) => void;
 export const document_removeCardExt: (a: number, b: number, c: number) => void;
 export const document_removeCardExtNamespace: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_removeCardField: (a: number, b: number, c: number, d: number, e: number) => void;
-export const document_removeExt: (a: number) => number;
-export const document_removeExtNamespace: (a: number, b: number, c: number) => number;
+export const document_removeExt: (a: number, b: number) => void;
+export const document_removeExtNamespace: (a: number, b: number, c: number, d: number) => void;
 export const document_removeField: (a: number, b: number, c: number, d: number) => void;
+export const document_removeSeedNamespace: (a: number, b: number, c: number, d: number) => void;
 export const document_replaceBody: (a: number, b: number, c: number) => void;
 export const document_schemaVersionOf: (a: number, b: number, c: number) => void;
 export const document_setCardExt: (a: number, b: number, c: number, d: number) => void;
@@ -37,21 +38,22 @@ export const document_setExtNamespace: (a: number, b: number, c: number, d: numb
 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;
+export const document_setSeedNamespace: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_toJson: (a: number, b: number) => void;
 export const document_toMarkdown: (a: number, b: number) => void;
 export const document_tryFromJson: (a: number, b: number) => number;
 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 document_warnings: (a: number, b: number) => void;
 export const init: () => void;
 export const quill_backendId: (a: number, b: number) => void;
 export const quill_blueprint: (a: number, b: number) => void;
 export const quill_fromTree: (a: number, b: number) => void;
-export const quill_metadata: (a: number) => number;
-export const quill_schema: (a: number) => number;
-export const quill_seedCard: (a: number, b: number, c: number) => number;
+export const quill_metadata: (a: number, b: number) => void;
+export const quill_schema: (a: number, b: number) => void;
+export const quill_seedCard: (a: number, b: number, c: number, d: number, e: number) => void;
 export const quill_seedDocument: (a: number) => number;
-export const quill_seedMain: (a: number) => number;
+export const quill_seedMain: (a: number, b: number) => void;
 export const quill_toTree: (a: number) => number;
 export const quill_validate: (a: number, b: number, c: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;

package/package.json

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