@scalable-vector-audio/sva-wasm 0.7.8 → 0.7.11

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

package/sva_wasm.d.ts

@@ -5,15 +5,19 @@ export class Composition {
     free(): void;
     [Symbol.dispose](): void;
     clear_cache(): void;
+    /**
+     * Memory's disk traffic since it opened.
+     */
+    counters(): any;
     insert(path: string, text: string): void;
     constructor(name?: string | null);
     /**
-     * Over the store in `dir`, an origin-private file system directory, or memory alone
-     * where there is none or its store will not open.
+     * Memory over the store in `dir`, an origin-private file system directory; alone where
+     * none opens.
      */
     static open(name?: string | null, dir?: FileSystemDirectoryHandle | null): Promise<Composition>;
     /**
-     * The only write to the directory `open` was handed: every value computed since the last.
+     * The only commit to the directory `open` was handed.
      */
     persist(): Promise<number>;
     /**
@@ -24,21 +28,20 @@ export class Composition {
     /**
      * `target` as `sva-cli render` takes it, `@piano([0, 2b], f0=C4)`; `representations`
      * what `representations()` answers, `samples` where unset, each a call as
-     * `--representation` writes it. `options` sets `rate`, `bits`, `flop_budget`, `until`,
-     * `volatile` and `cache`.
+     * `--representation` writes it. `options` sets `rate`, `bits`, `flop_budget`, `until` and
+     * `volatile`.
      */
     render(target: string, representations: string[] | null | undefined, options: any): Promise<Rendering>;
     set_cache_policy(policy: string): void;
     set_prune_policy(policy: string): void;
     /**
-     * `target` block by block, through this store. `options`: `rate`, `bits`, `until`, `cache`,
-     * `live`, `channels`.
+     * `target` block by block. `options`: `rate`, `bits`, `until`, `live`, `channels`.
      */
     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`.
+     * `target` computed into memory as `render` would; `{ stats, representations }`, the
+     * latter `representations()` for `readings`. Options: `rate`, `bits`, `flop_budget`,
+     * `readings`.
      */
     warm(target: string, options: any): Promise<any>;
     readonly cache_bytes: number;
@@ -60,7 +63,7 @@ export class Rendering {
     representations(): any;
     samples(channel: number): Float32Array;
     /**
-     * Every lookup this render made of the composition's store, and what each came to.
+     * Every lookup this render made of memory, and what each came to.
      */
     stats(): any;
     work(): any;
@@ -75,7 +78,7 @@ 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 the stream passes its support. An edit lands at the first block boundary
- * once the store answered it; `read` and getters answer meanwhile.
+ * once memory answered it; `read` and getters answer meanwhile.
  */
 export class Stream {
     private constructor();
@@ -87,7 +90,8 @@ export class Stream {
      */
     add(term: string, options?: any | null): Promise<number>;
     /**
-     * `late`: edits landed past where issued.
+     * `late`: edits landed late; `demands`: reads working out the note sum's asks; `built`:
+     * what the latest change did anew; `tier`: memory's disk traffic since it opened.
      */
     counts(): any;
     /**
@@ -96,7 +100,7 @@ export class Stream {
      */
     edit(expr: string): Promise<void>;
     /**
-     * Reads the stored samples the next second of blocks plays, as the stream plays on.
+     * Reads what the next second plays, a few disk reads a call at most.
      */
     fetch(): Promise<void>;
     landed(handle: number): number | undefined;
@@ -150,6 +154,7 @@ export interface InitOutput {
     readonly composition_cache_max_bytes: (a: number) => number;
     readonly composition_cache_policy: (a: number) => [number, number];
     readonly composition_clear_cache: (a: number) => void;
+    readonly composition_counters: (a: number) => [number, number, number];
     readonly composition_insert: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly composition_new: (a: number, b: number) => number;
     readonly composition_open: (a: number, b: number, c: number) => any;
@@ -190,7 +195,7 @@ export interface InitOutput {
     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__h0b378cff48a90795: (a: number, b: number) => any;
+    readonly wasm_bindgen__convert__closures_____invoke__h79de5e4e9fa3346a: (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

@@ -63,6 +63,17 @@ export class Composition {
     clear_cache() {
         wasm.composition_clear_cache(this.__wbg_ptr);
     }
+    /**
+     * Memory's disk traffic since it opened.
+     * @returns {any}
+     */
+    counters() {
+        const ret = wasm.composition_counters(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * @param {string} path
      * @param {string} text
@@ -86,8 +97,8 @@ export class Composition {
         return this;
     }
     /**
-     * Over the store in `dir`, an origin-private file system directory, or memory alone
-     * where there is none or its store will not open.
+     * Memory over the store in `dir`, an origin-private file system directory; alone where
+     * none opens.
      * @param {string | null} [name]
      * @param {FileSystemDirectoryHandle | null} [dir]
      * @returns {Promise<Composition>}
@@ -99,7 +110,7 @@ export class Composition {
         return ret;
     }
     /**
-     * The only write to the directory `open` was handed: every value computed since the last.
+     * The only commit to the directory `open` was handed.
      * @returns {Promise<number>}
      */
     persist() {
@@ -137,8 +148,8 @@ export class Composition {
     /**
      * `target` as `sva-cli render` takes it, `@piano([0, 2b], f0=C4)`; `representations`
      * what `representations()` answers, `samples` where unset, each a call as
-     * `--representation` writes it. `options` sets `rate`, `bits`, `flop_budget`, `until`,
-     * `volatile` and `cache`.
+     * `--representation` writes it. `options` sets `rate`, `bits`, `flop_budget`, `until` and
+     * `volatile`.
      * @param {string} target
      * @param {string[] | null | undefined} representations
      * @param {any} options
@@ -181,8 +192,7 @@ export class Composition {
         }
     }
     /**
-     * `target` block by block, through this store. `options`: `rate`, `bits`, `until`, `cache`,
-     * `live`, `channels`.
+     * `target` block by block. `options`: `rate`, `bits`, `until`, `live`, `channels`.
      * @param {string} target
      * @param {number} block
      * @param {any} options
@@ -195,9 +205,9 @@ export class Composition {
         return ret;
     }
     /**
-     * `target` staged as `render` would, until `persist`; `{ stats, representations }`,
-     * the latter `representations()` for `readings`, null unasked. Options: `rate`, `bits`,
-     * `flop_budget`, `readings`.
+     * `target` computed into memory as `render` would; `{ stats, representations }`, the
+     * latter `representations()` for `readings`. Options: `rate`, `bits`, `flop_budget`,
+     * `readings`.
      * @param {string} target
      * @param {any} options
      * @returns {Promise<any>}
@@ -282,7 +292,7 @@ export class Rendering {
         return ret;
     }
     /**
-     * Every lookup this render made of the composition's store, and what each came to.
+     * Every lookup this render made of memory, and what each came to.
      * @returns {any}
      */
     stats() {
@@ -324,7 +334,7 @@ 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 the stream passes its support. An edit lands at the first block boundary
- * once the store answered it; `read` and getters answer meanwhile.
+ * once memory answered it; `read` and getters answer meanwhile.
  */
 export class Stream {
     static __wrap(ptr) {
@@ -371,7 +381,8 @@ export class Stream {
         return ret >>> 0;
     }
     /**
-     * `late`: edits landed past where issued.
+     * `late`: edits landed late; `demands`: reads working out the note sum's asks; `built`:
+     * what the latest change did anew; `tier`: memory's disk traffic since it opened.
      * @returns {any}
      */
     counts() {
@@ -401,7 +412,7 @@ export class Stream {
         return ret[0] === 0 ? undefined : ret[1];
     }
     /**
-     * Reads the stored samples the next second of blocks plays, as the stream plays on.
+     * Reads what the next second plays, a few disk reads a call at most.
      * @returns {Promise<void>}
      */
     fetch() {
@@ -576,7 +587,7 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_997e73d32238e655: function(arg0) {
             arg0._wbg_cb_unref();
         },
-        __wbg_arrayBuffer_ed0fc02b47259251: function(arg0) {
+        __wbg_arrayBuffer_f07c2e90cd52db62: function(arg0) {
             const ret = arg0.arrayBuffer();
             return ret;
         },
@@ -588,7 +599,7 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_close_6c081589a833e036: function(arg0) {
+        __wbg_close_18d7e291293c297d: function(arg0) {
             const ret = arg0.close();
             return ret;
         },
@@ -596,7 +607,7 @@ function __wbg_get_imports() {
             const ret = Composition.__wrap(arg0);
             return ret;
         },
-        __wbg_createWritable_0bfb9955e666dc67: function(arg0) {
+        __wbg_createWritable_96ad69f25b5e0aa3: function(arg0) {
             const ret = arg0.createWritable();
             return ret;
         },
@@ -608,15 +619,15 @@ function __wbg_get_imports() {
             const ret = Array.from(arg0);
             return ret;
         },
-        __wbg_getDirectoryHandle_e48497d7e6489bff: function(arg0, arg1, arg2, arg3) {
+        __wbg_getDirectoryHandle_4cf01a0ef8dc8838: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getDirectoryHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFileHandle_e25fbdb9810ee2ba: function(arg0, arg1, arg2, arg3) {
+        __wbg_getFileHandle_0a0196d063101c06: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getFileHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFile_7150d09112e56285: function(arg0) {
+        __wbg_getFile_87457664a94e628d: function(arg0) {
             const ret = arg0.getFile();
             return ret;
         },
@@ -646,7 +657,7 @@ function __wbg_get_imports() {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_keys_0cf090f77c2b2e97: function(arg0) {
+        __wbg_keys_8838facd131c6680: function(arg0) {
             const ret = arg0.keys();
             return ret;
         },
@@ -662,11 +673,11 @@ function __wbg_get_imports() {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_move_a08cdc60d2ec93fd: function(arg0, arg1, arg2, arg3) {
+        __wbg_move_e9f3888afdee5378: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.move(arg1, getStringFromWasm0(arg2, arg3));
             return ret;
         },
-        __wbg_name_71c3006a1b1be14c: function(arg0, arg1) {
+        __wbg_name_b2a0e8fa7dc9f795: function(arg0, arg1) {
             const ret = arg1.name;
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
             const len1 = WASM_VECTOR_LEN;
@@ -695,12 +706,12 @@ function __wbg_get_imports() {
                 state0.a = 0;
             }
         },
-        __wbg_new_bebc3f4757acf305: function() {
-            const ret = new Object();
+        __wbg_new_94977a6bac8d2087: function(arg0, arg1) {
+            const ret = new Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_new_f1bc8fe7339085d3: function(arg0, arg1) {
-            const ret = new Error(getStringFromWasm0(arg0, arg1));
+        __wbg_new_bebc3f4757acf305: function() {
+            const ret = new Object();
             return ret;
         },
         __wbg_new_from_slice_4ee02165f9de919e: function(arg0, arg1) {
@@ -725,18 +736,18 @@ function __wbg_get_imports() {
                 state0.a = 0;
             }
         },
-        __wbg_next_bc1e641458a00fca: function(arg0) {
+        __wbg_next_6ce8c52a5e93c951: function(arg0) {
             const ret = arg0.next();
             return ret;
         },
-        __wbg_parse_4aff54b60acfa526: function() { return handleError(function (arg0, arg1) {
+        __wbg_parse_137470364fb37b46: 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_b729c18d2bbb5c09: function(arg0) {
+        __wbg_query_5c7287509234c779: function(arg0) {
             const ret = arg0.query();
             return ret;
         },
@@ -751,19 +762,19 @@ function __wbg_get_imports() {
             const ret = Math.random();
             return ret;
         },
-        __wbg_removeEntry_0059246a91f9ae88: function(arg0, arg1, arg2) {
-            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
+        __wbg_removeEntry_08e6fab1462cddc0: function(arg0, arg1, arg2, arg3) {
+            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_removeEntry_849a552a2cf5a02e: function(arg0, arg1, arg2, arg3) {
-            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
+        __wbg_removeEntry_b76635b0f1b39807: function(arg0, arg1, arg2) {
+            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
             return ret;
         },
         __wbg_rendering_new: function(arg0) {
             const ret = Rendering.__wrap(arg0);
             return ret;
         },
-        __wbg_request_5302d75023e3c01e: function(arg0, arg1, arg2, arg3) {
+        __wbg_request_4b258bd4e8d59718: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.request(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
@@ -778,17 +789,17 @@ function __wbg_get_imports() {
         __wbg_set_c41f8dbc07a2190f: function(arg0, arg1, arg2) {
             arg0.set(getArrayF32FromWasm0(arg1, arg2));
         },
-        __wbg_set_name_6677ad217e2f283b: function(arg0, arg1, arg2) {
+        __wbg_set_name_ad160d0021c74277: function(arg0, arg1, arg2) {
             arg0.name = getStringFromWasm0(arg1, arg2);
         },
-        __wbg_set_refusal_0099e1cb8eaf6e8f: function(arg0, arg1) {
+        __wbg_set_refusal_6e56234e4d6c3daf: function(arg0, arg1) {
             arg0.refusal = arg1;
         },
-        __wbg_size_901248edb0f46fff: function(arg0) {
+        __wbg_size_2e4cce3f7e2afea9: function(arg0) {
             const ret = arg0.size;
             return ret;
         },
-        __wbg_slice_7c5a37a2d4425735: function(arg0, arg1, arg2) {
+        __wbg_slice_7e86f72fd9fb87c2: function(arg0, arg1, arg2) {
             const ret = arg0.slice(arg1, arg2);
             return ret;
         },
@@ -824,21 +835,21 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1);
             return ret;
         },
-        __wbg_warn_4693fb2055cb5040: function(arg0, arg1) {
+        __wbg_warn_fd5541c02e4e31a7: function(arg0, arg1) {
             console.warn(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_write_84c06b7ae2a2469f: function(arg0, arg1) {
+        __wbg_write_92f3f2f851dd835e: 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: 535, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 541, 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: 92, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h0b378cff48a90795);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 101, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h79de5e4e9fa3346a);
             return ret;
         },
         __wbindgen_generic_0000000000000003: function(arg0) {
@@ -867,8 +878,8 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__h0b378cff48a90795(arg0, arg1) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h0b378cff48a90795(arg0, arg1);
+function wasm_bindgen__convert__closures_____invoke__h79de5e4e9fa3346a(arg0, arg1) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h79de5e4e9fa3346a(arg0, arg1);
     return ret;
 }