@opendaw/studio-adapters 0.3.0 → 0.3.2

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,EAEpB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAM,KAAK,EAAe,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAiB,IAAI,EAAgC,SAAS,EAAO,MAAM,kBAAkB,CAAA;AACpG,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,YAyB1F,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,110 @@
+import { LfoModulatorBox, MacroModulatorBox, ModulationBox, RandomModulatorBox, StepsModulatorBox, TrackBox } from "@opendaw/studio-boxes";
+import { ByteArrayInput, isInstanceOf, 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));
+        // An assignment's depth lane is parented to its SOURCE, so it would die with the old box while the
+        // assignment it belongs to survives. The old kind's own parameter lanes have no meaning in the new
+        // kind and are left to the cascade.
+        modulator.tracks.pointerHub.incoming().slice()
+            .map((pointer) => pointer.box)
+            .filter((box) => isInstanceOf(box, TrackBox))
+            .filter((track) => track.target.targetVertex
+            .mapOr(vertex => isInstanceOf(vertex.box, ModulationBox), false))
+            .forEach((track) => track.tracks.refer(replacement.tracks));
+        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,22 @@
+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 rateSync: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateAbsolute: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly phase: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly smooth: 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;CA6BjB"}

package/dist/modulation/RandomModulatorBoxAdapter.js

@@ -0,0 +1,60 @@
+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, _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() * RandomModulatorBoxAdapter.MaxSeed)); }
+}
+_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 {
+        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")
+    };
+};
+RandomModulatorBoxAdapter.MaxLoop = 64;
+RandomModulatorBoxAdapter.MaxLevels = 32;
+RandomModulatorBoxAdapter.MaxSeed = 999999;

package/dist/modulation/StepsModulatorBoxAdapter.d.ts

@@ -0,0 +1,40 @@
+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 rateSync: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly rateAbsolute: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly phase: import("..").AutomatableParameterFieldAdapter<number>;
+        readonly smooth: 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,CAerC;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;CA2B5B"}

package/dist/modulation/StepsModulatorBoxAdapter.js

@@ -0,0 +1,99 @@
+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 }];
+            // Random reorders per cycle, so there is no one pass to draw: the display shows a forward one.
+            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 {
+        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")
+    };
+};
+StepsModulatorBoxAdapter.MaxSteps = 64;
+StepsModulatorBoxAdapter.DirectionStrings = ["Forward", "Backward", "Ping-Pong", "Alternate", "Random"];

package/dist/protocols.d.ts

@@ -20,6 +20,8 @@ export interface EngineCommands extends Terminable {
     noteSignal(signal: NoteSignal): void;
     /** @internal */
     ignoreNoteRegion(uuid: UUID.Bytes): void;
+    /** @internal */
+    suspendAutomation(uuid: UUID.Bytes): void;
     scheduleClipPlay(clipIds: ReadonlyArray<UUID.Bytes>): void;
     scheduleClipStop(trackIds: ReadonlyArray<UUID.Bytes>): void;
     /** @internal */

package/dist/protocols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocols.d.ts","sourceRoot":"","sources":["../src/protocols.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAC,SAAS,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAE1C,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;CAAE,CAAA;AAEnF,MAAM,WAAW,cAAe,SAAQ,UAAU;IAC9C,IAAI,IAAI,IAAI,CAAA;IACZ,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACjC,gBAAgB;IAChB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7C,gBAAgB;IAChB,aAAa,IAAI,IAAI,CAAA;IACrB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAExC,KAAK,IAAI,IAAI,CAAA;IACb,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IACpC,gBAAgB;IAChB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACxC,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAC1D,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAC3D,gBAAgB;IAChB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC7D,cAAc,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IACnD,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IACtE,gBAAgB;IAChB,mBAAmB,CAAC,GAAG,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAA;CACpE;AAED,MAAM,WAAW,cAAc;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAClD,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAChD,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACrD,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IACpC,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAC/D,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAA;IAC3D,KAAK,IAAI,IAAI,CAAA;CAChB"}
+{"version":3,"file":"protocols.d.ts","sourceRoot":"","sources":["../src/protocols.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAC,SAAS,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAE1C,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;CAAE,CAAA;AAEnF,MAAM,WAAW,cAAe,SAAQ,UAAU;IAC9C,IAAI,IAAI,IAAI,CAAA;IACZ,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACjC,gBAAgB;IAChB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7C,gBAAgB;IAChB,aAAa,IAAI,IAAI,CAAA;IACrB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAExC,KAAK,IAAI,IAAI,CAAA;IACb,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IACpC,gBAAgB;IAChB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACxC,gBAAgB;IAChB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACzC,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAC1D,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAC3D,gBAAgB;IAChB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC7D,cAAc,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IACnD,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IACtE,gBAAgB;IAChB,mBAAmB,CAAC,GAAG,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAA;CACpE;AAED,MAAM,WAAW,cAAc;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAClD,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAChD,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACrD,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IACpC,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAC/D,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAA;IAC3D,KAAK,IAAI,IAAI,CAAA;CAChB"}

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();