@quillmark/wasm 0.88.0-rc.1 → 0.88.0

package/CHANGELOG.md

@@ -1,18 +1,6 @@
 # Changelog
 
-## v0.88.0-rc.1 - 2026-06-05
-
-- blueprint: flatten group_fields, drop unused group label (#697)
-- Update CLAUDE.md
-- Expose seedMain/seedCard to WASM + Python bindings (#696)
-- docs: note that released migration guides are era-accurate and immutable (#695)
-- Remove form-view projection; add Quill::validate (#694)
-- Remove example() reference document, fold into seeding (#693)
-- Document seeding (example → absent) + block-scalar prescan fix + commitment-ladder docs (#691)
-- docs(canon): dedup field-resolution semantics into SCHEMAS (#692)
-
-
-## Unreleased
+## v0.88.0 - 2026-06-05
 
 - **Breaking (bindings + Rust API):** a single canonical **`Card` wire shape** now
   flows in *both* directions. Core owns it as `quillmark_core::CardWire` (with
@@ -31,7 +19,6 @@
   `Result<(), EditError>` and, with `insert_card`, validates that the card's
   `$kind` is a valid, non-reserved composable kind — the cards-list invariant is
   enforced at the edit op rather than incidentally at `Card::new`.
-
 - **Breaking (bindings + Rust API):** the schema-aware **form view is removed**.
   `Quill::form` / `Quill::blank_main` / `Quill::blank_card` (and the
   `quill.form` / `blankMain` / `blankCard` bindings) are gone, along with the
@@ -62,6 +49,25 @@
   authoring surface is `blueprint()`), so the projection collapses into the
   seed: internally the `FillSource` fork in blueprint emission is gone and the
   blueprint always renders `default:` else the `<must-fill>` sentinel.
+- **wasm:** lower the npm package `engines.node` floor from `>=24` to `>=22`.
+  The runtime never required 24 — `--weak-refs` needs only Node 14.6+, and the
+  `using` sugar that motivated the 24 floor is optional (a `try` / `finally`
+  fallback covers Node 22). The aggressive floor hard-blocked installs on Node
+  22 CI/dev images under `engine-strict`.
+- **wasm:** `Document.makeCard(kind, fields?, body?)` now types `fields` as
+  optional in the generated `.d.ts` (was required, contradicting its docs);
+  omitting it yields an empty field map, as before.
+- **docs:** fix the `Quill.schema` getter doc — the returned schema **includes**
+  `ui` hints (it never stripped them); the stale "ui hints stripped" wording is
+  corrected. The 0.87→0.88 migration guide now documents the `fill` flag's
+  `!fill`-placeholder semantics and clarifies that seeding is example-filled,
+  not a blank-form replacement.
+- **blueprint:** flatten `group_fields` and drop the unused group label (#697).
+- **docs:** document seeding (example → absent), fix a block-scalar prescan
+  bug, and add commitment-ladder docs (#691).
+- **docs(canon):** dedup field-resolution semantics into SCHEMAS (#692); note
+  that released migration guides are era-accurate and immutable (#695); prune
+  evolutionary information from comments and canon docs (#700).
 
 ## v0.87.3 - 2026-06-04
 

package/README.md

@@ -329,9 +329,10 @@ The wasm bindings are built with `--weak-refs`, so dropped `Document`,
 without manual `.free()` discipline. `.free()` is still emitted as an eager
 teardown hook for callers that want deterministic release.
 
-The package requires Node 24+ (`engines: { node: ">=24" }`) and current
-evergreen browsers; `--weak-refs` itself only needs Node 14.6+, but the
-published package floor is 24.
+The package floor is Node 22+ (`engines: { node: ">=22" }`) and current
+evergreen browsers; `--weak-refs` itself only needs Node 14.6+. The `using`
+sugar shown below ([explicit resource management][erm]) needs Node 24, but is
+optional — the `try` / `finally` fallback runs on the Node 22 floor.
 
 For environments where `using` (the [explicit resource management][erm]
 proposal) hasn't landed, use an explicit `try` / `finally`:

package/bundler/wasm.d.ts

@@ -494,7 +494,10 @@ export class Quill {
      */
     readonly metadata: QuillMetadata;
     /**
-     * Document schema with `ui` hints stripped — for LLM/MCP consumers.
+     * Document schema for the quill: the user-fillable fields plus their
+     * `ui` hints (group / order / showWhen). The single field-metadata
+     * surface — drives form editors and LLM/MCP consumers alike. Returns the
+     * `QuillSchema` shape.
      */
     readonly schema: QuillSchema;
     /**

package/bundler/wasm_bg.js

@@ -240,7 +240,7 @@ export class Document {
             const len0 = WASM_VECTOR_LEN;
             var ptr1 = isLikeNone(body) ? 0 : passStringToWasm0(body, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             var len1 = WASM_VECTOR_LEN;
-            wasm.document_makeCard(retptr, ptr0, len0, addHeapObject(fields), ptr1, len1);
+            wasm.document_makeCard(retptr, ptr0, len0, isLikeNone(fields) ? 0 : addHeapObject(fields), ptr1, len1);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -887,7 +887,10 @@ export class Quill {
         }
     }
     /**
-     * Document schema with `ui` hints stripped — for LLM/MCP consumers.
+     * Document schema for the quill: the user-fillable fields plus their
+     * `ui` hints (group / order / showWhen). The single field-metadata
+     * surface — drives form editors and LLM/MCP consumers alike. Returns the
+     * `QuillSchema` shape.
      * @returns {QuillSchema}
      */
     get schema() {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.88.0-rc.1",
+  "version": "0.88.0",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",
   "engines": {
-    "node": ">=24"
+    "node": ">=22"
   },
   "repository": {
     "type": "git",