@timmy6942025/cli-timer 1.1.12 → 1.1.14

package/README.md

@@ -49,6 +49,7 @@ By default, timer and stopwatch output is centered in the terminal.
 
 - `p` or `Spacebar`: Pause/Resume
 - `r`: Restart
+- `f`: Random style/font
 - `q`, `e` or `Ctrl+C`: Exit
 
 ## Font Styles
@@ -113,6 +114,7 @@ This launches a Bubble Tea based screen where you can change:
 - Completion sound/alarm on completion (default Off)
 - Pause key / pause alt key
 - Restart key
+- Style key
 - Exit key / exit alt key
 
 When completion sound/alarm is enabled, it plays 5 terminal bell beeps.

package/package.json

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

package/settings-ui/main.go

@@ -26,6 +26,7 @@ type keybindings struct {
 	PauseKey    string `json:"pauseKey"`
 	PauseAltKey string `json:"pauseAltKey"`
 	RestartKey  string `json:"restartKey"`
+	StyleKey    string `json:"styleKey"`
 	ExitKey     string `json:"exitKey"`
 	ExitAltKey  string `json:"exitAltKey"`
 }
@@ -34,6 +35,7 @@ var defaultKeybindings = keybindings{
 	PauseKey:    "p",
 	PauseAltKey: "space",
 	RestartKey:  "r",
+	StyleKey:    "f",
 	ExitKey:     "q",
 	ExitAltKey:  "e",
 }
@@ -156,6 +158,7 @@ func buildMenuItems(cfg config) []list.Item {
 		menuEntry{id: "pauseKey", title: "Pause key", description: keyTokenLabel(cfg.Keybindings.PauseKey)},
 		menuEntry{id: "pauseAltKey", title: "Pause alt key", description: keyTokenLabel(cfg.Keybindings.PauseAltKey)},
 		menuEntry{id: "restartKey", title: "Restart key", description: keyTokenLabel(cfg.Keybindings.RestartKey)},
+		menuEntry{id: "styleKey", title: "Style key", description: keyTokenLabel(cfg.Keybindings.StyleKey)},
 		menuEntry{id: "exitKey", title: "Exit key", description: keyTokenLabel(cfg.Keybindings.ExitKey)},
 		menuEntry{id: "exitAltKey", title: "Exit alt key", description: keyTokenLabel(cfg.Keybindings.ExitAltKey)},
 		menuEntry{id: "save", title: "Save and exit", description: "Write settings and close"},
@@ -221,6 +224,7 @@ func normalizeKeybindings(cfg keybindings) keybindings {
 	result.PauseKey = normalizeKeyToken(cfg.PauseKey, result.PauseKey)
 	result.PauseAltKey = normalizeKeyToken(cfg.PauseAltKey, result.PauseAltKey)
 	result.RestartKey = normalizeKeyToken(cfg.RestartKey, result.RestartKey)
+	result.StyleKey = normalizeKeyToken(cfg.StyleKey, result.StyleKey)
 	result.ExitKey = normalizeKeyToken(cfg.ExitKey, result.ExitKey)
 	result.ExitAltKey = normalizeKeyToken(cfg.ExitAltKey, result.ExitAltKey)
 	return result
@@ -379,6 +383,8 @@ func (m *model) keyTokenForTarget(target string) string {
 		return m.payload.Config.Keybindings.PauseAltKey
 	case "restartKey":
 		return m.payload.Config.Keybindings.RestartKey
+	case "styleKey":
+		return m.payload.Config.Keybindings.StyleKey
 	case "exitKey":
 		return m.payload.Config.Keybindings.ExitKey
 	case "exitAltKey":
@@ -396,6 +402,8 @@ func (m *model) setKeyTokenForTarget(target string, token string) {
 		m.payload.Config.Keybindings.PauseAltKey = token
 	case "restartKey":
 		m.payload.Config.Keybindings.RestartKey = token
+	case "styleKey":
+		m.payload.Config.Keybindings.StyleKey = token
 	case "exitKey":
 		m.payload.Config.Keybindings.ExitKey = token
 	case "exitAltKey":
@@ -479,6 +487,9 @@ func (m *model) applyMenuAction() tea.Cmd {
 	case "restartKey":
 		m.openKeyPicker("restartKey", "Select Restart Key")
 		return nil
+	case "styleKey":
+		m.openKeyPicker("styleKey", "Select Style Key")
+		return nil
 	case "exitKey":
 		m.openKeyPicker("exitKey", "Select Exit Key")
 		return nil

package/src/index.js

@@ -39,6 +39,7 @@ const DEFAULT_KEYBINDINGS = Object.freeze({
   pauseKey: "p",
   pauseAltKey: "space",
   restartKey: "r",
+  styleKey: "f",
   exitKey: "q",
   exitAltKey: "e"
 });
@@ -47,6 +48,7 @@ const LEGACY_DEFAULT_KEYBINDINGS = Object.freeze({
   pauseKey: "p",
   pauseAltKey: "space",
   restartKey: "r",
+  styleKey: "f",
   exitKey: "s",
   exitAltKey: "e"
 });
@@ -324,6 +326,7 @@ function normalizeKeybindings(raw) {
   next.pauseKey = normalizeKeyToken(raw.pauseKey, next.pauseKey);
   next.pauseAltKey = normalizeKeyToken(raw.pauseAltKey, next.pauseAltKey);
   next.restartKey = normalizeKeyToken(raw.restartKey, next.restartKey);
+  next.styleKey = normalizeKeyToken(raw.styleKey, next.styleKey);
   next.exitKey = normalizeKeyToken(raw.exitKey, next.exitKey);
   next.exitAltKey = normalizeKeyToken(raw.exitAltKey, next.exitAltKey);
 
@@ -331,6 +334,7 @@ function normalizeKeybindings(raw) {
     next.pauseKey === LEGACY_DEFAULT_KEYBINDINGS.pauseKey &&
     next.pauseAltKey === LEGACY_DEFAULT_KEYBINDINGS.pauseAltKey &&
     next.restartKey === LEGACY_DEFAULT_KEYBINDINGS.restartKey &&
+    next.styleKey === LEGACY_DEFAULT_KEYBINDINGS.styleKey &&
     next.exitKey === LEGACY_DEFAULT_KEYBINDINGS.exitKey &&
     next.exitAltKey === LEGACY_DEFAULT_KEYBINDINGS.exitAltKey
   ) {
@@ -432,6 +436,30 @@ function setFontInConfig(requestedFont) {
   return { ok: true, reason: null, font: updated.font };
 }
 
+function pickRandomFont(fonts, currentFont) {
+  if (!Array.isArray(fonts) || fonts.length === 0) {
+    return null;
+  }
+  if (fonts.length === 1) {
+    return fonts[0];
+  }
+
+  let candidate = currentFont;
+  for (let attempt = 0; attempt < 8 && candidate === currentFont; attempt += 1) {
+    candidate = fonts[Math.floor(Math.random() * fonts.length)];
+  }
+
+  if (candidate === currentFont) {
+    const currentIndex = fonts.findIndex((fontName) => fontName === currentFont);
+    if (currentIndex >= 0) {
+      return fonts[(currentIndex + 1) % fonts.length];
+    }
+    return fonts[0];
+  }
+
+  return candidate;
+}
+
 function parseDurationArgs(args) {
   if (args.length === 0 || args.length % 2 !== 0) {
     return { ok: false, error: "Duration must be in <number> <unit> pairs." };
@@ -519,8 +547,9 @@ function keyTokenToLabel(token) {
 function controlsHelpLine(keybindings) {
   const pause = `${keyTokenToLabel(keybindings.pauseKey)}/${keyTokenToLabel(keybindings.pauseAltKey)}`;
   const restart = keyTokenToLabel(keybindings.restartKey);
+  const style = keyTokenToLabel(keybindings.styleKey);
   const exit = `${keyTokenToLabel(keybindings.exitKey)}/${keyTokenToLabel(keybindings.exitAltKey)}/Ctrl+C`;
-  return `Controls: ${pause} Pause-Resume | ${restart} Restart | ${exit} Exit`;
+  return `Controls: ${pause} Pause-Resume | ${restart} Restart | ${style} Random Style | ${exit} Exit`;
 }
 
 function keyTokenFromInput(chunk) {
@@ -983,6 +1012,21 @@ function runClock({ mode, initialSeconds, config }) {
     draw(true);
   }
 
+  function cycleStyle() {
+    const fonts = getAllFonts();
+    if (fonts.length === 0) {
+      return;
+    }
+    const nextFont = pickRandomFont(fonts, config.font);
+    if (!nextFont) {
+      return;
+    }
+    const updated = setFontInConfig(nextFont);
+    config.font = updated.ok ? updated.font : nextFont;
+    lastDrawState = "";
+    draw(true);
+  }
+
   function onSignal() {
     cleanupAndExit(0);
   }
@@ -1048,6 +1092,11 @@ function runClock({ mode, initialSeconds, config }) {
       return;
     }
 
+    if (token === config.keybindings.styleKey) {
+      cycleStyle();
+      return;
+    }
+
     if (token === config.keybindings.exitKey || token === config.keybindings.exitAltKey) {
       cleanupAndExit(0);
     }
@@ -1192,7 +1241,7 @@ function printUsage() {
   process.stdout.write("Settings\n");
   process.stdout.write("  timer settings\n\n");
   process.stdout.write("Controls\n");
-  process.stdout.write("  Defaults: p/Space Pause-Resume | r Restart | q/e/Ctrl+C Exit\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");
   process.stdout.write("Font Styles\n");
   process.stdout.write("  timer style\n");
@@ -1252,7 +1301,12 @@ function runTimer(args) {
         process.exitCode = 1;
         return;
       }
-      const randomFont = fonts[Math.floor(Math.random() * fonts.length)];
+      const randomFont = pickRandomFont(fonts, getFontFromConfig());
+      if (!randomFont) {
+        process.stderr.write("No fonts are available.\n");
+        process.exitCode = 1;
+        return;
+      }
       const result = setFontInConfig(randomFont);
       if (!result.ok) {
         process.stderr.write(`Failed to set random font: ${randomFont}\n`);