@quillmark/wasm 0.98.0 → 0.100.0

package/core/wasm_bg.js

@@ -21,7 +21,7 @@ export class Document {
     }
     /**
      * 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`.
+     * 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 +
@@ -58,7 +58,7 @@ export class Document {
     }
     /**
      * 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`.
+     * `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
@@ -69,10 +69,10 @@ export class Document {
      *
      * 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`
+     * 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
-     * `edit::unknown_field` rather than falling to the opaque store — on
+     * `edit::unknown_field` 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 `edit::field_conform` /
      * `edit::field_richtext_decode` / `edit::field_richtext_not_inline`
@@ -105,7 +105,7 @@ export class Document {
      * 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
+     * [`storeFields`](Document::store_fields): nothing is applied on error and
      * the thrown error's `diagnostics` carry one entry per offending field,
      * including an `edit::unknown_field` for any name the schema does not
      * declare, so a whole-form submit sees every typo in one pass. Throws on an
@@ -130,7 +130,7 @@ export class Document {
     }
     /**
      * Interpreted read at `addr`, resolving the field's declared `type` from
-     * `quill` — the stable ABI under the runtime `reader.get` / `reader.card(i).get`.
+     * `quill`: the stable ABI under the runtime `reader.get` / `reader.card(i).get`.
      * The schema-plane twin of the quill-free [`getStored`](Self::get_stored): a `richtext`
      * field returns its markdown projection, every other declared type its
      * canonical value verbatim, so a consumer holding the quill reads by field
@@ -139,10 +139,10 @@ export class Document {
      * 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
+     * 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 `edit::unknown_field` (the authority `getMarkdown`
-     * lacks — there an unknown name reads back `undefined`); a `richtext` field
+     * lacks: there an unknown name reads back `undefined`); a `richtext` field
      * holding a value that does not decode throws `edit::field_richtext_decode`;
      * an out-of-range `addr.card` throws.
      *
@@ -169,8 +169,49 @@ export class Document {
         }
     }
     /**
-     * Revise the richtext field at `addr` from markdown, typed *and*
-     * anchor-preserving — the ABI under `writer.reviseField`. Resolves the
+     * Interpreted **corpus** read at `addr`: the stable ABI under the runtime
+     * `reader.getContent` / `reader.card(i).getContent`. The corpus twin of
+     * [`reader.get`](Self::reader_get), which projects; this decodes the stored
+     * value through the codec the field's declared type names (`richtext` as
+     * markdown, `plaintext` as literal text) and returns the canonical `Content`.
+     *
+     * Total over the storage form: a committed field holds a content object and
+     * a parsed one holds the authored string, and both read back as a corpus
+     * here, so a consumer mounting a corpus editor stops branching on how the
+     * document was built.
+     *
+     * A bare string is `Addr` shorthand for `{ field }`; `{ card, field }`
+     * targets a composable card. Returns `undefined` for an **absent** field. An
+     * absent `addr.field` reads the **body** corpus, quill-free, mirroring
+     * [`getStored`](Self::get_stored). Throws `edit::unknown_field` for a name
+     * the schema does not declare, `edit::field_not_content` for a declared type
+     * that is not a content leaf (`array<richtext>` carries content and still has
+     * no one corpus), `edit::field_richtext_decode` for a stored value
+     * that decodes under neither encoding, and `edit::index_out_of_range` for a
+     * bad `addr.card`.
+     * @param {Quill} quill
+     * @param {Addr | string} addr
+     * @returns {Content | undefined}
+     */
+    _readerGetContent(quill, addr) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(quill, Quill);
+            wasm.document__readerGetContent(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);
+        }
+    }
+    /**
+     * Revise the content field at `addr` from authored text, 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
@@ -178,21 +219,24 @@ export class Document {
      * multi-block result with `edit::field_richtext_not_inline`. Returns the
      * text `Delta`.
      *
+     * The codec is the declared type's: `richtext` diffs markdown, `plaintext`
+     * the literal text.
+     *
      * `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
+     * throws (a body carries no field schema: use [`revise`](Self::revise)). A
      * name the schema does not declare throws `edit::unknown_field`. 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
+     * @param {string} text
      * @returns {Delta}
      */
-    _reviseField(quill, addr, markdown) {
+    _reviseField(quill, addr, text) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             _assertClass(quill, Quill);
-            const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(text, 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);
@@ -208,7 +252,7 @@ export class Document {
     }
     /**
      * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
-     * at `addr` — the editor splice: text delta first, then line ops, then mark
+     * 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.
      *
@@ -258,7 +302,7 @@ export class Document {
         }
     }
     /**
-     * A single composable card by index — the whole `Card`, the card-indexed
+     * 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 `edit::index_out_of_range`, matching the card write
@@ -289,20 +333,6 @@ export class Document {
         const ret = wasm.document_cardCount(this.__wbg_ptr);
         return ret >>> 0;
     }
-    /**
-     * The index of the composable card whose `$id` equals `id`, or
-     * `undefined` when none carries it. Resolves the durable card handle
-     * without a hand-rolled scan over [`cards`](Self::cards); `$id` is
-     * unique per document, so at most one card matches.
-     * @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[]}
      */
@@ -459,7 +489,7 @@ export class Document {
     }
     /**
      * The whole `$ext` map at `addr` (a card address, absent `card` = main), or
-     * `undefined` when the card carries none. The fine-grained `$ext` read —
+     * `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]
@@ -482,7 +512,7 @@ export class Document {
     }
     /**
      * The value stored under `$ext[ns]` at `addr` (a card address, absent `card`
-     * = main), or `undefined`. The namespace-scoped `$ext` read — your own slot
+     * = 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
@@ -507,15 +537,15 @@ export class Document {
         }
     }
     /**
-     * The **body** markdown projection — the main body, or a composable card's
-     * body (`{ card }`) — the on-demand, lossy export (content-only marks do not
+     * 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
+     * present `field` throws: a field's markdown is read through the
      * schema-plane `quill.reader(doc).get(field)`, which interprets by declared
-     * type (#978). An out-of-range `addr.card` throws.
+     * type. An out-of-range `addr.card` throws.
      * @param {CardAddr} [addr]
      * @returns {string}
      */
@@ -535,16 +565,25 @@ export class Document {
         }
     }
     /**
-     * Read the **verbatim stored value** at `addr` — the raw 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
+     * Read the **verbatim stored value** at `addr`: the raw payload value of a
+     * field, 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 `edit::index_out_of_range`. Needs no schema, so it lives on
-     * `Document` — the read echo of the verbatim `store*` write, distinct from
+     * `Document`: the read echo of the verbatim `store*` write, distinct from
      * the interpreted schema-plane [`reader.get`](Self::reader_get). For the
      * markdown projection use [`getMarkdown`](Self::get_markdown) (body) or
      * `reader.get` (a field's declared type).
+     *
+     * **A content field at rest has one stored form per codec**: a `richtext`
+     * field holds the canonical content object, a `plaintext` field its literal
+     * string. A document that came through the bound door (`quill.parse` /
+     * `quill.conform`) is at rest, so this read no longer depends on which lane
+     * built it. A document that came through the transport door
+     * (`Document.fromMarkdown`, a legacy stored row) may rest as authored until
+     * it is conformed, and this read reports what is there. For the corpus
+     * either way, use the schema-plane `reader.getContent`, which decodes
+     * through the codec the field's declared type names.
      * @param {Addr | string} addr
      * @returns {unknown}
      */
@@ -564,9 +603,9 @@ export class Document {
         }
     }
     /**
-     * Insert a card — the single insertion verb: `at` absent appends, a number
+     * 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`),
+     * `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.
@@ -587,7 +626,7 @@ export class Document {
         }
     }
     /**
-     * **Install** a richtext value at `addr` — **value semantics**, content only.
+     * **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
@@ -615,7 +654,7 @@ export class Document {
     }
     /**
      * 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
+     * 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
@@ -638,13 +677,13 @@ export class Document {
     }
     /**
      * Replace this document's contents **in place** from a versioned storage
-     * DTO string — the mutating twin of the static
+     * 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
+     * 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
      */
@@ -665,7 +704,7 @@ export class Document {
     }
     /**
      * The document's main (entry) card. Allocates and serializes on each
-     * call — cache locally if read in a hot loop.
+     * call: cache locally if read in a hot loop.
      * @returns {Card}
      */
     get main() {
@@ -684,7 +723,7 @@ export class Document {
         }
     }
     /**
-     * Build a fresh `Card` from a kind and a flat field map — the ergonomic
+     * Build a fresh `Card` from a kind and a flat field map: the ergonomic
      * constructor for `insertCard`. `fields` is an optional
      * `Record<string, unknown>` (each entry becomes a card field, in
      * insertion order); `body` defaults to `""`.
@@ -694,8 +733,8 @@ export class Document {
      * here.
      *
      * Checks only what a detached card can decide alone: field-name grammar
-     * and value depth. Kind validity is positional — `main` is right for the
-     * root, reserved for a composable card — so `insertCard` is its gate, and
+     * and value depth. Kind validity is positional (`main` is right for the
+     * root, reserved for a composable card) so `insertCard` is its gate, and
      * any kind string is accepted here.
      * @param {string} kind
      * @param {Record<string, unknown>} [fields]
@@ -740,7 +779,7 @@ export class Document {
         }
     }
     /**
-     * `new Document(quillRef)` — a blank document: a main card carrying only
+     * `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
@@ -789,7 +828,7 @@ export class Document {
     /**
      * 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
+     * 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}
@@ -831,7 +870,7 @@ export class Document {
     }
     /**
      * Remove the `$ext` map on the card `addr` targets *entirely*, returning the
-     * previous map or `undefined` — a blunt escape hatch that discards every
+     * 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]
@@ -926,7 +965,7 @@ export class Document {
         }
     }
     /**
-     * **Revise** the richtext value at `addr` from a markdown string — **edit
+     * **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
@@ -958,7 +997,7 @@ export class Document {
     }
     /**
      * Read the `schema` version tag from a raw storage DTO string without a
-     * full parse, or `undefined`. Returns unknown future versions as-is —
+     * 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
@@ -986,7 +1025,7 @@ export class Document {
      * 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`
+     * 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}
@@ -1053,7 +1092,7 @@ export class Document {
      * 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
+     * `{}` 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
@@ -1073,8 +1112,8 @@ export class Document {
     }
     /**
      * 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.
+     * 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
@@ -1096,12 +1135,12 @@ export class Document {
         }
     }
     /**
-     * Store a field verbatim at `addr` — the opaque store (**store** = verbatim,
+     * 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
+     * `!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
@@ -1121,12 +1160,12 @@ export class Document {
         }
     }
     /**
-     * Store several fields verbatim and atomically on the card `addr` targets —
+     * 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`".
+     * 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
@@ -1146,7 +1185,7 @@ export class Document {
         }
     }
     /**
-     * Store a field verbatim at `addr` and mark it `!must_fill` — the opaque
+     * 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).
@@ -1168,9 +1207,9 @@ export class Document {
     }
     /**
      * Merge a card-kind's seed `overlay` into the **main** card's `$seed` map
-     * under `cardKind`, preserving sibling kinds — `$seed` lives on the main
+     * 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`
+     * 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
@@ -1194,7 +1233,7 @@ export class Document {
      * 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
+     * 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
@@ -1240,7 +1279,7 @@ export class Document {
     }
     /**
      * Like [`fromJson`](Document::from_json) but returns `undefined` instead
-     * of throwing when `json` is not a valid storage DTO — use to
+     * 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.
@@ -1254,6 +1293,10 @@ export class Document {
         return ret === 0 ? undefined : Document.__wrap(ret);
     }
     /**
+     * The non-fatal diagnostics of the load that produced this document: parse
+     * warnings, plus the `conform::*` warnings when it came through
+     * `quill.parse`. Session state, not document value: `equals` and the
+     * storage DTO exclude it, and `fromJson` / `loadJson` clear it.
      * @returns {Diagnostic[]}
      */
     get warnings() {
@@ -1294,7 +1337,7 @@ export class Quill {
     }
     /**
      * The *declared* backend identifier (`config.backend`, e.g. `"typst"`).
-     * Intent, not a resolved capability — capability (`supportedFormats` /
+     * Intent, not a resolved capability: capability (`supportedFormats` /
      * `supportsCanvas`) is read from the engine.
      * @returns {string}
      */
@@ -1334,7 +1377,41 @@ export class Quill {
         }
     }
     /**
-     * Build a quill from a file tree. Pure — no backend, no engine; the
+     * Land `doc`'s declared content fields at their canonical rest **in
+     * place**, returning the `conform::*` diagnostics for the values that would
+     * not commit (an empty array when everything rested).
+     *
+     * The read-repair verb: a document that arrived through the transport door
+     * (`fromMarkdown`, `fromJson`, a stored row) converges here, and is then
+     * eligible for rewrite under its current schema tag. Idempotent, and a
+     * no-op on an already-canonical document: an equal value is not rewritten,
+     * so YAML comments and stored bytes survive.
+     *
+     * A `!must_fill` marker anywhere in a field's value skips that field (the
+     * marker is the state), and a value the strict write refuses stays as
+     * authored with a diagnostic. Throws when `doc` declares a different
+     * `$quill`, before any mutation.
+     * @param {Document} doc
+     * @returns {Diagnostic[]}
+     */
+    conform(doc) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(doc, Document);
+            wasm.quill_conform(retptr, this.__wbg_ptr, doc.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Build a quill from a file tree. Pure: no backend, no engine; the
      * declared backend is resolved later, at render time.
      *
      * Accepts either a `Map<string, Uint8Array>` or a plain object
@@ -1361,7 +1438,7 @@ export class Quill {
     }
     /**
      * Identity snapshot of the `quill:` section of `Quill.yaml` plus any extra
-     * `quill:` keys. Pure config — the backend's output formats are a
+     * `quill:` keys. Pure config: the backend's output formats are a
      * resolved-backend capability read from the engine
      * (`Quillmark.supportedFormats`), not part of this snapshot.
      * @returns {QuillMetadata}
@@ -1382,11 +1459,44 @@ export class Quill {
         }
     }
     /**
-     * The resolved-value view of `doc` against this quill's schema — for every
+     * Parse `markdown` and conform it against this quill: the **primary
+     * ingestion path**, and the bound twin of the schema-free
+     * `Document.fromMarkdown`. The returned document rests at its canonical
+     * form (a `richtext` field as a content object, a `plaintext` field as its
+     * literal string), so `getStored` no longer answers "corpus or string?"
+     * with "depends how this document was built".
+     *
+     * Parse warnings and the `conform::*` diagnostics both land on
+     * `doc.warnings`. Throws on a parse failure, or when `markdown` declares a
+     * `$quill` this quill does not answer to: nothing conforms under the wrong
+     * schema. To open a document whose `$quill` is stale, use the transport
+     * door (`Document.fromMarkdown`, `setQuillRef`, then `quill.conform`).
+     * @param {string} markdown
+     * @returns {Document}
+     */
+    parse(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.quill_parse(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 Document.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * The resolved-value view of `doc` against this quill's schema: for every
      * declared field the value the render projection would use and the
      * `FieldSource` rung it came from (`"authored" | "default" | "zero"`), in
      * one call. The card body is a `body` sibling on its card (row `name`
-     * `"body"`), never a row in `fields` — `null` when the kind enables no body.
+     * `"body"`), never a row in `fields`: `null` when the kind enables no body.
      *
      * Value and provenance only: completeness and errors stay `validate`'s
      * (a consumer merges it with its own diagnostic producers regardless), and
@@ -1413,8 +1523,8 @@ export class Quill {
     /**
      * Document schema for the quill: the user-fillable fields plus their
      * `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
+     * 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}
      */
@@ -1443,7 +1553,7 @@ export class Quill {
      * 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.
+     * plain object: this reads the document, it does not mutate it.
      * @param {string} card_kind
      * @param {Record<string, unknown> | undefined} overlay
      * @returns {Card | undefined}
@@ -1466,7 +1576,7 @@ export class Quill {
         }
     }
     /**
-     * Seed a starter `Document` from the schema — the main card plus one
+     * Seed a starter `Document` from the schema, the main card plus one
      * instance of each composable card kind, each committing its fields'
      * `example:` values and leaving every other field absent (interpolated at
      * render: `default:`, else type-empty zero). Illustration-first: a field
@@ -1479,7 +1589,7 @@ export class Quill {
         return Document.__wrap(ret);
     }
     /**
-     * Seed a starter main `Card` (carries `$quill`) from the schema — the
+     * Seed a starter main `Card` (carries `$quill`) from the schema: the
      * `$kind: main` card of [`seedDocument`](Self::seed_document) in
      * isolation, committing each field's `example:` value. Returns the same
      * `Card` shape as the `Document.main` getter.
@@ -1501,7 +1611,7 @@ export class Quill {
         }
     }
     /**
-     * Flatten this quill back into its canonical file tree — the inverse of
+     * Flatten this quill back into its canonical file tree: the inverse of
      * [`fromTree`](Self::from_tree). Round-trips: `Quill.fromTree(q.toTree())`
      * reproduces an equivalent quill.
      *
@@ -1521,8 +1631,8 @@ export class Quill {
      * Validate `doc` against this quill's schema, returning every diagnostic
      * (an empty array when the document is valid).
      *
-     * Forwards the canonical `validation::*` diagnostics — same `code`,
-     * `path`, and `hint` the engine emits — including the non-fatal
+     * Forwards the canonical `validation::*` diagnostics (same `code`,
+     * `path`, and `hint` the engine emits) including the non-fatal
      * `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`
@@ -1550,7 +1660,7 @@ export class Quill {
 if (Symbol.dispose) Quill.prototype[Symbol.dispose] = Quill.prototype.free;
 
 /**
- * Export a canonical `Content` content to its markdown projection — the pure
+ * 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
@@ -1583,7 +1693,7 @@ export function exportMarkdown(rt) {
 
 /**
  * Serialize structured [`DocPathSeg`] segments back to the canonical path
- * string — the inverse of `parseDocPath`, for a consumer that builds a path
+ * string: the inverse of `parseDocPath`, for a consumer that builds a path
  * rather than reads one. Throws on a segment array the deserializer rejects,
  * and on an empty segment array (symmetric with `parseDocPath("")`, which
  * throws "empty path").
@@ -1616,7 +1726,7 @@ export function formatDocPath(segs) {
 }
 
 /**
- * Import a markdown string to a canonical `Content` content — the pure,
+ * 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.
@@ -1649,8 +1759,8 @@ export function init() {
 }
 
 /**
- * Map a base content position — a USV index into `Content.text`, not a UTF-16
- * offset — through a `delta` to its new USV position: the pure position-mapping
+ * Map a base content position (a USV index into `Content.text`, not a UTF-16
+ * offset) through a `delta` to its new USV 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`.
@@ -1678,7 +1788,7 @@ export function mapPos(delta, pos, assoc) {
 /**
  * Parse a canonical document-model `Diagnostic.path`
  * (`cards.<kind>[<i>].<field>`, `main.body`, `recipients[0].name`) into its
- * structured [`DocPathSeg`] segments — the exported inverse of the engine's
+ * structured [`DocPathSeg`] segments: the exported inverse of the engine's
  * one path serializer, so a consumer routes on segments instead of regexing
  * the string. Throws on a malformed path.
  * @param {string} path
@@ -1703,7 +1813,7 @@ export function parseDocPath(path) {
 }
 
 /**
- * Rebase `markdown` onto a `base` content — the pure, document-free twin of
+ * 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` (its offsets USV indices into `Content.text`, surviving anchors
  * rebased). Use it to compute a revise without a document in hand; `revise(addr,
@@ -1745,13 +1855,6 @@ export function __wbg_String_8564e559799eccda(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg_String_b51de6b05a10845b(arg0, arg1) {
-    const ret = String(getObject(arg1));
-    const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-    const len1 = WASM_VECTOR_LEN;
-    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
-    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
-}
 export function __wbg___wbindgen_bigint_get_as_i64_3d3aba5d616c6a51(arg0, arg1) {
     const v = getObject(arg1);
     const ret = typeof(v) === 'bigint' ? v : undefined;
@@ -1855,9 +1958,6 @@ export function __wbg_from_0dbf29f09e7fb200(arg0) {
     const ret = Array.from(getObject(arg0));
     return addHeapObject(ret);
 }
-export function __wbg_getRandomValues_3f44b700395062e5() { return handleError(function (arg0, arg1) {
-    globalThis.crypto.getRandomValues(getArrayU8FromWasm0(arg0, arg1));
-}, arguments); }
 export function __wbg_get_1affdbdd5573b16a() { return handleError(function (arg0, arg1) {
     const ret = Reflect.get(getObject(arg0), getObject(arg1));
     return addHeapObject(ret);
@@ -1874,10 +1974,6 @@ export function __wbg_get_with_ref_key_6412cf3094599694(arg0, arg1) {
     const ret = getObject(arg0)[getObject(arg1)];
     return addHeapObject(ret);
 }
-export function __wbg_get_with_ref_key_f64427178466f623(arg0, arg1) {
-    const ret = getObject(arg0)[getObject(arg1)];
-    return addHeapObject(ret);
-}
 export function __wbg_instanceof_ArrayBuffer_7c8433c6ed14ffe3(arg0) {
     let result;
     try {
@@ -2006,6 +2102,14 @@ export function __wbg_value_ee3a06f4579184fa(arg0) {
     const ret = getObject(arg0).value;
     return addHeapObject(ret);
 }
+export function __wbg_values_1e6d547ce555ce44(arg0) {
+    const ret = getObject(arg0).values();
+    return addHeapObject(ret);
+}
+export function __wbg_values_301a77363cf6c773(arg0) {
+    const ret = Object.values(getObject(arg0));
+    return addHeapObject(ret);
+}
 export function __wbindgen_cast_0000000000000001(arg0) {
     // Cast intrinsic for `F64 -> Externref`.
     const ret = arg0;