@quillmark/wasm 0.124.0 → 0.125.0

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # Changelog
 
+## v0.125.0 - 2026-10-12
+
+Upgrade path: [0.124 → 0.125](docs/migrations/0.124-to-0.125.md). Every Typst
+plate migrates: the helper is version 0.2.0, imported `as qm`. Stored documents
+load as before, under the same storage tag.
+
+### Regions and the helper
+
+- feat(typst)!: **the helper is a module imported as `qm`, at version 0.2.0**,
+  and every other import fails the render as `typst::helper_import`.
+  `field-region` is `qm.region`, `ink(x).f` and `display(..)` are
+  `qm.ink(x, "f", ..)`, and every other member reads under `qm.`. No
+  dictionary carries `$ink`; `data`, every card and every typed dictionary
+  carry `$path`. (#2157)
+- feat(typst)!: **regions come from three declared producers**: ink the helper
+  generates, a `qm.region` claim and a form widget. A value the plate prints
+  itself, `#data.subject` included, surfaces no region. (#2157)
+- feat(typst)!: **a claim takes the text between its markers that has no
+  source position of its own**, list bullets included, and no header, footer,
+  background, page number, footnote or float it crosses; a claim opened
+  inside one of those takes its ink. `typst::unclosed_field_region` is
+  `typst::unclosed_region`. (#2157, #2163)
+- feat(core,cli,wasm): **`LiveSession::coverage` and `quillmark check
+  --regions` list the filled fields no click reaches**, a printed `0` or
+  `false` included. (#2157, #2160)
+
+### Sections
+
+- feat(core)!: **a card frames its fields in titled panels under
+  `sections:`**, and `ui.group` / `ui.groups` warn `quill::deprecated_groups`.
+  `schema()` still emits `ui.groups`, lists a grouped card's fields in display
+  order, and gives an object alone in its group `ui.layout: flat`. An empty
+  section fails the load. (#2156)
+
+### Validation and typed writes
+
+- feat(core)!: **`Quill::validate` warns `backend::declined_construct`, the
+  render's own diagnostic**, where it warned `validation::declined_construct`,
+  which is gone. (#2147)
+- feat(core,wasm,python)!: **a typed `set` / `setAll` returns the
+  `parse::dropped_construct` of each `richtext` string it writes**, at the
+  string's path, and `addCard` its fields' ahead of its body's. (#2147, #2160)
+- fix(acroform): **a `form@0.1.0` file gets the version message**, not a
+  field-shape error. (#2160)
+
+### Markdown
+
+- fix(core)!: **a backtick line whose info string holds a backtick opens no
+  code fence**, as CommonMark reads it, so a card block under it opens its
+  card. (#2147)
+- fix(content)!: **a newline beside a hard break imports as no space, a line
+  whose content all drops imports as no line, and U+0000 reads as U+FFFD.**
+  Content stored by 0.124 keeps its space. (#2164)
+- fix(content)!: **a raw tag inside a footnote definition warns nothing beside
+  the definition's `footnote`.** (#2160)
+- fix(content): **a replaced line pairs by its word diff whatever its word
+  count.** (#2147)
+
+### Tables
+
+- fix(typst)!: **a placed table aligns its cells as an unplaced one does**
+  under the plate's `table.align` and a vertical `table.cell` rule. (#2147)
+- fix(content)!: **a table's `align`, `widths` or `headless` outside its set
+  rests as written and reads as absent**, where normalization removed it.
+  (#2147)
+- fix(typst): **`keep` holds its run whatever the element registry holds.**
+  (#2147)
+
+### Revise
+
+- refactor(core,wasm)!: **`droppedAnchors` holds `DocumentAnchor`s, `{ id,
+  path, line }`**, matched at the exact address, and an anchor dropped from
+  content stored out of canonical order is named. `DocumentAnchor` exports
+  from the WASM package root. (#2147)
+
+### Rust
+
+- refactor(content)!: **`ImportWarning` is a struct, and
+  `Container::Element` holds a validated `carrier::Element`.** The typed
+  writer's `set` / `set_all` return `Vec<Diagnostic>`, and
+  `SessionHandle::update` takes the session's `QuillConfig`. (#2147)
+
+### CLI and packaging
+
+- feat(typst,cli): **`quillmark --version` names the linked Typst**, 0.15.
+  (#2162)
+- **`@quillmark/wasm` ships a CycloneDX SBOM of its crate graph**, and every
+  CI action is pinned by commit SHA. (#2132)
+
 ## v0.124.0 - 2026-10-10
 
 Upgrade path: [0.123 → 0.124](docs/migrations/0.123-to-0.124.md).

package/README.md

@@ -394,8 +394,8 @@ A document that compiles to zero pages still produces a valid session
 the throw.
 
 Their `warnings` differ in reach. `engine.render` returns every
-`quill.validate(doc)` warning but `validation::declined_construct`, which the
-compile raises as `backend::declined_construct`, then the compile's own;
+`quill.validate(doc)` warning but `backend::declined_construct`, then the
+compile's own, a decline among them;
 `session.render` and `session.warnings` carry the compile's alone, so read
 `quill.validate(doc)` beside them. Neither carries the load's: those stay on
 `doc.warnings`, and a revise's on its receipt.

package/core/wasm.d.ts

@@ -146,7 +146,8 @@ export interface TableCell {
 
 /** `props` of a `type: "table"` island: a pipe table normalized to one column
  * count that `header`, every row of `rows`, `aligns` and `widths` all share.
- * A layout key at its default is absent. */
+ * A layout key at its default is absent; one holding a value outside its type
+ * stays as written and reads as absent. */
 export interface TableProps {
     header: TableCell[];
     rows: TableCell[][];
@@ -154,7 +155,7 @@ export interface TableProps {
     aligns: ("none" | "left" | "center" | "right")[];
     /** Per-column relative weights; `null` is an auto-fit column. Absent when
      * every column is auto-fit. A weight is an integer from 1 to
-     * `Number.MAX_SAFE_INTEGER`; any other entry drops the key. */
+     * `Number.MAX_SAFE_INTEGER`. */
     widths?: (number | null)[];
     /** The table's placement; absent is the quill's. */
     align?: "left" | "center" | "right";
@@ -237,14 +238,14 @@ export interface Revised {
 
 /**
  * The receipt of `writer.reviseDocument`. `droppedAnchors` names every prose
- * anchor the write did not carry, at its path in the stored document; a table
+ * anchor the write did not carry, at its path and line in the stored document; a table
  * cell's anchors drop unnamed. `warnings` are the parse's, then each revised
  * content field's `parse::dropped_construct`, then the writer's `conform::*`.
  * A field that lands rather than revises, on an inserted card or over no stored
  * content, reports no drop.
  */
 export interface DocumentRevised {
-    droppedAnchors: { path: string; id: string }[];
+    droppedAnchors: DocumentAnchor[];
     warnings: Diagnostic[];
 }
 
@@ -258,7 +259,13 @@ export interface DocumentRevised {
  */
 export interface AnnotatedMarkdown {
     markdown: string;
-    anchors: { id: string; path: string; line: string }[];
+    anchors: DocumentAnchor[];
+}
+
+export interface DocumentAnchor {
+    id: string;
+    path: string;
+    line: string;
 }
 
 /**
@@ -439,6 +446,8 @@ export interface Resolved {
 /** UI layout hints for a single field. Display order is not a hint: key order
  * in the schema's `fields`/`properties` objects is the ordering contract. */
 export interface QuillFieldUi {
+    /** The id of the card section holding the field, a key of the card's
+     *  `ui.groups`. */
     group?: string;
     compact?: boolean;
     multiline?: boolean;
@@ -455,18 +464,18 @@ export interface QuillFieldUi {
     layout?: "table" | "flat";
 }
 
-/** One entry in a card's `ui.groups` registry: a display-label override for the
- * group id (the map key). An empty object carries no override, and the consumer
- * derives the label from the id (`memo_for` → "Memo For"). */
+/** One section in a card's `ui.groups`: a display-label override for the
+ * section id (the map key). An empty object carries no override, and the
+ * consumer derives the label from the id (`memo_for` → "Memo For"). */
 export interface QuillGroupUi {
     title?: string;
 }
 
 /** UI layout hints for a card (main or named card kind). */
 export interface QuillCardUi {
-    /** The groups a field's `ui.group` may reference, keyed by group id. Key
-     * order is the display-order contract, as with `fields`. Absent when the
-     * card declares no groups. */
+    /** The card's sections keyed by id, each holding at least one field, which
+     * names it in its `ui.group`. Key order is the display-order contract, as
+     * with `fields`. Absent when the card declares no sections. */
     groups?: Record<string, QuillGroupUi>;
 }
 
@@ -963,8 +972,9 @@ export class Quill {
     toTree(): Map<string, Uint8Array>;
     /**
      * Validate `doc` against this quill's schema, returning every diagnostic:
-     * an error blocks a render, a warning does not. Forwards the canonical
-     * `validation::*` diagnostics the engine emits.
+     * an error blocks a render, a warning does not. Forwards the engine's
+     * `validation::*`, a markdown string's `parse::dropped_construct` and the
+     * backend's `backend::declined_construct`.
      */
     validate(doc: Document): Diagnostic[];
     /**

package/core/wasm.js

@@ -26,8 +26,8 @@ export class Document {
      * leaves the document untouched. Field errors throw the same per-field
      * bundle as [`commitFields`](Self::commit_fields); an invalid kind or body,
      * or a bad position, throws a single-entry bundle keyed `$kind` / `$body`.
-     * Returns the body import's `parse::dropped_construct` warnings, anchored
-     * at the placed card's body.
+     * Returns the fields' `parse::dropped_construct` warnings, then the body
+     * import's, anchored under the placed card.
      * @param {Quill} quill
      * @param {string} kind
      * @param {Record<string, unknown>} [fields]
@@ -73,9 +73,13 @@ export class Document {
      *
      * The `quill` handle is passed per call because a `Document` carries only a
      * `$quill` reference, not the resolved schema.
+     *
+     * Returns a `parse::dropped_construct` warning per construct a `richtext`
+     * markdown string in the value dropped, at the string's path.
      * @param {Quill} quill
      * @param {Addr | string} addr
      * @param {any} value
+     * @returns {Diagnostic[]}
      */
     _commitField(quill, addr, value) {
         try {
@@ -84,9 +88,11 @@ export class Document {
             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);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
@@ -98,10 +104,12 @@ export class Document {
      * diagnostic contract as [`storeFields`](Document::store_fields) — nothing
      * applied on error, one `diagnostics` entry per offending field, including
      * `edit::unknown_field` for undeclared names. Throws on an out-of-range
-     * card.
+     * card. Returns [`commitField`](Document::commit_field)'s warnings for
+     * every field, in batch order.
      * @param {Quill} quill
      * @param {CardAddr} addr
      * @param {Record<string, unknown>} fields
+     * @returns {Diagnostic[]}
      */
     _commitFields(quill, addr, fields) {
         try {
@@ -110,9 +118,11 @@ export class Document {
             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);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
@@ -1500,8 +1510,9 @@ export class Quill {
     }
     /**
      * Validate `doc` against this quill's schema, returning every diagnostic:
-     * an error blocks a render, a warning does not. Forwards the canonical
-     * `validation::*` diagnostics the engine emits.
+     * an error blocks a render, a warning does not. Forwards the engine's
+     * `validation::*`, a markdown string's `parse::dropped_construct` and the
+     * backend's `backend::declined_construct`.
      * @param {Document} doc
      * @returns {Diagnostic[]}
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.124.0",
+  "version": "0.125.0",
   "description": "WebAssembly bindings for Quillmark, a schema-driven document engine",
   "type": "module",
   "license": "Apache-2.0",
@@ -15,7 +15,8 @@
     "core",
     "render",
     "runtime",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "sbom.cdx.json"
   ],
   "main": "./runtime/runtime.js",
   "module": "./runtime/runtime.js",

package/render/wasm.d.ts

@@ -146,7 +146,8 @@ export interface TableCell {
 
 /** `props` of a `type: "table"` island: a pipe table normalized to one column
  * count that `header`, every row of `rows`, `aligns` and `widths` all share.
- * A layout key at its default is absent. */
+ * A layout key at its default is absent; one holding a value outside its type
+ * stays as written and reads as absent. */
 export interface TableProps {
     header: TableCell[];
     rows: TableCell[][];
@@ -154,7 +155,7 @@ export interface TableProps {
     aligns: ("none" | "left" | "center" | "right")[];
     /** Per-column relative weights; `null` is an auto-fit column. Absent when
      * every column is auto-fit. A weight is an integer from 1 to
-     * `Number.MAX_SAFE_INTEGER`; any other entry drops the key. */
+     * `Number.MAX_SAFE_INTEGER`. */
     widths?: (number | null)[];
     /** The table's placement; absent is the quill's. */
     align?: "left" | "center" | "right";
@@ -237,14 +238,14 @@ export interface Revised {
 
 /**
  * The receipt of `writer.reviseDocument`. `droppedAnchors` names every prose
- * anchor the write did not carry, at its path in the stored document; a table
+ * anchor the write did not carry, at its path and line in the stored document; a table
  * cell's anchors drop unnamed. `warnings` are the parse's, then each revised
  * content field's `parse::dropped_construct`, then the writer's `conform::*`.
  * A field that lands rather than revises, on an inserted card or over no stored
  * content, reports no drop.
  */
 export interface DocumentRevised {
-    droppedAnchors: { path: string; id: string }[];
+    droppedAnchors: DocumentAnchor[];
     warnings: Diagnostic[];
 }
 
@@ -258,7 +259,13 @@ export interface DocumentRevised {
  */
 export interface AnnotatedMarkdown {
     markdown: string;
-    anchors: { id: string; path: string; line: string }[];
+    anchors: DocumentAnchor[];
+}
+
+export interface DocumentAnchor {
+    id: string;
+    path: string;
+    line: string;
 }
 
 /**
@@ -450,6 +457,8 @@ export interface Resolved {
 /** UI layout hints for a single field. Display order is not a hint: key order
  * in the schema's `fields`/`properties` objects is the ordering contract. */
 export interface QuillFieldUi {
+    /** The id of the card section holding the field, a key of the card's
+     *  `ui.groups`. */
     group?: string;
     compact?: boolean;
     multiline?: boolean;
@@ -466,18 +475,18 @@ export interface QuillFieldUi {
     layout?: "table" | "flat";
 }
 
-/** One entry in a card's `ui.groups` registry: a display-label override for the
- * group id (the map key). An empty object carries no override, and the consumer
- * derives the label from the id (`memo_for` → "Memo For"). */
+/** One section in a card's `ui.groups`: a display-label override for the
+ * section id (the map key). An empty object carries no override, and the
+ * consumer derives the label from the id (`memo_for` → "Memo For"). */
 export interface QuillGroupUi {
     title?: string;
 }
 
 /** UI layout hints for a card (main or named card kind). */
 export interface QuillCardUi {
-    /** The groups a field's `ui.group` may reference, keyed by group id. Key
-     * order is the display-order contract, as with `fields`. Absent when the
-     * card declares no groups. */
+    /** The card's sections keyed by id, each holding at least one field, which
+     * names it in its `ui.group`. Key order is the display-order contract, as
+     * with `fields`. Absent when the card declares no sections. */
     groups?: Record<string, QuillGroupUi>;
 }
 
@@ -619,7 +628,8 @@ export interface FieldRegion {
     rect: [number, number, number, number];
     /**
      * The slice this box covers: USV `[start, end)` into the field's `Content`
-     * for one content segment, `undefined` for a scalar site or widget.
+     * for one content segment, `undefined` for a scalar's ink, a claim or a
+     * widget.
      */
     span?: [number, number];
 }
@@ -630,6 +640,23 @@ export interface FieldRegion {
  */
 export type HitGranularity = "cluster" | "segment";
 
+/**
+ * One address a compiled document fills and the region address a click
+ * reaches it through: the consumer's copy of this contract is
+ * `runtime/runtime.d.ts`.
+ */
+export interface FieldCoverage {
+    /**
+     * Canonical `DocPath` field address, as `FieldRegion.field` spells it.
+     */
+    field: string;
+    /**
+     * The `DocPath` of the region reaching `field`: itself, or the nearest
+     * enclosing address a region carries. `undefined` where no click does.
+     */
+    coveredBy?: string;
+}
+
 /**
  * Output formats supported by backends. Gated behind the engine surface so
  * tsify omits it from the core bundle, which has no rendering surface.
@@ -1010,6 +1037,13 @@ export class LiveSession {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Each address the current compile fills that a reader could want to
+     * click, and the `DocPath` of the region reaching it: the address itself,
+     * the nearest enclosing one a region carries (a row claim reaching its
+     * cells), or `undefined` where no click does. Reflects the current compile.
+     */
+    coverage(): FieldCoverage[];
     /**
      * The schema field whose content is under a point on `page`: the `DocPath`
      * address to focus in the editor, or `undefined` off any field's ink.
@@ -1030,9 +1064,9 @@ export class LiveSession {
     /**
      * The whole-field highlight boxes for `field`: one union rect per page over
      * the field's `span`-bearing content segments, the union `regions()` leaves
-     * derived. **Content only**: a field placed solely as a scalar reference or
-     * a bound widget carries no `span` and returns `[]`, its box being a single
-     * `regions()` rect. Reflects the current compile.
+     * derived. **Content only**: a field placed solely as a scalar's ink, a
+     * claim or a bound widget carries no `span` and returns `[]`, its box being
+     * a single `regions()` rect. Reflects the current compile.
      */
     fieldBoxes(field: string): FieldRegion[];
     /**
@@ -1077,9 +1111,9 @@ export class LiveSession {
      */
     positionAt(page: number, x: number, y: number, tol_pt?: number | null): ContentHit | undefined;
     /**
-     * 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 canonical `DocPath` address. A
+     * Schema-field geometry for this compiled session: each piece of generated
+     * ink's **first placement** (one region per page it touches) plus claim and
+     * widget regions, keyed on the canonical `DocPath` address. A
      * field may appear more than once, so group by `field` (see `FieldRegion`).
      * A session-level query: no render, no byte artifact. The click direction is
      * `fieldAt`. Empty for backends that place no schema fields.
@@ -1197,8 +1231,9 @@ export class Quill {
     toTree(): Map<string, Uint8Array>;
     /**
      * Validate `doc` against this quill's schema, returning every diagnostic:
-     * an error blocks a render, a warning does not. Forwards the canonical
-     * `validation::*` diagnostics the engine emits.
+     * an error blocks a render, a warning does not. Forwards the engine's
+     * `validation::*`, a markdown string's `parse::dropped_construct` and the
+     * backend's `backend::declined_construct`.
      */
     validate(doc: Document): Diagnostic[];
     /**
@@ -1242,11 +1277,10 @@ export class Quillmark {
     open(quill: Quill, doc: Document, today?: string | null): LiveSession;
     /**
      * Render `doc` against `quill` in one shot: `open` + `LiveSession.render`,
-     * with every `quill.validate` warning but `validation::declined_construct`,
-     * which the compile raises as `backend::declined_construct`, ahead of the
-     * compile's in `warnings`; the load's stay on `doc.warnings`. An unset
-     * `output_format` falls back to the backend's first supported format.
-     * `today` reads as on `open`.
+     * with every `quill.validate` warning in `warnings`, a decline among the
+     * compile's and the rest ahead of them; the load's stay on `doc.warnings`.
+     * An unset `output_format` falls back to the backend's first supported
+     * format. `today` reads as on `open`.
      */
     render(quill: Quill, doc: Document, opts?: RenderOptions | null, today?: string | null): RenderResult;
     /**
@@ -1422,6 +1456,7 @@ export interface InitOutput {
     readonly isInline: (a: number, b: number) => void;
     readonly isPlain: (a: number, b: number) => void;
     readonly livesession_backendId: (a: number, b: number) => void;
+    readonly livesession_coverage: (a: number, b: number) => void;
     readonly livesession_fieldAt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly livesession_fieldBoxes: (a: number, b: number, c: number, d: number) => void;
     readonly livesession_locate: (a: number, b: number, c: number, d: number, e: number) => void;

package/render/wasm.js

@@ -26,8 +26,8 @@ export class Document {
      * leaves the document untouched. Field errors throw the same per-field
      * bundle as [`commitFields`](Self::commit_fields); an invalid kind or body,
      * or a bad position, throws a single-entry bundle keyed `$kind` / `$body`.
-     * Returns the body import's `parse::dropped_construct` warnings, anchored
-     * at the placed card's body.
+     * Returns the fields' `parse::dropped_construct` warnings, then the body
+     * import's, anchored under the placed card.
      * @param {Quill} quill
      * @param {string} kind
      * @param {Record<string, unknown>} [fields]
@@ -73,9 +73,13 @@ export class Document {
      *
      * The `quill` handle is passed per call because a `Document` carries only a
      * `$quill` reference, not the resolved schema.
+     *
+     * Returns a `parse::dropped_construct` warning per construct a `richtext`
+     * markdown string in the value dropped, at the string's path.
      * @param {Quill} quill
      * @param {Addr | string} addr
      * @param {any} value
+     * @returns {Diagnostic[]}
      */
     _commitField(quill, addr, value) {
         try {
@@ -84,9 +88,11 @@ export class Document {
             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);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
@@ -98,10 +104,12 @@ export class Document {
      * diagnostic contract as [`storeFields`](Document::store_fields) — nothing
      * applied on error, one `diagnostics` entry per offending field, including
      * `edit::unknown_field` for undeclared names. Throws on an out-of-range
-     * card.
+     * card. Returns [`commitField`](Document::commit_field)'s warnings for
+     * every field, in batch order.
      * @param {Quill} quill
      * @param {CardAddr} addr
      * @param {Record<string, unknown>} fields
+     * @returns {Diagnostic[]}
      */
     _commitFields(quill, addr, fields) {
         try {
@@ -110,9 +118,11 @@ export class Document {
             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);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
             }
+            return takeObject(r0);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
@@ -1224,6 +1234,28 @@ export class LiveSession {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Each address the current compile fills that a reader could want to
+     * click, and the `DocPath` of the region reaching it: the address itself,
+     * the nearest enclosing one a region carries (a row claim reaching its
+     * cells), or `undefined` where no click does. Reflects the current compile.
+     * @returns {FieldCoverage[]}
+     */
+    coverage() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.livesession_coverage(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);
+        }
+    }
     /**
      * The schema field whose content is under a point on `page`: the `DocPath`
      * address to focus in the editor, or `undefined` off any field's ink.
@@ -1264,9 +1296,9 @@ export class LiveSession {
     /**
      * The whole-field highlight boxes for `field`: one union rect per page over
      * the field's `span`-bearing content segments, the union `regions()` leaves
-     * derived. **Content only**: a field placed solely as a scalar reference or
-     * a bound widget carries no `span` and returns `[]`, its box being a single
-     * `regions()` rect. Reflects the current compile.
+     * derived. **Content only**: a field placed solely as a scalar's ink, a
+     * claim or a bound widget carries no `span` and returns `[]`, its box being
+     * a single `regions()` rect. Reflects the current compile.
      * @param {string} field
      * @returns {FieldRegion[]}
      */
@@ -1405,9 +1437,9 @@ export class LiveSession {
         }
     }
     /**
-     * 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 canonical `DocPath` address. A
+     * Schema-field geometry for this compiled session: each piece of generated
+     * ink's **first placement** (one region per page it touches) plus claim and
+     * widget regions, keyed on the canonical `DocPath` address. A
      * field may appear more than once, so group by `field` (see `FieldRegion`).
      * A session-level query: no render, no byte artifact. The click direction is
      * `fieldAt`. Empty for backends that place no schema fields.
@@ -1822,8 +1854,9 @@ export class Quill {
     }
     /**
      * Validate `doc` against this quill's schema, returning every diagnostic:
-     * an error blocks a render, a warning does not. Forwards the canonical
-     * `validation::*` diagnostics the engine emits.
+     * an error blocks a render, a warning does not. Forwards the engine's
+     * `validation::*`, a markdown string's `parse::dropped_construct` and the
+     * backend's `backend::declined_construct`.
      * @param {Document} doc
      * @returns {Diagnostic[]}
      */
@@ -1917,11 +1950,10 @@ export class Quillmark {
     }
     /**
      * Render `doc` against `quill` in one shot: `open` + `LiveSession.render`,
-     * with every `quill.validate` warning but `validation::declined_construct`,
-     * which the compile raises as `backend::declined_construct`, ahead of the
-     * compile's in `warnings`; the load's stay on `doc.warnings`. An unset
-     * `output_format` falls back to the backend's first supported format.
-     * `today` reads as on `open`.
+     * with every `quill.validate` warning in `warnings`, a decline among the
+     * compile's and the rest ahead of them; the load's stay on `doc.warnings`.
+     * An unset `output_format` falls back to the backend's first supported
+     * format. `today` reads as on `open`.
      * @param {Quill} quill
      * @param {Document} doc
      * @param {RenderOptions | null} [opts]

package/render/wasm_bg.wasm.d.ts

@@ -59,6 +59,7 @@ export const importMarkdown: (a: number, b: number, c: number) => void;
 export const isInline: (a: number, b: number) => void;
 export const isPlain: (a: number, b: number) => void;
 export const livesession_backendId: (a: number, b: number) => void;
+export const livesession_coverage: (a: number, b: number) => void;
 export const livesession_fieldAt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const livesession_fieldBoxes: (a: number, b: number, c: number, d: number) => void;
 export const livesession_locate: (a: number, b: number, c: number, d: number, e: number) => void;