@scalable-vector-audio/sva-wasm 0.7.3 → 0.7.5

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.3",
+  "version": "0.7.5",
   "license": "MIT",
   "repository": {
     "type": "git",

package/sva_wasm.d.ts

@@ -74,35 +74,47 @@ 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. An edit lands at the first block boundary after the store
- * answered it; `next` and every getter answer meanwhile.
+ * once the stream passes its support. An edit lands at the first block boundary
+ * after the store answered it; `read` 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, 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.
+     * Writes frames from sample `at` into `out` (a SharedArrayBuffer view too) interleaved,
+     * `out[i * channels + c]`, and returns how many: `out.length / channels`, fewer at the end.
+     * A later `at` skips; live, what needed the span starts silent, in `stats().dropped`.
      */
-    next(out: Float32Array): number;
+    read(at: number, 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.
@@ -159,23 +171,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_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];
     readonly stream_fetch: (a: number) => any;
     readonly stream_held_bytes: (a: number) => number;
-    readonly stream_next: (a: number, b: number, c: number, d: any) => [number, number, number];
+    readonly stream_landed: (a: number, b: number) => [number, number];
     readonly stream_position: (a: number) => number;
+    readonly stream_read: (a: number, b: number, c: any) => [number, number, number];
     readonly stream_remove: (a: number, b: number) => any;
-    readonly stream_replace: (a: number, b: number, c: number, d: number) => any;
+    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__hc194386506580090: (a: number, b: number) => any;
+    readonly wasm_bindgen__convert__closures_____invoke__hdbc466ca7f9f0a3d: (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

@@ -323,8 +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. An edit lands at the first block boundary after the store
- * answered it; `next` and every getter answer meanwhile.
+ * once the stream passes its support. An edit lands at the first block boundary
+ * after the store answered it; `read` and every getter answer meanwhile.
  */
 export class Stream {
     static __wrap(ptr) {
@@ -344,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;
     }
     /**
@@ -369,7 +371,19 @@ export class Stream {
         return ret >>> 0;
     }
     /**
-     * `expr` in place of the target.
+     * `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 takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * `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>}
      */
@@ -402,19 +416,12 @@ export class Stream {
         return ret;
     }
     /**
-     * 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.
-     * @param {Float32Array} out
-     * @returns {number}
+     * @param {number} handle
+     * @returns {number | undefined}
      */
-    next(out) {
-        var ptr0 = passArrayF32ToWasm0(out, wasm.__wbindgen_malloc);
-        var len0 = WASM_VECTOR_LEN;
-        const ret = wasm.stream_next(this.__wbg_ptr, ptr0, len0, out);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return ret[0] >>> 0;
+    landed(handle) {
+        const ret = wasm.stream_landed(this.__wbg_ptr, handle);
+        return ret[0] === 0 ? undefined : ret[1];
     }
     /**
      * @returns {number}
@@ -423,6 +430,21 @@ export class Stream {
         const ret = wasm.stream_position(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * Writes frames from sample `at` into `out` (a SharedArrayBuffer view too) interleaved,
+     * `out[i * channels + c]`, and returns how many: `out.length / channels`, fewer at the end.
+     * A later `at` skips; live, what needed the span starts silent, in `stats().dropped`.
+     * @param {number} at
+     * @param {Float32Array} out
+     * @returns {number}
+     */
+    read(at, out) {
+        const ret = wasm.stream_read(this.__wbg_ptr, at, out);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * @param {number} handle
      * @returns {Promise<boolean>}
@@ -432,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;
     }
     /**
@@ -451,6 +474,8 @@ export class Stream {
         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() {
@@ -507,9 +532,6 @@ function __wbg_get_imports() {
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_copy_to_typed_array_cccd104be8cf0b8d: function(arg0, arg1, arg2) {
-            new Uint8Array(arg2.buffer, arg2.byteOffset, arg2.byteLength).set(getArrayU8FromWasm0(arg0, arg1));
-        },
         __wbg___wbindgen_debug_string_0e68cf47c9cbd9b0: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -553,7 +575,7 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_997e73d32238e655: function(arg0) {
             arg0._wbg_cb_unref();
         },
-        __wbg_arrayBuffer_8fa1b62e3be35f83: function(arg0) {
+        __wbg_arrayBuffer_365a1d1685a4dba2: function(arg0) {
             const ret = arg0.arrayBuffer();
             return ret;
         },
@@ -565,7 +587,7 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_close_431a12f30dd16967: function(arg0) {
+        __wbg_close_3b77a51c1dcac752: function(arg0) {
             const ret = arg0.close();
             return ret;
         },
@@ -573,7 +595,7 @@ function __wbg_get_imports() {
             const ret = Composition.__wrap(arg0);
             return ret;
         },
-        __wbg_createWritable_39924c898fe58254: function(arg0) {
+        __wbg_createWritable_bae1c9fdac782d30: function(arg0) {
             const ret = arg0.createWritable();
             return ret;
         },
@@ -585,15 +607,15 @@ function __wbg_get_imports() {
             const ret = Array.from(arg0);
             return ret;
         },
-        __wbg_getDirectoryHandle_a1f6c2ddc8e8180b: function(arg0, arg1, arg2, arg3) {
+        __wbg_getDirectoryHandle_473d1681af2be45f: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getDirectoryHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFileHandle_81f015ebb1e92030: function(arg0, arg1, arg2, arg3) {
+        __wbg_getFileHandle_99897b6c3d5e9074: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getFileHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFile_553fb0f9fc58716e: function(arg0) {
+        __wbg_getFile_88cdc01f283a7055: function(arg0) {
             const ret = arg0.getFile();
             return ret;
         },
@@ -623,7 +645,7 @@ function __wbg_get_imports() {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_keys_18de252854592697: function(arg0) {
+        __wbg_keys_362be373e394df7e: function(arg0) {
             const ret = arg0.keys();
             return ret;
         },
@@ -635,25 +657,29 @@ function __wbg_get_imports() {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_move_9838343335ced49d: function(arg0, arg1, arg2, arg3) {
+        __wbg_length_8768c6f6941913e3: function(arg0) {
+            const ret = arg0.length;
+            return ret;
+        },
+        __wbg_move_edc33b4719da771c: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.move(arg1, getStringFromWasm0(arg2, arg3));
             return ret;
         },
-        __wbg_name_1a1b7c43667f99f5: function(arg0, arg1) {
+        __wbg_name_6e7852ee6f2b7a8b: 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_11a85008814947b0: function(arg0, arg1) {
-            const ret = new Error(getStringFromWasm0(arg0, arg1));
-            return ret;
-        },
         __wbg_new_1da3429bc3c4541c: function(arg0) {
             const ret = new Uint8Array(arg0);
             return ret;
         },
+        __wbg_new_7a48d37babf8cc55: 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};
@@ -698,18 +724,18 @@ function __wbg_get_imports() {
                 state0.a = 0;
             }
         },
-        __wbg_next_791a8d00715c4466: function(arg0) {
+        __wbg_next_f2c96167b8bb87b6: function(arg0) {
             const ret = arg0.next();
             return ret;
         },
-        __wbg_parse_13fc413f981d786c: function() { return handleError(function (arg0, arg1) {
+        __wbg_parse_08ae2a4e53713e2e: 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_4f8c74fb7cf23e42: function(arg0) {
+        __wbg_query_d9edccbfa6c0e728: function(arg0) {
             const ret = arg0.query();
             return ret;
         },
@@ -724,11 +750,11 @@ function __wbg_get_imports() {
             const ret = Math.random();
             return ret;
         },
-        __wbg_removeEntry_3abdf44a9a4738c8: function(arg0, arg1, arg2) {
+        __wbg_removeEntry_18600e5dff7f249d: function(arg0, arg1, arg2) {
             const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
             return ret;
         },
-        __wbg_removeEntry_7914045ff1a983a4: function(arg0, arg1, arg2, arg3) {
+        __wbg_removeEntry_a339692b1dfb71b1: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
@@ -736,7 +762,7 @@ function __wbg_get_imports() {
             const ret = Rendering.__wrap(arg0);
             return ret;
         },
-        __wbg_request_6030b3039b1ae0dc: function(arg0, arg1, arg2, arg3) {
+        __wbg_request_6a40511b9f0e2911: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.request(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
@@ -748,17 +774,20 @@ function __wbg_get_imports() {
             const ret = Reflect.set(arg0, arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_set_name_93caa23cdf04a087: function(arg0, arg1, arg2) {
+        __wbg_set_c41f8dbc07a2190f: function(arg0, arg1, arg2) {
+            arg0.set(getArrayF32FromWasm0(arg1, arg2));
+        },
+        __wbg_set_name_4b9dcf4c83c869ae: function(arg0, arg1, arg2) {
             arg0.name = getStringFromWasm0(arg1, arg2);
         },
-        __wbg_set_refusal_280ba8e696e1aa4c: function(arg0, arg1) {
+        __wbg_set_refusal_a7ebf7dd502b61d1: function(arg0, arg1) {
             arg0.refusal = arg1;
         },
-        __wbg_size_ce4c161c70d82206: function(arg0) {
+        __wbg_size_d020191da61b5cb0: function(arg0) {
             const ret = arg0.size;
             return ret;
         },
-        __wbg_slice_6f166d9c74deb2bb: function(arg0, arg1, arg2) {
+        __wbg_slice_434fd5f1e8c04836: function(arg0, arg1, arg2) {
             const ret = arg0.slice(arg1, arg2);
             return ret;
         },
@@ -782,6 +811,10 @@ function __wbg_get_imports() {
             const ret = Stream.__wrap(arg0);
             return ret;
         },
+        __wbg_subarray_03833f2a8828b0c8: function(arg0, arg1, arg2) {
+            const ret = arg0.subarray(arg1 >>> 0, arg2 >>> 0);
+            return ret;
+        },
         __wbg_then_7a850dae4493f353: function(arg0, arg1, arg2) {
             const ret = arg0.then(arg1, arg2);
             return ret;
@@ -790,21 +823,21 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1);
             return ret;
         },
-        __wbg_warn_6232f611e2e359d1: function(arg0, arg1) {
+        __wbg_warn_b627ad1e6b70ad0c: function(arg0, arg1) {
             console.warn(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_write_c5dcd6f362f80fb4: function(arg0, arg1) {
+        __wbg_write_13ecd27d53c671a8: 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: 524, 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: 93, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__hc194386506580090);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 92, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__hdbc466ca7f9f0a3d);
             return ret;
         },
         __wbindgen_generic_0000000000000003: function(arg0) {
@@ -833,8 +866,8 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__hc194386506580090(arg0, arg1) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__hc194386506580090(arg0, arg1);
+function wasm_bindgen__convert__closures_____invoke__hdbc466ca7f9f0a3d(arg0, arg1) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__hdbc466ca7f9f0a3d(arg0, arg1);
     return ret;
 }
 
@@ -1013,13 +1046,6 @@ function makeMutClosure(arg0, arg1, f) {
     return real;
 }
 
-function passArrayF32ToWasm0(arg, malloc) {
-    const ptr = malloc(arg.length * 4, 4) >>> 0;
-    getFloat32ArrayMemory0().set(arg, ptr / 4);
-    WASM_VECTOR_LEN = arg.length;
-    return ptr;
-}
-
 function passArrayJsValueToWasm0(array, malloc) {
     const ptr = malloc(array.length * 4, 4) >>> 0;
     for (let i = 0; i < array.length; i++) {