@libraz/libsonare 1.5.5 → 1.7.0

package/src/worklet/engine-offline.ts

@@ -47,6 +47,7 @@ export interface EngineTransportContext {
     seekSample(timelineSample: number, sampleTime?: number): boolean;
   };
   offlineEngine: RealtimeEngine;
+  flushOfflineMirror(): void;
   setTransportPlaying(playing: boolean): void;
   flushPendingInstrumentSync(): void;
   setTempo(bpm: number): void;
@@ -74,12 +75,16 @@ export function buildTransportFacade(ctx: EngineTransportContext): SonareEngineT
     },
     seekPpq: (ppq, sampleTime = -1) => {
       ctx.offlineEngine.seekPpq(ppq, sampleTime);
-      return ctx.realtimeNode.seekPpq(ppq, sampleTime);
+      const ok = ctx.realtimeNode.seekPpq(ppq, sampleTime);
+      ctx.flushOfflineMirror();
+      return ok;
     },
     seekSeconds: (seconds, sampleTime = -1) => {
       const timelineSample = Math.max(0, Math.round(seconds * ctx.sampleRate));
       ctx.offlineEngine.seekSample(timelineSample, sampleTime);
-      return ctx.realtimeNode.seekSample(timelineSample, sampleTime);
+      const ok = ctx.realtimeNode.seekSample(timelineSample, sampleTime);
+      ctx.flushOfflineMirror();
+      return ok;
     },
     setTempo: (bpm) => ctx.setTempo(bpm),
     setTempoSegments: (segments) => ctx.setTempoSegments(segments),

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

@@ -1,5 +1,11 @@
-import type { EngineParameterInfo, RealtimeEngine } from '../index';
-import type { SonareRealtimeEngineNode } from './engine-node';
+import { trackMonitorModeCode } from '../codes';
+import type {
+  EngineAutomationPoint,
+  EngineParameterInfo,
+  EngineTrackMonitorMode,
+  RealtimeEngine,
+} from '../index';
+import type { SonareEngineSyncMessage } from './messages';
 import {
   ENGINE_MIXER_PARAM_FADER_DB,
   ENGINE_MIXER_PARAM_PAN,
@@ -17,7 +23,15 @@ import {
  */
 export interface EngineParameterContext {
   readonly offlineEngine: RealtimeEngine;
-  readonly realtimeNode: SonareRealtimeEngineNode;
+  sendCommand(command: {
+    type: SonareEngineCommandType;
+    targetId?: number;
+    sampleTime?: number;
+    argFloat?: number;
+    argInt?: number;
+  }): boolean;
+  postSync(message: SonareEngineSyncMessage): void;
+  readonly automationLanes: Map<number, EngineAutomationPoint[]>;
   readonly trackLaneIds: number[];
   resolveParamId(nodeId: string, param: string | number): number;
   ensureTrackLane(target: string | number): number;
@@ -35,7 +49,7 @@ export function setParam(
   // reflects the live value, then push a sample-accurate command to the
   // realtime runtime (mirrors setTempo/setLoop above).
   ctx.offlineEngine.setParameter(paramId, value);
-  return ctx.realtimeNode.sendCommand({
+  return ctx.sendCommand({
     type: SonareEngineCommandType.SetParam,
     targetId: paramId,
     sampleTime: -1,
@@ -51,7 +65,7 @@ export function setSoloMute(
 ): boolean {
   const laneIndex = ctx.ensureTrackLane(target);
   ctx.offlineEngine.setSoloMute(laneIndex, solo, mute);
-  return ctx.realtimeNode.sendCommand({
+  return ctx.sendCommand({
     type: SonareEngineCommandType.SetSoloMute,
     targetId: laneIndex,
     sampleTime: -1,
@@ -59,6 +73,29 @@ export function setSoloMute(
   });
 }
 
+export function setTrackMonitorMode(
+  ctx: EngineParameterContext,
+  target: string | number,
+  mode: EngineTrackMonitorMode,
+  renderFrame = -1,
+): boolean {
+  // Resolve the mode before declaring a lane or touching either engine. This
+  // keeps booleans, fractions, and unknown spellings from reaching the queue.
+  const modeOrdinal = trackMonitorModeCode(mode);
+  const laneIndex = ctx.ensureTrackLane(target);
+  ctx.offlineEngine.setTrackMonitorMode(
+    laneIndex,
+    modeOrdinal as EngineTrackMonitorMode,
+    renderFrame,
+  );
+  return ctx.sendCommand({
+    type: SonareEngineCommandType.SetTrackMonitorMode,
+    targetId: laneIndex,
+    sampleTime: renderFrame,
+    argInt: modeOrdinal,
+  });
+}
+
 /**
  * Returns the automation target id for a mixer strip parameter.
  *
@@ -170,3 +207,16 @@ export function listParameters(ctx: EngineParameterContext): EngineParameterInfo
   }
   return parameters;
 }
+
+/** Registers a parameter on both the offline mirror and live worklet engine. */
+export function addParameter(ctx: EngineParameterContext, info: EngineParameterInfo): void {
+  ctx.offlineEngine.addParameter(info);
+  ctx.postSync({ type: 'syncParameters', parameters: listParameters(ctx) });
+}
+
+/** Clears registered parameters and their automation lanes on both engines. */
+export function clearParameters(ctx: EngineParameterContext): void {
+  ctx.offlineEngine.clearParameters();
+  ctx.automationLanes.clear();
+  ctx.postSync({ type: 'syncParameters', parameters: [] });
+}