audio-ml 1.0.0

package/dist/analysis/SpectralCentroidAnalyzer.js

@@ -0,0 +1,44 @@
+/**
+ * SpectralCentroidAnalyzer computes the spectral centroid of a PCM audio frame.
+ * The spectral centroid is the "center of mass" of the spectrum and is related to the perceived brightness of a sound.
+ * Usage: const sc = new SpectralCentroidAnalyzer({ sampleRate: 16000 }); sc.analyzeFrame(pcm)
+ */
+import FFT from 'fft.js';
+export class SpectralCentroidAnalyzer {
+    fft;
+    fftSize;
+    sampleRate;
+    /**
+     * @param config - Configuration with sample rate and optional FFT size
+     */
+    constructor(config) {
+        this.fftSize = config.fftSize || 1024;
+        this.fft = new FFT(this.fftSize);
+        this.sampleRate = config.sampleRate;
+    }
+    /**
+     * Compute the spectral centroid for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Spectral centroid in Hz
+     */
+    analyzeFrame(pcm) {
+        const spectrum = this.fft.createComplexArray();
+        this.fft.realTransform(spectrum, pcm);
+        this.fft.completeSpectrum(spectrum);
+        let mags = [];
+        for (let i = 0; i < this.fftSize / 2; i++) {
+            const re = spectrum[2 * i];
+            const im = spectrum[2 * i + 1];
+            mags.push(Math.sqrt(re * re + im * im));
+        }
+        let num = 0, denom = 0;
+        for (let i = 0; i < mags.length; i++) {
+            num += i * mags[i];
+            denom += mags[i];
+        }
+        if (denom === 0)
+            return 0;
+        return (num / denom) * (this.sampleRate / 2) / mags.length;
+    }
+}
+//# sourceMappingURL=SpectralCentroidAnalyzer.js.map

package/dist/analysis/SpectralCentroidAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpectralCentroidAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/SpectralCentroidAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,GAAG,MAAM,QAAQ,CAAC;AASzB,MAAM,OAAO,wBAAwB;IAC3B,GAAG,CAAM;IACT,OAAO,CAAS;IAChB,UAAU,CAAS;IAC3B;;OAEG;IACH,YAAY,MAA8B;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACtC,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAC,GAAiB;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IAC7D,CAAC;CACF"}

package/dist/analysis/SpectralFlatnessAnalyzer.d.ts

@@ -0,0 +1,21 @@
+export interface SpectralFlatnessConfig {
+    /** Sample rate of the audio (Hz) */
+    sampleRate: number;
+    /** FFT size (default: 1024) */
+    fftSize?: number;
+}
+export declare class SpectralFlatnessAnalyzer {
+    private fft;
+    private fftSize;
+    /**
+     * @param config - Configuration with sample rate and optional FFT size
+     */
+    constructor(config: SpectralFlatnessConfig);
+    /**
+     * Compute the spectral flatness for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Spectral flatness (0 = tone, 1 = noise)
+     */
+    analyzeFrame(pcm: Float32Array): number;
+}
+//# sourceMappingURL=SpectralFlatnessAnalyzer.d.ts.map

package/dist/analysis/SpectralFlatnessAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpectralFlatnessAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/SpectralFlatnessAnalyzer.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB;;OAEG;gBACS,MAAM,EAAE,sBAAsB;IAI1C;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;CAcxC"}

package/dist/analysis/SpectralFlatnessAnalyzer.js

@@ -0,0 +1,37 @@
+/**
+ * SpectralFlatnessAnalyzer computes the spectral flatness of a PCM audio frame.
+ * Spectral flatness measures how noise-like a sound is (flat = noise, peaked = tone).
+ * Usage: const sf = new SpectralFlatnessAnalyzer({ sampleRate: 16000 }); sf.analyzeFrame(pcm)
+ */
+import FFT from 'fft.js';
+export class SpectralFlatnessAnalyzer {
+    fft;
+    fftSize;
+    /**
+     * @param config - Configuration with sample rate and optional FFT size
+     */
+    constructor(config) {
+        this.fftSize = config.fftSize || 1024;
+        this.fft = new FFT(this.fftSize);
+    }
+    /**
+     * Compute the spectral flatness for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Spectral flatness (0 = tone, 1 = noise)
+     */
+    analyzeFrame(pcm) {
+        const spectrum = this.fft.createComplexArray();
+        this.fft.realTransform(spectrum, pcm);
+        this.fft.completeSpectrum(spectrum);
+        let mags = [];
+        for (let i = 0; i < this.fftSize / 2; i++) {
+            const re = spectrum[2 * i];
+            const im = spectrum[2 * i + 1];
+            mags.push(Math.sqrt(re * re + im * im));
+        }
+        const geoMean = Math.exp(mags.reduce((a, b) => a + Math.log(b + 1e-12), 0) / mags.length);
+        const arithMean = mags.reduce((a, b) => a + b, 0) / mags.length;
+        return geoMean / (arithMean + 1e-12);
+    }
+}
+//# sourceMappingURL=SpectralFlatnessAnalyzer.js.map

package/dist/analysis/SpectralFlatnessAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpectralFlatnessAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/SpectralFlatnessAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,GAAG,MAAM,QAAQ,CAAC;AASzB,MAAM,OAAO,wBAAwB;IAC3B,GAAG,CAAM;IACT,OAAO,CAAS;IACxB;;OAEG;IACH,YAAY,MAA8B;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAC,GAAiB;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAChE,OAAO,OAAO,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/analysis/SpectralRolloffAnalyzer.d.ts

@@ -0,0 +1,25 @@
+export interface SpectralRolloffConfig {
+    /** Sample rate of the audio (Hz) */
+    sampleRate: number;
+    /** FFT size (default: 1024) */
+    fftSize?: number;
+    /** Rolloff percent (default: 0.85) */
+    rolloffPercent?: number;
+}
+export declare class SpectralRolloffAnalyzer {
+    private fft;
+    private fftSize;
+    private sampleRate;
+    private rolloffPercent;
+    /**
+     * @param config - Configuration with sample rate, optional FFT size, and rolloff percent
+     */
+    constructor(config: SpectralRolloffConfig);
+    /**
+     * Compute the spectral rolloff for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Spectral rolloff frequency in Hz
+     */
+    analyzeFrame(pcm: Float32Array): number;
+}
+//# sourceMappingURL=SpectralRolloffAnalyzer.d.ts.map

package/dist/analysis/SpectralRolloffAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpectralRolloffAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/SpectralRolloffAnalyzer.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;IAC/B;;OAEG;gBACS,MAAM,EAAE,qBAAqB;IAMzC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;CAqBxC"}

package/dist/analysis/SpectralRolloffAnalyzer.js

@@ -0,0 +1,48 @@
+/**
+ * SpectralRolloffAnalyzer computes the spectral rolloff point of a PCM audio frame.
+ * The rolloff is the frequency below which a certain percentage (e.g., 85%) of the total spectral energy lies.
+ * Usage: const sr = new SpectralRolloffAnalyzer({ sampleRate: 16000 }); sr.analyzeFrame(pcm)
+ */
+import FFT from 'fft.js';
+export class SpectralRolloffAnalyzer {
+    fft;
+    fftSize;
+    sampleRate;
+    rolloffPercent;
+    /**
+     * @param config - Configuration with sample rate, optional FFT size, and rolloff percent
+     */
+    constructor(config) {
+        this.fftSize = config.fftSize || 1024;
+        this.fft = new FFT(this.fftSize);
+        this.sampleRate = config.sampleRate;
+        this.rolloffPercent = config.rolloffPercent || 0.85;
+    }
+    /**
+     * Compute the spectral rolloff for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Spectral rolloff frequency in Hz
+     */
+    analyzeFrame(pcm) {
+        const spectrum = this.fft.createComplexArray();
+        this.fft.realTransform(spectrum, pcm);
+        this.fft.completeSpectrum(spectrum);
+        let mags = [];
+        for (let i = 0; i < this.fftSize / 2; i++) {
+            const re = spectrum[2 * i];
+            const im = spectrum[2 * i + 1];
+            mags.push(Math.sqrt(re * re + im * im));
+        }
+        const totalEnergy = mags.reduce((a, b) => a + b, 0);
+        let threshold = totalEnergy * this.rolloffPercent;
+        let cumulative = 0;
+        for (let i = 0; i < mags.length; i++) {
+            cumulative += mags[i];
+            if (cumulative >= threshold) {
+                return (i / mags.length) * (this.sampleRate / 2);
+            }
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=SpectralRolloffAnalyzer.js.map

package/dist/analysis/SpectralRolloffAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpectralRolloffAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/SpectralRolloffAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,GAAG,MAAM,QAAQ,CAAC;AAWzB,MAAM,OAAO,uBAAuB;IAC1B,GAAG,CAAM;IACT,OAAO,CAAS;IAChB,UAAU,CAAS;IACnB,cAAc,CAAS;IAC/B;;OAEG;IACH,YAAY,MAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAC,GAAiB;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,SAAS,GAAG,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC;QAClD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/dist/analysis/WaveformEnvelopeAnalyzer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * WaveformEnvelopeAnalyzer computes the amplitude envelope of a PCM audio frame.
+ * The envelope tracks the maximum absolute amplitude in a sliding window, useful for visualizing signal dynamics.
+ * Usage: const env = new WaveformEnvelopeAnalyzer({ sampleRate: 16000 }); env.analyzeFrame(pcm)
+ */
+export interface WaveformEnvelopeConfig {
+    sampleRate: number;
+    windowSize?: number;
+}
+export declare class WaveformEnvelopeAnalyzer {
+    private windowSize;
+    /**
+     * @param config - Configuration with sample rate and optional window size
+     */
+    constructor(config: WaveformEnvelopeConfig);
+    /**
+     * Compute the amplitude envelope for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Envelope as a Float32Array
+     */
+    analyzeFrame(pcm: Float32Array): Float32Array;
+}
+//# sourceMappingURL=WaveformEnvelopeAnalyzer.d.ts.map

package/dist/analysis/WaveformEnvelopeAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaveformEnvelopeAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/WaveformEnvelopeAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AAEnF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,UAAU,CAAS;IAC3B;;OAEG;gBACS,MAAM,EAAE,sBAAsB;IAG1C;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;CAa9C"}

package/dist/analysis/WaveformEnvelopeAnalyzer.js

@@ -0,0 +1,28 @@
+export class WaveformEnvelopeAnalyzer {
+    windowSize;
+    /**
+     * @param config - Configuration with sample rate and optional window size
+     */
+    constructor(config) {
+        this.windowSize = config.windowSize || Math.floor(config.sampleRate * 0.01); // 10ms default
+    }
+    /**
+     * Compute the amplitude envelope for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Envelope as a Float32Array
+     */
+    analyzeFrame(pcm) {
+        const env = new Float32Array(pcm.length);
+        for (let i = 0; i < pcm.length; i++) {
+            let start = Math.max(0, i - Math.floor(this.windowSize / 2));
+            let end = Math.min(pcm.length, i + Math.floor(this.windowSize / 2));
+            let max = 0;
+            for (let j = start; j < end; j++) {
+                max = Math.max(max, Math.abs(pcm[j]));
+            }
+            env[i] = max;
+        }
+        return env;
+    }
+}
+//# sourceMappingURL=WaveformEnvelopeAnalyzer.js.map

package/dist/analysis/WaveformEnvelopeAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaveformEnvelopeAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/WaveformEnvelopeAnalyzer.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,wBAAwB;IAC3B,UAAU,CAAS;IAC3B;;OAEG;IACH,YAAY,MAA8B;QACxC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe;IAC9F,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAC,GAAiB;QAC5B,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;YAC7D,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;YACpE,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACf,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/analysis/WaveletTransformAnalyzer.d.ts

@@ -0,0 +1,10 @@
+export interface WaveletTransformConfig {
+    sampleRate: number;
+    levels?: number;
+}
+export declare class WaveletTransformAnalyzer {
+    private levels;
+    constructor(config: WaveletTransformConfig);
+    analyzeFrame(pcm: Float32Array): Float32Array[];
+}
+//# sourceMappingURL=WaveletTransformAnalyzer.d.ts.map

package/dist/analysis/WaveletTransformAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaveletTransformAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/WaveletTransformAnalyzer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAC/E,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAS;gBACX,MAAM,EAAE,sBAAsB;IAI1C,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,EAAE;CAiBhD"}

package/dist/analysis/WaveletTransformAnalyzer.js

@@ -0,0 +1,25 @@
+export class WaveletTransformAnalyzer {
+    levels;
+    constructor(config) {
+        this.levels = config.levels || 1;
+    }
+    // Haar DWT (minimal, single-level or multi-level)
+    analyzeFrame(pcm) {
+        let coeffs = [];
+        let current = Float32Array.from(pcm);
+        for (let l = 0; l < this.levels; l++) {
+            const N = current.length;
+            const approx = new Float32Array(N / 2);
+            const detail = new Float32Array(N / 2);
+            for (let i = 0; i < N; i += 2) {
+                approx[i / 2] = (current[i] + current[i + 1]) / Math.sqrt(2);
+                detail[i / 2] = (current[i] - current[i + 1]) / Math.sqrt(2);
+            }
+            coeffs.push(detail);
+            current = approx;
+        }
+        coeffs.push(current); // final approx
+        return coeffs;
+    }
+}
+//# sourceMappingURL=WaveletTransformAnalyzer.js.map

package/dist/analysis/WaveletTransformAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaveletTransformAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/WaveletTransformAnalyzer.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,wBAAwB;IAC3B,MAAM,CAAS;IACvB,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,kDAAkD;IAClD,YAAY,CAAC,GAAiB;QAC5B,IAAI,MAAM,GAAmB,EAAE,CAAC;QAChC,IAAI,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC7D,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/analysis/ZeroCrossingRateAnalyzer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ZeroCrossingRateAnalyzer computes the rate at which the audio signal changes sign (crosses zero).
+ * This is a simple time-domain feature useful for distinguishing voiced/unvoiced speech and percussive sounds.
+ * Usage: const zcr = new ZeroCrossingRateAnalyzer({ sampleRate: 16000 }); zcr.analyzeFrame(pcm)
+ */
+export interface ZeroCrossingRateConfig {
+    sampleRate: number;
+}
+export declare class ZeroCrossingRateAnalyzer {
+    /**
+     * @param _config - Configuration with sample rate
+     */
+    constructor(_config: ZeroCrossingRateConfig);
+    /**
+     * Compute the zero crossing rate for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Zero crossing rate (crossings per sample)
+     */
+    analyzeFrame(pcm: Float32Array): number;
+}
+//# sourceMappingURL=ZeroCrossingRateAnalyzer.d.ts.map

package/dist/analysis/ZeroCrossingRateAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZeroCrossingRateAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/ZeroCrossingRateAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IAAG,UAAU,EAAE,MAAM,CAAA;CAAE;AAE9D,qBAAa,wBAAwB;IACnC;;OAEG;gBACS,OAAO,EAAE,sBAAsB;IAE3C;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;CASxC"}

package/dist/analysis/ZeroCrossingRateAnalyzer.js

@@ -0,0 +1,22 @@
+export class ZeroCrossingRateAnalyzer {
+    /**
+     * @param _config - Configuration with sample rate
+     */
+    constructor(_config) {
+    }
+    /**
+     * Compute the zero crossing rate for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Zero crossing rate (crossings per sample)
+     */
+    analyzeFrame(pcm) {
+        let zcr = 0;
+        for (let i = 1; i < pcm.length; i++) {
+            if ((pcm[i - 1] >= 0 && pcm[i] < 0) || (pcm[i - 1] < 0 && pcm[i] >= 0)) {
+                zcr++;
+            }
+        }
+        return zcr / pcm.length;
+    }
+}
+//# sourceMappingURL=ZeroCrossingRateAnalyzer.js.map

package/dist/analysis/ZeroCrossingRateAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZeroCrossingRateAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/ZeroCrossingRateAnalyzer.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,wBAAwB;IACnC;;OAEG;IACH,YAAY,OAA+B;IAC3C,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAC,GAAiB;QAC5B,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,EAAE,CAAC;YACR,CAAC;QACH,CAAC;QACD,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,CAAC;CACF"}

package/dist/analysis/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Audio Analysis Library
+ *
+ * A comprehensive collection of audio feature extractors for machine learning applications.
+ * All analyzers work in both browser and Node.js environments.
+ *
+ * @example
+ * ```typescript
+ * import { MFCCAnalyzer, FFTAnalyzer } from '@your-package/audio-analyzers';
+ *
+ * const mfcc = new MFCCAnalyzer({ sampleRate: 44100 });
+ * const features = mfcc.analyzeFrame(pcmData);
+ * ```
+ */
+export { FFTAnalyzer, type FFTConfig } from './FFTAnalyzer';
+export { MFCCAnalyzer, type MFCCConfig } from './MFCCAnalyzer';
+export { PLPAnalyzer, type PLPConfig } from './PLPAnalyzer';
+export { MelSpectrogramAnalyzer, type MelSpectrogramConfig } from './MelSpectrogramAnalyzer';
+export { ConstantQTransformAnalyzer, type ConstantQTransformConfig } from './ConstantQTransformAnalyzer';
+export { ChromaFeaturesAnalyzer, type ChromaFeaturesConfig } from './ChromaFeaturesAnalyzer';
+export { SpectralCentroidAnalyzer, type SpectralCentroidConfig } from './SpectralCentroidAnalyzer';
+export { SpectralRolloffAnalyzer, type SpectralRolloffConfig } from './SpectralRolloffAnalyzer';
+export { SpectralBandwidthAnalyzer, type SpectralBandwidthConfig } from './SpectralBandwidthAnalyzer';
+export { SpectralFlatnessAnalyzer, type SpectralFlatnessConfig } from './SpectralFlatnessAnalyzer';
+export { ZeroCrossingRateAnalyzer, type ZeroCrossingRateConfig } from './ZeroCrossingRateAnalyzer';
+export { RMSEAnalyzer, type RMSEConfig } from './RMSEAnalyzer';
+export { WaveformEnvelopeAnalyzer, type WaveformEnvelopeConfig } from './WaveformEnvelopeAnalyzer';
+export { AutocorrelationAnalyzer, type AutocorrelationConfig } from './AutocorrelationAnalyzer';
+export { LPCAnalyzer, type LPCConfig } from './LPCAnalyzer';
+export { WaveletTransformAnalyzer, type WaveletTransformConfig } from './WaveletTransformAnalyzer';
+//# sourceMappingURL=index.d.ts.map

package/dist/analysis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGnG,OAAO,EAAE,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGhG,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/analysis/index.js

@@ -0,0 +1,35 @@
+/**
+ * Audio Analysis Library
+ *
+ * A comprehensive collection of audio feature extractors for machine learning applications.
+ * All analyzers work in both browser and Node.js environments.
+ *
+ * @example
+ * ```typescript
+ * import { MFCCAnalyzer, FFTAnalyzer } from '@your-package/audio-analyzers';
+ *
+ * const mfcc = new MFCCAnalyzer({ sampleRate: 44100 });
+ * const features = mfcc.analyzeFrame(pcmData);
+ * ```
+ */
+// Frequency Domain Analyzers
+export { FFTAnalyzer } from './FFTAnalyzer';
+export { MFCCAnalyzer } from './MFCCAnalyzer';
+export { PLPAnalyzer } from './PLPAnalyzer';
+export { MelSpectrogramAnalyzer } from './MelSpectrogramAnalyzer';
+export { ConstantQTransformAnalyzer } from './ConstantQTransformAnalyzer';
+export { ChromaFeaturesAnalyzer } from './ChromaFeaturesAnalyzer';
+// Spectral Feature Analyzers
+export { SpectralCentroidAnalyzer } from './SpectralCentroidAnalyzer';
+export { SpectralRolloffAnalyzer } from './SpectralRolloffAnalyzer';
+export { SpectralBandwidthAnalyzer } from './SpectralBandwidthAnalyzer';
+export { SpectralFlatnessAnalyzer } from './SpectralFlatnessAnalyzer';
+// Time Domain Analyzers
+export { ZeroCrossingRateAnalyzer } from './ZeroCrossingRateAnalyzer';
+export { RMSEAnalyzer } from './RMSEAnalyzer';
+export { WaveformEnvelopeAnalyzer } from './WaveformEnvelopeAnalyzer';
+export { AutocorrelationAnalyzer } from './AutocorrelationAnalyzer';
+// Advanced Analyzers
+export { LPCAnalyzer } from './LPCAnalyzer';
+export { WaveletTransformAnalyzer } from './WaveletTransformAnalyzer';
+//# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAkB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAmB,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAkB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAA6B,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAiC,MAAM,8BAA8B,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAA6B,MAAM,0BAA0B,CAAC;AAE7F,6BAA6B;AAC7B,OAAO,EAAE,wBAAwB,EAA+B,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAA8B,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAgC,MAAM,6BAA6B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAA+B,MAAM,4BAA4B,CAAC;AAEnG,wBAAwB;AACxB,OAAO,EAAE,wBAAwB,EAA+B,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAmB,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAA+B,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAA8B,MAAM,2BAA2B,CAAC;AAEhG,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAkB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAA+B,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "audio-ml",
+  "version": "1.0.0",
+  "description": "A comprehensive JavaScript/TypeScript library for audio feature extraction, designed for machine learning applications and voice AI systems",
+  "type": "module",
+  "main": "./dist/analysis/index.js",
+  "types": "./dist/analysis/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/analysis/index.js",
+      "types": "./dist/analysis/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json",
+    "build:app": "tsc && vite build",
+    "preview": "vite preview",
+    "prepublishOnly": "yarn build"
+  },
+  "keywords": [
+    "audio",
+    "audio-analysis",
+    "feature-extraction",
+    "mfcc",
+    "fft",
+    "spectral-analysis",
+    "voice-ai",
+    "speech-recognition",
+    "machine-learning",
+    "signal-processing",
+    "dsp",
+    "typescript"
+  ],
+  "author": "Abijah Kajabika",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AbijahKaj/audio-ml.git"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vite": "^7.2.4"
+  },
+  "dependencies": {
+    "fft.js": "^4.0.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}