@opendaw/studio-core 0.0.11 → 0.0.13

package/dist/ProjectApi.d.ts

@@ -1,13 +1,41 @@
-import { int, Option } from "@opendaw/lib-std";
-import { AudioUnitType } from "@opendaw/studio-enums";
-import { AudioBusBox, NoteRegionBox, TrackBox, ValueRegionBox } from "@opendaw/studio-boxes";
-import { AnyClipBox, AudioUnitBoxAdapter, DeviceHost, IconSymbol, TrackClips, TrackRegions, TrackType } from "@opendaw/studio-adapters";
+import { float, int, Option } from "@opendaw/lib-std";
+import { PointerField } from "@opendaw/lib-box";
+import { AudioUnitType, Pointers } from "@opendaw/studio-enums";
+import { AudioBusBox, NoteEventBox, NoteEventCollectionBox, NoteRegionBox, TrackBox, ValueRegionBox } from "@opendaw/studio-boxes";
+import { AnyClipBox, AudioUnitBoxAdapter, DeviceHost, IconSymbol } from "@opendaw/studio-adapters";
 import { Project } from "./Project";
 import { InstrumentFactory } from "./InstrumentFactory";
 import { InstrumentProduct } from "./InstrumentProduct";
 import { InstrumentOptions } from "./InstrumentOptions";
 import { EffectFactory } from "./EffectFactory";
 import { ppqn } from "@opendaw/lib-dsp";
+export type ClipRegionOptions = {
+    name?: string;
+    hue?: number;
+};
+export type NoteEventParams = {
+    owner: {
+        events: PointerField<Pointers.NoteEventCollection>;
+    };
+    position: ppqn;
+    duration: ppqn;
+    pitch: int;
+    cent?: number;
+    velocity?: float;
+    chance?: int;
+};
+export type NoteRegionParams = {
+    trackBox: TrackBox;
+    position: ppqn;
+    duration: ppqn;
+    loopOffset?: ppqn;
+    loopDuration?: ppqn;
+    eventOffset?: ppqn;
+    eventCollection?: NoteEventCollectionBox;
+    mute?: boolean;
+    name?: string;
+    hue?: number;
+};
 export declare class ProjectApi {
     #private;
     static readonly AudioUnitOrdering: {
@@ -19,14 +47,14 @@ export declare class ProjectApi {
     constructor(project: Project);
     createInstrument({ create, defaultIcon, defaultName, trackType }: InstrumentFactory, { name, icon, index }?: InstrumentOptions): InstrumentProduct;
     createEffect(host: DeviceHost, factory: EffectFactory, newIndex: int): import("@opendaw/lib-box").Box<import("@opendaw/lib-box").PointerTypes, any>;
-    createTrack(adapter: AudioUnitBoxAdapter, trackType: TrackType, index?: int): TrackBox;
-    createClip({ collection, trackBoxAdapter }: TrackClips, clipIndex: int, { name }?: {
-        name?: string;
-    }): Option<AnyClipBox>;
-    createRegion({ trackBoxAdapter }: TrackRegions, position: ppqn, duration: ppqn, { name }?: {
-        name?: string;
-    }): Option<NoteRegionBox> | Option<ValueRegionBox>;
     createAudioBus(name: string, icon: IconSymbol, type: AudioUnitType, color: string): AudioBusBox;
+    createNoteTrack(adapter: AudioUnitBoxAdapter, index?: int): TrackBox;
+    createAudioTrack(adapter: AudioUnitBoxAdapter, index?: int): TrackBox;
+    createAutomationTrack(adapter: AudioUnitBoxAdapter, index?: int): TrackBox;
+    createClip(trackBox: TrackBox, clipIndex: int, { name, hue }?: ClipRegionOptions): Option<AnyClipBox>;
+    createNoteRegion({ trackBox, position, duration, loopOffset, loopDuration, eventOffset, eventCollection, mute, name, hue }: NoteRegionParams): NoteRegionBox;
+    createTrackRegion(trackBox: TrackBox, position: ppqn, duration: ppqn, { name, hue }?: ClipRegionOptions): Option<NoteRegionBox> | Option<ValueRegionBox>;
+    createNoteEvent({ owner, position, duration, velocity, pitch, chance, cent }: NoteEventParams): NoteEventBox;
     deleteAudioUnit(adapter: AudioUnitBoxAdapter): void;
 }
 //# sourceMappingURL=ProjectApi.d.ts.map

package/dist/ProjectApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectApi.d.ts","sourceRoot":"","sources":["../src/ProjectApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,GAAG,EAAE,MAAM,EAAuB,MAAM,kBAAkB,CAAA;AAE1E,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAA;AACnD,OAAO,EACH,WAAW,EAIX,aAAa,EACb,QAAQ,EAGR,cAAc,EACjB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACH,UAAU,EACV,mBAAmB,EACnB,UAAU,EAGV,UAAU,EAEV,UAAU,EACV,YAAY,EACZ,SAAS,EACZ,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,OAAO,EAAC,IAAI,EAAO,MAAM,kBAAkB,CAAA;AAE3C,qBAAa,UAAU;;IACnB,MAAM,CAAC,QAAQ,CAAC,iBAAiB;;;;;MAKvB;gBAIE,OAAO,EAAE,OAAO;IAE5B,gBAAgB,CAAC,EAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAC,EAAE,iBAAiB,EAChE,EAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAC,GAAE,iBAAsB,GAAG,iBAAiB;IAsBhF,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG;IAmBpE,WAAW,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,GAAE,GAAO,GAAG,QAAQ;IASzF,UAAU,CAAC,EAAC,UAAU,EAAE,eAAe,EAAC,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,EAAC,IAAI,EAAC,GAAE;QAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;KACX,GAAG,MAAM,CAAC,UAAU,CAAC;IAoC3B,YAAY,CAAC,EAAC,eAAe,EAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAC,IAAI,EAAC,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO;IAkC5G,cAAc,CAAC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,GAAG,WAAW;IAsB1C,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;CA0CtD"}
+{"version":3,"file":"ProjectApi.d.ts","sourceRoot":"","sources":["../src/ProjectApi.ts"],"names":[],"mappings":"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"}

package/dist/ProjectApi.js

@@ -1,6 +1,6 @@
 import { assert, Option, panic, Strings, UUID } from "@opendaw/lib-std";
 import { AudioUnitType } from "@opendaw/studio-enums";
-import { AudioBusBox, AudioUnitBox, NoteClipBox, NoteEventCollectionBox, NoteRegionBox, TrackBox, ValueClipBox, ValueEventCollectionBox, ValueRegionBox } from "@opendaw/studio-boxes";
+import { AudioBusBox, AudioUnitBox, NoteClipBox, NoteEventBox, NoteEventCollectionBox, NoteRegionBox, TrackBox, ValueClipBox, ValueEventCollectionBox, ValueRegionBox } from "@opendaw/studio-boxes";
 import { AudioUnitBoxAdapter, IconSymbol, TrackType } from "@opendaw/studio-adapters";
 import { ColorCodes } from "./ColorCodes";
 import { PPQN } from "@opendaw/lib-dsp";
@@ -54,31 +54,49 @@ export class ProjectApi {
         }
         return box;
     }
-    createTrack(adapter, trackType, index = 0) {
-        return TrackBox.create(this.#project.boxGraph, UUID.generate(), box => {
-            box.index.setValue(index);
-            box.type.setValue(trackType);
-            box.tracks.refer(adapter.tracksField);
-            box.target.refer(adapter.audioUnitBoxAdapter().box);
+    createAudioBus(name, icon, type, color) {
+        console.debug(`createAudioBus '${name}', type: ${type}, color: ${color}`);
+        const { rootBox, boxGraph } = this.#project;
+        assert(rootBox.audioBusses.isAttached(), "rootBox not attached");
+        const uuid = UUID.generate();
+        const audioBusBox = AudioBusBox.create(boxGraph, uuid, box => {
+            box.collection.refer(rootBox.audioBusses);
+            box.label.setValue(name);
+            box.icon.setValue(IconSymbol.toName(icon));
+            box.color.setValue(color);
         });
+        const audioUnitBox = this.#createAudioUnit(type);
+        TrackBox.create(boxGraph, UUID.generate(), box => {
+            box.tracks.refer(audioUnitBox.tracks);
+            box.target.refer(audioUnitBox);
+            box.index.setValue(0);
+            box.type.setValue(TrackType.Undefined);
+        });
+        audioBusBox.output.refer(audioUnitBox.input);
+        return audioBusBox;
     }
-    createClip({ collection, trackBoxAdapter }, clipIndex, { name } = {}) {
-        if (collection.getAdapterByIndex(clipIndex).nonEmpty()) {
-            console.warn("Cannot create Clip on occupied cell.");
-            return Option.None;
-        }
+    createNoteTrack(adapter, index = 0) {
+        return this.#createTrack(adapter, TrackType.Notes, index);
+    }
+    createAudioTrack(adapter, index = 0) {
+        return this.#createTrack(adapter, TrackType.Audio, index);
+    }
+    createAutomationTrack(adapter, index = 0) {
+        return this.#createTrack(adapter, TrackType.Value, index);
+    }
+    createClip(trackBox, clipIndex, { name, hue } = {}) {
         const { boxGraph } = this.#project;
-        const type = trackBoxAdapter.type;
+        const type = trackBox.type.getValue();
         switch (type) {
             case TrackType.Notes: {
                 const events = NoteEventCollectionBox.create(boxGraph, UUID.generate());
                 return Option.wrap(NoteClipBox.create(boxGraph, UUID.generate(), box => {
                     box.index.setValue(clipIndex);
                     box.label.setValue(name ?? "Notes");
-                    box.hue.setValue(ColorCodes.forTrackType(type));
+                    box.hue.setValue(hue ?? ColorCodes.forTrackType(type));
                     box.mute.setValue(false);
                     box.duration.setValue(PPQN.Bar);
-                    box.clips.refer(trackBoxAdapter.box.clips);
+                    box.clips.refer(trackBox.clips);
                     box.events.refer(events.owners);
                 }));
             }
@@ -86,32 +104,48 @@ export class ProjectApi {
                 const events = ValueEventCollectionBox.create(boxGraph, UUID.generate());
                 return Option.wrap(ValueClipBox.create(boxGraph, UUID.generate(), box => {
                     box.index.setValue(clipIndex);
-                    box.label.setValue(name ?? "CV");
-                    box.hue.setValue(ColorCodes.forTrackType(type));
+                    box.label.setValue(name ?? "Automation");
+                    box.hue.setValue(hue ?? ColorCodes.forTrackType(type));
                     box.mute.setValue(false);
                     box.duration.setValue(PPQN.Bar);
                     box.events.refer(events.owners);
-                    box.clips.refer(trackBoxAdapter.box.clips);
+                    box.clips.refer(trackBox.clips);
                 }));
             }
         }
         return Option.None;
     }
-    createRegion({ trackBoxAdapter }, position, duration, { name } = {}) {
+    createNoteRegion({ trackBox, position, duration, loopOffset, loopDuration, eventOffset, eventCollection, mute, name, hue }) {
         const { boxGraph } = this.#project;
-        const type = trackBoxAdapter.type;
+        const events = eventCollection ?? NoteEventCollectionBox.create(boxGraph, UUID.generate());
+        return NoteRegionBox.create(boxGraph, UUID.generate(), box => {
+            box.position.setValue(position);
+            box.label.setValue(name ?? "Notes");
+            box.hue.setValue(hue ?? ColorCodes.forTrackType(trackBox.type.getValue()));
+            box.mute.setValue(mute ?? false);
+            box.duration.setValue(duration);
+            box.loopDuration.setValue(loopOffset ?? 0);
+            box.loopDuration.setValue(loopDuration ?? duration);
+            box.eventOffset.setValue(eventOffset ?? 0);
+            box.events.refer(events.owners);
+            box.regions.refer(trackBox.regions);
+        });
+    }
+    createTrackRegion(trackBox, position, duration, { name, hue } = {}) {
+        const { boxGraph } = this.#project;
+        const type = trackBox.type.getValue();
         switch (type) {
             case TrackType.Notes: {
                 const events = NoteEventCollectionBox.create(boxGraph, UUID.generate());
                 return Option.wrap(NoteRegionBox.create(boxGraph, UUID.generate(), box => {
                     box.position.setValue(Math.max(position, 0));
                     box.label.setValue(name ?? "Notes");
-                    box.hue.setValue(ColorCodes.forTrackType(type));
+                    box.hue.setValue(hue ?? ColorCodes.forTrackType(type));
                     box.mute.setValue(false);
                     box.duration.setValue(duration);
                     box.loopDuration.setValue(PPQN.Bar);
                     box.events.refer(events.owners);
-                    box.regions.refer(trackBoxAdapter.box.regions);
+                    box.regions.refer(trackBox.regions);
                 }));
             }
             case TrackType.Value: {
@@ -119,37 +153,30 @@ export class ProjectApi {
                 return Option.wrap(ValueRegionBox.create(boxGraph, UUID.generate(), box => {
                     box.position.setValue(Math.max(position, 0));
                     box.label.setValue(name ?? "Automation");
-                    box.hue.setValue(ColorCodes.forTrackType(type));
+                    box.hue.setValue(hue ?? ColorCodes.forTrackType(type));
                     box.mute.setValue(false);
                     box.duration.setValue(duration);
                     box.loopDuration.setValue(PPQN.Bar);
                     box.events.refer(events.owners);
-                    box.regions.refer(trackBoxAdapter.box.regions);
+                    box.regions.refer(trackBox.regions);
                 }));
             }
         }
         return Option.None;
     }
-    createAudioBus(name, icon, type, color) {
-        console.debug(`createAudioBus '${name}', type: ${type}, color: ${color}`);
-        const { rootBox, boxGraph } = this.#project;
-        assert(rootBox.audioBusses.isAttached(), "rootBox not attached");
-        const uuid = UUID.generate();
-        const audioBusBox = AudioBusBox.create(boxGraph, uuid, box => {
-            box.collection.refer(rootBox.audioBusses);
-            box.label.setValue(name);
-            box.icon.setValue(IconSymbol.toName(icon));
-            box.color.setValue(color);
-        });
-        const audioUnitBox = this.#createAudioUnit(type);
-        TrackBox.create(boxGraph, UUID.generate(), box => {
-            box.tracks.refer(audioUnitBox.tracks);
-            box.target.refer(audioUnitBox);
-            box.index.setValue(0);
-            box.type.setValue(TrackType.Undefined);
+    createNoteEvent({ owner, position, duration, velocity, pitch, chance, cent }) {
+        const { boxGraph } = this.#project;
+        return NoteEventBox.create(boxGraph, UUID.generate(), box => {
+            box.position.setValue(position);
+            box.duration.setValue(duration);
+            box.velocity.setValue(velocity ?? 1.0);
+            box.pitch.setValue(pitch);
+            box.chance.setValue(chance ?? 100.0);
+            box.cent.setValue(cent ?? 0.0);
+            box.events.refer(owner.events.targetVertex
+                .unwrap("Owner has no event-collection").box
+                .asBox(NoteEventCollectionBox).events);
         });
-        audioBusBox.output.refer(audioUnitBox.input);
-        return audioBusBox;
     }
     deleteAudioUnit(adapter) {
         const { rootBoxAdapter } = this.#project;
@@ -180,6 +207,14 @@ export class ProjectApi {
             box.type.setValue(type);
         });
     }
+    #createTrack(adapter, trackType, index = 0) {
+        return TrackBox.create(this.#project.boxGraph, UUID.generate(), box => {
+            box.index.setValue(index);
+            box.type.setValue(trackType);
+            box.tracks.refer(adapter.tracksField);
+            box.target.refer(adapter.audioUnitBoxAdapter().box);
+        });
+    }
     #pushAudioUnitsIndices(rootBoxAdapter, type, count = 1) {
         const adapters = rootBoxAdapter.audioUnits.adapters();
         const order = ProjectApi.AudioUnitOrdering[type];