@nayan-ui/games 1.18.0 → 1.20.0

package/src/services/SoundsService.ts

@@ -0,0 +1,582 @@
+// Game sound effects: short, synthesised WAVs (scripts/build-sfx.py → src/assets/sfx) played through
+// the Nayan engine's mixer, which mixes them in Rust on the audio thread, so they're instant, overlap
+// freely and never queue up the way spoken phrases did. Every game's events are mapped below onto the
+// sound that fits them best (with a volume and pitch where it helps tell sounds apart).
+//
+// Games call playSound(GAME_SOUNDS.<GAME>.<EVENT>, settings.enableSounds) as before.
+import type { AudioPlayOptions, SoundBank, Voice } from '@nayan-ui/engine';
+import { SFX_SOURCES, type SfxName } from './SfxSources';
+
+export interface SoundConfig {
+  /** The sound effect to play. */
+  sfx?: SfxName;
+  /** 0..2, default 1. */
+  volume?: number;
+  /** Playback speed, which also shifts the pitch. Default 1. */
+  pitch?: number;
+  /** No longer spoken; kept so older call sites that pass a phrase still type-check. */
+  text?: string;
+  rate?: number;
+  language?: string;
+  /** Minimum gap between repeated instances, in milliseconds. */
+  cooldown?: number;
+  /** Repeat a music/ambience clip until its voice is stopped. */
+  loop?: boolean;
+}
+
+// Keep the engine out of the home screen's metadata import. Each decoded sound is shared
+// across games, but opening one game should not fetch and decode every game's effects.
+const banks = new Map<SfxName, SoundBank<SfxName>>();
+const engine = (): typeof import('@nayan-ui/engine') => require('@nayan-ui/engine');
+const loadBank = (name: SfxName): SoundBank<SfxName> | null => {
+  const { audio, isEngineAvailable } = engine();
+  if (!isEngineAvailable) return null;
+  let bank = banks.get(name);
+  if (!bank) {
+    bank = audio.load({ [name]: SFX_SOURCES[name] } as Record<SfxName, number>);
+    banks.set(name, bank);
+  }
+  return bank;
+};
+
+// The same sound re-triggered within this window is dropped (so a burst of events doesn't stack it)
+const MIN_REPEAT_INTERVAL = 30;
+const _lastPlay = new Map<SfxName, number>();
+// Recently started voices, so stopAllSounds can cut them off
+const MAX_TRACKED_VOICES = 24;
+const _voices: Voice[] = [];
+
+/** Loads the sound effects ahead of use (e.g. when a game opens), so the first one isn't skipped. */
+export const preloadSounds = (sounds?: Record<string, SoundConfig> | SoundConfig[]): void => {
+  if (!sounds) return;
+  for (const sound of Object.values(sounds)) if (sound.sfx) loadBank(sound.sfx);
+};
+
+function gameSoundConfigs(gameId: string): SoundConfig[] {
+  const key = gameId.replace(/-/g, '_').toUpperCase();
+  const sounds = GAME_SOUNDS[key as keyof typeof GAME_SOUNDS];
+  return [
+    ...(sounds && !('sfx' in sounds) ? Object.values(sounds as Record<string, SoundConfig>) : []),
+    GAME_SOUNDS.WELL_DONE,
+    GAME_SOUNDS.TIME_UP,
+    GAME_SOUNDS.STOP,
+    GAME_SOUNDS.RESET,
+    GAME_SOUNDS.DRAW
+  ];
+}
+
+/** Loads a game's effects on opening, including games excluded from homepage preloading. */
+export const preloadGameSounds = (gameId: string): void => preloadSounds(gameSoundConfigs(gameId));
+
+/** Decode only the selected games' effects, sharing each clip and leaving other banks lazy. */
+export function* warmSoundAssets(gameIds: readonly string[]): Iterable<() => Promise<unknown>> {
+  const names = new Set<SfxName>();
+  for (const id of gameIds) for (const sound of gameSoundConfigs(id)) if (sound.sfx) names.add(sound.sfx);
+  yield () => Promise.all([...names].map((name) => loadBank(name)?.ready));
+}
+
+export const playSound = (soundConfig: SoundConfig, soundEnabled: boolean, _force?: boolean): void => {
+  playSoundVoice(soundConfig, soundEnabled);
+};
+
+/** For game-owned effects that must stop immediately when an action changes. */
+export const playSoundVoice = (soundConfig: SoundConfig, soundEnabled: boolean): Voice | null => {
+  if (!soundEnabled || !soundConfig?.sfx) return null;
+  const b = loadBank(soundConfig.sfx);
+  if (!b) return null;
+  const { audio } = engine();
+  if (audio.muted) return null;
+  const now = Date.now();
+  if (now - (_lastPlay.get(soundConfig.sfx) ?? 0) < (soundConfig.cooldown ?? MIN_REPEAT_INTERVAL)) return null;
+  _lastPlay.set(soundConfig.sfx, now);
+  return playBankSound(b, soundConfig.sfx, { volume: soundConfig.volume ?? 1, pitch: soundConfig.pitch ?? 1, loop: soundConfig.loop });
+};
+
+/** Tracks custom native one-shots too, so race/forest effects stop with the shared game screen. */
+export const playBankSound = <K extends string>(bank: SoundBank<K> | undefined, name: K, options?: AudioPlayOptions): Voice | null => {
+  const { audio } = engine();
+  if (!bank || audio.muted) return null;
+  const voice = bank.play(name, options);
+  if (voice != null) {
+    _voices.push(voice);
+    if (_voices.length > MAX_TRACKED_VOICES) audio.stop(_voices.shift());
+  }
+  return voice;
+};
+
+export const stopAllSounds = (): void => {
+  _lastPlay.clear();
+  if (!_voices.length) return;
+  const { audio } = engine();
+  for (const v of _voices) audio.stop(v);
+  _voices.length = 0;
+};
+
+// Every game's events, mapped onto the sound effect that fits them best
+export const GAME_SOUNDS = {
+  STOP: { sfx: 'deselect', volume: 0.5 } as SoundConfig,
+  RESET: { sfx: 'click', volume: 0.5 } as SoundConfig,
+  DRAW: { sfx: 'draw' } as SoundConfig,
+  PLAY_WITH_TUA: {
+    START: { sfx: 'start', volume: 0.65 } as SoundConfig,
+    STANDING: { sfx: 'deselect', volume: 0.4 } as SoundConfig,
+    WALKING: { sfx: 'footstep_walk', volume: 0.5 } as SoundConfig,
+    RUNNING: { sfx: 'footstep_run', volume: 0.5 } as SoundConfig,
+    JUMPING: { sfx: 'jump', volume: 0.6 } as SoundConfig,
+    WAVING: { sfx: 'chime', volume: 0.55 } as SoundConfig,
+    WINKING: { sfx: 'pling', volume: 0.45, pitch: 1.15 } as SoundConfig,
+    DANCING: { sfx: 'dance', volume: 0.4, loop: true, cooldown: 0 } as SoundConfig,
+    LAUGHING: { sfx: 'laugh', volume: 0.55 } as SoundConfig,
+    FIGHTING: { sfx: 'swoosh', volume: 0.55 } as SoundConfig,
+    FALLING: { sfx: 'thud', volume: 0.5 } as SoundConfig,
+    LAND: { sfx: 'land', volume: 0.45 } as SoundConfig,
+    STUMBLE: { sfx: 'whoosh', volume: 0.3, pitch: 0.85 } as SoundConfig
+  },
+  TREASURE_HUNT: {
+    START: { sfx: 'start', volume: 0.6 } as SoundConfig,
+    ATTACK: { sfx: 'swoosh', volume: 0.35, pitch: 1.2 } as SoundConfig,
+    IMPACT: { sfx: 'clang', volume: 0.5 } as SoundConfig,
+    DEFEAT: { sfx: 'boom', volume: 0.5 } as SoundConfig,
+    COLLECT: { sfx: 'coin', volume: 0.55 } as SoundConfig,
+    HURT: { sfx: 'hurt', volume: 0.5 } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    LOSE: { sfx: 'game_over' } as SoundConfig
+  },
+  POP: { sfx: 'pop' } as SoundConfig,
+  SWOOSH: { sfx: 'swoosh' } as SoundConfig,
+  BOOM: { sfx: 'boom' } as SoundConfig,
+  WHOOSH: { sfx: 'whoosh' } as SoundConfig,
+  TIME_UP: { sfx: 'time_up' } as SoundConfig,
+  WELL_DONE: { sfx: 'win' } as SoundConfig,
+  WHACK_A_MOLE: {
+    START: { sfx: 'start' } as SoundConfig,
+    HIT: { sfx: 'whack' } as SoundConfig,
+    MISS: { sfx: 'swoosh', volume: 0.6 } as SoundConfig,
+    SPAWN: { sfx: 'pop_soft', volume: 0.7, pitch: 0.85 } as SoundConfig,
+    EMPTY_TAP: { sfx: 'thud', volume: 0.6 } as SoundConfig,
+    TIME_WARNING: { sfx: 'warning' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  BALLOON_BLASTER: {
+    START: { sfx: 'start' } as SoundConfig,
+    POP: { sfx: 'balloon_pop' } as SoundConfig,
+    BOMB: { sfx: 'boom' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  FRUIT_NINJA: {
+    START: { sfx: 'start' } as SoundConfig,
+    SLICE: { sfx: 'slice' } as SoundConfig,
+    BOMB: { sfx: 'boom' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  MAZE_RUNNER: {
+    TURN: { sfx: 'tick', volume: 0.25 } as SoundConfig,
+    BUMP: { sfx: 'thud', volume: 0.4, cooldown: 180 } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    COMPLETE: { sfx: 'win' } as SoundConfig,
+    STOP: { sfx: 'deselect', volume: 0.5 } as SoundConfig
+  },
+  SPACE_FIGHTER: {
+    START: { sfx: 'start' } as SoundConfig,
+    DODGE: { sfx: 'whoosh', volume: 0.7 } as SoundConfig,
+    COLLISION: { sfx: 'crash' } as SoundConfig,
+    GRAB: { sfx: 'swoosh', volume: 0.45, pitch: 1.25 } as SoundConfig,
+    RELEASE: { sfx: 'swoosh', volume: 0.3, pitch: 0.8 } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig
+  },
+  DINO_JUMP: {
+    WIN: { sfx: 'win' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    JUMP: { sfx: 'jump' } as SoundConfig,
+    COLLECT: { sfx: 'coin' } as SoundConfig,
+    HIT: { sfx: 'hurt' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  COLORS_SORT: {
+    PICK: { sfx: 'select', volume: 0.6 } as SoundConfig,
+    DESELECT: { sfx: 'deselect', volume: 0.5 } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    MATCH: { sfx: 'drop', volume: 0.8, pitch: 1.2 } as SoundConfig,
+    COMPLETE: { sfx: 'win' } as SoundConfig,
+    MISS: { sfx: 'invalid' } as SoundConfig
+  },
+  FRUIT_MERGER: {
+    START: { sfx: 'start' } as SoundConfig,
+    MERGE: { sfx: 'merge' } as SoundConfig,
+    DROP: { sfx: 'drop', volume: 0.8 } as SoundConfig,
+    COMPLETE: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  FLAPPY_BIRD: {
+    START: { sfx: 'start' } as SoundConfig,
+    FLAP: { sfx: 'flap' } as SoundConfig,
+    PASS: { sfx: 'coin', volume: 0.6 } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig
+  },
+  CAR_RACING: {
+    START: { sfx: 'start' } as SoundConfig,
+    LANE_SWITCH: { sfx: 'swoosh', volume: 0.5 } as SoundConfig,
+    PASS: { sfx: 'coin', volume: 0.6 } as SoundConfig,
+    CRASH: { sfx: 'crash' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  BIKE_RACING: {
+    START: { sfx: 'start' } as SoundConfig,
+    LANE_SWITCH: { sfx: 'swoosh', volume: 0.5 } as SoundConfig,
+    PASS: { sfx: 'coin', volume: 0.6 } as SoundConfig,
+    CRASH: { sfx: 'crash' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  BLOCK_BLAST: {
+    PICK: { sfx: 'select', volume: 0.45 } as SoundConfig,
+    INVALID: { sfx: 'invalid', volume: 0.6 } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    PLACE: { sfx: 'place' } as SoundConfig,
+    CLEAR: { sfx: 'capture' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  CONNECT_EM_ALL: {
+    WIN: { sfx: 'win' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    CONNECT: { sfx: 'tick', volume: 0.8 } as SoundConfig,
+    CLEAR: { sfx: 'capture' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  POPIT_FIDGET: {
+    START: { sfx: 'start' } as SoundConfig,
+    POP: { sfx: 'pop_soft' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  PERFECT_CIRCLE: {
+    START: { sfx: 'start' } as SoundConfig,
+    DRAW_END: { sfx: 'tock' } as SoundConfig,
+    SUCCESS: { sfx: 'bonus' } as SoundConfig,
+    FAIL: { sfx: 'miss' } as SoundConfig
+  },
+  SPIDER_SOLITAIRE: {
+    START: { sfx: 'shuffle' } as SoundConfig,
+    DRAW: { sfx: 'card_flip' } as SoundConfig,
+    SELECT: { sfx: 'tap' } as SoundConfig,
+    DESELECT: { sfx: 'deselect', volume: 0.7 } as SoundConfig,
+    PLACE: { sfx: 'card_place' } as SoundConfig,
+    INVALID: { sfx: 'invalid' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    COMPLETE: { sfx: 'bonus' } as SoundConfig
+  },
+  TIC_TAC_TOE: {
+    TIME_UP: { sfx: 'time_up' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    PLACE: { sfx: 'place' } as SoundConfig,
+    ROBOT: { sfx: 'robot', volume: 0.7 } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    LOSE: { sfx: 'lose' } as SoundConfig,
+    DRAW: { sfx: 'draw' } as SoundConfig
+  },
+  STACK_TOWER: {
+    START: { sfx: 'start' } as SoundConfig,
+    PLACE: { sfx: 'clack' } as SoundConfig,
+    PERFECT: { sfx: 'pling' } as SoundConfig,
+    MISS: { sfx: 'miss' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig
+  },
+  BLOCK_BREAKER: {
+    START: { sfx: 'start' } as SoundConfig,
+    HIT: { sfx: 'click' } as SoundConfig,
+    DESTROY: { sfx: 'pop' } as SoundConfig,
+    PADDLE: { sfx: 'tock', volume: 0.8, pitch: 0.8 } as SoundConfig,
+    WALL: { sfx: 'tick', volume: 0.6 } as SoundConfig,
+    LOSE_LIFE: { sfx: 'hurt' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    POWER_UP: { sfx: 'power_up' } as SoundConfig,
+    LAUNCH: { sfx: 'jump', volume: 0.7 } as SoundConfig,
+    COMBO: { sfx: 'combo' } as SoundConfig
+  },
+  MINE_SWEEPER: {
+    START: { sfx: 'start' } as SoundConfig,
+    REVEAL: { sfx: 'reveal' } as SoundConfig,
+    FLAG: { sfx: 'flag' } as SoundConfig,
+    MINE_HIT: { sfx: 'boom' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig
+  },
+  SUDOKU: {
+    START: { sfx: 'start' } as SoundConfig,
+    PLACE: { sfx: 'tap' } as SoundConfig,
+    ERROR: { sfx: 'error' } as SoundConfig,
+    NOTE: { sfx: 'tick' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig
+  },
+  COLOR_SWITCH: {
+    START: { sfx: 'start' } as SoundConfig,
+    JUMP: { sfx: 'hop' } as SoundConfig,
+    PASS: { sfx: 'coin', volume: 0.6 } as SoundConfig,
+    COLOR_CHANGE: { sfx: 'pling', volume: 0.8, pitch: 1.2 } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  KNIFE_HIT: {
+    START: { sfx: 'start' } as SoundConfig,
+    THROW: { sfx: 'swoosh', volume: 0.7 } as SoundConfig,
+    STICK: { sfx: 'thunk' } as SoundConfig,
+    HIT: { sfx: 'clang' } as SoundConfig,
+    APPLE: { sfx: 'crunch' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  PIPE_CONNECT: {
+    START: { sfx: 'start' } as SoundConfig,
+    ROTATE: { sfx: 'rotate' } as SoundConfig,
+    COMPLETE: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  TILE_HOME: {
+    START: { sfx: 'start' } as SoundConfig,
+    PICK: { sfx: 'tap' } as SoundConfig,
+    MATCH: { sfx: 'pling' } as SoundConfig,
+    SHUFFLE: { sfx: 'shuffle' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  BUBBLE_SHOOTER: {
+    START: { sfx: 'start' } as SoundConfig,
+    SHOOT: { sfx: 'swoosh', volume: 0.6, pitch: 1.3 } as SoundConfig,
+    POP: { sfx: 'pop' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  DOTS_AND_BOXES: {
+    START: { sfx: 'start' } as SoundConfig,
+    PLAYER_LINE: { sfx: 'tick' } as SoundConfig,
+    OPPONENT_LINE: { sfx: 'tock' } as SoundConfig,
+    BOX_CLAIMED: { sfx: 'pling' } as SoundConfig,
+    OPPONENT_BOX: { sfx: 'pling', volume: 0.8, pitch: 0.75 } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    LOSE: { sfx: 'lose' } as SoundConfig
+  },
+  CANDY_CRUSH: {
+    BOMB: { sfx: 'boom', volume: 0.65 } as SoundConfig,
+    BLAST: { sfx: 'zap', volume: 0.6 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    SELECT: { sfx: 'tap' } as SoundConfig,
+    SWAP: { sfx: 'slide' } as SoundConfig,
+    INVALID_SWAP: { sfx: 'invalid' } as SoundConfig,
+    MATCH: { sfx: 'pop' } as SoundConfig,
+    COMBO: { sfx: 'combo' } as SoundConfig,
+    WARNING: { sfx: 'warning' } as SoundConfig,
+    TIME_UP: { sfx: 'time_up' } as SoundConfig
+  },
+  LUDO_KING: {
+    TAP: { sfx: 'select', volume: 0.5 } as SoundConfig,
+    SIX: { sfx: 'six', volume: 0.7 } as SoundConfig,
+    PENALTY: { sfx: 'error', volume: 0.7 } as SoundConfig,
+    CANT_MOVE: { sfx: 'invalid', volume: 0.6 } as SoundConfig,
+    FINISH: { sfx: 'bonus', volume: 0.7 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    ROLL: { sfx: 'dice_roll' } as SoundConfig,
+    MOVE: { sfx: 'tick' } as SoundConfig,
+    CAPTURE: { sfx: 'whack' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  TANK_1990: {
+    DAMAGE: { sfx: 'hurt', volume: 0.7 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    FIRE: { sfx: 'cannon' } as SoundConfig,
+    DESTROY: { sfx: 'boom', volume: 0.8 } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  NUTS_AND_BOLTS: {
+    START: { sfx: 'start' } as SoundConfig,
+    SELECT: { sfx: 'rotate' } as SoundConfig,
+    PLACE: { sfx: 'snap' } as SoundConfig,
+    COMPLETE: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  WORD_SEARCH: {
+    START: { sfx: 'start' } as SoundConfig,
+    FOUND: { sfx: 'pling' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  NUMBER_SEARCH: {
+    START: { sfx: 'start' } as SoundConfig,
+    FOUND: { sfx: 'pling' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  SLIDING_NUMBERS: {
+    BLOCKED: { sfx: 'blocked', volume: 0.6 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    MOVE: { sfx: 'slide' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  SNAKE_3D: {
+    TIME_UP: { sfx: 'time_up' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    EAT: { sfx: 'eat' } as SoundConfig,
+    SPECIAL: { sfx: 'bonus' } as SoundConfig,
+    COLLISION: { sfx: 'hurt' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  GAME_2048: {
+    TIME_UP: { sfx: 'time_up' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    TILE_MOVE: { sfx: 'slide', volume: 0.7 } as SoundConfig,
+    TILE_MERGE: { sfx: 'merge' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig,
+    NEW_TILE: { sfx: 'pop_soft', volume: 0.6 } as SoundConfig,
+    INVALID_MOVE: { sfx: 'blocked' } as SoundConfig
+  },
+  ARROWS: {
+    START: { sfx: 'start' } as SoundConfig,
+    CLEAR: { sfx: 'swoosh' } as SoundConfig,
+    BLOCKED: { sfx: 'blocked' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  FIND_DIFFERENT_NUMBER: {
+    START: { sfx: 'start' } as SoundConfig,
+    CORRECT: { sfx: 'chime' } as SoundConfig,
+    WRONG: { sfx: 'error' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  TANGRAM: {
+    START: { sfx: 'start' } as SoundConfig,
+    ROTATE: { sfx: 'rotate' } as SoundConfig,
+    PLACE: { sfx: 'snap' } as SoundConfig,
+    WRONG: { sfx: 'invalid' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  CHECKERS: {
+    TIME_UP: { sfx: 'time_up' } as SoundConfig,
+    SELECT: { sfx: 'select', volume: 0.5 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    MOVE: { sfx: 'place' } as SoundConfig,
+    CAPTURE: { sfx: 'clack', pitch: 0.9 } as SoundConfig,
+    KING: { sfx: 'bonus' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    LOSE: { sfx: 'lose' } as SoundConfig
+  },
+  MEMORY_MATCH: {
+    START: { sfx: 'shuffle' } as SoundConfig,
+    FLIP: { sfx: 'card_flip' } as SoundConfig,
+    MATCH: { sfx: 'chime' } as SoundConfig,
+    WRONG: { sfx: 'invalid' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'time_up' } as SoundConfig
+  },
+  FALLING_STICKS: {
+    START: { sfx: 'start' } as SoundConfig,
+    CATCH: { sfx: 'catch' } as SoundConfig,
+    MISS: { sfx: 'miss' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  REVERSI: {
+    TIME_UP: { sfx: 'time_up' } as SoundConfig,
+    INVALID: { sfx: 'invalid', volume: 0.6 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    PLACE: { sfx: 'flip_disc' } as SoundConfig,
+    PASS: { sfx: 'invalid', volume: 0.7 } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    LOSE: { sfx: 'lose' } as SoundConfig
+  },
+  PAC_MAN: {
+    START: { sfx: 'start' } as SoundConfig,
+    CHOMP: { sfx: 'chomp', volume: 0.6 } as SoundConfig,
+    CHOMP_ALT: { sfx: 'chomp_alt', volume: 0.6 } as SoundConfig,
+    POWER_PELLET: { sfx: 'power_up' } as SoundConfig,
+    EAT_GHOST: { sfx: 'crunch' } as SoundConfig,
+    EAT_GHOST_COMBO: { sfx: 'combo' } as SoundConfig,
+    DEATH: { sfx: 'game_over' } as SoundConfig,
+    LIFE_LOST: { sfx: 'hurt' } as SoundConfig,
+    FRUIT: { sfx: 'coin' } as SoundConfig,
+    LEVEL_COMPLETE: { sfx: 'win' } as SoundConfig,
+    DIRECTION_CHANGE: { sfx: 'tick', volume: 0.3 } as SoundConfig,
+    TUNNEL: { sfx: 'whoosh', volume: 0.7 } as SoundConfig
+  },
+  SNAKES_AND_LADDERS: {
+    TAP: { sfx: 'select', volume: 0.5 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    ROLL: { sfx: 'dice_roll' } as SoundConfig,
+    MOVE: { sfx: 'tick', volume: 0.7 } as SoundConfig,
+    SNAKE: { sfx: 'snake' } as SoundConfig,
+    LADDER: { sfx: 'ladder' } as SoundConfig,
+    SIX: { sfx: 'six' } as SoundConfig,
+    PENALTY: { sfx: 'error' } as SoundConfig,
+    CANT_MOVE: { sfx: 'invalid' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  BLUK: {
+    WIN: { sfx: 'win' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    JUMP: { sfx: 'jump' } as SoundConfig,
+    LAND: { sfx: 'land' } as SoundConfig,
+    PERFECT: { sfx: 'pling' } as SoundConfig,
+    FALL: { sfx: 'miss' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  CHAMELEON_RUN: {
+    HURT: { sfx: 'hurt' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    JUMP: { sfx: 'hop' } as SoundConfig,
+    SWAP: { sfx: 'select' } as SoundConfig,
+    STAR: { sfx: 'star' } as SoundConfig,
+    LAND: { sfx: 'land', volume: 0.7 } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  MOB_CONTROL: {
+    START: { sfx: 'start' } as SoundConfig,
+    SHOOT: { sfx: 'pew', volume: 0.35 } as SoundConfig,
+    GATE: { sfx: 'gate' } as SoundConfig,
+    HIT: { sfx: 'whack', volume: 0.6 } as SoundConfig,
+    CLASH: { sfx: 'clash', volume: 0.35, cooldown: 150 } as SoundConfig,
+    LEVEL_UP: { sfx: 'boom' } as SoundConfig,
+    DAMAGE: { sfx: 'hurt' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  PAPER_IO: {
+    WIN: { sfx: 'win' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    CAPTURE: { sfx: 'capture' } as SoundConfig,
+    TURN: { sfx: 'tick', volume: 0.5 } as SoundConfig,
+    KILL: { sfx: 'zap' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  CROSSY_ROAD: {
+    TIME_UP: { sfx: 'time_up' } as SoundConfig,
+    WIN: { sfx: 'win' } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    HOP: { sfx: 'hop' } as SoundConfig,
+    CROSS: { sfx: 'chime' } as SoundConfig,
+    COIN: { sfx: 'coin' } as SoundConfig,
+    SPLASH: { sfx: 'splash' } as SoundConfig,
+    CRASH: { sfx: 'crash' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  },
+  PENGUIN_RUN: {
+    LANE_SWITCH: { sfx: 'swoosh', volume: 0.25 } as SoundConfig,
+    START: { sfx: 'start' } as SoundConfig,
+    COIN: { sfx: 'coin', volume: 0.6 } as SoundConfig,
+    GEM: { sfx: 'power_up' } as SoundConfig,
+    JUMP: { sfx: 'jump' } as SoundConfig,
+    SLIDE: { sfx: 'slide' } as SoundConfig,
+    CRASH: { sfx: 'crash' } as SoundConfig,
+    GAME_OVER: { sfx: 'game_over' } as SoundConfig
+  }
+};