@cacinie/cace-timer 1.1.1 → 1.3.2

package/dist/tui/lifecycle.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.destroyScreen = destroyScreen;
+exports.installSignalCleanup = installSignalCleanup;
+/**
+ * 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.
+ */
+function destroyScreen(screen) {
+    try {
+        screen.destroy();
+    }
+    catch {
+        // already destroyed — ignore
+    }
+    try {
+        if (process.stdin.isTTY && typeof process.stdin.setRawMode === 'function') {
+            process.stdin.setRawMode(false);
+        }
+    }
+    catch {
+        // stdin not writable / already detached — ignore
+    }
+    // screen.program.showCursor() / normalCursor() exist at runtime but
+    // the @types/blessed type def doesn't include them, so call via
+    // unknown to keep this file portable across blessed versions.
+    const program = screen.program;
+    try {
+        program.showCursor();
+    }
+    catch {
+        // program may be torn down — ignore
+    }
+    try {
+        program.normalCursor?.();
+    }
+    catch {
+        // ditto
+    }
+}
+let activeDispose;
+/**
+ * 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).
+ */
+function installSignalCleanup(screen) {
+    activeDispose?.();
+    const cleanup = (signal) => {
+        dispose();
+        destroyScreen(screen);
+        const code = signal === 'SIGINT' ? 130 : signal === 'SIGTERM' ? 143 : 1;
+        process.exit(code);
+    };
+    const onSigint = () => cleanup('SIGINT');
+    const onSigterm = () => cleanup('SIGTERM');
+    const dispose = () => {
+        process.removeListener('SIGINT', onSigint);
+        process.removeListener('SIGTERM', onSigterm);
+        if (activeDispose === dispose) {
+            activeDispose = undefined;
+        }
+    };
+    process.on('SIGINT', onSigint);
+    process.on('SIGTERM', onSigterm);
+    activeDispose = dispose;
+    return dispose;
+}

package/dist/tui/reflection.d.ts

@@ -0,0 +1,5 @@
+interface ReflectionResult {
+    text: string;
+}
+export declare function showReflectionInput(): Promise<ReflectionResult>;
+export {};

package/dist/tui/reflection.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showReflectionInput = showReflectionInput;
+const blessed_1 = __importDefault(require("blessed"));
+const i18n_1 = require("../i18n");
+const lifecycle_1 = require("./lifecycle");
+function showReflectionInput() {
+    return new Promise(resolve => {
+        const screen = blessed_1.default.screen({
+            smartCSR: true,
+            title: 'CACE TIMER',
+            fullUnicode: true,
+        });
+        // Title
+        blessed_1.default.box({
+            parent: screen,
+            top: 1,
+            left: 'center',
+            width: '100%',
+            height: 1,
+            align: 'center',
+            style: { fg: 'cyan', bold: true },
+            content: (0, i18n_1.t)('cmd.stop.reflection'),
+        });
+        // Text input area
+        const input = blessed_1.default.textarea({
+            parent: screen,
+            top: 3,
+            left: '10%',
+            width: '80%',
+            height: 5,
+            border: { type: 'line' },
+            style: {
+                border: { fg: 'cyan' },
+                fg: 'white',
+                bg: 'black',
+                focus: { border: { fg: 'green' } },
+            },
+            inputOnFocus: true,
+        });
+        // Hint
+        blessed_1.default.box({
+            parent: screen,
+            top: 9,
+            left: 'center',
+            width: '100%',
+            height: 1,
+            align: 'center',
+            style: { fg: 'gray' },
+            content: 'Enter to confirm | Esc to skip',
+        });
+        input.focus();
+        input.key('enter', () => {
+            const text = input.getValue().trim();
+            (0, lifecycle_1.destroyScreen)(screen);
+            resolve({ text });
+        });
+        input.key('escape', () => {
+            (0, lifecycle_1.destroyScreen)(screen);
+            resolve({ text: '' });
+        });
+        screen.key(['C-c'], () => {
+            (0, lifecycle_1.destroyScreen)(screen);
+            resolve({ text: '' });
+        });
+        screen.render();
+    });
+}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+export interface Mark {
+    time: string;
+    note: string;
+}
+export interface Session {
+    id: string;
+    start: string;
+    end?: string;
+    task: string;
+    tags: string[];
+    marks: Mark[];
+    estimatedMinutes?: number;
+    reflection?: string;
+    pointsEarned?: number;
+}
+export interface TimeKeeperData {
+    syncPath?: string;
+    lang?: string;
+    score: number;
+    streak: number;
+    lastActiveDate?: string;
+    current: Session | null;
+    history: Session[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function sleep(ms: number): Promise<void>;
+export declare function generateId(): string;
+export declare function formatDuration(ms: number): string;
+export declare function formatTime(isoString: string): string;
+export declare function formatDate(isoString: string): string;

package/dist/utils.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+exports.generateId = generateId;
+exports.formatDuration = formatDuration;
+exports.formatTime = formatTime;
+exports.formatDate = formatDate;
+// ============ Utilities ============
+const i18n_1 = require("./i18n");
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function generateId() {
+    return Date.now().toString(36) + Math.random().toString(36).substring(2);
+}
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+    }
+    else if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    else {
+        return `${seconds}s`;
+    }
+}
+function formatTime(isoString) {
+    const date = new Date(isoString);
+    const locale = (0, i18n_1.getLocale)() === 'zh' ? 'zh-CN' : 'en-US';
+    return date.toLocaleString(locale, {
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+    });
+}
+function formatDate(isoString) {
+    const date = new Date(isoString);
+    const locale = (0, i18n_1.getLocale)() === 'zh' ? 'zh-CN' : 'en-US';
+    return date.toLocaleDateString(locale);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cacinie/cace-timer",
-  "version": "1.1.1",
+  "version": "1.3.2",
   "description": "A minimal time tracking CLI with cute anime girl mascot",
   "main": "dist/index.js",
   "bin": {
@@ -11,6 +11,10 @@
     "build": "tsc",
     "dev": "ts-node src/index.ts",
     "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "format": "prettier --write src/",
     "prepublishOnly": "npm run build",
     "prepare": "npm run build"
   },
@@ -39,15 +43,27 @@
   },
   "homepage": "https://github.com/CacinieP/cace-timer#readme",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/blessed": "^0.1.27",
     "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.60.0",
+    "@typescript-eslint/parser": "^8.60.0",
+    "eslint": "^10.4.1",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.3",
     "ts-node": "^10.9.2",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^4.1.7"
   },
-  "types": "dist/index.d.ts"
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "blessed": "^0.1.81"
+  }
 }