Merge pull request #9 from udithavithanage/feature/update-checker

Enhance CLI UX, Add Version Auto-Check, and Refactor Configuration & Editor Logic

Author: udithavithanage

bun.lock

@@ -1,6 +1,6 @@
 {
   "name": "thyra",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Simple project folder opener CLI",
   "type": "module",
   "bin": {
@@ -39,5 +39,8 @@
     "@types/node": "^24.10.1",
     "bun": "^1.3.3",
     "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "picocolors": "^1.1.1"
   }
 }

package.json

@@ -9,40 +9,34 @@ import { getConfigFilePath, ConfigStore } from "~/configStore";
 (function run() {
   const [, , command, ...rest] = process.argv;
 
-  const configPath = getConfigFilePath();
-  const store = new ConfigStore(configPath);
+  const store = new ConfigStore(getConfigFilePath());
 
   if (
     !command ||
     command === "help" ||
     command === "--help" ||
     command === "-h"
   ) {
-    runHelp();
+    runHelp(0);
     return;
   }
-
   if (command === "version" || command === "--version" || command === "-v") {
-    runVersion();
+    runVersion(store);
     return;
   }
 
   switch (command) {
     case "config":
       runConfig(store, rest);
       break;
-
     case "open":
       runOpen(store, rest);
       break;
-
     case "list":
       runList(store);
       break;
-
     default:
       console.error(`Unknown command: ${command}`);
       runHelp(1);
-      break;
   }
 })();

src/cli.ts

@@ -0,0 +1,68 @@
+import color from "picocolors";
+
+// Strip ANSI escape sequences (for width calc)
+export function stripAnsi(s: string) {
+  return String(s).replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "");
+}
+
+// Visible length (ignores ANSI)
+export function vlen(s: string) {
+  return stripAnsi(s).length;
+}
+
+// Pad right by visible width
+export function padRight(s: string, width: number) {
+  const diff = Math.max(0, width - vlen(s));
+  return s + " ".repeat(diff);
+}
+
+export function colorize(cmd: string) {
+  return cmd.replace(/thyra\b|--\S+|<[^>]+>/g, (tok) => {
+    if (tok === "thyra") return color.green(tok);
+    if (tok.startsWith("--")) return color.yellow(tok);
+    if (tok.startsWith("<")) return color.cyan(tok);
+    return tok;
+  });
+}
+
+export interface CommandTableRow {
+  Command: string;
+  Description: string;
+}
+
+interface PrintCommandTableOptions {
+  header?: {
+    Command: string;
+    Description: string;
+  };
+}
+
+export function printCommandTable(
+  rows: CommandTableRow[],
+  options: PrintCommandTableOptions = {},
+) {
+  const header = options.header ?? {
+    Command: "Command",
+    Description: "Description",
+  };
+
+  const col1 = [header.Command, ...rows.map((r) => r.Command)];
+  const col2 = [header.Description, ...rows.map((r) => r.Description)];
+
+  const w1 = Math.max(...col1.map(vlen));
+  const w2 = Math.max(...col2.map(vlen));
+
+  const sep = "  "; // spacing between columns
+  const line = (t1: string, t2: string) =>
+    padRight(t1, w1) + sep + padRight(t2, w2);
+
+  // header
+  console.log(color.bold(line(header.Command, header.Description)));
+  // separator
+  console.log(padRight("-".repeat(w1), w1) + sep + "-".repeat(w2));
+
+  // rows
+  for (const r of rows) {
+    console.log(line(r.Command, r.Description));
+  }
+}

src/color-logs.ts

@@ -1,30 +1,42 @@
-export function runHelp(exitCode?: number): void {
-  console.log(`
-thyra - Quick shortcut manager for project folders
-`);
+import color from "picocolors";
 
-  console.table([
+import { colorize, printCommandTable } from "~/color-logs";
+
+export function runHelp(exitCode: number) {
+  console.log(
+    `\n${color.bold(color.cyan("thyra"))} ${color.dim(
+      "- Quick shortcut manager for project folders",
+    )}\n`,
+  );
+
+  const rows = [
     {
-      Command: "thyra config <name> <folder_path>",
+      Command: colorize("thyra config <name> <folder_path>"),
       Description: "Save a folder path",
     },
-    { Command: "thyra open <name>", Description: "Open folder in your editor" },
-    { Command: "thyra list", Description: "Show all saved paths" },
-    { Command: "thyra --version", Description: "Show CLI version" },
-    { Command: "thyra --help", Description: "Show this help" },
-  ]);
+    {
+      Command: colorize("thyra open <name>"),
+      Description: "Open folder in your editor",
+    },
+    { Command: colorize("thyra list"), Description: "Show all saved paths" },
+    { Command: colorize("thyra --version"), Description: "Show CLI version" },
+    { Command: colorize("thyra --help"), Description: "Show this help" },
+  ];
+
+  printCommandTable(rows);
 
-  console.log(`
-Examples:
-  thyra config my-app ~/projects/my-app
-  thyra open my-app
-  thyra --version
+  console.log(
+    `\n${color.bold(color.underline("Examples:"))}
+  ${colorize("thyra config <name> <folder_path>")}   ${color.dim("# Save a path")}
+  ${colorize("thyra open <name>")}                   ${color.dim(
+    "# Open in editor",
+  )}
+  ${colorize("thyra --version")}
 
-Environment:
-  THYRA_EDITOR                        Editor command (default: "code")
-`);
+${color.bold(color.underline("Environment:"))}
+  ${color.cyan("THYRA_EDITOR")}  ${color.dim('Editor command (default: "code")')}
+`,
+  );
 
-  if (typeof exitCode === "number") {
-    process.exit(exitCode);
-  }
+  if (typeof exitCode === "number") process.exit(exitCode);
 }

src/commands/help.ts

@@ -1,20 +1,30 @@
+import color from "picocolors";
+
+import { colorize, printCommandTable } from "~/color-logs";
+
 import type { ConfigStore } from "~/configStore";
 
-export function runList(store: ConfigStore): void {
+export function runList(store: ConfigStore) {
   const all = store.all();
   const keys = Object.keys(all);
 
   if (keys.length === 0) {
-    console.log("No folders saved yet.");
-    console.log("Use: thyra config <name> <folder_path>");
+    console.log(color.dim("No folders saved yet."));
+    console.log("Use: " + colorize("thyra config <name> <folder_path>"));
     return;
   }
 
   const rows = keys.map((key) => ({
-    Name: key,
-    Path: all[key],
+    Command: color.cyan(key),
+    Description: color.dim(all[key]),
   }));
 
-  console.log("\nSaved folders:\n");
-  console.table(rows);
+  console.log("\n" + color.bold("Saved folders:\n"));
+
+  printCommandTable(rows, {
+    header: {
+      Command: "Name",
+      Description: "Path",
+    },
+  });
 }

src/commands/list.ts

@@ -1,5 +1,36 @@
 import fs from "node:fs";
-import { openInEditor } from "~/editor.js";
+import { exec } from "node:child_process";
+
+function openInEditor(folderPath: string) {
+  const editorCmd = process.env.THYRA_EDITOR || "code";
+  let safePath = folderPath;
+  if (editorCmd.trim() !== "explorer") {
+    safePath = folderPath.replace(/(["\\$`])/g, "\\$1");
+  }
+  const command = `${editorCmd} "${safePath}"`;
+
+  console.log(`Opening "${folderPath}" in "${editorCmd}"...`);
+
+  const child = exec(command, (error, stdout, stderr) => {
+    if (stdout) {
+      process.stdout.write(stdout);
+    }
+    if (stderr) {
+      process.stderr.write(stderr);
+    }
+
+    if (error && editorCmd !== "explorer") {
+      console.error(
+        `Failed to start editor "${editorCmd}". Is it installed and on your PATH?`,
+      );
+      console.error(error.message);
+      process.exit(1);
+    }
+  });
+
+  if (child.stdout) child.stdout.pipe(process.stdout);
+  if (child.stderr) child.stderr.pipe(process.stderr);
+}
 
 import type { ConfigStore } from "~/configStore";