@cacinie/cace-timer 1.3.2 → 1.4.2

package/dist/mascot.js

@@ -4,217 +4,21 @@ exports.CACE_CELEBRATING = exports.CACE_FOCUSED = exports.CACE_SLEEPY = exports.
 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 terminal_1 = require("./terminal");
+const frames_1 = require("./mascot/frames");
 const MOOD_MAP = {
-    normal: exports.CACE_SMALL,
-    happy: exports.CACE_HAPPY,
-    sleepy: exports.CACE_SLEEPY,
-    focused: exports.CACE_FOCUSED,
-    celebrating: exports.CACE_CELEBRATING,
+    normal: 'little_smile',
+    happy: 'happy',
+    sleepy: 'asleep',
+    focused: 'little_smile',
+    celebrating: 'excited',
 };
+exports.CACE_SMALL = (0, frames_1.plainFrame)((0, frames_1.getFrame)({ size: 'compact' }));
+exports.CACE_HAPPY = (0, frames_1.plainFrame)((0, frames_1.getFrame)({ expression: 'happy' }));
+exports.CACE_SLEEPY = (0, frames_1.plainFrame)((0, frames_1.getFrame)({ expression: 'asleep' }));
+exports.CACE_FOCUSED = (0, frames_1.plainFrame)((0, frames_1.getFrame)());
+exports.CACE_CELEBRATING = (0, frames_1.plainFrame)((0, frames_1.getFrame)({ expression: 'excited' }));
 function getGreeting() {
     const hour = new Date().getHours();
     if (hour < 6)
@@ -225,33 +29,18 @@ function getGreeting() {
         return (0, i18n_1.t)('greeting.afternoon');
     return (0, i18n_1.t)('greeting.evening');
 }
+// One-shot commands return promptly. Continuous motion belongs to a TUI screen
+// with a lifecycle, not a clear/sleep loop inside task mutations.
 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);
-        }
-    }
+    showCaceSmall(message);
 }
 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);
-    }
+    const display = (0, terminal_1.getDisplay)();
+    const columns = process.stdout.columns ?? 80;
+    const size = columns >= 22 && (process.stdout.rows ?? 24) >= 18 ? 'compact' : 'tiny';
+    const frame = (0, frames_1.getFrame)({ expression: MOOD_MAP[mood], size, ascii: display.ascii });
+    if (columns >= frame.width)
+        console.log((0, frames_1.renderFrame)(frame, display));
+    if (status)
+        console.log((0, terminal_1.fitText)(status, columns));
 }

package/dist/parser.js

@@ -1,6 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseArgs = parseArgs;
+const BOOLEAN_OPTIONS = new Set([
+    'no-animation',
+    'no-tui',
+    'ascii',
+    'all',
+    'animate',
+    'today',
+    'week',
+    'month',
+    'last',
+]);
 function parseArgs(args) {
     const result = {
         command: '',
@@ -13,7 +24,7 @@ function parseArgs(args) {
         if (arg.startsWith('--')) {
             const key = arg.slice(2);
             const nextArg = args[i + 1];
-            if (nextArg && !nextArg.startsWith('-')) {
+            if (!BOOLEAN_OPTIONS.has(key) && nextArg && !nextArg.startsWith('-')) {
                 // Support repeated flags: accumulate into array
                 const existing = result.options[key];
                 if (Array.isArray(existing)) {

package/dist/terminal.d.ts

@@ -0,0 +1,15 @@
+export type ColorMode = 'auto' | 'always' | '256' | 'never';
+export interface DisplayOptions {
+    animation: boolean;
+    tui: boolean;
+    ascii: boolean;
+    color: ColorMode;
+    theme: 'dark' | 'light';
+}
+export declare function configureDisplay(options: Partial<DisplayOptions>): void;
+export declare function getDisplay(): Readonly<DisplayOptions>;
+export declare function resolveColor(mode?: ColorMode, isTTY?: boolean, env?: NodeJS.ProcessEnv): Exclude<ColorMode, 'auto'>;
+export declare function cellWidth(text: string): number;
+export declare function safeText(text: string): string;
+export declare function fitText(text: string, columns: number): string;
+export declare function paint(text: string, color: 'cyan' | 'yellow' | 'red' | 'green'): string;

package/dist/terminal.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureDisplay = configureDisplay;
+exports.getDisplay = getDisplay;
+exports.resolveColor = resolveColor;
+exports.cellWidth = cellWidth;
+exports.safeText = safeText;
+exports.fitText = fitText;
+exports.paint = paint;
+const blessed_1 = __importDefault(require("blessed"));
+const node_util_1 = require("node:util");
+let display = {
+    animation: true,
+    tui: true,
+    ascii: false,
+    color: 'auto',
+    theme: 'dark',
+};
+function configureDisplay(options) {
+    display = { ...display, ...options };
+}
+function getDisplay() {
+    return display;
+}
+function resolveColor(mode = display.color, isTTY = process.stdout.isTTY === true, env = process.env) {
+    if (mode !== 'auto')
+        return mode;
+    if (!isTTY || env.TERM === 'dumb' || env.NO_COLOR !== undefined)
+        return 'never';
+    return /^(truecolor|24bit)$/.test(env.COLORTERM ?? '') ? 'always' : '256';
+}
+// Use the same width table as the terminal renderer, including ambiguous-width
+// policy (NCURSES_CJK_WIDTH), rather than JavaScript UTF-16 string lengths.
+const unicode = blessed_1.default.unicode;
+function cellWidth(text) {
+    return unicode.strWidth(text);
+}
+function safeText(text) {
+    return (0, node_util_1.stripVTControlCharacters)(text).replace(/[\p{Cc}\p{Cf}]/gu, ' ');
+}
+function fitText(text, columns) {
+    const clean = safeText(text);
+    const width = Math.max(0, Math.floor(columns));
+    if (cellWidth(clean) <= width)
+        return clean;
+    if (!width)
+        return '';
+    let result = '';
+    let used = 0;
+    for (const char of clean) {
+        const size = unicode.charWidth(char.codePointAt(0));
+        if (used + size > width - 1)
+            break;
+        result += char;
+        used += size;
+    }
+    return result + '~';
+}
+function paint(text, color) {
+    const clean = safeText(text);
+    if (resolveColor() === 'never')
+        return clean;
+    const codes = { cyan: 36, yellow: 33, red: 31, green: 32 };
+    return `\x1b[${codes[color]}m${clean}\x1b[0m`;
+}

package/dist/tui/animation.d.ts

@@ -0,0 +1,5 @@
+export interface RefreshLoop {
+    refresh(): void;
+    dispose(): void;
+}
+export declare function startRefreshLoop(render: (elapsedMs: number) => void, onError: (error: unknown) => void, intervalMs?: number, now?: () => number): RefreshLoop;

package/dist/tui/animation.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startRefreshLoop = startRefreshLoop;
+// A single owned timer per screen. The caller only writes changed content;
+// this clock never changes task data or signals business completion.
+function startRefreshLoop(render, onError, intervalMs = 100, now = () => performance.now()) {
+    const startedAt = now();
+    let disposed = false;
+    const dispose = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        clearInterval(timer);
+    };
+    const refresh = () => {
+        if (disposed)
+            return;
+        try {
+            render(Math.max(0, now() - startedAt));
+        }
+        catch (error) {
+            dispose();
+            onError(error);
+        }
+    };
+    const timer = setInterval(refresh, intervalMs);
+    refresh();
+    return { refresh, dispose };
+}

package/dist/tui/countdown.d.ts

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

package/dist/tui/countdown.js

@@ -5,131 +5,62 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showCountdown = showCountdown;
 const blessed_1 = __importDefault(require("blessed"));
+const i18n_1 = require("../i18n");
+const terminal_1 = require("../terminal");
 const lifecycle_1 = require("./lifecycle");
+const animation_1 = require("./animation");
+const surface_1 = require("./surface");
+// Resolve false on cancellation; reject on render failure. Neither path is a
+// completed timer, so callers must not archive a successful work session.
 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
+    return new Promise((resolve, reject) => {
+        const screen = blessed_1.default.screen({ smartCSR: true, title: 'CACE TIMER', fullUnicode: true });
+        const surface = (0, surface_1.createSurface)(screen);
+        let loop = undefined;
+        let settled = false;
+        const disposeSignals = (0, lifecycle_1.installSignalCleanup)(screen);
+        screen.once('destroy', () => {
+            loop?.dispose();
+            disposeSignals();
+        });
+        const finish = (completed, error) => {
+            if (settled)
+                return;
+            settled = true;
+            loop?.dispose();
             (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');
+            if (error !== undefined)
+                reject(error);
+            else
+                resolve(completed);
+        };
+        screen.key(['escape', 'q'], () => finish(false));
+        screen.key(['C-c'], () => process.emit('SIGINT'));
+        screen.on('resize', () => loop?.refresh());
+        loop = (0, animation_1.startRefreshLoop)((elapsed) => {
+            if (elapsed >= options.totalMs) {
+                finish(true);
+                return;
+            }
+            const remaining = Math.max(0, options.totalMs - elapsed);
+            const totalSeconds = Math.ceil(remaining / 1000);
+            const minutes = Math.floor(totalSeconds / 60);
+            const seconds = totalSeconds % 60;
+            const progress = Math.min(1, elapsed / options.totalMs);
+            const width = Math.max(1, Math.min(28, Number(screen.width) - 8));
+            const filled = Math.floor(width * progress);
+            const bar = '[' + '='.repeat(filled) + '-'.repeat(width - filled) + ']';
+            const lines = [
+                options.label,
+                `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`,
+                `${bar} ${Math.floor(progress * 100)}%`,
+                '',
+                (0, i18n_1.t)('tui.oneThing'),
+            ];
+            surface.render('little_smile', elapsed, lines, (0, i18n_1.t)('tui.cancel'));
+        }, (error) => finish(false, error), (0, terminal_1.getDisplay)().animation ? 100 : 200);
+        // A zero-duration timer can finish during the first synchronous render.
+        if (settled)
+            loop.dispose();
     });
-    screen.render();
 }