@quillmark/wasm 0.84.0 → 0.85.0

package/README.md

@@ -254,7 +254,7 @@ A field's *cell* is inferred from whether its schema declares a `default:`:
   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
+  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

package/bundler/wasm.d.ts

@@ -221,7 +221,7 @@ export interface Diagnostic {
     location?: Location;
     path?: string;
     hint?: string;
-    sourceChain: string[];
+    sourceChain?: string[];
 }
 
 export interface Location {
@@ -257,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).
@@ -269,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.84.0",
+  "version": "0.85.0",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",