@quillmark/wasm 0.92.1 → 0.95.1

package/backends/typst/wasm_bg.js

@@ -19,6 +19,218 @@ export class Document {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_document_free(ptr, 0);
     }
+    /**
+     * Build a composable card of `kind`, typed-commit `fields` onto it, set its
+     * body from optional markdown, and place it — the ABI under `writer.addCard`.
+     * `at` picks the position: absent appends, a number inserts at that index
+     * (`0..=cards.length`), so a positioned typed insert is one atomic call
+     * rather than `addCard` + `moveCard`. Fuses `makeCard` + typed commit +
+     * insertion transactionally: the card is committed in full before it joins
+     * the document, so a rejected field (or an invalid kind, body, or
+     * out-of-range `at`) leaves the document untouched. Field errors throw the
+     * same per-field diagnostic bundle as [`commitFields`](Self::commit_fields),
+     * including an `[EditError::UnknownField]` per undeclared name; an invalid
+     * kind or body, or an out-of-range position, throws a single-entry bundle
+     * keyed `$kind` / `$body`.
+     * @param {Quill} quill
+     * @param {string} kind
+     * @param {Record<string, unknown>} [fields]
+     * @param {string} [body]
+     * @param {number} [at]
+     */
+    _addCard(quill, kind, fields, body, at) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(quill, Quill);
+            const ptr0 = passStringToWasm0(kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            var ptr1 = isLikeNone(body) ? 0 : passStringToWasm0(body, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            wasm.document__addCard(retptr, this.__wbg_ptr, quill.__wbg_ptr, ptr0, len0, isLikeNone(fields) ? 0 : addHeapObject(fields), ptr1, len1, isLikeNone(at) ? 0x100000001 : (at) >>> 0);
+            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);
+        }
+    }
+    /**
+     * Typed field write at `addr`, resolving the field's schema `type` from
+     * `quill` — the stable ABI under the runtime `writer.set` / `writer.card(i).set`.
+     * The one write verb for **every** field type (richtext, scalar, array,
+     * object); the schema carries the `inline` constraint, so no type token or
+     * flag is passed. A richtext-typed field stores the canonical content, so
+     * identity marks (anchors, island ids) and content-only marks (e.g.
+     * `underline`) live on it and survive compiles and the storage DTO. Values
+     * use the encoding the seam already speaks: a content object or markdown
+     * string for richtext, a scalar/array/object otherwise.
+     *
+     * A bare string is `Addr` shorthand for `{ field }`; `{ card, field }`
+     * targets a composable card (its `$kind` resolves the schema). A body
+     * address throws — a body has no field schema; write it with `writer.setBody`
+     * / `revise`. A field declared in the schema is strict-committed (a mismatch
+     * throws now, not at render); a name the schema does not declare throws
+     * `[EditError::UnknownField]` rather than falling to the opaque store — on
+     * the typed path it is a typo. Use [`storeField`](Document::store_field) for
+     * opaque storage. Also throws `[EditError::FieldConform]` /
+     * `[EditError::FieldRichtextDecode]` / `[EditError::FieldRichtextNotInline]`
+     * on a typed mismatch, `[EditError::InvalidFieldName]` on a malformed name,
+     * and `[EditError::IndexOutOfRange]` on an out-of-range card.
+     *
+     * The `quill` handle is passed per call because a `Document` carries only a
+     * `$quill` reference, not the resolved schema.
+     * @param {Quill} quill
+     * @param {Addr | string} addr
+     * @param {any} value
+     */
+    _commitField(quill, addr, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(quill, Quill);
+            wasm.document__commitField(retptr, this.__wbg_ptr, quill.__wbg_ptr, addHeapObject(addr), addHeapObject(value));
+            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);
+        }
+    }
+    /**
+     * Batched twin of [`commitField`](Document::commit_field): typed-commit
+     * several fields on the card `addr` targets atomically, resolving each
+     * field's schema `type` from `quill`. `addr` is a **card address**
+     * (`{ card }`, absent = main; a present `field` throws). All-or-nothing with
+     * the same per-field-diagnostic error contract as
+     * [`storeFields`](Document::store_fields) — nothing is applied on error and
+     * the thrown error's `diagnostics` carry one entry per offending field,
+     * including an `[EditError::UnknownField]` for any name the schema does not
+     * declare, so a whole-form submit sees every typo in one pass. Throws on an
+     * out-of-range card.
+     * @param {Quill} quill
+     * @param {CardAddr} addr
+     * @param {Record<string, unknown>} fields
+     */
+    _commitFields(quill, addr, fields) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(quill, Quill);
+            wasm.document__commitFields(retptr, this.__wbg_ptr, quill.__wbg_ptr, addHeapObject(addr), addHeapObject(fields));
+            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);
+        }
+    }
+    /**
+     * Revise the richtext field at `addr` from markdown, typed *and*
+     * anchor-preserving — the ABI under `writer.reviseField`. Resolves the
+     * field's schema from `quill` (main card, or the addressed card's `$kind`)
+     * and defers to [`TypedWriter::revise_field`](quillmark_core::TypedWriter::revise_field):
+     * surviving anchors rebase (as [`revise`](Self::revise)), then the diffed
+     * result is schema-conformed, so a `richtext(inline)` field rejects a
+     * multi-block result with `[EditError::FieldRichtextNotInline]`. Returns the
+     * text [`Delta`].
+     *
+     * `addr` must name a field (a bare string is `{ field }`); a body address
+     * throws (a body carries no field schema — use [`revise`](Self::revise)). A
+     * name the schema does not declare throws `[EditError::UnknownField]`. Throws
+     * on an out-of-range card. Hidden from the `.d.ts`; the visible verb is
+     * `writer.reviseField` in the runtime layer.
+     * @param {Quill} quill
+     * @param {Addr | string} addr
+     * @param {string} markdown
+     * @returns {Delta}
+     */
+    _reviseField(quill, addr, markdown) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(quill, Quill);
+            const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document__reviseField(retptr, this.__wbg_ptr, quill.__wbg_ptr, addHeapObject(addr), 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);
+        }
+    }
+    /**
+     * Interpreted read at `addr`, resolving the field's declared `type` from
+     * `quill` — the stable ABI under the runtime `view.get` / `view.card(i).get`.
+     * The schema-plane twin of the quill-free [`get`](Self::get): a `richtext`
+     * field returns its markdown projection, every other declared type its
+     * canonical value verbatim, so a consumer holding the quill reads by field
+     * meaning rather than by wire shape.
+     *
+     * A bare string is `Addr` shorthand for `{ field }`; `{ card, field }`
+     * targets a composable card (its `$kind` resolves the schema). Returns
+     * `undefined` for an **absent** field. An absent `addr.field` reads the body
+     * markdown — quill-free, mirroring [`getMarkdown`](Self::get_markdown), since
+     * a body's type is a format fact, not a schema fact. A name the schema does
+     * not declare throws `[EditError::UnknownField]` (the authority `getMarkdown`
+     * lacks — there an unknown name reads back `undefined`); a `richtext` field
+     * holding a value that does not decode throws `[EditError::FieldRichtextDecode]`;
+     * an out-of-range `addr.card` throws.
+     *
+     * The `quill` handle is passed per call because a `Document` carries only a
+     * `$quill` reference, not the resolved schema.
+     * @param {Quill} quill
+     * @param {Addr | string} addr
+     * @returns {unknown}
+     */
+    _viewGet(quill, addr) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(quill, Quill);
+            wasm.document__viewGet(retptr, this.__wbg_ptr, quill.__wbg_ptr, addHeapObject(addr));
+            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);
+        }
+    }
+    /**
+     * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
+     * at `addr` — the editor splice: text delta first, then line ops, then mark
+     * ops (mark ranges in final-text coordinates), each all-or-nothing. An absent
+     * `addr.field` targets the body, an absent `addr.card` the main card.
+     *
+     * Throws on an out-of-range card, a field that is not richtext, a malformed
+     * bundle, or an op that applies out of bounds (the value is unchanged on a
+     * failed apply).
+     * @param {Addr | string} addr
+     * @param {ChangeBundle} bundle
+     */
+    applyChange(addr, bundle) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_applyChange(retptr, this.__wbg_ptr, addHeapObject(addr), addHeapObject(bundle));
+            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);
+        }
+    }
     /**
      * Authoring-ergonomics header introducing a blueprint to an LLM/MCP
      * consumer for the given `quillName`. Re-exposes core's canonical text for
@@ -45,6 +257,30 @@ export class Document {
             wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
         }
     }
+    /**
+     * A single composable card by index — the whole `Card`, the card-indexed
+     * twin of the [`main`](Self::main) getter, so reading one card need not
+     * materialize every card via [`cards`](Self::cards). An out-of-range
+     * `index` throws `[EditError::IndexOutOfRange]`, matching the card write
+     * verbs.
+     * @param {number} index
+     * @returns {Card}
+     */
+    card(index) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_card(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);
+        }
+    }
     /**
      * Number of composable cards (excludes the main card). O(1).
      * @returns {number}
@@ -53,6 +289,20 @@ export class Document {
         const ret = wasm.document_cardCount(this.__wbg_ptr);
         return ret >>> 0;
     }
+    /**
+     * The index of the first composable card whose `$id` equals `id`, or
+     * `undefined` when none carries it. Resolves the canonical durable address
+     * without a hand-rolled scan over [`cards`](Self::cards); `$id` is
+     * non-unique by design, so the first match wins.
+     * @param {string} id
+     * @returns {number | undefined}
+     */
+    cardIndexById(id) {
+        const ptr0 = passStringToWasm0(id, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.document_cardIndexById(this.__wbg_ptr, ptr0, len0);
+        return takeObject(ret);
+    }
     /**
      * @returns {Card[]}
      */
@@ -208,15 +458,200 @@ export class Document {
         }
     }
     /**
-     * Insert a card at `index` (must be in `0..=cards.length`). Accepts a
-     * `Card` (see [`pushCard`](Self::push_card)).
-     * @param {number} index
-     * @param {Card} card
+     * Read the value at `addr` — the raw stored payload value of a field (a
+     * content object for a richtext field, a scalar/array/object otherwise), or
+     * the **body content** when `addr.field` is absent. A bare string is `Addr`
+     * shorthand for `{ field }`. Reads are total over the field axis: an absent
+     * field is `undefined`; only an out-of-range `addr.card` throws
+     * `[EditError::IndexOutOfRange]`. Reads need no schema, so they live on
+     * `Document`, not the typed writer; for the markdown projection of a
+     * richtext value use [`getMarkdown`](Self::get_markdown).
+     * @param {Addr | string} addr
+     * @returns {unknown}
+     */
+    get(addr) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_get(retptr, this.__wbg_ptr, addHeapObject(addr));
+            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);
+        }
+    }
+    /**
+     * The whole `$ext` map at `addr` (a card address, absent `card` = main), or
+     * `undefined` when the card carries none. The fine-grained `$ext` read —
+     * your own state without serializing the whole card. Throws on a present
+     * `field` (a card address takes only `card`) or an out-of-range card.
+     * @param {CardAddr} [addr]
+     * @returns {Record<string, unknown> | undefined}
+     */
+    getExt(addr) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_getExt(retptr, this.__wbg_ptr, addHeapObject(addr));
+            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);
+        }
+    }
+    /**
+     * The value stored under `$ext[ns]` at `addr` (a card address, absent `card`
+     * = main), or `undefined`. The namespace-scoped `$ext` read — your own slot
+     * without a whole-card serialize, and non-destructive (unlike
+     * `removeExtNamespace`). Throws on a present `field` or an out-of-range card.
+     * @param {CardAddr} addr
+     * @param {string} ns
+     * @returns {unknown}
+     */
+    getExtNamespace(addr, ns) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(ns, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_getExtNamespace(retptr, this.__wbg_ptr, addHeapObject(addr), 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);
+        }
+    }
+    /**
+     * The **body** markdown projection — the main body, or a composable card's
+     * body (`{ card }`) — the on-demand, lossy export (content-only marks do not
+     * survive markdown). A body's type is a format fact, not a schema fact, so
+     * this read stays quill-free; a body is never absent.
+     *
+     * `addr` is an optional **card address** (`{ card }`, absent = main). A
+     * present `field` throws — a field's markdown is read through the
+     * schema-plane `quill.view(doc).get(field)`, which interprets by declared
+     * type (#978). An out-of-range `addr.card` throws.
+     * @param {CardAddr} [addr]
+     * @returns {string}
+     */
+    getMarkdown(addr) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_getMarkdown(retptr, this.__wbg_ptr, addHeapObject(addr));
+            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);
+        }
+    }
+    /**
+     * Insert a card — the single insertion verb: `at` absent appends, a number
+     * inserts at that index (must be in `0..=cards.length`). Accepts a
+     * `CardInput` — a card read back (`cards` / `removeCard` / `quill.seedCard`),
+     * a [`makeCard`](Document::make_card) result, or a bare `{ kind, body }`
+     * (every returned `Card` is a valid `CardInput`). Throws if `card.kind` is
+     * not a valid kind name, or if `at` is out of range.
+     * @param {CardInput} card
+     * @param {number} [at]
+     */
+    insertCard(card, at) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_insertCard(retptr, this.__wbg_ptr, addHeapObject(card), isLikeNone(at) ? 0x100000001 : (at) >>> 0);
+            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);
+        }
+    }
+    /**
+     * **Install** a richtext value at `addr` — **value semantics**, content only.
+     * Stores exactly `rt` (a canonical `Content` content object); the identity
+     * anchors of any previous value are gone. An absent `addr.field` targets the
+     * body, an absent `addr.card` the main card. For "here's new markdown," use
+     * [`revise`](Document::revise); the cold-import path is spelled at the call
+     * site as `install(addr, importMarkdown(md))`, so anchor loss is visible in
+     * source.
+     *
+     * Throws on an out-of-range card, a malformed field name, or an `rt` that is
+     * not a canonical content object.
+     * @param {Addr | string} addr
+     * @param {Content} rt
+     */
+    install(addr, rt) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_install(retptr, this.__wbg_ptr, addHeapObject(addr), addHeapObject(rt));
+            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);
+        }
+    }
+    /**
+     * Whether the field at `addr` is marked `!must_fill`. A bare string is `Addr`
+     * shorthand for `{ field }`. `false` for an absent field (truthful — it isn't
+     * marked) and for a body address (a body is never a fill). Only an
+     * out-of-range `addr.card` throws.
+     * @param {Addr | string} addr
+     * @returns {boolean}
      */
-    insertCard(index, card) {
+    isFill(addr) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_insertCard(retptr, this.__wbg_ptr, index, addHeapObject(card));
+            wasm.document_isFill(retptr, this.__wbg_ptr, addHeapObject(addr));
+            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 r0 !== 0;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Replace this document's contents **in place** from a versioned storage
+     * DTO string — the mutating twin of the static
+     * [`fromJson`](Document::from_json) constructor. Parse-time `warnings` are
+     * cleared. Throws (leaving the document unchanged) on an invalid DTO.
+     *
+     * The cross-WASM-memory `Document` bridge: mutate a document on a
+     * backend-memory clone, then write the mutated state back into the caller's
+     * canonical document with this — the one way to update a live handle across
+     * the linear-memory seam without the caller re-binding its variable.
+     * @param {string} json
+     */
+    loadJson(json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_loadJson(retptr, this.__wbg_ptr, ptr0, len0);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -248,10 +683,10 @@ export class Document {
     }
     /**
      * Build a fresh `Card` from a kind and a flat field map — the ergonomic
-     * constructor for `pushCard` / `insertCard`. `fields` is an optional
+     * constructor for `insertCard`. `fields` is an optional
      * `Record<string, unknown>` (each entry becomes a card field, in
      * insertion order); `body` defaults to `""`. Kind validity is checked by
-     * `pushCard` / `insertCard`, not here.
+     * `insertCard`, not here.
      * @param {string} kind
      * @param {Record<string, unknown>} [fields]
      * @param {string} [body]
@@ -295,21 +730,29 @@ export class Document {
         }
     }
     /**
-     * Append a card to the end of the card list. Accepts a `Card` (the shape
-     * returned by `cards` / `removeCard` / `quill.seedCard`); build a fresh
-     * one with [`Document.makeCard`](Document::make_card). Throws if
-     * `card.kind` is not a valid kind name.
-     * @param {Card} card
+     * `new Document(quillRef)` — a blank document: a main card carrying only
+     * `$quill`, an empty body, and no composable cards. The programmatic
+     * blank canvas: absent fields resolve at render time (`default`, else
+     * type-empty zero), so nothing the caller did not set reaches the
+     * output. For an example-filled starter use `Quill.seedDocument()`.
+     * Throws on an invalid quill reference. Mirrors Python `Document(quill_ref)`.
+     * @param {string} quill_ref
      */
-    pushCard(card) {
+    constructor(quill_ref) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_pushCard(retptr, this.__wbg_ptr, addHeapObject(card));
+            const ptr0 = passStringToWasm0(quill_ref, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_new(retptr, ptr0, len0);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            if (r1) {
-                throw takeObject(r0);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            this.__wbg_ptr = r0 >>> 0;
+            DocumentFinalization.register(this, this.__wbg_ptr, this);
+            return this;
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
@@ -377,16 +820,17 @@ export class Document {
         }
     }
     /**
-     * Remove the `$ext` map from the composable card at `index` *entirely*,
-     * returning the previous map or `undefined`. Throws if out of range.
-     * Prefer `removeCardExtNamespace` to clear only one consumer's slot.
-     * @param {number} index
+     * Remove the `$ext` map on the card `addr` targets *entirely*, returning the
+     * previous map or `undefined` — a blunt escape hatch that discards every
+     * namespace at once (prefer `removeExtNamespace`). `addr` is a card address
+     * (absent = main). Throws on a present `field` or an out-of-range card.
+     * @param {CardAddr} [addr]
      * @returns {Record<string, unknown> | undefined}
      */
-    removeCardExt(index) {
+    removeExt(addr) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_removeCardExt(retptr, this.__wbg_ptr, index);
+            wasm.document_removeExt(retptr, this.__wbg_ptr, addHeapObject(addr));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -399,19 +843,20 @@ export class Document {
         }
     }
     /**
-     * Remove `namespace` from the composable card's `$ext` map, returning the
-     * value stored there or `undefined`; clears `$ext` entirely once empty.
-     * The card-indexed twin of `removeExtNamespace`. Throws if out of range.
-     * @param {number} index
-     * @param {string} namespace
+     * Remove `$ext[ns]` on the card `addr` targets, returning its value or
+     * `undefined`; drops `$ext` once empty. `addr` is a card address (absent =
+     * main). Preserves sibling namespaces. Throws on a present `field` or an
+     * out-of-range card.
+     * @param {CardAddr} addr
+     * @param {string} ns
      * @returns {any}
      */
-    removeCardExtNamespace(index, namespace) {
+    removeExtNamespace(addr, ns) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(ns, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_removeCardExtNamespace(retptr, this.__wbg_ptr, index, ptr0, len0);
+            wasm.document_removeExtNamespace(retptr, this.__wbg_ptr, addHeapObject(addr), 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);
@@ -424,18 +869,17 @@ export class Document {
         }
     }
     /**
-     * Remove a field on the card at `index`. Returns the removed value or
-     * `undefined`. Throws if `index` is out of range or `name` is invalid.
-     * @param {number} index
-     * @param {string} name
+     * Remove a field at `addr`, returning the removed value or `undefined`. A
+     * bare string is `Addr` shorthand for `{ field }`. One `remove` verb serves
+     * every write lane. A body address throws; throws on an out-of-range card or
+     * a malformed name.
+     * @param {Addr | string} addr
      * @returns {any}
      */
-    removeCardField(index, name) {
+    removeField(addr) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-            const len0 = WASM_VECTOR_LEN;
-            wasm.document_removeCardField(retptr, this.__wbg_ptr, index, ptr0, len0);
+            wasm.document_removeField(retptr, this.__wbg_ptr, addHeapObject(addr));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -448,16 +892,18 @@ export class Document {
         }
     }
     /**
-     * Remove the `$ext` map from the main card *entirely*, returning the
-     * previous map or `undefined`. This is a blunt escape hatch that discards
-     * every namespace at once — prefer `removeExtNamespace` to clear only your
-     * own slot while leaving sibling consumers' state intact.
-     * @returns {Record<string, unknown> | undefined}
+     * Remove `cardKind` from the main card's `$seed` map, returning its
+     * overlay or `undefined`; drops `$seed` entirely once empty. Sibling kinds
+     * survive. `$seed` is main-only, so this takes no address.
+     * @param {string} card_kind
+     * @returns {any}
      */
-    removeExt() {
+    removeSeedNamespace(card_kind) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_removeExt(retptr, this.__wbg_ptr);
+            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);
@@ -470,19 +916,25 @@ export class Document {
         }
     }
     /**
-     * Remove `namespace` from the main card's `$ext` map, returning the value
-     * stored there or `undefined`. This is the recommended way to clear `$ext`
-     * state: sibling namespaces survive, and when the last namespace is removed
-     * the `$ext` entry is dropped entirely (not left as `$ext: {}`).
-     * @param {string} namespace
-     * @returns {any}
+     * **Revise** the richtext value at `addr` from a markdown string — **edit
+     * semantics**, the default write path, returning the text [`Delta`]. Imports
+     * the markdown, diffs it against the current value, rebases surviving
+     * identity anchors, and returns the change an editor bridge maps its own
+     * positions through (`mapPos`). An absent `addr.field` targets the body, an
+     * absent `addr.card` the main card; an absent field cold-imports from empty.
+     *
+     * Throws on an out-of-range card, a malformed field name, a present
+     * non-content field value, or an over-nested markdown input.
+     * @param {Addr | string} addr
+     * @param {string} markdown
+     * @returns {Delta}
      */
-    removeExtNamespace(namespace) {
+    revise(addr, markdown) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_removeExtNamespace(retptr, this.__wbg_ptr, ptr0, len0);
+            wasm.document_revise(retptr, this.__wbg_ptr, addHeapObject(addr), 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);
@@ -495,41 +947,46 @@ export class Document {
         }
     }
     /**
-     * Remove a payload field on the main card, returning the removed value or
-     * `undefined`. Throws if `name` does not match `[A-Za-z_][A-Za-z0-9_]*`.
-     * @param {string} name
-     * @returns {any}
+     * Read the `schema` version tag from a raw storage DTO string without a
+     * full parse, or `undefined`. Returns unknown future versions as-is —
+     * useful to distinguish "build too old" from "payload corrupt" when
+     * `fromJson` throws.
+     * @param {string} json
+     * @returns {string | undefined}
      */
-    removeField(name) {
+    static schemaVersionOf(json) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_removeField(retptr, this.__wbg_ptr, ptr0, len0);
+            wasm.document_schemaVersionOf(retptr, 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);
+            let v2;
+            if (r0 !== 0) {
+                v2 = getStringFromWasm0(r0, r1).slice();
+                wasm.__wbindgen_export4(r0, r1 * 1, 1);
             }
-            return takeObject(r0);
+            return v2;
         } finally {
             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}
+     * The main card's `$seed` overlay object for `kind` (the `$seed[kind]`
+     * entry), or `undefined` when absent. The cheap read that feeds
+     * `quill.seedCard(kind, overlay)` without serializing the whole main card
+     * via [`main`](Self::main) to fish out one key — and it keeps `seedCard`
+     * pure: the quill still never reads the document.
+     * @param {string} kind
+     * @returns {Record<string, unknown> | undefined}
      */
-    removeSeedNamespace(card_kind) {
+    seedOverlay(kind) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(card_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_removeSeedNamespace(retptr, this.__wbg_ptr, ptr0, len0);
+            wasm.document_seedOverlay(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);
@@ -542,50 +999,59 @@ export class Document {
         }
     }
     /**
-     * @param {string} body
+     * Replace the kind of the card at `index`. Payload and body are untouched;
+     * schema-aware migration is the caller's responsibility.
+     * Throws if `index` is out of range or `newKind` is invalid.
+     * @param {number} index
+     * @param {string} new_kind
      */
-    replaceBody(body) {
-        const ptr0 = passStringToWasm0(body, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.document_replaceBody(this.__wbg_ptr, ptr0, len0);
+    setCardKind(index, new_kind) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(new_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_setCardKind(retptr, this.__wbg_ptr, index, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
-     * Read the `schema` version tag from a raw storage DTO string without a
-     * full parse, or `undefined`. Returns unknown future versions as-is —
-     * useful to distinguish "build too old" from "payload corrupt" when
-     * `fromJson` throws.
-     * @param {string} json
-     * @returns {string | undefined}
+     * Replace the QUILL reference string. Throws if `ref_str` is invalid.
+     * @param {string} ref_str
      */
-    static schemaVersionOf(json) {
+    setQuillRef(ref_str) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(ref_str, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_schemaVersionOf(retptr, ptr0, len0);
+            wasm.document_setQuillRef(retptr, this.__wbg_ptr, ptr0, len0);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            let v2;
-            if (r0 !== 0) {
-                v2 = getStringFromWasm0(r0, r1).slice();
-                wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            if (r1) {
+                throw takeObject(r0);
             }
-            return v2;
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
-     * Replace the `$ext` map on the composable card at `index`. Throws if out
-     * of range or `value` is not a plain object. Named to mirror `setExt` on
-     * the main card; `setCardExtNamespace` is the sibling-safe alternative.
-     * @param {number} index
+     * Replace the opaque `$ext` map on the card `addr` targets (a card address,
+     * absent `card` = main). `value` must be a plain object. `$ext` carries
+     * out-of-band consumer state and never reaches the rendered output; pass
+     * `{}` for an explicit empty `$ext`. Quill-free and verbatim — an opaque
+     * `store` verb. Throws on a present `field` or an out-of-range card.
+     * @param {CardAddr} addr
      * @param {any} value
      */
-    setCardExt(index, value) {
+    storeExt(addr, value) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_setCardExt(retptr, this.__wbg_ptr, index, addHeapObject(value));
+            wasm.document_storeExt(retptr, this.__wbg_ptr, addHeapObject(addr), addHeapObject(value));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -596,19 +1062,20 @@ export class Document {
         }
     }
     /**
-     * Merge `value` into the composable card's `$ext` map under `namespace`,
-     * preserving sibling namespaces. The card-indexed twin of `setExtNamespace`.
-     * Throws if out of range or `value` cannot be serialized.
-     * @param {number} index
-     * @param {string} namespace
+     * Merge `value` into `$ext[ns]` on the card `addr` targets, preserving
+     * sibling namespaces — the recommended `$ext` write. `addr` is a card
+     * address (absent = main). Quill-free and verbatim — an opaque `store` verb.
+     * Throws on a present `field` or an out-of-range card.
+     * @param {CardAddr} addr
+     * @param {string} ns
      * @param {any} value
      */
-    setCardExtNamespace(index, namespace, value) {
+    storeExtNamespace(addr, ns, value) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(ns, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_setCardExtNamespace(retptr, this.__wbg_ptr, index, ptr0, len0, addHeapObject(value));
+            wasm.document_storeExtNamespace(retptr, this.__wbg_ptr, addHeapObject(addr), ptr0, len0, addHeapObject(value));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -619,18 +1086,21 @@ export class Document {
         }
     }
     /**
-     * Replace the kind of the card at `index`. Payload and body are untouched;
-     * schema-aware migration is the caller's responsibility.
-     * Throws if `index` is out of range or `newKind` is invalid.
-     * @param {number} index
-     * @param {string} new_kind
+     * Store a field verbatim at `addr` — the opaque store (**store** = verbatim,
+     * coercion deferred to render; the typed write is
+     * [`commitField`](Document::commit_field)). A bare string is `Addr`
+     * shorthand for `{ field }`, so `doc.storeField("qty", 3)` reads as written;
+     * `{ card: 2, field: "qty" }` targets a composable card. Clears any
+     * `!must_fill` marker. A body address (no `field`) throws — a body is never
+     * opaque; write it with `revise` / `install` / `writer.setBody`. Throws on
+     * an out-of-range card or a malformed name.
+     * @param {Addr | string} addr
+     * @param {any} value
      */
-    setCardKind(index, new_kind) {
+    storeField(addr, value) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(new_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-            const len0 = WASM_VECTOR_LEN;
-            wasm.document_setCardKind(retptr, this.__wbg_ptr, index, ptr0, len0);
+            wasm.document_storeField(retptr, this.__wbg_ptr, addHeapObject(addr), addHeapObject(value));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -641,16 +1111,21 @@ export class Document {
         }
     }
     /**
-     * Replace the opaque `$ext` map on the main card. `value` must be a plain
-     * object; throws otherwise. `$ext` carries out-of-band consumer state and
-     * never reaches the rendered output. Pass `{}` to record an explicit
-     * empty `$ext`.
-     * @param {any} value
+     * Store several fields verbatim and atomically on the card `addr` targets —
+     * the opaque store's batch. `addr` is a **card address** (`{ card }`, absent
+     * = main); a present `field` throws. The batch verb takes the address first
+     * and is never shape-overloaded, because `card` is a legal field name:
+     * `storeFields({}, fields)` is the main card, `storeFields({ card: 2 },
+     * fields)` a composable one — never ambiguous with "set field `card`".
+     * Nothing is applied on error; the thrown error's `diagnostics` carry one
+     * entry per offending field. Throws on an out-of-range card.
+     * @param {CardAddr} addr
+     * @param {Record<string, unknown>} fields
      */
-    setExt(value) {
+    storeFields(addr, fields) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_setExt(retptr, this.__wbg_ptr, addHeapObject(value));
+            wasm.document_storeFields(retptr, this.__wbg_ptr, addHeapObject(addr), addHeapObject(fields));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -661,19 +1136,17 @@ export class Document {
         }
     }
     /**
-     * Merge `value` into the main card's `$ext` map under `namespace`, creating
-     * the map when absent and replacing any existing value at that key. Sibling
-     * namespaces are preserved, so independent consumers (`$ext.editor`,
-     * `$ext.agent`, …) don't clobber each other.
-     * @param {string} namespace
+     * Store a field verbatim at `addr` and mark it `!must_fill` — the opaque
+     * store's fill variant, card-capable (a bare string or `{ field }` for main,
+     * `{ card, field }` for a composable card). A body address throws. Same
+     * validation as [`storeField`](Document::store_field).
+     * @param {Addr | string} addr
      * @param {any} value
      */
-    setExtNamespace(namespace, value) {
+    storeFill(addr, value) {
         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_setExtNamespace(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(value));
+            wasm.document_storeFill(retptr, this.__wbg_ptr, addHeapObject(addr), addHeapObject(value));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -684,18 +1157,20 @@ export class Document {
         }
     }
     /**
-     * Update a payload field on the main card. Clears any existing `!must_fill` marker.
-     *
-     * Throws if `name` does not match `[A-Za-z_][A-Za-z0-9_]*`.
-     * @param {string} name
-     * @param {any} value
+     * Merge a card-kind's seed `overlay` into the **main** card's `$seed` map
+     * under `cardKind`, preserving sibling kinds — `$seed` lives on the main
+     * card by model, so this takes no address. Sets the starting values new
+     * cards of that kind spawn with. Quill-free and verbatim — an opaque `store`
+     * verb. Throws if `overlay` cannot be serialized or nests too deep.
+     * @param {string} card_kind
+     * @param {any} overlay
      */
-    setField(name, value) {
+    storeSeedNamespace(card_kind, overlay) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(card_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_setField(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(value));
+            wasm.document_storeSeedNamespace(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) {
@@ -706,180 +1181,390 @@ export class Document {
         }
     }
     /**
-     * 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
+     * Serialize this document to a versioned storage DTO string.
+     *
+     * Prefer this over `toMarkdown` for persistence across restarts or crate
+     * upgrades — the wire format is frozen per `schema` version. Parse-time
+     * `warnings` are excluded from the DTO.
+     *
+     * Output is **byte-deterministic** within a `schema` version: equal
+     * documents produce byte-equal output, safe for content-hash use cases.
+     * @returns {string}
      */
-    setFill(name, value) {
+    toJson() {
+        let deferred1_0;
+        let deferred1_1;
         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_toJson(retptr, this.__wbg_ptr);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            if (r1) {
-                throw takeObject(r0);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * Emit canonical Quillmark Markdown. Round-trip safe: re-parsing the
+     * result produces a `Document` equal to `self` by value and by type.
+     * @returns {string}
+     */
+    toMarkdown() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_toMarkdown(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * Like [`fromJson`](Document::from_json) but returns `undefined` instead
+     * of throwing when `json` is not a valid storage DTO — use to
+     * discriminate format without exceptions as control flow.
+     * `undefined` means "not a storage DTO"; `fromMarkdown` still throws on
+     * genuinely malformed markdown.
+     * @param {string} json
+     * @returns {Document | undefined}
+     */
+    static tryFromJson(json) {
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.document_tryFromJson(ptr0, len0);
+        return ret === 0 ? undefined : Document.__wrap(ret);
+    }
+    /**
+     * @returns {Diagnostic[]}
+     */
+    get warnings() {
+        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;
+
+/**
+ * Live render session: reads (`render`, `paint`, `pageSize`, `regions`,
+ * `fieldAt`, `positionAt`, `locate`) serve the current compile. `apply(doc)`
+ * recompiles a whole document in place, transactionally (on throw every read
+ * keeps serving the last-good compile). Geometry reads reflect the current
+ * compile; anchoring a caret across edits is the editor's job — re-read
+ * geometry after each committed `apply`.
+ *
+ * **Empty documents.** A zero-page document yields a valid session
+ * (`pageCount === 0`); `paint(ctx, 0)` or `pageSize(0)` throws with
+ * `"page index 0 out of range (pageCount=0)"`. Branch on `pageCount === 0`
+ * rather than catching the error.
+ */
+export class LiveSession {
+    static __wrap(ptr) {
+        ptr = ptr >>> 0;
+        const obj = Object.create(LiveSession.prototype);
+        obj.__wbg_ptr = ptr;
+        LiveSessionFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        LiveSessionFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_livesession_free(ptr, 0);
+    }
     /**
-     * Replace the QUILL reference string. Throws if `ref_str` is invalid.
-     * @param {string} ref_str
+     * Recompile the session against `doc` — the edit verb of a live preview.
+     * The document is compiled through the same schema pipeline as `open`
+     * (same quill), then applied transactionally: on throw every read
+     * (`render`, `paint`, `pageSize`, `regions`, `fieldAt`) keeps serving the last-good
+     * compile, and the session recovers on the next successful `apply`. On
+     * success reads serve the new compile; repaint `dirtyPages ∩ visible`.
+     * @param {Document} doc
+     * @returns {ChangeSet}
      */
-    setQuillRef(ref_str) {
+    apply(doc) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(ref_str, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-            const len0 = WASM_VECTOR_LEN;
-            wasm.document_setQuillRef(retptr, this.__wbg_ptr, ptr0, len0);
+            _assertClass(doc, Document);
+            wasm.livesession_apply(retptr, this.__wbg_ptr, doc.__wbg_ptr);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            if (r1) {
-                throw takeObject(r0);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             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
+     * The backend that produced this session (e.g. `"typst"`).
+     * @returns {string}
      */
-    setSeedNamespace(card_kind, overlay) {
+    get backendId() {
+        let deferred1_0;
+        let deferred1_1;
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(card_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            wasm.livesession_backendId(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * The schema field whose content is under a point on `page` — the
+     * forward (click → field) direction: hit-test a click against the
+     * compiled document and get back the field address to focus in the
+     * editor, or `undefined` off any field's ink. `x`/`y` are PDF points
+     * with a **bottom-left** origin, the same space as `FieldRegion.rect` —
+     * from a canvas click, invert the overlay transform documented on
+     * `FieldRegion`: `x = clickPx.x / renderScale`,
+     * `y = pageHeightPt - clickPx.y / renderScale`. Unlike `regions()`,
+     * *every* placement answers, not just the first.
+     * @param {number} page
+     * @param {number} x
+     * @param {number} y
+     * @returns {string | undefined}
+     */
+    fieldAt(page, x, y) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.livesession_fieldAt(retptr, this.__wbg_ptr, page, x, y);
+            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 whole-field highlight boxes for `field` — one union rect per page,
+     * over the field's `span`-bearing content segments. The convenience that
+     * owns the union `regions()` leaves derived: it keeps `regions()` the
+     * low-level disjoint truth (#829) and folds the span-filter + per-page
+     * union here, so a "highlight the focused field" consumer stops
+     * reimplementing it. **Content only** — a field placed solely as a scalar
+     * reference or a bound widget carries no `span` and returns `[]`; its box
+     * is a single `regions()` rect. Reflects the current compile, like
+     * `regions()`.
+     * @param {string} field
+     * @returns {FieldRegion[]}
+     */
+    fieldBoxes(field) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(field, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_setSeedNamespace(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(overlay));
+            wasm.livesession_fieldBoxes(retptr, this.__wbg_ptr, ptr0, len0);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            if (r1) {
-                throw takeObject(r0);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
-     * Serialize this document to a versioned storage DTO string.
-     *
-     * Prefer this over `toMarkdown` for persistence across restarts or crate
-     * upgrades — the wire format is frozen per `schema` version. Parse-time
-     * `warnings` are excluded from the DTO.
-     *
-     * Output is **byte-deterministic** within a `schema` version: equal
-     * documents produce byte-equal output, safe for content-hash use cases.
-     * @returns {string}
+     * A content position → **caret rect** — the reverse of `positionAt`: given
+     * a field and a USV offset into its `Content`, return the box (in the
+     * same bottom-left PDF-point space as `FieldRegion.rect`) to draw a caret
+     * at, its `span` collapsed to `[pos, pos]`; `undefined` when the field
+     * places no tracked content or the offset maps to no drawn glyph.
+     * @param {string} field
+     * @param {number} pos
+     * @returns {FieldRegion | undefined}
+     */
+    locate(field, pos) {
+        const ptr0 = passStringToWasm0(field, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.livesession_locate(this.__wbg_ptr, ptr0, len0, pos);
+        return takeObject(ret);
+    }
+    /**
+     * @returns {number}
+     */
+    get pageCount() {
+        const ret = wasm.livesession_pageCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * Page dimensions in points (1 pt = 1/72 inch).
+     * Throws if the backend has no canvas painter or `page` is out of range.
+     * @param {number} page
+     * @returns {PageSize}
      */
-    toJson() {
-        let deferred1_0;
-        let deferred1_1;
+    pageSize(page) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_toJson(retptr, this.__wbg_ptr);
+            wasm.livesession_pageSize(retptr, this.__wbg_ptr, page);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            deferred1_0 = r0;
-            deferred1_1 = r1;
-            return getStringFromWasm0(r0, r1);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
-            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
     /**
-     * Emit canonical Quillmark Markdown. Round-trip safe: re-parsing the
-     * result produces a `Document` equal to `self` by value and by type.
-     * @returns {string}
+     * Paint `page` into a `CanvasRenderingContext2D` or
+     * `OffscreenCanvasRenderingContext2D`. The painter owns
+     * `canvas.width`/`height` (no `clearRect` needed); consumers own
+     * `canvas.style.*`. If `layoutScale * densityScale` exceeds 16384 px
+     * per side, `densityScale` is clamped — `PaintResult.clamped` reports it and
+     * `PaintResult.effectiveDensityScale` carries the density actually applied.
+     *
+     * `put_image_data` writes the whole backing store, bypassing the 2D
+     * context's transform, `globalAlpha`, and clip: the painter owns the entire
+     * canvas, so each visible page needs its own `` — you cannot composite
+     * two pages, a sub-rect, or a context transform through this call.
+     *
+     * Throws if the backend has no canvas painter, `page` is out of range,
+     * `ctx` is the wrong type, or either scale is non-finite or `<= 0`.
+     * @param {CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D} ctx
+     * @param {number} page
+     * @param {PaintOptions | undefined} opts
+     * @returns {PaintResult}
      */
-    toMarkdown() {
-        let deferred1_0;
-        let deferred1_1;
+    paint(ctx, page, opts) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_toMarkdown(retptr, this.__wbg_ptr);
+            wasm.livesession_paint(retptr, this.__wbg_ptr, addHeapObject(ctx), page, addHeapObject(opts));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            deferred1_0 = r0;
-            deferred1_1 = r1;
-            return getStringFromWasm0(r0, r1);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
-            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
     /**
-     * Like [`fromJson`](Document::from_json) but returns `undefined` instead
-     * of throwing when `json` is not a valid storage DTO — use to
-     * discriminate format without exceptions as control flow.
-     * `undefined` means "not a storage DTO"; `fromMarkdown` still throws on
-     * genuinely malformed markdown.
-     * @param {string} json
-     * @returns {Document | undefined}
+     * A point → **content position** — the fine-grained click direction:
+     * hit-test a point and get back the field *and* a USV offset into its
+     * `Content` (for placing a caret or mapping a selection into the content
+     * model), or `undefined` off all content ink. `x`/`y` are PDF points,
+     * bottom-left origin — the same space as `fieldAt`. The offset is
+     * cluster-exact and degrades to the containing segment's start on
+     * origin-less ink (list markers, a code fence's interior). See
+     * `ContentHit`.
+     * @param {number} page
+     * @param {number} x
+     * @param {number} y
+     * @returns {ContentHit | undefined}
      */
-    static tryFromJson(json) {
-        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.document_tryFromJson(ptr0, len0);
-        return ret === 0 ? undefined : Document.__wrap(ret);
+    positionAt(page, x, y) {
+        const ret = wasm.livesession_positionAt(this.__wbg_ptr, page, x, y);
+        return takeObject(ret);
     }
     /**
-     * Replace the body of the card at `index`. Throws if out of range.
-     * @param {number} index
-     * @param {string} body
+     * Schema-field geometry for this compiled session — each content field's
+     * **first placement** (one region per page it touches) plus widget and
+     * scalar-reference-site regions, keyed on the quill schema field path; a
+     * field may still appear more than once (group by `field`, see
+     * `FieldRegion`). A session-level query: no render, no byte artifact. An
+     * interactive preview reads it to scroll to / highlight the focused
+     * field over a `paint`-ed canvas; the click direction is `fieldAt`.
+     * Empty for backends that place no schema fields.
+     * @returns {FieldRegion[]}
      */
-    updateCardBody(index, body) {
+    regions() {
         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_updateCardBody(retptr, this.__wbg_ptr, index, ptr0, len0);
+            wasm.livesession_regions(retptr, this.__wbg_ptr);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            if (r1) {
-                throw takeObject(r0);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
-     * Update a field on the card at `index`.
-     * Throws if `index` is out of range, `name` is reserved or invalid.
-     * @param {number} index
-     * @param {string} name
-     * @param {any} value
+     * @param {RenderOptions | null} [opts]
+     * @returns {RenderResult}
      */
-    updateCardField(index, name, value) {
+    render(opts) {
         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_updateCardField(retptr, this.__wbg_ptr, index, ptr0, len0, addHeapObject(value));
+            wasm.livesession_render(retptr, this.__wbg_ptr, isLikeNone(opts) ? 0 : addHeapObject(opts));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            if (r1) {
-                throw takeObject(r0);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
+     * `true` iff `paint` and `pageSize` will succeed for this session. Derived
+     * from the session's canvas seam, so it reflects exactly what `paint` will
+     * do — no separately captured flag.
+     * @returns {boolean}
+     */
+    get supportsCanvas() {
+        const ret = wasm.livesession_supportsCanvas(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Non-fatal diagnostics of the session's **current compile** (e.g. Typst
+     * font fallback) — set at open and refreshed by each committed `apply`;
+     * a failed apply keeps the last-good compile's warnings. Also appended
+     * to `RenderResult.warnings` on each `render()` call.
      * @returns {Diagnostic[]}
      */
     get warnings() {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.document_warnings(retptr, this.__wbg_ptr);
+            wasm.livesession_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);
@@ -892,7 +1577,7 @@ export class Document {
         }
     }
 }
-if (Symbol.dispose) Document.prototype[Symbol.dispose] = Document.prototype.free;
+if (Symbol.dispose) LiveSession.prototype[Symbol.dispose] = LiveSession.prototype.free;
 
 export class Quill {
     static __wrap(ptr) {
@@ -1003,9 +1688,10 @@ export class Quill {
     }
     /**
      * Document schema for the quill: the user-fillable fields plus their
-     * `ui` hints (group / order / showWhen). The single field-metadata
-     * surface — drives form editors and LLM/MCP consumers alike. Returns the
-     * `QuillSchema` shape.
+     * `ui` hints (title / group / compact / multiline). The single
+     * field-metadata surface — drives form editors and LLM/MCP consumers
+     * alike. Key order in `fields`/`properties` is declaration order — the
+     * ordering contract. Returns the `QuillSchema` shape.
      * @returns {QuillSchema}
      */
     get schema() {
@@ -1028,9 +1714,9 @@ export class Quill {
      * 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`.
+     * straight into `Document.insertCard`.
      *
-     * Pass `document.main.seed?.[cardKind]` as `overlay` so a card added to a
+     * Pass `document.seedOverlay(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.
@@ -1113,10 +1799,10 @@ export class Quill {
      *
      * Forwards the canonical `validation::*` diagnostics — same `code`,
      * `path`, and `hint` the engine emits — including the non-fatal
-     * `validation::field_absent` completeness signal that `render` demotes.
-     * Field values, defaults, and order are not part of this surface: read
-     * them from the `Document` payload and `Quill.schema` (fields carry
-     * `ui.order`).
+     * `validation::must_fill` warning for each `!must_fill` marker left in
+     * the document. Field values, defaults, and order are not part of this
+     * surface: read them from the `Document` payload and `Quill.schema`
+     * (schema key order is display order).
      * @param {Document} doc
      * @returns {Diagnostic[]}
      */
@@ -1161,10 +1847,10 @@ export class Quillmark {
         return this;
     }
     /**
-     * Open an iterative render session for `doc` against `quill`'s backend.
+     * Open a live render session for `doc` against `quill`'s backend.
      * @param {Quill} quill
      * @param {Document} doc
-     * @returns {RenderSession}
+     * @returns {LiveSession}
      */
     open(quill, doc) {
         try {
@@ -1178,14 +1864,14 @@ export class Quillmark {
             if (r2) {
                 throw takeObject(r1);
             }
-            return RenderSession.__wrap(r0);
+            return LiveSession.__wrap(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
      * Render `doc` against `quill` in one shot. Convenience over `open` +
-     * `RenderSession.render`: an unset `output_format` falls back to the
+     * `LiveSession.render`: an unset `output_format` falls back to the
      * backend's first supported format.
      * @param {Quill} quill
      * @param {Document} doc
@@ -1211,7 +1897,7 @@ export class Quillmark {
     }
     /**
      * The output formats `quill`'s backend can emit. Static capability —
-     * resolves the backend but compiles nothing. Throws `UnsupportedBackend`
+     * resolves the backend but compiles nothing. Throws `engine::backend_not_found`
      * if no registered backend matches the quill's declared backend.
      * @param {Quill} quill
      * @returns {OutputFormat[]}
@@ -1233,9 +1919,11 @@ export class Quillmark {
         }
     }
     /**
-     * `true` iff `quill`'s backend can paint sessions to a canvas. Asked of
-     * the real backend; `false` when the backend is unsupported or non-canvas.
-     * Use as a precondition probe before mounting a canvas-based preview UI.
+     * Pre-session hint: `true` iff `quill`'s backend can paint sessions to a
+     * canvas, derived from the backend's output formats; `false` when the
+     * backend is unsupported. Use as a cheap precondition probe before mounting
+     * a canvas-based preview UI; the authoritative answer is the session's
+     * `supportsCanvas` getter once `open()` has been called.
      * @param {Quill} quill
      * @returns {boolean}
      */
@@ -1248,158 +1936,62 @@ export class Quillmark {
 if (Symbol.dispose) Quillmark.prototype[Symbol.dispose] = Quillmark.prototype.free;
 
 /**
- * Iterative render handle backed by an immutable compiled snapshot.
- *
- * **Empty documents.** A zero-page document yields a valid session
- * (`pageCount === 0`); `paint(ctx, 0)` or `pageSize(0)` throws with
- * `"page index 0 out of range (pageCount=0)"`. Branch on `pageCount === 0`
- * rather than catching the error.
+ * Export a canonical `Content` content to its markdown projection — the pure
+ * on-demand codec behind `exportMarkdown(card.body)`. Throws if `rt` is not a
+ * canonical content.
+ * @param {Content} rt
+ * @returns {string}
  */
-export class RenderSession {
-    static __wrap(ptr) {
-        ptr = ptr >>> 0;
-        const obj = Object.create(RenderSession.prototype);
-        obj.__wbg_ptr = ptr;
-        RenderSessionFinalization.register(obj, obj.__wbg_ptr, obj);
-        return obj;
-    }
-    __destroy_into_raw() {
-        const ptr = this.__wbg_ptr;
-        this.__wbg_ptr = 0;
-        RenderSessionFinalization.unregister(this);
-        return ptr;
-    }
-    free() {
-        const ptr = this.__destroy_into_raw();
-        wasm.__wbg_rendersession_free(ptr, 0);
-    }
-    /**
-     * The backend that produced this session (e.g. `"typst"`).
-     * @returns {string}
-     */
-    get backendId() {
-        let deferred1_0;
-        let deferred1_1;
-        try {
-            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.rendersession_backendId(retptr, this.__wbg_ptr);
-            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            deferred1_0 = r0;
-            deferred1_1 = r1;
-            return getStringFromWasm0(r0, r1);
-        } finally {
-            wasm.__wbindgen_add_to_stack_pointer(16);
-            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
-        }
-    }
-    /**
-     * @returns {number}
-     */
-    get pageCount() {
-        const ret = wasm.rendersession_pageCount(this.__wbg_ptr);
-        return ret >>> 0;
-    }
-    /**
-     * Page dimensions in Typst points (1 pt = 1/72 inch).
-     * Throws if the backend has no canvas painter or `page` is out of range.
-     * @param {number} page
-     * @returns {PageSize}
-     */
-    pageSize(page) {
-        try {
-            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.rendersession_pageSize(retptr, this.__wbg_ptr, page);
-            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);
-        }
-    }
-    /**
-     * Paint `page` into a `CanvasRenderingContext2D` or
-     * `OffscreenCanvasRenderingContext2D`. The painter owns
-     * `canvas.width`/`height` (no `clearRect` needed); consumers own
-     * `canvas.style.*`. If `layoutScale * densityScale` exceeds 16384 px
-     * per side, `densityScale` is clamped — detect via `PaintResult.pixelWidth`.
-     *
-     * Throws if the backend has no canvas painter, `page` is out of range,
-     * `ctx` is the wrong type, or either scale is non-finite or `<= 0`.
-     * @param {CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D} ctx
-     * @param {number} page
-     * @param {PaintOptions | undefined} opts
-     * @returns {PaintResult}
-     */
-    paint(ctx, page, opts) {
-        try {
-            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.rendersession_paint(retptr, this.__wbg_ptr, addHeapObject(ctx), page, addHeapObject(opts));
-            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 {RenderOptions | null} [opts]
-     * @returns {RenderResult}
-     */
-    render(opts) {
-        try {
-            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.rendersession_render(retptr, this.__wbg_ptr, isLikeNone(opts) ? 0 : addHeapObject(opts));
-            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);
+export function exportMarkdown(rt) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.exportMarkdown(retptr, addHeapObject(rt));
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr1 = r0;
+        var len1 = r1;
+        if (r3) {
+            ptr1 = 0; len1 = 0;
+            throw takeObject(r2);
         }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
     }
-    /**
-     * `true` iff `paint` and `pageSize` will succeed for this session. The
-     * backend's canvas capability, captured at open time.
-     * @returns {boolean}
-     */
-    get supportsCanvas() {
-        const ret = wasm.rendersession_supportsCanvas(this.__wbg_ptr);
-        return ret !== 0;
-    }
-    /**
-     * Non-fatal diagnostics emitted when opening the session. Also appended
-     * to `RenderResult.warnings` on each `render()` call.
-     * @returns {Diagnostic[]}
-     */
-    get warnings() {
-        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);
+}
+
+/**
+ * Import a markdown string to a canonical `Content` content — the pure,
+ * document-free codec. Pair with `install(addr, importMarkdown(md))` to spell
+ * the cold (anchor-losing) write at the call site; prefer `revise` for edit
+ * semantics. Throws on an over-nested input.
+ * @param {string} markdown
+ * @returns {Content}
+ */
+export function importMarkdown(markdown) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.importMarkdown(retptr, 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);
     }
 }
-if (Symbol.dispose) RenderSession.prototype[Symbol.dispose] = RenderSession.prototype.free;
 
 /**
  * Initialize the WASM module with panic hooks for better error messages
@@ -1407,10 +1999,68 @@ if (Symbol.dispose) RenderSession.prototype[Symbol.dispose] = RenderSession.prot
 export function init() {
     wasm.init();
 }
+
+/**
+ * Map a base content position through a `delta` to its new position — the pure
+ * position-mapping codec an editor bridge composes to hold a caret stable
+ * across a `revise`. `assoc` decides the side of a same-position insertion
+ * (`"after"` moves past it). Throws on a malformed `delta`.
+ * @param {Delta} delta
+ * @param {number} pos
+ * @param {Assoc} assoc
+ * @returns {number}
+ */
+export function mapPos(delta, pos, assoc) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.mapPos(retptr, addHeapObject(delta), pos, addHeapObject(assoc));
+        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 r0 >>> 0;
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
+/**
+ * Rebase `markdown` onto a `base` content — the pure, document-free twin of
+ * `revise`: cold-import + `diff_import`, returning the new `content` and the
+ * text `delta` (surviving anchors rebased). Use it to compute a revise without
+ * a document in hand; `revise(addr, md)` fuses this with the store for
+ * atomicity. Throws on an over-nested markdown input or a non-content `base`.
+ * @param {Content} base
+ * @param {string} markdown
+ * @returns {{ content: Content; delta: Delta }}
+ */
+export function rebase(base, markdown) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.rebase(retptr, addHeapObject(base), 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);
+    }
+}
 export function __wbg_Error_960c155d3d49e4c2(arg0, arg1) {
     const ret = Error(getStringFromWasm0(arg0, arg1));
     return addHeapObject(ret);
 }
+export function __wbg_Number_32bf70a599af1d4b(arg0) {
+    const ret = Number(getObject(arg0));
+    return ret;
+}
 export function __wbg_String_8564e559799eccda(arg0, arg1) {
     const ret = String(getObject(arg1));
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
@@ -1795,15 +2445,15 @@ export function __wbindgen_object_drop_ref(arg0) {
 const DocumentFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_document_free(ptr >>> 0, 1));
+const LiveSessionFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_livesession_free(ptr >>> 0, 1));
 const QuillFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_quill_free(ptr >>> 0, 1));
 const QuillmarkFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_quillmark_free(ptr >>> 0, 1));
-const RenderSessionFinalization = (typeof FinalizationRegistry === 'undefined')
-    ? { register: () => {}, unregister: () => {} }
-    : new FinalizationRegistry(ptr => wasm.__wbg_rendersession_free(ptr >>> 0, 1));
 
 function addHeapObject(obj) {
     if (heap_next === heap.length) heap.push(heap.length + 1);