@comitor/ui 2.1.0 → 3.0.1

package/dist/data-grid/utils.d.ts

@@ -1,4 +1,5 @@
 import { Column, Table } from '@tanstack/react-table';
+import { Locale } from 'date-fns';
 import * as React from 'react';
 import { DataGridMessages } from './messages-en.js';
 import { CellOpts, RowHeightValue, CellPosition, Direction, FileCellData } from './types.js';
@@ -59,9 +60,28 @@ declare function getEmptyCellValue(variant: CellOpts["variant"] | undefined): un
 declare function getUrlHref(urlString: string): string;
 declare function parseLocalDate(dateStr: unknown): Date | null;
 declare function formatDateToString(date: Date): string;
-/** Hiển thị ngày theo chuẩn Việt Nam dd/MM/yyyy (dùng cho ô ngày, bộ lọc ngày) */
-declare function formatDate(date: Date | string | number | null | undefined): string;
-declare function formatDateForDisplay(dateStr: unknown): string;
+/**
+ * Hiển thị ngày dạng ngắn theo `locale` (dùng cho ô ngày, bộ lọc ngày).
+ *
+ * Hàm THUẦN nên không đọc được ngôn ngữ của lưới: component truyền locale đang có hiệu lực vào
+ * (`useDataGridDateLocale()`). Bỏ trống `locale` = locale mặc định của date-fns (`enUS`, trừ khi
+ * app đã đổi bằng `setDefaultOptions`).
+ *
+ * ⚠ Trước `3.0.0` hàm này luôn ra `dd/MM/yyyy` bất kể ngôn ngữ. Cần lại đúng chuỗi cũ thì truyền
+ * `vi` (`import { vi } from "date-fns/locale"`).
+ */
+declare function formatDate(date: Date | string | number | null | undefined, locale?: Locale): string;
+/** Như {@link formatDate}, cho giá trị thô của ô ngày (`yyyy-MM-dd` hoặc `Date`). */
+declare function formatDateForDisplay(dateStr: unknown, locale?: Locale): string;
+/**
+ * Đọc chuỗi ngày DÁN vào ô ngày. Thử dạng ngắn của `locale` trước — đúng dạng lưới đang hiển
+ * thị, nên `25/12/2024` dán vào lưới tiếng Việt là 25 tháng 12, không phải lỗi — rồi mới tới
+ * `new Date()` (ISO `yyyy-MM-dd`, và những gì JS tự hiểu). `null` khi không đọc được.
+ *
+ * Năm phải đủ 4 chữ số: mẫu `"P"` đọc `25/12/24` thành năm 24 sau Công nguyên, một ngày "hợp lệ"
+ * mà không ai muốn — chuỗi như thế rơi xuống `new Date()` như trước.
+ */
+declare function parseDateInput(text: string, locale?: Locale): Date | null;
 /**
  * Id cho tệp đính kèm. `crypto.randomUUID` chỉ có ở secure context (https/localhost) —
  * app nội bộ chạy http trong mạng bệnh viện sẽ không có, nên phải có đường lui.
@@ -78,4 +98,4 @@ declare function readClipboardText(): Promise<string | null>;
 declare function formatFileSize(bytes: number): string;
 declare function getFileIcon(type: string): React.ComponentType<React.SVGProps<SVGSVGElement>>;
 
-export { flexRender, formatDate, formatDateForDisplay, formatDateToString, formatFileSize, generateFileId, getCellKey, getColumnBorderVisibility, getColumnPinningStyle, getColumnVariant, getEmptyCellValue, getFileIcon, getIsFileCellData, getIsInPopover, getLineCount, getRowHeightValue, getScrollDirection, getUrlHref, matchSelectOption, parseCellKey, parseLocalDate, parseTsv, readClipboardText, scrollCellIntoView, writeClipboardText };
+export { flexRender, formatDate, formatDateForDisplay, formatDateToString, formatFileSize, generateFileId, getCellKey, getColumnBorderVisibility, getColumnPinningStyle, getColumnVariant, getEmptyCellValue, getFileIcon, getIsFileCellData, getIsInPopover, getLineCount, getRowHeightValue, getScrollDirection, getUrlHref, matchSelectOption, parseCellKey, parseDateInput, parseLocalDate, parseTsv, readClipboardText, scrollCellIntoView, writeClipboardText };

package/dist/data-grid/utils.js

@@ -1,4 +1,4 @@
-import { format } from "date-fns";
+import { format, isValid, parse } from "date-fns";
 import {
   BaselineIcon,
   CalendarIcon,
@@ -300,17 +300,26 @@ function formatDateToString(date) {
   const day = String(date.getDate()).padStart(2, "0");
   return `${year}-${month}-${day}`;
 }
-function formatDate(date) {
+const DATE_DISPLAY_FORMAT = "P";
+function formatDate(date, locale) {
   if (!date) return "";
   const value = date instanceof Date ? date : new Date(date);
   if (Number.isNaN(value.getTime())) return "";
-  return format(value, "dd/MM/yyyy");
+  return format(value, DATE_DISPLAY_FORMAT, { locale });
 }
-function formatDateForDisplay(dateStr) {
+function formatDateForDisplay(dateStr, locale) {
   if (!dateStr) return "";
   const date = parseLocalDate(dateStr);
   if (!date) return typeof dateStr === "string" ? dateStr : "";
-  return formatDate(date);
+  return formatDate(date, locale);
+}
+function parseDateInput(text, locale) {
+  const trimmed = text.trim();
+  if (!trimmed) return null;
+  const localized = parse(trimmed, DATE_DISPLAY_FORMAT, /* @__PURE__ */ new Date(), { locale });
+  if (isValid(localized) && localized.getFullYear() >= 1e3) return localized;
+  const date = new Date(trimmed);
+  return Number.isNaN(date.getTime()) ? null : date;
 }
 function generateFileId() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
@@ -400,6 +409,7 @@ export {
   getUrlHref,
   matchSelectOption,
   parseCellKey,
+  parseDateInput,
   parseLocalDate,
   parseTsv,
   readClipboardText,

package/dist/data-grid/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-grid/utils.ts"],"sourcesContent":["import type { Column, Table } from \"@tanstack/react-table\";\nimport { format } from \"date-fns\";\nimport {\n  BaselineIcon,\n  CalendarIcon,\n  CheckSquareIcon,\n  File,\n  FileArchive,\n  FileAudio,\n  FileIcon,\n  FileImage,\n  FileSpreadsheet,\n  FileText,\n  FileVideo,\n  HashIcon,\n  LinkIcon,\n  ListChecksIcon,\n  ListIcon,\n  Presentation,\n  WrapTextIcon\n} from \"lucide-react\";\nimport type * as React from \"react\";\nimport { type DataGridMessages, getDataGridMessages } from \"./messages.js\";\nimport type { CellOpts, CellPosition, Direction, FileCellData, RowHeightValue } from \"./types.js\";\n\nexport function flexRender<TProps extends object>(\n  Comp: ((props: TProps) => React.ReactNode) | string | undefined,\n  props: TProps\n): React.ReactNode {\n  if (typeof Comp === \"string\") {\n    return Comp;\n  }\n  return Comp?.(props);\n}\n\nexport function getIsFileCellData(item: unknown): item is FileCellData {\n  return !!item && typeof item === \"object\" && \"id\" in item && \"name\" in item && \"size\" in item && \"type\" in item;\n}\n\nexport function matchSelectOption(value: string, options: { value: string; label: string }[]): string | undefined {\n  return options.find(\n    (o) =>\n      o.value === value ||\n      o.value.toLowerCase() === value.toLowerCase() ||\n      o.label.toLowerCase() === value.toLowerCase()\n  )?.value;\n}\n\nexport function getCellKey(rowIndex: number, columnId: string) {\n  return `${rowIndex}:${columnId}`;\n}\n\nexport function parseCellKey(cellKey: string): Required<CellPosition> {\n  const parts = cellKey.split(\":\");\n  const rowIndexStr = parts[0];\n  const columnId = parts[1];\n  if (rowIndexStr && columnId) {\n    const rowIndex = parseInt(rowIndexStr, 10);\n    if (!Number.isNaN(rowIndex)) {\n      return { rowIndex, columnId };\n    }\n  }\n  return { rowIndex: 0, columnId: \"\" };\n}\n\nexport function getRowHeightValue(rowHeight: RowHeightValue): number {\n  const rowHeightMap: Record<RowHeightValue, number> = {\n    short: 36,\n    medium: 56,\n    tall: 76,\n    \"extra-tall\": 96\n  };\n\n  return rowHeightMap[rowHeight];\n}\n\nexport function getLineCount(rowHeight: RowHeightValue): number {\n  const lineCountMap: Record<RowHeightValue, number> = {\n    short: 1,\n    medium: 2,\n    tall: 3,\n    \"extra-tall\": 4\n  };\n\n  return lineCountMap[rowHeight];\n}\n\nexport function getColumnBorderVisibility<TData>(params: {\n  column: Column<TData>;\n  nextColumn?: Column<TData>;\n  isLastColumn: boolean;\n}): {\n  showEndBorder: boolean;\n  showStartBorder: boolean;\n} {\n  const { column, nextColumn, isLastColumn } = params;\n\n  const isPinned = column.getIsPinned();\n  const isFirstRightPinnedColumn = isPinned === \"right\" && column.getIsFirstColumn(\"right\");\n  const isLastRightPinnedColumn = isPinned === \"right\" && column.getIsLastColumn(\"right\");\n\n  const nextIsPinned = nextColumn?.getIsPinned();\n  const isBeforeRightPinned = nextIsPinned === \"right\" && nextColumn?.getIsFirstColumn(\"right\");\n\n  const showEndBorder = !isBeforeRightPinned && (isLastColumn || !isLastRightPinnedColumn);\n\n  const showStartBorder = isFirstRightPinnedColumn;\n\n  return {\n    showEndBorder,\n    showStartBorder\n  };\n}\n\nexport function getColumnPinningStyle<TData>(params: {\n  column: Column<TData>;\n  withBorder?: boolean;\n  dir?: Direction;\n}): React.CSSProperties {\n  const { column, dir = \"ltr\", withBorder = false } = params;\n\n  const isPinned = column.getIsPinned();\n  const isLastLeftPinnedColumn = isPinned === \"left\" && column.getIsLastColumn(\"left\");\n  const isFirstRightPinnedColumn = isPinned === \"right\" && column.getIsFirstColumn(\"right\");\n\n  const isRtl = dir === \"rtl\";\n\n  const leftPosition = isPinned === \"left\" ? `${column.getStart(\"left\")}px` : undefined;\n  const rightPosition = isPinned === \"right\" ? `${column.getAfter(\"right\")}px` : undefined;\n\n  /*\n   * ⚠ Token của gói này là MÀU ĐẦY ĐỦ (`--card: #ffffff`), KHÔNG phải bộ 3 kênh HSL — nên viết\n   * `var(--card)` trần, đừng bọc `hsl()`. Bản gốc port từ một hệ token kiểu `\"150 20% 98%\"` nên\n   * ở đó `hsl(var(--card))` mới đúng; bê nguyên sang đây thì `hsl(#ffffff)` là giá trị KHÔNG\n   * HỢP LỆ, và hệ quả là cột ghim trong suốt — nội dung cuộn phía dưới lộ xuyên qua. Không có\n   * lỗi nào được ném ra: CSS bỏ qua khai báo hỏng rồi rơi về `background: transparent`.\n   *\n   * Nền lấy theo `--card` vì hộp lưới dùng `bg-card` như mọi bảng khác của gói.\n   */\n  return {\n    boxShadow: withBorder\n      ? isLastLeftPinnedColumn\n        ? isRtl\n          ? \"4px 0 4px -4px var(--border) inset\"\n          : \"-4px 0 4px -4px var(--border) inset\"\n        : isFirstRightPinnedColumn\n          ? isRtl\n            ? \"-4px 0 4px -4px var(--border) inset\"\n            : \"4px 0 4px -4px var(--border) inset\"\n          : undefined\n      : undefined,\n    left: isRtl ? rightPosition : leftPosition,\n    right: isRtl ? leftPosition : rightPosition,\n    opacity: isPinned ? 0.97 : 1,\n    position: isPinned ? \"sticky\" : \"relative\",\n    background: \"var(--card)\",\n    width: column.getSize(),\n    zIndex: isPinned ? 1 : undefined\n  };\n}\n\nexport function getScrollDirection(direction: string): \"left\" | \"right\" | \"home\" | \"end\" | undefined {\n  if (direction === \"left\" || direction === \"right\" || direction === \"home\" || direction === \"end\") {\n    return direction as \"left\" | \"right\" | \"home\" | \"end\";\n  }\n  if (direction === \"pageleft\") return \"left\";\n  if (direction === \"pageright\") return \"right\";\n  return undefined;\n}\n\nexport function scrollCellIntoView<TData>(params: {\n  container: HTMLDivElement;\n  targetCell: HTMLDivElement;\n  tableRef: React.RefObject<Table<TData> | null>;\n  viewportOffset: number;\n  direction?: \"left\" | \"right\" | \"home\" | \"end\";\n  isRtl: boolean;\n}): void {\n  const { container, targetCell, tableRef, direction, viewportOffset, isRtl } = params;\n\n  const containerRect = container.getBoundingClientRect();\n  const cellRect = targetCell.getBoundingClientRect();\n\n  const hasNegativeScroll = container.scrollLeft < 0;\n  const isActuallyRtl = isRtl || hasNegativeScroll;\n\n  const currentTable = tableRef.current;\n  const leftPinnedColumns = currentTable?.getLeftVisibleLeafColumns() ?? [];\n  const rightPinnedColumns = currentTable?.getRightVisibleLeafColumns() ?? [];\n\n  const leftPinnedWidth = leftPinnedColumns.reduce((sum, c) => sum + c.getSize(), 0);\n  const rightPinnedWidth = rightPinnedColumns.reduce((sum, c) => sum + c.getSize(), 0);\n\n  const viewportLeft = isActuallyRtl\n    ? containerRect.left + rightPinnedWidth + viewportOffset\n    : containerRect.left + leftPinnedWidth + viewportOffset;\n  const viewportRight = isActuallyRtl\n    ? containerRect.right - leftPinnedWidth - viewportOffset\n    : containerRect.right - rightPinnedWidth - viewportOffset;\n\n  const isFullyVisible = cellRect.left >= viewportLeft && cellRect.right <= viewportRight;\n\n  if (isFullyVisible) return;\n\n  const isClippedLeft = cellRect.left < viewportLeft;\n  const isClippedRight = cellRect.right > viewportRight;\n\n  let scrollDelta = 0;\n\n  if (!direction) {\n    if (isClippedRight) {\n      scrollDelta = cellRect.right - viewportRight;\n    } else if (isClippedLeft) {\n      scrollDelta = -(viewportLeft - cellRect.left);\n    }\n  } else {\n    const shouldScrollRight = isActuallyRtl\n      ? direction === \"right\" || direction === \"home\"\n      : direction === \"right\" || direction === \"end\";\n\n    if (shouldScrollRight) {\n      scrollDelta = cellRect.right - viewportRight;\n    } else {\n      scrollDelta = -(viewportLeft - cellRect.left);\n    }\n  }\n\n  container.scrollLeft += scrollDelta;\n}\n\nfunction countTabs(s: string): number {\n  let n = 0;\n  for (let i = 0; i < s.length; i++) if (s[i] === \"\\t\") n++;\n  return n;\n}\n\nexport function parseTsv(text: string, fallbackColumnCount: number): string[][] {\n  if (text.startsWith('\"') || text.includes('\\t\"')) {\n    const rows: string[][] = [];\n    let currentRow: string[] = [];\n    let currentField = \"\";\n    let inQuotes = false;\n    let i = 0;\n\n    while (i < text.length) {\n      const char = text[i];\n      const nextChar = text[i + 1];\n\n      if (inQuotes) {\n        if (char === '\"' && nextChar === '\"') {\n          currentField += '\"';\n          i += 2;\n        } else if (char === '\"') {\n          inQuotes = false;\n          i++;\n        } else {\n          currentField += char;\n          i++;\n        }\n      } else {\n        if (char === '\"' && currentField === \"\") {\n          inQuotes = true;\n          i++;\n        } else if (char === \"\\t\") {\n          currentRow.push(currentField);\n          currentField = \"\";\n          i++;\n        } else if (char === \"\\n\") {\n          currentRow.push(currentField);\n          if (currentRow.length > 1 || currentRow.some((f) => f.length > 0)) {\n            rows.push(currentRow);\n          }\n          currentRow = [];\n          currentField = \"\";\n          i++;\n        } else if (char === \"\\r\" && nextChar === \"\\n\") {\n          currentRow.push(currentField);\n          if (currentRow.length > 1 || currentRow.some((f) => f.length > 0)) {\n            rows.push(currentRow);\n          }\n          currentRow = [];\n          currentField = \"\";\n          i += 2;\n        } else {\n          currentField += char;\n          i++;\n        }\n      }\n    }\n\n    currentRow.push(currentField);\n    if (currentRow.length > 1 || currentRow.some((f) => f.length > 0)) {\n      rows.push(currentRow);\n    }\n\n    return rows;\n  }\n\n  const lines = text.split(\"\\n\").map((l) => l.replace(/\\r$/, \"\"));\n  let maxTabCount = 0;\n  for (const line of lines) {\n    const n = countTabs(line);\n    if (n > maxTabCount) maxTabCount = n;\n  }\n  const columnCount = maxTabCount > 0 ? maxTabCount + 1 : fallbackColumnCount;\n  if (columnCount <= 0) return [];\n\n  const expectedTabCount = columnCount - 1;\n  const rows: string[][] = [];\n  let buf = \"\";\n  let bufTabCount = 0;\n\n  for (const line of lines) {\n    const tc = countTabs(line);\n\n    if (tc === expectedTabCount) {\n      if (buf && bufTabCount === expectedTabCount) rows.push(buf.split(\"\\t\"));\n      buf = \"\";\n      bufTabCount = 0;\n      rows.push(line.split(\"\\t\"));\n    } else {\n      buf = buf ? `${buf}\\n${line}` : line;\n      bufTabCount += tc;\n      if (bufTabCount === expectedTabCount) {\n        rows.push(buf.split(\"\\t\"));\n        buf = \"\";\n        bufTabCount = 0;\n      }\n    }\n  }\n\n  if (buf && bufTabCount === expectedTabCount) rows.push(buf.split(\"\\t\"));\n\n  return rows.length > 0 ? rows : lines.filter((l) => l.length > 0).map((l) => l.split(\"\\t\"));\n}\n\n/**\n * Phần tử có đang nằm trong một lớp nổi không? Dùng để lưới KHÔNG coi thao tác\n * trong popover/menu/hộp thoại là \"bấm ra ngoài\" (sẽ mất focus ô đang sửa).\n *\n * Primitive của package không gắn `data-slot`, nên bắt theo wrapper của Radix Popper\n * (bao Popover/DropdownMenu/Select/Tooltip) và theo role — kể cả Select \"item-aligned\".\n */\nexport function getIsInPopover(element: unknown): boolean {\n  if (!(element instanceof Element)) return false;\n\n  return (\n    element.closest(\"[data-grid-cell-editor]\") !== null ||\n    element.closest(\"[data-grid-popover]\") !== null ||\n    element.closest(\"[data-radix-popper-content-wrapper]\") !== null ||\n    element.closest(\"[role='dialog']\") !== null ||\n    element.closest(\"[role='menu']\") !== null ||\n    element.closest(\"[role='listbox']\") !== null\n  );\n}\n\n/**\n * Icon + tên kiểu dữ liệu của một cột (hiện trong tooltip ở tiêu đề cột).\n *\n * `messages` bỏ trống = bảng mặc định (tiếng Anh), giữ đúng chữ ký của `1.11.0`. Component nào\n * vẽ nhãn này cho người dùng thì PHẢI truyền bảng đang có hiệu lực vào — quên là tooltip nói\n * tiếng Anh giữa một lưới tiếng Việt.\n */\nexport function getColumnVariant(\n  variant?: CellOpts[\"variant\"],\n  messages?: DataGridMessages\n): {\n  icon: React.ComponentType<React.SVGProps<SVGSVGElement>>;\n  label: string;\n} | null {\n  const msg = messages ?? getDataGridMessages();\n  switch (variant) {\n    case \"short-text\":\n      return { label: msg.column.variant.shortText, icon: BaselineIcon };\n    case \"long-text\":\n      return { label: msg.column.variant.longText, icon: WrapTextIcon };\n    case \"number\":\n      return { label: msg.column.variant.number, icon: HashIcon };\n    case \"url\":\n      return { label: msg.column.variant.url, icon: LinkIcon };\n    case \"checkbox\":\n      return { label: msg.column.variant.checkbox, icon: CheckSquareIcon };\n    case \"select\":\n      return { label: msg.column.variant.select, icon: ListIcon };\n    case \"multi-select\":\n      return { label: msg.column.variant.multiSelect, icon: ListChecksIcon };\n    case \"date\":\n      return { label: msg.column.variant.date, icon: CalendarIcon };\n    case \"file\":\n      return { label: msg.column.variant.file, icon: FileIcon };\n    default:\n      return null;\n  }\n}\n\nexport function getEmptyCellValue(variant: CellOpts[\"variant\"] | undefined): unknown {\n  if (variant === \"multi-select\" || variant === \"file\") return [];\n  if (variant === \"number\" || variant === \"date\" || variant === \"select\") return null;\n  if (variant === \"checkbox\") return false;\n  return \"\";\n}\n\nexport function getUrlHref(urlString: string): string {\n  if (!urlString || urlString.trim() === \"\") return \"\";\n\n  const trimmed = urlString.trim();\n\n  // Reject dangerous protocols (extra safety, though our http:// prefix would neutralize them)\n  if (/^(javascript|data|vbscript|file):/i.test(trimmed)) {\n    return \"\";\n  }\n\n  if (trimmed.startsWith(\"http://\") || trimmed.startsWith(\"https://\")) {\n    return trimmed;\n  }\n\n  return `http://${trimmed}`;\n}\n\nexport function parseLocalDate(dateStr: unknown): Date | null {\n  if (!dateStr) return null;\n  if (dateStr instanceof Date) return dateStr;\n  if (typeof dateStr !== \"string\") return null;\n  const [year, month, day] = dateStr.split(\"-\").map(Number);\n  if (!year || !month || !day) return null;\n  const date = new Date(year, month - 1, day);\n  // Verify date wasn't auto-corrected (e.g. Feb 30 -> Mar 1)\n  if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {\n    return null;\n  }\n  return date;\n}\n\nexport function formatDateToString(date: Date): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  return `${year}-${month}-${day}`;\n}\n\n/** Hiển thị ngày theo chuẩn Việt Nam dd/MM/yyyy (dùng cho ô ngày, bộ lọc ngày) */\nexport function formatDate(date: Date | string | number | null | undefined): string {\n  if (!date) return \"\";\n  const value = date instanceof Date ? date : new Date(date);\n  if (Number.isNaN(value.getTime())) return \"\";\n  return format(value, \"dd/MM/yyyy\");\n}\n\nexport function formatDateForDisplay(dateStr: unknown): string {\n  if (!dateStr) return \"\";\n  const date = parseLocalDate(dateStr);\n  if (!date) return typeof dateStr === \"string\" ? dateStr : \"\";\n  return formatDate(date);\n}\n\n/**\n * Id cho tệp đính kèm. `crypto.randomUUID` chỉ có ở secure context (https/localhost) —\n * app nội bộ chạy http trong mạng bệnh viện sẽ không có, nên phải có đường lui.\n */\nexport function generateFileId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n  return `file-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/**\n * Chép text vào clipboard. `navigator.clipboard` cũng chỉ có ở secure context,\n * nên rơi về `document.execCommand(\"copy\")` (đã deprecated nhưng vẫn chạy mọi trình duyệt).\n * Ném lỗi khi cả hai đường đều không dùng được để phía gọi báo toast.\n */\nexport async function writeClipboardText(text: string): Promise<void> {\n  if (typeof navigator !== \"undefined\" && navigator.clipboard?.writeText) {\n    try {\n      await navigator.clipboard.writeText(text);\n      return;\n    } catch {\n      // Bị chặn quyền → thử đường lui bên dưới\n    }\n  }\n\n  if (!copyWithExecCommand(text)) {\n    throw new Error(\"Clipboard không khả dụng\");\n  }\n}\n\nfunction copyWithExecCommand(text: string): boolean {\n  if (typeof document === \"undefined\") return false;\n\n  const textarea = document.createElement(\"textarea\");\n  textarea.value = text;\n  textarea.setAttribute(\"readonly\", \"\");\n  textarea.style.position = \"fixed\";\n  textarea.style.top = \"0\";\n  textarea.style.insetInlineStart = \"-9999px\";\n  document.body.appendChild(textarea);\n\n  const previouslyFocused = document.activeElement;\n  textarea.select();\n\n  let copied = false;\n  try {\n    copied = document.execCommand(\"copy\");\n  } catch {\n    copied = false;\n  }\n\n  document.body.removeChild(textarea);\n  if (previouslyFocused instanceof HTMLElement) {\n    previouslyFocused.focus();\n  }\n\n  return copied;\n}\n\n/** Đọc clipboard khi có quyền; trả `null` nếu trình duyệt/ngữ cảnh không cho đọc. */\nexport async function readClipboardText(): Promise<string | null> {\n  if (typeof navigator === \"undefined\" || !navigator.clipboard?.readText) return null;\n  try {\n    return await navigator.clipboard.readText();\n  } catch {\n    return null;\n  }\n}\n\nexport function formatFileSize(bytes: number): string {\n  if (bytes <= 0 || !Number.isFinite(bytes)) return \"0 B\";\n  const k = 1024;\n  const sizes = [\"B\", \"KB\", \"MB\", \"GB\"];\n  const i = Math.min(sizes.length - 1, Math.floor(Math.log(bytes) / Math.log(k)));\n  return `${Number.parseFloat((bytes / k ** i).toFixed(1))} ${sizes[i]}`;\n}\n\nexport function getFileIcon(type: string): React.ComponentType<React.SVGProps<SVGSVGElement>> {\n  if (type.startsWith(\"image/\")) return FileImage;\n  if (type.startsWith(\"video/\")) return FileVideo;\n  if (type.startsWith(\"audio/\")) return FileAudio;\n  if (type.includes(\"pdf\")) return FileText;\n  if (type.includes(\"zip\") || type.includes(\"rar\")) return FileArchive;\n  if (type.includes(\"word\") || type.includes(\"document\") || type.includes(\"doc\")) return FileText;\n  if (type.includes(\"sheet\") || type.includes(\"excel\") || type.includes(\"xls\")) return FileSpreadsheet;\n  if (type.includes(\"presentation\") || type.includes(\"powerpoint\") || type.includes(\"ppt\")) return Presentation;\n  return File;\n}\n"],"mappings":"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","names":["rows"]}
+{"version":3,"sources":["../../src/data-grid/utils.ts"],"sourcesContent":["import type { Column, Table } from \"@tanstack/react-table\";\nimport { type Locale as DateFnsLocale, format, isValid, parse } from \"date-fns\";\nimport {\n  BaselineIcon,\n  CalendarIcon,\n  CheckSquareIcon,\n  File,\n  FileArchive,\n  FileAudio,\n  FileIcon,\n  FileImage,\n  FileSpreadsheet,\n  FileText,\n  FileVideo,\n  HashIcon,\n  LinkIcon,\n  ListChecksIcon,\n  ListIcon,\n  Presentation,\n  WrapTextIcon\n} from \"lucide-react\";\nimport type * as React from \"react\";\nimport { type DataGridMessages, getDataGridMessages } from \"./messages.js\";\nimport type { CellOpts, CellPosition, Direction, FileCellData, RowHeightValue } from \"./types.js\";\n\nexport function flexRender<TProps extends object>(\n  Comp: ((props: TProps) => React.ReactNode) | string | undefined,\n  props: TProps\n): React.ReactNode {\n  if (typeof Comp === \"string\") {\n    return Comp;\n  }\n  return Comp?.(props);\n}\n\nexport function getIsFileCellData(item: unknown): item is FileCellData {\n  return !!item && typeof item === \"object\" && \"id\" in item && \"name\" in item && \"size\" in item && \"type\" in item;\n}\n\nexport function matchSelectOption(value: string, options: { value: string; label: string }[]): string | undefined {\n  return options.find(\n    (o) =>\n      o.value === value ||\n      o.value.toLowerCase() === value.toLowerCase() ||\n      o.label.toLowerCase() === value.toLowerCase()\n  )?.value;\n}\n\nexport function getCellKey(rowIndex: number, columnId: string) {\n  return `${rowIndex}:${columnId}`;\n}\n\nexport function parseCellKey(cellKey: string): Required<CellPosition> {\n  const parts = cellKey.split(\":\");\n  const rowIndexStr = parts[0];\n  const columnId = parts[1];\n  if (rowIndexStr && columnId) {\n    const rowIndex = parseInt(rowIndexStr, 10);\n    if (!Number.isNaN(rowIndex)) {\n      return { rowIndex, columnId };\n    }\n  }\n  return { rowIndex: 0, columnId: \"\" };\n}\n\nexport function getRowHeightValue(rowHeight: RowHeightValue): number {\n  const rowHeightMap: Record<RowHeightValue, number> = {\n    short: 36,\n    medium: 56,\n    tall: 76,\n    \"extra-tall\": 96\n  };\n\n  return rowHeightMap[rowHeight];\n}\n\nexport function getLineCount(rowHeight: RowHeightValue): number {\n  const lineCountMap: Record<RowHeightValue, number> = {\n    short: 1,\n    medium: 2,\n    tall: 3,\n    \"extra-tall\": 4\n  };\n\n  return lineCountMap[rowHeight];\n}\n\nexport function getColumnBorderVisibility<TData>(params: {\n  column: Column<TData>;\n  nextColumn?: Column<TData>;\n  isLastColumn: boolean;\n}): {\n  showEndBorder: boolean;\n  showStartBorder: boolean;\n} {\n  const { column, nextColumn, isLastColumn } = params;\n\n  const isPinned = column.getIsPinned();\n  const isFirstRightPinnedColumn = isPinned === \"right\" && column.getIsFirstColumn(\"right\");\n  const isLastRightPinnedColumn = isPinned === \"right\" && column.getIsLastColumn(\"right\");\n\n  const nextIsPinned = nextColumn?.getIsPinned();\n  const isBeforeRightPinned = nextIsPinned === \"right\" && nextColumn?.getIsFirstColumn(\"right\");\n\n  const showEndBorder = !isBeforeRightPinned && (isLastColumn || !isLastRightPinnedColumn);\n\n  const showStartBorder = isFirstRightPinnedColumn;\n\n  return {\n    showEndBorder,\n    showStartBorder\n  };\n}\n\nexport function getColumnPinningStyle<TData>(params: {\n  column: Column<TData>;\n  withBorder?: boolean;\n  dir?: Direction;\n}): React.CSSProperties {\n  const { column, dir = \"ltr\", withBorder = false } = params;\n\n  const isPinned = column.getIsPinned();\n  const isLastLeftPinnedColumn = isPinned === \"left\" && column.getIsLastColumn(\"left\");\n  const isFirstRightPinnedColumn = isPinned === \"right\" && column.getIsFirstColumn(\"right\");\n\n  const isRtl = dir === \"rtl\";\n\n  const leftPosition = isPinned === \"left\" ? `${column.getStart(\"left\")}px` : undefined;\n  const rightPosition = isPinned === \"right\" ? `${column.getAfter(\"right\")}px` : undefined;\n\n  /*\n   * ⚠ Token của gói này là MÀU ĐẦY ĐỦ (`--card: #ffffff`), KHÔNG phải bộ 3 kênh HSL — nên viết\n   * `var(--card)` trần, đừng bọc `hsl()`. Bản gốc port từ một hệ token kiểu `\"150 20% 98%\"` nên\n   * ở đó `hsl(var(--card))` mới đúng; bê nguyên sang đây thì `hsl(#ffffff)` là giá trị KHÔNG\n   * HỢP LỆ, và hệ quả là cột ghim trong suốt — nội dung cuộn phía dưới lộ xuyên qua. Không có\n   * lỗi nào được ném ra: CSS bỏ qua khai báo hỏng rồi rơi về `background: transparent`.\n   *\n   * Nền lấy theo `--card` vì hộp lưới dùng `bg-card` như mọi bảng khác của gói.\n   */\n  return {\n    boxShadow: withBorder\n      ? isLastLeftPinnedColumn\n        ? isRtl\n          ? \"4px 0 4px -4px var(--border) inset\"\n          : \"-4px 0 4px -4px var(--border) inset\"\n        : isFirstRightPinnedColumn\n          ? isRtl\n            ? \"-4px 0 4px -4px var(--border) inset\"\n            : \"4px 0 4px -4px var(--border) inset\"\n          : undefined\n      : undefined,\n    left: isRtl ? rightPosition : leftPosition,\n    right: isRtl ? leftPosition : rightPosition,\n    opacity: isPinned ? 0.97 : 1,\n    position: isPinned ? \"sticky\" : \"relative\",\n    background: \"var(--card)\",\n    width: column.getSize(),\n    zIndex: isPinned ? 1 : undefined\n  };\n}\n\nexport function getScrollDirection(direction: string): \"left\" | \"right\" | \"home\" | \"end\" | undefined {\n  if (direction === \"left\" || direction === \"right\" || direction === \"home\" || direction === \"end\") {\n    return direction as \"left\" | \"right\" | \"home\" | \"end\";\n  }\n  if (direction === \"pageleft\") return \"left\";\n  if (direction === \"pageright\") return \"right\";\n  return undefined;\n}\n\nexport function scrollCellIntoView<TData>(params: {\n  container: HTMLDivElement;\n  targetCell: HTMLDivElement;\n  tableRef: React.RefObject<Table<TData> | null>;\n  viewportOffset: number;\n  direction?: \"left\" | \"right\" | \"home\" | \"end\";\n  isRtl: boolean;\n}): void {\n  const { container, targetCell, tableRef, direction, viewportOffset, isRtl } = params;\n\n  const containerRect = container.getBoundingClientRect();\n  const cellRect = targetCell.getBoundingClientRect();\n\n  const hasNegativeScroll = container.scrollLeft < 0;\n  const isActuallyRtl = isRtl || hasNegativeScroll;\n\n  const currentTable = tableRef.current;\n  const leftPinnedColumns = currentTable?.getLeftVisibleLeafColumns() ?? [];\n  const rightPinnedColumns = currentTable?.getRightVisibleLeafColumns() ?? [];\n\n  const leftPinnedWidth = leftPinnedColumns.reduce((sum, c) => sum + c.getSize(), 0);\n  const rightPinnedWidth = rightPinnedColumns.reduce((sum, c) => sum + c.getSize(), 0);\n\n  const viewportLeft = isActuallyRtl\n    ? containerRect.left + rightPinnedWidth + viewportOffset\n    : containerRect.left + leftPinnedWidth + viewportOffset;\n  const viewportRight = isActuallyRtl\n    ? containerRect.right - leftPinnedWidth - viewportOffset\n    : containerRect.right - rightPinnedWidth - viewportOffset;\n\n  const isFullyVisible = cellRect.left >= viewportLeft && cellRect.right <= viewportRight;\n\n  if (isFullyVisible) return;\n\n  const isClippedLeft = cellRect.left < viewportLeft;\n  const isClippedRight = cellRect.right > viewportRight;\n\n  let scrollDelta = 0;\n\n  if (!direction) {\n    if (isClippedRight) {\n      scrollDelta = cellRect.right - viewportRight;\n    } else if (isClippedLeft) {\n      scrollDelta = -(viewportLeft - cellRect.left);\n    }\n  } else {\n    const shouldScrollRight = isActuallyRtl\n      ? direction === \"right\" || direction === \"home\"\n      : direction === \"right\" || direction === \"end\";\n\n    if (shouldScrollRight) {\n      scrollDelta = cellRect.right - viewportRight;\n    } else {\n      scrollDelta = -(viewportLeft - cellRect.left);\n    }\n  }\n\n  container.scrollLeft += scrollDelta;\n}\n\nfunction countTabs(s: string): number {\n  let n = 0;\n  for (let i = 0; i < s.length; i++) if (s[i] === \"\\t\") n++;\n  return n;\n}\n\nexport function parseTsv(text: string, fallbackColumnCount: number): string[][] {\n  if (text.startsWith('\"') || text.includes('\\t\"')) {\n    const rows: string[][] = [];\n    let currentRow: string[] = [];\n    let currentField = \"\";\n    let inQuotes = false;\n    let i = 0;\n\n    while (i < text.length) {\n      const char = text[i];\n      const nextChar = text[i + 1];\n\n      if (inQuotes) {\n        if (char === '\"' && nextChar === '\"') {\n          currentField += '\"';\n          i += 2;\n        } else if (char === '\"') {\n          inQuotes = false;\n          i++;\n        } else {\n          currentField += char;\n          i++;\n        }\n      } else {\n        if (char === '\"' && currentField === \"\") {\n          inQuotes = true;\n          i++;\n        } else if (char === \"\\t\") {\n          currentRow.push(currentField);\n          currentField = \"\";\n          i++;\n        } else if (char === \"\\n\") {\n          currentRow.push(currentField);\n          if (currentRow.length > 1 || currentRow.some((f) => f.length > 0)) {\n            rows.push(currentRow);\n          }\n          currentRow = [];\n          currentField = \"\";\n          i++;\n        } else if (char === \"\\r\" && nextChar === \"\\n\") {\n          currentRow.push(currentField);\n          if (currentRow.length > 1 || currentRow.some((f) => f.length > 0)) {\n            rows.push(currentRow);\n          }\n          currentRow = [];\n          currentField = \"\";\n          i += 2;\n        } else {\n          currentField += char;\n          i++;\n        }\n      }\n    }\n\n    currentRow.push(currentField);\n    if (currentRow.length > 1 || currentRow.some((f) => f.length > 0)) {\n      rows.push(currentRow);\n    }\n\n    return rows;\n  }\n\n  const lines = text.split(\"\\n\").map((l) => l.replace(/\\r$/, \"\"));\n  let maxTabCount = 0;\n  for (const line of lines) {\n    const n = countTabs(line);\n    if (n > maxTabCount) maxTabCount = n;\n  }\n  const columnCount = maxTabCount > 0 ? maxTabCount + 1 : fallbackColumnCount;\n  if (columnCount <= 0) return [];\n\n  const expectedTabCount = columnCount - 1;\n  const rows: string[][] = [];\n  let buf = \"\";\n  let bufTabCount = 0;\n\n  for (const line of lines) {\n    const tc = countTabs(line);\n\n    if (tc === expectedTabCount) {\n      if (buf && bufTabCount === expectedTabCount) rows.push(buf.split(\"\\t\"));\n      buf = \"\";\n      bufTabCount = 0;\n      rows.push(line.split(\"\\t\"));\n    } else {\n      buf = buf ? `${buf}\\n${line}` : line;\n      bufTabCount += tc;\n      if (bufTabCount === expectedTabCount) {\n        rows.push(buf.split(\"\\t\"));\n        buf = \"\";\n        bufTabCount = 0;\n      }\n    }\n  }\n\n  if (buf && bufTabCount === expectedTabCount) rows.push(buf.split(\"\\t\"));\n\n  return rows.length > 0 ? rows : lines.filter((l) => l.length > 0).map((l) => l.split(\"\\t\"));\n}\n\n/**\n * Phần tử có đang nằm trong một lớp nổi không? Dùng để lưới KHÔNG coi thao tác\n * trong popover/menu/hộp thoại là \"bấm ra ngoài\" (sẽ mất focus ô đang sửa).\n *\n * Primitive của package không gắn `data-slot`, nên bắt theo wrapper của Radix Popper\n * (bao Popover/DropdownMenu/Select/Tooltip) và theo role — kể cả Select \"item-aligned\".\n */\nexport function getIsInPopover(element: unknown): boolean {\n  if (!(element instanceof Element)) return false;\n\n  return (\n    element.closest(\"[data-grid-cell-editor]\") !== null ||\n    element.closest(\"[data-grid-popover]\") !== null ||\n    element.closest(\"[data-radix-popper-content-wrapper]\") !== null ||\n    element.closest(\"[role='dialog']\") !== null ||\n    element.closest(\"[role='menu']\") !== null ||\n    element.closest(\"[role='listbox']\") !== null\n  );\n}\n\n/**\n * Icon + tên kiểu dữ liệu của một cột (hiện trong tooltip ở tiêu đề cột).\n *\n * `messages` bỏ trống = bảng mặc định (tiếng Anh), giữ đúng chữ ký của `1.11.0`. Component nào\n * vẽ nhãn này cho người dùng thì PHẢI truyền bảng đang có hiệu lực vào — quên là tooltip nói\n * tiếng Anh giữa một lưới tiếng Việt.\n */\nexport function getColumnVariant(\n  variant?: CellOpts[\"variant\"],\n  messages?: DataGridMessages\n): {\n  icon: React.ComponentType<React.SVGProps<SVGSVGElement>>;\n  label: string;\n} | null {\n  const msg = messages ?? getDataGridMessages();\n  switch (variant) {\n    case \"short-text\":\n      return { label: msg.column.variant.shortText, icon: BaselineIcon };\n    case \"long-text\":\n      return { label: msg.column.variant.longText, icon: WrapTextIcon };\n    case \"number\":\n      return { label: msg.column.variant.number, icon: HashIcon };\n    case \"url\":\n      return { label: msg.column.variant.url, icon: LinkIcon };\n    case \"checkbox\":\n      return { label: msg.column.variant.checkbox, icon: CheckSquareIcon };\n    case \"select\":\n      return { label: msg.column.variant.select, icon: ListIcon };\n    case \"multi-select\":\n      return { label: msg.column.variant.multiSelect, icon: ListChecksIcon };\n    case \"date\":\n      return { label: msg.column.variant.date, icon: CalendarIcon };\n    case \"file\":\n      return { label: msg.column.variant.file, icon: FileIcon };\n    default:\n      return null;\n  }\n}\n\nexport function getEmptyCellValue(variant: CellOpts[\"variant\"] | undefined): unknown {\n  if (variant === \"multi-select\" || variant === \"file\") return [];\n  if (variant === \"number\" || variant === \"date\" || variant === \"select\") return null;\n  if (variant === \"checkbox\") return false;\n  return \"\";\n}\n\nexport function getUrlHref(urlString: string): string {\n  if (!urlString || urlString.trim() === \"\") return \"\";\n\n  const trimmed = urlString.trim();\n\n  // Reject dangerous protocols (extra safety, though our http:// prefix would neutralize them)\n  if (/^(javascript|data|vbscript|file):/i.test(trimmed)) {\n    return \"\";\n  }\n\n  if (trimmed.startsWith(\"http://\") || trimmed.startsWith(\"https://\")) {\n    return trimmed;\n  }\n\n  return `http://${trimmed}`;\n}\n\nexport function parseLocalDate(dateStr: unknown): Date | null {\n  if (!dateStr) return null;\n  if (dateStr instanceof Date) return dateStr;\n  if (typeof dateStr !== \"string\") return null;\n  const [year, month, day] = dateStr.split(\"-\").map(Number);\n  if (!year || !month || !day) return null;\n  const date = new Date(year, month - 1, day);\n  // Verify date wasn't auto-corrected (e.g. Feb 30 -> Mar 1)\n  if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {\n    return null;\n  }\n  return date;\n}\n\nexport function formatDateToString(date: Date): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  return `${year}-${month}-${day}`;\n}\n\n/**\n * Mẫu định dạng ngày của lưới: ngày NGẮN theo locale date-fns — `en-US` ra `12/25/2024`,\n * `vi` / `en-GB` ra `25/12/2024`. Một mẫu cho cả hiển thị lẫn phép đọc lại ({@link parseDateInput}),\n * để thứ người dùng THẤY cũng là thứ dán vào được.\n */\nconst DATE_DISPLAY_FORMAT = \"P\";\n\n/**\n * Hiển thị ngày dạng ngắn theo `locale` (dùng cho ô ngày, bộ lọc ngày).\n *\n * Hàm THUẦN nên không đọc được ngôn ngữ của lưới: component truyền locale đang có hiệu lực vào\n * (`useDataGridDateLocale()`). Bỏ trống `locale` = locale mặc định của date-fns (`enUS`, trừ khi\n * app đã đổi bằng `setDefaultOptions`).\n *\n * ⚠ Trước `3.0.0` hàm này luôn ra `dd/MM/yyyy` bất kể ngôn ngữ. Cần lại đúng chuỗi cũ thì truyền\n * `vi` (`import { vi } from \"date-fns/locale\"`).\n */\nexport function formatDate(date: Date | string | number | null | undefined, locale?: DateFnsLocale): string {\n  if (!date) return \"\";\n  const value = date instanceof Date ? date : new Date(date);\n  if (Number.isNaN(value.getTime())) return \"\";\n  return format(value, DATE_DISPLAY_FORMAT, { locale });\n}\n\n/** Như {@link formatDate}, cho giá trị thô của ô ngày (`yyyy-MM-dd` hoặc `Date`). */\nexport function formatDateForDisplay(dateStr: unknown, locale?: DateFnsLocale): string {\n  if (!dateStr) return \"\";\n  const date = parseLocalDate(dateStr);\n  if (!date) return typeof dateStr === \"string\" ? dateStr : \"\";\n  return formatDate(date, locale);\n}\n\n/**\n * Đọc chuỗi ngày DÁN vào ô ngày. Thử dạng ngắn của `locale` trước — đúng dạng lưới đang hiển\n * thị, nên `25/12/2024` dán vào lưới tiếng Việt là 25 tháng 12, không phải lỗi — rồi mới tới\n * `new Date()` (ISO `yyyy-MM-dd`, và những gì JS tự hiểu). `null` khi không đọc được.\n *\n * Năm phải đủ 4 chữ số: mẫu `\"P\"` đọc `25/12/24` thành năm 24 sau Công nguyên, một ngày \"hợp lệ\"\n * mà không ai muốn — chuỗi như thế rơi xuống `new Date()` như trước.\n */\nexport function parseDateInput(text: string, locale?: DateFnsLocale): Date | null {\n  const trimmed = text.trim();\n  if (!trimmed) return null;\n  const localized = parse(trimmed, DATE_DISPLAY_FORMAT, new Date(), { locale });\n  if (isValid(localized) && localized.getFullYear() >= 1000) return localized;\n  const date = new Date(trimmed);\n  return Number.isNaN(date.getTime()) ? null : date;\n}\n\n/**\n * Id cho tệp đính kèm. `crypto.randomUUID` chỉ có ở secure context (https/localhost) —\n * app nội bộ chạy http trong mạng bệnh viện sẽ không có, nên phải có đường lui.\n */\nexport function generateFileId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n  return `file-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/**\n * Chép text vào clipboard. `navigator.clipboard` cũng chỉ có ở secure context,\n * nên rơi về `document.execCommand(\"copy\")` (đã deprecated nhưng vẫn chạy mọi trình duyệt).\n * Ném lỗi khi cả hai đường đều không dùng được để phía gọi báo toast.\n */\nexport async function writeClipboardText(text: string): Promise<void> {\n  if (typeof navigator !== \"undefined\" && navigator.clipboard?.writeText) {\n    try {\n      await navigator.clipboard.writeText(text);\n      return;\n    } catch {\n      // Bị chặn quyền → thử đường lui bên dưới\n    }\n  }\n\n  if (!copyWithExecCommand(text)) {\n    throw new Error(\"Clipboard không khả dụng\");\n  }\n}\n\nfunction copyWithExecCommand(text: string): boolean {\n  if (typeof document === \"undefined\") return false;\n\n  const textarea = document.createElement(\"textarea\");\n  textarea.value = text;\n  textarea.setAttribute(\"readonly\", \"\");\n  textarea.style.position = \"fixed\";\n  textarea.style.top = \"0\";\n  textarea.style.insetInlineStart = \"-9999px\";\n  document.body.appendChild(textarea);\n\n  const previouslyFocused = document.activeElement;\n  textarea.select();\n\n  let copied = false;\n  try {\n    copied = document.execCommand(\"copy\");\n  } catch {\n    copied = false;\n  }\n\n  document.body.removeChild(textarea);\n  if (previouslyFocused instanceof HTMLElement) {\n    previouslyFocused.focus();\n  }\n\n  return copied;\n}\n\n/** Đọc clipboard khi có quyền; trả `null` nếu trình duyệt/ngữ cảnh không cho đọc. */\nexport async function readClipboardText(): Promise<string | null> {\n  if (typeof navigator === \"undefined\" || !navigator.clipboard?.readText) return null;\n  try {\n    return await navigator.clipboard.readText();\n  } catch {\n    return null;\n  }\n}\n\nexport function formatFileSize(bytes: number): string {\n  if (bytes <= 0 || !Number.isFinite(bytes)) return \"0 B\";\n  const k = 1024;\n  const sizes = [\"B\", \"KB\", \"MB\", \"GB\"];\n  const i = Math.min(sizes.length - 1, Math.floor(Math.log(bytes) / Math.log(k)));\n  return `${Number.parseFloat((bytes / k ** i).toFixed(1))} ${sizes[i]}`;\n}\n\nexport function getFileIcon(type: string): React.ComponentType<React.SVGProps<SVGSVGElement>> {\n  if (type.startsWith(\"image/\")) return FileImage;\n  if (type.startsWith(\"video/\")) return FileVideo;\n  if (type.startsWith(\"audio/\")) return FileAudio;\n  if (type.includes(\"pdf\")) return FileText;\n  if (type.includes(\"zip\") || type.includes(\"rar\")) return FileArchive;\n  if (type.includes(\"word\") || type.includes(\"document\") || type.includes(\"doc\")) return FileText;\n  if (type.includes(\"sheet\") || type.includes(\"excel\") || type.includes(\"xls\")) return FileSpreadsheet;\n  if (type.includes(\"presentation\") || type.includes(\"powerpoint\") || type.includes(\"ppt\")) return Presentation;\n  return File;\n}\n"],"mappings":"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","names":["rows"]}

package/dist/i18n/locale-provider.d.ts

@@ -0,0 +1,127 @@
+import { Locale } from 'date-fns';
+import * as React from 'react';
+import { ComitorLanguage } from './locale.js';
+import { ComitorMessagesOverride, ComitorMessages } from './messages.js';
+import './namespaces/toast.js';
+import './namespaces/tags-input.js';
+import './namespaces/spinner.js';
+import '../shell/types.js';
+import 'lucide-react';
+import './namespaces/sheet.js';
+import './namespaces/scroll-spy.js';
+import './namespaces/route-tabs.js';
+import './namespaces/rating.js';
+import './namespaces/pagination.js';
+import './namespaces/mention.js';
+import './namespaces/inline-edit.js';
+import './namespaces/filter-chips.js';
+import '../uploader/file-upload-constants.js';
+import './namespaces/display-axis.js';
+import './namespaces/dialog.js';
+import './namespaces/date-picker.js';
+import '../components/composite/date-picker-constants.js';
+import 'react-day-picker';
+import './namespaces/copy-button.js';
+import '../shell/contrast-constants.js';
+import './namespaces/confirm-dialog.js';
+import './namespaces/command-palette.js';
+import '../components/composite/command-palette-constants.js';
+import './namespaces/command.js';
+import './namespaces/combobox.js';
+import './namespaces/carousel.js';
+import './namespaces/calendar.js';
+import './namespaces/breadcrumb.js';
+import './namespaces/banner.js';
+import './namespaces/badge-overflow.js';
+import './namespaces/avatar-group.js';
+import '../components/composite/data-table-constants.js';
+import '../components/composite/search-filter-bar-constants.js';
+import '../components/composite/table-pagination-constants.js';
+import '../components/ui/action-bar-constants.js';
+import '../components/ui/cropper-constants.js';
+import '../components/ui/kanban-constants.js';
+import '@dnd-kit/core';
+import '../components/ui/key-value-constants.js';
+import '../components/ui/phone-input-constants.js';
+import '../components/ui/stepper-constants.js';
+import '../components/ui/time-picker-constants.js';
+import '../components/ui/tour-constants.js';
+
+/**
+ * Ngôn ngữ của CẢ gói, đi xuống cây bằng context — một lần ở root, mọi component đọc theo.
+ *
+ * ─ THỨ TỰ ƯU TIÊN, cho mọi chuỗi và mọi định dạng ─
+ *   prop của chính component (`labels`, `placeholder`, `locale`…) → provider gần nhất → `"en"`.
+ * Không có provider thì gói chạy tiếng Anh — đúng cho app quốc tế, và đúng cho Storybook/test.
+ *
+ * ─ APP COMITOR: LUÔN truyền ngôn ngữ từ thiết lập của NGƯỜI DÙNG ─
+ * Ngôn ngữ của app Comitor sống ở hồ sơ Account (gieo vào cookie, đọc bằng `next-intl`). Bọc một
+ * lần ở root layout, TRONG `NextIntlClientProvider`:
+ *
+ * ```tsx
+ * const locale = await getLocale(); // next-intl/server
+ * <ComitorLocaleProvider locale={locale}>{children}</ComitorLocaleProvider>
+ * ```
+ *
+ * ⚠ Đừng để mặc định: từ `3.0.0` mặc định là tiếng Anh, nên một app Comitor quên dòng này sẽ hiện
+ * nút "Cancel" giữa màn hình tiếng Việt — không lỗi, không cảnh báo.
+ */
+interface ComitorLocaleContextValue {
+    /** Mã BCP 47 app truyền vào — dùng cho mọi phép định dạng `Intl`. */
+    locale: string;
+    /** Bảng chữ dựng sẵn được chọn từ `locale`. */
+    language: ComitorLanguage;
+    /** Bảng chữ đầy đủ đang có hiệu lực (đã trộn phần ghi đè của app). */
+    messages: ComitorMessages;
+    /** Locale của date-fns cho các component định dạng ngày bằng date-fns. */
+    dateFnsLocale: Locale;
+}
+interface ComitorLocaleProviderProps {
+    /**
+     * Mã BCP 47: `"vi"`, `"en"`, `"en-GB"`… Chọn bảng chữ dựng sẵn (xem `getComitorLanguage`) VÀ
+     * quyết định định dạng ngày/giờ/số. App Comitor truyền `getLocale()` / `useLocale()` của next-intl.
+     */
+    locale?: string;
+    /**
+     * Ghi đè một phần bảng chữ (theo namespace), hoặc cấp nguyên một bảng cho ngôn ngữ không dựng sẵn.
+     * ⚠ Giữ tham chiếu ỔN ĐỊNH (hằng module hoặc `useMemo`) — object mới mỗi lượt render làm mọi
+     * component đọc chữ render lại.
+     * ⚠ Có khoá là HÀM (vd `tablePagination.range`) thì object này không đi qua ranh giới server →
+     * client được: khai nó trong một component `"use client"` của app, đừng truyền từ root layout.
+     */
+    messages?: ComitorMessagesOverride;
+    /**
+     * Locale date-fns thay cho mặc định (`enUS` cho mọi mã không phải tiếng Việt). Cần khi app muốn
+     * định dạng kiểu Anh (`enGB`) hay một ngôn ngữ date-fns có sẵn khác.
+     *
+     * ⚠ Locale date-fns là object toàn HÀM — root layout của Next là Server Component, và truyền nó
+     * thẳng từ đó làm trang lỗi 500 ("Functions cannot be passed directly to Client Components"; đo
+     * trên Next 16 ở comitor-ds, 3.0.0). Đặt provider trong một component `"use client"` của app rồi
+     * render component đó từ layout:
+     *
+     * ```tsx
+     * "use client";
+     * export function ComitorLocale({ locale, children }: { locale: string; children: React.ReactNode }) {
+     *   return (
+     *     <ComitorLocaleProvider locale={locale} dateFnsLocale={locale === "en-GB" ? enGB : undefined}>
+     *       {children}
+     *     </ComitorLocaleProvider>
+     *   );
+     * }
+     * ```
+     */
+    dateFnsLocale?: Locale;
+    children: React.ReactNode;
+}
+declare function ComitorLocaleProvider({ locale, messages, dateFnsLocale, children }: ComitorLocaleProviderProps): React.JSX.Element;
+/** Ngôn ngữ đang có hiệu lực: `locale` (cho `Intl`), `language`, bảng chữ, locale date-fns. */
+declare function useComitorLocale(): ComitorLocaleContextValue;
+/** Chữ của MỘT namespace theo provider gần nhất (hoặc tiếng Anh khi không có provider). */
+declare function useComitorMessages<K extends keyof ComitorMessages>(namespace: K): ComitorMessages[K];
+/**
+ * Chữ của một namespace, đã trộn `labels` của chính component lên trên — đúng thứ tự ưu tiên
+ * prop → provider → `"en"`. Dành cho component có prop `labels?: Partial<…>`.
+ */
+declare function useComitorLabels<K extends keyof ComitorMessages>(namespace: K, labels?: Partial<ComitorMessages[K]>): ComitorMessages[K];
+
+export { ComitorLocaleProvider, type ComitorLocaleProviderProps, useComitorLabels, useComitorLocale, useComitorMessages };

package/dist/i18n/locale-provider.js

@@ -0,0 +1,47 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { enUS, vi } from "date-fns/locale";
+import * as React from "react";
+import { DEFAULT_COMITOR_LOCALE, getComitorLanguage } from "./locale.js";
+import { getComitorMessages } from "./messages.js";
+const DATE_FNS_LOCALES = { en: enUS, vi };
+function buildContextValue(locale, override, dateFnsLocale) {
+  const language = getComitorLanguage(locale);
+  return {
+    locale,
+    language,
+    messages: getComitorMessages(locale, override),
+    dateFnsLocale: dateFnsLocale ?? DATE_FNS_LOCALES[language]
+  };
+}
+const DEFAULT_CONTEXT_VALUE = buildContextValue(DEFAULT_COMITOR_LOCALE);
+const ComitorLocaleContext = React.createContext(DEFAULT_CONTEXT_VALUE);
+function ComitorLocaleProvider({
+  locale = DEFAULT_COMITOR_LOCALE,
+  messages,
+  dateFnsLocale,
+  children
+}) {
+  const value = React.useMemo(
+    () => buildContextValue(locale, messages, dateFnsLocale),
+    [locale, messages, dateFnsLocale]
+  );
+  return /* @__PURE__ */ jsx(ComitorLocaleContext.Provider, { value, children });
+}
+function useComitorLocale() {
+  return React.useContext(ComitorLocaleContext);
+}
+function useComitorMessages(namespace) {
+  return React.useContext(ComitorLocaleContext).messages[namespace];
+}
+function useComitorLabels(namespace, labels) {
+  const base = useComitorMessages(namespace);
+  return React.useMemo(() => labels ? { ...base, ...labels } : base, [base, labels]);
+}
+export {
+  ComitorLocaleProvider,
+  useComitorLabels,
+  useComitorLocale,
+  useComitorMessages
+};
+//# sourceMappingURL=locale-provider.js.map

package/dist/i18n/locale-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/i18n/locale-provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { Locale as DateFnsLocale } from \"date-fns\";\nimport { enUS, vi } from \"date-fns/locale\";\nimport * as React from \"react\";\nimport { type ComitorLanguage, DEFAULT_COMITOR_LOCALE, getComitorLanguage } from \"./locale.js\";\nimport { type ComitorMessages, type ComitorMessagesOverride, getComitorMessages } from \"./messages.js\";\n\n/**\n * Ngôn ngữ của CẢ gói, đi xuống cây bằng context — một lần ở root, mọi component đọc theo.\n *\n * ─ THỨ TỰ ƯU TIÊN, cho mọi chuỗi và mọi định dạng ─\n *   prop của chính component (`labels`, `placeholder`, `locale`…) → provider gần nhất → `\"en\"`.\n * Không có provider thì gói chạy tiếng Anh — đúng cho app quốc tế, và đúng cho Storybook/test.\n *\n * ─ APP COMITOR: LUÔN truyền ngôn ngữ từ thiết lập của NGƯỜI DÙNG ─\n * Ngôn ngữ của app Comitor sống ở hồ sơ Account (gieo vào cookie, đọc bằng `next-intl`). Bọc một\n * lần ở root layout, TRONG `NextIntlClientProvider`:\n *\n * ```tsx\n * const locale = await getLocale(); // next-intl/server\n * <ComitorLocaleProvider locale={locale}>{children}</ComitorLocaleProvider>\n * ```\n *\n * ⚠ Đừng để mặc định: từ `3.0.0` mặc định là tiếng Anh, nên một app Comitor quên dòng này sẽ hiện\n * nút \"Cancel\" giữa màn hình tiếng Việt — không lỗi, không cảnh báo.\n */\n\ninterface ComitorLocaleContextValue {\n  /** Mã BCP 47 app truyền vào — dùng cho mọi phép định dạng `Intl`. */\n  locale: string;\n  /** Bảng chữ dựng sẵn được chọn từ `locale`. */\n  language: ComitorLanguage;\n  /** Bảng chữ đầy đủ đang có hiệu lực (đã trộn phần ghi đè của app). */\n  messages: ComitorMessages;\n  /** Locale của date-fns cho các component định dạng ngày bằng date-fns. */\n  dateFnsLocale: DateFnsLocale;\n}\n\nconst DATE_FNS_LOCALES: Record<ComitorLanguage, DateFnsLocale> = { en: enUS, vi };\n\nfunction buildContextValue(\n  locale: string,\n  override?: ComitorMessagesOverride,\n  dateFnsLocale?: DateFnsLocale\n): ComitorLocaleContextValue {\n  const language = getComitorLanguage(locale);\n  return {\n    locale,\n    language,\n    messages: getComitorMessages(locale, override),\n    dateFnsLocale: dateFnsLocale ?? DATE_FNS_LOCALES[language]\n  };\n}\n\nconst DEFAULT_CONTEXT_VALUE = buildContextValue(DEFAULT_COMITOR_LOCALE);\n\nconst ComitorLocaleContext = React.createContext<ComitorLocaleContextValue>(DEFAULT_CONTEXT_VALUE);\n\nexport interface ComitorLocaleProviderProps {\n  /**\n   * Mã BCP 47: `\"vi\"`, `\"en\"`, `\"en-GB\"`… Chọn bảng chữ dựng sẵn (xem `getComitorLanguage`) VÀ\n   * quyết định định dạng ngày/giờ/số. App Comitor truyền `getLocale()` / `useLocale()` của next-intl.\n   */\n  locale?: string;\n  /**\n   * Ghi đè một phần bảng chữ (theo namespace), hoặc cấp nguyên một bảng cho ngôn ngữ không dựng sẵn.\n   * ⚠ Giữ tham chiếu ỔN ĐỊNH (hằng module hoặc `useMemo`) — object mới mỗi lượt render làm mọi\n   * component đọc chữ render lại.\n   * ⚠ Có khoá là HÀM (vd `tablePagination.range`) thì object này không đi qua ranh giới server →\n   * client được: khai nó trong một component `\"use client\"` của app, đừng truyền từ root layout.\n   */\n  messages?: ComitorMessagesOverride;\n  /**\n   * Locale date-fns thay cho mặc định (`enUS` cho mọi mã không phải tiếng Việt). Cần khi app muốn\n   * định dạng kiểu Anh (`enGB`) hay một ngôn ngữ date-fns có sẵn khác.\n   *\n   * ⚠ Locale date-fns là object toàn HÀM — root layout của Next là Server Component, và truyền nó\n   * thẳng từ đó làm trang lỗi 500 (\"Functions cannot be passed directly to Client Components\"; đo\n   * trên Next 16 ở comitor-ds, 3.0.0). Đặt provider trong một component `\"use client\"` của app rồi\n   * render component đó từ layout:\n   *\n   * ```tsx\n   * \"use client\";\n   * export function ComitorLocale({ locale, children }: { locale: string; children: React.ReactNode }) {\n   *   return (\n   *     <ComitorLocaleProvider locale={locale} dateFnsLocale={locale === \"en-GB\" ? enGB : undefined}>\n   *       {children}\n   *     </ComitorLocaleProvider>\n   *   );\n   * }\n   * ```\n   */\n  dateFnsLocale?: DateFnsLocale;\n  children: React.ReactNode;\n}\n\nexport function ComitorLocaleProvider({\n  locale = DEFAULT_COMITOR_LOCALE,\n  messages,\n  dateFnsLocale,\n  children\n}: ComitorLocaleProviderProps) {\n  const value = React.useMemo(\n    () => buildContextValue(locale, messages, dateFnsLocale),\n    [locale, messages, dateFnsLocale]\n  );\n  return <ComitorLocaleContext.Provider value={value}>{children}</ComitorLocaleContext.Provider>;\n}\n\n/** Ngôn ngữ đang có hiệu lực: `locale` (cho `Intl`), `language`, bảng chữ, locale date-fns. */\nexport function useComitorLocale(): ComitorLocaleContextValue {\n  return React.useContext(ComitorLocaleContext);\n}\n\n/** Chữ của MỘT namespace theo provider gần nhất (hoặc tiếng Anh khi không có provider). */\nexport function useComitorMessages<K extends keyof ComitorMessages>(namespace: K): ComitorMessages[K] {\n  return React.useContext(ComitorLocaleContext).messages[namespace];\n}\n\n/**\n * Chữ của một namespace, đã trộn `labels` của chính component lên trên — đúng thứ tự ưu tiên\n * prop → provider → `\"en\"`. Dành cho component có prop `labels?: Partial<…>`.\n */\nexport function useComitorLabels<K extends keyof ComitorMessages>(\n  namespace: K,\n  labels?: Partial<ComitorMessages[K]>\n): ComitorMessages[K] {\n  const base = useComitorMessages(namespace);\n  return React.useMemo(() => (labels ? { ...base, ...labels } : base), [base, labels]);\n}\n"],"mappings":";AA2GS;AAxGT,SAAS,MAAM,UAAU;AACzB,YAAY,WAAW;AACvB,SAA+B,wBAAwB,0BAA0B;AACjF,SAA6D,0BAA0B;AAiCvF,MAAM,mBAA2D,EAAE,IAAI,MAAM,GAAG;AAEhF,SAAS,kBACP,QACA,UACA,eAC2B;AAC3B,QAAM,WAAW,mBAAmB,MAAM;AAC1C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,mBAAmB,QAAQ,QAAQ;AAAA,IAC7C,eAAe,iBAAiB,iBAAiB,QAAQ;AAAA,EAC3D;AACF;AAEA,MAAM,wBAAwB,kBAAkB,sBAAsB;AAEtE,MAAM,uBAAuB,MAAM,cAAyC,qBAAqB;AAwC1F,SAAS,sBAAsB;AAAA,EACpC,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA;AACF,GAA+B;AAC7B,QAAM,QAAQ,MAAM;AAAA,IAClB,MAAM,kBAAkB,QAAQ,UAAU,aAAa;AAAA,IACvD,CAAC,QAAQ,UAAU,aAAa;AAAA,EAClC;AACA,SAAO,oBAAC,qBAAqB,UAArB,EAA8B,OAAe,UAAS;AAChE;AAGO,SAAS,mBAA8C;AAC5D,SAAO,MAAM,WAAW,oBAAoB;AAC9C;AAGO,SAAS,mBAAoD,WAAkC;AACpG,SAAO,MAAM,WAAW,oBAAoB,EAAE,SAAS,SAAS;AAClE;AAMO,SAAS,iBACd,WACA,QACoB;AACpB,QAAM,OAAO,mBAAmB,SAAS;AACzC,SAAO,MAAM,QAAQ,MAAO,SAAS,EAAE,GAAG,MAAM,GAAG,OAAO,IAAI,MAAO,CAAC,MAAM,MAAM,CAAC;AACrF;","names":[]}

package/dist/i18n/locale.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Ngôn ngữ của gói — phần THUẦN (không directive, không hook), Server Component đọc được.
+ *
+ * Gói phân biệt hai thứ mà app hay gộp làm một:
+ *   · `locale` — mã BCP 47 đầy đủ app truyền vào (`"vi"`, `"en"`, `"en-GB"`, `"vi-VN"`…). Nó quyết
+ *     định ĐỊNH DẠNG: ngày, giờ, số, đồng hồ 12/24 giờ — đi thẳng vào `Intl`.
+ *   · `language` — bảng CHỮ dựng sẵn được chọn từ `locale` đó. Hiện có `"en"` và `"vi"`; mã khác
+ *     rơi về tiếng Anh (định dạng vẫn theo đúng `locale`), còn chữ thì app tự truyền bảng riêng
+ *     qua prop `messages` của `ComitorLocaleProvider`.
+ *
+ * ⚠ Nước và tiền tệ KHÔNG suy từ đây. Chúng là thiết lập của VÙNG / nghiệp vụ, không phải của ngôn
+ * ngữ: một người Việt ở Mỹ dùng giao diện tiếng Anh vẫn có thể bán hàng bằng VND. `PhoneInput`
+ * (nước mặc định) và `MaskInput` (tiền tệ) vì thế nhận prop riêng, app Comitor truyền từ cài đặt
+ * workspace.
+ */
+/** Ngôn ngữ có bảng chữ DỰNG SẴN trong gói. */
+type ComitorLanguage = "en" | "vi";
+/** Mặc định khi không ai truyền gì: tiếng Anh — gói phục vụ cả app quốc tế (từ `3.0.0`). */
+declare const DEFAULT_COMITOR_LOCALE = "en";
+/**
+ * Bảng chữ dựng sẵn cho một `locale`: `"vi"`, `"vi-VN"`, `"VI_vn"` → `"vi"`; mọi mã khác → `"en"`.
+ * Mã rỗng hay hỏng cũng rơi về `"en"` thay vì ném lỗi — một chuỗi lạ trong cookie ngôn ngữ không
+ * đáng làm trắng cả màn hình.
+ */
+declare function getComitorLanguage(locale?: string | null): ComitorLanguage;
+
+export { type ComitorLanguage, DEFAULT_COMITOR_LOCALE, getComitorLanguage };

package/dist/i18n/locale.js

@@ -0,0 +1,10 @@
+const DEFAULT_COMITOR_LOCALE = "en";
+function getComitorLanguage(locale) {
+  const primary = (locale ?? "").trim().toLowerCase().split(/[-_]/)[0];
+  return primary === "vi" ? "vi" : "en";
+}
+export {
+  DEFAULT_COMITOR_LOCALE,
+  getComitorLanguage
+};
+//# sourceMappingURL=locale.js.map

package/dist/i18n/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/i18n/locale.ts"],"sourcesContent":["/**\n * Ngôn ngữ của gói — phần THUẦN (không directive, không hook), Server Component đọc được.\n *\n * Gói phân biệt hai thứ mà app hay gộp làm một:\n *   · `locale` — mã BCP 47 đầy đủ app truyền vào (`\"vi\"`, `\"en\"`, `\"en-GB\"`, `\"vi-VN\"`…). Nó quyết\n *     định ĐỊNH DẠNG: ngày, giờ, số, đồng hồ 12/24 giờ — đi thẳng vào `Intl`.\n *   · `language` — bảng CHỮ dựng sẵn được chọn từ `locale` đó. Hiện có `\"en\"` và `\"vi\"`; mã khác\n *     rơi về tiếng Anh (định dạng vẫn theo đúng `locale`), còn chữ thì app tự truyền bảng riêng\n *     qua prop `messages` của `ComitorLocaleProvider`.\n *\n * ⚠ Nước và tiền tệ KHÔNG suy từ đây. Chúng là thiết lập của VÙNG / nghiệp vụ, không phải của ngôn\n * ngữ: một người Việt ở Mỹ dùng giao diện tiếng Anh vẫn có thể bán hàng bằng VND. `PhoneInput`\n * (nước mặc định) và `MaskInput` (tiền tệ) vì thế nhận prop riêng, app Comitor truyền từ cài đặt\n * workspace.\n */\n\n/** Ngôn ngữ có bảng chữ DỰNG SẴN trong gói. */\nexport type ComitorLanguage = \"en\" | \"vi\";\n\n/** Mặc định khi không ai truyền gì: tiếng Anh — gói phục vụ cả app quốc tế (từ `3.0.0`). */\nexport const DEFAULT_COMITOR_LOCALE = \"en\";\n\n/**\n * Bảng chữ dựng sẵn cho một `locale`: `\"vi\"`, `\"vi-VN\"`, `\"VI_vn\"` → `\"vi\"`; mọi mã khác → `\"en\"`.\n * Mã rỗng hay hỏng cũng rơi về `\"en\"` thay vì ném lỗi — một chuỗi lạ trong cookie ngôn ngữ không\n * đáng làm trắng cả màn hình.\n */\nexport function getComitorLanguage(locale?: string | null): ComitorLanguage {\n  const primary = (locale ?? \"\").trim().toLowerCase().split(/[-_]/)[0];\n  return primary === \"vi\" ? \"vi\" : \"en\";\n}\n"],"mappings":"AAoBO,MAAM,yBAAyB;AAO/B,SAAS,mBAAmB,QAAyC;AAC1E,QAAM,WAAW,UAAU,IAAI,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,EAAE,CAAC;AACnE,SAAO,YAAY,OAAO,OAAO;AACnC;","names":[]}

package/dist/i18n/messages.d.ts

@@ -0,0 +1,116 @@
+import { ToastMessages } from './namespaces/toast.js';
+import { TagsInputMessages } from './namespaces/tags-input.js';
+import { SpinnerMessages } from './namespaces/spinner.js';
+import { ShellLabels } from '../shell/types.js';
+import { SheetMessages } from './namespaces/sheet.js';
+import { ScrollSpyMessages } from './namespaces/scroll-spy.js';
+import { RouteTabsMessages } from './namespaces/route-tabs.js';
+import { RatingMessages } from './namespaces/rating.js';
+import { PaginationMessages } from './namespaces/pagination.js';
+import { MentionMessages } from './namespaces/mention.js';
+import { InlineEditMessages } from './namespaces/inline-edit.js';
+import { FilterChipsMessages } from './namespaces/filter-chips.js';
+import { FileUploadLabels, ImageUploadFieldLabels } from '../uploader/file-upload-constants.js';
+import { DisplayAxisMessages } from './namespaces/display-axis.js';
+import { DialogMessages } from './namespaces/dialog.js';
+import { DatePickerMessages } from './namespaces/date-picker.js';
+import { CopyButtonMessages } from './namespaces/copy-button.js';
+import { ContrastToggleLabels } from '../shell/contrast-constants.js';
+import { ConfirmDialogMessages } from './namespaces/confirm-dialog.js';
+import { CommandPaletteMessages } from './namespaces/command-palette.js';
+import { CommandMessages } from './namespaces/command.js';
+import { ComboboxMessages } from './namespaces/combobox.js';
+import { CarouselMessages } from './namespaces/carousel.js';
+import { CalendarMessages } from './namespaces/calendar.js';
+import { BreadcrumbMessages } from './namespaces/breadcrumb.js';
+import { BannerMessages } from './namespaces/banner.js';
+import { BadgeOverflowMessages } from './namespaces/badge-overflow.js';
+import { AvatarGroupMessages } from './namespaces/avatar-group.js';
+import { DataTableLabels } from '../components/composite/data-table-constants.js';
+import { SearchFilterBarLabels } from '../components/composite/search-filter-bar-constants.js';
+import { TablePaginationLabels } from '../components/composite/table-pagination-constants.js';
+import { ActionBarLabels } from '../components/ui/action-bar-constants.js';
+import { CropperLabels } from '../components/ui/cropper-constants.js';
+import { KanbanLabels } from '../components/ui/kanban-constants.js';
+import { KeyValueLabels } from '../components/ui/key-value-constants.js';
+import { PhoneInputLabels } from '../components/ui/phone-input-constants.js';
+import { StepperLabels } from '../components/ui/stepper-constants.js';
+import { TimePickerLabels } from '../components/ui/time-picker-constants.js';
+import { TourLabels } from '../components/ui/tour-constants.js';
+import { ComitorLanguage } from './locale.js';
+import 'lucide-react';
+import 'react';
+import '../components/composite/date-picker-constants.js';
+import 'date-fns';
+import 'react-day-picker';
+import '../components/composite/command-palette-constants.js';
+import '@dnd-kit/core';
+
+/** Bảng tiếng Anh — BẢN GỐC, định nghĩa hình dạng của mọi bảng khác. */
+declare const comitorMessagesEn: {
+    actionBar: ActionBarLabels;
+    avatarGroup: AvatarGroupMessages;
+    badgeOverflow: BadgeOverflowMessages;
+    banner: BannerMessages;
+    breadcrumb: BreadcrumbMessages;
+    calendar: CalendarMessages;
+    carousel: CarouselMessages;
+    combobox: ComboboxMessages;
+    command: CommandMessages;
+    commandPalette: CommandPaletteMessages;
+    confirmDialog: ConfirmDialogMessages;
+    contrast: ContrastToggleLabels;
+    copyButton: CopyButtonMessages;
+    cropper: CropperLabels;
+    dataTable: DataTableLabels;
+    datePicker: DatePickerMessages;
+    dialog: DialogMessages;
+    displayAxis: DisplayAxisMessages;
+    fileUpload: FileUploadLabels;
+    filterChips: FilterChipsMessages;
+    imageUploadField: ImageUploadFieldLabels;
+    inlineEdit: InlineEditMessages;
+    kanban: KanbanLabels;
+    keyValue: KeyValueLabels;
+    mention: MentionMessages;
+    pagination: PaginationMessages;
+    phoneInput: PhoneInputLabels;
+    rating: RatingMessages;
+    routeTabs: RouteTabsMessages;
+    scrollSpy: ScrollSpyMessages;
+    searchFilterBar: SearchFilterBarLabels;
+    sheet: SheetMessages;
+    shell: ShellLabels;
+    spinner: SpinnerMessages;
+    stepper: StepperLabels;
+    tablePagination: TablePaginationLabels;
+    tagsInput: TagsInputMessages;
+    timePicker: TimePickerLabels;
+    toast: ToastMessages;
+    tour: TourLabels;
+};
+/** Hình dạng của một bảng chữ đầy đủ. Suy từ bảng tiếng Anh, không viết tay lần hai. */
+type ComitorMessages = typeof comitorMessagesEn;
+/** Bảng tiếng Việt — phải phủ ĐỦ mọi khoá của bảng tiếng Anh. */
+declare const comitorMessagesVi: ComitorMessages;
+/** Mọi bảng dựng sẵn, tra theo ngôn ngữ. */
+declare const COMITOR_MESSAGES: Record<ComitorLanguage, ComitorMessages>;
+/**
+ * Ghi đè MỘT PHẦN: theo namespace, và trong mỗi namespace theo khoá. Dùng để đổi vài chữ theo
+ * nghiệp vụ ("Không gian làm việc" → "Công ty"), hoặc để cấp nguyên một bảng cho ngôn ngữ thứ ba.
+ */
+type ComitorMessagesOverride = {
+    [K in keyof ComitorMessages]?: Partial<ComitorMessages[K]>;
+};
+/**
+ * Trộn phần ghi đè vào một bảng đầy đủ — từng namespace một, nông ở cấp khoá. Không đụng tới bảng
+ * gốc (trả về object mới), và namespace không được ghi đè giữ nguyên tham chiếu.
+ */
+declare function mergeComitorMessages(base: ComitorMessages, override?: ComitorMessagesOverride): ComitorMessages;
+/**
+ * Bảng chữ cho một `locale` (+ phần ghi đè) — bản THUẦN của những gì `ComitorLocaleProvider` làm,
+ * dành cho nơi không có context: Server Component, email, toast bắn ngoài cây React.
+ */
+declare function getComitorMessages(locale?: string | null, override?: ComitorMessagesOverride): ComitorMessages;
+
+export { COMITOR_MESSAGES, type ComitorMessages, type ComitorMessagesOverride, comitorMessagesEn, comitorMessagesVi, getComitorMessages, mergeComitorMessages };