@hypersocial/cli-games 0.1.0

package/dist/themes.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Terminal color themes
+ *
+ * Provides both CSS colors (for UI) and ANSI escape codes (for terminal).
+ */
+/**
+ * Available theme identifiers
+ */
+type PhosphorMode = 'cyan' | 'cyanLight' | 'amber' | 'green' | 'white' | 'hotpink' | 'hotpinkLight' | 'blood' | 'ice' | 'iceLight' | 'bladerunner' | 'bladerunnerLight' | 'tron' | 'tronLight' | 'daylight' | 'kawaii' | 'kawaiiLight' | 'oled' | 'solarized' | 'solarizedLight' | 'nord' | 'nordLight' | 'highcontrast' | 'highcontrastLight' | 'banana' | 'cream';
+/**
+ * Theme color definition for CSS/UI usage
+ */
+interface ThemeColors {
+    /** Display name */
+    name: string;
+    /** Emoji icon for quick switcher / UI */
+    icon: string;
+    /** Primary text/accent color (hex) */
+    primary: string;
+    /** Secondary accent color (hex) */
+    secondary: string;
+    /** Subtle glow effect (rgba) */
+    glow: string;
+    /** Intense glow effect (rgba) */
+    glowIntense: string;
+    /** Background color (hex) */
+    bg: string;
+    /** Status bar background - slightly elevated from bg */
+    statusBarBg: string;
+    /** Terminal foreground color - defaults to primary if not set */
+    foreground?: string;
+}
+/**
+ * All theme definitions with CSS colors
+ */
+declare const themes: Record<PhosphorMode, ThemeColors>;
+/**
+ * Get theme colors by mode
+ */
+declare function getTheme(mode: PhosphorMode): ThemeColors;
+/**
+ * Get ANSI escape code for a theme
+ */
+declare function getAnsiColor(mode: PhosphorMode): string;
+/**
+ * Check if a theme is light (needs dark text)
+ */
+declare function isLightTheme(mode: PhosphorMode): boolean;
+/**
+ * Get subtle background color for game elements
+ */
+declare function getSubtleColor(mode: PhosphorMode): string;
+/**
+ * Get all available theme modes
+ */
+declare function getThemeModes(): PhosphorMode[];
+/**
+ * Check if a string is a valid theme mode
+ */
+declare function isValidThemeMode(value: string): value is PhosphorMode;
+/**
+ * ANSI reset code
+ */
+declare const ANSI_RESET = "\u001B[0m";
+/**
+ * xterm.js ITheme-compatible color set.
+ * Includes the 16 ANSI colors, selection, cursor, scrollbar, and foreground/background.
+ */
+interface ITerminalTheme {
+    background: string;
+    foreground: string;
+    cursor: string;
+    cursorAccent: string;
+    selectionBackground: string;
+    selectionForeground: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    brightBlack: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+    scrollbarSliderBackground: string;
+    scrollbarSliderHoverBackground: string;
+    scrollbarSliderActiveBackground: string;
+}
+/**
+ * Generate a full xterm.js theme from a PhosphorMode.
+ *
+ * Maps theme colors to the 16 ANSI colors, selection, cursor, and scrollbar.
+ * Light themes get inverted black/white and muted ANSI colors for readability.
+ */
+declare function getTerminalTheme(mode: PhosphorMode): ITerminalTheme;
+/**
+ * Transform ANSI escape sequences for light themes.
+ *
+ * Apps like Codex use true color (24-bit) escape sequences that bypass our
+ * theme's ANSI color settings. This intercepts dark backgrounds/foregrounds
+ * and inverts them so TUI apps remain readable on light backgrounds.
+ *
+ * @param data - Raw terminal data with ANSI escape sequences
+ * @param themeBg - The theme's background color hex (e.g., "#F5E6D3")
+ * @returns Transformed data with inverted colors for light themes
+ */
+declare function transformEscapeSequencesForLightTheme(data: string, themeBg: string): string;
+/**
+ * Transform ANSI escape sequences for dark themes with non-black backgrounds.
+ *
+ * Apps like Claude Code use true-color (24-bit) escape sequences for dark
+ * backgrounds (e.g. \033[48;2;0;0;0m) which bypass the ANSI color mapping.
+ * On dark themes where the bg isn't pure black, these show as jarring strips.
+ * This remaps near-black and near-white backgrounds to the theme bg.
+ */
+declare function transformEscapeSequencesForDarkTheme(data: string, themeBg: string): string;
+
+export { ANSI_RESET, type ITerminalTheme, type PhosphorMode, type ThemeColors, getAnsiColor, getSubtleColor, getTerminalTheme, getTheme, getThemeModes, isLightTheme, isValidThemeMode, themes, transformEscapeSequencesForDarkTheme, transformEscapeSequencesForLightTheme };

package/dist/themes.js

@@ -0,0 +1,27 @@
+import {
+  ANSI_RESET,
+  getAnsiColor,
+  getSubtleColor,
+  getTerminalTheme,
+  getTheme,
+  getThemeModes,
+  isLightTheme,
+  isValidThemeMode,
+  themes,
+  transformEscapeSequencesForDarkTheme,
+  transformEscapeSequencesForLightTheme
+} from "./chunk-AVGB32MC.js";
+export {
+  ANSI_RESET,
+  getAnsiColor,
+  getSubtleColor,
+  getTerminalTheme,
+  getTheme,
+  getThemeModes,
+  isLightTheme,
+  isValidThemeMode,
+  themes,
+  transformEscapeSequencesForDarkTheme,
+  transformEscapeSequencesForLightTheme
+};
+//# sourceMappingURL=themes.js.map

package/dist/themes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@hypersocial/cli-games",
+  "version": "0.1.0",
+  "description": "Terminal games for xterm.js and CLI — snake, 2048, pong, asteroids, tetris, and more",
+  "license": "AGPL-3.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "cli-games": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./themes": {
+      "types": "./dist/themes.d.ts",
+      "import": "./dist/themes.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@xterm/xterm": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@xterm/xterm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "@xterm/xterm": "^6.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hypersocialinc/cli-games.git"
+  },
+  "keywords": [
+    "terminal",
+    "games",
+    "cli",
+    "xterm",
+    "snake",
+    "tetris",
+    "2048",
+    "pong",
+    "asteroids"
+  ],
+  "author": "Hypersocial Inc."
+}