waa-play 0.1.0

package/dist/chunk-5J7S6QV3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts"],"names":[],"mappings":";;;AAmCO,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,CACE,OACA,OAAA,EACY;AACZ,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,CACE,OACA,OAAA,EACM;AACN,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-5J7S6QV3.cjs","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>(\n    event: K,\n    handler: (data: Events[K]) => void,\n  ): () => void;\n\n  /** Unsubscribe a handler from an event. */\n  off<K extends keyof Events>(\n    event: K,\n    handler: (data: Events[K]) => void,\n  ): 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>(\n      event: K,\n      handler: (data: Events[K]) => void,\n    ): () => 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>(\n      event: K,\n      handler: (data: Events[K]) => void,\n    ): 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"]}

package/dist/chunk-6UTN73HG.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+// src/context.ts
+function createContext(options) {
+  return new AudioContext({
+    sampleRate: options?.sampleRate,
+    latencyHint: options?.latencyHint
+  });
+}
+async function resumeContext(ctx) {
+  if (ctx.state === "suspended") {
+    await ctx.resume();
+  }
+}
+async function ensureRunning(ctx) {
+  if (ctx.state !== "running") {
+    await ctx.resume();
+  }
+}
+function now(ctx) {
+  return ctx.currentTime;
+}
+
+exports.createContext = createContext;
+exports.ensureRunning = ensureRunning;
+exports.now = now;
+exports.resumeContext = resumeContext;
+//# sourceMappingURL=chunk-6UTN73HG.cjs.map
+//# sourceMappingURL=chunk-6UTN73HG.cjs.map

package/dist/chunk-6UTN73HG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts"],"names":[],"mappings":";;;AAaO,SAAS,cAAc,OAAA,EAA8C;AAC1E,EAAA,OAAO,IAAI,YAAA,CAAa;AAAA,IACtB,YAAY,OAAA,EAAS,UAAA;AAAA,IACrB,aAAa,OAAA,EAAS;AAAA,GACvB,CAAA;AACH;AAQA,eAAsB,cAAc,GAAA,EAAkC;AACpE,EAAA,IAAI,GAAA,CAAI,UAAU,WAAA,EAAa;AAC7B,IAAA,MAAM,IAAI,MAAA,EAAO;AAAA,EACnB;AACF;AAKA,eAAsB,cAAc,GAAA,EAAkC;AACpE,EAAA,IAAI,GAAA,CAAI,UAAU,SAAA,EAAW;AAC3B,IAAA,MAAM,IAAI,MAAA,EAAO;AAAA,EACnB;AACF;AAKO,SAAS,IAAI,GAAA,EAA2B;AAC7C,EAAA,OAAO,GAAA,CAAI,WAAA;AACb","file":"chunk-6UTN73HG.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// M1: AudioContext utilities\n// ---------------------------------------------------------------------------\n\nimport type { CreateContextOptions } from \"./types.js\";\n\n/**\n * Create an `AudioContext` with optional configuration.\n *\n * This is the only place in the library where `new AudioContext()` is called.\n * Users are encouraged to create their own context and pass it to other\n * functions — this helper exists purely for convenience.\n */\nexport function createContext(options?: CreateContextOptions): AudioContext {\n  return new AudioContext({\n    sampleRate: options?.sampleRate,\n    latencyHint: options?.latencyHint,\n  });\n}\n\n/**\n * Resume a suspended AudioContext (e.g. blocked by autoplay policy).\n *\n * Should be called inside a user-interaction event handler (click, keydown…)\n * if the context is in the `\"suspended\"` state.\n */\nexport async function resumeContext(ctx: AudioContext): Promise<void> {\n  if (ctx.state === \"suspended\") {\n    await ctx.resume();\n  }\n}\n\n/**\n * Ensure the context is in the `\"running\"` state, resuming if necessary.\n */\nexport async function ensureRunning(ctx: AudioContext): Promise<void> {\n  if (ctx.state !== \"running\") {\n    await ctx.resume();\n  }\n}\n\n/**\n * Shorthand for `ctx.currentTime`.\n */\nexport function now(ctx: AudioContext): number {\n  return ctx.currentTime;\n}\n"]}

package/dist/chunk-AGP2IRC6.js

@@ -0,0 +1,63 @@
+// src/adapters.ts
+function getSnapshot(playback) {
+  const base = {
+    state: playback.getState(),
+    position: playback.getCurrentTime(),
+    duration: playback.getDuration(),
+    progress: playback.getProgress()
+  };
+  const getter = playback["_getStretcherSnapshot"];
+  if (typeof getter === "function") {
+    const stretcher = getter();
+    if (stretcher) {
+      base.stretcher = stretcher;
+    }
+  }
+  return base;
+}
+function subscribeSnapshot(playback, callback) {
+  const unsubs = [];
+  unsubs.push(playback.on("statechange", callback));
+  unsubs.push(playback.on("timeupdate", callback));
+  unsubs.push(playback.on("seek", callback));
+  unsubs.push(playback.on("ended", callback));
+  return () => {
+    for (const unsub of unsubs) unsub();
+  };
+}
+function onFrame(playback, callback) {
+  let rafId = null;
+  function tick() {
+    callback(getSnapshot(playback));
+    rafId = requestAnimationFrame(tick);
+  }
+  rafId = requestAnimationFrame(tick);
+  return () => {
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+      rafId = null;
+    }
+  };
+}
+function whenEnded(playback) {
+  return new Promise((resolve) => {
+    const unsub = playback.on("ended", () => {
+      unsub();
+      resolve();
+    });
+  });
+}
+function whenPosition(playback, position) {
+  return new Promise((resolve) => {
+    const unsub = playback.on("timeupdate", ({ position: current }) => {
+      if (current >= position) {
+        unsub();
+        resolve();
+      }
+    });
+  });
+}
+
+export { getSnapshot, onFrame, subscribeSnapshot, whenEnded, whenPosition };
+//# sourceMappingURL=chunk-AGP2IRC6.js.map
+//# sourceMappingURL=chunk-AGP2IRC6.js.map

package/dist/chunk-AGP2IRC6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters.ts"],"names":[],"mappings":";AAUO,SAAS,YAAY,QAAA,EAAsC;AAChE,EAAA,MAAM,IAAA,GAAyB;AAAA,IAC7B,KAAA,EAAO,SAAS,QAAA,EAAS;AAAA,IACzB,QAAA,EAAU,SAAS,cAAA,EAAe;AAAA,IAClC,QAAA,EAAU,SAAS,WAAA,EAAY;AAAA,IAC/B,QAAA,EAAU,SAAS,WAAA;AAAY,GACjC;AAGA,EAAA,MAAM,MAAA,GAAU,SAAgD,uBAAuB,CAAA;AACvF,EAAA,IAAI,OAAO,WAAW,UAAA,EAAY;AAChC,IAAA,MAAM,YAAa,MAAA,EAA+C;AAClE,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,IAAA,CAAK,SAAA,GAAY,SAAA;AAAA,IACnB;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAiBO,SAAS,iBAAA,CACd,UACA,QAAA,EACY;AACZ,EAAA,MAAM,SAA4B,EAAC;AAEnC,EAAA,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,EAAA,CAAG,aAAA,EAAe,QAAQ,CAAC,CAAA;AAChD,EAAA,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,EAAA,CAAG,YAAA,EAAc,QAAQ,CAAC,CAAA;AAC/C,EAAA,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,EAAA,CAAG,MAAA,EAAQ,QAAQ,CAAC,CAAA;AACzC,EAAA,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,EAAA,CAAG,OAAA,EAAS,QAAQ,CAAC,CAAA;AAE1C,EAAA,OAAO,MAAM;AACX,IAAA,KAAA,MAAW,KAAA,IAAS,QAAQ,KAAA,EAAM;AAAA,EACpC,CAAA;AACF;AAQO,SAAS,OAAA,CACd,UACA,QAAA,EACY;AACZ,EAAA,IAAI,KAAA,GAAuB,IAAA;AAE3B,EAAA,SAAS,IAAA,GAAO;AACd,IAAA,QAAA,CAAS,WAAA,CAAY,QAAQ,CAAC,CAAA;AAC9B,IAAA,KAAA,GAAQ,sBAAsB,IAAI,CAAA;AAAA,EACpC;AAEA,EAAA,KAAA,GAAQ,sBAAsB,IAAI,CAAA;AAElC,EAAA,OAAO,MAAM;AACX,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,oBAAA,CAAqB,KAAK,CAAA;AAC1B,MAAA,KAAA,GAAQ,IAAA;AAAA,IACV;AAAA,EACF,CAAA;AACF;AAMO,SAAS,UAAU,QAAA,EAAmC;AAC3D,EAAA,OAAO,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACpC,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,EAAA,CAAG,OAAA,EAAS,MAAM;AACvC,MAAA,KAAA,EAAM;AACN,MAAA,OAAA,EAAQ;AAAA,IACV,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH;AAMO,SAAS,YAAA,CACd,UACA,QAAA,EACe;AACf,EAAA,OAAO,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACpC,IAAA,MAAM,KAAA,GAAQ,SAAS,EAAA,CAAG,YAAA,EAAc,CAAC,EAAE,QAAA,EAAU,SAAQ,KAAM;AACjE,MAAA,IAAI,WAAW,QAAA,EAAU;AACvB,QAAA,KAAA,EAAM;AACN,QAAA,OAAA,EAAQ;AAAA,MACV;AAAA,IACF,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH","file":"chunk-AGP2IRC6.js","sourcesContent":["// ---------------------------------------------------------------------------\n// M10: Framework adapters\n// ---------------------------------------------------------------------------\n\nimport type { Playback, PlaybackSnapshot } from \"./types.js\";\n\n/**\n * Get an immutable snapshot of the current playback state.\n * Designed for use with React's `useSyncExternalStore` or similar patterns.\n */\nexport function getSnapshot(playback: Playback): PlaybackSnapshot {\n  const base: PlaybackSnapshot = {\n    state: playback.getState(),\n    position: playback.getCurrentTime(),\n    duration: playback.getDuration(),\n    progress: playback.getProgress(),\n  };\n\n  // Include stretcher snapshot if available (no static import required)\n  const getter = (playback as unknown as Record<string, unknown>)[\"_getStretcherSnapshot\"];\n  if (typeof getter === \"function\") {\n    const stretcher = (getter as () => PlaybackSnapshot[\"stretcher\"])();\n    if (stretcher) {\n      base.stretcher = stretcher;\n    }\n  }\n\n  return base;\n}\n\n/**\n * Subscribe to playback state changes, calling `callback` with a fresh\n * snapshot whenever the state updates.\n *\n * Returns an unsubscribe function. Works as the `subscribe` parameter for\n * React's `useSyncExternalStore`.\n *\n * ```ts\n * // React example:\n * const snap = useSyncExternalStore(\n *   (cb) => subscribeSnapshot(playback, cb),\n *   () => getSnapshot(playback),\n * );\n * ```\n */\nexport function subscribeSnapshot(\n  playback: Playback,\n  callback: () => void,\n): () => void {\n  const unsubs: Array<() => void> = [];\n\n  unsubs.push(playback.on(\"statechange\", callback));\n  unsubs.push(playback.on(\"timeupdate\", callback));\n  unsubs.push(playback.on(\"seek\", callback));\n  unsubs.push(playback.on(\"ended\", callback));\n\n  return () => {\n    for (const unsub of unsubs) unsub();\n  };\n}\n\n/**\n * Call `callback` on every animation frame with the current playback snapshot.\n * Useful for smooth UI animations (waveform cursors, progress bars, etc.).\n *\n * Returns a `stop` function that cancels the loop.\n */\nexport function onFrame(\n  playback: Playback,\n  callback: (snapshot: PlaybackSnapshot) => void,\n): () => void {\n  let rafId: number | null = null;\n\n  function tick() {\n    callback(getSnapshot(playback));\n    rafId = requestAnimationFrame(tick);\n  }\n\n  rafId = requestAnimationFrame(tick);\n\n  return () => {\n    if (rafId !== null) {\n      cancelAnimationFrame(rafId);\n      rafId = null;\n    }\n  };\n}\n\n/**\n * Return a `Promise` that resolves when the playback reaches the `\"stopped\"`\n * state via the `ended` event (natural end, not manual stop).\n */\nexport function whenEnded(playback: Playback): Promise<void> {\n  return new Promise<void>((resolve) => {\n    const unsub = playback.on(\"ended\", () => {\n      unsub();\n      resolve();\n    });\n  });\n}\n\n/**\n * Return a `Promise` that resolves when the playback position reaches or\n * exceeds `position` seconds.\n */\nexport function whenPosition(\n  playback: Playback,\n  position: number,\n): Promise<void> {\n  return new Promise<void>((resolve) => {\n    const unsub = playback.on(\"timeupdate\", ({ position: current }) => {\n      if (current >= position) {\n        unsub();\n        resolve();\n      }\n    });\n  });\n}\n"]}

package/dist/chunk-C2ASIYN5.js

@@ -0,0 +1,67 @@
+// src/fade.ts
+var EXP_MIN = 1e-4;
+function applyRamp(node, from, to, duration, curve) {
+  const param = node.gain;
+  const now = node.context.currentTime;
+  param.cancelScheduledValues(now);
+  param.setValueAtTime(from, now);
+  switch (curve) {
+    case "exponential":
+      param.exponentialRampToValueAtTime(
+        Math.max(to, EXP_MIN),
+        now + duration
+      );
+      break;
+    case "equal-power": {
+      const steps = Math.max(Math.ceil(duration * 100), 2);
+      const values = new Float32Array(steps);
+      for (let i = 0; i < steps; i++) {
+        const t = i / (steps - 1);
+        const gain = from + (to - from) * Math.sin(t * Math.PI / 2);
+        values[i] = gain;
+      }
+      param.setValueCurveAtTime(values, now, duration);
+      break;
+    }
+    case "linear":
+    default:
+      param.linearRampToValueAtTime(to, now + duration);
+      break;
+  }
+}
+function fadeIn(gain, target, options) {
+  const { duration = 1, curve = "linear" } = options ?? {};
+  applyRamp(gain, 0, target, duration, curve);
+}
+function fadeOut(gain, options) {
+  const { duration = 1, curve = "linear" } = options ?? {};
+  applyRamp(gain, gain.gain.value, 0, duration, curve);
+}
+function crossfade(gainA, gainB, options) {
+  const { duration = 1, curve = "linear" } = options ?? {};
+  applyRamp(gainA, gainA.gain.value, 0, duration, curve);
+  applyRamp(gainB, 0, gainA.gain.value || 1, duration, curve);
+}
+function autoFade(playback, gain, options) {
+  const {
+    fadeIn: fadeInDuration = 0,
+    fadeOut: fadeOutDuration = 0,
+    curve = "linear"
+  } = options ?? {};
+  const duration = playback.getDuration();
+  let fadeOutScheduled = false;
+  if (fadeInDuration > 0) {
+    applyRamp(gain, 0, 1, fadeInDuration, curve);
+  }
+  const unsub = playback.on("timeupdate", ({ position }) => {
+    if (fadeOutDuration > 0 && !fadeOutScheduled && position >= duration - fadeOutDuration) {
+      fadeOutScheduled = true;
+      applyRamp(gain, gain.gain.value, 0, fadeOutDuration, curve);
+    }
+  });
+  return unsub;
+}
+
+export { autoFade, crossfade, fadeIn, fadeOut };
+//# sourceMappingURL=chunk-C2ASIYN5.js.map
+//# sourceMappingURL=chunk-C2ASIYN5.js.map

package/dist/chunk-C2ASIYN5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fade.ts"],"names":[],"mappings":"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","file":"chunk-C2ASIYN5.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(\n        Math.max(to, EXP_MIN),\n        now + duration,\n      );\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    case \"linear\":\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(\n  gain: GainNode,\n  target: number,\n  options?: FadeOptions,\n): 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(\n  gainA: GainNode,\n  gainB: GainNode,\n  options?: CrossfadeOptions,\n): 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 (\n      fadeOutDuration > 0 &&\n      !fadeOutScheduled &&\n      position >= duration - fadeOutDuration\n    ) {\n      fadeOutScheduled = true;\n      applyRamp(gain, gain.gain.value, 0, fadeOutDuration, curve);\n    }\n  });\n\n  return unsub;\n}\n"]}

package/dist/chunk-CJJC6ASU.js

@@ -0,0 +1,73 @@
+// src/nodes.ts
+function createGain(ctx, initialValue) {
+  const gain = ctx.createGain();
+  if (initialValue !== void 0) {
+    gain.gain.value = initialValue;
+  }
+  return gain;
+}
+function rampGain(gain, target, duration) {
+  const now = gain.context.currentTime;
+  gain.gain.cancelScheduledValues(now);
+  gain.gain.setValueAtTime(gain.gain.value, now);
+  gain.gain.linearRampToValueAtTime(target, now + duration);
+}
+function createAnalyser(ctx, options) {
+  const analyser = ctx.createAnalyser();
+  if (options?.fftSize !== void 0) analyser.fftSize = options.fftSize;
+  if (options?.smoothingTimeConstant !== void 0) {
+    analyser.smoothingTimeConstant = options.smoothingTimeConstant;
+  }
+  return analyser;
+}
+function getFrequencyData(analyser) {
+  const data = new Float32Array(analyser.frequencyBinCount);
+  analyser.getFloatFrequencyData(data);
+  return data;
+}
+function getFrequencyDataByte(analyser) {
+  const data = new Uint8Array(analyser.frequencyBinCount);
+  analyser.getByteFrequencyData(data);
+  return data;
+}
+function createFilter(ctx, options) {
+  const filter = ctx.createBiquadFilter();
+  if (options?.type !== void 0) filter.type = options.type;
+  if (options?.frequency !== void 0) filter.frequency.value = options.frequency;
+  if (options?.Q !== void 0) filter.Q.value = options.Q;
+  if (options?.gain !== void 0) filter.gain.value = options.gain;
+  return filter;
+}
+function createPanner(ctx, pan) {
+  const panner = ctx.createStereoPanner();
+  if (pan !== void 0) {
+    panner.pan.value = pan;
+  }
+  return panner;
+}
+function createCompressor(ctx, options) {
+  const comp = ctx.createDynamicsCompressor();
+  if (options?.threshold !== void 0) comp.threshold.value = options.threshold;
+  if (options?.knee !== void 0) comp.knee.value = options.knee;
+  if (options?.ratio !== void 0) comp.ratio.value = options.ratio;
+  if (options?.attack !== void 0) comp.attack.value = options.attack;
+  if (options?.release !== void 0) comp.release.value = options.release;
+  return comp;
+}
+function chain(...nodes) {
+  for (let i = 0; i < nodes.length - 1; i++) {
+    nodes[i].connect(nodes[i + 1]);
+  }
+}
+function disconnectChain(...nodes) {
+  for (const node of nodes) {
+    try {
+      node.disconnect();
+    } catch {
+    }
+  }
+}
+
+export { chain, createAnalyser, createCompressor, createFilter, createGain, createPanner, disconnectChain, getFrequencyData, getFrequencyDataByte, rampGain };
+//# sourceMappingURL=chunk-CJJC6ASU.js.map
+//# sourceMappingURL=chunk-CJJC6ASU.js.map

package/dist/chunk-CJJC6ASU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nodes.ts"],"names":[],"mappings":"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","file":"chunk-CJJC6ASU.js","sourcesContent":["// ---------------------------------------------------------------------------\n// M5: Audio node factory & graph utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Create a `GainNode` with an optional initial value.\n */\nexport function createGain(\n  ctx: AudioContext,\n  initialValue?: number,\n): GainNode {\n  const gain = ctx.createGain();\n  if (initialValue !== undefined) {\n    gain.gain.value = initialValue;\n  }\n  return gain;\n}\n\n/**\n * Smoothly ramp a `GainNode` to a target value over `duration` seconds using\n * `linearRampToValueAtTime`. This avoids audible clicks when changing volume.\n */\nexport function rampGain(\n  gain: GainNode,\n  target: number,\n  duration: number,\n): void {\n  const now = gain.context.currentTime;\n  gain.gain.cancelScheduledValues(now);\n  gain.gain.setValueAtTime(gain.gain.value, now);\n  gain.gain.linearRampToValueAtTime(target, now + duration);\n}\n\n/**\n * Create an `AnalyserNode`.\n */\nexport function createAnalyser(\n  ctx: AudioContext,\n  options?: { fftSize?: number; smoothingTimeConstant?: number },\n): AnalyserNode {\n  const analyser = ctx.createAnalyser();\n  if (options?.fftSize !== undefined) analyser.fftSize = options.fftSize;\n  if (options?.smoothingTimeConstant !== undefined) {\n    analyser.smoothingTimeConstant = options.smoothingTimeConstant;\n  }\n  return analyser;\n}\n\n/**\n * Get the current frequency data from an `AnalyserNode` as `Float32Array`.\n */\nexport function getFrequencyData(analyser: AnalyserNode): Float32Array {\n  const data = new Float32Array(analyser.frequencyBinCount);\n  analyser.getFloatFrequencyData(data);\n  return data;\n}\n\n/**\n * Get the current frequency data from an `AnalyserNode` as `Uint8Array`.\n */\nexport function getFrequencyDataByte(analyser: AnalyserNode): Uint8Array {\n  const data = new Uint8Array(analyser.frequencyBinCount);\n  analyser.getByteFrequencyData(data);\n  return data;\n}\n\n/**\n * Create a `BiquadFilterNode`.\n */\nexport function createFilter(\n  ctx: AudioContext,\n  options?: {\n    type?: BiquadFilterType;\n    frequency?: number;\n    Q?: number;\n    gain?: number;\n  },\n): BiquadFilterNode {\n  const filter = ctx.createBiquadFilter();\n  if (options?.type !== undefined) filter.type = options.type;\n  if (options?.frequency !== undefined) filter.frequency.value = options.frequency;\n  if (options?.Q !== undefined) filter.Q.value = options.Q;\n  if (options?.gain !== undefined) filter.gain.value = options.gain;\n  return filter;\n}\n\n/**\n * Create a `StereoPannerNode`.\n */\nexport function createPanner(\n  ctx: AudioContext,\n  pan?: number,\n): StereoPannerNode {\n  const panner = ctx.createStereoPanner();\n  if (pan !== undefined) {\n    panner.pan.value = pan;\n  }\n  return panner;\n}\n\n/**\n * Create a `DynamicsCompressorNode`.\n */\nexport function createCompressor(\n  ctx: AudioContext,\n  options?: {\n    threshold?: number;\n    knee?: number;\n    ratio?: number;\n    attack?: number;\n    release?: number;\n  },\n): DynamicsCompressorNode {\n  const comp = ctx.createDynamicsCompressor();\n  if (options?.threshold !== undefined) comp.threshold.value = options.threshold;\n  if (options?.knee !== undefined) comp.knee.value = options.knee;\n  if (options?.ratio !== undefined) comp.ratio.value = options.ratio;\n  if (options?.attack !== undefined) comp.attack.value = options.attack;\n  if (options?.release !== undefined) comp.release.value = options.release;\n  return comp;\n}\n\n/**\n * Connect a series of `AudioNode`s in order (serial chain).\n *\n * ```ts\n * chain(source, gain, analyser, ctx.destination);\n * ```\n */\nexport function chain(...nodes: AudioNode[]): void {\n  for (let i = 0; i < nodes.length - 1; i++) {\n    nodes[i]!.connect(nodes[i + 1]!);\n  }\n}\n\n/**\n * Disconnect a series of `AudioNode`s that were previously chained.\n */\nexport function disconnectChain(...nodes: AudioNode[]): void {\n  for (const node of nodes) {\n    try {\n      node.disconnect();\n    } catch {\n      // Already disconnected — safe to ignore.\n    }\n  }\n}\n"]}

package/dist/chunk-CPAT75WD.cjs

@@ -0,0 +1,60 @@
+'use strict';
+
+// src/buffer.ts
+async function loadBuffer(ctx, url, options) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch audio: ${response.status} ${response.statusText}`);
+  }
+  if (options?.onProgress && response.body && response.headers.get("content-length")) {
+    const total = Number(response.headers.get("content-length"));
+    const reader = response.body.getReader();
+    const chunks = [];
+    let received = 0;
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      chunks.push(value);
+      received += value.byteLength;
+      options.onProgress(total > 0 ? received / total : 0);
+    }
+    const merged = new Uint8Array(received);
+    let offset = 0;
+    for (const chunk of chunks) {
+      merged.set(chunk, offset);
+      offset += chunk.byteLength;
+    }
+    return ctx.decodeAudioData(merged.buffer);
+  }
+  const arrayBuffer = await response.arrayBuffer();
+  return ctx.decodeAudioData(arrayBuffer);
+}
+async function loadBufferFromBlob(ctx, blob) {
+  const arrayBuffer = await blob.arrayBuffer();
+  return ctx.decodeAudioData(arrayBuffer);
+}
+async function loadBuffers(ctx, map) {
+  const entries = Object.entries(map);
+  const results = await Promise.all(
+    entries.map(async ([key, url]) => {
+      const buffer = await loadBuffer(ctx, url);
+      return [key, buffer];
+    })
+  );
+  return new Map(results);
+}
+function getBufferInfo(buffer) {
+  return {
+    duration: buffer.duration,
+    numberOfChannels: buffer.numberOfChannels,
+    sampleRate: buffer.sampleRate,
+    length: buffer.length
+  };
+}
+
+exports.getBufferInfo = getBufferInfo;
+exports.loadBuffer = loadBuffer;
+exports.loadBufferFromBlob = loadBufferFromBlob;
+exports.loadBuffers = loadBuffers;
+//# sourceMappingURL=chunk-CPAT75WD.cjs.map
+//# sourceMappingURL=chunk-CPAT75WD.cjs.map

package/dist/chunk-CPAT75WD.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,CACpB,KACA,IAAA,EACsB;AACtB,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-CPAT75WD.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(\n  ctx: AudioContext,\n  blob: Blob,\n): 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-CRODJ4KS.js

@@ -0,0 +1,71 @@
+// src/waveform.ts
+function extractPeaks(buffer, options) {
+  const { resolution = 200, channel = 0 } = options ?? {};
+  const data = buffer.getChannelData(channel);
+  const blockSize = Math.floor(data.length / resolution);
+  const peaks = [];
+  for (let i = 0; i < resolution; i++) {
+    const start = i * blockSize;
+    const end = Math.min(start + blockSize, data.length);
+    let max = 0;
+    for (let j = start; j < end; j++) {
+      const abs = Math.abs(data[j]);
+      if (abs > max) max = abs;
+    }
+    peaks.push(max);
+  }
+  return peaks;
+}
+function extractPeakPairs(buffer, options) {
+  const { resolution = 200, channel = 0 } = options ?? {};
+  const data = buffer.getChannelData(channel);
+  const blockSize = Math.floor(data.length / resolution);
+  const pairs = [];
+  for (let i = 0; i < resolution; i++) {
+    const start = i * blockSize;
+    const end = Math.min(start + blockSize, data.length);
+    let min = 0;
+    let max = 0;
+    for (let j = start; j < end; j++) {
+      const sample = data[j];
+      if (sample < min) min = sample;
+      if (sample > max) max = sample;
+    }
+    pairs.push({ min, max });
+  }
+  return pairs;
+}
+function extractRMS(buffer, options) {
+  const { resolution = 200, channel = 0 } = options ?? {};
+  if (channel === -1) {
+    const allChannels = [];
+    for (let ch = 0; ch < buffer.numberOfChannels; ch++) {
+      allChannels.push(extractRMS(buffer, { resolution, channel: ch }));
+    }
+    return allChannels[0].map((_, i) => {
+      let sum = 0;
+      for (const ch of allChannels) {
+        sum += ch[i];
+      }
+      return sum / allChannels.length;
+    });
+  }
+  const data = buffer.getChannelData(channel);
+  const blockSize = Math.floor(data.length / resolution);
+  const rms = [];
+  for (let i = 0; i < resolution; i++) {
+    const start = i * blockSize;
+    const end = Math.min(start + blockSize, data.length);
+    let sumSq = 0;
+    for (let j = start; j < end; j++) {
+      const s = data[j];
+      sumSq += s * s;
+    }
+    rms.push(Math.sqrt(sumSq / (end - start)));
+  }
+  return rms;
+}
+
+export { extractPeakPairs, extractPeaks, extractRMS };
+//# sourceMappingURL=chunk-CRODJ4KS.js.map
+//# sourceMappingURL=chunk-CRODJ4KS.js.map

package/dist/chunk-CRODJ4KS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/waveform.ts"],"names":[],"mappings":"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","file":"chunk-CRODJ4KS.js","sourcesContent":["// ---------------------------------------------------------------------------\n// M6: Waveform data extraction\n// ---------------------------------------------------------------------------\n\nimport type { ExtractPeaksOptions, PeakPair } from \"./types.js\";\n\n/**\n * Extract normalised peak amplitude values from an `AudioBuffer`.\n * Returns an array of numbers in the range `[0, 1]`.\n */\nexport function extractPeaks(\n  buffer: AudioBuffer,\n  options?: ExtractPeaksOptions,\n): number[] {\n  const { resolution = 200, channel = 0 } = options ?? {};\n  const data = buffer.getChannelData(channel);\n  const blockSize = Math.floor(data.length / resolution);\n  const peaks: number[] = [];\n\n  for (let i = 0; i < resolution; i++) {\n    const start = i * blockSize;\n    const end = Math.min(start + blockSize, data.length);\n    let max = 0;\n    for (let j = start; j < end; j++) {\n      const abs = Math.abs(data[j]!);\n      if (abs > max) max = abs;\n    }\n    peaks.push(max);\n  }\n\n  return peaks;\n}\n\n/**\n * Extract min/max peak pairs for detailed waveform rendering.\n */\nexport function extractPeakPairs(\n  buffer: AudioBuffer,\n  options?: ExtractPeaksOptions,\n): PeakPair[] {\n  const { resolution = 200, channel = 0 } = options ?? {};\n  const data = buffer.getChannelData(channel);\n  const blockSize = Math.floor(data.length / resolution);\n  const pairs: PeakPair[] = [];\n\n  for (let i = 0; i < resolution; i++) {\n    const start = i * blockSize;\n    const end = Math.min(start + blockSize, data.length);\n    let min = 0;\n    let max = 0;\n    for (let j = start; j < end; j++) {\n      const sample = data[j]!;\n      if (sample < min) min = sample;\n      if (sample > max) max = sample;\n    }\n    pairs.push({ min, max });\n  }\n\n  return pairs;\n}\n\n/**\n * Extract RMS (root mean square) values representing perceived loudness.\n * Returns values in the range `[0, 1]`.\n *\n * When `channel` is set to `-1`, all channels are averaged.\n */\nexport function extractRMS(\n  buffer: AudioBuffer,\n  options?: ExtractPeaksOptions & { channel?: number },\n): number[] {\n  const { resolution = 200, channel = 0 } = options ?? {};\n\n  if (channel === -1) {\n    // Average across all channels.\n    const allChannels: number[][] = [];\n    for (let ch = 0; ch < buffer.numberOfChannels; ch++) {\n      allChannels.push(extractRMS(buffer, { resolution, channel: ch }));\n    }\n    return allChannels[0]!.map((_, i) => {\n      let sum = 0;\n      for (const ch of allChannels) {\n        sum += ch[i]!;\n      }\n      return sum / allChannels.length;\n    });\n  }\n\n  const data = buffer.getChannelData(channel);\n  const blockSize = Math.floor(data.length / resolution);\n  const rms: number[] = [];\n\n  for (let i = 0; i < resolution; i++) {\n    const start = i * blockSize;\n    const end = Math.min(start + blockSize, data.length);\n    let sumSq = 0;\n    for (let j = start; j < end; j++) {\n      const s = data[j]!;\n      sumSq += s * s;\n    }\n    rms.push(Math.sqrt(sumSq / (end - start)));\n  }\n\n  return rms;\n}\n"]}

package/dist/chunk-D5CD5KQZ.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+// src/scheduler.ts
+function createScheduler(ctx, options) {
+  const { lookahead = 0.1, interval = 25 } = options ?? {};
+  const events = [];
+  let timerId = null;
+  function tick() {
+    const horizon = ctx.currentTime + lookahead;
+    for (let i = events.length - 1; i >= 0; i--) {
+      const evt = events[i];
+      if (evt.time <= horizon) {
+        evt.callback(evt.time);
+        events.splice(i, 1);
+      }
+    }
+  }
+  return {
+    schedule(id, time, callback) {
+      events.push({ id, time, callback });
+    },
+    cancel(id) {
+      const idx = events.findIndex((e) => e.id === id);
+      if (idx !== -1) events.splice(idx, 1);
+    },
+    start() {
+      if (timerId !== null) return;
+      timerId = setInterval(tick, interval);
+    },
+    stop() {
+      if (timerId !== null) {
+        clearInterval(timerId);
+        timerId = null;
+      }
+    },
+    dispose() {
+      this.stop();
+      events.length = 0;
+    }
+  };
+}
+function createClock(ctx, options) {
+  let bpm = options?.bpm ?? 120;
+  const startTime = ctx.currentTime;
+  function secondsPerBeat() {
+    return 60 / bpm;
+  }
+  return {
+    beatToTime(beat) {
+      return startTime + beat * secondsPerBeat();
+    },
+    getCurrentBeat() {
+      return (ctx.currentTime - startTime) / secondsPerBeat();
+    },
+    getNextBeatTime() {
+      const current = this.getCurrentBeat();
+      const next = Math.ceil(current);
+      return this.beatToTime(next === current ? next + 1 : next);
+    },
+    setBpm(value) {
+      bpm = value;
+    },
+    getBpm() {
+      return bpm;
+    }
+  };
+}
+
+exports.createClock = createClock;
+exports.createScheduler = createScheduler;
+//# sourceMappingURL=chunk-D5CD5KQZ.cjs.map
+//# sourceMappingURL=chunk-D5CD5KQZ.cjs.map

package/dist/chunk-D5CD5KQZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scheduler.ts"],"names":[],"mappings":";;;AA6BO,SAAS,eAAA,CACd,KACA,OAAA,EACW;AACX,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,CACd,KACA,OAAA,EACO;AACP,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-D5CD5KQZ.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(\n  ctx: AudioContext,\n  options?: SchedulerOptions,\n): 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(\n  ctx: AudioContext,\n  options?: ClockOptions,\n): 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-GYH2JSCY.js

@@ -0,0 +1,42 @@
+// src/emitter.ts
+function createEmitter() {
+  const listeners = /* @__PURE__ */ new Map();
+  function getSet(event) {
+    let set = listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      listeners.set(event, set);
+    }
+    return set;
+  }
+  return {
+    on(event, handler) {
+      const set = getSet(event);
+      set.add(handler);
+      return () => {
+        set.delete(handler);
+      };
+    },
+    off(event, handler) {
+      listeners.get(event)?.delete(handler);
+    },
+    emit(event, data) {
+      const set = listeners.get(event);
+      if (!set) return;
+      for (const handler of set) {
+        handler(data);
+      }
+    },
+    clear(event) {
+      if (event !== void 0) {
+        listeners.delete(event);
+      } else {
+        listeners.clear();
+      }
+    }
+  };
+}
+
+export { createEmitter };
+//# sourceMappingURL=chunk-GYH2JSCY.js.map
+//# sourceMappingURL=chunk-GYH2JSCY.js.map

package/dist/chunk-GYH2JSCY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts"],"names":[],"mappings":";AAmCO,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,CACE,OACA,OAAA,EACY;AACZ,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,CACE,OACA,OAAA,EACM;AACN,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-GYH2JSCY.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>(\n    event: K,\n    handler: (data: Events[K]) => void,\n  ): () => void;\n\n  /** Unsubscribe a handler from an event. */\n  off<K extends keyof Events>(\n    event: K,\n    handler: (data: Events[K]) => void,\n  ): 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>(\n      event: K,\n      handler: (data: Events[K]) => void,\n    ): () => 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>(\n      event: K,\n      handler: (data: Events[K]) => void,\n    ): 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"]}