@libraz/libsonare 1.5.5 → 1.7.0

package/src/worklet/engine-register.ts

@@ -24,6 +24,7 @@ export function registerSonareRealtimeEngineWorkletProcessor(
   class RegisteredSonareRealtimeEngineWorkletProcessor extends Base {
     private bridge?: SonareRealtimeEngineWorkletProcessor;
     private readonly pendingMessages: unknown[] = [];
+    private pendingMessagesOverflowed = false;
     readonly port?: WorkletPort;
 
     constructor(options?: { processorOptions?: SonareRealtimeEngineWorkletProcessorOptions }) {
@@ -35,6 +36,10 @@ export function registerSonareRealtimeEngineWorkletProcessor(
         if (!this.bridge) {
           if (this.pendingMessages.length < 1024) {
             this.pendingMessages.push(event.data);
+          } else {
+            // A long sync before embind initialization must fail visibly rather
+            // than drop a provider/page/commit message and leave silent audio.
+            this.pendingMessagesOverflowed = true;
           }
           return;
         }
@@ -112,8 +117,11 @@ export function registerSonareRealtimeEngineWorkletProcessor(
             moduleFactory,
           });
         }
+        if (this.pendingMessagesOverflowed) {
+          throw new Error('AudioWorklet initialization message buffer overflowed.');
+        }
         this.bridge = new SonareRealtimeEngineWorkletProcessor(options, {
-          postMessage: (message) => port?.postMessage?.(message),
+          postMessage: (message, transfer) => port?.postMessage?.(message, transfer),
           onMeter: (meter) => port?.postMessage?.(meter),
         });
         for (const message of options.initialSyncMessages ?? []) {

package/src/worklet/engine-strips.ts

@@ -1,5 +1,5 @@
 import { panLawCode, panModeCode } from '../codes';
-import type { EqBand, PanLaw, PanMode, RealtimeEngine } from '../index';
+import type { EqBand, PanLawInput, PanMode, RealtimeEngine } from '../index';
 import type { SonareEngineInstrumentSyncMessage, SonareEngineSyncMessage } from './messages';
 
 /**
@@ -85,7 +85,7 @@ export function setTrackStripPan(
 export function setTrackStripPanLaw(
   ctx: EngineStripContext,
   target: string | number,
-  panLaw: PanLaw | number,
+  panLaw: PanLawInput,
 ): void {
   const trackId = trackIdFor(ctx, target);
   const code = panLawCode(panLaw);
@@ -232,6 +232,17 @@ export function pushMidiCc(
   });
 }
 
+export function pushMidiUmp(
+  ctx: EngineStripContext,
+  trackId: string | number,
+  word0: number,
+  renderFrame: number,
+): void {
+  const destinationId = ctx.resolveTargetId(trackId);
+  ctx.offlineEngine.pushMidiUmp(destinationId, word0, renderFrame);
+  ctx.postSync({ type: 'syncMidiUmp', destinationId, word0, renderFrame });
+}
+
 export function setBuiltinInstrument(
   ctx: EngineStripContext,
   trackId: string | number,
@@ -260,7 +271,12 @@ export function loadSoundFont(ctx: EngineStripContext, data: Uint8Array): void {
 export function setSf2Instrument(
   ctx: EngineStripContext,
   trackId: string | number,
-  config: { destinationId?: number; gain?: number; polyphony?: number },
+  config: {
+    destinationId?: number;
+    gain?: number;
+    polyphony?: number;
+    preferModelForModeledFamilies?: boolean;
+  },
 ): void {
   const destinationId = ctx.resolveTargetId(trackId);
   ctx.offlineEngine.setSf2Instrument(config, destinationId);

package/src/worklet/engine-sync.ts

@@ -65,11 +65,7 @@ export function resolveTargetId(target: string | number): number {
   return Number.isFinite(parsed) ? parsed : 0;
 }
 
-/**
- * Resolves a parameter id from a name or numeric id. Numeric params pass
- * through; named params are matched against the parameter list, then fall back
- * to a target-id resolution of the name (or the node id).
- */
+/** Resolves a registered parameter name or passes through a numeric id. */
 export function resolveParamId(
   parameters: readonly EngineParameterInfo[],
   nodeId: string,
@@ -82,7 +78,7 @@ export function resolveParamId(
   if (byName) {
     return byName.id;
   }
-  return resolveTargetId(param || nodeId);
+  throw new RangeError(`Unknown engine parameter ${JSON.stringify(param)} for node ${nodeId}`);
 }
 
 /** Encodes an automation curve descriptor to the engine's numeric curve code. */

package/src/worklet/engine-tempo-facade.ts

@@ -24,6 +24,13 @@ interface TimeSignature {
 export interface EngineTempoContext {
   readonly offlineEngine: RealtimeEngine;
   readonly realtimeNode: SonareRealtimeEngineNode;
+  sendCommand(command: {
+    type: SonareEngineCommandType;
+    targetId?: number;
+    sampleTime?: number;
+    argFloat?: number;
+    argInt?: number;
+  }): boolean;
   postSync(message: SonareEngineSyncMessage): void;
   getTempoBpm(): number;
   setTempoBpm(bpm: number): void;
@@ -54,11 +61,6 @@ export function setTempo(ctx: EngineTempoContext, bpm: number): void {
   ctx.setTempoSegments([{ startPpq: 0, bpm }]);
   ctx.offlineEngine.setTempo(bpm);
   postTempoSync(ctx);
-  ctx.realtimeNode.sendCommand({
-    type: SonareEngineCommandType.SetTempoMap,
-    sampleTime: -1,
-    argFloat: bpm,
-  });
 }
 
 export function setTempoSegments(
@@ -113,7 +115,7 @@ export function setLoop(
   // while loop STARTS and the offline path stay exact. This is intentional:
   // the record has no second free Float64 lane, and a micro-PPQ grid on the
   // loop end is well below audible/sample-accurate resolution at any tempo.
-  return ctx.realtimeNode.sendCommand({
+  return ctx.sendCommand({
     type: SonareEngineCommandType.SetLoop,
     targetId: enabled ? 1 : 0,
     sampleTime: -1,