@quillmark/wasm 0.87.2 → 0.87.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # 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)

package/bundler/wasm.d.ts

@@ -326,20 +326,36 @@ export class Document {
     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.
+     * 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, returning the previous map or
-     * `undefined`.
+     * 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_]*`.
@@ -353,6 +369,18 @@ 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.
@@ -416,11 +444,6 @@ 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

@@ -309,8 +309,9 @@ export class Document {
         return takeObject(ret);
     }
     /**
-     * Remove the `$ext` map from the card at `index`, returning the previous
-     * map or `undefined`. Throws if out of range.
+     * 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}
      */
@@ -329,6 +330,31 @@ export class Document {
             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.
@@ -354,14 +380,30 @@ export class Document {
         }
     }
     /**
-     * Remove the `$ext` map from the main card, returning the previous map or
-     * `undefined`.
+     * 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_]*`.
@@ -419,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.
@@ -629,25 +714,6 @@ 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

@@ -23,11 +23,15 @@ 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;
@@ -38,7 +42,6 @@ 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.2",
+  "version": "0.87.3",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",