/**
 * Shared formatting helpers extracted from the deprecated tool-render.ts
 * (F-21 Sprint 6 cleanup). Only the 3 utilities that are used by production
 * code live here; the deprecated render functions were removed with tool-render.ts.
 */
import { truncateToWidth } from "../utils/visual.ts";

export function formatTokens(n: number): string {
	if (n < 1000) return String(n);
	if (n < 10_000) return `${(n / 1000).toFixed(1)}k`;
	if (n < 1_000_000) return `${Math.round(n / 1000)}k`;
	return `${(n / 1_000_000).toFixed(1)}M`;
}

/**
 * Canonical generic duration formatter (QW#5 collision resolution):
 * `45ms` / `12.3s` / `3m5s` / `75m` — minutes are unbounded (no hours
 * bucket) and there is no invalid-input guard. Two same-stemmed helpers are
 * DELIBERATELY separate dialects and must not be merged into this one
 * (their output formats are design-pinned):
 *   - `formatTaskElapsed` (ui/widget/task-list.ts) — plan-card elapsed:
 *     `2m 49s` / `1h 03m`, empty string on invalid input.
 *   - `formatRelativeCompact` (utils/relative-time.ts) — relative-time
 *     ladder buckets `84m` / `14h` / `2d14h`.
 */
export function formatDuration(ms: number): string {
	if (ms < 1000) return `${ms}ms`;
	if (ms < 60_000) return `${(ms / 1000).toFixed(1)}s`;
	const m = Math.floor(ms / 60_000),
		s = Math.floor((ms % 60_000) / 1000);
	return s > 0 ? `${m}m${s}s` : `${m}m`;
}

export function truncLine(text: string, maxWidth: number): string {
	if (text.includes("\n") || text.includes("\r")) text = text.replace(/\r?\n/g, "↵ ");
	// Round 23 (BUG 4): previously this loop counted 1 visual column per UTF-16
	// code unit and indexed text[i], so for CJK it emitted up to 2x the visual
	// width (frame overflow) and for emoji it split surrogate pairs (U+FFFD).
	// Delegate to the grapheme/ANSI-aware truncateToWidth (keeps ANSI codes,
	// respects double-wide CJK + surrogate pairs, adds the '…' ellipsis).
	return truncateToWidth(text, maxWidth);
}

/**
 * `1 tool` / `3 tools` — count label with correct singular/plural.
 *
 * Live-run data surfaced `1 tools` in five different surfaces (tool card,
 * dashboard agent rows, live-run sidebar, live conversation overlay): every
 * call site hard-coded the plural. One helper, one rule.
 */
export function formatCount(count: number, singular: string, plural?: string): string {
	return `${count} ${count === 1 ? singular : (plural ?? `${singular}s`)}`;
}

/**
 * `team` / `team/workflow` — collapse the workflow half when it repeats the
 * team. Live runs carry both (`fast-fix` + `fast-fix`) and every surface that
 * printed them naively rendered `fast-fix/fast-fix` (sidebar, dashboard).
 */
export function teamWorkflowLabel(team: string | undefined, workflow: string | undefined): string {
	const t = team && team.length > 0 ? team : "?";
	const w = workflow && workflow.length > 0 ? workflow : undefined;
	return !w || w === t ? t : `${t}/${w}`;
}