audio-ml 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abijah Kajabika
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,213 @@
+# Audio ML - Audio Analysis for Machine Learning
+
+A comprehensive JavaScript/TypeScript library for real-time audio feature extraction, designed for machine learning applications, particularly voice AI systems.
+
+## Overview
+
+This project provides a complete toolkit for analyzing audio signals in real-time, extracting various features that are essential for machine learning models in speech recognition, speaker identification, music information retrieval, and voice AI applications.
+
+## Features
+
+### 🎯 Real-Time Audio Analysis
+- Process audio from microphone or audio playback in real-time
+- Extract multiple audio features simultaneously
+- Visualize all features in a responsive grid layout
+
+### 📊 16 Audio Analyzers
+
+#### Frequency Domain Features
+- **FFT** - Fast Fourier Transform magnitude spectrum
+- **MFCC** - Mel-Frequency Cepstral Coefficients (13 coefficients)
+- **PLP** - Perceptual Linear Prediction
+- **Mel Spectrogram** - Mel-scaled power spectrum
+- **Constant-Q Transform** - Logarithmically spaced frequency analysis
+- **Chroma Features** - 12-tone pitch class representation
+
+#### Spectral Features
+- **Spectral Centroid** - Frequency "center of mass"
+- **Spectral Rolloff** - Frequency below which 85% of energy lies
+- **Spectral Bandwidth** - Spread of spectrum around centroid
+- **Spectral Flatness** - Measure of noise-like vs tone-like content
+
+#### Time Domain Features
+- **Zero Crossing Rate** - Rate of sign changes
+- **RMSE** - Root Mean Square Energy
+- **Waveform Envelope** - Amplitude envelope tracking
+- **Autocorrelation** - Periodicity and pitch detection
+
+#### Advanced Features
+- **LPC** - Linear Predictive Coding coefficients
+- **Wavelet Transform** - Multi-level time-frequency decomposition
+
+### 🎨 Interactive Visualizations
+- Real-time canvas-based visualizations for each analyzer
+- Responsive grid layout (up to 4 columns)
+- Info tooltips with detailed explanations and resources
+- Scrolling spectrograms for time-frequency analysis
+
+## Getting Started
+
+### Installation
+
+```bash
+npm install
+# or
+yarn install
+```
+
+### Development
+
+```bash
+npm run dev
+# or
+yarn dev
+```
+
+Open your browser and navigate to the local development server (typically `http://localhost:5173`).
+
+### Usage
+
+1. Click "Start Recording" to begin capturing audio from your microphone
+2. All 16 analyzers will update in real-time as you speak
+3. Click the ⓘ icon next to any analyzer name to learn more about it
+4. Click "Stop Recording" to end the session
+
+## Architecture
+
+### Analyzers (`src/analysis/`)
+Each analyzer is a self-contained class that:
+- Takes PCM audio frames as input
+- Returns feature vectors or scalar values
+- Handles its own FFT and signal processing
+
+### Visualizations (`src/visualizations/`)
+- **Base classes**: `BaseVisualizer`, `ArrayVisualizer`, `ScalarVisualizer`
+- **Visualizer functions**: Specific drawing functions for each analyzer type
+- **VisualizationManager**: Manages multiple visualizations and updates them in real-time
+- **Info system**: Tooltips with detailed information about each analyzer
+
+### Main Application (`src/main.ts`)
+- Sets up audio capture from microphone
+- Creates and manages all analyzers
+- Handles frame size differences between analyzers
+- Updates visualizations in real-time
+
+## API Reference
+
+### Basic Usage
+
+```typescript
+import { FFTAnalyzer } from './analysis/FFTAnalyzer';
+import { MFCCAnalyzer } from './analysis/MFCCAnalyzer';
+import { visualizeFFT } from './visualizations/analyzerVisualizers';
+
+// Create analyzer
+const fftAnalyzer = new FFTAnalyzer({ 
+  sampleRate: 44100, 
+  fftSize: 1024 
+});
+
+// Analyze a frame
+const pcmFrame = new Float32Array(1024); // Your audio data
+const spectrum = fftAnalyzer.analyzeFrame(pcmFrame);
+
+// Visualize
+const canvas = document.createElement('canvas');
+visualizeFFT(canvas, spectrum);
+```
+
+### Using VisualizationManager
+
+```typescript
+import { VisualizationManager } from './visualizations';
+import { FFTAnalyzer } from './analysis/FFTAnalyzer';
+
+const container = document.getElementById('app')!;
+const manager = new VisualizationManager(container);
+
+const analyzer = new FFTAnalyzer({ sampleRate: 44100 });
+const canvas = document.createElement('canvas');
+canvas.width = 400;
+canvas.height = 200;
+
+manager.addVisualization(analyzer, canvas, 'FFT', { 
+  color: '#00ff00' 
+});
+
+// Update with audio data
+processor.onaudioprocess = (event) => {
+  const pcm = event.inputBuffer.getChannelData(0);
+  manager.update(pcm);
+};
+```
+
+## Analyzers Reference
+
+| Analyzer | Output Type | Frame Size | Description |
+|----------|-------------|------------|-------------|
+| FFT | `Float32Array` | 1024 | Raw frequency spectrum |
+| MFCC | `number[]` | 1024 | 13 cepstral coefficients |
+| PLP | `number[]` | 512 | Perceptual linear prediction |
+| Chroma | `number[]` | 1024 | 12 pitch classes |
+| LPC | `number[]` | Any | Linear prediction coefficients |
+| CQT | `Float32Array` | 2048 | Constant-Q transform |
+| Wavelet | `Float32Array[]` | Any | Multi-level decomposition |
+| Envelope | `Float32Array` | Any | Amplitude envelope |
+| Autocorr | `Float32Array` | Any | Autocorrelation function |
+| Centroid | `number` | 1024 | Spectral centroid (Hz) |
+| Rolloff | `number` | 1024 | Spectral rolloff (Hz) |
+| Bandwidth | `number` | 1024 | Spectral bandwidth (Hz) |
+| Flatness | `number` | 1024 | Spectral flatness (0-1) |
+| ZCR | `number` | Any | Zero crossing rate |
+| RMSE | `number` | Any | Root mean square energy |
+| Mel Spectrogram | `number[]` | 1024 | Mel-scaled energies |
+
+## Use Cases
+
+### Voice AI Applications
+- **Speech Recognition**: MFCC, PLP, and spectral features for acoustic modeling
+- **Speaker Identification**: Voiceprint extraction using MFCC, LPC, and spectral features
+- **Voice Activity Detection**: ZCR, RMSE, and spectral flatness for silence detection
+- **Emotion Recognition**: Spectral features and prosodic features
+
+### Music Information Retrieval
+- **Chord Recognition**: Chroma features
+- **Key Detection**: Chroma features and spectral analysis
+- **Tempo Estimation**: Autocorrelation
+- **Genre Classification**: Multiple spectral and temporal features
+
+### Audio Processing
+- **Noise Reduction**: Spectral analysis and filtering
+- **Pitch Detection**: Autocorrelation and CQT
+- **Onset Detection**: Envelope and spectral features
+
+## Dependencies
+
+- **fft.js** - Fast Fourier Transform implementation
+- **TypeScript** - Type-safe JavaScript
+- **Vite** - Build tool and dev server
+
+## Browser Compatibility
+
+- Modern browsers with Web Audio API support
+- Microphone access required for real-time analysis
+- Canvas API for visualizations
+
+## Contributing
+
+This project is designed to be extensible. To add a new analyzer:
+
+1. Create a new analyzer class in `src/analysis/`
+2. Implement the `analyzeFrame(pcm: Float32Array)` method
+3. Add a visualization function in `src/visualizations/analyzerVisualizers.ts`
+4. Register it in `VisualizationManager.getVisualizer()`
+5. Add info to `src/visualizations/analyzerInfo.ts`
+
+## License
+
+MIT
+
+## Resources
+
+- [Web Audio API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API)
+- [FFT.js Documentation](https://github.com/indutny/fft.js)

package/dist/analysis/AutocorrelationAnalyzer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AutocorrelationAnalyzer computes the autocorrelation function of a PCM audio frame.
+ * Autocorrelation is useful for pitch detection and periodicity analysis in audio signals.
+ * Usage: const ac = new AutocorrelationAnalyzer({ sampleRate: 16000 }); ac.analyzeFrame(pcm)
+ */
+export interface AutocorrelationConfig {
+    sampleRate: number;
+    maxLag?: number;
+}
+export declare class AutocorrelationAnalyzer {
+    private maxLag;
+    /**
+     * @param config - Configuration with sample rate and optional max lag
+     */
+    constructor(config: AutocorrelationConfig);
+    /**
+     * Compute the autocorrelation function for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Autocorrelation array (length = maxLag)
+     */
+    analyzeFrame(pcm: Float32Array): Float32Array;
+}
+//# sourceMappingURL=AutocorrelationAnalyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutocorrelationAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/AutocorrelationAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAE9E,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB;;OAEG;gBACS,MAAM,EAAE,qBAAqB;IAGzC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;CAW9C"}

package/dist/analysis/AutocorrelationAnalyzer.js

@@ -0,0 +1,26 @@
+export class AutocorrelationAnalyzer {
+    maxLag;
+    /**
+     * @param config - Configuration with sample rate and optional max lag
+     */
+    constructor(config) {
+        this.maxLag = config.maxLag || Math.floor(config.sampleRate / 50); // up to 20 Hz
+    }
+    /**
+     * Compute the autocorrelation function for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns Autocorrelation array (length = maxLag)
+     */
+    analyzeFrame(pcm) {
+        const result = new Float32Array(this.maxLag);
+        for (let lag = 0; lag < this.maxLag; lag++) {
+            let sum = 0;
+            for (let i = 0; i < pcm.length - lag; i++) {
+                sum += pcm[i] * pcm[i + lag];
+            }
+            result[lag] = sum / (pcm.length - lag);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=AutocorrelationAnalyzer.js.map

package/dist/analysis/AutocorrelationAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutocorrelationAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/AutocorrelationAnalyzer.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,uBAAuB;IAC1B,MAAM,CAAS;IACvB;;OAEG;IACH,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc;IACnF,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAC,GAAiB;QAC5B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;YAC3C,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAC/B,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/analysis/ChromaFeaturesAnalyzer.d.ts

@@ -0,0 +1,12 @@
+export interface ChromaFeaturesConfig {
+    sampleRate: number;
+    fftSize?: number;
+}
+export declare class ChromaFeaturesAnalyzer {
+    private fft;
+    private fftSize;
+    private sampleRate;
+    constructor(config: ChromaFeaturesConfig);
+    analyzeFrame(pcm: Float32Array): number[];
+}
+//# sourceMappingURL=ChromaFeaturesAnalyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChromaFeaturesAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/ChromaFeaturesAnalyzer.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,oBAAoB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AAC9E,qBAAa,sBAAsB;IACjC,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBACf,MAAM,EAAE,oBAAoB;IAKxC,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE;CAqB1C"}

package/dist/analysis/ChromaFeaturesAnalyzer.js

@@ -0,0 +1,33 @@
+import FFT from 'fft.js';
+export class ChromaFeaturesAnalyzer {
+    fft;
+    fftSize;
+    sampleRate;
+    constructor(config) {
+        this.fftSize = config.fftSize || 1024;
+        this.fft = new FFT(this.fftSize);
+        this.sampleRate = config.sampleRate;
+    }
+    analyzeFrame(pcm) {
+        // 12 chroma bins (C, C#, D, ..., B)
+        const chroma = new Array(12).fill(0);
+        const spectrum = this.fft.createComplexArray();
+        this.fft.realTransform(spectrum, pcm);
+        this.fft.completeSpectrum(spectrum);
+        for (let i = 0; i < this.fftSize / 2; i++) {
+            const re = spectrum[2 * i];
+            const im = spectrum[2 * i + 1];
+            const mag = Math.sqrt(re * re + im * im);
+            const freq = i * this.sampleRate / this.fftSize;
+            const midi = 69 + 12 * Math.log2(freq / 440);
+            const bin = Math.round(midi) % 12;
+            if (bin >= 0 && bin < 12 && isFinite(bin)) {
+                chroma[bin] += mag;
+            }
+        }
+        // Normalize
+        const sum = chroma.reduce((a, b) => a + b, 0) + 1e-12;
+        return chroma.map(v => v / sum);
+    }
+}
+//# sourceMappingURL=ChromaFeaturesAnalyzer.js.map

package/dist/analysis/ChromaFeaturesAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromaFeaturesAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/ChromaFeaturesAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,QAAQ,CAAC;AAEzB,MAAM,OAAO,sBAAsB;IACzB,GAAG,CAAM;IACT,OAAO,CAAS;IAChB,UAAU,CAAS;IAC3B,YAAY,MAA4B;QACtC,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,YAAY,CAAC,GAAiB;QAC5B,oCAAoC;QACpC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,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,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,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;YAChD,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAClC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;YACrB,CAAC;QACH,CAAC;QACD,YAAY;QACZ,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;QACtD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/analysis/ConstantQTransformAnalyzer.d.ts

@@ -0,0 +1,31 @@
+export interface ConstantQTransformConfig {
+    sampleRate: number;
+    fftSize?: number;
+    binsPerOctave?: number;
+    minFreq?: number;
+    maxFreq?: number;
+}
+export declare class ConstantQTransformAnalyzer {
+    private fft;
+    private fftSize;
+    private sampleRate;
+    private binsPerOctave;
+    private minFreq;
+    private maxFreq;
+    private kernels;
+    /**
+     * @param config - Configuration with sample rate, optional FFT size, bins per octave, and frequency range
+     */
+    constructor(config: ConstantQTransformConfig);
+    /**
+     * Compute the Constant-Q Transform for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns CQT coefficients as Float32Array
+     */
+    analyzeFrame(pcm: Float32Array): Float32Array;
+    /**
+     * Create CQT kernels for each frequency bin.
+     */
+    private createCQTKernels;
+}
+//# sourceMappingURL=ConstantQTransformAnalyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConstantQTransformAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/ConstantQTransformAnalyzer.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAsD;IAErE;;OAEG;gBACS,MAAM,EAAE,wBAAwB;IAU5C;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;IAsC7C;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA2CzB"}

package/dist/analysis/ConstantQTransformAnalyzer.js

@@ -0,0 +1,101 @@
+/**
+ * ConstantQTransformAnalyzer computes the Constant-Q Transform (CQT) of a PCM audio frame.
+ * CQT is a time-frequency analysis method with logarithmically spaced frequency bins, useful for music analysis.
+ * The Q factor (quality factor) remains constant across all frequency bins.
+ * Usage: const cqt = new ConstantQTransformAnalyzer({ sampleRate: 16000 }); cqt.analyzeFrame(pcm)
+ */
+import FFT from 'fft.js';
+export class ConstantQTransformAnalyzer {
+    fft;
+    fftSize;
+    sampleRate;
+    binsPerOctave;
+    minFreq;
+    maxFreq;
+    kernels;
+    /**
+     * @param config - Configuration with sample rate, optional FFT size, bins per octave, and frequency range
+     */
+    constructor(config) {
+        this.fftSize = config.fftSize || 2048;
+        this.sampleRate = config.sampleRate;
+        this.binsPerOctave = config.binsPerOctave || 12;
+        this.minFreq = config.minFreq || 27.5; // A0
+        this.maxFreq = config.maxFreq || this.sampleRate / 2;
+        this.fft = new FFT(this.fftSize);
+        this.kernels = this.createCQTKernels();
+    }
+    /**
+     * Compute the Constant-Q Transform for a PCM frame.
+     * @param pcm - Input PCM audio frame
+     * @returns CQT coefficients as Float32Array
+     */
+    analyzeFrame(pcm) {
+        // Pad or truncate input to fftSize
+        const padded = new Float32Array(this.fftSize);
+        const copyLen = Math.min(pcm.length, this.fftSize);
+        padded.set(pcm.subarray(0, copyLen), 0);
+        // Apply window (Hann window)
+        const windowed = new Float32Array(this.fftSize);
+        for (let i = 0; i < this.fftSize; i++) {
+            const window = 0.5 * (1 - Math.cos(2 * Math.PI * i / (this.fftSize - 1)));
+            windowed[i] = padded[i] * window;
+        }
+        // Compute FFT
+        const spectrum = this.fft.createComplexArray();
+        this.fft.realTransform(spectrum, windowed);
+        this.fft.completeSpectrum(spectrum);
+        // Compute CQT by convolving with kernels
+        const cqt = new Float32Array(this.kernels.length);
+        for (let k = 0; k < this.kernels.length; k++) {
+            const kernel = this.kernels[k].kernel;
+            let realSum = 0;
+            let imagSum = 0;
+            for (let i = 0; i < kernel.length && i < this.fftSize / 2; i++) {
+                const re = spectrum[2 * i];
+                const im = spectrum[2 * i + 1];
+                realSum += re * kernel[i];
+                imagSum += im * kernel[i];
+            }
+            cqt[k] = Math.sqrt(realSum * realSum + imagSum * imagSum);
+        }
+        return cqt;
+    }
+    /**
+     * Create CQT kernels for each frequency bin.
+     */
+    createCQTKernels() {
+        const kernels = [];
+        const Q = 1.0 / (Math.pow(2, 1.0 / this.binsPerOctave) - 1.0);
+        // Calculate number of bins
+        const numBins = Math.floor(this.binsPerOctave * Math.log2(this.maxFreq / this.minFreq));
+        for (let bin = 0; bin < numBins; bin++) {
+            const centerFreq = this.minFreq * Math.pow(2, bin / this.binsPerOctave);
+            if (centerFreq > this.maxFreq)
+                break;
+            // Bandwidth is proportional to center frequency (constant Q)
+            const bandwidth = centerFreq / Q;
+            // Create kernel in frequency domain
+            const kernel = new Float32Array(this.fftSize / 2);
+            // Gaussian-like window in frequency domain
+            for (let i = 0; i < kernel.length; i++) {
+                const freq = (i * this.sampleRate) / this.fftSize;
+                const distance = Math.abs(freq - centerFreq);
+                if (distance < bandwidth) {
+                    const sigma = bandwidth / 2.0;
+                    kernel[i] = Math.exp(-0.5 * Math.pow(distance / sigma, 2));
+                }
+            }
+            // Normalize
+            const sum = kernel.reduce((a, b) => a + b, 0);
+            if (sum > 0) {
+                for (let i = 0; i < kernel.length; i++) {
+                    kernel[i] /= sum;
+                }
+            }
+            kernels.push({ centerFreq, kernel });
+        }
+        return kernels;
+    }
+}
+//# sourceMappingURL=ConstantQTransformAnalyzer.js.map

package/dist/analysis/ConstantQTransformAnalyzer.js.map

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

package/dist/analysis/FFTAnalyzer.d.ts

@@ -0,0 +1,16 @@
+export interface FFTConfig {
+    sampleRate: number;
+    fftSize?: number;
+}
+export declare class FFTAnalyzer {
+    private fft;
+    private fftSize;
+    constructor(config: FFTConfig);
+    /**
+     * Compute the FFT magnitude spectrum for a PCM frame.
+     * @param pcm - Input PCM audio frame (must be fftSize samples)
+     * @returns Array of magnitude values (one per frequency bin)
+     */
+    analyzeFrame(pcm: Float32Array): Float32Array;
+}
+//# sourceMappingURL=FFTAnalyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FFTAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/FFTAnalyzer.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,SAAS;IAK7B;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;CAmB9C"}

package/dist/analysis/FFTAnalyzer.js

@@ -0,0 +1,36 @@
+/**
+ * FFTAnalyzer computes the Fast Fourier Transform magnitude spectrum of a PCM audio frame.
+ * This shows the frequency content of the signal as a magnitude spectrum.
+ * Usage: const fft = new FFTAnalyzer({ sampleRate: 16000 }); fft.analyzeFrame(pcm)
+ */
+import FFT from 'fft.js';
+export class FFTAnalyzer {
+    fft;
+    fftSize;
+    constructor(config) {
+        this.fftSize = config.fftSize || 1024;
+        this.fft = new FFT(this.fftSize);
+    }
+    /**
+     * Compute the FFT magnitude spectrum for a PCM frame.
+     * @param pcm - Input PCM audio frame (must be fftSize samples)
+     * @returns Array of magnitude values (one per frequency bin)
+     */
+    analyzeFrame(pcm) {
+        if (pcm.length !== this.fftSize) {
+            throw new Error(`PCM frame must be fftSize (${this.fftSize}) samples`);
+        }
+        const spectrum = this.fft.createComplexArray();
+        this.fft.realTransform(spectrum, pcm);
+        this.fft.completeSpectrum(spectrum);
+        // Compute magnitude spectrum (only need first half for real signals)
+        const magnitudes = new Float32Array(this.fftSize / 2);
+        for (let i = 0; i < this.fftSize / 2; i++) {
+            const re = spectrum[2 * i];
+            const im = spectrum[2 * i + 1];
+            magnitudes[i] = Math.sqrt(re * re + im * im);
+        }
+        return magnitudes;
+    }
+}
+//# sourceMappingURL=FFTAnalyzer.js.map

package/dist/analysis/FFTAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FFTAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/FFTAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,GAAG,MAAM,QAAQ,CAAC;AAOzB,MAAM,OAAO,WAAW;IACd,GAAG,CAAM;IACT,OAAO,CAAS;IAExB,YAAY,MAAiB;QAC3B,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;IAED;;;;OAIG;IACH,YAAY,CAAC,GAAiB;QAC5B,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;QACzE,CAAC;QAED,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;QAEpC,qEAAqE;QACrE,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QACtD,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,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/analysis/LPCAnalyzer.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"LPCAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/LPCAnalyzer.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,SAAS;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AACjE,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAS;gBACV,MAAM,EAAE,SAAS;IAG7B,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE;CA2B1C"}

package/dist/analysis/LPCAnalyzer.js

@@ -0,0 +1,34 @@
+export class LPCAnalyzer {
+    order;
+    constructor(config) {
+        this.order = config.order || 12;
+    }
+    analyzeFrame(pcm) {
+        // Autocorrelation method
+        const R = new Array(this.order + 1).fill(0);
+        for (let lag = 0; lag <= this.order; lag++) {
+            for (let i = 0; i < pcm.length - lag; i++) {
+                R[lag] += pcm[i] * pcm[i + lag];
+            }
+        }
+        // Levinson-Durbin recursion
+        const a = new Array(this.order + 1).fill(0);
+        const e = new Array(this.order + 1).fill(0);
+        a[0] = 1;
+        e[0] = R[0];
+        for (let i = 1; i <= this.order; i++) {
+            let acc = 0;
+            for (let j = 1; j < i; j++) {
+                acc += a[j] * R[i - j];
+            }
+            const k = (R[i] - acc) / (e[i - 1] + 1e-12);
+            a[i] = k;
+            for (let j = 1; j < i; j++) {
+                a[j] = a[j] - k * a[i - j];
+            }
+            e[i] = (1 - k * k) * e[i - 1];
+        }
+        return a.slice(1);
+    }
+}
+//# sourceMappingURL=LPCAnalyzer.js.map

package/dist/analysis/LPCAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LPCAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/LPCAnalyzer.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACd,KAAK,CAAS;IACtB,YAAY,MAAiB;QAC3B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,YAAY,CAAC,GAAiB;QAC5B,yBAAyB;QACzB,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;YAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,4BAA4B;QAC5B,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACT,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACT,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,CAAC;YACD,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;CACF"}

package/dist/analysis/MFCCAnalyzer.d.ts

@@ -0,0 +1,40 @@
+export interface MFCCConfig {
+    sampleRate: number;
+    melBands?: number;
+    fftSize?: number;
+    numCoeffs?: number;
+}
+export declare class MFCCAnalyzer {
+    private fft;
+    private fftSize;
+    private melBands;
+    private numCoeffs;
+    private sampleRate;
+    private melFilters;
+    /**
+     * @param config - MFCC extraction configuration
+     */
+    constructor(config: MFCCConfig);
+    /**
+     * Extract MFCCs from a PCM frame.
+     * @param pcm - Input PCM audio frame (Float32Array, length = fftSize)
+     * @returns Array of MFCC coefficients (length = numCoeffs)
+     */
+    analyzeFrame(pcm: Float32Array): number[];
+    /**
+     * Create a mel filter bank matrix.
+     * @returns Array of mel filters (each filter is an array of weights for FFT bins)
+     */
+    private createMelFilterBank;
+    /** Convert Hz to mel scale */
+    private hzToMel;
+    /** Convert mel scale to Hz */
+    private melToHz;
+    /**
+     * Discrete Cosine Transform (DCT-II) for MFCCs.
+     * @param vector - Input array (log-mel energies)
+     * @returns DCT coefficients
+     */
+    private dct;
+}
+//# sourceMappingURL=MFCCAnalyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MFCCAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/MFCCAnalyzer.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAE3G,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAa;IAE/B;;OAEG;gBACS,MAAM,EAAE,UAAU;IAS9B;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE;IAgBzC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAyB3B,8BAA8B;IAC9B,OAAO,CAAC,OAAO;IAIf,8BAA8B;IAC9B,OAAO,CAAC,OAAO;IAIf;;;;OAIG;IACH,OAAO,CAAC,GAAG;CAYZ"}