@libraz/libsonare 1.5.3 → 1.5.4

package/dist/index.d.ts

@@ -1176,12 +1176,12 @@ interface PercussiveRequest extends ValidateOptions {
 }
 interface TimeStretchRequest extends ValidateOptions {
     samples: Float32Array;
-    sampleRate: number;
+    sampleRate?: number;
     rate: number;
 }
 interface PitchShiftRequest extends ValidateOptions {
     samples: Float32Array;
-    sampleRate: number;
+    sampleRate?: number;
     semitones: number;
 }
 interface PitchCorrectToMidiRequest extends ValidateOptions {
@@ -1215,7 +1215,7 @@ interface NoteMoveRequest extends NoteMoveOptions, ValidateOptions {
 }
 interface NormalizeRequest extends ValidateOptions {
     samples: Float32Array;
-    sampleRate: number;
+    sampleRate?: number;
     targetDb?: number;
 }
 interface SpectralEditRequest extends SpectralEditOptions, ValidateOptions {
@@ -1256,7 +1256,7 @@ declare function percussive(samples: Float32Array, sampleRate?: number, options?
  * Time-stretch audio without changing pitch.
  *
  * @param samples - Audio samples (mono, float32)
- * @param sampleRate - Sample rate in Hz
+ * @param sampleRate - Sample rate in Hz (default: 22050)
  * @param rate - Time stretch rate (0.5 = double duration, 2.0 = half duration)
  * @returns Time-stretched audio
  */
@@ -1266,7 +1266,7 @@ declare function timeStretch(samples: Float32Array, sampleRate: number, rate: nu
  * Pitch-shift audio without changing duration.
  *
  * @param samples - Audio samples (mono, float32)
- * @param sampleRate - Sample rate in Hz
+ * @param sampleRate - Sample rate in Hz (default: 22050)
  * @param semitones - Pitch shift in semitones (+12 = one octave up, -12 = one octave down)
  * @returns Pitch-shifted audio
  */
@@ -1340,7 +1340,7 @@ declare function noteMove(samples: Float32Array, sampleRate?: number, options?:
  * Normalize audio to target peak level.
  *
  * @param samples - Audio samples (mono, float32)
- * @param sampleRate - Sample rate in Hz
+ * @param sampleRate - Sample rate in Hz (default: 22050)
  * @param targetDb - Target peak level in dB (default: 0 dB = full scale)
  * @returns Normalized audio
  */
@@ -2645,6 +2645,10 @@ declare class Project {
     undo(): void;
     /** Redo the most recently undone edit. */
     redo(): void;
+    /** Clear the undo/redo history without changing the current project state. */
+    clearHistory(): void;
+    /** Cap the undo history depth (clamped to >= 1); evicts oldest entries beyond the cap. */
+    setMaxUndoDepth(depth: number): void;
     /** Replace a MIDI clip's entire event list. */
     setMidiEvents(clipId: number, events: ReadonlyArray<ProjectMidiEvent | readonly [number, number, number]>): void;
     /** Import an in-memory SMF buffer; returns the first added clip id. */
@@ -5079,8 +5083,10 @@ interface WaveformPeaksReport {
 declare function meteringStereoCorrelation(request: MeteringStereoRequest): number;
 declare function meteringStereoCorrelation(left: Float32Array, right: Float32Array, sampleRate?: number, options?: ValidateOptions): number;
 /**
- * Side / mid energy ratio, clamped to `[0, 2]`: 0 = pure mono, ~1 = wide
- * stereo, 2 = fully decorrelated / out-of-phase.
+ * Side / mid energy ratio in `[0, +Infinity)`: 0 = pure mono, ~1 = wide stereo,
+ * larger = increasingly decorrelated / out-of-phase. The value is unbounded and
+ * returns `Infinity` when the mid channel is silent (a mono-collapsed / fully
+ * out-of-phase signal).
  */
 declare function meteringStereoWidth(request: MeteringStereoRequest): number;
 declare function meteringStereoWidth(left: Float32Array, right: Float32Array, sampleRate?: number, options?: ValidateOptions): number;
@@ -6022,7 +6028,7 @@ declare class RealtimeVoiceChanger {
     constructor(config?: RealtimeVoiceChangerConfigInput);
     prepare(sampleRate: number, maxBlockSize?: number, channels?: number): void;
     reset(): void;
-    setConfig(config: RealtimeVoiceChangerConfigInput): void;
+    setConfig(config: RealtimeVoiceChangerConfigInput | RealtimeVoiceChangerPodConfig): void;
     configJson(): string;
     latencySamples(): number;
     processMono(samples: Float32Array): Float32Array;

package/dist/index.js

@@ -244,12 +244,16 @@ function percussive(samples, sampleRate = 22050, options = {}) {
 function timeStretch(samples, sampleRate, rate, options = {}) {
   const request = samples instanceof Float32Array ? { samples, sampleRate, rate, ...options } : samples;
   assertSamples("timeStretch", request.samples, request.validate !== false);
-  return requireModule().timeStretch(request.samples, request.sampleRate, request.rate);
+  return requireModule().timeStretch(request.samples, request.sampleRate ?? 22050, request.rate);
 }
 function pitchShift(samples, sampleRate, semitones, options = {}) {
   const request = samples instanceof Float32Array ? { samples, sampleRate, semitones, ...options } : samples;
   assertSamples("pitchShift", request.samples, request.validate !== false);
-  return requireModule().pitchShift(request.samples, request.sampleRate, request.semitones);
+  return requireModule().pitchShift(
+    request.samples,
+    request.sampleRate ?? 22050,
+    request.semitones
+  );
 }
 function pitchCorrectToMidi(samples, sampleRate = 22050, currentMidi = 69, targetMidi = 69, options = {}) {
   const request = samples instanceof Float32Array ? { samples, sampleRate, currentMidi, targetMidi, ...options } : samples;
@@ -336,7 +340,11 @@ function noteMove(samples, sampleRate = 22050, options = {}) {
 function normalize(samples, sampleRate, targetDb = 0, options = {}) {
   const request = samples instanceof Float32Array ? { samples, sampleRate, targetDb, ...options } : samples;
   assertSamples("normalize", request.samples, request.validate !== false);
-  return requireModule().normalize(request.samples, request.sampleRate, request.targetDb ?? 0);
+  return requireModule().normalize(
+    request.samples,
+    request.sampleRate ?? 22050,
+    request.targetDb ?? 0
+  );
 }
 function spectralEdit(samples, sampleRate, ops = [], options = {}) {
   const request = samples instanceof Float32Array ? { samples, sampleRate, ops, ...options } : samples;
@@ -1257,7 +1265,11 @@ function analyzeMelody(samples, sampleRate = 22050, options = {}) {
   const fmax = options.fmax ?? 2093;
   validateFrequencyBounds("analyzeMelody", fmin, fmax);
   if (fmin <= 0) {
-    throw new RangeError("analyzeMelody: fmin must be positive");
+    throw new SonareError(
+      4 /* InvalidParameter */,
+      "InvalidParameter",
+      "analyzeMelody: fmin must be positive"
+    );
   }
   validatePositiveIntegers("analyzeMelody", {
     frameLength: options.frameLength ?? 2048,
@@ -1266,7 +1278,11 @@ function analyzeMelody(samples, sampleRate = 22050, options = {}) {
   const threshold = options.threshold ?? 0.1;
   assertFiniteScalar("analyzeMelody", threshold, "threshold");
   if (threshold <= 0) {
-    throw new RangeError("analyzeMelody: threshold must be positive");
+    throw new SonareError(
+      4 /* InvalidParameter */,
+      "InvalidParameter",
+      "analyzeMelody: threshold must be positive"
+    );
   }
   return requireModule9().analyzeMelody(
     samples,
@@ -3555,6 +3571,17 @@ var Project = class _Project {
   redo() {
     this.native.redo();
   }
+  /** Clear the undo/redo history without changing the current project state. */
+  clearHistory() {
+    this.native.clearHistory();
+  }
+  /** Cap the undo history depth (clamped to >= 1); evicts oldest entries beyond the cap. */
+  setMaxUndoDepth(depth) {
+    if (!Number.isInteger(depth) || depth < 1) {
+      throw new RangeError("Project.setMaxUndoDepth: depth must be an integer >= 1");
+    }
+    this.native.setMaxUndoDepth(depth);
+  }
   /** Replace a MIDI clip's entire event list. */
   setMidiEvents(clipId, events) {
     assertProjectMidiEvents("Project.setMidiEvents", events);
@@ -4021,6 +4048,8 @@ function panLawCode(panLaw) {
     return panLaw;
   }
   switch (panLaw) {
+    case "const3dB":
+      return 0;
     case "const4.5dB":
       return 1;
     case "const6dB":
@@ -4028,7 +4057,7 @@ function panLawCode(panLaw) {
     case "linear0dB":
       return 3;
     default:
-      return 0;
+      throw new Error(`Invalid pan law: ${panLaw}`);
   }
 }
 function panModeCode(panMode) {
@@ -4036,6 +4065,8 @@ function panModeCode(panMode) {
     return panMode;
   }
   switch (panMode) {
+    case "balance":
+      return 0;
     case "stereoPan":
     case "stereo-pan":
       return 1;
@@ -4043,17 +4074,34 @@ function panModeCode(panMode) {
     case "dual-pan":
       return 2;
     default:
-      return 0;
+      throw new Error(`Invalid pan mode: ${panMode}`);
   }
 }
 function meterTapCode(tap) {
-  return tap === "preFader" || tap === 0 ? 0 : 1;
+  if (typeof tap === "number") {
+    return tap;
+  }
+  switch (tap) {
+    case "preFader":
+      return 0;
+    case "postFader":
+      return 1;
+    default:
+      throw new Error(`Invalid meter tap: ${tap}`);
+  }
 }
 function sendTimingCode(timing) {
   if (typeof timing === "number") {
     return timing;
   }
-  return timing === "preFader" ? 1 : 0;
+  switch (timing) {
+    case "postFader":
+      return 0;
+    case "preFader":
+      return 1;
+    default:
+      throw new Error(`Invalid send timing: ${timing}`);
+  }
 }
 
 // src/realtime_engine.ts
@@ -5330,6 +5378,61 @@ var Mixer = class _Mixer {
 };
 
 // src/realtime_voice_changer.ts
+function isFlatVoiceChangerPod(config) {
+  return typeof config === "object" && config !== null && "retuneSemitones" in config;
+}
+function flatVoiceChangerPodToNested(pod) {
+  return {
+    inputGainDb: pod.inputGainDb,
+    outputGainDb: pod.outputGainDb,
+    wetMix: pod.wetMix,
+    retune: { semitones: pod.retuneSemitones, mix: pod.retuneMix, grainSize: pod.retuneGrainSize },
+    formant: {
+      factor: pod.formantFactor,
+      amount: pod.formantAmount,
+      body: pod.formantBody,
+      brightness: pod.formantBrightness,
+      nasal: pod.formantNasal
+    },
+    eq: {
+      highpassHz: pod.eqHighpassHz,
+      bodyDb: pod.eqBodyDb,
+      presenceDb: pod.eqPresenceDb,
+      airDb: pod.eqAirDb
+    },
+    gate: {
+      thresholdDb: pod.gateThresholdDb,
+      attackMs: pod.gateAttackMs,
+      releaseMs: pod.gateReleaseMs,
+      rangeDb: pod.gateRangeDb
+    },
+    compressor: {
+      thresholdDb: pod.compressorThresholdDb,
+      ratio: pod.compressorRatio,
+      attackMs: pod.compressorAttackMs,
+      releaseMs: pod.compressorReleaseMs,
+      makeupGainDb: pod.compressorMakeupGainDb
+    },
+    deesser: {
+      frequencyHz: pod.deesserFrequencyHz,
+      thresholdDb: pod.deesserThresholdDb,
+      ratio: pod.deesserRatio,
+      rangeDb: pod.deesserRangeDb
+    },
+    reverb: {
+      mix: pod.reverbMix,
+      timeMs: pod.reverbTimeMs,
+      damping: pod.reverbDamping,
+      seed: pod.reverbSeed
+    },
+    limiter: {
+      ceilingDb: pod.limiterCeilingDb,
+      releaseMs: pod.limiterReleaseMs,
+      enableIspLimiter: pod.limiterEnableIspLimiter,
+      ispCeilingDbtp: pod.limiterIspCeilingDbtp
+    }
+  };
+}
 var RealtimeVoiceChanger = class {
   constructor(config = "neutral-monitor") {
     const module2 = getSonareModule();
@@ -5342,7 +5445,8 @@ var RealtimeVoiceChanger = class {
     this.changer.reset();
   }
   setConfig(config) {
-    this.changer.setConfig(config);
+    const resolved = isFlatVoiceChangerPod(config) ? flatVoiceChangerPodToNested(config) : config;
+    this.changer.setConfig(resolved);
   }
   configJson() {
     return this.changer.configJson();