@quillmark/wasm 0.120.0 → 0.122.0

package/CHANGELOG.md

@@ -1,5 +1,173 @@
 # Changelog
 
+## v0.122.0 - 2026-10-05
+
+Upgrade path: [0.121 → 0.122](docs/migrations/0.121-to-0.122.md).
+
+### YAML booleans
+
+- fix(core)!: **only `true` and `false`, in any letter case, are YAML
+  booleans**, so an unquoted `y`, `n`, `yes`, `no`, `on` or `off` is the text
+  written: `middle_initial: N` reaches the plate as `N` where it printed
+  `false`, and nothing reports the change. A card-yaml payload, `Quill.yaml` and
+  `QuillValue::from_yaml_str` share the reading. A word under a `boolean`,
+  `number` or `integer` field, a matrix member's tick included, fails
+  validation as `validation::type_mismatch` and the render as
+  `validation::coercion_failed`; in `Quill.yaml` a word where a boolean belongs
+  fails to load, and `values: [US, NO, DE]` loads. `!!bool` on a word fails the
+  parse, its hint naming the two booleans. (#2034, #2044)
+
+### Comment placement
+
+- fix(core)!: **a comment keeps the slot the YAML gives it**: the prescan reads
+  each comment's container and slot from the parser's event stream, so one in a
+  sequence at its key's column, indented less than its block, in a compact
+  nested sequence or trailing a plain scalar's continuation line re-emits
+  there, where it moved or dropped. A sequence item carrying a trailer beside
+  its first key's emits in the bare-dash form. `parse::unsupported_yaml_tag`
+  warns on every tagged node at its own path. A column-zero key outside the
+  field grammar fails as `parse::invalid_structure` naming the field, and so
+  does a block whose comments and tags record more than 64 bytes of path per
+  byte of the block, plus 64 KiB. (#2041)
+- fix(core)!: **a legacy `quillmark/document@0.82.0` row's `$id` drops with its
+  inline trailer**, which re-emitted on the item above. (#2041)
+- fix(core): **a run of comments meets no count limit**, so a key's trailer
+  ahead of 32 own-line comments parses, as does any longer run 0.121 refused.
+  (#2044)
+- fix(core): removing a `$seed` overlay keeps its siblings' order (#2041); a
+  comment under an empty `$ext` or `$seed` survives `to_markdown`; and a
+  top-level field named `null`, in any letter case, emits quoted, so the
+  markdown reads back. (#2044)
+
+### Checkbox appearance states
+
+- fix(pdf,acroform)!: **every stamped checkbox carries both its appearance
+  states**, `/AP << /N << /Yes … /Off … >> >>` with `/AS` and `/V` naming the
+  current one, so a filler toggles it by renaming `/AS` and `/V`. A reader
+  taking `/N` only as a stream draws an empty box, and rendered PDF bytes move
+  wherever a checkbox is stamped. `StampOptions` gains `states:
+  AppearanceStates`: `All`, the default, is the deliverable, and `Selected`
+  writes each box's `/N` as the one stream `/AS` names, for a rasterizer that
+  cannot resolve it, as the acroform canvas does. (#2038)
+- fix(pdf): **a direct `null` dictionary entry reads as absent**, so a base
+  PDF's `/AcroForm null` stamps where it failed as `pdf::existing_acroform`.
+  Nulling the key strips no widgets. (#2038)
+- fix(pdf): **a stamp appends to a page's `/Annots` without rewriting the
+  array's bytes**, where it decoded them as lossy UTF-8, turning an inline
+  annotation's Latin-1 byte into U+FFFD, and could land the new refs inside a
+  closing `%` comment. (#2044)
+
+### Typst plate path
+
+- fix(typst)!: **a `plate_file` at a path Typst's path grammar refuses fails to
+  open as `typst::plate_path_invalid`**, where the plate loaded as `main.typ`
+  and shadowed the quill's own `main.typ`. Such a path holds a `\`: separate
+  the path with `/`. (#2037)
+- feat(typst): **a `typst::file_not_found` for a bare path in a module below the
+  quill root hints the rooted spelling** when the quill root holds that file.
+  (#2037)
+
+### WASM options and types
+
+- fix(wasm)!: **an options object refuses a key the verb does not read**:
+  `engine.render` and `session.render` throw on a render option outside
+  `format`, `ppi`, `pages` and `regions`, and `new Engine` on a key other than
+  `backends`, so `engine.render(quill, doc, { today })` rejects, naming the
+  trailing argument the date belongs in, where it rendered the local date. A
+  null-prototype or cross-realm options object, `Addr` or `CardInput` is
+  checked too. (#2036)
+- fix(wasm)!: **`runtime.d.ts`'s writer and reader verbs type as declared**:
+  `Addr`, `Content`, `Delta`, `PathStep` and `Resolved` read as `any`, so code
+  leaning on the `any` stops compiling. (#2043)
+
+### Load warnings
+
+- fix(core,typst,cli)!: **a failed Typst compile carries the quill's load
+  warnings after its errors**, so a thrown error's `diagnostics` may hold
+  warnings; `diagnostics[0]` and the message are unchanged. `quillmark render`
+  prints the carried warnings ahead of the error, and `quillmark validate`
+  reports each once. (#2039)
+- fix(typst,cli): **`quillmark workspace` prints the quill's load warnings**,
+  which `Workspace.warnings` carries, and its `typst watch` command passes
+  `--creation-timestamp=` at noon UTC of the render date, so the plate's
+  `datetime.today()` agrees with the render's, before 1970 too. (#2039,
+  #2044)
+
+### Raster refusals
+
+- fix(core,typst,acroform,wasm): **a raster refusal names a ppi or scale that
+  fits**: a PNG export one that fits every selected page, pointing a page too
+  long for PNG at PDF or SVG, and a canvas a scale. Both backends size a raster
+  by `raster_size`, each side rounded and at least one pixel, so a tiny canvas
+  scale paints one pixel where acroform threw, and `paint` checks a scale as
+  the `f64` a JS number is before narrowing it. (#2040)
+- feat(cli): **`quillmark render --ppi`** sets the PNG density. (#2040)
+
+### Docs
+
+- docs(quills): **consumer-study corrections** across the quill and authoring
+  pages. (#2035)
+
+### Build
+
+- ci: `wasm-bindgen-cli` pinned to the lockfile's 0.2.129; thiserror 2.0.21,
+  web-sys 0.3.106 and `taiki-e/install-action` 2.87.21. (#2032, #2033)
+
+
+## v0.121.0 - 2026-09-30
+
+Upgrade path: [0.120 → 0.121](docs/migrations/0.120-to-0.121.md).
+
+### Matrix presence
+
+- feat(core,typst,wasm)!: **a matrix member is held by being present in the
+  document**: a mapping is held whatever it carries, `{}` included, and a bare
+  scalar is the tick. A mapping naming no `held` flips from unticked to ticked,
+  with nothing reporting it. `held` is never stored: a member mapping storing
+  it fails validation as `validation::held_stored`, and the render with it, and
+  a `Quill.yaml` `seed:` or `default:` storing it fails to load as
+  `quill::seed_held_stored` / `quill::default_held_stored`. A `held: null` is
+  absent. The strict write rests a held member with no answers as `true`, and
+  the blueprint's `# e.g.` line drops `held: true`. (#2023)
+
+### Matrix plate
+
+- feat(core,typst,acroform)!: **a matrix reaches the plate as the members it
+  holds**, each its columns keyed by id: no member carries `held` or a roster
+  `title`, and an unheld member is absent, so a plate reading `m.held` or
+  `m.title` fails to compile. `roster(dict, key)` in the Typst helper prints the
+  whole vocabulary as `(id, title, held, value, path)` rows, and the dictionary
+  declaring a matrix carries `$path` for it. A member's tick is its own address,
+  `<field>.<member>`: a claim on `<field>.<member>.held` fails the compile, an
+  acroform binding on it fails to load as `acroform::dangling_binding`, and a
+  bare tick the boolean coercion refuses is `validation::type_mismatch` at the
+  member's path. `resolve()` reports the members a matrix holds. A matrix takes
+  a `default:` and `type: matrix?`. The transform schema carries the roster as
+  `quillmark:roster` `[id, title]` pairs, and Rust `QUILLMARK_ORDER_KEY` is
+  `QUILLMARK_ROSTER_KEY`; `FieldSchema::members` is `FieldSchema::member`,
+  beside `added_item`, and `namespace_props` answers `None` for a matrix.
+  (#2023)
+
+### Open matrix
+
+- feat(core,typst,wasm): **`open: true` on a matrix admits items a document
+  adds**, each keyed by a snake_case id and carrying a `title`, taking the
+  roster's columns. The plate and `roster` carry them after the held roster
+  members, sorted by id, and an added item's `title` is a cell with an address.
+  Any other key outside the roster is `validation::enum_violation`, which gains
+  an `open` arg. The transform schema declares the added item as
+  `additionalProperties`, `schema()` emits `open: true` (WASM
+  `QuillFieldSchema.open`), and an acroform quill declaring one fails to load as
+  `quill::open_matrix_unsupported`. `FieldType::Matrix` carries `open: bool`.
+  (#2023)
+
+### Release
+
+- ci(release): **crate publishing retries past a crates.io index backlog**,
+  excluding the crates crates.io already holds at the release version, so a
+  re-run resumes a partial upload. (#2029)
+
+
 ## v0.120.0 - 2026-09-30
 
 Upgrade path: [0.119 → 0.120](docs/migrations/0.119-to-0.120.md).

package/README.md

@@ -124,7 +124,8 @@ may load a backend). Pass `{ backends }` to register or override backend descrip
 Each entry is a descriptor (`{ [backendId]: { load, formats } }`) where `load`
 is the lazy thunk returning the backend module and `formats` is the
 **required** static capability manifest. A malformed descriptor throws at
-`new Engine(...)`, naming the backend id.
+`new Engine(...)`, naming the backend id, and so does any options key other
+than `backends`.
 
 **The format probe is always free.** `supportedFormats` depends only on
 `quill.backendId`, and answers from the descriptor's required `formats`
@@ -362,7 +363,7 @@ value throws `FieldDecode`; an absent field reads back `undefined` and a
 present-null `null`. A read never coerces a scalar (`qty: "3"` reads `"3"`);
 `resolve()` is the coerced view.
 
-### `engine.render(quill, parsed, opts?)` vs. `engine.open(quill, parsed)`
+### `engine.render(quill, parsed, opts?, today?)` vs. `engine.open(quill, parsed, today?)`
 
 Use **`engine.render`** for one-shot exports (PDF/SVG/PNG): compiles, emits
 artifacts, done. Use **`LiveSession`** (returned by `engine.open`) for
@@ -378,6 +379,15 @@ the local date): what a `today` date field and a plate's `datetime.today()`
 render as. A session keeps the date it opened with, so a preview left open past
 midnight renders yesterday's until it is reopened.
 
+`opts` takes `format`, `ppi`, `pages` and `regions`, on `engine.render` and
+`session.render` alike. Any other key throws rather than reading as absent,
+`today` included, so `engine.render(quill, doc, { today })` rejects instead of
+rendering the local date. The date goes last:
+
+```js
+await engine.render(quill, doc, { format: "pdf" }, "2026-03-14");
+```
+
 A document that compiles to zero pages still produces a valid session
 (`pageCount === 0`); `paint(ctx, 0, scale)` and `pageSize(0)` then throw. Branch on
 `pageCount === 0` to render a "no pages to preview" UI rather than relying on
@@ -478,8 +488,10 @@ throws a real `Error` and attaches the property, so there is no constructor to
 from any build or WASM instance in the page.
 
 `diagnostics` is always non-empty: length 1 for most failures, length N for
-backend compilation errors, and `message` is derived from it. The same shape
-applies to every throw site:
+backend compilation errors, and `message` is derived from it. `diagnostics[0]`
+is an error. A failed Typst `engine.render` or `engine.open` also carries the
+quill's load warnings after its errors, so read each entry's `severity`. The
+same shape applies to every throw site:
 
 - `Document.fromMarkdown`: parse errors (missing root `$quill` metadata, YAML
   errors, `parse::input_too_large` for inputs > 10 MiB).
@@ -490,6 +502,10 @@ applies to every throw site:
   `diagnostics[0].code`, never on message text.
 - `engine.render` / `session.render`: backend compilation failures and
   validation errors.
+- An object argument carrying a key its verb does not read: the render
+  options, `new Engine` options, an `Addr`, a `CardInput`. The diagnostic
+  names the key and carries no `code`: it is a call site to fix, not a
+  condition to route on.
 - `engine.render(quill, parsed)` against a quill whose *name* differs
   (`quill::name_mismatch`) or whose *version* falls outside the document's
   selector (`quill::version_mismatch`): a throw, never a warning.

package/core/wasm.d.ts

@@ -439,9 +439,16 @@ export interface QuillFieldSchema {
     variants?: Record<string, Record<string, QuillFieldSchema>>;
     /** The roster of a `type: "matrix"` field, required there and valid
      *  nowhere else: member id to display title, key order the display order.
-     *  Each member is an object of `held` plus the field's `properties`
-     *  (the columns), addressed as `<field>.<member id>.held`. */
+     *  A member is held by being present in the document, as a mapping of the
+     *  field's `properties` (the columns) or a bare `true`; unticking removes
+     *  it. Its own address `<field>.<member id>` is the tick, and each column
+     *  addresses one step further down. */
     members?: Record<string, string>;
+    /** `true` on a `type: "matrix"` field admitting items a document adds
+     *  beside the roster: each keyed by a snake_case id and carrying a
+     *  `title` string beside the columns, held by being present. Valid only
+     *  on a matrix. */
+    open?: boolean;
     ui?: QuillFieldUi;
     properties?: Record<string, QuillFieldSchema>;
     items?: QuillFieldSchema;

package/core/wasm.js

@@ -1788,11 +1788,11 @@ export function start() {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_67e7344beaa85059: function(arg0, arg1) {
+        __wbg_Error_30c8987f7c2ed4e2: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
-        __wbg_Number_c54e7112a3fa7e3e: function(arg0) {
+        __wbg_Number_14af1003b8dd5ead: function(arg0) {
             const ret = Number(getObject(arg0));
             return ret;
         },
@@ -1803,68 +1803,68 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_bigint_get_as_i64_b482365c149396c8: function(arg0, arg1) {
+        __wbg___wbindgen_bigint_get_as_i64_a2383202b9353e4c: function(arg0, arg1) {
             const v = getObject(arg1);
             const ret = typeof(v) === 'bigint' ? v : undefined;
             getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_boolean_get_7a12af2b3f899c5a: function(arg0) {
+        __wbg___wbindgen_boolean_get_5b446f51afd21013: function(arg0) {
             const v = getObject(arg0);
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_0e68cf47c9cbd9b0: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_4687d8d8c2017d52: function(arg0, arg1) {
             const ret = debugString(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);
         },
-        __wbg___wbindgen_in_50072d4d6e45c193: function(arg0, arg1) {
+        __wbg___wbindgen_in_92f62ee1427d9e49: function(arg0, arg1) {
             const ret = getObject(arg0) in getObject(arg1);
             return ret;
         },
-        __wbg___wbindgen_is_bigint_60fc0336cb14f5d7: function(arg0) {
+        __wbg___wbindgen_is_bigint_b123553bed3bb382: function(arg0) {
             const ret = typeof(getObject(arg0)) === 'bigint';
             return ret;
         },
-        __wbg___wbindgen_is_function_fcda5e3902d732fe: function(arg0) {
+        __wbg___wbindgen_is_function_1f9d30630b8b1d3d: function(arg0) {
             const ret = typeof(getObject(arg0)) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_null_5160b3e381865372: function(arg0) {
+        __wbg___wbindgen_is_null_e343b7d08827ba72: function(arg0) {
             const ret = getObject(arg0) === null;
             return ret;
         },
-        __wbg___wbindgen_is_object_edb6b15aa3afe12e: function(arg0) {
+        __wbg___wbindgen_is_object_3c45d4f2dde4e749: function(arg0) {
             const val = getObject(arg0);
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_string_c4f7cb494a2a21f1: function(arg0) {
+        __wbg___wbindgen_is_string_90b56bc79aad6f6c: function(arg0) {
             const ret = typeof(getObject(arg0)) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_8c687d0b90d5b524: function(arg0) {
+        __wbg___wbindgen_is_undefined_8865fb403f8fe9d8: function(arg0) {
             const ret = getObject(arg0) === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_eq_9fdcd3c0a860dd3b: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_eq_02babf21faa37971: function(arg0, arg1) {
             const ret = getObject(arg0) === getObject(arg1);
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_3c30021c243b64cd: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_677f21e468d6b461: function(arg0, arg1) {
             const ret = getObject(arg0) == getObject(arg1);
             return ret;
         },
-        __wbg___wbindgen_number_get_1dc732b810cb937c: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_2e0e7dee9f701a71: function(arg0, arg1) {
             const obj = getObject(arg1);
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_92ab86bb19cbc12f: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_0380ccaa2f57f0d9: function(arg0, arg1) {
             const obj = getObject(arg1);
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
@@ -1872,22 +1872,22 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
+        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_269c5566fbede3eb: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_6137034ef55c9d0f: function() { return handleError(function (arg0, arg1) {
             const ret = getObject(arg0).call(getObject(arg1));
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_done_cffed884d87aa22e: function(arg0) {
+        __wbg_done_b41a1d26cdb37fb6: function(arg0) {
             const ret = getObject(arg0).done;
             return ret;
         },
-        __wbg_entries_20b9608d57d8ddd6: function(arg0) {
+        __wbg_entries_3602f27ad32994b8: function(arg0) {
             const ret = getObject(arg0).entries();
             return addHeapObject(ret);
         },
-        __wbg_entries_972a87586902cf87: function(arg0) {
+        __wbg_entries_fb6397112b1de25f: function(arg0) {
             const ret = Object.entries(getObject(arg0));
             return addHeapObject(ret);
         },
@@ -1902,31 +1902,31 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_export4(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_from_a39669ce566077da: function(arg0) {
+        __wbg_from_296ca31f8d0f1c52: function(arg0) {
             const ret = Array.from(getObject(arg0));
             return addHeapObject(ret);
         },
-        __wbg_getDate_8e7807f062ade36a: function(arg0) {
+        __wbg_getDate_1181c785ea4fdd21: function(arg0) {
             const ret = getObject(arg0).getDate();
             return ret;
         },
-        __wbg_getFullYear_0cfd5a75cf3d5856: function(arg0) {
+        __wbg_getFullYear_32050b2c56c56cd8: function(arg0) {
             const ret = getObject(arg0).getFullYear();
             return ret;
         },
-        __wbg_getMonth_01ce17d889ed7e5e: function(arg0) {
+        __wbg_getMonth_aae5f530fd173536: function(arg0) {
             const ret = getObject(arg0).getMonth();
             return ret;
         },
-        __wbg_get_6cf5a4d4d8ad3c5a: function() { return handleError(function (arg0, arg1) {
+        __wbg_get_658f6698067d9515: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(getObject(arg0), getObject(arg1));
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_get_b1f0ab13c737f856: function(arg0, arg1) {
+        __wbg_get_6c896e0571ddae51: function(arg0, arg1) {
             const ret = getObject(arg0)[arg1 >>> 0];
             return addHeapObject(ret);
         },
-        __wbg_get_unchecked_363572bdd397d473: function(arg0, arg1) {
+        __wbg_get_unchecked_288889d017702237: function(arg0, arg1) {
             const ret = getObject(arg0)[arg1 >>> 0];
             return addHeapObject(ret);
         },
@@ -1934,7 +1934,7 @@ function __wbg_get_imports() {
             const ret = getObject(arg0)[getObject(arg1)];
             return addHeapObject(ret);
         },
-        __wbg_instanceof_ArrayBuffer_d4ff01f8247925ae: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_a99f175873e5d9b8: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof ArrayBuffer;
@@ -1944,7 +1944,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Map_1ff6a2b54c899f0d: function(arg0) {
+        __wbg_instanceof_Map_b2611749102d7ba3: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof Map;
@@ -1954,17 +1954,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Object_87732cb922ac2e2c: function(arg0) {
-            let result;
-            try {
-                result = getObject(arg0) instanceof Object;
-            } catch (_) {
-                result = false;
-            }
-            const ret = result;
-            return ret;
-        },
-        __wbg_instanceof_Uint8Array_598adc0fef426aa8: function(arg0) {
+        __wbg_instanceof_Uint8Array_828cef2aaacafc31: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof Uint8Array;
@@ -1974,35 +1964,35 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_5674713bb7b79043: function(arg0) {
+        __wbg_isArray_e15a2ff68ffdbef2: function(arg0) {
             const ret = Array.isArray(getObject(arg0));
             return ret;
         },
-        __wbg_isSafeInteger_8f51c743827d1ec5: function(arg0) {
+        __wbg_isSafeInteger_717808ad6a54bd9e: function(arg0) {
             const ret = Number.isSafeInteger(getObject(arg0));
             return ret;
         },
-        __wbg_iterator_22ddeb808cf55a6f: function() {
+        __wbg_iterator_e3c31c892080e444: function() {
             const ret = Symbol.iterator;
             return addHeapObject(ret);
         },
-        __wbg_keys_6efc298980178da1: function(arg0) {
+        __wbg_keys_440be172f17c0265: function(arg0) {
             const ret = Object.keys(getObject(arg0));
             return addHeapObject(ret);
         },
-        __wbg_length_31bdaf014f5fbde2: function(arg0) {
+        __wbg_length_7f3c00c40364105e: function(arg0) {
             const ret = getObject(arg0).length;
             return ret;
         },
-        __wbg_length_4e1adc0d42e23620: function(arg0) {
+        __wbg_length_d4bdea10311bd9cf: function(arg0) {
             const ret = getObject(arg0).length;
             return ret;
         },
-        __wbg_new_0_35540e542ba689d2: function() {
+        __wbg_new_0_72d020f0c63443d4: function() {
             const ret = new Date();
             return addHeapObject(ret);
         },
-        __wbg_new_1da3429bc3c4541c: function(arg0) {
+        __wbg_new_1dbf7428bba60a42: function(arg0) {
             const ret = new Uint8Array(getObject(arg0));
             return addHeapObject(ret);
         },
@@ -2010,51 +2000,51 @@ function __wbg_get_imports() {
             const ret = new Error();
             return addHeapObject(ret);
         },
-        __wbg_new_8d36e20aa758e411: function() {
+        __wbg_new_28744009d011f847: function() {
             const ret = new Map();
             return addHeapObject(ret);
         },
-        __wbg_new_a32a1ab6c6655abe: function(arg0, arg1) {
+        __wbg_new_343a093a3c2ffb4e: function(arg0, arg1) {
             const ret = new Error(getStringFromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
-        __wbg_new_bebc3f4757acf305: function() {
+        __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return addHeapObject(ret);
         },
-        __wbg_new_ffa92086ea89f79c: function() {
+        __wbg_new_ee2291f50781bf1d: function() {
             const ret = new Array();
             return addHeapObject(ret);
         },
-        __wbg_new_from_slice_4ee02165f9de919e: function(arg0, arg1) {
+        __wbg_new_from_slice_9a868026ffa4208a: function(arg0, arg1) {
             const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
-        __wbg_next_95053e306b1c3aed: function(arg0) {
+        __wbg_next_33784799010f1bbe: function(arg0) {
             const ret = getObject(arg0).next;
             return addHeapObject(ret);
         },
-        __wbg_next_f31ecb8646d2c605: function() { return handleError(function (arg0) {
+        __wbg_next_f4aac29c42af995c: function() { return handleError(function (arg0) {
             const ret = getObject(arg0).next();
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_prototypesetcall_ae9f5e7459250748: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_bc27214492979395: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), getObject(arg2));
         },
-        __wbg_set_13d25b81ab403f5e: function(arg0, arg1, arg2) {
-            getObject(arg0)[arg1 >>> 0] = takeObject(arg2);
-        },
-        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
-            getObject(arg0)[takeObject(arg1)] = takeObject(arg2);
-        },
-        __wbg_set_a377297433dfea63: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_set_145a351398b48c65: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = Reflect.set(getObject(arg0), getObject(arg1), getObject(arg2));
             return ret;
         }, arguments); },
-        __wbg_set_bf6dde4923b9b059: function(arg0, arg1, arg2) {
+        __wbg_set_6ae97e73113c4f0b: function(arg0, arg1, arg2) {
             const ret = getObject(arg0).set(getObject(arg1), getObject(arg2));
             return addHeapObject(ret);
         },
+        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
+            getObject(arg0)[takeObject(arg1)] = takeObject(arg2);
+        },
+        __wbg_set_bea140a88be9b277: function(arg0, arg1, arg2) {
+            getObject(arg0)[arg1 >>> 0] = takeObject(arg2);
+        },
         __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {
             const ret = getObject(arg1).stack;
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
@@ -2062,15 +2052,15 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg_value_c227f843d21da141: function(arg0) {
+        __wbg_value_f3c585ee8f5ba40c: function(arg0) {
             const ret = getObject(arg0).value;
             return addHeapObject(ret);
         },
-        __wbg_values_220548effc36d1d3: function(arg0) {
+        __wbg_values_0861828bcc747558: function(arg0) {
             const ret = Object.values(getObject(arg0));
             return addHeapObject(ret);
         },
-        __wbg_values_85d5bcf6f1ca8248: function(arg0) {
+        __wbg_values_6450e8158115fd4e: function(arg0) {
             const ret = getObject(arg0).values();
             return addHeapObject(ret);
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.120.0",
+  "version": "0.122.0",
   "description": "WebAssembly bindings for Quillmark, a schema-driven document engine",
   "type": "module",
   "license": "Apache-2.0",

package/render/wasm.d.ts

@@ -450,9 +450,16 @@ export interface QuillFieldSchema {
     variants?: Record<string, Record<string, QuillFieldSchema>>;
     /** The roster of a `type: "matrix"` field, required there and valid
      *  nowhere else: member id to display title, key order the display order.
-     *  Each member is an object of `held` plus the field's `properties`
-     *  (the columns), addressed as `<field>.<member id>.held`. */
+     *  A member is held by being present in the document, as a mapping of the
+     *  field's `properties` (the columns) or a bare `true`; unticking removes
+     *  it. Its own address `<field>.<member id>` is the tick, and each column
+     *  addresses one step further down. */
     members?: Record<string, string>;
+    /** `true` on a `type: "matrix"` field admitting items a document adds
+     *  beside the roster: each keyed by a snake_case id and carrying a
+     *  `title` string beside the columns, held by being present. Valid only
+     *  on a matrix. */
+    open?: boolean;
     ui?: QuillFieldUi;
     properties?: Record<string, QuillFieldSchema>;
     items?: QuillFieldSchema;
@@ -976,7 +983,8 @@ export class LiveSession {
      * this call.
      *
      * Throws if `page` is out of range, `ctx` is the wrong type, or `scale` is
-     * not finite and positive (`backend::invalid_raster_scale`).
+     * not finite and positive or is under `f32::MIN_POSITIVE`
+     * (`backend::invalid_raster_scale`).
      */
     paint(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, page: number, scale: number): void;
     /**

package/render/wasm.js

@@ -1296,7 +1296,8 @@ export class LiveSession {
      * this call.
      *
      * Throws if `page` is out of range, `ctx` is the wrong type, or `scale` is
-     * not finite and positive (`backend::invalid_raster_scale`).
+     * not finite and positive or is under `f32::MIN_POSITIVE`
+     * (`backend::invalid_raster_scale`).
      * @param {CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D} ctx
      * @param {number} page
      * @param {number} scale
@@ -2213,11 +2214,11 @@ export function start() {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_67e7344beaa85059: function(arg0, arg1) {
+        __wbg_Error_30c8987f7c2ed4e2: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
-        __wbg_Number_c54e7112a3fa7e3e: function(arg0) {
+        __wbg_Number_14af1003b8dd5ead: function(arg0) {
             const ret = Number(getObject(arg0));
             return ret;
         },
@@ -2228,68 +2229,68 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_bigint_get_as_i64_b482365c149396c8: function(arg0, arg1) {
+        __wbg___wbindgen_bigint_get_as_i64_a2383202b9353e4c: function(arg0, arg1) {
             const v = getObject(arg1);
             const ret = typeof(v) === 'bigint' ? v : undefined;
             getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_boolean_get_7a12af2b3f899c5a: function(arg0) {
+        __wbg___wbindgen_boolean_get_5b446f51afd21013: function(arg0) {
             const v = getObject(arg0);
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_0e68cf47c9cbd9b0: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_4687d8d8c2017d52: function(arg0, arg1) {
             const ret = debugString(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);
         },
-        __wbg___wbindgen_in_50072d4d6e45c193: function(arg0, arg1) {
+        __wbg___wbindgen_in_92f62ee1427d9e49: function(arg0, arg1) {
             const ret = getObject(arg0) in getObject(arg1);
             return ret;
         },
-        __wbg___wbindgen_is_bigint_60fc0336cb14f5d7: function(arg0) {
+        __wbg___wbindgen_is_bigint_b123553bed3bb382: function(arg0) {
             const ret = typeof(getObject(arg0)) === 'bigint';
             return ret;
         },
-        __wbg___wbindgen_is_function_fcda5e3902d732fe: function(arg0) {
+        __wbg___wbindgen_is_function_1f9d30630b8b1d3d: function(arg0) {
             const ret = typeof(getObject(arg0)) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_null_5160b3e381865372: function(arg0) {
+        __wbg___wbindgen_is_null_e343b7d08827ba72: function(arg0) {
             const ret = getObject(arg0) === null;
             return ret;
         },
-        __wbg___wbindgen_is_object_edb6b15aa3afe12e: function(arg0) {
+        __wbg___wbindgen_is_object_3c45d4f2dde4e749: function(arg0) {
             const val = getObject(arg0);
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_string_c4f7cb494a2a21f1: function(arg0) {
+        __wbg___wbindgen_is_string_90b56bc79aad6f6c: function(arg0) {
             const ret = typeof(getObject(arg0)) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_8c687d0b90d5b524: function(arg0) {
+        __wbg___wbindgen_is_undefined_8865fb403f8fe9d8: function(arg0) {
             const ret = getObject(arg0) === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_eq_9fdcd3c0a860dd3b: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_eq_02babf21faa37971: function(arg0, arg1) {
             const ret = getObject(arg0) === getObject(arg1);
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_3c30021c243b64cd: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_677f21e468d6b461: function(arg0, arg1) {
             const ret = getObject(arg0) == getObject(arg1);
             return ret;
         },
-        __wbg___wbindgen_number_get_1dc732b810cb937c: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_2e0e7dee9f701a71: function(arg0, arg1) {
             const obj = getObject(arg1);
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_92ab86bb19cbc12f: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_0380ccaa2f57f0d9: function(arg0, arg1) {
             const obj = getObject(arg1);
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
@@ -2297,30 +2298,30 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
+        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_269c5566fbede3eb: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_6137034ef55c9d0f: function() { return handleError(function (arg0, arg1) {
             const ret = getObject(arg0).call(getObject(arg1));
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_canvas_128715f4edb228ef: function(arg0) {
+        __wbg_canvas_2b619d4767b78c03: function(arg0) {
             const ret = getObject(arg0).canvas;
-            return addHeapObject(ret);
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
         },
-        __wbg_canvas_9c3188d85ded70f9: function(arg0) {
+        __wbg_canvas_e7d1eef7cc8eee84: function(arg0) {
             const ret = getObject(arg0).canvas;
-            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+            return addHeapObject(ret);
         },
-        __wbg_done_cffed884d87aa22e: function(arg0) {
+        __wbg_done_b41a1d26cdb37fb6: function(arg0) {
             const ret = getObject(arg0).done;
             return ret;
         },
-        __wbg_entries_20b9608d57d8ddd6: function(arg0) {
+        __wbg_entries_3602f27ad32994b8: function(arg0) {
             const ret = getObject(arg0).entries();
             return addHeapObject(ret);
         },
-        __wbg_entries_972a87586902cf87: function(arg0) {
+        __wbg_entries_fb6397112b1de25f: function(arg0) {
             const ret = Object.entries(getObject(arg0));
             return addHeapObject(ret);
         },
@@ -2335,31 +2336,31 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_export4(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_from_a39669ce566077da: function(arg0) {
+        __wbg_from_296ca31f8d0f1c52: function(arg0) {
             const ret = Array.from(getObject(arg0));
             return addHeapObject(ret);
         },
-        __wbg_getDate_8e7807f062ade36a: function(arg0) {
+        __wbg_getDate_1181c785ea4fdd21: function(arg0) {
             const ret = getObject(arg0).getDate();
             return ret;
         },
-        __wbg_getFullYear_0cfd5a75cf3d5856: function(arg0) {
+        __wbg_getFullYear_32050b2c56c56cd8: function(arg0) {
             const ret = getObject(arg0).getFullYear();
             return ret;
         },
-        __wbg_getMonth_01ce17d889ed7e5e: function(arg0) {
+        __wbg_getMonth_aae5f530fd173536: function(arg0) {
             const ret = getObject(arg0).getMonth();
             return ret;
         },
-        __wbg_get_6cf5a4d4d8ad3c5a: function() { return handleError(function (arg0, arg1) {
+        __wbg_get_658f6698067d9515: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(getObject(arg0), getObject(arg1));
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_get_b1f0ab13c737f856: function(arg0, arg1) {
+        __wbg_get_6c896e0571ddae51: function(arg0, arg1) {
             const ret = getObject(arg0)[arg1 >>> 0];
             return addHeapObject(ret);
         },
-        __wbg_get_unchecked_363572bdd397d473: function(arg0, arg1) {
+        __wbg_get_unchecked_288889d017702237: function(arg0, arg1) {
             const ret = getObject(arg0)[arg1 >>> 0];
             return addHeapObject(ret);
         },
@@ -2367,7 +2368,7 @@ function __wbg_get_imports() {
             const ret = getObject(arg0)[getObject(arg1)];
             return addHeapObject(ret);
         },
-        __wbg_instanceof_ArrayBuffer_d4ff01f8247925ae: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_a99f175873e5d9b8: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof ArrayBuffer;
@@ -2377,7 +2378,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_CanvasRenderingContext2d_bde5245b14027f3f: function(arg0) {
+        __wbg_instanceof_CanvasRenderingContext2d_769208c72dcbf5e6: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof CanvasRenderingContext2D;
@@ -2387,7 +2388,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Map_1ff6a2b54c899f0d: function(arg0) {
+        __wbg_instanceof_Map_b2611749102d7ba3: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof Map;
@@ -2397,17 +2398,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Object_87732cb922ac2e2c: function(arg0) {
-            let result;
-            try {
-                result = getObject(arg0) instanceof Object;
-            } catch (_) {
-                result = false;
-            }
-            const ret = result;
-            return ret;
-        },
-        __wbg_instanceof_OffscreenCanvasRenderingContext2d_4b64493c5055d621: function(arg0) {
+        __wbg_instanceof_OffscreenCanvasRenderingContext2d_957f1a991324c9dc: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof OffscreenCanvasRenderingContext2D;
@@ -2417,7 +2408,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_598adc0fef426aa8: function(arg0) {
+        __wbg_instanceof_Uint8Array_828cef2aaacafc31: function(arg0) {
             let result;
             try {
                 result = getObject(arg0) instanceof Uint8Array;
@@ -2427,35 +2418,35 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_5674713bb7b79043: function(arg0) {
+        __wbg_isArray_e15a2ff68ffdbef2: function(arg0) {
             const ret = Array.isArray(getObject(arg0));
             return ret;
         },
-        __wbg_isSafeInteger_8f51c743827d1ec5: function(arg0) {
+        __wbg_isSafeInteger_717808ad6a54bd9e: function(arg0) {
             const ret = Number.isSafeInteger(getObject(arg0));
             return ret;
         },
-        __wbg_iterator_22ddeb808cf55a6f: function() {
+        __wbg_iterator_e3c31c892080e444: function() {
             const ret = Symbol.iterator;
             return addHeapObject(ret);
         },
-        __wbg_keys_6efc298980178da1: function(arg0) {
+        __wbg_keys_440be172f17c0265: function(arg0) {
             const ret = Object.keys(getObject(arg0));
             return addHeapObject(ret);
         },
-        __wbg_length_31bdaf014f5fbde2: function(arg0) {
+        __wbg_length_7f3c00c40364105e: function(arg0) {
             const ret = getObject(arg0).length;
             return ret;
         },
-        __wbg_length_4e1adc0d42e23620: function(arg0) {
+        __wbg_length_d4bdea10311bd9cf: function(arg0) {
             const ret = getObject(arg0).length;
             return ret;
         },
-        __wbg_new_0_35540e542ba689d2: function() {
+        __wbg_new_0_72d020f0c63443d4: function() {
             const ret = new Date();
             return addHeapObject(ret);
         },
-        __wbg_new_1da3429bc3c4541c: function(arg0) {
+        __wbg_new_1dbf7428bba60a42: function(arg0) {
             const ret = new Uint8Array(getObject(arg0));
             return addHeapObject(ret);
         },
@@ -2463,71 +2454,71 @@ function __wbg_get_imports() {
             const ret = new Error();
             return addHeapObject(ret);
         },
-        __wbg_new_8d36e20aa758e411: function() {
+        __wbg_new_28744009d011f847: function() {
             const ret = new Map();
             return addHeapObject(ret);
         },
-        __wbg_new_a32a1ab6c6655abe: function(arg0, arg1) {
+        __wbg_new_343a093a3c2ffb4e: function(arg0, arg1) {
             const ret = new Error(getStringFromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
-        __wbg_new_bebc3f4757acf305: function() {
+        __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return addHeapObject(ret);
         },
-        __wbg_new_ffa92086ea89f79c: function() {
+        __wbg_new_ee2291f50781bf1d: function() {
             const ret = new Array();
             return addHeapObject(ret);
         },
-        __wbg_new_from_slice_4ee02165f9de919e: function(arg0, arg1) {
+        __wbg_new_from_slice_9a868026ffa4208a: function(arg0, arg1) {
             const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
-        __wbg_new_with_u8_clamped_array_and_sh_15a008af56aca047: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+        __wbg_new_with_u8_clamped_array_and_sh_af3f0dee40638e18: function() { return handleError(function (arg0, arg1, arg2, arg3) {
             const ret = new ImageData(getClampedArrayU8FromWasm0(arg0, arg1), arg2 >>> 0, arg3 >>> 0);
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_next_95053e306b1c3aed: function(arg0) {
+        __wbg_next_33784799010f1bbe: function(arg0) {
             const ret = getObject(arg0).next;
             return addHeapObject(ret);
         },
-        __wbg_next_f31ecb8646d2c605: function() { return handleError(function (arg0) {
+        __wbg_next_f4aac29c42af995c: function() { return handleError(function (arg0) {
             const ret = getObject(arg0).next();
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_prototypesetcall_ae9f5e7459250748: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_bc27214492979395: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), getObject(arg2));
         },
-        __wbg_putImageData_080efc8615f29b4e: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+        __wbg_putImageData_11570c06086c9e05: function() { return handleError(function (arg0, arg1, arg2, arg3) {
             getObject(arg0).putImageData(getObject(arg1), arg2, arg3);
         }, arguments); },
-        __wbg_putImageData_581de52c9f40fc59: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+        __wbg_putImageData_7bf1e9dea494ea50: function() { return handleError(function (arg0, arg1, arg2, arg3) {
             getObject(arg0).putImageData(getObject(arg1), arg2, arg3);
         }, arguments); },
-        __wbg_set_13d25b81ab403f5e: function(arg0, arg1, arg2) {
-            getObject(arg0)[arg1 >>> 0] = takeObject(arg2);
-        },
-        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
-            getObject(arg0)[takeObject(arg1)] = takeObject(arg2);
-        },
-        __wbg_set_a377297433dfea63: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_set_145a351398b48c65: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = Reflect.set(getObject(arg0), getObject(arg1), getObject(arg2));
             return ret;
         }, arguments); },
-        __wbg_set_bf6dde4923b9b059: function(arg0, arg1, arg2) {
+        __wbg_set_6ae97e73113c4f0b: function(arg0, arg1, arg2) {
             const ret = getObject(arg0).set(getObject(arg1), getObject(arg2));
             return addHeapObject(ret);
         },
-        __wbg_set_height_1202ad0eab43cbe0: function(arg0, arg1) {
+        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
+            getObject(arg0)[takeObject(arg1)] = takeObject(arg2);
+        },
+        __wbg_set_bea140a88be9b277: function(arg0, arg1, arg2) {
+            getObject(arg0)[arg1 >>> 0] = takeObject(arg2);
+        },
+        __wbg_set_height_c9789c1c77eaedff: function(arg0, arg1) {
             getObject(arg0).height = arg1 >>> 0;
         },
-        __wbg_set_height_698fb3b255bc1348: function(arg0, arg1) {
+        __wbg_set_height_fde391767df1ce27: function(arg0, arg1) {
             getObject(arg0).height = arg1 >>> 0;
         },
-        __wbg_set_width_4c3a2252e0dea033: function(arg0, arg1) {
+        __wbg_set_width_0ca908d167690992: function(arg0, arg1) {
             getObject(arg0).width = arg1 >>> 0;
         },
-        __wbg_set_width_f52a20e39808b138: function(arg0, arg1) {
+        __wbg_set_width_b0e1267db4b196b5: function(arg0, arg1) {
             getObject(arg0).width = arg1 >>> 0;
         },
         __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {
@@ -2537,15 +2528,15 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg_value_c227f843d21da141: function(arg0) {
+        __wbg_value_f3c585ee8f5ba40c: function(arg0) {
             const ret = getObject(arg0).value;
             return addHeapObject(ret);
         },
-        __wbg_values_220548effc36d1d3: function(arg0) {
+        __wbg_values_0861828bcc747558: function(arg0) {
             const ret = Object.values(getObject(arg0));
             return addHeapObject(ret);
         },
-        __wbg_values_85d5bcf6f1ca8248: function(arg0) {
+        __wbg_values_6450e8158115fd4e: function(arg0) {
             const ret = getObject(arg0).values();
             return addHeapObject(ret);
         },

package/runtime/runtime.d.ts

@@ -167,9 +167,11 @@ export type {
  * This is a STRUCTURAL interface, not a class: the WASM layer throws a real
  * `Error` and attaches `diagnostics` to it, so there is no constructor to
  * `instanceof` against, narrow with {@link isQuillmarkError}. `diagnostics`
- * is always non-empty; `message` is the first diagnostic's message (or an
- * `"N error(s): …"` aggregate for multi-diagnostic failures), so iterate
- * `diagnostics` for per-error detail. The shape is identical to
+ * is always non-empty and opens with an error. A `severity: 'warning'` entry
+ * after the errors is one raised before the failure that can explain it, such
+ * as a package the quill's load skipped. `message` is the first diagnostic's
+ * message (or an `"N error(s): …"` aggregate for multi-error failures), so
+ * iterate `diagnostics` for per-error detail. The shape is identical to
  * `RenderResult.warnings` entries.
  */
 export interface QuillmarkError extends Error {
@@ -236,14 +238,19 @@ export interface Artifact {
 	mimeType: string;
 }
 
-/** Options for one render. */
+/**
+ * Options for one render. Any other key throws, `today` included: the render
+ * date is an argument of {@link Engine.render} and {@link Engine.open}, not an
+ * option.
+ */
 export interface RenderOptions {
 	format?: OutputFormat;
 	/**
 	 * Pixels per inch for raster formats (PNG); ignored by PDF and SVG.
-	 * Defaults to 144. Must be finite, above 0, and small enough to keep every
-	 * rendered page under 268435456 pixels — anything else throws
-	 * `backend::invalid_raster_scale`.
+	 * Defaults to 144. Must be finite, above 0, and small enough to keep both
+	 * sides of every rendered page within 16384 px — anything else throws
+	 * `backend::invalid_raster_scale`, whose hint past the ceiling names a ppi
+	 * that fits.
 	 */
 	ppi?: number;
 	pages?: number[];
@@ -371,6 +378,7 @@ export interface BackendDescriptor {
 	formats: OutputFormat[];
 }
 
+/** Options for `new Engine(...)`. A key other than `backends` throws. */
 export interface EngineOptions {
 	/**
 	 * Extra or overriding backend descriptors, merged over the built-ins. Keys are
@@ -407,7 +415,8 @@ export declare class Engine {
 	 * document it opened from, so {@link LiveSession.render} carries the
 	 * compile's alone: read `doc.warnings` and `quill.validate(doc)` beside it.
 	 *
-	 * `today` reads as on {@link open}.
+	 * `today` reads as on {@link open}. An `options` key outside
+	 * {@link RenderOptions} rejects, `today` among them.
 	 */
 	render(quill: Quill, doc: Document, options?: RenderOptions, today?: string): Promise<RenderResult>;
 
@@ -537,7 +546,8 @@ export declare class LiveSession {
 	 * neither exceeds 16384 px, so `canvas.width / widthPt` is the scale painted
 	 * at; the caller owns `canvas.style.*`, and a canvas styled `width: 100%`
 	 * needs nothing back from the paint. Throws `backend::invalid_raster_scale`
-	 * on a `scale` that is not finite and positive.
+	 * on a `scale` that is not finite and positive, or is under the least a
+	 * 32-bit float holds at full precision (2⁻¹²⁶, about 1.2e-38).
 	 *
 	 * The write is a whole-backing-store `putImageData`, which bypasses the 2D
 	 * context transform, `globalAlpha`, and clip, so give each visible page its
@@ -580,6 +590,8 @@ declare module '../core/wasm.js' {
 	}
 }
 
+import type { Addr, Content, Delta, PathStep, Resolved } from '../core/wasm.js';
+
 /**
  * A `Document` bound to its `Quill` for typed writes, from {@link Quill.writer}.
  * Speaks names, values, and markdown, so bare `set` / `setAll` / `reviseBody` /

package/runtime/runtime.js

@@ -161,6 +161,25 @@ function quillmarkError(code, message, hint) {
 	return err;
 }
 
+/**
+ * Throw on an own key of an options object outside `known`. The JS twin of the
+ * binding's `reject_unknown_keys`, in the uncoded shape it throws: a misspelled
+ * optional key would otherwise read as absent.
+ * @param {unknown} options
+ * @param {string[]} known
+ * @param {string} what the options' name, for the message
+ * @returns {void}
+ */
+function rejectUnknownKeys(options, known, what) {
+	for (const key of Object.keys(options ?? {})) {
+		if (known.includes(key)) continue;
+		const message = `${what} have unknown key \`${key}\`; ${what} take only \`${known.join('`, `')}\``;
+		const err = /** @type {any} */ (new Error(message));
+		err.diagnostics = [{ severity: 'error', message }];
+		throw err;
+	}
+}
+
 // These checks deliver the ERROR, not the rejection, at the seams that cross
 // into backend memory as DATA — `Engine` and `LiveSession.update` — where a
 // foreign handle would otherwise work silently at the price of a whole-document
@@ -374,6 +393,7 @@ export class Engine {
 	 * @param {{ backends?: Record<string, { load: () => Promise<unknown>, formats: string[] }> }} [options]
 	 */
 	constructor(options) {
+		rejectUnknownKeys(options, ['backends'], 'Engine options');
 		const merged = { ...DEFAULT_BACKENDS, ...(options?.backends ?? {}) };
 		/** @type {Record<string, { load: () => Promise<unknown>, formats: string[] }>} */
 		const loaders = {};