feat: add timeLimit option and time-based game-over logic

- Add timeLimit to GameOptions (default 600 seconds)
- Game-over triggers when time limit exceeded
- Remove all efficiency-based game-over logic
- Pass timeLimit through to useScore
- Check time limit during started and has-key states

src/types.ts

@@ -11,6 +11,7 @@ export * from './useScore/types';
 export type GameOptions = {
   rows: number;
   cols: number;
+  timeLimit?: number;
 };
 
 export type KeyLogEntry = { key: string; timestamp: number };

src/useGame.ts

@@ -6,7 +6,7 @@ import { useHeroRender } from './useCursor';
 import { useScore } from './useScore';
 
 export function useGame(options: GameOptions, platformHook?: unknown): GameManager {
-  const { cols, rows } = options;
+  const { cols, rows, timeLimit = 600 } = options;
   const board = useBoard(cols, rows);
   const { containerRef, renderBoard } = board;
   const gameStatusManager = useGameStatus();
@@ -14,7 +14,7 @@ export function useGame(options: GameOptions, platformHook?: unknown): GameManag
   
   const hero = cursor.hero;
   const renderer = useHeroRender({ gameStatus: gameStatusManager.gameStatus, board, hero });
-  const scoreManager = useScore({ board, hero, gameStatusManager, keyManager, rows, cols });
+  const scoreManager = useScore({ board, hero, gameStatusManager, keyManager, rows, cols, timeLimit });
 
   const gameManager: GameManager = {
     containerRef,

src/useScore/useScore.ts

@@ -13,11 +13,12 @@ type UseScoreParams = {
   keyManager?: { keyLog: any[] };
   rows: number;
   cols: number;
+  timeLimit: number;
 };
 
-export function useScore({ board, hero, gameStatusManager, keyManager, rows, cols }: UseScoreParams) {
+export function useScore({ board, hero, gameStatusManager, keyManager, rows, cols, timeLimit }: UseScoreParams) {
   const timer = useTimer();
-  const { gameStatus } = gameStatusManager;
+  const { gameStatus, setGameStatus } = gameStatusManager;
   const { timeValue, startTimer, stopTimer, resetTimer } = timer;
 
   const {
@@ -35,6 +36,16 @@ export function useScore({ board, hero, gameStatusManager, keyManager, rows, col
 
   useScoreTime({ gameStatus, timer });
 
+  useEffect(() => {
+    if (gameStatus !== "started" && gameStatus !== "has-key") return;
+
+    const timeLimitMs = timeLimit * 1000;
+    if (timeValue >= timeLimitMs) {
+      setGameStatus("game-over");
+      return;
+    }
+  }, [gameStatus, timeValue, timeLimit, setGameStatus]);
+
   useEffect(() => {
     if (gameStatus !== "game-won") return;