homeio

1/**
2 * Format bytes to human-readable string
3 */
4export function formatBytes(
5  bytes: number,
6  decimals = 2,
7): { value: string; unit: string } {
8  if (bytes === 0) return { value: "0", unit: "Bytes" };
9
10  const k = 1024;
11  const dm = decimals < 0 ? 0 : decimals;
12  const sizes = ["Bytes", "KB", "MB", "GB", "TB", "PB"];
13
14  const i = Math.floor(Math.log(bytes) / Math.log(k));
15  const value = (bytes / Math.pow(k, i)).toFixed(dm);
16
17  return {
18    value,
19    unit: sizes[i] || "Bytes",
20  };
21}
22
23/**
24 * Format bytes to string with unit
25 */
26export function formatBytesCompact(bytes: number, decimals = 2): string {
27  const { value, unit } = formatBytes(bytes, decimals);
28  return `${value} ${unit}`;
29}
30
31/**
32 * Convert seconds to human-readable uptime
33 */
34export function formatUptime(seconds: number): string {
35  const days = Math.floor(seconds / 86400);
36  const hours = Math.floor((seconds % 86400) / 3600);
37  const minutes = Math.floor((seconds % 3600) / 60);
38
39  const parts: string[] = [];
40  if (days > 0) parts.push(`${days}d`);
41  if (hours > 0) parts.push(`${hours}h`);
42  if (minutes > 0 || parts.length === 0) parts.push(`${minutes}m`);
43
44  return parts.join(" ");
45}
46
47/**
48 * Format uptime in short format (e.g., "2d 5h")
49 */
50export function formatUptimeShort(seconds: number): string {
51  const days = Math.floor(seconds / 86400);
52  const hours = Math.floor((seconds % 86400) / 3600);
53
54  if (days > 0) {
55    return `${days}d ${hours}h`;
56  }
57  if (hours > 0) {
58    const minutes = Math.floor((seconds % 3600) / 60);
59    return `${hours}h ${minutes}m`;
60  }
61  const minutes = Math.floor(seconds / 60);
62  return `${minutes}m`;
63}
64
65/**
66 * Format percentage to fixed decimals
67 */
68export function formatPercent(value: number | undefined | null, decimals = 1): string {
69  if (value == null || !Number.isFinite(value)) return "--";
70  return value.toFixed(decimals);
71}
72
73/**
74 * Clamp value between min and max
75 */
76export function clamp(value: number, min: number, max: number): number {
77  return Math.max(min, Math.min(max, value));
78}
79
80/**
81 * Format number with thousand separators
82 */
83export function formatNumber(value: number, decimals = 0): string {
84  return value.toLocaleString(undefined, {
85    minimumFractionDigits: decimals,
86    maximumFractionDigits: decimals,
87  });
88}
89
90/**
91 * Get status color class based on percentage threshold
92 */
93export function getStatusColor(
94  percent: number,
95  thresholds = { warning: 70, critical: 90 },
96): string {
97  if (percent >= thresholds.critical) return "text-status-red";
98  if (percent >= thresholds.warning) return "text-status-amber";
99  return "text-status-green";
100}
101
102/**
103 * Get progress bar color based on percentage threshold
104 */
105export function getProgressColor(
106  percent: number,
107  thresholds = { warning: 70, critical: 90 },
108): string {
109  if (percent >= thresholds.critical) return "bg-status-red";
110  if (percent >= thresholds.warning) return "bg-status-amber";
111  return "bg-status-green";
112}
113