@libraz/libsonare 1.0.0 → 1.0.1

package/README.md

@@ -2,26 +2,34 @@
 
 [![CI](https://img.shields.io/github/actions/workflow/status/libraz/libsonare/ci.yml?branch=main&label=CI)](https://github.com/libraz/libsonare/actions)
 [![npm](https://img.shields.io/npm/v/@libraz/libsonare)](https://www.npmjs.com/package/@libraz/libsonare)
-[![codecov](https://codecov.io/gh/libraz/libsonare/branch/main/graph/badge.svg)](https://codecov.io/gh/libraz/libsonare)
+[![PyPI](https://img.shields.io/pypi/v/libsonare)](https://pypi.org/project/libsonare/)
 [![License](https://img.shields.io/github/license/libraz/libsonare)](https://github.com/libraz/libsonare/blob/main/LICENSE)
-[![C++17](https://img.shields.io/badge/C%2B%2B-17-blue?logo=c%2B%2B)](https://en.cppreference.com/w/cpp/17)
 
-Fast, dependency-free audio analysis library for browser and Node.js via WebAssembly. A librosa-like API for music information retrieval.
+Fast, dependency-free audio analysis library for browser and Node.js via WebAssembly. A librosa-like API for music information retrieval -- **tens of times faster** than Python.
+
+## Installation
+
+```bash
+npm install @libraz/libsonare
+```
 
 ## Usage
 
 ```typescript
-import { init, detectBpm, detectKey, analyze } from '@libraz/libsonare';
+import { init, detectBpm, detectKey, analyze, Audio } from '@libraz/libsonare';
 
 await init();
 
-// Quick analysis
-const result = await analyze(audioBuffer, sampleRate);
-console.log(`BPM: ${result.bpm}, Key: ${result.key.tonic} ${result.key.mode}`);
+// Function API
+const bpm = detectBpm(samples, sampleRate);
+const key = detectKey(samples, sampleRate);
+const result = analyze(samples, sampleRate);
+console.log(`BPM: ${result.bpm}, Key: ${result.key.name}`);
 
-// Individual features
-const bpm = detectBpm(audioBuffer, sampleRate);
-const key = detectKey(audioBuffer, sampleRate);
+// Audio class API
+const audio = Audio.fromBuffer(samples, sampleRate);
+console.log(`BPM: ${audio.detectBpm()}`);
+console.log(`Key: ${audio.detectKey().name}`);
 ```
 
 ### Browser (CDN)
@@ -35,7 +43,7 @@ const key = detectKey(audioBuffer, sampleRate);
 </script>
 ```
 
-### Bundlers (webpack, Vite, Next.js, etc.)
+### Bundlers (Vite, webpack, Next.js, etc.)
 
 If your bundler doesn't automatically resolve the `.wasm` file, specify its path:
 
@@ -46,19 +54,36 @@ import { init } from '@libraz/libsonare';
 await init({ wasmPath: wasmUrl });
 ```
 
+### Real-time Streaming
+
+```typescript
+import { init, StreamAnalyzer } from '@libraz/libsonare';
+
+await init();
+
+const analyzer = new StreamAnalyzer({ sampleRate: 44100 });
+
+// In audio processing callback
+analyzer.process(audioChunk);
+
+const stats = analyzer.stats();
+console.log(`BPM: ${stats.estimate.bpm}, Key: ${stats.estimate.key}`);
+```
+
 ## Features
 
-- BPM / tempo detection
-- Key detection (major/minor)
-- Beat tracking
-- Chord recognition
-- Onset detection
-- Mel spectrogram, MFCC, Chroma
-- Spectral features (centroid, bandwidth, rolloff, flatness)
-- Pitch detection (YIN, pYIN)
-- HPSS (harmonic-percussive separation)
-- Time stretching & pitch shifting
-- Real-time streaming analysis
+- **Detection**: BPM, key, beats, onsets, chords, sections
+- **Effects**: HPSS, time stretch, pitch shift, normalize, trim
+- **Features**: STFT, mel spectrogram, MFCC, chroma, CQT/VQT, spectral features
+- **Pitch**: YIN, pYIN algorithms
+- **Streaming**: Real-time analysis with progressive estimates
+- **Conversions**: Hz/mel/MIDI/note, frames/time, resample
+
+## Also available
+
+```bash
+pip install libsonare  # Python bindings with CLI
+```
 
 ## License
 

package/README.npm.md

@@ -2,26 +2,34 @@
 
 [![CI](https://img.shields.io/github/actions/workflow/status/libraz/libsonare/ci.yml?branch=main&label=CI)](https://github.com/libraz/libsonare/actions)
 [![npm](https://img.shields.io/npm/v/@libraz/libsonare)](https://www.npmjs.com/package/@libraz/libsonare)
-[![codecov](https://codecov.io/gh/libraz/libsonare/branch/main/graph/badge.svg)](https://codecov.io/gh/libraz/libsonare)
+[![PyPI](https://img.shields.io/pypi/v/libsonare)](https://pypi.org/project/libsonare/)
 [![License](https://img.shields.io/github/license/libraz/libsonare)](https://github.com/libraz/libsonare/blob/main/LICENSE)
-[![C++17](https://img.shields.io/badge/C%2B%2B-17-blue?logo=c%2B%2B)](https://en.cppreference.com/w/cpp/17)
 
-Fast, dependency-free audio analysis library for browser and Node.js via WebAssembly. A librosa-like API for music information retrieval.
+Fast, dependency-free audio analysis library for browser and Node.js via WebAssembly. A librosa-like API for music information retrieval -- **tens of times faster** than Python.
+
+## Installation
+
+```bash
+npm install @libraz/libsonare
+```
 
 ## Usage
 
 ```typescript
-import { init, detectBpm, detectKey, analyze } from '@libraz/libsonare';
+import { init, detectBpm, detectKey, analyze, Audio } from '@libraz/libsonare';
 
 await init();
 
-// Quick analysis
-const result = await analyze(audioBuffer, sampleRate);
-console.log(`BPM: ${result.bpm}, Key: ${result.key.tonic} ${result.key.mode}`);
+// Function API
+const bpm = detectBpm(samples, sampleRate);
+const key = detectKey(samples, sampleRate);
+const result = analyze(samples, sampleRate);
+console.log(`BPM: ${result.bpm}, Key: ${result.key.name}`);
 
-// Individual features
-const bpm = detectBpm(audioBuffer, sampleRate);
-const key = detectKey(audioBuffer, sampleRate);
+// Audio class API
+const audio = Audio.fromBuffer(samples, sampleRate);
+console.log(`BPM: ${audio.detectBpm()}`);
+console.log(`Key: ${audio.detectKey().name}`);
 ```
 
 ### Browser (CDN)
@@ -35,7 +43,7 @@ const key = detectKey(audioBuffer, sampleRate);
 </script>
 ```
 
-### Bundlers (webpack, Vite, Next.js, etc.)
+### Bundlers (Vite, webpack, Next.js, etc.)
 
 If your bundler doesn't automatically resolve the `.wasm` file, specify its path:
 
@@ -46,19 +54,36 @@ import { init } from '@libraz/libsonare';
 await init({ wasmPath: wasmUrl });
 ```
 
+### Real-time Streaming
+
+```typescript
+import { init, StreamAnalyzer } from '@libraz/libsonare';
+
+await init();
+
+const analyzer = new StreamAnalyzer({ sampleRate: 44100 });
+
+// In audio processing callback
+analyzer.process(audioChunk);
+
+const stats = analyzer.stats();
+console.log(`BPM: ${stats.estimate.bpm}, Key: ${stats.estimate.key}`);
+```
+
 ## Features
 
-- BPM / tempo detection
-- Key detection (major/minor)
-- Beat tracking
-- Chord recognition
-- Onset detection
-- Mel spectrogram, MFCC, Chroma
-- Spectral features (centroid, bandwidth, rolloff, flatness)
-- Pitch detection (YIN, pYIN)
-- HPSS (harmonic-percussive separation)
-- Time stretching & pitch shifting
-- Real-time streaming analysis
+- **Detection**: BPM, key, beats, onsets, chords, sections
+- **Effects**: HPSS, time stretch, pitch shift, normalize, trim
+- **Features**: STFT, mel spectrogram, MFCC, chroma, CQT/VQT, spectral features
+- **Pitch**: YIN, pYIN algorithms
+- **Streaming**: Real-time analysis with progressive estimates
+- **Conversions**: Hz/mel/MIDI/note, frames/time, resample
+
+## Also available
+
+```bash
+pip install libsonare  # Python bindings with CLI
+```
 
 ## License
 

package/dist/sonare.js

@@ -409,31 +409,6 @@ function unexportedRuntimeSymbol(sym) {
 var readyPromiseResolve, readyPromiseReject;
 
 // Memory management
-var
-/** @type {!Int8Array} */
-  HEAP8,
-/** @type {!Uint8Array} */
-  HEAPU8,
-/** @type {!Int16Array} */
-  HEAP16,
-/** @type {!Uint16Array} */
-  HEAPU16,
-/** @type {!Int32Array} */
-  HEAP32,
-/** @type {!Uint32Array} */
-  HEAPU32,
-/** @type {!Float32Array} */
-  HEAPF32,
-/** @type {!Float64Array} */
-  HEAPF64;
-
-// BigInt64Array type is not correctly defined in closure
-var
-/** not-@type {!BigInt64Array} */
-  HEAP64,
-/* BigUint64Array type is not correctly defined in closure
-/** not-@type {!BigUint64Array} */
-  HEAPU64;
 
 var runtimeInitialized = false;
 
@@ -730,6 +705,36 @@ async function createWasm() {
       }
     }
 
+  /** @type {!Int16Array} */
+  var HEAP16;
+
+  /** @type {!Int32Array} */
+  var HEAP32;
+
+  /** not-@type {!BigInt64Array} */
+  var HEAP64;
+
+  /** @type {!Int8Array} */
+  var HEAP8;
+
+  /** @type {!Float32Array} */
+  var HEAPF32;
+
+  /** @type {!Float64Array} */
+  var HEAPF64;
+
+  /** @type {!Uint16Array} */
+  var HEAPU16;
+
+  /** @type {!Uint32Array} */
+  var HEAPU32;
+
+  /** not-@type {!BigUint64Array} */
+  var HEAPU64;
+
+  /** @type {!Uint8Array} */
+  var HEAPU8;
+
   var callRuntimeCallbacks = (callbacks) => {
       while (callbacks.length > 0) {
         // Pass the module as the first argument.
@@ -765,12 +770,12 @@ async function createWasm() {
 
   var noExitRuntime = true;
 
-  var ptrToString = (ptr) => {
+  function ptrToString(ptr) {
       assert(typeof ptr === 'number', `ptrToString expects a number, got ${typeof ptr}`);
       // Convert to 32-bit unsigned value
       ptr >>>= 0;
       return '0x' + ptr.toString(16).padStart(8, '0');
-    };
+    }
 
   
     /**
@@ -3427,6 +3432,7 @@ Module['FS_createPreloadedFile'] = FS.createPreloadedFile;
   'FS_preloadFile',
   'FS_modeStringToFlags',
   'FS_getMode',
+  'FS_fileDataToTypedArray',
   'FS_stdin_getChar',
   'FS_mkdirTree',
   '_setNetworkCallback',
@@ -3483,21 +3489,21 @@ missingLibrarySymbols.forEach(missingLibrarySymbol)
   'callMain',
   'abort',
   'wasmExports',
-  'HEAPF32',
-  'HEAPF64',
+  'writeStackCookie',
+  'checkStackCookie',
+  'INT53_MAX',
+  'INT53_MIN',
+  'bigintToI53Checked',
   'HEAP8',
   'HEAPU8',
   'HEAP16',
   'HEAPU16',
   'HEAP32',
   'HEAPU32',
+  'HEAPF32',
+  'HEAPF64',
   'HEAP64',
   'HEAPU64',
-  'writeStackCookie',
-  'checkStackCookie',
-  'INT53_MAX',
-  'INT53_MIN',
-  'bigintToI53Checked',
   'stackSave',
   'stackRestore',
   'createNamedFunction',
@@ -3680,12 +3686,6 @@ missingLibrarySymbols.forEach(missingLibrarySymbol)
   'FS_createDataFile',
   'FS_forceLoadFile',
   'FS_createLazyFile',
-  'FS_absolutePath',
-  'FS_createFolder',
-  'FS_createLink',
-  'FS_joinPath',
-  'FS_mmapAlloc',
-  'FS_standardizePath',
   'MEMFS',
   'TTY',
   'PIPEFS',
@@ -3793,6 +3793,10 @@ function checkIncomingModuleAPI() {
   ignoredModuleProp('fetchSettings');
   ignoredModuleProp('logReadFiles');
   ignoredModuleProp('loadSplitModule');
+  ignoredModuleProp('onMalloc');
+  ignoredModuleProp('onRealloc');
+  ignoredModuleProp('onFree');
+  ignoredModuleProp('onSbrkGrow');
 }
 
 // Imports from the Wasm binary.
@@ -3800,11 +3804,11 @@ var ___getTypeName = makeInvalidEarlyAccess('___getTypeName');
 var _malloc = makeInvalidEarlyAccess('_malloc');
 var _free = makeInvalidEarlyAccess('_free');
 var _fflush = makeInvalidEarlyAccess('_fflush');
-var _emscripten_stack_get_end = makeInvalidEarlyAccess('_emscripten_stack_get_end');
-var _emscripten_stack_get_base = makeInvalidEarlyAccess('_emscripten_stack_get_base');
 var _strerror = makeInvalidEarlyAccess('_strerror');
 var _emscripten_stack_init = makeInvalidEarlyAccess('_emscripten_stack_init');
 var _emscripten_stack_get_free = makeInvalidEarlyAccess('_emscripten_stack_get_free');
+var _emscripten_stack_get_base = makeInvalidEarlyAccess('_emscripten_stack_get_base');
+var _emscripten_stack_get_end = makeInvalidEarlyAccess('_emscripten_stack_get_end');
 var __emscripten_stack_restore = makeInvalidEarlyAccess('__emscripten_stack_restore');
 var __emscripten_stack_alloc = makeInvalidEarlyAccess('__emscripten_stack_alloc');
 var _emscripten_stack_get_current = makeInvalidEarlyAccess('_emscripten_stack_get_current');
@@ -3818,11 +3822,11 @@ function assignWasmExports(wasmExports) {
   assert(typeof wasmExports['malloc'] != 'undefined', 'missing Wasm export: malloc');
   assert(typeof wasmExports['free'] != 'undefined', 'missing Wasm export: free');
   assert(typeof wasmExports['fflush'] != 'undefined', 'missing Wasm export: fflush');
-  assert(typeof wasmExports['emscripten_stack_get_end'] != 'undefined', 'missing Wasm export: emscripten_stack_get_end');
-  assert(typeof wasmExports['emscripten_stack_get_base'] != 'undefined', 'missing Wasm export: emscripten_stack_get_base');
   assert(typeof wasmExports['strerror'] != 'undefined', 'missing Wasm export: strerror');
   assert(typeof wasmExports['emscripten_stack_init'] != 'undefined', 'missing Wasm export: emscripten_stack_init');
   assert(typeof wasmExports['emscripten_stack_get_free'] != 'undefined', 'missing Wasm export: emscripten_stack_get_free');
+  assert(typeof wasmExports['emscripten_stack_get_base'] != 'undefined', 'missing Wasm export: emscripten_stack_get_base');
+  assert(typeof wasmExports['emscripten_stack_get_end'] != 'undefined', 'missing Wasm export: emscripten_stack_get_end');
   assert(typeof wasmExports['_emscripten_stack_restore'] != 'undefined', 'missing Wasm export: _emscripten_stack_restore');
   assert(typeof wasmExports['_emscripten_stack_alloc'] != 'undefined', 'missing Wasm export: _emscripten_stack_alloc');
   assert(typeof wasmExports['emscripten_stack_get_current'] != 'undefined', 'missing Wasm export: emscripten_stack_get_current');
@@ -3832,11 +3836,11 @@ function assignWasmExports(wasmExports) {
   _malloc = createExportWrapper('malloc', 1);
   _free = createExportWrapper('free', 1);
   _fflush = createExportWrapper('fflush', 1);
-  _emscripten_stack_get_end = wasmExports['emscripten_stack_get_end'];
-  _emscripten_stack_get_base = wasmExports['emscripten_stack_get_base'];
   _strerror = createExportWrapper('strerror', 1);
   _emscripten_stack_init = wasmExports['emscripten_stack_init'];
   _emscripten_stack_get_free = wasmExports['emscripten_stack_get_free'];
+  _emscripten_stack_get_base = wasmExports['emscripten_stack_get_base'];
+  _emscripten_stack_get_end = wasmExports['emscripten_stack_get_end'];
   __emscripten_stack_restore = wasmExports['_emscripten_stack_restore'];
   __emscripten_stack_alloc = wasmExports['_emscripten_stack_alloc'];
   _emscripten_stack_get_current = wasmExports['emscripten_stack_get_current'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libraz/libsonare",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "packageManager": "yarn@4.12.0",
   "description": "Audio analysis library for music information retrieval",