@opendaw/studio-core 0.0.24 → 0.0.26

package/dist/AudioDevices.js

@@ -1,11 +1,11 @@
 import { Promises } from "@opendaw/lib-runtime";
-import { Arrays, isInstanceOf, warn } from "@opendaw/lib-std";
+import { Arrays, Errors } from "@opendaw/lib-std";
 import { ConstrainDOM } from "@opendaw/lib-dom";
 export class AudioDevices {
     static async requestPermission() {
         const { status, value: stream } = await Promises.tryCatch(navigator.mediaDevices.getUserMedia({ audio: true }));
         if (status === "rejected") {
-            return warn("Could not request permission.");
+            return Errors.warn("Could not request permission.");
         }
         stream.getTracks().forEach(track => track.stop());
         await this.updateInputList();
@@ -13,7 +13,7 @@ export class AudioDevices {
     static async requestStream(constraints) {
         const { status, value: stream, error } = await Promises.tryCatch(navigator.mediaDevices.getUserMedia({ audio: constraints }));
         if (status === "rejected") {
-            return warn(isInstanceOf(error, OverconstrainedError) ?
+            return Errors.warn(Errors.isOverconstrained(error) ?
                 error.constraint === "deviceId"
                     ? `Could not find device with id: '${ConstrainDOM.resolveString(constraints.deviceId)}'`
                     : error.constraint
@@ -26,7 +26,7 @@ export class AudioDevices {
         this.#inputs = Arrays.empty();
         const { status, value: devices } = await Promises.tryCatch(navigator.mediaDevices.enumerateDevices());
         if (status === "rejected") {
-            return warn("Could not enumerate devices.");
+            return Errors.warn("Could not enumerate devices.");
         }
         this.#inputs = devices.filter(device => device.kind === "audioinput" && device.deviceId !== "" && device.groupId !== "");
     }

package/dist/AudioOfflineRenderer.d.ts

@@ -0,0 +1,8 @@
+import { int, Option } from "@opendaw/lib-std";
+import { ExportStemsConfiguration } from "@opendaw/studio-adapters";
+import { Project } from "./project/Project";
+import { ProjectMeta } from "./project/ProjectMeta";
+export declare namespace AudioOfflineRenderer {
+    const start: (source: Project, meta: ProjectMeta, optExportConfiguration: Option<ExportStemsConfiguration>, sampleRate?: int) => Promise<void>;
+}
+//# sourceMappingURL=AudioOfflineRenderer.d.ts.map

package/dist/AudioOfflineRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioOfflineRenderer.d.ts","sourceRoot":"","sources":["../src/AudioOfflineRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,GAAG,EAAE,MAAM,EAAmC,MAAM,kBAAkB,CAAA;AAI9G,OAAO,EAAC,wBAAwB,EAAC,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AAIjD,yBAAiB,oBAAoB,CAAC;IAC3B,MAAM,KAAK,GAAU,QAAQ,OAAO,EACf,MAAM,WAAW,EACjB,wBAAwB,MAAM,CAAC,wBAAwB,CAAC,EACxD,aAAY,GAAY,KAAG,OAAO,CAAC,IAAI,CA4BlE,CAAA;CA6CJ"}

package/dist/AudioOfflineRenderer.js

@@ -0,0 +1,88 @@
+import { DefaultObservableValue, Errors, panic, RuntimeNotifier, TimeSpan } from "@opendaw/lib-std";
+import { PPQN } from "@opendaw/lib-dsp";
+import { AnimationFrame, Files } from "@opendaw/lib-dom";
+import { Promises, Wait } from "@opendaw/lib-runtime";
+import { ExportStemsConfiguration } from "@opendaw/studio-adapters";
+import { encodeWavFloat } from "./Wav";
+import { AudioWorklets } from "./AudioWorklets";
+export var AudioOfflineRenderer;
+(function (AudioOfflineRenderer) {
+    AudioOfflineRenderer.start = async (source, meta, optExportConfiguration, sampleRate = 48_000) => {
+        const project = source.copy();
+        const numStems = ExportStemsConfiguration.countStems(optExportConfiguration);
+        const progress = new DefaultObservableValue(0.0);
+        const dialog = RuntimeNotifier.progress({ headline: "Rendering...", progress });
+        project.boxGraph.beginTransaction();
+        project.timelineBox.loopArea.enabled.setValue(false);
+        project.boxGraph.endTransaction();
+        const durationInPulses = project.timelineBox.durationInPulses.getValue();
+        const numSamples = PPQN.pulsesToSamples(durationInPulses, project.bpm, sampleRate);
+        const context = new OfflineAudioContext(numStems * 2, numSamples, sampleRate);
+        const durationInSeconds = numSamples / sampleRate;
+        const worklets = await AudioWorklets.install(context);
+        const engineWorklet = worklets.createEngine(project, optExportConfiguration.unwrapOrUndefined());
+        engineWorklet.play();
+        engineWorklet.connect(context.destination);
+        await engineWorklet.isReady();
+        while (!await engineWorklet.queryLoadingComplete()) {
+            await Wait.timeSpan(TimeSpan.seconds(1));
+        }
+        const terminable = AnimationFrame.add(() => progress.setValue(context.currentTime / durationInSeconds));
+        const buffer = await context.startRendering();
+        terminable.terminate();
+        dialog.terminate();
+        project.terminate();
+        if (optExportConfiguration.isEmpty()) {
+            await saveWavFile(buffer, meta);
+        }
+        else {
+            await saveZipFile(buffer, meta, Object.values(optExportConfiguration.unwrap()).map(({ fileName }) => fileName));
+        }
+    };
+    const saveWavFile = async (buffer, meta) => {
+        const approved = await RuntimeNotifier.approve({
+            headline: "Save Wav-File",
+            message: "",
+            approveText: "Save"
+        });
+        if (!approved) {
+            return;
+        }
+        const wavFile = encodeWavFloat(buffer);
+        const suggestedName = `${meta.name}.wav`;
+        const saveResult = await Promises.tryCatch(Files.save(wavFile, { suggestedName }));
+        if (saveResult.status === "rejected" && !Errors.isAbort(saveResult.error)) {
+            panic(String(saveResult.error));
+        }
+    };
+    const saveZipFile = async (buffer, meta, trackNames) => {
+        const { default: JSZip } = await import("jszip");
+        const dialog = RuntimeNotifier.progress({ headline: "Creating Zip File..." });
+        const numStems = buffer.numberOfChannels >> 1;
+        const zip = new JSZip();
+        for (let stemIndex = 0; stemIndex < numStems; stemIndex++) {
+            const l = buffer.getChannelData(stemIndex * 2);
+            const r = buffer.getChannelData(stemIndex * 2 + 1);
+            const file = encodeWavFloat({ channels: [l, r], sampleRate: buffer.sampleRate, numFrames: buffer.length });
+            zip.file(`${trackNames[stemIndex]}.wav`, file, { binary: true });
+        }
+        const arrayBuffer = await zip.generateAsync({
+            type: "arraybuffer",
+            compression: "DEFLATE",
+            compressionOptions: { level: 6 }
+        });
+        dialog.terminate();
+        const approved = await RuntimeNotifier.approve({
+            headline: "Save Zip",
+            message: `Size: ${arrayBuffer.byteLength >> 20}M`,
+            approveText: "Save"
+        });
+        if (!approved) {
+            return;
+        }
+        const saveResult = await Promises.tryCatch(Files.save(arrayBuffer, { suggestedName: `${meta.name}.zip` }));
+        if (saveResult.status === "rejected") {
+            panic(String(saveResult.error));
+        }
+    };
+})(AudioOfflineRenderer || (AudioOfflineRenderer = {}));

package/dist/AudioWorklets.d.ts

@@ -6,7 +6,7 @@ import { MeterWorklet } from "./MeterWorklet";
 import { RecordingWorklet } from "./RecordingWorklet";
 export declare class AudioWorklets {
     #private;
-    static install(context: BaseAudioContext, workletURL: string): Promise<AudioWorklets>;
+    static install(context: BaseAudioContext): Promise<AudioWorklets>;
     static get(context: BaseAudioContext): AudioWorklets;
     constructor(context: BaseAudioContext);
     get context(): BaseAudioContext;

package/dist/AudioWorklets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioWorklets.d.ts","sourceRoot":"","sources":["../src/AudioWorklets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,wBAAwB,EAAa,MAAM,0BAA0B,CAAA;AAC7E,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAA;AAGnD,qBAAa,aAAa;;WACT,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ3F,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa;gBAMxC,OAAO,EAAE,gBAAgB;IAErC,IAAI,OAAO,IAAI,gBAAgB,CAAuB;IAEtD,WAAW,CAAC,gBAAgB,EAAE,GAAG,GAAG,YAAY;IAIhD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,wBAAwB,GAAG,aAAa;IAI7F,eAAe,CAAC,gBAAgB,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,GAAG,gBAAgB;CAOlG"}
+{"version":3,"file":"AudioWorklets.d.ts","sourceRoot":"","sources":["../src/AudioWorklets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,wBAAwB,EAAa,MAAM,0BAA0B,CAAA;AAC7E,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAA;AAKnD,qBAAa,aAAa;;WACT,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQvE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa;gBAMxC,OAAO,EAAE,gBAAgB;IAErC,IAAI,OAAO,IAAI,gBAAgB,CAAuB;IAEtD,WAAW,CAAC,gBAAgB,EAAE,GAAG,GAAG,YAAY;IAIhD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,wBAAwB,GAAG,aAAa;IAI7F,eAAe,CAAC,gBAAgB,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,GAAG,gBAAgB;CAOlG"}

package/dist/AudioWorklets.js

@@ -3,9 +3,10 @@ import { EngineWorklet } from "./EngineWorklet";
 import { MeterWorklet } from "./MeterWorklet";
 import { RecordingWorklet } from "./RecordingWorklet";
 import { RenderQuantum } from "./RenderQuantum";
+const WorkletsUrl = new URL("./processors.js", import.meta.url);
 export class AudioWorklets {
-    static async install(context, workletURL) {
-        return context.audioWorklet.addModule(workletURL).then(() => {
+    static async install(context) {
+        return context.audioWorklet.addModule(WorkletsUrl).then(() => {
             const worklets = new AudioWorklets(context);
             this.#map.set(context, worklets);
             return worklets;

package/dist/FilePickerAcceptTypes.d.ts

@@ -0,0 +1,8 @@
+export declare namespace FilePickerAcceptTypes {
+    const WavFiles: FilePickerOptions;
+    const ProjectSyncLog: FilePickerOptions;
+    const ProjectFileType: FilePickerAcceptType;
+    const ProjectBundleFileType: FilePickerAcceptType;
+    const DawprojectFileType: FilePickerAcceptType;
+}
+//# sourceMappingURL=FilePickerAcceptTypes.d.ts.map

package/dist/FilePickerAcceptTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePickerAcceptTypes.d.ts","sourceRoot":"","sources":["../src/FilePickerAcceptTypes.ts"],"names":[],"mappings":"AAAA,yBAAiB,qBAAqB,CAAC;IAC5B,MAAM,QAAQ,EAAE,iBAKtB,CAAA;IACM,MAAM,cAAc,EAAE,iBAK5B,CAAA;IAEM,MAAM,eAAe,EAAE,oBAG7B,CAAA;IAEM,MAAM,qBAAqB,EAAE,oBAGnC,CAAA;IAEM,MAAM,kBAAkB,EAAE,oBAGhC,CAAA;CACJ"}

package/dist/FilePickerAcceptTypes.js

@@ -0,0 +1,27 @@
+export var FilePickerAcceptTypes;
+(function (FilePickerAcceptTypes) {
+    FilePickerAcceptTypes.WavFiles = {
+        types: [{
+                description: "wav-file",
+                accept: { "audio/wav": [".wav"] }
+            }]
+    };
+    FilePickerAcceptTypes.ProjectSyncLog = {
+        types: [{
+                description: "openDAW sync-log-file",
+                accept: { "application/octet-stream": [".odsl"] }
+            }]
+    };
+    FilePickerAcceptTypes.ProjectFileType = {
+        description: "openDAW project",
+        accept: { "application/octet-stream": [".od"] }
+    };
+    FilePickerAcceptTypes.ProjectBundleFileType = {
+        description: "openDAW project bundle",
+        accept: { "application/octet-stream": [".odb"] }
+    };
+    FilePickerAcceptTypes.DawprojectFileType = {
+        description: "dawproject",
+        accept: { "application/octet-stream": [".dawproject"] }
+    };
+})(FilePickerAcceptTypes || (FilePickerAcceptTypes = {}));

package/dist/WorkerAgents.d.ts

@@ -2,7 +2,7 @@ import { Option } from "@opendaw/lib-std";
 import type { OpfsProtocol, SamplePeakProtocol } from "@opendaw/lib-fusion";
 import { Messenger } from "@opendaw/lib-runtime";
 export declare class WorkerAgents {
-    static install(workerURL: string): void;
+    static install(): void;
     static messenger: Option<Messenger>;
     static get Peak(): SamplePeakProtocol;
     static get Opfs(): OpfsProtocol;

package/dist/WorkerAgents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerAgents.d.ts","sourceRoot":"","sources":["../src/WorkerAgents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAY,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAe,SAAS,EAAC,MAAM,sBAAsB,CAAA;AAE5D,qBAAa,YAAY;IACrB,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKvC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAc;IAGjD,MAAM,KAAK,IAAI,IAAI,kBAAkB,CAapC;IAGD,MAAM,KAAK,IAAI,IAAI,YAAY,CAS9B;CACJ"}
+{"version":3,"file":"WorkerAgents.d.ts","sourceRoot":"","sources":["../src/WorkerAgents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAY,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAe,SAAS,EAAC,MAAM,sBAAsB,CAAA;AAI5D,qBAAa,YAAY;IACrB,MAAM,CAAC,OAAO,IAAI,IAAI;IAItB,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAc;IAGjD,MAAM,KAAK,IAAI,IAAI,kBAAkB,CAapC;IAGD,MAAM,KAAK,IAAI,IAAI,YAAY,CAS9B;CACJ"}

package/dist/WorkerAgents.js

@@ -9,10 +9,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { Lazy, Option } from "@opendaw/lib-std";
 import { Communicator, Messenger } from "@opendaw/lib-runtime";
+const WorkerUrl = new URL("./workers.js", import.meta.url);
 export class WorkerAgents {
-    static install(workerURL) {
-        console.debug("workerURL", workerURL);
-        this.messenger = Option.wrap(Messenger.for(new Worker(workerURL, { type: "module" })));
+    static install() {
+        this.messenger = Option.wrap(Messenger.for(new Worker(WorkerUrl, { type: "module" })));
     }
     static messenger = Option.None;
     static get Peak() {

package/dist/capture/CaptureAudio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CaptureAudio.d.ts","sourceRoot":"","sources":["../../src/capture/CaptureAudio.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,uBAAuB,EACvB,MAAM,EAEN,UAAU,EAEb,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAC,YAAY,EAAE,eAAe,EAAC,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAI/C,qBAAa,YAAa,SAAQ,OAAO,CAAC,eAAe,CAAC;;gBAQ1C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe;IA4BjG,IAAI,MAAM,IAAI,MAAM,CAAsB;IAE1C,IAAI,MAAM,IAAI,uBAAuB,CAAC,WAAW,CAAC,CAAsB;IAExE,IAAI,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC,CAEnC;IAED,IAAI,KAAK,IAAI,MAAM,CAAsE;IAEzF,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,CAA+D;IAEhG,IAAI,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAE/C;IAEK,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcvC,cAAc,IAAI,UAAU;CA+D/B"}
+{"version":3,"file":"CaptureAudio.d.ts","sourceRoot":"","sources":["../../src/capture/CaptureAudio.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,uBAAuB,EACvB,MAAM,EAEN,UAAU,EACb,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAC,YAAY,EAAE,eAAe,EAAC,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAI/C,qBAAa,YAAa,SAAQ,OAAO,CAAC,eAAe,CAAC;;gBAQ1C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe;IA4BjG,IAAI,MAAM,IAAI,MAAM,CAAsB;IAE1C,IAAI,MAAM,IAAI,uBAAuB,CAAC,WAAW,CAAC,CAAsB;IAExE,IAAI,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC,CAEnC;IAED,IAAI,KAAK,IAAI,MAAM,CAAsE;IAEzF,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,CAA+D;IAEhG,IAAI,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAE/C;IAEK,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBvC,cAAc,IAAI,UAAU;CA+D/B"}

package/dist/capture/CaptureAudio.js

@@ -1,4 +1,4 @@
-import { abort, isDefined, isUndefined, MutableObservableOption, Option, safeExecute, Terminable, warn } from "@opendaw/lib-std";
+import { Errors, isDefined, isUndefined, MutableObservableOption, Option, RuntimeNotifier, Terminable } from "@opendaw/lib-std";
 import { Promises } from "@opendaw/lib-runtime";
 import { Capture } from "./Capture";
 import { RecordAudio } from "./RecordAudio";
@@ -43,9 +43,14 @@ export class CaptureAudio extends Capture {
         const { project } = this.manager;
         const { env: { audioContext } } = project;
         if (isUndefined(audioContext.outputLatency)) {
-            const approved = await safeExecute(project.env.dialogs?.approve, "Warning", "Your browser does not support 'output latency'. This will cause timing issue while recording.", "Ignore", "Cancel");
+            const approved = RuntimeNotifier.approve({
+                headline: "Warning",
+                message: "Your browser does not support 'output latency'. This will cause timing issue while recording.",
+                approveText: "Ignore",
+                cancelText: "Cancel"
+            });
             if (!approved) {
-                return abort("Recording cancelled");
+                return Promise.reject("Recording cancelled");
             }
         }
         return this.#streamGenerator();
@@ -105,7 +110,7 @@ export class CaptureAudio extends Capture {
             }
             else {
                 stream.getAudioTracks().forEach(track => track.stop());
-                return warn(`Could not find audio device with id: '${deviceId} in ${gotDeviceId}'`);
+                return Errors.warn(`Could not find audio device with id: '${deviceId} in ${gotDeviceId}'`);
             }
         });
     }

package/dist/capture/CaptureMidi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CaptureMidi.d.ts","sourceRoot":"","sources":["../../src/capture/CaptureMidi.ts"],"names":[],"mappings":"AAAA,OAAO,EAOH,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAAU,EAEb,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EAAC,YAAY,EAAE,cAAc,EAAC,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAA;AAEnD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAG/C,qBAAa,WAAY,SAAQ,OAAO,CAAC,cAAc,CAAC;;gBAOxC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc;IA8B/F,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAEhC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,YAAY;IAE5D,IAAI,KAAK,IAAI,MAAM,CAgBlB;IAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,CAIhC;IAEK,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBvC,cAAc,IAAI,UAAU;CAgD/B"}
+{"version":3,"file":"CaptureMidi.d.ts","sourceRoot":"","sources":["../../src/capture/CaptureMidi.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAAU,EACb,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EAAC,YAAY,EAAE,cAAc,EAAC,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAA;AAEnD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAI/C,qBAAa,WAAY,SAAQ,OAAO,CAAC,cAAc,CAAC;;gBAOxC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc;IA8B/F,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAEhC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,YAAY;IAE5D,IAAI,KAAK,IAAI,MAAM,CAgBlB;IAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,CAIhC;IAEK,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBvC,cAAc,IAAI,UAAU;CAgD/B"}

package/dist/capture/CaptureMidi.js

@@ -1,11 +1,12 @@
-import { assert, isDefined, isUndefined, Notifier, Option, Terminable, warn } from "@opendaw/lib-std";
+import { assert, Errors, isDefined, isUndefined, Notifier, Option, Terminable } from "@opendaw/lib-std";
 import { Events } from "@opendaw/lib-dom";
 import { MidiData } from "@opendaw/lib-midi";
 import { Promises } from "@opendaw/lib-runtime";
 import { NoteSignal } from "@opendaw/studio-adapters";
-import { MidiDevices } from "../MidiDevices";
+import { MidiDevices } from "../midi/MidiDevices";
 import { Capture } from "./Capture";
 import { RecordMidi } from "./RecordMidi";
+var warn = Errors.warn;
 export class CaptureMidi extends Capture {
     #streamGenerator;
     #notifier = new Notifier();
@@ -66,12 +67,12 @@ export class CaptureMidi extends Capture {
                 await MidiDevices.requestPermission();
             }
             else {
-                return warn("MIDI not available");
+                return Errors.warn("MIDI not available");
             }
         }
         const optInputs = MidiDevices.inputs();
         if (optInputs.isEmpty()) {
-            return warn("MIDI not available");
+            return Errors.warn("MIDI not available");
         }
         const inputs = optInputs.unwrap();
         if (inputs.length === 0) {

package/dist/capture/Recording.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Recording.d.ts","sourceRoot":"","sources":["../../src/capture/Recording.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,UAAU,EAAmB,MAAM,kBAAkB,CAAA;AAK3F,OAAO,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAA;AAE1C,qBAAa,SAAS;;IAClB,MAAM,KAAK,WAAW,IAAI,OAAO,CAA2B;WAE/C,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IA8D3E,OAAO;CACV"}
+{"version":3,"file":"Recording.d.ts","sourceRoot":"","sources":["../../src/capture/Recording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,UAAU,EAAa,MAAM,kBAAkB,CAAA;AAK7F,OAAO,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAA;AAE1C,qBAAa,SAAS;;IAClB,MAAM,KAAK,WAAW,IAAI,OAAO,CAA2B;WAE/C,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IA8D3E,OAAO;CACV"}

package/dist/capture/Recording.js

@@ -1,4 +1,4 @@
-import { asInstanceOf, assert, Option, Terminable, Terminator, warn } from "@opendaw/lib-std";
+import { asInstanceOf, assert, Errors, Option, Terminable, Terminator } from "@opendaw/lib-std";
 import { Promises } from "@opendaw/lib-runtime";
 import { AudioUnitBox } from "@opendaw/studio-boxes";
 import { AudioUnitType } from "@opendaw/studio-enums";
@@ -17,12 +17,12 @@ export class Recording {
         const captures = captureDevices.filterArmed();
         if (captures.length === 0) {
             this.#isRecording = false;
-            return warn("No track is armed for Recording");
+            return Errors.warn("No track is armed for Recording");
         }
         const { status, error } = await Promises.tryCatch(Promise.all(captures.map(capture => capture.prepareRecording())));
         if (status === "rejected") {
             this.#isRecording = false;
-            return warn(String(error));
+            return Errors.warn(String(error));
         }
         terminator.ownAll(...captures.map(capture => capture.startRecording()));
         engine.startRecording(countIn);

package/dist/index.d.ts

@@ -1,10 +1,3 @@
-export * from "./sync-log/Commit";
-export * from "./sync-log/SyncLogReader";
-export * from "./sync-log/SyncLogWriter";
-export * from "./samples/SampleStorage";
-export * from "./samples/MainThreadSampleLoader";
-export * from "./samples/MainThreadSampleManager";
-export * from "./samples/SampleProvider";
 export * from "./capture/Capture";
 export * from "./capture/CaptureAudio";
 export * from "./capture/CaptureMidi";
@@ -14,6 +7,8 @@ export * from "./dawproject/DawProject";
 export * from "./dawproject/DawProjectExporter";
 export * from "./dawproject/DawProjectImport";
 export * from "./dawproject/DawProjectImport";
+export * from "./midi/MidiDevices";
+export * from "./midi/MIDILearning";
 export * from "./project/Project";
 export * from "./project/ProjectApi";
 export * from "./project/ProjectBundle";
@@ -21,7 +16,18 @@ export * from "./project/ProjectEnv";
 export * from "./project/ProjectMeta";
 export * from "./project/ProjectPaths";
 export * from "./project/ProjectProfile";
+export * from "./samples/SampleStorage";
+export * from "./samples/MainThreadSampleLoader";
+export * from "./samples/MainThreadSampleManager";
+export * from "./samples/OpenSampleAPI";
+export * from "./samples/SampleAPI";
+export * from "./samples/SampleImporter";
+export * from "./samples/SampleProvider";
+export * from "./sync-log/Commit";
+export * from "./sync-log/SyncLogReader";
+export * from "./sync-log/SyncLogWriter";
 export * from "./AudioDevices";
+export * from "./AudioOfflineRenderer";
 export * from "./AudioUnitOrdering";
 export * from "./ColorCodes";
 export * from "./Colors";
@@ -31,15 +37,16 @@ export * from "./EffectFactories";
 export * from "./Engine";
 export * from "./EngineFacade";
 export * from "./EngineWorklet";
+export * from "./FilePickerAcceptTypes";
 export * from "./InstrumentBox";
 export * from "./InstrumentFactories";
 export * from "./InstrumentFactory";
 export * from "./InstrumentOptions";
 export * from "./InstrumentProduct";
 export * from "./MeterWorklet";
-export * from "./MidiDevices";
 export * from "./Mixer";
 export * from "./PeaksWriter";
+export * from "./RenderQuantum";
 export * from "./Wav";
 export * from "./WorkerAgents";
 export * from "./AudioWorklets";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AAExC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kCAAkC,CAAA;AAChD,cAAc,mCAAmC,CAAA;AACjD,cAAc,0BAA0B,CAAA;AAExC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAE7C,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AAExC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,OAAO,CAAA;AACrB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAE7C,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AAExC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kCAAkC,CAAA;AAChD,cAAc,mCAAmC,CAAA;AACjD,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AAExC,cAAc,mBAAmB,CAAA;AACjC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AAExC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,OAAO,CAAA;AACrB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,10 +1,3 @@
-export * from "./sync-log/Commit";
-export * from "./sync-log/SyncLogReader";
-export * from "./sync-log/SyncLogWriter";
-export * from "./samples/SampleStorage";
-export * from "./samples/MainThreadSampleLoader";
-export * from "./samples/MainThreadSampleManager";
-export * from "./samples/SampleProvider";
 export * from "./capture/Capture";
 export * from "./capture/CaptureAudio";
 export * from "./capture/CaptureMidi";
@@ -14,6 +7,8 @@ export * from "./dawproject/DawProject";
 export * from "./dawproject/DawProjectExporter";
 export * from "./dawproject/DawProjectImport";
 export * from "./dawproject/DawProjectImport";
+export * from "./midi/MidiDevices";
+export * from "./midi/MIDILearning";
 export * from "./project/Project";
 export * from "./project/ProjectApi";
 export * from "./project/ProjectBundle";
@@ -21,7 +16,18 @@ export * from "./project/ProjectEnv";
 export * from "./project/ProjectMeta";
 export * from "./project/ProjectPaths";
 export * from "./project/ProjectProfile";
+export * from "./samples/SampleStorage";
+export * from "./samples/MainThreadSampleLoader";
+export * from "./samples/MainThreadSampleManager";
+export * from "./samples/OpenSampleAPI";
+export * from "./samples/SampleAPI";
+export * from "./samples/SampleImporter";
+export * from "./samples/SampleProvider";
+export * from "./sync-log/Commit";
+export * from "./sync-log/SyncLogReader";
+export * from "./sync-log/SyncLogWriter";
 export * from "./AudioDevices";
+export * from "./AudioOfflineRenderer";
 export * from "./AudioUnitOrdering";
 export * from "./ColorCodes";
 export * from "./Colors";
@@ -31,15 +37,16 @@ export * from "./EffectFactories";
 export * from "./Engine";
 export * from "./EngineFacade";
 export * from "./EngineWorklet";
+export * from "./FilePickerAcceptTypes";
 export * from "./InstrumentBox";
 export * from "./InstrumentFactories";
 export * from "./InstrumentFactory";
 export * from "./InstrumentOptions";
 export * from "./InstrumentProduct";
 export * from "./MeterWorklet";
-export * from "./MidiDevices";
 export * from "./Mixer";
 export * from "./PeaksWriter";
+export * from "./RenderQuantum";
 export * from "./Wav";
 export * from "./WorkerAgents";
 export * from "./AudioWorklets";

package/dist/midi/MIDILearning.d.ts

@@ -0,0 +1,26 @@
+import { byte, JSONValue, Provider, Terminable } from "@opendaw/lib-std";
+import { Address, AddressJSON, PrimitiveField, PrimitiveValues } from "@opendaw/lib-box";
+import { Pointers } from "@opendaw/studio-enums";
+import { Project } from "../project/Project";
+export type MIDIConnectionJSON = ({
+    type: "control";
+    controlId: byte;
+}) & {
+    address: AddressJSON;
+    channel: byte;
+} & JSONValue;
+export interface MIDIConnection extends Terminable {
+    address: Address;
+    label: Provider<string>;
+    toJSON(): MIDIConnectionJSON;
+}
+export declare class MIDILearning implements Terminable {
+    #private;
+    constructor(project: Project);
+    hasMidiConnection(address: Address): boolean;
+    forgetMidiConnection(address: Address): void;
+    learnMIDIControls(field: PrimitiveField<PrimitiveValues, Pointers.MidiControl | Pointers>): Promise<void>;
+    toJSON(): ReadonlyArray<MIDIConnectionJSON>;
+    terminate(): void;
+}
+//# sourceMappingURL=MIDILearning.d.ts.map

package/dist/midi/MIDILearning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MIDILearning.d.ts","sourceRoot":"","sources":["../../src/midi/MIDILearning.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EAGJ,SAAS,EAET,QAAQ,EAGR,UAAU,EAEb,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAA;AAEtF,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAE9C,OAAO,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAA;AAG1C,MAAM,MAAM,kBAAkB,GAAG,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC,GACjE;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GACvC,SAAS,CAAA;AAEf,MAAM,WAAW,cAAe,SAAQ,UAAU;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACvB,MAAM,IAAI,kBAAkB,CAAA;CAC/B;AAID,qBAAa,YAAa,YAAW,UAAU;;gBAM/B,OAAO,EAAE,OAAO;IAK5B,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAC5C,oBAAoB,CAAC,OAAO,EAAE,OAAO;IAE/B,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC,WAAW,GAAG,QAAQ,CAAC;IAsB/F,MAAM,IAAI,aAAa,CAAC,kBAAkB,CAAC;IAI3C,SAAS,IAAI,IAAI;CAgDpB"}

package/dist/midi/MIDILearning.js

@@ -0,0 +1,88 @@
+import { Errors, isDefined, RuntimeNotifier, Terminator } from "@opendaw/lib-std";
+import { Address } from "@opendaw/lib-box";
+import { MidiData } from "@opendaw/lib-midi";
+import { MidiDevices } from "./MidiDevices";
+export class MIDILearning {
+    #terminator = new Terminator();
+    #project;
+    #connections;
+    constructor(project) {
+        this.#project = project;
+        this.#connections = Address.newSet(connection => connection.address);
+    }
+    hasMidiConnection(address) { return this.#connections.hasKey(address); }
+    forgetMidiConnection(address) { this.#connections.removeByKey(address).terminate(); }
+    async learnMIDIControls(field) {
+        if (!MidiDevices.canRequestMidiAccess()) {
+            return;
+        }
+        await MidiDevices.requestPermission();
+        const learnLifecycle = this.#terminator.spawn();
+        const abortController = new AbortController();
+        learnLifecycle.own(MidiDevices.subscribeMessageEvents((event) => {
+            const data = event.data;
+            if (data === null) {
+                return;
+            }
+            if (MidiData.isController(data)) {
+                learnLifecycle.terminate();
+                abortController.abort(Errors.AbortError);
+                return this.#startListeningControl(field, MidiData.readChannel(data), MidiData.readParam1(data), event);
+            }
+        }));
+        return RuntimeNotifier.info({
+            headline: "Learn Midi Keys...",
+            message: "Hit a key on your midi-device to learn a connection.",
+            okText: "Cancel",
+            abortSignal: abortController.signal
+        }).then(() => learnLifecycle.terminate(), Errors.CatchAbort);
+    }
+    toJSON() {
+        return this.#connections.values().map(connection => connection.toJSON());
+    }
+    terminate() {
+        this.#killAllConnections();
+        this.#terminator.terminate();
+    }
+    #startListeningControl(field, channel, controlId, event) {
+        console.debug(`startListeningControl channel: ${channel}, controlId: ${controlId}`);
+        const { observer, terminate } = this.#createMidiControlObserver(this.#project, this.#project.parameterFieldAdapters.get(field.address), controlId);
+        if (isDefined(event)) {
+            observer(event);
+        }
+        const subscription = MidiDevices.subscribeMessageEvents(observer, channel);
+        this.#connections.add({
+            address: field.address,
+            toJSON: () => ({
+                type: "control",
+                address: field.address.toJSON(),
+                channel,
+                controlId
+            }),
+            label: () => this.#project.parameterFieldAdapters.get(field.address).name,
+            terminate: () => {
+                terminate();
+                subscription.terminate();
+            }
+        });
+    }
+    #killAllConnections() {
+        this.#connections.forEach(({ terminate }) => terminate());
+        this.#connections.clear();
+    }
+    #createMidiControlObserver(project, adapter, controlId) {
+        const registration = adapter.registerMidiControl();
+        return {
+            observer: (event) => {
+                const data = event.data;
+                if (data === null) {
+                    return;
+                }
+                if (MidiData.isController(data) && MidiData.readParam1(data) === controlId) {
+                    project.editing.modify(() => adapter.setValue(adapter.valueMapping.y(MidiData.asValue(data))), false);
+                }
+            },
+            terminate: () => registration.terminate()
+        };
+    }
+}

package/dist/midi/MIDIMessageSubscriber.d.ts

@@ -0,0 +1,5 @@
+import { byte, Observer, Subscription } from "@opendaw/lib-std";
+export declare class MIDIMessageSubscriber {
+    static subscribeMessageEvents(access: MIDIAccess, observer: Observer<MIDIMessageEvent>, channel?: byte): Subscription;
+}
+//# sourceMappingURL=MIDIMessageSubscriber.d.ts.map

package/dist/midi/MIDIMessageSubscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MIDIMessageSubscriber.d.ts","sourceRoot":"","sources":["../../src/midi/MIDIMessageSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAqC,QAAQ,EAAE,YAAY,EAAC,MAAM,kBAAkB,CAAA;AAIhG,qBAAa,qBAAqB;IAC9B,MAAM,CAAC,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,YAAY;CA+BxH"}

package/dist/midi/MIDIMessageSubscriber.js

@@ -0,0 +1,40 @@
+import { isDefined, isInstanceOf } from "@opendaw/lib-std";
+import { Events } from "@opendaw/lib-dom";
+import { MidiData } from "@opendaw/lib-midi";
+export class MIDIMessageSubscriber {
+    static subscribeMessageEvents(access, observer, channel) {
+        const listen = (input) => isDefined(channel)
+            ? Events.subscribe(input, "midimessage", (event) => {
+                if (event.data === null || MidiData.readChannel(event.data) !== channel) {
+                    return;
+                }
+                observer(event);
+            }) : Events.subscribe(input, "midimessage", observer);
+        const connections = Array.from(access.inputs.values())
+            .map(input => ([input, listen(input)]));
+        const stateSubscription = Events.subscribe(access, "statechange", (event) => {
+            const port = event.port;
+            if (!isInstanceOf(port, MIDIInput)) {
+                return;
+            }
+            for (const [input, subscription] of connections) {
+                if (input === port) {
+                    // Well, this is strange, but if you start listening to a midi-input initially,
+                    // it will change its state to 'connected', so we clean up the first old subscriptions.
+                    subscription.terminate();
+                    break;
+                }
+            }
+            if (port.state === "connected") {
+                connections.push([port, listen(port)]);
+            }
+        });
+        return {
+            terminate: () => {
+                stateSubscription.terminate();
+                connections.forEach(([_, subscription]) => subscription.terminate());
+                connections.length = 0;
+            }
+        };
+    }
+}