mtosity 0.0.2 → 0.0.5

package/README.md

@@ -1,56 +1,143 @@
-# mtosity
+# MTosity
 
-My personal terminal, whatevery I need in one place. You can use it too! You may know something about me while using it.
+My personal CLI, whatever I need in one place. You can use it too! You may know something about me while using it.
 
 ```
-  __  __   _                   _   _
- |  \/  | | |_    ___    ___  (_) | |_   _   _
- | |\/| | | __|  / _ \  / __| | | | __| | | | |
- | |  | | | |_  | (_) | \__ \ | | | |_  | |_| |
- |_|  |_|  \__|  \___/  |___/ |_|  \__|  \__, |
-                                          |___/
+  __  __   _____                 _   _
+ |  \/  | |_   _|   ___    ___  (_) | |_   _   _
+ | |\/| |   | |    / _ \  / __| | | | __| | | | |
+ | |  | |   | |   | (_) | \__ \ | | | |_  | |_| |
+ |_|  |_|   |_|    \___/  |___/ |_|  \__|  \__, |
+                                           |___/
 ```
 
-## Prerequisites
+## Quick Start
 
-- [yt-dlp](https://github.com/yt-dlp/yt-dlp) installed and available in your PATH
+```bash
+bunx mtosity
+```
 
-## Install
+or
 
 ```bash
-npm install -g mtosity
+npx mtosity
 ```
 
-## Usage
+## Commands
 
-Run the CLI:
+### About
 
-```bash
-mtosity
-```
+| Command | Description |
+|---|---|
+| `me` | Animated terminal resume / about me |
 
-### Commands
+### System
+
+| Command | Description |
+|---|---|
+| `system` | Display system info (OS, CPU, GPU, memory, IP addresses) |
+
+### Apps
+
+| Command | Description |
+|---|---|
+| `spotify status` | Show current Spicetify config |
+| `spotify theme <name>` | Switch theme (mocha, macchiato, frappe, latte, dark, dracula, nord, gruvbox, rosepine, default) |
+| `spotify apply` | Apply Spicetify config |
+| `spotify restart` | Restart Spotify |
+| `spotify fix` | Backup & apply (fixes after Spotify updates) |
+| `spotify restore` | Restore original Spotify |
+| `whisky status` | Check Whisky installation |
+| `whisky run <file.exe>` | Run a Windows .exe via Whisky |
+| `whisky open` | Open Whisky.app GUI |
+| `whisky install` | Install Whisky via Homebrew |
+
+### Media
 
 | Command | Description |
 |---|---|
 | `yt <url> [start] [end]` | Download YouTube video (MP4) |
 | `yt-mp3 <url> [start] [end]` | Download YouTube audio (MP3) |
-| `neofetch` | Display system information |
+| `harmonica <file> [preset]` | Enhance harmonica recording (presets: echo, echo-light, echo-heavy, bass) |
+
+### Games
+
+| Command | Description |
+|---|---|
+| `game` | List available games |
+| `game tetris` | Bastard Tetris — always gives you the worst piece |
+| `game invaders` | nInvaders — Space Invaders clone in the terminal |
+
+### Utility
+
+| Command | Description |
+|---|---|
+| `clock` | World clock showing times across cities |
+| `clock -p <city>` | Add specific cities to the clock (e.g. `clock -p berlin -p "san francisco"`) |
+
+### General
+
+| Command | Description |
+|---|---|
 | `help` | Show available commands |
 | `clear` | Clear the terminal |
 | `exit` | Exit the CLI |
 
-### Examples
+> **Tip**: Press ↑/↓ arrows to navigate command history.
+
+## Examples
 
 ```bash
+# System info
+system
+
+# Switch Spotify theme
+spotify theme mocha
+
 # Download a video
 yt https://youtu.be/dQw4w9WgXcQ
 
-# Download audio only
-yt-mp3 https://youtu.be/dQw4w9WgXcQ
+# Download and trim audio (start at 0:30, duration 1:00)
+yt-mp3 https://youtu.be/dQw4w9WgXcQ 00:00:30 00:01:00
+
+# Run a Windows exe
+whisky run ~/Downloads/setup.exe
+
+# Enhance a harmonica recording with heavy echo
+harmonica recording.mp4 echo-heavy
+```
+
+## Project Structure
 
-# Download and trim (start at 0:30, duration 1:00)
-yt https://youtu.be/dQw4w9WgXcQ 00:00:30 00:01:00
+```
+src/
+├── index.ts              Entry point
+├── cli.ts                REPL loop & command dispatch
+├── commands/
+│   ├── help.ts           Help display
+│   ├── system.ts         System info (neofetch-style)
+│   ├── spicetify.ts      Spotify/Spicetify management
+│   ├── whisky.ts         Windows app runner via Whisky
+│   ├── youtube.ts        YouTube downloader
+│   ├── harmonica.ts      Audio enhancement
+│   ├── clock.ts          World clock display
+│   └── game.ts           Game launcher (tetris, invaders)
+├── games/
+│   ├── terminal.ts       Shared game infrastructure (raw mode, keys, ANSI)
+│   ├── tetris/
+│   │   ├── index.ts      Tetris game loop & state machine
+│   │   ├── pieces.ts     Tetromino definitions & rotations
+│   │   ├── board.ts      Board state, collision, line clearing
+│   │   ├── bastard.ts    Worst-piece selection algorithm
+│   │   └── renderer.ts   Board + HUD rendering
+│   └── invaders/
+│       ├── index.ts      Invaders game loop & state machine
+│       ├── entities.ts   Types, sprites, colors
+│       ├── wave.ts       Wave creation, speed scaling
+│       └── renderer.ts   Scene rendering
+└── utils/
+    ├── ffmpeg.ts          FFmpeg & yt-dlp setup
+    └── network.ts         IP address utilities
 ```
 
 ## Development
@@ -62,6 +149,9 @@ bun install
 # Run in dev mode
 bun run dev
 
+# Run tests
+bun test
+
 # Build
 bun run build
 ```

package/dist/cli.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const chalk_1 = __importDefault(require("chalk"));
+const figlet_1 = __importDefault(require("figlet"));
+const readline_1 = __importDefault(require("readline"));
+const system_1 = require("./commands/system");
+const youtube_1 = require("./commands/youtube");
+const help_1 = require("./commands/help");
+const harmonica_1 = require("./commands/harmonica");
+const spicetify_1 = require("./commands/spicetify");
+const whisky_1 = require("./commands/whisky");
+const me_1 = require("./commands/me");
+const clock_1 = require("./commands/clock");
+const game_1 = require("./commands/game");
+function prompt(rl) {
+    return new Promise((resolve) => {
+        rl.question(chalk_1.default.green("mtosity > "), (answer) => {
+            resolve(answer);
+        });
+    });
+}
+async function main() {
+    console.clear();
+    console.log(chalk_1.default.green(figlet_1.default.textSync("MTosity", { horizontalLayout: "full" })));
+    console.log(chalk_1.default.dim(`Welcome! Type '${chalk_1.default.white("me")}' to learn about me, or '${chalk_1.default.white("help")}' for all commands.\n`));
+    const rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        historySize: 100,
+        terminal: true,
+    });
+    // Handle Ctrl+C gracefully
+    rl.on("close", () => {
+        const confirmRl = readline_1.default.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: true,
+        });
+        console.log("");
+        confirmRl.question(chalk_1.default.yellow("Are you sure you want to quit? (y/N) "), (answer) => {
+            confirmRl.close();
+            if (answer.trim().toLowerCase() === "y") {
+                console.log(chalk_1.default.green("Goodbye!"));
+                process.exit(0);
+            }
+            else {
+                main().catch(console.error);
+            }
+        });
+    });
+    // Prevent default SIGINT from killing the process
+    process.on("SIGINT", () => { });
+    while (true) {
+        const input = await prompt(rl);
+        const parts = input.trim().split(" ");
+        const cmd = parts[0];
+        const args = parts.slice(1);
+        switch (cmd) {
+            case "system":
+                await (0, system_1.runNeofetch)();
+                break;
+            case "yt":
+                if (!args[0]) {
+                    console.log(chalk_1.default.dim("Usage: yt <url> [start] [end]"));
+                }
+                else {
+                    await (0, youtube_1.downloadYouTube)(args[0], "video", args[1], args[2]);
+                }
+                break;
+            case "yt-mp3":
+                if (!args[0]) {
+                    console.log(chalk_1.default.dim("Usage: yt-mp3 <url> [start] [end]"));
+                }
+                else {
+                    await (0, youtube_1.downloadYouTube)(args[0], "audio", args[1], args[2]);
+                }
+                break;
+            case "spotify":
+                await (0, spicetify_1.runSpicetify)(args[0], args[1]);
+                break;
+            case "whisky":
+                await (0, whisky_1.runWhisky)(args[0], args[1]);
+                break;
+            case "harmonica":
+                await (0, harmonica_1.enhanceHarmonica)(args[0], args[1]);
+                break;
+            case "me":
+                await (0, me_1.showResume)();
+                break;
+            case "clock":
+                const extraPlaces = (0, clock_1.parsePlaces)(args);
+                (0, clock_1.showClock)(extraPlaces);
+                break;
+            case "game":
+                await (0, game_1.runGame)(rl, args[0]);
+                break;
+            case "clear":
+                console.clear();
+                break;
+            case "exit":
+                console.log(chalk_1.default.green("Goodbye!"));
+                rl.close();
+                process.exit(0);
+            case "":
+                break;
+            case "help":
+                (0, help_1.showHelp)();
+                break;
+            default:
+                console.log(chalk_1.default.red(`Unknown command: ${cmd}`));
+                break;
+        }
+    }
+}

package/dist/commands/clock.js

@@ -0,0 +1,303 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePlaces = parsePlaces;
+exports.showClock = showClock;
+const chalk_1 = __importDefault(require("chalk"));
+const CITIES = [
+    { city: "Sydney", timezone: "Australia/Sydney", flag: "🇦🇺" },
+    { city: "Tokyo", timezone: "Asia/Tokyo", flag: "🇯🇵" },
+    { city: "Singapore", timezone: "Asia/Singapore", flag: "🇸🇬" },
+    { city: "Ho Chi Minh", timezone: "Asia/Ho_Chi_Minh", flag: "🇻🇳" },
+    { city: "Dubai", timezone: "Asia/Dubai", flag: "🇦🇪" },
+    { city: "UTC", timezone: "UTC", flag: "🌐" },
+    { city: "London", timezone: "Europe/London", flag: "🇬🇧" },
+    { city: "Paris", timezone: "Europe/Paris", flag: "🇫🇷" },
+    { city: "New York", timezone: "America/New_York", flag: "🇺🇸" },
+    { city: "San Francisco", timezone: "America/Los_Angeles", flag: "🇺🇸" },
+    { city: "Honolulu", timezone: "Pacific/Honolulu", flag: "🇺🇸" },
+];
+// Lookup table for resolving city names to IANA timezones
+const CITY_LOOKUP = {
+    // Americas
+    "new york": { timezone: "America/New_York", flag: "🇺🇸" },
+    "los angeles": { timezone: "America/Los_Angeles", flag: "🇺🇸" },
+    "san francisco": { timezone: "America/Los_Angeles", flag: "🇺🇸" },
+    "chicago": { timezone: "America/Chicago", flag: "🇺🇸" },
+    "denver": { timezone: "America/Denver", flag: "🇺🇸" },
+    "houston": { timezone: "America/Chicago", flag: "🇺🇸" },
+    "dallas": { timezone: "America/Chicago", flag: "🇺🇸" },
+    "seattle": { timezone: "America/Los_Angeles", flag: "🇺🇸" },
+    "miami": { timezone: "America/New_York", flag: "🇺🇸" },
+    "boston": { timezone: "America/New_York", flag: "🇺🇸" },
+    "atlanta": { timezone: "America/New_York", flag: "🇺🇸" },
+    "raleigh": { timezone: "America/New_York", flag: "🇺🇸" },
+    "washington": { timezone: "America/New_York", flag: "🇺🇸" },
+    "washington dc": { timezone: "America/New_York", flag: "🇺🇸" },
+    "dc": { timezone: "America/New_York", flag: "🇺🇸" },
+    "las vegas": { timezone: "America/Los_Angeles", flag: "🇺🇸" },
+    "vegas": { timezone: "America/Los_Angeles", flag: "🇺🇸" },
+    "phoenix": { timezone: "America/Phoenix", flag: "🇺🇸" },
+    "philadelphia": { timezone: "America/New_York", flag: "🇺🇸" },
+    "detroit": { timezone: "America/Detroit", flag: "🇺🇸" },
+    "san diego": { timezone: "America/Los_Angeles", flag: "🇺🇸" },
+    "austin": { timezone: "America/Chicago", flag: "🇺🇸" },
+    "honolulu": { timezone: "Pacific/Honolulu", flag: "🇺🇸" },
+    "anchorage": { timezone: "America/Anchorage", flag: "🇺🇸" },
+    "toronto": { timezone: "America/Toronto", flag: "🇨🇦" },
+    "montreal": { timezone: "America/Toronto", flag: "🇨🇦" },
+    "vancouver": { timezone: "America/Vancouver", flag: "🇨🇦" },
+    "mexico city": { timezone: "America/Mexico_City", flag: "🇲🇽" },
+    "sao paulo": { timezone: "America/Sao_Paulo", flag: "🇧🇷" },
+    "rio": { timezone: "America/Sao_Paulo", flag: "🇧🇷" },
+    "buenos aires": { timezone: "America/Argentina/Buenos_Aires", flag: "🇦🇷" },
+    "santiago": { timezone: "America/Santiago", flag: "🇨🇱" },
+    "lima": { timezone: "America/Lima", flag: "🇵🇪" },
+    "bogota": { timezone: "America/Bogota", flag: "🇨🇴" },
+    // Europe
+    "london": { timezone: "Europe/London", flag: "🇬🇧" },
+    "dublin": { timezone: "Europe/Dublin", flag: "🇮🇪" },
+    "paris": { timezone: "Europe/Paris", flag: "🇫🇷" },
+    "berlin": { timezone: "Europe/Berlin", flag: "🇩🇪" },
+    "frankfurt": { timezone: "Europe/Berlin", flag: "🇩🇪" },
+    "munich": { timezone: "Europe/Berlin", flag: "🇩🇪" },
+    "amsterdam": { timezone: "Europe/Amsterdam", flag: "🇳🇱" },
+    "brussels": { timezone: "Europe/Brussels", flag: "🇧🇪" },
+    "madrid": { timezone: "Europe/Madrid", flag: "🇪🇸" },
+    "barcelona": { timezone: "Europe/Madrid", flag: "🇪🇸" },
+    "rome": { timezone: "Europe/Rome", flag: "🇮🇹" },
+    "milan": { timezone: "Europe/Rome", flag: "🇮🇹" },
+    "vienne": { timezone: "Europe/Vienna", flag: "🇦🇹" },
+    "vienna": { timezone: "Europe/Vienna", flag: "🇦🇹" },
+    "zurich": { timezone: "Europe/Zurich", flag: "🇨Ｈ" },
+    "warsaw": { timezone: "Europe/Warsaw", flag: "🇵🇱" },
+    "stockholm": { timezone: "Europe/Stockholm", flag: "🇸🇪" },
+    "oslo": { timezone: "Europe/Oslo", flag: "🇳🇴" },
+    "copenhagen": { timezone: "Europe/Copenhagen", flag: "🇩🇰" },
+    "helsinki": { timezone: "Europe/Helsinki", flag: "🇫🇮" },
+    "athens": { timezone: "Europe/Athens", flag: "🇬🇷" },
+    "istanbul": { timezone: "Europe/Istanbul", flag: "🇹🇷" },
+    "moscow": { timezone: "Europe/Moscow", flag: "🇷🇺" },
+    "kyiv": { timezone: "Europe/Kyiv", flag: "🇺🇦" },
+    "kiev": { timezone: "Europe/Kyiv", flag: "🇺🇦" },
+    // Asia & Oceania
+    "tokyo": { timezone: "Asia/Tokyo", flag: "🇯🇵" },
+    "osaka": { timezone: "Asia/Tokyo", flag: "🇯🇵" },
+    "kyoto": { timezone: "Asia/Tokyo", flag: "🇯🇵" },
+    "singapore": { timezone: "Asia/Singapore", flag: "🇸🇬" },
+    "ho chi minh": { timezone: "Asia/Ho_Chi_Minh", flag: "🇻🇳" },
+    "saigon": { timezone: "Asia/Ho_Chi_Minh", flag: "🇻🇳" },
+    "hanoi": { timezone: "Asia/Ho_Chi_Minh", flag: "🇻🇳" },
+    "ha noi": { timezone: "Asia/Ho_Chi_Minh", flag: "🇻🇳" },
+    "bangkok": { timezone: "Asia/Bangkok", flag: "🇹🇭" },
+    "jakarta": { timezone: "Asia/Jakarta", flag: "🇮🇩" },
+    "bali": { timezone: "Asia/Makassar", flag: "🇮🇩" },
+    "manila": { timezone: "Asia/Manila", flag: "🇵🇭" },
+    "kuala lumpur": { timezone: "Asia/Kuala_Lumpur", flag: "🇲🇾" },
+    "dubai": { timezone: "Asia/Dubai", flag: "🇦🇪" },
+    "abu dhabi": { timezone: "Asia/Dubai", flag: "🇦🇪" },
+    "doha": { timezone: "Asia/Qatar", flag: "🇶🇦" },
+    "riyadh": { timezone: "Asia/Riyadh", flag: "🇸🇦" },
+    "tel aviv": { timezone: "Asia/Jerusalem", flag: "🇮🇱" },
+    "jerusalem": { timezone: "Asia/Jerusalem", flag: "🇮🇱" },
+    "mumbai": { timezone: "Asia/Kolkata", flag: "🇮🇳" },
+    "delhi": { timezone: "Asia/Kolkata", flag: "🇮🇳" },
+    "bangalore": { timezone: "Asia/Kolkata", flag: "🇮🇳" },
+    "beijing": { timezone: "Asia/Shanghai", flag: "🇨🇳" },
+    "shanghai": { timezone: "Asia/Shanghai", flag: "🇨🇳" },
+    "shenzhen": { timezone: "Asia/Shanghai", flag: "🇨🇳" },
+    "hong kong": { timezone: "Asia/Hong_Kong", flag: "🇭🇰" },
+    "seoul": { timezone: "Asia/Seoul", flag: "🇰🇷" },
+    "taipei": { timezone: "Asia/Taipei", flag: "🇹🇼" },
+    "sydney": { timezone: "Australia/Sydney", flag: "🇦🇺" },
+    "melbourne": { timezone: "Australia/Melbourne", flag: "🇦🇺" },
+    "brisbane": { timezone: "Australia/Brisbane", flag: "🇦🇺" },
+    "perth": { timezone: "Australia/Perth", flag: "🇦🇺" },
+    "adelaide": { timezone: "Australia/Adelaide", flag: "🇦🇺" },
+    "auckland": { timezone: "Pacific/Auckland", flag: "🇳🇿" },
+    "wellington": { timezone: "Pacific/Auckland", flag: "🇳🇿" },
+    // Africa & Middle East
+    "cairo": { timezone: "Africa/Cairo", flag: "🇪🇬" },
+    "johannesburg": { timezone: "Africa/Johannesburg", flag: "🇿🇦" },
+    "nairobi": { timezone: "Africa/Nairobi", flag: "🇰🇪" },
+    // Special
+    "utc": { timezone: "UTC", flag: "🌐" },
+};
+function parsePlaces(args) {
+    const places = [];
+    let i = 0;
+    while (i < args.length) {
+        if (args[i] === "-p" && i + 1 < args.length) {
+            i++;
+            // Collect words until the next -p flag or end
+            const words = [];
+            while (i < args.length && args[i] !== "-p") {
+                words.push(args[i]);
+                i++;
+            }
+            if (words.length > 0) {
+                places.push(words.join(" "));
+            }
+        }
+        else {
+            i++;
+        }
+    }
+    return places;
+}
+function resolvePlace(name) {
+    const key = name.toLowerCase().trim();
+    const entry = CITY_LOOKUP[key];
+    if (!entry)
+        return null;
+    // Capitalize city name nicely
+    const displayName = name.trim().replace(/\b\w/g, (c) => c.toUpperCase());
+    return { city: displayName, timezone: entry.timezone, flag: entry.flag };
+}
+function getTimeInZone(tz, now) {
+    const timeFmt = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: true,
+    });
+    const dateFmt = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        weekday: "short",
+        month: "short",
+        day: "numeric",
+    });
+    const hourFmt = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        hour: "numeric",
+        hour12: false,
+    });
+    return {
+        time: timeFmt.format(now),
+        date: dateFmt.format(now),
+        hour: parseInt(hourFmt.format(now), 10),
+    };
+}
+function getUtcOffset(tz, now) {
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        timeZoneName: "shortOffset",
+    });
+    const parts = formatter.formatToParts(now);
+    const tzPart = parts.find((p) => p.type === "timeZoneName");
+    if (!tzPart)
+        return 0;
+    // Parse "GMT+7", "GMT-5", "GMT+5:30", "GMT" etc.
+    const match = tzPart.value.match(/GMT([+-]?)(\d+)?(?::(\d+))?/);
+    if (!match)
+        return 0;
+    const sign = match[1] === "-" ? -1 : 1;
+    const hours = parseInt(match[2] || "0", 10);
+    const minutes = parseInt(match[3] || "0", 10);
+    return sign * (hours * 60 + minutes);
+}
+function getDayNightIcon(hour) {
+    if (hour >= 6 && hour < 18)
+        return "☀️";
+    if (hour >= 18 && hour < 21)
+        return "🌅";
+    return "🌙";
+}
+function formatOffset(diffMinutes) {
+    const sign = diffMinutes >= 0 ? "+" : "";
+    const hours = Math.floor(Math.abs(diffMinutes) / 60);
+    const mins = Math.abs(diffMinutes) % 60;
+    if (mins === 0)
+        return `${sign}${diffMinutes >= 0 ? hours : -hours}h`;
+    return `${sign}${diffMinutes >= 0 ? "" : "-"}${hours}h${mins}m`;
+}
+function showClock(extraPlaces = []) {
+    const now = new Date();
+    const localTz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const localOffset = getUtcOffset(localTz, now);
+    const localInfo = getTimeInZone(localTz, now);
+    // Resolve extra places
+    const extraCities = [];
+    const unknownPlaces = [];
+    for (const place of extraPlaces) {
+        const resolved = resolvePlace(place);
+        if (resolved) {
+            extraCities.push({ ...resolved, isRequested: true });
+        }
+        else {
+            unknownPlaces.push(place);
+        }
+    }
+    // Merge: default cities + extras (dedup by timezone+city)
+    // Use map to create mutable copies and track requested status
+    const allCities = CITIES.map((c) => ({ ...c, isRequested: false }));
+    for (const ec of extraCities) {
+        const existingIndex = allCities.findIndex((c) => c.timezone === ec.timezone && c.city.toLowerCase() === ec.city.toLowerCase());
+        if (existingIndex !== -1) {
+            allCities[existingIndex].isRequested = true;
+        }
+        else {
+            allCities.push(ec);
+        }
+    }
+    // Compute data for each city
+    const entries = allCities.map((c) => {
+        const info = getTimeInZone(c.timezone, now);
+        const offset = getUtcOffset(c.timezone, now);
+        const diff = offset - localOffset;
+        return { ...c, ...info, offset, diff };
+    });
+    // Sort by UTC offset (west → east)
+    entries.sort((a, b) => a.offset - b.offset);
+    // Group
+    const ahead = entries.filter((e) => e.diff > 0);
+    const same = entries.filter((e) => e.diff === 0);
+    const behind = entries.filter((e) => e.diff < 0);
+    const W = 56;
+    const dim = chalk_1.default.dim;
+    const divider = dim("  " + "─".repeat(W));
+    console.log("");
+    console.log(chalk_1.default.cyan.bold("  🕐 World Clock"));
+    console.log(divider);
+    // Local time header
+    const localCity = localTz.split("/").pop()?.replace(/_/g, " ") || localTz;
+    console.log("");
+    console.log(`  📍 ${chalk_1.default.white.bold("You")}  ${chalk_1.default.dim("·")}  ${chalk_1.default.white.bold(localCity)}  ${chalk_1.default.dim("·")}  ${chalk_1.default.green.bold(localInfo.time)}  ${chalk_1.default.dim(localInfo.date)}  ${getDayNightIcon(localInfo.hour)}`);
+    console.log("");
+    console.log(divider);
+    const printGroup = (label, labelColor, items) => {
+        if (items.length === 0)
+            return;
+        console.log("");
+        console.log(`  ${labelColor(label)}`);
+        console.log("");
+        for (const e of items) {
+            const offsetStr = formatOffset(e.diff);
+            const offsetColored = e.diff > 0
+                ? chalk_1.default.green(offsetStr.padStart(6))
+                : e.diff < 0
+                    ? chalk_1.default.red(offsetStr.padStart(6))
+                    : chalk_1.default.yellow(offsetStr.padStart(6));
+            const icon = getDayNightIcon(e.hour);
+            // Highlight requested cities
+            const rawCity = (e.flag + " " + e.city).padEnd(22);
+            const cityDisplay = e.isRequested ? chalk_1.default.cyan.bold(rawCity) : rawCity;
+            console.log(`    ${cityDisplay} ${chalk_1.default.white.bold(e.time.padEnd(9))} ${dim(e.date.padEnd(14))} ${icon}  ${offsetColored}`);
+        }
+    };
+    printGroup("▲  Ahead of you", chalk_1.default.green.bold, ahead);
+    printGroup("●  Same time", chalk_1.default.yellow.bold, same);
+    printGroup("▼  Behind you", chalk_1.default.red.bold, behind);
+    console.log("");
+    console.log(divider);
+    console.log(dim(`  Timezone: ${localTz}`));
+    if (unknownPlaces.length > 0) {
+        console.log("");
+        for (const p of unknownPlaces) {
+            console.log(chalk_1.default.yellow(`  ⚠  Unknown place: "${p}". Try a major city name.`));
+        }
+    }
+    console.log("");
+}

package/dist/commands/game.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGame = runGame;
+const chalk_1 = __importDefault(require("chalk"));
+const tetris_1 = require("../games/tetris");
+const invaders_1 = require("../games/invaders");
+const GAMES = {
+    tetris: { name: "Bastard Tetris", desc: "Tetris that always gives you the worst piece", play: tetris_1.playTetris },
+    invaders: { name: "nInvaders", desc: "Space Invaders clone in the terminal", play: invaders_1.playInvaders },
+};
+function showGameList() {
+    const cmd = chalk_1.default.cyan.bold;
+    const dim = chalk_1.default.dim;
+    console.log("");
+    console.log(chalk_1.default.white.bold("  Available Games:"));
+    console.log("");
+    console.log(`    ${cmd("game tetris")}                Bastard Tetris ${dim("— always the worst piece")}`);
+    console.log(`    ${cmd("game invaders")}              nInvaders ${dim("— Space Invaders clone")}`);
+    console.log("");
+}
+async function runGame(rl, gameName) {
+    if (!gameName || !GAMES[gameName]) {
+        showGameList();
+        return;
+    }
+    await GAMES[gameName].play(rl);
+}