@scalable-vector-audio/sva-wasm 0.7.9 → 0.7.12

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.9",
+  "version": "0.7.12",
   "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>;
     /**
@@ -23,30 +27,21 @@ export class Composition {
     prune(policy: string): void;
     /**
      * `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`.
+     * what `representations()` answers, each a call as `--representation` writes it.
+     * `options`: `rate`, `bits`, `flop_budget`, `until`, `volatile`, and `out: null`, which
+     * hands back no samples and reads only `representations`, `samples` otherwise.
      */
     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`.
-     */
-    warm(target: string, options: any): Promise<any>;
     readonly cache_bytes: number;
     readonly cache_entries: number;
     readonly cache_evictions: number;
     cache_max_bytes: number;
     readonly cache_policy: string;
-    readonly prune_policy: string;
 }
 
 export class Rendering {
@@ -60,7 +55,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 +70,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 +82,8 @@ export class Stream {
      */
     add(term: string, options?: any | null): Promise<number>;
     /**
-     * `late`: edits landed past where issued; `built`: what the latest change built anew.
+     * `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 +92,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,18 +146,16 @@ 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;
     readonly composition_persist: (a: number) => any;
     readonly composition_prune: (a: number, b: number, c: number) => [number, number];
-    readonly composition_prune_policy: (a: number) => [number, number];
     readonly composition_render: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
     readonly composition_set_cache_max_bytes: (a: number, b: number) => void;
     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;
@@ -190,7 +184,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__habf5c6770f02f6a8: (a: number, b: number) => any;
+    readonly wasm_bindgen__convert__closures_____invoke__h5b6034d5d61911ef: (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() {
@@ -119,26 +130,11 @@ export class Composition {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
-    /**
-     * @returns {string}
-     */
-    get prune_policy() {
-        let deferred1_0;
-        let deferred1_1;
-        try {
-            const ret = wasm.composition_prune_policy(this.__wbg_ptr);
-            deferred1_0 = ret[0];
-            deferred1_1 = ret[1];
-            return getStringFromWasm0(ret[0], ret[1]);
-        } finally {
-            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
-        }
-    }
     /**
      * `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`.
+     * what `representations()` answers, each a call as `--representation` writes it.
+     * `options`: `rate`, `bits`, `flop_budget`, `until`, `volatile`, and `out: null`, which
+     * hands back no samples and reads only `representations`, `samples` otherwise.
      * @param {string} target
      * @param {string[] | null | undefined} representations
      * @param {any} options
@@ -170,19 +166,7 @@ export class Composition {
         }
     }
     /**
-     * @param {string} policy
-     */
-    set_prune_policy(policy) {
-        const ptr0 = passStringToWasm0(policy, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.composition_set_prune_policy(this.__wbg_ptr, ptr0, len0);
-        if (ret[1]) {
-            throw takeFromExternrefTable0(ret[0]);
-        }
-    }
-    /**
-     * `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
@@ -194,20 +178,6 @@ 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;
 
@@ -282,7 +252,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 +294,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 +341,8 @@ export class Stream {
         return ret >>> 0;
     }
     /**
-     * `late`: edits landed past where issued; `built`: what the latest change built anew.
+     * `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 +372,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 +547,7 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_997e73d32238e655: function(arg0) {
             arg0._wbg_cb_unref();
         },
-        __wbg_arrayBuffer_11f2a1e4ddaa95d8: function(arg0) {
+        __wbg_arrayBuffer_8f03d5b78ebe3a4e: function(arg0) {
             const ret = arg0.arrayBuffer();
             return ret;
         },
@@ -588,7 +559,7 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_close_6b04298b11db1bba: function(arg0) {
+        __wbg_close_c7f4b860d2ea6a47: function(arg0) {
             const ret = arg0.close();
             return ret;
         },
@@ -596,7 +567,7 @@ function __wbg_get_imports() {
             const ret = Composition.__wrap(arg0);
             return ret;
         },
-        __wbg_createWritable_cfe5fad5deed639c: function(arg0) {
+        __wbg_createWritable_2a75642432c12d33: function(arg0) {
             const ret = arg0.createWritable();
             return ret;
         },
@@ -608,15 +579,15 @@ function __wbg_get_imports() {
             const ret = Array.from(arg0);
             return ret;
         },
-        __wbg_getDirectoryHandle_e798912eb62508f2: function(arg0, arg1, arg2, arg3) {
+        __wbg_getDirectoryHandle_25b3be46cc47f02b: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getDirectoryHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFileHandle_a84a2f16e791f795: function(arg0, arg1, arg2, arg3) {
+        __wbg_getFileHandle_48a0d03d8fb43555: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.getFileHandle(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_getFile_7f8dc32a458f2d0e: function(arg0) {
+        __wbg_getFile_040bdebdde28065f: function(arg0) {
             const ret = arg0.getFile();
             return ret;
         },
@@ -646,7 +617,7 @@ function __wbg_get_imports() {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_keys_634cd92b86dd446e: function(arg0) {
+        __wbg_keys_f97039285c3d52fb: function(arg0) {
             const ret = arg0.keys();
             return ret;
         },
@@ -662,23 +633,23 @@ function __wbg_get_imports() {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_move_8434d92a54c91b00: function(arg0, arg1, arg2, arg3) {
+        __wbg_move_28983a826cc9330f: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.move(arg1, getStringFromWasm0(arg2, arg3));
             return ret;
         },
-        __wbg_name_293675515634cc39: function(arg0, arg1) {
+        __wbg_name_7a0bc23891d2f56b: 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);
+        __wbg_new_102e0b0848e3aea7: function(arg0, arg1) {
+            const ret = new Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_new_5b3c6d17acdce20d: function(arg0, arg1) {
-            const ret = new Error(getStringFromWasm0(arg0, arg1));
+        __wbg_new_1da3429bc3c4541c: function(arg0) {
+            const ret = new Uint8Array(arg0);
             return ret;
         },
         __wbg_new_8f72ed7c652bf5a2: function(arg0, arg1) {
@@ -725,18 +696,18 @@ function __wbg_get_imports() {
                 state0.a = 0;
             }
         },
-        __wbg_next_8d6fcae425e2f3b6: function(arg0) {
+        __wbg_next_01020fab0b97b5c1: function(arg0) {
             const ret = arg0.next();
             return ret;
         },
-        __wbg_parse_90714255eaa41f3a: function() { return handleError(function (arg0, arg1) {
+        __wbg_parse_2ac530907013022a: 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_051255628c48587d: function(arg0) {
+        __wbg_query_5b1678c887e9e494: function(arg0) {
             const ret = arg0.query();
             return ret;
         },
@@ -751,19 +722,19 @@ function __wbg_get_imports() {
             const ret = Math.random();
             return ret;
         },
-        __wbg_removeEntry_43d25519fd6d5acf: function(arg0, arg1, arg2) {
-            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
+        __wbg_removeEntry_9bc2ca700ad0dc67: function(arg0, arg1, arg2, arg3) {
+            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
-        __wbg_removeEntry_664b9cfa8cda099a: function(arg0, arg1, arg2, arg3) {
-            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2), arg3);
+        __wbg_removeEntry_f3bdba746dbb58ab: 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_f0db2453e0980c9a: function(arg0, arg1, arg2, arg3) {
+        __wbg_request_e0d65e37b6bc0c8e: function(arg0, arg1, arg2, arg3) {
             const ret = arg0.request(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         },
@@ -778,17 +749,17 @@ function __wbg_get_imports() {
         __wbg_set_c41f8dbc07a2190f: function(arg0, arg1, arg2) {
             arg0.set(getArrayF32FromWasm0(arg1, arg2));
         },
-        __wbg_set_name_bbf79553964796e1: function(arg0, arg1, arg2) {
+        __wbg_set_name_7e2b1a4388209082: function(arg0, arg1, arg2) {
             arg0.name = getStringFromWasm0(arg1, arg2);
         },
-        __wbg_set_refusal_c7d6c75b9c149c7b: function(arg0, arg1) {
+        __wbg_set_refusal_c7e0bdf118c521d3: function(arg0, arg1) {
             arg0.refusal = arg1;
         },
-        __wbg_size_3306dc497d65749e: function(arg0) {
+        __wbg_size_5ff0355676e8eca9: function(arg0) {
             const ret = arg0.size;
             return ret;
         },
-        __wbg_slice_d005f256128d12dc: function(arg0, arg1, arg2) {
+        __wbg_slice_2fbdf03b9a72bf02: function(arg0, arg1, arg2) {
             const ret = arg0.slice(arg1, arg2);
             return ret;
         },
@@ -824,21 +795,21 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1);
             return ret;
         },
-        __wbg_warn_60eba7643acae09a: function(arg0, arg1) {
+        __wbg_warn_b7a190536a7219ed: function(arg0, arg1) {
             console.warn(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_write_eb6a2d7280448b4f: function(arg0, arg1) {
+        __wbg_write_c36a73d780533ec0: 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: 548, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 534, 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: 96, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__habf5c6770f02f6a8);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 86, ret: NamedExternref("Promise<any>"), inner_ret: Some(NamedExternref("Promise<any>")) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h5b6034d5d61911ef);
             return ret;
         },
         __wbindgen_generic_0000000000000003: function(arg0) {
@@ -867,8 +838,8 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__habf5c6770f02f6a8(arg0, arg1) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__habf5c6770f02f6a8(arg0, arg1);
+function wasm_bindgen__convert__closures_____invoke__h5b6034d5d61911ef(arg0, arg1) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h5b6034d5d61911ef(arg0, arg1);
     return ret;
 }