@scalable-vector-audio/sva-wasm 0.2.0 → 0.3.1

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

package/sva_wasm.d.ts

@@ -5,15 +5,32 @@ export class Composition {
     free(): void;
     [Symbol.dispose](): void;
     bound_cache(max_bytes: number): void;
+    /**
+     * Empties the memory tier only: a persistent pack outlives it by design.
+     */
     clear_cache(): void;
     insert(path: string, text: string): void;
     constructor(name?: string | null);
+    /**
+     * `name` labels the composition as `new` does; renders persist under `cache` in a dedicated
+     * worker's private file system, and anywhere none opens, or `cache` is held, memory-only.
+     */
+    static persistent(name: string | null | undefined, cache: string, max_bytes?: number | null): Promise<Composition>;
     /**
      * Unset, `target` is `master`; `seconds` is the horizon and `rate` the observation rate.
      */
     render(target?: string | null, rate?: number | null, seconds?: number | null): Rendering;
+    /**
+     * The memory tier's, as `cache_max_bytes` is; `persistent_bytes` is the pack's.
+     */
     readonly cache_bytes: number;
     readonly cache_max_bytes: number;
+    readonly persistent: boolean;
+    /**
+     * Zero on a memory-only composition, as `persistent_max_bytes` is.
+     */
+    readonly persistent_bytes: number;
+    readonly persistent_max_bytes: number;
 }
 
 export class Rendering {
@@ -25,6 +42,10 @@ export class Rendering {
      */
     query(representation: string, from_secs?: number | null, to_secs?: number | null): any;
     samples(channel: number, from_secs?: number | null, to_secs?: number | null): Float32Array;
+    /**
+     * The object `sva-cli render` puts under `data.cache.stats`.
+     */
+    stats(): any;
     readonly channels: number;
     readonly duration_secs: number;
     readonly sample_rate: number;
@@ -42,19 +63,27 @@ export interface InitOutput {
     readonly composition_cache_max_bytes: (a: number) => number;
     readonly composition_clear_cache: (a: number) => void;
     readonly composition_insert: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly composition_is_persistent: (a: number) => number;
     readonly composition_new: (a: number, b: number) => number;
+    readonly composition_persistent: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+    readonly composition_persistent_bytes: (a: number) => number;
+    readonly composition_persistent_max_bytes: (a: number) => number;
     readonly composition_render: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
     readonly rendering_channels: (a: number) => number;
     readonly rendering_duration_secs: (a: number) => number;
     readonly rendering_query: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
     readonly rendering_sample_rate: (a: number) => number;
     readonly rendering_samples: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly rendering_stats: (a: number) => [number, number, number];
     readonly rendering_target: (a: 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 __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;
     readonly __externref_table_alloc: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
-    readonly __wbindgen_malloc: (a: number, b: number) => number;
-    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
     readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_start: () => void;

package/sva_wasm.js

@@ -1,6 +1,12 @@
 /* @ts-self-types="./sva_wasm.d.ts" */
 
 export class Composition {
+    static __wrap(ptr) {
+        const obj = Object.create(Composition.prototype);
+        obj.__wbg_ptr = ptr;
+        CompositionFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
     __destroy_into_raw() {
         const ptr = this.__wbg_ptr;
         this.__wbg_ptr = 0;
@@ -18,6 +24,7 @@ export class Composition {
         wasm.composition_bound_cache(this.__wbg_ptr, max_bytes);
     }
     /**
+     * The memory tier's, as `cache_max_bytes` is; `persistent_bytes` is the pack's.
      * @returns {number}
      */
     get cache_bytes() {
@@ -31,6 +38,9 @@ export class Composition {
         const ret = wasm.composition_cache_max_bytes(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * Empties the memory tier only: a persistent pack outlives it by design.
+     */
     clear_cache() {
         wasm.composition_clear_cache(this.__wbg_ptr);
     }
@@ -45,6 +55,13 @@ export class Composition {
         const len1 = WASM_VECTOR_LEN;
         wasm.composition_insert(this.__wbg_ptr, ptr0, len0, ptr1, len1);
     }
+    /**
+     * @returns {boolean}
+     */
+    get persistent() {
+        const ret = wasm.composition_is_persistent(this.__wbg_ptr);
+        return ret !== 0;
+    }
     /**
      * @param {string | null} [name]
      */
@@ -56,6 +73,37 @@ export class Composition {
         CompositionFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * `name` labels the composition as `new` does; renders persist under `cache` in a dedicated
+     * worker's private file system, and anywhere none opens, or `cache` is held, memory-only.
+     * @param {string | null | undefined} name
+     * @param {string} cache
+     * @param {number | null} [max_bytes]
+     * @returns {Promise<Composition>}
+     */
+    static persistent(name, cache, max_bytes) {
+        var ptr0 = isLikeNone(name) ? 0 : passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(cache, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.composition_persistent(ptr0, len0, ptr1, len1, !isLikeNone(max_bytes), isLikeNone(max_bytes) ? 0 : max_bytes);
+        return ret;
+    }
+    /**
+     * Zero on a memory-only composition, as `persistent_max_bytes` is.
+     * @returns {number}
+     */
+    get persistent_bytes() {
+        const ret = wasm.composition_persistent_bytes(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @returns {number}
+     */
+    get persistent_max_bytes() {
+        const ret = wasm.composition_persistent_max_bytes(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * Unset, `target` is `master`; `seconds` is the horizon and `rate` the observation rate.
      * @param {string | null} [target]
@@ -144,6 +192,17 @@ export class Rendering {
         wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
         return v1;
     }
+    /**
+     * The object `sva-cli render` puts under `data.cache.stats`.
+     * @returns {any}
+     */
+    stats() {
+        const ret = wasm.rendering_stats(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * @returns {string}
      */
@@ -164,24 +223,235 @@ if (Symbol.dispose) Rendering.prototype[Symbol.dispose] = Rendering.prototype.fr
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg___wbindgen_is_falsy_4502df4d571fca70: function(arg0) {
+            const ret = !arg0;
+            return ret;
+        },
+        __wbg___wbindgen_is_function_fcda5e3902d732fe: function(arg0) {
+            const ret = typeof(arg0) === 'function';
+            return ret;
+        },
+        __wbg___wbindgen_is_undefined_8c687d0b90d5b524: function(arg0) {
+            const ret = arg0 === undefined;
+            return ret;
+        },
+        __wbg___wbindgen_string_get_92ab86bb19cbc12f: function(arg0, arg1) {
+            const obj = arg1;
+            const ret = typeof(obj) === 'string' ? obj : undefined;
+            var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            var len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
         __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_new_ba59ef2486993134: function(arg0, arg1) {
+        __wbg__wbg_cb_unref_997e73d32238e655: function(arg0) {
+            arg0._wbg_cb_unref();
+        },
+        __wbg_call_6bcf8d3e20937e46: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = arg0.call(arg1, arg2);
+            return ret;
+        }, arguments); },
+        __wbg_close_1d55410e47fc11c8: function(arg0) {
+            arg0.close();
+        },
+        __wbg_composition_new: function(arg0) {
+            const ret = Composition.__wrap(arg0);
+            return ret;
+        },
+        __wbg_createSyncAccessHandle_f2f0452f71047cd7: function(arg0) {
+            const ret = arg0.createSyncAccessHandle();
+            return ret;
+        },
+        __wbg_flush_91458c8278aae724: function() { return handleError(function (arg0) {
+            arg0.flush();
+        }, arguments); },
+        __wbg_getDirectoryHandle_df6fb6f1fc6240ed: function(arg0, arg1, arg2, arg3) {
+            const ret = arg0.getDirectoryHandle(getStringFromWasm0(arg1, arg2), arg3);
+            return ret;
+        },
+        __wbg_getDirectory_31689baa30c0e94c: function(arg0) {
+            const ret = arg0.getDirectory();
+            return ret;
+        },
+        __wbg_getFileHandle_fbeae17e3423535f: function(arg0, arg1, arg2, arg3) {
+            const ret = arg0.getFileHandle(getStringFromWasm0(arg1, arg2), arg3);
+            return ret;
+        },
+        __wbg_getSize_479486b8ac438f8e: function() { return handleError(function (arg0) {
+            const ret = arg0.getSize();
+            return ret;
+        }, arguments); },
+        __wbg_get_989d0a1309644f2b: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(arg0, arg1);
+            return ret;
+        }, arguments); },
+        __wbg_instanceof_FileSystemDirectoryHandle_a5c1bdaafba684ca: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof FileSystemDirectoryHandle;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_instanceof_FileSystemFileHandle_aba527fd4c84a882: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof FileSystemFileHandle;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_instanceof_WorkerGlobalScope_0c1a6411473b843f: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof WorkerGlobalScope;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_keys_4d3b6ee519555a72: function(arg0) {
+            const ret = arg0.keys();
+            return ret;
+        },
+        __wbg_navigator_d25c0f071226f233: function(arg0) {
+            const ret = arg0.navigator;
+            return ret;
+        },
+        __wbg_new_43bce91511b945bd: function(arg0, arg1) {
             const ret = new Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_parse_8ede4cc41eba4991: function() { return handleError(function (arg0, arg1) {
+        __wbg_new_8f72ed7c652bf5a2: function(arg0, arg1) {
+            try {
+                var state0 = {a: arg0, b: arg1};
+                var cb0 = (arg0, arg1) => {
+                    const a = state0.a;
+                    state0.a = 0;
+                    try {
+                        return wasm_bindgen__convert__closures_____invoke__h76bd71bceeca2b95(a, state0.b, arg0, arg1);
+                    } finally {
+                        state0.a = a;
+                    }
+                };
+                const ret = new Promise(cb0);
+                return ret;
+            } finally {
+                state0.a = 0;
+            }
+        },
+        __wbg_new_bebc3f4757acf305: function() {
+            const ret = new Object();
+            return ret;
+        },
+        __wbg_new_typed_6f8b0d724fe26c07: function(arg0, arg1) {
+            try {
+                var state0 = {a: arg0, b: arg1};
+                var cb0 = (arg0, arg1) => {
+                    const a = state0.a;
+                    state0.a = 0;
+                    try {
+                        return wasm_bindgen__convert__closures_____invoke__h76bd71bceeca2b95(a, state0.b, arg0, arg1);
+                    } finally {
+                        state0.a = a;
+                    }
+                };
+                const ret = new Promise(cb0);
+                return ret;
+            } finally {
+                state0.a = 0;
+            }
+        },
+        __wbg_next_a128c458fd40a0a5: function() { return handleError(function (arg0) {
+            const ret = arg0.next();
+            return ret;
+        }, arguments); },
+        __wbg_parse_d55461db42f64de2: function() { return handleError(function (arg0, arg1) {
             const ret = JSON.parse(getStringFromWasm0(arg0, arg1));
             return ret;
         }, arguments); },
-        __wbg_set_name_1c3c10b65efaa3ed: function(arg0, arg1, arg2) {
+        __wbg_queueMicrotask_85c90f6987555d65: function(arg0) {
+            const ret = arg0.queueMicrotask;
+            return ret;
+        },
+        __wbg_queueMicrotask_f6a1fa10b81d1fc0: function(arg0) {
+            queueMicrotask(arg0);
+        },
+        __wbg_read_259baab664b5f318: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+            const ret = arg0.read(getArrayU8FromWasm0(arg1, arg2), arg3);
+            return ret;
+        }, arguments); },
+        __wbg_removeEntry_c72a6de718a4679d: function(arg0, arg1, arg2) {
+            const ret = arg0.removeEntry(getStringFromWasm0(arg1, arg2));
+            return ret;
+        },
+        __wbg_resolve_35ec7e0c6af4c82c: function(arg0) {
+            const ret = Promise.resolve(arg0);
+            return ret;
+        },
+        __wbg_setTimeout_68c2cba08a966520: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = arg0.setTimeout(arg1, arg2);
+            return ret;
+        }, arguments); },
+        __wbg_set_at_40af7269bbcce291: function(arg0, arg1) {
+            arg0.at = arg1;
+        },
+        __wbg_set_create_389985224a53c83d: function(arg0, arg1) {
+            arg0.create = arg1 !== 0;
+        },
+        __wbg_set_create_8c556c6febf6436c: function(arg0, arg1) {
+            arg0.create = arg1 !== 0;
+        },
+        __wbg_set_name_608c9ebd7e7091c7: function(arg0, arg1, arg2) {
             arg0.name = getStringFromWasm0(arg1, arg2);
         },
-        __wbg_set_refusal_f44fac85733e1451: function(arg0, arg1) {
+        __wbg_set_refusal_880b46e8b673b0c6: function(arg0, arg1) {
             arg0.refusal = arg1;
         },
+        __wbg_static_accessor_GLOBAL_8eb4cd83130a11a0: function() {
+            const ret = typeof global === 'undefined' ? null : global;
+            return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+        },
+        __wbg_static_accessor_GLOBAL_THIS_1e7044f654e934db: function() {
+            const ret = typeof globalThis === 'undefined' ? null : globalThis;
+            return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+        },
+        __wbg_static_accessor_SELF_d8b50611246a6d92: function() {
+            const ret = typeof self === 'undefined' ? null : self;
+            return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+        },
+        __wbg_static_accessor_WINDOW_fd0bc376bf0f8b42: function() {
+            const ret = typeof window === 'undefined' ? null : window;
+            return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+        },
+        __wbg_then_7a850dae4493f353: function(arg0, arg1, arg2) {
+            const ret = arg0.then(arg1, arg2);
+            return ret;
+        },
+        __wbg_then_b830475380919203: function(arg0, arg1) {
+            const ret = arg0.then(arg1);
+            return ret;
+        },
+        __wbg_truncate_2ed7d68b99bcc8f6: function() { return handleError(function (arg0, arg1) {
+            arg0.truncate(arg1);
+        }, arguments); },
+        __wbg_write_3e78f5b3224d701e: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+            const ret = arg0.write(getArrayU8FromWasm0(arg1, arg2), arg3);
+            return ret;
+        }, arguments); },
         __wbindgen_generic_0000000000000001: function(arg0, arg1) {
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 94, 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 `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
@@ -202,6 +472,17 @@ function __wbg_get_imports() {
     };
 }
 
+function wasm_bindgen__convert__closures_____invoke__hd55bb211d6a08150(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__hd55bb211d6a08150(arg0, arg1, arg2);
+    if (ret[1]) {
+        throw takeFromExternrefTable0(ret[0]);
+    }
+}
+
+function wasm_bindgen__convert__closures_____invoke__h76bd71bceeca2b95(arg0, arg1, arg2, arg3) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h76bd71bceeca2b95(arg0, arg1, arg2, arg3);
+}
+
 const CompositionFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_composition_free(ptr, 1));
@@ -215,11 +496,28 @@ function addToExternrefTable0(obj) {
     return idx;
 }
 
+const CLOSURE_DTORS = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(state => wasm.__wbindgen_destroy_closure(state.a, state.b));
+
 function getArrayF32FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getFloat32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
 }
 
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
 let cachedFloat32ArrayMemory0 = null;
 function getFloat32ArrayMemory0() {
     if (cachedFloat32ArrayMemory0 === null || cachedFloat32ArrayMemory0.byteLength === 0) {
@@ -253,6 +551,34 @@ function isLikeNone(x) {
     return x === undefined || x === null;
 }
 
+function makeMutClosure(arg0, arg1, f) {
+    const state = { a: arg0, b: arg1, cnt: 1 };
+    const real = (...args) => {
+
+        // First up with a closure we increment the internal reference
+        // count. This ensures that the Rust closure environment won't
+        // be deallocated while we're invoking it.
+        state.cnt++;
+        const a = state.a;
+        state.a = 0;
+        try {
+            return f(a, state.b, ...args);
+        } finally {
+            state.a = a;
+            real._wbg_cb_unref();
+        }
+    };
+    real._wbg_cb_unref = () => {
+        if (--state.cnt === 0) {
+            wasm.__wbindgen_destroy_closure(state.a, state.b);
+            state.a = 0;
+            CLOSURE_DTORS.unregister(state);
+        }
+    };
+    CLOSURE_DTORS.register(real, state, state);
+    return real;
+}
+
 function passStringToWasm0(arg, malloc, realloc) {
     if (realloc === undefined) {
         const buf = cachedTextEncoder.encode(arg);
@@ -330,6 +656,7 @@ function __wbg_finalize_init(instance, module) {
     wasmInstance = instance;
     wasm = instance.exports;
     wasmModule = module;
+    cachedDataViewMemory0 = null;
     cachedFloat32ArrayMemory0 = null;
     cachedUint8ArrayMemory0 = null;
     wasm.__wbindgen_start();