react-native-games 0.4.0 → 0.5.0

package/lib/module/services/GamesConstants.js.map

@@ -1 +1 @@
-{"version":3,"names":["gamesList","BALLOON_BLASTER_THEME","BALLOON_BLASTER_DIFFICULTY_DESCRIPTIONS","FRUIT_NINJA_THEME","FRUIT_NINJA_DIFFICULTY_DESCRIPTIONS","MAZE_RUNNER_THEME","MAZE_RUNNER_DIFFICULTY_DESCRIPTIONS","WHACK_A_MOLE_THEME","WHACK_A_MOLE_DIFFICULTY_DESCRIPTIONS","SPACE_FIGHTER_THEME","SPACE_FIGHTER_DIFFICULTY_DESCRIPTIONS","POPIT_FIDGET_THEME","POPIT_FIDGET_DIFFICULTY_DESCRIPTIONS","GAME_THEMES","balloonBlaster","fruitNinja","mazeRunner","whackAMole","spaceFighter","popitFidget","GAME_DIFFICULTY_DESCRIPTIONS","GAME_DURATIONS","EASY","MEDIUM","HARD","DIFFICULTY_LEVELS","GAME_NAMES","BALLOON_BLASTER","FRUIT_SLICER","MAZE_RUNNER","CAT_POPPER","SPACE_TRAVELLER","getGameTheme","gameId","getGameDifficultyDescriptions","getGameTitle","game","find","g","id","title"],"sourceRoot":"../../../src","sources":["services/GamesConstants.ts"],"mappings":";;AACA,SAASA,SAAS,QAAQ,mBAAgB;AAC1C,SAASC,qBAAqB,EAAEC,uCAAuC,QAAQ,qDAAkD;AACjI,SAASC,iBAAiB,EAAEC,mCAAmC,QAAQ,6CAA0C;AACjH,SAASC,iBAAiB,EAAEC,mCAAmC,QAAQ,6CAA0C;AACjH,SAASC,kBAAkB,EAAEC,oCAAoC,QAAQ,8CAA2C;AACpH,SAASC,mBAAmB,EAAEC,qCAAqC,QAAQ,iDAA8C;AACzH,SAASC,kBAAkB,EAAEC,oCAAoC,QAAQ,+CAA4C;;AAErH;AACA,OAAO,MAAMC,WAAW,GAAG;EACzBC,cAAc,EAAEb,qBAAqB;EACrCc,UAAU,EAAEZ,iBAAiB;EAC7Ba,UAAU,EAAEX,iBAAiB;EAC7BY,UAAU,EAAEV,kBAAkB;EAC9BW,YAAY,EAAET,mBAAmB;EACjCU,WAAW,EAAER;AACf,CAAU;;AAEV;AACA,OAAO,MAAMS,4BAA4B,GAAG;EAC1CN,cAAc,EAAEZ,uCAAuC;EACvDa,UAAU,EAAEX,mCAAmC;EAC/CY,UAAU,EAAEV,mCAAmC;EAC/CW,UAAU,EAAET,oCAAoC;EAChDU,YAAY,EAAER,qCAAqC;EACnDS,WAAW,EAAEP;AACf,CAAU;;AAEV;AACA,OAAO,MAAMS,cAAc,GAAG;EAC5BC,IAAI,EAAE,EAAE;EACRC,MAAM,EAAE,GAAG;EACXC,IAAI,EAAE;AACR,CAAU;;AAEV;AACA,OAAO,MAAMC,iBAAiB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAU;AAGpE;AACA,OAAO,MAAMC,UAAU,GAAG;EACxBC,eAAe,EAAE,gBAAgB;EACjCC,YAAY,EAAE,aAAa;EAC3BC,WAAW,EAAE,YAAY;EACzBC,UAAU,EAAE,WAAW;EACvBC,eAAe,EAAE;AACnB,CAAU;AAIV;AACA,OAAO,MAAMC,YAAY,GAAIC,MAAc,IAAwB;EACjE,QAAQA,MAAM;IACZ,KAAK,iBAAiB;MACpB,OAAOpB,WAAW,CAACC,cAAc;IACnC,KAAK,aAAa;MAChB,OAAOD,WAAW,CAACE,UAAU;IAC/B,KAAK,aAAa;MAChB,OAAOF,WAAW,CAACG,UAAU;IAC/B,KAAK,cAAc;MACjB,OAAOH,WAAW,CAACI,UAAU;IAC/B,KAAK,eAAe;MAClB,OAAOJ,WAAW,CAACK,YAAY;IACjC,KAAK,cAAc;MACjB,OAAOL,WAAW,CAACM,WAAW;IAChC;MACE,OAAON,WAAW,CAACC,cAAc;IAAE;EACvC;AACF,CAAC;AAED,OAAO,MAAMoB,6BAA6B,GAAID,MAAc,IAAK;EAC/D,QAAQA,MAAM;IACZ,KAAK,iBAAiB;MACpB,OAAOb,4BAA4B,CAACN,cAAc;IACpD,KAAK,aAAa;MAChB,OAAOM,4BAA4B,CAACL,UAAU;IAChD,KAAK,aAAa;MAChB,OAAOK,4BAA4B,CAACJ,UAAU;IAChD,KAAK,cAAc;MACjB,OAAOI,4BAA4B,CAACH,UAAU;IAChD,KAAK,eAAe;MAClB,OAAOG,4BAA4B,CAACF,YAAY;IAClD,KAAK,cAAc;MACjB,OAAOE,4BAA4B,CAACD,WAAW;IACjD;MACE,OAAOC,4BAA4B,CAACN,cAAc;IAAE;EACxD;AACF,CAAC;AAED,OAAO,MAAMqB,YAAY,GAAIF,MAAc,IAAa;EACtD,MAAMG,IAAI,GAAGpC,SAAS,CAACqC,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,EAAE,KAAKN,MAAM,CAAC;EACjD,OAAOG,IAAI,GAAGA,IAAI,CAACI,KAAK,GAAG,eAAe;AAC5C,CAAC","ignoreList":[]}
+{"version":3,"names":["gamesList","GAME_IDS","BALLOON_BLASTER_THEME","BALLOON_BLASTER_DIFFICULTY_DESCRIPTIONS","FRUIT_NINJA_THEME","FRUIT_NINJA_DIFFICULTY_DESCRIPTIONS","MAZE_RUNNER_THEME","MAZE_RUNNER_DIFFICULTY_DESCRIPTIONS","WHACK_A_MOLE_THEME","WHACK_A_MOLE_DIFFICULTY_DESCRIPTIONS","SPACE_FIGHTER_THEME","SPACE_FIGHTER_DIFFICULTY_DESCRIPTIONS","POPIT_FIDGET_THEME","POPIT_FIDGET_DIFFICULTY_DESCRIPTIONS","GAME_THEMES","balloonBlaster","fruitNinja","mazeRunner","whackAMole","spaceFighter","popitFidget","GAME_DIFFICULTY_DESCRIPTIONS","DIFFICULTY_LEVELS","GAME_NAMES","BALLOON_BLASTER","FRUIT_SLICER","MAZE_RUNNER","CAT_POPPER","SPACE_TRAVELLER","getGameTheme","gameId","FRUIT_NINJA","WHACK_A_MOLE","SPACE_FIGHTER","POPIT_FIDGET","getGameDifficultyDescriptions","getGameTitle","game","find","g","id","title"],"sourceRoot":"../../../src","sources":["services/GamesConstants.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/services/GamesService.js

@@ -1,42 +1,46 @@
 "use strict";
 
 import { produce } from 'immer';
+export const DEFAULT_GAME_SETTINGS = {
+  isVisible: false,
+  difficulty: 'medium',
+  enableSounds: true,
+  enableHaptics: true
+};
+export let GAME_IDS = /*#__PURE__*/function (GAME_IDS) {
+  GAME_IDS["WHACK_A_MOLE"] = "whack-a-mole";
+  GAME_IDS["POPIT_FIDGET"] = "popit-fidget";
+  GAME_IDS["FRUIT_NINJA"] = "fruit-ninja";
+  GAME_IDS["BALLOON_BLASTER"] = "balloon-blaster";
+  GAME_IDS["SPACE_FIGHTER"] = "space-fighter";
+  GAME_IDS["MAZE_RUNNER"] = "maze-runner";
+  return GAME_IDS;
+}({});
+;
 export const gamesList = [{
-  id: 'whack-a-mole',
+  id: GAME_IDS.WHACK_A_MOLE,
   title: 'Whack A Mole',
-  description: 'Whack cute cats popping from holes - fast reflexes needed!',
-  icon: 'hammer',
-  color: '#ff6b6b'
+  description: 'Whack cute cats popping from holes - fast reflexes needed!'
 }, {
-  id: 'popit-fidget',
+  id: GAME_IDS.POPIT_FIDGET,
   title: 'Popit Fidget',
-  description: 'Pop satisfying bubbles in this relaxing fidget toy game',
-  icon: 'ellipse',
-  color: '#6c5ce7'
+  description: 'Pop satisfying bubbles in this relaxing fidget toy game'
 }, {
-  id: 'fruit-ninja',
+  id: GAME_IDS.FRUIT_NINJA,
   title: 'Fruit Ninja',
-  description: 'Slice flying fruits with finger swipes - avoid the bombs!',
-  icon: 'cut',
-  color: '#4ecdc4'
+  description: 'Slice flying fruits with finger swipes - avoid the bombs!'
 }, {
-  id: 'space-fighter',
-  title: 'Space Fighter',
-  description: 'Pilot spaceship through asteroid fields in endless space',
-  icon: 'rocket',
-  color: '#45b7d1'
-}, {
-  id: 'balloon-blaster',
+  id: GAME_IDS.BALLOON_BLASTER,
   title: 'Balloon Blaster',
-  description: 'Pop rising balloons before they escape - quick taps win!',
-  icon: 'balloon',
-  color: '#ff9ff3'
+  description: 'Pop rising balloons before they escape - quick taps win!'
+}, {
+  id: GAME_IDS.SPACE_FIGHTER,
+  title: 'Space Fighter',
+  description: 'Pilot spaceship through asteroid fields in endless space'
 }, {
-  id: 'maze-runner',
+  id: GAME_IDS.MAZE_RUNNER,
   title: 'Maze Runner',
-  description: 'Navigate ball through mazes using tilt and physics controls',
-  icon: 'trail-sign',
-  color: '#96ceb4'
+  description: 'Navigate ball through mazes using tilt and physics controls'
 }];
 export const immerMiddleware = config => (set, get, api) => config(fn => set(produce(fn)), get, api);
 //# sourceMappingURL=GamesService.js.map

package/lib/module/services/GamesService.js.map

@@ -1 +1 @@
-{"version":3,"names":["produce","gamesList","id","title","description","icon","color","immerMiddleware","config","set","get","api","fn"],"sourceRoot":"../../../src","sources":["services/GamesService.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAE/B,OAAO,MAAMC,SAAS,GAAG,CACvB;EACEC,EAAE,EAAE,cAAc;EAClBC,KAAK,EAAE,cAAc;EACrBC,WAAW,EAAE,4DAA4D;EACzEC,IAAI,EAAE,QAAQ;EACdC,KAAK,EAAE;AACT,CAAC,EACD;EACEJ,EAAE,EAAE,cAAc;EAClBC,KAAK,EAAE,cAAc;EACrBC,WAAW,EAAE,yDAAyD;EACtEC,IAAI,EAAE,SAAS;EACfC,KAAK,EAAE;AACT,CAAC,EACD;EACEJ,EAAE,EAAE,aAAa;EACjBC,KAAK,EAAE,aAAa;EACpBC,WAAW,EAAE,2DAA2D;EACxEC,IAAI,EAAE,KAAK;EACXC,KAAK,EAAE;AACT,CAAC,EACD;EACEJ,EAAE,EAAE,eAAe;EACnBC,KAAK,EAAE,eAAe;EACtBC,WAAW,EAAE,0DAA0D;EACvEC,IAAI,EAAE,QAAQ;EACdC,KAAK,EAAE;AACT,CAAC,EACD;EACEJ,EAAE,EAAE,iBAAiB;EACrBC,KAAK,EAAE,iBAAiB;EACxBC,WAAW,EAAE,0DAA0D;EACvEC,IAAI,EAAE,SAAS;EACfC,KAAK,EAAE;AACT,CAAC,EACD;EACEJ,EAAE,EAAE,aAAa;EACjBC,KAAK,EAAE,aAAa;EACpBC,WAAW,EAAE,6DAA6D;EAC1EC,IAAI,EAAE,YAAY;EAClBC,KAAK,EAAE;AACT,CAAC,CACF;AAED,OAAO,MAAMC,eAAe,GAAIC,MAAW,IAAK,CAACC,GAAQ,EAAEC,GAAQ,EAAEC,GAAQ,KAAKH,MAAM,CAAEI,EAAO,IAAKH,GAAG,CAACT,OAAO,CAACY,EAAE,CAAC,CAAC,EAAEF,GAAG,EAAEC,GAAG,CAAC","ignoreList":[]}
+{"version":3,"names":["produce","DEFAULT_GAME_SETTINGS","isVisible","difficulty","enableSounds","enableHaptics","GAME_IDS","gamesList","id","WHACK_A_MOLE","title","description","POPIT_FIDGET","FRUIT_NINJA","BALLOON_BLASTER","SPACE_FIGHTER","MAZE_RUNNER","immerMiddleware","config","set","get","api","fn"],"sourceRoot":"../../../src","sources":["services/GamesService.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAc/B,OAAO,MAAMC,qBAAmC,GAAG;EACjDC,SAAS,EAAE,KAAK;EAChBC,UAAU,EAAE,QAAQ;EACpBC,YAAY,EAAE,IAAI;EAClBC,aAAa,EAAE;AACjB,CAAC;AAED,WAAYC,QAAQ,0BAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAAA,OAARA,QAAQ;AAAA;AAOnB;AAED,OAAO,MAAMC,SAAS,GAAG,CACvB;EACEC,EAAE,EAAEF,QAAQ,CAACG,YAAY;EACzBC,KAAK,EAAE,cAAc;EACrBC,WAAW,EAAE;AACf,CAAC,EACD;EACEH,EAAE,EAAEF,QAAQ,CAACM,YAAY;EACzBF,KAAK,EAAE,cAAc;EACrBC,WAAW,EAAE;AACf,CAAC,EACD;EACEH,EAAE,EAAEF,QAAQ,CAACO,WAAW;EACxBH,KAAK,EAAE,aAAa;EACpBC,WAAW,EAAE;AACf,CAAC,EACD;EACEH,EAAE,EAAEF,QAAQ,CAACQ,eAAe;EAC5BJ,KAAK,EAAE,iBAAiB;EACxBC,WAAW,EAAE;AACf,CAAC,EACD;EACEH,EAAE,EAAEF,QAAQ,CAACS,aAAa;EAC1BL,KAAK,EAAE,eAAe;EACtBC,WAAW,EAAE;AACf,CAAC,EACD;EACEH,EAAE,EAAEF,QAAQ,CAACU,WAAW;EACxBN,KAAK,EAAE,aAAa;EACpBC,WAAW,EAAE;AACf,CAAC,CACF;AAED,OAAO,MAAMM,eAAe,GAAIC,MAAW,IAAK,CAACC,GAAQ,EAAEC,GAAQ,EAAEC,GAAQ,KAAKH,MAAM,CAAEI,EAAO,IAAKH,GAAG,CAACnB,OAAO,CAACsB,EAAE,CAAC,CAAC,EAAEF,GAAG,EAAEC,GAAG,CAAC","ignoreList":[]}

package/lib/module/services/SoundsService.js

@@ -43,43 +43,43 @@ export const GAME_SOUNDS = {
     pitch: 0.7,
     rate: 1.8
   },
-  // Game state sounds
+  // Game state sounds - slower and more understandable
   GAME_START: {
     text: 'Game started!',
-    pitch: 1.2,
-    rate: 1.8
+    pitch: 1.1,
+    rate: 0.9
   },
   GAME_OVER: {
     text: 'Game over!',
-    pitch: 1.0,
-    rate: 1.5
+    pitch: 0.9,
+    rate: 0.8
   },
   TIME_UP: {
     text: 'Time up! Game over!',
-    pitch: 1.0,
-    rate: 1.5
+    pitch: 0.9,
+    rate: 0.8
   },
   WELL_DONE: {
     text: 'Well done!',
-    pitch: 1.3,
-    rate: 1.6
+    pitch: 1.2,
+    rate: 1.0
   },
   CONGRATULATIONS: {
     text: 'Congratulations!',
-    pitch: 1.2,
-    rate: 1.6
+    pitch: 1.1,
+    rate: 0.9
   },
   // Specific game sounds
   BUBBLE_POPPER: {
     START: {
       text: 'Bubble Popper started!',
-      pitch: 1.2,
-      rate: 1.8
+      pitch: 1.1,
+      rate: 0.9
     },
     COMPLETE: {
       text: 'All bubbles popped! Well done!',
-      pitch: 1.3,
-      rate: 1.6
+      pitch: 1.2,
+      rate: 1.0
     },
     POP: {
       text: 'Pop!',
@@ -137,24 +137,24 @@ export const GAME_SOUNDS = {
     START: {
       text: 'Maze started! Navigate to the exit!',
       pitch: 1.0,
-      rate: 1.8
+      rate: 0.9
     },
     COMPLETE: {
       text: 'Congratulations! Maze completed!',
-      pitch: 1.2,
-      rate: 1.6
+      pitch: 1.1,
+      rate: 0.9
     },
     STOP: {
       text: 'Maze stopped!',
-      pitch: 1.0,
-      rate: 1.5
+      pitch: 0.9,
+      rate: 0.8
     }
   },
   SPACE_FIGHTER: {
     START: {
       text: 'Mission started! Navigate through the asteroid field!',
       pitch: 1.0,
-      rate: 1.8
+      rate: 0.9
     },
     SUCCESS: {
       text: 'Nice!',

package/lib/module/shared/helpers/AnimationFrame.js

@@ -0,0 +1,120 @@
+"use strict";
+
+import { useEffect, useRef } from 'react';
+
+/**
+ * Optimized animation frame utility for smooth game object cleanup and updates
+ * Uses requestAnimationFrame instead of setInterval for better performance
+ */
+export class AnimationFrameManager {
+  animationId = null;
+  isRunning = false;
+  lastTime = 0;
+  constructor(callback, interval = 100) {
+    this.callback = callback;
+    this.interval = interval;
+  }
+
+  /**
+   * Start the animation frame loop
+   */
+  start() {
+    if (this.isRunning) return;
+    this.isRunning = true;
+    this.lastTime = performance.now();
+    this.loop();
+  }
+
+  /**
+   * Stop the animation frame loop
+   */
+  stop() {
+    if (this.animationId) {
+      cancelAnimationFrame(this.animationId);
+      this.animationId = null;
+    }
+    this.isRunning = false;
+  }
+
+  /**
+   * Internal animation frame loop
+   */
+  loop = () => {
+    if (!this.isRunning) return;
+    const currentTime = performance.now();
+    const deltaTime = currentTime - this.lastTime;
+    if (deltaTime >= this.interval) {
+      this.callback();
+      this.lastTime = currentTime;
+    }
+    this.animationId = requestAnimationFrame(this.loop);
+  };
+
+  /**
+   * Update the callback function
+   */
+  updateCallback(callback) {
+    this.callback = callback;
+  }
+
+  /**
+   * Update the interval
+   */
+  updateInterval(interval) {
+    this.interval = interval;
+  }
+}
+
+/**
+ * React hook for using optimized animation frame cleanup
+ */
+export function useAnimationFrame(callback, interval = 100, dependencies = []) {
+  const managerRef = useRef(null);
+  useEffect(() => {
+    // Create or update the manager
+    if (!managerRef.current) {
+      managerRef.current = new AnimationFrameManager(callback, interval);
+    } else {
+      managerRef.current.updateCallback(callback);
+      managerRef.current.updateInterval(interval);
+    }
+
+    // Start the animation frame loop
+    managerRef.current.start();
+
+    // Cleanup on unmount or dependency change
+    return () => {
+      if (managerRef.current) {
+        managerRef.current.stop();
+      }
+    };
+  }, dependencies);
+
+  // Cleanup on unmount
+  useEffect(() => {
+    return () => {
+      if (managerRef.current) {
+        managerRef.current.stop();
+      }
+    };
+  }, []);
+}
+
+/**
+ * React hook for creating a reusable animation frame manager
+ */
+export function useAnimationFrameManager(interval = 100) {
+  const managerRef = useRef(null);
+  if (!managerRef.current) {
+    managerRef.current = new AnimationFrameManager(() => {}, interval);
+  }
+  useEffect(() => {
+    return () => {
+      if (managerRef.current) {
+        managerRef.current.stop();
+      }
+    };
+  }, []);
+  return managerRef.current;
+}
+//# sourceMappingURL=AnimationFrame.js.map

package/lib/module/shared/helpers/AnimationFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","AnimationFrameManager","animationId","isRunning","lastTime","constructor","callback","interval","start","performance","now","loop","stop","cancelAnimationFrame","currentTime","deltaTime","requestAnimationFrame","updateCallback","updateInterval","useAnimationFrame","dependencies","managerRef","current","useAnimationFrameManager"],"sourceRoot":"../../../../src","sources":["shared/helpers/AnimationFrame.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/shared/helpers/AnimationTracker.js

@@ -0,0 +1,89 @@
+"use strict";
+
+import { useRef } from 'react';
+
+/**
+ * Animation state interface for tracking game object animations
+ */
+
+/**
+ * Default animation state values
+ */
+export const DEFAULT_ANIMATION_STATE = {
+  scale: 1,
+  opacity: 1,
+  rotation: 0,
+  translateX: 0,
+  translateY: 0
+};
+
+/**
+ * Animation tracker class for managing game object animations
+ * Extends Map to maintain compatibility with existing game services
+ */
+export class AnimationTracker extends Map {
+  constructor() {
+    super();
+  }
+
+  /**
+   * Override set to merge with default animation state
+   */
+  set(id, state) {
+    const currentState = super.get(id) || {
+      ...DEFAULT_ANIMATION_STATE
+    };
+    const newState = {
+      ...currentState,
+      ...state
+    };
+    super.set(id, newState);
+    return this;
+  }
+
+  /**
+   * Initialize animation for object if it doesn't exist
+   */
+  initialize(id, initialState) {
+    if (!this.has(id)) {
+      const state = {
+        ...DEFAULT_ANIMATION_STATE,
+        ...initialState
+      };
+      super.set(id, state);
+      return state;
+    }
+    return this.get(id);
+  }
+
+  /**
+   * Update multiple objects at once
+   */
+  updateBatch(updates) {
+    updates.forEach(({
+      id,
+      state
+    }) => {
+      this.set(id, state);
+    });
+  }
+}
+
+/**
+ * React hook for creating and managing animation trackers
+ */
+export function useAnimationTracker() {
+  return useRef(new AnimationTracker()).current;
+}
+
+/**
+ * React hook for creating multiple animation trackers
+ */
+export function useAnimationTrackers(trackerNames) {
+  const trackers = useRef(trackerNames.reduce((acc, name) => {
+    acc[name] = new AnimationTracker();
+    return acc;
+  }, {})).current;
+  return trackers;
+}
+//# sourceMappingURL=AnimationTracker.js.map

package/lib/module/shared/helpers/AnimationTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useRef","DEFAULT_ANIMATION_STATE","scale","opacity","rotation","translateX","translateY","AnimationTracker","Map","constructor","set","id","state","currentState","get","newState","initialize","initialState","has","updateBatch","updates","forEach","useAnimationTracker","current","useAnimationTrackers","trackerNames","trackers","reduce","acc","name"],"sourceRoot":"../../../../src","sources":["shared/helpers/AnimationTracker.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,OAAO;;AAE9B;AACA;AACA;;AASA;AACA;AACA;AACA,OAAO,MAAMC,uBAAuC,GAAG;EACrDC,KAAK,EAAE,CAAC;EACRC,OAAO,EAAE,CAAC;EACVC,QAAQ,EAAE,CAAC;EACXC,UAAU,EAAE,CAAC;EACbC,UAAU,EAAE;AACd,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,SAASC,GAAG,CAAyB;EAChEC,WAAWA,CAAA,EAAG;IACZ,KAAK,CAAC,CAAC;EACT;;EAEA;AACF;AACA;EACEC,GAAGA,CAACC,EAAU,EAAEC,KAA8B,EAAQ;IACpD,MAAMC,YAAY,GAAG,KAAK,CAACC,GAAG,CAACH,EAAE,CAAC,IAAI;MAAE,GAAGV;IAAwB,CAAC;IACpE,MAAMc,QAAQ,GAAG;MAAE,GAAGF,YAAY;MAAE,GAAGD;IAAM,CAAC;IAC9C,KAAK,CAACF,GAAG,CAACC,EAAE,EAAEI,QAAQ,CAAC;IACvB,OAAO,IAAI;EACb;;EAEA;AACF;AACA;EACEC,UAAUA,CAACL,EAAU,EAAEM,YAAsC,EAAkB;IAC7E,IAAI,CAAC,IAAI,CAACC,GAAG,CAACP,EAAE,CAAC,EAAE;MACjB,MAAMC,KAAK,GAAG;QAAE,GAAGX,uBAAuB;QAAE,GAAGgB;MAAa,CAAC;MAC7D,KAAK,CAACP,GAAG,CAACC,EAAE,EAAEC,KAAK,CAAC;MACpB,OAAOA,KAAK;IACd;IACA,OAAO,IAAI,CAACE,GAAG,CAACH,EAAE,CAAC;EACrB;;EAEA;AACF;AACA;EACEQ,WAAWA,CAACC,OAA8D,EAAQ;IAChFA,OAAO,CAACC,OAAO,CAAC,CAAC;MAAEV,EAAE;MAAEC;IAAM,CAAC,KAAK;MACjC,IAAI,CAACF,GAAG,CAACC,EAAE,EAAEC,KAAK,CAAC;IACrB,CAAC,CAAC;EACJ;AACF;;AAEA;AACA;AACA;AACA,OAAO,SAASU,mBAAmBA,CAAA,EAAqB;EACtD,OAAOtB,MAAM,CAAC,IAAIO,gBAAgB,CAAC,CAAC,CAAC,CAACgB,OAAO;AAC/C;;AAEA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAClCC,YAAyB,EACU;EACnC,MAAMC,QAAQ,GAAG1B,MAAM,CACrByB,YAAY,CAACE,MAAM,CAAC,CAACC,GAAG,EAAEC,IAAI,KAAK;IACjCD,GAAG,CAACC,IAAI,CAAC,GAAG,IAAItB,gBAAgB,CAAC,CAAC;IAClC,OAAOqB,GAAG;EACZ,CAAC,EAAE,CAAC,CAAsC,CAC5C,CAAC,CAACL,OAAO;EAET,OAAOG,QAAQ;AACjB","ignoreList":[]}

package/lib/module/shared/helpers/ErrorHandler.js

@@ -0,0 +1,269 @@
+"use strict";
+
+import { useCallback, useRef } from 'react';
+
+/**
+ * Error types for game-specific error handling
+ */
+export let GameErrorType = /*#__PURE__*/function (GameErrorType) {
+  GameErrorType["INITIALIZATION_ERROR"] = "INITIALIZATION_ERROR";
+  GameErrorType["ANIMATION_ERROR"] = "ANIMATION_ERROR";
+  GameErrorType["STORAGE_ERROR"] = "STORAGE_ERROR";
+  GameErrorType["SOUND_ERROR"] = "SOUND_ERROR";
+  GameErrorType["HAPTIC_ERROR"] = "HAPTIC_ERROR";
+  GameErrorType["GESTURE_ERROR"] = "GESTURE_ERROR";
+  GameErrorType["PERFORMANCE_ERROR"] = "PERFORMANCE_ERROR";
+  GameErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+  GameErrorType["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+  return GameErrorType;
+}({});
+
+/**
+ * Game error interface
+ */
+
+/**
+ * Error handler configuration
+ */
+
+/**
+ * Default error handler configuration
+ */
+export const DEFAULT_ERROR_CONFIG = {
+  enableLogging: __DEV__,
+  enableConsoleOutput: __DEV__,
+  maxErrorHistory: 50,
+  enableCrashRecovery: true
+};
+
+/**
+ * Game error handler class
+ */
+export class GameErrorHandler {
+  errorHistory = [];
+  errorCounts = new Map();
+  constructor(config = {}) {
+    this.config = {
+      ...DEFAULT_ERROR_CONFIG,
+      ...config
+    };
+  }
+
+  /**
+   * Handle a game error
+   */
+  handleError(type, message, gameId, context) {
+    const error = {
+      type,
+      message,
+      gameId,
+      timestamp: Date.now(),
+      stack: new Error().stack,
+      context
+    };
+
+    // Add to error history
+    this.errorHistory.push(error);
+    if (this.errorHistory.length > this.config.maxErrorHistory) {
+      this.errorHistory.shift();
+    }
+
+    // Update error counts
+    const currentCount = this.errorCounts.get(type) || 0;
+    this.errorCounts.set(type, currentCount + 1);
+
+    // Log error if enabled
+    if (this.config.enableLogging && this.config.enableConsoleOutput) {
+      this.logError(error);
+    }
+
+    // Call custom error handler if provided
+    if (this.config.onError) {
+      try {
+        this.config.onError(error);
+      } catch (handlerError) {
+        console.error('Error in custom error handler:', handlerError);
+      }
+    }
+  }
+
+  /**
+   * Wrap a function with error handling
+   */
+  wrapFunction(fn, errorType, gameId) {
+    return (...args) => {
+      try {
+        const result = fn(...args);
+
+        // Handle async functions
+        if (result && typeof result.catch === 'function') {
+          return result.catch(error => {
+            this.handleError(errorType, error.message || 'Async function error', gameId, {
+              functionName: fn.name,
+              args
+            });
+            throw error;
+          });
+        }
+        return result;
+      } catch (error) {
+        this.handleError(errorType, error instanceof Error ? error.message : 'Unknown error', gameId, {
+          functionName: fn.name,
+          args
+        });
+        throw error;
+      }
+    };
+  }
+
+  /**
+   * Safe execution with error recovery
+   */
+  safeExecute(fn, fallback, errorType, gameId) {
+    try {
+      return fn();
+    } catch (error) {
+      this.handleError(errorType, error instanceof Error ? error.message : 'Safe execution failed', gameId, {
+        fallback
+      });
+      return fallback;
+    }
+  }
+
+  /**
+   * Safe async execution with error recovery
+   */
+  async safeExecuteAsync(fn, fallback, errorType, gameId) {
+    try {
+      return await fn();
+    } catch (error) {
+      this.handleError(errorType, error instanceof Error ? error.message : 'Safe async execution failed', gameId, {
+        fallback
+      });
+      return fallback;
+    }
+  }
+
+  /**
+   * Get error statistics
+   */
+  getErrorStats() {
+    const errorsByType = {};
+    for (const [type, count] of this.errorCounts.entries()) {
+      errorsByType[type] = count;
+    }
+    return {
+      totalErrors: this.errorHistory.length,
+      errorsByType,
+      recentErrors: this.errorHistory.slice(-10)
+    };
+  }
+
+  /**
+   * Clear error history
+   */
+  clearHistory() {
+    this.errorHistory = [];
+    this.errorCounts.clear();
+  }
+
+  /**
+   * Update configuration
+   */
+  updateConfig(config) {
+    this.config = {
+      ...this.config,
+      ...config
+    };
+  }
+
+  /**
+   * Log error to console
+   */
+  logError(error) {
+    const prefix = error.gameId ? `[${error.gameId}]` : '[Game]';
+    console.error(`${prefix} ${error.type}: ${error.message}`, {
+      timestamp: new Date(error.timestamp).toISOString(),
+      context: error.context,
+      stack: error.stack
+    });
+  }
+}
+
+/**
+ * Global error handler instance
+ */
+export const globalErrorHandler = new GameErrorHandler();
+
+/**
+ * React hook for error handling in game components
+ */
+export function useGameErrorHandler(gameId, config = {}) {
+  const handlerRef = useRef(null);
+
+  // Initialize handler
+  if (!handlerRef.current) {
+    handlerRef.current = new GameErrorHandler(config);
+  }
+  const handleError = useCallback((type, message, context) => {
+    handlerRef.current?.handleError(type, message, gameId, context);
+  }, [gameId]);
+  const wrapFunction = useCallback((fn, errorType) => {
+    return handlerRef.current?.wrapFunction(fn, errorType, gameId) || fn;
+  }, [gameId]);
+  const safeExecute = useCallback((fn, fallback, errorType) => {
+    return handlerRef.current?.safeExecute(fn, fallback, errorType, gameId) || fallback;
+  }, [gameId]);
+  const safeExecuteAsync = useCallback((fn, fallback, errorType) => {
+    return handlerRef.current?.safeExecuteAsync(fn, fallback, errorType, gameId) || Promise.resolve(fallback);
+  }, [gameId]);
+  return {
+    handleError,
+    wrapFunction,
+    safeExecute,
+    safeExecuteAsync,
+    errorStats: handlerRef.current?.getErrorStats() || {
+      totalErrors: 0,
+      errorsByType: {},
+      recentErrors: []
+    }
+  };
+}
+
+/**
+ * Error boundary utility for wrapping functions with error handling
+ */
+export function withErrorHandling(fn, gameId, errorType = GameErrorType.UNKNOWN_ERROR) {
+  return globalErrorHandler.wrapFunction(fn, errorType, gameId);
+}
+
+/**
+ * Utility functions for common error scenarios
+ */
+export const ErrorUtils = {
+  /**
+   * Handle animation errors safely
+   */
+  safeAnimate: (animationFn, gameId, fallback) => {
+    globalErrorHandler.safeExecute(animationFn, fallback ? fallback() : undefined, GameErrorType.ANIMATION_ERROR, gameId);
+  },
+  /**
+   * Handle sound errors safely
+   */
+  safePlaySound: (soundFn, gameId) => {
+    globalErrorHandler.safeExecute(soundFn, undefined, GameErrorType.SOUND_ERROR, gameId);
+  },
+  /**
+   * Handle haptic errors safely
+   */
+  safeHaptic: (hapticFn, gameId) => {
+    globalErrorHandler.safeExecute(hapticFn, undefined, GameErrorType.HAPTIC_ERROR, gameId);
+  },
+  /**
+   * Handle gesture errors safely
+   */
+  safeGesture: (gestureFn, gameId) => {
+    globalErrorHandler.safeExecute(gestureFn, undefined, GameErrorType.GESTURE_ERROR, gameId);
+  }
+};
+//# sourceMappingURL=ErrorHandler.js.map