@libraz/libsonare 1.7.0 → 1.7.2

package/dist/index.js

@@ -227,6 +227,13 @@ function assertInterleavedSamples(fnName, samples, channels, validate) {
 function requireModule() {
   return getSonareModule();
 }
+function toVoicedFloat32(voiced) {
+  const out = new Float32Array(voiced.length);
+  for (let index = 0; index < voiced.length; index += 1) {
+    out[index] = voiced[index] ? 1 : 0;
+  }
+  return out;
+}
 function resolveEffectFftOptions(fnName, nFft, hopLength) {
   const resolvedNFft = nFft === void 0 ? 2048 : nFft;
   const resolvedHopLength = hopLength === void 0 ? 512 : hopLength;
@@ -374,7 +381,7 @@ function pitchCorrectToMidiTimevarying(samples, f0Hz, targetMidi, sampleRate = 2
   if (request.voicedProb && request.voicedProb.length !== request.f0Hz.length) {
     throw new RangeError("pitchCorrectToMidiTimevarying: voicedProb length must match f0Hz length");
   }
-  const voicedF32 = request.voiced ? Float32Array.from(request.voiced) : void 0;
+  const voicedF32 = request.voiced ? toVoicedFloat32(request.voiced) : void 0;
   return requireModule().pitchCorrectToMidiTimevarying(
     request.samples,
     request.sampleRate ?? 22050,
@@ -396,7 +403,7 @@ function pitchCorrectTimevarying(samples, f0Hz, sampleRate = 22050, hopLength =
   }
   const nativeOptions = {
     ...request,
-    voiced: request.voiced ? Float32Array.from(request.voiced) : void 0
+    voiced: request.voiced ? toVoicedFloat32(request.voiced) : void 0
   };
   return requireModule().pitchCorrectTimevarying(
     request.samples,
@@ -856,6 +863,30 @@ function masteringStreamingPreview(samples, sampleRate = 22050, platforms = [])
     request.platforms ?? []
   );
 }
+function masteringAssistantSuggestStereo(request) {
+  return requireModule4().masteringAssistantSuggestStereo(
+    request.left,
+    request.right,
+    request.sampleRate ?? 22050,
+    request.params ?? {}
+  );
+}
+function masteringAudioProfileStereo(request) {
+  return requireModule4().masteringAudioProfileStereo(
+    request.left,
+    request.right,
+    request.sampleRate ?? 22050,
+    request.params ?? {}
+  );
+}
+function masteringStreamingPreviewStereo(request) {
+  return requireModule4().masteringStreamingPreviewStereo(
+    request.left,
+    request.right,
+    request.sampleRate ?? 22050,
+    request.platforms ?? []
+  );
+}
 
 // src/mastering_dynamics.ts
 function requireModule5() {
@@ -3740,6 +3771,15 @@ function meteringCrestFactorDb(samples, sampleRate = 22050, options = {}) {
   assertSamples("meteringCrestFactorDb", request.samples, request.validate !== false);
   return requireModule15().meteringCrestFactorDb(request.samples, request.sampleRate ?? 22050);
 }
+function meteringCrestFactorDbStereo(request) {
+  assertSamples("meteringCrestFactorDbStereo", request.left, request.validate !== false);
+  assertSamples("meteringCrestFactorDbStereo", request.right, request.validate !== false);
+  return requireModule15().meteringCrestFactorDbStereo(
+    request.left,
+    request.right,
+    request.sampleRate ?? 22050
+  );
+}
 function meteringDcOffset(samples, sampleRate = 22050, options = {}) {
   const request = samples instanceof Float32Array ? { samples, sampleRate, ...options } : samples;
   assertSamples("meteringDcOffset", request.samples, request.validate !== false);
@@ -3975,6 +4015,20 @@ function projectLoopModeValue(mode) {
 }
 
 // src/project_class.ts
+function normalizeMidiFxBakeRequest(clipIdOrRequest, configJson) {
+  if (typeof clipIdOrRequest === "number") {
+    return {
+      clipId: clipIdOrRequest,
+      configJson: configJson ?? "",
+      withSourceIndex: false
+    };
+  }
+  return {
+    clipId: clipIdOrRequest.clipId,
+    configJson: clipIdOrRequest.configJson,
+    withSourceIndex: clipIdOrRequest.withSourceIndex ?? false
+  };
+}
 function validateAssistSidecarUint32(value, field) {
   if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0 || value > 4294967295) {
     throw new RangeError(`Project.setAssistSidecar: ${field} must be a uint32`);
@@ -4330,12 +4384,23 @@ var Project = class _Project {
   setProgramOnChannel(clipId, group, channel, program, bank = -1) {
     this.native.setProgramOnChannel(clipId, group, channel, program, bank);
   }
+  bakeMidiFx(clipIdOrRequest, configJson) {
+    const request = normalizeMidiFxBakeRequest(clipIdOrRequest, configJson);
+    if (!request.withSourceIndex) {
+      this.native.bakeMidiFx(request.clipId, request.configJson);
+      return {};
+    }
+    return {
+      sourceIndex: this.native.bakeMidiFxWithSourceIndex(request.clipId, request.configJson)
+    };
+  }
   /**
-   * Destructively bake a MIDI-FX chain into all stored events. Large clips are
-   * drained without truncation; failure leaves the original clip unchanged.
+   * Count the events {@link bakeMidiFx} would produce for this clip and
+   * configuration, without mutating the project. The transform is
+   * deterministic, so the count matches what the bake goes on to produce.
    */
-  bakeMidiFx(clipId, configJson) {
-    this.native.bakeMidiFx(clipId, configJson);
+  previewMidiFxCount(request) {
+    return this.native.previewMidiFxCount(request.clipId, request.configJson);
   }
   /** Backward alias for {@link bakeMidiFx}. */
   setMidiFx(clipId, configJson) {
@@ -5293,6 +5358,15 @@ var RealtimeEngine = class {
    * Returns `-1` when the track, insert, or name is unknown. (The Python binding
    * raises a `SonareError` for an unknown id where Node/WASM return the `-1`
    * sentinel.)
+   *
+   * This trio is how a mastering processor gets time-varying automation: the
+   * `eq.*`, `dynamics.*`, `saturation.*`, `spectral.*`, `stereo.*`,
+   * `maximizer.*` and `multiband.*` processors are all available as strip
+   * inserts, so placing one on a strip and resolving its parameter here drives
+   * it at audio-block precision, live and offline alike. The whole-signal
+   * stages of the offline mastering chain (`repair.*`, `loudness`, and the
+   * match stages) have no insert form and no automation id: they buffer the
+   * entire signal by construction and do not run on the realtime path.
    */
   resolveTrackInsertAutomationId(trackId, insertIndex, paramName) {
     return this.native.resolveTrackInsertAutomationId(trackId, insertIndex, paramName);
@@ -5420,6 +5494,33 @@ var RealtimeEngine = class {
   processPrepared(numFrames) {
     this.native.processPrepared(numFrames);
   }
+  /**
+   * Allocates the cue-bus counterpart of {@link prepareChannels}. Needed only
+   * when PFL/AFL monitoring must reach a separate output: `processPrepared`
+   * folds the cue bus into the program output, while
+   * {@link processPreparedWithMonitor} keeps the two apart. Call once, off the
+   * audio thread, with at least as many channels as `prepareChannels` got.
+   */
+  prepareMonitorChannels(numChannels, maxFrames) {
+    this.native.prepareMonitorChannels(numChannels, maxFrames);
+  }
+  /**
+   * Returns a Float32Array view onto the persistent cue-bus scratch for one
+   * channel (valid for up to `numFrames`). Read it after
+   * {@link processPreparedWithMonitor}. Re-acquire after WASM memory growth.
+   */
+  getMonitorChannelBuffer(channel, numFrames) {
+    return this.native.getMonitorChannelBuffer(channel, numFrames);
+  }
+  /**
+   * Runs the engine in place over the prepared scratch, writing the cue bus to
+   * the monitor scratch instead of folding it into the program output.
+   * Allocation-free: safe on the AudioWorklet render thread after
+   * `prepareChannels` and `prepareMonitorChannels`.
+   */
+  processPreparedWithMonitor(numFrames) {
+    this.native.processPreparedWithMonitor(numFrames);
+  }
   processWithMonitor(channels) {
     return this.native.processWithMonitor(channels);
   }
@@ -7303,7 +7404,9 @@ export {
   masterAudioWithProgress,
   mastering,
   masteringAssistantSuggest,
+  masteringAssistantSuggestStereo,
   masteringAudioProfile,
+  masteringAudioProfileStereo,
   masteringChain,
   masteringChainStereo,
   masteringChainStereoWithProgress,
@@ -7333,12 +7436,14 @@ export {
   masteringStereoAnalysisNames,
   masteringStereoAnalyze,
   masteringStreamingPreview,
+  masteringStreamingPreviewStereo,
   melDelta,
   melSpectrogram,
   melToAudio,
   melToHz,
   melToStft,
   meteringCrestFactorDb,
+  meteringCrestFactorDbStereo,
   meteringDcOffset,
   meteringDetectClipping,
   meteringDynamicRange,