@timmy6942025/cli-timer 1.1.15 → 1.1.17

package/README.md

@@ -45,6 +45,16 @@ timer 5 min 2 sec
 
 By default, timer and stopwatch output is centered in the terminal.
 
+### Update CLI Timer
+
+To update globally and verify you are on latest:
+
+```bash
+timer update
+```
+
+`timer update` auto-detects whether your current install came from Bun, npm, or pnpm, runs the matching global update command, then checks your installed version against npm `latest`.
+
 ## Controls
 
 - `p` or `Spacebar`: Pause/Resume

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmy6942025/cli-timer",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "description": "Simple customizable terminal timer and stopwatch",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -12,6 +12,7 @@ const SETTINGS_STATE_PATH = path.join(CONFIG_DIR, "settings-state.json");
 const DEFAULT_FONT = "Standard";
 const TIMER_SAMPLE_TEXT = "01:23:45";
 const MIN_FIGLET_WIDTH = 120;
+const PACKAGE_NAME = "@timmy6942025/cli-timer";
 const PRINTABLE_ASCII_CANDIDATES = Object.freeze(
   Array.from({ length: 94 }, (_, index) => String.fromCharCode(33 + index))
 );
@@ -91,6 +92,22 @@ function exitAlternateScreen() {
   process.stdout.write("\x1b[?1049l");
 }
 
+function disableLineWrap() {
+  process.stdout.write("\x1b[?7l");
+}
+
+function enableLineWrap() {
+  process.stdout.write("\x1b[?7h");
+}
+
+function enableMouseCapture() {
+  process.stdout.write("\x1b[?1000h\x1b[?1006h");
+}
+
+function disableMouseCapture() {
+  process.stdout.write("\x1b[?1000l\x1b[?1006l");
+}
+
 function formatHms(totalSeconds) {
   const hours = Math.floor(totalSeconds / 3600);
   const minutes = Math.floor((totalSeconds % 3600) / 60);
@@ -578,6 +595,13 @@ function toDisplayLines(text) {
   return lines.length > 0 ? lines : [""];
 }
 
+function writeFrameLines(lines) {
+  const safeLines = Array.isArray(lines) && lines.length > 0 ? lines : [""];
+  const terminalHeight = process.stdout.rows || safeLines.length;
+  const visibleLines = safeLines.slice(0, Math.max(1, terminalHeight));
+  process.stdout.write(visibleLines.join("\n"));
+}
+
 function writeCenteredBlock(lines) {
   const safeLines = lines.length > 0 ? lines : [""];
   const terminalWidth = process.stdout.columns || 120;
@@ -593,8 +617,7 @@ function writeCenteredBlock(lines) {
     output += "\n".repeat(padTop);
   }
   output += safeLines.map((line) => `${leftPrefix}${line}`).join("\n");
-  output += "\n";
-  process.stdout.write(output);
+  writeFrameLines(toDisplayLines(output));
 }
 
 function writeCenteredBlockWithTop(topLines, centerLines) {
@@ -617,8 +640,7 @@ function writeCenteredBlockWithTop(topLines, centerLines) {
     output += "\n".repeat(padTop);
   }
   output += safeCenter.map((line) => `${leftPrefix}${line}`).join("\n");
-  output += "\n";
-  process.stdout.write(output);
+  writeFrameLines(toDisplayLines(output));
 }
 
 function drawFrame({ mode, seconds, paused, config, done }) {
@@ -654,7 +676,7 @@ function drawFrame({ mode, seconds, paused, config, done }) {
     writeCenteredBlockWithTop(topLines, centerLines);
   } else {
     const lines = [...topLines, ...centerLines];
-    process.stdout.write(`${lines.join("\n")}\n`);
+    writeFrameLines(lines);
   }
 }
 
@@ -675,6 +697,147 @@ function spawnOk(command, args, options) {
   }
 }
 
+function readCurrentPackageVersion() {
+  try {
+    const packagePath = path.join(PROJECT_ROOT, "package.json");
+    const text = fs.readFileSync(packagePath, "utf8");
+    const parsed = JSON.parse(text);
+    if (!parsed || typeof parsed.version !== "string") {
+      return null;
+    }
+    return parsed.version.trim() || null;
+  } catch (_error) {
+    return null;
+  }
+}
+
+function readLatestPublishedVersion() {
+  try {
+    const result = spawnSync("npm", ["view", PACKAGE_NAME, "version", "--registry=https://registry.npmjs.org"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    if (result.error || result.status !== 0) {
+      return null;
+    }
+    const version = String(result.stdout || "").trim();
+    return version || null;
+  } catch (_error) {
+    return null;
+  }
+}
+
+function detectInstallMethod() {
+  try {
+    const realRoot = fs.realpathSync(PROJECT_ROOT).replace(/\\/g, "/").toLowerCase();
+    if (realRoot.includes("/.bun/install/global/node_modules/")) {
+      return "bun";
+    }
+    if (
+      realRoot.includes("/.local/share/pnpm/global/") ||
+      realRoot.includes("/pnpm/global/") ||
+      realRoot.includes("/.pnpm/")
+    ) {
+      return "pnpm";
+    }
+    if (realRoot.includes("/node_modules/")) {
+      return "npm";
+    }
+  } catch (_error) {
+  }
+
+  const userAgent = String(process.env.npm_config_user_agent || "").toLowerCase();
+  if (userAgent.startsWith("bun/")) {
+    return "bun";
+  }
+  if (userAgent.startsWith("pnpm/")) {
+    return "pnpm";
+  }
+  if (userAgent.startsWith("npm/")) {
+    return "npm";
+  }
+
+  return "npm";
+}
+
+function getUpdateCommand(method) {
+  const packageTarget = `${PACKAGE_NAME}@latest`;
+  if (method === "bun") {
+    return {
+      command: "bun",
+      args: ["add", "-g", packageTarget],
+      printable: `bun add -g ${packageTarget}`
+    };
+  }
+  if (method === "pnpm") {
+    return {
+      command: "pnpm",
+      args: ["add", "-g", packageTarget],
+      printable: `pnpm add -g ${packageTarget}`
+    };
+  }
+  return {
+    command: "npm",
+    args: ["i", "-g", packageTarget],
+    printable: `npm i -g ${packageTarget}`
+  };
+}
+
+function runSelfUpdate() {
+  const method = detectInstallMethod();
+  const updateCommand = getUpdateCommand(method);
+  const beforeVersion = readCurrentPackageVersion();
+  const latestVersion = readLatestPublishedVersion();
+
+  process.stdout.write(`Detected install method: ${method}\n`);
+  if (beforeVersion) {
+    process.stdout.write(`Current version: ${beforeVersion}\n`);
+  }
+  if (latestVersion) {
+    process.stdout.write(`Latest version: ${latestVersion}\n`);
+  }
+  process.stdout.write(`Running: ${updateCommand.printable}\n\n`);
+
+  let result;
+  try {
+    result = spawnSync(updateCommand.command, updateCommand.args, { stdio: "inherit" });
+  } catch (error) {
+    process.stderr.write(`Failed to run updater: ${error.message}\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  if (result.error || result.status !== 0) {
+    process.stderr.write(`Update command failed: ${updateCommand.printable}\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const installedAfter = readCurrentPackageVersion();
+  const latestAfter = readLatestPublishedVersion();
+
+  process.stdout.write("\nUpdate finished.\n");
+  if (installedAfter) {
+    process.stdout.write(`Installed version: ${installedAfter}\n`);
+  }
+  if (latestAfter) {
+    process.stdout.write(`Latest version: ${latestAfter}\n`);
+  }
+
+  if (installedAfter && latestAfter && installedAfter === latestAfter) {
+    process.stdout.write("You are on the latest version.\n");
+    return;
+  }
+
+  if (latestAfter) {
+    process.stderr.write("Update completed, but this running install is not on the latest version yet.\n");
+    process.exitCode = 1;
+    return;
+  }
+
+  process.stdout.write("Could not verify latest version from npm, but update command completed.\n");
+}
+
 function sleepSync(ms) {
   const durationMs = Math.max(0, Number(ms) || 0);
   if (durationMs <= 0) {
@@ -967,6 +1130,8 @@ function runClock({ mode, initialSeconds, config }) {
   let lastDrawState = "";
   let hasExited = false;
   let didEnterAlternateScreen = false;
+  let didDisableLineWrap = false;
+  let didEnableMouseCapture = false;
 
   const stdin = process.stdin;
 
@@ -1062,6 +1227,12 @@ function runClock({ mode, initialSeconds, config }) {
     }
     stdin.pause();
     showCursor();
+    if (didEnableMouseCapture) {
+      disableMouseCapture();
+    }
+    if (didDisableLineWrap) {
+      enableLineWrap();
+    }
     if (didEnterAlternateScreen) {
       exitAlternateScreen();
     } else {
@@ -1127,6 +1298,10 @@ function runClock({ mode, initialSeconds, config }) {
   stdin.on("data", onKeypress);
   enterAlternateScreen();
   didEnterAlternateScreen = true;
+  disableLineWrap();
+  didDisableLineWrap = true;
+  enableMouseCapture();
+  didEnableMouseCapture = true;
   hideCursor();
 
   draw(true);
@@ -1255,6 +1430,8 @@ function printUsage() {
   process.stdout.write("  Example: timer 5 min 2 sec\n\n");
   process.stdout.write("Settings\n");
   process.stdout.write("  timer settings\n\n");
+  process.stdout.write("Update\n");
+  process.stdout.write("  timer update\n\n");
   process.stdout.write("Controls\n");
   process.stdout.write("  Defaults: p/Space Pause-Resume | r Restart | f Random Style | q/e/Ctrl+C Exit\n");
   process.stdout.write("  Keybindings are customizable in `timer settings`.\n\n");
@@ -1283,6 +1460,11 @@ function runTimer(args) {
     return;
   }
 
+  if (args[0] === "update") {
+    runSelfUpdate();
+    return;
+  }
+
   if (args[0] === "style") {
     if (args.length === 1 || (args.length === 2 && args[1] === "--all")) {
       const currentFont = getFontFromConfig();