minimojs 1.0.0-alpha.4 → 1.0.0-alpha.5

package/dist/minimo.d.ts

@@ -1009,6 +1009,9 @@ export declare class Game {
      * gesture (click, keypress) before audio can play — always call `sound()` in
      * response to user input or a game event triggered by input.
      *
+     * If you need a melody/sequence, use {@link Game.soundSequence} instead of
+     * multiple `sound()` calls in the same frame.
+     *
      * The tone fades out exponentially over `durationMs` to avoid clicks.
      *
      * @param freq - Frequency in Hz. Middle C = 261.6. Typical range: 100–4000 Hz.
@@ -1022,6 +1025,20 @@ export declare class Game {
      * ```
      */
     sound(freq: number, durationMs: number): void;
+    /**
+     * Plays multiple square-wave tones in strict sequence.
+     *
+     * Each tuple is `[frequencyHz, durationMs]`. The next tone starts when the
+     * previous one ends.
+     *
+     * @param tones - Tone tuples in playback order.
+     *
+     * @example
+     * ```ts
+     * game.soundSequence([660, 80], [820, 90], [980, 110], [1180, 150]);
+     * ```
+     */
+    soundSequence(...tones: Array<readonly [number, number]>): void;
     /**
      * Animates a sprite's {@link Sprite.alpha} from its current value to `to`
      * over `durationMs` milliseconds using **linear interpolation**.

package/dist/minimo.js

@@ -1157,6 +1157,9 @@ export class Game {
      * gesture (click, keypress) before audio can play — always call `sound()` in
      * response to user input or a game event triggered by input.
      *
+     * If you need a melody/sequence, use {@link Game.soundSequence} instead of
+     * multiple `sound()` calls in the same frame.
+     *
      * The tone fades out exponentially over `durationMs` to avoid clicks.
      *
      * @param freq - Frequency in Hz. Middle C = 261.6. Typical range: 100–4000 Hz.
@@ -1188,6 +1191,49 @@ export class Game {
         oscillator.start(ctx.currentTime);
         oscillator.stop(ctx.currentTime + durationMs / 1000);
     }
+    /**
+     * Plays multiple square-wave tones in strict sequence.
+     *
+     * Each tuple is `[frequencyHz, durationMs]`. The next tone starts when the
+     * previous one ends.
+     *
+     * @param tones - Tone tuples in playback order.
+     *
+     * @example
+     * ```ts
+     * game.soundSequence([660, 80], [820, 90], [980, 110], [1180, 150]);
+     * ```
+     */
+    soundSequence(...tones) {
+        if (tones.length === 0)
+            return;
+        if (!this._audioCtx) {
+            this._audioCtx = new AudioContext();
+        }
+        const ctx = this._audioCtx;
+        if (ctx.state === "suspended") {
+            ctx.resume();
+        }
+        let startTime = ctx.currentTime;
+        for (const [freq, durationMs] of tones) {
+            if (!Number.isFinite(freq) || !Number.isFinite(durationMs))
+                continue;
+            if (freq <= 0 || durationMs <= 0)
+                continue;
+            const durationSec = durationMs / 1000;
+            const oscillator = ctx.createOscillator();
+            const gain = ctx.createGain();
+            oscillator.type = "square";
+            oscillator.frequency.setValueAtTime(freq, startTime);
+            gain.gain.setValueAtTime(0.08, startTime);
+            gain.gain.exponentialRampToValueAtTime(0.001, startTime + durationSec);
+            oscillator.connect(gain);
+            gain.connect(ctx.destination);
+            oscillator.start(startTime);
+            oscillator.stop(startTime + durationSec);
+            startTime += durationSec;
+        }
+    }
     // -------------------------------------------------------------------------
     // Animations
     // -------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimojs",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.5",
   "description": "MinimoJS v1 — ultra-minimal, flat, deterministic 2D web game engine. Emoji-only sprites, rAF loop, TypeScript-first, LLM-friendly.",
   "type": "module",
   "main": "dist/minimo.js",