@drop-ai/core 0.2.0 → 0.3.0

package/dist/audio/engine/Declick.js

@@ -0,0 +1,204 @@
+/**
+ * Declick (DeclickAmp) - Provides smooth amplitude transitions
+ * to avoid clicks/pops at record start/stop and region boundaries.
+ * Inspired by Ardour's DeclickAmp.
+ */
+export class DeclickAmp {
+    /**
+     * @param sampleRate - The audio sample rate (e.g. 44100, 48000)
+     * @param rampLengthMs - Duration of a full 0->1 or 1->0 ramp in ms. Defaults to ~1.5ms (~64 samples at 44100).
+     */
+    constructor(sampleRate, rampLengthMs) {
+        this._targetGain = 1.0;
+        this._currentGain = 0.0;
+        this._sampleRate = sampleRate;
+        const ms = rampLengthMs !== null && rampLengthMs !== void 0 ? rampLengthMs : 1.5;
+        this._rampLength = Math.max(1, Math.round((ms / 1000) * sampleRate));
+        this._rampIncrement = 1.0 / this._rampLength;
+    }
+    /**
+     * Set target gain (0 for fade out, 1 for fade in).
+     */
+    setTarget(gain) {
+        this._targetGain = Math.max(0, Math.min(1, gain));
+    }
+    /**
+     * Apply declick ramp to a buffer in-place.
+     * Uses linear ramping from _currentGain toward _targetGain.
+     * @returns true if ramp is still in progress after processing
+     */
+    applyToBuffer(buffer, offset, count) {
+        const end = offset + count;
+        const target = this._targetGain;
+        let current = this._currentGain;
+        const inc = this._rampIncrement;
+        if (current === target) {
+            // Already at target — apply constant gain
+            if (target !== 1.0) {
+                for (let i = offset; i < end; i++) {
+                    buffer[i] *= target;
+                }
+            }
+            return false;
+        }
+        const goingUp = target > current;
+        for (let i = offset; i < end; i++) {
+            buffer[i] *= current;
+            if (goingUp) {
+                current = Math.min(current + inc, target);
+            }
+            else {
+                current = Math.max(current - inc, target);
+            }
+        }
+        this._currentGain = current;
+        return current !== target;
+    }
+    /**
+     * Apply declick ramp to multi-channel buffers in-place.
+     * All channels share the same gain trajectory.
+     * @returns true if ramp is still in progress after processing
+     */
+    applyToBuffers(buffers, offset, count) {
+        const end = offset + count;
+        const target = this._targetGain;
+        let current = this._currentGain;
+        const inc = this._rampIncrement;
+        const numChannels = buffers.length;
+        if (current === target) {
+            // Already at target — apply constant gain
+            if (target !== 1.0) {
+                for (let ch = 0; ch < numChannels; ch++) {
+                    const buf = buffers[ch];
+                    for (let i = offset; i < end; i++) {
+                        buf[i] *= target;
+                    }
+                }
+            }
+            return false;
+        }
+        const goingUp = target > current;
+        for (let i = offset; i < end; i++) {
+            for (let ch = 0; ch < numChannels; ch++) {
+                buffers[ch][i] *= current;
+            }
+            if (goingUp) {
+                current = Math.min(current + inc, target);
+            }
+            else {
+                current = Math.max(current - inc, target);
+            }
+        }
+        this._currentGain = current;
+        return current !== target;
+    }
+    /**
+     * Check if currently ramping (current gain has not yet reached target).
+     */
+    isRamping() {
+        return this._currentGain !== this._targetGain;
+    }
+    /**
+     * Reset to initial state.
+     * @param initialGain - Starting gain value (default 0.0)
+     */
+    reset(initialGain) {
+        this._currentGain = initialGain !== null && initialGain !== void 0 ? initialGain : 0.0;
+        this._targetGain = 1.0;
+    }
+    /**
+     * Get current gain value.
+     */
+    getCurrentGain() {
+        return this._currentGain;
+    }
+}
+/**
+ * Declicker - Provides crossfade curves for loop boundaries.
+ * Used to create smooth transitions at loop points.
+ * Uses raised cosine (Hann) curves for perceptually smooth fades.
+ */
+export class Declicker {
+    /**
+     * @param lengthSamples - Number of samples for the fade region
+     */
+    constructor(lengthSamples) {
+        this._length = Math.max(1, lengthSamples);
+        this._fadeIn = new Float32Array(this._length);
+        this._fadeOut = new Float32Array(this._length);
+        this.computeCurves();
+    }
+    /**
+     * Pre-compute fade curves using a raised cosine (Hann window).
+     * fade_in[i]  = 0.5 * (1 - cos(pi * i / (N-1)))
+     * fade_out[i] = 0.5 * (1 + cos(pi * i / (N-1)))
+     * This ensures fade_in + fade_out = 1.0 at every sample (constant power crossfade).
+     */
+    computeCurves() {
+        const N = this._length;
+        if (N === 1) {
+            this._fadeIn[0] = 1.0;
+            this._fadeOut[0] = 1.0;
+            return;
+        }
+        const divisor = N - 1;
+        for (let i = 0; i < N; i++) {
+            const cosVal = Math.cos(Math.PI * i / divisor);
+            this._fadeIn[i] = 0.5 * (1 - cosVal);
+            this._fadeOut[i] = 0.5 * (1 + cosVal);
+        }
+    }
+    /**
+     * Apply fade-in curve to the start of a buffer.
+     * @param buffer - The audio buffer to modify in-place
+     * @param offset - Optional offset into the buffer (default 0)
+     */
+    applyFadeIn(buffer, offset = 0) {
+        const len = Math.min(this._length, buffer.length - offset);
+        for (let i = 0; i < len; i++) {
+            buffer[offset + i] *= this._fadeIn[i];
+        }
+    }
+    /**
+     * Apply fade-out curve to the end of a buffer.
+     * @param offset - Optional: the sample index where the fade-out begins.
+     *                 Defaults to buffer.length - fadeLength.
+     */
+    applyFadeOut(buffer, offset) {
+        const start = offset !== null && offset !== void 0 ? offset : (buffer.length - this._length);
+        const len = Math.min(this._length, buffer.length - Math.max(0, start));
+        for (let i = 0; i < len; i++) {
+            buffer[Math.max(0, start) + i] *= this._fadeOut[i];
+        }
+    }
+    /**
+     * Apply crossfade between two buffers, writing result into output.
+     * output[i] = outgoing[i] * fadeOut[i] + incoming[i] * fadeIn[i]
+     * All three buffers must be at least _length samples long.
+     */
+    applyCrossfade(outgoing, incoming, output) {
+        const len = Math.min(this._length, outgoing.length, incoming.length, output.length);
+        for (let i = 0; i < len; i++) {
+            output[i] = outgoing[i] * this._fadeOut[i] + incoming[i] * this._fadeIn[i];
+        }
+    }
+    /**
+     * Get the pre-computed fade-in curve.
+     */
+    getFadeIn() {
+        return this._fadeIn;
+    }
+    /**
+     * Get the pre-computed fade-out curve.
+     */
+    getFadeOut() {
+        return this._fadeOut;
+    }
+    /**
+     * Get the length of the fade region in samples.
+     */
+    getLength() {
+        return this._length;
+    }
+}
+//# sourceMappingURL=Declick.js.map

package/dist/audio/engine/Declick.js.map

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

package/dist/audio/engine/DiskIO.d.ts

@@ -0,0 +1,172 @@
+import { XrunTracker } from './XrunTracker';
+/**
+ * Minimal interface for audio buffer sources used by DiskReader.
+ * Compatible with Web Audio API's AudioBuffer.
+ */
+export interface AudioBufferLike {
+    numberOfChannels: number;
+    length: number;
+    sampleRate: number;
+    getChannelData(channel: number): Float32Array;
+}
+/**
+ * DiskReader - Manages buffered playback I/O.
+ * Provides chunk-based reading with loop handling.
+ * Inspired by Ardour's DiskReader.
+ */
+export declare class DiskReader {
+    private _chunkSize;
+    private _buffer;
+    private _readPosition;
+    private _writeOffset;
+    private _channelCount;
+    private _loopStart;
+    private _loopEnd;
+    private _declicker;
+    /**
+     * @param channelCount - Number of audio channels (e.g. 2 for stereo)
+     * @param chunkSize - Size of the internal playback buffer per channel (default 64k)
+     */
+    constructor(channelCount: number, chunkSize?: number);
+    /**
+     * Set loop boundaries for loop playback.
+     * When reading reaches loopEnd, it wraps back to loopStart.
+     * Optionally enables a declicker for smooth loop transitions.
+     * @param start - Loop start frame (in source coordinates)
+     * @param end - Loop end frame (in source coordinates)
+     */
+    setLoop(start: number, end: number): void;
+    /**
+     * Remove loop boundaries.
+     */
+    clearLoop(): void;
+    /**
+     * Fill the internal buffer from a source starting at the given frame.
+     * Handles loop wrapping if a loop is set.
+     * @param source - The audio buffer source to read from
+     * @param startFrame - The frame position in the source to start reading from
+     * @returns The number of frames actually read
+     */
+    refill(source: AudioBufferLike, startFrame: number): Promise<number>;
+    /**
+     * Read samples from the internal buffer into output arrays.
+     * @param output - Per-channel output arrays to write into
+     * @param offset - Offset into the output arrays
+     * @param count - Number of frames to read
+     * @returns Number of frames actually read
+     */
+    read(output: Float32Array[], offset: number, count: number): number;
+    /**
+     * Seek to a specific frame position within the buffer.
+     * Note: This only adjusts the internal read pointer; you may need to refill().
+     */
+    seek(frame: number): void;
+    /**
+     * Get current read position within the internal buffer.
+     */
+    getPosition(): number;
+    /**
+     * Check if the internal buffer needs a refill (more than half consumed).
+     */
+    needsRefill(): boolean;
+    /**
+     * Get the percentage of the buffer that still contains unread data.
+     * Useful for monitoring playback buffer health.
+     */
+    getBufferLoadPercent(): number;
+}
+/**
+ * DiskWriter - Manages buffered recording I/O.
+ * Captures audio with alignment and xrun tracking.
+ * Inspired by Ardour's DiskWriter.
+ */
+export declare class DiskWriter {
+    private _buffer;
+    private _bufferSize;
+    private _writePosition;
+    private _captureStart;
+    private _captureEnd;
+    private _channelCount;
+    private _isRecording;
+    private _xrunTracker;
+    private _declickAmp;
+    private _peakBuffer;
+    private _peakWritePos;
+    private _alignmentStyle;
+    /** Initial capture buffer size: 10 minutes at 48kHz stereo */
+    private static readonly INITIAL_BUFFER_FRAMES;
+    /**
+     * @param channelCount - Number of audio channels
+     * @param sampleRate - Audio sample rate (for DeclickAmp ramp calculation)
+     * @param xrunTracker - Shared xrun tracker instance
+     */
+    constructor(channelCount: number, sampleRate: number, xrunTracker: XrunTracker);
+    /**
+     * Prepare for recording. Resets buffers and sets the capture start frame.
+     * @param startFrame - The session frame at which recording will begin
+     */
+    prepareRecord(startFrame: number): void;
+    /**
+     * Start recording. Activates capture and begins the fade-in ramp.
+     */
+    startRecord(): void;
+    /**
+     * Stop recording. Begins fade-out ramp and marks the capture end.
+     * @returns The capture end frame in session coordinates
+     */
+    stopRecord(): number;
+    /**
+     * Write incoming audio samples to the capture buffer.
+     * Applies declick ramp and tracks peak data for GUI.
+     * Reports an xrun if the buffer overflows.
+     * @param input - Per-channel input arrays
+     * @param offset - Offset into the input arrays
+     * @param count - Number of frames to write
+     */
+    write(input: Float32Array[], offset: number, count: number): void;
+    /**
+     * Get the captured audio as trimmed Float32Arrays (one per channel).
+     */
+    getCapturedAudio(): Float32Array[];
+    /**
+     * Get the capture range in session frame coordinates.
+     */
+    getCaptureRange(): {
+        start: number;
+        end: number;
+    };
+    /**
+     * Get peak data for GUI real-time visualization during recording.
+     * Returns per-channel arrays of peak values.
+     */
+    getPeakData(): Float32Array[];
+    /**
+     * Reset peak data (e.g. when the GUI display scrolls).
+     */
+    resetPeakData(): void;
+    /**
+     * Set the alignment style for the captured recording.
+     * - 'existing_material': Align to existing material on the track (snap to beat/region boundaries)
+     * - 'capture_time': Align to the exact time the audio was captured (default)
+     */
+    setAlignment(style: 'existing_material' | 'capture_time'): void;
+    /**
+     * Check if currently recording.
+     */
+    isRecording(): boolean;
+    /**
+     * Get the number of frames captured so far.
+     */
+    getCapturedFrames(): number;
+    /**
+     * Grow the capture buffer by doubling its size.
+     */
+    private _growBuffer;
+    /**
+     * Update the peak buffer with the maximum absolute sample values
+     * from the most recently written segment. Each peak entry represents
+     * a chunk of recorded samples, downsampled for efficient GUI rendering.
+     */
+    private _updatePeaks;
+}
+//# sourceMappingURL=DiskIO.d.ts.map

package/dist/audio/engine/DiskIO.d.ts.map

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