@quillmark/wasm 0.87.1 → 0.87.3

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## v0.87.3 - 2026-06-04
+
+- Complete and consolidate the $ext mutator surface (#689)
+- Complete the `$ext` mutator matrix with namespace-scoped removal and
+  card-indexed namespace ops: `remove_ext_namespace` (Rust `Card`,
+  `removeExtNamespace` WASM, `remove_ext_namespace` Python) plus
+  `setCardExtNamespace` / `removeCardExtNamespace`. Deleting a sub-namespace
+  is now the preferred way to clear `$ext` state — it preserves sibling
+  consumers' slots and drops `$ext` entirely once empty, where `removeExt`
+  remains a blunt clear-everything escape hatch.
+- **Breaking (bindings):** the whole-map card mutator `updateCardExt` /
+  `update_card_ext` is renamed `setCardExt` / `set_card_ext` for naming
+  consistency with `setExt` on the main card.
+
+## 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)

package/bundler/wasm.d.ts

@@ -325,11 +325,37 @@ export class Document {
      */
     static quillRefHint(): string;
     removeCard(index: number): Card | undefined;
+    /**
+     * Remove the `$ext` map from the composable card at `index` *entirely*,
+     * returning the previous map or `undefined`. Throws if out of range.
+     * Prefer `removeCardExtNamespace` to clear only one consumer's slot.
+     */
+    removeCardExt(index: number): Record<string, unknown> | undefined;
+    /**
+     * Remove `namespace` from the composable card's `$ext` map, returning the
+     * value stored there or `undefined`; clears `$ext` entirely once empty.
+     * The card-indexed twin of `removeExtNamespace`. Throws if out of range.
+     */
+    removeCardExtNamespace(index: number, namespace: string): any;
     /**
      * 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 *entirely*, returning the
+     * previous map or `undefined`. This is a blunt escape hatch that discards
+     * every namespace at once — prefer `removeExtNamespace` to clear only your
+     * own slot while leaving sibling consumers' state intact.
+     */
+    removeExt(): Record<string, unknown> | undefined;
+    /**
+     * Remove `namespace` from the main card's `$ext` map, returning the value
+     * stored there or `undefined`. This is the recommended way to clear `$ext`
+     * state: sibling namespaces survive, and when the last namespace is removed
+     * the `$ext` entry is dropped entirely (not left as `$ext: {}`).
+     */
+    removeExtNamespace(namespace: string): any;
     /**
      * 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_]*`.
@@ -343,12 +369,38 @@ export class Document {
      * `fromJson` throws.
      */
     static schemaVersionOf(json: string): string | undefined;
+    /**
+     * Replace the `$ext` map on the composable card at `index`. Throws if out
+     * of range or `value` is not a plain object. Named to mirror `setExt` on
+     * the main card; `setCardExtNamespace` is the sibling-safe alternative.
+     */
+    setCardExt(index: number, value: any): void;
+    /**
+     * Merge `value` into the composable card's `$ext` map under `namespace`,
+     * preserving sibling namespaces. The card-indexed twin of `setExtNamespace`.
+     * Throws if out of range or `value` cannot be serialized.
+     */
+    setCardExtNamespace(index: number, namespace: string, value: any): void;
     /**
      * Replace the kind of the card at `index`. Payload and body are untouched;
      * schema-aware migration is the caller's responsibility.
      * 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.
      *

package/bundler/wasm_bg.js

@@ -308,6 +308,53 @@ export class Document {
         const ret = wasm.document_removeCard(this.__wbg_ptr, index);
         return takeObject(ret);
     }
+    /**
+     * Remove the `$ext` map from the composable card at `index` *entirely*,
+     * returning the previous map or `undefined`. Throws if out of range.
+     * Prefer `removeCardExtNamespace` to clear only one consumer's slot.
+     * @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 `namespace` from the composable card's `$ext` map, returning the
+     * value stored there or `undefined`; clears `$ext` entirely once empty.
+     * The card-indexed twin of `removeExtNamespace`. Throws if out of range.
+     * @param {number} index
+     * @param {string} namespace
+     * @returns {any}
+     */
+    removeCardExtNamespace(index, namespace) {
+        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_removeCardExtNamespace(retptr, this.__wbg_ptr, index, ptr0, len0);
+            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.
@@ -332,6 +379,31 @@ export class Document {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Remove the `$ext` map from the main card *entirely*, returning the
+     * previous map or `undefined`. This is a blunt escape hatch that discards
+     * every namespace at once — prefer `removeExtNamespace` to clear only your
+     * own slot while leaving sibling consumers' state intact.
+     * @returns {Record<string, unknown> | undefined}
+     */
+    removeExt() {
+        const ret = wasm.document_removeExt(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+     * Remove `namespace` from the main card's `$ext` map, returning the value
+     * stored there or `undefined`. This is the recommended way to clear `$ext`
+     * state: sibling namespaces survive, and when the last namespace is removed
+     * the `$ext` entry is dropped entirely (not left as `$ext: {}`).
+     * @param {string} namespace
+     * @returns {any}
+     */
+    removeExtNamespace(namespace) {
+        const ptr0 = passStringToWasm0(namespace, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.document_removeExtNamespace(this.__wbg_ptr, ptr0, len0);
+        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_]*`.
@@ -389,6 +461,49 @@ export class Document {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Replace the `$ext` map on the composable card at `index`. Throws if out
+     * of range or `value` is not a plain object. Named to mirror `setExt` on
+     * the main card; `setCardExtNamespace` is the sibling-safe alternative.
+     * @param {number} index
+     * @param {any} value
+     */
+    setCardExt(index, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.document_setCardExt(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);
+        }
+    }
+    /**
+     * Merge `value` into the composable card's `$ext` map under `namespace`,
+     * preserving sibling namespaces. The card-indexed twin of `setExtNamespace`.
+     * Throws if out of range or `value` cannot be serialized.
+     * @param {number} index
+     * @param {string} namespace
+     * @param {any} value
+     */
+    setCardExtNamespace(index, 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_setCardExtNamespace(retptr, this.__wbg_ptr, index, 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);
+        }
+    }
     /**
      * Replace the kind of the card at `index`. Payload and body are untouched;
      * schema-aware migration is the caller's responsibility.
@@ -411,6 +526,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.
      *

package/bundler/wasm_bg.wasm.d.ts

@@ -22,11 +22,19 @@ 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_removeCardExtNamespace: (a: number, b: number, c: number, d: number, e: 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_removeExtNamespace: (a: number, b: number, c: 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_setCardExt: (a: number, b: number, c: number, d: number) => void;
+export const document_setCardExtNamespace: (a: number, b: number, c: number, d: number, e: number, f: 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;

package/package.json

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