@quillmark/wasm 0.87.0 → 0.87.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v0.87.2 - 2026-06-03
+
+- Expose $ext write path through the editor surface and bindings (#687)
+- Surface prose/canon entrypoint and fix canon documentation drift (#686)
+
+
+## v0.87.1 - 2026-06-01
+
+- Make $quill reference grammar a single source of truth (#684)
+- Remove stale FieldType::Date references and add rejection test (#683)
+
+
 ## v0.87.0 - 2026-06-01
 
 Arrays become first-class typed fields via a required `items` element

package/bundler/wasm.d.ts

@@ -316,12 +316,30 @@ export class Document {
      * Throws if `card.kind` is not a valid kind name.
      */
     pushCard(card: CardInput): void;
+    /**
+     * The canonical `$quill` reference grammar as author-facing text. Single
+     * source of truth (CLI, Python, MCP): drive schema `describe` and
+     * validation messages from this instead of re-stating the rule — it
+     * matches the `hint` on `parse::invalid_quill_reference`. Cache it; the
+     * value never changes.
+     */
+    static quillRefHint(): string;
     removeCard(index: number): Card | undefined;
+    /**
+     * Remove the `$ext` map from the card at `index`, returning the previous
+     * map or `undefined`. Throws if out of range.
+     */
+    removeCardExt(index: number): Record<string, unknown> | undefined;
     /**
      * Remove a field on the card at `index`. Returns the removed value or
      * `undefined`. Throws if `index` is out of range or `name` is invalid.
      */
     removeCardField(index: number, name: string): any;
+    /**
+     * Remove the `$ext` map from the main card, returning the previous map or
+     * `undefined`.
+     */
+    removeExt(): Record<string, unknown> | undefined;
     /**
      * Remove a payload field on the main card, returning the removed value or
      * `undefined`. Throws if `name` does not match `[a-z_][a-z0-9_]*`.
@@ -341,6 +359,20 @@ export class Document {
      * Throws if `index` is out of range or `newKind` is invalid.
      */
     setCardKind(index: number, new_kind: string): void;
+    /**
+     * Replace the opaque `$ext` map on the main card. `value` must be a plain
+     * object; throws otherwise. `$ext` carries out-of-band consumer state and
+     * never reaches the rendered output. Pass `{}` to record an explicit
+     * empty `$ext`.
+     */
+    setExt(value: any): void;
+    /**
+     * Merge `value` into the main card's `$ext` map under `namespace`, creating
+     * the map when absent and replacing any existing value at that key. Sibling
+     * namespaces are preserved, so independent consumers (`$ext.presentation`,
+     * `$ext.agent`, …) don't clobber each other.
+     */
+    setExtNamespace(namespace: string, value: any): void;
     /**
      * Update a payload field on the main card. Clears any existing `!fill` marker.
      *
@@ -384,6 +416,11 @@ export class Document {
      * Replace the body of the card at `index`. Throws if out of range.
      */
     updateCardBody(index: number, body: string): void;
+    /**
+     * Replace the `$ext` map on the card at `index`. Throws if out of range or
+     * `value` is not a plain object.
+     */
+    updateCardExt(index: number, value: any): void;
     /**
      * Update a field on the card at `index`.
      * Throws if `index` is out of range, `name` is reserved or invalid.

package/bundler/wasm_bg.js

@@ -276,6 +276,30 @@ export class Document {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * The canonical `$quill` reference grammar as author-facing text. Single
+     * source of truth (CLI, Python, MCP): drive schema `describe` and
+     * validation messages from this instead of re-stating the rule — it
+     * matches the `hint` on `parse::invalid_quill_reference`. Cache it; the
+     * value never changes.
+     * @returns {string}
+     */
+    static quillRefHint() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_quillRefHint(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);
+        }
+    }
     /**
      * @param {number} index
      * @returns {Card | undefined}
@@ -284,6 +308,27 @@ export class Document {
         const ret = wasm.document_removeCard(this.__wbg_ptr, index);
         return takeObject(ret);
     }
+    /**
+     * Remove the `$ext` map from the card at `index`, returning the previous
+     * map or `undefined`. Throws if out of range.
+     * @param {number} index
+     * @returns {Record<string, unknown> | undefined}
+     */
+    removeCardExt(index) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_removeCardExt(retptr, this.__wbg_ptr, index);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Remove a field on the card at `index`. Returns the removed value or
      * `undefined`. Throws if `index` is out of range or `name` is invalid.
@@ -308,6 +353,15 @@ export class Document {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Remove the `$ext` map from the main card, returning the previous map or
+     * `undefined`.
+     * @returns {Record<string, unknown> | undefined}
+     */
+    removeExt() {
+        const ret = wasm.document_removeExt(this.__wbg_ptr);
+        return takeObject(ret);
+    }
     /**
      * Remove a payload field on the main card, returning the removed value or
      * `undefined`. Throws if `name` does not match `[a-z_][a-z0-9_]*`.
@@ -387,6 +441,49 @@ export class Document {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Replace the opaque `$ext` map on the main card. `value` must be a plain
+     * object; throws otherwise. `$ext` carries out-of-band consumer state and
+     * never reaches the rendered output. Pass `{}` to record an explicit
+     * empty `$ext`.
+     * @param {any} value
+     */
+    setExt(value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_setExt(retptr, this.__wbg_ptr, addHeapObject(value));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Merge `value` into the main card's `$ext` map under `namespace`, creating
+     * the map when absent and replacing any existing value at that key. Sibling
+     * namespaces are preserved, so independent consumers (`$ext.presentation`,
+     * `$ext.agent`, …) don't clobber each other.
+     * @param {string} namespace
+     * @param {any} value
+     */
+    setExtNamespace(namespace, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.document_setExtNamespace(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(value));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Update a payload field on the main card. Clears any existing `!fill` marker.
      *
@@ -532,6 +629,25 @@ export class Document {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Replace the `$ext` map on the card at `index`. Throws if out of range or
+     * `value` is not a plain object.
+     * @param {number} index
+     * @param {any} value
+     */
+    updateCardExt(index, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_updateCardExt(retptr, this.__wbg_ptr, index, addHeapObject(value));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Update a field on the card at `index`.
      * Throws if `index` is out of range, `name` is reserved or invalid.

package/bundler/wasm_bg.wasm.d.ts

@@ -20,12 +20,17 @@ export const document_main: (a: number) => number;
 export const document_moveCard: (a: number, b: number, c: number, d: number) => void;
 export const document_pushCard: (a: number, b: number, c: number) => void;
 export const document_quillRef: (a: number, b: number) => void;
+export const document_quillRefHint: (a: number) => void;
 export const document_removeCard: (a: number, b: number) => number;
+export const document_removeCardExt: (a: number, b: number, c: number) => void;
 export const document_removeCardField: (a: number, b: number, c: number, d: number, e: number) => void;
+export const document_removeExt: (a: number) => number;
 export const document_removeField: (a: number, b: number, c: number, d: number) => void;
 export const document_replaceBody: (a: number, b: number, c: number) => void;
 export const document_schemaVersionOf: (a: number, b: number, c: number) => void;
 export const document_setCardKind: (a: number, b: number, c: number, d: number, e: number) => void;
+export const document_setExt: (a: number, b: number, c: number) => void;
+export const document_setExtNamespace: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setField: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setFill: (a: number, b: number, c: number, d: number, e: number) => void;
 export const document_setQuillRef: (a: number, b: number, c: number, d: number) => void;
@@ -33,6 +38,7 @@ export const document_toJson: (a: number, b: number) => void;
 export const document_toMarkdown: (a: number, b: number) => void;
 export const document_tryFromJson: (a: number, b: number) => number;
 export const document_updateCardBody: (a: number, b: number, c: number, d: number, e: number) => void;
+export const document_updateCardExt: (a: number, b: number, c: number, d: number) => void;
 export const document_updateCardField: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const document_warnings: (a: number) => number;
 export const init: () => void;

package/package.json

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