@libraz/libsonare 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libraz/libsonare",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "packageManager": "yarn@4.12.0",
   "description": "Audio analysis library for music information retrieval",

package/src/index.ts

@@ -66,6 +66,7 @@ import type {
   StftResult,
   StreamingEqualizerConfig,
   StreamingPlatform,
+  StreamingRetuneConfig,
   TempogramMode,
 } from './public_types';
 import { KeyProfile as KeyProfileValues, Mode, PitchClass } from './public_types';
@@ -162,6 +163,7 @@ export type {
   StftResult,
   StreamingEqualizerConfig,
   StreamingPlatform,
+  StreamingRetuneConfig,
   Timbre,
   TimeSignature,
 } from './public_types';
@@ -1683,6 +1685,69 @@ export class StreamingEqualizer {
   }
 }
 
+// ============================================================================
+// StreamingRetune Class
+// ============================================================================
+
+/**
+ * Block-by-block mono voice retune / pitch shifter.
+ *
+ * State is maintained across {@link processMono} calls. Call {@link prepare}
+ * before processing, and call {@link delete} (or use `try/finally`) to release
+ * the underlying WASM object.
+ */
+export class StreamingRetune {
+  private retune: import('./wasm_types').WasmStreamingRetune;
+
+  constructor(config: StreamingRetuneConfig = {}) {
+    if (!module) {
+      throw new Error('Module not initialized. Call init() first.');
+    }
+    this.retune = module.createStreamingRetune(config as Record<string, unknown>);
+  }
+
+  /**
+   * Allocate and initialize native state for the given sample rate and maximum
+   * process block size.
+   */
+  prepare(sampleRate: number, maxBlockSize: number): void {
+    this.retune.prepare(sampleRate, maxBlockSize);
+  }
+
+  /** Reset delay, grain, and overlap-add state without changing config. */
+  reset(): void {
+    this.retune.reset();
+  }
+
+  /**
+   * Update retune settings. Changing `grainSize` takes effect after the next
+   * {@link prepare} call.
+   */
+  setConfig(config: StreamingRetuneConfig): void {
+    this.retune.setConfig(config as Record<string, unknown>);
+  }
+
+  /** Current native config. */
+  config(): Required<StreamingRetuneConfig> {
+    return this.retune.config();
+  }
+
+  /** Resolved grain size in samples after {@link prepare}. */
+  grainSize(): number {
+    return this.retune.grainSize();
+  }
+
+  /** Process one mono block, returning the shifted samples (same length). */
+  processMono(samples: Float32Array): Float32Array {
+    return this.retune.processMono(samples);
+  }
+
+  /** Release the underlying WASM object. Safe to call only once. */
+  delete(): void {
+    this.retune.delete();
+  }
+}
+
 // ============================================================================
 // Mixer Class (scene-based persistent mixer)
 // ============================================================================

package/src/public_types.ts

@@ -845,6 +845,16 @@ export interface StreamingEqualizerConfig {
   maxBlockSize?: number;
 }
 
+/** Configuration for {@link StreamingRetune}. */
+export interface StreamingRetuneConfig {
+  /** Pitch shift in semitones, clamped by the native processor to +/-24. */
+  semitones?: number;
+  /** Wet/dry mix, clamped by the native processor to 0..1. */
+  mix?: number;
+  /** Grain size in samples. Use 0/omit to derive it from the sample rate. */
+  grainSize?: number;
+}
+
 /** Options for {@link StreamingEqualizer.match}. */
 export interface EqMatchOptions {
   sampleRate?: number;

package/src/sonare.js.d.ts

@@ -1081,6 +1081,9 @@ interface SonareModule {
   // Streaming - StreamingEqualizer
   createEqualizer: (config: Record<string, unknown>) => WasmStreamingEqualizer;
 
+  // Streaming - StreamingRetune
+  createStreamingRetune: (config: Record<string, unknown>) => WasmStreamingRetune;
+
   // Mixing - scene-based Mixer
   createMixerFromSceneJson: (json: string, sampleRate: number, blockSize: number) => WasmMixer;
   mixerPresetJson: (presetName: string) => string;
@@ -1133,6 +1136,16 @@ interface WasmStreamingEqualizer {
   delete: () => void;
 }
 
+interface WasmStreamingRetune {
+  prepare: (sampleRate: number, maxBlockSize: number) => void;
+  reset: () => void;
+  setConfig: (config: Record<string, unknown>) => void;
+  config: () => { semitones: number; mix: number; grainSize: number };
+  grainSize: () => number;
+  processMono: (samples: Float32Array) => Float32Array;
+  delete: () => void;
+}
+
 interface WasmMixer {
   compile: () => void;
   processStereo: (

package/src/wasm_types.ts

@@ -426,6 +426,16 @@ export interface WasmStreamingEqualizer {
   delete: () => void;
 }
 
+export interface WasmStreamingRetune {
+  prepare: (sampleRate: number, maxBlockSize: number) => void;
+  reset: () => void;
+  setConfig: (config: Record<string, unknown>) => void;
+  config: () => { semitones: number; mix: number; grainSize: number };
+  grainSize: () => number;
+  processMono: (samples: Float32Array) => Float32Array;
+  delete: () => void;
+}
+
 export interface WasmEngineClip {
   id?: number;
   channels: Float32Array[];
@@ -1243,6 +1253,7 @@ export interface SonareModule {
 
   createStreamingMasteringChain: (config: Record<string, unknown>) => WasmStreamingMasteringChain;
   createEqualizer: (config: Record<string, unknown>) => WasmStreamingEqualizer;
+  createStreamingRetune: (config: Record<string, unknown>) => WasmStreamingRetune;
   createMixerFromSceneJson: (json: string, sampleRate: number, blockSize: number) => WasmMixer;
   mixerPresetJson: (presetName: string) => string;
 }