@libraz/libsonare 1.5.3 → 1.5.5

package/src/sonare.js.d.ts

@@ -458,6 +458,8 @@ export interface WasmLufsResult {
   integratedLufs: number;
   momentaryLufs: number;
   shortTermLufs: number;
+  maxMomentaryLufs: number;
+  maxShortTermLufs: number;
   loudnessRange: number;
 }
 
@@ -467,6 +469,7 @@ export interface WasmMasteringResult {
   inputLufs: number;
   outputLufs: number;
   appliedGainDb: number;
+  loudnessTargetLimited?: boolean;
   latencySamples?: number;
 }
 
@@ -479,6 +482,7 @@ export interface WasmMasteringChainResult extends WasmMasteringResult {
   stages: string[];
   outputTruePeakDbtp: number;
   outputLra: number;
+  loudnessTargetLimited: boolean;
   stageGainReductions: WasmStageGainReduction[];
 }
 
@@ -492,6 +496,7 @@ export interface WasmMasteringStereoChainResult {
   stages: string[];
   outputTruePeakDbtp: number;
   outputLra: number;
+  loudnessTargetLimited: boolean;
   stageGainReductions: WasmStageGainReduction[];
 }
 
@@ -624,8 +629,9 @@ export interface WasmEngineMetronomeConfig {
   enabled: boolean;
   beatGain?: number;
   accentGain?: number;
+  /** Explicit click length in samples (0..384000). The engine caps it to one second at its sample rate. */
   clickSamples?: number;
-  /** Optional click length in seconds; > 0 overrides the engine 2 ms default. */
+  /** Optional click length in seconds (0..1); > 0 overrides the engine 2 ms default. */
   clickSeconds?: number;
 }
 
@@ -745,6 +751,10 @@ export interface WasmEngineTransportState {
   barCount: number;
   /** Time signature in effect at the current PPQ. */
   timeSignature: { numerator: number; denominator: number; confidence: number };
+  /** One-based beat within the current bar (`barCount` is zero-based). */
+  beat: number;
+  /** Fractional position within the current beat, in [0, 1). */
+  beatFraction: number;
 }
 
 export interface WasmEngineBounceOptions {
@@ -939,6 +949,7 @@ export interface WasmRealtimeEngine {
     minValue: number,
     maxValue: number,
   ) => void;
+  bindMidiCcBinding: (binding: import('./project_types').ProjectMidiCcBinding) => void;
   clearMidiCcBindings: () => void;
   midiCcBindingCount: () => number;
   setMidiFx: (destinationId: number, configJson: string) => void;
@@ -1096,7 +1107,7 @@ export interface SonareModule {
     detectInversions: boolean,
     chromaMethod: number,
   ) => string[];
-  analyze: (samples: Float32Array, sampleRate: number) => WasmAnalysisResult;
+  analyze: (samples: Float32Array, sampleRate: number, options: object) => WasmAnalysisResult;
   _synthEnumTables: () => WasmSynthEnumTables;
   _synthPatchRoundTrip: (patch: unknown) => unknown;
   _analysisResultSchemaPaths: () => string[];
@@ -1178,6 +1189,13 @@ export interface SonareModule {
 
   meteringPeakDb: (samples: Float32Array, sampleRate: number) => number;
   meteringRmsDb: (samples: Float32Array, sampleRate: number) => number;
+  meteringSilenceRatio: (
+    samples: Float32Array,
+    sampleRate: number,
+    thresholdDb: number,
+    frameLength: number,
+    hopLength: number,
+  ) => number;
   meteringCrestFactorDb: (samples: Float32Array, sampleRate: number) => number;
   meteringDcOffset: (samples: Float32Array, sampleRate: number) => number;
   meteringTruePeakDb: (
@@ -1691,6 +1709,7 @@ export interface SonareModule {
     nMfcc: number,
     nFrames: number,
     nMels: number,
+    lifter: number,
   ) => WasmMelPowerResult;
   mfccToAudio: (
     mfcc: Float32Array,
@@ -1704,6 +1723,7 @@ export interface SonareModule {
     fmax: number,
     nIter: number,
     htk: boolean,
+    lifter: number,
   ) => Float32Array;
 
   // Features - Chroma
@@ -1885,12 +1905,14 @@ export interface SonareModule {
     sampleRate: number,
     hopLength: number,
     nChroma: number,
+    binsPerOctave: number,
   ) => WasmChromaResult;
   chromaCqt: (
     samples: Float32Array,
     sampleRate: number,
     hopLength: number,
     nChroma: number,
+    binsPerOctave: number,
   ) => WasmChromaResult;
   bassChroma: (
     samples: Float32Array,
@@ -1898,7 +1920,13 @@ export interface SonareModule {
     hopLength: number,
     nChroma: number,
   ) => WasmChromaResult;
-  nnlsChroma: (samples: Float32Array, sampleRate: number) => WasmNnlsChromaResult;
+  nnlsChroma: (
+    samples: Float32Array,
+    sampleRate: number,
+    enableStftBlend: boolean,
+    stftBlendWeight: number,
+    stftBlendNFft: number,
+  ) => WasmNnlsChromaResult;
   cqt: (
     samples: Float32Array,
     sampleRate: number,
@@ -2251,6 +2279,7 @@ export interface WasmMixer {
   removeSend: (stripIndex: number, sendIndex: number) => void;
   meterTap: (stripIndex: number, tap: number) => WasmMixMeterSnapshot;
   stripMeter: (stripIndex: number) => WasmMixMeterSnapshot;
+  busMeter: (busId: string) => WasmMixMeterSnapshot;
   scheduleFaderAutomation: (
     stripIndex: number,
     samplePos: number,
@@ -2282,6 +2311,7 @@ export interface WasmMixer {
   busCount: () => number;
   addVcaGroup: (id: string, gainDb: number, members: string[]) => void;
   setVcaGroupGainDb: (id: string, gainDb: number) => void;
+  setVcaGroupMembers: (id: string, members: string[]) => void;
   removeVcaGroup: (id: string) => void;
   vcaGroupCount: () => number;
   toSceneJson: () => string;

package/src/streaming_processors.ts

@@ -1,3 +1,4 @@
+import { flattenChainConfig } from './_chain_config';
 import { getSonareModule } from './module_state';
 import type {
   EqBand,
@@ -64,7 +65,12 @@ export class StreamingMasteringChain {
 
   constructor(config: StreamingMasteringChainConfig) {
     const module = getSonareModule();
-    this.chain = module.createStreamingMasteringChain(config as Record<string, unknown>);
+    const { loudnessStaticGainDb, loudnessStaticGainPeakDb, ...chainConfig } = config;
+    this.chain = module.createStreamingMasteringChain({
+      __flatParams: flattenChainConfig(chainConfig),
+      loudnessStaticGainDb,
+      loudnessStaticGainPeakDb,
+    });
   }
 
   /**

package/src/validation.ts

@@ -78,6 +78,12 @@ export function assertSampleRate(fnName: string, sampleRate: number): void {
   }
 }
 
+/** Validate and retain the public Audio.fromBuffer construction contract. */
+export function validateAudioBuffer(samples: Float32Array, sampleRate: number): void {
+  assertSamples('Audio.fromBuffer', samples, true);
+  assertSampleRate('Audio.fromBuffer', sampleRate);
+}
+
 export function assertNonNegativeInteger(fnName: string, value: number, argName: string): void {
   if (!Number.isInteger(value) || value < 0) {
     throw new RangeError(`${fnName}: ${argName} must be a non-negative integer`);

package/src/worklet/messages.ts

@@ -191,15 +191,29 @@ export interface ResolvedMetronomeConfig {
 export const DEFAULT_METRONOME_CONFIG: ResolvedMetronomeConfig = {
   beatGain: 0.35,
   accentGain: 0.7,
-  clickSamples: 96,
+  clickSamples: 0,
 };
 
 export function resolveMetronomeConfig(config: EngineMetronomeConfig): ResolvedMetronomeConfig {
-  return {
+  const resolved = {
     beatGain: config.beatGain ?? DEFAULT_METRONOME_CONFIG.beatGain,
     accentGain: config.accentGain ?? DEFAULT_METRONOME_CONFIG.accentGain,
     clickSamples: config.clickSamples ?? DEFAULT_METRONOME_CONFIG.clickSamples,
   };
+  if (
+    !Number.isFinite(resolved.beatGain) ||
+    resolved.beatGain < 0 ||
+    !Number.isFinite(resolved.accentGain) ||
+    resolved.accentGain < 0 ||
+    !Number.isInteger(resolved.clickSamples) ||
+    resolved.clickSamples < 0 ||
+    resolved.clickSamples > 384000 ||
+    (config.clickSeconds !== undefined &&
+      (!Number.isFinite(config.clickSeconds) || config.clickSeconds < 0 || config.clickSeconds > 1))
+  ) {
+    throw new RangeError('invalid metronome gains or click length');
+  }
+  return resolved;
 }
 
 // Out-of-band control messages posted from the main-thread SonareEngine facade

package/src/worklet/protocol.ts

@@ -122,6 +122,8 @@ export enum SonareEngineTelemetryError {
   CommandBacklogDeferred = 14,
   ClipPageUnderrun = 15,
   InsertAutomationOverflow = 16,
+  MidiClockOverflow = 17,
+  MetronomeOverflow = 18,
 }
 
 export interface SonareMeterRingBuffer {