@libraz/libsonare 1.2.0 → 1.2.1

package/dist/index.d.ts

@@ -651,6 +651,15 @@ interface StreamingEqualizerConfig {
     sampleRate?: number;
     maxBlockSize?: number;
 }
+/** Configuration for {@link StreamingRetune}. */
+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}. */
 interface EqMatchOptions {
     sampleRate?: number;
@@ -1468,6 +1477,37 @@ declare class StreamingEqualizer {
     /** Release the underlying WASM object. Safe to call only once. */
     delete(): void;
 }
+/**
+ * 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.
+ */
+declare class StreamingRetune {
+    private retune;
+    constructor(config?: StreamingRetuneConfig);
+    /**
+     * Allocate and initialize native state for the given sample rate and maximum
+     * process block size.
+     */
+    prepare(sampleRate: number, maxBlockSize: number): void;
+    /** Reset delay, grain, and overlap-add state without changing config. */
+    reset(): void;
+    /**
+     * Update retune settings. Changing `grainSize` takes effect after the next
+     * {@link prepare} call.
+     */
+    setConfig(config: StreamingRetuneConfig): void;
+    /** Current native config. */
+    config(): Required<StreamingRetuneConfig>;
+    /** Resolved grain size in samples after {@link prepare}. */
+    grainSize(): number;
+    /** Process one mono block, returning the shifted samples (same length). */
+    processMono(samples: Float32Array): Float32Array;
+    /** Release the underlying WASM object. Safe to call only once. */
+    delete(): void;
+}
 /**
  * Get a built-in mixing scene preset serialized as JSON, normalized through the
  * C mixer API (the same path {@link Mixer.fromSceneJson} uses to load it).
@@ -2276,4 +2316,4 @@ declare class StreamAnalyzer {
     dispose(): void;
 }
 
-export { type AcousticResult, type AnalysisResult, type AnalyzerStats, Audio, type AutomationCurve, type BarChord, type Beat, type Chord, type ChordAnalysisResult, type ChordChange, type ChordDetectionOptions, ChordQuality, type ChromaResult, type CqtResult, type Dynamics, EXPECTED_ENGINE_ABI_VERSION, type EngineAutomationPoint, type EngineBounceOptions, type EngineBounceResult, type EngineCapabilities, type EngineCaptureStatus, type EngineClip, type EngineFreezeOptions, type EngineFreezeResult, type EngineGraphSpec, type EngineMarker, type EngineMeterTelemetry, type EngineMetronomeConfig, type EngineParameterInfo, type EngineTelemetry, type EngineTransportState, type EqBand, type EqBandPhase, type EqBandType, type EqCoeffMode, type EqMatchOptions, type EqSpectrumSnapshot, type EqStereoPlacement, type FrameBuffer, type GoniometerPoint, type HpssResult, type Key, type KeyCandidate, type KeyDetectionOptions, KeyProfile, type KeyProfileName, type LufsResult, type MasteringChainConfig, type MasteringChainResult, type MasteringPreset, type MasteringProcessorParams, type MasteringResult, type MasteringStereoChainResult, type MasteringStereoResult, type MelSpectrogramResult, type MelodyPoint, type MelodyResult, type MeterTap, type MfccResult, type MixMeterSnapshot, type MixOptions, type MixResult, Mixer, type MixerProcessResult, type MixerRealtimeBuffer, Mode, type PairAnalysis, type PairProcessor, type PanLaw, type PanMode, type PatternScore, PitchClass as Pitch, PitchClass, type PitchResult, type ProgressCallback, type ProgressiveEstimate, RealtimeEngine, type RhythmFeatures, type Section, SectionType, type SendTiming, type SoloProcessor, type StereoAnalysis, type StftResult, StreamAnalyzer, type StreamConfig, type StreamFramesI16, type StreamFramesU8, StreamingEqualizer, type StreamingEqualizerConfig, StreamingMasteringChain, type StreamingPlatform, type Timbre, type TimeSignature, amplitudeToDb, analyze, analyzeImpulseResponse, analyzeMelody, analyzeSections, analyzeWithProgress, chroma, cqt, cyclicTempogram, dbToAmplitude, dbToPower, deemphasis, detectAcoustic, detectBeats, detectBpm, detectChords, detectDownbeats, detectKey, detectKeyCandidates, detectOnsets, engineAbiVersion, engineCapabilities, fixFrames, fixLength, fourierTempogram, frameSignal, framesToSamples, framesToTime, harmonic, hpss, hzToMel, hzToMidi, hzToNote, init, isInitialized, lufs, masterAudio, masterAudioStereo, mastering, masteringAssistantSuggest, masteringAudioProfile, masteringChain, masteringChainStereo, masteringChainStereoWithProgress, masteringChainWithProgress, masteringPairAnalysisNames, masteringPairAnalyze, masteringPairProcess, masteringPairProcessorNames, masteringPresetNames, masteringProcess, masteringProcessStereo, masteringProcessorNames, masteringStereoAnalysisNames, masteringStereoAnalyze, masteringStreamingPreview, melSpectrogram, melToAudio, melToHz, melToStft, mfcc, mfccToAudio, mfccToMel, midiToHz, mixStereo, mixerScenePresetJson, mixingScenePresetJson, mixingScenePresetNames, momentaryLufs, nnlsChroma, normalize, noteStretch, noteToHz, onsetEnvelope, padCenter, pcen, peakPick, percussive, pitchCorrectToMidi, pitchPyin, pitchShift, pitchYin, plp, powerToDb, preemphasis, resample, rmsEnergy, samplesToFrames, shortTermLufs, spectralBandwidth, spectralCentroid, spectralFlatness, spectralRolloff, splitSilence, stft, stftDb, tempogram, tempogramRatio, timeStretch, timeToFrames, tonnetz, trim, trimSilence, vectorNormalize, version, voiceChange, vqt, zeroCrossingRate };
+export { type AcousticResult, type AnalysisResult, type AnalyzerStats, Audio, type AutomationCurve, type BarChord, type Beat, type Chord, type ChordAnalysisResult, type ChordChange, type ChordDetectionOptions, ChordQuality, type ChromaResult, type CqtResult, type Dynamics, EXPECTED_ENGINE_ABI_VERSION, type EngineAutomationPoint, type EngineBounceOptions, type EngineBounceResult, type EngineCapabilities, type EngineCaptureStatus, type EngineClip, type EngineFreezeOptions, type EngineFreezeResult, type EngineGraphSpec, type EngineMarker, type EngineMeterTelemetry, type EngineMetronomeConfig, type EngineParameterInfo, type EngineTelemetry, type EngineTransportState, type EqBand, type EqBandPhase, type EqBandType, type EqCoeffMode, type EqMatchOptions, type EqSpectrumSnapshot, type EqStereoPlacement, type FrameBuffer, type GoniometerPoint, type HpssResult, type Key, type KeyCandidate, type KeyDetectionOptions, KeyProfile, type KeyProfileName, type LufsResult, type MasteringChainConfig, type MasteringChainResult, type MasteringPreset, type MasteringProcessorParams, type MasteringResult, type MasteringStereoChainResult, type MasteringStereoResult, type MelSpectrogramResult, type MelodyPoint, type MelodyResult, type MeterTap, type MfccResult, type MixMeterSnapshot, type MixOptions, type MixResult, Mixer, type MixerProcessResult, type MixerRealtimeBuffer, Mode, type PairAnalysis, type PairProcessor, type PanLaw, type PanMode, type PatternScore, PitchClass as Pitch, PitchClass, type PitchResult, type ProgressCallback, type ProgressiveEstimate, RealtimeEngine, type RhythmFeatures, type Section, SectionType, type SendTiming, type SoloProcessor, type StereoAnalysis, type StftResult, StreamAnalyzer, type StreamConfig, type StreamFramesI16, type StreamFramesU8, StreamingEqualizer, type StreamingEqualizerConfig, StreamingMasteringChain, type StreamingPlatform, StreamingRetune, type StreamingRetuneConfig, type Timbre, type TimeSignature, amplitudeToDb, analyze, analyzeImpulseResponse, analyzeMelody, analyzeSections, analyzeWithProgress, chroma, cqt, cyclicTempogram, dbToAmplitude, dbToPower, deemphasis, detectAcoustic, detectBeats, detectBpm, detectChords, detectDownbeats, detectKey, detectKeyCandidates, detectOnsets, engineAbiVersion, engineCapabilities, fixFrames, fixLength, fourierTempogram, frameSignal, framesToSamples, framesToTime, harmonic, hpss, hzToMel, hzToMidi, hzToNote, init, isInitialized, lufs, masterAudio, masterAudioStereo, mastering, masteringAssistantSuggest, masteringAudioProfile, masteringChain, masteringChainStereo, masteringChainStereoWithProgress, masteringChainWithProgress, masteringPairAnalysisNames, masteringPairAnalyze, masteringPairProcess, masteringPairProcessorNames, masteringPresetNames, masteringProcess, masteringProcessStereo, masteringProcessorNames, masteringStereoAnalysisNames, masteringStereoAnalyze, masteringStreamingPreview, melSpectrogram, melToAudio, melToHz, melToStft, mfcc, mfccToAudio, mfccToMel, midiToHz, mixStereo, mixerScenePresetJson, mixingScenePresetJson, mixingScenePresetNames, momentaryLufs, nnlsChroma, normalize, noteStretch, noteToHz, onsetEnvelope, padCenter, pcen, peakPick, percussive, pitchCorrectToMidi, pitchPyin, pitchShift, pitchYin, plp, powerToDb, preemphasis, resample, rmsEnergy, samplesToFrames, shortTermLufs, spectralBandwidth, spectralCentroid, spectralFlatness, spectralRolloff, splitSilence, stft, stftDb, tempogram, tempogramRatio, timeStretch, timeToFrames, tonnetz, trim, trimSilence, vectorNormalize, version, voiceChange, vqt, zeroCrossingRate };

package/dist/index.js

@@ -937,6 +937,48 @@ var StreamingEqualizer = class {
     this.eq.delete();
   }
 };
+var StreamingRetune = class {
+  constructor(config = {}) {
+    if (!module) {
+      throw new Error("Module not initialized. Call init() first.");
+    }
+    this.retune = module.createStreamingRetune(config);
+  }
+  /**
+   * Allocate and initialize native state for the given sample rate and maximum
+   * process block size.
+   */
+  prepare(sampleRate, maxBlockSize) {
+    this.retune.prepare(sampleRate, maxBlockSize);
+  }
+  /** Reset delay, grain, and overlap-add state without changing config. */
+  reset() {
+    this.retune.reset();
+  }
+  /**
+   * Update retune settings. Changing `grainSize` takes effect after the next
+   * {@link prepare} call.
+   */
+  setConfig(config) {
+    this.retune.setConfig(config);
+  }
+  /** Current native config. */
+  config() {
+    return this.retune.config();
+  }
+  /** Resolved grain size in samples after {@link prepare}. */
+  grainSize() {
+    return this.retune.grainSize();
+  }
+  /** Process one mono block, returning the shifted samples (same length). */
+  processMono(samples) {
+    return this.retune.processMono(samples);
+  }
+  /** Release the underlying WASM object. Safe to call only once. */
+  delete() {
+    this.retune.delete();
+  }
+};
 function mixerScenePresetJson(preset) {
   if (!module) {
     throw new Error("Module not initialized. Call init() first.");
@@ -2008,6 +2050,7 @@ export {
   StreamAnalyzer,
   StreamingEqualizer,
   StreamingMasteringChain,
+  StreamingRetune,
   amplitudeToDb,
   analyze,
   analyzeImpulseResponse,