minimojs 1.0.0-alpha.33 → 1.0.0-alpha.34

package/dist/minimo.d.ts

@@ -2072,9 +2072,12 @@ export declare class Game {
     /**
      * Plays a square-wave beep using the Web Audio API.
      *
-     * **Square wave only.** This synthesizes a tone and needs no file. To play
-     * a recorded sound, load it with {@link Game.loadSound} and play it with
-     * {@link Game.playSound}.
+     * **Retro tone, not a game's sound.** This synthesizes a square-wave tone and
+     * needs no file, so it sounds like an old arcade machine. A game's music and
+     * sound effects are audio files: declare them as `sound` entries in an asset
+     * file, or load them with {@link Game.loadSound}, and play them with
+     * {@link Game.playSound}. Use tones only for a deliberately retro game, or
+     * when no audio file can be obtained.
      *
      * The AudioContext is created lazily on first call. Browsers require a user
      * gesture (click, keypress) before audio can play — always call `sound()` in
@@ -2092,13 +2095,16 @@ export declare class Game {
      * ```ts
      * game.sound(440, 100);   // 440 Hz beep for 100ms
      * game.sound(261, 500);   // middle C for 500ms
-     * game.sound(880, 50);    // high beep for 50ms (jump sound)
+     * game.sound(880, 50);    // high beep for 50ms
      * ```
      */
     sound(freq: number, durationMs: number): void;
     /**
      * Plays multiple square-wave tones in strict sequence.
      *
+     * Like {@link Game.sound}, this is a retro tone, not a game's sound: for
+     * music and sound effects, play audio files with {@link Game.playSound}.
+     *
      * Each tuple is `[frequencyHz, durationMs]`. The next tone starts when the
      * previous one ends.
      *

package/dist/minimo.js

@@ -2400,9 +2400,12 @@ export class Game {
     /**
      * Plays a square-wave beep using the Web Audio API.
      *
-     * **Square wave only.** This synthesizes a tone and needs no file. To play
-     * a recorded sound, load it with {@link Game.loadSound} and play it with
-     * {@link Game.playSound}.
+     * **Retro tone, not a game's sound.** This synthesizes a square-wave tone and
+     * needs no file, so it sounds like an old arcade machine. A game's music and
+     * sound effects are audio files: declare them as `sound` entries in an asset
+     * file, or load them with {@link Game.loadSound}, and play them with
+     * {@link Game.playSound}. Use tones only for a deliberately retro game, or
+     * when no audio file can be obtained.
      *
      * The AudioContext is created lazily on first call. Browsers require a user
      * gesture (click, keypress) before audio can play — always call `sound()` in
@@ -2420,7 +2423,7 @@ export class Game {
      * ```ts
      * game.sound(440, 100);   // 440 Hz beep for 100ms
      * game.sound(261, 500);   // middle C for 500ms
-     * game.sound(880, 50);    // high beep for 50ms (jump sound)
+     * game.sound(880, 50);    // high beep for 50ms
      * ```
      */
     sound(freq, durationMs) {
@@ -2429,6 +2432,9 @@ export class Game {
     /**
      * Plays multiple square-wave tones in strict sequence.
      *
+     * Like {@link Game.sound}, this is a retro tone, not a game's sound: for
+     * music and sound effects, play audio files with {@link Game.playSound}.
+     *
      * Each tuple is `[frequencyHz, durationMs]`. The next tone starts when the
      * previous one ends.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimojs",
-  "version": "1.0.0-alpha.33",
+  "version": "1.0.0-alpha.34",
   "description": "MinimoJS v1 — ultra-minimal, flat, deterministic 2D web game engine. Image-first sprites with emoji as a zero-asset alternative, rAF loop, TypeScript-first, LLM-friendly.",
   "type": "module",
   "main": "dist/minimo.js",