@quillmark/wasm 0.90.0 → 0.92.0

package/backends/typst/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
@@ -1219,8 +1384,19 @@ export class RenderSession {
      * @returns {Diagnostic[]}
      */
     get warnings() {
-        const ret = wasm.rendersession_warnings(this.__wbg_ptr);
-        return takeObject(ret);
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.rendersession_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) RenderSession.prototype[Symbol.dispose] = RenderSession.prototype.free;

package/backends/typst/wasm_bg.wasm.d.ts

@@ -7,7 +7,7 @@ export const __wbg_quillmark_free: (a: number, b: number) => void;
 export const __wbg_rendersession_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;
@@ -16,19 +16,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;
@@ -39,21 +40,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 quillmark_new: () => number;
@@ -67,20 +69,7 @@ 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 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_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_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 qcms_enable_iccv4: () => void;
-export const qcms_profile_is_bogus: (a: number) => number;
-export const qcms_transform_release: (a: number) => void;
+export const rendersession_warnings: (a: number, b: 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/core/wasm.d.ts

@@ -1,9 +1,26 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * A path to a value nested inside a field `value`: `string` keys and
+ * `number` array indices, e.g. `["addr", "street"]` or `["recipients", 0, "name"]`.
+ */
+export type PathStep = string | number;
+
 /** A field or comment entry in a `Card.payloadItems` list. */
 export type PayloadItem =
-| { type: "field"; key: string; value: unknown; fill?: boolean }
+| {
+    type: "field";
+    key: string;
+    value: unknown;
+    fill?: boolean;
+    /**
+     * Paths to `!must_fill` markers nested *inside* `value` (the `value`
+     * projection itself is fill-free). Absent when the field has no nested
+     * placeholders. Preserved across `pushCard` / `makeCard`.
+     */
+    nestedFills?: PathStep[][];
+}
 | { type: "comment"; text: string; inline?: boolean };
 
 /**
@@ -14,14 +31,16 @@ export type PayloadItem =
  *
  * `$` system entries are hoisted to named fields: `kind` (the `$kind`, empty
  * string when none), optional `quill` (the `$quill` `name@version`, main card
- * only), optional `id` (`$id`), and optional `ext` (`$ext`). `payloadItems`
- * carries user fields and comments in order.
+ * only), optional `id` (`$id`), optional `ext` (`$ext`), and optional `seed`
+ * (the `$seed` per-kind overlay map, main card only). `payloadItems` carries
+ * user fields and comments in order.
  */
 export interface Card {
     kind: string;
     quill?: string;
     id?: string;
     ext?: Record<string, unknown>;
+    seed?: Record<string, unknown>;
     payloadItems: PayloadItem[];
     body: string;
 }
@@ -134,8 +153,9 @@ export class Document {
     [Symbol.dispose](): void;
     /**
      * 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.
      */
     static blueprintInstruction(quill_name: string): string;
     clone(): Document;
@@ -151,16 +171,17 @@ export class Document {
      */
     equals(other: Document): boolean;
     /**
-     * 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.
      */
     static formatDiagnostic(diag: Diagnostic): string;
     /**
-     * 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.
      */
     static formatRules(): string;
     /**
@@ -201,11 +222,11 @@ export class Document {
      */
     pushCard(card: Card): void;
     /**
-     * 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.
      */
     static quillRefHint(): string;
     removeCard(index: number): Card | undefined;
@@ -245,6 +266,12 @@ export class Document {
      * `undefined`. Throws if `name` does not match `[a-z_][a-z0-9_]*`.
      */
     removeField(name: string): any;
+    /**
+     * Remove `cardKind` from the main card's `$seed` map, returning its
+     * overlay or `undefined`; drops `$seed` entirely once empty. Sibling
+     * kinds survive.
+     */
+    removeSeedNamespace(card_kind: string): any;
     replaceBody(body: string): void;
     /**
      * Read the `schema` version tag from a raw storage DTO string without a
@@ -286,13 +313,13 @@ export class Document {
      */
     setExtNamespace(namespace: string, value: any): void;
     /**
-     * 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_]*`.
      */
     setField(name: string, value: any): void;
     /**
-     * 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)).
      */
     setFill(name: string, value: any): void;
@@ -300,6 +327,13 @@ export class Document {
      * Replace the QUILL reference string. Throws if `ref_str` is invalid.
      */
     setQuillRef(ref_str: string): void;
+    /**
+     * 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.
+     */
+    setSeedNamespace(card_kind: string, overlay: any): void;
     /**
      * Serialize this document to a versioned storage DTO string.
      *
@@ -363,12 +397,17 @@ export class Quill {
     static fromTree(tree: Map<string, Uint8Array>): Quill;
     /**
      * 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.
      */
-    seedCard(card_kind: string): Card | undefined;
+    seedCard(card_kind: string, overlay: Record<string, unknown> | undefined): Card | undefined;
     /**
      * Seed a starter `Document` from the schema — the main card plus one
      * instance of each composable card kind, each committing its fields'