"use client"; import { useUiText } from "@suphark/ui/components/shared/ui-text"; import { getNumberFormat } from "@suphark/ui/lib/intl-cache"; import { cn } from "@suphark/ui/lib/utils"; import { type ReactNode, useId } from "react"; export type UsageLevel = "ok" | "warning" | "danger" | "over" | "unlimited"; /** ระดับของการใช้งาน — แยกออกมาให้แอปใช้ตัดสินใจเอง (เช่น ปิดปุ่มอัปโหลดเมื่อ `over`) */ export function usageLevel( used: number, limit: number | null | undefined, { warnAt = 0.8, dangerAt = 0.95 }: { warnAt?: number; dangerAt?: number } = {}, ): UsageLevel { if (limit == null || !Number.isFinite(limit)) return "unlimited"; if (limit <= 0) return used > 0 ? "over" : "ok"; const ratio = used / limit; if (ratio > 1) return "over"; if (ratio >= dangerAt) return "danger"; if (ratio >= warnAt) return "warning"; return "ok"; } const BAR: Record = { ok: "bg-primary", warning: "bg-warning", danger: "bg-destructive", over: "bg-destructive", unlimited: "", }; const BADGE: Record<"warning" | "danger" | "over", string> = { warning: "bg-warning-subtle text-warning-subtle-foreground", danger: "bg-destructive-subtle text-destructive-subtle-foreground", over: "bg-destructive-subtle text-destructive-subtle-foreground", }; export interface UsageMeterProps { /** ชื่อของสิ่งที่นับ เช่น "พื้นที่ไฟล์" — เป็นชื่อของ meter สำหรับโปรแกรมอ่านจอด้วย */ label: ReactNode; used: number; /** null/undefined = ไม่จำกัด (แสดงเส้นประ ไม่มีเปอร์เซ็นต์) */ limit?: number | null; /** แปลงตัวเลขเป็นข้อความ เช่น `formatBytes` (ค่าเริ่มต้น: ตัวเลขมีจุลภาค) */ format?: (value: number) => ReactNode; /** สัดส่วนที่เริ่มเตือนเหลือง (ค่าเริ่มต้น 0.8) */ warnAt?: number; /** สัดส่วนที่เตือนแดง + บอกว่าเหลือเท่าไร (ค่าเริ่มต้น 0.95) */ dangerAt?: number; /** compact = แถบบาง + ข้อความบรรทัดเดียวใต้แถบ (แถบข้าง/ท้ายเมนู) */ variant?: "default" | "compact"; /** * compact: แสดง `label` หน้าตัวเลขใต้แถบ (ค่าเริ่มต้นไม่แสดง — แถบข้างที่มีหัวข้ออยู่แล้ว) · ใช้เมื่อวางหลายแถบซ้อนกัน * เช่น "วันนี้" / "เดือนนี้" ไม่งั้นอ่านไม่ออกว่าแถบไหนคืออะไร · โหมด default แสดง label เสมอ */ showLabel?: boolean; /** ข้อความเล็กใต้แถบ เช่น "รีเซ็ต 1 พ.ย." */ hint?: ReactNode; className?: string; } /** * แถบโควตา "ใช้ไป X จาก Y" — สีเปลี่ยนเองที่ 80%/95% และมีป้ายเป็นคำ ("ใกล้เต็ม", "เหลือ 280") ไม่พึ่งสีอย่างเดียว * (auth/files/pdf ทำแถบแบบนี้เองคนละแบบ) * * formatBytes(n)} /> * // ไม่จำกัด */ export function UsageMeter({ label, used, limit, format, warnAt, dangerAt, variant = "default", showLabel = false, hint, className, }: UsageMeterProps) { const text = useUiText().usage; // ไม่ระบุภาษา = ตามเครื่อง (server en-US "1,234" / browser de-DE "1.234" → hydration mismatch) — ใช้ th-TH ที่ cache ไว้ const plain = (value: number) => getNumberFormat("th-TH").format(value); const show = (value: number) => (format ? format(value) : plain(value)); const level = usageLevel(used, limit, { warnAt, dangerAt }); const unlimited = level === "unlimited"; const percent = unlimited || !limit ? 0 : Math.min(100, Math.max(0, (used / limit) * 100)); const labelId = useId(); // ค่าที่โปรแกรมอ่านจอพูด — เดิมอ่าน aria-valuenow ดิบ (เช่น 734003200 ไบต์) · format คืน string ใช้ได้เลย const spoken = (value: number) => { const shown = show(value); return typeof shown === "string" || typeof shown === "number" ? String(shown) : plain(value); }; const compact = variant === "compact"; const amount = unlimited ? ( <> {show(used)} · {text?.unlimited ?? "ไม่จำกัด"} ) : ( fill(text?.of ?? "{used} จาก {limit}", { used: show(used), limit: show(limit ?? 0) }) ); const badge = level === "warning" || level === "danger" || level === "over" ? ( {level === "warning" ? (text?.nearlyFull ?? "ใกล้เต็ม") : level === "over" ? (text?.over ?? "เกินโควตา") : fill(text?.remaining ?? "เหลือ {remaining}", { remaining: show(Math.max(0, (limit ?? 0) - used)), })} ) : null; const bar = unlimited ? (