@logtrace/tracker 0.1.0

package/src/ui/renderer.js

@@ -0,0 +1,136 @@
+/**
+ * packages/cli/src/ui/renderer.js
+ *
+ * Terminal rendering helpers.
+ *
+ * All output goes through these functions — never call console.log() directly
+ * in command handlers. This keeps the rendering layer swappable and testable.
+ *
+ * Chalk v5 is ESM-only, which is why we use dynamic import if needed.
+ * Since our packages use "type":"module", the static import below works fine.
+ */
+
+import chalk from 'chalk'
+import Table from 'cli-table3'
+
+// ── Status display ────────────────────────────────────────────────────────────
+
+/**
+ * printStatus(data) — render the `tracker status` output.
+ *
+ * @param {{ version: string, uptime: number, modules: string[] }} data
+ */
+export function printStatus(data) {
+  const { version, uptime, modules } = data
+
+  const uptimeStr = formatUptime(uptime)
+  const moduleCount = Array.isArray(modules) ? modules.length : 0
+  const moduleStr = moduleCount === 0
+    ? chalk.dim('none')
+    : modules.join(', ')
+
+  console.log()
+  console.log(
+    chalk.bold.green('LogTrace') +
+    chalk.dim(` v${version}`) +
+    '  ' +
+    chalk.dim('|') +
+    '  ' +
+    chalk.dim('uptime: ') + chalk.cyan(uptimeStr) +
+    '  ' +
+    chalk.dim('|') +
+    '  ' +
+    chalk.dim('modules: ') + chalk.yellow(String(moduleCount))
+  )
+
+  if (moduleCount > 0) {
+    console.log(chalk.dim('  active: ') + moduleStr)
+  }
+
+  console.log()
+}
+
+// ── Error display ─────────────────────────────────────────────────────────────
+
+/**
+ * printError(message) — render an error message to stderr.
+ *
+ * @param {string} message
+ * @param {Error} [err] - optional error object for stack in dev mode
+ */
+export function printError(message, err = null) {
+  process.stderr.write(chalk.red('  error  ') + message + '\n')
+
+  if (err && process.env.LOGTRACE_ENV === 'development') {
+    process.stderr.write(chalk.dim(err.stack || err.message) + '\n')
+  }
+}
+
+/**
+ * printWarning(message) — render a warning to stdout.
+ * @param {string} message
+ */
+export function printWarning(message) {
+  console.log(chalk.yellow('  warn   ') + message)
+}
+
+/**
+ * printInfo(message) — render an informational line.
+ * @param {string} message
+ */
+export function printInfo(message) {
+  console.log(chalk.dim('  info   ') + message)
+}
+
+// ── Table display ─────────────────────────────────────────────────────────────
+
+/**
+ * printTable(headers, rows) — render a formatted table.
+ *
+ * @param {string[]} headers - column header names
+ * @param {Array<string[]>} rows - array of row arrays
+ */
+export function printTable(headers, rows) {
+  const table = new Table({
+    head: headers.map((h) => chalk.bold.white(h)),
+    style: {
+      head: [],    // disable default blue — we apply chalk above
+      border: [],  // disable default color
+    },
+    chars: {
+      'top':    '─', 'top-mid':    '┬', 'top-left':    '┌', 'top-right':    '┐',
+      'bottom': '─', 'bottom-mid': '┴', 'bottom-left': '└', 'bottom-right': '┘',
+      'left':   '│', 'left-mid':   '├', 'mid':          '─', 'mid-mid':      '┼',
+      'right':  '│', 'right-mid':  '┤', 'middle':       '│',
+    },
+  })
+
+  for (const row of rows) {
+    table.push(row)
+  }
+
+  console.log(table.toString())
+  console.log()
+}
+
+// ── Utilities ─────────────────────────────────────────────────────────────────
+
+/**
+ * formatUptime(seconds) — convert seconds to human-readable uptime string.
+ *
+ * @param {number} seconds
+ * @returns {string} e.g. "3d 4h 21m" or "42s"
+ */
+export function formatUptime(seconds) {
+  if (typeof seconds !== 'number' || isNaN(seconds)) return '?'
+
+  const d = Math.floor(seconds / 86400)
+  const h = Math.floor((seconds % 86400) / 3600)
+  const m = Math.floor((seconds % 3600) / 60)
+  const s = seconds % 60
+
+  if (d > 0) return `${d}d ${h}h ${m}m`
+  if (h > 0) return `${h}h ${m}m`
+  if (m > 0) return `${m}m ${s}s`
+  return `${s}s`
+}