@libraz/libsonare 1.5.1 → 1.5.3

package/src/mastering_repair.ts

@@ -17,6 +17,10 @@ export interface DeclickOptions {
   lpcOrder?: number;
   residualRatio?: number;
 }
+export interface MasteringRepairDeclickRequest extends DeclickOptions {
+  samples: Float32Array;
+  sampleRate: number;
+}
 
 /** Algorithms accepted by `masteringRepairDenoiseClassical`. */
 export type DenoiseClassicalMode = 'logMmse' | 'mmseStsa' | 'spectralSubtraction';
@@ -38,23 +42,53 @@ export interface DenoiseClassicalOptions {
   speechPresenceGain?: boolean;
   gainSmoothing?: boolean;
 }
+export interface MasteringRepairDenoiseClassicalRequest extends DenoiseClassicalOptions {
+  samples: Float32Array;
+  sampleRate: number;
+}
 
 /** Offline LPC-based declicker. */
+export function masteringRepairDeclick(request: MasteringRepairDeclickRequest): Float32Array;
 export function masteringRepairDeclick(
   samples: Float32Array,
   sampleRate: number,
+  options?: DeclickOptions,
+): Float32Array;
+export function masteringRepairDeclick(
+  samples: Float32Array | MasteringRepairDeclickRequest,
+  sampleRate?: number,
   options: DeclickOptions = {},
 ): Float32Array {
-  return requireModule().masteringRepairDeclick(samples, sampleRate, options);
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate: sampleRate as number, ...options }
+      : samples;
+  return requireModule().masteringRepairDeclick(request.samples, request.sampleRate, request);
 }
 
 /** Offline STFT-domain classical denoiser (LogMMSE / MMSE-STSA / SpectralSubtraction). */
+export function masteringRepairDenoiseClassical(
+  request: MasteringRepairDenoiseClassicalRequest,
+): Float32Array;
 export function masteringRepairDenoiseClassical(
   samples: Float32Array,
   sampleRate: number,
+  options?: DenoiseClassicalOptions,
+): Float32Array;
+export function masteringRepairDenoiseClassical(
+  samples: Float32Array | MasteringRepairDenoiseClassicalRequest,
+  sampleRate?: number,
   options: DenoiseClassicalOptions = {},
 ): Float32Array {
-  return requireModule().masteringRepairDenoiseClassical(samples, sampleRate, options);
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate: sampleRate as number, ...options }
+      : samples;
+  return requireModule().masteringRepairDenoiseClassical(
+    request.samples,
+    request.sampleRate,
+    request,
+  );
 }
 
 /** Options for `masteringRepairDeclip`. */
@@ -64,6 +98,10 @@ export interface DeclipOptions {
   iterations?: number;
   lpcBlend?: number;
 }
+export interface MasteringRepairDeclipRequest extends DeclipOptions {
+  samples: Float32Array;
+  sampleRate: number;
+}
 
 /** Algorithms accepted by `masteringRepairDecrackle`. */
 export type DecrackleMode = 'median' | 'waveletShrinkage';
@@ -74,6 +112,10 @@ export interface DecrackleOptions {
   mode?: DecrackleMode;
   levels?: number;
 }
+export interface MasteringRepairDecrackleRequest extends DecrackleOptions {
+  samples: Float32Array;
+  sampleRate: number;
+}
 
 /** Options for `masteringRepairDehum`. */
 export interface DehumOptions {
@@ -86,6 +128,10 @@ export interface DehumOptions {
   frameSize?: number;
   pllBandwidth?: number;
 }
+export interface MasteringRepairDehumRequest extends DehumOptions {
+  samples: Float32Array;
+  sampleRate: number;
+}
 
 /** Options for `masteringRepairDereverbClassical`. */
 export interface DereverbClassicalOptions {
@@ -102,6 +148,10 @@ export interface DereverbClassicalOptions {
   wpeTaps?: number;
   wpeStrength?: number;
 }
+export interface MasteringRepairDereverbClassicalRequest extends DereverbClassicalOptions {
+  samples: Float32Array;
+  sampleRate: number;
+}
 
 /** Trimming modes accepted by `masteringRepairTrimSilence`. */
 export type TrimSilenceMode = 'peak' | 'lufsGated';
@@ -114,48 +164,110 @@ export interface TrimSilenceOptions {
   gateLufs?: number;
   windowMs?: number;
 }
+export interface MasteringRepairTrimSilenceRequest extends TrimSilenceOptions {
+  samples: Float32Array;
+  sampleRate: number;
+}
 
 /** Offline LPC-based declipper. */
+export function masteringRepairDeclip(request: MasteringRepairDeclipRequest): Float32Array;
 export function masteringRepairDeclip(
   samples: Float32Array,
   sampleRate: number,
+  options?: DeclipOptions,
+): Float32Array;
+export function masteringRepairDeclip(
+  samples: Float32Array | MasteringRepairDeclipRequest,
+  sampleRate?: number,
   options: DeclipOptions = {},
 ): Float32Array {
-  return requireModule().masteringRepairDeclip(samples, sampleRate, options);
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate: sampleRate as number, ...options }
+      : samples;
+  return requireModule().masteringRepairDeclip(request.samples, request.sampleRate, request);
 }
 
 /** Offline crackle suppressor (median or wavelet-shrinkage). */
+export function masteringRepairDecrackle(request: MasteringRepairDecrackleRequest): Float32Array;
 export function masteringRepairDecrackle(
   samples: Float32Array,
   sampleRate: number,
+  options?: DecrackleOptions,
+): Float32Array;
+export function masteringRepairDecrackle(
+  samples: Float32Array | MasteringRepairDecrackleRequest,
+  sampleRate?: number,
   options: DecrackleOptions = {},
 ): Float32Array {
-  return requireModule().masteringRepairDecrackle(samples, sampleRate, options);
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate: sampleRate as number, ...options }
+      : samples;
+  return requireModule().masteringRepairDecrackle(request.samples, request.sampleRate, request);
 }
 
 /** Offline mains-hum remover. */
+export function masteringRepairDehum(request: MasteringRepairDehumRequest): Float32Array;
 export function masteringRepairDehum(
   samples: Float32Array,
   sampleRate: number,
+  options?: DehumOptions,
+): Float32Array;
+export function masteringRepairDehum(
+  samples: Float32Array | MasteringRepairDehumRequest,
+  sampleRate?: number,
   options: DehumOptions = {},
 ): Float32Array {
-  return requireModule().masteringRepairDehum(samples, sampleRate, options);
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate: sampleRate as number, ...options }
+      : samples;
+  return requireModule().masteringRepairDehum(request.samples, request.sampleRate, request);
 }
 
 /** Offline classical dereverberator (spectral subtraction + optional WPE). */
+export function masteringRepairDereverbClassical(
+  request: MasteringRepairDereverbClassicalRequest,
+): Float32Array;
 export function masteringRepairDereverbClassical(
   samples: Float32Array,
   sampleRate: number,
+  options?: DereverbClassicalOptions,
+): Float32Array;
+export function masteringRepairDereverbClassical(
+  samples: Float32Array | MasteringRepairDereverbClassicalRequest,
+  sampleRate?: number,
   options: DereverbClassicalOptions = {},
 ): Float32Array {
-  return requireModule().masteringRepairDereverbClassical(samples, sampleRate, options);
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate: sampleRate as number, ...options }
+      : samples;
+  return requireModule().masteringRepairDereverbClassical(
+    request.samples,
+    request.sampleRate,
+    request,
+  );
 }
 
 /** Offline silence trimmer (peak threshold or LUFS-gated). */
+export function masteringRepairTrimSilence(
+  request: MasteringRepairTrimSilenceRequest,
+): Float32Array;
 export function masteringRepairTrimSilence(
   samples: Float32Array,
   sampleRate: number,
+  options?: TrimSilenceOptions,
+): Float32Array;
+export function masteringRepairTrimSilence(
+  samples: Float32Array | MasteringRepairTrimSilenceRequest,
+  sampleRate?: number,
   options: TrimSilenceOptions = {},
 ): Float32Array {
-  return requireModule().masteringRepairTrimSilence(samples, sampleRate, options);
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate: sampleRate as number, ...options }
+      : samples;
+  return requireModule().masteringRepairTrimSilence(request.samples, request.sampleRate, request);
 }