@opendaw/studio-adapters 0.0.6

package/README.md

@@ -0,0 +1 @@
+This package is part of the openDAW SDK

package/dist/AudioData.d.ts

@@ -0,0 +1,7 @@
+export type AudioData = {
+    sampleRate: number;
+    numberOfFrames: number;
+    numberOfChannels: number;
+    frames: ReadonlyArray<Float32Array>;
+};
+//# sourceMappingURL=AudioData.d.ts.map

package/dist/AudioData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioData.d.ts","sourceRoot":"","sources":["../src/AudioData.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CACtC,CAAA"}

package/dist/AudioData.js

@@ -0,0 +1 @@
+export {};

package/dist/AudioFileBoxAdapter.d.ts

@@ -0,0 +1,22 @@
+import { AudioFileBox } from "@opendaw/studio-boxes";
+import { Option, UUID } from "@opendaw/lib-std";
+import { Peaks } from "@opendaw/lib-fusion";
+import { AudioData } from "./AudioData";
+import { Address } from "@opendaw/lib-box";
+import { AudioLoader } from "./AudioLoader";
+import { BoxAdaptersContext } from "./BoxAdaptersContext";
+import { BoxAdapter } from "./BoxAdapter";
+export declare class AudioFileBoxAdapter implements BoxAdapter {
+    #private;
+    constructor(context: BoxAdaptersContext, box: AudioFileBox);
+    get box(): AudioFileBox;
+    get uuid(): UUID.Format;
+    get address(): Address;
+    get startInSeconds(): number;
+    get endInSeconds(): number;
+    get data(): Option<AudioData>;
+    get peaks(): Option<Peaks>;
+    getOrCreateAudioLoader(): AudioLoader;
+    terminate(): void;
+}
+//# sourceMappingURL=AudioFileBoxAdapter.d.ts.map

package/dist/AudioFileBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioFileBoxAdapter.d.ts","sourceRoot":"","sources":["../src/AudioFileBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAC,MAAM,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAA;AACrC,OAAO,EAAC,OAAO,EAAC,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AACzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AAEvC,qBAAa,mBAAoB,YAAW,UAAU;;gBAItC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,YAAY;IAK1D,IAAI,GAAG,IAAI,YAAY,CAAmB;IAC1C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAgC;IACvD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,cAAc,IAAI,MAAM,CAA6C;IACzE,IAAI,YAAY,IAAI,MAAM,CAA2C;IACrE,IAAI,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,CAA4C;IACzE,IAAI,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAA6C;IAEvE,sBAAsB,IAAI,WAAW;IAIrC,SAAS,IAAI,IAAI;CACpB"}

package/dist/AudioFileBoxAdapter.js

@@ -0,0 +1,19 @@
+export class AudioFileBoxAdapter {
+    #context;
+    #box;
+    constructor(context, box) {
+        this.#context = context;
+        this.#box = box;
+    }
+    get box() { return this.#box; }
+    get uuid() { return this.#box.address.uuid; }
+    get address() { return this.#box.address; }
+    get startInSeconds() { return this.#box.startInSeconds.getValue(); }
+    get endInSeconds() { return this.#box.endInSeconds.getValue(); }
+    get data() { return this.getOrCreateAudioLoader().data; }
+    get peaks() { return this.getOrCreateAudioLoader().peaks; }
+    getOrCreateAudioLoader() {
+        return this.#context.audioManager.getOrCreate(this.#box.address.uuid);
+    }
+    terminate() { }
+}

package/dist/AudioLoader.d.ts

@@ -0,0 +1,26 @@
+import { AudioData } from "./AudioData";
+import { Peaks } from "@opendaw/lib-fusion";
+import { Observer, Option, Subscription, unitValue, UUID } from "@opendaw/lib-std";
+export interface AudioLoaderManager {
+    getOrCreate(uuid: UUID.Format): AudioLoader;
+    invalidate(uuid: UUID.Format): void;
+}
+export interface AudioLoader {
+    readonly data: Option<AudioData>;
+    readonly peaks: Option<Peaks>;
+    readonly uuid: UUID.Format;
+    readonly state: AudioLoaderState;
+    subscribe(observer: Observer<AudioLoaderState>): Subscription;
+}
+export type AudioLoaderState = {
+    type: "idle";
+} | {
+    type: "progress";
+    progress: unitValue;
+} | {
+    type: "error";
+    reason: string;
+} | {
+    type: "loaded";
+};
+//# sourceMappingURL=AudioLoader.d.ts.map

package/dist/AudioLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioLoader.d.ts","sourceRoot":"","sources":["../src/AudioLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAA;AACrC,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAEhF,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,GAAG,WAAW,CAAA;IAC3C,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;CACtC;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAAA;CAChE;AAED,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA"}

package/dist/AudioLoader.js

@@ -0,0 +1 @@
+export {};

package/dist/AudioMetaData.d.ts

@@ -0,0 +1,8 @@
+export type AudioMetaData = {
+    name: string;
+    bpm: number;
+    duration: number;
+    sample_rate: number;
+    cloud?: boolean;
+};
+//# sourceMappingURL=AudioMetaData.d.ts.map

package/dist/AudioMetaData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioMetaData.d.ts","sourceRoot":"","sources":["../src/AudioMetaData.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA"}

package/dist/AudioMetaData.js

@@ -0,0 +1 @@
+export {};

package/dist/AudioSample.d.ts

@@ -0,0 +1,5 @@
+import { AudioMetaData } from "./AudioMetaData";
+export type AudioSample = {
+    uuid: string;
+} & AudioMetaData;
+//# sourceMappingURL=AudioSample.d.ts.map

package/dist/AudioSample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioSample.d.ts","sourceRoot":"","sources":["../src/AudioSample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAAA"}

package/dist/AudioSample.js

@@ -0,0 +1 @@
+export {};

package/dist/AutomatableParameterFieldAdapter.d.ts

@@ -0,0 +1,35 @@
+import { ControlSourceListener, Observer, Option, Parameter, StringMapping, StringResult, Subscription, Terminable, unitValue, ValueMapping } from "@opendaw/lib-std";
+import { ppqn } from "@opendaw/lib-dsp";
+import { Address, PrimitiveField, PrimitiveType, PrimitiveValues } from "@opendaw/lib-box";
+import { Pointers } from "@opendaw/studio-enums";
+import { TrackBoxAdapter } from "./timeline/TrackBoxAdapter";
+import { BoxAdaptersContext } from "./BoxAdaptersContext";
+export declare class AutomatableParameterFieldAdapter<T extends PrimitiveValues = any> implements Parameter<T>, Terminable {
+    #private;
+    constructor(context: BoxAdaptersContext, field: PrimitiveField<T, any>, valueMapping: ValueMapping<T>, stringMapping: StringMapping<T>, name: string, anchor?: unitValue);
+    registerMidiControl(): Terminable;
+    get field(): PrimitiveField<T, Pointers.Automation>;
+    get valueMapping(): ValueMapping<T>;
+    get stringMapping(): StringMapping<T>;
+    get name(): string;
+    get anchor(): unitValue;
+    get type(): PrimitiveType;
+    get address(): Address;
+    get track(): Option<TrackBoxAdapter>;
+    valueAt(position: ppqn): T;
+    subscribe(observer: Observer<AutomatableParameterFieldAdapter<T>>): Subscription;
+    catchupAndSubscribe(observer: Observer<AutomatableParameterFieldAdapter<T>>): Subscription;
+    catchupAndSubscribeControlSources(observer: ControlSourceListener): Subscription;
+    getValue(): T;
+    setValue(value: T): void;
+    setUnitValue(value: unitValue): void;
+    getUnitValue(): unitValue;
+    getControlledValue(): T;
+    getControlledUnitValue(): unitValue;
+    getControlledPrintValue(): Readonly<StringResult>;
+    getPrintValue(): Readonly<StringResult>;
+    setPrintValue(text: string): void;
+    reset(): void;
+    terminate(): void;
+}
+//# sourceMappingURL=AutomatableParameterFieldAdapter.d.ts.map

package/dist/AutomatableParameterFieldAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutomatableParameterFieldAdapter.d.ts","sourceRoot":"","sources":["../src/AutomatableParameterFieldAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,qBAAqB,EAIrB,QAAQ,EACR,MAAM,EAEN,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EAEV,SAAS,EACT,YAAY,EACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAA;AACrC,OAAO,EAAC,OAAO,EAA8B,cAAc,EAAE,aAAa,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAA;AACpH,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAE9C,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AAQvD,qBAAa,gCAAgC,CAAC,CAAC,SAAS,eAAe,GAAG,GAAG,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU;;gBAiBlG,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,EAC7B,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAC7B,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,SAAS;IAwD9B,mBAAmB,IAAI,UAAU;IAWjC,IAAI,KAAK,IAAI,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAqB;IACxE,IAAI,YAAY,IAAI,YAAY,CAAC,CAAC,CAAC,CAA4B;IAC/D,IAAI,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,CAA6B;IAClE,IAAI,IAAI,IAAI,MAAM,CAAoB;IACtC,IAAI,MAAM,IAAI,SAAS,CAAsB;IAC7C,IAAI,IAAI,IAAI,aAAa,CAA0B;IACnD,IAAI,OAAO,IAAI,OAAO,CAA6B;IACnD,IAAI,KAAK,IAAI,MAAM,CAAC,eAAe,CAAC,CAA+B;IAEnE,OAAO,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC;IAW1B,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY;IAEhF,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY;IAK1F,iCAAiC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,YAAY;IAMhF,QAAQ,IAAI,CAAC;IACb,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IACpC,YAAY,IAAI,SAAS;IACzB,kBAAkB,IAAI,CAAC;IACvB,sBAAsB,IAAI,SAAS;IACnC,uBAAuB,IAAI,QAAQ,CAAC,YAAY,CAAC;IACjD,aAAa,IAAI,QAAQ,CAAC,YAAY,CAAC;IACvC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWjC,KAAK,IAAI,IAAI;IAEb,SAAS,IAAI,IAAI;CAKpB"}

package/dist/AutomatableParameterFieldAdapter.js

@@ -0,0 +1,161 @@
+import { assert, clamp, Listeners, Notifier, Option, panic, Terminator } from "@opendaw/lib-std";
+import { Pointers } from "@opendaw/studio-enums";
+import { TrackBoxAdapter } from "./timeline/TrackBoxAdapter";
+const ExternalControlTypes = [
+    Pointers.Automation,
+    Pointers.Modulation,
+    Pointers.MidiControl,
+    Pointers.ParameterController
+];
+export class AutomatableParameterFieldAdapter {
+    #context;
+    #field;
+    #valueMapping;
+    #stringMapping;
+    #name;
+    #anchor;
+    #terminator = new Terminator();
+    #valueChangeNotifier;
+    #controlSource;
+    #trackBoxAdapter = Option.None;
+    #automationHandle = Option.None;
+    #controlledValue = null;
+    #midiControlled = false;
+    constructor(context, field, valueMapping, stringMapping, name, anchor) {
+        this.#context = context;
+        this.#field = field;
+        this.#valueMapping = valueMapping;
+        this.#stringMapping = stringMapping;
+        this.#name = name;
+        this.#anchor = anchor ?? 0.0;
+        this.#terminator.own(this.#context.parameterFieldAdapters.register(this));
+        this.#valueChangeNotifier = this.#terminator.own(new Notifier());
+        this.#controlSource = new Listeners();
+        this.#terminator.own(this.#field.subscribe(() => this.#valueChangeNotifier.notify(this)));
+        this.#terminator.own(this.#field.pointerHub.catchupAndSubscribeTransactual({
+            onAdd: (pointer) => {
+                this.#controlSource.proxy.onControlSourceAdd(mapPointerToControlSource(pointer.pointerType));
+                pointer.box.accept({
+                    visitTrackBox: (box) => {
+                        assert(this.#trackBoxAdapter.isEmpty(), "Already assigned");
+                        const adapter = this.#context.boxAdapters.adapterFor(box, TrackBoxAdapter);
+                        this.#trackBoxAdapter = Option.wrap(adapter);
+                        if (this.#context.isMainThread) {
+                            this.#automationHandle = Option.wrap(this.#context.liveStreamReceiver
+                                .subscribeFloat(this.#field.address, value => {
+                                if (this.#controlledValue === value) {
+                                    return;
+                                }
+                                this.#controlledValue = value;
+                                this.#valueChangeNotifier.notify(this);
+                            }));
+                        }
+                    }
+                });
+            },
+            onRemove: (pointer) => {
+                this.#controlSource.proxy.onControlSourceRemove(mapPointerToControlSource(pointer.pointerType));
+                pointer.box.accept({
+                    visitTrackBox: (box) => {
+                        assert(this.#trackBoxAdapter.unwrapOrNull()?.address?.equals(box.address) === true, `Unknown ${box}`);
+                        this.#trackBoxAdapter = Option.None;
+                        if (this.#context.isMainThread) {
+                            this.#automationHandle.ifSome(handle => handle.terminate());
+                            this.#automationHandle = Option.None;
+                            this.#controlledValue = null;
+                            this.#valueChangeNotifier.notify(this);
+                        }
+                    }
+                });
+            }
+        }, ...ExternalControlTypes));
+        /*
+        For debugging: It's not live because floating errors expose false positives,
+            and I am too lazy to implement this in the mappings itself.
+        */
+        if (field.getValue() !== valueMapping.clamp(field.getValue())) {
+            console.warn(`${name} (${field.getValue()}) is out of bounds`, valueMapping);
+        }
+    }
+    registerMidiControl() {
+        this.#controlSource.proxy.onControlSourceAdd("midi");
+        this.#midiControlled = true;
+        return {
+            terminate: () => {
+                this.#midiControlled = false;
+                this.#controlSource.proxy.onControlSourceRemove("midi");
+            }
+        };
+    }
+    get field() { return this.#field; }
+    get valueMapping() { return this.#valueMapping; }
+    get stringMapping() { return this.#stringMapping; }
+    get name() { return this.#name; }
+    get anchor() { return this.#anchor; }
+    get type() { return this.#field.type; }
+    get address() { return this.#field.address; }
+    get track() { return this.#trackBoxAdapter; }
+    valueAt(position) {
+        const optTrack = this.#trackBoxAdapter;
+        if (optTrack.nonEmpty()) {
+            const track = optTrack.unwrap();
+            if (track.enabled) {
+                return this.valueMapping.y(track.valueAt(position, this.getUnitValue()));
+            }
+        }
+        return this.getValue();
+    }
+    subscribe(observer) { return this.#valueChangeNotifier.subscribe(observer); }
+    catchupAndSubscribe(observer) {
+        observer(this);
+        return this.subscribe(observer);
+    }
+    catchupAndSubscribeControlSources(observer) {
+        if (this.#midiControlled) {
+            observer.onControlSourceAdd("midi");
+        }
+        this.#field.pointerHub.filter(...ExternalControlTypes)
+            .forEach(pointer => observer.onControlSourceAdd(mapPointerToControlSource(pointer.pointerType)));
+        return this.#controlSource.subscribe(observer);
+    }
+    getValue() { return this.#field.getValue(); }
+    setValue(value) { this.#field.setValue(value); }
+    setUnitValue(value) { this.setValue(this.#valueMapping.y(value)); }
+    getUnitValue() { return this.#valueMapping.x(this.getValue()); }
+    getControlledValue() { return this.#valueMapping.y(this.getControlledUnitValue()); }
+    getControlledUnitValue() { return this.#controlledValue ?? this.getUnitValue(); }
+    getControlledPrintValue() { return this.#stringMapping.x(this.getControlledValue()); }
+    getPrintValue() { return this.#stringMapping.x(this.getValue()); }
+    setPrintValue(text) {
+        const result = this.#stringMapping.y(text);
+        if (result.type === "unitValue") {
+            this.setUnitValue(clamp(result.value, 0.0, 1.0));
+        }
+        else if (result.type === "explicit") {
+            this.setValue(this.valueMapping.clamp(result.value));
+        }
+        else {
+            console.debug(`Unknown text input: '${result.value}'`);
+        }
+    }
+    reset() { this.setValue(this.#valueMapping.clamp(this.#field.initValue)); }
+    terminate() {
+        this.#automationHandle.ifSome(handle => handle.terminate());
+        this.#automationHandle = Option.None;
+        this.#terminator.terminate();
+    }
+}
+const mapPointerToControlSource = (pointer) => {
+    switch (pointer) {
+        case Pointers.Automation:
+            return "automated";
+        case Pointers.Modulation:
+            return "modulated";
+        case Pointers.MidiControl:
+            return "midi";
+        case Pointers.ParameterController:
+            return "external";
+        default:
+            return panic(`${pointer.toString()} is an unknown pointer type`);
+    }
+};

package/dist/BoxAdapter.d.ts

@@ -0,0 +1,7 @@
+import { Terminable, UUID } from "@opendaw/lib-std";
+import { Addressable, Box } from "@opendaw/lib-box";
+export interface BoxAdapter extends Addressable, Terminable {
+    get box(): Box;
+    get uuid(): UUID.Format;
+}
+//# sourceMappingURL=BoxAdapter.d.ts.map

package/dist/BoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxAdapter.d.ts","sourceRoot":"","sources":["../src/BoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAC,WAAW,EAAE,GAAG,EAAC,MAAM,kBAAkB,CAAA;AAEjD,MAAM,WAAW,UAAW,SAAQ,WAAW,EAAE,UAAU;IACvD,IAAI,GAAG,IAAI,GAAG,CAAA;IACd,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAA;CAC1B"}

package/dist/BoxAdapter.js

@@ -0,0 +1 @@
+export {};

package/dist/BoxAdapterCollection.d.ts

@@ -0,0 +1,19 @@
+import { Func, int, Subscription, Terminable } from "@opendaw/lib-std";
+import { Box, PointerHub } from "@opendaw/lib-box";
+import { Pointers } from "@opendaw/studio-enums";
+import { BoxAdapter } from "./BoxAdapter";
+export interface AdapterCollectionListener<ADAPTER extends BoxAdapter> {
+    onAdd(adapter: ADAPTER): void;
+    onRemove(adapter: ADAPTER): void;
+}
+export declare class BoxAdapterCollection<ADAPTER extends BoxAdapter> implements Terminable {
+    #private;
+    constructor(pointerHub: PointerHub, provider: Func<Box, ADAPTER>, pointers: Pointers);
+    subscribe(listener: AdapterCollectionListener<ADAPTER>): Subscription;
+    catchupAndSubscribe(listener: AdapterCollectionListener<ADAPTER>): Subscription;
+    adapters(): ReadonlyArray<ADAPTER>;
+    size(): int;
+    isEmpty(): boolean;
+    terminate(): void;
+}
+//# sourceMappingURL=BoxAdapterCollection.d.ts.map

package/dist/BoxAdapterCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxAdapterCollection.d.ts","sourceRoot":"","sources":["../src/BoxAdapterCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,IAAI,EAAE,GAAG,EAAwB,YAAY,EAAE,UAAU,EAAO,MAAM,kBAAkB,CAAA;AACxG,OAAO,EAAC,GAAG,EAAgB,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AAEvC,MAAM,WAAW,yBAAyB,CAAC,OAAO,SAAS,UAAU;IACjE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CACnC;AAED,qBAAa,oBAAoB,CAAC,OAAO,SAAS,UAAU,CAAE,YAAW,UAAU;;gBAKnE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ;IAiBpF,SAAS,CAAC,QAAQ,EAAE,yBAAyB,CAAC,OAAO,CAAC,GAAG,YAAY;IAErE,mBAAmB,CAAC,QAAQ,EAAE,yBAAyB,CAAC,OAAO,CAAC,GAAG,YAAY;IAK/E,QAAQ,IAAI,aAAa,CAAC,OAAO,CAAC;IAClC,IAAI,IAAI,GAAG;IACX,OAAO,IAAI,OAAO;IAElB,SAAS,IAAI,IAAI;CAKpB"}

package/dist/BoxAdapterCollection.js

@@ -0,0 +1,35 @@
+import { assert, Listeners, UUID } from "@opendaw/lib-std";
+export class BoxAdapterCollection {
+    #entries;
+    #listeners;
+    #subscription;
+    constructor(pointerHub, provider, pointers) {
+        this.#entries = UUID.newSet(adapter => adapter.uuid);
+        this.#listeners = new Listeners();
+        this.#subscription = pointerHub.catchupAndSubscribeTransactual({
+            onAdd: (pointer) => {
+                const adapter = provider(pointer.box);
+                const added = this.#entries.add(adapter);
+                assert(added, `Could not add ${adapter}`);
+                this.#listeners.proxy.onAdd(adapter);
+            },
+            onRemove: (pointer) => {
+                const uuid = pointer.box.address.uuid;
+                this.#listeners.proxy.onRemove(this.#entries.removeByKey(uuid));
+            }
+        }, pointers);
+    }
+    subscribe(listener) { return this.#listeners.subscribe(listener); }
+    catchupAndSubscribe(listener) {
+        this.#entries.forEach(adapter => listener.onAdd(adapter));
+        return this.subscribe(listener);
+    }
+    adapters() { return this.#entries.values(); }
+    size() { return this.#entries.size(); }
+    isEmpty() { return this.size() === 0; }
+    terminate() {
+        this.#entries.clear();
+        this.#listeners.terminate();
+        this.#subscription.terminate();
+    }
+}

package/dist/BoxAdapters.d.ts

@@ -0,0 +1,11 @@
+import { AssertType, Class, Terminable } from "@opendaw/lib-std";
+import { Box } from "@opendaw/lib-box";
+import { BoxAdaptersContext } from "./BoxAdaptersContext";
+import { BoxAdapter } from "./BoxAdapter";
+export declare class BoxAdapters implements Terminable {
+    #private;
+    constructor(context: BoxAdaptersContext);
+    terminate(): void;
+    adapterFor<BOX extends Box, T extends BoxAdapter>(box: BOX, checkType: Class<T> | AssertType<T>): T;
+}
+//# sourceMappingURL=BoxAdapters.d.ts.map

package/dist/BoxAdapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxAdapters.d.ts","sourceRoot":"","sources":["../src/BoxAdapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,UAAU,EAAE,KAAK,EAA6C,UAAU,EAAO,MAAM,kBAAkB,CAAA;AAClI,OAAO,EAAC,GAAG,EAAS,MAAM,kBAAkB,CAAA;AAwF5C,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AAIvC,qBAAa,WAAY,YAAW,UAAU;;gBAO9B,OAAO,EAAE,kBAAkB;IAkBvC,SAAS,IAAI,IAAI;IAMjB,UAAU,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;CA8DtG"}

package/dist/BoxAdapters.js

@@ -0,0 +1,129 @@
+import { asDefined, assert, isDefined, panic, UUID } from "@opendaw/lib-std";
+import { AudioUnitBoxAdapter } from "./audio-unit/AudioUnitBoxAdapter";
+import { DelayDeviceBoxAdapter } from "./devices/audio-effects/DelayDeviceBoxAdapter";
+import { ReverbDeviceBoxAdapter } from "./devices/audio-effects/ReverbDeviceBoxAdapter";
+import { RevampDeviceBoxAdapter } from "./devices/audio-effects/RevampDeviceBoxAdapter";
+import { AudioFileBoxAdapter } from "./AudioFileBoxAdapter";
+import { AudioRegionBoxAdapter } from "./timeline/region/AudioRegionBoxAdapter";
+import { TimelineBoxAdapter } from "./timeline/TimelineBoxAdapter";
+import { MarkerBoxAdapter } from "./timeline/MarkerBoxAdapter";
+import { ModularAdapter } from "./modular/modular";
+import { ModuleDelayAdapter } from "./modular/modules/delay";
+import { ModuleMultiplierAdapter } from "./modular/modules/multiplier";
+import { ModuleConnectionAdapter } from "./modular/connection";
+import { ModularAudioOutputAdapter } from "./modular/modules/audio-output";
+import { ModularAudioInputAdapter } from "./modular/modules/audio-input";
+import { ModularDeviceBoxAdapter } from "./devices/audio-effects/ModularDeviceBoxAdapter";
+import { DeviceInterfaceKnobAdapter } from "./modular/user-interface";
+import { ModuleGainAdapter } from "./modular/modules/gain";
+import { AudioBusBoxAdapter } from "./audio-unit/AudioBusBoxAdapter";
+import { AuxSendBoxAdapter } from "./audio-unit/AuxSendBoxAdapter";
+import { RootBoxAdapter } from "./RootBoxAdapter";
+import { NoteEventBoxAdapter } from "./timeline/event/NoteEventBoxAdapter";
+import { NoteRegionBoxAdapter } from "./timeline/region/NoteRegionBoxAdapter";
+import { NoteEventCollectionBoxAdapter } from "./timeline/collection/NoteEventCollectionBoxAdapter";
+import { ValueEventBoxAdapter } from "./timeline/event/ValueEventBoxAdapter";
+import { ValueRegionBoxAdapter } from "./timeline/region/ValueRegionBoxAdapter";
+import { ValueEventCollectionBoxAdapter } from "./timeline/collection/ValueEventCollectionBoxAdapter";
+import { NoteClipBoxAdapter } from "./timeline/clip/NoteClipBoxAdapter";
+import { AudioClipBoxAdapter } from "./timeline/clip/AudioClipBoxAdapter";
+import { ValueClipBoxAdapter } from "./timeline/clip/ValueClipBoxAdapter";
+import { TrackBoxAdapter } from "./timeline/TrackBoxAdapter";
+import { TapeDeviceBoxAdapter } from "./devices/instruments/TapeDeviceBoxAdapter";
+import { VaporisateurDeviceBoxAdapter } from "./devices/instruments/VaporisateurDeviceBoxAdapter";
+import { ArpeggioDeviceBoxAdapter } from "./devices/midi-effects/ArpeggioDeviceBoxAdapter";
+import { PitchDeviceBoxAdapter } from "./devices/midi-effects/PitchDeviceBoxAdapter";
+import { NanoDeviceBoxAdapter } from "./devices/instruments/NanoDeviceBoxAdapter";
+import { PlayfieldDeviceBoxAdapter } from "./devices/instruments/PlayfieldDeviceBoxAdapter";
+import { StereoToolDeviceBoxAdapter } from "./devices/audio-effects/StereoToolDeviceBoxAdapter";
+import { PlayfieldSampleBoxAdapter } from "./devices/instruments/Playfield/PlayfieldSampleBoxAdapter";
+import { ZeitgeistDeviceBoxAdapter } from "./devices/midi-effects/ZeitgeistDeviceBoxAdapter";
+import { GrooveShuffleBoxAdapter } from "./grooves/GrooveShuffleBoxAdapter";
+export class BoxAdapters {
+    #context;
+    #adapters;
+    #deleted;
+    #terminable;
+    constructor(context) {
+        this.#context = context;
+        this.#adapters = UUID.newSet(adapter => adapter.uuid);
+        this.#deleted = new Set();
+        this.#terminable = this.#context.boxGraph.subscribeToAllUpdates({
+            onUpdate: (update) => {
+                if (update.type === "delete") {
+                    const adapter = this.#adapters.getOrNull(update.uuid);
+                    if (isDefined(adapter)) {
+                        this.#deleted.add(adapter.box);
+                        this.#adapters.removeByValue(adapter).terminate();
+                    }
+                }
+            }
+        });
+    }
+    terminate() {
+        this.#adapters.values().forEach(adapter => adapter.terminate());
+        this.#adapters.clear();
+        this.#terminable.terminate();
+    }
+    adapterFor(box, checkType) {
+        if (this.#deleted.has(box)) {
+            return panic(`Cannot resolve adapter for already deleted box: ${box}`);
+        }
+        let adapter = this.#adapters.getOrNull(box.address.uuid);
+        if (adapter === null) {
+            adapter = this.#create(box);
+            const added = this.#adapters.add(adapter);
+            assert(added, `Could not add adapter for ${box}`);
+        }
+        if (typeof checkType === "function") {
+            return Object.hasOwn(checkType, "prototype")
+                ? adapter instanceof checkType ? adapter : panic(`${adapter} is not instance of ${checkType}`)
+                : checkType(adapter) ? adapter : panic(`${adapter} did not pass custom type guard`);
+        }
+        return panic("Unknown checkType method");
+    }
+    #create(unknownBox) {
+        return asDefined(unknownBox.accept({
+            visitRootBox: (box) => new RootBoxAdapter(this.#context, box),
+            visitArpeggioDeviceBox: (box) => new ArpeggioDeviceBoxAdapter(this.#context, box),
+            visitPitchDeviceBox: (box) => new PitchDeviceBoxAdapter(this.#context, box),
+            visitStereoToolDeviceBox: (box) => new StereoToolDeviceBoxAdapter(this.#context, box),
+            visitDelayDeviceBox: (box) => new DelayDeviceBoxAdapter(this.#context, box),
+            visitReverbDeviceBox: (box) => new ReverbDeviceBoxAdapter(this.#context, box),
+            visitRevampDeviceBox: (box) => new RevampDeviceBoxAdapter(this.#context, box),
+            visitPlayfieldDeviceBox: (box) => new PlayfieldDeviceBoxAdapter(this.#context, box),
+            visitPlayfieldSampleBox: (box) => new PlayfieldSampleBoxAdapter(this.#context, box),
+            visitModularDeviceBox: (box) => new ModularDeviceBoxAdapter(this.#context, box),
+            visitTapeDeviceBox: (box) => new TapeDeviceBoxAdapter(this.#context, box),
+            visitNanoDeviceBox: (box) => new NanoDeviceBoxAdapter(this.#context, box),
+            visitVaporisateurDeviceBox: (box) => new VaporisateurDeviceBoxAdapter(this.#context, box),
+            visitModularBox: (box) => new ModularAdapter(this.#context, box),
+            visitModuleConnectionBox: (box) => new ModuleConnectionAdapter(this.#context, box),
+            visitModuleDelayBox: (box) => new ModuleDelayAdapter(this.#context, box),
+            visitModuleGainBox: (box) => new ModuleGainAdapter(this.#context, box),
+            visitModuleMultiplierBox: (box) => new ModuleMultiplierAdapter(this.#context, box),
+            visitModularAudioInputBox: (box) => new ModularAudioInputAdapter(this.#context, box),
+            visitModularAudioOutputBox: (box) => new ModularAudioOutputAdapter(this.#context, box),
+            visitDeviceInterfaceKnobBox: (box) => new DeviceInterfaceKnobAdapter(this.#context, box),
+            visitAudioUnitBox: (box) => new AudioUnitBoxAdapter(this.#context, box),
+            visitAudioBusBox: (box) => new AudioBusBoxAdapter(this.#context, box),
+            visitAuxSendBox: (box) => new AuxSendBoxAdapter(this.#context, box),
+            visitAudioFileBox: (box) => new AudioFileBoxAdapter(this.#context, box),
+            visitAudioClipBox: (box) => new AudioClipBoxAdapter(this.#context, box),
+            visitAudioRegionBox: (box) => new AudioRegionBoxAdapter(this.#context, box),
+            visitNoteEventBox: (box) => new NoteEventBoxAdapter(this.#context, box),
+            visitNoteEventCollectionBox: (box) => new NoteEventCollectionBoxAdapter(this.#context, box),
+            visitNoteClipBox: (box) => new NoteClipBoxAdapter(this.#context, box),
+            visitNoteRegionBox: (box) => new NoteRegionBoxAdapter(this.#context, box),
+            visitValueEventBox: (box) => new ValueEventBoxAdapter(this.#context, box),
+            visitValueEventCollectionBox: (box) => new ValueEventCollectionBoxAdapter(this.#context, box),
+            visitValueClipBox: (box) => new ValueClipBoxAdapter(this.#context, box),
+            visitValueRegionBox: (box) => new ValueRegionBoxAdapter(this.#context, box),
+            visitTrackBox: (box) => new TrackBoxAdapter(this.#context, box),
+            visitTimelineBox: (box) => new TimelineBoxAdapter(this.#context, box),
+            visitMarkerBox: (box) => new MarkerBoxAdapter(this.#context, box),
+            visitZeitgeistDeviceBox: (box) => new ZeitgeistDeviceBoxAdapter(this.#context, box),
+            visitGrooveShuffleBox: (box) => new GrooveShuffleBoxAdapter(this.#context, box)
+        }), `Could not find factory for ${unknownBox}`);
+    }
+}

package/dist/BoxAdaptersContext.d.ts

@@ -0,0 +1,24 @@
+import { Terminable } from "@opendaw/lib-std";
+import { BoxGraph } from "@opendaw/lib-box";
+import { LiveStreamBroadcaster, LiveStreamReceiver } from "@opendaw/lib-fusion";
+import { AudioLoaderManager } from "./AudioLoader";
+import { RootBoxAdapter } from "./RootBoxAdapter";
+import { TimelineBoxAdapter } from "./timeline/TimelineBoxAdapter";
+import { ClipSequencing } from "./ClipSequencing";
+import { ParameterFieldAdapters } from "./ParameterFieldAdapters";
+import { BoxAdapters } from "./BoxAdapters";
+export interface BoxAdaptersContext extends Terminable {
+    get boxGraph(): BoxGraph;
+    get boxAdapters(): BoxAdapters;
+    get audioManager(): AudioLoaderManager;
+    get rootBoxAdapter(): RootBoxAdapter;
+    get timelineBoxAdapter(): TimelineBoxAdapter;
+    get liveStreamReceiver(): LiveStreamReceiver;
+    get liveStreamBroadcaster(): LiveStreamBroadcaster;
+    get clipSequencing(): ClipSequencing;
+    get parameterFieldAdapters(): ParameterFieldAdapters;
+    get bpm(): number;
+    get isMainThread(): boolean;
+    get isAudioContext(): boolean;
+}
+//# sourceMappingURL=BoxAdaptersContext.d.ts.map

package/dist/BoxAdaptersContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxAdaptersContext.d.ts","sourceRoot":"","sources":["../src/BoxAdaptersContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAC,qBAAqB,EAAE,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAC7E,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAA;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAEzC,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IAClD,IAAI,QAAQ,IAAI,QAAQ,CAAA;IACxB,IAAI,WAAW,IAAI,WAAW,CAAA;IAC9B,IAAI,YAAY,IAAI,kBAAkB,CAAA;IACtC,IAAI,cAAc,IAAI,cAAc,CAAA;IACpC,IAAI,kBAAkB,IAAI,kBAAkB,CAAA;IAC5C,IAAI,kBAAkB,IAAI,kBAAkB,CAAA;IAC5C,IAAI,qBAAqB,IAAI,qBAAqB,CAAA;IAClD,IAAI,cAAc,IAAI,cAAc,CAAA;IACpC,IAAI,sBAAsB,IAAI,sBAAsB,CAAA;IACpD,IAAI,GAAG,IAAI,MAAM,CAAA;IACjB,IAAI,YAAY,IAAI,OAAO,CAAA;IAC3B,IAAI,cAAc,IAAI,OAAO,CAAA;CAChC"}

package/dist/BoxAdaptersContext.js

@@ -0,0 +1 @@
+export {};

package/dist/ClipNotifications.d.ts

@@ -0,0 +1,14 @@
+import { UUID } from "@opendaw/lib-std";
+export type ClipSequencingUpdates = {
+    started: ReadonlyArray<UUID.Format>;
+    stopped: ReadonlyArray<UUID.Format>;
+    obsolete: ReadonlyArray<UUID.Format>;
+};
+export type ClipNotification = {
+    type: "sequencing";
+    changes: ClipSequencingUpdates;
+} | {
+    type: "waiting";
+    clips: ReadonlyArray<UUID.Format>;
+};
+//# sourceMappingURL=ClipNotifications.d.ts.map

package/dist/ClipNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipNotifications.d.ts","sourceRoot":"","sources":["../src/ClipNotifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAErC,MAAM,MAAM,qBAAqB,GAAG;IAChC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACnC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,qBAAqB,CAAA;CACjC,GAAG;IACA,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;CACpC,CAAA"}

package/dist/ClipNotifications.js

@@ -0,0 +1 @@
+export {};

package/dist/ClipSequencing.d.ts

@@ -0,0 +1,12 @@
+import { Option, Terminable, UUID } from "@opendaw/lib-std";
+import { ppqn } from "@opendaw/lib-dsp";
+import { AnyClipBoxAdapter } from "./UnionAdapterTypes";
+export type Section = {
+    optClip: Option<AnyClipBoxAdapter>;
+    sectionFrom: ppqn;
+    sectionTo: ppqn;
+};
+export interface ClipSequencing extends Terminable {
+    iterate(trackKey: UUID.Format, a: ppqn, b: ppqn): Generator<Section>;
+}
+//# sourceMappingURL=ClipSequencing.d.ts.map

package/dist/ClipSequencing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipSequencing.d.ts","sourceRoot":"","sources":["../src/ClipSequencing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAA;AACrC,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAA;AAErD,MAAM,MAAM,OAAO,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAA;IAClC,WAAW,EAAE,IAAI,CAAA;IACjB,SAAS,EAAE,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,cAAe,SAAQ,UAAU;IAC9C,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;CACvE"}

package/dist/ClipSequencing.js

@@ -0,0 +1 @@
+export {};