@opendaw/studio-adapters 0.0.6

package/dist/timeline/event/NoteEventBoxAdapter.js

@@ -0,0 +1,106 @@
+import { NoteEvent } from "@opendaw/lib-dsp";
+import { Arrays, UUID } from "@opendaw/lib-std";
+import { NoteEventBox } from "@opendaw/studio-boxes";
+import { Propagation } from "@opendaw/lib-box";
+import { NoteEventCollectionBoxAdapter } from "../collection/NoteEventCollectionBoxAdapter";
+export class NoteEventBoxAdapter {
+    type = "note-event";
+    #context;
+    #box;
+    #subscription;
+    #isSelected = false;
+    constructor(context, box) {
+        this.#context = context;
+        this.#box = box;
+        this.#subscription = this.#box.subscribe(Propagation.Children, (update) => {
+            if (this.collection.isEmpty()) {
+                return;
+            }
+            if (update.type === "primitive" || update.type === "pointer") {
+                const collection = this.collection.unwrap();
+                const updatedFieldKeys = update.address.fieldKeys;
+                const pitchChanged = Arrays.equals(this.#box.pitch.address.fieldKeys, updatedFieldKeys);
+                const positionChanged = Arrays.equals(this.#box.position.address.fieldKeys, updatedFieldKeys);
+                if (pitchChanged || positionChanged) {
+                    collection.requestSorting();
+                }
+                else {
+                    collection.onEventPropertyChanged();
+                }
+            }
+        });
+    }
+    onSelected() {
+        this.#isSelected = true;
+        this.collection.ifSome(region => region.onEventPropertyChanged());
+    }
+    onDeselected() {
+        this.#isSelected = false;
+        this.collection.ifSome(region => region.onEventPropertyChanged());
+    }
+    terminate() { this.#subscription.terminate(); }
+    get box() { return this.#box; }
+    get uuid() { return this.#box.address.uuid; }
+    get address() { return this.#box.address; }
+    get position() { return this.#box.position.getValue(); }
+    get duration() { return this.#box.duration.getValue(); }
+    get complete() { return this.position + this.duration; }
+    get velocity() { return this.#box.velocity.getValue(); } // 0.0...1.0
+    get pitch() { return this.#box.pitch.getValue(); } // 0...127
+    get cent() { return this.#box.cent.getValue(); } // -50.0...+50.0
+    get chance() { return this.#box.chance.getValue(); } // 0...100%
+    get playCount() { return this.#box.playCount.getValue(); } // 1...16
+    get playCurve() { return this.#box.playCurve.getValue(); } // -1...+1
+    get isSelected() { return this.#isSelected; }
+    get collection() {
+        return this.#box.events.targetVertex
+            .map(vertex => this.#context.boxAdapters.adapterFor(vertex.box, NoteEventCollectionBoxAdapter));
+    }
+    normalizedPitch() {
+        if (this.collection.isEmpty()) {
+            return 0.5;
+        }
+        const { minPitch, maxPitch } = this.collection.unwrap();
+        return minPitch === maxPitch ? 0.5 : 1.0 - (this.pitch - minPitch) / (maxPitch - minPitch);
+    }
+    copyAsNoteEvent() {
+        return {
+            type: "note-event",
+            position: this.position,
+            duration: this.duration,
+            pitch: this.pitch,
+            cent: this.cent,
+            velocity: this.velocity
+        };
+    }
+    copyTo(options) {
+        return this.#context.boxAdapters.adapterFor(NoteEventBox.create(this.#context.boxGraph, UUID.generate(), box => {
+            box.position.setValue(options?.position ?? this.position);
+            box.duration.setValue(options?.duration ?? this.duration);
+            box.pitch.setValue(options?.pitch ?? this.pitch);
+            box.playCount.setValue(options?.playCount ?? this.playCount);
+            box.events.refer(options?.events ?? this.collection.unwrap().box.events);
+            box.velocity.setValue(this.velocity);
+            box.cent.setValue(this.cent);
+            box.chance.setValue(this.chance);
+        }), NoteEventBoxAdapter);
+    }
+    computeCurveValue(ratio) { return NoteEvent.curveFunc(ratio, this.playCurve); }
+    canConsolidate() { return this.playCount > 1; }
+    consolidate() {
+        const playCount = this.playCount;
+        const events = this.collection.unwrap().box.events;
+        const adapters = Arrays.create((index) => {
+            const a = Math.floor(this.computeCurveValue(index / playCount) * this.duration);
+            const b = Math.floor(this.computeCurveValue((index + 1) / playCount) * this.duration);
+            return this.copyTo({
+                position: Math.floor(this.position + a),
+                duration: Math.max(1, b - a),
+                playCount: 1,
+                events
+            });
+        }, playCount);
+        this.#box.delete();
+        return adapters;
+    }
+}

package/dist/timeline/event/ValueEventBoxAdapter.d.ts

@@ -0,0 +1,39 @@
+import { Comparator, int, Option, Selectable, unitValue, UUID } from "@opendaw/lib-std";
+import { Interpolation, ppqn, ValueEvent } from "@opendaw/lib-dsp";
+import { Address, Field } from "@opendaw/lib-box";
+import { Pointers } from "@opendaw/studio-enums";
+import { ValueEventBox } from "@opendaw/studio-boxes";
+import { ValueEventCollectionBoxAdapter } from "../collection/ValueEventCollectionBoxAdapter";
+import { BoxAdapter } from "../../BoxAdapter";
+import { BoxAdaptersContext } from "../../BoxAdaptersContext";
+type CopyToParams = {
+    position?: ppqn;
+    index?: int;
+    value?: unitValue;
+    interpolation?: Interpolation;
+    events?: Field<Pointers.ValueEvents>;
+};
+export declare class ValueEventBoxAdapter implements ValueEvent, BoxAdapter, Selectable {
+    #private;
+    static readonly Comparator: Comparator<ValueEventBoxAdapter>;
+    readonly type = "value-event";
+    constructor(context: BoxAdaptersContext, box: ValueEventBox);
+    onSelected(): void;
+    onDeselected(): void;
+    terminate(): void;
+    get box(): ValueEventBox;
+    get uuid(): UUID.Format;
+    get address(): Address;
+    get position(): int;
+    get index(): int;
+    set interpolation(value: Interpolation);
+    get interpolation(): Interpolation;
+    get value(): int;
+    get isSelected(): boolean;
+    get collection(): Option<ValueEventCollectionBoxAdapter>;
+    copyTo(options?: CopyToParams): ValueEventBoxAdapter;
+    copyFrom(options?: CopyToParams): this;
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=ValueEventBoxAdapter.d.ts.map

package/dist/timeline/event/ValueEventBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueEventBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/timeline/event/ValueEventBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,UAAU,EACV,GAAG,EACH,MAAM,EACN,UAAU,EAGV,SAAS,EACT,IAAI,EACP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,aAAa,EAAE,IAAI,EAAE,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAC,OAAO,EAAE,KAAK,EAAsB,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAC,8BAA8B,EAAC,MAAM,8CAA8C,CAAA;AAC3F,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAG3D,KAAK,YAAY,GAAG;IAChB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;CACvC,CAAA;AAED,qBAAa,oBAAqB,YAAW,UAAU,EAAE,UAAU,EAAE,UAAU;;IAC3E,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAM3D;IAED,QAAQ,CAAC,IAAI,iBAAgB;gBAYjB,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,aAAa;IAiD3D,UAAU,IAAI,IAAI;IAIlB,YAAY,IAAI,IAAI;IAKpB,SAAS,IAAI,IAAI;IAKjB,IAAI,GAAG,IAAI,aAAa,CAAmB;IAC3C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAgC;IACvD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,QAAQ,IAAI,GAAG,CAAuC;IAC1D,IAAI,KAAK,IAAI,GAAG,CAAoC;IACpD,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,EAAmE;IACzG,IAAI,aAAa,IAAI,aAAa,CAAmC;IACrE,IAAI,KAAK,IAAI,GAAG,CAAoC;IACpD,IAAI,UAAU,IAAI,OAAO,CAA0B;IACnD,IAAI,UAAU,IAAI,MAAM,CAAC,8BAA8B,CAAC,CAGvD;IAED,MAAM,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,oBAAoB;IAWpD,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAStC,QAAQ,IAAI,MAAM;CACrB"}

package/dist/timeline/event/ValueEventBoxAdapter.js

@@ -0,0 +1,113 @@
+import { Arrays, Cache, Terminable, Terminator, UUID } from "@opendaw/lib-std";
+import { Propagation } from "@opendaw/lib-box";
+import { Pointers } from "@opendaw/studio-enums";
+import { ValueEventBox } from "@opendaw/studio-boxes";
+import { ValueEventCollectionBoxAdapter } from "../collection/ValueEventCollectionBoxAdapter";
+import { InterpolationFieldAdapter } from "./InterpolationFieldAdapter";
+export class ValueEventBoxAdapter {
+    static Comparator = (a, b) => {
+        const positionDiff = a.position - b.position;
+        if (positionDiff !== 0) {
+            return positionDiff;
+        }
+        const indexDiff = a.index - b.index;
+        if (indexDiff !== 0) {
+            return indexDiff;
+        }
+        throw new Error(`${a} and ${b} are identical in terms of comparison`);
+    };
+    type = "value-event";
+    #terminator = new Terminator();
+    #context;
+    #box;
+    #interpolation;
+    #interpolationSubscription;
+    #isSelected = false;
+    constructor(context, box) {
+        this.#context = context;
+        this.#box = box;
+        this.#interpolation = this.#terminator.own(new Cache(() => InterpolationFieldAdapter.read(this.#box.interpolation)));
+        const invalidateInterpolation = () => {
+            this.#interpolation.invalidate();
+            this.collection.ifSome(collection => collection.onEventPropertyChanged());
+        };
+        this.#terminator.ownAll(this.#box.subscribe(Propagation.Children, (update) => {
+            if (this.collection.isEmpty()) {
+                return;
+            }
+            if (update.type === "primitive" || update.type === "pointer") {
+                const collection = this.collection.unwrap();
+                const updatedFieldKeys = update.address.fieldKeys;
+                const indexChanged = Arrays.equals(this.#box.index.address.fieldKeys, updatedFieldKeys);
+                const positionChanged = Arrays.equals(this.#box.position.address.fieldKeys, updatedFieldKeys);
+                if (indexChanged || positionChanged) {
+                    collection.requestSorting();
+                }
+                else {
+                    collection.onEventPropertyChanged();
+                }
+            }
+        }), this.#box.interpolation.subscribe(invalidateInterpolation), this.#box.interpolation.pointerHub.subscribeImmediate({
+            onAdd: ({ targetVertex }) => {
+                this.#interpolationSubscription.terminate();
+                this.#interpolationSubscription = targetVertex.unwrap().box
+                    .subscribe(Propagation.Children, invalidateInterpolation);
+                invalidateInterpolation();
+            },
+            onRemove: () => {
+                this.#interpolationSubscription.terminate();
+                this.#interpolationSubscription = Terminable.Empty;
+                invalidateInterpolation();
+            }
+        }));
+        this.#interpolationSubscription = this.#box.interpolation.pointerHub
+            .filter(Pointers.ValueInterpolation)
+            .at(0)?.box
+            .subscribe(Propagation.Children, invalidateInterpolation)
+            ?? Terminable.Empty;
+    }
+    onSelected() {
+        this.#isSelected = true;
+        this.collection.ifSome(region => region.onEventPropertyChanged());
+    }
+    onDeselected() {
+        this.#isSelected = false;
+        this.collection.ifSome(region => region.onEventPropertyChanged());
+    }
+    terminate() {
+        this.#interpolationSubscription.terminate();
+        this.#terminator.terminate();
+    }
+    get box() { return this.#box; }
+    get uuid() { return this.#box.address.uuid; }
+    get address() { return this.#box.address; }
+    get position() { return this.#box.position.getValue(); }
+    get index() { return this.#box.index.getValue(); }
+    set interpolation(value) { InterpolationFieldAdapter.write(this.#box.interpolation, value); }
+    get interpolation() { return this.#interpolation.get(); }
+    get value() { return this.#box.value.getValue(); }
+    get isSelected() { return this.#isSelected; }
+    get collection() {
+        return this.#box.events.targetVertex
+            .map(vertex => this.#context.boxAdapters.adapterFor(vertex.box, ValueEventCollectionBoxAdapter));
+    }
+    copyTo(options) {
+        const eventBox = ValueEventBox.create(this.#context.boxGraph, UUID.generate(), box => {
+            box.position.setValue(options?.position ?? this.position);
+            box.index.setValue(options?.index ?? this.index);
+            box.events.refer(options?.events ?? this.collection.unwrap().box.events);
+            box.value.setValue(options?.value ?? this.value);
+        });
+        InterpolationFieldAdapter.write(eventBox.interpolation, options?.interpolation ?? this.interpolation);
+        return this.#context.boxAdapters.adapterFor(eventBox, ValueEventBoxAdapter);
+    }
+    copyFrom(options) {
+        this.#box.position.setValue(options?.position ?? this.position);
+        this.#box.index.setValue(options?.index ?? this.index);
+        this.#box.events.refer(options?.events ?? this.collection.unwrap().box.events);
+        this.#box.value.setValue(options?.value ?? this.value);
+        InterpolationFieldAdapter.write(this.#box.interpolation, options?.interpolation ?? this.interpolation);
+        return this;
+    }
+    toString() { return `{ValueEventBoxAdapter position: ${this.position} index: ${this.index}}`; }
+}

package/dist/timeline/region/AudioRegionBoxAdapter.d.ts

@@ -0,0 +1,53 @@
+import { AudioRegionBox } from "@opendaw/studio-boxes";
+import { int, Nullish, Observer, Option, Subscription, UUID } from "@opendaw/lib-std";
+import { Pointers } from "@opendaw/studio-enums";
+import { Address, Field } from "@opendaw/lib-box";
+import { ppqn } from "@opendaw/lib-dsp";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+import { LoopableRegionBoxAdapter, RegionBoxAdapter, RegionBoxAdapterVisitor } from "../RegionBoxAdapter";
+import { BoxAdaptersContext } from "../../BoxAdaptersContext";
+import { AudioFileBoxAdapter } from "../../AudioFileBoxAdapter";
+type CopyToParams = {
+    track?: Field<Pointers.RegionCollection>;
+    position?: ppqn;
+    duration?: ppqn;
+    loopOffset?: ppqn;
+    loopDuration?: ppqn;
+};
+export declare class AudioRegionBoxAdapter implements LoopableRegionBoxAdapter<never> {
+    #private;
+    readonly type = "audio-region";
+    constructor(context: BoxAdaptersContext, box: AudioRegionBox);
+    subscribeChange(observer: Observer<void>): Subscription;
+    accept<R>(visitor: RegionBoxAdapterVisitor<R>): Nullish<R>;
+    onSelected(): void;
+    onDeselected(): void;
+    get isSelected(): boolean;
+    terminate(): void;
+    get box(): AudioRegionBox;
+    get uuid(): UUID.Format;
+    get address(): Address;
+    get position(): int;
+    get duration(): int;
+    get complete(): int;
+    get loopOffset(): ppqn;
+    get loopDuration(): ppqn;
+    get offset(): ppqn;
+    get mute(): boolean;
+    get hue(): int;
+    get gain(): number;
+    get file(): AudioFileBoxAdapter;
+    get hasCollection(): boolean;
+    get optCollection(): Option<never>;
+    get label(): string;
+    get isMirrowed(): boolean;
+    get canMirror(): boolean;
+    get trackBoxAdapter(): Option<TrackBoxAdapter>;
+    copyTo(params?: CopyToParams): AudioRegionBoxAdapter;
+    consolidate(): void;
+    canFlatten(_regions: ReadonlyArray<RegionBoxAdapter<unknown>>): boolean;
+    flatten(_regions: ReadonlyArray<RegionBoxAdapter<unknown>>): Option<AudioRegionBox>;
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=AudioRegionBoxAdapter.d.ts.map

package/dist/timeline/region/AudioRegionBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioRegionBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/timeline/region/AudioRegionBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAC,GAAG,EAAY,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAe,YAAY,EAAc,IAAI,EAAC,MAAM,kBAAkB,CAAA;AACtH,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,OAAO,EAAE,KAAK,EAAoC,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAO,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAC,wBAAwB,EAAE,gBAAgB,EAAE,uBAAuB,EAAC,MAAM,qBAAqB,CAAA;AACvG,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAA;AAE7D,KAAK,YAAY,GAAG;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,UAAU,CAAC,EAAE,IAAI,CAAA;IACjB,YAAY,CAAC,EAAE,IAAI,CAAA;CACtB,CAAA;AAED,qBAAa,qBAAsB,YAAW,wBAAwB,CAAC,KAAK,CAAC;;IACzE,QAAQ,CAAC,IAAI,kBAAiB;gBAelB,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,cAAc;IA8C5D,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IAEvD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D,UAAU,IAAI,IAAI;IAKlB,YAAY,IAAI,IAAI;IAKpB,IAAI,UAAU,IAAI,OAAO,CAA0B;IAEnD,SAAS;IAET,IAAI,GAAG,IAAI,cAAc,CAAmB;IAE5C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAgC;IACvD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,QAAQ,IAAI,GAAG,CAAuC;IAC1D,IAAI,QAAQ,IAAI,GAAG,CAUlB;IACD,IAAI,QAAQ,IAAI,GAAG,CAAuC;IAC1D,IAAI,UAAU,IAAI,IAAI,CAAyC;IAC/D,IAAI,YAAY,IAAI,IAAI,CAA2C;IACnE,IAAI,MAAM,IAAI,IAAI,CAAyC;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,YAAwC;IACzD,IAAI,aAAa,IAAI,MAAM,CAAC,KAAK,CAAC,CAAqB;IACvD,IAAI,KAAK,IAAI,MAAM,CAMlB;IACD,IAAI,UAAU,IAAI,OAAO,CAAe;IACxC,IAAI,SAAS,IAAI,OAAO,CAAe;IACvC,IAAI,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,CAG7C;IAED,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,qBAAqB;IAepD,WAAW,IAAI,IAAI;IAGnB,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO;IACvE,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;IAInF,QAAQ,IAAI,MAAM;CAOrB"}

package/dist/timeline/region/AudioRegionBoxAdapter.js

@@ -0,0 +1,143 @@
+import { AudioRegionBox } from "@opendaw/studio-boxes";
+import { Notifier, Option, safeExecute, Terminator, UUID } from "@opendaw/lib-std";
+import { Propagation } from "@opendaw/lib-box";
+import { PPQN } from "@opendaw/lib-dsp";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+import { AudioFileBoxAdapter } from "../../AudioFileBoxAdapter";
+export class AudioRegionBoxAdapter {
+    type = "audio-region";
+    #terminator;
+    #context;
+    #box;
+    #changeNotifier;
+    #fileAdapter = Option.None;
+    #fileSubscription = Option.None;
+    #isSelected;
+    #constructing;
+    constructor(context, box) {
+        this.#context = context;
+        this.#box = box;
+        this.#terminator = new Terminator();
+        this.#changeNotifier = new Notifier();
+        this.#isSelected = false;
+        this.#constructing = true;
+        // TODO For unsyned audio samples
+        // this.#terminator.own(this.#project.timelineBox.bpm.subscribe(() => this.trackAdapter.unwrapOrNull()?.dispatchChange()))
+        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) => {
+            if (this.trackBoxAdapter.isEmpty()) {
+                return;
+            }
+            if (update.type === "primitive" || update.type === "pointer") {
+                const track = this.trackBoxAdapter.unwrap();
+                if (this.#box.position.address.equals(update.address)) {
+                    track.regions.onIndexingChanged();
+                    this.#dispatchChange();
+                }
+                else {
+                    this.#dispatchChange();
+                }
+            }
+        }), {
+            terminate: () => {
+                this.#fileSubscription.ifSome(subscription => subscription.terminate());
+                this.#fileSubscription = Option.None;
+            }
+        });
+        this.#constructing = false;
+    }
+    subscribeChange(observer) { return this.#changeNotifier.subscribe(observer); }
+    accept(visitor) {
+        return safeExecute(visitor.visitAudioRegionBoxAdapter, this);
+    }
+    onSelected() {
+        this.#isSelected = true;
+        this.#dispatchChange();
+    }
+    onDeselected() {
+        this.#isSelected = false;
+        this.#dispatchChange();
+    }
+    get isSelected() { return this.#isSelected; }
+    terminate() { this.#terminator.terminate(); }
+    get box() { return this.#box; }
+    get uuid() { return this.#box.address.uuid; }
+    get address() { return this.#box.address; }
+    get position() { return this.#box.position.getValue(); }
+    get duration() {
+        const duration = this.#box.duration.getValue();
+        if (duration === 0) { // signals no synchronization with track bpm
+            const fileBoxAdapter = this.#fileAdapter.unwrap("Cannot compute duration without file");
+            const startInSeconds = fileBoxAdapter.startInSeconds;
+            const endInSeconds = fileBoxAdapter.endInSeconds;
+            const totalInSeconds = endInSeconds - startInSeconds;
+            return PPQN.secondsToPulses(totalInSeconds, this.#context.bpm);
+        }
+        return duration;
+    }
+    get complete() { return this.position + this.duration; }
+    get loopOffset() { return this.#box.loopOffset.getValue(); }
+    get loopDuration() { return this.#box.loopDuration.getValue(); }
+    get offset() { return this.position - this.loopOffset; }
+    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.#fileAdapter.nonEmpty(); }
+    get optCollection() { return Option.None; }
+    get label() {
+        if (this.#fileAdapter.isEmpty()) {
+            return "No Audio File";
+        }
+        const state = this.#fileAdapter.unwrap().getOrCreateAudioLoader().state;
+        if (state.type === "progress") {
+            return `${Math.round(state.progress * 100)}%`;
+        }
+        if (state.type === "error") {
+            return String(state.reason);
+        }
+        return this.#box.label.getValue();
+    }
+    get isMirrowed() { return false; }
+    get canMirror() { return false; }
+    get trackBoxAdapter() {
+        return this.#box.regions.targetVertex
+            .map(vertex => this.#context.boxAdapters.adapterFor(vertex.box, TrackBoxAdapter));
+    }
+    copyTo(params) {
+        return this.#context.boxAdapters.adapterFor(AudioRegionBox.create(this.#context.boxGraph, UUID.generate(), box => {
+            box.position.setValue(params?.position ?? this.position);
+            box.duration.setValue(params?.duration ?? this.duration);
+            box.loopOffset.setValue(params?.loopOffset ?? this.loopOffset);
+            box.loopDuration.setValue(params?.loopDuration ?? this.loopDuration);
+            box.regions.refer(params?.track ?? this.#box.regions.targetVertex.unwrap());
+            box.file.refer(this.#box.file.targetVertex.unwrap());
+            box.mute.setValue(this.mute);
+            box.hue.setValue(this.hue);
+            box.label.setValue(this.label);
+            box.gain.setValue(this.gain);
+        }), AudioRegionBoxAdapter);
+    }
+    consolidate() {
+        // TODO This needs to done by creating a new audio file
+    }
+    canFlatten(_regions) { return false; }
+    flatten(_regions) {
+        // TODO This needs to done by creating a new audio file
+        return Option.None;
+    }
+    toString() { return `{AudioRegionBoxAdapter ${UUID.toString(this.#box.address.uuid)}}`; }
+    #dispatchChange() {
+        if (this.#constructing) {
+            return;
+        }
+        this.#changeNotifier.notify();
+        this.trackBoxAdapter.unwrapOrNull()?.regions?.dispatchChange();
+    }
+}

package/dist/timeline/region/NoteRegionBoxAdapter.d.ts

@@ -0,0 +1,53 @@
+import { NoteEvent, ppqn } from "@opendaw/lib-dsp";
+import { int, Nullish, Observer, Option, Subscription, UUID } from "@opendaw/lib-std";
+import { Address, Field } from "@opendaw/lib-box";
+import { Pointers } from "@opendaw/studio-enums";
+import { NoteRegionBox } from "@opendaw/studio-boxes";
+import { TrackBoxAdapter } from "../TrackBoxAdapter";
+import { LoopableRegionBoxAdapter, RegionBoxAdapter, RegionBoxAdapterVisitor } from "../RegionBoxAdapter";
+import { NoteEventCollectionBoxAdapter } from "../collection/NoteEventCollectionBoxAdapter";
+import { BoxAdaptersContext } from "../../BoxAdaptersContext";
+type CopyToParams = {
+    track?: Field<Pointers.RegionCollection>;
+    position?: ppqn;
+    duration?: ppqn;
+    loopOffset?: ppqn;
+    loopDuration?: ppqn;
+    consolidate?: boolean;
+};
+export declare class NoteRegionBoxAdapter implements LoopableRegionBoxAdapter<NoteEventCollectionBoxAdapter> {
+    #private;
+    readonly type = "note-region";
+    constructor(context: BoxAdaptersContext, box: NoteRegionBox);
+    subscribeChange(observer: Observer<void>): Subscription;
+    accept<R>(visitor: RegionBoxAdapterVisitor<R>): Nullish<R>;
+    onSelected(): void;
+    onDeselected(): void;
+    get isSelected(): boolean;
+    iterateActiveNotesAt(position: ppqn): Generator<NoteEvent>;
+    terminate(): void;
+    get box(): NoteRegionBox;
+    get uuid(): UUID.Format;
+    get address(): Address;
+    get position(): ppqn;
+    get duration(): ppqn;
+    get loopOffset(): ppqn;
+    get loopDuration(): ppqn;
+    get offset(): ppqn;
+    get complete(): ppqn;
+    get mute(): boolean;
+    get hue(): int;
+    get hasCollection(): boolean;
+    get optCollection(): Option<NoteEventCollectionBoxAdapter>;
+    get label(): string;
+    get trackBoxAdapter(): Option<TrackBoxAdapter>;
+    get isMirrowed(): boolean;
+    get canMirror(): boolean;
+    copyTo(params?: CopyToParams): NoteRegionBoxAdapter;
+    consolidate(): void;
+    canFlatten(regions: ReadonlyArray<RegionBoxAdapter<unknown>>): boolean;
+    flatten(regions: ReadonlyArray<RegionBoxAdapter<unknown>>): Option<NoteRegionBox>;
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=NoteRegionBoxAdapter.d.ts.map

package/dist/timeline/region/NoteRegionBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoteRegionBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/timeline/region/NoteRegionBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAE,IAAI,EAAyB,MAAM,kBAAkB,CAAA;AACxF,OAAO,EAEH,GAAG,EAEH,OAAO,EACP,QAAQ,EACR,MAAM,EAEN,YAAY,EAGZ,IAAI,EACP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,OAAO,EAAE,KAAK,EAAsB,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAyB,aAAa,EAAC,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAC,wBAAwB,EAAE,gBAAgB,EAAE,uBAAuB,EAAC,MAAM,qBAAqB,CAAA;AACvG,OAAO,EAAC,6BAA6B,EAAC,MAAM,6CAA6C,CAAA;AACzF,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAE3D,KAAK,YAAY,GAAG;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,UAAU,CAAC,EAAE,IAAI,CAAA;IACjB,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,qBAAa,oBAAqB,YAAW,wBAAwB,CAAC,6BAA6B,CAAC;;IAChG,QAAQ,CAAC,IAAI,iBAAgB;gBAajB,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,aAAa;IAsC3D,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IACvD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAE1D,UAAU,IAAI,IAAI;IAKlB,YAAY,IAAI,IAAI;IAKpB,IAAI,UAAU,IAAI,OAAO,CAA0B;IAEjD,oBAAoB,CAAC,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC;IAa5D,SAAS,IAAI,IAAI;IAKjB,IAAI,GAAG,IAAI,aAAa,CAAmB;IAC3C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAgC;IACvD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,QAAQ,IAAI,IAAI,CAAuC;IAC3D,IAAI,QAAQ,IAAI,IAAI,CAAuC;IAC3D,IAAI,UAAU,IAAI,IAAI,CAAyC;IAC/D,IAAI,YAAY,IAAI,IAAI,CAA2C;IACnE,IAAI,MAAM,IAAI,IAAI,CAAyC;IAC3D,IAAI,QAAQ,IAAI,IAAI,CAAuC;IAC3D,IAAI,IAAI,IAAI,OAAO,CAAmC;IACtD,IAAI,GAAG,IAAI,GAAG,CAAkC;IAChD,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,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,oBAAoB;IAkBnD,WAAW,IAAI,IAAI;IAUnB,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO;IAKtE,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;IA6CjF,QAAQ,IAAI,MAAM;CAMrB"}