@opendaw/studio-core 0.0.100 → 0.0.102

package/dist/project/Project.d.ts

@@ -1,7 +1,7 @@
 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 { BoxAdapters, BoxAdaptersContext, ClipSequencing, DeviceBoxAdapter, FilteredSelection, ParameterFieldAdapters, ProcessorOptions, ProjectSkeleton, RootBoxAdapter, SampleLoaderManager, SoundfontLoaderManager, TimelineBoxAdapter, UserEditingManager, VertexSelection } from "@opendaw/studio-adapters";
 import { LiveStreamBroadcaster, LiveStreamReceiver } from "@opendaw/lib-fusion";
 import { ProjectEnv } from "./ProjectEnv";
 import { Mixer } from "../Mixer";
@@ -11,6 +11,7 @@ import { EngineFacade } from "../EngineFacade";
 import { EngineWorklet } from "../EngineWorklet";
 import { MIDILearning } from "../midi";
 import { ppqn, TempoMap } from "@opendaw/lib-dsp";
+import { RegionOverlapResolver, TimelineFocus } from "../ui";
 export type RestartWorklet = {
     unload: Func<unknown, Promise<unknown>>;
     load: Procedure<EngineWorklet>;
@@ -34,6 +35,7 @@ export declare class Project implements BoxAdaptersContext, Terminable, Terminab
     readonly captureDevices: CaptureDevices;
     readonly editing: BoxEditing;
     readonly selection: VertexSelection;
+    readonly deviceSelection: FilteredSelection<DeviceBoxAdapter>;
     readonly boxAdapters: BoxAdapters;
     readonly userEditingManager: UserEditingManager;
     readonly parameterFieldAdapters: ParameterFieldAdapters;
@@ -41,9 +43,12 @@ export declare class Project implements BoxAdaptersContext, Terminable, Terminab
     readonly midiLearning: MIDILearning;
     readonly mixer: Mixer;
     readonly tempoMap: TempoMap;
+    readonly overlapResolver: RegionOverlapResolver;
+    readonly timelineFocus: TimelineFocus;
     readonly engine: EngineFacade;
     private constructor();
     startAudioWorklet(restart?: RestartWorklet, options?: ProcessorOptions): EngineWorklet;
+    handleCpuOverload(): void;
     startRecording(countIn?: boolean): void;
     follow(box: UserInterfaceBox): void;
     own<T extends Terminable>(terminable: T): T;
@@ -66,6 +71,7 @@ export declare class Project implements BoxAdaptersContext, Terminable, Terminab
     copy(env?: Partial<ProjectEnv>): Project;
     invalid(): boolean;
     lastRegionAction(): ppqn;
+    trackUserCreatedSample(uuid: UUID.Bytes): void;
     terminate(): void;
 }
 //# sourceMappingURL=Project.d.ts.map

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,7 +1,7 @@
-import { Arrays, isDefined, panic, safeExecute, Terminator, UUID } from "@opendaw/lib-std";
+import { Arrays, isDefined, panic, RuntimeNotifier, safeExecute, Terminator, UUID } from "@opendaw/lib-std";
 import { BoxEditing, DeleteUpdate, NewUpdate } from "@opendaw/lib-box";
 import { AudioFileBox, AudioRegionBox } from "@opendaw/studio-boxes";
-import { BoxAdapters, ParameterFieldAdapters, ProjectSkeleton, RootBoxAdapter, TimelineBoxAdapter, UnionBoxTypes, UserEditingManager, VaryingTempoMap, VertexSelection } from "@opendaw/studio-adapters";
+import { BoxAdapters, DeviceBoxUtils, Devices, isVertexOfBox, ParameterFieldAdapters, ProjectSkeleton, RootBoxAdapter, TimelineBoxAdapter, UnionBoxTypes, UserEditingManager, VaryingTempoMap, VertexSelection } from "@opendaw/studio-adapters";
 import { LiveStreamReceiver } from "@opendaw/lib-fusion";
 import { Mixer } from "../Mixer";
 import { ProjectApi } from "./ProjectApi";
@@ -13,6 +13,8 @@ import { ProjectValidation } from "./ProjectValidation";
 import { TimeBase } from "@opendaw/lib-dsp";
 import { MidiData } from "@opendaw/lib-midi";
 import { StudioPreferences } from "../StudioPreferences";
+import { RegionOverlapResolver, TimelineFocus } from "../ui";
+import { SampleStorage } from "../samples";
 // Main Entry Point for a Project
 export class Project {
     static new(env, options) {
@@ -47,6 +49,7 @@ export class Project {
     }
     #terminator = new Terminator();
     #sampleRegistrations;
+    #userCreatedSamples = UUID.newSet(uuid => uuid);
     #env;
     boxGraph;
     rootBox;
@@ -58,6 +61,7 @@ export class Project {
     captureDevices;
     editing;
     selection;
+    deviceSelection;
     boxAdapters;
     userEditingManager;
     parameterFieldAdapters;
@@ -65,7 +69,11 @@ export class Project {
     midiLearning;
     mixer;
     tempoMap;
+    overlapResolver;
+    timelineFocus;
     engine = new EngineFacade();
+    #rootBoxAdapter;
+    #timelineBoxAdapter;
     constructor(env, boxGraph, { rootBox, userInterfaceBoxes, primaryAudioBus, primaryAudioOutputUnit, timelineBox }) {
         this.#env = env;
         this.boxGraph = boxGraph;
@@ -79,12 +87,20 @@ export class Project {
         this.selection = new VertexSelection(this.editing, this.boxGraph);
         this.parameterFieldAdapters = new ParameterFieldAdapters();
         this.boxAdapters = this.#terminator.own(new BoxAdapters(this));
-        this.tempoMap = new VaryingTempoMap(this.timelineBoxAdapter);
+        this.deviceSelection = this.#terminator.own(this.selection.createFilteredSelection(isVertexOfBox(DeviceBoxUtils.isDeviceBox), {
+            fx: (adapter) => adapter.box,
+            fy: vertex => this.boxAdapters.adapterFor(vertex.box, Devices.isAny)
+        }));
+        this.#timelineBoxAdapter = this.boxAdapters.adapterFor(this.timelineBox, TimelineBoxAdapter);
+        this.tempoMap = this.#terminator.own(new VaryingTempoMap(this.#timelineBoxAdapter));
         this.userEditingManager = new UserEditingManager(this.editing);
         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);
+        this.#rootBoxAdapter = this.boxAdapters.adapterFor(this.rootBox, RootBoxAdapter);
+        this.mixer = new Mixer(this.#rootBoxAdapter.audioUnits);
+        this.overlapResolver = new RegionOverlapResolver(this.editing, this.api, this.boxAdapters);
+        this.timelineFocus = this.#terminator.own(new TimelineFocus());
         console.debug(`Project was created on ${this.rootBoxAdapter.created.toString()}`);
         this.#sampleRegistrations = UUID.newSet(({ uuid }) => uuid);
         for (const box of this.boxGraph.boxes()) {
@@ -99,6 +115,7 @@ export class Project {
                 }
                 else if (update instanceof DeleteUpdate && update.name === AudioFileBox.ClassName) {
                     this.#unregisterSample(update.uuid);
+                    this.#deleteUserCreatedSample(update.uuid);
                 }
             }
         }));
@@ -122,6 +139,16 @@ export class Project {
         this.engine.setWorklet(worklet);
         return worklet;
     }
+    handleCpuOverload() {
+        if (!StudioPreferences.settings.engine["stop-playback-when-overloading"]) {
+            return;
+        }
+        this.engine.sleep();
+        RuntimeNotifier.info({
+            headline: "CPU Overload Detected",
+            message: "Playback has been stopped. Try removing heavy plugins or effects."
+        }).finally();
+    }
     startRecording(countIn = true) {
         this.engine.assertWorklet();
         if (Recording.isRecording) {
@@ -138,8 +165,8 @@ export class Project {
     ownAll(...terminables) { return this.#terminator.ownAll(...terminables); }
     spawn() { return this.#terminator.spawn(); }
     get env() { return this.#env; }
-    get rootBoxAdapter() { return this.boxAdapters.adapterFor(this.rootBox, RootBoxAdapter); }
-    get timelineBoxAdapter() { return this.boxAdapters.adapterFor(this.timelineBox, TimelineBoxAdapter); }
+    get rootBoxAdapter() { return this.#rootBoxAdapter; }
+    get timelineBoxAdapter() { return this.#timelineBoxAdapter; }
     get sampleManager() { return this.#env.sampleManager; }
     get soundfontManager() { return this.#env.soundfontManager; }
     get clipSequencing() { return panic("Only available in audio context"); }
@@ -204,8 +231,8 @@ export class Project {
         return Project.load({ ...this.#env, ...env }, this.toArrayBuffer());
     }
     invalid() {
-        // TODO Optimise. Flag changes somewhere.
-        return this.boxGraph.boxes().some(box => box.accept({
+        const now = performance.now();
+        const result = this.boxGraph.boxes().some(box => box.accept({
             visitTrackBox: (box) => {
                 for (const [current, next] of Arrays.iterateAdjacent(box.regions.pointerHub.incoming()
                     .map(({ box }) => UnionBoxTypes.asRegionBox(box))
@@ -220,6 +247,10 @@ export class Project {
                 return false;
             }
         }) ?? false);
+        if (performance.now() - now > 5) {
+            console.warn("Evaluation of invalid project takes more than 5ms");
+        }
+        return result;
     }
     lastRegionAction() {
         return this.rootBoxAdapter.audioUnits.adapters()
@@ -227,6 +258,9 @@ export class Project {
             .map(trackAdapter => trackAdapter.regions.collection.asArray().at(-1)))
             .filter(isDefined).reduce((position, region) => Math.max(position, region.complete), 0);
     }
+    trackUserCreatedSample(uuid) {
+        this.#userCreatedSamples.add(uuid);
+    }
     terminate() {
         this.#sampleRegistrations.forEach(({ terminable }) => terminable.terminate());
         this.#sampleRegistrations.clear();
@@ -239,4 +273,20 @@ export class Project {
     #unregisterSample(uuid) {
         this.#sampleRegistrations.removeByKey(uuid).terminable.terminate();
     }
+    async #deleteUserCreatedSample(uuid) {
+        if (!this.#userCreatedSamples.hasKey(uuid)) {
+            return;
+        }
+        this.#userCreatedSamples.removeByKey(uuid);
+        const autoDelete = StudioPreferences.settings.storage["auto-delete-orphaned-samples"];
+        if (!autoDelete && !await RuntimeNotifier.approve({
+            headline: "Delete Sample?",
+            message: "The sample is no longer used. Delete it from storage? This cannot be undone!",
+            approveText: "Delete",
+            cancelText: "Keep"
+        })) {
+            return;
+        }
+        SampleStorage.get().deleteItem(uuid).catch((reason) => console.warn("Failed to delete sample from storage", reason));
+    }
 }

package/dist/project/ProjectApi.d.ts

@@ -59,7 +59,7 @@ export declare class ProjectApi {
     createNotStretchedClip(props: AudioContentFactory.NotStretchedProps & AudioContentFactory.Clip): AudioClipBox;
     createNotStretchedRegion(props: AudioContentFactory.NotStretchedProps & AudioContentFactory.Region): AudioRegionBox;
     createNoteClip(trackBox: TrackBox, clipIndex: int, { name, hue }?: ClipRegionOptions): NoteClipBox;
-    duplicateRegion<R extends AnyRegionBoxAdapter>(region: R): R;
+    duplicateRegion<R extends AnyRegionBoxAdapter>(region: R): Option<R>;
     quantiseNotes(collection: NoteEventCollectionBox, { positionQuantisation, durationQuantisation }: QuantiseNotesOptions): void;
     createValueClip(trackBox: TrackBox, clipIndex: int, { name, hue }?: ClipRegionOptions): ValueClipBox;
     createNoteRegion({ trackBox, position, duration, loopOffset, loopDuration, eventOffset, eventCollection, mute, name, hue }: NoteRegionParams): NoteRegionBox;

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

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

package/dist/project/ProjectApi.js

@@ -5,7 +5,6 @@ import { AudioUnitType } from "@opendaw/studio-enums";
 import { AudioUnitBox, CaptureAudioBox, CaptureMidiBox, NoteClipBox, NoteEventBox, NoteEventCollectionBox, NoteRegionBox, TrackBox, ValueClipBox, ValueEventCollectionBox, ValueRegionBox } from "@opendaw/studio-boxes";
 import { AudioUnitFactory, ColorCodes, ProjectQueries, TrackType } from "@opendaw/studio-adapters";
 import { AudioContentFactory } from "./audio";
-import { RegionClipResolver } from "../ui";
 // noinspection JSUnusedGlobalSymbols
 export class ProjectApi {
     #project;
@@ -111,10 +110,25 @@ export class ProjectApi {
         });
     }
     duplicateRegion(region) {
+        if (region.trackBoxAdapter.isEmpty()) {
+            return Option.None;
+        }
+        const track = region.trackBoxAdapter.unwrap();
         const clearFrom = region.position + region.duration;
         const clearTo = region.complete + region.duration;
-        RegionClipResolver.fromRange(region.trackBoxAdapter.unwrap("Region is invalid"), clearFrom, clearTo)();
-        return region.copyTo({ position: region.complete, consolidate: true });
+        // Resolve target track (for keep-existing mode)
+        const targetTrack = this.#project.overlapResolver.resolveTargetTrack(track, clearFrom, clearTo);
+        // Capture overlap state before creating (for clip/push-existing modes)
+        const solver = this.#project.overlapResolver.fromRange(targetTrack, clearFrom, clearTo);
+        // Create the duplicate on target track
+        const duplicate = region.copyTo({
+            position: region.complete,
+            consolidate: true,
+            track: targetTrack !== track ? targetTrack.box.regions : undefined
+        });
+        // Apply overlap resolution
+        solver();
+        return Option.wrap(duplicate);
     }
     quantiseNotes(collection, { positionQuantisation, durationQuantisation }) {
         if (isAbsent(positionQuantisation) && isAbsent(durationQuantisation)) {

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectMigration.d.ts","sourceRoot":"","sources":["../../src/project/ProjectMigration.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAA;AAExD,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AAgBvC,qBAAa,gBAAgB;WACZ,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,EAAC,QAAQ,EAAE,cAAc,EAAC,EAAE,eAAe;CA6DpF"}
+{"version":3,"file":"ProjectMigration.d.ts","sourceRoot":"","sources":["../../src/project/ProjectMigration.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAA;AAExD,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AAiBvC,qBAAa,gBAAgB;WACZ,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,EAAC,QAAQ,EAAE,cAAc,EAAC,EAAE,eAAe;CA8DpF"}

package/dist/project/ProjectMigration.js

@@ -1,6 +1,6 @@
 import { GrooveShuffleBox } from "@opendaw/studio-boxes";
 import { asInstanceOf, UUID } from "@opendaw/lib-std";
-import { migrateAudioClipBox, migrateAudioFileBox, migrateAudioRegionBox, migrateAudioUnitBox, migrateDelayDeviceBox, migrateMIDIOutputDeviceBox, migrateRevampDeviceBox, migrateTimelineBox, migrateValueEventBox, migrateValueEventCollection, migrateVaporisateurDeviceBox, migrateZeitgeistDeviceBox } from "./migration";
+import { migrateAudioClipBox, migrateAudioFileBox, migrateAudioRegionBox, migrateAudioUnitBox, migrateDelayDeviceBox, migrateMIDIOutputDeviceBox, migrateNeuralAmpDeviceBox, migrateRevampDeviceBox, migrateTimelineBox, migrateValueEventBox, migrateValueEventCollection, migrateVaporisateurDeviceBox, migrateZeitgeistDeviceBox } from "./migration";
 export class ProjectMigration {
     static async migrate(env, { boxGraph, mandatoryBoxes }) {
         const { rootBox, timelineBox: { bpm } } = mandatoryBoxes;
@@ -46,7 +46,8 @@ export class ProjectMigration {
         // 1st pass (2nd pass might rely on those changes)
         for (const box of boxGraph.boxes()) {
             await box.accept({
-                visitAudioFileBox: (box) => migrateAudioFileBox(boxGraph, box, loadAudioData)
+                visitAudioFileBox: (box) => migrateAudioFileBox(boxGraph, box, loadAudioData),
+                visitNeuralAmpDeviceBox: (box) => migrateNeuralAmpDeviceBox(boxGraph, box)
             });
         }
         // 2nd pass. We need to run on a copy, because we might add more boxes during the migration

package/dist/project/audio/AudioContentFactory.d.ts

@@ -29,6 +29,11 @@ export declare namespace AudioContentFactory {
     } & Props;
     type PitchStretchedProps = {} & Props;
     type NotStretchedProps = {} & Props;
+    /**
+     * Calculates the duration of an audio region based on sample properties.
+     * Returns duration in PPQN for stretched regions, or in seconds for non-stretched.
+     */
+    const calculateDuration: (sample: Sample) => ppqn;
     const createTimeStretchedRegion: (props: TimeStretchedProps & Region) => AudioRegionBox;
     const createPitchStretchedRegion: (props: PitchStretchedProps & Region) => AudioRegionBox;
     const createNotStretchedRegion: (props: NotStretchedProps & Region) => AudioRegionBox;

package/dist/project/audio/AudioContentFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioContentFactory.d.ts","sourceRoot":"","sources":["../../../src/project/audio/AudioContentFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAiB,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAa,MAAM,EAAY,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAC,GAAG,EAAuC,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EACH,YAAY,EACZ,YAAY,EAEZ,cAAc,EAEd,QAAQ,EAEX,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AAEvD,yBAAiB,mBAAmB,CAAC;IACjC,KAAY,KAAK,GAAG;QAChB,QAAQ,EAAE,QAAQ,CAAA;QAClB,WAAW,EAAE,QAAQ,CAAA;QACrB,YAAY,EAAE,YAAY,CAAA;QAC1B,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;QACxB,WAAW,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;QAC/C,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IAED,KAAY,IAAI,GAAG,KAAK,GAAG;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAA;IACzC,KAAY,MAAM,GAAG,KAAK,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAE9D,KAAY,kBAAkB,GAAG;QAC7B,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;QACrC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,GAAG,KAAK,CAAA;IAET,KAAY,mBAAmB,GAAG,EAA0C,GAAG,KAAK,CAAA;IAEpF,KAAY,iBAAiB,GAAG,EAA0C,GAAG,KAAK,CAAA;IAI3E,MAAM,yBAAyB,GAAI,OAAO,kBAAkB,GAAG,MAAM,KAAG,cAM9E,CAAA;IAEM,MAAM,0BAA0B,GAAI,OAAO,mBAAmB,GAAG,MAAM,KAAG,cAEhF,CAAA;IAEM,MAAM,wBAAwB,GAAI,OAAO,iBAAiB,GAAG,MAAM,KAAG,cAgB5E,CAAA;IAIM,MAAM,uBAAuB,GAAI,OAAO,kBAAkB,GAAG,IAAI,KAAG,YAM1E,CAAA;IAEM,MAAM,wBAAwB,GAAI,OAAO,mBAAmB,GAAG,IAAI,KAAG,YAG5E,CAAA;IAEM,MAAM,sBAAsB,GAAI,OAAO,iBAAiB,GAAG,IAAI,KAAG,YAcxE,CAAA;CA6DJ"}
+{"version":3,"file":"AudioContentFactory.d.ts","sourceRoot":"","sources":["../../../src/project/audio/AudioContentFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAiB,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAa,MAAM,EAAY,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAC,GAAG,EAAuC,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EACH,YAAY,EACZ,YAAY,EAEZ,cAAc,EAEd,QAAQ,EAEX,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AAEvD,yBAAiB,mBAAmB,CAAC;IACjC,KAAY,KAAK,GAAG;QAChB,QAAQ,EAAE,QAAQ,CAAA;QAClB,WAAW,EAAE,QAAQ,CAAA;QACrB,YAAY,EAAE,YAAY,CAAA;QAC1B,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;QACxB,WAAW,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;QAC/C,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IAED,KAAY,IAAI,GAAG,KAAK,GAAG;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAA;IACzC,KAAY,MAAM,GAAG,KAAK,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAE9D,KAAY,kBAAkB,GAAG;QAC7B,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;QACrC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,GAAG,KAAK,CAAA;IAET,KAAY,mBAAmB,GAAG,EAA0C,GAAG,KAAK,CAAA;IAEpF,KAAY,iBAAiB,GAAG,EAA0C,GAAG,KAAK,CAAA;IAElF;;;OAGG;IACI,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,IAQlD,CAAA;IAIM,MAAM,yBAAyB,GAAI,OAAO,kBAAkB,GAAG,MAAM,KAAG,cAM9E,CAAA;IAEM,MAAM,0BAA0B,GAAI,OAAO,mBAAmB,GAAG,MAAM,KAAG,cAEhF,CAAA;IAEM,MAAM,wBAAwB,GAAI,OAAO,iBAAiB,GAAG,MAAM,KAAG,cAgB5E,CAAA;IAIM,MAAM,uBAAuB,GAAI,OAAO,kBAAkB,GAAG,IAAI,KAAG,YAM1E,CAAA;IAEM,MAAM,wBAAwB,GAAI,OAAO,mBAAmB,GAAG,IAAI,KAAG,YAG5E,CAAA;IAEM,MAAM,sBAAsB,GAAI,OAAO,iBAAiB,GAAG,IAAI,KAAG,YAcxE,CAAA;CA6DJ"}

package/dist/project/audio/AudioContentFactory.js

@@ -6,6 +6,19 @@ import { TransientPlayMode } from "@opendaw/studio-enums";
 import { AudioContentHelpers } from "./AudioContentHelpers";
 export var AudioContentFactory;
 (function (AudioContentFactory) {
+    /**
+     * Calculates the duration of an audio region based on sample properties.
+     * Returns duration in PPQN for stretched regions, or in seconds for non-stretched.
+     */
+    AudioContentFactory.calculateDuration = (sample) => {
+        const { duration: durationInSeconds, bpm } = sample;
+        if (bpm === 0) {
+            // Non-stretched: duration is in seconds
+            return durationInSeconds;
+        }
+        // Stretched: duration is in PPQN
+        return quantizeCeil(PPQN.secondsToPulses(durationInSeconds, bpm), PPQN.SemiQuaver);
+    };
     // --- Region Creation --- //
     AudioContentFactory.createTimeStretchedRegion = (props) => {
         const { boxGraph, playbackRate, transientPlayMode } = props;

package/dist/project/migration/MigrateNeuralAmpDeviceBox.d.ts

@@ -0,0 +1,4 @@
+import { BoxGraph } from "@opendaw/lib-box";
+import { BoxIO, NeuralAmpDeviceBox } from "@opendaw/studio-boxes";
+export declare const migrateNeuralAmpDeviceBox: (boxGraph: BoxGraph<BoxIO.TypeMap>, box: NeuralAmpDeviceBox) => Promise<void>;
+//# sourceMappingURL=MigrateNeuralAmpDeviceBox.d.ts.map

package/dist/project/migration/MigrateNeuralAmpDeviceBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrateNeuralAmpDeviceBox.d.ts","sourceRoot":"","sources":["../../../src/project/migration/MigrateNeuralAmpDeviceBox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAC,KAAK,EAAE,kBAAkB,EAAoB,MAAM,uBAAuB,CAAA;AAElF,eAAO,MAAM,yBAAyB,GAAU,UAAU,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,kBAAkB,KAAG,OAAO,CAAC,IAAI,CAsBxH,CAAA"}

package/dist/project/migration/MigrateNeuralAmpDeviceBox.js

@@ -0,0 +1,29 @@
+import { UUID } from "@opendaw/lib-std";
+import { NeuralAmpModelBox } from "@opendaw/studio-boxes";
+export const migrateNeuralAmpDeviceBox = async (boxGraph, box) => {
+    const oldJson = box.modelJson.getValue();
+    if (oldJson.length === 0) {
+        return;
+    }
+    if (box.model.targetVertex.nonEmpty()) {
+        return;
+    }
+    const jsonBuffer = new TextEncoder().encode(oldJson);
+    const uuid = await UUID.sha256(jsonBuffer.buffer);
+    let modelBox = null;
+    for (const existing of boxGraph.boxes()) {
+        if (existing instanceof NeuralAmpModelBox && UUID.equals(existing.address.uuid, uuid)) {
+            modelBox = existing;
+            break;
+        }
+    }
+    boxGraph.beginTransaction();
+    if (modelBox === null) {
+        modelBox = NeuralAmpModelBox.create(boxGraph, uuid);
+        modelBox.label.setValue("Imported Model");
+        modelBox.model.setValue(oldJson);
+    }
+    box.model.refer(modelBox);
+    boxGraph.endTransaction();
+    console.debug(`Migrated NeuralAmpDeviceBox to use NeuralAmpModelBox (${UUID.toString(uuid).slice(0, 8)})`);
+};

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

@@ -4,6 +4,7 @@ export { migrateAudioRegionBox } from "./MigrateAudioRegionBox";
 export { migrateAudioUnitBox } from "./MigrateAudioUnitBox";
 export { migrateDelayDeviceBox } from "./MigrateDelayDeviceBox";
 export { migrateMIDIOutputDeviceBox } from "./MigrateMIDIOutputDeviceBox";
+export { migrateNeuralAmpDeviceBox } from "./MigrateNeuralAmpDeviceBox";
 export { migrateRevampDeviceBox } from "./MigrateRevampDeviceBox";
 export { migrateTimelineBox } from "./MigrateTimelineBox";
 export { migrateValueEventBox } from "./MigrateValueEventBox";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/project/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAC,0BAA0B,EAAC,MAAM,8BAA8B,CAAA;AACvE,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAC,2BAA2B,EAAC,MAAM,+BAA+B,CAAA;AACzE,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAA;AAC3E,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/project/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAC,0BAA0B,EAAC,MAAM,8BAA8B,CAAA;AACvE,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAC,2BAA2B,EAAC,MAAM,+BAA+B,CAAA;AACzE,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAA;AAC3E,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAA"}

package/dist/project/migration/index.js

@@ -4,6 +4,7 @@ export { migrateAudioRegionBox } from "./MigrateAudioRegionBox";
 export { migrateAudioUnitBox } from "./MigrateAudioUnitBox";
 export { migrateDelayDeviceBox } from "./MigrateDelayDeviceBox";
 export { migrateMIDIOutputDeviceBox } from "./MigrateMIDIOutputDeviceBox";
+export { migrateNeuralAmpDeviceBox } from "./MigrateNeuralAmpDeviceBox";
 export { migrateRevampDeviceBox } from "./MigrateRevampDeviceBox";
 export { migrateTimelineBox } from "./MigrateTimelineBox";
 export { migrateValueEventBox } from "./MigrateValueEventBox";

package/dist/ui/{generic → clipboard}/ClipboardManager.d.ts

@@ -1,7 +1,7 @@
-import { Client, JSONValue, Option, Subscription } from "@opendaw/lib-std";
-export type ClipboardEntry<T extends string = string, D extends JSONValue = JSONValue> = {
+import { Client, Option, Subscription } from "@opendaw/lib-std";
+export type ClipboardEntry<T extends string = string> = {
     readonly type: T;
-    readonly data: D;
+    readonly data: ArrayBufferLike;
 };
 export interface ClipboardHandler<E extends ClipboardEntry> {
     canCopy(client: Client): boolean;

package/dist/ui/clipboard/ClipboardManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardManager.d.ts","sourceRoot":"","sources":["../../../src/ui/clipboard/ClipboardManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAa,MAAM,kBAAkB,CAAA;AASzE,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACpD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CACjC,CAAA;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,cAAc;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IACxD,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;IACjB,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;IAChB,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CACrC;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,KAAK,QAAQ,GAAG,cAAc,CAAA;IA0B9B,MAAM,CAAC,MAAM,OAAO,GAAI,CAAC,SAAS,QAAQ,EAAE,SAAS,WAAW,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,KAAG,YAwGhG,CAAA;;CACJ"}

package/dist/ui/clipboard/ClipboardManager.js

@@ -0,0 +1,147 @@
+import { Option, Terminable } from "@opendaw/lib-std";
+import { Events, ReservedShortcuts } from "@opendaw/lib-dom";
+import { ContextMenu } from "./ContextMenu";
+import { MenuItem } from "../menu/MenuItems";
+import { StudioPreferences } from "../../StudioPreferences";
+const CLIPBOARD_HEADER = "OPENDAW";
+const CLIPBOARD_VERSION = 2;
+export var ClipboardManager;
+(function (ClipboardManager) {
+    let fallbackEntry = Option.None;
+    const encode = (entry) => {
+        const bytes = new Uint8Array(entry.data);
+        let binary = "";
+        for (let i = 0; i < bytes.length; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return `${CLIPBOARD_HEADER}:${CLIPBOARD_VERSION}:${entry.type}:${btoa(binary)}`;
+    };
+    const decode = (text) => {
+        const parts = text.split(":");
+        if (parts.length < 4 || parts[0] !== CLIPBOARD_HEADER) {
+            return Option.None;
+        }
+        const version = parseInt(parts[1], 10);
+        if (version !== CLIPBOARD_VERSION) {
+            return Option.None;
+        }
+        return Option.tryCatch(() => {
+            const type = parts[2];
+            const base64 = parts.slice(3).join(":");
+            const binary = atob(base64);
+            const bytes = new Uint8Array(binary.length);
+            for (let i = 0; i < binary.length; i++) {
+                bytes[i] = binary.charCodeAt(i);
+            }
+            return { type, data: bytes.buffer };
+        });
+    };
+    ClipboardManager.install = (element, handler) => {
+        const writeEntry = (entry) => {
+            fallbackEntry = Option.wrap(entry);
+            navigator.clipboard?.writeText(encode(entry)).catch(() => { });
+        };
+        const performCopy = () => {
+            const entry = handler.copy();
+            entry.ifSome(writeEntry);
+            return entry.nonEmpty();
+        };
+        const performCut = () => {
+            const entry = handler.cut();
+            entry.ifSome(writeEntry);
+            return entry.nonEmpty();
+        };
+        const performPaste = async () => {
+            try {
+                const rawText = await navigator.clipboard.readText();
+                const text = Option.wrap(rawText);
+                const entry = text.flatMap(decode);
+                if (entry.nonEmpty()) {
+                    handler.paste(entry.unwrap());
+                }
+                else {
+                    fallbackEntry.ifSome(entry => handler.paste(entry));
+                }
+            }
+            catch (_error) {
+                fallbackEntry.ifSome(entry => handler.paste(entry));
+            }
+        };
+        return Terminable.many(Events.subscribe(element, "copy", (event) => {
+            handler.copy().ifSome(entry => {
+                event.preventDefault();
+                event.stopPropagation();
+                const encoded = encode(entry);
+                fallbackEntry = Option.wrap(entry);
+                event.clipboardData?.setData("text/plain", encoded);
+            });
+        }), Events.subscribe(element, "cut", (event) => {
+            handler.cut().ifSome(entry => {
+                event.preventDefault();
+                event.stopPropagation();
+                const encoded = encode(entry);
+                fallbackEntry = Option.wrap(entry);
+                event.clipboardData?.setData("text/plain", encoded);
+            });
+        }), Events.subscribe(document, "paste", (event) => {
+            if (!element.contains(document.activeElement) && document.activeElement !== document.body) {
+                return;
+            }
+            const text = event.clipboardData?.getData("text/plain") ?? "";
+            const entry = decode(text);
+            if (entry.nonEmpty()) {
+                event.preventDefault();
+                handler.paste(entry.unwrap());
+            }
+            else {
+                fallbackEntry.ifSome(entry => {
+                    event.preventDefault();
+                    handler.paste(entry);
+                });
+            }
+        }), Events.subscribe(document, "keydown", (event) => {
+            if (!element.contains(document.activeElement) && document.activeElement !== document.body) {
+                return;
+            }
+            const isMod = event.metaKey || event.ctrlKey;
+            if (!isMod || event.shiftKey || event.altKey) {
+                return;
+            }
+            if (event.key === "c") {
+                if (performCopy()) {
+                    event.preventDefault();
+                    event.stopImmediatePropagation();
+                }
+            }
+            else if (event.key === "x") {
+                if (performCut()) {
+                    event.preventDefault();
+                    event.stopImmediatePropagation();
+                }
+            }
+        }), ContextMenu.subscribe(element, async (collector) => {
+            if (!StudioPreferences.settings.editing["show-clipboard-menu"]) {
+                return;
+            }
+            const { client } = collector;
+            const text = await Option.async(navigator.clipboard.readText());
+            const entry = text.flatMap(decode);
+            const canPaste = entry.map(entry => handler.canPaste(entry, client))
+                .unwrapOrElse(() => fallbackEntry
+                .map(entry => handler.canPaste(entry, client)).unwrapOrElse(false));
+            collector.addItems(MenuItem.default({
+                label: "Cut",
+                shortcut: ReservedShortcuts.Cut.format(),
+                selectable: handler.canCut(client)
+            }).setTriggerProcedure(performCut), MenuItem.default({
+                label: "Copy",
+                shortcut: ReservedShortcuts.Copy.format(),
+                selectable: handler.canCopy(client)
+            }).setTriggerProcedure(performCopy), MenuItem.default({
+                label: "Paste",
+                shortcut: ReservedShortcuts.Paste.format(),
+                selectable: canPaste
+            }).setTriggerProcedure(performPaste));
+        }));
+    };
+})(ClipboardManager || (ClipboardManager = {}));

package/dist/ui/clipboard/ClipboardUtils.d.ts

@@ -0,0 +1,12 @@
+import { Predicate, Procedure } from "@opendaw/lib-std";
+import { Box, BoxGraph, SpecialDecoder } from "@opendaw/lib-box";
+export declare namespace ClipboardUtils {
+    const extractMetadata: (data: ArrayBufferLike) => ArrayBufferLike;
+    const serializeBoxes: (boxes: ReadonlyArray<Box>, metadata?: ArrayBufferLike) => ArrayBufferLike;
+    const deserializeBoxes: <T extends Box = Box>(data: ArrayBufferLike, targetGraph: BoxGraph, options: {
+        mapPointer: SpecialDecoder["map"];
+        modifyBox?: Procedure<T>;
+        excludeBox?: Predicate<Box>;
+    }) => ReadonlyArray<T>;
+}
+//# sourceMappingURL=ClipboardUtils.d.ts.map

package/dist/ui/clipboard/ClipboardUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardUtils.d.ts","sourceRoot":"","sources":["../../../src/ui/clipboard/ClipboardUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,SAAS,EAAE,SAAS,EAAO,MAAM,kBAAkB,CAAA;AACpG,OAAO,EAAC,GAAG,EAAE,QAAQ,EAAgB,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAK5E,yBAAiB,cAAc,CAAC;IACrB,MAAM,eAAe,GAAI,MAAM,eAAe,KAAG,eAMvD,CAAA;IAEM,MAAM,cAAc,GAAI,OAAO,aAAa,CAAC,GAAG,CAAC,EACzB,WAAU,eAAoC,KAAG,eAsB/E,CAAA;IAEM,MAAM,gBAAgB,GAAI,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,MAAM,eAAe,EACrB,aAAa,QAAQ,EACrB,SAAS;QACL,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;QACjC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QACxB,UAAU,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;KAC9B,KAAG,aAAa,CAAC,CAAC,CAkDxE,CAAA;CACJ"}