@libraz/libsonare 1.7.2 → 1.8.0

package/src/worklet/voice-changer-processor.ts

@@ -1,6 +1,6 @@
 import { RealtimeVoiceChanger } from '../index';
-import type { WorkletInput, WorkletOutput } from './audio_types';
-import { isRealtimeVoiceChangerMessage } from './guards';
+import { copyPlanesToOutput, type WorkletInput, type WorkletOutput } from './audio_types';
+import { isRealtimeVoiceChangerMessage, requireChannelCount } from './guards';
 import type {
   SonareRealtimeVoiceChangerMessage,
   SonareRealtimeVoiceChangerWorkletProcessorOptions,
@@ -25,12 +25,14 @@ export class SonareRealtimeVoiceChangerWorkletProcessor {
   // Float32Arrays, so this avoids the per-sample interleave/deinterleave
   // passes that the older interleaved path needed.
   private planarChannels: Float32Array[];
+  // Reused so the mono fan-out never builds an array on the audio thread.
+  private readonly monoPlane: Float32Array[] = [new Float32Array(0)];
   private destroyed = false;
 
   constructor(options: SonareRealtimeVoiceChangerWorkletProcessorOptions = {}) {
     this.sampleRate = options.sampleRate ?? 48000;
     this.blockSize = options.blockSize ?? 128;
-    this.channelCount = Math.max(1, Math.floor(options.channelCount ?? 1));
+    this.channelCount = requireChannelCount(options.channelCount, 1);
     this.changer = new RealtimeVoiceChanger(options.preset ?? 'neutral-monitor');
     this.changer.prepare(this.sampleRate, this.blockSize, this.channelCount);
     // Acquire WASM-heap views once, sized to the worst case. These are alive
@@ -100,7 +102,14 @@ export class SonareRealtimeVoiceChangerWorkletProcessor {
         this.monoInput.fill(0, 0, frames);
       }
       this.changer.processPreparedMono(frames);
-      output[0].set(this.monoOutput.subarray(0, frames));
+      // One plane fans out to every output channel and anything it does not
+      // fill is zeroed. Writing only output[0] left a stereo host hard-panned
+      // left -- the default `channelCount` here is 1 while AudioWorkletNode's
+      // default `channelCountMode: 'max'` gives a 2-channel output, so that was
+      // the ordinary configuration -- and left the previous block's samples in
+      // the channels it skipped.
+      this.monoPlane[0] = this.monoOutput;
+      copyPlanesToOutput(output, this.monoPlane, frames);
       return true;
     }
 
@@ -122,13 +131,10 @@ export class SonareRealtimeVoiceChangerWorkletProcessor {
       }
     }
     this.changer.processPreparedPlanar(frames);
-    for (let ch = 0; ch < channels; ch++) {
-      const src = this.planarChannels[ch];
-      if (src) {
-        output[ch].set(src.subarray(0, frames));
-      }
-      // No `for frame` inner loop needed; output[ch] is a Float32Array.
-    }
+    // Same rule as the mono branch: an output channel past the last processed
+    // plane is silence rather than a duplicate of plane 0, and the tail past
+    // `frames` is zeroed.
+    copyPlanesToOutput(output, this.planarChannels, frames);
     return true;
   }
 

package/src/worklet.ts

@@ -26,6 +26,7 @@ export type {
   SonareEngineClipPageRequestMessage,
   SonareEngineSyncAutomationMessage,
   SonareEngineSyncBuiltinInstrumentMessage,
+  SonareEngineSyncBusStripEqBandMessage,
   SonareEngineSyncCaptureMessage,
   SonareEngineSyncClipsDeltaMessage,
   SonareEngineSyncClipsMessage,
@@ -48,6 +49,17 @@ export type {
   SonareEngineTransportFacade,
   SonareEngineTransportRequestMessage,
   SonareEngineTransportResponseMessage,
+  SonarePlaybackConfigMessage,
+  SonarePlaybackDestroyMessage,
+  SonarePlaybackDiagnosticsReplyMessage,
+  SonarePlaybackDiagnosticsRequestMessage,
+  SonarePlaybackErrorMessage,
+  SonarePlaybackMessage,
+  SonarePlaybackNodeOptions,
+  SonarePlaybackOrientationMessage,
+  SonarePlaybackResetMessage,
+  SonarePlaybackWorkletDiagnostics,
+  SonarePlaybackWorkletProcessorOptions,
   SonareRealtimeEngineNodeCapabilities,
   SonareRealtimeEngineNodeOptions,
   SonareRealtimeEngineWorkletProcessorOptions,
@@ -67,6 +79,11 @@ export {
   registerSonareWorkletProcessor,
   SonareWorkletProcessor,
 } from './worklet/mixer-processor';
+export {
+  createSonarePlaybackNode,
+  registerSonarePlaybackWorkletProcessor,
+  SonarePlaybackWorkletProcessor,
+} from './worklet/playback-processor';
 export {
   createSonareClipPageRequestRingBuffer,
   createSonareEngineCommandRingBuffer,