@nayan-ui/games 1.20.0 → 1.21.0

package/src/services/GameAssetLoader.ts

@@ -1,111 +0,0 @@
-export type AssetTask = () => unknown;
-export interface AssetStage {
-  label: string;
-  tasks: () => Iterable<AssetTask>;
-}
-export interface LoadTiming {
-  afterPaint(run: () => void): () => void;
-  now?: () => number;
-}
-const FRAME_BUDGET_MS = 4;
-const MAX_JOBS_PER_FRAME = 64;
-const timing: LoadTiming = {
-  afterPaint(run) {
-    let timer: ReturnType<typeof setTimeout> | undefined;
-    const frame = requestAnimationFrame(() => {
-      timer = setTimeout(run, 0);
-    });
-    return () => {
-      cancelAnimationFrame(frame);
-      if (timer !== undefined) clearTimeout(timer);
-    };
-  }
-};
-
-/** Paint first, then batch small jobs within a frame budget, yielding between expensive builders. */
-export class GameAssetLoader {
-  private stage = 0;
-  private iterator?: Iterator<AssetTask>;
-  private task?: AssetTask;
-  private cancel?: () => void;
-  private active = false;
-  private busy = false;
-  private disposed = false;
-  private done = false;
-  constructor(
-    private stages: readonly AssetStage[],
-    private changed: (label: string) => void,
-    private finished: () => void,
-    private failed: (error: unknown) => void,
-    private clock: LoadTiming = timing
-  ) {}
-  start() {
-    if (this.disposed || this.done) return;
-    this.active = true;
-    this.schedule();
-  }
-  pause() {
-    this.active = false;
-    this.cancel?.();
-    this.cancel = undefined;
-  }
-  dispose() {
-    this.pause();
-    this.disposed = true;
-  }
-  private schedule() {
-    if (!this.active || this.busy || this.cancel || this.disposed || this.done) return;
-    this.cancel = this.clock.afterPaint(() => {
-      this.cancel = undefined;
-      void this.step();
-    });
-  }
-  private async step() {
-    if (!this.active || this.disposed) return;
-    this.busy = true;
-    const now = () => this.clock.now?.() ?? performance.now();
-    const started = now();
-    try {
-      for (let jobs = 0; jobs < MAX_JOBS_PER_FRAME && this.active && !this.disposed; jobs++) {
-        const stage = this.stages[this.stage];
-        if (!stage) {
-          this.done = true;
-          this.active = false;
-          this.finished();
-          return;
-        }
-        if (!this.iterator) {
-          this.changed(stage.label);
-          this.iterator = stage.tasks()[Symbol.iterator]();
-        }
-        if (!this.task) {
-          const next = this.iterator.next();
-          if (next.done) {
-            this.iterator = undefined;
-            this.stage++;
-            continue;
-          }
-          this.task = next.value;
-        }
-        if (!this.active || this.disposed) break;
-        const result = this.task();
-        if (result && typeof (result as PromiseLike<unknown>).then === 'function') await result;
-        this.task = undefined;
-        if (now() - started >= FRAME_BUDGET_MS) break;
-      }
-    } catch (error) {
-      this.reject(error);
-    } finally {
-      this.busy = false;
-    }
-    this.schedule();
-  }
-  private reject(error: unknown) {
-    this.busy = false;
-    if (this.disposed) return;
-    // A thrown generator is closed: retry the stage; completed model factories retain their caches.
-    if (!this.task) this.iterator = undefined;
-    this.pause();
-    this.failed(error);
-  }
-}

package/src/services/GameAssets.ts

@@ -1,149 +0,0 @@
-import type { AssetStage, AssetTask } from './GameAssetLoader';
-import { resolveGameTheme } from './ThemeService';
-// Prepare only the selected game; the engine owns durable assets and in-session mesh reuse.
-import { GAME_IDS, type GameThemeMode } from './UtilsService';
-
-/** Give module evaluation its own frame before running any of its model builders. */
-function* deferred(load: () => Iterable<AssetTask>): Iterable<AssetTask> {
-  let tasks: Iterable<AssetTask> = [];
-  yield () => {
-    tasks = load();
-  };
-  yield* tasks;
-}
-
-// Opt in only games with expensive imported/procedural models. Tile Home is included for its fruit
-// meshes; other board games use built-ins and create their small resources when opened.
-const HEAVY_GAME_ASSETS = {
-  [GAME_IDS.PLAY_WITH_TUA]: function* () {
-    yield* deferred(() => require('../games/play-with-tua/PlayWithTuaModel').warmAssets());
-  },
-  [GAME_IDS.TREASURE_HUNT]: function* () {
-    yield* deferred(() => require('../games/treasure-hunt/TreasureHuntConstants').warmAssets());
-    yield* deferred(() => require('../games/treasure-hunt/TreasureHuntScene').warmAssets());
-    yield* deferred(() => require('../games/treasure-hunt/TreasureHuntModel').warmAssets());
-  },
-  [GAME_IDS.TILE_HOME]: function* () {
-    const { TILE_TYPES } = require('../games/tile-home/TileHomeConstants') as typeof import('../games/tile-home/TileHomeConstants');
-    yield* deferred(() =>
-      require('../games/shared/EngineFruits').warmAssets(
-        TILE_TYPES.map((t) => t.fruit),
-        0.25
-      )
-    );
-  },
-  [GAME_IDS.FRUIT_MERGER]: function* () {
-    yield* deferred(() => require('../games/fruit-merger/FruitMergerScene').warmAssets());
-  },
-  [GAME_IDS.FRUIT_NINJA]: function* () {
-    const { FRUIT_KINDS, FRUIT_DETAIL } =
-      require('../games/fruit-ninja/FruitNinjaConstants') as typeof import('../games/fruit-ninja/FruitNinjaConstants');
-    yield* deferred(() => require('../games/shared/EngineFruits').warmAssets(FRUIT_KINDS, FRUIT_DETAIL, true));
-    yield* deferred(() => require('../games/fruit-ninja/FruitNinjaScene').warmAssets());
-  },
-  [GAME_IDS.CAR_RACING]: function* () {
-    yield* deferred(() => require('../games/car-racing/CarRacingConstants').warmAssets());
-    yield* deferred(() => require('../games/car-racing/CarRacingScene').warmAssets());
-  },
-  [GAME_IDS.BIKE_RACING]: function* () {
-    yield* deferred(() => require('../games/car-racing/CarRacingConstants').warmAssets());
-    yield* deferred(() => require('../games/bike-racing/BikeRacingConstants').warmAssets());
-    yield* deferred(() => require('../games/bike-racing/BikeRacingScene').warmAssets());
-  },
-  [GAME_IDS.PENGUIN_RUN]: function* () {
-    yield* deferred(() => require('../games/penguin-run/PenguinMeshes').warmAssets());
-    yield* deferred(() => require('../games/penguin-run/PenguinRunScene').warmAssets());
-  },
-  [GAME_IDS.CHAMELEON_RUN]: function* () {
-    yield* deferred(() => require('../games/chameleon-run/ChameleonRunMeshes').warmAssets());
-  },
-  [GAME_IDS.PAPER_IO]: function* () {
-    yield* deferred(() => require('../games/paper-io/PaperIoMeshes').warmAssets());
-    yield* deferred(() => require('../games/paper-io/PaperIoScene').warmAssets());
-  },
-  [GAME_IDS.CROSSY_ROAD]: function* () {
-    yield* deferred(() => require('../games/crossy-road/CrossyRoadMeshes').warmAssets());
-    yield* deferred(() => require('../games/crossy-road/CrossyRoadPerson').warmAssets());
-  }
-} satisfies Partial<Record<GAME_IDS, () => Iterable<AssetTask>>>;
-
-const prepared = new Set<GAME_IDS>();
-const scenes = new Set<string>();
-let sharedReady = false;
-export const isHeavyGame = (id: GAME_IDS): boolean => Object.hasOwn(HEAVY_GAME_ASSETS, id);
-export const areGameAssetsReady = (id: GAME_IDS, mode?: GameThemeMode): boolean =>
-  prepared.has(id) && scenes.has(`${id}:${mode ?? 'classic'}`) && id !== GAME_IDS.TREASURE_HUNT;
-
-/** Nothing here runs until the selected game's loader has painted. */
-export function gameAssetStages(id: GAME_IDS, mode?: GameThemeMode): AssetStage[] {
-  const build = HEAVY_GAME_ASSETS[id as keyof typeof HEAVY_GAME_ASSETS];
-  return [
-    {
-      label: 'Getting ready',
-      *tasks() {
-        yield () => {
-          const engine = require('@nayan-ui/engine');
-          if (!engine.isEngineAvailable) throw Error('The native game engine is unavailable in this app build');
-          return engine.warmUpEngine();
-        };
-        if (!sharedReady) {
-          yield () => require('../games/shared/EngineHud').loadHudFonts();
-          yield* deferred(() => require('../games/shared/EngineHud').warmAssets());
-          yield* deferred(() => require('../games/shared/EngineBlasts').warmAssets());
-          yield () => {
-            sharedReady = true;
-          };
-        }
-      }
-    },
-    {
-      label: 'Bringing your world to life',
-      *tasks() {
-        // Decode audio alongside the visual builders instead of starting one clip per frame at the end.
-        require('./SoundsService').preloadGameSounds(id);
-        if (!prepared.has(id)) {
-          if (build) yield* build();
-          yield () => {
-            prepared.add(id);
-          };
-        }
-        if (id === GAME_IDS.TREASURE_HUNT) {
-          yield* deferred(() => require('../games/treasure-hunt/TreasureHuntRules').warmNextMap());
-          yield () => {
-            const map = require('../games/treasure-hunt/TreasureHuntRules').peekNextMap();
-            if (map) require('../games/treasure-hunt/TreasureHuntScene').terrainModels(map.landscape.profile);
-          };
-        }
-      }
-    },
-    {
-      label: 'Adding the finishing touches',
-      *tasks() {
-        const key = `${id}:${mode ?? 'classic'}`;
-        if (!scenes.has(key)) {
-          const theme = resolveGameTheme(mode);
-          if ([GAME_IDS.PAPER_IO, GAME_IDS.TILE_HOME, GAME_IDS.FRUIT_MERGER].includes(id))
-            yield () => require('../games/shared/EngineBackdrop').backdropMesh(theme);
-          if (id === GAME_IDS.FRUIT_NINJA) yield* deferred(() => require('../games/shared/EngineMeadow').warmAssets(theme, ['meadow']));
-          if (id === GAME_IDS.CHAMELEON_RUN) yield* deferred(() => require('../games/chameleon-run/ChameleonRunBackdrop').warmAssets(theme));
-          yield* require('./SoundsService').warmSoundAssets([id]);
-          if (id === GAME_IDS.TREASURE_HUNT) yield () => require('../games/treasure-hunt/TreasureHuntConstants').sounds?.ready;
-          yield () => {
-            scenes.add(key);
-          };
-        }
-        // ProceduralCache already writes each built asset asynchronously; persistence does not gate play.
-      }
-    }
-  ];
-}
-
-/** Asset audit tooling; production opens only gameAssetStages(selectedId). */
-export function gameAssetGroups() {
-  return Object.keys(HEAVY_GAME_ASSETS).map((id) => ({
-    id,
-    *tasks() {
-      for (const stage of gameAssetStages(id as GAME_IDS)) yield* stage.tasks();
-    }
-  }));
-}

package/src/services/GameLoaders.ts

@@ -1,93 +0,0 @@
-import type React from 'react';
-import { GAME_IDS, type GameProps } from './UtilsService';
-
-// Every game paints its loading screen before evaluating its module and building its world.
-/* eslint-disable @typescript-eslint/no-var-requires */
-const GAME_LOADERS: Record<GAME_IDS, () => React.ComponentType<GameProps>> = {
-  [GAME_IDS.PLAY_WITH_TUA]: () => require('../games/play-with-tua/PlayWithTua').PlayWithTua,
-  [GAME_IDS.TREASURE_HUNT]: () => require('../games/treasure-hunt/TreasureHunt').TreasureHunt,
-  [GAME_IDS.BLOCK_BLAST]: () => require('../games/block-blast/BlockBlast').BlockBlast,
-  [GAME_IDS.CONNECT_EM_ALL]: () => require('../games/connect-em-all/ConnectEmAll').ConnectEmAll,
-  [GAME_IDS.BUBBLE_SHOOTER]: () => require('../games/bubble-shooter/BubbleShooter').BubbleShooter,
-  [GAME_IDS.BLOCK_BREAKER]: () => require('../games/block-breaker/BlockBreaker').BlockBreaker,
-  [GAME_IDS.TILE_HOME]: () => require('../games/tile-home/TileHome').TileHome,
-  [GAME_IDS.FRUIT_MERGER]: () => require('../games/fruit-merger/FruitMerger').FruitMerger,
-  [GAME_IDS.FRUIT_NINJA]: () => require('../games/fruit-ninja/FruitNinja').FruitNinja,
-  [GAME_IDS.ARROWS]: () => require('../games/arrows/Arrows').Arrows,
-  [GAME_IDS.FLAPPY_BIRD]: () => require('../games/flappy-bird/FlappyBird').FlappyBird,
-  [GAME_IDS.DINO_JUMP]: () => require('../games/dino-jump/DinoJump').DinoJump,
-  [GAME_IDS.SNAKES_AND_LADDERS]: () => require('../games/snakes-and-ladders/SnakesAndLadders').SnakesAndLadders,
-  [GAME_IDS.LUDO_KING]: () => require('../games/ludo-king/LudoKing').LudoKing,
-  [GAME_IDS.DOTS_AND_BOXES]: () => require('../games/dots-and-boxes/DotsAndBoxes').DotsAndBoxes,
-  [GAME_IDS.CANDY_CRUSH]: () => require('../games/candy-crush/CandyCrush').CandyCrush,
-  [GAME_IDS.WHACK_A_MOLE]: () => require('../games/whack-a-mole/WhackAMole').WhackAMole,
-  [GAME_IDS.PAC_MAN]: () => require('../games/pac-man/PacMan').PacMan,
-  [GAME_IDS.COLORS_SORT]: () => require('../games/colors-sort/ColorsSort').ColorsSort,
-  [GAME_IDS.POPIT_FIDGET]: () => require('../games/popit-fidget/PopitFidget').PopitFidget,
-  [GAME_IDS.BALLOON_BLASTER]: () => require('../games/balloon-blaster/BalloonBlaster').BalloonBlaster,
-  [GAME_IDS.SPACE_FIGHTER]: () => require('../games/space-fighter/SpaceFighter').SpaceFighter,
-  [GAME_IDS.WORD_SEARCH]: () => require('../games/word-search/WordSearch').WordSearch,
-  [GAME_IDS.NUMBER_SEARCH]: () => require('../games/number-search/NumberSearch').NumberSearch,
-  [GAME_IDS.FIND_DIFFERENT_NUMBER]: () => require('../games/find-different-number/FindDifferentNumber').FindDifferentNumber,
-  [GAME_IDS.TANK_1990]: () => require('../games/tank-1990/Tank1990').Tank1990,
-  [GAME_IDS.NUTS_AND_BOLTS]: () => require('../games/nuts-and-bolts/NutsAndBolts').NutsAndBolts,
-  [GAME_IDS.STACK_TOWER]: () => require('../games/stack-tower/StackTower').StackTower,
-  [GAME_IDS.PIPE_CONNECT]: () => require('../games/pipe-connect/PipeConnect').PipeConnect,
-  [GAME_IDS.MINE_SWEEPER]: () => require('../games/mine-sweeper/MineSweeper').MineSweeper,
-  [GAME_IDS.KNIFE_HIT]: () => require('../games/knife-hit/KnifeHit').KnifeHit,
-  [GAME_IDS.COLOR_SWITCH]: () => require('../games/color-switch/ColorSwitch').ColorSwitch,
-  [GAME_IDS.SPIDER_SOLITAIRE]: () => require('../games/spider-solitaire/SpiderSolitaire').SpiderSolitaire,
-  [GAME_IDS.MAZE_RUNNER]: () => require('../games/maze-runner/MazeRunner').MazeRunner,
-  [GAME_IDS.TIC_TAC_TOE]: () => require('../games/tic-tac-toe/TicTacToe').TicTacToe,
-  [GAME_IDS.CAR_RACING]: () => require('../games/car-racing/CarRacing').CarRacing,
-  [GAME_IDS.BIKE_RACING]: () => require('../games/bike-racing/BikeRacing').BikeRacing,
-  [GAME_IDS.SLIDING_NUMBERS]: () => require('../games/sliding-numbers/SlidingNumbers').SlidingNumbers,
-  [GAME_IDS.GAME_2048]: () => require('../games/game-2048/Game2048').Game2048,
-  [GAME_IDS.SUDOKU]: () => require('../games/sudoku/Sudoku').Sudoku,
-  [GAME_IDS.SNAKE_3D]: () => require('../games/snake-3d/Snake3D').Snake3D,
-  [GAME_IDS.PERFECT_CIRCLE]: () => require('../games/perfect-circle/PerfectCircle').PerfectCircle,
-  [GAME_IDS.TANGRAM]: () => require('../games/tangram/Tangram').Tangram,
-  [GAME_IDS.CHECKERS]: () => require('../games/checkers/Checkers').Checkers,
-  [GAME_IDS.MEMORY_MATCH]: () => require('../games/memory-match/MemoryMatch').MemoryMatch,
-  [GAME_IDS.FALLING_STICKS]: () => require('../games/falling-sticks/FallingSticks').FallingSticks,
-  [GAME_IDS.REVERSI]: () => require('../games/reversi/Reversi').Reversi,
-  [GAME_IDS.PENGUIN_RUN]: () => require('../games/penguin-run/PenguinRun').PenguinRun,
-  [GAME_IDS.BLUK]: () => require('../games/bluk/Bluk').Bluk,
-  [GAME_IDS.CHAMELEON_RUN]: () => require('../games/chameleon-run/ChameleonRun').ChameleonRun,
-  [GAME_IDS.MOB_CONTROL]: () => require('../games/mob-control/MobControl').MobControl,
-  [GAME_IDS.PAPER_IO]: () => require('../games/paper-io/PaperIo').PaperIo,
-  [GAME_IDS.CROSSY_ROAD]: () => require('../games/crossy-road/CrossyRoad').CrossyRoad
-};
-const components = new Map<GAME_IDS, React.ComponentType<GameProps>>();
-
-/**
- * Get the React component for a game id, loading its module on first use.
- */
-export const loadGameComponent = (gameId: GAME_IDS | null | undefined): React.ComponentType<GameProps> | null => {
-  if (!gameId) return null;
-  const cached = components.get(gameId);
-  if (cached) return cached;
-  const load = GAME_LOADERS[gameId];
-  if (!load) return null;
-  const component = require('../games/shared/EngineGameLoader').withGameLoading(gameId, load);
-  components.set(gameId, component);
-  return component;
-};
-
-function warmEngine(): boolean {
-  const { isEngineAvailable, warmUpEngine } = require('@nayan-ui/engine');
-  if (isEngineAvailable) warmUpEngine();
-  return isEngineAvailable;
-}
-
-/** Explicit engine-only warm-up for existing integrations; game assets load on their screen. */
-export const warmUpGames = (): (() => void) => {
-  warmEngine();
-  return () => {};
-};
-/** @deprecated Games no longer preload from the catalog. */
-export const prioritizeGameAssets = (_ids: readonly string[]) => {};
-/** @deprecated Game-screen loaders own their cancellation. */
-export const pauseGameAssetWarmup = () => {};
-export const getGameAssetWarmupStatus = () => ({ running: false, completed: 0, failed: 0, complete: false });
-/* eslint-enable @typescript-eslint/no-var-requires */

package/src/services/GamesConstants.ts

@@ -1,193 +0,0 @@
-import { GAME_IDS } from './UtilsService';
-
-// Global primary and background colors for all games
-export const PRIMARY_COLOR = '#ffffff';
-export const BACKGROUND_COLOR = '#3a3a5e';
-
-// Derived transparent colors from PRIMARY_COLOR
-export const COLORS = {
-  // Component backgrounds and borders (white transparent)
-  BG_35: 'rgba(255, 255, 255, 0.35)',
-  BG_40: 'rgba(255, 255, 255, 0.40)',
-  BG_50: 'rgba(255, 255, 255, 0.50)',
-  // Overlay backgrounds (black transparent)
-  OVERLAY: 'rgba(0, 0, 0, 0.8)',
-  OVERLAY_LIGHT: 'rgba(0, 0, 0, 0.5)',
-  // Text colors
-  TEXT: '#ffffff',
-  TEXT_MUTED: '#cccccc',
-  // Accent color
-  ACCENT: '#3b82f6',
-  ACCENT_LIGHT: '#60a5fa',
-  // Switch colors
-  SWITCH_TRACK_OFF: '#555555',
-  SWITCH_TRACK_ON: '#3b82f6',
-  SWITCH_THUMB: '#ffffff',
-  // Score display
-  SCORE_GOLD: '#facc15'
-} as const;
-
-// Shared in-game chrome (scoreboard, control buttons, modals): frosted white. A light fill with a
-// brighter thin rim keeps panels crisp instead of milky. SOLID is the Game Over modal's Play Again.
-export const HUD = {
-  SURFACE: 'rgba(255, 255, 255, 0.3)',
-  BORDER: 'rgba(255, 255, 255, 0.6)',
-  BORDER_WIDTH: 1.5,
-  DIVIDER: 'rgba(255, 255, 255, 0.25)',
-  TEXT: '#ffffff',
-  TEXT_MUTED: 'rgba(255, 255, 255, 0.85)',
-  TEXT_SHADOW: 'rgba(0, 0, 0, 0.35)',
-  SOLID: '#ffffff',
-  ON_SOLID: '#3a3a5e'
-} as const;
-
-// Game Names
-export const GAME_NAMES = {
-  BALLOON_BLASTER: 'balloonBlaster',
-  FRUIT_SLICER: 'fruitSlicer',
-  MAZE_RUNNER: 'mazeRunner',
-  CAT_POPPER: 'catPopper',
-  SPACE_TRAVELLER: 'spaceTraveller'
-} as const;
-
-export type GameName = (typeof GAME_NAMES)[keyof typeof GAME_NAMES];
-
-// Game titles mapping - avoids circular dependency with GamesService
-export const getGameTitle = (gameId: string): string => {
-  switch (gameId) {
-    case GAME_IDS.PLAY_WITH_TUA:
-      return 'Play With Tua';
-    case GAME_IDS.TREASURE_HUNT:
-      return 'Treasure Hunt';
-    case GAME_IDS.BALLOON_BLASTER:
-      return 'Balloon Blaster';
-    case GAME_IDS.FRUIT_NINJA:
-      return 'Fruit Ninja';
-    case GAME_IDS.MAZE_RUNNER:
-      return 'Maze Runner';
-    case GAME_IDS.WHACK_A_MOLE:
-      return 'Whack-a-Mole';
-    case GAME_IDS.SPACE_FIGHTER:
-      return 'Space Fighter';
-    case GAME_IDS.POPIT_FIDGET:
-      return 'Pop It Fidget';
-    case GAME_IDS.SLIDING_NUMBERS:
-      return 'Sliding Numbers';
-    case GAME_IDS.GAME_2048:
-      return '2048';
-    case GAME_IDS.DINO_JUMP:
-      return 'Dino Jump';
-    case GAME_IDS.COLORS_SORT:
-      return 'Colors Sort';
-    case GAME_IDS.FRUIT_MERGER:
-      return 'Fruit Merger';
-    case GAME_IDS.FLAPPY_BIRD:
-      return 'Flappy Bird';
-    case GAME_IDS.CANDY_CRUSH:
-      return 'Candy Crush';
-    case GAME_IDS.SNAKE_3D:
-      return 'Snake 3D';
-    case GAME_IDS.CAR_RACING:
-      return 'Car Racing';
-    case GAME_IDS.BIKE_RACING:
-      return 'Bike Racing';
-    case GAME_IDS.BLOCK_BLAST:
-      return 'Block Blast';
-    case GAME_IDS.BUBBLE_SHOOTER:
-      return 'Bubble Shooter';
-    case GAME_IDS.PERFECT_CIRCLE:
-      return 'Perfect Circle';
-    case GAME_IDS.TIC_TAC_TOE:
-      return 'Tic Tac Toe';
-    case GAME_IDS.SPIDER_SOLITAIRE:
-      return 'Spider Solitaire';
-    case GAME_IDS.PAC_MAN:
-      return 'Pac-Man';
-    case GAME_IDS.TILE_HOME:
-      return 'Tile Home';
-    case GAME_IDS.WORD_SEARCH:
-      return 'Word Search';
-    case GAME_IDS.CONNECT_EM_ALL:
-      return 'Connect Em All';
-    case GAME_IDS.NUTS_AND_BOLTS:
-      return 'Nuts and Bolts';
-    case GAME_IDS.NUMBER_SEARCH:
-      return 'Number Search';
-    case GAME_IDS.DOTS_AND_BOXES:
-      return 'Dots and Boxes';
-    case GAME_IDS.LUDO_KING:
-      return 'Ludo King';
-    case GAME_IDS.TANK_1990:
-      return 'Tank 1990';
-    case GAME_IDS.BLOCK_BREAKER:
-      return 'Block Breaker';
-    case GAME_IDS.STACK_TOWER:
-      return 'Stack Tower';
-    case GAME_IDS.MINE_SWEEPER:
-      return 'Mine Sweeper';
-    case GAME_IDS.SUDOKU:
-      return 'Sudoku';
-    case GAME_IDS.KNIFE_HIT:
-      return 'Knife Hit';
-    case GAME_IDS.COLOR_SWITCH:
-      return 'Color Switch';
-    case GAME_IDS.PIPE_CONNECT:
-      return 'Pipe Connect';
-    case GAME_IDS.ARROWS:
-      return 'Arrows';
-    case GAME_IDS.FIND_DIFFERENT_NUMBER:
-      return 'Find Different Number';
-    case GAME_IDS.SNAKES_AND_LADDERS:
-      return 'Snakes and Ladders';
-    case GAME_IDS.BLUK:
-      return 'Bluk';
-    case GAME_IDS.CHAMELEON_RUN:
-      return 'Chameleon Run';
-    case GAME_IDS.MOB_CONTROL:
-      return 'Mob Control';
-    case GAME_IDS.PAPER_IO:
-      return 'Paper IO';
-    case GAME_IDS.CROSSY_ROAD:
-      return 'Crossy Road';
-    case GAME_IDS.TANGRAM:
-      return 'Tangram';
-    case GAME_IDS.CHECKERS:
-      return 'Checkers';
-    case GAME_IDS.MEMORY_MATCH:
-      return 'Memory Match';
-    case GAME_IDS.FALLING_STICKS:
-      return 'Falling Sticks';
-    case GAME_IDS.REVERSI:
-      return 'Reversi';
-    case GAME_IDS.PENGUIN_RUN:
-      return 'Penguin Run';
-    default:
-      return 'Game Settings';
-  }
-};
-
-// --- Color helpers for 3D faces ---
-export const hexToRgb = (hex: string): [number, number, number] => {
-  const h = hex.replace('#', '');
-  return [parseInt(h.substring(0, 2), 16), parseInt(h.substring(2, 4), 16), parseInt(h.substring(4, 6), 16)];
-};
-
-export const rgbToHex = (r: number, g: number, b: number) =>
-  '#' +
-  [r, g, b]
-    .map((v) =>
-      Math.max(0, Math.min(255, Math.round(v)))
-        .toString(16)
-        .padStart(2, '0')
-    )
-    .join('');
-
-export const lighten = (hex: string, amount: number) => {
-  const [r, g, b] = hexToRgb(hex);
-  return rgbToHex(r + (255 - r) * amount, g + (255 - g) * amount, b + (255 - b) * amount);
-};
-
-export const darken = (hex: string, amount: number) => {
-  const [r, g, b] = hexToRgb(hex);
-  return rgbToHex(r * (1 - amount), g * (1 - amount), b * (1 - amount));
-};