@opendaw/studio-core 0.0.44 → 0.0.46

package/dist/project/Project.d.ts

@@ -1,5 +1,5 @@
-import { Procedure, Terminable, TerminableOwner, Terminator } from "@opendaw/lib-std";
-import { BoxGraph, Editing } from "@opendaw/lib-box";
+import { Func, Procedure, Terminable, TerminableOwner, Terminator, UUID } from "@opendaw/lib-std";
+import { BoxEditing, BoxGraph } from "@opendaw/lib-box";
 import { AudioBusBox, AudioUnitBox, BoxIO, RootBox, TimelineBox, UserInterfaceBox } from "@opendaw/studio-boxes";
 import { BoxAdapters, BoxAdaptersContext, ClipSequencing, ParameterFieldAdapters, ProcessorOptions, ProjectSkeleton, RootBoxAdapter, SampleLoaderManager, SoundfontLoaderManager, TimelineBoxAdapter, UserEditingManager, VertexSelection } from "@opendaw/studio-adapters";
 import { LiveStreamBroadcaster, LiveStreamReceiver } from "@opendaw/lib-fusion";
@@ -11,23 +11,26 @@ import { EngineFacade } from "../EngineFacade";
 import { EngineWorklet } from "../EngineWorklet";
 import { MIDILearning } from "../midi";
 export type RestartWorklet = {
-    unload: Procedure<unknown>;
+    unload: Func<unknown, Promise<unknown>>;
     load: Procedure<EngineWorklet>;
 };
+export type ProjectCreateOptions = {
+    noDefaultUser?: boolean;
+};
 export declare class Project implements BoxAdaptersContext, Terminable, TerminableOwner {
     #private;
-    static new(env: ProjectEnv): Project;
+    static new(env: ProjectEnv, options?: ProjectCreateOptions): Project;
     static load(env: ProjectEnv, arrayBuffer: ArrayBuffer): Project;
-    static skeleton(env: ProjectEnv, skeleton: ProjectSkeleton): Project;
+    static skeleton(env: ProjectEnv, skeleton: ProjectSkeleton, followFirstUser?: boolean): Project;
     readonly boxGraph: BoxGraph<BoxIO.TypeMap>;
     readonly rootBox: RootBox;
-    readonly userInterfaceBox: UserInterfaceBox;
+    readonly userInterfaceBoxes: ReadonlyArray<UserInterfaceBox>;
     readonly masterBusBox: AudioBusBox;
     readonly masterAudioUnit: AudioUnitBox;
     readonly timelineBox: TimelineBox;
     readonly api: ProjectApi;
     readonly captureDevices: CaptureDevices;
-    readonly editing: Editing;
+    readonly editing: BoxEditing;
     readonly selection: VertexSelection;
     readonly boxAdapters: BoxAdapters;
     readonly userEditingManager: UserEditingManager;
@@ -39,6 +42,7 @@ export declare class Project implements BoxAdaptersContext, Terminable, Terminab
     private constructor();
     startAudioWorklet(restart?: RestartWorklet, options?: ProcessorOptions): EngineWorklet;
     startRecording(countIn?: boolean): void;
+    follow(box: UserInterfaceBox): void;
     own<T extends Terminable>(terminable: T): T;
     ownAll<T extends Terminable>(...terminables: Array<T>): void;
     spawn(): Terminator;
@@ -53,6 +57,7 @@ export declare class Project implements BoxAdaptersContext, Terminable, Terminab
     get isMainThread(): boolean;
     get liveStreamBroadcaster(): LiveStreamBroadcaster;
     get skeleton(): ProjectSkeleton;
+    collectSampleUUIDs(): ReadonlyArray<UUID.Bytes>;
     toArrayBuffer(): ArrayBufferLike;
     copy(env?: Partial<ProjectEnv>): Project;
     invalid(): boolean;

package/dist/project/Project.d.ts.map

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

package/dist/project/Project.js

@@ -1,6 +1,6 @@
 import { Arrays, ByteArrayOutput, Option, panic, safeExecute, Terminator, UUID } from "@opendaw/lib-std";
-import { BoxGraph, Editing } from "@opendaw/lib-box";
-import { AudioBusBox, AudioUnitBox, BoxIO, GrooveShuffleBox, RootBox, TimelineBox, UserInterfaceBox } from "@opendaw/studio-boxes";
+import { BoxEditing, BoxGraph } from "@opendaw/lib-box";
+import { AudioBusBox, AudioUnitBox, BoxIO, CompressorDeviceBox, GrooveShuffleBox, RootBox, TimelineBox, UserInterfaceBox } from "@opendaw/studio-boxes";
 import { BoxAdapters, IconSymbol, ParameterFieldAdapters, ProjectDecoder, RootBoxAdapter, TimelineBoxAdapter, UnionBoxTypes, UserEditingManager, VertexSelection } from "@opendaw/studio-adapters";
 import { LiveStreamReceiver } from "@opendaw/lib-fusion";
 import { AudioUnitType } from "@opendaw/studio-enums";
@@ -11,9 +11,10 @@ import { CaptureDevices, Recording } from "../capture";
 import { EngineFacade } from "../EngineFacade";
 import { MIDILearning } from "../midi";
 import { ProjectValidation } from "./ProjectValidation";
+import { Preferences } from "../Preferences";
 // Main Entry Point for a Project
 export class Project {
-    static new(env) {
+    static new(env, options) {
         const boxGraph = new BoxGraph(Option.wrap(BoxIO.create));
         const isoString = new Date().toISOString();
         console.debug(`New Project created on ${isoString}`);
@@ -25,45 +26,67 @@ export class Project {
             box.groove.refer(grooveShuffleBox);
             box.created.setValue(isoString);
         });
-        const userInterfaceBox = UserInterfaceBox.create(boxGraph, UUID.generate());
-        const masterBusBox = AudioBusBox.create(boxGraph, UUID.generate(), box => {
+        const primaryAudioBus = AudioBusBox.create(boxGraph, UUID.generate(), box => {
             box.collection.refer(rootBox.audioBusses);
             box.label.setValue("Output");
             box.icon.setValue(IconSymbol.toName(IconSymbol.SpeakerHeadphone));
             box.color.setValue(/*Colors.blue*/ "hsl(189, 100%, 65%)"); // TODO
         });
-        const masterAudioUnit = AudioUnitBox.create(boxGraph, UUID.generate(), box => {
+        const primaryAudioOutputUnit = AudioUnitBox.create(boxGraph, UUID.generate(), box => {
             box.type.setValue(AudioUnitType.Output);
             box.collection.refer(rootBox.audioUnits);
             box.output.refer(rootBox.outputDevice);
             box.index.setValue(0);
         });
+        if (Preferences.values["auto-create-output-compressor"]) {
+            CompressorDeviceBox.create(boxGraph, UUID.generate(), box => {
+                box.label.setValue("Compressor");
+                box.index.setValue(0);
+                box.host.refer(primaryAudioOutputUnit.audioEffects);
+                box.threshold.setValue(0);
+                box.ratio.setValue(24);
+            });
+        }
         const timelineBox = TimelineBox.create(boxGraph, UUID.generate());
         rootBox.timeline.refer(timelineBox.root);
-        userInterfaceBox.root.refer(rootBox.users);
-        masterBusBox.output.refer(masterAudioUnit.input);
+        primaryAudioBus.output.refer(primaryAudioOutputUnit.input);
+        const userInterfaceBoxes = [];
+        const createDefaultUser = options?.noDefaultUser !== true;
+        if (createDefaultUser) {
+            const userInterfaceBox = UserInterfaceBox.create(boxGraph, UUID.generate());
+            userInterfaceBox.root.refer(rootBox.users);
+            userInterfaceBoxes.push(userInterfaceBox);
+        }
         boxGraph.endTransaction();
-        return new Project(env, boxGraph, {
+        const project = new Project(env, boxGraph, {
             rootBox,
-            userInterfaceBox,
-            masterBusBox,
-            masterAudioUnit,
+            primaryAudioBus,
+            primaryAudioOutputUnit,
+            userInterfaceBoxes,
             timelineBox
         });
+        if (createDefaultUser) {
+            project.follow(userInterfaceBoxes[0]);
+        }
+        return project;
     }
     static load(env, arrayBuffer) {
         return this.skeleton(env, ProjectDecoder.decode(arrayBuffer));
     }
-    static skeleton(env, skeleton) {
+    static skeleton(env, skeleton, followFirstUser = true) {
         ProjectMigration.migrate(skeleton);
         ProjectValidation.validate(skeleton);
-        return new Project(env, skeleton.boxGraph, skeleton.mandatoryBoxes);
+        const project = new Project(env, skeleton.boxGraph, skeleton.mandatoryBoxes);
+        if (followFirstUser) {
+            project.follow(project.userInterfaceBoxes[0]);
+        }
+        return project;
     }
     #terminator = new Terminator();
     #env;
     boxGraph;
     rootBox;
-    userInterfaceBox;
+    userInterfaceBoxes;
     masterBusBox;
     masterAudioUnit;
     timelineBox;
@@ -78,26 +101,28 @@ export class Project {
     midiLearning;
     mixer;
     engine = new EngineFacade();
-    constructor(env, boxGraph, { rootBox, userInterfaceBox, masterBusBox, masterAudioUnit, timelineBox }) {
+    constructor(env, boxGraph, { rootBox, userInterfaceBoxes, primaryAudioBus, primaryAudioOutputUnit, timelineBox }) {
         this.#env = env;
         this.boxGraph = boxGraph;
         this.rootBox = rootBox;
-        this.userInterfaceBox = userInterfaceBox;
-        this.masterBusBox = masterBusBox;
-        this.masterAudioUnit = masterAudioUnit;
+        this.userInterfaceBoxes = userInterfaceBoxes;
+        this.masterBusBox = primaryAudioBus;
+        this.masterAudioUnit = primaryAudioOutputUnit;
         this.timelineBox = timelineBox;
         this.api = new ProjectApi(this);
-        this.editing = new Editing(this.boxGraph);
+        this.editing = new BoxEditing(this.boxGraph);
         this.selection = new VertexSelection(this.editing, this.boxGraph);
         this.parameterFieldAdapters = new ParameterFieldAdapters();
         this.boxAdapters = this.#terminator.own(new BoxAdapters(this));
         this.userEditingManager = new UserEditingManager(this.editing);
-        this.userEditingManager.follow(this.userInterfaceBox);
-        this.selection.switch(this.userInterfaceBox.selection);
         this.liveStreamReceiver = this.#terminator.own(new LiveStreamReceiver());
         this.midiLearning = this.#terminator.own(new MIDILearning(this));
         this.captureDevices = this.#terminator.own(new CaptureDevices(this));
         this.mixer = new Mixer(this.rootBoxAdapter.audioUnits);
+        // TODO We are probably doing that from the outside
+        if (this.userInterfaceBoxes.length === 1) {
+            this.follow(this.userInterfaceBoxes[0]);
+        }
         console.debug(`Project was created on ${this.rootBoxAdapter.created.toString()}`);
     }
     startAudioWorklet(restart, options) {
@@ -109,8 +134,8 @@ export class Project {
             // we will only accept the first error
             engine.removeEventListener("error", handler);
             engine.removeEventListener("processorerror", handler);
-            safeExecute(restart?.unload, event);
             lifecycle.terminate();
+            await safeExecute(restart?.unload, event);
             safeExecute(restart?.load, this.startAudioWorklet(restart));
         };
         engine.addEventListener("error", handler);
@@ -126,6 +151,10 @@ export class Project {
         }
         Recording.start(this, countIn).finally();
     }
+    follow(box) {
+        this.userEditingManager.follow(box);
+        this.selection.switch(box.selection);
+    }
     own(terminable) { return this.#terminator.own(terminable); }
     ownAll(...terminables) { return this.#terminator.ownAll(...terminables); }
     spawn() { return this.#terminator.spawn(); }
@@ -145,26 +174,24 @@ export class Project {
             mandatoryBoxes: {
                 rootBox: this.rootBox,
                 timelineBox: this.timelineBox,
-                masterBusBox: this.masterBusBox,
-                masterAudioUnit: this.masterAudioUnit,
-                userInterfaceBox: this.userInterfaceBox
+                primaryAudioBus: this.masterBusBox,
+                primaryAudioOutputUnit: this.masterAudioUnit,
+                userInterfaceBoxes: this.userInterfaceBoxes
             }
         };
     }
+    collectSampleUUIDs() {
+        return this.boxGraph.boxes()
+            .filter(box => box.accept({ visitAudioFileBox: (_box) => true }))
+            .map(box => box.address.uuid);
+    }
     toArrayBuffer() {
         const output = ByteArrayOutput.create();
         output.writeInt(ProjectDecoder.MAGIC_HEADER_OPEN);
         output.writeInt(ProjectDecoder.FORMAT_VERSION);
-        // store all boxes
         const boxGraphChunk = this.boxGraph.toArrayBuffer();
         output.writeInt(boxGraphChunk.byteLength);
         output.writeBytes(new Int8Array(boxGraphChunk));
-        // store mandatory boxes' addresses
-        UUID.toDataOutput(output, this.rootBox.address.uuid);
-        UUID.toDataOutput(output, this.userInterfaceBox.address.uuid);
-        UUID.toDataOutput(output, this.masterBusBox.address.uuid);
-        UUID.toDataOutput(output, this.masterAudioUnit.address.uuid);
-        UUID.toDataOutput(output, this.timelineBox.address.uuid);
         return output.toArrayBuffer();
     }
     copy(env) {

package/dist/project/ProjectMigration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectMigration.d.ts","sourceRoot":"","sources":["../../src/project/ProjectMigration.ts"],"names":[],"mappings":"AAYA,OAAO,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAA;AAExD,qBAAa,gBAAgB;IACzB,MAAM,CAAC,OAAO,CAAC,EAAC,QAAQ,EAAE,cAAc,EAAC,EAAE,eAAe,GAAG,IAAI;CAmEpE"}
+{"version":3,"file":"ProjectMigration.d.ts","sourceRoot":"","sources":["../../src/project/ProjectMigration.ts"],"names":[],"mappings":"AAaA,OAAO,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAA;AAExD,qBAAa,gBAAgB;IACzB,MAAM,CAAC,OAAO,CAAC,EAAC,QAAQ,EAAE,cAAc,EAAC,EAAE,eAAe,GAAG,IAAI;CA4EpE"}

package/dist/project/ProjectMigration.js

@@ -1,5 +1,5 @@
 import { CaptureAudioBox, CaptureMidiBox, GrooveShuffleBox, ValueEventCurveBox } from "@opendaw/studio-boxes";
-import { asDefined, asInstanceOf, UUID } from "@opendaw/lib-std";
+import { asDefined, asInstanceOf, clamp, UUID } from "@opendaw/lib-std";
 import { AudioUnitType } from "@opendaw/studio-enums";
 export class ProjectMigration {
     static migrate({ boxGraph, mandatoryBoxes }) {
@@ -70,6 +70,15 @@ export class ProjectMigration {
                 }));
                 box.capture.refer(captureBox);
                 boxGraph.endTransaction();
+            },
+            visitRevampDeviceBox: (box) => {
+                // Clamp order in RevampDeviceBox to 0-3
+                // The older version stored the actual order,
+                // but the new version only stores indices, so 4 is not valid anymore
+                boxGraph.beginTransaction();
+                box.lowPass.order.setValue(clamp(box.lowPass.order.getValue(), 0, 3));
+                box.highPass.order.setValue(clamp(box.highPass.order.getValue(), 0, 3));
+                boxGraph.endTransaction();
             }
         }));
     }

package/dist/project/Recovery.d.ts

@@ -0,0 +1,9 @@
+import { Option, Provider } from "@opendaw/lib-std";
+import { ProjectEnv, ProjectProfile } from "../";
+export declare class Recovery {
+    #private;
+    constructor(projectProfileService: Provider<Option<ProjectProfile>>, env: ProjectEnv);
+    restoreProfile(): Promise<Option<ProjectProfile>>;
+    createBackupCommand(): Option<Provider<Promise<void>>>;
+}
+//# sourceMappingURL=Recovery.d.ts.map

package/dist/project/Recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Recovery.d.ts","sourceRoot":"","sources":["../../src/project/Recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAO,MAAM,kBAAkB,CAAA;AAEvD,OAAO,EAAU,UAAU,EAAe,cAAc,EAAU,MAAM,KAAK,CAAA;AAE7E,qBAAa,QAAQ;;gBAML,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU;IAK9E,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAsBvD,mBAAmB,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAgBzD"}

package/dist/project/Recovery.js

@@ -0,0 +1,49 @@
+import { Option, UUID } from "@opendaw/lib-std";
+import { Promises } from "@opendaw/lib-runtime";
+import { Project, ProjectProfile, Workers } from "../";
+export class Recovery {
+    static #RESTORE_FILE_PATH = ".backup";
+    #projectProfileProvider;
+    #env;
+    constructor(projectProfileService, env) {
+        this.#projectProfileProvider = projectProfileService;
+        this.#env = env;
+    }
+    async restoreProfile() {
+        const backupResult = await Promises.tryCatch(Workers.Opfs.list(Recovery.#RESTORE_FILE_PATH));
+        if (backupResult.status === "rejected" || backupResult.value.length === 0) {
+            return Option.None;
+        }
+        const readResult = await Promises.tryCatch(Promise.all([
+            Workers.Opfs.read(`${Recovery.#RESTORE_FILE_PATH}/uuid`)
+                .then(x => UUID.validateBytes(x)),
+            Workers.Opfs.read(`${Recovery.#RESTORE_FILE_PATH}/project.od`)
+                .then(x => Project.load(this.#env, x.buffer)),
+            Workers.Opfs.read(`${Recovery.#RESTORE_FILE_PATH}/meta.json`)
+                .then(x => JSON.parse(new TextDecoder().decode(x.buffer))),
+            Workers.Opfs.read(`${Recovery.#RESTORE_FILE_PATH}/saved`)
+                .then(x => x.at(0) === 1)
+        ]));
+        const deleteResult = await Promises.tryCatch(Workers.Opfs.delete(Recovery.#RESTORE_FILE_PATH));
+        console.debug(`delete backup: "${deleteResult.status}"`);
+        if (readResult.status === "rejected") {
+            return Option.None;
+        }
+        const [uuid, project, meta, saved] = readResult.value;
+        const profile = new ProjectProfile(uuid, project, meta, Option.None, saved);
+        console.debug(`restore ${profile}, saved: ${saved}`);
+        return Option.wrap(profile);
+    }
+    createBackupCommand() {
+        return this.#projectProfileProvider().map((profile) => async () => {
+            console.debug("backup project");
+            const { project, meta, uuid } = profile;
+            return Promises.tryCatch(Promise.all([
+                Workers.Opfs.write(`${Recovery.#RESTORE_FILE_PATH}/uuid`, uuid),
+                Workers.Opfs.write(`${Recovery.#RESTORE_FILE_PATH}/project.od`, new Uint8Array(project.toArrayBuffer())),
+                Workers.Opfs.write(`${Recovery.#RESTORE_FILE_PATH}/meta.json`, new TextEncoder().encode(JSON.stringify(meta))),
+                Workers.Opfs.write(`${Recovery.#RESTORE_FILE_PATH}/saved`, new Uint8Array([profile.saved() ? 1 : 0]))
+            ])).then(result => console.debug(`backup result: ${result.status}`));
+        });
+    }
+}

package/dist/project/index.d.ts

@@ -7,4 +7,5 @@ export * from "./ProjectPaths";
 export * from "./ProjectProfile";
 export * from "./ProjectSignals";
 export * from "./ProjectStorage";
+export * from "./Recovery";
 //# sourceMappingURL=index.d.ts.map

package/dist/project/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA"}

package/dist/project/index.js

@@ -7,3 +7,4 @@ export * from "./ProjectPaths";
 export * from "./ProjectProfile";
 export * from "./ProjectSignals";
 export * from "./ProjectStorage";
+export * from "./Recovery";