@al8b/audio 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# @al8b/audio
+
+Audio primitives for the L8B runtime. This package provides the browser-facing audio core plus the asset wrappers used for sound effects, music playback, and synthesized beeps.
+
+## Public API
+
+- `AudioCore`
+- `Sound`
+- `Music`
+- `Beeper`
+
+## Notes
+
+- Primarily consumed by `@al8b/runtime`.
+- Depends on browser audio APIs and is not a standalone CLI-facing package.
+
+## Scripts
+
+```bash
+bun run build
+bun run test
+bun run clean
+```

package/dist/constants.d.mts

@@ -0,0 +1,8 @@
+/** A4 reference frequency in Hz (concert pitch) */
+declare const A4_FREQUENCY = 440;
+/** Ratio between adjacent semitones in equal temperament */
+declare const SEMITONE_RATIO: number;
+/** MIDI note number for A4 */
+declare const A4_MIDI_NOTE = 69;
+
+export { A4_FREQUENCY, A4_MIDI_NOTE, SEMITONE_RATIO };

package/dist/constants.d.ts

@@ -0,0 +1,8 @@
+/** A4 reference frequency in Hz (concert pitch) */
+declare const A4_FREQUENCY = 440;
+/** Ratio between adjacent semitones in equal temperament */
+declare const SEMITONE_RATIO: number;
+/** MIDI note number for A4 */
+declare const A4_MIDI_NOTE = 69;
+
+export { A4_FREQUENCY, A4_MIDI_NOTE, SEMITONE_RATIO };

package/dist/constants.js

@@ -0,0 +1,37 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/constants.ts
+var constants_exports = {};
+__export(constants_exports, {
+  A4_FREQUENCY: () => A4_FREQUENCY,
+  A4_MIDI_NOTE: () => A4_MIDI_NOTE,
+  SEMITONE_RATIO: () => SEMITONE_RATIO
+});
+module.exports = __toCommonJS(constants_exports);
+var A4_FREQUENCY = 440;
+var SEMITONE_RATIO = 2 ** (1 / 12);
+var A4_MIDI_NOTE = 69;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  A4_FREQUENCY,
+  A4_MIDI_NOTE,
+  SEMITONE_RATIO
+});
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/** A4 reference frequency in Hz (concert pitch) */\nexport const A4_FREQUENCY = 440;\n\n/** Ratio between adjacent semitones in equal temperament */\nexport const SEMITONE_RATIO = 2 ** (1 / 12);\n\n/** MIDI note number for A4 */\nexport const A4_MIDI_NOTE = 69;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;AACO,IAAMA,eAAe;AAGrB,IAAMC,iBAAiB,MAAM,IAAI;AAGjC,IAAMC,eAAe;","names":["A4_FREQUENCY","SEMITONE_RATIO","A4_MIDI_NOTE"]}

package/dist/constants.mjs

@@ -0,0 +1,10 @@
+// src/constants.ts
+var A4_FREQUENCY = 440;
+var SEMITONE_RATIO = 2 ** (1 / 12);
+var A4_MIDI_NOTE = 69;
+export {
+  A4_FREQUENCY,
+  A4_MIDI_NOTE,
+  SEMITONE_RATIO
+};
+//# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/** A4 reference frequency in Hz (concert pitch) */\nexport const A4_FREQUENCY = 440;\n\n/** Ratio between adjacent semitones in equal temperament */\nexport const SEMITONE_RATIO = 2 ** (1 / 12);\n\n/** MIDI note number for A4 */\nexport const A4_MIDI_NOTE = 69;\n"],"mappings":";AACO,IAAMA,eAAe;AAGrB,IAAMC,iBAAiB,MAAM,IAAI;AAGjC,IAAMC,eAAe;","names":["A4_FREQUENCY","SEMITONE_RATIO","A4_MIDI_NOTE"]}

package/dist/core/audio-core.d.mts

@@ -0,0 +1,98 @@
+import { Beeper } from '../devices/beeper.mjs';
+
+/**
+ * AudioCore - Web Audio API wrapper
+ * Manages audio context, beeper, and sound/music playback
+ */
+
+/** An actively playing sound/music that can be stopped */
+interface PlayingHandle {
+    stop: () => void;
+}
+/** Item that can be woken up on audio context activation */
+interface WakeUpItem {
+    wakeUp: () => void;
+}
+declare class AudioCore {
+    context: AudioContext;
+    private buffer;
+    private playing;
+    private wakeupList;
+    private workletNode?;
+    private beeper?;
+    private runtime;
+    private masterVolume;
+    constructor(runtime: any);
+    /**
+     * Check if audio context is running
+     */
+    isStarted(): boolean;
+    /**
+     * Add item to wakeup list (for mobile audio activation)
+     */
+    addToWakeUpList(item: WakeUpItem): void;
+    private interfaceCache;
+    /**
+     * Set master volume (0-1). Applied as a multiplier to all sound/music playback.
+     */
+    setVolume(volume: number): void;
+    /**
+     * Get current master volume (0-1)
+     */
+    getVolume(): number;
+    /**
+     * Get interface for game code
+     */
+    getInterface(): Record<string, any>;
+    /**
+     * Play sound effect
+     */
+    playSound(sound: any, volume?: number, pitch?: number, pan?: number, loopit?: boolean): number;
+    /**
+     * Play music
+     */
+    playMusic(music: any, volume?: number, loopit?: boolean): number;
+    /**
+     * Get or create audio context (lazy initialization - created on first use)
+     * Note: Browser may suspend context until user interaction, which is handled automatically
+     */
+    getContext(): AudioContext;
+    /**
+     * Start audio processor
+     */
+    start(): Promise<void>;
+    /**
+     * Flush buffered messages
+     */
+    private flushBuffer;
+    /**
+     * Get or create beeper
+     */
+    getBeeper(): Beeper;
+    /**
+     * Play beep sequence
+     */
+    beep(sequence: string): void;
+    /**
+     * Add beeps to audio processor
+     */
+    addBeeps(beeps: any[]): void;
+    /**
+     * Cancel all beeps
+     */
+    cancelBeeps(): void;
+    /**
+     * Add playing sound/music to list
+     */
+    addPlaying(item: PlayingHandle): void;
+    /**
+     * Remove playing sound/music from list
+     */
+    removePlaying(item: PlayingHandle): void;
+    /**
+     * Stop all playing sounds/music
+     */
+    stopAll(): void;
+}
+
+export { AudioCore };

package/dist/core/audio-core.d.ts

@@ -0,0 +1,98 @@
+import { Beeper } from '../devices/beeper.js';
+
+/**
+ * AudioCore - Web Audio API wrapper
+ * Manages audio context, beeper, and sound/music playback
+ */
+
+/** An actively playing sound/music that can be stopped */
+interface PlayingHandle {
+    stop: () => void;
+}
+/** Item that can be woken up on audio context activation */
+interface WakeUpItem {
+    wakeUp: () => void;
+}
+declare class AudioCore {
+    context: AudioContext;
+    private buffer;
+    private playing;
+    private wakeupList;
+    private workletNode?;
+    private beeper?;
+    private runtime;
+    private masterVolume;
+    constructor(runtime: any);
+    /**
+     * Check if audio context is running
+     */
+    isStarted(): boolean;
+    /**
+     * Add item to wakeup list (for mobile audio activation)
+     */
+    addToWakeUpList(item: WakeUpItem): void;
+    private interfaceCache;
+    /**
+     * Set master volume (0-1). Applied as a multiplier to all sound/music playback.
+     */
+    setVolume(volume: number): void;
+    /**
+     * Get current master volume (0-1)
+     */
+    getVolume(): number;
+    /**
+     * Get interface for game code
+     */
+    getInterface(): Record<string, any>;
+    /**
+     * Play sound effect
+     */
+    playSound(sound: any, volume?: number, pitch?: number, pan?: number, loopit?: boolean): number;
+    /**
+     * Play music
+     */
+    playMusic(music: any, volume?: number, loopit?: boolean): number;
+    /**
+     * Get or create audio context (lazy initialization - created on first use)
+     * Note: Browser may suspend context until user interaction, which is handled automatically
+     */
+    getContext(): AudioContext;
+    /**
+     * Start audio processor
+     */
+    start(): Promise<void>;
+    /**
+     * Flush buffered messages
+     */
+    private flushBuffer;
+    /**
+     * Get or create beeper
+     */
+    getBeeper(): Beeper;
+    /**
+     * Play beep sequence
+     */
+    beep(sequence: string): void;
+    /**
+     * Add beeps to audio processor
+     */
+    addBeeps(beeps: any[]): void;
+    /**
+     * Cancel all beeps
+     */
+    cancelBeeps(): void;
+    /**
+     * Add playing sound/music to list
+     */
+    addPlaying(item: PlayingHandle): void;
+    /**
+     * Remove playing sound/music from list
+     */
+    removePlaying(item: PlayingHandle): void;
+    /**
+     * Stop all playing sounds/music
+     */
+    stopAll(): void;
+}
+
+export { AudioCore };