@owloops/claude-powerline 1.24.3 → 1.25.0

package/src/utils/constants.ts

@@ -0,0 +1,176 @@
+export const RESET_CODE = "\x1b[0m";
+
+export const SYMBOLS = {
+  right: "\uE0B0",
+  left_rounded: "\uE0B6",
+  right_rounded: "\uE0B4",
+  branch: "⎇",
+  model: "✱",
+  git_clean: "✓",
+  git_dirty: "●",
+  git_conflicts: "⚠",
+  git_ahead: "↑",
+  git_behind: "↓",
+  git_worktree: "⧉",
+  git_tag: "⌂",
+  git_sha: "♯",
+  git_upstream: "→",
+  git_stash: "⧇",
+  git_time: "◷",
+  session_cost: "§",
+  block_cost: "◱",
+  today_cost: "☉",
+  context_time: "◔",
+  metrics_response: "⧖",
+  metrics_last_response: "Δ",
+  metrics_duration: "⧗",
+  metrics_messages: "◆",
+  metrics_lines_added: "+",
+  metrics_lines_removed: "-",
+  metrics_burn: "↗",
+  version: "◈",
+  bar_filled: "▪",
+  bar_empty: "▫",
+  env: "⚙",
+  session_id: "⌗",
+  weekly_cost: "◑",
+  dir: "📁",
+  activity: "⚡",
+} as const;
+
+export const BOX_CHARS = {
+  topLeft: "╭",
+  topRight: "╮",
+  bottomLeft: "╰",
+  bottomRight: "╯",
+  horizontal: "─",
+  vertical: "│",
+  teeLeft: "├",
+  teeRight: "┤",
+} as const;
+
+export const BOX_CHARS_TEXT = {
+  topLeft: "+",
+  topRight: "+",
+  bottomLeft: "+",
+  bottomRight: "+",
+  horizontal: "-",
+  vertical: "|",
+  teeLeft: "+",
+  teeRight: "+",
+} as const;
+
+import type { BoxChars } from "../tui/types";
+
+export const BOX_PRESETS: Record<string, BoxChars> = {
+  rounded: BOX_CHARS,
+  square: {
+    topLeft: "┌",
+    topRight: "┐",
+    bottomLeft: "└",
+    bottomRight: "┘",
+    horizontal: "─",
+    vertical: "│",
+    teeLeft: "├",
+    teeRight: "┤",
+  },
+  heavy: {
+    topLeft: "┏",
+    topRight: "┓",
+    bottomLeft: "┗",
+    bottomRight: "┛",
+    horizontal: "━",
+    vertical: "┃",
+    teeLeft: "┣",
+    teeRight: "┫",
+  },
+  double: {
+    topLeft: "╔",
+    topRight: "╗",
+    bottomLeft: "╚",
+    bottomRight: "╝",
+    horizontal: "═",
+    vertical: "║",
+    teeLeft: "╠",
+    teeRight: "╣",
+  },
+  dashed: {
+    topLeft: "╭",
+    topRight: "╮",
+    bottomLeft: "╰",
+    bottomRight: "╯",
+    horizontal: "┄",
+    vertical: "┊",
+    teeLeft: "├",
+    teeRight: "┤",
+  },
+  "heavy-dashed": {
+    topLeft: "┏",
+    topRight: "┓",
+    bottomLeft: "┗",
+    bottomRight: "┛",
+    horizontal: "┅",
+    vertical: "┇",
+    teeLeft: "┣",
+    teeRight: "┫",
+  },
+  mixed: {
+    topLeft: "┍",
+    topRight: "┑",
+    bottomLeft: "┕",
+    bottomRight: "┙",
+    horizontal: "━",
+    vertical: "│",
+    teeLeft: "┝",
+    teeRight: "┥",
+  },
+  ascii: BOX_CHARS_TEXT,
+  invisible: {
+    topLeft: " ",
+    topRight: " ",
+    bottomLeft: " ",
+    bottomRight: " ",
+    horizontal: " ",
+    vertical: " ",
+    teeLeft: " ",
+    teeRight: " ",
+  },
+};
+
+export const TEXT_SYMBOLS = {
+  right: "\uE0B0",
+  left_rounded: "\uE0B6",
+  right_rounded: "\uE0B4",
+  branch: "~",
+  model: "M",
+  git_clean: "=",
+  git_dirty: "*",
+  git_conflicts: "!",
+  git_ahead: "^",
+  git_behind: "v",
+  git_worktree: "W",
+  git_tag: "T",
+  git_sha: "#",
+  git_upstream: ">>",
+  git_stash: "S",
+  git_time: "@",
+  session_cost: "S",
+  block_cost: "B",
+  today_cost: "D",
+  context_time: "C",
+  metrics_response: "R",
+  metrics_last_response: "L",
+  metrics_duration: "T",
+  metrics_messages: "#",
+  metrics_lines_added: "+",
+  metrics_lines_removed: "-",
+  metrics_burn: "~/h",
+  version: "V",
+  bar_filled: "=",
+  bar_empty: "-",
+  env: "$",
+  session_id: "#",
+  weekly_cost: "W",
+  dir: "D",
+  activity: "A",
+} as const;

package/src/utils/formatters.ts

@@ -0,0 +1,160 @@
+interface TokenBreakdown {
+  input: number;
+  output: number;
+  cacheCreation: number;
+  cacheRead: number;
+}
+
+export function formatCost(cost: number | null): string {
+  if (cost === null) return "$0.00";
+  if (cost < 0.01) return "<$0.01";
+  return `$${cost.toFixed(2)}`;
+}
+
+export function formatTokens(tokens: number | null): string {
+  if (tokens === null) return "0 tokens";
+  if (tokens === 0) return "0 tokens";
+  if (tokens >= 1_000_000) {
+    return `${(tokens / 1_000_000).toFixed(1)}M tokens`;
+  } else if (tokens >= 1_000) {
+    return `${(tokens / 1_000).toFixed(1)}K tokens`;
+  }
+  return `${tokens} tokens`;
+}
+
+export function formatTokenBreakdown(breakdown: TokenBreakdown | null): string {
+  if (!breakdown) return "0 tokens";
+
+  const parts: string[] = [];
+
+  if (breakdown.input > 0) {
+    parts.push(`${formatTokenCount(breakdown.input)} in`);
+  }
+
+  if (breakdown.output > 0) {
+    parts.push(`${formatTokenCount(breakdown.output)} out`);
+  }
+
+  if (breakdown.cacheCreation > 0 || breakdown.cacheRead > 0) {
+    const totalCached = breakdown.cacheCreation + breakdown.cacheRead;
+    parts.push(`${formatTokenCount(totalCached)} cached`);
+  }
+
+  return parts.length > 0 ? parts.join(" + ") : "0 tokens";
+}
+
+export function formatTimeSince(seconds: number): string {
+  if (seconds < 60) return `${seconds}s`;
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;
+  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h`;
+  if (seconds < 604800) return `${Math.floor(seconds / 86400)}d`;
+  return `${Math.floor(seconds / 604800)}w`;
+}
+
+export function formatDuration(seconds: number): string {
+  if (seconds < 60) {
+    return `${seconds.toFixed(0)}s`;
+  } else if (seconds < 3600) {
+    return `${(seconds / 60).toFixed(0)}m`;
+  } else if (seconds < 86400) {
+    return `${(seconds / 3600).toFixed(1)}h`;
+  } else {
+    return `${(seconds / 86400).toFixed(1)}d`;
+  }
+}
+
+const CLAUDE_MODEL_PATTERN =
+  /^(?:(?:global|apac|au|eu|us|us-east-\d|us-west-\d|eu-west-\d|eu-central-\d)\.)?(?:anthropic\.|azure_ai\/|bedrock\/|vertex_ai\/)?claude-(?:(?<family>opus|sonnet|haiku)-(?<newMajor>\d+)(?:-(?<newMinor>\d))?|(?<oldMajor>\d+)(?:-(?<oldMinor>\d))?-(?<oldFamily>opus|sonnet|haiku))(?:[-@]\d{8})?(?:-v\d+:\d+)?(?:-latest)?$/i;
+
+export function formatModelName(rawName: string): string {
+  if (!rawName) {
+    return "Claude";
+  }
+
+  const match = rawName.trim().match(CLAUDE_MODEL_PATTERN);
+  if (!match?.groups) {
+    return rawName;
+  }
+
+  const { family, newMajor, newMinor, oldMajor, oldMinor, oldFamily } =
+    match.groups;
+
+  const modelFamily = family || oldFamily;
+  const major = newMajor || oldMajor;
+  const minor = newMinor || oldMinor;
+
+  if (modelFamily && major) {
+    const capitalizedFamily =
+      modelFamily.charAt(0).toUpperCase() + modelFamily.slice(1).toLowerCase();
+    const version = minor ? `${major}.${minor}` : major;
+    return `${capitalizedFamily} ${version}`;
+  }
+
+  return rawName;
+}
+
+export function abbreviateFishStyle(dirPath: string): string {
+  const sep = dirPath.includes("/") ? "/" : "\\";
+  const parts = dirPath.split(sep);
+  return parts
+    .map((part, index) => {
+      if (index === parts.length - 1) {
+        return part;
+      }
+      if (part === "~" || part === "") {
+        return part;
+      }
+      return part.charAt(0);
+    })
+    .join(sep);
+}
+
+export function formatResponseTime(seconds: number): string {
+  if (seconds < 60) {
+    return `${seconds.toFixed(1)}s`;
+  }
+  return `${(seconds / 60).toFixed(1)}m`;
+}
+
+export function formatTokenCount(tokens: number | null): string {
+  return formatTokens(tokens).replace(" tokens", "");
+}
+
+export function formatBurnRate(rate: number | null | undefined): string {
+  if (rate === null || rate === undefined || rate <= 0) return "";
+  return rate < 1 ? `${(rate * 100).toFixed(0)}c/h` : `$${rate.toFixed(2)}/h`;
+}
+
+export function collapseHome(dirPath: string, homeDir?: string): string {
+  const home =
+    homeDir ??
+    globalThis.process?.env?.HOME ??
+    globalThis.process?.env?.USERPROFILE;
+  if (home && dirPath.startsWith(home)) {
+    return dirPath.replace(home, "~");
+  }
+  return dirPath;
+}
+
+export function formatTimeRemaining(totalMinutes: number): string {
+  const hours = Math.floor(totalMinutes / 60);
+  const minutes = totalMinutes % 60;
+  return hours > 0 ? `${hours}h ${minutes}m left` : `${minutes}m left`;
+}
+
+export function formatLongTimeRemaining(totalMinutes: number): string {
+  if (totalMinutes >= 1440) {
+    const days = Math.floor(totalMinutes / 1440);
+    const hours = Math.floor((totalMinutes % 1440) / 60);
+    return hours > 0 ? `${days}d ${hours}h` : `${days}d`;
+  } else if (totalMinutes >= 60) {
+    const hours = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    return minutes > 0 ? `${hours}h ${minutes}m` : `${hours}h`;
+  }
+  return `${totalMinutes}m`;
+}
+
+export function minutesUntilReset(epochSeconds: number): number {
+  return Math.round(Math.max(0, epochSeconds * 1000 - Date.now()) / 60000);
+}

package/src/utils/logger.ts

@@ -0,0 +1,5 @@
+export function debug(message: string, ...args: unknown[]): void {
+  if (process.env.CLAUDE_POWERLINE_DEBUG) {
+    console.error(`[DEBUG] ${message}`, ...args);
+  }
+}

package/src/utils/terminal-width.ts

@@ -0,0 +1,117 @@
+import { execSync } from "node:child_process";
+
+const VALID_TTY_PATTERN = /^[a-zA-Z0-9/]+$/;
+
+function findParentTty(): string | null {
+  if (process.platform === "win32") return null;
+
+  let pid = process.pid.toString();
+
+  for (let i = 0; i < 10; i++) {
+    try {
+      const info = execSync(`ps -o ppid=,tty= -p ${pid}`, {
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "ignore"],
+      }).trim();
+      const parts = info.split(/\s+/);
+      const ppid = parts[0];
+      const tty = parts[1];
+
+      if (tty && tty !== "?" && tty !== "??" && VALID_TTY_PATTERN.test(tty)) {
+        return tty;
+      }
+
+      if (!ppid || ppid === "1" || ppid === "0") break;
+      pid = ppid;
+    } catch {
+      break;
+    }
+  }
+
+  return null;
+}
+
+function getWindowsTerminalWidth(): number | null {
+  try {
+    const output = execSync("mode con", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "ignore"],
+      windowsHide: true,
+    });
+    const match = output.match(/Columns:\s*(\d+)/i);
+    if (match?.[1]) {
+      const parsed = parseInt(match[1], 10);
+      if (!isNaN(parsed) && parsed > 0) return parsed;
+    }
+  } catch {}
+  return null;
+}
+
+function getUnixTerminalWidth(): number | null {
+  const tty = findParentTty();
+  if (tty) {
+    try {
+      const size = execSync(`stty size < /dev/${tty}`, {
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "ignore"],
+        shell: "/bin/sh",
+      }).trim();
+      const width = size.split(" ")[1];
+      if (width) {
+        const parsed = parseInt(width, 10);
+        if (!isNaN(parsed) && parsed > 0) return parsed;
+      }
+    } catch {}
+  }
+
+  try {
+    const width = execSync("tput cols 2>/dev/null", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "ignore"],
+    }).trim();
+
+    const parsed = parseInt(width, 10);
+    if (!isNaN(parsed) && parsed > 0) return parsed;
+  } catch {}
+
+  return null;
+}
+
+/**
+ * @info Reserves characters for Claude Code's right-side UI messages
+ * (e.g., "Current: 2.1.78 · latest: 2.1.78", "Thinking off")
+ */
+const RESERVED_CHARS = 45;
+
+export function getTerminalWidth(): number | null {
+  const applyReserve = (w: number) => Math.max(1, w - RESERVED_CHARS);
+
+  const envColumns = process.env.COLUMNS;
+  if (envColumns) {
+    const parsed = parseInt(envColumns, 10);
+    if (!isNaN(parsed) && parsed > 0) return applyReserve(parsed);
+  }
+
+  if (process.stdout.columns && process.stdout.columns > 0) {
+    return applyReserve(process.stdout.columns);
+  }
+
+  if (process.platform === "win32") {
+    const width = getWindowsTerminalWidth();
+    if (width) return applyReserve(width);
+  }
+
+  const width = getUnixTerminalWidth();
+  return width ? applyReserve(width) : null;
+}
+
+export function getRawTerminalWidth(): number | null {
+  // Skip COLUMNS env and process.stdout.columns — Claude Code sets those
+  // to an already-reserved panel width. We need the actual terminal width
+  // so the grid engine can apply its own widthReserve.
+  if (process.platform === "win32") {
+    return getWindowsTerminalWidth();
+  }
+
+  return getUnixTerminalWidth();
+}

package/src/utils/terminal.ts

@@ -0,0 +1,11 @@
+export const ESC = String.fromCharCode(27);
+const ANSI_REGEX = new RegExp(`${ESC}\\[[0-9;]*m`, "g");
+export const ANSI_SPLIT = new RegExp(`(${ESC}\\[[0-9;]*m)`);
+
+export function stripAnsi(str: string): string {
+  return str.replace(ANSI_REGEX, "");
+}
+
+export function visibleLength(str: string): number {
+  return stripAnsi(str).length;
+}