@octoseq/visualiser 0.1.0-main.ef9b77a → 0.1.0-main.f485112

package/package.json

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

package/pkg/visualiser.d.ts

@@ -8,6 +8,10 @@ export class WasmVisualiser {
    * Check if a script is currently loaded.
    */
   has_script(): boolean;
+  /**
+   * Check if a signal variable exists in the current script.
+   */
+  has_signal(name: string): boolean;
   /**
    * Load a Rhai script for controlling the visualiser.
    * Returns true if the script was loaded successfully.
@@ -89,6 +93,18 @@ export class WasmVisualiser {
    * - `sample_rate`: Sample rate of the signal.
    */
   push_band_signal(band_id: string, band_label: string, feature: string, samples: Float32Array, sample_rate: number): void;
+  /**
+   * Push a stem-scoped signal for use in scripts.
+   * The signal will be available as `inputs.stems[stem_id].{feature}` in Rhai scripts.
+   * Stores under both stem_id and stem_label for dual-access support.
+   *
+   * - `stem_id`: The unique ID of the stem.
+   * - `stem_label`: The user-visible label of the stem.
+   * - `feature`: Signal type ("energy", "onset", "flux").
+   * - `samples`: Signal data.
+   * - `sample_rate`: Sample rate of the signal.
+   */
+  push_stem_signal(stem_id: string, stem_label: string, feature: string, samples: Float32Array, sample_rate: number): void;
   /**
    * Set the musical time structure for beat-aware signal processing.
    * The JSON format matches the TypeScript MusicalTimeStructure type.
@@ -128,11 +144,30 @@ export class WasmVisualiser {
    * Beat-aware operations will fall back to 120 BPM default.
    */
   clear_musical_time(): void;
+  /**
+   * Clear all stem signals.
+   */
+  clear_stem_signals(): void;
   /**
    * Get frequency bounds for all active bands at a given time.
    * Returns a JSON array of { bandId, label, lowHz, highHz, enabled } objects.
    */
   get_band_bounds_at(time: number): string;
+  /**
+   * Get all Signal variables from the current script.
+   * Returns a JSON array of ScriptSignalInfo objects.
+   */
+  get_script_signals(): string;
+  /**
+   * Push a custom signal for use in scripts.
+   * The signal will be available as `inputs.customSignals["signal_id"]` in Rhai scripts.
+   *
+   * - `signal_id`: The unique ID of the custom signal.
+   * - `label`: The user-visible label of the signal.
+   * - `samples`: Signal data.
+   * - `sample_rate`: Sample rate of the signal.
+   */
+  push_custom_signal(signal_id: string, label: string, samples: Float32Array, sample_rate: number): void;
   push_rotation_data(samples: Float32Array, sample_rate: number): void;
   /**
    * Render with a frame budget timeout.
@@ -157,12 +192,41 @@ export class WasmVisualiser {
    * Returns true if successful, false if parsing failed.
    */
   register_mesh_asset(asset_id: string, obj_content: string): boolean;
+  /**
+   * Set available stems for script namespace generation.
+   * This registers stem IDs and labels so the script engine can generate
+   * `inputs.stems["stem_id"]` and `inputs.stems["label"]` accessors.
+   *
+   * The JSON format should be an array of [id, label] pairs:
+   * `[["stem-abc123", "Drums"], ["stem-def456", "Bass"]]`
+   *
+   * Returns true if successful, false if parsing failed.
+   */
+  set_available_stems(json: string): boolean;
   /**
    * Set the frequency band structure for band-aware processing.
    * The JSON format matches the TypeScript FrequencyBandStructure type.
    * Returns true if successful, false if parsing failed.
    */
   set_frequency_bands(json: string): boolean;
+  /**
+   * Analyze a signal chain with localized sampling.
+   *
+   * Returns JSON with either:
+   * - SignalChainAnalysis on success
+   * - { "error": "message" } on failure
+   *
+   * Parameters:
+   * - signal_name: Name of the signal variable in the script
+   * - center_time: Time to center analysis around (seconds)
+   * - window_beats: Number of beats before/after center to sample
+   * - sample_count: Number of samples to take
+   */
+  analyze_signal_chain(signal_name: string, center_time: number, window_beats: number, sample_count: number): string;
+  /**
+   * Clear all custom signals.
+   */
+  clear_custom_signals(): void;
   /**
    * Get the number of events for a specific band.
    * Returns 0 if no events are stored for this band.
@@ -173,15 +237,52 @@ export class WasmVisualiser {
    * Returns a JSON array of strings.
    */
   get_band_signal_keys(): string;
+  /**
+   * Get list of stem keys (IDs and labels) that have signals.
+   * Returns a JSON array of strings.
+   */
+  get_stem_signal_keys(): string;
+  /**
+   * Check if performance profiling is currently enabled.
+   */
+  is_profiling_enabled(): boolean;
+  /**
+   * Push a composed signal for use in scripts.
+   * The signal will be available as `inputs.composedSignals["name"]` in Rhai scripts.
+   *
+   * - `name`: The composed signal name (composed signals are keyed by name only).
+   * - `samples`: Signal data.
+   * - `sample_rate`: Sample rate of the signal.
+   */
+  push_composed_signal(name: string, samples: Float32Array, sample_rate: number): void;
   /**
    * Clear the frequency band structure.
    */
   clear_frequency_bands(): void;
+  /**
+   * Get camera state as JSON for inspector.
+   * Returns current position, rotation, target, fov, near, far, mode, and signal flags.
+   */
+  get_camera_state_json(): string;
+  /**
+   * Enable or disable performance profiling.
+   * When enabled, console timing and collection size logging will be active.
+   */
+  set_profiling_enabled(enabled: boolean): void;
   /**
    * Unregister a mesh asset.
    * Returns true if the asset was unregistered, false if it didn't exist.
    */
   unregister_mesh_asset(asset_id: string): boolean;
+  /**
+   * Clear all composed signals.
+   */
+  clear_composed_signals(): void;
+  /**
+   * Get list of custom signal keys (IDs and labels).
+   * Returns a JSON array of strings.
+   */
+  get_custom_signal_keys(): string;
   /**
    * Get the number of events in a named event stream.
    * Returns 0 if no events are stored for this name.
@@ -206,6 +307,37 @@ export class WasmVisualiser {
    * Returns a JSON array of objects with id, type, and position fields.
    */
   get_entity_positions_json(): string;
+  /**
+   * Push an authored event stream for script access.
+   *
+   * The event stream will be available as `inputs.authored["name"]` in Rhai scripts.
+   * This is used for user-authored events (promoted or manually created).
+   *
+   * 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_authored_event_stream(name: string, events_json: string): boolean;
+  /**
+   * Clear all authored event streams.
+   */
+  clear_authored_event_streams(): void;
+  /**
+   * Set available custom signals for script namespace generation.
+   * This registers custom signal IDs and labels so the script engine can generate
+   * `inputs.customSignals["signal_id"]` accessors.
+   *
+   * The JSON format should be an array of [id, label] pairs:
+   * `[["signal-abc123", "My Signal"], ["signal-def456", "Another Signal"]]`
+   *
+   * Returns true if successful, false if parsing failed.
+   */
+  set_available_custom_signals(json: string): boolean;
   /**
    * Drain and return any pending structured script diagnostics as JSON.
    *
@@ -213,6 +345,22 @@ export class WasmVisualiser {
    * queue so repeated polling does not duplicate messages.
    */
   take_script_diagnostics_json(): string;
+  /**
+   * Set available composed signals for script namespace generation.
+   * This registers composed signal IDs and labels so the script engine can generate
+   * `inputs.composedSignals["name"]` accessors.
+   *
+   * The JSON format should be an array of [id, label] pairs:
+   * `[["intensity", "intensity"], ["buildup", "buildup"]]`
+   *
+   * Returns true if successful, false if parsing failed.
+   */
+  set_available_composed_signals(json: string): boolean;
+  /**
+   * Get the number of events in an authored event stream.
+   * Returns 0 if no events are stored for this name.
+   */
+  get_authored_event_stream_count(name: string): number;
   constructor();
   render(dt: number): void;
   resize(width: number, height: number): void;
@@ -240,33 +388,50 @@ export interface InitOutput {
   readonly __wbg_wasmvisualiser_free: (a: number, b: number) => void;
   readonly create_visualiser: (a: any) => any;
   readonly get_script_api_metadata_json: () => [number, number];
+  readonly wasmvisualiser_analyze_signal_chain: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+  readonly wasmvisualiser_clear_authored_event_streams: (a: number) => void;
   readonly wasmvisualiser_clear_band_events: (a: number) => void;
   readonly wasmvisualiser_clear_band_signals: (a: number) => void;
+  readonly wasmvisualiser_clear_composed_signals: (a: number) => void;
+  readonly wasmvisualiser_clear_custom_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;
   readonly wasmvisualiser_clear_signals: (a: number) => void;
+  readonly wasmvisualiser_clear_stem_signals: (a: number) => void;
+  readonly wasmvisualiser_get_authored_event_stream_count: (a: number, b: number, c: number) => number;
   readonly wasmvisualiser_get_band_bounds_at: (a: number, b: number) => [number, number];
   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_camera_state_json: (a: number) => [number, number];
   readonly wasmvisualiser_get_current_vals: (a: number) => [number, number];
+  readonly wasmvisualiser_get_custom_signal_keys: (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_script_signals: (a: number) => [number, number];
   readonly wasmvisualiser_get_signal_names: (a: number) => [number, number];
+  readonly wasmvisualiser_get_stem_signal_keys: (a: number) => [number, number];
   readonly wasmvisualiser_has_frequency_bands: (a: number) => number;
   readonly wasmvisualiser_has_script: (a: number) => number;
+  readonly wasmvisualiser_has_signal: (a: number, b: number, c: number) => number;
+  readonly wasmvisualiser_is_profiling_enabled: (a: number) => number;
   readonly wasmvisualiser_isolate_entity: (a: number, b: bigint) => void;
   readonly wasmvisualiser_list_mesh_assets: (a: number) => [number, number];
   readonly wasmvisualiser_load_script: (a: number, b: number, c: number) => number;
   readonly wasmvisualiser_new: () => number;
+  readonly wasmvisualiser_push_authored_event_stream: (a: number, b: number, c: number, d: number, e: number) => number;
   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_composed_signal: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+  readonly wasmvisualiser_push_custom_signal: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: 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_rotation_data: (a: number, b: number, c: number, d: number) => void;
   readonly wasmvisualiser_push_signal: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+  readonly wasmvisualiser_push_stem_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_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;
@@ -274,20 +439,23 @@ export interface InitOutput {
   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];
+  readonly wasmvisualiser_set_available_composed_signals: (a: number, b: number, c: number) => number;
+  readonly wasmvisualiser_set_available_custom_signals: (a: number, b: number, c: number) => number;
+  readonly wasmvisualiser_set_available_stems: (a: number, b: number, c: number) => number;
   readonly wasmvisualiser_set_debug_options: (a: number, b: number, c: number) => void;
   readonly wasmvisualiser_set_frequency_bands: (a: number, b: number, c: number) => number;
   readonly wasmvisualiser_set_musical_time: (a: number, b: number, c: number) => number;
+  readonly wasmvisualiser_set_profiling_enabled: (a: number, b: number) => void;
   readonly wasmvisualiser_set_sigmoid_k: (a: number, b: number) => void;
   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 init_panic_hook: () => void;
-  readonly wasmvisualiser_push_rotation_data: (a: number, b: number, c: number, d: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h9d1c5a23ecfcd5c8: (a: number, b: number, c: any) => void;
-  readonly wasm_bindgen__closure__destroy__heb49a8f426ac2d2e: (a: number, b: 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__h320f3d825d3712ba: (a: number, b: number, c: any, d: any) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h21c634b0b0f83d75: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__hbe34fa9c2b795850: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h99981589310a7d61: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__hbe29fa491d28c510: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h4dbe1f4cd0045c74: (a: number, b: number, c: any, d: any) => void;
   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/pkg/visualiser.js

@@ -241,16 +241,16 @@ if (!('encodeInto' in cachedTextEncoder)) {
 
 let WASM_VECTOR_LEN = 0;
 
-function wasm_bindgen__convert__closures_____invoke__h9d1c5a23ecfcd5c8(arg0, arg1, arg2) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h9d1c5a23ecfcd5c8(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h21c634b0b0f83d75(arg0, arg1, arg2) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h21c634b0b0f83d75(arg0, arg1, arg2);
 }
 
-function wasm_bindgen__convert__closures_____invoke__h53437a38721e89f7(arg0, arg1, arg2) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h53437a38721e89f7(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h99981589310a7d61(arg0, arg1, arg2) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h99981589310a7d61(arg0, arg1, arg2);
 }
 
-function wasm_bindgen__convert__closures_____invoke__h320f3d825d3712ba(arg0, arg1, arg2, arg3) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h320f3d825d3712ba(arg0, arg1, arg2, arg3);
+function wasm_bindgen__convert__closures_____invoke__h4dbe1f4cd0045c74(arg0, arg1, arg2, arg3) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h4dbe1f4cd0045c74(arg0, arg1, arg2, arg3);
 }
 
 const __wbindgen_enum_GpuCompilationMessageType = ["error", "warning", "info"];
@@ -293,6 +293,17 @@ export class WasmVisualiser {
         const ret = wasm.wasmvisualiser_has_script(this.__wbg_ptr);
         return ret !== 0;
     }
+    /**
+     * Check if a signal variable exists in the current script.
+     * @param {string} name
+     * @returns {boolean}
+     */
+    has_signal(name) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvisualiser_has_signal(this.__wbg_ptr, ptr0, len0);
+        return ret !== 0;
+    }
     /**
      * Load a Rhai script for controlling the visualiser.
      * Returns true if the script was loaded successfully.
@@ -491,6 +502,33 @@ export class WasmVisualiser {
         const len3 = WASM_VECTOR_LEN;
         wasm.wasmvisualiser_push_band_signal(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, sample_rate);
     }
+    /**
+     * Push a stem-scoped signal for use in scripts.
+     * The signal will be available as `inputs.stems[stem_id].{feature}` in Rhai scripts.
+     * Stores under both stem_id and stem_label for dual-access support.
+     *
+     * - `stem_id`: The unique ID of the stem.
+     * - `stem_label`: The user-visible label of the stem.
+     * - `feature`: Signal type ("energy", "onset", "flux").
+     * - `samples`: Signal data.
+     * - `sample_rate`: Sample rate of the signal.
+     * @param {string} stem_id
+     * @param {string} stem_label
+     * @param {string} feature
+     * @param {Float32Array} samples
+     * @param {number} sample_rate
+     */
+    push_stem_signal(stem_id, stem_label, feature, samples, sample_rate) {
+        const ptr0 = passStringToWasm0(stem_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(stem_label, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(feature, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passArrayF32ToWasm0(samples, wasm.__wbindgen_malloc);
+        const len3 = WASM_VECTOR_LEN;
+        wasm.wasmvisualiser_push_stem_signal(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, sample_rate);
+    }
     /**
      * Set the musical time structure for beat-aware signal processing.
      * The JSON format matches the TypeScript MusicalTimeStructure type.
@@ -557,6 +595,12 @@ export class WasmVisualiser {
     clear_musical_time() {
         wasm.wasmvisualiser_clear_musical_time(this.__wbg_ptr);
     }
+    /**
+     * Clear all stem signals.
+     */
+    clear_stem_signals() {
+        wasm.wasmvisualiser_clear_stem_signals(this.__wbg_ptr);
+    }
     /**
      * Get frequency bounds for all active bands at a given time.
      * Returns a JSON array of { bandId, label, lowHz, highHz, enabled } objects.
@@ -575,6 +619,45 @@ export class WasmVisualiser {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Get all Signal variables from the current script.
+     * Returns a JSON array of ScriptSignalInfo objects.
+     * @returns {string}
+     */
+    get_script_signals() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmvisualiser_get_script_signals(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);
+        }
+    }
+    /**
+     * Push a custom signal for use in scripts.
+     * The signal will be available as `inputs.customSignals["signal_id"]` in Rhai scripts.
+     *
+     * - `signal_id`: The unique ID of the custom signal.
+     * - `label`: The user-visible label of the signal.
+     * - `samples`: Signal data.
+     * - `sample_rate`: Sample rate of the signal.
+     * @param {string} signal_id
+     * @param {string} label
+     * @param {Float32Array} samples
+     * @param {number} sample_rate
+     */
+    push_custom_signal(signal_id, label, samples, sample_rate) {
+        const ptr0 = passStringToWasm0(signal_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(label, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passArrayF32ToWasm0(samples, wasm.__wbindgen_malloc);
+        const len2 = WASM_VECTOR_LEN;
+        wasm.wasmvisualiser_push_custom_signal(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, sample_rate);
+    }
     /**
      * @param {Float32Array} samples
      * @param {number} sample_rate
@@ -582,7 +665,7 @@ export class WasmVisualiser {
     push_rotation_data(samples, sample_rate) {
         const ptr0 = passArrayF32ToWasm0(samples, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        wasm.wasmvisualiser_push_data(this.__wbg_ptr, ptr0, len0, sample_rate);
+        wasm.wasmvisualiser_push_rotation_data(this.__wbg_ptr, ptr0, len0, sample_rate);
     }
     /**
      * Render with a frame budget timeout.
@@ -629,6 +712,24 @@ export class WasmVisualiser {
         const ret = wasm.wasmvisualiser_register_mesh_asset(this.__wbg_ptr, ptr0, len0, ptr1, len1);
         return ret !== 0;
     }
+    /**
+     * Set available stems for script namespace generation.
+     * This registers stem IDs and labels so the script engine can generate
+     * `inputs.stems["stem_id"]` and `inputs.stems["label"]` accessors.
+     *
+     * The JSON format should be an array of [id, label] pairs:
+     * `[["stem-abc123", "Drums"], ["stem-def456", "Bass"]]`
+     *
+     * Returns true if successful, false if parsing failed.
+     * @param {string} json
+     * @returns {boolean}
+     */
+    set_available_stems(json) {
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvisualiser_set_available_stems(this.__wbg_ptr, ptr0, len0);
+        return ret !== 0;
+    }
     /**
      * Set the frequency band structure for band-aware processing.
      * The JSON format matches the TypeScript FrequencyBandStructure type.
@@ -642,6 +743,44 @@ export class WasmVisualiser {
         const ret = wasm.wasmvisualiser_set_frequency_bands(this.__wbg_ptr, ptr0, len0);
         return ret !== 0;
     }
+    /**
+     * Analyze a signal chain with localized sampling.
+     *
+     * Returns JSON with either:
+     * - SignalChainAnalysis on success
+     * - { "error": "message" } on failure
+     *
+     * Parameters:
+     * - signal_name: Name of the signal variable in the script
+     * - center_time: Time to center analysis around (seconds)
+     * - window_beats: Number of beats before/after center to sample
+     * - sample_count: Number of samples to take
+     * @param {string} signal_name
+     * @param {number} center_time
+     * @param {number} window_beats
+     * @param {number} sample_count
+     * @returns {string}
+     */
+    analyze_signal_chain(signal_name, center_time, window_beats, sample_count) {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const ptr0 = passStringToWasm0(signal_name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ret = wasm.wasmvisualiser_analyze_signal_chain(this.__wbg_ptr, ptr0, len0, center_time, window_beats, sample_count);
+            deferred2_0 = ret[0];
+            deferred2_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        }
+    }
+    /**
+     * Clear all custom signals.
+     */
+    clear_custom_signals() {
+        wasm.wasmvisualiser_clear_custom_signals(this.__wbg_ptr);
+    }
     /**
      * Get the number of events for a specific band.
      * Returns 0 if no events are stored for this band.
@@ -671,12 +810,80 @@ export class WasmVisualiser {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Get list of stem keys (IDs and labels) that have signals.
+     * Returns a JSON array of strings.
+     * @returns {string}
+     */
+    get_stem_signal_keys() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmvisualiser_get_stem_signal_keys(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);
+        }
+    }
+    /**
+     * Check if performance profiling is currently enabled.
+     * @returns {boolean}
+     */
+    is_profiling_enabled() {
+        const ret = wasm.wasmvisualiser_is_profiling_enabled(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Push a composed signal for use in scripts.
+     * The signal will be available as `inputs.composedSignals["name"]` in Rhai scripts.
+     *
+     * - `name`: The composed signal name (composed signals are keyed by name only).
+     * - `samples`: Signal data.
+     * - `sample_rate`: Sample rate of the signal.
+     * @param {string} name
+     * @param {Float32Array} samples
+     * @param {number} sample_rate
+     */
+    push_composed_signal(name, samples, sample_rate) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArrayF32ToWasm0(samples, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.wasmvisualiser_push_composed_signal(this.__wbg_ptr, ptr0, len0, ptr1, len1, sample_rate);
+    }
     /**
      * Clear the frequency band structure.
      */
     clear_frequency_bands() {
         wasm.wasmvisualiser_clear_frequency_bands(this.__wbg_ptr);
     }
+    /**
+     * Get camera state as JSON for inspector.
+     * Returns current position, rotation, target, fov, near, far, mode, and signal flags.
+     * @returns {string}
+     */
+    get_camera_state_json() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmvisualiser_get_camera_state_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);
+        }
+    }
+    /**
+     * Enable or disable performance profiling.
+     * When enabled, console timing and collection size logging will be active.
+     * @param {boolean} enabled
+     */
+    set_profiling_enabled(enabled) {
+        wasm.wasmvisualiser_set_profiling_enabled(this.__wbg_ptr, enabled);
+    }
     /**
      * Unregister a mesh asset.
      * Returns true if the asset was unregistered, false if it didn't exist.
@@ -689,6 +896,29 @@ export class WasmVisualiser {
         const ret = wasm.wasmvisualiser_unregister_mesh_asset(this.__wbg_ptr, ptr0, len0);
         return ret !== 0;
     }
+    /**
+     * Clear all composed signals.
+     */
+    clear_composed_signals() {
+        wasm.wasmvisualiser_clear_composed_signals(this.__wbg_ptr);
+    }
+    /**
+     * Get list of custom signal keys (IDs and labels).
+     * Returns a JSON array of strings.
+     * @returns {string}
+     */
+    get_custom_signal_keys() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmvisualiser_get_custom_signal_keys(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);
+        }
+    }
     /**
      * Get the number of events in a named event stream.
      * Returns 0 if no events are stored for this name.
@@ -753,6 +983,56 @@ export class WasmVisualiser {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Push an authored event stream for script access.
+     *
+     * The event stream will be available as `inputs.authored["name"]` in Rhai scripts.
+     * This is used for user-authored events (promoted or manually created).
+     *
+     * 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_authored_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_authored_event_stream(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+        return ret !== 0;
+    }
+    /**
+     * Clear all authored event streams.
+     */
+    clear_authored_event_streams() {
+        wasm.wasmvisualiser_clear_authored_event_streams(this.__wbg_ptr);
+    }
+    /**
+     * Set available custom signals for script namespace generation.
+     * This registers custom signal IDs and labels so the script engine can generate
+     * `inputs.customSignals["signal_id"]` accessors.
+     *
+     * The JSON format should be an array of [id, label] pairs:
+     * `[["signal-abc123", "My Signal"], ["signal-def456", "Another Signal"]]`
+     *
+     * Returns true if successful, false if parsing failed.
+     * @param {string} json
+     * @returns {boolean}
+     */
+    set_available_custom_signals(json) {
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvisualiser_set_available_custom_signals(this.__wbg_ptr, ptr0, len0);
+        return ret !== 0;
+    }
     /**
      * Drain and return any pending structured script diagnostics as JSON.
      *
@@ -772,6 +1052,36 @@ export class WasmVisualiser {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Set available composed signals for script namespace generation.
+     * This registers composed signal IDs and labels so the script engine can generate
+     * `inputs.composedSignals["name"]` accessors.
+     *
+     * The JSON format should be an array of [id, label] pairs:
+     * `[["intensity", "intensity"], ["buildup", "buildup"]]`
+     *
+     * Returns true if successful, false if parsing failed.
+     * @param {string} json
+     * @returns {boolean}
+     */
+    set_available_composed_signals(json) {
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvisualiser_set_available_composed_signals(this.__wbg_ptr, ptr0, len0);
+        return ret !== 0;
+    }
+    /**
+     * Get the number of events in an authored event stream.
+     * Returns 0 if no events are stored for this name.
+     * @param {string} name
+     * @returns {number}
+     */
+    get_authored_event_stream_count(name) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvisualiser_get_authored_event_stream_count(this.__wbg_ptr, ptr0, len0);
+        return ret >>> 0;
+    }
     constructor() {
         const ret = wasm.wasmvisualiser_new();
         this.__wbg_ptr = ret >>> 0;
@@ -1459,7 +1769,7 @@ function __wbg_get_imports() {
                 const a = state0.a;
                 state0.a = 0;
                 try {
-                    return wasm_bindgen__convert__closures_____invoke__h320f3d825d3712ba(a, state0.b, arg0, arg1);
+                    return wasm_bindgen__convert__closures_____invoke__h4dbe1f4cd0045c74(a, state0.b, arg0, arg1);
                 } finally {
                     state0.a = a;
                 }
@@ -1665,6 +1975,12 @@ function __wbg_get_imports() {
         const ret = arg0.then(arg1);
         return ret;
     };
+    imports.wbg.__wbg_timeEnd_46ed224117e5f2d2 = function(arg0, arg1) {
+        console.timeEnd(getStringFromWasm0(arg0, arg1));
+    };
+    imports.wbg.__wbg_time_c49415b636fbbf3f = function(arg0, arg1) {
+        console.time(getStringFromWasm0(arg0, arg1));
+    };
     imports.wbg.__wbg_type_c0d5d83032e9858a = function(arg0) {
         const ret = arg0.type;
         return (__wbindgen_enum_GpuCompilationMessageType.indexOf(ret) + 1 || 4) - 1;
@@ -1702,14 +2018,14 @@ function __wbg_get_imports() {
         const ret = getStringFromWasm0(arg0, arg1);
         return ret;
     };
-    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);
+    imports.wbg.__wbindgen_cast_6e1a5c3e219620cc = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 3569, function: Function { arguments: [Externref], shim_idx: 3570, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hbe29fa491d28c510, wasm_bindgen__convert__closures_____invoke__h99981589310a7d61);
         return ret;
     };
-    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);
+    imports.wbg.__wbindgen_cast_77ea2f6a269d2527 = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 3560, function: Function { arguments: [NamedExternref("GPUUncapturedErrorEvent")], shim_idx: 3561, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hbe34fa9c2b795850, wasm_bindgen__convert__closures_____invoke__h21c634b0b0f83d75);
         return ret;
     };
     imports.wbg.__wbindgen_cast_cb9088102bce6b30 = function(arg0, arg1) {

package/pkg/visualiser_bg.wasm.d.ts

@@ -4,33 +4,50 @@ export const memory: WebAssembly.Memory;
 export const __wbg_wasmvisualiser_free: (a: number, b: number) => void;
 export const create_visualiser: (a: any) => any;
 export const get_script_api_metadata_json: () => [number, number];
+export const wasmvisualiser_analyze_signal_chain: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+export const wasmvisualiser_clear_authored_event_streams: (a: number) => void;
 export const wasmvisualiser_clear_band_events: (a: number) => void;
 export const wasmvisualiser_clear_band_signals: (a: number) => void;
+export const wasmvisualiser_clear_composed_signals: (a: number) => void;
+export const wasmvisualiser_clear_custom_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;
 export const wasmvisualiser_clear_signals: (a: number) => void;
+export const wasmvisualiser_clear_stem_signals: (a: number) => void;
+export const wasmvisualiser_get_authored_event_stream_count: (a: number, b: number, c: number) => number;
 export const wasmvisualiser_get_band_bounds_at: (a: number, b: number) => [number, number];
 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_camera_state_json: (a: number) => [number, number];
 export const wasmvisualiser_get_current_vals: (a: number) => [number, number];
+export const wasmvisualiser_get_custom_signal_keys: (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_script_signals: (a: number) => [number, number];
 export const wasmvisualiser_get_signal_names: (a: number) => [number, number];
+export const wasmvisualiser_get_stem_signal_keys: (a: number) => [number, number];
 export const wasmvisualiser_has_frequency_bands: (a: number) => number;
 export const wasmvisualiser_has_script: (a: number) => number;
+export const wasmvisualiser_has_signal: (a: number, b: number, c: number) => number;
+export const wasmvisualiser_is_profiling_enabled: (a: number) => number;
 export const wasmvisualiser_isolate_entity: (a: number, b: bigint) => void;
 export const wasmvisualiser_list_mesh_assets: (a: number) => [number, number];
 export const wasmvisualiser_load_script: (a: number, b: number, c: number) => number;
 export const wasmvisualiser_new: () => number;
+export const wasmvisualiser_push_authored_event_stream: (a: number, b: number, c: number, d: number, e: number) => 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_composed_signal: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmvisualiser_push_custom_signal: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: 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_rotation_data: (a: number, b: number, c: number, d: number) => void;
 export const wasmvisualiser_push_signal: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmvisualiser_push_stem_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_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;
@@ -38,20 +55,23 @@ export const wasmvisualiser_render_with_budget: (a: number, b: number, c: 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];
+export const wasmvisualiser_set_available_composed_signals: (a: number, b: number, c: number) => number;
+export const wasmvisualiser_set_available_custom_signals: (a: number, b: number, c: number) => number;
+export const wasmvisualiser_set_available_stems: (a: number, b: number, c: number) => number;
 export const wasmvisualiser_set_debug_options: (a: number, b: number, c: number) => void;
 export const wasmvisualiser_set_frequency_bands: (a: number, b: number, c: number) => number;
 export const wasmvisualiser_set_musical_time: (a: number, b: number, c: number) => number;
+export const wasmvisualiser_set_profiling_enabled: (a: number, b: number) => void;
 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 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__h9d1c5a23ecfcd5c8: (a: number, b: number, c: any) => void;
-export const wasm_bindgen__closure__destroy__heb49a8f426ac2d2e: (a: number, b: 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__h320f3d825d3712ba: (a: number, b: number, c: any, d: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h21c634b0b0f83d75: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__closure__destroy__hbe34fa9c2b795850: (a: number, b: number) => void;
+export const wasm_bindgen__convert__closures_____invoke__h99981589310a7d61: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__closure__destroy__hbe29fa491d28c510: (a: number, b: number) => void;
+export const wasm_bindgen__convert__closures_____invoke__h4dbe1f4cd0045c74: (a: number, b: number, c: any, d: any) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;