@libraz/libsonare 1.4.0 → 1.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libraz/libsonare",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "type": "module",
   "packageManager": "yarn@4.15.0",
   "description": "Audio analysis library for music information retrieval",

package/src/effects_mastering.ts

@@ -385,11 +385,16 @@ export function mastering(
     options.targetLufs ?? -14.0,
     options.ceilingDb ?? -1.0,
     options.truePeakOversample ?? 4,
+    options.releaseMs ?? 0, // 0 => library default (50 ms)
+    options.applyGainAtInputRate ?? false,
   );
 }
 
 export function masteringProcessorNames(): SoloProcessor[] {
-  return requireModule().masteringProcessorNames() as SoloProcessor[];
+  // embind hands back a vector whose constructor is not this realm's Array, so the
+  // result is not structured-cloneable (breaks postMessage to a Worker).
+  // Array.from() re-roots it as a plain Array. Same for the sibling *Names() below.
+  return Array.from(requireModule().masteringProcessorNames()) as SoloProcessor[];
 }
 
 /**
@@ -414,9 +419,11 @@ export function masteringInsertNames(): string[] {
  * @param name - Insert processor name (see {@link masteringInsertNames}).
  */
 export function masteringInsertParamNames(name: string): string[] {
-  return (
-    requireModule() as unknown as { masteringInsertParamNames: (name: string) => string[] }
-  ).masteringInsertParamNames(name);
+  return Array.from(
+    (
+      requireModule() as unknown as { masteringInsertParamNames: (name: string) => string[] }
+    ).masteringInsertParamNames(name),
+  );
 }
 
 /** One realtime-automatable parameter of an insert processor. */
@@ -495,15 +502,15 @@ export function masteringProcessorCatalog(): MasteringProcessorCatalogEntry[] {
 }
 
 export function masteringPairProcessorNames(): PairProcessor[] {
-  return requireModule().masteringPairProcessorNames() as PairProcessor[];
+  return Array.from(requireModule().masteringPairProcessorNames()) as PairProcessor[];
 }
 
 export function masteringPairAnalysisNames(): PairAnalysis[] {
-  return requireModule().masteringPairAnalysisNames() as PairAnalysis[];
+  return Array.from(requireModule().masteringPairAnalysisNames()) as PairAnalysis[];
 }
 
 export function masteringStereoAnalysisNames(): StereoAnalysis[] {
-  return requireModule().masteringStereoAnalysisNames() as StereoAnalysis[];
+  return Array.from(requireModule().masteringStereoAnalysisNames()) as StereoAnalysis[];
 }
 
 export function masteringProcess(
@@ -945,7 +952,7 @@ export function masteringChainStereoWithProgress(
  * @returns Preset names in display order (e.g. "pop", "edm", "aiMusic")
  */
 export function masteringPresetNames(): MasteringPreset[] {
-  return requireModule().masteringPresetNames() as MasteringPreset[];
+  return Array.from(requireModule().masteringPresetNames()) as MasteringPreset[];
 }
 
 /**
@@ -1034,7 +1041,7 @@ export function masterAudioStereoWithProgress(
 }
 
 export function mixingScenePresetNames(): string[] {
-  return requireModule().mixingScenePresetNames();
+  return Array.from(requireModule().mixingScenePresetNames());
 }
 
 /**

package/src/feature_music.ts

@@ -204,15 +204,19 @@ export function analyzeSections(
   if ((options.minSectionSec ?? 4.0) <= 0) {
     throw new RangeError('analyzeSections: minSectionSec must be positive');
   }
-  return requireModule()
-    .analyzeSections(
-      samples,
-      sampleRate,
-      options.nFft ?? 2048,
-      options.hopLength ?? 512,
-      options.minSectionSec ?? 4.0,
-    )
-    .map((s) => ({ ...s, type: s.type as SectionType }));
+  // The embind value marshalling returns an array whose constructor is not this
+  // realm's Array; chaining .map() onto it propagates that constructor via
+  // Symbol.species, leaving a result that structuredClone (and so postMessage to
+  // a Worker) rejects with "could not be cloned". Array.from() re-roots it as a
+  // plain Array before mapping.
+  const sections = requireModule().analyzeSections(
+    samples,
+    sampleRate,
+    options.nFft ?? 2048,
+    options.hopLength ?? 512,
+    options.minSectionSec ?? 4.0,
+  );
+  return Array.from(sections, (s) => ({ ...s, type: s.type as SectionType }));
 }
 
 /** Options for {@link analyzeMelody}. All fields are optional. */

package/src/project.ts

@@ -626,7 +626,12 @@ interface WasmProject {
     activeTakeId: number,
   ) => void;
   setClipCompSegments: (clipId: number, segments: ReadonlyArray<ProjectClipCompSegment>) => void;
-  setClipLoop: (clipId: number, loopMode: number, loopLengthPpq: number) => void;
+  setClipLoop: (
+    clipId: number,
+    loopMode: number,
+    loopLengthPpq: number,
+    loopCrossfadePpq: number,
+  ) => void;
   setClipSource: (clipId: number, sourceId: number) => void;
   duplicateClip: (clipId: number, newStartPpq: number) => number;
   removeTrack: (trackId: number) => void;
@@ -827,7 +832,8 @@ export function projectAbiVersion(): number {
  * names instead of hardcoding magic strings.
  */
 export function synthPresetNames(): string[] {
-  return projectModule().synthPresetNames();
+  // Array.from re-roots embind's vector as a plain, structured-cloneable Array.
+  return Array.from(projectModule().synthPresetNames());
 }
 
 /**
@@ -837,7 +843,11 @@ export function synthPresetNames(): string[] {
  * throw.
  */
 export function synthPresetPatch(name: string): SynthPatch {
-  return projectModule().synthPresetPatch(name);
+  // embind returns a val::object whose constructor is not this realm's Object, so a
+  // direct return is not structured-cloneable (breaks postMessage to a Worker).
+  // Spreading into a fresh literal re-roots it as a plain Object; modRoutings is
+  // already a plain member array.
+  return { ...projectModule().synthPresetPatch(name) };
 }
 
 export function synthEnumTables(): SynthEnumTables {
@@ -1464,9 +1474,23 @@ export class Project {
     this.native.setClipCompSegments(clipId, segments);
   }
 
-  /** Set a clip's loop mode + loop length in PPQ (undoable). */
-  setClipLoop(clipId: number, loopMode: ProjectLoopMode, loopLengthPpq = 0): void {
-    this.native.setClipLoop(clipId, projectLoopModeValue(loopMode), loopLengthPpq);
+  /**
+   * Set a clip's loop mode + loop length in PPQ (undoable). `loopCrossfadePpq`
+   * is an optional equal-power crossfade at the loop seam (PPQ, finite and >= 0;
+   * 0 = hard loop); the engine clamps it to the clip's pre-roll and half the loop.
+   */
+  setClipLoop(
+    clipId: number,
+    loopMode: ProjectLoopMode,
+    loopLengthPpq = 0,
+    loopCrossfadePpq = 0,
+  ): void {
+    this.native.setClipLoop(
+      clipId,
+      projectLoopModeValue(loopMode),
+      loopLengthPpq,
+      loopCrossfadePpq,
+    );
   }
 
   /** Rebind a clip to a different (already-registered) source (undoable). */

package/src/public_types.ts

@@ -355,6 +355,10 @@ export interface MasteringOptions {
   ceilingDb?: number;
   /** Oversampling factor used for peak estimation. Default 4. */
   truePeakOversample?: number;
+  /** Post true-peak limiter release in ms. Default 0 => library default (50 ms). */
+  releaseMs?: number;
+  /** Apply the static loudness gain at the input (pre-oversample) rate. Default false. */
+  applyGainAtInputRate?: boolean;
 }
 
 /** Options for `noteStretch`. All fields are optional. */

package/src/quick_analysis.ts

@@ -107,20 +107,24 @@ export function detectKeyCandidates(
   options: KeyDetectionOptions = {},
 ): KeyCandidate[] {
   validateAnalysisInput('detectKeyCandidates', samples, sampleRate, options);
-  return requireModule()
-    ._detectKeyCandidates(
-      samples,
-      sampleRate,
-      options.nFft ?? 4096,
-      options.hopLength ?? 512,
-      options.useHpss ?? false,
-      options.loudnessWeighted ?? false,
-      options.highPassHz ?? 0,
-      keyModeValues(options.modes),
-      keyProfileValue(options.profile),
-      options.genreHint ?? '',
-    )
-    .map(convertKeyCandidate);
+  // The embind value marshalling returns an array whose constructor is not this
+  // realm's Array; chaining .map() onto it propagates that constructor via
+  // Symbol.species, leaving a result that structuredClone (and so postMessage to
+  // a Worker) rejects with "could not be cloned". Array.from() re-roots it as a
+  // plain Array before mapping.
+  const candidates = requireModule()._detectKeyCandidates(
+    samples,
+    sampleRate,
+    options.nFft ?? 4096,
+    options.hopLength ?? 512,
+    options.useHpss ?? false,
+    options.loudnessWeighted ?? false,
+    options.highPassHz ?? 0,
+    keyModeValues(options.modes),
+    keyProfileValue(options.profile),
+    options.genreHint ?? '',
+  );
+  return Array.from(candidates, convertKeyCandidate);
 }
 
 /**

package/src/realtime_voice_changer.ts

@@ -259,7 +259,8 @@ export class RealtimeVoiceChanger {
 }
 
 export function realtimeVoiceChangerPresetNames(): VoicePresetId[] {
-  return getSonareModule().realtimeVoiceChangerPresetNames() as VoicePresetId[];
+  // Array.from re-roots embind's vector as a plain, structured-cloneable Array.
+  return Array.from(getSonareModule().realtimeVoiceChangerPresetNames()) as VoicePresetId[];
 }
 
 export function realtimeVoiceChangerPresetJson(name: VoicePresetId): string {

package/src/sonare.js.d.ts

@@ -1357,6 +1357,8 @@ export interface SonareModule {
     targetLufs: number,
     ceilingDb: number,
     truePeakOversample: number,
+    releaseMs: number,
+    applyGainAtInputRate: boolean,
   ) => WasmMasteringResult;
   masteringProcessorNames: () => string[];
   masteringPairProcessorNames: () => string[];