@libraz/libsonare 1.8.0 → 1.8.2

package/src/worklet/protocol.ts

@@ -41,6 +41,20 @@ export interface SonareWorkletMeterSnapshot {
   shortTermLufs: number;
   integratedLufs: number;
   gainReductionDb: number;
+  /** Maximum pre-trim input peak for the left channel, in dBFS. */
+  inputPeakDbL: number;
+  /** Maximum pre-trim input peak for the right channel, in dBFS. */
+  inputPeakDbR: number;
+  /**
+   * Per-insert gain reduction in dB (each <= 0) of the target's strip, in combined
+   * pre-to-post insert order, folded to the deepest value across the sub-blocks of the
+   * latest committed host block. It describes that latest block as of the drain, not
+   * necessarily this record's own block, so it is attached only to the newest record per
+   * target within one drain; older backlogged records omit it. Present only on snapshots
+   * delivered over postMessage; the SharedArrayBuffer meter ring has a fixed layout that
+   * does not carry it, so ring hosts read it with `pollInsertGainReduction(targetId)`.
+   */
+  insertGainReductionDb?: number[];
 }
 
 export interface SonareWorkletSpectrumSnapshot {
@@ -52,18 +66,21 @@ export interface SonareWorkletSpectrumSnapshot {
 export const SONARE_METER_RING_HEADER_INTS = 4;
 // Record layout: [frameLo, frameHi, targetId, peakDbL, peakDbR, rmsDbL, rmsDbR,
 // correlation, truePeakDbL, truePeakDbR, momentaryLufs, shortTermLufs,
-// integratedLufs, gainReductionDb].
+// integratedLufs, gainReductionDb, inputPeakDbL, inputPeakDbR].
 // The sample-frame index is monotonically increasing and quickly exceeds the
 // 2^24 exact-integer range of a single Float32 slot (~349 s at 48 kHz), so it is
 // stored split across two Float32 lanes (low 24 bits + high bits) for exact
 // reconstruction. See encodeFrameLo/encodeFrameHi/decodeFrame.
-export const SONARE_METER_RING_RECORD_FLOATS = 14;
+export const SONARE_METER_RING_RECORD_FLOATS = 16;
 export const SONARE_SPECTRUM_RING_HEADER_INTS = 5;
 // Scope ring header: [writeIndex, capacity, recordFloats, bands, maxPoints,
 // reserved]. Record layout: [frameLo, frameHi, targetId, bandCount, pointCount,
 // band0..band(bands-1), l0, r0, l1, r1, ... (maxPoints stereo pairs)].
 export const SONARE_SCOPE_RING_HEADER_INTS = 6;
 export const SONARE_SCOPE_RING_RECORD_PREFIX_FLOATS = 5;
+/** Scope band and goniometer point counts used when a caller supplies none. */
+export const SONARE_SCOPE_DEFAULT_BANDS = 48;
+export const SONARE_SCOPE_DEFAULT_MAX_POINTS = 32;
 
 /** Base for splitting a frame index into two exactly-representable Float32 lanes. */
 const SONARE_FRAME_LANE_BASE = 0x1000000; // 2^24
@@ -121,6 +138,10 @@ export enum SonareEngineCommandType {
   // Queueable lane monitor-mode transition. The worklet command vocabulary
   // deliberately leaves 18..25 unused; this is the stable ABI-v3 ordinal.
   SetTrackMonitorMode = 26,
+  // Queueable master-meter integrated-loudness reset. Numeric value 28 mirrors
+  // rt::CommandType::kResetMasterMeterIntegrated; 27 remains the appended MIDI
+  // UMP slot command in the native vocabulary.
+  ResetMasterLoudnessMeter = 28,
 }
 
 export enum SonareEngineTelemetryType {
@@ -387,6 +408,8 @@ export function readSonareMeterRingBuffer(
       shortTermLufs: ring.records[offset + 11],
       integratedLufs: ring.records[offset + 12],
       gainReductionDb: ring.records[offset + 13],
+      inputPeakDbL: ring.records[offset + 14],
+      inputPeakDbR: ring.records[offset + 15],
     });
   }
   return { nextReadIndex: writeIndex, meters };
@@ -456,8 +479,8 @@ export function sonareScopeRingRecordFloats(bands: number, maxPoints: number): n
 
 export function sonareScopeRingBufferByteLength(
   capacity: number,
-  bands = 48,
-  maxPoints = 32,
+  bands = SONARE_SCOPE_DEFAULT_BANDS,
+  maxPoints = SONARE_SCOPE_DEFAULT_MAX_POINTS,
 ): number {
   const clampedCapacity = Math.max(1, Math.floor(capacity));
   const clampedBands = Math.max(1, Math.floor(bands));
@@ -472,8 +495,8 @@ export function sonareScopeRingBufferByteLength(
 
 export function createSonareScopeRingBuffer(
   capacity = 64,
-  bands = 48,
-  maxPoints = 32,
+  bands = SONARE_SCOPE_DEFAULT_BANDS,
+  maxPoints = SONARE_SCOPE_DEFAULT_MAX_POINTS,
 ): SonareScopeRingBuffer {
   const clampedCapacity = Math.max(1, Math.floor(capacity));
   const clampedBands = Math.max(1, Math.floor(bands));
@@ -552,8 +575,14 @@ export function scopeRingFromSharedBuffer(
   const existingBands = Atomics.load(header, 3);
   const existingMaxPoints = Atomics.load(header, 4);
   const capacity = Math.max(1, Math.floor(existingCapacity || fallbackCapacity || 1));
-  const bands = Math.max(1, Math.floor(existingBands || fallbackBands || 48));
-  const maxPoints = Math.max(0, Math.floor(existingMaxPoints || (fallbackMaxPoints ?? 32)));
+  const bands = Math.max(
+    1,
+    Math.floor(existingBands || fallbackBands || SONARE_SCOPE_DEFAULT_BANDS),
+  );
+  const maxPoints = Math.max(
+    0,
+    Math.floor(existingMaxPoints || (fallbackMaxPoints ?? SONARE_SCOPE_DEFAULT_MAX_POINTS)),
+  );
   const recordFloats = sonareScopeRingRecordFloats(bands, maxPoints);
   const minBytes = sonareScopeRingBufferByteLength(capacity, bands, maxPoints);
   if (sharedBuffer.byteLength < minBytes) {
@@ -1102,6 +1131,8 @@ export function meterFromEngine(meter: EngineMeterTelemetry): SonareWorkletMeter
     shortTermLufs: meter.shortTermLufs,
     integratedLufs: meter.integratedLufs,
     gainReductionDb: meter.gainReductionDb,
+    inputPeakDbL: meter.inputPeakDbL,
+    inputPeakDbR: meter.inputPeakDbR,
   };
 }
 

package/src/worklet.ts

@@ -24,6 +24,8 @@ export type {
   SonareEngineCaptureRequestMessage,
   SonareEngineCaptureResponseMessage,
   SonareEngineClipPageRequestMessage,
+  SonareEngineInsertGainReductionRequestMessage,
+  SonareEngineInsertGainReductionResponseMessage,
   SonareEngineSyncAutomationMessage,
   SonareEngineSyncBuiltinInstrumentMessage,
   SonareEngineSyncBusStripEqBandMessage,