@opendaw/studio-core 0.0.9 → 0.0.11

package/dist/EffectFactories.d.ts

@@ -0,0 +1,38 @@
+import { EffectFactory } from "./EffectFactory";
+export declare namespace Effects {
+    const Arpeggio: EffectFactory;
+    const Pitch: EffectFactory;
+    const Zeitgeist: EffectFactory;
+    const StereoTool: EffectFactory;
+    const Delay: EffectFactory;
+    const Reverb: EffectFactory;
+    const Revamp: EffectFactory;
+    const Modular: EffectFactory;
+    const MidiNamed: {
+        Arpeggio: EffectFactory;
+        Pitch: EffectFactory;
+        Zeitgeist: EffectFactory;
+    };
+    const AudioNamed: {
+        StereoTool: EffectFactory;
+        Delay: EffectFactory;
+        Reverb: EffectFactory;
+        Revamp: EffectFactory;
+        Modular: EffectFactory;
+    };
+    const MidiList: ReadonlyArray<Readonly<EffectFactory>>;
+    const AudioList: ReadonlyArray<Readonly<EffectFactory>>;
+    const MergedNamed: {
+        StereoTool: EffectFactory;
+        Delay: EffectFactory;
+        Reverb: EffectFactory;
+        Revamp: EffectFactory;
+        Modular: EffectFactory;
+        Arpeggio: EffectFactory;
+        Pitch: EffectFactory;
+        Zeitgeist: EffectFactory;
+    };
+    type MidiEffectKeys = keyof typeof MidiNamed;
+    type AudioEffectKeys = keyof typeof AudioNamed;
+}
+//# sourceMappingURL=EffectFactories.d.ts.map

package/dist/EffectFactories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectFactories.d.ts","sourceRoot":"","sources":["../src/EffectFactories.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,yBAAiB,OAAO,CAAC;IACd,MAAM,QAAQ,EAAE,aAWtB,CAAA;IAEM,MAAM,KAAK,EAAE,aAWnB,CAAA;IAEM,MAAM,SAAS,EAAE,aAqBvB,CAAA;IAEM,MAAM,UAAU,EAAE,aAWxB,CAAA;IAEM,MAAM,KAAK,EAAE,aAWnB,CAAA;IAEM,MAAM,MAAM,EAAE,aAYpB,CAAA;IAEM,MAAM,MAAM,EAAE,aA+BpB,CAAA;IAEM,MAAM,OAAO,EAAE,aAoCrB,CAAA;IAEM,MAAM,SAAS;;;;KAA+B,CAAA;IAC9C,MAAM,UAAU;;;;;;KAA+C,CAAA;IAE/D,MAAM,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA4B,CAAA;IACjF,MAAM,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA6B,CAAA;IACnF,MAAM,WAAW;;;;;;;;;KAAgC,CAAA;IAExD,KAAY,cAAc,GAAG,MAAM,OAAO,SAAS,CAAA;IACnD,KAAY,eAAe,GAAG,MAAM,OAAO,UAAU,CAAA;CACxD"}

package/dist/EffectFactories.js

@@ -0,0 +1,163 @@
+import { INVERSE_SQRT_2, UUID } from "@opendaw/lib-std";
+import { ArpeggioDeviceBox, DelayDeviceBox, GrooveShuffleBox, ModularAudioInputBox, ModularAudioOutputBox, ModularBox, ModularDeviceBox, ModuleConnectionBox, PitchDeviceBox, RevampDeviceBox, ReverbDeviceBox, StereoToolDeviceBox, ZeitgeistDeviceBox } from "@opendaw/studio-boxes";
+import { IconSymbol } from "@opendaw/studio-adapters";
+export var Effects;
+(function (Effects) {
+    Effects.Arpeggio = {
+        defaultName: "Arpeggio",
+        defaultIcon: IconSymbol.Stack,
+        description: "Generates rhythmic note sequences from chords",
+        separatorBefore: false,
+        type: "midi",
+        create: ({ boxGraph }, unit, index) => ArpeggioDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue("Arpeggio");
+            box.index.setValue(index);
+            box.host.refer(unit);
+        })
+    };
+    Effects.Pitch = {
+        defaultName: "Pitch",
+        defaultIcon: IconSymbol.Note,
+        description: "Shifts the pitch of incoming notes",
+        separatorBefore: false,
+        type: "midi",
+        create: ({ boxGraph }, unit, index) => PitchDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue("Pitch");
+            box.index.setValue(index);
+            box.host.refer(unit);
+        })
+    };
+    Effects.Zeitgeist = {
+        defaultName: "Zeitgeist",
+        defaultIcon: IconSymbol.Zeitgeist,
+        description: "Distorts space and time",
+        separatorBefore: false,
+        type: "midi",
+        create: ({ boxGraph, rootBoxAdapter }, unit, index) => {
+            const useGlobal = false; // TODO First Zeitgeist should be true
+            const shuffleBox = useGlobal
+                ? rootBoxAdapter.groove.box
+                : GrooveShuffleBox.create(boxGraph, UUID.generate(), box => {
+                    box.label.setValue("Shuffle");
+                    box.duration.setValue(480);
+                });
+            return ZeitgeistDeviceBox.create(boxGraph, UUID.generate(), box => {
+                box.label.setValue("Zeitgeist");
+                box.groove.refer(shuffleBox);
+                box.index.setValue(index);
+                box.host.refer(unit);
+            });
+        }
+    };
+    Effects.StereoTool = {
+        defaultName: "Stereo Tool",
+        defaultIcon: IconSymbol.Stereo,
+        description: "Computes a stereo transformation matrix with volume, panning, phase inversion and stereo width.",
+        separatorBefore: false,
+        type: "audio",
+        create: ({ boxGraph }, unit, index) => StereoToolDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue("Stereo Tool");
+            box.index.setValue(index);
+            box.host.refer(unit);
+        })
+    };
+    Effects.Delay = {
+        defaultName: "Delay",
+        defaultIcon: IconSymbol.Time,
+        description: "Echoes the input signal with time-based repeats",
+        separatorBefore: false,
+        type: "audio",
+        create: ({ boxGraph }, unit, index) => DelayDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue("Delay");
+            box.index.setValue(index);
+            box.host.refer(unit);
+        })
+    };
+    Effects.Reverb = {
+        defaultName: "Reverb",
+        defaultIcon: IconSymbol.Cube,
+        description: "Simulates space and depth with reflections",
+        separatorBefore: false,
+        type: "audio",
+        create: ({ boxGraph }, unit, index) => ReverbDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue("Reverb");
+            box.preDelay.setInitValue(0.001);
+            box.index.setValue(index);
+            box.host.refer(unit);
+        })
+    };
+    Effects.Revamp = {
+        defaultName: "Revamp",
+        defaultIcon: IconSymbol.EQ,
+        description: "Shapes the frequency balance of the sound",
+        separatorBefore: false,
+        type: "audio",
+        create: ({ boxGraph }, unit, index) => RevampDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue("Revamp");
+            box.highPass.frequency.setInitValue(40.0);
+            box.highPass.order.setInitValue(2);
+            box.highPass.q.setInitValue(INVERSE_SQRT_2);
+            box.highPass.enabled.setInitValue(true);
+            box.lowShelf.frequency.setInitValue(80.0);
+            box.lowShelf.gain.setInitValue(6);
+            box.lowBell.frequency.setInitValue(120.0);
+            box.lowBell.gain.setInitValue(6);
+            box.lowBell.q.setInitValue(INVERSE_SQRT_2);
+            box.midBell.frequency.setInitValue(640.0);
+            box.midBell.q.setInitValue(INVERSE_SQRT_2);
+            box.midBell.gain.setInitValue(6);
+            box.highBell.frequency.setInitValue(3600.0);
+            box.highBell.q.setInitValue(INVERSE_SQRT_2);
+            box.highBell.gain.setInitValue(6);
+            box.highShelf.frequency.setInitValue(10000.0);
+            box.highShelf.gain.setInitValue(6);
+            box.lowPass.frequency.setInitValue(15000.0);
+            box.lowPass.order.setInitValue(2);
+            box.lowPass.q.setInitValue(INVERSE_SQRT_2);
+            box.index.setValue(index);
+            box.host.refer(unit);
+        })
+    };
+    Effects.Modular = {
+        defaultName: "🔇 Create New Modular Audio Effect (inaudible yet)",
+        defaultIcon: IconSymbol.Box,
+        description: "",
+        separatorBefore: true,
+        type: "audio",
+        create: ({ boxGraph, rootBox, userEditingManager }, unit, index) => {
+            const moduleSetupBox = ModularBox.create(boxGraph, UUID.generate(), box => {
+                box.collection.refer(rootBox.modularSetups);
+                box.label.setValue("Modular");
+            });
+            const modularInput = ModularAudioInputBox.create(boxGraph, UUID.generate(), box => {
+                box.attributes.collection.refer(moduleSetupBox.modules);
+                box.attributes.label.setValue("Modular Input");
+                box.attributes.x.setValue(-256);
+                box.attributes.y.setValue(32);
+            });
+            const modularOutput = ModularAudioOutputBox.create(boxGraph, UUID.generate(), box => {
+                box.attributes.collection.refer(moduleSetupBox.modules);
+                box.attributes.label.setValue("Modular Output");
+                box.attributes.x.setValue(256);
+                box.attributes.y.setValue(32);
+            });
+            ModuleConnectionBox.create(boxGraph, UUID.generate(), box => {
+                box.collection.refer(moduleSetupBox.connections);
+                box.source.refer(modularInput.output);
+                box.target.refer(modularOutput.input);
+            });
+            userEditingManager.modularSystem.edit(moduleSetupBox.editing);
+            return ModularDeviceBox.create(boxGraph, UUID.generate(), box => {
+                box.label.setValue("Modular");
+                box.modularSetup.refer(moduleSetupBox.device);
+                box.index.setValue(index);
+                box.host.refer(unit);
+            });
+        }
+    };
+    Effects.MidiNamed = { Arpeggio: Effects.Arpeggio, Pitch: Effects.Pitch, Zeitgeist: Effects.Zeitgeist };
+    Effects.AudioNamed = { StereoTool: Effects.StereoTool, Delay: Effects.Delay, Reverb: Effects.Reverb, Revamp: Effects.Revamp, Modular: Effects.Modular };
+    Effects.MidiList = Object.values(Effects.MidiNamed);
+    Effects.AudioList = Object.values(Effects.AudioNamed);
+    Effects.MergedNamed = { ...Effects.MidiNamed, ...Effects.AudioNamed };
+})(Effects || (Effects = {}));

package/dist/EffectFactory.d.ts

@@ -0,0 +1,13 @@
+import { EffectPointerType, IconSymbol } from "@opendaw/studio-adapters";
+import { Box, Field } from "@opendaw/lib-box";
+import { int } from "@opendaw/lib-std";
+import { Project } from "./Project";
+export interface EffectFactory {
+    get defaultName(): string;
+    get defaultIcon(): IconSymbol;
+    get description(): string;
+    get separatorBefore(): boolean;
+    get type(): "audio" | "midi";
+    create(project: Project, unit: Field<EffectPointerType>, index: int): Box;
+}
+//# sourceMappingURL=EffectFactory.d.ts.map

package/dist/EffectFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectFactory.d.ts","sourceRoot":"","sources":["../src/EffectFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAE,UAAU,EAAC,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAC,GAAG,EAAE,KAAK,EAAC,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAC,GAAG,EAAC,MAAM,kBAAkB,CAAA;AACpC,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEjC,MAAM,WAAW,aAAa;IAC1B,IAAI,WAAW,IAAI,MAAM,CAAA;IACzB,IAAI,WAAW,IAAI,UAAU,CAAA;IAC7B,IAAI,WAAW,IAAI,MAAM,CAAA;IACzB,IAAI,eAAe,IAAI,OAAO,CAAA;IAC9B,IAAI,IAAI,IAAI,OAAO,GAAG,MAAM,CAAA;IAE5B,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAAA;CAC5E"}

package/dist/EffectFactory.js

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

package/dist/InstrumentBox.d.ts

@@ -0,0 +1,3 @@
+import { NanoDeviceBox, PlayfieldDeviceBox, TapeDeviceBox, VaporisateurDeviceBox } from "@opendaw/studio-boxes";
+export type InstrumentBox = TapeDeviceBox | VaporisateurDeviceBox | NanoDeviceBox | PlayfieldDeviceBox;
+//# sourceMappingURL=InstrumentBox.d.ts.map

package/dist/InstrumentBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstrumentBox.d.ts","sourceRoot":"","sources":["../src/InstrumentBox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAA;AAE7G,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,qBAAqB,GAAG,aAAa,GAAG,kBAAkB,CAAA"}

package/dist/InstrumentBox.js

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

package/dist/InstrumentFactories.d.ts

@@ -0,0 +1,15 @@
+import { InstrumentFactory } from "./InstrumentFactory";
+export declare namespace InstrumentFactories {
+    const Tape: InstrumentFactory;
+    const Nano: InstrumentFactory;
+    const Playfield: InstrumentFactory;
+    const Vaporisateur: InstrumentFactory;
+    const Named: {
+        Vaporisateur: InstrumentFactory;
+        Playfield: InstrumentFactory;
+        Nano: InstrumentFactory;
+        Tape: InstrumentFactory;
+    };
+    type Keys = keyof typeof Named;
+}
+//# sourceMappingURL=InstrumentFactories.d.ts.map

package/dist/InstrumentFactories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstrumentFactories.d.ts","sourceRoot":"","sources":["../src/InstrumentFactories.ts"],"names":[],"mappings":"AAaA,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAA;AAErD,yBAAiB,mBAAmB,CAAC;IAC1B,MAAM,IAAI,EAAE,iBAelB,CAAA;IAEM,MAAM,IAAI,EAAE,iBAkBlB,CAAA;IAEM,MAAM,SAAS,EAAE,iBAiCvB,CAAA;IAEM,MAAM,YAAY,EAAE,iBAiB1B,CAAA;IAEM,MAAM,KAAK;;;;;KAAwC,CAAA;IAC1D,KAAY,IAAI,GAAG,MAAM,OAAO,KAAK,CAAA;CAMxC"}

package/dist/InstrumentFactories.js

@@ -0,0 +1,97 @@
+import { AudioFileBox, NanoDeviceBox, PlayfieldDeviceBox, PlayfieldSampleBox, TapeDeviceBox, VaporisateurDeviceBox } from "@opendaw/studio-boxes";
+import { UUID } from "@opendaw/lib-std";
+import { Waveform } from "@opendaw/lib-dsp";
+import { IconSymbol, TrackType } from "@opendaw/studio-adapters";
+export var InstrumentFactories;
+(function (InstrumentFactories) {
+    InstrumentFactories.Tape = {
+        defaultName: "Tape",
+        defaultIcon: IconSymbol.Tape,
+        description: "Plays audio regions & clips",
+        trackType: TrackType.Audio,
+        create: (boxGraph, deviceHost, name, icon) => TapeDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue(name);
+            box.icon.setValue(IconSymbol.toName(icon));
+            box.flutter.setValue(0.2);
+            box.wow.setValue(0.05);
+            box.noise.setValue(0.02);
+            box.saturation.setValue(0.5);
+            box.host.refer(deviceHost.inputField);
+        })
+    };
+    InstrumentFactories.Nano = {
+        defaultName: "Nano",
+        defaultIcon: IconSymbol.NanoWave,
+        description: "Simple sampler",
+        trackType: TrackType.Notes,
+        create: (boxGraph, deviceHost, name, icon) => {
+            const fileUUID = UUID.parse("c1678daa-4a47-4cba-b88f-4f4e384663c3");
+            const audioFileBox = boxGraph.findBox(fileUUID)
+                .unwrapOrElse(() => AudioFileBox.create(boxGraph, fileUUID, box => {
+                box.fileName.setValue("Rhode");
+            }));
+            return NanoDeviceBox.create(boxGraph, UUID.generate(), box => {
+                box.label.setValue(name);
+                box.icon.setValue(IconSymbol.toName(icon));
+                box.file.refer(audioFileBox);
+                box.host.refer(deviceHost.inputField);
+            });
+        }
+    };
+    InstrumentFactories.Playfield = {
+        defaultName: "Playfield",
+        defaultIcon: IconSymbol.Playfield,
+        description: "Drum computer",
+        trackType: TrackType.Notes,
+        create: (boxGraph, deviceHost, name, icon) => {
+            const deviceBox = PlayfieldDeviceBox.create(boxGraph, UUID.generate(), box => {
+                box.label.setValue(name);
+                box.icon.setValue(IconSymbol.toName(icon));
+                box.host.refer(deviceHost.inputField);
+            });
+            const files = [
+                useFile(boxGraph, UUID.parse("8bb2c6e8-9a6d-4d32-b7ec-1263594ef367"), "909 Bassdrum"),
+                useFile(boxGraph, UUID.parse("0017fa18-a5eb-4d9d-b6f2-e2ddd30a3010"), "909 Snare"),
+                useFile(boxGraph, UUID.parse("28d14cb9-1dc6-4193-9dd7-4e881f25f520"), "909 Low Tom"),
+                useFile(boxGraph, UUID.parse("21f92306-d6e7-446c-a34b-b79620acfefc"), "909 Mid Tom"),
+                useFile(boxGraph, UUID.parse("ad503883-8a72-46ab-a05b-a84149953e17"), "909 High Tom"),
+                useFile(boxGraph, UUID.parse("cfee850b-7658-4d08-9e3b-79d196188504"), "909 Rimshot"),
+                useFile(boxGraph, UUID.parse("32a6f36f-06eb-4b84-bb57-5f51103eb9e6"), "909 Clap"),
+                useFile(boxGraph, UUID.parse("e0ac4b39-23fb-4a56-841d-c9e0ff440cab"), "909 Closed Hat"),
+                useFile(boxGraph, UUID.parse("51c5eea4-391c-4743-896a-859692ec1105"), "909 Open Hat"),
+                useFile(boxGraph, UUID.parse("42a56ff6-89b6-4f2e-8a66-5a41d316f4cb"), "909 Crash"),
+                useFile(boxGraph, UUID.parse("87cde966-b799-4efc-a994-069e703478d3"), "909 Ride")
+            ];
+            const samples = files.map((file, index) => PlayfieldSampleBox.create(boxGraph, UUID.generate(), box => {
+                box.device.refer(deviceBox.samples);
+                box.file.refer(file);
+                box.index.setValue(60 + index);
+            }));
+            samples[7].exclude.setValue(true);
+            samples[8].exclude.setValue(true);
+            return deviceBox;
+        }
+    };
+    InstrumentFactories.Vaporisateur = {
+        defaultName: "Vaporisateur",
+        defaultIcon: IconSymbol.Piano,
+        description: "Classic subtractive synthesizer",
+        trackType: TrackType.Notes,
+        create: (boxGraph, deviceHost, name, icon) => VaporisateurDeviceBox.create(boxGraph, UUID.generate(), box => {
+            box.label.setValue(name);
+            box.icon.setValue(IconSymbol.toName(icon));
+            box.tune.setInitValue(0.0);
+            box.cutoff.setInitValue(1000.0);
+            box.resonance.setInitValue(0.1);
+            box.attack.setInitValue(0.005);
+            box.release.setInitValue(0.1);
+            box.waveform.setInitValue(Waveform.sine);
+            box.host.refer(deviceHost.inputField);
+        })
+    };
+    InstrumentFactories.Named = { Vaporisateur: InstrumentFactories.Vaporisateur, Playfield: InstrumentFactories.Playfield, Nano: InstrumentFactories.Nano, Tape: InstrumentFactories.Tape };
+    const useFile = (boxGraph, fileUUID, name) => boxGraph.findBox(fileUUID)
+        .unwrapOrElse(() => AudioFileBox.create(boxGraph, fileUUID, box => {
+        box.fileName.setValue(name);
+    }));
+})(InstrumentFactories || (InstrumentFactories = {}));

package/dist/InstrumentFactory.d.ts

@@ -0,0 +1,11 @@
+import { DeviceHost, IconSymbol, TrackType } from "@opendaw/studio-adapters";
+import { BoxGraph } from "@opendaw/lib-box";
+import { InstrumentBox } from "./InstrumentBox";
+export interface InstrumentFactory {
+    defaultName: string;
+    defaultIcon: IconSymbol;
+    description: string;
+    trackType: TrackType;
+    create: (boxGraph: BoxGraph, deviceHost: DeviceHost, name: string, icon: IconSymbol) => InstrumentBox;
+}
+//# sourceMappingURL=InstrumentFactory.d.ts.map

package/dist/InstrumentFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstrumentFactory.d.ts","sourceRoot":"","sources":["../src/InstrumentFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAC,MAAM,0BAA0B,CAAA;AAC1E,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,aAAa,CAAA;CACxG"}

package/dist/InstrumentFactory.js

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

package/dist/InstrumentOptions.d.ts

@@ -0,0 +1,8 @@
+import { IconSymbol } from "@opendaw/studio-adapters";
+import { int } from "@opendaw/lib-std";
+export type InstrumentOptions = {
+    name?: string;
+    icon?: IconSymbol;
+    index?: int;
+};
+//# sourceMappingURL=InstrumentOptions.d.ts.map

package/dist/InstrumentOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstrumentOptions.d.ts","sourceRoot":"","sources":["../src/InstrumentOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAC,GAAG,EAAC,MAAM,kBAAkB,CAAA;AAEpC,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAA;CAAE,CAAA"}

package/dist/InstrumentOptions.js

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

package/dist/InstrumentProduct.d.ts

@@ -0,0 +1,8 @@
+import { AudioUnitBox, TrackBox } from "@opendaw/studio-boxes";
+import { InstrumentBox } from "./InstrumentBox";
+export type InstrumentProduct = {
+    audioUnitBox: AudioUnitBox;
+    instrumentBox: InstrumentBox;
+    trackBox: TrackBox;
+};
+//# sourceMappingURL=InstrumentProduct.d.ts.map

package/dist/InstrumentProduct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstrumentProduct.d.ts","sourceRoot":"","sources":["../src/InstrumentProduct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAE5D,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,MAAM,iBAAiB,GAAG;IAC5B,YAAY,EAAE,YAAY,CAAA;IAC1B,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,QAAQ,CAAA;CACrB,CAAA"}

package/dist/InstrumentProduct.js

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

package/dist/Project.d.ts

@@ -1,10 +1,11 @@
 import { Terminable, TerminableOwner, Terminator } from "@opendaw/lib-std";
 import { BoxGraph, Editing } from "@opendaw/lib-box";
 import { AudioBusBox, AudioUnitBox, BoxIO, RootBox, TimelineBox, UserInterfaceBox } from "@opendaw/studio-boxes";
-import { SampleManager, BoxAdapters, BoxAdaptersContext, ClipSequencing, ParameterFieldAdapters, RootBoxAdapter, TimelineBoxAdapter, UserEditingManager, VertexSelection } from "@opendaw/studio-adapters";
+import { BoxAdapters, BoxAdaptersContext, ClipSequencing, ParameterFieldAdapters, RootBoxAdapter, SampleManager, TimelineBoxAdapter, UserEditingManager, VertexSelection } from "@opendaw/studio-adapters";
 import { LiveStreamBroadcaster, LiveStreamReceiver } from "@opendaw/lib-fusion";
 import { ProjectEnv } from "./ProjectEnv";
 import { Mixer } from "./Mixer";
+import { ProjectApi } from "./ProjectApi";
 export declare class Project implements BoxAdaptersContext, Terminable, TerminableOwner {
     #private;
     static new(env: ProjectEnv): Project;
@@ -15,6 +16,7 @@ export declare class Project implements BoxAdaptersContext, Terminable, Terminab
     readonly masterBusBox: AudioBusBox;
     readonly masterAudioUnit: AudioUnitBox;
     readonly timelineBox: TimelineBox;
+    readonly api: ProjectApi;
     readonly editing: Editing;
     readonly selection: VertexSelection;
     readonly boxAdapters: BoxAdapters;

package/dist/Project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../src/Project.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,UAAU,EACV,eAAe,EACf,UAAU,EAEb,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,QAAQ,EAAE,OAAO,EAAC,MAAM,kBAAkB,CAAA;AAClD,OAAO,EACH,WAAW,EACX,YAAY,EACZ,KAAK,EAGL,OAAO,EACP,WAAW,EACX,gBAAgB,EAInB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACH,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,cAAc,EAGd,sBAAsB,EAEtB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAClB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAC,qBAAqB,EAAE,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAE7E,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AACvC,OAAO,EAAC,KAAK,EAAC,MAAM,SAAS,CAAA;AAI7B,qBAAa,OAAQ,YAAW,kBAAkB,EAAE,UAAU,EAAE,eAAe;;IAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAuCpC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO;IA8D/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAE1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IAEjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAA;IACvD,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IAErB,OAAO;IA6BP,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC;IAC3C,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAC5D,KAAK,IAAI,UAAU;IAEnB,IAAI,GAAG,IAAI,MAAM,CAAyC;IAC1D,IAAI,cAAc,IAAI,cAAc,CAAmE;IACvG,IAAI,kBAAkB,IAAI,kBAAkB,CAA2E;IACvH,IAAI,YAAY,IAAI,aAAa,CAAiC;IAClE,IAAI,cAAc,IAAI,cAAc,CAAkD;IACtF,IAAI,cAAc,IAAI,OAAO,CAAe;IAC5C,IAAI,YAAY,IAAI,OAAO,CAAc;IACzC,IAAI,qBAAqB,IAAI,qBAAqB,CAAkD;IAEpG,aAAa,IAAI,eAAe;IAiBhC,IAAI,IAAI,OAAO;IAEf,SAAS,IAAI,IAAI;CACpB"}
+{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../src/Project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,UAAU,EAAE,eAAe,EAAE,UAAU,EAAO,MAAM,kBAAkB,CAAA;AAC9G,OAAO,EAAC,QAAQ,EAAE,OAAO,EAAC,MAAM,kBAAkB,CAAA;AAClD,OAAO,EACH,WAAW,EACX,YAAY,EACZ,KAAK,EAEL,OAAO,EACP,WAAW,EACX,gBAAgB,EACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,cAAc,EAGd,sBAAsB,EAEtB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAClB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAC,qBAAqB,EAAE,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAE7E,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AACvC,OAAO,EAAC,KAAK,EAAC,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AAKvC,qBAAa,OAAQ,YAAW,kBAAkB,EAAE,UAAU,EAAE,eAAe;;IAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAuCpC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO;IAS/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAE1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IAEjC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAA;IACvD,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IAErB,OAAO;IA8BP,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC;IAC3C,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAC5D,KAAK,IAAI,UAAU;IAEnB,IAAI,GAAG,IAAI,MAAM,CAAyC;IAC1D,IAAI,cAAc,IAAI,cAAc,CAAmE;IACvG,IAAI,kBAAkB,IAAI,kBAAkB,CAA2E;IACvH,IAAI,YAAY,IAAI,aAAa,CAAiC;IAClE,IAAI,cAAc,IAAI,cAAc,CAAkD;IACtF,IAAI,cAAc,IAAI,OAAO,CAAe;IAC5C,IAAI,YAAY,IAAI,OAAO,CAAc;IACzC,IAAI,qBAAqB,IAAI,qBAAqB,CAAkD;IAEpG,aAAa,IAAI,eAAe;IAiBhC,IAAI,IAAI,OAAO;IAEf,SAAS,IAAI,IAAI;CACpB"}

package/dist/Project.js

@@ -1,10 +1,12 @@
-import { asInstanceOf, ByteArrayOutput, Option, panic, Terminator, UUID } from "@opendaw/lib-std";
+import { ByteArrayOutput, Option, panic, Terminator, UUID } from "@opendaw/lib-std";
 import { BoxGraph, Editing } from "@opendaw/lib-box";
-import { AudioBusBox, AudioUnitBox, BoxIO, GrooveShuffleBox, RootBox, TimelineBox, UserInterfaceBox, ValueEventCurveBox } from "@opendaw/studio-boxes";
+import { AudioBusBox, AudioUnitBox, BoxIO, GrooveShuffleBox, RootBox, TimelineBox, UserInterfaceBox } from "@opendaw/studio-boxes";
 import { BoxAdapters, IconSymbol, ParameterFieldAdapters, ProjectDecoder, RootBoxAdapter, TimelineBoxAdapter, UserEditingManager, VertexSelection } from "@opendaw/studio-adapters";
 import { LiveStreamReceiver } from "@opendaw/lib-fusion";
 import { AudioUnitType } from "@opendaw/studio-enums";
 import { Mixer } from "./Mixer";
+import { ProjectApi } from "./ProjectApi";
+import { ProjectMigration } from "./ProjectMigration";
 // Main Entry Point for a Project
 //
 export class Project {
@@ -48,65 +50,9 @@ export class Project {
     }
     static load(env, arrayBuffer) {
         const skeleton = ProjectDecoder.decode(arrayBuffer);
-        this.#migrate(skeleton);
+        ProjectMigration.migrate(skeleton);
         return new Project(env, skeleton.boxGraph, skeleton.mandatoryBoxes);
     }
-    static #migrate({ boxGraph, mandatoryBoxes }) {
-        const { rootBox } = mandatoryBoxes;
-        if (rootBox.groove.targetAddress.isEmpty()) {
-            console.debug("Migrate to global GrooveShuffleBox");
-            boxGraph.beginTransaction();
-            rootBox.groove.refer(GrooveShuffleBox.create(boxGraph, UUID.generate()));
-            boxGraph.endTransaction();
-        }
-        const globalShuffle = asInstanceOf(rootBox.groove.targetVertex.unwrap(), GrooveShuffleBox).label;
-        if (globalShuffle.getValue() !== "Groove Shuffle") {
-            boxGraph.beginTransaction();
-            globalShuffle.setValue("Groove Shuffle");
-            boxGraph.endTransaction();
-        }
-        // TODO We can remove this when we delete all not-migrated, local(!) project files from my machine
-        boxGraph.boxes().forEach(box => box.accept({
-            visitZeitgeistDeviceBox: (box) => {
-                if (box.groove.targetAddress.isEmpty()) {
-                    console.debug("Migrate 'ZeitgeistDeviceBox' to GrooveShuffleBox");
-                    boxGraph.beginTransaction();
-                    box.groove.refer(rootBox.groove.targetVertex.unwrap());
-                    boxGraph.endTransaction();
-                }
-            },
-            visitValueEventBox: (eventBox) => {
-                const slope = eventBox.slope.getValue();
-                if (isNaN(slope)) {
-                    return;
-                } // already migrated, nothing to do
-                if (slope === 0.0) { // never set
-                    console.debug("Migrate 'ValueEventBox'");
-                    boxGraph.beginTransaction();
-                    eventBox.slope.setValue(NaN);
-                    boxGraph.endTransaction();
-                }
-                else if (eventBox.interpolation.getValue() === 1) { // linear
-                    if (slope === 0.5) {
-                        console.debug("Migrate 'ValueEventBox' to linear");
-                        boxGraph.beginTransaction();
-                        eventBox.slope.setValue(NaN);
-                        boxGraph.endTransaction();
-                    }
-                    else {
-                        console.debug("Migrate 'ValueEventBox' to new ValueEventCurveBox");
-                        boxGraph.beginTransaction();
-                        ValueEventCurveBox.create(boxGraph, UUID.generate(), box => {
-                            box.event.refer(eventBox.interpolation);
-                            box.slope.setValue(slope);
-                        });
-                        eventBox.slope.setValue(NaN);
-                        boxGraph.endTransaction();
-                    }
-                }
-            }
-        }));
-    }
     #terminator = new Terminator();
     #env;
     boxGraph;
@@ -115,6 +61,7 @@ export class Project {
     masterBusBox;
     masterAudioUnit;
     timelineBox;
+    api;
     editing;
     selection;
     boxAdapters;
@@ -131,6 +78,7 @@ export class Project {
         this.masterAudioUnit = masterAudioUnit;
         this.timelineBox = timelineBox;
         this.liveStreamReceiver = this.#terminator.own(new LiveStreamReceiver());
+        this.api = new ProjectApi(this);
         this.editing = new Editing(this.boxGraph);
         this.selection = new VertexSelection(this.editing, this.boxGraph);
         this.parameterFieldAdapters = new ParameterFieldAdapters();

package/dist/ProjectApi.d.ts

@@ -0,0 +1,32 @@
+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 { 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 declare class ProjectApi {
+    #private;
+    static readonly AudioUnitOrdering: {
+        readonly instrument: 0;
+        readonly aux: 1;
+        readonly bus: 2;
+        readonly output: 3;
+    };
+    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;
+    deleteAudioUnit(adapter: AudioUnitBoxAdapter): void;
+}
+//# sourceMappingURL=ProjectApi.d.ts.map

package/dist/ProjectApi.d.ts.map

@@ -0,0 +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"}