@prismatic-io/lux 0.0.1

package/src/cli/render/format.ts

@@ -0,0 +1,69 @@
+import type { TokenUsage } from "../../core/index.js";
+
+const pad2 = (n: number): string => String(n).padStart(2, "0");
+
+/**
+ * Durations a human reads at a glance, rounded to whole seconds or minutes.
+ */
+export const formatDuration = (ms: number): string => {
+  if (!Number.isFinite(ms) || ms < 0) return "—";
+  const totalSeconds = Math.round(ms / 1000);
+  if (ms < 60_000) {
+    if (totalSeconds < 60) return `${totalSeconds}s`;
+  }
+  if (ms < 3_600_000 && Math.floor(totalSeconds / 60) < 60) {
+    return `${Math.floor(totalSeconds / 60)}m${pad2(totalSeconds % 60)}s`;
+  }
+  const totalMinutes = Math.round(ms / 60_000);
+  return `${Math.floor(totalMinutes / 60)}h${pad2(totalMinutes % 60)}m`;
+};
+
+/** Token counts, abbreviated so a footer stays one line: 950, 4.2k, 128k, 1.4M. */
+export const formatTokens = (n: number): string => {
+  if (!Number.isFinite(n) || n < 0) return "0";
+  if (n < 1000) return String(Math.round(n));
+  if (n < 1_000_000) {
+    const thousands = n / 1000;
+    const text = thousands < 10 ? thousands.toFixed(1) : String(Math.round(thousands));
+    // Promote to M when rounding reaches it — never "1000k".
+    if (text !== "1000") return `${text}k`;
+  }
+  return `${(n / 1_000_000).toFixed(1)}M`;
+};
+
+const formatCompactTokens = (n: number): string => {
+  if (!Number.isFinite(n) || n < 0) return "0";
+  if (n < 1000) return String(Math.round(n));
+  if (n < 1_000_000) return `${Math.round(n / 1000)}k`;
+  if (n < 1_000_000_000) return `${Math.round(n / 1_000_000)}M`;
+  return `${Math.round(n / 1_000_000_000)}B`;
+};
+
+/** `↑in ↓out ⚡read ◇create`; cache reads are confirmed hits, not writes. */
+export const formatUsage = (usage: TokenUsage): string => {
+  const parts = [`↑${formatTokens(usage.input)}`, `↓${formatTokens(usage.output)}`];
+  if (usage.cacheRead > 0) parts.push(`⚡${formatTokens(usage.cacheRead)}`);
+  if (usage.cacheCreation > 0) parts.push(`◇${formatTokens(usage.cacheCreation)}`);
+  return parts.join(" ");
+};
+
+export const formatAlignedUsage = (usage: TokenUsage): string =>
+  [
+    [
+      `↑${formatCompactTokens(usage.input).padStart(3)}`,
+      `↓${formatCompactTokens(usage.output).padStart(3)}`,
+    ].join("  "),
+    [
+      `⚡${formatCompactTokens(usage.cacheRead).padStart(3)}`,
+      `◇${formatCompactTokens(usage.cacheCreation).padStart(3)}`,
+    ].join("  "),
+  ].join("      ");
+
+export const formatScore = (score: number): string => `${Math.round(score * 100)}%`;
+
+/** A one-line count summary: "2 passed · 1 failed · 1 running  (4)". */
+export const formatTally = (parts: [count: number, label: string][], total: number): string => {
+  const shown = parts.filter(([count]) => count > 0).map(([count, label]) => `${count} ${label}`);
+  const body = shown.length > 0 ? shown.join(" · ") : "0 run";
+  return `${body}  (${total})`;
+};