@libraz/libsonare 1.7.2 → 1.8.0

package/dist/worklet/engine-offline.d.ts

@@ -0,0 +1,81 @@
+import type { EngineCaptureStatus, EngineMarker, EngineTrackLane, RealtimeEngine } from '../index';
+import type { SonareEngineSyncCaptureMessage, SonareEngineTransportFacade } from './messages';
+/** Capture configuration options accepted by the engine's `configureCapture`. */
+export interface CaptureOptions {
+    bufferFrames: number;
+    channels?: number;
+    source?: EngineCaptureStatus['source'];
+    recordOffsetSamples?: number;
+    inputMonitor?: {
+        enabled: boolean;
+        gain?: number;
+    };
+}
+/**
+ * Normalizes capture options into the resolved config carried by the
+ * `syncCapture` message, applying defaults and refusing a non-integer count.
+ *
+ * @param options Raw capture options.
+ * @param defaultChannels Channel count to use when `options.channels` is unset.
+ * @throws RangeError if a frame count, channel count or offset is not an integer.
+ */
+export declare function buildCaptureConfig(options: CaptureOptions, defaultChannels: number): Omit<SonareEngineSyncCaptureMessage, 'type'>;
+/**
+ * Collaborator surface the transport facade needs from the owning engine: the
+ * realtime node (sample-accurate command transport), the offline engine it
+ * mirrors, and the tempo/loop setters plus playing-state bookkeeping.
+ */
+export interface EngineTransportContext {
+    readonly sampleRate: number;
+    realtimeNode: {
+        play(sampleTime?: number): boolean;
+        stop(sampleTime?: number): boolean;
+        seekPpq(ppq: number, sampleTime?: number): boolean;
+        seekSample(timelineSample: number, sampleTime?: number): boolean;
+    };
+    offlineEngine: RealtimeEngine;
+    flushOfflineMirror(): void;
+    setTransportPlaying(playing: boolean): void;
+    flushPendingInstrumentSync(): void;
+    setTempo(bpm: number): void;
+    setTempoSegments(segments: readonly {
+        startPpq: number;
+        bpm: number;
+    }[]): void;
+    setLoop(startPpq: number, endPpq: number, enabled?: boolean): boolean;
+}
+/** Builds the public transport facade that fans control to both engines. */
+export declare function buildTransportFacade(ctx: EngineTransportContext): SonareEngineTransportFacade;
+/**
+ * Validates and normalizes an append-only mixer-lane declaration.
+ *
+ * Lane indices are append-only: the new list must start with the already
+ * declared lane ids in their current order and may only append new track ids.
+ * Returns the normalized lane entries (numbers coerced to descriptors) and the
+ * resulting ordered id list.
+ *
+ * @throws if any track id is invalid, ids are duplicated, or the existing lane
+ *   order is not preserved.
+ */
+export declare function normalizeTrackLanes(existing: readonly number[], lanes: ReadonlyArray<number | EngineTrackLane>): {
+    entries: EngineTrackLane[];
+    ids: number[];
+};
+/**
+ * Resolves a marker set, assigning fresh ids to entries without one and
+ * validating explicit ids (positive, unique).
+ *
+ * @param markers The marker list to resolve.
+ * @param nextMarkerId The id counter to draw fresh ids from.
+ * @returns The resolved markers and the advanced id counter.
+ * @throws on a non-finite ppq, an invalid id, or a duplicate id.
+ */
+export declare function resolveMarkerSet(markers: ReadonlyArray<{
+    ppq: number;
+    name?: string;
+    id?: number;
+}>, nextMarkerId: number): {
+    resolved: EngineMarker[];
+    nextMarkerId: number;
+};
+//# sourceMappingURL=engine-offline.d.ts.map

package/dist/worklet/engine-offline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-offline.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-offline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEnG,OAAO,KAAK,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9F,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EACvB,eAAe,EAAE,MAAM,GACtB,IAAI,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAY9C;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACnC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACnD,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KAClE,CAAC;IACF,aAAa,EAAE,cAAc,CAAC;IAC9B,kBAAkB,IAAI,IAAI,CAAC;IAC3B,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,0BAA0B,IAAI,IAAI,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI,CAAC;IAC/E,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACvE;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,sBAAsB,GAAG,2BAA2B,CAkC7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,eAAe,CAAC,GAC7C;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAoB/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACnE,YAAY,EAAE,MAAM,GACnB;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CA2BpD"}

package/dist/worklet/engine-options.d.ts

@@ -0,0 +1,12 @@
+import type { RealtimeEngine } from '../index';
+import type { SonareRealtimeEngineNodeOptions } from './messages';
+export interface SonareEngineOptions extends SonareRealtimeEngineNodeOptions {
+    offlineEngine?: RealtimeEngine;
+    offlineBlockSize?: number;
+    offlineChannelCount?: number;
+}
+export type SuspendableAudioContext = BaseAudioContext & {
+    suspend?: () => Promise<void>;
+    resume?: () => Promise<void>;
+};
+//# sourceMappingURL=engine-options.d.ts.map

package/dist/worklet/engine-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-options.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,mBAAoB,SAAQ,+BAA+B;IAC1E,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG;IACvD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC"}

package/dist/worklet/engine-parameter-facade.d.ts

@@ -0,0 +1,106 @@
+import type { EngineAutomationPoint, EngineParameterInfo, EngineTrackMonitorMode, RealtimeEngine } from '../index';
+import type { SonareEngineSyncMessage } from './messages';
+import { SonareEngineCommandType } from './protocol';
+/**
+ * Collaborator surface the parameter / automation-id resolution helpers need
+ * from the owning {@link SonareEngine}: the offline engine they mirror into and
+ * query, the realtime node they command, the lane/bus declaration helpers, and
+ * the declared track-lane id store used to resolve insert-automation ids.
+ */
+export interface EngineParameterContext {
+    readonly offlineEngine: RealtimeEngine;
+    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;
+    ensureBus(busId: number): number;
+}
+export declare function setParam(ctx: EngineParameterContext, nodeId: string, param: string | number, value: number): boolean;
+export declare function setSoloMute(ctx: EngineParameterContext, target: string | number, solo: boolean, mute: boolean): boolean;
+export declare function setTrackMonitorMode(ctx: EngineParameterContext, target: string | number, mode: EngineTrackMonitorMode, renderFrame?: number): boolean;
+/**
+ * Returns the automation target id for a mixer strip parameter.
+ *
+ * The id addresses the engine's reserved mixer namespace, so it can be fed
+ * straight to setAutomationLane to automate a fader or pan without
+ * registering a parameter.
+ *
+ * @param target Track id (declares a mixer lane on first use) or 'master'.
+ * @param kind Strip parameter to address.
+ * @returns Reserved engine parameter id for the strip parameter.
+ */
+export declare function automationParamId(ctx: EngineParameterContext, target: string | number, kind: 'faderDb' | 'pan'): number;
+/**
+ * Returns the automation target id for a bus fader.
+ *
+ * @param busId Bus id (declares the mixer bus on first use).
+ * @returns Reserved engine parameter id for the bus fader gain (dB).
+ */
+export declare function busAutomationParamId(ctx: EngineParameterContext, busId: number): number;
+/**
+ * Resolves a track-lane insert parameter (JSON-key name) to the reserved
+ * insert-automation id fed straight to setAutomationLane. Declares the track's
+ * mixer lane first (like automationParamId) so the offline engine resolves the
+ * same strip selector the realtime engine uses.
+ *
+ * @param target Track id (declares a mixer lane on first use).
+ * @param insertIndex Index into the strip's combined insert sequence.
+ * @param paramName Processor JSON-key parameter name.
+ * @returns Reserved insert-automation id, or -1 when strip/insert/key unknown.
+ */
+export declare function resolveTrackInsertAutomationId(ctx: EngineParameterContext, target: string | number, insertIndex: number, paramName: string): number;
+/**
+ * Resolves a master-strip insert parameter to its reserved insert-automation
+ * id.
+ *
+ * @param insertIndex Index into the master strip's insert sequence.
+ * @param paramName Processor JSON-key parameter name.
+ * @returns Reserved insert-automation id, or -1 when insert/key unknown.
+ */
+export declare function resolveMasterInsertAutomationId(ctx: EngineParameterContext, insertIndex: number, paramName: string): number;
+/**
+ * Resolves a bus-strip insert parameter to its reserved insert-automation id.
+ * Declares the mixer bus first so the offline engine resolves the same bus
+ * selector.
+ *
+ * @param busId Bus id (declares the mixer bus on first use).
+ * @param insertIndex Index into the bus strip's insert sequence.
+ * @param paramName Processor JSON-key parameter name.
+ * @returns Reserved insert-automation id, or -1 when bus/insert/key unknown.
+ */
+export declare function resolveBusInsertAutomationId(ctx: EngineParameterContext, busId: number, insertIndex: number, paramName: string): number;
+/**
+ * Resolves a hosted instrument's continuous parameter to its reserved
+ * instrument-automation id, so an instrument parameter is driven from a
+ * breakpoint lane at audio-block precision like a strip insert.
+ *
+ * The instrument must already be bound on the offline engine for the
+ * destination (the worklet mirrors every instrument sync onto it), otherwise
+ * the resolve returns -1.
+ *
+ * @param destinationId MIDI destination the instrument is bound to.
+ * @param paramName Instrument JSON-key parameter name (e.g. `cutoffHz`).
+ * @returns Reserved instrument-automation id, or -1 when destination/key unknown.
+ */
+export declare function resolveInstrumentAutomationId(ctx: EngineParameterContext, destinationId: number, paramName: string): number;
+/**
+ * Returns the number of automation lanes installed on the engine, including
+ * lanes whose breakpoint list is currently empty.
+ *
+ * @returns Engine-side automation lane count.
+ */
+export declare function automationLaneCount(ctx: EngineParameterContext): number;
+export declare function listParameters(ctx: EngineParameterContext): EngineParameterInfo[];
+/** Registers a parameter on both the offline mirror and live worklet engine. */
+export declare function addParameter(ctx: EngineParameterContext, info: EngineParameterInfo): void;
+/** Clears registered parameters and their automation lanes on both engines. */
+export declare function clearParameters(ctx: EngineParameterContext): void;
+//# sourceMappingURL=engine-parameter-facade.d.ts.map

package/dist/worklet/engine-parameter-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-parameter-facade.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-parameter-facade.ts"],"names":[],"mappings":"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"}

package/dist/worklet/engine-processor.d.ts

@@ -0,0 +1,68 @@
+import { type WorkletInput, type WorkletOutput } from './audio_types';
+import { type SonareEngineCaptureRequestMessage, type SonareEngineSyncMessage, type SonareEngineTransportRequestMessage, type SonareRealtimeEngineWorkletProcessorOptions, type WorkletTransport } from './messages';
+import { type SonareEngineCommandRecord } from './protocol';
+/**
+ * AudioWorklet-style bridge for the DAW realtime engine facade.
+ *
+ * Backed by the `sonare.wasm` embind facade.
+ */
+export declare class SonareRealtimeEngineWorkletProcessor {
+    private static warnedChannelScratchOverflow;
+    readonly sampleRate: number;
+    readonly blockSize: number;
+    readonly channelCount: number;
+    private engine;
+    private closed;
+    private commandRing?;
+    private telemetryRing?;
+    private meterRing?;
+    private scopeRing?;
+    private clipPageRequestRing?;
+    private externalMidiRing?;
+    private transport?;
+    private meterIntervalFrames;
+    private lastMeterFrame;
+    private metronomeConfig;
+    private channelBuffers;
+    private monitorBuffers;
+    private readonly cueOutput;
+    private readonly liveClips;
+    private readonly pagedClipProviders;
+    private readonly pagedClipPageFrames;
+    private readonly pendingPagedClips;
+    private readonly clipPageRequestClipIds;
+    private readonly clipPageRequestPageIndices;
+    private clipPageRequestOverflowReported;
+    constructor(options?: SonareRealtimeEngineWorkletProcessorOptions, transport?: WorkletTransport);
+    process(inputs: WorkletInput, outputs: WorkletOutput): boolean;
+    private reacquireChannelBuffers;
+    private reacquireMonitorBuffers;
+    receiveCommand(command: SonareEngineCommandRecord): void;
+    receiveSync(message: SonareEngineSyncMessage): void;
+    private applySync;
+    receiveCaptureRequest(message: SonareEngineCaptureRequestMessage): void;
+    receiveTransportRequest(message: SonareEngineTransportRequestMessage): void;
+    destroy(): void;
+    private drainCommands;
+    private safeApplyCommand;
+    private applyCommand;
+    private publishTelemetry;
+    private writeTelemetryScratch;
+    private publishTelemetryRecord;
+    private publishMeters;
+    private writeMeterScratch;
+    private publishScope;
+    private writeScopeScratch;
+    private publishExternalMidi;
+    /**
+     * Forward a bounded batch of native page misses to the main thread. This
+     * deliberately runs after audio rendering: a cache miss is silence for this
+     * block, and OPFS I/O must never delay `process()`.
+     */
+    private publishClipPageRequests;
+    private removePagedClipProvider;
+    private clearPagedClipProviders;
+    private commandRingFromSharedBuffer;
+    private telemetryRingFromSharedBuffer;
+}
+//# sourceMappingURL=engine-processor.d.ts.map

package/dist/worklet/engine-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-processor.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-processor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAG1F,OAAO,EAIL,KAAK,iCAAiC,EAEtC,KAAK,uBAAuB,EAC5B,KAAK,mCAAmC,EAExC,KAAK,2CAA2C,EAChD,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAmBL,KAAK,yBAAyB,EAW/B,MAAM,YAAY,CAAC;AAkBpB;;;;GAIG;AACH,qBAAa,oCAAoC;IAC/C,OAAO,CAAC,MAAM,CAAC,4BAA4B,CAAS;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAC,CAAgC;IACpD,OAAO,CAAC,aAAa,CAAC,CAAkC;IACxD,OAAO,CAAC,SAAS,CAAC,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAC,CAAwB;IAC1C,OAAO,CAAC,mBAAmB,CAAC,CAAkC;IAC9D,OAAO,CAAC,gBAAgB,CAAC,CAA+B;IACxD,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAA4B;IAGlD,OAAO,CAAC,eAAe,CAA4D;IAQnF,OAAO,CAAC,cAAc,CAAiB;IAIvC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IACjE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IAKnE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAwB;IAC/D,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAwB;IACnE,OAAO,CAAC,+BAA+B,CAAK;gBAG1C,OAAO,GAAE,2CAAgD,EACzD,SAAS,CAAC,EAAE,gBAAgB;IAoF9B,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO;IAqF9D,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,uBAAuB;IAM/B,cAAc,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAUxD,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAenD,OAAO,CAAC,SAAS;IA+gBjB,qBAAqB,CAAC,OAAO,EAAE,iCAAiC,GAAG,IAAI;IAuDvE,uBAAuB,CAAC,OAAO,EAAE,mCAAmC,GAAG,IAAI;IAqB3E,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IA4GpB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,aAAa;IA6CrB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,mBAAmB;IA4B3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IA+F/B,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,6BAA6B;CAWtC"}

package/dist/worklet/engine-register.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSonareRealtimeEngineWorkletProcessor(name?: string): void;
+//# sourceMappingURL=engine-register.d.ts.map

package/dist/worklet/engine-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-register.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-register.ts"],"names":[],"mappings":"AAaA,wBAAgB,4CAA4C,CAC1D,IAAI,SAAqC,GACxC,IAAI,CA8IN"}

package/dist/worklet/engine-strips.d.ts

@@ -0,0 +1,73 @@
+import type { EqBand, PanLawInput, PanMode, RealtimeEngine } from '../index';
+import type { InsertParamOverrideMap } from './engine-mixer-facade';
+import { type StripJsonTarget } from './engine-mixer-facade';
+import type { SonareEngineInstrumentSyncMessage, SonareEngineSyncMessage } from './messages';
+/**
+ * Collaborator surface the strip/pan/EQ/insert/instrument/MIDI setters need from
+ * the owning {@link SonareEngine}: the offline engine they mirror writes into,
+ * the out-of-band sync posters, and the lane-resolution helpers.
+ */
+export interface EngineStripContext {
+    readonly offlineEngine: RealtimeEngine;
+    readonly trackLaneIds: number[];
+    postSync(message: SonareEngineSyncMessage): void;
+    postInstrumentSync(message: SonareEngineInstrumentSyncMessage): void;
+    ensureTrackLane(target: string | number): number;
+    resolveTargetId(target: string | number): number;
+    readStripJson(target: StripJsonTarget): string | undefined;
+    writeStripJson(target: StripJsonTarget, sceneJson: string): void;
+    readonly insertParamOverrides: InsertParamOverrideMap;
+}
+export declare function setTrackStripJson(ctx: EngineStripContext, trackId: number, sceneJson: string, trackStripJson: Map<number, string>): {
+    resetInserts: boolean;
+};
+export declare function setTrackStripEqBand(ctx: EngineStripContext, target: string | number, bandIndex: number, band: EqBand | string): void;
+export declare function setTrackStripInsertBypassed(ctx: EngineStripContext, target: string | number, insertIndex: number, bypassed: boolean, resetOnBypass: boolean): void;
+export declare function setTrackStripInsertParamByName(ctx: EngineStripContext, target: string | number, insertIndex: number, paramName: string, value: number): void;
+export declare function setTrackStripPan(ctx: EngineStripContext, target: string | number, pan: number): void;
+export declare function setTrackStripPanLaw(ctx: EngineStripContext, target: string | number, panLaw: PanLawInput): void;
+export declare function setTrackStripPanMode(ctx: EngineStripContext, target: string | number, panMode: PanMode | number): void;
+export declare function setTrackStripDualPan(ctx: EngineStripContext, target: string | number, leftPan: number, rightPan: number): void;
+export declare function setTrackStripChannelDelaySamples(ctx: EngineStripContext, target: string | number, delaySamples: number): void;
+/**
+ * Records a master fader or pan value the parameter path applied, so a master
+ * strip re-post does not reset it; a track lane keeps these outside its strip.
+ */
+export declare function cacheMasterStripScalar(ctx: EngineStripContext, field: 'faderDb' | 'pan', value: number): void;
+export declare function setMasterStripEqBand(ctx: EngineStripContext, bandIndex: number, band: EqBand | string): void;
+export declare function setMasterStripInsertBypassed(ctx: EngineStripContext, insertIndex: number, bypassed: boolean, resetOnBypass: boolean): void;
+export declare function setMasterStripInsertParamByName(ctx: EngineStripContext, insertIndex: number, paramName: string, value: number): void;
+export declare function setBusStripInsertParamByName(ctx: EngineStripContext, busId: number, insertIndex: number, paramName: string, value: number): void;
+export declare function setBusStripInsertBypassed(ctx: EngineStripContext, busId: number, insertIndex: number, bypassed: boolean, resetOnBypass: boolean): void;
+export declare function setBusStripEqBand(ctx: EngineStripContext, busId: number, bandIndex: number, band: EqBand | string): void;
+export declare function setBusStripPan(ctx: EngineStripContext, busId: number, pan: number): void;
+export declare function setBusStripPanLaw(ctx: EngineStripContext, busId: number, panLaw: PanLawInput): void;
+export declare function setBusStripPanMode(ctx: EngineStripContext, busId: number, panMode: PanMode | number): void;
+export declare function setBusStripDualPan(ctx: EngineStripContext, busId: number, leftPan: number, rightPan: number): void;
+export declare function pushMidiNoteOn(ctx: EngineStripContext, trackId: string | number, group: number, channel: number, note: number, velocity: number, renderFrame: number): void;
+export declare function pushMidiNoteOff(ctx: EngineStripContext, trackId: string | number, group: number, channel: number, note: number, velocity: number, renderFrame: number): void;
+export declare function pushMidiCc(ctx: EngineStripContext, trackId: string | number, group: number, channel: number, controller: number, value: number, renderFrame: number): void;
+export declare function pushMidiPitchBend(ctx: EngineStripContext, trackId: string | number, group: number, channel: number, bend14: number, renderFrame: number): void;
+export declare function pushMidiChannelPressure(ctx: EngineStripContext, trackId: string | number, group: number, channel: number, pressure: number, renderFrame: number): void;
+export declare function pushMidiPolyPressure(ctx: EngineStripContext, trackId: string | number, group: number, channel: number, note: number, pressure: number, renderFrame: number): void;
+export declare function pushMidiUmp(ctx: EngineStripContext, trackId: string | number, word0: number, renderFrame: number): void;
+export declare function setBuiltinInstrument(ctx: EngineStripContext, trackId: string | number, config: {
+    destinationId?: number;
+} & Record<string, unknown>): void;
+export declare function setSynthInstrument(ctx: EngineStripContext, trackId: string | number, patch: Record<string, unknown> | string): void;
+export declare function loadSoundFont(ctx: EngineStripContext, data: Uint8Array): void;
+export declare function setSf2Instrument(ctx: EngineStripContext, trackId: string | number, config: {
+    destinationId?: number;
+    gain?: number;
+    polyphony?: number;
+    preferModelForModeledFamilies?: boolean;
+    clearBankRig?: boolean;
+    gsEfxRealization?: 'modern' | 'classic';
+}): void;
+export declare function setMidiDestinationExternal(ctx: EngineStripContext, trackId: string | number, external: boolean): void;
+export declare function setExternalMidiClockEnabled(ctx: EngineStripContext, enabled: boolean): void;
+export declare function setMidiFx(ctx: EngineStripContext, trackId: string | number, configJson: string): void;
+export declare function clearMidiFx(ctx: EngineStripContext, trackId: string | number): void;
+export declare function pushMidiSysex(ctx: EngineStripContext, trackId: string | number, data: Uint8Array, renderFrame: number): void;
+export declare function pushMidiPanic(ctx: EngineStripContext, renderFrame: number): void;
+//# sourceMappingURL=engine-strips.d.ts.map

package/dist/worklet/engine-strips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-strips.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-strips.ts"],"names":[],"mappings":"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"}

package/dist/worklet/engine-sync.d.ts

@@ -0,0 +1,37 @@
+import type { EngineParameterInfo, EngineTempoSegment, EngineTimeSignatureSegment, EngineTrackLane, EngineTrackSend } from '../index';
+import type { SonareEngineSyncTempoMessage } from './messages';
+/**
+ * Builds the ordered mixer-lane descriptors for a sync message.
+ *
+ * Each declared track id is paired with its current send list and output bus
+ * (both omitted when absent), defensively copying the send entries.
+ *
+ * @param trackLaneIds Lane order (track ids) declared on the engine.
+ * @param trackSends Per-track send lists.
+ * @param trackOutputBus Per-track output bus routing.
+ * @returns Lane descriptors in lane order.
+ */
+export declare function buildMixerLanes(trackLaneIds: readonly number[], trackSends: ReadonlyMap<number, EngineTrackSend[]>, trackOutputBus: ReadonlyMap<number, number>): EngineTrackLane[];
+/**
+ * Builds the out-of-band tempo/time-signature sync message, deep-copying the
+ * tempo and time-signature segments so the consumer cannot alias engine state.
+ */
+export declare function buildTempoSync(tempoBpm: number, timeSignature: {
+    numerator: number;
+    denominator: number;
+}, tempoSegments: readonly EngineTempoSegment[], timeSignatureSegments: readonly EngineTimeSignatureSegment[]): SonareEngineSyncTempoMessage;
+/**
+ * Resolves a target id given as a number, or as a string naming one.
+ *
+ * Both spellings reach one refusal. Reading the string with `Number.parseInt`
+ * stops at the first non-digit, so `"3.5"` resolves to `3` and `"5abc"` to `5`,
+ * and an unparseable name resolves to `0` -- all ids the caller never named.
+ * `0` is a legal destination, so the native check these feed cannot tell the
+ * substitution from a deliberate choice and never reports one.
+ */
+export declare function resolveTargetId(target: string | number): number;
+/** Resolves a registered parameter name or passes through a numeric id. */
+export declare function resolveParamId(parameters: readonly EngineParameterInfo[], nodeId: string, param: string | number): number;
+/** Encodes an automation curve descriptor to the engine's numeric curve code. */
+export declare function curveCode(curve: number | 'linear' | 'exponential'): number;
+//# sourceMappingURL=engine-sync.d.ts.map

package/dist/worklet/engine-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-sync.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAClD,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C,eAAe,EAAE,CAUnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EACzD,aAAa,EAAE,SAAS,kBAAkB,EAAE,EAC5C,qBAAqB,EAAE,SAAS,0BAA0B,EAAE,GAC3D,4BAA4B,CAQ9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAS/D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,MAAM,CASR;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAK1E"}

package/dist/worklet/engine-tempo-facade.d.ts

@@ -0,0 +1,48 @@
+import type { EngineTempoSegment, EngineTimeSignatureSegment, EngineTransportState, RealtimeEngine } from '../index';
+import type { SonareRealtimeEngineNode } from './engine-node';
+import type { SonareEngineSyncMessage } from './messages';
+import { SonareEngineCommandType } from './protocol';
+interface TimeSignature {
+    numerator: number;
+    denominator: number;
+}
+/**
+ * Collaborator surface the tempo / time-signature / loop / transport helpers
+ * need from the owning {@link SonareEngine}: the offline engine they mirror
+ * into, the realtime node they command and query, the out-of-band sync poster,
+ * and getters/setters for the tempo-map and cached-transport state the engine
+ * holds (so the helpers mutate it by reference).
+ */
+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;
+    getTimeSignature(): TimeSignature;
+    setTimeSignature(signature: TimeSignature): void;
+    getTempoSegments(): EngineTempoSegment[];
+    setTempoSegments(segments: EngineTempoSegment[]): void;
+    getTimeSignatureSegments(): EngineTimeSignatureSegment[];
+    setTimeSignatureSegments(segments: EngineTimeSignatureSegment[]): void;
+    setLatestTransportState(state: EngineTransportState): void;
+    getLatestTransportState(): EngineTransportState | undefined;
+}
+export declare function postTempoSync(ctx: EngineTempoContext): void;
+export declare function setTempo(ctx: EngineTempoContext, bpm: number): void;
+export declare function setTempoSegments(ctx: EngineTempoContext, segments: readonly EngineTempoSegment[]): void;
+export declare function setTimeSignature(ctx: EngineTempoContext, numerator: number, denominator: number): void;
+export declare function setTimeSignatureSegments(ctx: EngineTempoContext, segments: readonly EngineTimeSignatureSegment[]): void;
+export declare function setLoop(ctx: EngineTempoContext, startPpq: number, endPpq: number, enabled?: boolean): boolean;
+export declare function countInEndSample(ctx: EngineTempoContext, startSample: number, bars: number): number;
+export declare function getTransportState(ctx: EngineTempoContext): Promise<EngineTransportState>;
+export declare function cachedTransportState(ctx: EngineTempoContext): EngineTransportState | undefined;
+export {};
+//# sourceMappingURL=engine-tempo-facade.d.ts.map

package/dist/worklet/engine-tempo-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-tempo-facade.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-tempo-facade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,UAAU,aAAa;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;IAChD,WAAW,CAAC,OAAO,EAAE;QACnB,IAAI,EAAE,uBAAuB,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;IACZ,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,WAAW,IAAI,MAAM,CAAC;IACtB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,IAAI,aAAa,CAAC;IAClC,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IACjD,gBAAgB,IAAI,kBAAkB,EAAE,CAAC;IACzC,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IACvD,wBAAwB,IAAI,0BAA0B,EAAE,CAAC;IACzD,wBAAwB,CAAC,QAAQ,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAAC;IACvE,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3D,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAAC;CAC7D;AAGD,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAS3D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GACtC,IAAI,CAMN;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EACvB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAKN;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,SAAS,0BAA0B,EAAE,GAC9C,IAAI,CASN;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,UAAO,GACb,OAAO,CAkBT;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EACvB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAI9F;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,SAAS,CAE9F"}