@opendaw/studio-scripting 0.0.2

package/README.md

@@ -0,0 +1,24 @@
+# Scripting
+
+### TODO
+
+* Dialogs
+    * Info
+    * Approve
+    * Options
+    * Listen to a generated sample before importing
+* Console
+* Pass current project to script
+* Pass selection
+* Load file for importing any format
+* Save file for exporting any format
+* Store project in ProjectStorage
+* Add a way to query available projects, samples, soundfonts and presets
+* Add Clip support
+
+### Next
+
+* Scripts should drive backups
+* Scripts should drive mixdown and Stems export
+* Run scripts in the background and listen to changes in the project
+* Live plugins (instruments, midi-fx, audio-fx)

package/dist/Api.d.ts

@@ -0,0 +1,259 @@
+import { Chord, dbToGain, FFT, gainToDb, Interpolation, midiToHz, PPQN, ppqn } from "@opendaw/lib-dsp";
+import { bipolar, float, int, Nullable, unitValue } from "@opendaw/lib-std";
+import type { AudioData } from "@opendaw/studio-adapters";
+import { Sample } from "@opendaw/studio-adapters";
+import { AudioPlayback } from "@opendaw/studio-enums";
+export { AudioPlayback, PPQN, FFT, Chord, Sample, dbToGain, gainToDb, midiToHz };
+export type Send = {
+    /** Send amount in decibels */
+    amount: number;
+    /** Pan position for the Send (-1.0 = left, 0.0 = center, 1.0 = right) */
+    pan: bipolar;
+    /** Send routing mode (pre-fader or post-fader) */
+    mode: "pre" | "post";
+};
+export interface Sendable {
+    /**
+     * Add a Send to an auxiliary or group unit
+     * @param target - The destination unit for the Send
+     * @param props - Send configuration ({@link Send})
+     */
+    addSend(target: AuxAudioUnit | GroupAudioUnit, props?: Partial<Send>): Send;
+    /** Remove an existing Send */
+    removeSend(send: Send): void;
+}
+export type AnyDevice = MIDIEffects[keyof MIDIEffects] | AudioEffects[keyof AudioEffects] | Instruments[keyof Instruments] | AudioUnit;
+export interface Effect {
+    /** Enable or bypass the effect */
+    enabled: boolean;
+    /** Custom label for the effect */
+    label: string;
+}
+export interface AudioEffect extends Effect {
+    /** Effect type identifier */
+    readonly key: keyof AudioEffects;
+}
+export interface DelayEffect extends AudioEffect {
+    /** Delay time index (0-16): 1/1, 1/2, 1/3, 1/4, 3/16, 1/6, 1/8, 3/32, 1/12, 1/16, 3/64, 1/24, 1/32, 1/48, 1/64, 1/96, 1/128 note fractions */
+    delay: number;
+    /** Feedback amount (0.0 to 1.0) */
+    feedback: number;
+    /** Cross-feedback amount (0.0 to 1.0) */
+    cross: number;
+    /** Filter cutoff frequency */
+    filter: number;
+    /** Wet (processed) signal level (0.0 to 1.0) */
+    wet: number;
+    /** Dry (original) signal level (0.0 to 1.0) */
+    dry: number;
+}
+export interface AudioEffects {
+    "delay": DelayEffect;
+}
+export interface MIDIEffect extends Effect {
+    /** Effect type identifier */
+    readonly key: keyof MIDIEffects;
+}
+export interface PitchEffect extends MIDIEffect {
+    /** Pitch shift in octaves */
+    octaves: int;
+    /** Pitch shift in semitones */
+    semiTones: int;
+    /** Fine pitch shift in cents (100 cents = 1 semitone) */
+    cents: float;
+}
+export interface MIDIEffects {
+    "pitch": PitchEffect;
+}
+export interface AudioUnit {
+    /** Output routing destination, if unset it goes to primary output, if null, it remains unplugged */
+    output?: Nullable<OutputAudioUnit | GroupAudioUnit>;
+    /** Volume in decibels (dB) */
+    volume: number;
+    /** Pan position (-1.0 = full left, 0.0 = center, 1.0 = full right) */
+    panning: bipolar;
+    /** Mute the audio unit */
+    mute: boolean;
+    /** Solo the audio unit */
+    solo: boolean;
+    /** Add an audio effect to the unit */
+    addAudioEffect<T extends keyof AudioEffects>(type: T, props?: Partial<AudioEffects[T]>): AudioEffects[T];
+    /** Add a MIDI effect to the unit */
+    addMIDIEffect<T extends keyof MIDIEffects>(type: T, props?: Partial<MIDIEffects[T]>): MIDIEffects[T];
+    /** Add a note track for MIDI events */
+    addNoteTrack(props?: Partial<Pick<Track, "enabled">>): NoteTrack;
+    /** Add an audio track */
+    addAudioTrack(props?: Partial<Pick<Track, "enabled">>): AudioTrack;
+    /** Add an automation track for parameter changes */
+    addValueTrack<DEVICE extends AnyDevice, PARAMETER extends keyof DEVICE>(device: DEVICE, parameter: PARAMETER, props?: Partial<Pick<Track, "enabled">>): ValueTrack;
+}
+export interface InstrumentAudioUnit extends AudioUnit, Sendable {
+    /** Unit type identifier */
+    readonly kind: "instrument";
+    /** The instrument instance */
+    readonly instrument: Instrument;
+    /** Change the instrument type */
+    setInstrument(name: keyof Instruments): Instrument;
+}
+export interface AuxAudioUnit extends AudioUnit, Sendable {
+    /** Unit type identifier */
+    readonly kind: "auxiliary";
+    /** Custom label for the auxiliary unit */
+    label: string;
+}
+export interface GroupAudioUnit extends AudioUnit, Sendable {
+    /** Unit type identifier */
+    readonly kind: "group";
+    /** Custom label for the group unit */
+    label: string;
+}
+export interface OutputAudioUnit extends AudioUnit {
+    /** Unit type identifier */
+    readonly kind: "output";
+}
+export interface Track {
+    /** The audio unit this track belongs to */
+    readonly audioUnit: AudioUnit;
+    /** Enable or disable the track */
+    enabled: boolean;
+}
+export interface Region {
+    /** Start position in PPQN */
+    position: ppqn;
+    /** Length in PPQN */
+    duration: ppqn;
+    /** Mute the region */
+    mute: boolean;
+    /** Custom label for the region */
+    label: string;
+    /** Color hue (0-360) */
+    hue: int;
+}
+export interface LoopableRegion extends Region {
+    /** Loop cycle length in PPQN */
+    loopDuration: ppqn;
+    /** Loop start offset in PPQN */
+    loopOffset: ppqn;
+}
+export interface NoteEvent {
+    /** Start position in PPQN */
+    position: ppqn;
+    /** Note length in PPQN */
+    duration: ppqn;
+    /** MIDI pitch (0-127, where 60 = middle C) */
+    pitch: number;
+    /** Fine-tuning in cents (-100 to +100) */
+    cents: number;
+    /** Note velocity (0.0 to 1.0) */
+    velocity: number;
+}
+export interface NoteRegion extends LoopableRegion {
+    /** The note track this region belongs to */
+    readonly track: NoteTrack;
+    /** Add a MIDI note event to the region */
+    addEvent(props?: Partial<NoteEvent>): NoteEvent;
+    addEvents(events: Array<Partial<NoteEvent>>): void;
+}
+export type NoteRegionProps = Partial<NoteRegion & {
+    mirror: NoteRegion;
+}>;
+export interface NoteTrack extends Track {
+    /** Add a note region to the track */
+    addRegion(props?: NoteRegionProps): NoteRegion;
+}
+export interface AudioRegion extends LoopableRegion {
+    /** The audio track this region belongs to */
+    readonly track: AudioTrack;
+    /** NoSync is not dependent on the tempo. Pass seconds for duration, loopOffset and loopDuration! **/
+    playback: AudioPlayback.NoSync | AudioPlayback.Pitch;
+}
+export interface AudioTrack extends Track {
+    /** Add an audio region to the track */
+    addRegion(sample: Sample, props?: Partial<AudioRegion>): AudioRegion;
+}
+export interface ValueEvent {
+    /** Position in PPQN */
+    position: ppqn;
+    /** Parameter value (0.0 to 1.0) */
+    value: unitValue;
+    /** Interpolation curve type */
+    interpolation: Interpolation;
+}
+export interface ValueRegion extends LoopableRegion {
+    /** The automation track this region belongs to */
+    readonly track: ValueTrack;
+    /** Add an automation point to the region */
+    addEvent(props?: Partial<ValueEvent>): ValueEvent;
+    addEvents(events: Array<Partial<ValueEvent>>): void;
+}
+export type ValueRegionProps = Partial<ValueRegion & {
+    mirror: ValueRegion;
+}>;
+export interface ValueTrack extends Track {
+    /** Add an automation region to the track */
+    addRegion(props?: ValueRegionProps): ValueRegion;
+}
+export interface Instrument {
+    /** The audio unit this instrument belongs to */
+    readonly audioUnit: InstrumentAudioUnit;
+}
+export interface MIDIInstrument extends Instrument {
+}
+export interface AudioInstrument extends Instrument {
+}
+/** Wavetable synthesizer instrument */
+export interface Vaporisateur extends MIDIInstrument {
+}
+/** Sample-based playback instrument */
+export interface Playfield extends MIDIInstrument {
+}
+/** Minimal synthesizer instrument */
+export interface Nano extends MIDIInstrument {
+    sample: Sample;
+}
+/** SoundFont (.sf2) player instrument */
+export interface Soundfont extends MIDIInstrument {
+}
+/** External MIDI output instrument */
+export interface MIDIOutput extends MIDIInstrument {
+}
+export interface Tape extends AudioInstrument {
+}
+export type Instruments = {
+    "Vaporisateur": Vaporisateur;
+    "Playfield": Playfield;
+    "Nano": Nano;
+    "Soundfont": Soundfont;
+    "MIDIOutput": MIDIOutput;
+    "Tape": Tape;
+};
+export interface Project {
+    /** Master output audio unit */
+    readonly output: OutputAudioUnit;
+    /** Project name */
+    name: string;
+    /** Tempo in beats per minute */
+    bpm: number;
+    /** Time signature (e.g., 4/4, 3/4) */
+    timeSignature: {
+        numerator: int;
+        denominator: int;
+    };
+    /** Add an instrument track to the project */
+    addInstrumentUnit<KEY extends keyof Instruments>(name: KEY, props?: Partial<Instruments[KEY]>): InstrumentAudioUnit;
+    /** Add an auxiliary effects track */
+    addAuxUnit(props?: Partial<Pick<AuxAudioUnit, "label">>): AuxAudioUnit;
+    /** Add a group track for mixing multiple units */
+    addGroupUnit(props?: Partial<Pick<GroupAudioUnit, "label">>): GroupAudioUnit;
+    /** Open the project in the studio and exit */
+    openInStudio(): void;
+}
+export interface Api {
+    /** Create a new project */
+    newProject(name?: string): Project;
+    /** Get the current active project */
+    getProject(): Promise<Project>;
+    /** Creates a sample in the studio **/
+    addSample(data: AudioData, name: string): Promise<Sample>;
+}
+//# sourceMappingURL=Api.d.ts.map

package/dist/Api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.d.ts","sourceRoot":"","sources":["../src/Api.ts"],"names":[],"mappings":"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"}

package/dist/Api.js

@@ -0,0 +1,4 @@
+import { Chord, dbToGain, FFT, gainToDb, midiToHz, PPQN } from "@opendaw/lib-dsp";
+import { Sample } from "@opendaw/studio-adapters";
+import { AudioPlayback } from "@opendaw/studio-enums";
+export { AudioPlayback, PPQN, FFT, Chord, Sample, dbToGain, gainToDb, midiToHz };

package/dist/Asserts.d.ts

@@ -0,0 +1,4 @@
+export declare namespace Asserts {
+    const assertNoNaN: (obj: any, label?: string) => void;
+}
+//# sourceMappingURL=Asserts.d.ts.map

package/dist/Asserts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Asserts.d.ts","sourceRoot":"","sources":["../src/Asserts.ts"],"names":[],"mappings":"AAAA,yBAAiB,OAAO,CAAC;IAwCd,MAAM,WAAW,GAAI,KAAK,GAAG,EAAE,QAAO,MAAwB,KAAG,IAOvE,CAAA;CACJ"}

package/dist/Asserts.js

@@ -0,0 +1,53 @@
+export var Asserts;
+(function (Asserts) {
+    const validateNoNaN = (obj, path = "root", visited) => {
+        if (obj === null || obj === undefined)
+            return;
+        if (typeof obj === "number" && isNaN(obj)) {
+            throw new Error(`NaN found at: ${path}`);
+        }
+        if (Array.isArray(obj)) {
+            obj.forEach((item, index) => validateNoNaN(item, `${path}[${index}]`, visited));
+            return;
+        }
+        if (typeof obj === "object") {
+            if (visited.has(obj))
+                return;
+            visited.add(obj);
+            const allKeys = new Set();
+            Object.getOwnPropertyNames(obj).forEach(k => allKeys.add(k));
+            let proto = Object.getPrototypeOf(obj);
+            while (proto && proto !== Object.prototype) {
+                Object.getOwnPropertyNames(proto).forEach(k => allKeys.add(k));
+                proto = Object.getPrototypeOf(proto);
+            }
+            for (const key of allKeys) {
+                let value;
+                let accessible = true;
+                try {
+                    value = obj[key];
+                }
+                catch {
+                    accessible = false;
+                }
+                if (accessible) {
+                    if (typeof value === "number" && isNaN(value)) {
+                        throw new Error(`NaN found at: ${path}.${key}`);
+                    }
+                    if (typeof value !== "function") {
+                        validateNoNaN(value, `${path}.${key}`, visited);
+                    }
+                }
+            }
+        }
+    };
+    Asserts.assertNoNaN = (obj, label = "validateNoNaN") => {
+        console.time(label);
+        try {
+            validateNoNaN(obj, "root", new WeakSet());
+        }
+        finally {
+            console.timeEnd(label);
+        }
+    };
+})(Asserts || (Asserts = {}));

package/dist/AudioEffectFactory.d.ts

@@ -0,0 +1,7 @@
+import { Box, BoxGraph } from "@opendaw/lib-box";
+import { AudioUnitBox } from "@opendaw/studio-boxes";
+import { AudioEffects } from "./Api";
+export declare class AudioEffectFactory {
+    static write(boxGraph: BoxGraph, audioUnitBox: AudioUnitBox, effect: Required<AudioEffects[keyof AudioEffects]>): Box;
+}
+//# sourceMappingURL=AudioEffectFactory.d.ts.map

package/dist/AudioEffectFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioEffectFactory.d.ts","sourceRoot":"","sources":["../src/AudioEffectFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAE,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAC,YAAY,EAAiB,MAAM,uBAAuB,CAAA;AAElE,OAAO,EAAC,YAAY,EAAC,MAAM,OAAO,CAAA;AAElC,qBAAa,kBAAkB;IAC3B,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG;CAmBxE"}

package/dist/AudioEffectFactory.js

@@ -0,0 +1,23 @@
+import { DelayDeviceBox } from "@opendaw/studio-boxes";
+import { Unhandled, UUID } from "@opendaw/lib-std";
+export class AudioEffectFactory {
+    static write(boxGraph, audioUnitBox, effect) {
+        switch (effect.key) {
+            case "delay": {
+                return DelayDeviceBox.create(boxGraph, UUID.generate(), box => {
+                    box.delay.setValue(effect.delay);
+                    box.feedback.setValue(effect.feedback);
+                    box.cross.setValue(effect.cross);
+                    box.filter.setValue(effect.filter);
+                    box.dry.setValue(effect.dry);
+                    box.wet.setValue(effect.wet);
+                    box.enabled.setValue(effect.enabled);
+                    box.label.setValue(effect.label); // TODO uniquify?
+                    box.host.refer(audioUnitBox.audioEffects);
+                });
+            }
+            default:
+                return Unhandled(effect.key);
+        }
+    }
+}

package/dist/AudioFileBoxfactory.d.ts

@@ -0,0 +1,6 @@
+import { AudioFileBox } from "@opendaw/studio-boxes";
+import { BoxGraph } from "@opendaw/lib-box";
+export declare namespace AudioFileBoxfactory {
+    const create: (boxGraph: BoxGraph, sample: Sample) => AudioFileBox;
+}
+//# sourceMappingURL=AudioFileBoxfactory.d.ts.map

package/dist/AudioFileBoxfactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioFileBoxfactory.d.ts","sourceRoot":"","sources":["../src/AudioFileBoxfactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAElD,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAEzC,yBAAiB,mBAAmB,CAAC;IAC1B,MAAM,MAAM,GAAI,UAAU,QAAQ,EAAE,QAAQ,MAAM,KAAG,YAKtD,CAAA;CACT"}

package/dist/AudioFileBoxfactory.js

@@ -0,0 +1,10 @@
+import { AudioFileBox } from "@opendaw/studio-boxes";
+import { UUID } from "@opendaw/lib-std";
+export var AudioFileBoxfactory;
+(function (AudioFileBoxfactory) {
+    AudioFileBoxfactory.create = (boxGraph, sample) => AudioFileBox.create(boxGraph, UUID.parse(sample.uuid), box => {
+        box.fileName.setValue(sample.name);
+        box.startInSeconds.setValue(0);
+        box.endInSeconds.setValue(sample.duration);
+    });
+})(AudioFileBoxfactory || (AudioFileBoxfactory = {}));

package/dist/AudioTrackWriter.d.ts

@@ -0,0 +1,8 @@
+import { AudioUnitBox } from "@opendaw/studio-boxes";
+import { BoxGraph } from "@opendaw/lib-box";
+import { IndexRef } from "./IndexRef";
+import { AudioTrackImpl } from "./impl/AudioTrackImpl";
+export declare namespace AudioTrackWriter {
+    const write: (boxGraph: BoxGraph, audioUnitBox: AudioUnitBox, audioTracks: ReadonlyArray<AudioTrackImpl>, indexRef: IndexRef) => void;
+}
+//# sourceMappingURL=AudioTrackWriter.d.ts.map

package/dist/AudioTrackWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioTrackWriter.d.ts","sourceRoot":"","sources":["../src/AudioTrackWriter.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,YAAY,EAAW,MAAM,uBAAuB,CAAA;AAE5E,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAA;AACnC,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAA;AAMpD,yBAAiB,gBAAgB,CAAC;IACvB,MAAM,KAAK,GAAI,UAAU,QAAQ,EAClB,cAAc,YAAY,EAC1B,aAAa,aAAa,CAAC,cAAc,CAAC,EAC1C,UAAU,QAAQ,KAAG,IA+B1C,CAAA;CACJ"}

package/dist/AudioTrackWriter.js

@@ -0,0 +1,39 @@
+import { UUID } from "@opendaw/lib-std";
+import { AudioRegionBox, TrackBox } from "@opendaw/studio-boxes";
+import { TrackType } from "@opendaw/studio-adapters";
+import { AudioPlayback } from "@opendaw/studio-enums";
+import { TimeBase } from "@opendaw/lib-dsp";
+import { AudioFileBoxfactory } from "./AudioFileBoxfactory";
+export var AudioTrackWriter;
+(function (AudioTrackWriter) {
+    AudioTrackWriter.write = (boxGraph, audioUnitBox, audioTracks, indexRef) => {
+        audioTracks.forEach(({ enabled, regions }) => {
+            const trackBox = TrackBox.create(boxGraph, UUID.generate(), box => {
+                box.type.setValue(TrackType.Audio);
+                box.enabled.setValue(enabled);
+                box.index.setValue(indexRef.index++);
+                box.target.refer(audioUnitBox);
+                box.tracks.refer(audioUnitBox.tracks);
+            });
+            regions.forEach((region) => {
+                const { position, duration, loopDuration, loopOffset, hue, label, mute, sample } = region;
+                const fileBox = AudioFileBoxfactory.create(boxGraph, sample);
+                AudioRegionBox.create(boxGraph, UUID.generate(), box => {
+                    box.position.setValue(position);
+                    box.duration.setValue(duration);
+                    box.loopDuration.setValue(loopDuration);
+                    box.loopOffset.setValue(loopOffset);
+                    box.hue.setValue(hue);
+                    box.label.setValue(label);
+                    box.mute.setValue(mute);
+                    box.regions.refer(trackBox.regions);
+                    box.file.refer(fileBox);
+                    box.playback.setValue(region.playback);
+                    box.timeBase.setValue(region.playback === AudioPlayback.NoSync
+                        ? TimeBase.Seconds
+                        : TimeBase.Musical);
+                });
+            });
+        });
+    };
+})(AudioTrackWriter || (AudioTrackWriter = {}));

package/dist/AudioUnitBoxFactory.d.ts

@@ -0,0 +1,6 @@
+import { ProjectSkeleton } from "@opendaw/studio-adapters";
+import { ProjectImpl } from "./impl";
+export declare namespace AudioUnitBoxFactory {
+    const create: (skeleton: ProjectSkeleton, project: ProjectImpl) => void;
+}
+//# sourceMappingURL=AudioUnitBoxFactory.d.ts.map

package/dist/AudioUnitBoxFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioUnitBoxFactory.d.ts","sourceRoot":"","sources":["../src/AudioUnitBoxFactory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoD,eAAe,EAAC,MAAM,0BAA0B,CAAA;AAC3G,OAAO,EAAgE,WAAW,EAAW,MAAM,QAAQ,CAAA;AAS3G,yBAAiB,mBAAmB,CAAC;IAC1B,MAAM,MAAM,GAAI,UAAU,eAAe,EAAE,SAAS,WAAW,KAAG,IAqHxE,CAAA;CACJ"}

package/dist/AudioUnitBoxFactory.js

@@ -0,0 +1,116 @@
+import { asDefined, isDefined, isNotNull, UUID } from "@opendaw/lib-std";
+import { AudioUnitType, IconSymbol } from "@opendaw/studio-enums";
+import { AudioBusBox, AudioUnitBox, AuxSendBox, TrackBox } from "@opendaw/studio-boxes";
+import { AudioUnitFactory, InstrumentFactories } from "@opendaw/studio-adapters";
+import { MIDIEffectFactory } from "./MIDIEffectFactory";
+import { AudioEffectFactory } from "./AudioEffectFactory";
+import { NoteTrackWriter } from "./NoteTrackWriter";
+import { ValueTrackWriter } from "./ValueTrackWriter";
+import { AudioTrackWriter } from "./AudioTrackWriter";
+import { AudioFileBoxfactory } from "./AudioFileBoxfactory";
+export var AudioUnitBoxFactory;
+(function (AudioUnitBoxFactory) {
+    AudioUnitBoxFactory.create = (skeleton, project) => {
+        const { boxGraph, mandatoryBoxes: { rootBox, primaryAudioBus, primaryAudioOutputUnit } } = skeleton;
+        let audioUnitIndex = 0;
+        const devices = new Map();
+        const busMap = new Map([[project.output, primaryAudioBus]]);
+        const audioUnitMap = new Map([[project.output, primaryAudioOutputUnit]]);
+        const awaitedSends = [];
+        const noteTrackWriter = new NoteTrackWriter();
+        const valueTrackWriter = new ValueTrackWriter();
+        const createSend = (sends, audioUnitBox) => {
+            awaitedSends.push(...(sends.map((send, index) => [send, AuxSendBox.create(boxGraph, UUID.generate(), box => {
+                    box.index.setValue(index);
+                    box.audioUnit.refer(audioUnitBox.auxSends);
+                    box.sendGain.setValue(send.amount);
+                    box.sendPan.setValue(send.pan);
+                    // TODO mode "pre" | "post"
+                })])));
+        };
+        project.instrumentUnits.forEach((audioUnit) => {
+            const { instrument, midiEffects, audioEffects, noteTracks, audioTracks, valueTracks, volume, panning, mute, solo, sends } = audioUnit;
+            const factory = InstrumentFactories.Named[instrument.name];
+            const capture = AudioUnitFactory.trackTypeToCapture(boxGraph, factory.trackType);
+            const audioUnitBox = AudioUnitFactory.create(skeleton, AudioUnitType.Instrument, capture);
+            devices.set(audioUnit, audioUnitBox);
+            audioUnitBox.index.setValue(audioUnitIndex++);
+            audioUnitBox.mute.setValue(mute);
+            audioUnitBox.solo.setValue(solo);
+            audioUnitBox.volume.setValue(volume);
+            audioUnitBox.panning.setValue(panning);
+            if (factory === InstrumentFactories.Nano) {
+                const sample = instrument?.props?.sample;
+                factory.create(boxGraph, audioUnitBox.input, factory.defaultName, factory.defaultIcon, isDefined(sample) ? AudioFileBoxfactory.create(boxGraph, sample) : undefined);
+            }
+            else {
+                factory.create(boxGraph, audioUnitBox.input, factory.defaultName, factory.defaultIcon);
+            }
+            midiEffects.forEach((effect) => devices.set(effect, MIDIEffectFactory.write(boxGraph, audioUnitBox, effect)));
+            audioEffects.forEach((effect) => devices.set(effect, AudioEffectFactory.write(boxGraph, audioUnitBox, effect)));
+            const indexRef = { index: 0 };
+            noteTrackWriter.write(boxGraph, audioUnitBox, noteTracks, indexRef);
+            valueTrackWriter.write(boxGraph, devices, audioUnitBox, valueTracks, indexRef);
+            AudioTrackWriter.write(boxGraph, audioUnitBox, audioTracks, indexRef);
+            if (indexRef.index === 0) { // create a default track if none existed
+                TrackBox.create(boxGraph, UUID.generate(), box => {
+                    box.type.setValue(factory.trackType);
+                    box.index.setValue(0);
+                    box.target.refer(audioUnitBox);
+                    box.tracks.refer(audioUnitBox.tracks);
+                });
+            }
+            createSend(sends, audioUnitBox);
+            audioUnitMap.set(audioUnit, audioUnitBox);
+        });
+        const convertBusUnits = (audioUnit, type, icon, color) => {
+            const audioBusBox = AudioBusBox.create(boxGraph, UUID.generate(), box => {
+                box.collection.refer(rootBox.audioBusses);
+                box.label.setValue(audioUnit.label);
+                box.icon.setValue(IconSymbol.toName(icon));
+                box.color.setValue(color);
+            });
+            const audioUnitBox = AudioUnitBox.create(boxGraph, UUID.generate(), box => {
+                box.type.setValue(type);
+                box.collection.refer(rootBox.audioUnits);
+                box.index.setValue(audioUnitIndex++);
+            });
+            busMap.set(audioUnit, audioBusBox);
+            audioUnitMap.set(audioUnit, audioUnitBox);
+            audioBusBox.output.refer(audioUnitBox.input);
+            createSend(audioUnit.sends, audioUnitBox);
+            devices.set(audioUnit, audioUnitBox);
+            audioUnit.audioEffects.forEach((effect) => devices.set(effect, AudioEffectFactory.write(boxGraph, audioUnitBox, effect)));
+            valueTrackWriter.write(boxGraph, devices, audioUnitBox, audioUnit.valueTracks, { index: 0 });
+        };
+        // TODO Colors need to be in code and written to CSS
+        // Then use ColorCodes!
+        project.auxUnits.forEach(unit => convertBusUnits(unit, AudioUnitType.Aux, IconSymbol.Flask, "var(--color-orange)"));
+        project.groupUnits.forEach(unit => convertBusUnits(unit, AudioUnitType.Bus, IconSymbol.AudioBus, "var(--color-blue)"));
+        awaitedSends.forEach(([send, box]) => box.targetBus.refer(asDefined(busMap.get(send.target), "Could not find AudioBus").input));
+        const { output: { mute, solo, volume, panning } } = project;
+        primaryAudioOutputUnit.mute.setValue(mute);
+        primaryAudioOutputUnit.solo.setValue(solo);
+        primaryAudioOutputUnit.volume.setValue(volume);
+        primaryAudioOutputUnit.panning.setValue(panning);
+        primaryAudioOutputUnit.index.setValue(audioUnitIndex);
+        // connect
+        const audioUnits = [
+            ...project.instrumentUnits,
+            ...project.auxUnits,
+            ...project.groupUnits
+        ];
+        audioUnits.forEach((audioUnit) => {
+            const { output } = audioUnit;
+            // undefined means we connect this to the primary output
+            // null means this is intended to be unplugged
+            const audioBusBox = output === undefined
+                ? primaryAudioBus : output === null
+                ? null : asDefined(busMap.get(output), "Could not find AudioBus");
+            if (isNotNull(audioBusBox)) {
+                const audioUnitBox = asDefined(audioUnitMap.get(audioUnit), "audio unit not found in map");
+                audioUnitBox.output.refer(audioBusBox.input);
+            }
+        });
+    };
+})(AudioUnitBoxFactory || (AudioUnitBoxFactory = {}));

package/dist/IndexRef.d.ts

@@ -0,0 +1,5 @@
+import { int } from "@opendaw/lib-std";
+export type IndexRef = {
+    index: int;
+};
+//# sourceMappingURL=IndexRef.d.ts.map

package/dist/IndexRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexRef.d.ts","sourceRoot":"","sources":["../src/IndexRef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,kBAAkB,CAAA;AAEpC,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,GAAG,CAAA;CAAE,CAAA"}

package/dist/IndexRef.js

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

package/dist/MIDIEffectFactory.d.ts

@@ -0,0 +1,7 @@
+import { MIDIEffects } from "./Api";
+import { Box, BoxGraph } from "@opendaw/lib-box";
+import { AudioUnitBox } from "@opendaw/studio-boxes";
+export declare class MIDIEffectFactory {
+    static write(boxGraph: BoxGraph, audioUnitBox: AudioUnitBox, effect: Required<MIDIEffects[keyof MIDIEffects]>): Box;
+}
+//# sourceMappingURL=MIDIEffectFactory.d.ts.map

package/dist/MIDIEffectFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MIDIEffectFactory.d.ts","sourceRoot":"","sources":["../src/MIDIEffectFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,OAAO,CAAA;AACjC,OAAO,EAAC,GAAG,EAAE,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAC,YAAY,EAAiB,MAAM,uBAAuB,CAAA;AAGlE,qBAAa,iBAAiB;IAC1B,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG;CAgBtE"}

package/dist/MIDIEffectFactory.js

@@ -0,0 +1,20 @@
+import { PitchDeviceBox } from "@opendaw/studio-boxes";
+import { Unhandled, UUID } from "@opendaw/lib-std";
+export class MIDIEffectFactory {
+    static write(boxGraph, audioUnitBox, effect) {
+        switch (effect.key) {
+            case "pitch": {
+                return PitchDeviceBox.create(boxGraph, UUID.generate(), box => {
+                    box.cents.setValue(effect.cents);
+                    box.semiTones.setValue(effect.semiTones);
+                    box.octaves.setValue(effect.octaves);
+                    box.enabled.setValue(effect.enabled);
+                    box.label.setValue(effect.label); // TODO uniquify?
+                    box.host.refer(audioUnitBox.midiEffects);
+                });
+            }
+            default:
+                return Unhandled(effect.key);
+        }
+    }
+}