@drop-ai/core 0.2.0 → 0.3.1

package/dist/domain/TriggerBox.js

@@ -0,0 +1,428 @@
+import { Signal } from '../lib/Signal';
+/**
+ * TriggerBox implements Ableton-style clip/slot-based playback.
+ *
+ * A TriggerBox contains multiple slots (triggers), each holding a clip.
+ * Only one trigger per box is active at a time. Triggers can be launched
+ * quantized to musical grid positions.
+ */
+export var TriggerState;
+(function (TriggerState) {
+    TriggerState["STOPPED"] = "STOPPED";
+    TriggerState["WAITING_TO_START"] = "WAITING_TO_START";
+    TriggerState["RUNNING"] = "RUNNING";
+    TriggerState["WAITING_TO_STOP"] = "WAITING_TO_STOP";
+    TriggerState["WAITING_TO_RETRIGGER"] = "WAITING_TO_RETRIGGER";
+})(TriggerState || (TriggerState = {}));
+export var LaunchQuantize;
+(function (LaunchQuantize) {
+    LaunchQuantize["NONE"] = "NONE";
+    LaunchQuantize["BAR"] = "BAR";
+    LaunchQuantize["BEAT"] = "BEAT";
+    LaunchQuantize["HALF_BAR"] = "HALF_BAR";
+})(LaunchQuantize || (LaunchQuantize = {}));
+export var FollowAction;
+(function (FollowAction) {
+    FollowAction["NONE"] = "NONE";
+    FollowAction["AGAIN"] = "AGAIN";
+    FollowAction["NEXT"] = "NEXT";
+    FollowAction["PREV"] = "PREV";
+    FollowAction["RANDOM"] = "RANDOM";
+    FollowAction["STOP"] = "STOP";
+})(FollowAction || (FollowAction = {}));
+// Default slot colours used when none is specified
+const DEFAULT_SLOT_COLORS = [
+    '#E63946', '#457B9D', '#2A9D8F', '#E9C46A',
+    '#F4A261', '#264653', '#6A0572', '#AB83A1',
+];
+export class TriggerBox {
+    constructor(id, trackId, slotCount) {
+        this._slots = [];
+        this._activeSlotIndex = -1;
+        this._defaultSlotCount = 8;
+        // Signals
+        this.slotTriggered = new Signal();
+        this.slotStopped = new Signal();
+        this.activeSlotChanged = new Signal();
+        this.slotStateChanged = new Signal();
+        this.id = id;
+        this.trackId = trackId;
+        if (slotCount !== undefined) {
+            this._defaultSlotCount = slotCount;
+        }
+        // Initialise empty slots
+        for (let i = 0; i < this._defaultSlotCount; i++) {
+            this._slots.push(this.createEmptySlot(i));
+        }
+    }
+    // ───────────────────────── Slot management ───────────────────────────
+    getSlot(index) {
+        return this._slots[index];
+    }
+    get slots() {
+        return this._slots;
+    }
+    get slotCount() {
+        return this._slots.length;
+    }
+    get activeSlotIndex() {
+        return this._activeSlotIndex;
+    }
+    // ──────────────────────── Clip loading / clearing ─────────────────────
+    loadClip(slotIndex, sourceId, name) {
+        const slot = this._slots[slotIndex];
+        if (!slot) {
+            throw new Error(`TriggerBox: slot index ${slotIndex} out of range (0-${this._slots.length - 1})`);
+        }
+        // If this slot is currently running, stop it first
+        if (slot.state === TriggerState.RUNNING || slot.state === TriggerState.WAITING_TO_START) {
+            this.stopSlot(slotIndex);
+        }
+        slot.sourceId = sourceId;
+        slot.name = name !== null && name !== void 0 ? name : `Clip ${slotIndex + 1}`;
+        slot.playCount = 0;
+        slot.playbackPosition = 0;
+    }
+    clearSlot(slotIndex) {
+        const slot = this._slots[slotIndex];
+        if (!slot) {
+            throw new Error(`TriggerBox: slot index ${slotIndex} out of range`);
+        }
+        if (slot.state !== TriggerState.STOPPED) {
+            this.stopSlot(slotIndex);
+        }
+        slot.sourceId = null;
+        slot.name = '';
+        slot.playCount = 0;
+        slot.playbackPosition = 0;
+    }
+    // ──────────────────────── Launch / Stop ───────────────────────────────
+    launchSlot(slotIndex) {
+        const slot = this._slots[slotIndex];
+        if (!slot) {
+            throw new Error(`TriggerBox: slot index ${slotIndex} out of range`);
+        }
+        if (!slot.sourceId) {
+            return; // Nothing to play
+        }
+        // If another slot is active, set it to stop
+        if (this._activeSlotIndex >= 0 && this._activeSlotIndex !== slotIndex) {
+            const activeSlot = this._slots[this._activeSlotIndex];
+            if (activeSlot && activeSlot.state !== TriggerState.STOPPED) {
+                this.setSlotState(this._activeSlotIndex, TriggerState.WAITING_TO_STOP);
+            }
+        }
+        // If this is the same slot that is already running, mark retrigger
+        if (this._activeSlotIndex === slotIndex && slot.state === TriggerState.RUNNING) {
+            this.setSlotState(slotIndex, TriggerState.WAITING_TO_RETRIGGER);
+            return;
+        }
+        // Determine whether to launch immediately or wait for quantize
+        if (slot.launchQuantize === LaunchQuantize.NONE) {
+            this.activateSlot(slotIndex);
+        }
+        else {
+            this.setSlotState(slotIndex, TriggerState.WAITING_TO_START);
+        }
+    }
+    stopSlot(slotIndex) {
+        const slot = this._slots[slotIndex];
+        if (!slot) {
+            return;
+        }
+        if (slot.state === TriggerState.STOPPED) {
+            return;
+        }
+        if (slot.launchQuantize === LaunchQuantize.NONE) {
+            this.deactivateSlot(slotIndex);
+        }
+        else {
+            this.setSlotState(slotIndex, TriggerState.WAITING_TO_STOP);
+        }
+    }
+    stopAll() {
+        for (let i = 0; i < this._slots.length; i++) {
+            if (this._slots[i].state !== TriggerState.STOPPED) {
+                this.deactivateSlot(i);
+            }
+        }
+    }
+    // ────────────────────── Process block (real-time) ────────────────────
+    /**
+     * Called by the transport for each audio processing block.
+     * Handles state transitions (quantized launch, follow actions) and
+     * returns the playback information for the currently active clip.
+     */
+    processBlock(currentFrame, blockSize, bpm, beatsPerBar) {
+        // Default sample rate assumption (44100) — will be correct for most
+        // cases; a production version would accept sampleRate as a parameter.
+        const sampleRate = 44100;
+        // ── Handle WAITING_TO_START slots ──
+        for (let i = 0; i < this._slots.length; i++) {
+            const slot = this._slots[i];
+            if (slot.state === TriggerState.WAITING_TO_START) {
+                const quantizePoint = this.getNextQuantizePoint(currentFrame, bpm, beatsPerBar, sampleRate);
+                if (currentFrame >= quantizePoint || quantizePoint - currentFrame <= blockSize) {
+                    // Stop any previously active slot first
+                    if (this._activeSlotIndex >= 0 && this._activeSlotIndex !== i) {
+                        this.deactivateSlot(this._activeSlotIndex);
+                    }
+                    this.activateSlot(i);
+                }
+            }
+        }
+        // ── Handle WAITING_TO_STOP slots ──
+        for (let i = 0; i < this._slots.length; i++) {
+            const slot = this._slots[i];
+            if (slot.state === TriggerState.WAITING_TO_STOP) {
+                const quantizePoint = this.getNextQuantizePoint(currentFrame, bpm, beatsPerBar, sampleRate);
+                if (currentFrame >= quantizePoint || quantizePoint - currentFrame <= blockSize) {
+                    this.deactivateSlot(i);
+                }
+            }
+        }
+        // ── Handle WAITING_TO_RETRIGGER ──
+        for (let i = 0; i < this._slots.length; i++) {
+            const slot = this._slots[i];
+            if (slot.state === TriggerState.WAITING_TO_RETRIGGER) {
+                const quantizePoint = this.getNextQuantizePoint(currentFrame, bpm, beatsPerBar, sampleRate);
+                if (currentFrame >= quantizePoint || quantizePoint - currentFrame <= blockSize) {
+                    slot.playbackPosition = slot.loopStart;
+                    slot.playCount = 0;
+                    this.setSlotState(i, TriggerState.RUNNING);
+                }
+            }
+        }
+        // ── Produce playback info for the active slot ──
+        if (this._activeSlotIndex < 0) {
+            return null;
+        }
+        const activeSlot = this._slots[this._activeSlotIndex];
+        if (!activeSlot || activeSlot.state !== TriggerState.RUNNING || !activeSlot.sourceId) {
+            return null;
+        }
+        const info = {
+            sourceId: activeSlot.sourceId,
+            startInSource: activeSlot.playbackPosition,
+            blockSize,
+            gain: activeSlot.gain,
+        };
+        // Advance playback position
+        activeSlot.playbackPosition += blockSize;
+        // Check if we have reached the loop end (or clip end if loopEnd === 0)
+        const effectiveEnd = activeSlot.loopEnd > 0 ? activeSlot.loopEnd : Infinity;
+        if (activeSlot.playbackPosition >= effectiveEnd) {
+            activeSlot.playCount++;
+            activeSlot.playbackPosition = activeSlot.loopStart;
+            // Check follow action
+            if (activeSlot.followCount > 0 && activeSlot.playCount >= activeSlot.followCount) {
+                this.processFollowAction(this._activeSlotIndex);
+            }
+        }
+        return info;
+    }
+    // ──────────────────────── Quantize helpers ──────────────────────────
+    /**
+     * Calculate the next quantize boundary based on the launch quantize
+     * setting of the slot that is currently transitioning.
+     */
+    getNextQuantizePoint(currentFrame, bpm, beatsPerBar, sampleRate) {
+        if (bpm <= 0) {
+            return currentFrame; // No tempo = immediate
+        }
+        const framesPerBeat = (sampleRate * 60) / bpm;
+        const framesPerBar = framesPerBeat * beatsPerBar;
+        // Find the waiting slot to read its quantize setting
+        let quantize = LaunchQuantize.NONE;
+        for (const slot of this._slots) {
+            if (slot.state === TriggerState.WAITING_TO_START ||
+                slot.state === TriggerState.WAITING_TO_STOP ||
+                slot.state === TriggerState.WAITING_TO_RETRIGGER) {
+                quantize = slot.launchQuantize;
+                break;
+            }
+        }
+        if (quantize === LaunchQuantize.NONE) {
+            return currentFrame;
+        }
+        let gridSize;
+        switch (quantize) {
+            case LaunchQuantize.BAR:
+                gridSize = framesPerBar;
+                break;
+            case LaunchQuantize.HALF_BAR:
+                gridSize = framesPerBar / 2;
+                break;
+            case LaunchQuantize.BEAT:
+                gridSize = framesPerBeat;
+                break;
+            default:
+                return currentFrame;
+        }
+        // Next boundary = ceil(currentFrame / gridSize) * gridSize
+        const nextBoundary = Math.ceil(currentFrame / gridSize) * gridSize;
+        return nextBoundary;
+    }
+    // ──────────────────────── Follow actions ─────────────────────────────
+    processFollowAction(slotIndex) {
+        const slot = this._slots[slotIndex];
+        if (!slot) {
+            return;
+        }
+        // Probability check
+        if (slot.followProbability < 1 && Math.random() > slot.followProbability) {
+            // Follow action did not fire — reset play count and continue looping
+            slot.playCount = 0;
+            return;
+        }
+        switch (slot.followAction) {
+            case FollowAction.NONE:
+                this.deactivateSlot(slotIndex);
+                break;
+            case FollowAction.AGAIN:
+                slot.playbackPosition = slot.loopStart;
+                slot.playCount = 0;
+                break;
+            case FollowAction.NEXT: {
+                const next = this.findNextLoadedSlot(slotIndex, 1);
+                if (next >= 0) {
+                    this.deactivateSlot(slotIndex);
+                    this.activateSlot(next);
+                }
+                else {
+                    this.deactivateSlot(slotIndex);
+                }
+                break;
+            }
+            case FollowAction.PREV: {
+                const prev = this.findNextLoadedSlot(slotIndex, -1);
+                if (prev >= 0) {
+                    this.deactivateSlot(slotIndex);
+                    this.activateSlot(prev);
+                }
+                else {
+                    this.deactivateSlot(slotIndex);
+                }
+                break;
+            }
+            case FollowAction.RANDOM: {
+                const loaded = this._slots
+                    .map((s, i) => (s.sourceId && i !== slotIndex ? i : -1))
+                    .filter(i => i >= 0);
+                if (loaded.length > 0) {
+                    const randomIndex = loaded[Math.floor(Math.random() * loaded.length)];
+                    this.deactivateSlot(slotIndex);
+                    this.activateSlot(randomIndex);
+                }
+                else {
+                    this.deactivateSlot(slotIndex);
+                }
+                break;
+            }
+            case FollowAction.STOP:
+                this.stopAll();
+                break;
+        }
+    }
+    // ──────────────────────── Serialization ──────────────────────────────
+    toJSON() {
+        return {
+            id: this.id,
+            trackId: this.trackId,
+            slots: this._slots.map(slot => ({
+                name: slot.name,
+                sourceId: slot.sourceId,
+                gain: slot.gain,
+                color: slot.color,
+                launchQuantize: slot.launchQuantize,
+                followAction: slot.followAction,
+                followCount: slot.followCount,
+                followProbability: slot.followProbability,
+            })),
+        };
+    }
+    static fromJSON(data) {
+        const box = new TriggerBox(data.id, data.trackId, data.slots.length);
+        data.slots.forEach((slotData, i) => {
+            const slot = box._slots[i];
+            if (!slot)
+                return;
+            slot.name = slotData.name;
+            slot.sourceId = slotData.sourceId;
+            slot.gain = slotData.gain;
+            slot.color = slotData.color;
+            slot.launchQuantize = slotData.launchQuantize;
+            slot.followAction = slotData.followAction;
+            slot.followCount = slotData.followCount;
+            slot.followProbability = slotData.followProbability;
+        });
+        return box;
+    }
+    // ──────────────────────── Private helpers ────────────────────────────
+    createEmptySlot(index) {
+        return {
+            id: `${this.id}-slot-${index}`,
+            index,
+            name: '',
+            sourceId: null,
+            state: TriggerState.STOPPED,
+            gain: 1.0,
+            color: DEFAULT_SLOT_COLORS[index % DEFAULT_SLOT_COLORS.length],
+            launchQuantize: LaunchQuantize.BAR,
+            followAction: FollowAction.AGAIN,
+            followCount: 0,
+            followProbability: 1.0,
+            stretchMode: 'timestretch',
+            loopStart: 0,
+            loopEnd: 0,
+            playCount: 0,
+            playbackPosition: 0,
+        };
+    }
+    activateSlot(index) {
+        const slot = this._slots[index];
+        if (!slot || !slot.sourceId)
+            return;
+        slot.playbackPosition = slot.loopStart;
+        slot.playCount = 0;
+        this.setSlotState(index, TriggerState.RUNNING);
+        this._activeSlotIndex = index;
+        this.activeSlotChanged.emit(index);
+        this.slotTriggered.emit({ index, slot });
+    }
+    deactivateSlot(index) {
+        const slot = this._slots[index];
+        if (!slot)
+            return;
+        this.setSlotState(index, TriggerState.STOPPED);
+        slot.playbackPosition = 0;
+        slot.playCount = 0;
+        if (this._activeSlotIndex === index) {
+            this._activeSlotIndex = -1;
+            this.activeSlotChanged.emit(-1);
+        }
+        this.slotStopped.emit({ index });
+    }
+    setSlotState(index, state) {
+        const slot = this._slots[index];
+        if (!slot)
+            return;
+        slot.state = state;
+        this.slotStateChanged.emit({ index, state });
+    }
+    /**
+     * Find the next slot (in the given direction) that has a loaded clip.
+     * Wraps around the slot list.
+     */
+    findNextLoadedSlot(fromIndex, direction) {
+        const count = this._slots.length;
+        for (let offset = 1; offset < count; offset++) {
+            const candidate = ((fromIndex + direction * offset) % count + count) % count;
+            if (this._slots[candidate].sourceId) {
+                return candidate;
+            }
+        }
+        return -1;
+    }
+}
+//# sourceMappingURL=TriggerBox.js.map

package/dist/domain/TriggerBox.js.map

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

package/dist/domain/VCATrack.d.ts

@@ -1,21 +1,30 @@
 import { Signal } from '../lib/Signal';
 import { TrackId } from './types';
+import { Track } from './Track';
 /**
  * VCA (Voltage Controlled Amplifier) Track
- * Ardour 참조: libs/ardour/vca.cc
- *
  * Virtual fader that controls multiple assigned tracks.
  * Adjusting the VCA fader changes gain on all slave tracks
  * while maintaining their relative volume differences.
+ *
+ * VCA master logic includes:
+ * - Proportional gain application to slave tracks
+ * - Mute/solo propagation to slave tracks
+ * - Automation enable/disable
  */
 export declare class VCATrack {
     readonly id: string;
     name: string;
     private _gain;
     private _slaveTrackIds;
+    private _muted;
+    private _soloed;
+    private _automationEnabled;
     readonly gainChanged: Signal<number>;
     readonly slaveAdded: Signal<string>;
     readonly slaveRemoved: Signal<string>;
+    readonly muteChanged: Signal<boolean>;
+    readonly soloChanged: Signal<boolean>;
     constructor(id: string, name: string);
     get gain(): number;
     /**
@@ -36,6 +45,55 @@ export declare class VCATrack {
     hasSlave(trackId: TrackId): boolean;
     get slaveTrackIds(): ReadonlyArray<TrackId>;
     get slaveCount(): number;
+    /**
+     * Apply the current VCA gain as a delta to all slave tracks.
+     *
+     * Each slave track's fader volume is multiplied by the VCA's current
+     * linear gain. This preserves relative volume differences between
+     * slave tracks while allowing group-level control.
+     *
+     * @param getTrack Function to look up a Track by its ID.
+     * @returns Map of trackId -> the gain delta that was applied.
+     */
+    applyGainToSlaves(getTrack: (id: TrackId) => Track | undefined): Map<TrackId, number>;
+    /**
+     * Set the VCA mute state.
+     * When a VCA is muted, all slave tracks are considered muted
+     * regardless of their individual mute state.
+     */
+    setMuted(muted: boolean): void;
+    get muted(): boolean;
+    /**
+     * Set the VCA solo state.
+     * When a VCA is soloed, all slave tracks are treated as soloed.
+     */
+    setSoloed(soloed: boolean): void;
+    get soloed(): boolean;
+    /**
+     * Check if a slave should be audible considering VCA state.
+     *
+     * A slave is NOT audible if:
+     * - The VCA is muted (overrides individual track state)
+     * - The slave is not actually assigned to this VCA
+     *
+     * A slave IS audible if:
+     * - The VCA is not muted, or
+     * - The VCA is soloed (solo overrides mute for slaves)
+     *
+     * @param trackId The slave track ID to check.
+     * @returns true if the slave should produce audio.
+     */
+    isSlaveAudible(trackId: TrackId): boolean;
+    /**
+     * Remove all slave tracks from this VCA.
+     */
+    clearSlaves(): void;
+    /**
+     * Enable or disable automation playback for this VCA.
+     * When enabled, the VCA gain may be driven by an automation lane.
+     */
+    setAutomationEnabled(enabled: boolean): void;
+    get automationEnabled(): boolean;
     toJSON(): VCATrackSnapshot;
     static fromJSON(data: VCATrackSnapshot): VCATrack;
 }
@@ -44,5 +102,8 @@ export interface VCATrackSnapshot {
     name: string;
     gain: number;
     slaveTrackIds: string[];
+    muted?: boolean;
+    soloed?: boolean;
+    automationEnabled?: boolean;
 }
 //# sourceMappingURL=VCATrack.d.ts.map

package/dist/domain/VCATrack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VCATrack.d.ts","sourceRoot":"","sources":["../../src/domain/VCATrack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACjB,SAAgB,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,cAAc,CAA2B;IAEjD,SAAgB,WAAW,iBAAwB;IACnD,SAAgB,UAAU,iBAAyB;IACnD,SAAgB,YAAY,iBAAyB;gBAEzC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAKpC,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASpC;;OAEG;IACI,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACI,SAAS,IAAI,MAAM;IAInB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOhC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAI1C,IAAW,aAAa,IAAI,aAAa,CAAC,OAAO,CAAC,CAEjD;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAEM,MAAM,IAAI,gBAAgB;WASnB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,QAAQ;CAQ3D;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;CAC3B"}
+{"version":3,"file":"VCATrack.d.ts","sourceRoot":"","sources":["../../src/domain/VCATrack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACjB,SAAgB,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,cAAc,CAA2B;IAGjD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAkB;IAGjC,OAAO,CAAC,kBAAkB,CAAkB;IAE5C,SAAgB,WAAW,iBAAwB;IACnD,SAAgB,UAAU,iBAAyB;IACnD,SAAgB,YAAY,iBAAyB;IACrD,SAAgB,WAAW,kBAAyB;IACpD,SAAgB,WAAW,kBAAyB;gBAExC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAKpC,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASpC;;OAEG;IACI,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACI,SAAS,IAAI,MAAM;IAInB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOhC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAI1C,IAAW,aAAa,IAAI,aAAa,CAAC,OAAO,CAAC,CAEjD;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAID;;;;;;;;;OASG;IACI,iBAAiB,CACpB,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,KAAK,GAAG,SAAS,GAC7C,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;IAwBvB;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOrC,IAAW,KAAK,IAAI,OAAO,CAE1B;IAED;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAOvC,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;;;;;;;;;;;;OAaG;IACI,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAmBhD;;OAEG;IACI,WAAW,IAAI,IAAI;IAU1B;;;OAGG;IACI,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInD,IAAW,iBAAiB,IAAI,OAAO,CAEtC;IAIM,MAAM,IAAI,gBAAgB;WAYnB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,QAAQ;CAW3D;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B"}