@drop-ai/core 0.2.0 → 0.3.0

package/dist/processing/MeterDSP.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Professional metering DSP algorithms implementing broadcast standards.
+ * Inspired by Ardour's meter.h and industry standard implementations.
+ *
+ * Supported meter types:
+ *   - Peak (simple sample-peak detection)
+ *   - IEC 60268-10 Type I (DIN, Nordic)
+ *   - IEC 60268-10 Type II (BBC PPM, EBU)
+ *   - K-system (K-12, K-14, K-20)
+ *   - VU (300ms RMS integration)
+ *   - LUFS / EBU R128 (momentary, short-term, integrated, loudness range)
+ *   - ITU-R BS.1770 true peak (4x oversampling)
+ */
+export declare enum MeterType {
+    PEAK = "peak",
+    IEC1_DIN = "iec1_din",
+    IEC1_NORDIC = "iec1_nordic",
+    IEC2_BBC = "iec2_bbc",
+    IEC2_EBU = "iec2_ebu",
+    K_12 = "k12",
+    K_14 = "k14",
+    K_20 = "k20",
+    VU = "vu",
+    LUFS = "lufs",
+    TRUE_PEAK = "true_peak"
+}
+export interface MeterReading {
+    peak: number;
+    rms: number;
+    peakHold: number;
+    overCount: number;
+}
+export interface LUFSReading {
+    momentary: number;
+    shortTerm: number;
+    integrated: number;
+    range: number;
+    truePeak: number;
+}
+export declare class MeterDSP {
+    private _type;
+    private _sampleRate;
+    private _channelCount;
+    private _peaks;
+    private _rms;
+    private _peakHold;
+    private _peakHoldDecay;
+    private _peakHoldTime;
+    private _peakHoldCounter;
+    private _overCount;
+    private _iecIntegrator;
+    private _vuIntegrator;
+    private _kShelfCoeffs;
+    private _kHPCoeffs;
+    private _kWeightingState;
+    private _kShelfStates;
+    private _kHPStates;
+    private _momentaryBuffer;
+    private _shortTermBuffer;
+    private _momentaryLen;
+    private _shortTermLen;
+    private _blockSize100ms;
+    private _lufsBlockAccum;
+    private _lufsBlockSampleCount;
+    private _momentaryWriteIdx;
+    private _shortTermWriteIdx;
+    private _momentaryFilled;
+    private _shortTermFilled;
+    private _integratedSum;
+    private _integratedCount;
+    private _gatingBlocks;
+    private _truePeakMax;
+    private _tpHistory;
+    constructor(type: MeterType, sampleRate: number, channelCount?: number);
+    private _initKWeighting;
+    /**
+     * Compute a single-pole IIR coefficient from an integration time.
+     * coeff = exp(-2.2 / (time * sampleRate))
+     *
+     * A coefficient of ~1 means very slow response (long integration);
+     * a coefficient close to 0 means instantaneous tracking.
+     */
+    private _iecCoeff;
+    /**
+     * Return rise and fall coefficients for the current IEC type.
+     */
+    private _getIecCoeffs;
+    /**
+     * Process a single channel of audio samples.
+     */
+    process(samples: Float32Array, channel: number): void;
+    /**
+     * Process a multi-channel block at once.
+     * buffer[ch] must contain at least blockSize samples.
+     */
+    processBlock(buffer: Float32Array[], blockSize: number): void;
+    /**
+     * Accumulate K-weighted power for one channel into the 100ms block
+     * accumulator. When a full 100ms block is completed, push it into
+     * the momentary and short-term ring buffers and perform gating.
+     */
+    private _processLufsChannel;
+    /**
+     * Commit a completed 100ms block into the ring buffers and perform gating.
+     */
+    private _commitLufsBlock;
+    /**
+     * ITU-R BS.1770 channel weighting.
+     * Front channels = 1.0, surround channels (index >= 3) = 1.41 (~+1.5 dB).
+     * For stereo (2 channels) everything is 1.0.
+     */
+    private _channelWeight;
+    private _processTruePeak;
+    getReading(channel: number): MeterReading;
+    getLUFSReading(): LUFSReading;
+    getAllChannelReadings(): MeterReading[];
+    /**
+     * Compute the loudness of a sliding window from ring-buffer data.
+     */
+    private _computeLufsWindow;
+    /**
+     * ITU-R BS.1770-4 gated integrated loudness.
+     * 1. Absolute gate at -70 LUFS
+     * 2. Relative gate at -10 LU below the absolute-gated mean
+     */
+    private _computeIntegratedLoudness;
+    /**
+     * EBU R128 Loudness Range (LRA).
+     * Computed as the difference between the 95th and 10th percentiles
+     * of the short-term loudness distribution (after gating).
+     */
+    private _computeLoudnessRange;
+    reset(): void;
+    resetPeakHold(): void;
+    setType(type: MeterType): void;
+    setPeakHoldTime(seconds: number): void;
+    setPeakHoldDecay(dbPerSecond: number): void;
+    /**
+     * Returns the reference level offset (in dB) for the current K-type.
+     * K-12 => -12, K-14 => -14, K-20 => -20.
+     * Non-K types return 0.
+     */
+    getKReference(): number;
+    static linearToDb(linear: number): number;
+    static dbToLinear(db: number): number;
+    /**
+     * IEC 60268-10 scale mapping: converts a dB value to a 0-1 range
+     * suitable for drawing meter graphics.
+     *
+     * The piecewise curve is defined by the standard breakpoints:
+     *   -70 dB = 0.0
+     *   -60 dB = 0.05
+     *   -50 dB = 0.075
+     *   -40 dB = 0.15
+     *   -30 dB = 0.3
+     *   -20 dB = 0.5
+     *   -10 dB = 0.75
+     *    -5 dB = 0.875
+     *     0 dB = 1.0
+     *
+     * The meterType parameter is accepted for future per-type customisation
+     * but currently all IEC types share the same display curve.
+     */
+    static iecScale(dbValue: number, _meterType: MeterType): number;
+}
+//# sourceMappingURL=MeterDSP.d.ts.map

package/dist/processing/MeterDSP.d.ts.map

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