@libraz/libsonare 1.2.0 → 1.2.2

package/src/public_types.ts

@@ -845,6 +845,77 @@ 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;
+}
+
+export type VoicePresetId =
+  | 'neutral-monitor'
+  | 'bright-idol'
+  | 'soft-whisper'
+  | 'deep-narrator'
+  | 'robot-mascot'
+  | 'dark-villain';
+
+export interface RealtimeVoiceChangerPreset {
+  schemaVersion: 1;
+  id?: string;
+  name?: string;
+  description?: string;
+  macros?: Record<string, number>;
+  dsp?: Record<string, unknown>;
+}
+
+export type RealtimeVoiceChangerConfigInput = VoicePresetId | RealtimeVoiceChangerPreset;
+
+/**
+ * Flat (POD) realtime voice-changer configuration. Field names mirror the
+ * C ABI `SonareRealtimeVoiceChangerConfig` / Python POD exactly (snake_case),
+ * so a config can be round-tripped across bindings without renaming.
+ */
+export interface RealtimeVoiceChangerPodConfig {
+  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;
+}
+
 /** Options for {@link StreamingEqualizer.match}. */
 export interface EqMatchOptions {
   sampleRate?: number;