brainrot-cli 0.1.0

package/README.md

@@ -0,0 +1,372 @@
+# BrainRot CLI
+
+```
+ ____            _       ____        _      ____ _     ___
+| __ ) _ __ __ _(_)_ __ |  _ \ ___ | |_   / ___| |   |_ _|
+|  _ \| '__/ _` | | '_ \| |_) / _ \| __| | |   | |    | |
+| |_) | | | (_| | | | | |  _ < (_) | |_  | |___| |___ | |
+|____/|_|  \__,_|_|_| |_|_| \_\___/ \__|  \____|_____|___|
+```
+
+> Play games while Claude Code works
+
+[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](package.json)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](package.json)
+
+A terminal-native CLI application that wraps Claude Code with built-in games to play while AI agents work. Built with TypeScript, React 19, and Ink 6.
+
+## Features
+
+- **4 Built-in Games**: Snake, Pong, Tetris, and Minesweeper
+- **Split-Pane Interface**: Play games while monitoring Claude Code output
+- **4 Color Themes**: Default, Dark, Light, and Retro
+- **Auto-Pause**: Games pause automatically when Claude Code needs your attention
+- **Persistent High Scores**: Compete against yourself with local leaderboards
+- **Full Keyboard Navigation**: No mouse needed
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18.0.0 or higher
+- [Claude Code](https://claude.ai/code) installed and available in PATH
+
+### Install Globally
+
+```bash
+npm install -g brainrot-cli
+```
+
+### Or Run from Source
+
+```bash
+git clone https://github.com/brainrot-cli/brainrot.git
+cd brainrot
+npm install
+npm run build
+npm start
+```
+
+## Quick Start
+
+```bash
+# Start with defaults
+brainrot
+
+# Start with vertical layout
+brainrot --layout-direction vertical
+
+# Start with dark theme
+brainrot --color-scheme dark
+
+# Start directly in Snake
+brainrot --default-game snake
+```
+
+## Keyboard Shortcuts
+
+### Global Controls
+
+| Key | Action |
+|-----|--------|
+| `Tab` | Switch focus between game and management panes |
+| `?` | Toggle help overlay |
+| `Ctrl+S` | Open settings menu |
+| `Ctrl+C` | Exit application |
+| `[` / `]` | Resize panes (when focused) |
+
+### In-Game Controls
+
+| Key | Action |
+|-----|--------|
+| `P` | Pause / Resume game |
+| `R` | Restart game |
+| `Q` or `Esc` | Return to game menu |
+| `H` | View high scores (where available) |
+
+## Games
+
+### Snake
+
+Classic snake game - eat food to grow, avoid walls and yourself!
+
+| Key | Action |
+|-----|--------|
+| `Arrow Keys` or `WASD` | Move snake |
+| `P` | Pause |
+| `R` | Restart |
+| `H` | High scores |
+
+### Pong
+
+Single-player pong against AI - first to 5 wins!
+
+| Key | Action |
+|-----|--------|
+| `Up/Down` or `W/S` | Move paddle |
+| `P` | Pause |
+| `R` | Restart |
+
+### Tetris
+
+Classic Tetris - clear lines with falling blocks!
+
+| Key | Action |
+|-----|--------|
+| `Left/Right` | Move piece |
+| `Up` or `W` | Rotate piece |
+| `Down` | Soft drop |
+| `Space` | Hard drop |
+| `P` | Pause |
+| `R` | Restart |
+
+### Minesweeper
+
+Find all mines without triggering them!
+
+| Key | Action |
+|-----|--------|
+| `Arrow Keys` | Move cursor |
+| `Space` or `Enter` | Reveal cell |
+| `F` | Flag/unflag cell |
+| `P` | Pause |
+| `R` | Restart |
+
+## Configuration
+
+BrainRot CLI uses XDG Base Directory conventions for configuration storage.
+
+### File Locations
+
+| Type | Location |
+|------|----------|
+| Config | `~/.config/brainrot-cli/config.json` |
+| High Scores | `~/.local/share/brainrot-cli/high-scores.json` |
+| Stats | `~/.local/share/brainrot-cli/stats.json` |
+
+### Example Configuration
+
+```json
+{
+  "version": 1,
+  "games": {
+    "defaultDifficulty": "medium",
+    "snake": {
+      "initialSpeed": 5,
+      "growthRate": 1
+    },
+    "tetris": {
+      "startingLevel": 1,
+      "showGhostPiece": true
+    },
+    "minesweeper": {
+      "defaultDifficulty": "easy",
+      "showTimer": true
+    },
+    "pong": {
+      "aiDifficulty": 5,
+      "ballSpeedMultiplier": 1.0
+    }
+  },
+  "layout": {
+    "direction": "horizontal",
+    "splitRatio": 0.5,
+    "minRatio": 0.25,
+    "maxRatio": 0.75,
+    "resizeStep": 0.05,
+    "showSecondary": true,
+    "defaultFocusedPane": 0
+  },
+  "theme": {
+    "colorScheme": "default",
+    "borderStyle": "round",
+    "spinnerStyle": "spinner",
+    "enableAnimations": true,
+    "colors": {
+      "primary": "cyan",
+      "secondary": "magenta",
+      "accent": "yellow"
+    }
+  },
+  "claudeCode": {
+    "executablePath": "claude",
+    "workingDirectory": null,
+    "defaultArgs": [],
+    "shutdownTimeout": 5000
+  },
+  "app": {
+    "maxScoresPerGame": 10,
+    "defaultGame": null,
+    "debugMode": false,
+    "logLevel": "info"
+  }
+}
+```
+
+### Configuration Options
+
+#### Games
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `defaultDifficulty` | `easy` \| `medium` \| `hard` | `medium` | Default difficulty for games |
+| `snake.initialSpeed` | `1-10` | `5` | Snake movement speed |
+| `snake.growthRate` | `number` | `1` | Segments added per food |
+| `tetris.startingLevel` | `1-10` | `1` | Starting level |
+| `tetris.showGhostPiece` | `boolean` | `true` | Show piece preview |
+| `minesweeper.defaultDifficulty` | `easy` \| `medium` \| `hard` | `easy` | Board size/mines |
+| `minesweeper.showTimer` | `boolean` | `true` | Display timer |
+| `pong.aiDifficulty` | `1-10` | `5` | AI opponent skill |
+| `pong.ballSpeedMultiplier` | `0.5-2.0` | `1.0` | Ball speed modifier |
+
+#### Layout
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `direction` | `horizontal` \| `vertical` | `horizontal` | Split direction |
+| `splitRatio` | `0.0-1.0` | `0.5` | Initial split ratio |
+| `minRatio` | `0.0-1.0` | `0.25` | Minimum pane size |
+| `maxRatio` | `0.0-1.0` | `0.75` | Maximum pane size |
+| `resizeStep` | `number` | `0.05` | Keyboard resize increment |
+| `showSecondary` | `boolean` | `true` | Show management pane |
+| `defaultFocusedPane` | `0` \| `1` | `0` | Initial focus (0=game) |
+
+#### Theme
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `colorScheme` | `default` \| `dark` \| `light` \| `retro` | `default` | Color theme |
+| `borderStyle` | `single` \| `round` \| `double` \| `heavy` | `round` | Border characters |
+| `spinnerStyle` | `spinner` \| `dots` \| `braille` | `spinner` | Loading animation |
+| `enableAnimations` | `boolean` | `true` | Enable animations |
+| `colors.*` | `string` | varies | Custom color overrides |
+
+#### Claude Code
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `executablePath` | `string` | `claude` | Path to Claude Code |
+| `workingDirectory` | `string` | `null` | Default working directory |
+| `defaultArgs` | `string[]` | `[]` | CLI arguments to pass |
+| `shutdownTimeout` | `number` | `5000` | Graceful shutdown timeout (ms) |
+
+#### App
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `maxScoresPerGame` | `number` | `10` | Leaderboard entries to keep |
+| `defaultGame` | `string` | `null` | Auto-select game on start |
+| `debugMode` | `boolean` | `false` | Enable debug output |
+| `logLevel` | `error` \| `warn` \| `info` \| `debug` | `info` | Log verbosity |
+
+## Themes
+
+BrainRot CLI includes four color themes:
+
+| Theme | Description |
+|-------|-------------|
+| `default` | Modern terminal - cyan/magenta/yellow |
+| `dark` | Muted colors for extended sessions |
+| `light` | High contrast for light backgrounds |
+| `retro` | Classic green phosphor terminal |
+
+Switch themes via settings menu (`Ctrl+S`) or CLI flag:
+
+```bash
+brainrot --color-scheme retro
+```
+
+## CLI Flags
+
+```
+USAGE:
+  brainrot [OPTIONS]
+
+OPTIONS:
+  -h, --help                 Show help message and exit
+  -v, --version              Show version and exit
+  -c, --config <path>        Use custom config file path
+
+LAYOUT OPTIONS:
+  --layout-direction <dir>   Split direction: horizontal, vertical
+  --split-ratio <ratio>      Split ratio (0.0-1.0)
+
+THEME OPTIONS:
+  --color-scheme <scheme>    Color scheme: default, dark, light, retro
+  --border-style <style>     Border style: single, round, double, heavy
+
+CLAUDE CODE OPTIONS:
+  --claude-executable <path> Path to Claude Code executable
+  --claude-args <args>       Arguments to pass (comma-separated)
+  -w, --working-dir <path>   Working directory for Claude Code
+
+APP OPTIONS:
+  -d, --debug                Enable debug mode
+  --log-level <level>        Log level: error, warn, info, debug
+  -g, --default-game <id>    Default game: snake, tetris, pong, minesweeper
+```
+
+### Examples
+
+```bash
+# Start with vertical layout and 70% game pane
+brainrot --layout-direction vertical --split-ratio 0.7
+
+# Use retro theme with heavy borders
+brainrot --color-scheme retro --border-style heavy
+
+# Debug mode with verbose logging
+brainrot --debug --log-level debug
+
+# Custom config file
+brainrot -c ~/.my-brainrot-config.json
+
+# Pass arguments to Claude Code
+brainrot --claude-args "--model,claude-3-opus"
+```
+
+## Troubleshooting
+
+### Claude Code not found
+
+If you see "claude: command not found":
+
+1. Ensure Claude Code is installed
+2. Add it to your PATH, or use `--claude-executable` to specify the full path:
+   ```bash
+   brainrot --claude-executable /path/to/claude
+   ```
+
+### Terminal too small
+
+Games require minimum terminal dimensions. If you see dimension warnings:
+
+1. Resize your terminal window
+2. Or try vertical layout which may fit better:
+   ```bash
+   brainrot --layout-direction vertical
+   ```
+
+### Configuration not saving
+
+Ensure you have write permissions to the config directory:
+
+```bash
+mkdir -p ~/.config/brainrot-cli
+chmod 755 ~/.config/brainrot-cli
+```
+
+### Games not responding to input
+
+Make sure the game pane has focus (use `Tab` to switch). The focused pane has a highlighted border.
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+See [docs/GAME_DEVELOPMENT.md](docs/GAME_DEVELOPMENT.md) for creating new games.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/dist/AchievementNotification.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Achievement Notification Component
+ *
+ * Displays a notification when an achievement is unlocked.
+ * Supports queuing multiple achievements and auto-dismiss.
+ */
+export interface AchievementNotificationProps {
+    /** Achievement IDs to display */
+    achievementIds: string[];
+    /** Callback when all notifications have been shown */
+    onComplete?: () => void;
+    /** Duration to show each notification (ms) */
+    duration?: number;
+}
+/**
+ * Achievement notification queue manager
+ */
+export declare function AchievementNotification({ achievementIds, onComplete, duration, }: AchievementNotificationProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Hook for managing achievement notifications
+ */
+export declare function useAchievementNotifications(): {
+    addAchievements: (ids: string[]) => void;
+    NotificationComponent: import("react/jsx-runtime").JSX.Element | null;
+    hasNotifications: boolean;
+};
+export default AchievementNotification;
+//# sourceMappingURL=AchievementNotification.d.ts.map

package/dist/AchievementNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AchievementNotification.d.ts","sourceRoot":"","sources":["../src/AchievementNotification.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,4BAA4B;IAC3C,iCAAiC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkCD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,cAAc,EACd,UAAU,EACV,QAAe,GAChB,EAAE,4BAA4B,kDA+B9B;AAED;;GAEG;AACH,wBAAgB,2BAA2B;2BAIC,MAAM,EAAE;;;EAuBnD;AAED,eAAe,uBAAuB,CAAC"}

package/dist/AchievementNotification.js

@@ -0,0 +1,74 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Achievement Notification Component
+ *
+ * Displays a notification when an achievement is unlocked.
+ * Supports queuing multiple achievements and auto-dismiss.
+ */
+import { Box, Text } from "ink";
+import { useState, useEffect, useCallback } from "react";
+import { getAchievementById } from "./stats.js";
+import { useThemeColors } from "./useTheme.js";
+/**
+ * Single achievement notification display
+ */
+function AchievementBanner({ achievement }) {
+    const colors = useThemeColors();
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "double", borderColor: colors.warning, paddingX: 2, paddingY: 1, alignItems: "center", children: [_jsx(Box, { children: _jsxs(Text, { color: colors.warning, bold: true, children: [achievement.icon, " ACHIEVEMENT UNLOCKED ", achievement.icon] }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: colors.primary, children: achievement.name }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: achievement.description }) })] }));
+}
+/**
+ * Achievement notification queue manager
+ */
+export function AchievementNotification({ achievementIds, onComplete, duration = 3000, }) {
+    const [currentIndex, setCurrentIndex] = useState(0);
+    const [currentAchievement, setCurrentAchievement] = useState(null);
+    // Get current achievement details
+    useEffect(() => {
+        if (currentIndex < achievementIds.length) {
+            const achievement = getAchievementById(achievementIds[currentIndex]);
+            setCurrentAchievement(achievement ?? null);
+        }
+        else {
+            setCurrentAchievement(null);
+            onComplete?.();
+        }
+    }, [currentIndex, achievementIds, onComplete]);
+    // Auto-advance to next achievement
+    useEffect(() => {
+        if (!currentAchievement)
+            return;
+        const timer = setTimeout(() => {
+            setCurrentIndex((prev) => prev + 1);
+        }, duration);
+        return () => clearTimeout(timer);
+    }, [currentAchievement, duration]);
+    if (!currentAchievement) {
+        return null;
+    }
+    return _jsx(AchievementBanner, { achievement: currentAchievement });
+}
+/**
+ * Hook for managing achievement notifications
+ */
+export function useAchievementNotifications() {
+    const [queue, setQueue] = useState([]);
+    const [isShowing, setIsShowing] = useState(false);
+    const addAchievements = useCallback((ids) => {
+        if (ids.length === 0)
+            return;
+        setQueue((prev) => [...prev, ...ids]);
+        setIsShowing(true);
+    }, []);
+    const handleComplete = useCallback(() => {
+        setQueue([]);
+        setIsShowing(false);
+    }, []);
+    const NotificationComponent = isShowing && queue.length > 0 ? (_jsx(AchievementNotification, { achievementIds: queue, onComplete: handleComplete })) : null;
+    return {
+        addAchievements,
+        NotificationComponent,
+        hasNotifications: isShowing && queue.length > 0,
+    };
+}
+export default AchievementNotification;
+//# sourceMappingURL=AchievementNotification.js.map

package/dist/AchievementNotification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AchievementNotification.js","sourceRoot":"","sources":["../src/AchievementNotification.tsx"],"names":[],"mappings":"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"}

package/dist/GameSelector.d.ts

@@ -0,0 +1,25 @@
+/**
+ * GameSelector Component
+ *
+ * A menu component for selecting and launching games.
+ * Supports keyboard navigation with arrow keys and Enter to select.
+ */
+import type { GameInfo, GameDimensions } from "./game-types.js";
+export interface GameSelectorProps {
+    /** Available games to select from */
+    games: GameInfo[];
+    /** Whether the selector has keyboard focus */
+    hasFocus: boolean;
+    /** Available dimensions */
+    dimensions: GameDimensions;
+    /** Callback when a game is selected */
+    onSelectGame: (gameId: string) => void;
+    /** Callback when stats menu is requested */
+    onOpenStats?: () => void;
+}
+/**
+ * Game selector menu component
+ */
+export declare function GameSelector({ games, hasFocus, dimensions, onSelectGame, onOpenStats, }: GameSelectorProps): import("react/jsx-runtime").JSX.Element;
+export default GameSelector;
+//# sourceMappingURL=GameSelector.d.ts.map

package/dist/GameSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameSelector.d.ts","sourceRoot":"","sources":["../src/GameSelector.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKhE,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,cAAc,CAAC;IAC3B,uCAAuC;IACvC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAgHD;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,EAAE,iBAAiB,2CA8GnB;AAED,eAAe,YAAY,CAAC"}

package/dist/GameSelector.js

@@ -0,0 +1,105 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * GameSelector Component
+ *
+ * A menu component for selecting and launching games.
+ * Supports keyboard navigation with arrow keys and Enter to select.
+ */
+import { Box, Text, useInput } from "ink";
+import { useState, useCallback, useEffect } from "react";
+import { navIcons } from "./theme.js";
+import { useThemeColors } from "./useTheme.js";
+import { getAchievementCount } from "./stats.js";
+function GameCard({ game, isSelected, isHighlighted, dimensions }) {
+    const colors = useThemeColors();
+    const borderColor = isHighlighted ? colors.primary : isSelected ? colors.accent : colors.border;
+    const titleColor = isHighlighted ? colors.primary : isSelected ? colors.accent : colors.text;
+    // Calculate card width based on available space
+    const cardWidth = Math.min(Math.max(dimensions.width - 4, 30), 50);
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: borderColor, paddingX: 1, width: cardWidth, children: [_jsx(Box, { children: _jsxs(Text, { bold: true, color: titleColor, children: [isHighlighted ? `${navIcons.arrowRight} ` : "  ", game.name] }) }), _jsx(Text, { dimColor: true, wrap: "truncate", children: game.description }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: colors.textMuted, children: "Controls: " }), _jsx(Text, { dimColor: true, children: game.controls })] }), game.minWidth && game.minHeight && (_jsxs(Text, { dimColor: true, children: ["Min size: ", game.minWidth, "x", game.minHeight] }))] }));
+}
+function SelectorHeader({ hasFocus }) {
+    const colors = useThemeColors();
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: colors.primary, children: "Select a Game" }), _jsx(Text, { dimColor: true, children: hasFocus
+                    ? "↑/↓: Navigate | Enter: Select | S: Stats | Q: Back"
+                    : "Press Tab to focus game selector" })] }));
+}
+function StatsMenuCard({ isHighlighted, dimensions, achievementCount }) {
+    const colors = useThemeColors();
+    const borderColor = isHighlighted ? colors.warning : colors.border;
+    const titleColor = isHighlighted ? colors.warning : colors.textMuted;
+    const cardWidth = Math.min(Math.max(dimensions.width - 4, 30), 50);
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: borderColor, paddingX: 1, width: cardWidth, children: [_jsx(Box, { children: _jsxs(Text, { bold: true, color: titleColor, children: [isHighlighted ? `${navIcons.arrowRight} ` : "  ", "Stats & Achievements"] }) }), _jsx(Text, { dimColor: true, children: "View your gameplay statistics and unlock achievements" }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: colors.textMuted, children: "Progress: " }), _jsxs(Text, { color: colors.success, children: [achievementCount.unlocked, "/", achievementCount.total, " achievements"] })] })] }));
+}
+function EmptyState() {
+    const colors = useThemeColors();
+    return (_jsxs(Box, { flexDirection: "column", padding: 2, children: [_jsx(Text, { color: colors.accent, children: "No games available" }), _jsx(Text, { dimColor: true, children: "Check back later for new games!" })] }));
+}
+/**
+ * Game selector menu component
+ */
+export function GameSelector({ games, hasFocus, dimensions, onSelectGame, onOpenStats, }) {
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const [achievementCount, setAchievementCount] = useState({ unlocked: 0, total: 0 });
+    // Total items: games + stats menu
+    const totalItems = games.length + 1;
+    const statsIndex = games.length; // Stats is always last
+    // Load achievement count
+    useEffect(() => {
+        const loadCount = async () => {
+            const count = await getAchievementCount();
+            setAchievementCount(count);
+        };
+        void loadCount();
+    }, []);
+    const handleSelect = useCallback(() => {
+        if (selectedIndex === statsIndex) {
+            onOpenStats?.();
+        }
+        else if (games.length > 0 && games[selectedIndex]) {
+            onSelectGame(games[selectedIndex].id);
+        }
+    }, [games, selectedIndex, onSelectGame, onOpenStats, statsIndex]);
+    useInput((input, key) => {
+        if (!hasFocus)
+            return;
+        // Navigate up
+        if (key.upArrow || input === "k") {
+            setSelectedIndex((prev) => (prev > 0 ? prev - 1 : totalItems - 1));
+            return;
+        }
+        // Navigate down
+        if (key.downArrow || input === "j") {
+            setSelectedIndex((prev) => (prev < totalItems - 1 ? prev + 1 : 0));
+            return;
+        }
+        // Select item
+        if (key.return || input === " ") {
+            handleSelect();
+            return;
+        }
+        // Quick open stats with S key
+        if (input === "s" || input === "S") {
+            onOpenStats?.();
+            return;
+        }
+        // Quick select game by number (1-9)
+        const num = parseInt(input, 10);
+        if (!isNaN(num) && num >= 1 && num <= games.length) {
+            setSelectedIndex(num - 1);
+            if (games[num - 1]) {
+                onSelectGame(games[num - 1].id);
+            }
+            return;
+        }
+    }, { isActive: hasFocus });
+    // Keep selected index in bounds
+    if (selectedIndex >= totalItems && totalItems > 0) {
+        setSelectedIndex(totalItems - 1);
+    }
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, height: "100%", children: [_jsx(SelectorHeader, { hasFocus: hasFocus }), games.length === 0 ? (_jsx(EmptyState, {})) : (_jsxs(Box, { flexDirection: "column", gap: 1, children: [games.map((game, index) => (_jsx(GameCard, { game: game, isSelected: index === selectedIndex, isHighlighted: hasFocus && index === selectedIndex, dimensions: dimensions }, game.id))), _jsx(StatsMenuCard, { isHighlighted: hasFocus && selectedIndex === statsIndex, dimensions: dimensions, achievementCount: achievementCount })] })), totalItems > 0 && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: selectedIndex === statsIndex
+                        ? "Stats & Achievements"
+                        : `Game ${selectedIndex + 1} of ${games.length}` }) }))] }));
+}
+export default GameSelector;
+//# sourceMappingURL=GameSelector.js.map

package/dist/GameSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameSelector.js","sourceRoot":"","sources":["../src/GameSelector.tsx"],"names":[],"mappings":"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"}

package/dist/HelpOverlay.d.ts

@@ -0,0 +1,15 @@
+/**
+ * HelpOverlay Component
+ *
+ * Modal overlay that displays comprehensive keyboard shortcuts organized by context.
+ * Triggered by ? or F1 key globally.
+ */
+export interface HelpOverlayProps {
+    /** Whether the overlay has focus */
+    hasFocus: boolean;
+    /** Callback to close the overlay */
+    onClose: () => void;
+}
+export declare function HelpOverlay({ hasFocus, onClose }: HelpOverlayProps): import("react/jsx-runtime").JSX.Element;
+export default HelpOverlay;
+//# sourceMappingURL=HelpOverlay.d.ts.map

package/dist/HelpOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpOverlay.d.ts","sourceRoot":"","sources":["../src/HelpOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA+ID,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,gBAAgB,2CAoFlE;AAED,eAAe,WAAW,CAAC"}