@edgarlopezcalomarde/stopwatch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Edgar Lopez Calomarde
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# stopwatch
+
+Cronómetro para la terminal con dígitos grandes, construido con [Bun](https://bun.sh) y [OpenTUI](https://opentui.dev).
+
+## Instalación
+
+```bash
+bun i -g @edgarlopezcalomarde/stopwatch
+```
+
+Requiere tener [Bun](https://bun.sh) instalado.
+
+## Uso
+
+```bash
+stopwatch          # abre el cronómetro en 00:00:00 (detenido)
+stopwatch --start  # abre el cronómetro y empieza a contar solo
+```
+
+### Teclas
+
+| Tecla   | Acción                                     |
+| ------- | ------------------------------------------ |
+| `Enter` | Iniciar / parar                            |
+| `r`     | Reiniciar a 00:00:00                       |
+| `c`     | Color aleatorio (se guarda entre sesiones) |
+| `q`     | Salir (también Esc/Ctrl+C)                 |
+
+El color elegido se guarda en `~/.config/stopwatch/config.json`.
+
+## Desarrollo
+
+```bash
+git clone https://github.com/edgarlopezcalomarde/stopwatch.git
+cd stopwatch
+bun install
+bun run index.ts
+```
+
+Para registrar el comando `stopwatch` global desde el código local:
+
+```bash
+bun link
+```
+
+## Licencia
+
+MIT © Edgar Lopez Calomarde

package/index.ts

@@ -0,0 +1,171 @@
+#!/usr/bin/env bun
+import {
+  createCliRenderer,
+  ASCIIFontRenderable,
+  TextRenderable,
+  BoxRenderable,
+  type KeyEvent,
+} from "@opentui/core"
+import { homedir } from "node:os"
+import { join } from "node:path"
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs"
+
+const DEFAULT_COLOR = "#00FF88"
+const CONFIG_DIR = join(homedir(), ".config", "stopwatch")
+const CONFIG_PATH = join(CONFIG_DIR, "config.json")
+
+const autoStart = process.argv.includes("--start")
+
+function loadColor(): string {
+  try {
+    const config = JSON.parse(readFileSync(CONFIG_PATH, "utf8"))
+    if (typeof config.color === "string" && /^#[0-9a-fA-F]{6}$/.test(config.color)) {
+      return config.color
+    }
+  } catch {}
+  return DEFAULT_COLOR
+}
+
+function saveColor(color: string) {
+  try {
+    mkdirSync(CONFIG_DIR, { recursive: true })
+    writeFileSync(CONFIG_PATH, JSON.stringify({ color }, null, 2))
+  } catch {}
+}
+
+function randomColor(): string {
+  // Random hue with fixed high saturation/lightness so digits stay readable
+  const h = Math.random()
+  const s = 0.85
+  const l = 0.6
+  const q = l + s * Math.min(l, 1 - l)
+  const p = 2 * l - q
+  const channel = (t: number) => {
+    if (t < 0) t += 1
+    if (t > 1) t -= 1
+    if (t < 1 / 6) return p + (q - p) * 6 * t
+    if (t < 1 / 2) return q
+    if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6
+    return p
+  }
+  const toHex = (v: number) =>
+    Math.round(v * 255)
+      .toString(16)
+      .padStart(2, "0")
+  return `#${toHex(channel(h + 1 / 3))}${toHex(channel(h))}${toHex(channel(h - 1 / 3))}`
+}
+
+function dim(color: string): string {
+  const scale = (hex: string) =>
+    Math.round(parseInt(hex, 16) * 0.45)
+      .toString(16)
+      .padStart(2, "0")
+  return `#${scale(color.slice(1, 3))}${scale(color.slice(3, 5))}${scale(color.slice(5, 7))}`
+}
+
+let clockColor = loadColor()
+
+function formatTime(elapsedMs: number): string {
+  const totalSeconds = Math.floor(elapsedMs / 1000)
+  const hours = Math.floor(totalSeconds / 3600)
+  const minutes = Math.floor((totalSeconds % 3600) / 60)
+  const seconds = totalSeconds % 60
+  const pad = (n: number) => String(n).padStart(2, "0")
+  return `${pad(hours)}:${pad(minutes)}:${pad(seconds)}`
+}
+
+const renderer = await createCliRenderer({
+  exitOnCtrlC: true,
+  useMouse: false,
+})
+
+const container = new BoxRenderable(renderer, {
+  id: "container",
+  width: "100%",
+  height: "100%",
+  flexDirection: "column",
+  alignItems: "center",
+  justifyContent: "center",
+  gap: 1,
+})
+
+const clock = new ASCIIFontRenderable(renderer, {
+  id: "clock",
+  text: "00:00:00",
+  font: "block",
+  color: autoStart ? clockColor : dim(clockColor),
+})
+
+const status = new TextRenderable(renderer, {
+  id: "status",
+  content: autoStart ? "corriendo" : "detenido",
+  fg: "#888888",
+})
+
+const help = new TextRenderable(renderer, {
+  id: "help",
+  content: "enter: iniciar/parar   r: reiniciar   c: color   q: salir",
+  fg: "#444444",
+})
+
+container.add(clock)
+container.add(status)
+container.add(help)
+renderer.root.add(container)
+
+let running = false
+let elapsedMs = 0
+let startedAt = 0
+let interval: ReturnType<typeof setInterval> | null = null
+
+function currentElapsed(): number {
+  return running ? elapsedMs + (Date.now() - startedAt) : elapsedMs
+}
+
+function refreshDisplay() {
+  clock.text = formatTime(currentElapsed())
+  clock.color = running ? clockColor : dim(clockColor)
+  status.content = running ? "corriendo" : "detenido"
+}
+
+function start() {
+  if (running) return
+  running = true
+  startedAt = Date.now()
+  interval = setInterval(refreshDisplay, 100)
+  refreshDisplay()
+}
+
+function stop() {
+  if (!running) return
+  elapsedMs += Date.now() - startedAt
+  running = false
+  if (interval) {
+    clearInterval(interval)
+    interval = null
+  }
+  refreshDisplay()
+}
+
+function reset() {
+  elapsedMs = 0
+  startedAt = Date.now()
+  refreshDisplay()
+}
+
+renderer.keyInput.on("keypress", (key: KeyEvent) => {
+  if (key.name === "return") {
+    running ? stop() : start()
+  } else if (key.name === "r") {
+    reset()
+  } else if (key.name === "c" && !key.ctrl) {
+    clockColor = randomColor()
+    saveColor(clockColor)
+    refreshDisplay()
+  } else if (key.name === "q" || key.name === "escape") {
+    renderer.destroy()
+    process.exit(0)
+  }
+})
+
+if (autoStart) start()

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@edgarlopezcalomarde/stopwatch",
+  "version": "1.0.0",
+  "description": "Cronómetro para la terminal con dígitos grandes, construido con Bun y OpenTUI",
+  "author": "Edgar Lopez Calomarde <edgarlopezcalomarde@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edgarlopezcalomarde/stopwatch.git"
+  },
+  "keywords": ["stopwatch", "timer", "cli", "terminal", "tui", "bun", "opentui"],
+  "module": "index.ts",
+  "type": "module",
+  "bin": {
+    "stopwatch": "./index.ts"
+  },
+  "files": ["index.ts", "README.md", "LICENSE"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@opentui/core": "^0.4.2"
+  }
+}