@quillmark/wasm 0.81.0 → 0.82.0

package/bundler/wasm_bg.js

@@ -1,15 +1,5 @@
 /**
  * Typed in-memory Quillmark document.
- *
- * Created via `Document.fromMarkdown(markdown)`. Exposes:
- * - `quillRef` (string)
- * - `frontmatter` (JS object/Record)
- * - `body` (string)
- * - `cards` (array of Card objects)
- * - `warnings` (array of Diagnostic objects)
- *
- * `toMarkdown()` emits canonical Quillmark Markdown that round-trips back to
- * an equal `Document` by value and by type.
  */
 export class Document {
     static __wrap(ptr) {
@@ -30,10 +20,7 @@ export class Document {
         wasm.__wbg_document_free(ptr, 0);
     }
     /**
-     * Number of composable cards (excludes the main card).
-     *
-     * O(1). Use this to validate indices before calling card mutators
-     * instead of allocating the full `cards` array.
+     * Number of composable cards (excludes the main card). O(1).
      * @returns {number}
      */
     get cardCount() {
@@ -41,7 +28,6 @@ export class Document {
         return ret >>> 0;
     }
     /**
-     * Ordered list of composable card blocks as typed `Card` objects.
      * @returns {Card[]}
      */
     get cards() {
@@ -49,12 +35,6 @@ export class Document {
         return takeObject(ret);
     }
     /**
-     * Return a fresh `Document` handle with the same parse state.
-     *
-     * Mutations on the returned handle do not affect the original and
-     * vice versa. Parse-time warnings are snapshotted alongside the
-     * document — they describe the original parse, not the edit
-     * history of either handle.
      * @returns {Document}
      */
     clone() {
@@ -63,16 +43,8 @@ export class Document {
     }
     /**
      * Schema version this build writes via [`toJson`](Document::to_json).
-     *
-     * Compare a payload's [`schemaVersionOf`](Document::schema_version_of)
-     * against this to detect mismatches before calling
-     * [`fromJson`](Document::from_json).
-     *
-     * The tag tracks the **`Document` model version** — the crate version
-     * at which the wire format was last changed — not the running crate
-     * version. Every patch and minor release within the same model
-     * generation returns the same string; the tag advances only when a
-     * new schema variant ships.
+     * Tracks the `Document` model version (not the running crate version):
+     * the tag advances only when the wire format changes, not on every release.
      * @returns {string}
      */
     static currentSchemaVersion() {
@@ -92,14 +64,8 @@ export class Document {
         }
     }
     /**
-     * Structural equality against another `Document`.
-     *
-     * Compares `main` and `cards` by value (matching core's [`PartialEq`]).
-     * Parse-time `warnings` are intentionally excluded — they describe the
-     * source text, not the document's content.
-     *
-     * Use this to debounce upstream prop updates: keep the last parsed
-     * `Document` and compare instead of re-parsing on every keystroke.
+     * Structural equality (parse-time `warnings` excluded). Use to debounce
+     * upstream prop updates instead of re-parsing on every keystroke.
      * @param {Document} other
      * @returns {boolean}
      */
@@ -109,19 +75,12 @@ export class Document {
         return ret !== 0;
     }
     /**
-     * Reconstruct a `Document` from its versioned storage DTO string.
-     *
-     * `json` must be a string produced by [`toJson`](Document::to_json) —
-     * the versioned storage DTO. Parsing and schema dispatch happen inside
-     * the module via `serde_json`; the JS `JSON` global is not involved.
-     * Unknown `schema` tags are rejected.
+     * Reconstruct a `Document` from a versioned storage DTO string produced
+     * by [`toJson`](Document::to_json). Unknown `schema` tags are rejected.
+     * The result carries no parse-time warnings (`.warnings` is always empty).
      *
-     * The reconstructed document carries no parse-time warnings — the DTO
-     * describes content, not source text — so `.warnings` is always empty.
-     *
-     * Throws a JS `Error` if `json` is not a valid storage DTO (malformed
-     * JSON, unknown `schema`, missing fields, or an unparseable quill
-     * reference).
+     * Throws if `json` is not a valid storage DTO (malformed JSON, unknown
+     * `schema`, missing fields, or unparseable quill reference).
      * @param {string} json
      * @returns {Document}
      */
@@ -143,10 +102,7 @@ export class Document {
         }
     }
     /**
-     * Parse markdown into a typed Document.
-     *
-     * Returns the document with any parse-time warnings accessible via `.warnings`.
-     * Throws on parse errors.
+     * Parse markdown into a typed Document. Throws on parse errors.
      * @param {string} markdown
      * @returns {Document}
      */
@@ -168,11 +124,7 @@ export class Document {
         }
     }
     /**
-     * Insert a card at the given index.
-     *
-     * `index` must be in `0..=cards.length`. Out-of-range throws an `Error`.
-     *
-     * Mutators never modify `warnings`.
+     * Insert a card at `index` (must be in `0..=cards.length`).
      * @param {number} index
      * @param {CardInput} card
      */
@@ -190,13 +142,8 @@ export class Document {
         }
     }
     /**
-     * The document's main (entry) card.
-     *
-     * Carries the QUILL sentinel, the document-level frontmatter, and the
-     * global body. Frontmatter/body reads and mutations go through this
-     * handle — there are no document-level shortcuts after the rework.
-     *
-     * Allocates and serializes on each call — cache locally if read in a hot loop.
+     * The document's main (entry) card. Allocates and serializes on each
+     * call — cache locally if read in a hot loop.
      * @returns {Card}
      */
     get main() {
@@ -204,12 +151,7 @@ export class Document {
         return takeObject(ret);
     }
     /**
-     * Move the card at `from` to position `to`.
-     *
-     * `from == to` is a no-op. Both indices must be in `0..cards.length`.
-     * Out-of-range throws an `Error`.
-     *
-     * Mutators never modify `warnings`.
+     * Move the card at `from` to position `to`. `from == to` is a no-op.
      * @param {number} from
      * @param {number} to
      */
@@ -228,13 +170,7 @@ export class Document {
     }
     /**
      * Append a card to the end of the card list.
-     *
-     * `card` must be a JS object with a `tag` string field and optional
-     * `fields` (object) and `body` (string).
-     *
-     * Throws an `Error` if `card.tag` is not a valid tag name.
-     *
-     * Mutators never modify `warnings`.
+     * Throws if `card.kind` is not a valid kind name.
      * @param {CardInput} card
      */
     pushCard(card) {
@@ -251,7 +187,6 @@ export class Document {
         }
     }
     /**
-     * The QUILL reference string (e.g. `"usaf_memo@0.1"`).
      * @returns {string}
      */
     get quillRef() {
@@ -271,9 +206,6 @@ export class Document {
         }
     }
     /**
-     * Remove the card at `index` and return it, or `undefined` if out of range.
-     *
-     * Mutators never modify `warnings`.
      * @param {number} index
      * @returns {Card | undefined}
      */
@@ -282,13 +214,8 @@ export class Document {
         return takeObject(ret);
     }
     /**
-     * Remove a frontmatter field on the card at `index`, returning the
-     * removed value or `undefined` if the field was absent.
-     *
-     * Throws if `index` is out of range, `name` is reserved, or `name` does
-     * not match `[a-z_][a-z0-9_]*`.
-     *
-     * Mutators never modify `warnings`.
+     * 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
      * @returns {any}
@@ -311,14 +238,9 @@ export class Document {
         }
     }
     /**
-     * Remove a frontmatter field on the main card, returning the removed value or `undefined`.
-     *
-     * Throws an `Error` whose message includes the `EditError` variant name
-     * and details if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`)
-     * or does not match `[a-z_][a-z0-9_]*`. Absence of an otherwise-valid
-     * name returns `undefined`.
-     *
-     * Mutators never modify `warnings`.
+     * Remove a payload field on the main card, returning the removed value or
+     * `undefined`. Throws if `name` is reserved or does not match
+     * `[a-z_][a-z0-9_]*`.
      * @param {string} name
      * @returns {any}
      */
@@ -340,9 +262,6 @@ export class Document {
         }
     }
     /**
-     * Replace the main card's body (the global Markdown body).
-     *
-     * Mutators never modify `warnings`.
      * @param {string} body
      */
     replaceBody(body) {
@@ -351,24 +270,10 @@ export class Document {
         wasm.document_replaceBody(this.__wbg_ptr, ptr0, len0);
     }
     /**
-     * Read the schema version from a raw storage DTO string without
-     * performing a full parse, or `undefined`.
-     *
-     * Returns the `schema` field as-is — including unknown future versions
-     * that `fromJson` would reject. Use this to distinguish "this build is
-     * too old for the payload" from "the payload is corrupt" when
-     * [`fromJson`](Document::from_json) throws:
-     *
-     * ```js
-     * const v = Document.schemaVersionOf(blob);
-     * if (v === undefined) {
-     *   // not a stored DTO at all — try fromMarkdown
-     * } else if (v !== Document.currentSchemaVersion()) {
-     *   // newer (or older unmigrated) schema — prompt the user to upgrade
-     * } else {
-     *   doc = Document.fromJson(blob);
-     * }
-     * ```
+     * 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}
      */
@@ -391,26 +296,18 @@ export class Document {
         }
     }
     /**
-     * Replace the tag of the composable card at `index`.
-     *
-     * Mutates only the sentinel — the card's frontmatter and body are
-     * untouched. Schema-aware migration (clearing orphan fields, applying
-     * new defaults) is the caller's responsibility; `setCardTag` is a
-     * structural primitive.
-     *
-     * Throws if `index` is out of range or if `newTag` does not match
-     * `[a-z_][a-z0-9_]*`.
-     *
-     * Mutators never modify `warnings`.
+     * 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_tag
+     * @param {string} new_kind
      */
-    setCardTag(index, new_tag) {
+    setCardKind(index, new_kind) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(new_tag, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const ptr0 = passStringToWasm0(new_kind, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.document_setCardTag(retptr, this.__wbg_ptr, index, ptr0, len0);
+            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) {
@@ -421,16 +318,10 @@ export class Document {
         }
     }
     /**
-     * Update a frontmatter field on the main card.
-     *
-     * Convenience method: equivalent to `doc.mainMut().setField(name, value)`.
-     * Clears any existing `!fill` marker on the field.
+     * Update a payload field on the main card. Clears any existing `!fill` marker.
      *
-     * Throws an `Error` whose message includes the `EditError` variant name and
-     * details if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`) or does
+     * Throws if `name` is reserved (`BODY`, `CARDS`, `QUILL`, `CARD`) or does
      * not match `[a-z_][a-z0-9_]*`.
-     *
-     * Mutators never modify `warnings`.
      * @param {string} name
      * @param {any} value
      */
@@ -450,13 +341,8 @@ export class Document {
         }
     }
     /**
-     * Update a frontmatter field on the main card AND mark it as `!fill`.
-     *
-     * Convenience method: equivalent to `doc.mainMut().setFill(name, value)`.
-     *
+     * Update a payload field on the main card and mark it as `!fill`.
      * Throws on invalid name (see [`setField`](Document::set_field)).
-     *
-     * Mutators never modify `warnings`.
      * @param {string} name
      * @param {any} value
      */
@@ -476,11 +362,7 @@ export class Document {
         }
     }
     /**
-     * Replace the QUILL reference string.
-     *
-     * Throws if `ref_str` is not a valid `QuillReference`.
-     *
-     * Mutators never modify `warnings`.
+     * Replace the QUILL reference string. Throws if `ref_str` is invalid.
      * @param {string} ref_str
      */
     setQuillRef(ref_str) {
@@ -501,36 +383,12 @@ export class Document {
     /**
      * Serialize this document to a versioned storage DTO string.
      *
-     * Returns the document as a JSON string carrying a `schema` version
-     * field. The string is produced inside the module via `serde_json` and
-     * round-trips losslessly back to an equal `Document` via
-     * [`fromJson`](Document::from_json) — the JS `JSON` global is not
-     * involved in either direction.
-     *
-     * Use this — not [`toMarkdown`](Document::to_markdown) — to persist a
-     * document across a process restart or crate upgrade; the wire format
-     * is frozen per `schema` version, whereas Markdown syntax evolves.
-     * Parse-time `warnings` are not part of the DTO.
-     *
-     * The result is standard JSON text, so callers that want to inspect it
-     * may `JSON.parse` it — but treating it as an opaque blob is the
-     * intended use.
+     * 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.
      *
-     * ## Byte-stability
-     *
-     * The output is a **byte-deterministic** function of the document's
-     * value within a given `schema` version: two documents that compare
-     * equal under [`equals`](Document::equals) serialize to byte-equal
-     * strings, and the same document re-serialized in a later patch or
-     * minor release of this crate (same `schema`) produces the same bytes.
-     * Content-hash use cases (template-divergence detection, cache keys)
-     * can rely on this without re-canonicalizing.
-     *
-     * Specifics: object fields are emitted in struct-declaration order;
-     * frontmatter field values preserve their YAML insertion order (no
-     * key sorting); whitespace is `serde_json`'s compact form (no spaces
-     * between tokens, no trailing newline); strings use `serde_json`'s
-     * standard escape set. A schema-version bump may change any of these.
+     * Output is **byte-deterministic** within a `schema` version: equal
+     * documents produce byte-equal output, safe for content-hash use cases.
      * @returns {string}
      */
     toJson() {
@@ -550,11 +408,8 @@ export class Document {
         }
     }
     /**
-     * Emit canonical Quillmark Markdown.
-     *
-     * Returns the document serialised as a Quillmark Markdown string.
-     * The output is type-fidelity round-trip safe: re-parsing the result
-     * produces a `Document` equal to `self` by value and by type.
+     * 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() {
@@ -574,18 +429,11 @@ export class Document {
         }
     }
     /**
-     * Reconstruct a `Document` from a storage DTO string, or `undefined`.
-     *
-     * Like [`fromJson`](Document::from_json), but returns `undefined`
-     * instead of throwing when `json` is not a valid storage DTO. Use this
-     * to detect format and fall back without exceptions as control flow:
-     *
-     * ```js
-     * const doc = Document.tryFromJson(content) ?? Document.fromMarkdown(content);
-     * ```
-     *
-     * `undefined` only ever means "not a storage DTO" — `fromMarkdown`
-     * still throws on genuinely malformed markdown.
+     * 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}
      */
@@ -596,11 +444,7 @@ export class Document {
         return ret === 0 ? undefined : Document.__wrap(ret);
     }
     /**
-     * Replace the body of the card at `index`.
-     *
-     * Throws if `index` is out of range.
-     *
-     * Mutators never modify `warnings`.
+     * Replace the body of the card at `index`. Throws if out of range.
      * @param {number} index
      * @param {string} body
      */
@@ -621,13 +465,7 @@ export class Document {
     }
     /**
      * Update a field on the card at `index`.
-     *
-     * Convenience method: equivalent to `doc.card_mut(index)?.set_field(name, value)`.
-     *
-     * Throws if `index` is out of range, `name` is reserved or invalid, or
-     * `value` cannot be serialized.
-     *
-     * Mutators never modify `warnings`.
+     * Throws if `index` is out of range, `name` is reserved or invalid.
      * @param {number} index
      * @param {string} name
      * @param {any} value
@@ -648,7 +486,6 @@ export class Document {
         }
     }
     /**
-     * Non-fatal parse-time warnings as an array of typed `Diagnostic` objects.
      * @returns {Diagnostic[]}
      */
     get warnings() {
@@ -658,9 +495,6 @@ export class Document {
 }
 if (Symbol.dispose) Document.prototype[Symbol.dispose] = Document.prototype.free;
 
-/**
- * Opaque, shareable Quill handle.
- */
 export class Quill {
     static __wrap(ptr) {
         ptr = ptr >>> 0;
@@ -700,13 +534,8 @@ export class Quill {
         }
     }
     /**
-     * A blank form for a card of the given kind — no document values supplied.
-     *
-     * Returns `null` if `cardKind` is not declared in this quill's schema.
-     * Otherwise returns a plain JS object shaped like a single entry in
-     * [`Form::cards`].
-     *
-     * [`Form::cards`]: quillmark::form::Form::cards
+     * Blank `FormCard` for the given card kind. Returns `null` if `cardKind`
+     * is not declared in this quill's schema.
      * @param {string} card_kind
      * @returns {FormCard | null}
      */
@@ -728,13 +557,8 @@ export class Quill {
         }
     }
     /**
-     * A blank form for the main card — no document values supplied.
-     *
-     * Returns a plain JS object with the same shape as one entry in
-     * [`Form::main`]. Every declared field's `source` is `"default"` (when
-     * the schema declares a default) or `"missing"`.
-     *
-     * [`Form::main`]: quillmark::form::Form::main
+     * Blank `FormCard` for the main card with no document values.
+     * Every field's `source` is `"default"` or `"missing"`.
      * @returns {FormCard}
      */
     blankMain() {
@@ -753,7 +577,6 @@ export class Quill {
         }
     }
     /**
-     * Auto-generated annotated Markdown blueprint for LLM consumers.
      * @returns {string}
      */
     get blueprint() {
@@ -773,23 +596,8 @@ export class Quill {
         }
     }
     /**
-     * The schema-aware form view of `doc`.
-     *
-     * Returns a plain JS object (not a class) that is immediately
-     * `JSON.stringify`-able. The shape mirrors [`Form`]:
-     *
-     * ```json
-     * {
-     *   "main":  { "schema": {...}, "values": { "field": {...} } },
-     *   "cards": [ ... ],
-     *   "diagnostics": [ ... ]
-     * }
-     * ```
-     *
-     * **Snapshot semantics.** This is a read-only snapshot of the document
-     * at call time. Subsequent edits to `doc` require calling `form` again.
-     *
-     * [`Form`]: quillmark::form::Form
+     * The schema-aware form view of `doc`. Read-only snapshot at call time;
+     * subsequent edits to `doc` require calling `form` again.
      * @param {Document} doc
      * @returns {Form}
      */
@@ -811,13 +619,7 @@ export class Quill {
     }
     /**
      * Identity snapshot of the `quill:` section of `Quill.yaml`, plus
-     * `supportedFormats` and any custom `quill:` keys.
-     *
-     * Consumers that need validation run their own validator against
-     * `metadata.schema`.
-     *
-     * Equivalent by value for the lifetime of the handle; the quill is
-     * immutable once constructed.
+     * `supportedFormats` and any extra `quill:` keys.
      * @returns {QuillMetadata}
      */
     get metadata() {
@@ -825,7 +627,6 @@ export class Quill {
         return takeObject(ret);
     }
     /**
-     * Open an iterative render session for page-selective rendering.
      * @param {Document} doc
      * @returns {RenderSession}
      */
@@ -846,7 +647,6 @@ export class Quill {
         }
     }
     /**
-     * Render a document to final artifacts.
      * @param {Document} doc
      * @param {RenderOptions | null} [opts]
      * @returns {RenderResult}
@@ -876,12 +676,9 @@ export class Quill {
         return takeObject(ret);
     }
     /**
-     * Whether this quill's backend supports canvas preview.
-     *
      * `true` iff `RenderSession.paint` and `RenderSession.pageSize` will
-     * succeed for sessions opened by this quill. Use this as a precondition
-     * probe before mounting a canvas-based preview UI; the throw on `paint`
-     * remains the enforcement contract.
+     * succeed for sessions opened by this quill. Use as a precondition
+     * probe before mounting a canvas-based preview UI.
      * @returns {boolean}
      */
     get supportsCanvas() {
@@ -891,9 +688,6 @@ export class Quill {
 }
 if (Symbol.dispose) Quill.prototype[Symbol.dispose] = Quill.prototype.free;
 
-/**
- * Quillmark WASM Engine
- */
 export class Quillmark {
     __destroy_into_raw() {
         const ptr = this.__wbg_ptr;
@@ -905,9 +699,6 @@ export class Quillmark {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_quillmark_free(ptr, 0);
     }
-    /**
-     * JavaScript constructor: `new Quillmark()`
-     */
     constructor() {
         const ret = wasm.quillmark_new();
         this.__wbg_ptr = ret >>> 0;
@@ -943,19 +734,12 @@ export class Quillmark {
 if (Symbol.dispose) Quillmark.prototype[Symbol.dispose] = Quillmark.prototype.free;
 
 /**
- * An iterative render handle backed by an immutable compiled snapshot.
- *
- * Created via [`Quill::open`]. Holds the compiled output so that
- * [`RenderSession::render`], [`RenderSession::paint`], and
- * [`RenderSession::page_size`] can be called repeatedly without
- * recompiling.
+ * Iterative render handle backed by an immutable compiled snapshot.
  *
- * **Empty documents.** A document that compiles to zero pages still
- * produces a valid session (`pageCount === 0`). Iterating
- * `0..pageCount` is then a no-op; calling `paint(ctx, 0)` or
- * `pageSize(0)` throws `"... page index 0 out of range
- * (pageCount=0)"`. Hosts that surface "no pages to preview" UI should
- * branch on `pageCount === 0` rather than on a thrown error.
+ * **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 RenderSession {
     static __wrap(ptr) {
@@ -977,9 +761,6 @@ export class RenderSession {
     }
     /**
      * The backend that produced this session (e.g. `"typst"`).
-     *
-     * Equal to the `backendId` of the [`Quill`] that opened this session
-     * (sessions inherit their quill's backend), so checking either is fine.
      * @returns {string}
      */
     get backendId() {
@@ -999,10 +780,6 @@ export class RenderSession {
         }
     }
     /**
-     * Number of pages in this render session.
-     *
-     * Stable for the lifetime of the session — the underlying compiled
-     * document is an immutable snapshot.
      * @returns {number}
      */
     get pageCount() {
@@ -1011,18 +788,7 @@ export class RenderSession {
     }
     /**
      * Page dimensions in Typst points (1 pt = 1/72 inch).
-     *
-     * Report-only: the painter sizes the canvas itself based on
-     * `PaintOptions`. Exposed for consumers that need page geometry
-     * up-front (e.g. to lay out a scrollable list of canvases before
-     * any pixels are rendered).
-     *
-     * Stable for a given `page` across the session's lifetime — the
-     * compiled document is an immutable snapshot, so callers can cache
-     * results.
-     *
-     * Throws if the underlying backend has no canvas painter (i.e. is not
-     * the Typst backend) or if `page` is out of range.
+     * Throws if the backend has no canvas painter or `page` is out of range.
      * @param {number} page
      * @returns {PageSize}
      */
@@ -1042,42 +808,14 @@ export class RenderSession {
         }
     }
     /**
-     * Paint `page` into a 2D canvas context.
-     *
-     * Accepts either a `CanvasRenderingContext2D` (main thread) or an
-     * `OffscreenCanvasRenderingContext2D` (Worker / off-DOM rasterization).
-     * Both dispatch to the same Rust rasterizer; the dispatch happens at
-     * the JS boundary so neither context type is privileged.
-     *
-     * The painter owns `canvas.width` / `canvas.height` and writes them
-     * itself; consumers must not. The painter does not touch
-     * `canvas.style.*` — that's layout, owned by the consumer (see
-     * `PaintResult.layoutWidth` / `layoutHeight`).
-     *
-     * `opts.layoutScale` (default 1.0) is layout-space pixels per Typst
-     * point and determines the canvas's display-box size. `opts.densityScale`
-     * (default 1.0) is the rasterization density multiplier the consumer
-     * folds `window.devicePixelRatio`, in-app zoom, and
-     * `visualViewport.scale` (pinch-zoom) into. The effective
-     * rasterization scale is `layoutScale * densityScale`.
-     *
-     * If `layoutScale * densityScale` would exceed the safe backing-store
-     * maximum (16384 px per side), `densityScale` is clamped
-     * proportionally so the largest dimension fits. The actual
-     * backing-store dimensions are reported in the returned
-     * `PaintResult` — compare against
-     * `round(layoutWidth * densityScale)` to detect clamping.
-     *
-     * Each call resets the backing store (`paint` is always a full
-     * repaint). Consumers do not need to call `clearRect`.
-     *
-     * Throws when:
-     * - the backend does not support canvas preview (message includes the
-     *   resolved `backendId`),
-     * - `page` is out of range,
-     * - `ctx` is neither `CanvasRenderingContext2D` nor
-     *   `OffscreenCanvasRenderingContext2D`,
-     * - `opts.layoutScale` or `opts.densityScale` is non-finite or `<= 0`.
+     * 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
@@ -1099,7 +837,6 @@ export class RenderSession {
         }
     }
     /**
-     * Render all or selected pages from this session.
      * @param {RenderOptions | null} [opts]
      * @returns {RenderResult}
      */
@@ -1119,11 +856,7 @@ export class RenderSession {
         }
     }
     /**
-     * Whether this session's backend supports canvas preview.
-     *
-     * `true` iff [`paint`](Self::paint) and [`page_size`](Self::page_size)
-     * will succeed. Equal to `Quill.supportsCanvas` for the quill that
-     * opened this session.
+     * `true` iff `paint` and `pageSize` will succeed for this session.
      * @returns {boolean}
      */
     get supportsCanvas() {
@@ -1131,14 +864,8 @@ export class RenderSession {
         return ret !== 0;
     }
     /**
-     * Session-level warnings attached at `quill.open(...)` time.
-     *
-     * Snapshot of any non-fatal diagnostics emitted while opening the
-     * session (e.g. version compatibility shims). Stable across the
-     * session's lifetime. These are also appended to
-     * [`RenderResult.warnings`] on every `render()` call; the accessor
-     * surfaces them to canvas-preview consumers that don't go through
-     * `render()`.
+     * Non-fatal diagnostics emitted when opening the session. Also appended
+     * to `RenderResult.warnings` on each `render()` call.
      * @returns {Diagnostic[]}
      */
     get warnings() {