@libraz/libsonare 1.2.1 → 1.2.3

package/src/public_types.ts

@@ -421,6 +421,69 @@ export interface AcousticResult {
   isBlind: boolean;
 }
 
+/** Shoebox geometry + placement shared by RIR synthesis and the room morph. */
+export interface RoomGeometryOptions {
+  lengthM?: number;
+  widthM?: number;
+  heightM?: number;
+  absorption?: number;
+  sourceX?: number;
+  sourceY?: number;
+  sourceZ?: number;
+  listenerX?: number;
+  listenerY?: number;
+  listenerZ?: number;
+  ismOrder?: number;
+  seed?: number;
+  maxSeconds?: number;
+}
+
+export interface RirSynthOptions extends RoomGeometryOptions {
+  sampleRate?: number;
+  /** Use the Eyring statistical late-tail model (default true); false = Sabine. */
+  preferEyring?: boolean;
+  /** Early/late crossover in ms (0 = auto, ~sqrt(V) ms). */
+  mixingTimeMs?: number;
+  /** Equal-power crossfade width around the mixing time in ms (0 = default). */
+  crossfadeMs?: number;
+}
+
+export interface RirResult {
+  rir: Float32Array;
+  sampleRate: number;
+  hasError: boolean;
+}
+
+export interface RoomEstimateOptions {
+  aspectHintLw?: number;
+  aspectHintLh?: number;
+  referenceAbsorption?: number;
+  preferEyring?: boolean;
+  nOctaveBands?: number;
+  /** Analyzer routing: 0 = auto, 1 = blind, 2 = impulse-response. */
+  mode?: number;
+  /** Analyzer decay-fit span in dB (0 = library default). */
+  minDecayDb?: number;
+  /** Analyzer noise-floor margin in dB (0 = library default). */
+  noiseFloorMarginDb?: number;
+}
+
+export interface RoomEstimateResult {
+  volume: number;
+  length: number;
+  width: number;
+  height: number;
+  drrDb: number;
+  confidence: number;
+  absorptionBands: Float32Array;
+  rt60Bands: Float32Array;
+}
+
+export interface RoomMorphOptions extends RoomGeometryOptions {
+  wet?: number;
+  sourceTailSuppression?: number;
+}
+
 /**
  * HPSS (Harmonic-Percussive Source Separation) result
  */
@@ -855,6 +918,71 @@ export interface StreamingRetuneConfig {
   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;
+  /** Non-zero enables the 4x-oversampled inter-sample-peak limiter (default enabled). */
+  limiter_enable_isp_limiter: boolean;
+  /** True-peak ceiling in dBTP applied by the ISP limiter (default -1.0). */
+  limiter_isp_ceiling_dbtp: number;
+}
+
 /** Options for {@link StreamingEqualizer.match}. */
 export interface EqMatchOptions {
   sampleRate?: number;