@scalable-vector-audio/sva-wasm 0.7.2 → 0.7.4

package/package.json

@@ -2,7 +2,7 @@
   "name": "@scalable-vector-audio/sva-wasm",
   "type": "module",
   "description": "JS bindings: a composition a page fills node by node, rendered in the browser",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "license": "MIT",
   "repository": {
     "type": "git",

package/sva_wasm.d.ts

@@ -9,7 +9,7 @@ export class Composition {
     constructor(name?: string | null);
     /**
      * Over the store in `dir`, an origin-private file system directory, or memory alone
-     * where there is none.
+     * where there is none or its store will not open.
      */
     static open(name?: string | null, dir?: FileSystemDirectoryHandle | null): Promise<Composition>;
     /**
@@ -32,7 +32,7 @@ export class Composition {
     set_prune_policy(policy: string): void;
     /**
      * `target` block by block, through this store. `options`: `rate`, `bits`, `until`, `cache`,
-     * `live`. Opening and every edit look the store on disk up, so each is awaited.
+     * `live`.
      */
     stream(target: string, block: number, options: any): Promise<Stream>;
     /**
@@ -74,26 +74,32 @@ export class Rendering {
 /**
  * A target block by block, reading `@notes` as the sum of its terms, as `@hall(t, x=@notes)`.
  * A key-up replaces a term with one whose release is a number. A term leaves with its handle
- * once its node ends, bar the last.
+ * once the stream passes its support, bar the last. An edit lands at the first block boundary
+ * after the store answered it; `next` and every getter answer meanwhile.
  */
 export class Stream {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * `term` summed into `@notes`.
+     * `term` summed into `@notes`. `options.at`: `"written"` (the stream's `t`) or
+     * `"landing"`, its sample 0 the sample it lands at.
      */
-    add(term: string): Promise<number>;
+    add(term: string, options?: any | null): Promise<number>;
     /**
-     * `expr` in place of the target.
+     * `late`: edits landed past where issued.
+     */
+    counts(): any;
+    /**
+     * `expr` in place of the target. Each edit's promise rejects as a `conflict` where the
+     * page frees the stream first.
      */
     edit(expr: string): Promise<void>;
     /**
-     * Reads the stored samples the next second of blocks plays, and the stream plays on
-     * meanwhile. A block reading stored samples not yet read computes them, or, live, starts
-     * the note silent where its live remainder is not ready.
+     * Reads the stored samples the next second of blocks plays, as the stream plays on.
      */
     fetch(): Promise<void>;
+    landed(handle: number): number | undefined;
     /**
      * Writes the next block into `out`, component `c` from `c * block`, and returns the
      * samples each component took: `block`, fewer where silence ends inside it, `0` after.
@@ -101,9 +107,13 @@ export class Stream {
     next(out: Float32Array): number;
     remove(handle: number): Promise<boolean>;
     /**
-     * False where the stream no longer holds `handle`.
+     * False where `handle` is gone. `"landing"`: where its add landed.
+     */
+    replace(handle: number, term: string, options?: any | null): Promise<boolean>;
+    /**
+     * Each list the latest; its `pagination.count` counts all. `pruned`: the level a term under
+     * which for good leaves the sum, and each node cut, at the sample it is zero from.
      */
-    replace(handle: number, term: string): Promise<boolean>;
     stats(): any;
     /**
      * `{ samples, priced_flops, waves }` since it opened.
@@ -160,23 +170,25 @@ export interface InitOutput {
     readonly rendering_stats: (a: number) => [number, number, number];
     readonly rendering_target: (a: number) => [number, number];
     readonly rendering_work: (a: number) => [number, number, number];
-    readonly stream_add: (a: number, b: number, c: number) => any;
-    readonly stream_block: (a: number) => [number, number, number];
-    readonly stream_channels: (a: number) => [number, number, number];
+    readonly stream_add: (a: number, b: number, c: number, d: number) => any;
+    readonly stream_block: (a: number) => number;
+    readonly stream_channels: (a: number) => number;
+    readonly stream_counts: (a: number) => [number, number, number];
     readonly stream_edit: (a: number, b: number, c: number) => any;
-    readonly stream_end: (a: number) => [number, number, number, number];
+    readonly stream_end: (a: number) => [number, number];
     readonly stream_fetch: (a: number) => any;
-    readonly stream_held_bytes: (a: number) => [number, number, number];
+    readonly stream_held_bytes: (a: number) => number;
+    readonly stream_landed: (a: number, b: number) => [number, number];
     readonly stream_next: (a: number, b: number, c: number, d: any) => [number, number, number];
-    readonly stream_position: (a: number) => [number, number, number];
+    readonly stream_position: (a: number) => number;
     readonly stream_remove: (a: number, b: number) => any;
-    readonly stream_replace: (a: number, b: number, c: number, d: number) => any;
-    readonly stream_sample_rate: (a: number) => [number, number, number];
+    readonly stream_replace: (a: number, b: number, c: number, d: number, e: number) => any;
+    readonly stream_sample_rate: (a: number) => number;
     readonly stream_stats: (a: number) => [number, number, number];
     readonly stream_work: (a: number) => [number, number, number];
     readonly wasm_bindgen__convert__closures_____invoke__h76bd71bceeca2b95: (a: number, b: number, c: any, d: any) => void;
     readonly wasm_bindgen__convert__closures_____invoke__hd55bb211d6a08150: (a: number, b: number, c: any) => [number, number];
-    readonly wasm_bindgen__convert__closures_____invoke__h1fa9803413ae3c8c: (a: number, b: number) => any;
+    readonly wasm_bindgen__convert__closures_____invoke__h99c3d187ea7e66d3: (a: number, b: number) => any;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store: (a: number) => void;

package/sva_wasm.js

@@ -87,7 +87,7 @@ export class Composition {
     }
     /**
      * Over the store in `dir`, an origin-private file system directory, or memory alone
-     * where there is none.
+     * where there is none or its store will not open.
      * @param {string | null} [name]
      * @param {FileSystemDirectoryHandle | null} [dir]
      * @returns {Promise<Composition>}
@@ -182,7 +182,7 @@ export class Composition {
     }
     /**
      * `target` block by block, through this store. `options`: `rate`, `bits`, `until`, `cache`,
-     * `live`. Opening and every edit look the store on disk up, so each is awaited.
+     * `live`.
      * @param {string} target
      * @param {number} block
      * @param {any} options
@@ -323,7 +323,8 @@ if (Symbol.dispose) Rendering.prototype[Symbol.dispose] = Rendering.prototype.fr
 /**
  * A target block by block, reading `@notes` as the sum of its terms, as `@hall(t, x=@notes)`.
  * A key-up replaces a term with one whose release is a number. A term leaves with its handle
- * once its node ends, bar the last.
+ * once the stream passes its support, bar the last. An edit lands at the first block boundary
+ * after the store answered it; `next` and every getter answer meanwhile.
  */
 export class Stream {
     static __wrap(ptr) {
@@ -343,14 +344,16 @@ export class Stream {
         wasm.__wbg_stream_free(ptr, 0);
     }
     /**
-     * `term` summed into `@notes`.
+     * `term` summed into `@notes`. `options.at`: `"written"` (the stream's `t`) or
+     * `"landing"`, its sample 0 the sample it lands at.
      * @param {string} term
+     * @param {any | null} [options]
      * @returns {Promise<number>}
      */
-    add(term) {
+    add(term, options) {
         const ptr0 = passStringToWasm0(term, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.stream_add(this.__wbg_ptr, ptr0, len0);
+        const ret = wasm.stream_add(this.__wbg_ptr, ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
         return ret;
     }
     /**
@@ -358,23 +361,29 @@ export class Stream {
      */
     get block() {
         const ret = wasm.stream_block(this.__wbg_ptr);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return ret[0] >>> 0;
+        return ret >>> 0;
     }
     /**
      * @returns {number}
      */
     get channels() {
         const ret = wasm.stream_channels(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * `late`: edits landed past where issued.
+     * @returns {any}
+     */
+    counts() {
+        const ret = wasm.stream_counts(this.__wbg_ptr);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
-        return ret[0] >>> 0;
+        return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * `expr` in place of the target.
+     * `expr` in place of the target. Each edit's promise rejects as a `conflict` where the
+     * page frees the stream first.
      * @param {string} expr
      * @returns {Promise<void>}
      */
@@ -389,15 +398,10 @@ export class Stream {
      */
     get end() {
         const ret = wasm.stream_end(this.__wbg_ptr);
-        if (ret[3]) {
-            throw takeFromExternrefTable0(ret[2]);
-        }
         return ret[0] === 0 ? undefined : ret[1];
     }
     /**
-     * Reads the stored samples the next second of blocks plays, and the stream plays on
-     * meanwhile. A block reading stored samples not yet read computes them, or, live, starts
-     * the note silent where its live remainder is not ready.
+     * Reads the stored samples the next second of blocks plays, as the stream plays on.
      * @returns {Promise<void>}
      */
     fetch() {
@@ -409,10 +413,15 @@ export class Stream {
      */
     get held_bytes() {
         const ret = wasm.stream_held_bytes(this.__wbg_ptr);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return ret[0];
+        return ret;
+    }
+    /**
+     * @param {number} handle
+     * @returns {number | undefined}
+     */
+    landed(handle) {
+        const ret = wasm.stream_landed(this.__wbg_ptr, handle);
+        return ret[0] === 0 ? undefined : ret[1];
     }
     /**
      * Writes the next block into `out`, component `c` from `c * block`, and returns the
@@ -434,10 +443,7 @@ export class Stream {
      */
     get position() {
         const ret = wasm.stream_position(this.__wbg_ptr);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return ret[0];
+        return ret;
     }
     /**
      * @param {number} handle
@@ -448,15 +454,16 @@ export class Stream {
         return ret;
     }
     /**
-     * False where the stream no longer holds `handle`.
+     * False where `handle` is gone. `"landing"`: where its add landed.
      * @param {number} handle
      * @param {string} term
+     * @param {any | null} [options]
      * @returns {Promise<boolean>}
      */
-    replace(handle, term) {
+    replace(handle, term, options) {
         const ptr0 = passStringToWasm0(term, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.stream_replace(this.__wbg_ptr, handle, ptr0, len0);
+        const ret = wasm.stream_replace(this.__wbg_ptr, handle, ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
         return ret;
     }
     /**
@@ -464,12 +471,11 @@ export class Stream {
      */
     get sample_rate() {
         const ret = wasm.stream_sample_rate(this.__wbg_ptr);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return ret[0] >>> 0;
+        return ret >>> 0;
     }
     /**
+     * Each list the latest; its `pagination.count` counts all. `pruned`: the level a term under
+     * which for good leaves the sum, and each node cut, at the sample it is zero from.
      * @returns {any}
      */
     stats() {
@@ -572,7 +578,7 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_997e73d32238e655: function(arg0) {
             arg0._wbg_cb_unref();
         },
-        __wbg_arrayBuffer_dbd53e75db738fae: function(arg0) {
+        __wbg_arrayBuffer_02aa4e2181f6c7ed: function(arg0) {
             const ret = arg0.arrayBuffer();
             return ret;
         },
@@ -584,7 +590,7 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_close_5aa4fdce5d27170d: function(arg0) {
+        __wbg_close_c9faf528adcf54fa: function(arg0) {
             const ret = arg0.close();
             return ret;
         },
@@ -592,7 +598,7 @@ function __wbg_get_imports() {
             const ret = Composition.__wrap(arg0);
             return ret;
         },
-        __wbg_createWritable_813278137702c672: function(arg0) {
+        __wbg_createWritable_f0a5a98a99f1c04e: function(arg0) {
             const ret = arg0.createWritable();
             return ret;
         },
@@ -604,15 +610,15 @@ function __wbg_get_imports() {
             const ret = Array.from(arg0);
             return ret;
         },
-        __wbg_getDirectoryHandle_abeab464f3c65f25: function(arg0, arg1, arg2, arg3) {
+        __wbg_getDirectoryHandle_d305b95848ed1223: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getDirectoryHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFileHandle_9b7788a10f51304f: function(arg0, arg1, arg2, arg3) {
+        __wbg_getFileHandle_b5f945fc68734fc5: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getFileHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFile_880d5e36fcbe5891: function(arg0) {
+        __wbg_getFile_dabe5116756354b9: function(arg0) {
             const ret = arg0.getFile();
             return ret;
         },
@@ -642,7 +648,7 @@ function __wbg_get_imports() {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_keys_bb1628b5f767331c: function(arg0) {
+        __wbg_keys_460b0697b08c92c0: function(arg0) {
             const ret = arg0.keys();
             return ret;
         },
@@ -654,18 +660,21 @@ function __wbg_get_imports() {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_move_7b940aab376195ce: function(arg0, arg1, arg2, arg3) {
+        __wbg_move_824e3de963dcb59e: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.move(arg1, getStringFromWasm0(arg2, arg3));
             return ret;
         },
+        __wbg_name_d25ff35a3709031f: function(arg0, arg1) {
+            const ret = arg1.name;
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
         __wbg_new_1da3429bc3c4541c: function(arg0) {
             const ret = new Uint8Array(arg0);
             return ret;
         },
-        __wbg_new_536d8ff546834a3d: function(arg0, arg1) {
-            const ret = new Error(getStringFromWasm0(arg0, arg1));
-            return ret;
-        },
         __wbg_new_8f72ed7c652bf5a2: function(arg0, arg1) {
             try {
                 var state0 = {a: arg0, b: arg1};
@@ -688,6 +697,10 @@ function __wbg_get_imports() {
             const ret = new Object();
             return ret;
         },
+        __wbg_new_de6ef68ed26ef76a: function(arg0, arg1) {
+            const ret = new Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
         __wbg_new_from_slice_4ee02165f9de919e: function(arg0, arg1) {
             const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
             return ret;
@@ -710,18 +723,18 @@ function __wbg_get_imports() {
                 state0.a = 0;
             }
         },
-        __wbg_next_f4b7785cddb77159: function(arg0) {
+        __wbg_next_4ececa9fa46caff7: function(arg0) {
             const ret = arg0.next();
             return ret;
         },
-        __wbg_parse_77f086087c089de1: function() { return handleError(function (arg0, arg1) {
+        __wbg_parse_4282218725f51d78: function() { return handleError(function (arg0, arg1) {
             const ret = JSON.parse(getStringFromWasm0(arg0, arg1));
             return ret;
         }, arguments); },
         __wbg_prototypesetcall_ae9f5e7459250748: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_query_3333eea8f8b016ee: function(arg0) {
+        __wbg_query_2bab8ab6bd3c03ee: function(arg0) {
             const ret = arg0.query();
             return ret;
         },
@@ -736,11 +749,11 @@ function __wbg_get_imports() {
             const ret = Math.random();
             return ret;
         },
-        __wbg_removeEntry_2a712749f1dc4003: function(arg0, arg1, arg2, arg3) {
+        __wbg_removeEntry_7faa28015ba45f4d: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_removeEntry_7ea9843e2b12fd01: function(arg0, arg1, arg2) {
+        __wbg_removeEntry_c243351d137728ef: function(arg0, arg1, arg2) {
             const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
             return ret;
         },
@@ -748,7 +761,7 @@ function __wbg_get_imports() {
             const ret = Rendering.__wrap(arg0);
             return ret;
         },
-        __wbg_request_8ca00ebd07e4a6e8: function(arg0, arg1, arg2, arg3) {
+        __wbg_request_e5098c5a6c3a0def: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.request(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
@@ -760,17 +773,17 @@ function __wbg_get_imports() {
             const ret = Reflect.set(arg0, arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_set_name_676ed49f8d7df324: function(arg0, arg1, arg2) {
+        __wbg_set_name_0d2b021786d55b39: function(arg0, arg1, arg2) {
             arg0.name = getStringFromWasm0(arg1, arg2);
         },
-        __wbg_set_refusal_e944caff565482ce: function(arg0, arg1) {
+        __wbg_set_refusal_877c7b5dad993d0f: function(arg0, arg1) {
             arg0.refusal = arg1;
         },
-        __wbg_size_98080bde78dcec98: function(arg0) {
+        __wbg_size_792e8a25bb0824cb: function(arg0) {
             const ret = arg0.size;
             return ret;
         },
-        __wbg_slice_d3997ea27cf70829: function(arg0, arg1, arg2) {
+        __wbg_slice_a4e27652a4c64ce3: function(arg0, arg1, arg2) {
             const ret = arg0.slice(arg1, arg2);
             return ret;
         },
@@ -802,18 +815,21 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1);
             return ret;
         },
-        __wbg_write_84516362671d6058: function(arg0, arg1) {
+        __wbg_warn_9656c2adf297a87c: function(arg0, arg1) {
+            console.warn(getStringFromWasm0(arg0, arg1));
+        },
+        __wbg_write_f437168441a656ec: function(arg0, arg1) {
             const ret = arg0.write(arg1);
             return ret;
         },
         __wbindgen_generic_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 540, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 538, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__hd55bb211d6a08150);
             return ret;
         },
         __wbindgen_generic_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 90, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h1fa9803413ae3c8c);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 91, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h99c3d187ea7e66d3);
             return ret;
         },
         __wbindgen_generic_0000000000000003: function(arg0) {
@@ -842,8 +858,8 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__h1fa9803413ae3c8c(arg0, arg1) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h1fa9803413ae3c8c(arg0, arg1);
+function wasm_bindgen__convert__closures_____invoke__h99c3d187ea7e66d3(arg0, arg1) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h99c3d187ea7e66d3(arg0, arg1);
     return ret;
 }