beatd-js 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 Yusuke Nakada
+
+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

@@ -1,3 +1,149 @@
-# Temporary Holding Version
+# beatd
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/nuskey8/beatd/actions/workflows/ci.yml/badge.svg)](https://github.com/nuskey8/beatd/avctions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/nuskey8/beatd)](https://github.com/nuskey8/beatd/releases/latest)
+[![crates.io](https://img.shields.io/crates/v/beatd)](https://crates.io/crates/beatd)
+[![npm](https://img.shields.io/npm/v/beatd-js)](https://www.npmjs.com/package/beatd-js)
+[![NuGet](https://img.shields.io/nuget/v/Beatd)](https://www.nuget.org/packages/Beatd)
+[![Unity](https://img.shields.io/badge/Unity-6000.0%2B-black?logo=unity)](https://github.com/nuskey8/beatd/tree/main/beatd-dotnet/Beatd.Unity/Packages/com.nuskey8.beatd.unity)
+
+English | [日本語](https://github.com/nuskey8/beatd/blob/main/README.ja.md)
+
+GUI application and library for streaming audio analysis and OSC conversion.
+
+![hero](https://raw.githubusercontent.com/nuskey8/beatd/main/assets/hero.png)
+
+## Overview
+
+beatd is a cross-platform application and library for streaming audio analysis.
+
+It started with the concept of being a modern reimplementation of [Sound2Light](https://github.com/ETCLabs/Sound2Light), utilizing a Rust implementation to create an easy-to-use, cross-platform GUI. It can send audio analysis results via OSC to integrate with external VJ software and similar tools.
+
+Additionally, the core analysis engine is provided as an independent library so that it can be embedded into applications for Rust, C, C# (.NET/Unity), and JavaScript (WebAssembly).
+
+## Screenshot
+
+![img](https://raw.githubusercontent.com/nuskey8/beatd/main/assets/img1.png)
+
+## Installation
+
+Select the latest release from GitHub [Releases](https://github.com/nuskey8/beatd/releases/latest) and download the executable file for your operating system.
+
+## libbeatd
+
+The streaming audio analysis in beatd is implemented in Rust as an independent crate. By embedding this, you can use features such as BPM analysis within your applications.
+
+### Rust
+
+Add the crate via cargo.
+
+```sh
+cargo add beatd
+```
+
+```rust
+use beatd::Analyzer;
+
+let mut analyzer = Analyzer::new(48_000);
+
+// samples: &[f32] (-1.0 to 1.0)
+analyzer.push(&samples);
+
+let level = analyzer.level();
+let bpm = analyzer.bpm();
+let spectrum = analyzer.spectrum();
+let waveform = analyzer.waveform();
+let beats = analyzer.beat_offsets(bpm);
+```
+
+### C
+
+Build the library with the `ffi` feature enabled.
+
+```sh
+cargo build -p beatd --features ffi
+```
+
+Add the generated `libbeatd.so` / `libbeatd.dylib` / `beatd.dll` along with `beatd/beatd.h` to your project, and specify `-lbeatd` during linking.
+
+```c
+#include "beatd.h"
+
+beatd_analyzer *analyzer = beatd_new(48000);
+if (analyzer == NULL) {
+    return 1;
+}
+
+beatd_set_bpm_range_min(analyzer, 75);
+beatd_push(analyzer, samples, count);
+
+float level = beatd_level(analyzer);
+float bpm = beatd_bpm(analyzer);
+
+float spectrum[1024];
+size_t bins = beatd_spectrum(analyzer, spectrum, 1024);
+
+beatd_free(analyzer);
+```
+
+### JavaScript
+
+Add the library via npm.
+
+```sh
+npm i beatd-js
+```
+
+```js
+import { createAnalyzer } from "beatd-js";
+
+using analyzer = createAnalyzer({ sampleRate: 48000 });
+
+// samples: Float32Array
+analyzer.push(samples);
+
+console.log(analyzer.level(), analyzer.bpm());
+console.log(analyzer.spectrum());
+console.log(analyzer.waveform());
+console.log(analyzer.beatOffsets(analyzer.bpm()));
+```
+
+### C# / Unity
+
+For .NET projects, you can add the package from NuGet.
+
+```sh
+dotnet package add Beatd
+```
+
+For Unity, you can add the package from the Package Manager using the git URL.
+
+```
+https://github.com/nuskey8/beatd.git?path=beatd-dotnet/Beatd.Unity/Packages/com.nuskey8.beatd.unity
+```
+
+```csharp
+using Beatd;
+
+using var analyzer = new BeatdAnalyzer(48_000);
+analyzer.BpmRangeMin = 75;
+
+analyzer.Push(samples); // ReadOnlySpan<float>
+
+Console.WriteLine($"{analyzer.Level}, {analyzer.Bpm}");
+float[] spectrum = analyzer.GetSpectrum();
+float[] beats = analyzer.GetBeatOffsets(analyzer.Bpm);
+```
+
+Please note that the .NET/Unity version currently supports only the following platforms:
+
+| Platform            | RID         | .NET (NuGet) | Unity |
+| :------------------ | :---------- | :----------: | :---: |
+| Windows x64         | `win-x64`   |      ✅      |  ✅   |
+| Linux x64           | `linux-x64` |      ✅      |  ✅   |
+| macOS Intel         | `osx-x64`   |      ✅      |  ✅   |
+| macOS Apple Silicon | `osx-arm64` |      ✅      |  ✅   |
+
+## License
+
+beatd is released under the [MIT License](https://github.com/nuskey8/beatd/blob/main/LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export interface AnalyzerOptions {
+    sampleRate: number;
+}
+export declare class Analyzer {
+    private readonly inner;
+    constructor(options: AnalyzerOptions);
+    push(samples: Float32Array): boolean;
+    sampleRate(): number;
+    level(): number;
+    bpm(): number;
+    spectrum(): Float32Array;
+    waveform(): Float32Array;
+    beatOffsets(bpm: number): Float32Array;
+    bandLevel(low: number, high: number): number;
+    bpmRangeMin(): number;
+    setBpmRangeMin(min: number): void;
+    setBpmEnabled(enabled: boolean): void;
+    setSpectrumGain(gain: number): void;
+    setSpectrumCompression(compression: number): void;
+    reset(): void;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare function createAnalyzer(options: AnalyzerOptions): Analyzer;

package/dist/index.js

@@ -0,0 +1,34 @@
+import init, { Analyzer as WasmAnalyzer } from '../dist/wasm/beatd.js';
+const wasmUrl = new URL('./wasm/beatd_bg.wasm', import.meta.url);
+if (wasmUrl.protocol === 'file:') {
+    const { readFile } = await import('node:fs/promises');
+    await init({ module_or_path: await readFile(wasmUrl) });
+}
+else {
+    await init({ module_or_path: wasmUrl });
+}
+export class Analyzer {
+    inner;
+    constructor(options) {
+        this.inner = new WasmAnalyzer(options.sampleRate);
+    }
+    push(samples) { return this.inner.push(samples); }
+    sampleRate() { return this.inner.sample_rate(); }
+    level() { return this.inner.level(); }
+    bpm() { return this.inner.bpm(); }
+    spectrum() { return this.inner.spectrum(); }
+    waveform() { return this.inner.waveform(); }
+    beatOffsets(bpm) { return this.inner.beat_offsets(bpm); }
+    bandLevel(low, high) { return this.inner.band_level(low, high); }
+    bpmRangeMin() { return this.inner.bpm_range_min(); }
+    setBpmRangeMin(min) { this.inner.set_bpm_range_min(min); }
+    setBpmEnabled(enabled) { this.inner.set_bpm_enabled(enabled); }
+    setSpectrumGain(gain) { this.inner.set_spectrum_gain(gain); }
+    setSpectrumCompression(compression) { this.inner.set_spectrum_compression(compression); }
+    reset() { this.inner.reset(); }
+    dispose() { this.inner.free(); }
+    [Symbol.dispose]() { this.dispose(); }
+}
+export function createAnalyzer(options) {
+    return new Analyzer(options);
+}

package/dist/wasm/README.md

@@ -0,0 +1,149 @@
+# beatd
+
+[![CI](https://github.com/nuskey8/beatd/actions/workflows/ci.yml/badge.svg)](https://github.com/nuskey8/beatd/avctions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/nuskey8/beatd)](https://github.com/nuskey8/beatd/releases/latest)
+[![crates.io](https://img.shields.io/crates/v/beatd)](https://crates.io/crates/beatd)
+[![npm](https://img.shields.io/npm/v/beatd-js)](https://www.npmjs.com/package/beatd-js)
+[![NuGet](https://img.shields.io/nuget/v/Beatd)](https://www.nuget.org/packages/Beatd)
+[![Unity](https://img.shields.io/badge/Unity-6000.0%2B-black?logo=unity)](https://github.com/nuskey8/beatd/tree/main/beatd-dotnet/Beatd.Unity/Packages/com.nuskey8.beatd.unity)
+
+English | [日本語](https://github.com/nuskey8/beatd/blob/main/README.ja.md)
+
+GUI application and library for streaming audio analysis and OSC conversion.
+
+![hero](https://raw.githubusercontent.com/nuskey8/beatd/main/assets/hero.png)
+
+## Overview
+
+beatd is a cross-platform application and library for streaming audio analysis.
+
+It started with the concept of being a modern reimplementation of [Sound2Light](https://github.com/ETCLabs/Sound2Light), utilizing a Rust implementation to create an easy-to-use, cross-platform GUI. It can send audio analysis results via OSC to integrate with external VJ software and similar tools.
+
+Additionally, the core analysis engine is provided as an independent library so that it can be embedded into applications for Rust, C, C# (.NET/Unity), and JavaScript (WebAssembly).
+
+## Screenshot
+
+![img](https://raw.githubusercontent.com/nuskey8/beatd/main/assets/img1.png)
+
+## Installation
+
+Select the latest release from GitHub [Releases](https://github.com/nuskey8/beatd/releases/latest) and download the executable file for your operating system.
+
+## libbeatd
+
+The streaming audio analysis in beatd is implemented in Rust as an independent crate. By embedding this, you can use features such as BPM analysis within your applications.
+
+### Rust
+
+Add the crate via cargo.
+
+```sh
+cargo add beatd
+```
+
+```rust
+use beatd::Analyzer;
+
+let mut analyzer = Analyzer::new(48_000);
+
+// samples: &[f32] (-1.0 to 1.0)
+analyzer.push(&samples);
+
+let level = analyzer.level();
+let bpm = analyzer.bpm();
+let spectrum = analyzer.spectrum();
+let waveform = analyzer.waveform();
+let beats = analyzer.beat_offsets(bpm);
+```
+
+### C
+
+Build the library with the `ffi` feature enabled.
+
+```sh
+cargo build -p beatd --features ffi
+```
+
+Add the generated `libbeatd.so` / `libbeatd.dylib` / `beatd.dll` along with `beatd/beatd.h` to your project, and specify `-lbeatd` during linking.
+
+```c
+#include "beatd.h"
+
+beatd_analyzer *analyzer = beatd_new(48000);
+if (analyzer == NULL) {
+    return 1;
+}
+
+beatd_set_bpm_range_min(analyzer, 75);
+beatd_push(analyzer, samples, count);
+
+float level = beatd_level(analyzer);
+float bpm = beatd_bpm(analyzer);
+
+float spectrum[1024];
+size_t bins = beatd_spectrum(analyzer, spectrum, 1024);
+
+beatd_free(analyzer);
+```
+
+### JavaScript
+
+Add the library via npm.
+
+```sh
+npm i beatd-js
+```
+
+```js
+import { createAnalyzer } from "beatd-js";
+
+using analyzer = createAnalyzer({ sampleRate: 48000 });
+
+// samples: Float32Array
+analyzer.push(samples);
+
+console.log(analyzer.level(), analyzer.bpm());
+console.log(analyzer.spectrum());
+console.log(analyzer.waveform());
+console.log(analyzer.beatOffsets(analyzer.bpm()));
+```
+
+### C# / Unity
+
+For .NET projects, you can add the package from NuGet.
+
+```sh
+dotnet package add Beatd
+```
+
+For Unity, you can add the package from the Package Manager using the git URL.
+
+```
+https://github.com/nuskey8/beatd.git?path=beatd-dotnet/Beatd.Unity/Packages/com.nuskey8.beatd.unity
+```
+
+```csharp
+using Beatd;
+
+using var analyzer = new BeatdAnalyzer(48_000);
+analyzer.BpmRangeMin = 75;
+
+analyzer.Push(samples); // ReadOnlySpan<float>
+
+Console.WriteLine($"{analyzer.Level}, {analyzer.Bpm}");
+float[] spectrum = analyzer.GetSpectrum();
+float[] beats = analyzer.GetBeatOffsets(analyzer.Bpm);
+```
+
+Please note that the .NET/Unity version currently supports only the following platforms:
+
+| Platform            | RID         | .NET (NuGet) | Unity |
+| :------------------ | :---------- | :----------: | :---: |
+| Windows x64         | `win-x64`   |      ✅      |  ✅   |
+| Linux x64           | `linux-x64` |      ✅      |  ✅   |
+| macOS Intel         | `osx-x64`   |      ✅      |  ✅   |
+| macOS Apple Silicon | `osx-arm64` |      ✅      |  ✅   |
+
+## License
+
+beatd is released under the [MIT License](https://github.com/nuskey8/beatd/blob/main/LICENSE).

package/dist/wasm/beatd.d.ts

@@ -0,0 +1,71 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export class Analyzer {
+    free(): void;
+    [Symbol.dispose](): void;
+    band_level(low: number, high: number): number;
+    beat_offsets(bpm: number): Float32Array;
+    bpm(): number;
+    bpm_range_min(): number;
+    level(): number;
+    constructor(sample_rate: number);
+    push(samples: Float32Array | number[]): boolean;
+    reset(): void;
+    sample_rate(): number;
+    set_bpm_enabled(enabled: boolean): void;
+    set_bpm_range_min(min: number): void;
+    set_spectrum_compression(compression: number): void;
+    set_spectrum_gain(gain: number): void;
+    spectrum(): Float32Array;
+    waveform(): Float32Array;
+}
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_analyzer_free: (a: number, b: number) => void;
+    readonly analyzer_band_level: (a: number, b: number, c: number) => number;
+    readonly analyzer_beat_offsets: (a: number, b: number) => [number, number];
+    readonly analyzer_bpm: (a: number) => number;
+    readonly analyzer_bpm_range_min: (a: number) => number;
+    readonly analyzer_level: (a: number) => number;
+    readonly analyzer_new: (a: number) => [number, number, number];
+    readonly analyzer_push: (a: number, b: number, c: number) => number;
+    readonly analyzer_reset: (a: number) => void;
+    readonly analyzer_sample_rate: (a: number) => number;
+    readonly analyzer_set_bpm_enabled: (a: number, b: number) => void;
+    readonly analyzer_set_bpm_range_min: (a: number, b: number) => [number, number];
+    readonly analyzer_set_spectrum_compression: (a: number, b: number) => void;
+    readonly analyzer_set_spectrum_gain: (a: number, b: number) => void;
+    readonly analyzer_spectrum: (a: number) => [number, number];
+    readonly analyzer_waveform: (a: number) => [number, number];
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;

package/dist/wasm/beatd.js

@@ -0,0 +1,321 @@
+/* @ts-self-types="./beatd.d.ts" */
+
+export class Analyzer {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        AnalyzerFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_analyzer_free(ptr, 0);
+    }
+    /**
+     * @param {number} low
+     * @param {number} high
+     * @returns {number}
+     */
+    band_level(low, high) {
+        const ret = wasm.analyzer_band_level(this.__wbg_ptr, low, high);
+        return ret;
+    }
+    /**
+     * @param {number} bpm
+     * @returns {Float32Array}
+     */
+    beat_offsets(bpm) {
+        const ret = wasm.analyzer_beat_offsets(this.__wbg_ptr, bpm);
+        var v1 = getArrayF32FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @returns {number}
+     */
+    bpm() {
+        const ret = wasm.analyzer_bpm(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @returns {number}
+     */
+    bpm_range_min() {
+        const ret = wasm.analyzer_bpm_range_min(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @returns {number}
+     */
+    level() {
+        const ret = wasm.analyzer_level(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @param {number} sample_rate
+     */
+    constructor(sample_rate) {
+        const ret = wasm.analyzer_new(sample_rate);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
+        AnalyzerFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * @param {Float32Array | number[]} samples
+     * @returns {boolean}
+     */
+    push(samples) {
+        const ptr0 = passArrayF32ToWasm0(samples, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.analyzer_push(this.__wbg_ptr, ptr0, len0);
+        return ret !== 0;
+    }
+    reset() {
+        wasm.analyzer_reset(this.__wbg_ptr);
+    }
+    /**
+     * @returns {number}
+     */
+    sample_rate() {
+        const ret = wasm.analyzer_sample_rate(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * @param {boolean} enabled
+     */
+    set_bpm_enabled(enabled) {
+        wasm.analyzer_set_bpm_enabled(this.__wbg_ptr, enabled);
+    }
+    /**
+     * @param {number} min
+     */
+    set_bpm_range_min(min) {
+        const ret = wasm.analyzer_set_bpm_range_min(this.__wbg_ptr, min);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * @param {number} compression
+     */
+    set_spectrum_compression(compression) {
+        wasm.analyzer_set_spectrum_compression(this.__wbg_ptr, compression);
+    }
+    /**
+     * @param {number} gain
+     */
+    set_spectrum_gain(gain) {
+        wasm.analyzer_set_spectrum_gain(this.__wbg_ptr, gain);
+    }
+    /**
+     * @returns {Float32Array}
+     */
+    spectrum() {
+        const ret = wasm.analyzer_spectrum(this.__wbg_ptr);
+        var v1 = getArrayF32FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @returns {Float32Array}
+     */
+    waveform() {
+        const ret = wasm.analyzer_waveform(this.__wbg_ptr);
+        var v1 = getArrayF32FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+}
+if (Symbol.dispose) Analyzer.prototype[Symbol.dispose] = Analyzer.prototype.free;
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+        __wbg_Error_208446807d0d1e30: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
+        __wbg___wbindgen_throw_4c88d8bf264fd984: function(arg0, arg1) {
+            throw new Error(getStringFromWasm0(arg0, arg1));
+        },
+        __wbindgen_init_externref_table: function() {
+            const table = wasm.__wbindgen_externrefs;
+            table.set(0, undefined);
+            table.set(1024, undefined);
+            table.set(1025, null);
+            table.set(1026, true);
+            table.set(1027, false);
+        },
+    };
+    return {
+        __proto__: null,
+        "./beatd_bg.js": import0,
+    };
+}
+
+const AnalyzerFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_analyzer_free(ptr, 1));
+
+function getArrayF32FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getFloat32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
+}
+
+let cachedFloat32ArrayMemory0 = null;
+function getFloat32ArrayMemory0() {
+    if (cachedFloat32ArrayMemory0 === null || cachedFloat32ArrayMemory0.byteLength === 0) {
+        cachedFloat32ArrayMemory0 = new Float32Array(wasm.memory.buffer);
+    }
+    return cachedFloat32ArrayMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return decodeText(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function passArrayF32ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 4, 4) >>> 0;
+    getFloat32ArrayMemory0().set(arg, ptr / 4);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(bytes) {
+    numBytesDecoded += bytes.length;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = bytes.length;
+    }
+    return cachedTextDecoder.decode(bytes);
+}
+
+let WASM_VECTOR_LEN = 0;
+
+let wasmModule, wasmInstance, wasm;
+function __wbg_finalize_init(instance, module) {
+    wasmInstance = instance;
+    wasm = instance.exports;
+    wasmModule = module;
+    cachedFloat32ArrayMemory0 = null;
+    cachedUint8ArrayMemory0 = null;
+    wasm.__wbindgen_start();
+    return wasm;
+}
+
+async function __wbg_load(module, imports) {
+    if (typeof Response === 'function' && module instanceof Response) {
+        if (!module.ok) {
+            throw new Error(`failed to fetch Wasm: ${module.status} ${module.statusText} fetching '${module.url}'`);
+        }
+
+        if (typeof WebAssembly.instantiateStreaming === 'function') {
+            try {
+                return await WebAssembly.instantiateStreaming(module, imports);
+            } catch (e) {
+                const validResponse = expectedResponseType(module.type);
+
+                if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
+                    console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
+
+                } else { throw e; }
+            }
+        }
+
+        const bytes = await module.arrayBuffer();
+        return await WebAssembly.instantiate(bytes, imports);
+    } else {
+        const instance = await WebAssembly.instantiate(module, imports);
+
+        if (instance instanceof WebAssembly.Instance) {
+            return { instance, module };
+        } else {
+            return instance;
+        }
+    }
+
+    function expectedResponseType(type) {
+        switch (type) {
+            case 'basic': case 'cors': case 'default': return true;
+        }
+        return false;
+    }
+}
+
+function initSync(module) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module !== undefined) {
+        if (Object.getPrototypeOf(module) === Object.prototype) {
+            ({module} = module)
+        } else {
+            console.warn('using deprecated parameters for `initSync()`; pass a single object instead')
+        }
+    }
+
+    const imports = __wbg_get_imports();
+    if (!(module instanceof WebAssembly.Module)) {
+        module = new WebAssembly.Module(module);
+    }
+    const instance = new WebAssembly.Instance(module, imports);
+    return __wbg_finalize_init(instance, module);
+}
+
+let __wbg_init_promise;
+async function __wbg_init(module_or_path) {
+    if (wasm !== undefined) return wasm;
+    if (__wbg_init_promise === undefined) {
+        __wbg_init_promise = __wbg_init_once(module_or_path);
+        __wbg_init_promise.catch(() => { __wbg_init_promise = undefined; });
+    }
+    return __wbg_init_promise;
+}
+
+async function __wbg_init_once(module_or_path) {
+
+    if (module_or_path !== undefined) {
+        if (Object.getPrototypeOf(module_or_path) === Object.prototype) {
+            ({module_or_path} = module_or_path)
+        } else {
+            console.warn('using deprecated parameters for the initialization function; pass a single object instead')
+        }
+    }
+
+    if (module_or_path === undefined) {
+        module_or_path = new URL('beatd_bg.wasm', import.meta.url);
+    }
+    const imports = __wbg_get_imports();
+
+    if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {
+        module_or_path = fetch(module_or_path);
+    }
+
+    const { instance, module } = await __wbg_load(await module_or_path, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+export { initSync, __wbg_init as default };

package/dist/wasm/beatd_bg.wasm.d.ts

@@ -0,0 +1,24 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_analyzer_free: (a: number, b: number) => void;
+export const analyzer_band_level: (a: number, b: number, c: number) => number;
+export const analyzer_beat_offsets: (a: number, b: number) => [number, number];
+export const analyzer_bpm: (a: number) => number;
+export const analyzer_bpm_range_min: (a: number) => number;
+export const analyzer_level: (a: number) => number;
+export const analyzer_new: (a: number) => [number, number, number];
+export const analyzer_push: (a: number, b: number, c: number) => number;
+export const analyzer_reset: (a: number) => void;
+export const analyzer_sample_rate: (a: number) => number;
+export const analyzer_set_bpm_enabled: (a: number, b: number) => void;
+export const analyzer_set_bpm_range_min: (a: number, b: number) => [number, number];
+export const analyzer_set_spectrum_compression: (a: number, b: number) => void;
+export const analyzer_set_spectrum_gain: (a: number, b: number) => void;
+export const analyzer_spectrum: (a: number) => [number, number];
+export const analyzer_waveform: (a: number) => [number, number];
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_start: () => void;

package/dist/wasm/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "beatd",
+  "type": "module",
+  "description": "A cross-platform library for Streaming audio analysis.",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nuskey8/beatd"
+  },
+  "files": [
+    "beatd_bg.wasm",
+    "beatd.js",
+    "beatd.d.ts"
+  ],
+  "main": "beatd.js",
+  "homepage": "https://github.com/nuskey8/beatd",
+  "types": "beatd.d.ts",
+  "sideEffects": [
+    "./snippets/*"
+  ],
+  "keywords": [
+    "audio",
+    "bpm",
+    "beat-detection",
+    "fft",
+    "wasm"
+  ]
+}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "beatd-js",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "beatd bindings for JavaScript",
+  "license": "MIT",
+  "author": "nuskey",
+  "homepage": "https://github.com/nuskey8/beatd#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nuskey8/beatd.git",
+    "directory": "beatd-js"
+  },
+  "bugs": {
+    "url": "https://github.com/nuskey8/beatd/issues"
+  },
+  "keywords": [
+    "audio",
+    "bpm",
+    "beat",
+    "analysis",
+    "webassembly",
+    "wasm"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "wasm-pack build ../beatd --target web --out-dir ../beatd-js/dist/wasm -- --features wasm && rm -f dist/wasm/.gitignore && tsc",
+    "test": "bun test",
+    "prepack": "bun run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.0.0"
+  }
+}