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

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.1",
+  "version": "0.7.3",
   "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,9 +32,15 @@ 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>;
+    /**
+     * `target` staged as `render` would, until `persist`; `{ stats, representations }`,
+     * the latter `representations()` for `readings`, null unasked. Options: `rate`, `bits`,
+     * `flop_budget`, `readings`.
+     */
+    warm(target: string, options: any): Promise<any>;
     readonly cache_bytes: number;
     readonly cache_entries: number;
     readonly cache_evictions: number;
@@ -68,7 +74,8 @@ 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 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.
  */
 export class Stream {
     private constructor();
@@ -82,6 +89,10 @@ export class Stream {
      * `expr` in place of the target.
      */
     edit(expr: string): Promise<void>;
+    /**
+     * Reads the stored samples the next second of blocks plays, as the stream plays on.
+     */
+    fetch(): Promise<void>;
     /**
      * 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.
@@ -137,6 +148,7 @@ export interface InitOutput {
     readonly composition_set_cache_policy: (a: number, b: number, c: number) => [number, number];
     readonly composition_set_prune_policy: (a: number, b: number, c: number) => [number, number];
     readonly composition_stream: (a: number, b: number, c: number, d: number, e: any) => any;
+    readonly composition_warm: (a: number, b: number, c: number, d: any) => any;
     readonly outline: (a: number, b: number) => [number, number, number];
     readonly rendering_channels: (a: number) => number;
     readonly rendering_duration_secs: (a: number) => number;
@@ -148,21 +160,22 @@ export interface InitOutput {
     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_block: (a: number) => number;
+    readonly stream_channels: (a: number) => number;
     readonly stream_edit: (a: number, b: number, c: number) => any;
-    readonly stream_end: (a: number) => [number, number, number, number];
-    readonly stream_held_bytes: (a: number) => [number, number, number];
+    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_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_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__h3f8776df83dbd585: (a: number, b: number) => any;
+    readonly wasm_bindgen__convert__closures_____invoke__hc194386506580090: (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
@@ -194,6 +194,20 @@ export class Composition {
         const ret = wasm.composition_stream(this.__wbg_ptr, ptr0, len0, block, options);
         return ret;
     }
+    /**
+     * `target` staged as `render` would, until `persist`; `{ stats, representations }`,
+     * the latter `representations()` for `readings`, null unasked. Options: `rate`, `bits`,
+     * `flop_budget`, `readings`.
+     * @param {string} target
+     * @param {any} options
+     * @returns {Promise<any>}
+     */
+    warm(target, options) {
+        const ptr0 = passStringToWasm0(target, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.composition_warm(this.__wbg_ptr, ptr0, len0, options);
+        return ret;
+    }
 }
 if (Symbol.dispose) Composition.prototype[Symbol.dispose] = Composition.prototype.free;
 
@@ -309,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 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.
  */
 export class Stream {
     static __wrap(ptr) {
@@ -344,20 +359,14 @@ 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);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return ret[0] >>> 0;
+        return ret >>> 0;
     }
     /**
      * `expr` in place of the target.
@@ -375,20 +384,22 @@ 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, as the stream plays on.
+     * @returns {Promise<void>}
+     */
+    fetch() {
+        const ret = wasm.stream_fetch(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * @returns {number}
      */
     get held_bytes() {
         const ret = wasm.stream_held_bytes(this.__wbg_ptr);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return ret[0];
+        return ret;
     }
     /**
      * Writes the next block into `out`, component `c` from `c * block`, and returns the
@@ -410,10 +421,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
@@ -440,10 +448,7 @@ 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;
     }
     /**
      * @returns {any}
@@ -548,7 +553,7 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_997e73d32238e655: function(arg0) {
             arg0._wbg_cb_unref();
         },
-        __wbg_arrayBuffer_be9196be466b026c: function(arg0) {
+        __wbg_arrayBuffer_8fa1b62e3be35f83: function(arg0) {
             const ret = arg0.arrayBuffer();
             return ret;
         },
@@ -560,7 +565,7 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_close_3a3da2c0b5950d54: function(arg0) {
+        __wbg_close_431a12f30dd16967: function(arg0) {
             const ret = arg0.close();
             return ret;
         },
@@ -568,7 +573,7 @@ function __wbg_get_imports() {
             const ret = Composition.__wrap(arg0);
             return ret;
         },
-        __wbg_createWritable_7eba132720802ecc: function(arg0) {
+        __wbg_createWritable_39924c898fe58254: function(arg0) {
             const ret = arg0.createWritable();
             return ret;
         },
@@ -580,15 +585,15 @@ function __wbg_get_imports() {
             const ret = Array.from(arg0);
             return ret;
         },
-        __wbg_getDirectoryHandle_638d1a5c4bf1966d: function(arg0, arg1, arg2, arg3) {
+        __wbg_getDirectoryHandle_a1f6c2ddc8e8180b: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getDirectoryHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFileHandle_98d7c52e03604ca5: function(arg0, arg1, arg2, arg3) {
+        __wbg_getFileHandle_81f015ebb1e92030: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getFileHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFile_84e299f9ca29fcea: function(arg0) {
+        __wbg_getFile_553fb0f9fc58716e: function(arg0) {
             const ret = arg0.getFile();
             return ret;
         },
@@ -618,7 +623,7 @@ function __wbg_get_imports() {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_keys_c94929b6f83bc1b9: function(arg0) {
+        __wbg_keys_18de252854592697: function(arg0) {
             const ret = arg0.keys();
             return ret;
         },
@@ -630,10 +635,21 @@ function __wbg_get_imports() {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_move_8bee0fab8a394cb5: function(arg0, arg1, arg2, arg3) {
+        __wbg_move_9838343335ced49d: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.move(arg1, getStringFromWasm0(arg2, arg3));
             return ret;
         },
+        __wbg_name_1a1b7c43667f99f5: 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;
@@ -660,10 +676,6 @@ function __wbg_get_imports() {
             const ret = new Object();
             return ret;
         },
-        __wbg_new_c76aa635a13cdc59: 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;
@@ -686,18 +698,18 @@ function __wbg_get_imports() {
                 state0.a = 0;
             }
         },
-        __wbg_next_3e3ca2daea5cd939: function(arg0) {
+        __wbg_next_791a8d00715c4466: function(arg0) {
             const ret = arg0.next();
             return ret;
         },
-        __wbg_parse_27e7dc84974fe18b: function() { return handleError(function (arg0, arg1) {
+        __wbg_parse_13fc413f981d786c: 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_e8d4a4541f8a732e: function(arg0) {
+        __wbg_query_4f8c74fb7cf23e42: function(arg0) {
             const ret = arg0.query();
             return ret;
         },
@@ -712,19 +724,19 @@ function __wbg_get_imports() {
             const ret = Math.random();
             return ret;
         },
-        __wbg_removeEntry_31eaa4b3d8f57600: function(arg0, arg1, arg2, arg3) {
-            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
+        __wbg_removeEntry_3abdf44a9a4738c8: function(arg0, arg1, arg2) {
+            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
             return ret;
         },
-        __wbg_removeEntry_c2d36332ccabb790: function(arg0, arg1, arg2) {
-            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
+        __wbg_removeEntry_7914045ff1a983a4: function(arg0, arg1, arg2, arg3) {
+            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
         __wbg_rendering_new: function(arg0) {
             const ret = Rendering.__wrap(arg0);
             return ret;
         },
-        __wbg_request_d9d81a79185ecd35: function(arg0, arg1, arg2, arg3) {
+        __wbg_request_6030b3039b1ae0dc: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.request(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
@@ -736,16 +748,20 @@ function __wbg_get_imports() {
             const ret = Reflect.set(arg0, arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_set_name_eefc31a33db38edb: function(arg0, arg1, arg2) {
+        __wbg_set_name_93caa23cdf04a087: function(arg0, arg1, arg2) {
             arg0.name = getStringFromWasm0(arg1, arg2);
         },
-        __wbg_set_refusal_b8f13d05e8212be6: function(arg0, arg1) {
+        __wbg_set_refusal_280ba8e696e1aa4c: function(arg0, arg1) {
             arg0.refusal = arg1;
         },
-        __wbg_size_a1ed0c98f6f32013: function(arg0) {
+        __wbg_size_ce4c161c70d82206: function(arg0) {
             const ret = arg0.size;
             return ret;
         },
+        __wbg_slice_6f166d9c74deb2bb: function(arg0, arg1, arg2) {
+            const ret = arg0.slice(arg1, arg2);
+            return ret;
+        },
         __wbg_static_accessor_GLOBAL_8eb4cd83130a11a0: function() {
             const ret = typeof global === 'undefined' ? null : global;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
@@ -774,18 +790,21 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1);
             return ret;
         },
-        __wbg_write_d29f03282c34951b: function(arg0, arg1) {
+        __wbg_warn_6232f611e2e359d1: function(arg0, arg1) {
+            console.warn(getStringFromWasm0(arg0, arg1));
+        },
+        __wbg_write_c5dcd6f362f80fb4: 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: 521, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // 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`.
             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: 73, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3f8776df83dbd585);
+            // 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);
             return ret;
         },
         __wbindgen_generic_0000000000000003: function(arg0) {
@@ -814,8 +833,8 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__h3f8776df83dbd585(arg0, arg1) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h3f8776df83dbd585(arg0, arg1);
+function wasm_bindgen__convert__closures_____invoke__hc194386506580090(arg0, arg1) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__hc194386506580090(arg0, arg1);
     return ret;
 }