@siteed/audio-studio 3.0.0 → 3.0.1

package/build/types/AudioAnalysis/audioFeaturesWasm.d.ts

@@ -6,19 +6,7 @@ export interface AudioFeaturesWasmResult {
     mfcc: number[];
     chromagram: number[];
 }
-/**
- * Initialise the WASM streaming audio features processor.
- * Call once before computeAudioFeaturesFrameWasm().
- */
-export declare function initAudioFeaturesWasm(sampleRate: number, fftLength?: number, nMfcc?: number, nMelFilters?: number, computeMfcc?: boolean, computeChroma?: boolean): Promise<void>;
-/**
- * Compute audio features for a single frame via WASM C++.
- * Returns null if not initialised or on error.
- */
-export declare function computeAudioFeaturesFrameWasm(samples: Float32Array): AudioFeaturesWasmResult | null;
-/**
- * Compute audio features for a buffer of samples via WASM C++.
- * Lazy-loads the WASM module on first call.
- */
-export declare function computeAudioFeaturesWasm(audioData: Float32Array, sampleRate: number, fftLength?: number, nMfcc?: number, nMelFilters?: number, computeMfcc?: boolean, computeChroma?: boolean): Promise<AudioFeaturesWasmResult>;
+export declare function initAudioFeaturesWasm(_sampleRate: number, _fftLength?: number, _nMfcc?: number, _nMelFilters?: number, _computeMfcc?: boolean, _computeChroma?: boolean): Promise<void>;
+export declare function computeAudioFeaturesFrameWasm(_samples: Float32Array): AudioFeaturesWasmResult | null;
+export declare function computeAudioFeaturesWasm(_audioData: Float32Array, _sampleRate: number, _fftLength?: number, _nMfcc?: number, _nMelFilters?: number, _computeMfcc?: boolean, _computeChroma?: boolean): Promise<AudioFeaturesWasmResult>;
 //# sourceMappingURL=audioFeaturesWasm.d.ts.map

package/build/types/AudioAnalysis/audioFeaturesWasm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audioFeaturesWasm.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/audioFeaturesWasm.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACpC,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;CACvB;AA8ED;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,SAAO,EAChB,KAAK,SAAK,EACV,WAAW,SAAK,EAChB,WAAW,UAAO,EAClB,aAAa,UAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,YAAY,GACtB,uBAAuB,GAAG,IAAI,CA2BhC;AAID;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,SAAO,EAChB,KAAK,SAAK,EACV,WAAW,SAAK,EAChB,WAAW,UAAO,EAClB,aAAa,UAAO,GACrB,OAAO,CAAC,uBAAuB,CAAC,CA4BlC"}
+{"version":3,"file":"audioFeaturesWasm.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/audioFeaturesWasm.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACpC,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,wBAAsB,qBAAqB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,OAAO,EACtB,cAAc,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,6BAA6B,CACzC,QAAQ,EAAE,YAAY,GACvB,uBAAuB,GAAG,IAAI,CAEhC;AAED,wBAAsB,wBAAwB,CAC1C,UAAU,EAAE,YAAY,EACxB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,OAAO,EACtB,cAAc,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAElC"}

package/build/types/AudioAnalysis/audioFeaturesWasm.web.d.ts

@@ -0,0 +1,24 @@
+export interface AudioFeaturesWasmResult {
+    spectralCentroid: number;
+    spectralFlatness: number;
+    spectralRolloff: number;
+    spectralBandwidth: number;
+    mfcc: number[];
+    chromagram: number[];
+}
+/**
+ * Initialise the WASM streaming audio features processor.
+ * Call once before computeAudioFeaturesFrameWasm().
+ */
+export declare function initAudioFeaturesWasm(sampleRate: number, fftLength?: number, nMfcc?: number, nMelFilters?: number, computeMfcc?: boolean, computeChroma?: boolean): Promise<void>;
+/**
+ * Compute audio features for a single frame via WASM C++.
+ * Returns null if not initialised or on error.
+ */
+export declare function computeAudioFeaturesFrameWasm(samples: Float32Array): AudioFeaturesWasmResult | null;
+/**
+ * Compute audio features for a buffer of samples via WASM C++.
+ * Lazy-loads the WASM module on first call.
+ */
+export declare function computeAudioFeaturesWasm(audioData: Float32Array, sampleRate: number, fftLength?: number, nMfcc?: number, nMelFilters?: number, computeMfcc?: boolean, computeChroma?: boolean): Promise<AudioFeaturesWasmResult>;
+//# sourceMappingURL=audioFeaturesWasm.web.d.ts.map

package/build/types/AudioAnalysis/audioFeaturesWasm.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioFeaturesWasm.web.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/audioFeaturesWasm.web.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACpC,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;CACvB;AA8ED;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,SAAO,EAChB,KAAK,SAAK,EACV,WAAW,SAAK,EAChB,WAAW,UAAO,EAClB,aAAa,UAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,YAAY,GACtB,uBAAuB,GAAG,IAAI,CA2BhC;AAID;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,SAAO,EAChB,KAAK,SAAK,EACV,WAAW,SAAK,EAChB,WAAW,UAAO,EAClB,aAAa,UAAO,GACrB,OAAO,CAAC,uBAAuB,CAAC,CA4BlC"}

package/build/types/AudioAnalysis/melSpectrogramWasm.d.ts

@@ -1,16 +1,4 @@
-/**
- * Initialise the WASM streaming processor. Call once before computeMelFrame().
- * Re-initialises only when config changes.
- */
-export declare function initMelStreamingWasm(sampleRate: number, nMels?: number, fftLength?: number, windowSizeSamples?: number, hopLengthSamples?: number, fMin?: number, fMax?: number): Promise<void>;
-/**
- * Compute a single mel spectrogram frame from raw PCM samples via WASM C++.
- * Returns null if not initialised or on error.
- */
-export declare function computeMelFrameWasm(samples: Float32Array): number[] | null;
-/**
- * Computes a mel spectrogram via the WASM-compiled C++ implementation.
- * Lazy-loads the WASM module on first call.
- */
-export declare function computeMelSpectrogramWasm(audioData: Float32Array, sampleRate: number, nMels: number, windowSizeSamples: number, hopLengthSamples: number, fMin: number, fMax: number, windowType: 'hann' | 'hamming', normalize: boolean, logScale: boolean): Promise<number[][]>;
+export declare function initMelStreamingWasm(_sampleRate: number, _nMels?: number, _fftLength?: number, _windowSizeSamples?: number, _hopLengthSamples?: number, _fMin?: number, _fMax?: number): Promise<void>;
+export declare function computeMelFrameWasm(_samples: Float32Array): number[] | null;
+export declare function computeMelSpectrogramWasm(_audioData: Float32Array, _sampleRate: number, _nMels: number, _windowSizeSamples: number, _hopLengthSamples: number, _fMin: number, _fMax: number, _windowType: 'hann' | 'hamming', _normalize: boolean, _logScale: boolean): Promise<number[][]>;
 //# sourceMappingURL=melSpectrogramWasm.d.ts.map

package/build/types/AudioAnalysis/melSpectrogramWasm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"melSpectrogramWasm.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/melSpectrogramWasm.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,MAAM,EAClB,KAAK,SAAM,EACX,SAAS,SAAO,EAChB,iBAAiB,SAAM,EACvB,gBAAgB,SAAM,EACtB,IAAI,SAAI,EACR,IAAI,SAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,IAAI,CA4B1E;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC3C,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAgErB"}
+{"version":3,"file":"melSpectrogramWasm.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/melSpectrogramWasm.ts"],"names":[],"mappings":"AAGA,wBAAsB,oBAAoB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,iBAAiB,CAAC,EAAE,MAAM,EAC1B,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,IAAI,CAE3E;AAED,wBAAsB,yBAAyB,CAC3C,UAAU,EAAE,YAAY,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,EAC1B,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,GACnB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAErB"}

package/build/types/AudioAnalysis/melSpectrogramWasm.web.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Initialise the WASM streaming processor. Call once before computeMelFrame().
+ * Re-initialises only when config changes.
+ */
+export declare function initMelStreamingWasm(sampleRate: number, nMels?: number, fftLength?: number, windowSizeSamples?: number, hopLengthSamples?: number, fMin?: number, fMax?: number): Promise<void>;
+/**
+ * Compute a single mel spectrogram frame from raw PCM samples via WASM C++.
+ * Returns null if not initialised or on error.
+ */
+export declare function computeMelFrameWasm(samples: Float32Array): number[] | null;
+/**
+ * Computes a mel spectrogram via the WASM-compiled C++ implementation.
+ * Lazy-loads the WASM module on first call.
+ */
+export declare function computeMelSpectrogramWasm(audioData: Float32Array, sampleRate: number, nMels: number, windowSizeSamples: number, hopLengthSamples: number, fMin: number, fMax: number, windowType: 'hann' | 'hamming', normalize: boolean, logScale: boolean): Promise<number[][]>;
+//# sourceMappingURL=melSpectrogramWasm.web.d.ts.map

package/build/types/AudioAnalysis/melSpectrogramWasm.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"melSpectrogramWasm.web.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/melSpectrogramWasm.web.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,MAAM,EAClB,KAAK,SAAM,EACX,SAAS,SAAO,EAChB,iBAAiB,SAAM,EACvB,gBAAgB,SAAM,EACtB,IAAI,SAAI,EACR,IAAI,SAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,IAAI,CA4B1E;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC3C,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAgErB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@siteed/audio-studio",
-    "version": "3.0.0",
+    "version": "3.0.1",
     "description": "Comprehensive audio processing library for React Native and Expo with recording, analysis, visualization, and streaming capabilities across iOS, Android, and web",
     "license": "MIT",
     "type": "commonjs",
@@ -72,7 +72,7 @@
     ],
     "scripts": {
         "build:wasm": "bash scripts/build-wasm.sh",
-        "build": "rimraf build && yarn build:types && yarn build:cjs && yarn build:esm && yarn build:plugin",
+        "build": "rimraf build && yarn build:types && yarn build:cjs && yarn build:esm && yarn build:plugin && cp -r prebuilt/ build/cjs/prebuilt && cp -r prebuilt/ build/esm/prebuilt",
         "build:cjs": "tsc -p tsconfig.cjs.json",
         "build:esm": "tsc -p tsconfig.esm.json",
         "build:types": "tsc -p tsconfig.types.json",
@@ -135,6 +135,7 @@
         "typescript": "~5.8.3"
     },
     "peerDependencies": {
+        "@expo/config-plugins": ">=7.0.0",
         "expo": ">=52.0.0",
         "react": "*",
         "react-native": "*"

package/src/AudioAnalysis/audioFeaturesWasm.ts

@@ -1,4 +1,4 @@
-import type { AudioFeaturesWasmModule } from './audio-features-wasm'
+// Native stub — WASM audio features is web-only.
 
 export interface AudioFeaturesWasmResult {
     spectralCentroid: number
@@ -9,192 +9,31 @@ export interface AudioFeaturesWasmResult {
     chromagram: number[]
 }
 
-let modulePromise: Promise<AudioFeaturesWasmModule> | null = null
-
-function getModule(): Promise<AudioFeaturesWasmModule> {
-    if (!modulePromise) {
-        modulePromise = (async () => {
-            // Same WASM module as mel spectrogram (now includes audio features)
-            // @ts-expect-error -- prebuilt Emscripten JS glue has no .d.ts
-            const mod = await import('../../prebuilt/wasm/mel-spectrogram.js')
-            const factory = mod.default ?? mod
-            return factory() as Promise<AudioFeaturesWasmModule>
-        })().catch((err) => {
-            modulePromise = null
-            throw err
-        })
-    }
-    return modulePromise
-}
-
-// --- Struct layout for CAudioFeaturesResult (wasm32) ---
-// Offset  0: float spectralCentroid  (4 bytes)
-// Offset  4: float spectralFlatness  (4 bytes)
-// Offset  8: float spectralRolloff   (4 bytes)
-// Offset 12: float spectralBandwidth (4 bytes)
-// Offset 16: float* mfcc             (4 bytes pointer)
-// Offset 20: int mfccCount           (4 bytes)
-// Offset 24: float* chromagram       (4 bytes pointer)
-// Offset 28: int chromagramCount     (4 bytes)
-const STRUCT_SIZE = 32
-
-function readResult(
-    Module: AudioFeaturesWasmModule,
-    ptr: number
-): AudioFeaturesWasmResult {
-    const spectralCentroid = Module.getValue(ptr, 'float')
-    const spectralFlatness = Module.getValue(ptr + 4, 'float')
-    const spectralRolloff = Module.getValue(ptr + 8, 'float')
-    const spectralBandwidth = Module.getValue(ptr + 12, 'float')
-
-    const mfccPtr = Module.getValue(ptr + 16, 'i32')
-    const mfccCount = Module.getValue(ptr + 20, 'i32')
-    const chromaPtr = Module.getValue(ptr + 24, 'i32')
-    const chromaCount = Module.getValue(ptr + 28, 'i32')
-
-    const mfcc: number[] = []
-    if (mfccPtr && mfccCount > 0) {
-        const offset = mfccPtr >> 2
-        for (let i = 0; i < mfccCount; i++) {
-            mfcc.push(Module.HEAPF32[offset + i])
-        }
-    }
-
-    const chromagram: number[] = []
-    if (chromaPtr && chromaCount > 0) {
-        const offset = chromaPtr >> 2
-        for (let i = 0; i < chromaCount; i++) {
-            chromagram.push(Module.HEAPF32[offset + i])
-        }
-    }
-
-    return {
-        spectralCentroid,
-        spectralFlatness,
-        spectralRolloff,
-        spectralBandwidth,
-        mfcc,
-        chromagram,
-    }
-}
-
-// --- Streaming (per-frame) API ---
-
-let streamingModule: AudioFeaturesWasmModule | null = null
-let streamingFramePtr = 0
-let streamingFrameCapacity = 0
-let streamingResultPtr = 0
-
-/**
- * Initialise the WASM streaming audio features processor.
- * Call once before computeAudioFeaturesFrameWasm().
- */
 export async function initAudioFeaturesWasm(
-    sampleRate: number,
-    fftLength = 1024,
-    nMfcc = 13,
-    nMelFilters = 26,
-    computeMfcc = true,
-    computeChroma = true
+    _sampleRate: number,
+    _fftLength?: number,
+    _nMfcc?: number,
+    _nMelFilters?: number,
+    _computeMfcc?: boolean,
+    _computeChroma?: boolean
 ): Promise<void> {
-    const Module = await getModule()
-    streamingModule = Module
-
-    Module._audio_features_init(
-        sampleRate,
-        fftLength,
-        nMfcc,
-        nMelFilters,
-        computeMfcc ? 1 : 0,
-        computeChroma ? 1 : 0
-    )
-
-    // Pre-allocate result struct on WASM heap
-    if (streamingResultPtr) Module._free(streamingResultPtr)
-    streamingResultPtr = Module._malloc(STRUCT_SIZE)
-    // Zero-initialize to prevent freeing garbage pointers on first use
-    Module.HEAPU8.fill(0, streamingResultPtr, streamingResultPtr + STRUCT_SIZE)
-
-    // Frame input buffer allocated on demand
-    streamingFrameCapacity = 0
-    streamingFramePtr = 0
+    throw new Error('WASM audio features is not available on native')
 }
 
-/**
- * Compute audio features for a single frame via WASM C++.
- * Returns null if not initialised or on error.
- */
 export function computeAudioFeaturesFrameWasm(
-    samples: Float32Array
+    _samples: Float32Array
 ): AudioFeaturesWasmResult | null {
-    if (!streamingModule || !streamingResultPtr) return null
-    const Module = streamingModule
-
-    // (Re-)allocate frame input buffer if needed
-    if (samples.length > streamingFrameCapacity) {
-        if (streamingFramePtr) Module._free(streamingFramePtr)
-        streamingFramePtr = Module._malloc(samples.length * 4)
-        streamingFrameCapacity = samples.length
-    }
-
-    // Copy samples to WASM heap
-    Module.HEAPF32.set(samples, streamingFramePtr >> 2)
-
-    const ok = Module._audio_features_compute_frame(
-        streamingFramePtr,
-        samples.length,
-        streamingResultPtr
-    )
-    if (!ok) return null
-
-    const result = readResult(Module, streamingResultPtr)
-
-    // Free internal arrays (mfcc, chromagram) allocated by C
-    Module._audio_features_free_arrays(streamingResultPtr)
-
-    return result
+    return null
 }
 
-// --- Batch API ---
-
-/**
- * Compute audio features for a buffer of samples via WASM C++.
- * Lazy-loads the WASM module on first call.
- */
 export async function computeAudioFeaturesWasm(
-    audioData: Float32Array,
-    sampleRate: number,
-    fftLength = 1024,
-    nMfcc = 13,
-    nMelFilters = 26,
-    computeMfcc = true,
-    computeChroma = true
+    _audioData: Float32Array,
+    _sampleRate: number,
+    _fftLength?: number,
+    _nMfcc?: number,
+    _nMelFilters?: number,
+    _computeMfcc?: boolean,
+    _computeChroma?: boolean
 ): Promise<AudioFeaturesWasmResult> {
-    const Module = await getModule()
-
-    const numSamples = audioData.length
-    const inputPtr = Module._malloc(numSamples * 4)
-    Module.HEAPF32.set(audioData, inputPtr >> 2)
-
-    const resultPtr = Module._audio_features_compute(
-        inputPtr,
-        numSamples,
-        sampleRate,
-        fftLength,
-        nMfcc,
-        nMelFilters,
-        computeMfcc ? 1 : 0,
-        computeChroma ? 1 : 0
-    )
-
-    Module._free(inputPtr)
-
-    if (resultPtr === 0) {
-        throw new Error('audio_features_compute returned null')
-    }
-
-    const result = readResult(Module, resultPtr)
-    Module._audio_features_free(resultPtr)
-
-    return result
+    throw new Error('WASM audio features is not available on native')
 }

package/src/AudioAnalysis/audioFeaturesWasm.web.ts

@@ -0,0 +1,200 @@
+import type { AudioFeaturesWasmModule } from './audio-features-wasm'
+
+export interface AudioFeaturesWasmResult {
+    spectralCentroid: number
+    spectralFlatness: number
+    spectralRolloff: number
+    spectralBandwidth: number
+    mfcc: number[]
+    chromagram: number[]
+}
+
+let modulePromise: Promise<AudioFeaturesWasmModule> | null = null
+
+function getModule(): Promise<AudioFeaturesWasmModule> {
+    if (!modulePromise) {
+        modulePromise = (async () => {
+            // Same WASM module as mel spectrogram (now includes audio features)
+            // @ts-expect-error -- prebuilt Emscripten JS glue has no .d.ts
+            const mod = await import('../../prebuilt/wasm/mel-spectrogram.js')
+            const factory = mod.default ?? mod
+            return factory() as Promise<AudioFeaturesWasmModule>
+        })().catch((err) => {
+            modulePromise = null
+            throw err
+        })
+    }
+    return modulePromise
+}
+
+// --- Struct layout for CAudioFeaturesResult (wasm32) ---
+// Offset  0: float spectralCentroid  (4 bytes)
+// Offset  4: float spectralFlatness  (4 bytes)
+// Offset  8: float spectralRolloff   (4 bytes)
+// Offset 12: float spectralBandwidth (4 bytes)
+// Offset 16: float* mfcc             (4 bytes pointer)
+// Offset 20: int mfccCount           (4 bytes)
+// Offset 24: float* chromagram       (4 bytes pointer)
+// Offset 28: int chromagramCount     (4 bytes)
+const STRUCT_SIZE = 32
+
+function readResult(
+    Module: AudioFeaturesWasmModule,
+    ptr: number
+): AudioFeaturesWasmResult {
+    const spectralCentroid = Module.getValue(ptr, 'float')
+    const spectralFlatness = Module.getValue(ptr + 4, 'float')
+    const spectralRolloff = Module.getValue(ptr + 8, 'float')
+    const spectralBandwidth = Module.getValue(ptr + 12, 'float')
+
+    const mfccPtr = Module.getValue(ptr + 16, 'i32')
+    const mfccCount = Module.getValue(ptr + 20, 'i32')
+    const chromaPtr = Module.getValue(ptr + 24, 'i32')
+    const chromaCount = Module.getValue(ptr + 28, 'i32')
+
+    const mfcc: number[] = []
+    if (mfccPtr && mfccCount > 0) {
+        const offset = mfccPtr >> 2
+        for (let i = 0; i < mfccCount; i++) {
+            mfcc.push(Module.HEAPF32[offset + i])
+        }
+    }
+
+    const chromagram: number[] = []
+    if (chromaPtr && chromaCount > 0) {
+        const offset = chromaPtr >> 2
+        for (let i = 0; i < chromaCount; i++) {
+            chromagram.push(Module.HEAPF32[offset + i])
+        }
+    }
+
+    return {
+        spectralCentroid,
+        spectralFlatness,
+        spectralRolloff,
+        spectralBandwidth,
+        mfcc,
+        chromagram,
+    }
+}
+
+// --- Streaming (per-frame) API ---
+
+let streamingModule: AudioFeaturesWasmModule | null = null
+let streamingFramePtr = 0
+let streamingFrameCapacity = 0
+let streamingResultPtr = 0
+
+/**
+ * Initialise the WASM streaming audio features processor.
+ * Call once before computeAudioFeaturesFrameWasm().
+ */
+export async function initAudioFeaturesWasm(
+    sampleRate: number,
+    fftLength = 1024,
+    nMfcc = 13,
+    nMelFilters = 26,
+    computeMfcc = true,
+    computeChroma = true
+): Promise<void> {
+    const Module = await getModule()
+    streamingModule = Module
+
+    Module._audio_features_init(
+        sampleRate,
+        fftLength,
+        nMfcc,
+        nMelFilters,
+        computeMfcc ? 1 : 0,
+        computeChroma ? 1 : 0
+    )
+
+    // Pre-allocate result struct on WASM heap
+    if (streamingResultPtr) Module._free(streamingResultPtr)
+    streamingResultPtr = Module._malloc(STRUCT_SIZE)
+    // Zero-initialize to prevent freeing garbage pointers on first use
+    Module.HEAPU8.fill(0, streamingResultPtr, streamingResultPtr + STRUCT_SIZE)
+
+    // Frame input buffer allocated on demand
+    streamingFrameCapacity = 0
+    streamingFramePtr = 0
+}
+
+/**
+ * Compute audio features for a single frame via WASM C++.
+ * Returns null if not initialised or on error.
+ */
+export function computeAudioFeaturesFrameWasm(
+    samples: Float32Array
+): AudioFeaturesWasmResult | null {
+    if (!streamingModule || !streamingResultPtr) return null
+    const Module = streamingModule
+
+    // (Re-)allocate frame input buffer if needed
+    if (samples.length > streamingFrameCapacity) {
+        if (streamingFramePtr) Module._free(streamingFramePtr)
+        streamingFramePtr = Module._malloc(samples.length * 4)
+        streamingFrameCapacity = samples.length
+    }
+
+    // Copy samples to WASM heap
+    Module.HEAPF32.set(samples, streamingFramePtr >> 2)
+
+    const ok = Module._audio_features_compute_frame(
+        streamingFramePtr,
+        samples.length,
+        streamingResultPtr
+    )
+    if (!ok) return null
+
+    const result = readResult(Module, streamingResultPtr)
+
+    // Free internal arrays (mfcc, chromagram) allocated by C
+    Module._audio_features_free_arrays(streamingResultPtr)
+
+    return result
+}
+
+// --- Batch API ---
+
+/**
+ * Compute audio features for a buffer of samples via WASM C++.
+ * Lazy-loads the WASM module on first call.
+ */
+export async function computeAudioFeaturesWasm(
+    audioData: Float32Array,
+    sampleRate: number,
+    fftLength = 1024,
+    nMfcc = 13,
+    nMelFilters = 26,
+    computeMfcc = true,
+    computeChroma = true
+): Promise<AudioFeaturesWasmResult> {
+    const Module = await getModule()
+
+    const numSamples = audioData.length
+    const inputPtr = Module._malloc(numSamples * 4)
+    Module.HEAPF32.set(audioData, inputPtr >> 2)
+
+    const resultPtr = Module._audio_features_compute(
+        inputPtr,
+        numSamples,
+        sampleRate,
+        fftLength,
+        nMfcc,
+        nMelFilters,
+        computeMfcc ? 1 : 0,
+        computeChroma ? 1 : 0
+    )
+
+    Module._free(inputPtr)
+
+    if (resultPtr === 0) {
+        throw new Error('audio_features_compute returned null')
+    }
+
+    const result = readResult(Module, resultPtr)
+    Module._audio_features_free(resultPtr)
+
+    return result
+}