@cacinie/cace-timer 1.3.2 → 1.4.2

package/dist/tui/dashboard.js

@@ -6,130 +6,84 @@ 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 terminal_1 = require("../terminal");
 const lifecycle_1 = require("./lifecycle");
+const animation_1 = require("./animation");
+const surface_1 = require("./surface");
 function showDashboard() {
-    return new Promise(resolve => {
+    return new Promise((resolve, reject) => {
         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) })}`,
+        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();
         });
-        // 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
+        const finish = (action) => {
+            if (settled)
+                return;
+            settled = true;
+            loop?.dispose();
+            (0, lifecycle_1.destroyScreen)(screen);
+            resolve(action);
+        };
+        const fail = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            loop?.dispose();
+            (0, lifecycle_1.destroyScreen)(screen);
+            reject(error);
+        };
+        const menu = data.current
             ? [
-                { 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: 'm', label: (0, i18n_1.t)('cmd.mark.markPoint'), action: 'mark' },
+                { key: 's', label: (0, i18n_1.t)('cmd.help.stopDesc'), action: 'stop' },
             ]
             : [
-                { 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' },
+                { key: 's', label: (0, i18n_1.t)('cmd.help.startDesc'), action: 'start' },
+                { key: 'f', label: (0, i18n_1.t)('cmd.help.focusDesc'), action: 'focus' },
             ];
-        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,
+        menu.push({ 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' });
+        screen.key(menu.map((item) => item.key), (key) => {
+            const item = menu.find((item) => item.key === key);
+            if (item)
+                finish(item.action);
         });
-        // 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();
+        screen.key(['escape', 'q'], () => finish('quit'));
+        screen.key(['C-c'], () => process.emit('SIGINT'));
+        screen.on('resize', () => loop?.refresh());
+        const today = (0, data_1.getTodayStr)();
+        let streak = data.streak || 0;
+        if (data.lastActiveDate && Date.parse(today) - Date.parse(data.lastActiveDate) > 86400000)
+            streak = 0;
+        loop = (0, animation_1.startRefreshLoop)((elapsedMs) => {
+            const task = data.current;
+            const primary = task
+                ? [
+                    `${(0, i18n_1.t)('common.task')}: ${task.task}`,
+                    `${(0, i18n_1.t)('cmd.mark.elapsed')}: ${(0, utils_1.formatDuration)(Date.now() - Date.parse(task.start))}`,
+                ]
+                : [(0, i18n_1.t)('tui.ready')];
+            const menuLines = menu.map((item) => `[${item.key}] ${item.label}`);
+            const height = Number(screen.height);
+            const lines = height < 12
+                ? [...primary, ...menuLines]
+                : [
+                    'C A C E  /  T I M E R',
+                    '',
+                    ...primary,
+                    '',
+                    ...menuLines,
+                    '',
+                    `Lv.${(0, data_1.scoreToLevel)(data.score || 0)}  |  ${data.score || 0} pts  |  ${(0, i18n_1.t)('tui.streak', { days: String(streak) })}`,
+                ];
+            surface.render('little_smile', elapsedMs, lines, (0, i18n_1.t)('tui.quit'));
+        }, fail, (0, terminal_1.getDisplay)().animation ? 100 : 1000);
     });
 }

package/dist/tui/index.js

@@ -1,8 +1,11 @@
 "use strict";
-// ============ TUI Helpers ============
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isInteractiveTerminal = isInteractiveTerminal;
+const terminal_1 = require("../terminal");
 /** Check if current terminal supports interactive TUI */
 function isInteractiveTerminal() {
-    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+    return ((0, terminal_1.getDisplay)().tui &&
+        process.env.TERM !== 'dumb' &&
+        process.stdin.isTTY === true &&
+        process.stdout.isTTY === true);
 }

package/dist/tui/layout.d.ts

@@ -0,0 +1,15 @@
+import { MascotSize } from '../mascot/assets/mint';
+export interface Rect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export interface Layout {
+    mascot?: Rect & {
+        size: MascotSize;
+    };
+    body: Rect;
+    footer: Rect;
+}
+export declare function calculateLayout(columns: number, rows: number, bodyRows: number): Layout;

package/dist/tui/layout.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateLayout = calculateLayout;
+const frames_1 = require("../mascot/frames");
+function calculateLayout(columns, rows, bodyRows) {
+    const width = Math.max(1, Math.floor(columns));
+    const height = Math.max(1, Math.floor(rows));
+    const usableHeight = Math.max(0, height - 1);
+    const footer = { top: height - 1, left: 0, width, height: 1 };
+    const full = (0, frames_1.getFrame)();
+    if (width >= full.width + 42 && usableHeight >= Math.max(full.height, bodyRows)) {
+        return {
+            mascot: { size: 'full', top: 0, left: 0, width: full.width, height: full.height },
+            body: { top: 0, left: full.width + 3, width: width - full.width - 3, height: usableHeight },
+            footer,
+        };
+    }
+    for (const size of ['full', 'compact', 'tiny']) {
+        const frame = (0, frames_1.getFrame)({ size });
+        if (frame.width <= width && frame.height + 1 + bodyRows <= usableHeight) {
+            const top = frame.height + 1;
+            return {
+                mascot: {
+                    size,
+                    top: 0,
+                    left: Math.floor((width - frame.width) / 2),
+                    width: frame.width,
+                    height: frame.height,
+                },
+                body: { top, left: 0, width, height: usableHeight - top },
+                footer,
+            };
+        }
+    }
+    return { body: { top: 0, left: 0, width, height: usableHeight }, footer };
+}

package/dist/tui/reflection.js

@@ -7,13 +7,16 @@ exports.showReflectionInput = showReflectionInput;
 const blessed_1 = __importDefault(require("blessed"));
 const i18n_1 = require("../i18n");
 const lifecycle_1 = require("./lifecycle");
+const terminal_1 = require("../terminal");
 function showReflectionInput() {
-    return new Promise(resolve => {
+    return new Promise((resolve) => {
         const screen = blessed_1.default.screen({
             smartCSR: true,
             title: 'CACE TIMER',
             fullUnicode: true,
         });
+        const disposeSignals = (0, lifecycle_1.installSignalCleanup)(screen);
+        screen.once('destroy', disposeSignals);
         // Title
         blessed_1.default.box({
             parent: screen,
@@ -54,7 +57,7 @@ function showReflectionInput() {
         });
         input.focus();
         input.key('enter', () => {
-            const text = input.getValue().trim();
+            const text = (0, terminal_1.safeText)(input.getValue()).trim();
             (0, lifecycle_1.destroyScreen)(screen);
             resolve({ text });
         });
@@ -63,8 +66,7 @@ function showReflectionInput() {
             resolve({ text: '' });
         });
         screen.key(['C-c'], () => {
-            (0, lifecycle_1.destroyScreen)(screen);
-            resolve({ text: '' });
+            process.emit('SIGINT');
         });
         screen.render();
     });

package/dist/tui/surface.d.ts

@@ -0,0 +1,5 @@
+import blessed from 'blessed';
+import { Expression } from '../mascot/assets/mint';
+export declare function createSurface(screen: blessed.Widgets.Screen): {
+    render(expression: Expression, elapsedMs: number, lines: string[], footer: string, bodyRows?: number): void;
+};

package/dist/tui/surface.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSurface = createSurface;
+const blessed_1 = __importDefault(require("blessed"));
+const frames_1 = require("../mascot/frames");
+const terminal_1 = require("../terminal");
+const layout_1 = require("./layout");
+// Artwork is tagged, user text is not. This prevents task names such as
+// "{red-bg}" from being interpreted as blessed markup.
+function createSurface(screen) {
+    const mascot = blessed_1.default.box({ parent: screen, tags: true, wrap: false, align: 'left' });
+    const body = blessed_1.default.box({ parent: screen, tags: false, wrap: false, align: 'left' });
+    const hint = blessed_1.default.box({ parent: screen, tags: false, wrap: false });
+    let previous = '';
+    return {
+        render(expression, elapsedMs, lines, footer, bodyRows = lines.length) {
+            const columns = Number(screen.width);
+            const rows = Number(screen.height);
+            const layout = (0, layout_1.calculateLayout)(columns, rows, bodyRows);
+            const display = (0, terminal_1.getDisplay)();
+            const plain = (0, terminal_1.resolveColor)() === 'never';
+            body.style.fg = plain ? 'default' : display.theme === 'light' ? '#526764' : '#d5e7e3';
+            hint.style.fg = plain ? 'default' : display.theme === 'light' ? '#687776' : '#82989e';
+            const frame = layout.mascot
+                ? (0, frames_1.getFrame)({
+                    expression,
+                    size: layout.mascot.size,
+                    elapsedMs,
+                    motion: display.animation,
+                    ascii: display.ascii,
+                })
+                : undefined;
+            const picture = frame ? (0, frames_1.renderFrame)(frame, { ...display, format: 'blessed' }) : '';
+            const content = lines
+                .slice(0, layout.body.height)
+                .map((line) => (0, terminal_1.fitText)(line, layout.body.width))
+                .join('\n');
+            const footerText = (0, terminal_1.fitText)(footer, columns);
+            const signature = JSON.stringify([columns, rows, layout, picture, content, footerText]);
+            if (signature === previous)
+                return;
+            previous = signature;
+            if (layout.mascot) {
+                Object.assign(mascot, layout.mascot);
+                mascot.show();
+                mascot.setContent(picture);
+            }
+            else
+                mascot.hide();
+            Object.assign(body, layout.body);
+            if (layout.body.height)
+                body.show();
+            else
+                body.hide();
+            body.setContent(content);
+            Object.assign(hint, layout.footer);
+            hint.setContent(footerText);
+            screen.render();
+        },
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cacinie/cace-timer",
-  "version": "1.3.2",
-  "description": "A minimal time tracking CLI with cute anime girl mascot",
+  "version": "1.4.2",
+  "description": "Local-first time tracking CLI with a responsive MINT character dashboard",
   "main": "dist/index.js",
   "bin": {
     "tk": "dist/index.js",
@@ -16,7 +16,9 @@
     "lint": "eslint src/",
     "format": "prettier --write src/",
     "prepublishOnly": "npm run build",
-    "prepare": "npm run build"
+    "prepare": "npm run build",
+    "test:cli": "npm run build && node --test scripts/cli-smoke.cjs",
+    "test:pty": "npm run build && python3 scripts/pty-smoke.py"
   },
   "files": [
     "dist",