waa-play 0.1.1 → 0.2.1

package/README.md

@@ -1,163 +1,80 @@
 # waa-play
 
 [![npm version](https://img.shields.io/npm/v/waa-play)](https://www.npmjs.com/package/waa-play)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 
-Composable Web Audio API utilities.
+Web Audio API modules with WSOLA time-stretching, chunk-based streaming, and waveform extraction
 
-BYO AudioContext / Zero Dependencies / Framework-agnostic / Sample-accurate / Pitch-preserving time-stretch / Chunk-based streaming
+waa-play は Web Audio API を用いた音声操作のためのモジュール群です。ピッチ保持タイムストレッチ、ストリーミング再生、波形抽出、AudioNode チェーン接続などの機能を提供します。
 
-**[Demo](https://ivgtr.github.io/waa/)**
+Web Audio API の `playbackRate` で再生速度を変更するとピッチも連動して変化します。waa-play は、ピッチを保持したまま再生速度を変えたいユースケースのために作成しました。
 
-## Features
+この実装は完璧なものではなく、すべてのユースケースに対応するわけではないことに注意してください。
 
-再生からピッチ保持タイムストレッチまで、必要な機能を関数単位で組み合わせられる Web Audio ライブラリです。
+## Documentation & Demo
 
-- **BYO AudioContext** — AudioContext を外から渡す設計で、他のライブラリとの共存が容易
-- **Composable** — モノリシックな Player クラスではなく、小さな関数を組み合わせて利用
-- **Zero Dependencies** — Web Audio API のみに依存、バンドルサイズを最小化
-- **Framework-agnostic** — React / Vue / Svelte / Vanilla JS のどれでも同じ API で動作
-- **TypeScript-first** — 完全な型定義により、エディタ補完で快適に開発
-- **Sample-accurate** — `AudioContext.currentTime` ベースの精密な再生位置追跡
-- **Tree-shakeable** — 使う関数だけがバンドルに含まれる
-- **Pitch-preserving time-stretch** — WSOLA アルゴリズムによるテンポ変更を Web Worker で処理
-- **Chunk-based streaming** — 音声をチャンク分割で逐次処理し、低スペック環境でも安定動作
+https://ivgtr.github.io/waa/
 
-## Install
+## ピッチ保持タイムストレッチ（WSOLA）
 
-```bash
-npm install waa-play
-```
+waa-play は WSOLA (Waveform Similarity Overlap-Add) アルゴリズムを採用しています。
+音声信号を小さなフレームに分割し、類似した波形を重ね合わせて再構築することで、ピッチを変えずに時間的な伸縮を実現します。
 
-## Quick Start
+HTML5 Audio 要素の `preservePitch` オプションと同様の効果を目指していますが、いくつかの制約があります。
+WSOLA の処理はクライアントサイドで行われるため、CPU リソースを多く消費する可能性があります。
+また、AudioBuffer 全体を事前に読み込む必要があるため、長い音声ファイルでは変換に時間がかかる場合があります。
 
-```ts
-import { createContext, loadBuffer, play, createGain } from "waa-play";
+これらの制約に対して、Worker による並列処理やチャンクベースのストリーミングで対処しています。
 
-const ctx = createContext();
-const buffer = await loadBuffer(ctx, "/audio/track.mp3");
+### Worker ベースの変換
 
-const gain = createGain(ctx, 0.8);
-const playback = play(ctx, buffer, { through: [gain] });
+WSOLA 変換は Web Worker 内で実行され、メインスレッドのパフォーマンスへの影響を最小限に抑えています。
+Worker は複数生成され、変換タスクがキューイングされて効率的に処理されます。
 
-playback.on("timeupdate", ({ position, duration }) => {
-  console.log(`${position.toFixed(1)}s / ${duration.toFixed(1)}s`);
-});
+### チャンクベースのストリーミング再生
 
-playback.pause();
-playback.seek(30);
-playback.resume();
-```
+変換済みの音声がチャンク単位で順次再生されます。
+これにより、長時間の音声でもすべての変換を待つことなく、スムーズな再生が可能です。
 
-## Usage Examples
+### イベント通知
 
-### オーディオグラフの構築
+再生位置の更新や再生終了などのイベントが通知され、UI の更新や他の処理に利用できます。
 
-```ts
-import { createGain, createFilter, createPanner, chain } from "waa-play";
-
-const gain = createGain(ctx, 0.8);
-const lowpass = createFilter(ctx, { type: "lowpass", frequency: 2000 });
-const panner = createPanner(ctx, -0.5);
-
-chain(sourceNode, gain, lowpass, panner);
-panner.connect(ctx.destination);
-```
-
-### 波形の描画
-
-```ts
-import { extractPeaks } from "waa-play";
+## Quick Start
 
-const peaks = extractPeaks(buffer, { resolution: 500 });
-peaks.forEach((peak, i) => {
-  ctx2d.fillRect(i * barWidth, canvas.height * (1 - peak), barWidth - 1, canvas.height * peak);
-});
+```bash
+npm install waa-play
 ```
 
-### React で使う
-
-```tsx
-import { useSyncExternalStore, useCallback } from "react";
-import { subscribeSnapshot, getSnapshot, type Playback } from "waa-play";
-
-function usePlayback(playback: Playback | null) {
-  const subscribe = useCallback(
-    (cb: () => void) => {
-      if (!playback) return () => {};
-      return subscribeSnapshot(playback, cb);
-    },
-    [playback],
-  );
-  return useSyncExternalStore(
-    subscribe,
-    () => (playback ? getSnapshot(playback) : null),
-  );
-}
-```
+### 最も簡単な使い方（WaaPlayer）
 
-### ピッチを保持したままテンポを変更
+`WaaPlayer` が `AudioContext` を内部管理し、全モジュールの機能を統合して提供します。
 
 ```ts
-import { createContext, loadBuffer, play, onFrame } from "waa-play";
+import { WaaPlayer } from "waa-play";
 
-const ctx = createContext();
-const buffer = await loadBuffer(ctx, "/audio/track.mp3");
+const player = new WaaPlayer();
+const buffer = await player.load("/audio/track.mp3");
 
-// preservePitch: true を渡すだけでピッチ保持タイムストレッチが有効に
-const playback = play(ctx, buffer, {
-  playbackRate: 0.75,     // テンポ 75%（スロー再生）
-  preservePitch: true,    // ピッチは変わらない
-});
+const gain = player.createGain(0.8);
+const playback = player.play(buffer, { through: [gain] }); // 再生
 
-// 再生中にテンポを変更
-playback.setPlaybackRate(1.25); // テンポ 125%（高速再生）
+playback.setPlaybackRate(1.5); // 再生速度を 1.5 倍に変更（リアルタイム反映）
 
-// stretcher の状態を監視
-const stopLoop = onFrame(playback, (snapshot) => {
-  if (snapshot.stretcher) {
-    console.log(`変換進捗: ${(snapshot.stretcher.conversionProgress * 100).toFixed(0)}%`);
-    console.log(`バッファ: ${snapshot.stretcher.bufferHealth}`);
-  }
+playback.on("timeupdate", ({ position, duration }) => {
+  console.log(`${position.toFixed(2)}s / ${duration.toFixed(2)}s`);
 });
-```
-
-### 他のライブラリの AudioContext を使う
-
-```ts
-import { play, loadBuffer } from "waa-play";
-import { Tone } from "tone";
 
-const ctx = Tone.context.rawContext;
-const buffer = await loadBuffer(ctx, "/audio/track.mp3");
-play(ctx, buffer);
+playback.dispose(); // 再生停止・リソース解放
 ```
 
-## Modules
-
-必要なものだけ import できます。
+既存の `AudioContext` を渡すこともできます。これは例えば、他の AudioNode と接続したい場合に有用です。
 
 ```ts
-import { play } from "waa-play/play";
-import { loadBuffer } from "waa-play/buffer";
-import { extractPeaks } from "waa-play/waveform";
+const player = new WaaPlayer(existingAudioContext);
 ```
 
-| Module | 概要 |
-|--------|------|
-| `context` | AudioContext のライフサイクル管理 |
-| `buffer` | 音声ファイルのロード・デコード |
-| `play` | 再生制御（play / pause / seek / loop / preservePitch） |
-| `emitter` | 型安全なイベントエミッター |
-| `nodes` | AudioNode のファクトリとチェーン接続 |
-| `waveform` | 波形データの抽出（ピーク・RMS） |
-| `fade` | フェード処理（in / out / crossfade） |
-| `scheduler` | スケジューリングと BPM ベースのクロック |
-| `synth` | 波形バッファの生成（sin / noise / click） |
-| `adapters` | フレームワーク統合（React / Vue / Svelte） |
-| `stretcher` | ピッチ保持タイムストレッチ（WSOLA） |
-
 ## License
 
-MIT
+MIT © [ivgtr](https://github.com/ivgtr)
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/ivgtr?style=social)](https://twitter.com/ivgtr) [![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)

package/dist/adapters.cjs

@@ -1,28 +1,28 @@
 'use strict';
 
-var chunkHTGOHC73_cjs = require('./chunk-HTGOHC73.cjs');
+var chunkOZN5X4N6_cjs = require('./chunk-OZN5X4N6.cjs');
 
 
 
 Object.defineProperty(exports, "getSnapshot", {
   enumerable: true,
-  get: function () { return chunkHTGOHC73_cjs.getSnapshot; }
+  get: function () { return chunkOZN5X4N6_cjs.getSnapshot; }
 });
 Object.defineProperty(exports, "onFrame", {
   enumerable: true,
-  get: function () { return chunkHTGOHC73_cjs.onFrame; }
+  get: function () { return chunkOZN5X4N6_cjs.onFrame; }
 });
 Object.defineProperty(exports, "subscribeSnapshot", {
   enumerable: true,
-  get: function () { return chunkHTGOHC73_cjs.subscribeSnapshot; }
+  get: function () { return chunkOZN5X4N6_cjs.subscribeSnapshot; }
 });
 Object.defineProperty(exports, "whenEnded", {
   enumerable: true,
-  get: function () { return chunkHTGOHC73_cjs.whenEnded; }
+  get: function () { return chunkOZN5X4N6_cjs.whenEnded; }
 });
 Object.defineProperty(exports, "whenPosition", {
   enumerable: true,
-  get: function () { return chunkHTGOHC73_cjs.whenPosition; }
+  get: function () { return chunkOZN5X4N6_cjs.whenPosition; }
 });
 //# sourceMappingURL=adapters.cjs.map
 //# sourceMappingURL=adapters.cjs.map

package/dist/adapters.d.cts

@@ -1,8 +1,14 @@
-import { e as Playback, g as PlaybackSnapshot } from './types-DUrbEbPl.cjs';
+import { e as Playback, g as PlaybackSnapshot } from './types-BYC6m7Q0.cjs';
 
 /**
  * Get an immutable snapshot of the current playback state.
  * Designed for use with React's `useSyncExternalStore` or similar patterns.
+ *
+ * Always returns a referentially stable (cached) object. The cache is updated
+ * by `subscribeSnapshot` (on playback events) and `onFrame` (every animation
+ * frame), so `getSnapshot` itself never computes a fresh snapshot — it only
+ * reads or initialises the cache. This guarantees the reference-equality
+ * contract required by `useSyncExternalStore`.
  */
 declare function getSnapshot(playback: Playback): PlaybackSnapshot;
 /**
@@ -14,10 +20,16 @@ declare function getSnapshot(playback: Playback): PlaybackSnapshot;
  *
  * ```ts
  * // React example:
- * const snap = useSyncExternalStore(
- *   (cb) => subscribeSnapshot(playback, cb),
+ * import { useCallback } from "react";
+ * const subscribe = useCallback(
+ *   (cb: () => void) => subscribeSnapshot(playback, cb),
+ *   [playback],
+ * );
+ * const snap = useCallback(
  *   () => getSnapshot(playback),
+ *   [playback],
  * );
+ * const snapshot = useSyncExternalStore(subscribe, snap, snap);
  * ```
  */
 declare function subscribeSnapshot(playback: Playback, callback: () => void): () => void;

package/dist/adapters.d.ts

@@ -1,8 +1,14 @@
-import { e as Playback, g as PlaybackSnapshot } from './types-DUrbEbPl.js';
+import { e as Playback, g as PlaybackSnapshot } from './types-BYC6m7Q0.js';
 
 /**
  * Get an immutable snapshot of the current playback state.
  * Designed for use with React's `useSyncExternalStore` or similar patterns.
+ *
+ * Always returns a referentially stable (cached) object. The cache is updated
+ * by `subscribeSnapshot` (on playback events) and `onFrame` (every animation
+ * frame), so `getSnapshot` itself never computes a fresh snapshot — it only
+ * reads or initialises the cache. This guarantees the reference-equality
+ * contract required by `useSyncExternalStore`.
  */
 declare function getSnapshot(playback: Playback): PlaybackSnapshot;
 /**
@@ -14,10 +20,16 @@ declare function getSnapshot(playback: Playback): PlaybackSnapshot;
  *
  * ```ts
  * // React example:
- * const snap = useSyncExternalStore(
- *   (cb) => subscribeSnapshot(playback, cb),
+ * import { useCallback } from "react";
+ * const subscribe = useCallback(
+ *   (cb: () => void) => subscribeSnapshot(playback, cb),
+ *   [playback],
+ * );
+ * const snap = useCallback(
  *   () => getSnapshot(playback),
+ *   [playback],
  * );
+ * const snapshot = useSyncExternalStore(subscribe, snap, snap);
  * ```
  */
 declare function subscribeSnapshot(playback: Playback, callback: () => void): () => void;

package/dist/adapters.js

@@ -1,3 +1,3 @@
-export { getSnapshot, onFrame, subscribeSnapshot, whenEnded, whenPosition } from './chunk-AGP2IRC6.js';
+export { getSnapshot, onFrame, subscribeSnapshot, whenEnded, whenPosition } from './chunk-JIHPQAEA.js';
 //# sourceMappingURL=adapters.js.map
 //# sourceMappingURL=adapters.js.map

package/dist/buffer.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunkCPAT75WD_cjs = require('./chunk-CPAT75WD.cjs');
+var chunk3VTU5OX5_cjs = require('./chunk-3VTU5OX5.cjs');
 
 
 
 Object.defineProperty(exports, "getBufferInfo", {
   enumerable: true,
-  get: function () { return chunkCPAT75WD_cjs.getBufferInfo; }
+  get: function () { return chunk3VTU5OX5_cjs.getBufferInfo; }
 });
 Object.defineProperty(exports, "loadBuffer", {
   enumerable: true,
-  get: function () { return chunkCPAT75WD_cjs.loadBuffer; }
+  get: function () { return chunk3VTU5OX5_cjs.loadBuffer; }
 });
 Object.defineProperty(exports, "loadBufferFromBlob", {
   enumerable: true,
-  get: function () { return chunkCPAT75WD_cjs.loadBufferFromBlob; }
+  get: function () { return chunk3VTU5OX5_cjs.loadBufferFromBlob; }
 });
 Object.defineProperty(exports, "loadBuffers", {
   enumerable: true,
-  get: function () { return chunkCPAT75WD_cjs.loadBuffers; }
+  get: function () { return chunk3VTU5OX5_cjs.loadBuffers; }
 });
 //# sourceMappingURL=buffer.cjs.map
 //# sourceMappingURL=buffer.cjs.map

package/dist/buffer.d.cts

@@ -1,4 +1,4 @@
-import { B as BufferInfo, L as LoadBufferOptions } from './types-DUrbEbPl.cjs';
+import { B as BufferInfo, L as LoadBufferOptions } from './types-BYC6m7Q0.cjs';
 
 /**
  * Fetch an audio file from a URL and decode it into an `AudioBuffer`.

package/dist/buffer.d.ts

@@ -1,4 +1,4 @@
-import { B as BufferInfo, L as LoadBufferOptions } from './types-DUrbEbPl.js';
+import { B as BufferInfo, L as LoadBufferOptions } from './types-BYC6m7Q0.js';
 
 /**
  * Fetch an audio file from a URL and decode it into an `AudioBuffer`.

package/dist/buffer.js

@@ -1,3 +1,3 @@
-export { getBufferInfo, loadBuffer, loadBufferFromBlob, loadBuffers } from './chunk-T74FBKTY.js';
+export { getBufferInfo, loadBuffer, loadBufferFromBlob, loadBuffers } from './chunk-2FGUFHZM.js';
 //# sourceMappingURL=buffer.js.map
 //# sourceMappingURL=buffer.js.map

package/dist/{chunk-T74FBKTY.js → chunk-2FGUFHZM.js}

@@ -51,5 +51,5 @@ function getBufferInfo(buffer) {
 }
 
 export { getBufferInfo, loadBuffer, loadBufferFromBlob, loadBuffers };
-//# sourceMappingURL=chunk-T74FBKTY.js.map
-//# sourceMappingURL=chunk-T74FBKTY.js.map
+//# sourceMappingURL=chunk-2FGUFHZM.js.map
+//# sourceMappingURL=chunk-2FGUFHZM.js.map

package/dist/chunk-2FGUFHZM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/buffer.ts"],"names":[],"mappings":";AAeA,eAAsB,UAAA,CACpB,GAAA,EACA,GAAA,EACA,OAAA,EACsB;AACtB,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAChC,EAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,IAAA,MAAM,IAAI,MAAM,CAAA,uBAAA,EAA0B,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,EACpF;AAEA,EAAA,IAAI,OAAA,EAAS,cAAc,QAAA,CAAS,IAAA,IAAQ,SAAS,OAAA,CAAQ,GAAA,CAAI,gBAAgB,CAAA,EAAG;AAClF,IAAA,MAAM,QAAQ,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,gBAAgB,CAAC,CAAA;AAC3D,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,IAAA,CAAK,SAAA,EAAU;AACvC,IAAA,MAAM,SAAuB,EAAC;AAC9B,IAAA,IAAI,QAAA,GAAW,CAAA;AAEf,IAAA,WAAS;AACP,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACV,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AACjB,MAAA,QAAA,IAAY,KAAA,CAAM,UAAA;AAClB,MAAA,OAAA,CAAQ,UAAA,CAAW,KAAA,GAAQ,CAAA,GAAI,QAAA,GAAW,QAAQ,CAAC,CAAA;AAAA,IACrD;AAEA,IAAA,MAAM,MAAA,GAAS,IAAI,UAAA,CAAW,QAAQ,CAAA;AACtC,IAAA,IAAI,MAAA,GAAS,CAAA;AACb,IAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,MAAA,MAAA,CAAO,GAAA,CAAI,OAAO,MAAM,CAAA;AACxB,MAAA,MAAA,IAAU,KAAA,CAAM,UAAA;AAAA,IAClB;AAEA,IAAA,OAAO,GAAA,CAAI,eAAA,CAAgB,MAAA,CAAO,MAAM,CAAA;AAAA,EAC1C;AAEA,EAAA,MAAM,WAAA,GAAc,MAAM,QAAA,CAAS,WAAA,EAAY;AAC/C,EAAA,OAAO,GAAA,CAAI,gBAAgB,WAAW,CAAA;AACxC;AAKA,eAAsB,kBAAA,CAAmB,KAAmB,IAAA,EAAkC;AAC5F,EAAA,MAAM,WAAA,GAAc,MAAM,IAAA,CAAK,WAAA,EAAY;AAC3C,EAAA,OAAO,GAAA,CAAI,gBAAgB,WAAW,CAAA;AACxC;AAaA,eAAsB,WAAA,CACpB,KACA,GAAA,EACmC;AACnC,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAClC,EAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,GAAA;AAAA,IAC5B,QAAQ,GAAA,CAAI,OAAO,CAAC,GAAA,EAAK,GAAG,CAAA,KAAM;AAChC,MAAA,MAAM,MAAA,GAAS,MAAM,UAAA,CAAW,GAAA,EAAK,GAAG,CAAA;AACxC,MAAA,OAAO,CAAC,KAAK,MAAM,CAAA;AAAA,IACrB,CAAC;AAAA,GACH;AACA,EAAA,OAAO,IAAI,IAAI,OAAO,CAAA;AACxB;AAKO,SAAS,cAAc,MAAA,EAAiC;AAC7D,EAAA,OAAO;AAAA,IACL,UAAU,MAAA,CAAO,QAAA;AAAA,IACjB,kBAAkB,MAAA,CAAO,gBAAA;AAAA,IACzB,YAAY,MAAA,CAAO,UAAA;AAAA,IACnB,QAAQ,MAAA,CAAO;AAAA,GACjB;AACF","file":"chunk-2FGUFHZM.js","sourcesContent":["// ---------------------------------------------------------------------------\n// M2: Audio buffer loading utilities\n// ---------------------------------------------------------------------------\n\nimport type { BufferInfo, LoadBufferOptions } from \"./types.js\";\n\n/**\n * Fetch an audio file from a URL and decode it into an `AudioBuffer`.\n *\n * ```ts\n * const buffer = await loadBuffer(ctx, \"/audio/track.mp3\", {\n *   onProgress: (p) => console.log(`${(p * 100).toFixed(0)}%`),\n * });\n * ```\n */\nexport async function loadBuffer(\n  ctx: AudioContext,\n  url: string,\n  options?: LoadBufferOptions,\n): Promise<AudioBuffer> {\n  const response = await fetch(url);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch audio: ${response.status} ${response.statusText}`);\n  }\n\n  if (options?.onProgress && response.body && response.headers.get(\"content-length\")) {\n    const total = Number(response.headers.get(\"content-length\"));\n    const reader = response.body.getReader();\n    const chunks: Uint8Array[] = [];\n    let received = 0;\n\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      chunks.push(value);\n      received += value.byteLength;\n      options.onProgress(total > 0 ? received / total : 0);\n    }\n\n    const merged = new Uint8Array(received);\n    let offset = 0;\n    for (const chunk of chunks) {\n      merged.set(chunk, offset);\n      offset += chunk.byteLength;\n    }\n\n    return ctx.decodeAudioData(merged.buffer);\n  }\n\n  const arrayBuffer = await response.arrayBuffer();\n  return ctx.decodeAudioData(arrayBuffer);\n}\n\n/**\n * Decode an `AudioBuffer` from a `Blob` or `File`.\n */\nexport async function loadBufferFromBlob(ctx: AudioContext, blob: Blob): Promise<AudioBuffer> {\n  const arrayBuffer = await blob.arrayBuffer();\n  return ctx.decodeAudioData(arrayBuffer);\n}\n\n/**\n * Load multiple audio files in parallel.\n *\n * ```ts\n * const buffers = await loadBuffers(ctx, {\n *   kick: \"/samples/kick.wav\",\n *   snare: \"/samples/snare.wav\",\n * });\n * buffers.get(\"kick\"); // AudioBuffer\n * ```\n */\nexport async function loadBuffers(\n  ctx: AudioContext,\n  map: Record<string, string>,\n): Promise<Map<string, AudioBuffer>> {\n  const entries = Object.entries(map);\n  const results = await Promise.all(\n    entries.map(async ([key, url]) => {\n      const buffer = await loadBuffer(ctx, url);\n      return [key, buffer] as const;\n    }),\n  );\n  return new Map(results);\n}\n\n/**\n * Return metadata about an `AudioBuffer`.\n */\nexport function getBufferInfo(buffer: AudioBuffer): BufferInfo {\n  return {\n    duration: buffer.duration,\n    numberOfChannels: buffer.numberOfChannels,\n    sampleRate: buffer.sampleRate,\n    length: buffer.length,\n  };\n}\n"]}

package/dist/{chunk-CPAT75WD.cjs → chunk-3VTU5OX5.cjs}

@@ -56,5 +56,5 @@ exports.getBufferInfo = getBufferInfo;
 exports.loadBuffer = loadBuffer;
 exports.loadBufferFromBlob = loadBufferFromBlob;
 exports.loadBuffers = loadBuffers;
-//# sourceMappingURL=chunk-CPAT75WD.cjs.map
-//# sourceMappingURL=chunk-CPAT75WD.cjs.map
+//# sourceMappingURL=chunk-3VTU5OX5.cjs.map
+//# sourceMappingURL=chunk-3VTU5OX5.cjs.map

package/dist/chunk-3VTU5OX5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/buffer.ts"],"names":[],"mappings":";;;AAeA,eAAsB,UAAA,CACpB,GAAA,EACA,GAAA,EACA,OAAA,EACsB;AACtB,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAChC,EAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,IAAA,MAAM,IAAI,MAAM,CAAA,uBAAA,EAA0B,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,EACpF;AAEA,EAAA,IAAI,OAAA,EAAS,cAAc,QAAA,CAAS,IAAA,IAAQ,SAAS,OAAA,CAAQ,GAAA,CAAI,gBAAgB,CAAA,EAAG;AAClF,IAAA,MAAM,QAAQ,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,gBAAgB,CAAC,CAAA;AAC3D,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,IAAA,CAAK,SAAA,EAAU;AACvC,IAAA,MAAM,SAAuB,EAAC;AAC9B,IAAA,IAAI,QAAA,GAAW,CAAA;AAEf,IAAA,WAAS;AACP,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACV,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AACjB,MAAA,QAAA,IAAY,KAAA,CAAM,UAAA;AAClB,MAAA,OAAA,CAAQ,UAAA,CAAW,KAAA,GAAQ,CAAA,GAAI,QAAA,GAAW,QAAQ,CAAC,CAAA;AAAA,IACrD;AAEA,IAAA,MAAM,MAAA,GAAS,IAAI,UAAA,CAAW,QAAQ,CAAA;AACtC,IAAA,IAAI,MAAA,GAAS,CAAA;AACb,IAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,MAAA,MAAA,CAAO,GAAA,CAAI,OAAO,MAAM,CAAA;AACxB,MAAA,MAAA,IAAU,KAAA,CAAM,UAAA;AAAA,IAClB;AAEA,IAAA,OAAO,GAAA,CAAI,eAAA,CAAgB,MAAA,CAAO,MAAM,CAAA;AAAA,EAC1C;AAEA,EAAA,MAAM,WAAA,GAAc,MAAM,QAAA,CAAS,WAAA,EAAY;AAC/C,EAAA,OAAO,GAAA,CAAI,gBAAgB,WAAW,CAAA;AACxC;AAKA,eAAsB,kBAAA,CAAmB,KAAmB,IAAA,EAAkC;AAC5F,EAAA,MAAM,WAAA,GAAc,MAAM,IAAA,CAAK,WAAA,EAAY;AAC3C,EAAA,OAAO,GAAA,CAAI,gBAAgB,WAAW,CAAA;AACxC;AAaA,eAAsB,WAAA,CACpB,KACA,GAAA,EACmC;AACnC,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAClC,EAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,GAAA;AAAA,IAC5B,QAAQ,GAAA,CAAI,OAAO,CAAC,GAAA,EAAK,GAAG,CAAA,KAAM;AAChC,MAAA,MAAM,MAAA,GAAS,MAAM,UAAA,CAAW,GAAA,EAAK,GAAG,CAAA;AACxC,MAAA,OAAO,CAAC,KAAK,MAAM,CAAA;AAAA,IACrB,CAAC;AAAA,GACH;AACA,EAAA,OAAO,IAAI,IAAI,OAAO,CAAA;AACxB;AAKO,SAAS,cAAc,MAAA,EAAiC;AAC7D,EAAA,OAAO;AAAA,IACL,UAAU,MAAA,CAAO,QAAA;AAAA,IACjB,kBAAkB,MAAA,CAAO,gBAAA;AAAA,IACzB,YAAY,MAAA,CAAO,UAAA;AAAA,IACnB,QAAQ,MAAA,CAAO;AAAA,GACjB;AACF","file":"chunk-3VTU5OX5.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// M2: Audio buffer loading utilities\n// ---------------------------------------------------------------------------\n\nimport type { BufferInfo, LoadBufferOptions } from \"./types.js\";\n\n/**\n * Fetch an audio file from a URL and decode it into an `AudioBuffer`.\n *\n * ```ts\n * const buffer = await loadBuffer(ctx, \"/audio/track.mp3\", {\n *   onProgress: (p) => console.log(`${(p * 100).toFixed(0)}%`),\n * });\n * ```\n */\nexport async function loadBuffer(\n  ctx: AudioContext,\n  url: string,\n  options?: LoadBufferOptions,\n): Promise<AudioBuffer> {\n  const response = await fetch(url);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch audio: ${response.status} ${response.statusText}`);\n  }\n\n  if (options?.onProgress && response.body && response.headers.get(\"content-length\")) {\n    const total = Number(response.headers.get(\"content-length\"));\n    const reader = response.body.getReader();\n    const chunks: Uint8Array[] = [];\n    let received = 0;\n\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      chunks.push(value);\n      received += value.byteLength;\n      options.onProgress(total > 0 ? received / total : 0);\n    }\n\n    const merged = new Uint8Array(received);\n    let offset = 0;\n    for (const chunk of chunks) {\n      merged.set(chunk, offset);\n      offset += chunk.byteLength;\n    }\n\n    return ctx.decodeAudioData(merged.buffer);\n  }\n\n  const arrayBuffer = await response.arrayBuffer();\n  return ctx.decodeAudioData(arrayBuffer);\n}\n\n/**\n * Decode an `AudioBuffer` from a `Blob` or `File`.\n */\nexport async function loadBufferFromBlob(ctx: AudioContext, blob: Blob): Promise<AudioBuffer> {\n  const arrayBuffer = await blob.arrayBuffer();\n  return ctx.decodeAudioData(arrayBuffer);\n}\n\n/**\n * Load multiple audio files in parallel.\n *\n * ```ts\n * const buffers = await loadBuffers(ctx, {\n *   kick: \"/samples/kick.wav\",\n *   snare: \"/samples/snare.wav\",\n * });\n * buffers.get(\"kick\"); // AudioBuffer\n * ```\n */\nexport async function loadBuffers(\n  ctx: AudioContext,\n  map: Record<string, string>,\n): Promise<Map<string, AudioBuffer>> {\n  const entries = Object.entries(map);\n  const results = await Promise.all(\n    entries.map(async ([key, url]) => {\n      const buffer = await loadBuffer(ctx, url);\n      return [key, buffer] as const;\n    }),\n  );\n  return new Map(results);\n}\n\n/**\n * Return metadata about an `AudioBuffer`.\n */\nexport function getBufferInfo(buffer: AudioBuffer): BufferInfo {\n  return {\n    duration: buffer.duration,\n    numberOfChannels: buffer.numberOfChannels,\n    sampleRate: buffer.sampleRate,\n    length: buffer.length,\n  };\n}\n"]}

package/dist/{chunk-2DL7CAEP.js → chunk-7JUVBZ6B.js}

@@ -65,5 +65,5 @@ function createClock(ctx, options) {
 }
 
 export { createClock, createScheduler };
-//# sourceMappingURL=chunk-2DL7CAEP.js.map
-//# sourceMappingURL=chunk-2DL7CAEP.js.map
+//# sourceMappingURL=chunk-7JUVBZ6B.js.map
+//# sourceMappingURL=chunk-7JUVBZ6B.js.map

package/dist/chunk-7JUVBZ6B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scheduler.ts"],"names":[],"mappings":";AA6BO,SAAS,eAAA,CAAgB,KAAmB,OAAA,EAAuC;AACxF,EAAA,MAAM,EAAE,SAAA,GAAY,GAAA,EAAK,WAAW,EAAA,EAAG,GAAI,WAAW,EAAC;AAEvD,EAAA,MAAM,SAA2B,EAAC;AAClC,EAAA,IAAI,OAAA,GAAiD,IAAA;AAErD,EAAA,SAAS,IAAA,GAAO;AACd,IAAA,MAAM,OAAA,GAAU,IAAI,WAAA,GAAc,SAAA;AAClC,IAAA,KAAA,IAAS,IAAI,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG,CAAA,IAAK,GAAG,CAAA,EAAA,EAAK;AAC3C,MAAA,MAAM,GAAA,GAAM,OAAO,CAAC,CAAA;AACpB,MAAA,IAAI,GAAA,CAAI,QAAQ,OAAA,EAAS;AACvB,QAAA,GAAA,CAAI,QAAA,CAAS,IAAI,IAAI,CAAA;AACrB,QAAA,MAAA,CAAO,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,QAAA,CAAS,EAAA,EAAI,IAAA,EAAM,QAAA,EAAU;AAC3B,MAAA,MAAA,CAAO,IAAA,CAAK,EAAE,EAAA,EAAI,IAAA,EAAM,UAAU,CAAA;AAAA,IACpC,CAAA;AAAA,IACA,OAAO,EAAA,EAAI;AACT,MAAA,MAAM,MAAM,MAAA,CAAO,SAAA,CAAU,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,EAAE,CAAA;AAC/C,MAAA,IAAI,GAAA,KAAQ,EAAA,EAAI,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IACtC,CAAA;AAAA,IACA,KAAA,GAAQ;AACN,MAAA,IAAI,YAAY,IAAA,EAAM;AACtB,MAAA,OAAA,GAAU,WAAA,CAAY,MAAM,QAAQ,CAAA;AAAA,IACtC,CAAA;AAAA,IACA,IAAA,GAAO;AACL,MAAA,IAAI,YAAY,IAAA,EAAM;AACpB,QAAA,aAAA,CAAc,OAAO,CAAA;AACrB,QAAA,OAAA,GAAU,IAAA;AAAA,MACZ;AAAA,IACF,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,IAAA,CAAK,IAAA,EAAK;AACV,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAAA,IAClB;AAAA,GACF;AACF;AAsBO,SAAS,WAAA,CAAY,KAAmB,OAAA,EAA+B;AAC5E,EAAA,IAAI,GAAA,GAAM,SAAS,GAAA,IAAO,GAAA;AAC1B,EAAA,MAAM,YAAY,GAAA,CAAI,WAAA;AAEtB,EAAA,SAAS,cAAA,GAAiB;AACxB,IAAA,OAAO,EAAA,GAAK,GAAA;AAAA,EACd;AAEA,EAAA,OAAO;AAAA,IACL,WAAW,IAAA,EAAsB;AAC/B,MAAA,OAAO,SAAA,GAAY,OAAO,cAAA,EAAe;AAAA,IAC3C,CAAA;AAAA,IACA,cAAA,GAAyB;AACvB,MAAA,OAAA,CAAQ,GAAA,CAAI,WAAA,GAAc,SAAA,IAAa,cAAA,EAAe;AAAA,IACxD,CAAA;AAAA,IACA,eAAA,GAA0B;AACxB,MAAA,MAAM,OAAA,GAAU,KAAK,cAAA,EAAe;AACpC,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA;AAC9B,MAAA,OAAO,KAAK,UAAA,CAAW,IAAA,KAAS,OAAA,GAAU,IAAA,GAAO,IAAI,IAAI,CAAA;AAAA,IAC3D,CAAA;AAAA,IACA,OAAO,KAAA,EAAe;AACpB,MAAA,GAAA,GAAM,KAAA;AAAA,IACR,CAAA;AAAA,IACA,MAAA,GAAiB;AACf,MAAA,OAAO,GAAA;AAAA,IACT;AAAA,GACF;AACF","file":"chunk-7JUVBZ6B.js","sourcesContent":["// ---------------------------------------------------------------------------\n// M8: Scheduler & Clock\n// ---------------------------------------------------------------------------\n\nimport type { ClockOptions, ScheduledEvent, SchedulerOptions } from \"./types.js\";\n\n// ---------------------------------------------------------------------------\n// Scheduler\n// ---------------------------------------------------------------------------\n\nexport interface Scheduler {\n  /** Schedule a callback at a specific AudioContext time. */\n  schedule(id: string, time: number, callback: (time: number) => void): void;\n  /** Remove a scheduled event by id. */\n  cancel(id: string): void;\n  /** Start the scheduler loop. */\n  start(): void;\n  /** Stop the scheduler loop. */\n  stop(): void;\n  /** Dispose of all resources. */\n  dispose(): void;\n}\n\n/**\n * Create a lookahead-based event scheduler.\n *\n * Uses `setInterval` to check upcoming events and fire callbacks\n * slightly before their scheduled time, enabling sample-accurate timing.\n */\nexport function createScheduler(ctx: AudioContext, options?: SchedulerOptions): Scheduler {\n  const { lookahead = 0.1, interval = 25 } = options ?? {};\n\n  const events: ScheduledEvent[] = [];\n  let timerId: ReturnType<typeof setInterval> | null = null;\n\n  function tick() {\n    const horizon = ctx.currentTime + lookahead;\n    for (let i = events.length - 1; i >= 0; i--) {\n      const evt = events[i]!;\n      if (evt.time <= horizon) {\n        evt.callback(evt.time);\n        events.splice(i, 1);\n      }\n    }\n  }\n\n  return {\n    schedule(id, time, callback) {\n      events.push({ id, time, callback });\n    },\n    cancel(id) {\n      const idx = events.findIndex((e) => e.id === id);\n      if (idx !== -1) events.splice(idx, 1);\n    },\n    start() {\n      if (timerId !== null) return;\n      timerId = setInterval(tick, interval);\n    },\n    stop() {\n      if (timerId !== null) {\n        clearInterval(timerId);\n        timerId = null;\n      }\n    },\n    dispose() {\n      this.stop();\n      events.length = 0;\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Clock\n// ---------------------------------------------------------------------------\n\nexport interface Clock {\n  /** Convert a beat number to AudioContext time (seconds). */\n  beatToTime(beat: number): number;\n  /** Get the current beat based on AudioContext time. */\n  getCurrentBeat(): number;\n  /** Get the AudioContext time of the next beat boundary. */\n  getNextBeatTime(): number;\n  /** Update BPM. */\n  setBpm(bpm: number): void;\n  /** Get current BPM. */\n  getBpm(): number;\n}\n\n/**\n * Create a BPM-based clock tied to an `AudioContext`.\n */\nexport function createClock(ctx: AudioContext, options?: ClockOptions): Clock {\n  let bpm = options?.bpm ?? 120;\n  const startTime = ctx.currentTime;\n\n  function secondsPerBeat() {\n    return 60 / bpm;\n  }\n\n  return {\n    beatToTime(beat: number): number {\n      return startTime + beat * secondsPerBeat();\n    },\n    getCurrentBeat(): number {\n      return (ctx.currentTime - startTime) / secondsPerBeat();\n    },\n    getNextBeatTime(): number {\n      const current = this.getCurrentBeat();\n      const next = Math.ceil(current);\n      return this.beatToTime(next === current ? next + 1 : next);\n    },\n    setBpm(value: number) {\n      bpm = value;\n    },\n    getBpm(): number {\n      return bpm;\n    },\n  };\n}\n"]}

package/dist/{chunk-D5CD5KQZ.cjs → chunk-BRS7LZVH.cjs}

@@ -68,5 +68,5 @@ function createClock(ctx, options) {
 
 exports.createClock = createClock;
 exports.createScheduler = createScheduler;
-//# sourceMappingURL=chunk-D5CD5KQZ.cjs.map
-//# sourceMappingURL=chunk-D5CD5KQZ.cjs.map
+//# sourceMappingURL=chunk-BRS7LZVH.cjs.map
+//# sourceMappingURL=chunk-BRS7LZVH.cjs.map

package/dist/chunk-BRS7LZVH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scheduler.ts"],"names":[],"mappings":";;;AA6BO,SAAS,eAAA,CAAgB,KAAmB,OAAA,EAAuC;AACxF,EAAA,MAAM,EAAE,SAAA,GAAY,GAAA,EAAK,WAAW,EAAA,EAAG,GAAI,WAAW,EAAC;AAEvD,EAAA,MAAM,SAA2B,EAAC;AAClC,EAAA,IAAI,OAAA,GAAiD,IAAA;AAErD,EAAA,SAAS,IAAA,GAAO;AACd,IAAA,MAAM,OAAA,GAAU,IAAI,WAAA,GAAc,SAAA;AAClC,IAAA,KAAA,IAAS,IAAI,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG,CAAA,IAAK,GAAG,CAAA,EAAA,EAAK;AAC3C,MAAA,MAAM,GAAA,GAAM,OAAO,CAAC,CAAA;AACpB,MAAA,IAAI,GAAA,CAAI,QAAQ,OAAA,EAAS;AACvB,QAAA,GAAA,CAAI,QAAA,CAAS,IAAI,IAAI,CAAA;AACrB,QAAA,MAAA,CAAO,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,QAAA,CAAS,EAAA,EAAI,IAAA,EAAM,QAAA,EAAU;AAC3B,MAAA,MAAA,CAAO,IAAA,CAAK,EAAE,EAAA,EAAI,IAAA,EAAM,UAAU,CAAA;AAAA,IACpC,CAAA;AAAA,IACA,OAAO,EAAA,EAAI;AACT,MAAA,MAAM,MAAM,MAAA,CAAO,SAAA,CAAU,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,EAAE,CAAA;AAC/C,MAAA,IAAI,GAAA,KAAQ,EAAA,EAAI,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IACtC,CAAA;AAAA,IACA,KAAA,GAAQ;AACN,MAAA,IAAI,YAAY,IAAA,EAAM;AACtB,MAAA,OAAA,GAAU,WAAA,CAAY,MAAM,QAAQ,CAAA;AAAA,IACtC,CAAA;AAAA,IACA,IAAA,GAAO;AACL,MAAA,IAAI,YAAY,IAAA,EAAM;AACpB,QAAA,aAAA,CAAc,OAAO,CAAA;AACrB,QAAA,OAAA,GAAU,IAAA;AAAA,MACZ;AAAA,IACF,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,IAAA,CAAK,IAAA,EAAK;AACV,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAAA,IAClB;AAAA,GACF;AACF;AAsBO,SAAS,WAAA,CAAY,KAAmB,OAAA,EAA+B;AAC5E,EAAA,IAAI,GAAA,GAAM,SAAS,GAAA,IAAO,GAAA;AAC1B,EAAA,MAAM,YAAY,GAAA,CAAI,WAAA;AAEtB,EAAA,SAAS,cAAA,GAAiB;AACxB,IAAA,OAAO,EAAA,GAAK,GAAA;AAAA,EACd;AAEA,EAAA,OAAO;AAAA,IACL,WAAW,IAAA,EAAsB;AAC/B,MAAA,OAAO,SAAA,GAAY,OAAO,cAAA,EAAe;AAAA,IAC3C,CAAA;AAAA,IACA,cAAA,GAAyB;AACvB,MAAA,OAAA,CAAQ,GAAA,CAAI,WAAA,GAAc,SAAA,IAAa,cAAA,EAAe;AAAA,IACxD,CAAA;AAAA,IACA,eAAA,GAA0B;AACxB,MAAA,MAAM,OAAA,GAAU,KAAK,cAAA,EAAe;AACpC,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA;AAC9B,MAAA,OAAO,KAAK,UAAA,CAAW,IAAA,KAAS,OAAA,GAAU,IAAA,GAAO,IAAI,IAAI,CAAA;AAAA,IAC3D,CAAA;AAAA,IACA,OAAO,KAAA,EAAe;AACpB,MAAA,GAAA,GAAM,KAAA;AAAA,IACR,CAAA;AAAA,IACA,MAAA,GAAiB;AACf,MAAA,OAAO,GAAA;AAAA,IACT;AAAA,GACF;AACF","file":"chunk-BRS7LZVH.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// M8: Scheduler & Clock\n// ---------------------------------------------------------------------------\n\nimport type { ClockOptions, ScheduledEvent, SchedulerOptions } from \"./types.js\";\n\n// ---------------------------------------------------------------------------\n// Scheduler\n// ---------------------------------------------------------------------------\n\nexport interface Scheduler {\n  /** Schedule a callback at a specific AudioContext time. */\n  schedule(id: string, time: number, callback: (time: number) => void): void;\n  /** Remove a scheduled event by id. */\n  cancel(id: string): void;\n  /** Start the scheduler loop. */\n  start(): void;\n  /** Stop the scheduler loop. */\n  stop(): void;\n  /** Dispose of all resources. */\n  dispose(): void;\n}\n\n/**\n * Create a lookahead-based event scheduler.\n *\n * Uses `setInterval` to check upcoming events and fire callbacks\n * slightly before their scheduled time, enabling sample-accurate timing.\n */\nexport function createScheduler(ctx: AudioContext, options?: SchedulerOptions): Scheduler {\n  const { lookahead = 0.1, interval = 25 } = options ?? {};\n\n  const events: ScheduledEvent[] = [];\n  let timerId: ReturnType<typeof setInterval> | null = null;\n\n  function tick() {\n    const horizon = ctx.currentTime + lookahead;\n    for (let i = events.length - 1; i >= 0; i--) {\n      const evt = events[i]!;\n      if (evt.time <= horizon) {\n        evt.callback(evt.time);\n        events.splice(i, 1);\n      }\n    }\n  }\n\n  return {\n    schedule(id, time, callback) {\n      events.push({ id, time, callback });\n    },\n    cancel(id) {\n      const idx = events.findIndex((e) => e.id === id);\n      if (idx !== -1) events.splice(idx, 1);\n    },\n    start() {\n      if (timerId !== null) return;\n      timerId = setInterval(tick, interval);\n    },\n    stop() {\n      if (timerId !== null) {\n        clearInterval(timerId);\n        timerId = null;\n      }\n    },\n    dispose() {\n      this.stop();\n      events.length = 0;\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Clock\n// ---------------------------------------------------------------------------\n\nexport interface Clock {\n  /** Convert a beat number to AudioContext time (seconds). */\n  beatToTime(beat: number): number;\n  /** Get the current beat based on AudioContext time. */\n  getCurrentBeat(): number;\n  /** Get the AudioContext time of the next beat boundary. */\n  getNextBeatTime(): number;\n  /** Update BPM. */\n  setBpm(bpm: number): void;\n  /** Get current BPM. */\n  getBpm(): number;\n}\n\n/**\n * Create a BPM-based clock tied to an `AudioContext`.\n */\nexport function createClock(ctx: AudioContext, options?: ClockOptions): Clock {\n  let bpm = options?.bpm ?? 120;\n  const startTime = ctx.currentTime;\n\n  function secondsPerBeat() {\n    return 60 / bpm;\n  }\n\n  return {\n    beatToTime(beat: number): number {\n      return startTime + beat * secondsPerBeat();\n    },\n    getCurrentBeat(): number {\n      return (ctx.currentTime - startTime) / secondsPerBeat();\n    },\n    getNextBeatTime(): number {\n      const current = this.getCurrentBeat();\n      const next = Math.ceil(current);\n      return this.beatToTime(next === current ? next + 1 : next);\n    },\n    setBpm(value: number) {\n      bpm = value;\n    },\n    getBpm(): number {\n      return bpm;\n    },\n  };\n}\n"]}

package/dist/{chunk-QWNV2BZ5.cjs → chunk-F6WXD3XW.cjs}

@@ -33,5 +33,5 @@ function createClickBuffer(ctx, frequency, duration) {
 exports.createClickBuffer = createClickBuffer;
 exports.createNoiseBuffer = createNoiseBuffer;
 exports.createSineBuffer = createSineBuffer;
-//# sourceMappingURL=chunk-QWNV2BZ5.cjs.map
-//# sourceMappingURL=chunk-QWNV2BZ5.cjs.map
+//# sourceMappingURL=chunk-F6WXD3XW.cjs.map
+//# sourceMappingURL=chunk-F6WXD3XW.cjs.map

package/dist/chunk-F6WXD3XW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/synth.ts"],"names":[],"mappings":";;;AAQO,SAAS,gBAAA,CACd,GAAA,EACA,SAAA,EACA,QAAA,EACa;AACb,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,aAAa,QAAQ,CAAA;AAClD,EAAA,MAAM,SAAS,GAAA,CAAI,YAAA,CAAa,CAAA,EAAG,MAAA,EAAQ,IAAI,UAAU,CAAA;AACzD,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,cAAA,CAAe,CAAC,CAAA;AAEpC,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,EAAQ,CAAA,EAAA,EAAK;AAC/B,IAAA,IAAA,CAAK,CAAC,CAAA,GAAI,IAAA,CAAK,GAAA,CAAK,CAAA,GAAI,KAAK,EAAA,GAAK,SAAA,GAAY,CAAA,GAAK,GAAA,CAAI,UAAU,CAAA;AAAA,EACnE;AAEA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,iBAAA,CAAkB,KAAmB,QAAA,EAA+B;AAClF,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,aAAa,QAAQ,CAAA;AAClD,EAAA,MAAM,SAAS,GAAA,CAAI,YAAA,CAAa,CAAA,EAAG,MAAA,EAAQ,IAAI,UAAU,CAAA;AACzD,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,cAAA,CAAe,CAAC,CAAA;AAEpC,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,EAAQ,CAAA,EAAA,EAAK;AAC/B,IAAA,IAAA,CAAK,CAAC,CAAA,GAAI,IAAA,CAAK,MAAA,KAAW,CAAA,GAAI,CAAA;AAAA,EAChC;AAEA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,iBAAA,CACd,GAAA,EACA,SAAA,EACA,QAAA,EACa;AACb,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,aAAa,QAAQ,CAAA;AAClD,EAAA,MAAM,SAAS,GAAA,CAAI,YAAA,CAAa,CAAA,EAAG,MAAA,EAAQ,IAAI,UAAU,CAAA;AACzD,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,cAAA,CAAe,CAAC,CAAA;AAEpC,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,EAAQ,CAAA,EAAA,EAAK;AAE/B,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,CAAK,EAAA,GAAK,IAAK,MAAM,CAAA;AAC3C,IAAA,IAAA,CAAK,CAAC,CAAA,GAAI,QAAA,GAAW,IAAA,CAAK,GAAA,CAAK,CAAA,GAAI,IAAA,CAAK,EAAA,GAAK,SAAA,GAAY,CAAA,GAAK,GAAA,CAAI,UAAU,CAAA;AAAA,EAC9E;AAEA,EAAA,OAAO,MAAA;AACT","file":"chunk-F6WXD3XW.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// M9: Buffer synthesis\n// ---------------------------------------------------------------------------\n\n/**\n * Create an `AudioBuffer` containing a sine wave.\n * Useful for test tones and debugging.\n */\nexport function createSineBuffer(\n  ctx: AudioContext,\n  frequency: number,\n  duration: number,\n): AudioBuffer {\n  const length = Math.ceil(ctx.sampleRate * duration);\n  const buffer = ctx.createBuffer(1, length, ctx.sampleRate);\n  const data = buffer.getChannelData(0);\n\n  for (let i = 0; i < length; i++) {\n    data[i] = Math.sin((2 * Math.PI * frequency * i) / ctx.sampleRate);\n  }\n\n  return buffer;\n}\n\n/**\n * Create an `AudioBuffer` containing white noise.\n */\nexport function createNoiseBuffer(ctx: AudioContext, duration: number): AudioBuffer {\n  const length = Math.ceil(ctx.sampleRate * duration);\n  const buffer = ctx.createBuffer(1, length, ctx.sampleRate);\n  const data = buffer.getChannelData(0);\n\n  for (let i = 0; i < length; i++) {\n    data[i] = Math.random() * 2 - 1;\n  }\n\n  return buffer;\n}\n\n/**\n * Create an `AudioBuffer` containing a short click/impulse.\n */\nexport function createClickBuffer(\n  ctx: AudioContext,\n  frequency: number,\n  duration: number,\n): AudioBuffer {\n  const length = Math.ceil(ctx.sampleRate * duration);\n  const buffer = ctx.createBuffer(1, length, ctx.sampleRate);\n  const data = buffer.getChannelData(0);\n\n  for (let i = 0; i < length; i++) {\n    // Exponential decay envelope.\n    const envelope = Math.exp((-5 * i) / length);\n    data[i] = envelope * Math.sin((2 * Math.PI * frequency * i) / ctx.sampleRate);\n  }\n\n  return buffer;\n}\n"]}

package/dist/{chunk-C2ASIYN5.js → chunk-FESPIMZM.js}

@@ -7,10 +7,7 @@ function applyRamp(node, from, to, duration, curve) {
   param.setValueAtTime(from, now);
   switch (curve) {
     case "exponential":
-      param.exponentialRampToValueAtTime(
-        Math.max(to, EXP_MIN),
-        now + duration
-      );
+      param.exponentialRampToValueAtTime(Math.max(to, EXP_MIN), now + duration);
       break;
     case "equal-power": {
       const steps = Math.max(Math.ceil(duration * 100), 2);
@@ -23,7 +20,6 @@ function applyRamp(node, from, to, duration, curve) {
       param.setValueCurveAtTime(values, now, duration);
       break;
     }
-    case "linear":
     default:
       param.linearRampToValueAtTime(to, now + duration);
       break;
@@ -63,5 +59,5 @@ function autoFade(playback, gain, options) {
 }
 
 export { autoFade, crossfade, fadeIn, fadeOut };
-//# sourceMappingURL=chunk-C2ASIYN5.js.map
-//# sourceMappingURL=chunk-C2ASIYN5.js.map
+//# sourceMappingURL=chunk-FESPIMZM.js.map
+//# sourceMappingURL=chunk-FESPIMZM.js.map

package/dist/chunk-FESPIMZM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fade.ts"],"names":[],"mappings":";AAaA,IAAM,OAAA,GAAU,IAAA;AAEhB,SAAS,SAAA,CACP,IAAA,EACA,IAAA,EACA,EAAA,EACA,UACA,KAAA,EACM;AACN,EAAA,MAAM,QAAQ,IAAA,CAAK,IAAA;AACnB,EAAA,MAAM,GAAA,GAAM,KAAK,OAAA,CAAQ,WAAA;AACzB,EAAA,KAAA,CAAM,sBAAsB,GAAG,CAAA;AAC/B,EAAA,KAAA,CAAM,cAAA,CAAe,MAAM,GAAG,CAAA;AAE9B,EAAA,QAAQ,KAAA;AAAO,IACb,KAAK,aAAA;AACH,MAAA,KAAA,CAAM,6BAA6B,IAAA,CAAK,GAAA,CAAI,IAAI,OAAO,CAAA,EAAG,MAAM,QAAQ,CAAA;AACxE,MAAA;AAAA,IACF,KAAK,aAAA,EAAe;AAElB,MAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,CAAI,IAAA,CAAK,KAAK,QAAA,GAAW,GAAG,GAAG,CAAC,CAAA;AACnD,MAAA,MAAM,MAAA,GAAS,IAAI,YAAA,CAAa,KAAK,CAAA;AACrC,MAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA,EAAA,EAAK;AAC9B,QAAA,MAAM,CAAA,GAAI,KAAK,KAAA,GAAQ,CAAA,CAAA;AACvB,QAAA,MAAM,IAAA,GAAO,QAAQ,EAAA,GAAK,IAAA,IAAQ,KAAK,GAAA,CAAK,CAAA,GAAI,IAAA,CAAK,EAAA,GAAM,CAAC,CAAA;AAC5D,QAAA,MAAA,CAAO,CAAC,CAAA,GAAI,IAAA;AAAA,MACd;AACA,MAAA,KAAA,CAAM,mBAAA,CAAoB,MAAA,EAAQ,GAAA,EAAK,QAAQ,CAAA;AAC/C,MAAA;AAAA,IACF;AAAA,IACA;AACE,MAAA,KAAA,CAAM,uBAAA,CAAwB,EAAA,EAAI,GAAA,GAAM,QAAQ,CAAA;AAChD,MAAA;AAAA;AAEN;AAKO,SAAS,MAAA,CAAO,IAAA,EAAgB,MAAA,EAAgB,OAAA,EAA6B;AAClF,EAAA,MAAM,EAAE,QAAA,GAAW,CAAA,EAAG,QAAQ,QAAA,EAAS,GAAI,WAAW,EAAC;AACvD,EAAA,SAAA,CAAU,IAAA,EAAM,CAAA,EAAG,MAAA,EAAQ,QAAA,EAAU,KAAK,CAAA;AAC5C;AAKO,SAAS,OAAA,CAAQ,MAAgB,OAAA,EAA6B;AACnE,EAAA,MAAM,EAAE,QAAA,GAAW,CAAA,EAAG,QAAQ,QAAA,EAAS,GAAI,WAAW,EAAC;AACvD,EAAA,SAAA,CAAU,MAAM,IAAA,CAAK,IAAA,CAAK,KAAA,EAAO,CAAA,EAAG,UAAU,KAAK,CAAA;AACrD;AAKO,SAAS,SAAA,CAAU,KAAA,EAAiB,KAAA,EAAiB,OAAA,EAAkC;AAC5F,EAAA,MAAM,EAAE,QAAA,GAAW,CAAA,EAAG,QAAQ,QAAA,EAAS,GAAI,WAAW,EAAC;AACvD,EAAA,SAAA,CAAU,OAAO,KAAA,CAAM,IAAA,CAAK,KAAA,EAAO,CAAA,EAAG,UAAU,KAAK,CAAA;AACrD,EAAA,SAAA,CAAU,OAAO,CAAA,EAAG,KAAA,CAAM,KAAK,KAAA,IAAS,CAAA,EAAG,UAAU,KAAK,CAAA;AAC5D;AAMO,SAAS,QAAA,CACd,QAAA,EACA,IAAA,EACA,OAAA,EACY;AACZ,EAAA,MAAM;AAAA,IACJ,QAAQ,cAAA,GAAiB,CAAA;AAAA,IACzB,SAAS,eAAA,GAAkB,CAAA;AAAA,IAC3B,KAAA,GAAQ;AAAA,GACV,GAAI,WAAW,EAAC;AAEhB,EAAA,MAAM,QAAA,GAAW,SAAS,WAAA,EAAY;AACtC,EAAA,IAAI,gBAAA,GAAmB,KAAA;AAGvB,EAAA,IAAI,iBAAiB,CAAA,EAAG;AACtB,IAAA,SAAA,CAAU,IAAA,EAAM,CAAA,EAAG,CAAA,EAAG,cAAA,EAAgB,KAAK,CAAA;AAAA,EAC7C;AAEA,EAAA,MAAM,QAAQ,QAAA,CAAS,EAAA,CAAG,cAAc,CAAC,EAAE,UAAS,KAAM;AACxD,IAAA,IAAI,kBAAkB,CAAA,IAAK,CAAC,gBAAA,IAAoB,QAAA,IAAY,WAAW,eAAA,EAAiB;AACtF,MAAA,gBAAA,GAAmB,IAAA;AACnB,MAAA,SAAA,CAAU,MAAM,IAAA,CAAK,IAAA,CAAK,KAAA,EAAO,CAAA,EAAG,iBAAiB,KAAK,CAAA;AAAA,IAC5D;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,KAAA;AACT","file":"chunk-FESPIMZM.js","sourcesContent":["// ---------------------------------------------------------------------------\n// M7: Fade utilities\n// ---------------------------------------------------------------------------\n\nimport type {\n  AutoFadeOptions,\n  CrossfadeOptions,\n  FadeCurve,\n  FadeOptions,\n  Playback,\n} from \"./types.js\";\n\n/** Minimum value used for exponential ramps (cannot ramp to/from 0). */\nconst EXP_MIN = 0.0001;\n\nfunction applyRamp(\n  node: GainNode,\n  from: number,\n  to: number,\n  duration: number,\n  curve: FadeCurve,\n): void {\n  const param = node.gain;\n  const now = node.context.currentTime;\n  param.cancelScheduledValues(now);\n  param.setValueAtTime(from, now);\n\n  switch (curve) {\n    case \"exponential\":\n      param.exponentialRampToValueAtTime(Math.max(to, EXP_MIN), now + duration);\n      break;\n    case \"equal-power\": {\n      // Approximate equal-power with a setValueCurveAtTime.\n      const steps = Math.max(Math.ceil(duration * 100), 2);\n      const values = new Float32Array(steps);\n      for (let i = 0; i < steps; i++) {\n        const t = i / (steps - 1);\n        const gain = from + (to - from) * Math.sin((t * Math.PI) / 2);\n        values[i] = gain;\n      }\n      param.setValueCurveAtTime(values, now, duration);\n      break;\n    }\n    default:\n      param.linearRampToValueAtTime(to, now + duration);\n      break;\n  }\n}\n\n/**\n * Fade a `GainNode` in from 0 to `target`.\n */\nexport function fadeIn(gain: GainNode, target: number, options?: FadeOptions): void {\n  const { duration = 1, curve = \"linear\" } = options ?? {};\n  applyRamp(gain, 0, target, duration, curve);\n}\n\n/**\n * Fade a `GainNode` out to 0.\n */\nexport function fadeOut(gain: GainNode, options?: FadeOptions): void {\n  const { duration = 1, curve = \"linear\" } = options ?? {};\n  applyRamp(gain, gain.gain.value, 0, duration, curve);\n}\n\n/**\n * Crossfade between two `GainNode`s.\n */\nexport function crossfade(gainA: GainNode, gainB: GainNode, options?: CrossfadeOptions): void {\n  const { duration = 1, curve = \"linear\" } = options ?? {};\n  applyRamp(gainA, gainA.gain.value, 0, duration, curve);\n  applyRamp(gainB, 0, gainA.gain.value || 1, duration, curve);\n}\n\n/**\n * Automatically apply fade-in at start and/or fade-out near end of a Playback.\n * Returns a cleanup function.\n */\nexport function autoFade(\n  playback: Playback,\n  gain: GainNode,\n  options?: AutoFadeOptions,\n): () => void {\n  const {\n    fadeIn: fadeInDuration = 0,\n    fadeOut: fadeOutDuration = 0,\n    curve = \"linear\",\n  } = options ?? {};\n\n  const duration = playback.getDuration();\n  let fadeOutScheduled = false;\n\n  // Apply fade-in immediately if playing from the start.\n  if (fadeInDuration > 0) {\n    applyRamp(gain, 0, 1, fadeInDuration, curve);\n  }\n\n  const unsub = playback.on(\"timeupdate\", ({ position }) => {\n    if (fadeOutDuration > 0 && !fadeOutScheduled && position >= duration - fadeOutDuration) {\n      fadeOutScheduled = true;\n      applyRamp(gain, gain.gain.value, 0, fadeOutDuration, curve);\n    }\n  });\n\n  return unsub;\n}\n"]}

package/dist/{chunk-GYH2JSCY.js → chunk-FY273Z3I.js}

@@ -38,5 +38,5 @@ function createEmitter() {
 }
 
 export { createEmitter };
-//# sourceMappingURL=chunk-GYH2JSCY.js.map
-//# sourceMappingURL=chunk-GYH2JSCY.js.map
+//# sourceMappingURL=chunk-FY273Z3I.js.map
+//# sourceMappingURL=chunk-FY273Z3I.js.map

package/dist/chunk-FY273Z3I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts"],"names":[],"mappings":";AA6BO,SAAS,aAAA,GAEK;AACnB,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAA8C;AAEpE,EAAA,SAAS,OAA+B,KAAA,EAAU;AAChD,IAAA,IAAI,GAAA,GAAM,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AAC7B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,GAAA,uBAAU,GAAA,EAAI;AACd,MAAA,SAAA,CAAU,GAAA,CAAI,OAAO,GAAG,CAAA;AAAA,IAC1B;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,EAAA,CAA2B,OAAU,OAAA,EAAgD;AACnF,MAAA,MAAM,GAAA,GAAM,OAAO,KAAK,CAAA;AACxB,MAAA,GAAA,CAAI,IAAI,OAAgC,CAAA;AACxC,MAAA,OAAO,MAAM;AACX,QAAA,GAAA,CAAI,OAAO,OAAgC,CAAA;AAAA,MAC7C,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,GAAA,CAA4B,OAAU,OAAA,EAA0C;AAC9E,MAAA,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA,EAAG,MAAA,CAAO,OAAgC,CAAA;AAAA,IAC/D,CAAA;AAAA,IAEA,IAAA,CAA6B,OAAU,IAAA,EAAuB;AAC5D,MAAA,MAAM,GAAA,GAAM,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AAC/B,MAAA,IAAI,CAAC,GAAA,EAAK;AACV,MAAA,KAAA,MAAW,WAAW,GAAA,EAAK;AACzB,QAAA,OAAA,CAAQ,IAAa,CAAA;AAAA,MACvB;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,KAAA,EAA4B;AAChC,MAAA,IAAI,UAAU,MAAA,EAAW;AACvB,QAAA,SAAA,CAAU,OAAO,KAAK,CAAA;AAAA,MACxB,CAAA,MAAO;AACL,QAAA,SAAA,CAAU,KAAA,EAAM;AAAA,MAClB;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-FY273Z3I.js","sourcesContent":["// ---------------------------------------------------------------------------\n// M4: Lightweight type-safe event emitter\n// ---------------------------------------------------------------------------\n\n/** A minimal, type-safe event emitter. */\nexport interface Emitter<Events extends Record<string, any> = Record<string, unknown>> {\n  /** Subscribe to an event. Returns an unsubscribe function. */\n  on<K extends keyof Events>(event: K, handler: (data: Events[K]) => void): () => void;\n\n  /** Unsubscribe a handler from an event. */\n  off<K extends keyof Events>(event: K, handler: (data: Events[K]) => void): void;\n\n  /** Emit an event with data. */\n  emit<K extends keyof Events>(event: K, data: Events[K]): void;\n\n  /** Remove all listeners (optionally for a specific event). */\n  clear(event?: keyof Events): void;\n}\n\n/**\n * Create a lightweight, type-safe event emitter.\n *\n * ```ts\n * const emitter = createEmitter<{ tick: number; done: void }>();\n * const unsub = emitter.on(\"tick\", (n) => console.log(n));\n * emitter.emit(\"tick\", 42);\n * unsub();\n * ```\n */\nexport function createEmitter<\n  Events extends Record<string, any> = Record<string, unknown>,\n>(): Emitter<Events> {\n  const listeners = new Map<keyof Events, Set<(data: never) => void>>();\n\n  function getSet<K extends keyof Events>(event: K) {\n    let set = listeners.get(event);\n    if (!set) {\n      set = new Set();\n      listeners.set(event, set);\n    }\n    return set;\n  }\n\n  return {\n    on<K extends keyof Events>(event: K, handler: (data: Events[K]) => void): () => void {\n      const set = getSet(event);\n      set.add(handler as (data: never) => void);\n      return () => {\n        set.delete(handler as (data: never) => void);\n      };\n    },\n\n    off<K extends keyof Events>(event: K, handler: (data: Events[K]) => void): void {\n      listeners.get(event)?.delete(handler as (data: never) => void);\n    },\n\n    emit<K extends keyof Events>(event: K, data: Events[K]): void {\n      const set = listeners.get(event);\n      if (!set) return;\n      for (const handler of set) {\n        handler(data as never);\n      }\n    },\n\n    clear(event?: keyof Events): void {\n      if (event !== undefined) {\n        listeners.delete(event);\n      } else {\n        listeners.clear();\n      }\n    },\n  };\n}\n"]}