@libraz/libsonare 1.5.0 → 1.5.2

package/src/sonare.js.d.ts

@@ -26,45 +26,45 @@ export interface WasmKeyCandidateResult {
   correlation: number;
 }
 
-// Flat POD mirror of SonareRealtimeVoiceChangerConfig. Field names match the
-// C ABI / Python POD exactly (snake_case).
+// Flat POD mirror of SonareRealtimeVoiceChangerConfig. Keys are camelCase to
+// match the Node addon getter (the underlying C ABI / Python POD is snake_case).
 export interface WasmRealtimeVoiceChangerPodConfig {
-  input_gain_db: number;
-  output_gain_db: number;
-  wet_mix: number;
-  retune_semitones: number;
-  retune_mix: number;
-  retune_grain_size: number;
-  formant_factor: number;
-  formant_amount: number;
-  formant_body: number;
-  formant_brightness: number;
-  formant_nasal: number;
-  eq_highpass_hz: number;
-  eq_body_db: number;
-  eq_presence_db: number;
-  eq_air_db: number;
-  gate_threshold_db: number;
-  gate_attack_ms: number;
-  gate_release_ms: number;
-  gate_range_db: number;
-  compressor_threshold_db: number;
-  compressor_ratio: number;
-  compressor_attack_ms: number;
-  compressor_release_ms: number;
-  compressor_makeup_gain_db: number;
-  deesser_frequency_hz: number;
-  deesser_threshold_db: number;
-  deesser_ratio: number;
-  deesser_range_db: number;
-  reverb_mix: number;
-  reverb_time_ms: number;
-  reverb_damping: number;
-  reverb_seed: number;
-  limiter_ceiling_db: number;
-  limiter_release_ms: number;
-  limiter_enable_isp_limiter: boolean;
-  limiter_isp_ceiling_dbtp: number;
+  inputGainDb: number;
+  outputGainDb: number;
+  wetMix: number;
+  retuneSemitones: number;
+  retuneMix: number;
+  retuneGrainSize: number;
+  formantFactor: number;
+  formantAmount: number;
+  formantBody: number;
+  formantBrightness: number;
+  formantNasal: number;
+  eqHighpassHz: number;
+  eqBodyDb: number;
+  eqPresenceDb: number;
+  eqAirDb: number;
+  gateThresholdDb: number;
+  gateAttackMs: number;
+  gateReleaseMs: number;
+  gateRangeDb: number;
+  compressorThresholdDb: number;
+  compressorRatio: number;
+  compressorAttackMs: number;
+  compressorReleaseMs: number;
+  compressorMakeupGainDb: number;
+  deesserFrequencyHz: number;
+  deesserThresholdDb: number;
+  deesserRatio: number;
+  deesserRangeDb: number;
+  reverbMix: number;
+  reverbTimeMs: number;
+  reverbDamping: number;
+  reverbSeed: number;
+  limiterCeilingDb: number;
+  limiterReleaseMs: number;
+  limiterEnableIspLimiter: boolean;
+  limiterIspCeilingDbtp: number;
 }
 
 export interface WasmBeatResult {
@@ -194,6 +194,8 @@ export interface WasmStreamConfigDefaults {
   computeSpectral: boolean;
   emitEveryNFrames: number;
   magnitudeDownsample: number;
+  maxPendingFrames: number;
+  maxProgressionEntries: number;
   keyUpdateIntervalSec: number;
   bpmUpdateIntervalSec: number;
   window: number;
@@ -1156,6 +1158,7 @@ export interface SonareModule {
   detectKeyCandidates: (samples: Float32Array, sampleRate: number) => WasmKeyCandidateResult[];
   hasFfmpegSupport: () => boolean;
   version: () => string;
+  abiVersion: () => number;
   engineAbiVersion: () => number;
   voiceChangerAbiVersion: () => number;
   voiceCharacterPresetId: (preset: number) => string | null;
@@ -1904,6 +1907,27 @@ export interface SonareModule {
     binsPerOctave: number,
     gamma: number,
   ) => WasmCqtResult;
+  cqtToAudio: (
+    magnitude: Float32Array,
+    nBins: number,
+    nFrames: number,
+    sampleRate: number,
+    hopLength: number,
+    fmin: number,
+    binsPerOctave: number,
+    nIter: number,
+  ) => Float32Array;
+  vqtToAudio: (
+    magnitude: Float32Array,
+    nBins: number,
+    nFrames: number,
+    sampleRate: number,
+    hopLength: number,
+    fmin: number,
+    binsPerOctave: number,
+    gamma: number,
+    nIter: number,
+  ) => Float32Array;
   analyzeSections: (
     samples: Float32Array,
     sampleRate: number,
@@ -1948,6 +1972,7 @@ export interface SonareModule {
     winLength: number,
     sampleRate: number,
     hopLength: number,
+    factors?: Float32Array | number[],
   ) => Float32Array;
   lufs: (samples: Float32Array, sampleRate: number) => WasmLufsResult;
   momentaryLufs: (samples: Float32Array, sampleRate: number) => Float32Array;
@@ -2024,6 +2049,8 @@ export interface SonareModule {
     computeSpectral: boolean,
     emitEveryNFrames: number,
     magnitudeDownsample: number,
+    maxPendingFrames: number,
+    maxProgressionEntries: number,
     keyUpdateIntervalSec: number,
     bpmUpdateIntervalSec: number,
     window: number,
@@ -2234,6 +2261,7 @@ export interface WasmMixer {
   vcaGroupCount: () => number;
   toSceneJson: () => string;
   tailSamples: () => number;
+  latencySamples: () => number;
   drainTailStereo: (numSamples: number) => {
     left: Float32Array;
     right: Float32Array;
@@ -2297,6 +2325,10 @@ export interface WasmAnalyzerStats {
   totalFrames: number;
   totalSamples: number;
   durationSeconds: number;
+  pendingFrames: number;
+  droppedOutputFrames: number;
+  droppedChordProgressionEntries: number;
+  droppedBarProgressionEntries: number;
   estimate: WasmProgressiveEstimate;
 }
 

package/src/stream_analyzer.ts

@@ -71,6 +71,8 @@ export class StreamAnalyzer {
       config.computeSpectral ?? defaults.computeSpectral,
       config.emitEveryNFrames ?? defaults.emitEveryNFrames,
       config.magnitudeDownsample ?? defaults.magnitudeDownsample,
+      config.maxPendingFrames ?? defaults.maxPendingFrames,
+      config.maxProgressionEntries ?? defaults.maxProgressionEntries,
       config.keyUpdateIntervalSec ?? defaults.keyUpdateIntervalSec,
       config.bpmUpdateIntervalSec ?? defaults.bpmUpdateIntervalSec,
       config.window ?? defaults.window,
@@ -88,7 +90,8 @@ export class StreamAnalyzer {
   }
 
   /**
-   * Process audio samples with explicit sample offset.
+   * Process audio samples with a contiguous explicit sample offset. A gap,
+   * seek, or switch from `process()` requires `reset()` first.
    *
    * @param samples - Audio samples (mono, float32)
    * @param sampleOffset - Cumulative sample count at start of this chunk
@@ -163,6 +166,10 @@ export class StreamAnalyzer {
       totalFrames: s.totalFrames,
       totalSamples: s.totalSamples,
       durationSeconds: s.durationSeconds,
+      pendingFrames: s.pendingFrames,
+      droppedOutputFrames: s.droppedOutputFrames,
+      droppedChordProgressionEntries: s.droppedChordProgressionEntries,
+      droppedBarProgressionEntries: s.droppedBarProgressionEntries,
       estimate: {
         bpm: s.estimate.bpm,
         bpmConfidence: s.estimate.bpmConfidence,

package/src/stream_types.ts

@@ -64,6 +64,10 @@ export interface AnalyzerStats {
   totalFrames: number;
   totalSamples: number;
   durationSeconds: number;
+  pendingFrames: number;
+  droppedOutputFrames: number;
+  droppedChordProgressionEntries: number;
+  droppedBarProgressionEntries: number;
   estimate: ProgressiveEstimate;
 }
 
@@ -159,6 +163,10 @@ export interface StreamConfig {
   computeSpectral?: boolean;
   emitEveryNFrames?: number;
   magnitudeDownsample?: number;
+  /** Maximum unread frames; overflow drops the oldest frame. */
+  maxPendingFrames?: number;
+  /** Maximum retained chord and bar progression entries; overflow drops oldest. */
+  maxProgressionEntries?: number;
   keyUpdateIntervalSec?: number;
   bpmUpdateIntervalSec?: number;
   window?: number;