@opendaw/studio-core 0.0.48 → 0.0.50

package/dist/project/ProjectApi.d.ts

@@ -3,7 +3,7 @@ import { ppqn } from "@opendaw/lib-dsp";
 import { Field, PointerField } from "@opendaw/lib-box";
 import { AudioUnitType, Pointers } from "@opendaw/studio-enums";
 import { AudioBusBox, AudioUnitBox, NoteEventBox, NoteEventCollectionBox, NoteRegionBox, TrackBox, ValueRegionBox } from "@opendaw/studio-boxes";
-import { AnyClipBox, AnyRegionBox, AudioUnitBoxAdapter, EffectPointerType, IconSymbol, IndexedAdapterCollectionListener } from "@opendaw/studio-adapters";
+import { AnyClipBox, AudioUnitBoxAdapter, EffectPointerType, IconSymbol, IndexedAdapterCollectionListener } from "@opendaw/studio-adapters";
 import { Project } from "./Project";
 import { InstrumentFactory } from "../InstrumentFactory";
 import { InstrumentProduct } from "../InstrumentProduct";
@@ -54,13 +54,5 @@ export declare class ProjectApi {
     createTrackRegion(trackBox: TrackBox, position: ppqn, duration: ppqn, { name, hue }?: ClipRegionOptions): Option<NoteRegionBox> | Option<ValueRegionBox>;
     createNoteEvent({ owner, position, duration, velocity, pitch, chance, cent }: NoteEventParams): NoteEventBox;
     deleteAudioUnit(audioUnitBox: AudioUnitBox): void;
-    extractIntoNew(audioUnits: ReadonlyArray<AudioUnitBox>, option?: {
-        includeAux?: boolean;
-        includeBus?: boolean;
-    }): Project;
-    mergeInto(...sources: ReadonlyArray<{
-        source: Project | AnyRegionBox;
-        insertAt: ppqn;
-    }>): Promise<void>;
 }
 //# sourceMappingURL=ProjectApi.d.ts.map

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

@@ -1,10 +1,9 @@
-import { Arrays, asDefined, asInstanceOf, assert, ByteArrayInput, clamp, Option, Strings, UUID } from "@opendaw/lib-std";
+import { asDefined, asInstanceOf, assert, clamp, Option, Strings, UUID } from "@opendaw/lib-std";
 import { PPQN } from "@opendaw/lib-dsp";
-import { IndexedBox, PointerField, StringField } from "@opendaw/lib-box";
+import { IndexedBox, StringField } from "@opendaw/lib-box";
 import { AudioUnitType } from "@opendaw/studio-enums";
-import { AudioBusBox, AudioFileBox, AudioUnitBox, AuxSendBox, CaptureAudioBox, CaptureMidiBox, NoteClipBox, NoteEventBox, NoteEventCollectionBox, NoteRegionBox, SelectionBox, TrackBox, ValueClipBox, ValueEventCollectionBox, ValueRegionBox } from "@opendaw/studio-boxes";
+import { AudioBusBox, AudioUnitBox, CaptureAudioBox, CaptureMidiBox, NoteClipBox, NoteEventBox, NoteEventCollectionBox, NoteRegionBox, TrackBox, ValueClipBox, ValueEventCollectionBox, ValueRegionBox } from "@opendaw/studio-boxes";
 import { IconSymbol, TrackType } from "@opendaw/studio-adapters";
-import { Project } from "./Project";
 import { ColorCodes } from "../ColorCodes";
 import { AudioUnitOrdering } from "../AudioUnitOrdering";
 // noinspection JSUnusedGlobalSymbols
@@ -179,69 +178,6 @@ export class ProjectApi {
         IndexedBox.removeOrder(rootBox.audioUnits, audioUnitBox.index.getValue());
         audioUnitBox.delete();
     }
-    // This version ignores selected items, buses and aux-sends. All outputs will be redirected to the primary output.
-    extractIntoNew(audioUnits, option = {}) {
-        console.time("extractIntoNew");
-        assert(Arrays.satisfy(audioUnits, (a, b) => a.graph === b.graph), "AudioUnits must share the same BoxGraph");
-        // TODO Implement include options.
-        assert(!option.includeAux && !option.includeBus, "Options are not yet implemented");
-        const targetProject = Project.new(this.#project.env);
-        const { boxGraph, masterBusBox, masterAudioUnit, rootBox } = targetProject;
-        const dependencies = audioUnits
-            .flatMap(box => Array.from(box.graph.dependenciesOf(box).boxes))
-            .filter(box => box.name !== SelectionBox.ClassName && box.name !== AuxSendBox.ClassName);
-        const uuidMap = UUID.newSet(({ source }) => source);
-        const allAdded = uuidMap.addMany([
-            ...audioUnits
-                .filter(({ output: { targetAddress } }) => targetAddress.nonEmpty())
-                .map(box => ({
-                source: box.output.targetAddress.unwrap().uuid,
-                target: masterBusBox.address.uuid
-            })),
-            ...audioUnits
-                .map(box => ({
-                source: box.collection.targetAddress.unwrap("AudioUnitBox was not connect to a RootBox").uuid,
-                target: rootBox.audioUnits.address.uuid
-            })),
-            ...audioUnits
-                .map(box => ({ source: box.address.uuid, target: UUID.generate() })),
-            ...dependencies
-                .map(({ address: { uuid }, name }) => ({ source: uuid, target: name === AudioFileBox.ClassName ? uuid : UUID.generate() }))
-        ]);
-        assert(allAdded, "Some mapping are redundant");
-        boxGraph.beginTransaction();
-        PointerField.decodeWith({
-            map: (_pointer, newAddress) => newAddress.map(address => uuidMap.opt(address.uuid).match({
-                none: () => address,
-                some: ({ target }) => address.moveTo(target)
-            }))
-        }, () => {
-            audioUnits
-                .toSorted((a, b) => a.index.getValue() - b.index.getValue())
-                .forEach((source, index) => {
-                const input = new ByteArrayInput(source.toArrayBuffer());
-                const key = source.name;
-                const uuid = uuidMap.get(source.address.uuid).target;
-                const copy = boxGraph.createBox(key, uuid, box => box.read(input));
-                copy.index.setValue(index);
-            });
-            masterAudioUnit.index.setValue(audioUnits.length);
-            dependencies
-                .forEach((source) => {
-                const input = new ByteArrayInput(source.toArrayBuffer());
-                const key = source.name;
-                const uuid = uuidMap.get(source.address.uuid).target;
-                boxGraph.createBox(key, uuid, box => box.read(input));
-            });
-        });
-        boxGraph.endTransaction();
-        boxGraph.verifyPointers();
-        console.timeEnd("extractIntoNew");
-        return targetProject;
-    }
-    mergeInto(...sources) {
-        return Promise.reject("Not implemented");
-    }
     #createAudioUnit(type, capture, index) {
         const { boxGraph, rootBox, masterBusBox } = this.#project;
         const insertIndex = index ?? this.#sortAudioUnitOrdering(type);

package/dist/project/ProjectUtils.d.ts

@@ -0,0 +1,12 @@
+import { ppqn } from "@opendaw/lib-dsp";
+import { AnyRegionBox } from "@opendaw/studio-adapters";
+import { Project } from "./Project";
+import { AudioUnitBox } from "@opendaw/studio-boxes";
+export declare namespace ProjectUtils {
+    const extractAudioUnits: (audioUnitBoxes: ReadonlyArray<AudioUnitBox>, targetProject: Project, options?: {
+        includeAux?: boolean;
+        includeBus?: boolean;
+    }) => void;
+    const extractRegions: (regionBoxes: ReadonlyArray<AnyRegionBox>, targetProject: Project, insertPosition?: ppqn) => void;
+}
+//# sourceMappingURL=ProjectUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectUtils.d.ts","sourceRoot":"","sources":["../../src/project/ProjectUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAA;AACrC,OAAO,EAAC,YAAY,EAAgB,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAcjC,OAAO,EAEH,YAAY,EAOf,MAAM,uBAAuB,CAAA;AAI9B,yBAAiB,YAAY,CAAC;IAMnB,MAAM,iBAAiB,GAAI,gBAAgB,aAAa,CAAC,YAAY,CAAC,EAC3C,eAAe,OAAO,EACtB,UAAS;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,KAAG,IAehG,CAAA;IAEM,MAAM,cAAc,GAAI,aAAa,aAAa,CAAC,YAAY,CAAC,EACxC,eAAe,OAAO,EACtB,iBAAgB,IAAU,KAAG,IAkD3D,CAAA;CAmFJ"}

package/dist/project/ProjectUtils.js

@@ -0,0 +1,145 @@
+import { UnionBoxTypes } from "@opendaw/studio-adapters";
+import { Arrays, asInstanceOf, assert, ByteArrayInput, isInstanceOf, SetMultimap, UUID } from "@opendaw/lib-std";
+import { AudioFileBox, AudioUnitBox, AuxSendBox, SelectionBox, SoundfontFileBox, TrackBox } from "@opendaw/studio-boxes";
+import { IndexedBox, PointerField } from "@opendaw/lib-box";
+import { AudioUnitOrdering } from "../AudioUnitOrdering";
+export var ProjectUtils;
+(function (ProjectUtils) {
+    const isSameGraph = ({ graph: a }, { graph: b }) => a === b;
+    const compareIndex = (a, b) => a.index.getValue() - b.index.getValue();
+    ProjectUtils.extractAudioUnits = (audioUnitBoxes, targetProject, options = {}) => {
+        assert(Arrays.satisfy(audioUnitBoxes, isSameGraph), "AudioUnits must share the same BoxGraph");
+        // TODO Implement include options.
+        assert(!options.includeAux && !options.includeBus, "Options are not yet implemented");
+        const { boxGraph, masterBusBox, masterAudioUnit, rootBox } = targetProject;
+        const dependencies = audioUnitBoxes
+            .flatMap(box => Array.from(box.graph.dependenciesOf(box, { alwaysFollowMandatory: true }).boxes))
+            .filter(box => box.name !== SelectionBox.ClassName && box.name !== AuxSendBox.ClassName);
+        const uuidMap = generateTransferMap(audioUnitBoxes, dependencies, rootBox.audioUnits.address.uuid, masterBusBox.address.uuid);
+        boxGraph.beginTransaction();
+        copy(uuidMap, boxGraph, audioUnitBoxes, dependencies);
+        reorderAudioUnits(uuidMap, audioUnitBoxes, rootBox);
+        boxGraph.endTransaction();
+        boxGraph.verifyPointers();
+    };
+    ProjectUtils.extractRegions = (regionBoxes, targetProject, insertPosition = 0.0) => {
+        assert(Arrays.satisfy(regionBoxes, isSameGraph), "Region smust be from the same BoxGraph");
+        const regionBoxSet = new Set(regionBoxes);
+        const trackBoxSet = new Set();
+        const audioUnitBoxSet = new SetMultimap();
+        // Collect AudioUnits and Tracks
+        regionBoxes.forEach(regionBox => {
+            const trackBox = asInstanceOf(regionBox.regions.targetVertex.unwrap().box, TrackBox);
+            trackBoxSet.add(trackBox);
+            const audioUnitBox = asInstanceOf(trackBox.tracks.targetVertex.unwrap().box, AudioUnitBox);
+            audioUnitBoxSet.add(audioUnitBox, trackBox);
+        });
+        console.debug(`Found ${audioUnitBoxSet.keyCount()} audioUnits`);
+        console.debug(`Found ${trackBoxSet.size} tracks`);
+        const audioUnitBoxes = [...audioUnitBoxSet.keys()];
+        const { boxGraph, masterBusBox, masterAudioUnit, rootBox } = targetProject;
+        const excludeBox = box => (isInstanceOf(box, TrackBox) && !trackBoxSet.has(box))
+            || (UnionBoxTypes.isRegionBox(box) && !regionBoxSet.has(box));
+        const dependencies = audioUnitBoxes
+            .flatMap(box => Array.from(box.graph.dependenciesOf(box, { excludeBox, alwaysFollowMandatory: true }).boxes))
+            .filter(box => box.name !== SelectionBox.ClassName && box.name !== AuxSendBox.ClassName);
+        const uuidMap = generateTransferMap(audioUnitBoxes, dependencies, rootBox.audioUnits.address.uuid, masterBusBox.address.uuid);
+        boxGraph.beginTransaction();
+        copy(uuidMap, boxGraph, audioUnitBoxes, dependencies);
+        reorderAudioUnits(uuidMap, audioUnitBoxes, rootBox);
+        // reorder track indices
+        audioUnitBoxSet.forEach((_, trackBoxes) => [...trackBoxes]
+            .sort(compareIndex)
+            .forEach((source, index) => {
+            const box = boxGraph
+                .findBox(uuidMap.get(source.address.uuid).target)
+                .unwrap("Target Track has not been copied");
+            asInstanceOf(box, TrackBox).index.setValue(index);
+        }));
+        // move new regions to the target position
+        const minPosition = regionBoxes.reduce((min, region) => Math.min(min, region.position.getValue()), Number.MAX_VALUE);
+        const delta = insertPosition - minPosition;
+        regionBoxes.forEach((source) => {
+            const box = boxGraph
+                .findBox(uuidMap.get(source.address.uuid).target)
+                .unwrap("Target Track has not been copied");
+            const position = UnionBoxTypes.asRegionBox(box).position;
+            position.setValue(position.getValue() + delta);
+        });
+        boxGraph.endTransaction();
+        boxGraph.verifyPointers();
+    };
+    const generateTransferMap = (audioUnitBoxes, dependencies, rootBoxUUID, masterBusBoxUUID) => {
+        const uuidMap = UUID.newSet(({ source }) => source);
+        uuidMap.addMany([
+            ...audioUnitBoxes
+                .filter(({ output: { targetAddress } }) => targetAddress.nonEmpty())
+                .map(box => ({
+                source: box.output.targetAddress.unwrap().uuid,
+                target: masterBusBoxUUID
+            })),
+            ...audioUnitBoxes
+                .map(box => ({
+                source: box.collection.targetAddress.unwrap("AudioUnitBox was not connected to a RootBox").uuid,
+                target: rootBoxUUID
+            })),
+            ...audioUnitBoxes
+                .map(box => ({
+                source: box.address.uuid,
+                target: UUID.generate()
+            })),
+            ...dependencies
+                .map(({ address: { uuid }, name }) => ({
+                source: uuid,
+                target: name === AudioFileBox.ClassName || name === SoundfontFileBox.ClassName
+                    ? uuid
+                    : UUID.generate()
+            }))
+        ]);
+        return uuidMap;
+    };
+    const copy = (uuidMap, boxGraph, audioUnitBoxes, dependencies) => {
+        PointerField.decodeWith({
+            map: (_pointer, newAddress) => newAddress.map(address => uuidMap.opt(address.uuid).match({
+                none: () => address,
+                some: ({ target }) => address.moveTo(target)
+            }))
+        }, () => {
+            audioUnitBoxes
+                .forEach((source) => {
+                const input = new ByteArrayInput(source.toArrayBuffer());
+                const key = source.name;
+                const uuid = uuidMap.get(source.address.uuid).target;
+                boxGraph.createBox(key, uuid, box => box.read(input));
+            });
+            dependencies
+                .forEach((source) => {
+                const input = new ByteArrayInput(source.toArrayBuffer());
+                const key = source.name;
+                const uuid = uuidMap.get(source.address.uuid).target;
+                boxGraph.createBox(key, uuid, box => box.read(input));
+            });
+        });
+    };
+    const reorderAudioUnits = (uuidMap, audioUnitBoxes, rootBox) => {
+        audioUnitBoxes
+            .toSorted(compareIndex)
+            .forEach((box) => {
+            const boxes = IndexedBox.collectIndexedBoxes(rootBox.audioUnits, AudioUnitBox);
+            const order = AudioUnitOrdering[box.type.getValue()];
+            let index = 0 | 0;
+            for (; index < boxes.length; index++) {
+                if (AudioUnitOrdering[boxes[index].type.getValue()] > order) {
+                    break;
+                }
+            }
+            const insertIndex = index;
+            while (index < boxes.length) {
+                boxes[index].index.setValue(++index);
+            }
+            asInstanceOf(rootBox.graph
+                .findBox(uuidMap.get(box.address.uuid).target)
+                .unwrap("Target Track has not been copied"), AudioUnitBox).index.setValue(insertIndex);
+        });
+    };
+})(ProjectUtils || (ProjectUtils = {}));

package/dist/project/index.d.ts

@@ -7,5 +7,6 @@ export * from "./ProjectPaths";
 export * from "./ProjectProfile";
 export * from "./ProjectSignals";
 export * from "./ProjectStorage";
+export * from "./ProjectUtils";
 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;AAChC,cAAc,YAAY,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,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/dist/project/index.js

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