@cacinie/cace-timer 1.1.1 → 1.3.2

package/dist/mascot.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CACE_CELEBRATING = exports.CACE_FOCUSED = exports.CACE_SLEEPY = exports.CACE_HAPPY = exports.CACE_SMALL = void 0;
+exports.getGreeting = getGreeting;
+exports.showCaceAnimation = showCaceAnimation;
+exports.showCaceSmall = showCaceSmall;
+const utils_1 = require("./utils");
+const i18n_1 = require("./i18n");
+// ============ CACE TIMER Mascot ============
+// 可爱短发小女孩 — 完整身体设计
+// 人设参考: 语码 Cace — 译者 + Vibe Coder + 电音/VOCALOID 宅
+// 特征: 呆毛 + 齐耳 Bob 短发 + 尖下巴 + A 字裙(CACE 绣在裙面)
+// 动画帧用于开场动画，各 mood 用于内联显示
+// 对齐约定: 中心线在 13/14 列之间,所有 ┬┴┘└ 连接点逐列对齐
+const CACE_FRAMES = [
+    // Frame 1: 正常站立
+    `
+     ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ●    ●    │
+      │      ▽       │
+      │     ───      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+           │    │
+           │    │
+           │    │
+          ╭┴╮  ╭┴╮
+          ╰─╯  ╰─╯`,
+    // Frame 2: 眨眼
+    `
+     ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ─    ─    │
+      │      ▽       │
+      │     ───      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+           │    │
+           │    │
+           │    │
+          ╭┴╮  ╭┴╮
+          ╰─╯  ╰─╯`,
+    // Frame 3: 微笑蹦跳
+    `
+     ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ★    ★    │
+      │      ▽       │
+      │     ◡◡◡      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+       ╭───┘    └───╮
+       │            │
+       │            │
+      ╭┴╮          ╭┴╮
+      ╰─╯          ╰─╯`,
+    // Frame 4: 超开心 + 举手
+    `
+  ♪  ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ◉    ◉    │
+      │      ▽       │
+      │     ▽△▽      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+       ╭───┘    └───╮
+       │            │
+       │            │
+      ╭┴╮          ╭┴╮
+      ╰─╯          ╰─╯`,
+];
+// --- Inline mascot variants ---
+exports.CACE_SMALL = `
+     ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ●    ●    │
+      │      ▽       │
+      │     ───      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+           │    │
+           │    │
+           │    │
+          ╭┴╮  ╭┴╮
+          ╰─╯  ╰─╯`;
+exports.CACE_HAPPY = `
+     ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ★    ★    │
+      │      ▽       │
+      │     ◡◡◡      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+       ╭───┘    └───╮
+       │            │
+       │            │
+      ╭┴╮          ╭┴╮
+      ╰─╯          ╰─╯`;
+exports.CACE_SLEEPY = `
+     ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ─    ─    │
+      │      ▽       │
+      │      ～～      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+           │    │
+           │    │
+           │    │
+          ╭┴╮  ╭┴╮
+          ╰─╯  ╰─╯`;
+exports.CACE_FOCUSED = `
+     ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ◆    ◆    │
+      │      ▽       │
+      │     ▬▬▬      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+           │    │
+           │    │
+           │    │
+          ╭┴╮  ╭┴╮
+          ╰─╯  ╰─╯`;
+exports.CACE_CELEBRATING = `
+  ♪  ╭─╮            ╭─╮
+     ╰─╯            ╰─╯
+       ╭────────────╮
+      ╭┴────────────┴╮
+      │   ╭╮╭╮╭╮╭╮   │
+      │    ◉    ◉    │
+      │      ▽       │
+      │     ▽△▽      │
+      ╰──────┬┬──────╯
+             ││
+       ╭─────┴┴─────╮
+      ╭╯  ╔══════╗  ╰╮
+     o│   ║ CACE ║   │o
+      │   ╚══════╝   │
+      ╰────┬────┬────╯
+       ╭───┘    └───╮
+       │            │
+       │            │
+      ╭┴╮          ╭┴╮
+      ╰─╯          ╰─╯`;
+const MOOD_MAP = {
+    normal: exports.CACE_SMALL,
+    happy: exports.CACE_HAPPY,
+    sleepy: exports.CACE_SLEEPY,
+    focused: exports.CACE_FOCUSED,
+    celebrating: exports.CACE_CELEBRATING,
+};
+function getGreeting() {
+    const hour = new Date().getHours();
+    if (hour < 6)
+        return (0, i18n_1.t)('greeting.lateNight');
+    if (hour < 12)
+        return (0, i18n_1.t)('greeting.morning');
+    if (hour < 18)
+        return (0, i18n_1.t)('greeting.afternoon');
+    return (0, i18n_1.t)('greeting.evening');
+}
+async function showCaceAnimation(message = '') {
+    const cyan = '\x1b[36m';
+    const bold = '\x1b[1m';
+    const reset = '\x1b[0m';
+    // Animation: 3 cycles through frames for a smooth intro
+    for (let i = 0; i < 3; i++) {
+        for (const frame of CACE_FRAMES) {
+            console.clear();
+            console.log(cyan + frame + reset);
+            console.log();
+            console.log(cyan + bold + '  ═══════════════════════════════════' + reset);
+            console.log(cyan + bold + '        C A C E   T I M E R' + reset);
+            console.log(cyan + bold + '  ═══════════════════════════════════' + reset);
+            if (message) {
+                console.log();
+                console.log('  ' + message);
+            }
+            await (0, utils_1.sleep)(200);
+        }
+    }
+}
+function showCaceSmall(status = '', mood = 'normal') {
+    const cyan = '\x1b[36m';
+    const reset = '\x1b[0m';
+    const face = MOOD_MAP[mood] || exports.CACE_SMALL;
+    console.log(cyan + face + reset);
+    if (status) {
+        console.log(cyan + '  ' + status + reset);
+    }
+}

package/dist/parser.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedArgs {
+    command: string;
+    positional: string[];
+    options: Record<string, string | boolean | string[]>;
+}
+export declare function parseArgs(args: string[]): ParsedArgs;

package/dist/parser.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+function parseArgs(args) {
+    const result = {
+        command: '',
+        positional: [],
+        options: {},
+    };
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const nextArg = args[i + 1];
+            if (nextArg && !nextArg.startsWith('-')) {
+                // Support repeated flags: accumulate into array
+                const existing = result.options[key];
+                if (Array.isArray(existing)) {
+                    existing.push(nextArg);
+                }
+                else if (typeof existing === 'string') {
+                    result.options[key] = [existing, nextArg];
+                }
+                else {
+                    result.options[key] = nextArg;
+                }
+                i += 2;
+            }
+            else {
+                result.options[key] = true;
+                i++;
+            }
+        }
+        else if (!result.command) {
+            result.command = arg;
+            i++;
+        }
+        else {
+            result.positional.push(arg);
+            i++;
+        }
+    }
+    return result;
+}

package/dist/tui/countdown.d.ts

@@ -0,0 +1,8 @@
+interface CountdownOptions {
+    totalMs: number;
+    label: string;
+    mascots: string[];
+    onDone: () => void;
+}
+export declare function showCountdown(options: CountdownOptions): void;
+export {};

package/dist/tui/countdown.js

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showCountdown = showCountdown;
+const blessed_1 = __importDefault(require("blessed"));
+const lifecycle_1 = require("./lifecycle");
+function showCountdown(options) {
+    const screen = blessed_1.default.screen({
+        smartCSR: true,
+        title: 'CACE TIMER',
+        fullUnicode: true,
+    });
+    // Mascot display
+    const mascotBox = blessed_1.default.box({
+        parent: screen,
+        top: 0,
+        left: 'center',
+        width: '100%',
+        height: 16,
+        align: 'center',
+        valign: 'middle',
+        style: { fg: 'cyan' },
+    });
+    // Label (round info) — rendered as static content, no box ref needed
+    blessed_1.default.box({
+        parent: screen,
+        top: 16,
+        left: 'center',
+        width: '100%',
+        height: 1,
+        align: 'center',
+        style: { fg: 'white', bold: true },
+        content: options.label,
+    });
+    // Timer display
+    const timerBox = blessed_1.default.box({
+        parent: screen,
+        top: 18,
+        left: 'center',
+        width: '100%',
+        height: 3,
+        align: 'center',
+        valign: 'middle',
+        style: { fg: 'cyan', bold: true },
+    });
+    // Progress bar container
+    const progressLabel = blessed_1.default.box({
+        parent: screen,
+        top: 22,
+        left: 'center',
+        width: '100%',
+        height: 1,
+        align: 'center',
+        style: { fg: 'white' },
+    });
+    // Controls hint
+    blessed_1.default.box({
+        parent: screen,
+        bottom: 0,
+        left: 'center',
+        width: '100%',
+        height: 1,
+        align: 'center',
+        style: { fg: 'gray' },
+        content: 'Ctrl+C to stop',
+    });
+    // Draw mascot
+    if (options.mascots.length > 0) {
+        mascotBox.setContent(options.mascots[0]);
+    }
+    const startTime = Date.now();
+    const barWidth = 30;
+    // Clean up signal handlers when this screen closes normally.
+    const disposeSignalCleanup = (0, lifecycle_1.installSignalCleanup)(screen);
+    // Update timer every 500ms
+    const interval = setInterval(() => {
+        let elapsed = 0;
+        let remaining = 0;
+        try {
+            elapsed = Date.now() - startTime;
+            remaining = Math.max(0, options.totalMs - elapsed);
+            const progress = Math.min(1, elapsed / options.totalMs);
+            // Format time
+            const totalSec = Math.floor(remaining / 1000);
+            const min = Math.floor(totalSec / 60);
+            const sec = totalSec % 60;
+            const timeStr = `${min.toString().padStart(2, '0')}:${sec.toString().padStart(2, '0')}`;
+            // Progress bar
+            const filled = Math.floor(progress * barWidth);
+            const bar = '█'.repeat(filled) + '░'.repeat(barWidth - filled);
+            const pct = Math.floor(progress * 100);
+            timerBox.setContent(`  ${timeStr}  `);
+            progressLabel.setContent(`[${bar}] ${pct}%`);
+            // Rotate mascot expression
+            if (options.mascots.length > 1) {
+                const idx = Math.floor(progress * options.mascots.length) % options.mascots.length;
+                mascotBox.setContent(options.mascots[idx]);
+            }
+            screen.render();
+        }
+        catch (err) {
+            // Render or content error — don't leave the screen half-updated.
+            // Tear down with cleanup, then surface the error to the caller.
+            clearInterval(interval);
+            disposeSignalCleanup();
+            (0, lifecycle_1.destroyScreen)(screen);
+            options.onDone();
+            // Re-throw asynchronously so Node reports it instead of swallowing it.
+            setImmediate(() => {
+                throw err;
+            });
+            return;
+        }
+        if (elapsed >= options.totalMs) {
+            clearInterval(interval);
+            disposeSignalCleanup();
+            process.stdout.write('\x07'); // bell
+            (0, lifecycle_1.destroyScreen)(screen);
+            options.onDone();
+        }
+    }, 500);
+    // Don't keep the event loop alive just for the timer.
+    if (typeof interval.unref === 'function')
+        interval.unref();
+    // Handle Ctrl+C — exit code 130, blessed cleanup included.
+    screen.key(['C-c'], () => {
+        clearInterval(interval);
+        process.stdout.write('\n');
+        (0, lifecycle_1.destroyScreen)(screen);
+        process.kill(process.pid, 'SIGINT');
+    });
+    screen.render();
+}

package/dist/tui/dashboard.d.ts

@@ -0,0 +1,2 @@
+export type DashboardAction = 'start' | 'focus' | 'mark' | 'stop' | 'summary' | 'list' | 'help' | 'quit';
+export declare function showDashboard(): Promise<DashboardAction>;

package/dist/tui/dashboard.js

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showDashboard = showDashboard;
+const blessed_1 = __importDefault(require("blessed"));
+const data_1 = require("../data");
+const mascot_1 = require("../mascot");
+const utils_1 = require("../utils");
+const i18n_1 = require("../i18n");
+const lifecycle_1 = require("./lifecycle");
+function showDashboard() {
+    return new Promise(resolve => {
+        const data = (0, data_1.loadData)();
+        // Refresh streak display (don't mutate saved data here)
+        let displayStreak = data.streak || 0;
+        const today = (0, data_1.getTodayStr)();
+        if (data.lastActiveDate && data.lastActiveDate !== today) {
+            const last = new Date(data.lastActiveDate);
+            const now = new Date(today);
+            const diff = Math.floor((now.getTime() - last.getTime()) / 86400000);
+            if (diff > 1)
+                displayStreak = 0;
+        }
+        const level = (0, data_1.scoreToLevel)(data.score || 0);
+        const prog = (0, data_1.pointsToNextLevel)(data.score || 0);
+        const screen = blessed_1.default.screen({
+            smartCSR: true,
+            title: 'CACE TIMER',
+            fullUnicode: true,
+        });
+        // Mascot
+        const mascotContent = data.current ? mascot_1.CACE_FOCUSED : mascot_1.CACE_SLEEPY;
+        blessed_1.default.box({
+            parent: screen,
+            top: 0,
+            left: 'center',
+            width: 46,
+            height: 13,
+            align: 'center',
+            valign: 'top',
+            style: { fg: 'cyan' },
+            content: mascotContent,
+        });
+        // Level / Score / Streak bar
+        const streakStr = displayStreak > 1
+            ? (0, i18n_1.t)('score.streakFire', { days: String(displayStreak) })
+            : displayStreak === 1
+                ? (0, i18n_1.t)('score.newStreak')
+                : (0, i18n_1.t)('cmd.status.noStreak');
+        const progFilled = Math.min(20, Math.round((prog.current / Math.max(1, prog.needed)) * 20));
+        const progressBar = '█'.repeat(progFilled) + '░'.repeat(20 - progFilled);
+        blessed_1.default.box({
+            parent: screen,
+            top: 13,
+            left: 'center',
+            width: '100%',
+            height: 3,
+            align: 'center',
+            style: { fg: 'yellow', bold: true },
+            content: ` ${(0, i18n_1.t)('cmd.status.level', { level: String(level), score: String(data.score || 0) })}  |  ${streakStr}\n ${progressBar} ${(0, i18n_1.t)('score.progress', { current: String(prog.current), needed: String(prog.needed) })}`,
+        });
+        // Active task panel
+        const hasActive = !!data.current;
+        const menuTop = hasActive ? 18 : 17;
+        if (hasActive && data.current) {
+            const elapsed = Date.now() - new Date(data.current.start).getTime();
+            const taskInfo = data.current;
+            blessed_1.default.box({
+                parent: screen,
+                top: 16,
+                left: '10%',
+                width: '80%',
+                height: 2,
+                align: 'center',
+                border: { type: 'line' },
+                style: { fg: 'green', border: { fg: 'green' } },
+                content: ` ${(0, i18n_1.t)('cmd.status.inProgress')}: ${taskInfo.task} | ${(0, i18n_1.t)('cmd.mark.elapsed')}: ${(0, utils_1.formatDuration)(elapsed)}`,
+            });
+        }
+        // Menu items - context-dependent
+        const menuItems = hasActive
+            ? [
+                { key: 'm', label: `📍 ${(0, i18n_1.t)('cmd.mark.markPoint')}`, action: 'mark' },
+                { key: 's', label: `⏹  ${(0, i18n_1.t)('cmd.help.stopDesc')}`, action: 'stop' },
+                { key: 'b', label: `📊 ${(0, i18n_1.t)('cmd.help.summaryDesc')}`, action: 'summary' },
+                { key: 'l', label: `📋 ${(0, i18n_1.t)('cmd.help.listDesc')}`, action: 'list' },
+                { key: '?', label: `❓ ${(0, i18n_1.t)('cmd.help.helpDesc')}`, action: 'help' },
+            ]
+            : [
+                { key: 's', label: `🚀 ${(0, i18n_1.t)('cmd.help.startDesc')}`, action: 'start' },
+                { key: 'f', label: `🍅 ${(0, i18n_1.t)('cmd.help.focusDesc')}`, action: 'focus' },
+                { key: 'b', label: `📊 ${(0, i18n_1.t)('cmd.help.summaryDesc')}`, action: 'summary' },
+                { key: 'l', label: `📋 ${(0, i18n_1.t)('cmd.help.listDesc')}`, action: 'list' },
+                { key: '?', label: `❓ ${(0, i18n_1.t)('cmd.help.helpDesc')}`, action: 'help' },
+            ];
+        const menuContent = menuItems.map(m => `  [${m.key}]  ${m.label}`).join('\n');
+        blessed_1.default.box({
+            parent: screen,
+            top: menuTop,
+            left: 'center',
+            width: '80%',
+            height: menuItems.length + 1,
+            align: 'center',
+            style: { fg: 'white' },
+            content: menuContent,
+        });
+        // Bottom hint
+        blessed_1.default.box({
+            parent: screen,
+            bottom: 0,
+            left: 'center',
+            width: '100%',
+            height: 1,
+            align: 'center',
+            style: { fg: 'gray' },
+            content: 'q/Esc to quit',
+        });
+        // Handle keys
+        const allKeys = menuItems.map(m => m.key);
+        screen.key([...allKeys], (ch) => {
+            const item = menuItems.find(m => m.key === ch);
+            if (item) {
+                (0, lifecycle_1.destroyScreen)(screen);
+                resolve(item.action);
+            }
+        });
+        screen.key(['escape', 'q', 'C-c'], () => {
+            (0, lifecycle_1.destroyScreen)(screen);
+            resolve('quit');
+        });
+        screen.render();
+    });
+}

package/dist/tui/index.d.ts

@@ -0,0 +1,2 @@
+/** Check if current terminal supports interactive TUI */
+export declare function isInteractiveTerminal(): boolean;

package/dist/tui/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// ============ TUI Helpers ============
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInteractiveTerminal = isInteractiveTerminal;
+/** Check if current terminal supports interactive TUI */
+function isInteractiveTerminal() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}

package/dist/tui/lifecycle.d.ts

@@ -0,0 +1,28 @@
+import type blessed from 'blessed';
+type Screen = blessed.Widgets.Screen;
+/**
+ * Single source of truth for tearing down a blessed screen without
+ * leaving the parent TTY in a broken state.
+ *
+ * blessed calls `process.stdin.setRawMode(true)` on entry. Depending on
+ * the blessed version and the exact exit path, `screen.destroy()` does not
+ * always restore the parent TTY — leaving the user's terminal in raw mode
+ * after Ctrl+C / quit. This helper runs the documented cleanup chain
+ * (`screen.destroy` + raw-mode off + cursor reset) so every exit path
+ * (Ctrl+C, q/Esc, timeout, callback throw) behaves the same.
+ *
+ * Every cleanup step is wrapped in try/catch — screen may already be
+ * destroyed (double-fire on race conditions), stdin may not be a TTY,
+ * and `screen.program` may have been torn down by blessed itself.
+ */
+export declare function destroyScreen(screen: Screen): void;
+/**
+ * Install SIGINT/SIGTERM handlers that run the standard blessed cleanup
+ * and then exit with the conventional signal status (130 / 143).
+ *
+ * Returns a `dispose()` function so callers can remove the handlers when
+ * the screen is closed normally. Installing again while a previous
+ * instance is active disposes that instance first (idempotent replace).
+ */
+export declare function installSignalCleanup(screen: Screen): () => void;
+export {};