@quillmark/wasm 0.83.0 → 0.85.0-rc.1

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 `; delete-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>;
@@ -214,7 +221,7 @@ export interface Diagnostic {
     location?: Location;
     path?: string;
     hint?: string;
-    sourceChain: string[];
+    sourceChain?: string[];
 }
 
 export interface Location {
@@ -250,6 +257,12 @@ export class Document {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Authoring-ergonomics header introducing a blueprint to an LLM/MCP
+     * consumer for the given `quillName`. Surfaced verbatim by every binding
+     * so the wording stays uniform across CLI / Python / MCP.
+     */
+    static blueprintInstruction(quill_name: string): string;
     clone(): Document;
     /**
      * Schema version this build writes via [`toJson`](Document::to_json).
@@ -262,6 +275,19 @@ export class Document {
      * upstream prop updates instead of re-parsing on every keystroke.
      */
     equals(other: Document): boolean;
+    /**
+     * Render a Diagnostic as the canonical pretty-printed text every binding
+     * shows (CLI, Python, MCP). Single source of truth so a Diagnostic looks
+     * identical no matter which consumer surfaces it.
+     */
+    static formatDiagnostic(diag: Diagnostic): string;
+    /**
+     * Authoring-format rules for the card-yaml markdown surface — the same
+     * text every binding (CLI, Python, MCP) shows so callers reading errors
+     * from one binding can use the rules from any other. Read once at
+     * startup and cache; the value never changes between calls.
+     */
+    static formatRules(): string;
     /**
      * Reconstruct a `Document` from a versioned storage DTO string produced
      * by [`toJson`](Document::to_json). Unknown `schema` tags are rejected.

package/bundler/wasm_bg.js

@@ -19,6 +19,31 @@ export class Document {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_document_free(ptr, 0);
     }
+    /**
+     * Authoring-ergonomics header introducing a blueprint to an LLM/MCP
+     * consumer for the given `quillName`. Surfaced verbatim by every binding
+     * so the wording stays uniform across CLI / Python / MCP.
+     * @param {string} quill_name
+     * @returns {string}
+     */
+    static blueprintInstruction(quill_name) {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(quill_name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_blueprintInstruction(retptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred2_0 = r0;
+            deferred2_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+        }
+    }
     /**
      * Number of composable cards (excludes the main card). O(1).
      * @returns {number}
@@ -74,6 +99,52 @@ export class Document {
         const ret = wasm.document_equals(this.__wbg_ptr, other.__wbg_ptr);
         return ret !== 0;
     }
+    /**
+     * Render a Diagnostic as the canonical pretty-printed text every binding
+     * shows (CLI, Python, MCP). Single source of truth so a Diagnostic looks
+     * identical no matter which consumer surfaces it.
+     * @param {Diagnostic} diag
+     * @returns {string}
+     */
+    static formatDiagnostic(diag) {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_formatDiagnostic(retptr, addHeapObject(diag));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * Authoring-format rules for the card-yaml markdown surface — the same
+     * text every binding (CLI, Python, MCP) shows so callers reading errors
+     * from one binding can use the rules from any other. Read once at
+     * startup and cache; the value never changes between calls.
+     * @returns {string}
+     */
+    static formatRules() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_formatRules(retptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Reconstruct a `Document` from a versioned storage DTO string produced
      * by [`toJson`](Document::to_json). Unknown `schema` tags are rejected.

package/bundler/wasm_bg.wasm.d.ts

@@ -5,11 +5,14 @@ export const __wbg_document_free: (a: number, b: number) => void;
 export const __wbg_quill_free: (a: number, b: number) => void;
 export const __wbg_quillmark_free: (a: number, b: number) => void;
 export const __wbg_rendersession_free: (a: number, b: number) => void;
+export const document_blueprintInstruction: (a: number, b: number, c: number) => void;
 export const document_cardCount: (a: number) => number;
 export const document_cards: (a: number) => number;
 export const document_clone: (a: number) => number;
 export const document_currentSchemaVersion: (a: number) => void;
 export const document_equals: (a: number, b: number) => number;
+export const document_formatDiagnostic: (a: number, b: number) => void;
+export const document_formatRules: (a: number) => void;
 export const document_fromJson: (a: number, b: number, c: number) => void;
 export const document_fromMarkdown: (a: number, b: number, c: number) => void;
 export const document_insertCard: (a: number, b: number, c: number, d: number) => void;

package/package.json

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