@quillmark/wasm 0.108.0 → 0.108.2

package/CHANGELOG.md

@@ -1,5 +1,93 @@
 # Changelog
 
+## v0.108.2 - 2026-08-20
+
+- fix(core): **storage blobs tagged `@0.81.0` and `@0.82.0` load again.** Both
+  tags migrate forward on read instead of failing as an unknown schema version.
+  Migrations chain (`V0_81_0 → V0_82_0 → V0_92_0 → V0_93_0`); the write path is
+  untouched, so re-serializing a migrated row emits `@0.93.0`.
+
+  The `V0_82_0` hop is **lossy in one place**: the `$id` payload item is
+  dropped, the live model having no counterpart for it. The alternative is
+  refusing the row. A consumer that kept a key under `$id` re-establishes it
+  under a `$ext` namespace it owns.
+
+  This reverses the #929 retirement, whose two premises were both wrong. Rows
+  do predate `@0.92.0` — #1327 reports stored `@0.81.0` ones. And `0.82.0` was
+  not yanked: every published Quillmark version is live on crates.io, npm, and
+  PyPI. Because no yank happened, `@0.82.0` names a shape
+  union rather than a frozen format — every release from `0.83.0` through
+  `0.91.0` stamped it — so the restored reader accepts the union (#1327)
+
+- refactor!: **one definition per mechanism across the rust crates.** A
+  whole-codebase simplify pass: the typst session compiles through one
+  `recompile` pipeline whose derived tables (regions, span windows, page hashes)
+  are built per commit instead of per query; the pdf reader's scan plumbing
+  (`object_dict`, `open_trailer`, `dict_end`, `ws_end`) and the page-dict array
+  splice are single definitions shared by stamp and flatten; the flattened PDF
+  is shared by `Arc` instead of copied per render; emission, prescan, payload
+  assembly and validation in core lose their duplicated dispatch and their
+  per-keystroke deep clones. Two outputs shift: a blank pdfform document returns
+  the base PDF unchanged rather than appending a revision carrying two
+  unreferenced font objects, and three `quillmark-pdf` parse-failure messages
+  share one `dict not parseable` spelling (codes unchanged). Dead public API is
+  deleted: `FileTreeNode::{file_exists, dir_exists, list_files,
+  list_subdirectories}`, `Payload::contains_key`, `PayloadItem::nested_comments`,
+  `QuillValue::{string, integer, bool, null}` (the `From` impls and `from_json`
+  are the constructors), `FieldSpec::{with_schema_field, with_value,
+  with_tooltip}` (assign the fields), and `quillmark-content`'s
+  `strip_bidi_formatting` / `fix_html_comment_fences` (internal to
+  `normalize_markdown`). None had a caller in the workspace or bindings.
+
+- fix: **an empty mapping emits as `{}` rather than losing its key.** `emit_field`
+  dropped an empty-object field entirely, which composes with the block form of
+  its parent into markdown no parser accepts: a `$ext` whose every namespace
+  emptied wrote `$ext:` with no children, and re-parsed as null. That is the
+  `parse::invalid_structure` a `@quillmark/svelte` host hit on save, once a
+  tips-card dismissal had cleared `$ext.editor.tips`. One level down the same
+  rule ran silent: `$ext` is the only slot type-checked, so an inner mapping
+  turned null and the document parsed clean, handing a consumer back a type it
+  never wrote. Plain user fields carried that loss too — `cfg: {opts: {}}`
+  re-parsed as `cfg: null`, and the second emit then differed from the first.
+  Empty mappings now emit `key: {}` at every depth. That is the spelling a
+  sequence item (`- {}`) and a wholly empty `$ext: {}` already used, so an
+  emptied container survives the round-trip as the value a consumer stored.
+
+<!-- seed: commits since v0.108.1, confirm the entries above cover them, then delete this comment
+- docs(canon): record that @0.81.0 is the oldest tag that exists
+- docs: leave the applied migration guide untouched
+- docs: dense-prose pass on the DTO backfill
+- test(core): drop the vacuous V0_81_0 body-import test
+- fix(core): restore the V0_82_0 read shim; 0.82.0 was never yanked (#1327)
+- chore(deps): bump the cargo group with 2 updates
+- chore(deps): bump taiki-e/install-action in the actions group
+- fix(core): restore the V0_81_0 storage read shim (#1327)
+- docs: changelog entry for the simplify sweep
+- refactor(core)!: apply simplify-review cleanups to the session seam
+- docs(pdf): trim test helper doc to its contract
+- refactor(core/document): apply simplify-review cleanups
+- refactor(pdf): apply simplify-review cleanups
+- refactor(typst): apply simplify-review cleanups
+- refactor(core/quill): apply simplify-review cleanups
+- refactor(content): apply simplify-review cleanups
+- fix: an empty mapping emits as `{}` rather than losing its key
+-->
+
+
+## v0.108.1 - 2026-08-19
+
+- fix: **a content cell under `variants:` is readable at its codec.**
+  `schema_at`, the walk behind `reader.get_content_at`, stepped `items` and
+  `properties` where conform steps `variants` as well, so a key into a variant
+  container fell to the catch-all and answered `edit::field_not_content` naming
+  `enum` — for a cell the same config declares `plaintext`. Such a cell stored,
+  conformed, seeded, validated and rendered, and nothing could read it back, so
+  no consumer could mount a content editor over it. The walk unions the worlds,
+  so a cell of a world that is not live reads absent rather than raising, as a
+  stale row index does; a name no world declares is `edit::unknown_field`, and a
+  variantless enum stays a scalar. The write is unchanged — a variant container
+  has no per-cell op address and needs none, committing whole.
+
 ## v0.108.0 - 2026-08-18
 
 - fix: **the value ladder is cut per cell, so the plate is total at every

package/backends/pdfform/wasm.js

@@ -196,7 +196,8 @@ export class Document {
      * and [`reader.getContent`](Self::reader_get_content) with the path spelled
      * out. `path` is a `PathStep[]` from the field to the leaf — `[0]` an
      * element of an `array<richtext>`, `["motto"]` an `object`'s content
-     * property, `[1, "notes"]` a leaf under both.
+     * property, `[1, "notes"]` a leaf under both, `["controlled_by"]` a
+     * variant's cell.
      *
      * The codec is the leaf's declared type's, so the caller stops deciding
      * what an element's stored bytes mean. Total over the storage form, as the

package/backends/typst/wasm.js

@@ -196,7 +196,8 @@ export class Document {
      * and [`reader.getContent`](Self::reader_get_content) with the path spelled
      * out. `path` is a `PathStep[]` from the field to the leaf — `[0]` an
      * element of an `array<richtext>`, `["motto"]` an `object`'s content
-     * property, `[1, "notes"]` a leaf under both.
+     * property, `[1, "notes"]` a leaf under both, `["controlled_by"]` a
+     * variant's cell.
      *
      * The codec is the leaf's declared type's, so the caller stops deciding
      * what an element's stored bytes mean. Total over the storage form, as the

package/core/wasm.js

@@ -196,7 +196,8 @@ export class Document {
      * and [`reader.getContent`](Self::reader_get_content) with the path spelled
      * out. `path` is a `PathStep[]` from the field to the leaf — `[0]` an
      * element of an `array<richtext>`, `["motto"]` an `object`'s content
-     * property, `[1, "notes"]` a leaf under both.
+     * property, `[1, "notes"]` a leaf under both, `["controlled_by"]` a
+     * variant's cell.
      *
      * The codec is the leaf's declared type's, so the caller stops deciding
      * what an element's stored bytes mean. Total over the storage form, as the

package/package.json

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

package/runtime/runtime.d.ts

@@ -771,10 +771,10 @@ export declare class DocumentReader {
 	/**
 	 * Read the `Content` nested inside the composite field at `addr`, at `path`:
 	 * `[0]` an element of an `array<richtext>`, `["motto"]` an object's content
-	 * property, `[1, "notes"]` a leaf under both. The codec is the leaf's declared
-	 * type's, resolved through the field schema's `items` / `properties`, so the
-	 * element's storage form is not the caller's business. The empty path is
-	 * {@link getContent}.
+	 * property, `[1, "notes"]` a leaf under both, `["controlled_by"]` a variant's
+	 * cell. The codec is the leaf's declared type's, resolved through the field
+	 * schema's `items` / `properties` / `variants`, so the element's storage
+	 * form is not the caller's business. The empty path is {@link getContent}.
 	 *
 	 * `undefined` for an absent field and for a path that names nothing in the
 	 * stored value: a repeater's row index goes stale between derive and read,

package/runtime/runtime.js

@@ -1205,7 +1205,8 @@ export class DocumentReader {
 	/**
 	 * Read the `Content` nested inside the composite field at `addr`, at `path`:
 	 * `[0]` an `array<richtext>` element, `["motto"]` an object's content property,
-	 * `[1, "notes"]` a leaf under both. The codec is the leaf's declared type's.
+	 * `[1, "notes"]` a leaf under both, `["controlled_by"]` a variant's cell. The
+	 * codec is the leaf's declared type's.
 	 * `undefined` for an absent field and for a path that names nothing stored;
 	 * throws `UnknownField`, `FieldNotContent` when `path` resolves to no content
 	 * leaf, `FieldDecode` anchored at the addressed path, and `IndexOutOfRange`.