@libraz/libsonare 1.5.2 → 1.5.4

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@libraz/libsonare",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "type": "module",
   "packageManager": "yarn@4.15.0",
-  "description": "Audio analysis library for music information retrieval",
+  "description": "Audio analysis, mastering, mixing, and MIDI synthesis in WebAssembly",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -35,6 +35,7 @@
     "format": "biome format --write src/ tests/",
     "test": "vitest run",
     "test:browser": "node scripts/audio-worklet-smoke.mjs",
+    "test:browser:audit": "node scripts/audit-boundary-smoke.mjs",
     "test:watch": "vitest",
     "prepublishOnly": "yarn clean && cp ../../LICENSE LICENSE && yarn build && yarn lint && yarn test"
   },
@@ -46,6 +47,17 @@
     "bpm",
     "key",
     "tempo",
+    "chords",
+    "audio-processing",
+    "dsp",
+    "mastering",
+    "mixing",
+    "loudness",
+    "lufs",
+    "midi",
+    "synthesizer",
+    "soundfont",
+    "room-acoustics",
     "wasm",
     "webassembly"
   ],
@@ -58,7 +70,7 @@
   "bugs": {
     "url": "https://github.com/libraz/libsonare/issues"
   },
-  "homepage": "https://github.com/libraz/libsonare#readme",
+  "homepage": "https://libsonare.libraz.net",
   "engines": {
     "node": ">=18.0.0"
   },

package/src/_chain_config.ts

@@ -0,0 +1,46 @@
+import type { MasteringChainConfig } from './public_types';
+
+type ChainSection = { [key: string]: number | boolean | ChainSection | undefined };
+
+/**
+ * Flattens a nested {@link MasteringChainConfig} into the dot-notation
+ * `{ "module.processor.param": value }` map the WASM core consumes. Internal
+ * helper shared by the mastering-chain / master-audio entry points; mirrors the
+ * Node facade so a nested config produces identical overrides on both surfaces.
+ */
+export function flattenChainConfig(config: MasteringChainConfig): Record<string, number | boolean> {
+  const out: Record<string, number | boolean> = {};
+  const walk = (node: ChainSection, prefix: string): void => {
+    for (const [key, value] of Object.entries(node)) {
+      const path = prefix ? `${prefix}.${key}` : key;
+      if (typeof value === 'number' || typeof value === 'boolean') {
+        out[path] = value;
+      } else if (value !== null && typeof value === 'object') {
+        walk(value, path);
+      }
+    }
+  };
+  walk(config as ChainSection, '');
+
+  // Compatibility aliases for the original WASM-only shorthand. Normalize at
+  // this boundary so every native entry point receives the core parser's one
+  // canonical vocabulary; public types can migrate to the nested spelling
+  // without preserving a second C++ parser indefinitely.
+  const aliases: Record<string, string> = {
+    'repair.denoise': 'repair.denoise.enabled',
+    'repair.nFft': 'repair.denoise.nFft',
+    'repair.hopLength': 'repair.denoise.hopLength',
+    'repair.ddAlpha': 'repair.denoise.ddAlpha',
+    'repair.gainFloor': 'repair.denoise.gainFloor',
+    'eq.tiltDb': 'eq.tilt.tiltDb',
+    'eq.pivotHz': 'eq.tilt.pivotHz',
+  };
+  for (const [legacy, canonical] of Object.entries(aliases)) {
+    const value = out[legacy];
+    if (value !== undefined) {
+      out[canonical] = value;
+      delete out[legacy];
+    }
+  }
+  return out;
+}

package/src/audio.ts

@@ -7,6 +7,7 @@ import {
   masteringChain,
   masteringProcess,
   normalize,
+  noteMove,
   noteStretch,
   percussive,
   pitchCorrectToMidi,
@@ -332,6 +333,10 @@ export class Audio {
     return noteStretch(this._samples, this._sampleRate, options);
   }
 
+  noteMove(options: import('./public_types.js').NoteMoveOptions = {}): Float32Array {
+    return noteMove(this._samples, this._sampleRate, options);
+  }
+
   voiceChange(options: VoiceChangeOptions = {}): Float32Array {
     return voiceChange(this._samples, this._sampleRate, options);
   }
@@ -344,15 +349,30 @@ export class Audio {
     return mastering(this._samples, this._sampleRate, options);
   }
 
-  masteringChain(config: MasteringChainConfig): MasteringChainResult {
-    return masteringChain(this._samples, this._sampleRate, config);
+  masteringChain(
+    config: MasteringChainConfig = {},
+    onProgress?: ProgressCallback,
+  ): MasteringChainResult {
+    return masteringChain({
+      samples: this._samples,
+      sampleRate: this._sampleRate,
+      config,
+      onProgress,
+    });
   }
 
   masterAudio(
     presetName: MasteringPreset = 'pop',
-    overrides: Record<string, number | boolean> | null = null,
+    overrides: MasteringChainConfig | null = null,
+    onProgress?: ProgressCallback,
   ): MasteringChainResult {
-    return masterAudio(this._samples, this._sampleRate, presetName, overrides ?? {});
+    return masterAudio({
+      samples: this._samples,
+      sampleRate: this._sampleRate,
+      preset: presetName,
+      overrides: overrides ?? {},
+      onProgress,
+    });
   }
 
   masteringProcess(

package/src/codes.ts

@@ -20,6 +20,8 @@ export function panLawCode(panLaw: PanLaw | number): number {
     return panLaw;
   }
   switch (panLaw) {
+    case 'const3dB':
+      return 0;
     case 'const4.5dB':
       return 1;
     case 'const6dB':
@@ -27,7 +29,7 @@ export function panLawCode(panLaw: PanLaw | number): number {
     case 'linear0dB':
       return 3;
     default:
-      return 0;
+      throw new Error(`Invalid pan law: ${panLaw}`);
   }
 }
 
@@ -36,6 +38,8 @@ export function panModeCode(panMode: PanMode | number): number {
     return panMode;
   }
   switch (panMode) {
+    case 'balance':
+      return 0;
     case 'stereoPan':
     case 'stereo-pan':
       return 1;
@@ -43,19 +47,38 @@ export function panModeCode(panMode: PanMode | number): number {
     case 'dual-pan':
       return 2;
     default:
-      return 0;
+      throw new Error(`Invalid pan mode: ${panMode}`);
   }
 }
 
 export function meterTapCode(tap: MeterTap | number): number {
-  return tap === 'preFader' || tap === 0 ? 0 : 1;
+  if (typeof tap === 'number') {
+    return tap;
+  }
+  switch (tap) {
+    case 'preFader':
+      return 0;
+    case 'postFader':
+      return 1;
+    default:
+      throw new Error(`Invalid meter tap: ${tap}`);
+  }
 }
 
 export function sendTimingCode(timing: SendTiming | number): number {
   // Mirrors SonareSendTiming: post-fader is 0 (so an omitted/zeroed value is
   // post-fader), pre-fader is 1. A raw number is passed through as the C ABI int.
+  // An unknown string is rejected rather than silently routed to post-fader,
+  // matching the sibling enum-code helpers and Node's sendTimingValue.
   if (typeof timing === 'number') {
     return timing;
   }
-  return timing === 'preFader' ? 1 : 0;
+  switch (timing) {
+    case 'postFader':
+      return 0;
+    case 'preFader':
+      return 1;
+    default:
+      throw new Error(`Invalid send timing: ${timing}`);
+  }
 }

package/src/effects_mastering.ts

@@ -2,6 +2,7 @@ export {
   harmonic,
   hpss,
   normalize,
+  noteMove,
   noteStretch,
   percussive,
   pitchCorrectTimevarying,
@@ -11,7 +12,12 @@ export {
   spectralEdit,
   timeStretch,
 } from './effects_transform';
-export type { VoiceChangeOptions, VoiceChangeRealtimeOptions } from './effects_voice_change';
+export type {
+  VoiceChangeOptions,
+  VoiceChangeRealtimeOptions,
+  VoiceChangeRealtimeRequest,
+  VoiceChangeRequest,
+} from './effects_voice_change';
 export { voiceChange, voiceChangeRealtime } from './effects_voice_change';
 export {
   masterAudio,
@@ -27,7 +33,14 @@ export {
 export type {
   MasteringChannelPolicy,
   MasteringInsertParamInfo,
+  MasteringPairAnalyzeRequest,
+  MasteringPairProcessRequest,
   MasteringProcessorCatalogEntry,
+  MasteringProcessRequest,
+  MasteringProcessStereoRequest,
+  MasteringSamplesParamsRequest,
+  MasteringStereoAnalyzeRequest,
+  MasteringStreamingPreviewRequest,
 } from './mastering_core';
 export {
   mastering,
@@ -53,6 +66,9 @@ export type {
   CompressorOptions,
   DynamicsResult,
   GateOptions,
+  MasteringDynamicsCompressorRequest,
+  MasteringDynamicsGateRequest,
+  MasteringDynamicsTransientShaperRequest,
   TransientShaperOptions,
 } from './mastering_dynamics';
 export {
@@ -70,6 +86,13 @@ export type {
   DenoiseClassicalNoiseEstimator,
   DenoiseClassicalOptions,
   DereverbClassicalOptions,
+  MasteringRepairDeclickRequest,
+  MasteringRepairDeclipRequest,
+  MasteringRepairDecrackleRequest,
+  MasteringRepairDehumRequest,
+  MasteringRepairDenoiseClassicalRequest,
+  MasteringRepairDereverbClassicalRequest,
+  MasteringRepairTrimSilenceRequest,
   TrimSilenceMode,
   TrimSilenceOptions,
 } from './mastering_repair';
@@ -82,4 +105,5 @@ export {
   masteringRepairDereverbClassical,
   masteringRepairTrimSilence,
 } from './mastering_repair';
+export type { MixStereoRequest } from './mixing_oneshot';
 export { mixingScenePresetJson, mixingScenePresetNames, mixStereo } from './mixing_oneshot';