@quillmark/wasm 0.83.0 → 0.84.0

package/README.md

@@ -244,6 +244,24 @@ canvas.style.height = `${result.layoutHeight}px`;
   enforcement contract and includes the resolved `backendId` for
   debugging.
 
+### Schema model
+
+A field's *cell* is inferred from whether its schema declares a `default:`:
+
+- **Must Fill** (no `default:`) — `quill.blueprint` renders `<must-fill>`
+  in the value cell, and `quill.render(doc)` throws with
+  `validation::must_fill_absent` when the field is absent at
+  validate time, or `validation::must_fill_sentinel` when the
+  `<must-fill>` sentinel survives into the document.
+- **Endorsed** (with `default:`) — `quill.blueprint` renders the
+  default value followed by a `; skip-ok` annotation, and the default
+  is used when the document omits the field.
+
+`QuillFieldSchema` no longer carries a `required` axis. The legacy
+`validation::missing_required` code has been replaced by
+`validation::must_fill_absent`; the `validation::must_fill_sentinel`
+code covers unreplaced sentinels.
+
 ### Errors
 
 Every method that can fail throws a JS `Error` with `.diagnostics` attached:

package/bundler/wasm.d.ts

@@ -106,13 +106,20 @@ export interface QuillCardBody {
     example?: string;
 }
 
-/** Schema entry for a single field declared in a quill's `Quill.yaml`. */
+/** Schema entry for a single field declared in a quill's `Quill.yaml`.
+ *
+ * A field's *cell* is determined by `default`: a field with a `default`
+ * is **Endorsed** (the rendered value is shippable as-is), while a field
+ * without a `default` is **Must Fill** (the blueprint carries a
+ * `<must-fill>` sentinel and validation reports
+ * `validation::must_fill_absent` if the field is absent at validate
+ * time). There is no separate `required` axis.
+ */
 export interface QuillFieldSchema {
     type: "string" | "number" | "integer" | "boolean" | "array" | "object" | "date" | "datetime" | "markdown";
     description?: string;
     default?: unknown;
     example?: unknown;
-    required?: boolean;
     enum?: string[];
     ui?: QuillFieldUi;
     properties?: Record<string, QuillFieldSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.83.0",
+  "version": "0.84.0",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",