@opendaw/studio-adapters 0.0.6

package/dist/timeline/TrackBoxAdapter.js

@@ -0,0 +1,167 @@
+import { asInstanceOf, DefaultObservableValue, isInstanceOf, Option, panic, Terminable, Terminator } from "@opendaw/lib-std";
+import { StringField } from "@opendaw/lib-box";
+import { TrackClips } from "./TrackClips";
+import { TrackRegions } from "./TrackRegions";
+import { AudioUnitBoxAdapter } from "../audio-unit/AudioUnitBoxAdapter";
+import { TrackType } from "./TrackType";
+import { UpdateClockRate } from "../UpdateClockRate";
+import { ValueClipBoxAdapter } from "./clip/ValueClipBoxAdapter";
+import { ValueRegionBoxAdapter } from "./region/ValueRegionBoxAdapter";
+import { AudioUnitBox } from "@opendaw/studio-boxes";
+export class TrackBoxAdapter {
+    #context;
+    #box;
+    #terminator;
+    #clips;
+    #regions;
+    #listIndex;
+    constructor(context, box) {
+        this.#context = context;
+        this.#box = box;
+        this.#terminator = new Terminator();
+        this.#clips = this.#terminator.own(new TrackClips(this, context.boxAdapters));
+        this.#regions = this.#terminator.own(new TrackRegions(this, context.boxAdapters));
+        this.#listIndex = this.#terminator.own(new DefaultObservableValue(-1));
+    }
+    catchupAndSubscribePath(observer) {
+        const path = [Option.None, Option.None];
+        const updater = () => {
+            if (path.every(option => option.nonEmpty())) {
+                observer(Option.wrap(path.map(option => option.unwrap())));
+            }
+            else {
+                observer(Option.None);
+            }
+        };
+        return Terminable.many(this.#catchupAndSubscribeTargetDeviceName(option => {
+            if (path[0].equals(option)) {
+                return;
+            }
+            path[0] = option;
+            updater();
+        }), this.#catchupAndSubscribeTargetControlName(option => {
+            if (path[1].equals(option)) {
+                return;
+            }
+            path[1] = option;
+            updater();
+        }));
+    }
+    #catchupAndSubscribeTargetDeviceName(observer) {
+        const targetVertex = this.#box.target.targetVertex;
+        if (targetVertex.nonEmpty()) {
+            const vertex = targetVertex.unwrap().box;
+            if (vertex instanceof AudioUnitBox) {
+                const adapter = this.#context.boxAdapters.adapterFor(vertex, AudioUnitBoxAdapter);
+                return adapter.input.catchupAndSubscribeLabelChange(option => observer(option));
+            }
+            else if ("label" in vertex && vertex.label instanceof StringField) {
+                return vertex.label.catchupAndSubscribe(owner => observer(Option.wrap(owner.getValue())));
+            }
+            else {
+                // TODO This is a workaround. We need to find a way to dig into the box for a name
+                observer(Option.wrap(vertex.name));
+                return Terminable.Empty;
+            }
+        }
+        observer(Option.None);
+        return Terminable.Empty;
+    }
+    #catchupAndSubscribeTargetControlName(observer) {
+        const type = this.type;
+        switch (type) {
+            case TrackType.Audio:
+            case TrackType.Notes: {
+                observer(Option.wrap(TrackType[type]));
+                return Terminable.Empty;
+            }
+            case TrackType.Value: {
+                const target = this.#box.target.targetVertex.unwrap();
+                if (target.isField()) {
+                    observer(this.#context.parameterFieldAdapters.opt(target.address).map(vertex => vertex.name));
+                }
+                else if (target.isBox()) {
+                    // I cannot think of a scenario where target is a box, but at least the UI shows the box's name
+                    observer(Option.wrap(target.name));
+                }
+                else {
+                    return panic("Illegal State. Vertex is not a field nor box.");
+                }
+                return Terminable.Empty;
+            }
+            case TrackType.Undefined: {
+                observer(Option.wrap(""));
+                return Terminable.Empty;
+            }
+            default: {
+                observer(Option.None);
+                return Terminable.Empty;
+            }
+        }
+    }
+    terminate() { this.#terminator.terminate(); }
+    get audioUnit() { return asInstanceOf(this.#box.tracks.targetVertex.unwrap().box, AudioUnitBox); }
+    get target() { return this.#box.target; }
+    get clips() { return this.#clips; }
+    get regions() { return this.#regions; }
+    get enabled() { return this.#box.enabled; }
+    get indexField() { return this.#box.index; }
+    get type() { return this.#box.type.getValue(); }
+    get box() { return this.#box; }
+    get uuid() { return this.#box.address.uuid; }
+    get address() { return this.#box.address; }
+    get listIndex() { return this.#listIndex.getValue(); }
+    set listIndex(value) { this.#listIndex.setValue(value); }
+    accepts(subject) {
+        switch (subject.type) {
+            case "audio-clip":
+                return this.type === TrackType.Audio;
+            case "note-clip":
+                return this.type === TrackType.Notes;
+            case "value-clip":
+                return this.type === TrackType.Value;
+            case "audio-region":
+                return this.type === TrackType.Audio;
+            case "note-region":
+                return this.type === TrackType.Notes;
+            case "value-region":
+                return this.type === TrackType.Value;
+        }
+    }
+    valueAt(position, fallback) {
+        if (!this.enabled.getValue()) {
+            return fallback;
+        }
+        let value = fallback;
+        const intervals = this.#context.clipSequencing.iterate(this.uuid, position, position + UpdateClockRate);
+        for (const { optClip, sectionFrom } of intervals) {
+            value = optClip.match({
+                none: () => {
+                    const region = this.regions.collection.lowerEqual(position, region => !region.mute);
+                    if (region === null) {
+                        const firstRegion = this.regions.collection.optAt(0);
+                        return isInstanceOf(firstRegion, ValueRegionBoxAdapter) ? firstRegion.incomingValue(fallback) : fallback;
+                    }
+                    else if (isInstanceOf(region, ValueRegionBoxAdapter)) {
+                        if (position < region.complete) {
+                            return region.valueAt(position, fallback);
+                        }
+                        else {
+                            return region.outgoingValue(fallback);
+                        }
+                    }
+                    return fallback;
+                },
+                some: clip => {
+                    if (sectionFrom === position) {
+                        if (isInstanceOf(clip, ValueClipBoxAdapter)) {
+                            return clip.valueAt(position, fallback);
+                        }
+                    }
+                    return fallback;
+                }
+            });
+        }
+        return value;
+    }
+}

package/dist/timeline/TrackClips.d.ts

@@ -0,0 +1,16 @@
+import { Pointers } from "@opendaw/studio-enums";
+import { Observer, Subscription, Terminable } from "@opendaw/lib-std";
+import { TrackBoxAdapter } from "./TrackBoxAdapter";
+import { SortedBoxAdapterCollection } from "../SortedBoxAdapterCollection";
+import { AnyClipBoxAdapter } from "../UnionAdapterTypes";
+import { BoxAdapters } from "../BoxAdapters";
+export declare class TrackClips implements Terminable {
+    #private;
+    constructor(adapter: TrackBoxAdapter, boxAdapters: BoxAdapters);
+    get trackBoxAdapter(): TrackBoxAdapter;
+    get collection(): SortedBoxAdapterCollection<AnyClipBoxAdapter, Pointers.ClipCollection>;
+    dispatchChange(): void;
+    subscribeChanges(observer: Observer<void>): Subscription;
+    terminate(): void;
+}
+//# sourceMappingURL=TrackClips.d.ts.map

package/dist/timeline/TrackClips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackClips.d.ts","sourceRoot":"","sources":["../../src/timeline/TrackClips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAW,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAA;AACzF,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,0BAA0B,EAAC,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAA;AAG1C,qBAAa,UAAW,YAAW,UAAU;;gBAM7B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW;IAc9D,IAAI,eAAe,IAAI,eAAe,CAA+B;IACrE,IAAI,UAAU,IAAI,0BAA0B,CAAC,iBAAiB,EAAE,QAAQ,CAAC,cAAc,CAAC,CAA0B;IAElH,cAAc,IAAI,IAAI;IACtB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IACxD,SAAS,IAAI,IAAI;CACpB"}

package/dist/timeline/TrackClips.js

@@ -0,0 +1,26 @@
+import { Pointers } from "@opendaw/studio-enums";
+import { Notifier, Terminator } from "@opendaw/lib-std";
+import { SortedBoxAdapterCollection } from "../SortedBoxAdapterCollection";
+import { ClipAdapters } from "./ClipBoxAdapter";
+export class TrackClips {
+    #trackBoxAdapter;
+    #terminator;
+    #changeNotifier;
+    #collection;
+    constructor(adapter, boxAdapters) {
+        this.#trackBoxAdapter = adapter;
+        this.#terminator = new Terminator();
+        this.#changeNotifier = this.#terminator.own(new Notifier());
+        this.#collection = this.#terminator.own(SortedBoxAdapterCollection.create(adapter.box.clips, box => ClipAdapters.for(boxAdapters, box), Pointers.ClipCollection));
+        this.#collection.subscribe({
+            onAdd: () => this.dispatchChange(),
+            onRemove: () => this.dispatchChange(),
+            onReorder: () => this.dispatchChange()
+        });
+    }
+    get trackBoxAdapter() { return this.#trackBoxAdapter; }
+    get collection() { return this.#collection; }
+    dispatchChange() { this.#changeNotifier.notify(); }
+    subscribeChanges(observer) { return this.#changeNotifier.subscribe(observer); }
+    terminate() { this.#terminator.terminate(); }
+}

package/dist/timeline/TrackRegions.d.ts

@@ -0,0 +1,17 @@
+import { RegionCollection } from "@opendaw/lib-dsp";
+import { Observer, SortedSet, Subscription } from "@opendaw/lib-std";
+import { TrackBoxAdapter } from "./TrackBoxAdapter";
+import { AnyRegionBoxAdapter } from "../UnionAdapterTypes";
+import { BoxAdapters } from "../BoxAdapters";
+export declare class TrackRegions {
+    #private;
+    constructor(adapter: TrackBoxAdapter, boxAdapters: BoxAdapters);
+    get trackBoxAdapter(): TrackBoxAdapter;
+    get collection(): RegionCollection<AnyRegionBoxAdapter>;
+    get adapters(): SortedSet<Readonly<Uint8Array>, AnyRegionBoxAdapter>;
+    onIndexingChanged(): void;
+    subscribeChanges(observer: Observer<void>): Subscription;
+    dispatchChange(): void;
+    terminate(): void;
+}
+//# sourceMappingURL=TrackRegions.d.ts.map

package/dist/timeline/TrackRegions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackRegions.d.ts","sourceRoot":"","sources":["../../src/timeline/TrackRegions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAmB,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAA;AAEtG,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,mBAAmB,EAAC,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAA;AAG1C,qBAAa,YAAY;;gBAQT,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW;IAwB9D,IAAI,eAAe,IAAI,eAAe,CAA+B;IACrE,IAAI,UAAU,IAAI,gBAAgB,CAAC,mBAAmB,CAAC,CAA0B;IACjF,IAAI,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC,CAAwB;IAE5F,iBAAiB,IAAI,IAAI;IAKzB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IACxD,cAAc,IAAI,IAAI;IACtB,SAAS;CACZ"}

package/dist/timeline/TrackRegions.js

@@ -0,0 +1,41 @@
+import { RegionCollection } from "@opendaw/lib-dsp";
+import { assert, Notifier, Terminator, UUID } from "@opendaw/lib-std";
+import { Pointers } from "@opendaw/studio-enums";
+import { RegionAdapters, RegionComparator } from "./RegionBoxAdapter";
+export class TrackRegions {
+    #trackBoxAdapter;
+    #terminator;
+    #changeNotifier;
+    #collection;
+    #adapters;
+    constructor(adapter, boxAdapters) {
+        this.#trackBoxAdapter = adapter;
+        this.#terminator = new Terminator();
+        this.#changeNotifier = this.#terminator.own(new Notifier());
+        this.#collection = RegionCollection.create(RegionComparator);
+        this.#adapters = UUID.newSet(adapter => adapter.uuid);
+        this.#terminator.ownAll(this.#trackBoxAdapter.box.regions.pointerHub.catchupAndSubscribeTransactual({
+            onAdd: ({ box }) => {
+                const adapter = RegionAdapters.for(boxAdapters, box);
+                const added = this.#adapters.add(adapter);
+                assert(added, `Cannot add ${box}`);
+                this.#collection.add(adapter);
+                this.dispatchChange();
+            },
+            onRemove: ({ box: { address: { uuid } } }) => {
+                this.#collection.remove(this.#adapters.removeByKey(uuid));
+                this.dispatchChange();
+            }
+        }, Pointers.RegionCollection));
+    }
+    get trackBoxAdapter() { return this.#trackBoxAdapter; }
+    get collection() { return this.#collection; }
+    get adapters() { return this.#adapters; }
+    onIndexingChanged() {
+        this.#collection.onIndexingChanged();
+        this.dispatchChange();
+    }
+    subscribeChanges(observer) { return this.#changeNotifier.subscribe(observer); }
+    dispatchChange() { this.#changeNotifier.notify(); }
+    terminate() { this.#terminator.terminate(); }
+}

package/dist/timeline/TrackType.d.ts

@@ -0,0 +1,12 @@
+import { IconSymbol } from "../IconSymbol";
+export declare enum TrackType {
+    Undefined = 0,
+    Notes = 1,
+    Audio = 2,
+    Value = 3
+}
+export declare namespace TrackType {
+    const toLabelString: (type: TrackType) => string;
+    const toIconSymbol: (type: TrackType) => IconSymbol.Waveform | IconSymbol.AudioBus | IconSymbol.Piano | IconSymbol.Automation | IconSymbol.Unknown;
+}
+//# sourceMappingURL=TrackType.d.ts.map

package/dist/timeline/TrackType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackType.d.ts","sourceRoot":"","sources":["../../src/timeline/TrackType.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AAExC,oBAAY,SAAS;IAAE,SAAS,IAAA;IAAE,KAAK,IAAA;IAAE,KAAK,IAAA;IAAE,KAAK,IAAA;CAAC;AAEtD,yBAAiB,SAAS,CAAC;IAChB,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,MAY/C,CAAA;IACM,MAAM,YAAY,GAAI,MAAM,SAAS,8GAa3C,CAAA;CACJ"}

package/dist/timeline/TrackType.js

@@ -0,0 +1,37 @@
+import { IconSymbol } from "../IconSymbol";
+export var TrackType;
+(function (TrackType) {
+    TrackType[TrackType["Undefined"] = 0] = "Undefined";
+    TrackType[TrackType["Notes"] = 1] = "Notes";
+    TrackType[TrackType["Audio"] = 2] = "Audio";
+    TrackType[TrackType["Value"] = 3] = "Value";
+})(TrackType || (TrackType = {}));
+(function (TrackType) {
+    TrackType.toLabelString = (type) => {
+        switch (type) {
+            case TrackType.Audio:
+                return "Audio";
+            case TrackType.Notes:
+                return "Notes";
+            case TrackType.Value:
+                return "Automation";
+            case TrackType.Undefined:
+            default:
+                return "N/A";
+        }
+    };
+    TrackType.toIconSymbol = (type) => {
+        switch (type) {
+            case TrackType.Audio:
+                return IconSymbol.Waveform;
+            case TrackType.Notes:
+                return IconSymbol.Piano;
+            case TrackType.Value:
+                return IconSymbol.Automation;
+            case TrackType.Undefined:
+                return IconSymbol.AudioBus;
+            default:
+                return IconSymbol.Unknown;
+        }
+    };
+})(TrackType || (TrackType = {}));

package/dist/timeline/clip/AudioClipBoxAdapter.d.ts

@@ -0,0 +1,39 @@
+import { ppqn } from "@opendaw/lib-dsp";
+import { int, Nullish, ObservableValue, Observer, Option, Subscription, UUID } from "@opendaw/lib-std";
+import { AudioClipBox } from "@opendaw/studio-boxes";
+import { Address, Int32Field } from "@opendaw/lib-box";
+import { ClipBoxAdapter, ClipBoxAdapterVisitor } from "../ClipBoxAdapter";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+import { BoxAdaptersContext } from "../../BoxAdaptersContext";
+import { AudioFileBoxAdapter } from "../../AudioFileBoxAdapter";
+export declare class AudioClipBoxAdapter implements ClipBoxAdapter<never> {
+    #private;
+    readonly type = "audio-clip";
+    constructor(context: BoxAdaptersContext, box: AudioClipBox);
+    catchupAndSubscribeSelected(observer: Observer<ObservableValue<boolean>>): Subscription;
+    subscribeChange(observer: Observer<void>): Subscription;
+    accept<R>(visitor: ClipBoxAdapterVisitor<R>): Nullish<R>;
+    consolidate(): void;
+    clone(_mirrored: boolean): void;
+    onSelected(): void;
+    onDeselected(): void;
+    get isSelected(): boolean;
+    terminate(): void;
+    get box(): AudioClipBox;
+    get uuid(): UUID.Format;
+    get address(): Address;
+    get indexField(): Int32Field;
+    get duration(): ppqn;
+    get mute(): boolean;
+    get hue(): int;
+    get gain(): number;
+    get file(): AudioFileBoxAdapter;
+    get hasCollection(): boolean;
+    get optCollection(): Option<never>;
+    get label(): string;
+    get trackBoxAdapter(): Option<TrackBoxAdapter>;
+    get isMirrowed(): boolean;
+    get canMirror(): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=AudioClipBoxAdapter.d.ts.map

package/dist/timeline/clip/AudioClipBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioClipBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/timeline/clip/AudioClipBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAEH,GAAG,EAEH,OAAO,EACP,eAAe,EACf,QAAQ,EACR,MAAM,EAEN,YAAY,EAEZ,IAAI,EACP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAC,OAAO,EAAE,UAAU,EAAoC,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAAC,cAAc,EAAE,qBAAqB,EAAC,MAAM,mBAAmB,CAAA;AAEvE,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAA;AAE7D,qBAAa,mBAAoB,YAAW,cAAc,CAAC,KAAK,CAAC;;IAC7D,QAAQ,CAAC,IAAI,gBAAe;gBAehB,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,YAAY;IA+B1D,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,YAAY;IAIvF,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IACvD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAExD,WAAW,IAAI,IAAI;IACnB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAa/B,UAAU,IAAI,IAAI;IAClB,YAAY,IAAI,IAAI;IAEpB,IAAI,UAAU,IAAI,OAAO,CAAwC;IAEjE,SAAS,IAAI,IAAI;IAEjB,IAAI,GAAG,IAAI,YAAY,CAAmB;IAC1C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAgC;IACvD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,QAAQ,IAAI,IAAI,CAAuC;IAC3D,IAAI,IAAI,IAAI,OAAO,CAAmC;IACtD,IAAI,GAAG,IAAI,GAAG,CAAkC;IAChD,IAAI,IAAI,IAAI,MAAM,CAAmC;IACrD,IAAI,IAAI,IAAI,mBAAmB,CAAyD;IACxF,IAAI,aAAa,YAAyC;IAC1D,IAAI,aAAa,IAAI,MAAM,CAAC,KAAK,CAAC,CAAqB;IACvD,IAAI,KAAK,IAAI,MAAM,CAAoC;IACvD,IAAI,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,CAI7C;IACD,IAAI,UAAU,IAAI,OAAO,CAAe;IACxC,IAAI,SAAS,IAAI,OAAO,CAAe;IAEvC,QAAQ,IAAI,MAAM;CAMrB"}

package/dist/timeline/clip/AudioClipBoxAdapter.js

@@ -0,0 +1,87 @@
+import { PPQN } from "@opendaw/lib-dsp";
+import { DefaultObservableValue, Notifier, Option, safeExecute, Terminator, UUID } from "@opendaw/lib-std";
+import { AudioClipBox } from "@opendaw/studio-boxes";
+import { Propagation } from "@opendaw/lib-box";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+import { AudioFileBoxAdapter } from "../../AudioFileBoxAdapter";
+export class AudioClipBoxAdapter {
+    type = "audio-clip";
+    #terminator = new Terminator();
+    #context;
+    #box;
+    #selectedValue;
+    #changeNotifier;
+    #isConstructing; // Prevents stack overflow due to infinite adapter queries
+    #fileAdapter = Option.None;
+    #fileSubscription = Option.None;
+    constructor(context, box) {
+        this.#context = context;
+        this.#box = box;
+        this.#isConstructing = true;
+        this.#selectedValue = this.#terminator.own(new DefaultObservableValue(false));
+        this.#changeNotifier = this.#terminator.own(new Notifier());
+        this.#terminator.ownAll(this.#box.pointerHub.subscribeImmediate({
+            onAdd: () => this.#dispatchChange(),
+            onRemove: () => this.#dispatchChange()
+        }), this.#box.file.catchupAndSubscribe((pointerField) => {
+            this.#fileAdapter = pointerField.targetVertex
+                .map(vertex => this.#context.boxAdapters.adapterFor(vertex.box, AudioFileBoxAdapter));
+            this.#fileSubscription.ifSome(subscription => subscription.terminate());
+            this.#fileSubscription = this.#fileAdapter.map(adapter => adapter.getOrCreateAudioLoader().subscribe(() => this.#dispatchChange()));
+        }), this.#box.subscribe(Propagation.Children, (_update) => this.#dispatchChange()), {
+            terminate: () => {
+                this.#fileSubscription.ifSome(subscription => subscription.terminate());
+                this.#fileSubscription = Option.None;
+            }
+        });
+        this.#isConstructing = false;
+    }
+    catchupAndSubscribeSelected(observer) {
+        return this.#selectedValue.catchupAndSubscribe(observer);
+    }
+    subscribeChange(observer) { return this.#changeNotifier.subscribe(observer); }
+    accept(visitor) { return safeExecute(visitor.visitAudioClipBoxAdapter, this); }
+    consolidate() { }
+    clone(_mirrored) {
+        AudioClipBox.create(this.#context.boxGraph, UUID.generate(), box => {
+            box.index.setValue(this.indexField.getValue());
+            box.gain.setValue(this.gain);
+            box.label.setValue(this.label);
+            box.hue.setValue(this.hue);
+            box.duration.setValue(this.duration);
+            box.mute.setValue(this.mute);
+            box.clips.refer(this.#box.clips.targetVertex.unwrap());
+            box.file.refer(this.#box.file.targetVertex.unwrap());
+        });
+    }
+    onSelected() { this.#selectedValue.setValue(true); }
+    onDeselected() { this.#selectedValue.setValue(false); }
+    get isSelected() { return this.#selectedValue.getValue(); }
+    terminate() { this.#terminator.terminate(); }
+    get box() { return this.#box; }
+    get uuid() { return this.#box.address.uuid; }
+    get address() { return this.#box.address; }
+    get indexField() { return this.#box.index; }
+    get duration() { return this.#box.duration.getValue(); }
+    get mute() { return this.#box.mute.getValue(); }
+    get hue() { return this.#box.hue.getValue(); }
+    get gain() { return this.#box.gain.getValue(); }
+    get file() { return this.#fileAdapter.unwrap("Cannot access file."); }
+    get hasCollection() { return !this.optCollection.isEmpty(); }
+    get optCollection() { return Option.None; }
+    get label() { return this.#box.label.getValue(); }
+    get trackBoxAdapter() {
+        if (this.#isConstructing) {
+            return Option.None;
+        }
+        return this.#box.clips.targetVertex
+            .map(vertex => this.#context.boxAdapters.adapterFor(vertex.box, TrackBoxAdapter));
+    }
+    get isMirrowed() { return false; }
+    get canMirror() { return false; }
+    toString() { return `{AudioClipBoxAdapter ${UUID.toString(this.#box.address.uuid)} d: ${PPQN.toString(this.duration)}}`; }
+    #dispatchChange() {
+        this.#changeNotifier.notify();
+        this.trackBoxAdapter.unwrapOrNull()?.clips?.dispatchChange();
+    }
+}

package/dist/timeline/clip/NoteClipBoxAdapter.d.ts

@@ -0,0 +1,39 @@
+import { int, Nullish, ObservableValue, Observer, Option, Subscription, UUID } from "@opendaw/lib-std";
+import { EventCollection, ppqn } from "@opendaw/lib-dsp";
+import { Address, Int32Field } from "@opendaw/lib-box";
+import { NoteClipBox } from "@opendaw/studio-boxes";
+import { NoteEventCollectionBoxAdapter } from "../collection/NoteEventCollectionBoxAdapter";
+import { ClipBoxAdapter, ClipBoxAdapterVisitor } from "../ClipBoxAdapter";
+import { BoxAdaptersContext } from "../../BoxAdaptersContext";
+import { NoteEventBoxAdapter } from "../event/NoteEventBoxAdapter";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+export declare class NoteClipBoxAdapter implements ClipBoxAdapter<NoteEventCollectionBoxAdapter> {
+    #private;
+    readonly type = "note-clip";
+    constructor(context: BoxAdaptersContext, box: NoteClipBox);
+    catchupAndSubscribeSelected(observer: Observer<ObservableValue<boolean>>): Subscription;
+    subscribeChange(observer: Observer<void>): Subscription;
+    accept<R>(visitor: ClipBoxAdapterVisitor<R>): Nullish<R>;
+    consolidate(): void;
+    clone(consolidate: boolean): void;
+    onSelected(): void;
+    onDeselected(): void;
+    get isSelected(): boolean;
+    terminate(): void;
+    get box(): NoteClipBox;
+    get uuid(): UUID.Format;
+    get address(): Address;
+    get indexField(): Int32Field;
+    get duration(): ppqn;
+    get mute(): boolean;
+    get hue(): int;
+    get events(): Option<EventCollection<NoteEventBoxAdapter>>;
+    get hasCollection(): boolean;
+    get optCollection(): Option<NoteEventCollectionBoxAdapter>;
+    get label(): string;
+    get trackBoxAdapter(): Option<TrackBoxAdapter>;
+    get isMirrowed(): boolean;
+    get canMirror(): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=NoteClipBoxAdapter.d.ts.map

package/dist/timeline/clip/NoteClipBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoteClipBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/timeline/clip/NoteClipBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,GAAG,EAEH,OAAO,EACP,eAAe,EACf,QAAQ,EACR,MAAM,EAEN,YAAY,EAGZ,IAAI,EACP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,eAAe,EAAE,IAAI,EAAO,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAC,OAAO,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,6BAA6B,EAAC,MAAM,6CAA6C,CAAA;AACzF,OAAO,EAAC,cAAc,EAAE,qBAAqB,EAAC,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAElD,qBAAa,kBAAmB,YAAW,cAAc,CAAC,6BAA6B,CAAC;;IACpF,QAAQ,CAAC,IAAI,eAAc;gBAcf,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,WAAW;IA2BzD,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,YAAY;IAIvF,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IACvD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAExD,WAAW,IAAI,IAAI;IACnB,KAAK,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI;IAajC,UAAU,IAAI,IAAI;IAClB,YAAY,IAAI,IAAI;IAEpB,IAAI,UAAU,IAAI,OAAO,CAAwC;IAEjE,SAAS,IAAI,IAAI;IAKjB,IAAI,GAAG,IAAI,WAAW,CAAmB;IACzC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAgC;IACvD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,QAAQ,IAAI,IAAI,CAAuC;IAC3D,IAAI,IAAI,IAAI,OAAO,CAAmC;IACtD,IAAI,GAAG,IAAI,GAAG,CAAkC;IAChD,IAAI,MAAM,IAAI,MAAM,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAEzD;IACD,IAAI,aAAa,YAAyC;IAC1D,IAAI,aAAa,IAAI,MAAM,CAAC,6BAA6B,CAAC,CAGzD;IACD,IAAI,KAAK,IAAI,MAAM,CAAoC;IACvD,IAAI,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,CAI7C;IACD,IAAI,UAAU,IAAI,OAAO,CAA2E;IACpG,IAAI,SAAS,IAAI,OAAO,CAAc;IAEtC,QAAQ,IAAI,MAAM;CAMrB"}

package/dist/timeline/clip/NoteClipBoxAdapter.js

@@ -0,0 +1,92 @@
+import { DefaultObservableValue, Notifier, Option, safeExecute, Terminable, Terminator, UUID } from "@opendaw/lib-std";
+import { PPQN } from "@opendaw/lib-dsp";
+import { Propagation } from "@opendaw/lib-box";
+import { NoteClipBox } from "@opendaw/studio-boxes";
+import { NoteEventCollectionBoxAdapter } from "../collection/NoteEventCollectionBoxAdapter";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+export class NoteClipBoxAdapter {
+    type = "note-clip";
+    #terminator = new Terminator();
+    #context;
+    #box;
+    #selectedValue;
+    #changeNotifier;
+    #isConstructing; // Prevents stack overflow due to infinite adapter queries
+    #eventCollectionSubscription = Terminable.Empty;
+    constructor(context, box) {
+        this.#context = context;
+        this.#box = box;
+        this.#isConstructing = true;
+        this.#selectedValue = this.#terminator.own(new DefaultObservableValue(false));
+        this.#changeNotifier = this.#terminator.own(new Notifier());
+        this.#terminator.ownAll(this.#box.pointerHub.subscribeImmediate({
+            onAdd: () => this.#dispatchChange(),
+            onRemove: () => this.#dispatchChange()
+        }), this.#box.subscribe(Propagation.Children, (_update) => this.#dispatchChange()), this.#box.events.catchupAndSubscribe(({ targetVertex }) => {
+            this.#eventCollectionSubscription.terminate();
+            this.#eventCollectionSubscription = targetVertex.match({
+                none: () => Terminable.Empty,
+                some: ({ box }) => this.#context.boxAdapters
+                    .adapterFor(box, NoteEventCollectionBoxAdapter)
+                    .subscribeChange(() => this.#dispatchChange())
+            });
+            this.#dispatchChange();
+        }));
+        this.#isConstructing = false;
+    }
+    catchupAndSubscribeSelected(observer) {
+        return this.#selectedValue.catchupAndSubscribe(observer);
+    }
+    subscribeChange(observer) { return this.#changeNotifier.subscribe(observer); }
+    accept(visitor) { return safeExecute(visitor.visitNoteClipBoxAdapter, this); }
+    consolidate() { this.#box.events.refer(this.optCollection.unwrap().copy().box.owners); }
+    clone(consolidate) {
+        const events = consolidate ? this.optCollection.unwrap().copy().box.owners : this.#box.events.targetVertex.unwrap();
+        NoteClipBox.create(this.#context.boxGraph, UUID.generate(), box => {
+            box.index.setValue(this.indexField.getValue());
+            box.label.setValue(this.label);
+            box.hue.setValue(this.hue);
+            box.duration.setValue(this.duration);
+            box.mute.setValue(this.mute);
+            box.clips.refer(this.#box.clips.targetVertex.unwrap());
+            box.events.refer(events);
+        });
+    }
+    onSelected() { this.#selectedValue.setValue(true); }
+    onDeselected() { this.#selectedValue.setValue(false); }
+    get isSelected() { return this.#selectedValue.getValue(); }
+    terminate() {
+        this.#eventCollectionSubscription.terminate();
+        this.#terminator.terminate();
+    }
+    get box() { return this.#box; }
+    get uuid() { return this.#box.address.uuid; }
+    get address() { return this.#box.address; }
+    get indexField() { return this.#box.index; }
+    get duration() { return this.#box.duration.getValue(); }
+    get mute() { return this.#box.mute.getValue(); }
+    get hue() { return this.#box.hue.getValue(); }
+    get events() {
+        return this.optCollection.map(collection => collection.events);
+    }
+    get hasCollection() { return !this.optCollection.isEmpty(); }
+    get optCollection() {
+        return this.#box.events.targetVertex
+            .map(vertex => this.#context.boxAdapters.adapterFor(vertex.box, NoteEventCollectionBoxAdapter));
+    }
+    get label() { return this.#box.label.getValue(); }
+    get trackBoxAdapter() {
+        if (this.#isConstructing) {
+            return Option.None;
+        }
+        return this.#box.clips.targetVertex
+            .map(vertex => this.#context.boxAdapters.adapterFor(vertex.box, TrackBoxAdapter));
+    }
+    get isMirrowed() { return this.optCollection.mapOr(adapter => adapter.numOwners > 1, false); }
+    get canMirror() { return true; }
+    toString() { return `{NoteClipBoxAdapter ${UUID.toString(this.#box.address.uuid)} d: ${PPQN.toString(this.duration)}}`; }
+    #dispatchChange() {
+        this.#changeNotifier.notify();
+        this.trackBoxAdapter.unwrapOrNull()?.clips?.dispatchChange();
+    }
+}

package/dist/timeline/clip/ValueClipBoxAdapter.d.ts

@@ -0,0 +1,40 @@
+import { EventCollection, ppqn } from "@opendaw/lib-dsp";
+import { int, Nullish, ObservableValue, Observer, Option, Subscription, unitValue, UUID } from "@opendaw/lib-std";
+import { Address, Int32Field } from "@opendaw/lib-box";
+import { ClipBoxAdapter, ClipBoxAdapterVisitor } from "../ClipBoxAdapter";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+import { ValueEventCollectionBoxAdapter } from "../collection/ValueEventCollectionBoxAdapter";
+import { BoxAdaptersContext } from "../../BoxAdaptersContext";
+import { ValueClipBox } from "@opendaw/studio-boxes";
+import { ValueEventBoxAdapter } from "../event/ValueEventBoxAdapter";
+export declare class ValueClipBoxAdapter implements ClipBoxAdapter<ValueEventCollectionBoxAdapter> {
+    #private;
+    readonly type = "value-clip";
+    constructor(context: BoxAdaptersContext, box: ValueClipBox);
+    valueAt(position: ppqn, fallback: unitValue): unitValue;
+    catchupAndSubscribeSelected(observer: Observer<ObservableValue<boolean>>): Subscription;
+    subscribeChange(observer: Observer<void>): Subscription;
+    accept<R>(visitor: ClipBoxAdapterVisitor<R>): Nullish<R>;
+    consolidate(): void;
+    clone(consolidate: boolean): void;
+    onSelected(): void;
+    onDeselected(): void;
+    get isSelected(): boolean;
+    terminate(): void;
+    get box(): ValueClipBox;
+    get uuid(): UUID.Format;
+    get address(): Address;
+    get indexField(): Int32Field;
+    get duration(): ppqn;
+    get mute(): boolean;
+    get hue(): int;
+    get hasCollection(): boolean;
+    get events(): Option<EventCollection<ValueEventBoxAdapter>>;
+    get optCollection(): Option<ValueEventCollectionBoxAdapter>;
+    get label(): string;
+    get trackBoxAdapter(): Option<TrackBoxAdapter>;
+    get isMirrowed(): boolean;
+    get canMirror(): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=ValueClipBoxAdapter.d.ts.map

package/dist/timeline/clip/ValueClipBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueClipBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/timeline/clip/ValueClipBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAE,IAAI,EAAO,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAEH,GAAG,EAEH,OAAO,EACP,eAAe,EACf,QAAQ,EACR,MAAM,EAEN,YAAY,EAGZ,SAAS,EACT,IAAI,EACP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,OAAO,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAC,cAAc,EAAE,qBAAqB,EAAC,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAC,8BAA8B,EAAC,MAAM,8CAA8C,CAAA;AAC3F,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAC,oBAAoB,EAAC,MAAM,+BAA+B,CAAA;AAElE,qBAAa,mBAAoB,YAAW,cAAc,CAAC,8BAA8B,CAAC;;IACtF,QAAQ,CAAC,IAAI,gBAAe;gBAahB,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,YAAY;IA4B1D,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,GAAG,SAAS;IAKvD,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,YAAY;IAGvF,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IACvD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAExD,WAAW,IAAI,IAAI;IACnB,KAAK,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI;IAajC,UAAU,IAAI,IAAI;IAClB,YAAY,IAAI,IAAI;IAEpB,IAAI,UAAU,IAAI,OAAO,CAAwC;IAEjE,SAAS,IAAI,IAAI;IAKjB,IAAI,GAAG,IAAI,YAAY,CAAmB;IAC1C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAgC;IACvD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,QAAQ,IAAI,IAAI,CAAuC;IAC3D,IAAI,IAAI,IAAI,OAAO,CAAmC;IACtD,IAAI,GAAG,IAAI,GAAG,CAAkC;IAChD,IAAI,aAAa,YAAyC;IAC1D,IAAI,MAAM,IAAI,MAAM,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAE1D;IACD,IAAI,aAAa,IAAI,MAAM,CAAC,8BAA8B,CAAC,CAG1D;IACD,IAAI,KAAK,IAAI,MAAM,CAAoC;IACvD,IAAI,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,CAI7C;IACD,IAAI,UAAU,IAAI,OAAO,CAA2E;IACpG,IAAI,SAAS,IAAI,OAAO,CAAc;IAEtC,QAAQ,IAAI,MAAM;CAMrB"}