@octoseq/visualiser 0.1.0-main.c336fba → 0.1.0-main.d9e42ef

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@octoseq/visualiser",
-    "version": "0.1.0-main.c336fba",
+    "version": "0.1.0-main.d9e42ef",
     "description": "WASM-based visualiser for Octoseq",
     "license": "MIT",
     "repository": {

package/pkg/visualiser.d.ts

@@ -99,6 +99,22 @@ export class WasmVisualiser {
    * Clear all band event streams.
    */
   clear_band_events(): void;
+  /**
+   * Push a named event stream (e.g., "beatCandidates") for script access.
+   *
+   * The event stream will be available as `inputs.<name>` in Rhai scripts.
+   * This is used for MIR-derived events like beat candidates, onset peaks, etc.
+   *
+   * The JSON format should be an array of event objects with:
+   * - time: f32
+   * - weight: f32
+   * - beat_position: Option<f32>
+   * - beat_phase: Option<f32>
+   * - cluster_id: Option<u32>
+   *
+   * Returns true if successful, false if parsing failed.
+   */
+  push_event_stream(name: string, events_json: string): boolean;
   /**
    * Set debug visualization options.
    */
@@ -118,6 +134,19 @@ export class WasmVisualiser {
    */
   get_band_bounds_at(time: number): string;
   push_rotation_data(samples: Float32Array, sample_rate: number): void;
+  /**
+   * Render with a frame budget timeout.
+   *
+   * If the frame takes longer than `budget_ms` to process, it will be dropped
+   * and a warning logged. This prevents expensive scripts from freezing the browser.
+   *
+   * Returns true if the frame completed, false if it was dropped due to budget.
+   */
+  render_with_budget(dt: number, budget_ms: number): boolean;
+  /**
+   * Clear all named event streams.
+   */
+  clear_event_streams(): void;
   /**
    * Check if frequency bands are currently set.
    */
@@ -153,6 +182,11 @@ export class WasmVisualiser {
    * Returns true if the asset was unregistered, false if it didn't exist.
    */
   unregister_mesh_asset(asset_id: string): boolean;
+  /**
+   * Get the number of events in a named event stream.
+   * Returns 0 if no events are stored for this name.
+   */
+  get_event_stream_count(name: string): number;
   /**
    * Get the number of frequency bands.
    */
@@ -167,6 +201,11 @@ export class WasmVisualiser {
    * Returns a JSON-serialized ExtendedAnalysisResultJson.
    */
   run_analysis_with_events(script: string, duration: number, time_step: number): string;
+  /**
+   * Get entity positions as JSON for debugging.
+   * Returns a JSON array of objects with id, type, and position fields.
+   */
+  get_entity_positions_json(): string;
   /**
    * Drain and return any pending structured script diagnostics as JSON.
    *
@@ -203,6 +242,7 @@ export interface InitOutput {
   readonly get_script_api_metadata_json: () => [number, number];
   readonly wasmvisualiser_clear_band_events: (a: number) => void;
   readonly wasmvisualiser_clear_band_signals: (a: number) => void;
+  readonly wasmvisualiser_clear_event_streams: (a: number) => void;
   readonly wasmvisualiser_clear_frequency_bands: (a: number) => void;
   readonly wasmvisualiser_clear_isolation: (a: number) => void;
   readonly wasmvisualiser_clear_musical_time: (a: number) => void;
@@ -211,6 +251,8 @@ export interface InitOutput {
   readonly wasmvisualiser_get_band_event_count: (a: number, b: number, c: number) => number;
   readonly wasmvisualiser_get_band_signal_keys: (a: number) => [number, number];
   readonly wasmvisualiser_get_current_vals: (a: number) => [number, number];
+  readonly wasmvisualiser_get_entity_positions_json: (a: number) => [number, number];
+  readonly wasmvisualiser_get_event_stream_count: (a: number, b: number, c: number) => number;
   readonly wasmvisualiser_get_frequency_band_count: (a: number) => number;
   readonly wasmvisualiser_get_script_error: (a: number) => [number, number];
   readonly wasmvisualiser_get_signal_names: (a: number) => [number, number];
@@ -223,10 +265,12 @@ export interface InitOutput {
   readonly wasmvisualiser_push_band_events: (a: number, b: number, c: number, d: number, e: number) => number;
   readonly wasmvisualiser_push_band_signal: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
   readonly wasmvisualiser_push_data: (a: number, b: number, c: number, d: number) => void;
+  readonly wasmvisualiser_push_event_stream: (a: number, b: number, c: number, d: number, e: number) => number;
   readonly wasmvisualiser_push_signal: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
   readonly wasmvisualiser_push_zoom_data: (a: number, b: number, c: number, d: number) => void;
   readonly wasmvisualiser_register_mesh_asset: (a: number, b: number, c: number, d: number, e: number) => number;
   readonly wasmvisualiser_render: (a: number, b: number) => void;
+  readonly wasmvisualiser_render_with_budget: (a: number, b: number, c: number) => number;
   readonly wasmvisualiser_resize: (a: number, b: number, c: number) => void;
   readonly wasmvisualiser_run_analysis: (a: number, b: number, c: number, d: number, e: number) => [number, number];
   readonly wasmvisualiser_run_analysis_with_events: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -237,8 +281,8 @@ export interface InitOutput {
   readonly wasmvisualiser_set_time: (a: number, b: number) => void;
   readonly wasmvisualiser_take_script_diagnostics_json: (a: number) => [number, number];
   readonly wasmvisualiser_unregister_mesh_asset: (a: number, b: number, c: number) => number;
-  readonly wasmvisualiser_push_rotation_data: (a: number, b: number, c: number, d: number) => void;
   readonly init_panic_hook: () => void;
+  readonly wasmvisualiser_push_rotation_data: (a: number, b: number, c: number, d: number) => void;
   readonly wasm_bindgen__convert__closures_____invoke__h53437a38721e89f7: (a: number, b: number, c: any) => void;
   readonly wasm_bindgen__closure__destroy__hf5eaa61ced318e08: (a: number, b: number) => void;
   readonly wasm_bindgen__convert__closures_____invoke__h9d1c5a23ecfcd5c8: (a: number, b: number, c: any) => void;

package/pkg/visualiser.js

@@ -510,6 +510,32 @@ export class WasmVisualiser {
     clear_band_events() {
         wasm.wasmvisualiser_clear_band_events(this.__wbg_ptr);
     }
+    /**
+     * Push a named event stream (e.g., "beatCandidates") for script access.
+     *
+     * The event stream will be available as `inputs.<name>` in Rhai scripts.
+     * This is used for MIR-derived events like beat candidates, onset peaks, etc.
+     *
+     * The JSON format should be an array of event objects with:
+     * - time: f32
+     * - weight: f32
+     * - beat_position: Option<f32>
+     * - beat_phase: Option<f32>
+     * - cluster_id: Option<u32>
+     *
+     * Returns true if successful, false if parsing failed.
+     * @param {string} name
+     * @param {string} events_json
+     * @returns {boolean}
+     */
+    push_event_stream(name, events_json) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(events_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvisualiser_push_event_stream(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+        return ret !== 0;
+    }
     /**
      * Set debug visualization options.
      * @param {boolean} wireframe
@@ -558,6 +584,27 @@ export class WasmVisualiser {
         const len0 = WASM_VECTOR_LEN;
         wasm.wasmvisualiser_push_data(this.__wbg_ptr, ptr0, len0, sample_rate);
     }
+    /**
+     * Render with a frame budget timeout.
+     *
+     * If the frame takes longer than `budget_ms` to process, it will be dropped
+     * and a warning logged. This prevents expensive scripts from freezing the browser.
+     *
+     * Returns true if the frame completed, false if it was dropped due to budget.
+     * @param {number} dt
+     * @param {number} budget_ms
+     * @returns {boolean}
+     */
+    render_with_budget(dt, budget_ms) {
+        const ret = wasm.wasmvisualiser_render_with_budget(this.__wbg_ptr, dt, budget_ms);
+        return ret !== 0;
+    }
+    /**
+     * Clear all named event streams.
+     */
+    clear_event_streams() {
+        wasm.wasmvisualiser_clear_event_streams(this.__wbg_ptr);
+    }
     /**
      * Check if frequency bands are currently set.
      * @returns {boolean}
@@ -642,6 +689,18 @@ export class WasmVisualiser {
         const ret = wasm.wasmvisualiser_unregister_mesh_asset(this.__wbg_ptr, ptr0, len0);
         return ret !== 0;
     }
+    /**
+     * Get the number of events in a named event stream.
+     * Returns 0 if no events are stored for this name.
+     * @param {string} name
+     * @returns {number}
+     */
+    get_event_stream_count(name) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvisualiser_get_event_stream_count(this.__wbg_ptr, ptr0, len0);
+        return ret >>> 0;
+    }
     /**
      * Get the number of frequency bands.
      * @returns {number}
@@ -677,6 +736,23 @@ export class WasmVisualiser {
             wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
         }
     }
+    /**
+     * Get entity positions as JSON for debugging.
+     * Returns a JSON array of objects with id, type, and position fields.
+     * @returns {string}
+     */
+    get_entity_positions_json() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmvisualiser_get_entity_positions_json(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);
+        }
+    }
     /**
      * Drain and return any pending structured script diagnostics as JSON.
      *
@@ -1414,6 +1490,10 @@ function __wbg_get_imports() {
         const ret = arg0.offset;
         return ret;
     };
+    imports.wbg.__wbg_performance_c77a440eff2efd9b = function(arg0) {
+        const ret = arg0.performance;
+        return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+    };
     imports.wbg.__wbg_popErrorScope_af0b22f136a861d6 = function(arg0) {
         const ret = arg0.popErrorScope();
         return ret;
@@ -1622,13 +1702,13 @@ function __wbg_get_imports() {
         const ret = getStringFromWasm0(arg0, arg1);
         return ret;
     };
-    imports.wbg.__wbindgen_cast_9983f14242864161 = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 2225, function: Function { arguments: [NamedExternref("GPUUncapturedErrorEvent")], shim_idx: 2226, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+    imports.wbg.__wbindgen_cast_3382faf1314a867c = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 2460, function: Function { arguments: [NamedExternref("GPUUncapturedErrorEvent")], shim_idx: 2461, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
         const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__heb49a8f426ac2d2e, wasm_bindgen__convert__closures_____invoke__h9d1c5a23ecfcd5c8);
         return ret;
     };
-    imports.wbg.__wbindgen_cast_adb0bbfefc4aa204 = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 2357, function: Function { arguments: [Externref], shim_idx: 2358, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+    imports.wbg.__wbindgen_cast_81075635f0fa4021 = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 2592, function: Function { arguments: [Externref], shim_idx: 2593, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
         const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hf5eaa61ced318e08, wasm_bindgen__convert__closures_____invoke__h53437a38721e89f7);
         return ret;
     };

package/pkg/visualiser_bg.wasm.d.ts

@@ -6,6 +6,7 @@ export const create_visualiser: (a: any) => any;
 export const get_script_api_metadata_json: () => [number, number];
 export const wasmvisualiser_clear_band_events: (a: number) => void;
 export const wasmvisualiser_clear_band_signals: (a: number) => void;
+export const wasmvisualiser_clear_event_streams: (a: number) => void;
 export const wasmvisualiser_clear_frequency_bands: (a: number) => void;
 export const wasmvisualiser_clear_isolation: (a: number) => void;
 export const wasmvisualiser_clear_musical_time: (a: number) => void;
@@ -14,6 +15,8 @@ export const wasmvisualiser_get_band_bounds_at: (a: number, b: number) => [numbe
 export const wasmvisualiser_get_band_event_count: (a: number, b: number, c: number) => number;
 export const wasmvisualiser_get_band_signal_keys: (a: number) => [number, number];
 export const wasmvisualiser_get_current_vals: (a: number) => [number, number];
+export const wasmvisualiser_get_entity_positions_json: (a: number) => [number, number];
+export const wasmvisualiser_get_event_stream_count: (a: number, b: number, c: number) => number;
 export const wasmvisualiser_get_frequency_band_count: (a: number) => number;
 export const wasmvisualiser_get_script_error: (a: number) => [number, number];
 export const wasmvisualiser_get_signal_names: (a: number) => [number, number];
@@ -26,10 +29,12 @@ export const wasmvisualiser_new: () => number;
 export const wasmvisualiser_push_band_events: (a: number, b: number, c: number, d: number, e: number) => number;
 export const wasmvisualiser_push_band_signal: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
 export const wasmvisualiser_push_data: (a: number, b: number, c: number, d: number) => void;
+export const wasmvisualiser_push_event_stream: (a: number, b: number, c: number, d: number, e: number) => number;
 export const wasmvisualiser_push_signal: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmvisualiser_push_zoom_data: (a: number, b: number, c: number, d: number) => void;
 export const wasmvisualiser_register_mesh_asset: (a: number, b: number, c: number, d: number, e: number) => number;
 export const wasmvisualiser_render: (a: number, b: number) => void;
+export const wasmvisualiser_render_with_budget: (a: number, b: number, c: number) => number;
 export const wasmvisualiser_resize: (a: number, b: number, c: number) => void;
 export const wasmvisualiser_run_analysis: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const wasmvisualiser_run_analysis_with_events: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -40,8 +45,8 @@ export const wasmvisualiser_set_sigmoid_k: (a: number, b: number) => void;
 export const wasmvisualiser_set_time: (a: number, b: number) => void;
 export const wasmvisualiser_take_script_diagnostics_json: (a: number) => [number, number];
 export const wasmvisualiser_unregister_mesh_asset: (a: number, b: number, c: number) => number;
-export const wasmvisualiser_push_rotation_data: (a: number, b: number, c: number, d: number) => void;
 export const init_panic_hook: () => void;
+export const wasmvisualiser_push_rotation_data: (a: number, b: number, c: number, d: number) => void;
 export const wasm_bindgen__convert__closures_____invoke__h53437a38721e89f7: (a: number, b: number, c: any) => void;
 export const wasm_bindgen__closure__destroy__hf5eaa61ced318e08: (a: number, b: number) => void;
 export const wasm_bindgen__convert__closures_____invoke__h9d1c5a23ecfcd5c8: (a: number, b: number, c: any) => void;