@libraz/libsonare 1.7.2 → 1.8.1

package/dist/worker_client.d.ts

@@ -0,0 +1,96 @@
+import { ErrorCode } from './errors';
+import type { MasterAudioRequest, MasterAudioStereoRequest } from './mastering_chain';
+import type { DetectChordsRequest, DetectKeyRequest, MusicAnalyzeRequest, SamplesRequest } from './quick_analysis';
+type WorkerRequest<T> = Omit<T, 'onProgress'>;
+/** Progress relayed from the Worker at the core's native progress boundaries. */
+export interface OfflineWorkerProgress {
+    progress: number;
+    stage: string;
+}
+/** Per-call behaviour for a one-shot operation. */
+export interface OfflineWorkerCallOptions {
+    /**
+     * Preserve the caller's input arrays by copying them before dispatch.
+     *
+     * The default is `false`: `Float32Array` buffers are transferred to the
+     * Worker and become detached on the calling thread, avoiding a second copy.
+     */
+    copy?: boolean;
+    /** Receives native progress boundaries for analysis and mastering calls. */
+    onProgress?: (update: OfflineWorkerProgress) => void;
+}
+/** Options used to create an {@link OfflineWorkerClient}. */
+export interface OfflineWorkerClientOptions {
+    /** Reuse a Worker owned by the host instead of creating one. */
+    worker?: OfflineWorker;
+    /** URL of the Worker entry; defaults to the adjacent published `worker.js`. */
+    workerUrl?: string | URL;
+    /** Test/host hook for creating a dedicated Worker. */
+    workerFactory?: (url: URL) => OfflineWorker;
+    /** Terminate a supplied Worker when {@link OfflineWorkerClient.dispose} runs. */
+    terminateWorkerOnDispose?: boolean;
+}
+/** Browser Worker or Node `worker_threads.Worker` used by the client. */
+export interface OfflineWorker {
+    postMessage(message: unknown, transfer?: Transferable[]): void;
+    terminate(): unknown;
+    addEventListener?(type: string, listener: EventListener): void;
+    removeEventListener?(type: string, listener: EventListener): void;
+    on?(type: 'message' | 'error', listener: (...args: unknown[]) => void): unknown;
+    off?(type: 'message' | 'error', listener: (...args: unknown[]) => void): unknown;
+}
+/**
+ * A cancellable promise returned by an {@link OfflineWorkerClient} call.
+ *
+ * It is Promise-like, so `await client.analyze(...)` works. Call `cancel()` to
+ * request cancellation at the next native progress boundary. In browsers this
+ * uses a `SharedArrayBuffer` flag, which requires cross-origin isolation for
+ * prompt cancellation while synchronous WASM is running. The worker forwards
+ * that flag through the same native cancellation callback used by synchronous
+ * one-shot requests.
+ */
+export declare class OfflineWorkerTask<T> implements PromiseLike<T> {
+    readonly result: Promise<T>;
+    private readonly cancelRequest;
+    constructor(result: Promise<T>, cancelRequest: () => void);
+    cancel(): void;
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<T | TResult>;
+    finally(onfinally?: (() => void) | null): Promise<T>;
+}
+/**
+ * Owns a dedicated Worker for value-based offline analysis and mastering.
+ *
+ * `Project`, `Mixer`, and realtime APIs are intentionally absent: their native
+ * handles are local to one JavaScript realm and cannot be transferred safely.
+ */
+export declare class OfflineWorkerClient {
+    private readonly worker;
+    private readonly ownsWorker;
+    private readonly pending;
+    private nextId;
+    private closed;
+    private usesEventTarget;
+    constructor(options?: OfflineWorkerClientOptions);
+    /** Dispatch full music analysis to the Worker. */
+    analyze(request: WorkerRequest<MusicAnalyzeRequest>, options?: OfflineWorkerCallOptions): OfflineWorkerTask<ReturnType<typeof import('./quick_analysis').analyze>>;
+    /** Dispatch BPM detection to the Worker. */
+    detectBpm(request: SamplesRequest, options?: OfflineWorkerCallOptions): OfflineWorkerTask<number>;
+    /** Dispatch key detection to the Worker. */
+    detectKey(request: DetectKeyRequest, options?: OfflineWorkerCallOptions): OfflineWorkerTask<ReturnType<typeof import('./quick_analysis').detectKey>>;
+    /** Dispatch chord detection to the Worker. */
+    detectChords(request: DetectChordsRequest, options?: OfflineWorkerCallOptions): OfflineWorkerTask<ReturnType<typeof import('./quick_analysis').detectChords>>;
+    /** Dispatch mono preset mastering to the Worker. */
+    masterAudio(request: WorkerRequest<MasterAudioRequest>, options?: OfflineWorkerCallOptions): OfflineWorkerTask<ReturnType<typeof import('./mastering_chain').masterAudio>>;
+    /** Dispatch stereo preset mastering to the Worker. */
+    masterAudioStereo(request: WorkerRequest<MasterAudioStereoRequest>, options?: OfflineWorkerCallOptions): OfflineWorkerTask<ReturnType<typeof import('./mastering_chain').masterAudioStereo>>;
+    /** Stop accepting calls, reject outstanding work, and release the Worker if owned. */
+    dispose(): void;
+    private call;
+    private readonly onMessage;
+    private readonly onError;
+    private readonly onNodeMessage;
+    private readonly onNodeError;
+}
+export { ErrorCode };
+//# sourceMappingURL=worker_client.d.ts.map

package/dist/worker_client.d.ts.map

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

package/dist/worker_protocol.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Internal structured-clone protocol for the offline Web Worker bridge.
+ *
+ * Keep this deliberately limited to one-shot operations. Embind handles own
+ * native resources and cannot safely cross a worker boundary.
+ */
+export type OfflineWorkerOperation = 'analyze' | 'detectBpm' | 'detectKey' | 'detectChords' | 'masterAudio' | 'masterAudioStereo';
+export interface OfflineWorkerRunMessage {
+    type: 'sonare:offline-run';
+    id: number;
+    operation: OfflineWorkerOperation;
+    request: Record<string, unknown>;
+    /** A shared flag lets cancellation reach synchronous WASM progress callbacks. */
+    cancelBuffer?: SharedArrayBuffer;
+}
+export interface OfflineWorkerCancelMessage {
+    type: 'sonare:offline-cancel';
+    id: number;
+}
+export type OfflineWorkerRequestMessage = OfflineWorkerRunMessage | OfflineWorkerCancelMessage;
+export interface OfflineWorkerProgressMessage {
+    type: 'sonare:offline-progress';
+    id: number;
+    progress: number;
+    stage: string;
+}
+export interface OfflineWorkerResultMessage {
+    type: 'sonare:offline-result';
+    id: number;
+    result: unknown;
+}
+export interface OfflineWorkerErrorMessage {
+    type: 'sonare:offline-error';
+    id: number;
+    error: {
+        name: string;
+        message: string;
+        code?: number;
+        codeName?: string;
+    };
+}
+export type OfflineWorkerResponseMessage = OfflineWorkerProgressMessage | OfflineWorkerResultMessage | OfflineWorkerErrorMessage;
+//# sourceMappingURL=worker_protocol.d.ts.map

package/dist/worker_protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker_protocol.d.ts","sourceRoot":"","sources":["../src/worker_protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,WAAW,GACX,WAAW,GACX,cAAc,GACd,aAAa,GACb,mBAAmB,CAAC;AAExB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iFAAiF;IACjF,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,2BAA2B,GAAG,uBAAuB,GAAG,0BAA0B,CAAC;AAE/F,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,yBAAyB,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,MAAM,4BAA4B,GACpC,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,CAAC"}

package/dist/worklet/audio_types.d.ts

@@ -0,0 +1,21 @@
+export type WorkletInput = readonly (readonly Float32Array[])[];
+export type WorkletOutput = Float32Array[][];
+/**
+ * Copies one plane per output channel. Shared by every worklet output — the
+ * engine's program and cue buses and the voice changer — so they cannot drift
+ * in their padding behaviour. Allocation-free.
+ *
+ * A host output wider than the engine's plane count is mapped the way Web Audio
+ * up-mixes rather than by padding with a copy of plane 0:
+ * - A single plane fans out to every output channel, so a mono engine driving a
+ *   stereo host stays centred instead of hard-panned left.
+ * - With two or more planes, an output channel past the last plane is silence.
+ *   Duplicating plane 0 into it would put the left signal in a rear or centre
+ *   channel and add correlated energy the engine never produced.
+ *
+ * Everything the source does not fill is zeroed — the tail past `frames`, and
+ * the remainder of a plane shorter than `frames` — so no sample of the previous
+ * block survives into this one.
+ */
+export declare function copyPlanesToOutput(output: Float32Array[], planes: readonly Float32Array[], frames: number): void;
+//# sourceMappingURL=audio_types.d.ts.map

package/dist/worklet/audio_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio_types.d.ts","sourceRoot":"","sources":["../../src/worklet/audio_types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,YAAY,EAAE,EAAE,CAAC;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,MAAM,EAAE,MAAM,GACb,IAAI,CAcN"}

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

@@ -0,0 +1,29 @@
+import type { EngineAutomationPoint, RealtimeEngine } from '../index';
+import type { SonareEngineSyncMessage } from './messages';
+/**
+ * Collaborator surface the automation-lane helpers need from the owning
+ * {@link SonareEngine}: the lane store they mutate, the offline engine they
+ * mirror into, the sync poster, and the parameter-id resolver.
+ */
+export interface EngineAutomationContext {
+    readonly offlineEngine: RealtimeEngine;
+    readonly automationLanes: Map<number, EngineAutomationPoint[]>;
+    postSync(message: SonareEngineSyncMessage): void;
+    resolveParamId(nodeId: string, param: string | number): number;
+}
+export declare function scheduleParam(ctx: EngineAutomationContext, nodeId: string, param: string | number, ppq: number, value: number, curve?: number | 'linear' | 'exponential'): void;
+export declare function addAutomationPoint(ctx: EngineAutomationContext, laneId: string | number, ppq: number, value: number, curve?: number | 'linear' | 'exponential'): void;
+/**
+ * Replaces the automation lane for `paramId` with the given breakpoints.
+ *
+ * Unlike scheduleParam (which appends a single point), this sets the whole
+ * lane at once; an empty array clears the lane. The points are defensively
+ * copied and sorted by ppq before being mirrored to the offline engine and
+ * the live worklet engine.
+ *
+ * @param paramId Automation target id (registered parameter or a reserved
+ *   engine mixer target from automationParamId/busAutomationParamId).
+ * @param points Lane breakpoints; order does not matter.
+ */
+export declare function setAutomationLane(ctx: EngineAutomationContext, paramId: number, points: ReadonlyArray<EngineAutomationPoint>): void;
+//# sourceMappingURL=engine-automation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-automation.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-automation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAChE;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,GAAG,QAAQ,GAAG,aAAwB,GAClD,IAAI,CAaN;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,GAAG,QAAQ,GAAG,aAAwB,GAClD,IAAI,CAEN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAC3C,IAAI,CASN"}

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

@@ -0,0 +1,35 @@
+import type { EngineCaptureStatus, RealtimeEngine } from '../index';
+import type { SonareRealtimeEngineNode } from './engine-node';
+import { type CaptureOptions } from './engine-offline';
+import type { SonareEngineSyncCaptureMessage, SonareEngineSyncMessage } from './messages';
+import { SonareEngineCommandType } from './protocol';
+type CaptureConfig = Omit<SonareEngineSyncCaptureMessage, 'type'>;
+/**
+ * Collaborator surface the capture/record/punch setters need from the owning
+ * {@link SonareEngine}: the offline engine they mirror into, the realtime node
+ * they command and query, the channel count, the out-of-band sync poster, the
+ * capture-config accessor, and the target-id resolver.
+ */
+export interface EngineCaptureContext {
+    readonly offlineEngine: RealtimeEngine;
+    readonly realtimeNode: SonareRealtimeEngineNode;
+    sendCommand(command: {
+        type: SonareEngineCommandType;
+        targetId?: number;
+        sampleTime?: number;
+        argFloat?: number;
+        argInt?: number;
+    }): boolean;
+    readonly offlineChannelCount: number;
+    postSync(message: SonareEngineSyncMessage): void;
+    getCaptureConfig(): CaptureConfig | undefined;
+    setCaptureConfig(config: CaptureConfig): void;
+}
+export declare function configureCapture(ctx: EngineCaptureContext, options: CaptureOptions): void;
+export declare function armRecord(ctx: EngineCaptureContext, trackId: string | number, enabled: boolean): boolean;
+export declare function punch(ctx: EngineCaptureContext, inPpq: number, outPpq: number): boolean;
+export declare function captureStatus(ctx: EngineCaptureContext): Promise<EngineCaptureStatus>;
+export declare function capturedAudio(ctx: EngineCaptureContext): Promise<Float32Array[]>;
+export declare function resetCapture(ctx: EngineCaptureContext): Promise<void>;
+export {};
+//# sourceMappingURL=engine-capture-facade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-capture-facade.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-capture-facade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,8BAA8B,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,KAAK,aAAa,GAAG,IAAI,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,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,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAAC;IAC9C,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC/C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAQzF;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,oBAAoB,EACzB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,EAAE,OAAO,GACf,OAAO,CAcT;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAevF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAErF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAEhF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E"}

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

@@ -0,0 +1,23 @@
+import type { EngineClip, EngineMidiClipSchedule, RealtimeEngine } from '../index';
+import type { ClipPageProvider } from '../realtime_engine';
+import type { SonareEngineSyncMessage } from './messages';
+/**
+ * Collaborator surface the audio/MIDI clip scheduling helpers need from the
+ * owning {@link SonareEngine}: the clip stores they mutate, the offline engine
+ * they mirror into, the sync poster, and the clip-id allocator / lane resolvers.
+ */
+export interface EngineClipContext {
+    readonly offlineEngine: RealtimeEngine;
+    readonly clips: Map<number, EngineClip>;
+    readonly midiClips: Map<number, EngineMidiClipSchedule>;
+    allocateClipId(): number;
+    postSync(message: SonareEngineSyncMessage, transfer?: Transferable[]): void;
+    resolveTargetId(target: string | number): number;
+    ensureTrackLane(target: string | number): number;
+    /** Commits a provider already primed through the worklet's OPFS pull bridge. */
+    commitWorkletClipPageProvider(clip: EngineClip): boolean;
+}
+export declare function addClip(ctx: EngineClipContext, trackId: string | number, buffer: Float32Array[] | ClipPageProvider, startPpq: number, opts?: Partial<Omit<EngineClip, 'channels' | 'pageProvider' | 'startPpq'>>): number;
+export declare function removeClip(ctx: EngineClipContext, clipId: number): void;
+export declare function setMidiClips(ctx: EngineClipContext, clips: readonly EngineMidiClipSchedule[]): void;
+//# sourceMappingURL=engine-clips.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-clips.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-clips.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACxD,cAAc,IAAI,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,uBAAuB,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC5E,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,gFAAgF;IAChF,6BAA6B,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;CAC1D;AAQD,wBAAgB,OAAO,CACrB,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,EACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC,CAAM,GAC7E,MAAM,CAaR;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGvE;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,SAAS,sBAAsB,EAAE,GACvC,IAAI,CAON"}

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

@@ -0,0 +1,40 @@
+import type { EngineMarker, RealtimeEngine } from '../index';
+import type { SonareEngineSyncMessage } from './messages';
+import { type SonareEngineCommandRecord } from './protocol';
+/**
+ * Collaborator surface the marker helpers need from the owning
+ * {@link SonareEngine}: the marker store and id counter, the offline engine they
+ * mirror into, the sync poster, the realtime command sender, and the loop setter.
+ */
+export interface EngineMarkerContext {
+    readonly offlineEngine: RealtimeEngine;
+    readonly markers: Map<number, EngineMarker>;
+    getNextMarkerId(): number;
+    setNextMarkerId(value: number): void;
+    postSync(message: SonareEngineSyncMessage): void;
+    sendCommand(command: SonareEngineCommandRecord): boolean;
+    setLoop(startPpq: number, endPpq: number, enabled: boolean): boolean;
+}
+export declare function addMarker(ctx: EngineMarkerContext, ppq: number, name?: string): number;
+/**
+ * Replaces the whole marker set in one call.
+ *
+ * Entries without an `id` are assigned fresh ids; entries carrying an `id`
+ * keep it (ids must be positive and unique within the list). Returns the
+ * resolved markers in the order given, so a caller can map its own marker
+ * identities to the engine ids used by `seekMarker`/`setLoopFromMarkers`.
+ *
+ * @param markers The full marker list (an empty list clears all markers).
+ * @returns The markers with their resolved engine ids.
+ */
+export declare function setMarkers(ctx: EngineMarkerContext, markers: ReadonlyArray<{
+    ppq: number;
+    name?: string;
+    id?: number;
+}>): EngineMarker[];
+export declare function markerCount(ctx: EngineMarkerContext): number;
+export declare function markerByIndex(ctx: EngineMarkerContext, index: number): EngineMarker;
+export declare function marker(ctx: EngineMarkerContext, markerId: number): EngineMarker;
+export declare function seekMarker(ctx: EngineMarkerContext, markerId: number): boolean;
+export declare function setLoopFromMarkers(ctx: EngineMarkerContext, startMarkerId: number, endMarkerId: number): boolean;
+//# sourceMappingURL=engine-markers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-markers.d.ts","sourceRoot":"","sources":["../../src/worklet/engine-markers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,KAAK,yBAAyB,EAA2B,MAAM,YAAY,CAAC;AAErF;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5C,eAAe,IAAI,MAAM,CAAC;IAC1B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,WAAW,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACzD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CACtE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAMlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClE,YAAY,EAAE,CAShB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAE5D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAEnF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAE/E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU9E;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,mBAAmB,EACxB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAKT"}

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

@@ -0,0 +1,164 @@
+import type { EngineBus, EngineTrackLane, EngineTrackSend, RealtimeEngine, SidechainSourceKind } from '../index';
+import type { SonareEngineSyncMessage } from './messages';
+/** A latest by-name insert value retained across a later topology replay. */
+export interface InsertParamOverride {
+    target: StripJsonTarget;
+    insertIndex: number;
+    paramName: string;
+    value: number;
+}
+export type InsertParamOverrideMap = Map<string, InsertParamOverride>;
+/**
+ * Collaborator surface the mixer/routing setters need from the owning
+ * {@link SonareEngine}: the offline engine they mirror writes into, the mutable
+ * routing stores (held by reference), the out-of-band sync poster, and the
+ * lane/bus declaration and mixer-sync helpers.
+ */
+export interface EngineMixerContext {
+    readonly offlineEngine: RealtimeEngine;
+    readonly trackLaneIds: number[];
+    readonly trackSends: Map<number, EngineTrackSend[]>;
+    readonly trackOutputBus: Map<number, number>;
+    readonly trackSourceChannelLayout: Map<number, number>;
+    readonly laneSidechains: Map<string, {
+        trackId: number;
+        insertIndex: number;
+        sourceTrackId: number;
+    }>;
+    readonly busSidechains: Map<string, {
+        busId: number;
+        insertIndex: number;
+        sourceKind: number;
+        sourceId: number;
+    }>;
+    readonly masterSidechains: Map<number, {
+        insertIndex: number;
+        sourceKind: number;
+        sourceId: number;
+    }>;
+    readonly buses: EngineBus[];
+    readonly trackStripJson: Map<number, string>;
+    readonly busStripJson: Map<number, string>;
+    readonly insertParamOverrides: InsertParamOverrideMap;
+    clearInsertAutomationLanes(target: StripJsonTarget, forgetResolvedIds?: boolean): void;
+    flushOfflineMirror(): void;
+    postSync(message: SonareEngineSyncMessage): void;
+    ensureTrackLane(target: string | number): number;
+    ensureBus(busId: number): number;
+    mixerLanes(): EngineTrackLane[];
+    syncMixer(insertBaseResets?: StripJsonTarget[], oneShotInsertParamOverrides?: InsertParamOverride[]): void;
+    sendSmoothedParam(paramId: number, value: number): boolean;
+    getMasterStripJson(): string | undefined;
+    cacheMasterStripJson(sceneJson: string): void;
+}
+/** Addresses one strip's cached scene JSON, the state a syncMixer re-post replays. */
+export type StripJsonTarget = {
+    kind: 'track';
+    trackId: number;
+} | {
+    kind: 'bus';
+    busId: number;
+} | {
+    kind: 'master';
+};
+/**
+ * Returns the insert identity used to decide whether native state can stay
+ * alive across a strip-scene update. Scalar strip fields are intentionally
+ * excluded. Track and master inserts use the native pre-then-post indexing;
+ * buses retain their scene order.
+ */
+export declare function decodedInsertSignature(sceneJson: string, target: StripJsonTarget): string;
+/** Builds one-shot restores for manual insert edits before their bookkeeping is forgotten. */
+export declare function constructionInsertOverrides(engine: RealtimeEngine, target: StripJsonTarget, overrides: InsertParamOverrideMap): InsertParamOverride[];
+/** Applies construction restores to the control-side mirror before posting them. */
+export declare function applyConstructionInsertOverrides(engine: RealtimeEngine, overrides: readonly InsertParamOverride[]): void;
+/** Clears the native manual parameter bases for one strip after a replacement. */
+export declare function clearInsertParameterBases(engine: RealtimeEngine, target: StripJsonTarget): void;
+/** An empty construction scene used only within an explicit strip replacement. */
+export declare function emptyStripJson(target: StripJsonTarget): string;
+/** Drop bindings whose insert was removed by an explicit scene replacement. */
+export declare function pruneStripSidechains(ctx: EngineMixerContext, target: StripJsonTarget, sceneJson: string): void;
+export declare function hasInsertParamOverrides(overrides: InsertParamOverrideMap, target: StripJsonTarget): boolean;
+/** Apply and validate one candidate scene without rebuilding it through an empty scene. */
+export declare function applyFullStripJson(engine: RealtimeEngine, target: StripJsonTarget, sceneJson: string): void;
+/** Builds a collision-safe key for one target/insert/parameter tuple. */
+export declare function insertParamOverrideKey(override: InsertParamOverride): string;
+/** Removes all retained insert values for one strip after a full scene replacement. */
+export declare function clearInsertParamOverrides(overrides: InsertParamOverrideMap, target: StripJsonTarget): void;
+/** Reads a strip's cached scene JSON; undefined when none was ever set. */
+export declare function cachedStripJson(ctx: EngineMixerContext, target: StripJsonTarget): string | undefined;
+/** Replaces a strip's cached scene JSON without syncing it. */
+export declare function cacheStripJson(ctx: EngineMixerContext, target: StripJsonTarget, sceneJson: string): void;
+/** Builds the engine's track-lane descriptors from the current routing stores. */
+export declare function mixerLanes(ctx: EngineMixerContext): EngineTrackLane[];
+/**
+ * Mirrors the current mixer routing into the offline engine and posts the full
+ * mixer-sync message (lanes, buses, strip JSON, sidechains) to the worklet.
+ */
+export declare function syncMixer(ctx: EngineMixerContext, busesAlreadyApplied?: boolean, insertBaseResets?: StripJsonTarget[], oneShotInsertParamOverrides?: InsertParamOverride[]): void;
+/**
+ * Reapplies retained by-name values after native topology setters clear their
+ * smoother slots. This runs once per mixer sync, never once per knob tick.
+ */
+export declare function replayInsertParamOverrides(ctx: EngineMixerContext, lanes?: EngineTrackLane[], buses?: EngineBus[]): void;
+/**
+ * Declares the mixer track lanes in an explicit order.
+ *
+ * Lane indices are append-only: once a track id occupies a lane, its index
+ * stays fixed for the engine's lifetime. The given list must therefore start
+ * with the already-declared lane ids in their current order and may only
+ * append new track ids after them. Entries carrying `sends` replace that
+ * track's send list; entries without `sends` leave existing sends untouched.
+ * The same omission rule preserves an existing source channel layout.
+ *
+ * @param lanes Track ids or lane descriptors in the desired lane order.
+ */
+export declare function setTrackLanes(ctx: EngineMixerContext, lanes: ReadonlyArray<number | EngineTrackLane>): void;
+/** Ensures a lane exists, committing it only after native routing accepts it. */
+export declare function ensureTrackLane(ctx: EngineMixerContext, target: string | number): number;
+/**
+ * Routes a track lane's post-fader output into a declared bus instead of
+ * the master mix (group/folder routing); busId 0 restores the master mix.
+ */
+export declare function setTrackOutputBus(ctx: EngineMixerContext, target: string | number, busId: number): void;
+/**
+ * Keys one insert of a lane strip from another lane's post-strip pre-fader
+ * audio (ducking/sidechainRouter inserts). sourceTarget null removes the
+ * binding.
+ */
+export declare function setLaneSidechain(ctx: EngineMixerContext, target: string | number, insertIndex: number, sourceTarget: string | number | null): void;
+/**
+ * Keys one insert of a bus strip from a track lane or another bus
+ * (ducking/sidechainRouter inserts). `sourceId` 0 removes the binding. The
+ * binding is cached for resync only once the engine has accepted it.
+ */
+export declare function setBusSidechain(ctx: EngineMixerContext, busId: number, insertIndex: number, kind: SidechainSourceKind | number, sourceId: number): void;
+/**
+ * Keys one insert of the master strip from a track lane or a bus. Same source
+ * rules as {@link setBusSidechain}.
+ */
+export declare function setMasterSidechain(ctx: EngineMixerContext, insertIndex: number, kind: SidechainSourceKind | number, sourceId: number): void;
+export declare function setSends(ctx: EngineMixerContext, target: string | number, sends: EngineTrackSend[]): void;
+export declare function setTrackBuses(ctx: EngineMixerContext, buses: EngineBus[]): void;
+export declare function setBusGain(ctx: EngineMixerContext, busId: number, db: number): boolean;
+/** Control-side state a strip-scene replacement reads and updates. */
+export interface StripSceneContext {
+    readonly offlineEngine: RealtimeEngine;
+    readonly insertParamOverrides: InsertParamOverrideMap;
+    clearInsertAutomationLanes(target: StripJsonTarget): void;
+}
+/**
+ * Applies a strip scene to the offline mirror and returns what the realtime
+ * sync must repeat: the targets whose manual insert bases it clears and the
+ * construction values it restores. A changed insert chain forgets manual edits;
+ * an equal chain with manual edits restores each edited parameter's
+ * construction value. Native state of equal inserts is kept either way.
+ */
+export declare function replaceStripScene(ctx: StripSceneContext, target: StripJsonTarget, previousJson: string | undefined, sceneJson: string): {
+    insertBaseResets: StripJsonTarget[];
+    constructionOverrides: InsertParamOverride[];
+};
+export declare function setBusStripJson(ctx: EngineMixerContext, busId: number, sceneJson: string): void;
+/** Applies a master strip scene while retaining native state for equal inserts. */
+export declare function setMasterStripJson(ctx: EngineMixerContext, sceneJson: string): void;
+//# sourceMappingURL=engine-mixer-facade.d.ts.map

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

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

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

@@ -0,0 +1,83 @@
+import type { EngineCaptureStatus, EngineTransportState } from '../index';
+import type { SonareEngineClipPageRequestMessage, SonareEngineSyncErrorMessage, SonareRealtimeEngineNodeCapabilities, SonareRealtimeEngineNodeOptions, SonareWorkletExternalMidiEvent } from './messages';
+import { type SonareClipPageRequestRingBuffer, type SonareEngineCommandRecord, type SonareEngineCommandRingBuffer, type SonareEngineTelemetryRecord, type SonareEngineTelemetryRingBuffer, type SonareExternalMidiRingBuffer, type SonareMeterRingBuffer, type SonareScopeRingBuffer, type SonareWorkletMeterSnapshot, type SonareWorkletScopeSnapshot } from './protocol';
+export declare class SonareRealtimeEngineNode {
+    readonly node: AudioWorkletNode;
+    readonly capabilities: SonareRealtimeEngineNodeCapabilities;
+    readonly commandRing?: SonareEngineCommandRingBuffer;
+    readonly telemetryRing?: SonareEngineTelemetryRingBuffer;
+    readonly meterRing?: SonareMeterRingBuffer;
+    readonly scopeRing?: SonareScopeRingBuffer;
+    readonly clipPageRequestRing?: SonareClipPageRequestRingBuffer;
+    readonly externalMidiRing?: SonareExternalMidiRingBuffer;
+    readonly ready: Promise<void>;
+    private telemetryReadIndex;
+    private meterReadIndex;
+    private scopeReadIndex;
+    private clipPageRequestDroppedRead;
+    private ringPollTimer;
+    private telemetryListeners;
+    private meterListeners;
+    private scopeListeners;
+    private midiOutListeners;
+    private clipPageRequestListeners;
+    private syncErrorListeners;
+    private captureRequestId;
+    private readonly captureRequests;
+    private transportRequestId;
+    private readonly transportRequests;
+    private resolveReady;
+    private rejectReady;
+    private destroyed;
+    private constructor();
+    /** Subscribes to control-plane sync rejections reported by the worklet. */
+    onSyncError(listener: (message: SonareEngineSyncErrorMessage) => void): () => void;
+    static create(context: BaseAudioContext, options?: SonareRealtimeEngineNodeOptions): Promise<SonareRealtimeEngineNode>;
+    play(sampleTime?: number): boolean;
+    /** Queues a reset of the master's integrated-loudness accumulator. */
+    resetMasterLoudnessMeter(sampleTime?: number): boolean;
+    stop(sampleTime?: number): boolean;
+    seekSample(timelineSample: number, sampleTime?: number): boolean;
+    seekPpq(ppq: number, sampleTime?: number): boolean;
+    sendCommand(command: SonareEngineCommandRecord): boolean;
+    requestCaptureStatus(): Promise<EngineCaptureStatus>;
+    requestCapturedAudio(): Promise<Float32Array[]>;
+    requestCaptureReset(): Promise<void>;
+    requestTransportState(): Promise<EngineTransportState>;
+    pollTelemetry(): SonareEngineTelemetryRecord[];
+    pollMeters(): SonareWorkletMeterSnapshot[];
+    pollScope(): SonareWorkletScopeSnapshot[];
+    /** Drain lowered MIDI-1 records from the SAB ring on the main thread. */
+    pollMidiOut(): SonareWorkletExternalMidiEvent[];
+    /**
+     * Drains bounded paged-clip misses from the SAB ring and forwards one batch
+     * to subscribers. In postMessage mode the legacy handler remains available,
+     * but that degraded path is not realtime-safe for OPFS streaming.
+     */
+    pollClipPageRequests(): SonareEngineClipPageRequestMessage | undefined;
+    onTelemetry(callback: (telemetry: SonareEngineTelemetryRecord) => void): () => void;
+    onMeter(callback: (meter: SonareWorkletMeterSnapshot) => void): () => void;
+    onScope(callback: (scope: SonareWorkletScopeSnapshot) => void): () => void;
+    /**
+     * Subscribe to external-MIDI batches drained from the engine (one call per
+     * render block that produced events), already lowered to MIDI 1.0 bytes for a
+     * Web MIDI output port. Returns an unsubscribe function.
+     */
+    onMidiOut(callback: (events: SonareWorkletExternalMidiEvent[]) => void): () => void;
+    /**
+     * Subscribe to bounded batches of paged-clip misses from the worklet. The
+     * callback runs on the main thread and may initiate asynchronous OPFS I/O.
+     */
+    onClipPageRequests(callback: (message: SonareEngineClipPageRequestMessage) => void): () => void;
+    destroy(): void;
+    private emitTelemetry;
+    private startRingPolling;
+    private stopRingPollingIfUnused;
+    private emitMeter;
+    private emitMidiOut;
+    private emitClipPageRequests;
+    private emitScope;
+    private sendCaptureRequest;
+    private sendTransportRequest;
+}
+//# sourceMappingURL=engine-node.d.ts.map

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

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