@opendaw/studio-adapters 0.3.0 → 0.3.1

package/dist/DeviceManualUrls.d.ts

@@ -6,13 +6,13 @@ export declare namespace DeviceManualUrls {
     const Velocity = "manuals/devices/midi/velocity";
     const Zeitgeist = "manuals/devices/midi/zeitgeist";
     const Autotune = "manuals/devices/audio/autotune";
-    const StereoTool = "manuals/devices/audio/stereo-tool";
+    const StereoTool = "manuals/devices/audio/stereotool";
     const Delay = "manuals/devices/audio/delay";
     const DattorroReverb = "manuals/devices/audio/dattorro-reverb";
     const Maximizer = "manuals/devices/audio/maximizer";
     const Compressor = "manuals/devices/audio/compressor";
     const Gate = "manuals/devices/audio/gate";
-    const Reverb = "manuals/devices/audio/cheap-reverb";
+    const Reverb = "manuals/devices/audio/reverb";
     const Crusher = "manuals/devices/audio/crusher";
     const Fold = "manuals/devices/audio/fold";
     const Tidal = "manuals/devices/audio/tidal";
@@ -30,7 +30,7 @@ export declare namespace DeviceManualUrls {
     const Playfield = "manuals/devices/instruments/playfield";
     const Vaporisateur = "manuals/devices/instruments/vaporisateur";
     const Neon = "manuals/devices/instruments/neon";
-    const MIDIOutput = "manuals/devices/instruments/midi-output";
+    const MIDIOutput = "manuals/devices/instruments/midioutput";
     const Soundfont = "manuals/devices/instruments/soundfont";
     const FrequencySplit = "manuals/devices/audio/frequency-split";
 }

package/dist/DeviceManualUrls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeviceManualUrls.d.ts","sourceRoot":"","sources":["../src/DeviceManualUrls.ts"],"names":[],"mappings":"AAAA,yBAAiB,gBAAgB,CAAC;IAEvB,MAAM,QAAQ,sBAAsB,CAAA;IAGpC,MAAM,QAAQ,kCAAkC,CAAA;IAChD,MAAM,KAAK,+BAA+B,CAAA;IAC1C,MAAM,SAAS,mCAAmC,CAAA;IAClD,MAAM,QAAQ,kCAAkC,CAAA;IAChD,MAAM,SAAS,mCAAmC,CAAA;IAGlD,MAAM,QAAQ,mCAAmC,CAAA;IACjD,MAAM,UAAU,sCAAsC,CAAA;IACtD,MAAM,KAAK,gCAAgC,CAAA;IAC3C,MAAM,cAAc,0CAA0C,CAAA;IAC9D,MAAM,SAAS,oCAAoC,CAAA;IACnD,MAAM,UAAU,qCAAqC,CAAA;IACrD,MAAM,IAAI,+BAA+B,CAAA;IACzC,MAAM,MAAM,uCAAuC,CAAA;IACnD,MAAM,OAAO,kCAAkC,CAAA;IAC/C,MAAM,IAAI,+BAA+B,CAAA;IACzC,MAAM,KAAK,gCAAgC,CAAA;IAC3C,MAAM,MAAM,iCAAiC,CAAA;IAC7C,MAAM,OAAO,kCAAkC,CAAA;IAC/C,MAAM,SAAS,qCAAqC,CAAA;IACpD,MAAM,OAAO,kCAAkC,CAAA;IAC/C,MAAM,UAAU,qCAAqC,CAAA;IACrD,MAAM,SAAS,oCAAoC,CAAA;IACnD,MAAM,oBAAoB,2CAA2C,CAAA;IACrE,MAAM,eAAe,2CAA2C,CAAA;IAGhE,MAAM,OAAO,wCAAwC,CAAA;IACrD,MAAM,IAAI,qCAAqC,CAAA;IAC/C,MAAM,IAAI,qCAAqC,CAAA;IAC/C,MAAM,SAAS,0CAA0C,CAAA;IACzD,MAAM,YAAY,6CAA6C,CAAA;IAC/D,MAAM,IAAI,qCAAqC,CAAA;IAC/C,MAAM,UAAU,4CAA4C,CAAA;IAC5D,MAAM,SAAS,0CAA0C,CAAA;IACzD,MAAM,cAAc,0CAA0C,CAAA;CACxE"}
+{"version":3,"file":"DeviceManualUrls.d.ts","sourceRoot":"","sources":["../src/DeviceManualUrls.ts"],"names":[],"mappings":"AAAA,yBAAiB,gBAAgB,CAAC;IAEvB,MAAM,QAAQ,sBAAsB,CAAA;IAGpC,MAAM,QAAQ,kCAAkC,CAAA;IAChD,MAAM,KAAK,+BAA+B,CAAA;IAC1C,MAAM,SAAS,mCAAmC,CAAA;IAClD,MAAM,QAAQ,kCAAkC,CAAA;IAChD,MAAM,SAAS,mCAAmC,CAAA;IAGlD,MAAM,QAAQ,mCAAmC,CAAA;IACjD,MAAM,UAAU,qCAAqC,CAAA;IACrD,MAAM,KAAK,gCAAgC,CAAA;IAC3C,MAAM,cAAc,0CAA0C,CAAA;IAC9D,MAAM,SAAS,oCAAoC,CAAA;IACnD,MAAM,UAAU,qCAAqC,CAAA;IACrD,MAAM,IAAI,+BAA+B,CAAA;IACzC,MAAM,MAAM,iCAAiC,CAAA;IAC7C,MAAM,OAAO,kCAAkC,CAAA;IAC/C,MAAM,IAAI,+BAA+B,CAAA;IACzC,MAAM,KAAK,gCAAgC,CAAA;IAC3C,MAAM,MAAM,iCAAiC,CAAA;IAC7C,MAAM,OAAO,kCAAkC,CAAA;IAC/C,MAAM,SAAS,qCAAqC,CAAA;IACpD,MAAM,OAAO,kCAAkC,CAAA;IAC/C,MAAM,UAAU,qCAAqC,CAAA;IACrD,MAAM,SAAS,oCAAoC,CAAA;IACnD,MAAM,oBAAoB,2CAA2C,CAAA;IACrE,MAAM,eAAe,2CAA2C,CAAA;IAGhE,MAAM,OAAO,wCAAwC,CAAA;IACrD,MAAM,IAAI,qCAAqC,CAAA;IAC/C,MAAM,IAAI,qCAAqC,CAAA;IAC/C,MAAM,SAAS,0CAA0C,CAAA;IACzD,MAAM,YAAY,6CAA6C,CAAA;IAC/D,MAAM,IAAI,qCAAqC,CAAA;IAC/C,MAAM,UAAU,2CAA2C,CAAA;IAC3D,MAAM,SAAS,0CAA0C,CAAA;IACzD,MAAM,cAAc,0CAA0C,CAAA;CACxE"}

package/dist/DeviceManualUrls.js

@@ -10,13 +10,13 @@ export var DeviceManualUrls;
     DeviceManualUrls.Zeitgeist = "manuals/devices/midi/zeitgeist";
     // Audio Effects
     DeviceManualUrls.Autotune = "manuals/devices/audio/autotune";
-    DeviceManualUrls.StereoTool = "manuals/devices/audio/stereo-tool";
+    DeviceManualUrls.StereoTool = "manuals/devices/audio/stereotool";
     DeviceManualUrls.Delay = "manuals/devices/audio/delay";
     DeviceManualUrls.DattorroReverb = "manuals/devices/audio/dattorro-reverb";
     DeviceManualUrls.Maximizer = "manuals/devices/audio/maximizer";
     DeviceManualUrls.Compressor = "manuals/devices/audio/compressor";
     DeviceManualUrls.Gate = "manuals/devices/audio/gate";
-    DeviceManualUrls.Reverb = "manuals/devices/audio/cheap-reverb";
+    DeviceManualUrls.Reverb = "manuals/devices/audio/reverb";
     DeviceManualUrls.Crusher = "manuals/devices/audio/crusher";
     DeviceManualUrls.Fold = "manuals/devices/audio/fold";
     DeviceManualUrls.Tidal = "manuals/devices/audio/tidal";
@@ -35,7 +35,7 @@ export var DeviceManualUrls;
     DeviceManualUrls.Playfield = "manuals/devices/instruments/playfield";
     DeviceManualUrls.Vaporisateur = "manuals/devices/instruments/vaporisateur";
     DeviceManualUrls.Neon = "manuals/devices/instruments/neon";
-    DeviceManualUrls.MIDIOutput = "manuals/devices/instruments/midi-output";
+    DeviceManualUrls.MIDIOutput = "manuals/devices/instruments/midioutput";
     DeviceManualUrls.Soundfont = "manuals/devices/instruments/soundfont";
     DeviceManualUrls.FrequencySplit = "manuals/devices/audio/frequency-split";
 })(DeviceManualUrls || (DeviceManualUrls = {}));

package/dist/ParameterOwner.d.ts

@@ -0,0 +1,10 @@
+import { Vertex } from "@opendaw/lib-box";
+import { Observer, Option, Subscription } from "@opendaw/lib-std";
+import { BoxAdaptersContext } from "./BoxAdaptersContext";
+import { AudioUnitBoxAdapter } from "./audio-unit/AudioUnitBoxAdapter";
+export declare namespace ParameterOwner {
+    const nameOf: (context: BoxAdaptersContext, vertex: Vertex) => Option<string>;
+    const catchupAndSubscribeName: (context: BoxAdaptersContext, vertex: Vertex, observer: Observer<string>) => Subscription;
+    const audioUnitOf: (context: BoxAdaptersContext, vertex: Vertex) => Option<AudioUnitBoxAdapter>;
+}
+//# sourceMappingURL=ParameterOwner.d.ts.map

package/dist/ParameterOwner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParameterOwner.d.ts","sourceRoot":"","sources":["../src/ParameterOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,MAAM,EAAC,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAa,MAAM,kBAAkB,CAAA;AAG3E,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,mBAAmB,EAAC,MAAM,kCAAkC,CAAA;AAIpE,yBAAiB,cAAc,CAAC;IAGrB,MAAM,MAAM,GAAI,SAAS,kBAAkB,EAAE,QAAQ,MAAM,KAAG,MAAM,CAAC,MAAM,CAcjF,CAAA;IAIM,MAAM,uBAAuB,GAAI,SAAS,kBAAkB,EAC3B,QAAQ,MAAM,EACd,UAAU,QAAQ,CAAC,MAAM,CAAC,KAAG,YAepE,CAAA;IAEM,MAAM,WAAW,GAAI,SAAS,kBAAkB,EAAE,QAAQ,MAAM,KAAG,MAAM,CAAC,mBAAmB,CAQnG,CAAA;CAyBJ"}

package/dist/ParameterOwner.js

@@ -0,0 +1,73 @@
+import { StringField } from "@opendaw/lib-box";
+import { Option, Terminable } from "@opendaw/lib-std";
+import { Pointers } from "@opendaw/studio-enums";
+import { AudioUnitBox, ModulationBox } from "@opendaw/studio-boxes";
+import { AudioUnitBoxAdapter } from "./audio-unit/AudioUnitBoxAdapter";
+import { ModulationBoxAdapter } from "./modulation/ModulationBoxAdapter";
+import { Devices } from "./DeviceAdapter";
+export var ParameterOwner;
+(function (ParameterOwner) {
+    /// A scriptable device's dynamic parameter lives in its own child box, so the walk falls back to the
+    /// device that owns it.
+    ParameterOwner.nameOf = (context, vertex) => {
+        const box = vertex.box;
+        if (box instanceof AudioUnitBox) {
+            return context.boxAdapters.adapterFor(box, AudioUnitBoxAdapter).input.label;
+        }
+        if (box instanceof ModulationBox) {
+            const adapter = context.boxAdapters.adapterFor(box, ModulationBoxAdapter);
+            return Option.wrap(`${adapter.source.label} \u2192 ${adapter.targetOwner.unwrapOrElse("")} ${adapter.target.mapOr(parameter => parameter.name, "")}`.trim());
+        }
+        const own = labelOf(context, box);
+        if (own.nonEmpty()) {
+            return own;
+        }
+        const owner = resolveOwnerDeviceBox(box).flatMap(owner => labelOf(context, owner));
+        return owner.nonEmpty() ? owner : Option.wrap(box.name);
+    };
+    /// The same name as `nameOf`, but following the rename: a view stays in sync when the device (or the
+    /// audio unit's instrument) is relabelled.
+    ParameterOwner.catchupAndSubscribeName = (context, vertex, observer) => {
+        const box = vertex.box;
+        if (box instanceof AudioUnitBox) {
+            return context.boxAdapters.adapterFor(box, AudioUnitBoxAdapter).input
+                .catchupAndSubscribeLabelChange(label => observer(label.unwrapOrElse("")));
+        }
+        const own = labelFieldOf(context, box);
+        const field = own.nonEmpty()
+            ? own
+            : resolveOwnerDeviceBox(box).flatMap(owner => labelFieldOf(context, owner));
+        if (field.isEmpty()) {
+            observer(ParameterOwner.nameOf(context, vertex).unwrapOrElse(box.name));
+            return Terminable.Empty;
+        }
+        return field.unwrap().catchupAndSubscribe(field => observer(field.getValue()));
+    };
+    ParameterOwner.audioUnitOf = (context, vertex) => {
+        const box = vertex.box;
+        if (box instanceof AudioUnitBox) {
+            return Option.wrap(context.boxAdapters.adapterFor(box, AudioUnitBoxAdapter));
+        }
+        const own = unitOf(context, box);
+        if (own.nonEmpty()) {
+            return own;
+        }
+        return resolveOwnerDeviceBox(box).flatMap(owner => unitOf(context, owner));
+    };
+    const unitOf = (context, box) => context.boxAdapters.optAdapter(box)
+        .flatMap(adapter => Devices.isAny(adapter)
+        ? Option.wrap(adapter.audioUnitBoxAdapter())
+        : Option.None);
+    const labelOf = (context, box) => labelFieldOf(context, box).map(field => field.getValue());
+    const labelFieldOf = (context, box) => context.boxAdapters.optAdapter(box).flatMap(adapter => "labelField" in adapter && adapter.labelField instanceof StringField
+        ? Option.wrap(adapter.labelField)
+        : Option.None);
+    const resolveOwnerDeviceBox = (box) => {
+        for (const [pointer] of box.outgoingEdges()) {
+            if (pointer.pointerType === Pointers.Parameter) {
+                return pointer.targetVertex.map(vertex => vertex.box);
+            }
+        }
+        return Option.None;
+    };
+})(ParameterOwner || (ParameterOwner = {}));

package/dist/devices/audio-effects/ReverbDeviceBoxAdapter.d.ts

@@ -10,7 +10,7 @@ export declare class ReverbDeviceBoxAdapter implements AudioEffectDeviceAdapter
     #private;
     readonly type = "audio-effect";
     readonly accepts = "audio";
-    readonly manualUrl = "manuals/devices/audio/cheap-reverb";
+    readonly manualUrl = "manuals/devices/audio/reverb";
     readonly namedParameter: {
         readonly decay: import("../..").AutomatableParameterFieldAdapter<number>;
         readonly preDelay: import("../..").AutomatableParameterFieldAdapter<number>;

package/dist/devices/audio-effects/ReverbDeviceBoxAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReverbDeviceBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/devices/audio-effects/ReverbDeviceBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAwB,IAAI,EAAe,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC7F,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,wBAAwB,EAAE,UAAU,EAAU,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAG3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,sCAAsC,CAAA;AAExE,qBAAa,sBAAuB,YAAW,wBAAwB;;IACnE,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAU;IAC1B,QAAQ,CAAC,SAAS,wCAA0B;IAK5C,QAAQ,CAAC,cAAc;;;;;;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,eAAe;IAO7D,IAAI,GAAG,IAAI,eAAe,CAAmB;IAC7C,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,UAAU,IAAI,WAAW,CAAyB;IACtD,IAAI,YAAY,IAAI,YAAY,CAA2B;IAC3D,IAAI,cAAc,IAAI,YAAY,CAA6B;IAC/D,IAAI,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;IAE1E,UAAU,IAAI,UAAU;IAKxB,mBAAmB,IAAI,mBAAmB;IAEzC,mBAAmB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAIpD,SAAS,IAAI,IAAI;CAwCpB"}
+{"version":3,"file":"ReverbDeviceBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/devices/audio-effects/ReverbDeviceBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAwB,IAAI,EAAe,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC7F,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,wBAAwB,EAAE,UAAU,EAAU,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAG3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,sCAAsC,CAAA;AAExE,qBAAa,sBAAuB,YAAW,wBAAwB;;IACnE,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAU;IAC1B,QAAQ,CAAC,SAAS,kCAA0B;IAK5C,QAAQ,CAAC,cAAc;;;;;;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,eAAe;IAO7D,IAAI,GAAG,IAAI,eAAe,CAAmB;IAC7C,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,UAAU,IAAI,WAAW,CAAyB;IACtD,IAAI,YAAY,IAAI,YAAY,CAA2B;IAC3D,IAAI,cAAc,IAAI,YAAY,CAA6B;IAC/D,IAAI,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;IAE1E,UAAU,IAAI,UAAU;IAKxB,mBAAmB,IAAI,mBAAmB;IAEzC,mBAAmB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAIpD,SAAS,IAAI,IAAI;CAwCpB"}

package/dist/devices/audio-effects/StereoToolDeviceBoxAdapter.d.ts

@@ -10,7 +10,7 @@ export declare class StereoToolDeviceBoxAdapter implements AudioEffectDeviceAdap
     #private;
     readonly type = "audio-effect";
     readonly accepts = "audio";
-    readonly manualUrl = "manuals/devices/audio/stereo-tool";
+    readonly manualUrl = "manuals/devices/audio/stereotool";
     readonly namedParameter: {
         readonly volume: import("../..").AutomatableParameterFieldAdapter<number>;
         readonly panning: import("../..").AutomatableParameterFieldAdapter<number>;

package/dist/devices/audio-effects/StereoToolDeviceBoxAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StereoToolDeviceBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/devices/audio-effects/StereoToolDeviceBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,IAAI,EAAe,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC7F,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,wBAAwB,EAAE,UAAU,EAAU,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAG3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,sCAAsC,CAAA;AAExE,qBAAa,0BAA2B,YAAW,wBAAwB;;IACvE,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAU;IAC1B,QAAQ,CAAC,SAAS,uCAA8B;IAMhD,QAAQ,CAAC,cAAc;;;;;;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,mBAAmB;IAOjE,IAAI,GAAG,IAAI,mBAAmB,CAAmB;IACjD,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,UAAU,IAAI,WAAW,CAAyB;IACtD,IAAI,YAAY,IAAI,YAAY,CAA2B;IAC3D,IAAI,cAAc,IAAI,YAAY,CAA6B;IAC/D,IAAI,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;IAE1E,UAAU,IAAI,UAAU;IAKxB,mBAAmB,IAAI,mBAAmB;IAEzC,mBAAmB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAIpD,SAAS,IAAI,IAAI;CAqBpB"}
+{"version":3,"file":"StereoToolDeviceBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/devices/audio-effects/StereoToolDeviceBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,IAAI,EAAe,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC7F,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,wBAAwB,EAAE,UAAU,EAAU,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAG3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,sCAAsC,CAAA;AAExE,qBAAa,0BAA2B,YAAW,wBAAwB;;IACvE,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAU;IAC1B,QAAQ,CAAC,SAAS,sCAA8B;IAMhD,QAAQ,CAAC,cAAc;;;;;;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,mBAAmB;IAOjE,IAAI,GAAG,IAAI,mBAAmB,CAAmB;IACjD,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,UAAU,IAAI,WAAW,CAAyB;IACtD,IAAI,YAAY,IAAI,YAAY,CAA2B;IAC3D,IAAI,cAAc,IAAI,YAAY,CAA6B;IAC/D,IAAI,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;IAE1E,UAAU,IAAI,UAAU;IAKxB,mBAAmB,IAAI,mBAAmB;IAEzC,mBAAmB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAIpD,SAAS,IAAI,IAAI;CAqBpB"}

package/dist/devices/instruments/MIDIOutputDeviceBoxAdapter.d.ts

@@ -11,7 +11,7 @@ export declare class MIDIOutputDeviceBoxAdapter implements InstrumentDeviceBoxAd
     #private;
     readonly type = "instrument";
     readonly accepts = "midi";
-    readonly manualUrl = "manuals/devices/instruments/midi-output";
+    readonly manualUrl = "manuals/devices/instruments/midioutput";
     constructor(context: BoxAdaptersContext, box: MIDIOutputDeviceBox);
     get box(): MIDIOutputDeviceBox;
     get uuid(): UUID.Bytes;

package/dist/devices/instruments/MIDIOutputDeviceBoxAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MIDIOutputDeviceBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/devices/instruments/MIDIOutputDeviceBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,gBAAgB,EAQhB,IAAI,EAEP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,aAAa,EAAE,mBAAmB,EAAyB,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAC,UAAU,EAAW,0BAA0B,EAAC,MAAM,qBAAqB,CAAA;AACnF,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAE3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAC,mBAAmB,EAAC,MAAM,sCAAsC,CAAA;AAoBxE,qBAAa,0BAA2B,YAAW,0BAA0B;;IAGzE,QAAQ,CAAC,IAAI,gBAAe;IAC5B,QAAQ,CAAC,OAAO,UAAS;IACzB,QAAQ,CAAC,SAAS,6CAA8B;gBAQpC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,mBAAmB;IAuBjE,IAAI,GAAG,IAAI,mBAAmB,CAAmB;IACjD,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,WAAW,CAAyB;IACtD,IAAI,SAAS,IAAI,WAAW,CAAwB;IACpD,IAAI,gBAAgB,IAAI,SAAS,CAAyB;IAC1D,IAAI,YAAY,IAAI,YAAY,CAA2B;IAC3D,IAAI,cAAc,IAAI,YAAY,CAA6B;IAC/D,IAAI,iBAAiB,IAAI,OAAO,CAAc;IAC9C,IAAI,UAAU,IAAI,mBAAmB,CAA0B;IAC/D,IAAI,UAAU,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAA0B;IAE3E,UAAU,IAAI,UAAU;IAKxB,mBAAmB,IAAI,mBAAmB;IAEzC,mBAAmB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAIpD,SAAS,IAAI,IAAI;CACpB"}
+{"version":3,"file":"MIDIOutputDeviceBoxAdapter.d.ts","sourceRoot":"","sources":["../../../src/devices/instruments/MIDIOutputDeviceBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,gBAAgB,EAQhB,IAAI,EAEP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,aAAa,EAAE,mBAAmB,EAAyB,MAAM,uBAAuB,CAAA;AAChG,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAC,UAAU,EAAW,0BAA0B,EAAC,MAAM,qBAAqB,CAAA;AACnF,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAE3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAC,mBAAmB,EAAC,MAAM,sCAAsC,CAAA;AAoBxE,qBAAa,0BAA2B,YAAW,0BAA0B;;IAGzE,QAAQ,CAAC,IAAI,gBAAe;IAC5B,QAAQ,CAAC,OAAO,UAAS;IACzB,QAAQ,CAAC,SAAS,4CAA8B;gBAQpC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,mBAAmB;IAuBjE,IAAI,GAAG,IAAI,mBAAmB,CAAmB;IACjD,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,UAAU,IAAI,WAAW,CAAyB;IACtD,IAAI,SAAS,IAAI,WAAW,CAAwB;IACpD,IAAI,gBAAgB,IAAI,SAAS,CAAyB;IAC1D,IAAI,YAAY,IAAI,YAAY,CAA2B;IAC3D,IAAI,cAAc,IAAI,YAAY,CAA6B;IAC/D,IAAI,iBAAiB,IAAI,OAAO,CAAc;IAC9C,IAAI,UAAU,IAAI,mBAAmB,CAA0B;IAC/D,IAAI,UAAU,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAA0B;IAE3E,UAAU,IAAI,UAAU;IAKxB,mBAAmB,IAAI,mBAAmB;IAEzC,mBAAmB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAIpD,SAAS,IAAI,IAAI;CACpB"}

package/dist/modulation/LfoModulatorBoxAdapter.d.ts

@@ -0,0 +1,31 @@
+import { LfoModulatorBox } from "@opendaw/studio-boxes";
+import { int } from "@opendaw/lib-std";
+import { ppqn } from "@opendaw/lib-dsp";
+import { BoxAdaptersContext } from "../BoxAdaptersContext";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+export declare enum LfoShape {
+    Sine = 0,
+    Triangle = 1,
+    SawUp = 2,
+    SawDown = 3,
+    Square = 4
+}
+export declare class LfoModulatorBoxAdapter extends ModulatorBoxAdapter<LfoModulatorBox> {
+    #private;
+    static readonly Rates: ReadonlyArray<[int, int]>;
+    static readonly MaxAbsoluteRate = 10;
+    static readonly ExponentRange = 8;
+    static readonly CenterAbsoluteRate = 1;
+    static readonly RatePPQNs: ReadonlyArray<ppqn>;
+    static readonly RateStrings: ReadonlyArray<string>;
+    static readonly ShapeStrings: ReadonlyArray<string>;
+    readonly namedParameter: {
+        readonly shape: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateSync: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateAbsolute: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly phase: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly exponent: import("..").AutomatableParameterFieldAdapter<number>;
+    };
+    constructor(context: BoxAdaptersContext, box: LfoModulatorBox);
+}
+//# sourceMappingURL=LfoModulatorBoxAdapter.d.ts.map

package/dist/modulation/LfoModulatorBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LfoModulatorBoxAdapter.d.ts","sourceRoot":"","sources":["../../src/modulation/LfoModulatorBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAC,GAAG,EAA8B,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAC,IAAI,EAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AAEzD,oBAAY,QAAQ;IAAE,IAAI,IAAA;IAAE,QAAQ,IAAA;IAAE,KAAK,IAAA;IAAE,OAAO,IAAA;IAAE,MAAM,IAAA;CAAC;AAG7D,qBAAa,sBAAuB,SAAQ,mBAAmB,CAAC,eAAe,CAAC;;IAC5E,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAE/C;IACD,MAAM,CAAC,QAAQ,CAAC,eAAe,MAAO;IACtC,MAAM,CAAC,QAAQ,CAAC,aAAa,KAAM;IACnC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,KAAM;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CACqC;IACnF,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAGT;IACzC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAmD;IAEtG,QAAQ,CAAC,cAAc;;;;;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,eAAe;CAwBhE"}

package/dist/modulation/LfoModulatorBoxAdapter.js

@@ -0,0 +1,48 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _LfoModulatorBoxAdapter_instances, _a, _LfoModulatorBoxAdapter_wrapParameters;
+import { StringMapping, ValueMapping } from "@opendaw/lib-std";
+import { PPQN } from "@opendaw/lib-dsp";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+export var LfoShape;
+(function (LfoShape) {
+    LfoShape[LfoShape["Sine"] = 0] = "Sine";
+    LfoShape[LfoShape["Triangle"] = 1] = "Triangle";
+    LfoShape[LfoShape["SawUp"] = 2] = "SawUp";
+    LfoShape[LfoShape["SawDown"] = 3] = "SawDown";
+    LfoShape[LfoShape["Square"] = 4] = "Square";
+})(LfoShape || (LfoShape = {}));
+// WASM CONTRACT: `RatePPQNs` mirrors the engine's `modulation::RATES` (crates/engine/src/modulation.rs).
+export class LfoModulatorBoxAdapter extends ModulatorBoxAdapter {
+    constructor(context, box) {
+        super(context, box);
+        _LfoModulatorBoxAdapter_instances.add(this);
+        this.namedParameter = __classPrivateFieldGet(this, _LfoModulatorBoxAdapter_instances, "m", _LfoModulatorBoxAdapter_wrapParameters).call(this, box);
+        this.registerParameterTracks();
+    }
+}
+_a = LfoModulatorBoxAdapter, _LfoModulatorBoxAdapter_instances = new WeakSet(), _LfoModulatorBoxAdapter_wrapParameters = function _LfoModulatorBoxAdapter_wrapParameters(box) {
+    return {
+        shape: this.parametric.createParameter(box.shape, ValueMapping.linearInteger(0, _a.ShapeStrings.length - 1), StringMapping.indices("", _a.ShapeStrings), "Shape"),
+        rateSync: this.parametric.createParameter(box.rateSync, ValueMapping.linearInteger(0, _a.RateStrings.length - 1), StringMapping.indices("", _a.RateStrings), "Sync"),
+        rateAbsolute: this.parametric.createParameter(box.rateAbsolute, ValueMapping.powerByCenter(_a.CenterAbsoluteRate, 0.0, _a.MaxAbsoluteRate), StringMapping.numeric({ unit: "Hz", fractionDigits: 2 }), "Free"),
+        phase: this.parametric.createParameter(box.phase, ValueMapping.unipolar(), StringMapping.percent({ fractionDigits: 0 }), "Phase"),
+        exponent: this.parametric.createParameter(box.exponent, ValueMapping.bipolar(), StringMapping.percent({ fractionDigits: 0 }), "Pow")
+    };
+};
+LfoModulatorBoxAdapter.Rates = [
+    [8, 1], [4, 1], [2, 1], [1, 1], [1, 2], [1, 4], [1, 6], [1, 8], [1, 12], [1, 16], [1, 24], [1, 32]
+];
+LfoModulatorBoxAdapter.MaxAbsoluteRate = 10.0;
+LfoModulatorBoxAdapter.ExponentRange = 8.0;
+LfoModulatorBoxAdapter.CenterAbsoluteRate = 1.0;
+LfoModulatorBoxAdapter.RatePPQNs = [0, ..._a.Rates
+        .map(([nominator, denominator]) => PPQN.fromSignature(nominator, denominator))];
+LfoModulatorBoxAdapter.RateStrings = ["Off", ..._a.Rates
+        .map(([nominator, denominator]) => denominator === 1
+        ? (nominator === 1 ? "1 bar" : `${nominator} bars`)
+        : `${nominator}/${denominator}`)];
+LfoModulatorBoxAdapter.ShapeStrings = ["Sine", "Triangle", "Saw ↑", "Saw ↓", "Square"];

package/dist/modulation/MacroModulatorBoxAdapter.d.ts

@@ -0,0 +1,11 @@
+import { MacroModulatorBox } from "@opendaw/studio-boxes";
+import { BoxAdaptersContext } from "../BoxAdaptersContext";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+export declare class MacroModulatorBoxAdapter extends ModulatorBoxAdapter<MacroModulatorBox> {
+    #private;
+    readonly namedParameter: {
+        readonly value: import("..").AutomatableParameterFieldAdapter<number>;
+    };
+    constructor(context: BoxAdaptersContext, box: MacroModulatorBox);
+}
+//# sourceMappingURL=MacroModulatorBoxAdapter.d.ts.map

package/dist/modulation/MacroModulatorBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MacroModulatorBoxAdapter.d.ts","sourceRoot":"","sources":["../../src/modulation/MacroModulatorBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAC,mBAAmB,EAAwB,MAAM,uBAAuB,CAAA;AAEhF,qBAAa,wBAAyB,SAAQ,mBAAmB,CAAC,iBAAiB,CAAC;;IAChF,QAAQ,CAAC,cAAc;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,iBAAiB;CAYlE"}

package/dist/modulation/MacroModulatorBoxAdapter.js

@@ -0,0 +1,21 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _MacroModulatorBoxAdapter_instances, _MacroModulatorBoxAdapter_wrapParameters;
+import { ValueMapping } from "@opendaw/lib-std";
+import { ModulatorBoxAdapter, polarityStringMapping } from "./ModulatorBoxAdapter";
+export class MacroModulatorBoxAdapter extends ModulatorBoxAdapter {
+    constructor(context, box) {
+        super(context, box);
+        _MacroModulatorBoxAdapter_instances.add(this);
+        this.namedParameter = __classPrivateFieldGet(this, _MacroModulatorBoxAdapter_instances, "m", _MacroModulatorBoxAdapter_wrapParameters).call(this, box);
+        this.registerParameterTracks();
+    }
+}
+_MacroModulatorBoxAdapter_instances = new WeakSet(), _MacroModulatorBoxAdapter_wrapParameters = function _MacroModulatorBoxAdapter_wrapParameters(box) {
+    return {
+        value: this.parametric.createParameter(box.value, ValueMapping.unipolar(), polarityStringMapping(box.bipolar), "Value")
+    };
+};

package/dist/modulation/ModulationBoxAdapter.d.ts

@@ -0,0 +1,27 @@
+import { Address } from "@opendaw/lib-box";
+import { ModulationBox } from "@opendaw/studio-boxes";
+import { Observer, Option, Subscription, UUID } from "@opendaw/lib-std";
+import { BoxAdapter } from "../BoxAdapter";
+import { BoxAdaptersContext } from "../BoxAdaptersContext";
+import { AutomatableParameterFieldAdapter } from "../AutomatableParameterFieldAdapter";
+import { AudioUnitBoxAdapter } from "../audio-unit/AudioUnitBoxAdapter";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+export declare class ModulationBoxAdapter implements BoxAdapter {
+    #private;
+    readonly namedParameter: {
+        readonly depth: AutomatableParameterFieldAdapter<number>;
+    };
+    constructor(context: BoxAdaptersContext, box: ModulationBox);
+    get box(): ModulationBox;
+    get uuid(): UUID.Bytes;
+    get address(): Address;
+    get enabled(): boolean;
+    get depth(): number;
+    get source(): ModulatorBoxAdapter;
+    get target(): Option<AutomatableParameterFieldAdapter>;
+    get targetAudioUnit(): Option<AudioUnitBoxAdapter>;
+    get targetOwner(): Option<string>;
+    catchupAndSubscribeTargetOwner(observer: Observer<string>): Subscription;
+    terminate(): void;
+}
+//# sourceMappingURL=ModulationBoxAdapter.d.ts.map

package/dist/modulation/ModulationBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModulationBoxAdapter.d.ts","sourceRoot":"","sources":["../../src/modulation/ModulationBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAiB,YAAY,EAA0B,IAAI,EAAe,MAAM,kBAAkB,CAAA;AAC1H,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AACxC,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAC,gCAAgC,EAAC,MAAM,qCAAqC,CAAA;AACpF,OAAO,EAAC,mBAAmB,EAAC,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAwB,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AAGhF,qBAAa,oBAAqB,YAAW,UAAU;;IAKnD,QAAQ,CAAC,cAAc;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,aAAa;IAsB3D,IAAI,GAAG,IAAI,aAAa,CAAmB;IAC3C,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,OAAO,IAAI,OAAO,CAAsC;IAC5D,IAAI,KAAK,IAAI,MAAM,CAAoC;IAEvD,IAAI,MAAM,IAAI,mBAAmB,CAGhC;IAGD,IAAI,MAAM,IAAI,MAAM,CAAC,gCAAgC,CAAC,CAGrD;IAED,IAAI,eAAe,IAAI,MAAM,CAAC,mBAAmB,CAAC,CAEjD;IAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,CAEhC;IAGD,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAY;IASxE,SAAS,IAAI,IAAI;CACpB"}

package/dist/modulation/ModulationBoxAdapter.js

@@ -0,0 +1,72 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ModulationBoxAdapter_terminator, _ModulationBoxAdapter_context, _ModulationBoxAdapter_box, _ModulationBoxAdapter_parametric;
+import { StringMapping, Terminable, Terminator, ValueMapping } from "@opendaw/lib-std";
+import { ParameterAdapterSet } from "../ParameterAdapterSet";
+import { isModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+import { ParameterOwner } from "../ParameterOwner";
+export class ModulationBoxAdapter {
+    constructor(context, box) {
+        _ModulationBoxAdapter_terminator.set(this, new Terminator());
+        _ModulationBoxAdapter_context.set(this, void 0);
+        _ModulationBoxAdapter_box.set(this, void 0);
+        _ModulationBoxAdapter_parametric.set(this, void 0);
+        __classPrivateFieldSet(this, _ModulationBoxAdapter_context, context, "f");
+        __classPrivateFieldSet(this, _ModulationBoxAdapter_box, box, "f");
+        __classPrivateFieldSet(this, _ModulationBoxAdapter_parametric, __classPrivateFieldGet(this, _ModulationBoxAdapter_terminator, "f").own(new ParameterAdapterSet(__classPrivateFieldGet(this, _ModulationBoxAdapter_context, "f"))), "f");
+        this.namedParameter = {
+            depth: __classPrivateFieldGet(this, _ModulationBoxAdapter_parametric, "f").createParameter(box.depth, ValueMapping.bipolar(), StringMapping.percent({ fractionDigits: 0 }), "Depth", 0.5)
+        };
+        // The depth's automation lane lives on the modulator that drives it, so it shows up in that group.
+        const registration = __classPrivateFieldGet(this, _ModulationBoxAdapter_terminator, "f").own(new Terminator());
+        __classPrivateFieldGet(this, _ModulationBoxAdapter_terminator, "f").own(box.source.catchupAndSubscribe(() => {
+            registration.terminate();
+            box.source.targetVertex
+                .flatMap(vertex => __classPrivateFieldGet(this, _ModulationBoxAdapter_context, "f").boxAdapters.optAdapter(vertex.box))
+                .ifSome(adapter => {
+                if (isModulatorBoxAdapter(adapter)) {
+                    registration.own(this.namedParameter.depth.registerTracks(adapter.tracks));
+                }
+            });
+        }));
+    }
+    get box() { return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f"); }
+    get uuid() { return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").address.uuid; }
+    get address() { return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").address; }
+    get enabled() { return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").enabled.getValue(); }
+    get depth() { return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").depth.getValue(); }
+    get source() {
+        return __classPrivateFieldGet(this, _ModulationBoxAdapter_context, "f").boxAdapters.adapterFor(__classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").source.targetVertex.unwrap("no modulator").box, isModulatorBoxAdapter);
+    }
+    /// `None` while the target field has no registered parameter adapter yet.
+    get target() {
+        return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").target.targetVertex
+            .flatMap(vertex => __classPrivateFieldGet(this, _ModulationBoxAdapter_context, "f").parameterFieldAdapters.opt(vertex.address));
+    }
+    get targetAudioUnit() {
+        return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").target.targetVertex.flatMap(vertex => ParameterOwner.audioUnitOf(__classPrivateFieldGet(this, _ModulationBoxAdapter_context, "f"), vertex));
+    }
+    get targetOwner() {
+        return __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").target.targetVertex.flatMap(vertex => ParameterOwner.nameOf(__classPrivateFieldGet(this, _ModulationBoxAdapter_context, "f"), vertex));
+    }
+    /// The owner's name, kept current: renaming the device the target belongs to notifies again.
+    catchupAndSubscribeTargetOwner(observer) {
+        const vertex = __classPrivateFieldGet(this, _ModulationBoxAdapter_box, "f").target.targetVertex;
+        if (vertex.isEmpty()) {
+            observer("");
+            return Terminable.Empty;
+        }
+        return ParameterOwner.catchupAndSubscribeName(__classPrivateFieldGet(this, _ModulationBoxAdapter_context, "f"), vertex.unwrap(), observer);
+    }
+    terminate() { __classPrivateFieldGet(this, _ModulationBoxAdapter_terminator, "f").terminate(); }
+}
+_ModulationBoxAdapter_terminator = new WeakMap(), _ModulationBoxAdapter_context = new WeakMap(), _ModulationBoxAdapter_box = new WeakMap(), _ModulationBoxAdapter_parametric = new WeakMap();

package/dist/modulation/ModulatorBoxAdapter.d.ts

@@ -0,0 +1,35 @@
+import { Address, BooleanField, Box, Int32Field, StringField } from "@opendaw/lib-box";
+import { LfoModulatorBox, MacroModulatorBox, RandomModulatorBox, StepsModulatorBox } from "@opendaw/studio-boxes";
+import { AssertType, StringMapping, Terminator, unitValue, UUID } from "@opendaw/lib-std";
+import { IndexedBoxAdapter } from "../IndexedBoxAdapterCollection";
+import { BoxAdaptersContext } from "../BoxAdaptersContext";
+import { ParameterAdapterSet } from "../ParameterAdapterSet";
+import { AutomatableParameterFieldAdapter } from "../AutomatableParameterFieldAdapter";
+import { FieldParameterTracks } from "../timeline/ParameterTracks";
+import { ModulationBoxAdapter } from "./ModulationBoxAdapter";
+export declare const rangeStringMapping: (bipolar: BooleanField) => StringMapping<unitValue>;
+export declare const polarityStringMapping: (bipolar: BooleanField) => StringMapping<unitValue>;
+export type ModulatorBox = LfoModulatorBox | StepsModulatorBox | MacroModulatorBox | RandomModulatorBox;
+export declare const isModulatorBox: (box: Box) => box is ModulatorBox;
+export declare abstract class ModulatorBoxAdapter<BOX extends ModulatorBox = ModulatorBox> implements IndexedBoxAdapter {
+    #private;
+    protected readonly terminator: Terminator;
+    protected readonly context: BoxAdaptersContext;
+    protected readonly parametric: ParameterAdapterSet;
+    readonly tracks: FieldParameterTracks;
+    readonly amount: AutomatableParameterFieldAdapter<unitValue>;
+    protected constructor(context: BoxAdaptersContext, box: BOX);
+    get box(): BOX;
+    get uuid(): UUID.Bytes;
+    get address(): Address;
+    get label(): string;
+    get labelField(): StringField;
+    get enabled(): boolean;
+    get indexField(): Int32Field;
+    get bipolarField(): BooleanField;
+    get assignments(): ReadonlyArray<ModulationBoxAdapter>;
+    protected registerParameterTracks(): void;
+    terminate(): void;
+}
+export declare const isModulatorBoxAdapter: AssertType<ModulatorBoxAdapter>;
+//# sourceMappingURL=ModulatorBoxAdapter.d.ts.map

package/dist/modulation/ModulatorBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModulatorBoxAdapter.d.ts","sourceRoot":"","sources":["../../src/modulation/ModulatorBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAA;AACpF,OAAO,EACH,eAAe,EACf,iBAAiB,EAEjB,kBAAkB,EAClB,iBAAiB,EACpB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAEH,UAAU,EAGV,aAAa,EAEb,UAAU,EACV,SAAS,EACT,IAAI,EAEP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAC,mBAAmB,EAAC,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAC,gCAAgC,EAAC,MAAM,qCAAqC,CAAA;AACpF,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAA;AAI3D,eAAO,MAAM,kBAAkB,GAAI,SAAS,YAAY,KAAG,aAAa,CAAC,SAAS,CAOhF,CAAA;AAEF,eAAO,MAAM,qBAAqB,GAAI,SAAS,YAAY,KAAG,aAAa,CAAC,SAAS,CAQnF,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,kBAAkB,CAAA;AAEvG,eAAO,MAAM,cAAc,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,YAA6C,CAAA;AAE9F,8BAAsB,mBAAmB,CAAC,GAAG,SAAS,YAAY,GAAG,YAAY,CAAE,YAAW,iBAAiB;;IAC3G,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAmB;IAC5D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IAC9C,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC,SAAS,CAAC,CAAA;IAI5D,SAAS,aAAa,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG;IAU3D,IAAI,GAAG,IAAI,GAAG,CAAmB;IACjC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAgC;IACtD,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,IAAI,KAAK,IAAI,MAAM,CAAoC;IACvD,IAAI,UAAU,IAAI,WAAW,CAAyB;IACtD,IAAI,OAAO,IAAI,OAAO,CAAsC;IAC5D,IAAI,UAAU,IAAI,UAAU,CAAyB;IACrD,IAAI,YAAY,IAAI,YAAY,CAA2B;IAE3D,IAAI,WAAW,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAGrD;IAID,SAAS,CAAC,uBAAuB,IAAI,IAAI;IAOzC,SAAS,IAAI,IAAI;CACpB;AAED,eAAO,MAAM,qBAAqB,EAAE,UAAU,CAAC,mBAAmB,CACkC,CAAA"}

package/dist/modulation/ModulatorBoxAdapter.js

@@ -0,0 +1,69 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ModulatorBoxAdapter_box;
+import { ModulationBox } from "@opendaw/studio-boxes";
+import { asInstanceOf, isInstanceOf, Terminator, ValueMapping } from "@opendaw/lib-std";
+import { ParameterAdapterSet } from "../ParameterAdapterSet";
+import { FieldParameterTracks } from "../timeline/ParameterTracks";
+import { ModulationBoxAdapter } from "./ModulationBoxAdapter";
+const percent = (value) => (value * 100.0).toFixed(0);
+export const rangeStringMapping = (bipolar) => ({
+    x: (value) => ({ value: `${bipolar.getValue() ? "±" : "+"}${percent(value)}`, unit: "%" }),
+    y: (text) => {
+        const value = parseFloat(text.replace("±", "").replace("+", "").trim());
+        return isNaN(value) ? { type: "unknown", value: text.trim() } : { type: "explicit", value: value / 100.0 };
+    }
+});
+export const polarityStringMapping = (bipolar) => ({
+    x: (value) => ({ value: percent(bipolar.getValue() ? value * 2.0 - 1.0 : value), unit: "%" }),
+    y: (text) => {
+        const value = parseFloat(text.replace("%", "").trim());
+        if (isNaN(value)) {
+            return { type: "unknown", value: text.trim() };
+        }
+        return { type: "explicit", value: bipolar.getValue() ? value / 200.0 + 0.5 : value / 100.0 };
+    }
+});
+export const isModulatorBox = (box) => box.tags.type === "modulator";
+export class ModulatorBoxAdapter {
+    constructor(context, box) {
+        this.terminator = new Terminator();
+        _ModulatorBoxAdapter_box.set(this, void 0);
+        this.context = context;
+        __classPrivateFieldSet(this, _ModulatorBoxAdapter_box, box, "f");
+        this.parametric = this.terminator.own(new ParameterAdapterSet(context));
+        this.tracks = this.terminator.own(new FieldParameterTracks(box.graph, box.tracks, context.boxAdapters));
+        this.amount = this.parametric.createParameter(box.amount, ValueMapping.unipolar(), rangeStringMapping(box.bipolar), "Range");
+    }
+    get box() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f"); }
+    get uuid() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").address.uuid; }
+    get address() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").address; }
+    get label() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").label.getValue(); }
+    get labelField() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").label; }
+    get enabled() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").enabled.getValue(); }
+    get indexField() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").index; }
+    get bipolarField() { return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").bipolar; }
+    get assignments() {
+        return __classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").assignments.pointerHub.incoming()
+            .map(({ box }) => this.context.boxAdapters.adapterFor(asInstanceOf(box, ModulationBox), ModulationBoxAdapter));
+    }
+    /// The subclass creates its parameters, then hands them their lane owner: automation of a modulator's
+    /// parameter lives on the modulator, not on an audio unit.
+    registerParameterTracks() {
+        const parameters = this.parametric.parameters();
+        parameters.forEach(parameter => this.terminator.own(parameter.registerTracks(this.tracks)));
+        this.terminator.own(__classPrivateFieldGet(this, _ModulatorBoxAdapter_box, "f").bipolar.subscribe(() => parameters.forEach(parameter => parameter.notifyPrinting())));
+    }
+    terminate() { this.terminator.terminate(); }
+}
+_ModulatorBoxAdapter_box = new WeakMap();
+export const isModulatorBoxAdapter = (adapter) => isInstanceOf(adapter, ModulatorBoxAdapter);

package/dist/modulation/Modulators.d.ts

@@ -0,0 +1,25 @@
+import { LfoModulatorBox, MacroModulatorBox, ModulationBox, RandomModulatorBox, StepsModulatorBox } from "@opendaw/studio-boxes";
+import { Field } from "@opendaw/lib-box";
+import { Pointers } from "@opendaw/studio-enums";
+import { Func, unitValue } from "@opendaw/lib-std";
+import { BoxAdaptersContext } from "../BoxAdaptersContext";
+import { ModulatorBox } from "./ModulatorBoxAdapter";
+export declare namespace Modulators {
+    const createLfo: (context: BoxAdaptersContext, label?: string) => LfoModulatorBox;
+    const createSteps: (context: BoxAdaptersContext, label?: string) => StepsModulatorBox;
+    const createMacro: (context: BoxAdaptersContext, label?: string) => MacroModulatorBox;
+    const createRandom: (context: BoxAdaptersContext, label?: string) => RandomModulatorBox;
+    type Kind = {
+        readonly label: string;
+        readonly boxName: string;
+        readonly create: Func<BoxAdaptersContext, ModulatorBox>;
+    };
+    const Kinds: ReadonlyArray<Kind>;
+    const replace: (context: BoxAdaptersContext, modulator: ModulatorBox, kind: Kind) => ModulatorBox;
+    const duplicate: (context: BoxAdaptersContext, modulator: ModulatorBox) => ModulatorBox;
+    const duplicateAll: (context: BoxAdaptersContext, modulators: ReadonlyArray<ModulatorBox>) => ReadonlyArray<ModulatorBox>;
+    const deleteAll: (context: BoxAdaptersContext, modulators: ReadonlyArray<ModulatorBox>) => void;
+    const move: (context: BoxAdaptersContext, modulators: ReadonlyArray<ModulatorBox>, target: ModulatorBox) => void;
+    const assign: (context: BoxAdaptersContext, modulator: ModulatorBox, target: Field<Pointers.Modulation>, depth?: unitValue) => ModulationBox;
+}
+//# sourceMappingURL=Modulators.d.ts.map

package/dist/modulation/Modulators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modulators.d.ts","sourceRoot":"","sources":["../../src/modulation/Modulators.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAElB,iBAAiB,EACpB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAM,KAAK,EAAe,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAiB,IAAI,EAAkB,SAAS,EAAO,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAGlD,yBAAiB,UAAU,CAAC;IACjB,MAAM,SAAS,GAAI,SAAS,kBAAkB,EAAE,QAAQ,MAAM,KAAG,eACkC,CAAA;IAEnG,MAAM,WAAW,GAAI,SAAS,kBAAkB,EAAE,QAAQ,MAAM,KAAG,iBACoC,CAAA;IAEvG,MAAM,WAAW,GAAI,SAAS,kBAAkB,EAAE,QAAQ,MAAM,KAAG,iBACoC,CAAA;IAEvG,MAAM,YAAY,GAAI,SAAS,kBAAkB,EAAE,QAAQ,MAAM,KAAG,kBACqC,CAAA;IAEhH,KAAY,IAAI,GAAG;QACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAA;KAC1D,CAAA;IAEM,MAAM,KAAK,EAAE,aAAa,CAAC,IAAI,CAKrC,CAAA;IAGM,MAAM,OAAO,GAAI,SAAS,kBAAkB,EAAE,WAAW,YAAY,EAAE,MAAM,IAAI,KAAG,YAgB1F,CAAA;IAGM,MAAM,SAAS,GAAI,SAAS,kBAAkB,EAAE,WAAW,YAAY,KAAG,YACxC,CAAA;IAKlC,MAAM,YAAY,GAAI,SAAS,kBAAkB,EAC3B,YAAY,aAAa,CAAC,YAAY,CAAC,KAAG,aAAa,CAAC,YAAY,CAehG,CAAA;IAGM,MAAM,SAAS,GAAI,SAAS,kBAAkB,EAAE,YAAY,aAAa,CAAC,YAAY,CAAC,KAAG,IAMhG,CAAA;IAIM,MAAM,IAAI,GAAI,SAAS,kBAAkB,EAC3B,YAAY,aAAa,CAAC,YAAY,CAAC,EACvC,QAAQ,YAAY,KAAG,IAW3C,CAAA;IAqBM,MAAM,MAAM,GAAI,SAAS,kBAAkB,EAC3B,WAAW,YAAY,EACvB,QAAQ,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAClC,QAAO,SAAgB,KAAG,aAM3C,CAAA;CACT"}

package/dist/modulation/Modulators.js

@@ -0,0 +1,101 @@
+import { LfoModulatorBox, MacroModulatorBox, ModulationBox, RandomModulatorBox, StepsModulatorBox } from "@opendaw/studio-boxes";
+import { ByteArrayInput, panic, Strings, UUID } from "@opendaw/lib-std";
+/// Every caller is inside an `editing.modify`, so nothing here opens a transaction.
+export var Modulators;
+(function (Modulators) {
+    Modulators.createLfo = (context, label) => LfoModulatorBox.create(context.boxGraph, UUID.generate(), box => attach(context, box, label ?? "LFO"));
+    Modulators.createSteps = (context, label) => StepsModulatorBox.create(context.boxGraph, UUID.generate(), box => attach(context, box, label ?? "Steps"));
+    Modulators.createMacro = (context, label) => MacroModulatorBox.create(context.boxGraph, UUID.generate(), box => attach(context, box, label ?? "Macro"));
+    Modulators.createRandom = (context, label) => RandomModulatorBox.create(context.boxGraph, UUID.generate(), box => attach(context, box, label ?? "Random"));
+    Modulators.Kinds = [
+        { label: "LFO", boxName: "LfoModulatorBox", create: Modulators.createLfo },
+        { label: "Steps", boxName: "StepsModulatorBox", create: Modulators.createSteps },
+        { label: "Macro", boxName: "MacroModulatorBox", create: Modulators.createMacro },
+        { label: "Random", boxName: "RandomModulatorBox", create: Modulators.createRandom }
+    ];
+    /// Becomes another kind in place: the assignments move over first, so they never see the old box die.
+    Modulators.replace = (context, modulator, kind) => {
+        const replacement = kind.create(context);
+        modulator.assignments.pointerHub.incoming().slice()
+            .forEach((pointer) => pointer.refer(replacement.assignments));
+        const label = modulator.label.getValue();
+        const index = modulator.index.getValue();
+        const enabled = modulator.enabled.getValue();
+        const bipolar = modulator.bipolar.getValue();
+        const amount = modulator.amount.getValue();
+        modulator.delete();
+        replacement.label.setValue(label);
+        replacement.index.setValue(index);
+        replacement.enabled.setValue(enabled);
+        replacement.bipolar.setValue(bipolar);
+        replacement.amount.setValue(amount);
+        return replacement;
+    };
+    /// Same kind and settings, no targets. The copy reads the original's own bytes, so every kind is covered.
+    Modulators.duplicate = (context, modulator) => Modulators.duplicateAll(context, [modulator])[0];
+    /// Several at once, appended in their list order, each with its own unique name. A box created in THIS
+    /// transaction is not in the collection yet (its edges resolve on commit), so index and name are counted
+    /// forward here rather than re-read per copy.
+    Modulators.duplicateAll = (context, modulators) => {
+        const existing = context.rootBoxAdapter.modulators.adapters();
+        const taken = existing.map(adapter => adapter.label);
+        return modulators.slice()
+            .sort((a, b) => a.index.getValue() - b.index.getValue())
+            .map((modulator, offset) => {
+            const input = new ByteArrayInput(modulator.toArrayBuffer());
+            const copy = asModulatorBox(context.boxGraph.createBox(modulator.name, UUID.generate(), box => box.read(input)));
+            const label = Strings.getUniqueName(taken, modulator.label.getValue());
+            taken.push(label);
+            copy.index.setValue(existing.length + offset);
+            copy.label.setValue(label);
+            return copy;
+        });
+    };
+    /// Delete a whole selection and close the gaps it leaves, so the remaining indices stay 0..n-1.
+    Modulators.deleteAll = (context, modulators) => {
+        const doomed = new Set(modulators);
+        const remaining = context.rootBoxAdapter.modulators.adapters()
+            .filter(adapter => !doomed.has(adapter.box));
+        doomed.forEach(modulator => modulator.delete());
+        reindex(remaining.map(adapter => adapter.box));
+    };
+    /// Move a set to `target`'s place, keeping the moved ones in their own order. Dropping onto a member of
+    /// the set itself is a no-op, so a drag that ends where it started changes nothing.
+    Modulators.move = (context, modulators, target) => {
+        const moved = new Set(modulators);
+        if (moved.has(target) || moved.size === 0) {
+            return;
+        }
+        const ordered = context.rootBoxAdapter.modulators.adapters().map(adapter => adapter.box);
+        const stationary = ordered.filter(box => !moved.has(box));
+        const insertAt = stationary.indexOf(target);
+        if (insertAt < 0) {
+            return;
+        }
+        const dragged = ordered.filter(box => moved.has(box));
+        const before = ordered.indexOf(dragged[0]) < ordered.indexOf(target);
+        stationary.splice(before ? insertAt + 1 : insertAt, 0, ...dragged);
+        reindex(stationary);
+    };
+    const reindex = (modulators) => modulators.forEach((modulator, index) => modulator.index.setValue(index));
+    const asModulatorBox = (box) => box.accept({
+        visitLfoModulatorBox: (box) => box,
+        visitStepsModulatorBox: (box) => box,
+        visitMacroModulatorBox: (box) => box,
+        visitRandomModulatorBox: (box) => box
+    }) ?? panic(`${box.name} is no modulator`);
+    const attach = (context, box, label) => {
+        const rootBox = context.rootBoxAdapter.box;
+        const existing = context.rootBoxAdapter.modulators.adapters();
+        box.collection.refer(rootBox.modulators);
+        box.index.setValue(existing.length);
+        box.label.setValue(Strings.getUniqueName(existing.map(adapter => adapter.label), label));
+    };
+    /// A parameter accepts several assignments, so this never replaces an existing one. `depth` is signed.
+    Modulators.assign = (context, modulator, target, depth = 0.25) => ModulationBox.create(context.boxGraph, UUID.generate(), box => {
+        box.source.refer(modulator.assignments);
+        box.target.refer(target);
+        box.index.setValue(modulator.assignments.pointerHub.incoming().length);
+        box.depth.setValue(depth);
+    });
+})(Modulators || (Modulators = {}));

package/dist/modulation/RandomModulatorBoxAdapter.d.ts

@@ -0,0 +1,24 @@
+import { RandomModulatorBox } from "@opendaw/studio-boxes";
+import { int, unitValue } from "@opendaw/lib-std";
+import { BoxAdaptersContext } from "../BoxAdaptersContext";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+export declare class RandomModulatorBoxAdapter extends ModulatorBoxAdapter<RandomModulatorBox> {
+    #private;
+    static readonly MaxLoop = 64;
+    static readonly MaxLevels = 32;
+    static readonly MaxSeed = 999999;
+    readonly namedParameter: {
+        readonly loop: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateSync: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateAbsolute: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly phase: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly smooth: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly levels: import("..").AutomatableParameterFieldAdapter<number>;
+    };
+    constructor(context: BoxAdaptersContext, box: RandomModulatorBox);
+    get loop(): int;
+    draw(index: int): unitValue;
+    valueAt(step: number): unitValue;
+    reseed(): void;
+}
+//# sourceMappingURL=RandomModulatorBoxAdapter.d.ts.map

package/dist/modulation/RandomModulatorBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RandomModulatorBoxAdapter.d.ts","sourceRoot":"","sources":["../../src/modulation/RandomModulatorBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAC,GAAG,EAAiB,SAAS,EAAe,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AAGzD,qBAAa,yBAA0B,SAAQ,mBAAmB,CAAC,kBAAkB,CAAC;;IAClF,MAAM,CAAC,QAAQ,CAAC,OAAO,MAAK;IAC5B,MAAM,CAAC,QAAQ,CAAC,SAAS,MAAK;IAC9B,MAAM,CAAC,QAAQ,CAAC,OAAO,UAAS;IAEhC,QAAQ,CAAC,cAAc;;;;;;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB;IAMhE,IAAI,IAAI,IAAI,GAAG,CAAkC;IAEjD,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS;IAS3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAUhC,MAAM,IAAI,IAAI;CAmCjB"}

package/dist/modulation/RandomModulatorBoxAdapter.js

@@ -0,0 +1,62 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _RandomModulatorBoxAdapter_instances, _a, _RandomModulatorBoxAdapter_localIndex, _RandomModulatorBoxAdapter_quantize, _RandomModulatorBoxAdapter_wrapParameters;
+import { StringMapping, ValueMapping } from "@opendaw/lib-std";
+import { LfoModulatorBoxAdapter } from "./LfoModulatorBoxAdapter";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+// WASM CONTRACT: `draw` and `quantize` mirror the engine's `modulation::hash_bipolar` / `quantize`.
+export class RandomModulatorBoxAdapter extends ModulatorBoxAdapter {
+    constructor(context, box) {
+        super(context, box);
+        _RandomModulatorBoxAdapter_instances.add(this);
+        this.namedParameter = __classPrivateFieldGet(this, _RandomModulatorBoxAdapter_instances, "m", _RandomModulatorBoxAdapter_wrapParameters).call(this, box);
+        this.registerParameterTracks();
+    }
+    get loop() { return this.box.loop.getValue(); }
+    draw(index) {
+        const seed = this.box.seed.getValue();
+        const local = __classPrivateFieldGet(this, _RandomModulatorBoxAdapter_instances, "m", _RandomModulatorBoxAdapter_localIndex).call(this, index);
+        let hash = Math.imul(seed, 0x9E3779B1) ^ Math.imul(local, 0x85EBCA77);
+        hash = Math.imul(hash ^ (hash >>> 15), 0x2545F491);
+        hash ^= hash >>> 13;
+        return __classPrivateFieldGet(this, _RandomModulatorBoxAdapter_instances, "m", _RandomModulatorBoxAdapter_quantize).call(this, (hash >>> 0) / 4294967295.0 * 2.0 - 1.0);
+    }
+    valueAt(step) {
+        const index = Math.floor(step);
+        const current = this.draw(index);
+        const smooth = this.box.smooth.getValue();
+        if (smooth <= 0.0) {
+            return current;
+        }
+        const previous = this.draw(index - 1);
+        const ramp = Math.min(1.0, (step - index) / smooth);
+        return previous + (current - previous) * ramp * ramp * (3.0 - 2.0 * ramp);
+    }
+    reseed() { this.box.seed.setValue(Math.floor(Math.random() * _a.MaxSeed)); }
+}
+_a = RandomModulatorBoxAdapter, _RandomModulatorBoxAdapter_instances = new WeakSet(), _RandomModulatorBoxAdapter_localIndex = function _RandomModulatorBoxAdapter_localIndex(index) {
+    const length = this.loop;
+    return length > 0 ? ((index % length) + length) % length : index | 0;
+}, _RandomModulatorBoxAdapter_quantize = function _RandomModulatorBoxAdapter_quantize(value) {
+    const levels = this.box.levels.getValue();
+    if (levels < 2) {
+        return value;
+    }
+    const steps = levels - 1;
+    return Math.min(steps, Math.max(0, Math.floor((value + 1.0) * 0.5 * steps + 0.5))) / steps * 2.0 - 1.0;
+}, _RandomModulatorBoxAdapter_wrapParameters = function _RandomModulatorBoxAdapter_wrapParameters(box) {
+    return {
+        loop: this.parametric.createParameter(box.loop, ValueMapping.linearInteger(0, _a.MaxLoop), StringMapping.numeric({ unit: "" }), "Loop"),
+        rateSync: this.parametric.createParameter(box.rateSync, ValueMapping.linearInteger(0, LfoModulatorBoxAdapter.RateStrings.length - 1), StringMapping.indices("", LfoModulatorBoxAdapter.RateStrings), "Sync"),
+        rateAbsolute: this.parametric.createParameter(box.rateAbsolute, ValueMapping.powerByCenter(LfoModulatorBoxAdapter.CenterAbsoluteRate, 0.0, LfoModulatorBoxAdapter.MaxAbsoluteRate), StringMapping.numeric({ unit: "Hz", fractionDigits: 2 }), "Free"),
+        phase: this.parametric.createParameter(box.phase, ValueMapping.unipolar(), StringMapping.percent({ fractionDigits: 0 }), "Phase"),
+        smooth: this.parametric.createParameter(box.smooth, ValueMapping.unipolar(), StringMapping.percent({ fractionDigits: 0 }), "Smooth"),
+        levels: this.parametric.createParameter(box.levels, ValueMapping.linearInteger(0, _a.MaxLevels), StringMapping.numeric({ unit: "" }), "Levels")
+    };
+};
+RandomModulatorBoxAdapter.MaxLoop = 64;
+RandomModulatorBoxAdapter.MaxLevels = 32;
+RandomModulatorBoxAdapter.MaxSeed = 999999;

package/dist/modulation/StepsModulatorBoxAdapter.d.ts

@@ -0,0 +1,42 @@
+import { Float32Field } from "@opendaw/lib-box";
+import { StepsModulatorBox } from "@opendaw/studio-boxes";
+import { int, unitValue } from "@opendaw/lib-std";
+import { BoxAdaptersContext } from "../BoxAdaptersContext";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+export declare enum StepsDirection {
+    Forward = 0,
+    Backward = 1,
+    PingPong = 2,
+    Alternate = 3,
+    Random = 4
+}
+export type StepsPass = {
+    ascending: boolean;
+    from: int;
+    to: int;
+};
+export declare class StepsModulatorBoxAdapter extends ModulatorBoxAdapter<StepsModulatorBox> {
+    #private;
+    static readonly MaxSteps = 64;
+    static readonly DirectionStrings: ReadonlyArray<string>;
+    readonly namedParameter: {
+        readonly count: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateSync: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateAbsolute: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly phase: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly smooth: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly direction: import("..").AutomatableParameterFieldAdapter<number>;
+    };
+    constructor(context: BoxAdaptersContext, box: StepsModulatorBox);
+    get count(): int;
+    get steps(): ReadonlyArray<Float32Field>;
+    get passes(): ReadonlyArray<StepsPass>;
+    patternAt(step: number, ascending: boolean): unitValue;
+    get neutral(): unitValue;
+    emitted(stored: unitValue): number;
+    stored(emitted: number): unitValue;
+    clear(): void;
+    randomize(): void;
+    rotate(offset: int): void;
+}
+//# sourceMappingURL=StepsModulatorBoxAdapter.d.ts.map

package/dist/modulation/StepsModulatorBoxAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepsModulatorBoxAdapter.d.ts","sourceRoot":"","sources":["../../src/modulation/StepsModulatorBoxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAC,GAAG,EAAiB,SAAS,EAAe,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AAGzD,oBAAY,cAAc;IAAE,OAAO,IAAA;IAAE,QAAQ,IAAA;IAAE,QAAQ,IAAA;IAAE,SAAS,IAAA;IAAE,MAAM,IAAA;CAAC;AAE3E,MAAM,MAAM,SAAS,GAAG;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,EAAE,EAAE,GAAG,CAAA;CAAC,CAAA;AAEhE,qBAAa,wBAAyB,SAAQ,mBAAmB,CAAC,iBAAiB,CAAC;;IAChF,MAAM,CAAC,QAAQ,CAAC,QAAQ,MAAK;IAC7B,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAA8D;IAErH,QAAQ,CAAC,cAAc;;;;;;;MAAA;gBAEX,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,iBAAiB;IAM/D,IAAI,KAAK,IAAI,GAAG,CAAmC;IACnD,IAAI,KAAK,IAAI,aAAa,CAAC,YAAY,CAAC,CAAiC;IAGzE,IAAI,MAAM,IAAI,aAAa,CAAC,SAAS,CAAC,CAcrC;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS;IA6BtD,IAAI,OAAO,IAAI,SAAS,CAAiD;IAEzE,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM;IAElC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAElC,KAAK,IAAI,IAAI;IAKb,SAAS,IAAI,IAAI;IAEjB,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;CAiC5B"}

package/dist/modulation/StepsModulatorBoxAdapter.js

@@ -0,0 +1,100 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _StepsModulatorBoxAdapter_instances, _a, _StepsModulatorBoxAdapter_predecessor, _StepsModulatorBoxAdapter_activeSteps, _StepsModulatorBoxAdapter_wrapParameters;
+import { StringMapping, ValueMapping } from "@opendaw/lib-std";
+import { LfoModulatorBoxAdapter } from "./LfoModulatorBoxAdapter";
+import { ModulatorBoxAdapter } from "./ModulatorBoxAdapter";
+// WASM CONTRACT: mirrors the engine's `modulation::DIRECTION_*` (crates/engine/src/modulation.rs).
+export var StepsDirection;
+(function (StepsDirection) {
+    StepsDirection[StepsDirection["Forward"] = 0] = "Forward";
+    StepsDirection[StepsDirection["Backward"] = 1] = "Backward";
+    StepsDirection[StepsDirection["PingPong"] = 2] = "PingPong";
+    StepsDirection[StepsDirection["Alternate"] = 3] = "Alternate";
+    StepsDirection[StepsDirection["Random"] = 4] = "Random";
+})(StepsDirection || (StepsDirection = {}));
+export class StepsModulatorBoxAdapter extends ModulatorBoxAdapter {
+    constructor(context, box) {
+        super(context, box);
+        _StepsModulatorBoxAdapter_instances.add(this);
+        this.namedParameter = __classPrivateFieldGet(this, _StepsModulatorBoxAdapter_instances, "m", _StepsModulatorBoxAdapter_wrapParameters).call(this, box);
+        this.registerParameterTracks();
+    }
+    get count() { return this.box.count.getValue(); }
+    get steps() { return this.box.steps.fields(); }
+    /// The passes the sequence makes over the pattern, each covering the steps `[from, to)` it reaches.
+    get passes() {
+        const count = Math.max(1, Math.min(this.count, _a.MaxSteps));
+        switch (this.box.direction.getValue()) {
+            case StepsDirection.Backward:
+                return [{ ascending: false, from: 0, to: count }];
+            case StepsDirection.PingPong:
+                return [{ ascending: true, from: 0, to: count }, { ascending: false, from: 0, to: count }];
+            case StepsDirection.Alternate:
+                return count < 3
+                    ? [{ ascending: true, from: 0, to: count }]
+                    : [{ ascending: true, from: 0, to: count - 1 }, { ascending: false, from: 1, to: count }];
+            default:
+                return [{ ascending: true, from: 0, to: count }];
+        }
+    }
+    patternAt(step, ascending) {
+        const count = Math.max(1, Math.min(this.count, _a.MaxSteps));
+        const index = ((Math.floor(step) % count) + count) % count;
+        const current = this.steps[index].getValue();
+        const smooth = this.box.smooth.getValue();
+        if (smooth <= 0.0) {
+            return current;
+        }
+        const local = step - Math.floor(step);
+        const traversed = ascending ? local : 1.0 - local;
+        const previous = this.steps[__classPrivateFieldGet(this, _StepsModulatorBoxAdapter_instances, "m", _StepsModulatorBoxAdapter_predecessor).call(this, index, count, ascending)].getValue();
+        const ramp = Math.min(1.0, traversed / smooth);
+        return previous + (current - previous) * ramp * ramp * (3.0 - 2.0 * ramp);
+    }
+    get neutral() { return this.box.bipolar.getValue() ? 0.5 : 0.0; }
+    emitted(stored) { return this.box.bipolar.getValue() ? stored * 2.0 - 1.0 : stored; }
+    stored(emitted) { return this.box.bipolar.getValue() ? emitted * 0.5 + 0.5 : emitted; }
+    clear() {
+        const neutral = this.neutral;
+        __classPrivateFieldGet(this, _StepsModulatorBoxAdapter_instances, "m", _StepsModulatorBoxAdapter_activeSteps).call(this).forEach(step => step.setValue(neutral));
+    }
+    randomize() { __classPrivateFieldGet(this, _StepsModulatorBoxAdapter_instances, "m", _StepsModulatorBoxAdapter_activeSteps).call(this).forEach(step => step.setValue(Math.random())); }
+    rotate(offset) {
+        const active = __classPrivateFieldGet(this, _StepsModulatorBoxAdapter_instances, "m", _StepsModulatorBoxAdapter_activeSteps).call(this);
+        const values = active.map(step => step.getValue());
+        const count = values.length;
+        active.forEach((step, index) => step.setValue(values[(((index - offset) % count) + count) % count]));
+    }
+}
+_a = StepsModulatorBoxAdapter, _StepsModulatorBoxAdapter_instances = new WeakSet(), _StepsModulatorBoxAdapter_predecessor = function _StepsModulatorBoxAdapter_predecessor(index, count, ascending) {
+    const wrap = (value) => ((value % count) + count) % count;
+    switch (this.box.direction.getValue()) {
+        case StepsDirection.PingPong:
+            return ascending
+                ? (index === 0 ? 0 : index - 1)
+                : (index === count - 1 ? count - 1 : index + 1);
+        case StepsDirection.Alternate:
+            return ascending
+                ? (index === 0 ? Math.min(1, count - 1) : index - 1)
+                : (index === count - 1 ? Math.max(0, count - 2) : index + 1);
+        default:
+            return ascending ? wrap(index - 1) : wrap(index + 1);
+    }
+}, _StepsModulatorBoxAdapter_activeSteps = function _StepsModulatorBoxAdapter_activeSteps() {
+    return this.steps.slice(0, Math.max(1, Math.min(this.count, _a.MaxSteps)));
+}, _StepsModulatorBoxAdapter_wrapParameters = function _StepsModulatorBoxAdapter_wrapParameters(box) {
+    return {
+        count: this.parametric.createParameter(box.count, ValueMapping.linearInteger(1, _a.MaxSteps), StringMapping.numeric({ unit: "" }), "Steps"),
+        rateSync: this.parametric.createParameter(box.rateSync, ValueMapping.linearInteger(0, LfoModulatorBoxAdapter.RateStrings.length - 1), StringMapping.indices("", LfoModulatorBoxAdapter.RateStrings), "Sync"),
+        rateAbsolute: this.parametric.createParameter(box.rateAbsolute, ValueMapping.powerByCenter(LfoModulatorBoxAdapter.CenterAbsoluteRate, 0.0, LfoModulatorBoxAdapter.MaxAbsoluteRate), StringMapping.numeric({ unit: "Hz", fractionDigits: 2 }), "Free"),
+        phase: this.parametric.createParameter(box.phase, ValueMapping.unipolar(), StringMapping.percent({ fractionDigits: 0 }), "Phase"),
+        smooth: this.parametric.createParameter(box.smooth, ValueMapping.unipolar(), StringMapping.percent({ fractionDigits: 0 }), "Smooth"),
+        direction: this.parametric.createParameter(box.direction, ValueMapping.linearInteger(0, _a.DirectionStrings.length - 1), StringMapping.indices("", _a.DirectionStrings), "Mode")
+    };
+};
+StepsModulatorBoxAdapter.MaxSteps = 64;
+StepsModulatorBoxAdapter.DirectionStrings = ["Forward", "Backward", "Ping-Pong", "Alternate", "Random"];

package/dist/timeline/ParameterTracks.d.ts

@@ -0,0 +1,30 @@
+import { int, Observer, Option, Subscription, Terminable } from "@opendaw/lib-std";
+import { Pointers } from "@opendaw/studio-enums";
+import { TrackBox } from "@opendaw/studio-boxes";
+import { BoxGraph, Field, Vertex } from "@opendaw/lib-box";
+import { IndexedAdapterCollectionListener, IndexedBoxAdapterCollection } from "../IndexedBoxAdapterCollection";
+import { TrackBoxAdapter } from "./TrackBoxAdapter";
+import { BoxAdapters } from "../BoxAdapters";
+import { TrackType } from "./TrackType";
+export interface ParameterTracks extends Terminable {
+    create(type: TrackType, target: Vertex<Pointers.Automation | Pointers>, index?: int): TrackBox;
+    controls(target: Vertex<Pointers.Automation | Pointers>): Option<TrackBoxAdapter>;
+    delete(adapter: TrackBoxAdapter): void;
+    values(): ReadonlyArray<TrackBoxAdapter>;
+    get collection(): IndexedBoxAdapterCollection<TrackBoxAdapter, Pointers.TrackCollection>;
+    catchupAndSubscribe(listener: IndexedAdapterCollectionListener<TrackBoxAdapter>): Subscription;
+    subscribeAnyChange(observer: Observer<void>): Subscription;
+}
+export declare class FieldParameterTracks implements ParameterTracks {
+    #private;
+    constructor(graph: BoxGraph, field: Field<Pointers.TrackCollection>, boxAdapters: BoxAdapters);
+    create(type: TrackType, target: Vertex<Pointers.Automation | Pointers>, index?: int): TrackBox;
+    controls(target: Vertex<Pointers.Automation | Pointers>): Option<TrackBoxAdapter>;
+    delete(adapter: TrackBoxAdapter): void;
+    get collection(): IndexedBoxAdapterCollection<TrackBoxAdapter, Pointers.TrackCollection>;
+    values(): ReadonlyArray<TrackBoxAdapter>;
+    catchupAndSubscribe(listener: IndexedAdapterCollectionListener<TrackBoxAdapter>): Subscription;
+    subscribeAnyChange(observer: Observer<void>): Subscription;
+    terminate(): void;
+}
+//# sourceMappingURL=ParameterTracks.d.ts.map

package/dist/timeline/ParameterTracks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParameterTracks.d.ts","sourceRoot":"","sources":["../../src/timeline/ParameterTracks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAY,QAAQ,EAAE,MAAM,EAAoB,YAAY,EAAE,UAAU,EAAO,MAAM,kBAAkB,CAAA;AAClH,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAC,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAC,gCAAgC,EAAE,2BAA2B,EAAC,MAAM,gCAAgC,CAAA;AAC5G,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAA;AAIrC,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAC/C,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAA;IAC9F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA;IACjF,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC,CAAA;IACxC,IAAI,UAAU,IAAI,2BAA2B,CAAC,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;IACxF,mBAAmB,CAAC,QAAQ,EAAE,gCAAgC,CAAC,eAAe,CAAC,GAAG,YAAY,CAAA;IAC9F,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAA;CAC7D;AAED,qBAAa,oBAAqB,YAAW,eAAe;;gBAS5C,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,WAAW;IAgB7F,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,QAAQ;IAS9F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC;IAKjF,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAUtC,IAAI,UAAU,IAAI,2BAA2B,CAAC,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,CAA0B;IAElH,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC;IAExC,mBAAmB,CAAC,QAAQ,EAAE,gCAAgC,CAAC,eAAe,CAAC,GAAG,YAAY;IAI9F,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IAE1D,SAAS,IAAI,IAAI;CAMpB"}

package/dist/timeline/ParameterTracks.js

@@ -0,0 +1,75 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _FieldParameterTracks_graph, _FieldParameterTracks_field, _FieldParameterTracks_regionNotifier, _FieldParameterTracks_collection, _FieldParameterTracks_subscriptions, _FieldParameterTracks_subscription;
+import { Notifier, Option, panic, UUID } from "@opendaw/lib-std";
+import { Pointers } from "@opendaw/studio-enums";
+import { TrackBox } from "@opendaw/studio-boxes";
+import { IndexedBoxAdapterCollection } from "../IndexedBoxAdapterCollection";
+import { TrackBoxAdapter } from "./TrackBoxAdapter";
+export class FieldParameterTracks {
+    constructor(graph, field, boxAdapters) {
+        _FieldParameterTracks_graph.set(this, void 0);
+        _FieldParameterTracks_field.set(this, void 0);
+        _FieldParameterTracks_regionNotifier.set(this, new Notifier());
+        _FieldParameterTracks_collection.set(this, void 0);
+        _FieldParameterTracks_subscriptions.set(this, void 0);
+        _FieldParameterTracks_subscription.set(this, void 0);
+        __classPrivateFieldSet(this, _FieldParameterTracks_graph, graph, "f");
+        __classPrivateFieldSet(this, _FieldParameterTracks_field, field, "f");
+        __classPrivateFieldSet(this, _FieldParameterTracks_collection, IndexedBoxAdapterCollection.create(field, box => boxAdapters.adapterFor(box, TrackBoxAdapter), Pointers.TrackCollection), "f");
+        __classPrivateFieldSet(this, _FieldParameterTracks_subscriptions, UUID.newSet(({ uuid }) => uuid), "f");
+        __classPrivateFieldSet(this, _FieldParameterTracks_subscription, __classPrivateFieldGet(this, _FieldParameterTracks_collection, "f").catchupAndSubscribe({
+            onAdd: (adapter) => __classPrivateFieldGet(this, _FieldParameterTracks_subscriptions, "f").add({
+                uuid: adapter.uuid,
+                subscription: adapter.regions.subscribeChanges(() => __classPrivateFieldGet(this, _FieldParameterTracks_regionNotifier, "f").notify())
+            }),
+            onRemove: ({ uuid }) => __classPrivateFieldGet(this, _FieldParameterTracks_subscriptions, "f").removeByKey(uuid).subscription.terminate(),
+            onReorder: (_adapter) => { }
+        }), "f");
+    }
+    create(type, target, index) {
+        return TrackBox.create(__classPrivateFieldGet(this, _FieldParameterTracks_graph, "f"), UUID.generate(), box => {
+            box.index.setValue(index ?? __classPrivateFieldGet(this, _FieldParameterTracks_collection, "f").getMinFreeIndex());
+            box.type.setValue(type);
+            box.tracks.refer(__classPrivateFieldGet(this, _FieldParameterTracks_field, "f"));
+            box.target.refer(target);
+        });
+    }
+    controls(target) {
+        return Option.wrap(__classPrivateFieldGet(this, _FieldParameterTracks_collection, "f").adapters()
+            .find(adapter => adapter.target.targetVertex.contains(target), false));
+    }
+    delete(adapter) {
+        const adapters = __classPrivateFieldGet(this, _FieldParameterTracks_collection, "f").adapters();
+        const deleteIndex = adapters.indexOf(adapter);
+        if (deleteIndex === -1) {
+            return panic(`Cannot delete ${adapter}. Does not exist.`);
+        }
+        for (let index = deleteIndex + 1; index < adapters.length; index++) {
+            adapters[index].indexField.setValue(index - 1);
+        }
+        adapter.box.delete();
+    }
+    get collection() { return __classPrivateFieldGet(this, _FieldParameterTracks_collection, "f"); }
+    values() { return __classPrivateFieldGet(this, _FieldParameterTracks_collection, "f").adapters(); }
+    catchupAndSubscribe(listener) {
+        return __classPrivateFieldGet(this, _FieldParameterTracks_collection, "f").catchupAndSubscribe(listener);
+    }
+    subscribeAnyChange(observer) { return __classPrivateFieldGet(this, _FieldParameterTracks_regionNotifier, "f").subscribe(observer); }
+    terminate() {
+        __classPrivateFieldGet(this, _FieldParameterTracks_collection, "f").terminate();
+        __classPrivateFieldGet(this, _FieldParameterTracks_subscription, "f").terminate();
+        __classPrivateFieldGet(this, _FieldParameterTracks_subscriptions, "f").forEach(({ subscription }) => subscription.terminate());
+        __classPrivateFieldGet(this, _FieldParameterTracks_subscriptions, "f").clear();
+    }
+}
+_FieldParameterTracks_graph = new WeakMap(), _FieldParameterTracks_field = new WeakMap(), _FieldParameterTracks_regionNotifier = new WeakMap(), _FieldParameterTracks_collection = new WeakMap(), _FieldParameterTracks_subscriptions = new WeakMap(), _FieldParameterTracks_subscription = new WeakMap();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendaw/studio-adapters",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "license": "LGPL-3.0-or-later",
   "publishConfig": {
     "access": "public"
@@ -25,13 +25,13 @@
     "pregenerate-all-boxes": "npm run build -w @opendaw/studio-forge-boxes && npm run build -w @opendaw/studio-boxes"
   },
   "dependencies": {
-    "@opendaw/lib-box": "^0.0.91",
+    "@opendaw/lib-box": "^0.0.92",
     "@opendaw/lib-dsp": "^0.0.91",
-    "@opendaw/lib-fusion": "^0.0.100",
+    "@opendaw/lib-fusion": "^0.0.101",
     "@opendaw/lib-midi": "^0.0.72",
     "@opendaw/lib-runtime": "^0.0.84",
     "@opendaw/lib-std": "^0.0.83",
-    "@opendaw/studio-boxes": "^0.0.106",
+    "@opendaw/studio-boxes": "^0.0.107",
     "@opendaw/studio-enums": "^0.1.0",
     "soundfont2": "^0.5.0"
   },
@@ -39,5 +39,5 @@
     "@opendaw/eslint-config": "^0.0.28",
     "@opendaw/typescript-config": "^0.0.32"
   },
-  "gitHead": "4356bb141de31c0d27562bc9e8b310e90861ea10"
+  "gitHead": "e1495bbd78b89e262bcd72141dde0344bc328326"
 }