@stackframe/dashboard-ui-components 2.8.83 → 2.8.85

package/dist/components/data-grid/state.js

@@ -0,0 +1,329 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../../chunk-BE-pF4vm.js');
+let _stackframe_stack_shared_dist_utils_strings = require("@stackframe/stack-shared/dist/utils/strings");
+
+//#region src/components/data-grid/state.ts
+const EMPTY_SORT_MODEL = [];
+const EMPTY_SELECTION = {
+	selectedIds: /* @__PURE__ */ new Set(),
+	anchorId: null
+};
+const DEFAULT_PAGINATION = {
+	pageIndex: 0,
+	pageSize: 50
+};
+/**
+* Build the initial `DataGridState` for a set of columns. Pass this as the
+* lazy initializer to `useState` — NEVER hand-assemble the state object.
+*
+* ```tsx
+* const [gridState, setGridState] = React.useState(() =>
+*   createDefaultDataGridState(columns)
+* );
+* ```
+*
+* `columns` must be defined BEFORE this call (obvious, but a common TDZ
+* mistake: if you declare columns after the `useState`, you'll crash on
+* the first render). Keep the columns reference stable across renders
+* (define them outside the component or wrap in `React.useMemo`).
+*/
+function createDefaultDataGridState(columns) {
+	const columnWidths = {};
+	const columnOrder = [];
+	for (const col of columns) {
+		columnWidths[col.id] = col.width ?? 150;
+		columnOrder.push(col.id);
+	}
+	return {
+		sorting: EMPTY_SORT_MODEL,
+		columnVisibility: {},
+		columnWidths,
+		columnPinning: {
+			left: [],
+			right: []
+		},
+		columnOrder,
+		pagination: DEFAULT_PAGINATION,
+		selection: EMPTY_SELECTION,
+		dateDisplay: "relative",
+		quickSearch: ""
+	};
+}
+function resolveColumnValue(col, row) {
+	if (typeof col.accessor === "function") return col.accessor(row);
+	return row[col.accessor ?? col.id];
+}
+function resolveColumnWidth(col, storedWidth) {
+	return storedWidth ?? col.width ?? 150;
+}
+function isColumnVisible(columnId, visibility) {
+	return visibility[columnId] !== false;
+}
+function toggleSort(model, columnId, multiSort) {
+	const existing = model.find((s) => s.columnId === columnId);
+	if (!existing) {
+		const item = {
+			columnId,
+			direction: "asc"
+		};
+		return multiSort ? [...model, item] : [item];
+	}
+	if (existing.direction === "asc") {
+		const updated = {
+			columnId,
+			direction: "desc"
+		};
+		return model.map((s) => s.columnId === columnId ? updated : s);
+	}
+	return model.filter((s) => s.columnId !== columnId);
+}
+function getSortDirection(model, columnId) {
+	const item = model.find((s) => s.columnId === columnId);
+	return item ? item.direction : false;
+}
+function getSortIndex(model, columnId) {
+	if (model.length <= 1) return null;
+	const idx = model.findIndex((s) => s.columnId === columnId);
+	return idx >= 0 ? idx + 1 : null;
+}
+function defaultComparator(a, b) {
+	if (a == null && b == null) return 0;
+	if (a == null) return -1;
+	if (b == null) return 1;
+	if (typeof a === "number" && typeof b === "number") return a - b;
+	if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();
+	return (0, _stackframe_stack_shared_dist_utils_strings.stringCompare)(String(a), String(b));
+}
+function buildRowComparator(sortModel, columns) {
+	if (sortModel.length === 0) return null;
+	const colMap = new Map(columns.map((c) => [c.id, c]));
+	return (a, b) => {
+		for (const { columnId, direction } of sortModel) {
+			const col = colMap.get(columnId);
+			if (!col) continue;
+			const va = resolveColumnValue(col, a);
+			const vb = resolveColumnValue(col, b);
+			const cmp = col.sortComparator ? col.sortComparator(va, vb) : defaultComparator(va, vb);
+			if (cmp !== 0) return direction === "asc" ? cmp : -cmp;
+		}
+		return 0;
+	};
+}
+function paginateRows(rows, pagination) {
+	const start = pagination.pageIndex * pagination.pageSize;
+	return rows.slice(start, start + pagination.pageSize);
+}
+function getTotalPages(totalRows, pageSize) {
+	return Math.max(1, Math.ceil(totalRows / pageSize));
+}
+function toggleRowSelection(selection, rowId, mode, shiftKey, ctrlKey, allRowIds) {
+	if (mode === "single") {
+		const isSelected = selection.selectedIds.has(rowId);
+		return {
+			selectedIds: isSelected ? /* @__PURE__ */ new Set() : new Set([rowId]),
+			anchorId: isSelected ? null : rowId
+		};
+	}
+	if (shiftKey && selection.anchorId != null) {
+		const anchorIdx = allRowIds.indexOf(selection.anchorId);
+		const currentIdx = allRowIds.indexOf(rowId);
+		if (anchorIdx >= 0 && currentIdx >= 0) {
+			const start = Math.min(anchorIdx, currentIdx);
+			const end = Math.max(anchorIdx, currentIdx);
+			const rangeIds = allRowIds.slice(start, end + 1);
+			const next = ctrlKey ? new Set(selection.selectedIds) : /* @__PURE__ */ new Set();
+			for (const id of rangeIds) next.add(id);
+			return {
+				selectedIds: next,
+				anchorId: selection.anchorId
+			};
+		}
+	}
+	if (ctrlKey) {
+		const next = new Set(selection.selectedIds);
+		if (next.has(rowId)) next.delete(rowId);
+		else next.add(rowId);
+		return {
+			selectedIds: next,
+			anchorId: rowId
+		};
+	}
+	return {
+		selectedIds: new Set([rowId]),
+		anchorId: rowId
+	};
+}
+function selectAll(allRowIds) {
+	return {
+		selectedIds: new Set(allRowIds),
+		anchorId: null
+	};
+}
+function clearSelection() {
+	return EMPTY_SELECTION;
+}
+/** Default row matcher used by `applyQuickSearch`. Case-insensitive
+* substring match across every column's resolved cell value. Columns
+* with `null` / `undefined` values are skipped. The query is expected
+* to be pre-trimmed and lowercased by `applyQuickSearch` — this helper
+* does NOT trim or lowercase it again, so if you wire it up yourself,
+* do that first. */
+function defaultMatchRow(row, query, columns) {
+	for (const col of columns) {
+		const v = resolveColumnValue(col, row);
+		if (v == null) continue;
+		if (String(v).toLowerCase().includes(query)) return true;
+	}
+	return false;
+}
+/** Client-side quick-search filter. Returns the original array
+* reference when `query` is empty, so calling this in a hot `useMemo`
+* is cheap in the common "no search" case.
+*
+* Used by `useDataSource` in client mode. Exported so consumers driving
+* the grid manually (or doing their own pre-filtering before feeding
+* rows to an async data source) can stay consistent with the built-in
+* search behaviour.
+*
+* Override `matchRow` for custom matching logic — e.g. fuzzy matching,
+* field-specific weighting, or skipping some columns. */
+function applyQuickSearch(rows, query, columns, matchRow = defaultMatchRow) {
+	const trimmed = query.trim().toLowerCase();
+	if (!trimmed) return rows;
+	return rows.filter((r) => matchRow(r, trimmed, columns));
+}
+/** Parse a raw cell value into a `Date`. Returns `null` for nullish,
+* unparseable, or invalid dates. Accepts strings (including ISO and
+* "YYYY-MM-DD HH:MM:SS"-style ClickHouse output), numbers (ms since
+* epoch), and `Date` instances. For truly weird formats, override via
+* `col.parseValue`. */
+function defaultParseDate(value) {
+	if (value == null) return null;
+	if (value instanceof Date) return isNaN(value.getTime()) ? null : value;
+	if (typeof value === "number") {
+		const d = new Date(value);
+		return isNaN(d.getTime()) ? null : d;
+	}
+	if (typeof value === "string") {
+		const d = new Date(value);
+		return isNaN(d.getTime()) ? null : d;
+	}
+	return null;
+}
+const DIVISIONS = [
+	{
+		amount: 60,
+		unit: "second"
+	},
+	{
+		amount: 60,
+		unit: "minute"
+	},
+	{
+		amount: 24,
+		unit: "hour"
+	},
+	{
+		amount: 7,
+		unit: "day"
+	},
+	{
+		amount: 4.34524,
+		unit: "week"
+	},
+	{
+		amount: 12,
+		unit: "month"
+	},
+	{
+		amount: Number.POSITIVE_INFINITY,
+		unit: "year"
+	}
+];
+/** Default relative formatter — "1 day ago" / "in 2 hours" via
+* `Intl.RelativeTimeFormat`. Pure function of the date; does NOT
+* re-render as real time passes. */
+function defaultFormatRelative(date) {
+	const rtf = new Intl.RelativeTimeFormat(void 0, { numeric: "auto" });
+	let duration = (date.getTime() - Date.now()) / 1e3;
+	for (const div of DIVISIONS) {
+		if (Math.abs(duration) < div.amount) return rtf.format(Math.round(duration), div.unit);
+		duration /= div.amount;
+	}
+	return rtf.format(Math.round(duration), "year");
+}
+/** Default absolute formatter — full locale date + time. */
+function defaultFormatAbsolute(date) {
+	return date.toLocaleString();
+}
+/** Format a raw cell value for display in a `date` / `dateTime` column.
+* Returns both the inline display string and the tooltip string (which
+* is always the absolute form so users can read the exact datetime).
+*
+* Used internally by the grid's default date cell renderer, and exported
+* so consumers writing a custom `renderCell` for a date column can stay
+* visually consistent with the built-in behaviour.
+*
+* ```tsx
+* renderCell: ({ value, dateDisplay }) => {
+*   const { display, tooltip } = formatGridDate(value, dateDisplay);
+*   if (!display) return <span className="text-muted-foreground/40">—</span>;
+*   return <span title={tooltip ?? undefined}>{display}</span>;
+* }
+* ``` */
+function formatGridDate(value, mode, opts) {
+	const date = (opts?.parseValue ?? defaultParseDate)(value);
+	if (!date) return {
+		display: null,
+		tooltip: null
+	};
+	const relative = opts?.dateFormat?.relative ?? defaultFormatRelative;
+	const tooltip = (opts?.dateFormat?.absolute ?? defaultFormatAbsolute)(date);
+	return {
+		display: mode === "relative" ? relative(date) : tooltip,
+		tooltip
+	};
+}
+function exportToCsv(rows, columns, filename) {
+	const header = columns.map((col) => typeof col.header === "string" ? col.header : col.id);
+	const csvRows = rows.map((row) => columns.map((col) => {
+		const val = resolveColumnValue(col, row);
+		const formatted = col.formatValue ? col.formatValue(val, row) : String(val ?? "");
+		if (formatted.includes(",") || formatted.includes("\"") || formatted.includes("\n")) return `"${formatted.replace(/"/g, "\"\"")}"`;
+		return formatted;
+	}));
+	const csvContent = [header.join(","), ...csvRows.map((row) => row.join(","))].join("\n");
+	const blob = new Blob([csvContent], { type: "text/csv;charset=utf-8;" });
+	const url = URL.createObjectURL(blob);
+	const link = document.createElement("a");
+	link.href = url;
+	link.download = `${filename}.csv`;
+	link.click();
+	URL.revokeObjectURL(url);
+}
+
+//#endregion
+exports.DEFAULT_PAGINATION = DEFAULT_PAGINATION;
+exports.EMPTY_SELECTION = EMPTY_SELECTION;
+exports.EMPTY_SORT_MODEL = EMPTY_SORT_MODEL;
+exports.applyQuickSearch = applyQuickSearch;
+exports.buildRowComparator = buildRowComparator;
+exports.clearSelection = clearSelection;
+exports.createDefaultDataGridState = createDefaultDataGridState;
+exports.defaultFormatAbsolute = defaultFormatAbsolute;
+exports.defaultFormatRelative = defaultFormatRelative;
+exports.defaultMatchRow = defaultMatchRow;
+exports.defaultParseDate = defaultParseDate;
+exports.exportToCsv = exportToCsv;
+exports.formatGridDate = formatGridDate;
+exports.getSortDirection = getSortDirection;
+exports.getSortIndex = getSortIndex;
+exports.getTotalPages = getTotalPages;
+exports.isColumnVisible = isColumnVisible;
+exports.paginateRows = paginateRows;
+exports.resolveColumnValue = resolveColumnValue;
+exports.resolveColumnWidth = resolveColumnWidth;
+exports.selectAll = selectAll;
+exports.toggleRowSelection = toggleRowSelection;
+exports.toggleSort = toggleSort;
+//# sourceMappingURL=state.js.map

package/dist/components/data-grid/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","names":[],"sources":["../../../src/components/data-grid/state.ts"],"sourcesContent":["import { stringCompare } from \"@stackframe/stack-shared/dist/utils/strings\";\nimport type {\n  DataGridColumnDef,\n  DataGridDateDisplay,\n  DataGridDateFormat,\n  DataGridPaginationModel,\n  DataGridSelectionModel,\n  DataGridSortModel,\n  DataGridState,\n} from \"./types\";\n\n// ─── Default state ───────────────────────────────────────────────────\n\nexport const EMPTY_SORT_MODEL: DataGridSortModel = [];\nexport const EMPTY_SELECTION: DataGridSelectionModel = {\n  selectedIds: new Set(),\n  anchorId: null,\n};\nexport const DEFAULT_PAGINATION: DataGridPaginationModel = {\n  pageIndex: 0,\n  pageSize: 50,\n};\n\n/**\n * Build the initial `DataGridState` for a set of columns. Pass this as the\n * lazy initializer to `useState` — NEVER hand-assemble the state object.\n *\n * ```tsx\n * const [gridState, setGridState] = React.useState(() =>\n *   createDefaultDataGridState(columns)\n * );\n * ```\n *\n * `columns` must be defined BEFORE this call (obvious, but a common TDZ\n * mistake: if you declare columns after the `useState`, you'll crash on\n * the first render). Keep the columns reference stable across renders\n * (define them outside the component or wrap in `React.useMemo`).\n */\nexport function createDefaultDataGridState(\n  columns: readonly DataGridColumnDef<any>[],\n): DataGridState {\n  const columnWidths: Record<string, number> = {};\n  const columnOrder: string[] = [];\n\n  for (const col of columns) {\n    columnWidths[col.id] = col.width ?? 150;\n    columnOrder.push(col.id);\n  }\n\n  return {\n    sorting: EMPTY_SORT_MODEL,\n    columnVisibility: {},\n    columnWidths,\n    columnPinning: { left: [], right: [] },\n    columnOrder,\n    pagination: DEFAULT_PAGINATION,\n    selection: EMPTY_SELECTION,\n    dateDisplay: \"relative\",\n    quickSearch: \"\",\n  };\n}\n\n// ─── Column helpers ──────────────────────────────────────────────────\n\nexport function resolveColumnValue<TRow>(\n  col: DataGridColumnDef<TRow>,\n  row: TRow,\n): unknown {\n  if (typeof col.accessor === \"function\") return col.accessor(row);\n  const key = (col.accessor ?? col.id) as keyof TRow;\n  return row[key];\n}\n\nexport function resolveColumnWidth(\n  col: DataGridColumnDef<any>,\n  storedWidth: number | undefined,\n): number {\n  return storedWidth ?? col.width ?? 150;\n}\n\nexport function isColumnVisible(\n  columnId: string,\n  visibility: Record<string, boolean>,\n): boolean {\n  return visibility[columnId] !== false;\n}\n\n// ─── Sort helpers ────────────────────────────────────────────────────\n\nexport function toggleSort(\n  model: DataGridSortModel,\n  columnId: string,\n  multiSort: boolean,\n): DataGridSortModel {\n  const existing = model.find((s) => s.columnId === columnId);\n\n  if (!existing) {\n    const item = { columnId, direction: \"asc\" as const };\n    return multiSort ? [...model, item] : [item];\n  }\n\n  if (existing.direction === \"asc\") {\n    const updated = { columnId, direction: \"desc\" as const };\n    return model.map((s) => (s.columnId === columnId ? updated : s));\n  }\n\n  // desc → remove\n  return model.filter((s) => s.columnId !== columnId);\n}\n\nexport function getSortDirection(\n  model: DataGridSortModel,\n  columnId: string,\n): false | \"asc\" | \"desc\" {\n  const item = model.find((s) => s.columnId === columnId);\n  return item ? item.direction : false;\n}\n\nexport function getSortIndex(\n  model: DataGridSortModel,\n  columnId: string,\n): number | null {\n  if (model.length <= 1) return null;\n  const idx = model.findIndex((s) => s.columnId === columnId);\n  return idx >= 0 ? idx + 1 : null;\n}\n\n// ─── Default sort comparator ─────────────────────────────────────────\n\nfunction defaultComparator(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();\n  return stringCompare(String(a), String(b));\n}\n\nexport function buildRowComparator<TRow>(\n  sortModel: DataGridSortModel,\n  columns: readonly DataGridColumnDef<TRow>[],\n): ((a: TRow, b: TRow) => number) | null {\n  if (sortModel.length === 0) return null;\n\n  const colMap = new Map(columns.map((c) => [c.id, c]));\n\n  return (a, b) => {\n    for (const { columnId, direction } of sortModel) {\n      const col = colMap.get(columnId);\n      if (!col) continue;\n\n      const va = resolveColumnValue(col, a);\n      const vb = resolveColumnValue(col, b);\n      const cmp = col.sortComparator\n        ? col.sortComparator(va, vb)\n        : defaultComparator(va, vb);\n      if (cmp !== 0) return direction === \"asc\" ? cmp : -cmp;\n    }\n    return 0;\n  };\n}\n\n// ─── Pagination helpers ──────────────────────────────────────────────\n\nexport function paginateRows<TRow>(\n  rows: readonly TRow[],\n  pagination: DataGridPaginationModel,\n): TRow[] {\n  const start = pagination.pageIndex * pagination.pageSize;\n  return rows.slice(start, start + pagination.pageSize) as TRow[];\n}\n\nexport function getTotalPages(\n  totalRows: number,\n  pageSize: number,\n): number {\n  return Math.max(1, Math.ceil(totalRows / pageSize));\n}\n\n// ─── Selection helpers ───────────────────────────────────────────────\n\nexport function toggleRowSelection(\n  selection: DataGridSelectionModel,\n  rowId: string,\n  mode: \"single\" | \"multiple\",\n  shiftKey: boolean,\n  ctrlKey: boolean,\n  allRowIds: readonly string[],\n): DataGridSelectionModel {\n  if (mode === \"single\") {\n    const isSelected = selection.selectedIds.has(rowId);\n    return {\n      selectedIds: isSelected ? new Set() : new Set([rowId]),\n      anchorId: isSelected ? null : rowId,\n    };\n  }\n\n  // Multiple mode\n  if (shiftKey && selection.anchorId != null) {\n    const anchorIdx = allRowIds.indexOf(selection.anchorId);\n    const currentIdx = allRowIds.indexOf(rowId);\n    if (anchorIdx >= 0 && currentIdx >= 0) {\n      const start = Math.min(anchorIdx, currentIdx);\n      const end = Math.max(anchorIdx, currentIdx);\n      const rangeIds = allRowIds.slice(start, end + 1);\n\n      const next = ctrlKey ? new Set(selection.selectedIds) : new Set<string>();\n      for (const id of rangeIds) next.add(id);\n\n      return { selectedIds: next, anchorId: selection.anchorId };\n    }\n  }\n\n  if (ctrlKey) {\n    // Toggle single in multi mode\n    const next = new Set(selection.selectedIds);\n    if (next.has(rowId)) {\n      next.delete(rowId);\n    } else {\n      next.add(rowId);\n    }\n    return { selectedIds: next, anchorId: rowId };\n  }\n\n  // Plain click in multi mode — select only this row\n  return {\n    selectedIds: new Set([rowId]),\n    anchorId: rowId,\n  };\n}\n\nexport function selectAll(\n  allRowIds: readonly string[],\n): DataGridSelectionModel {\n  return {\n    selectedIds: new Set(allRowIds),\n    anchorId: null,\n  };\n}\n\nexport function clearSelection(): DataGridSelectionModel {\n  return EMPTY_SELECTION;\n}\n\n// ─── Quick search ────────────────────────────────────────────────────\n\n/** Default row matcher used by `applyQuickSearch`. Case-insensitive\n * substring match across every column's resolved cell value. Columns\n * with `null` / `undefined` values are skipped. The query is expected\n * to be pre-trimmed and lowercased by `applyQuickSearch` — this helper\n * does NOT trim or lowercase it again, so if you wire it up yourself,\n * do that first. */\nexport function defaultMatchRow<TRow>(\n  row: TRow,\n  query: string,\n  columns: readonly DataGridColumnDef<TRow>[],\n): boolean {\n  for (const col of columns) {\n    const v = resolveColumnValue(col, row);\n    if (v == null) continue;\n    if (String(v).toLowerCase().includes(query)) return true;\n  }\n  return false;\n}\n\n/** Client-side quick-search filter. Returns the original array\n * reference when `query` is empty, so calling this in a hot `useMemo`\n * is cheap in the common \"no search\" case.\n *\n * Used by `useDataSource` in client mode. Exported so consumers driving\n * the grid manually (or doing their own pre-filtering before feeding\n * rows to an async data source) can stay consistent with the built-in\n * search behaviour.\n *\n * Override `matchRow` for custom matching logic — e.g. fuzzy matching,\n * field-specific weighting, or skipping some columns. */\nexport function applyQuickSearch<TRow>(\n  rows: readonly TRow[],\n  query: string,\n  columns: readonly DataGridColumnDef<TRow>[],\n  matchRow: (\n    row: TRow,\n    query: string,\n    columns: readonly DataGridColumnDef<TRow>[],\n  ) => boolean = defaultMatchRow,\n): readonly TRow[] {\n  const trimmed = query.trim().toLowerCase();\n  if (!trimmed) return rows;\n  return rows.filter((r) => matchRow(r, trimmed, columns));\n}\n\n// ─── Date helpers ────────────────────────────────────────────────────\n\n/** Parse a raw cell value into a `Date`. Returns `null` for nullish,\n * unparseable, or invalid dates. Accepts strings (including ISO and\n * \"YYYY-MM-DD HH:MM:SS\"-style ClickHouse output), numbers (ms since\n * epoch), and `Date` instances. For truly weird formats, override via\n * `col.parseValue`. */\nexport function defaultParseDate(value: unknown): Date | null {\n  if (value == null) return null;\n  if (value instanceof Date) return isNaN(value.getTime()) ? null : value;\n  if (typeof value === \"number\") {\n    const d = new Date(value);\n    return isNaN(d.getTime()) ? null : d;\n  }\n  if (typeof value === \"string\") {\n    const d = new Date(value);\n    return isNaN(d.getTime()) ? null : d;\n  }\n  return null;\n}\n\nconst DIVISIONS: Array<{ amount: number; unit: Intl.RelativeTimeFormatUnit }> = [\n  { amount: 60, unit: \"second\" },\n  { amount: 60, unit: \"minute\" },\n  { amount: 24, unit: \"hour\" },\n  { amount: 7, unit: \"day\" },\n  { amount: 4.34524, unit: \"week\" },\n  { amount: 12, unit: \"month\" },\n  { amount: Number.POSITIVE_INFINITY, unit: \"year\" },\n];\n\n/** Default relative formatter — \"1 day ago\" / \"in 2 hours\" via\n * `Intl.RelativeTimeFormat`. Pure function of the date; does NOT\n * re-render as real time passes. */\nexport function defaultFormatRelative(date: Date): string {\n  const rtf = new Intl.RelativeTimeFormat(undefined, { numeric: \"auto\" });\n  let duration = (date.getTime() - Date.now()) / 1000;\n  for (const div of DIVISIONS) {\n    if (Math.abs(duration) < div.amount) {\n      return rtf.format(Math.round(duration), div.unit);\n    }\n    duration /= div.amount;\n  }\n  return rtf.format(Math.round(duration), \"year\");\n}\n\n/** Default absolute formatter — full locale date + time. */\nexport function defaultFormatAbsolute(date: Date): string {\n  return date.toLocaleString();\n}\n\n/** Format a raw cell value for display in a `date` / `dateTime` column.\n * Returns both the inline display string and the tooltip string (which\n * is always the absolute form so users can read the exact datetime).\n *\n * Used internally by the grid's default date cell renderer, and exported\n * so consumers writing a custom `renderCell` for a date column can stay\n * visually consistent with the built-in behaviour.\n *\n * ```tsx\n * renderCell: ({ value, dateDisplay }) => {\n *   const { display, tooltip } = formatGridDate(value, dateDisplay);\n *   if (!display) return <span className=\"text-muted-foreground/40\">—</span>;\n *   return <span title={tooltip ?? undefined}>{display}</span>;\n * }\n * ``` */\nexport function formatGridDate(\n  value: unknown,\n  mode: DataGridDateDisplay,\n  opts?: {\n    parseValue?: (value: unknown) => Date | null;\n    dateFormat?: DataGridDateFormat;\n  },\n): { display: string | null; tooltip: string | null } {\n  const parse = opts?.parseValue ?? defaultParseDate;\n  const date = parse(value);\n  if (!date) return { display: null, tooltip: null };\n\n  const relative = opts?.dateFormat?.relative ?? defaultFormatRelative;\n  const absolute = opts?.dateFormat?.absolute ?? defaultFormatAbsolute;\n\n  const tooltip = absolute(date);\n  const display = mode === \"relative\" ? relative(date) : tooltip;\n  return { display, tooltip };\n}\n\n// ─── CSV Export ──────────────────────────────────────────────────────\n\nexport function exportToCsv<TRow>(\n  rows: readonly TRow[],\n  columns: readonly DataGridColumnDef<TRow>[],\n  filename: string,\n): void {\n  const header = columns.map((col) =>\n    typeof col.header === \"string\" ? col.header : col.id,\n  );\n\n  const csvRows = rows.map((row) =>\n    columns.map((col) => {\n      const val = resolveColumnValue(col, row);\n      const formatted = col.formatValue ? col.formatValue(val, row) : String(val ?? \"\");\n      // Escape CSV special characters\n      if (formatted.includes(\",\") || formatted.includes('\"') || formatted.includes(\"\\n\")) {\n        return `\"${formatted.replace(/\"/g, '\"\"')}\"`;\n      }\n      return formatted;\n    }),\n  );\n\n  const csvContent = [\n    header.join(\",\"),\n    ...csvRows.map((row) => row.join(\",\")),\n  ].join(\"\\n\");\n\n  const blob = new Blob([csvContent], { type: \"text/csv;charset=utf-8;\" });\n  const url = URL.createObjectURL(blob);\n  const link = document.createElement(\"a\");\n  link.href = url;\n  link.download = `${filename}.csv`;\n  link.click();\n  URL.revokeObjectURL(url);\n}\n"],"mappings":"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"}

package/dist/components/data-grid/strings.d.ts

@@ -0,0 +1,8 @@
+import { DataGridStrings } from "./types.js";
+
+//#region src/components/data-grid/strings.d.ts
+declare const DATA_GRID_DEFAULT_STRINGS: DataGridStrings;
+declare function resolveDataGridStrings(override: Partial<DataGridStrings> | undefined): DataGridStrings;
+//#endregion
+export { DATA_GRID_DEFAULT_STRINGS, resolveDataGridStrings };
+//# sourceMappingURL=strings.d.ts.map

package/dist/components/data-grid/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","names":[],"sources":["../../../src/components/data-grid/strings.ts"],"mappings":";;;cAEa,yBAAA,EAA2B,eAAA;AAAA,iBAqCxB,sBAAA,CACd,QAAA,EAAU,OAAA,CAAQ,eAAA,gBACjB,eAAA"}

package/dist/components/data-grid/strings.js

@@ -0,0 +1,42 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/components/data-grid/strings.ts
+const DATA_GRID_DEFAULT_STRINGS = {
+	searchPlaceholder: "Search…",
+	columns: "Columns",
+	export: "Export",
+	density: "Density",
+	showAll: "Show all",
+	hideAll: "Hide all",
+	resetColumns: "Reset",
+	dateFormat: "Date format",
+	dateFormatRelative: "Relative",
+	dateFormatAbsolute: "Absolute",
+	rowsSelected: (count) => `${count} row${count === 1 ? "" : "s"} selected`,
+	rowsPerPage: "Rows per page",
+	pageOf: (page, total) => `${page} of ${total}`,
+	noData: "No data",
+	loading: "Loading…",
+	loadingMore: "Loading more…",
+	exportCsv: "Export CSV",
+	exportCopied: "Copied!",
+	sortAsc: "Sort ascending",
+	sortDesc: "Sort descending",
+	unsort: "Remove sort",
+	pinLeft: "Pin left",
+	pinRight: "Pin right",
+	unpin: "Unpin",
+	hideColumn: "Hide column"
+};
+function resolveDataGridStrings(override) {
+	if (!override) return DATA_GRID_DEFAULT_STRINGS;
+	return {
+		...DATA_GRID_DEFAULT_STRINGS,
+		...override
+	};
+}
+
+//#endregion
+exports.DATA_GRID_DEFAULT_STRINGS = DATA_GRID_DEFAULT_STRINGS;
+exports.resolveDataGridStrings = resolveDataGridStrings;
+//# sourceMappingURL=strings.js.map

package/dist/components/data-grid/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","names":[],"sources":["../../../src/components/data-grid/strings.ts"],"sourcesContent":["import type { DataGridStrings } from \"./types\";\n\nexport const DATA_GRID_DEFAULT_STRINGS: DataGridStrings = {\n  // toolbar\n  searchPlaceholder: \"Search\\u2026\",\n  columns: \"Columns\",\n  export: \"Export\",\n  density: \"Density\",\n  // column manager\n  showAll: \"Show all\",\n  hideAll: \"Hide all\",\n  resetColumns: \"Reset\",\n  // date display\n  dateFormat: \"Date format\",\n  dateFormatRelative: \"Relative\",\n  dateFormatAbsolute: \"Absolute\",\n  // selection\n  rowsSelected: (count) => `${count} row${count === 1 ? \"\" : \"s\"} selected`,\n  // pagination\n  rowsPerPage: \"Rows per page\",\n  pageOf: (page, total) => `${page} of ${total}`,\n  // empty / loading\n  noData: \"No data\",\n  loading: \"Loading\\u2026\",\n  loadingMore: \"Loading more\\u2026\",\n  // export\n  exportCsv: \"Export CSV\",\n  exportCopied: \"Copied!\",\n  // sort\n  sortAsc: \"Sort ascending\",\n  sortDesc: \"Sort descending\",\n  unsort: \"Remove sort\",\n  // misc\n  pinLeft: \"Pin left\",\n  pinRight: \"Pin right\",\n  unpin: \"Unpin\",\n  hideColumn: \"Hide column\",\n};\n\nexport function resolveDataGridStrings(\n  override: Partial<DataGridStrings> | undefined,\n): DataGridStrings {\n  if (!override) return DATA_GRID_DEFAULT_STRINGS;\n  return { ...DATA_GRID_DEFAULT_STRINGS, ...override };\n}\n"],"mappings":";;;AAEA,MAAa,4BAA6C;CAExD,mBAAmB;CACnB,SAAS;CACT,QAAQ;CACR,SAAS;CAET,SAAS;CACT,SAAS;CACT,cAAc;CAEd,YAAY;CACZ,oBAAoB;CACpB,oBAAoB;CAEpB,eAAe,UAAU,GAAG,MAAM,MAAM,UAAU,IAAI,KAAK,IAAI;CAE/D,aAAa;CACb,SAAS,MAAM,UAAU,GAAG,KAAK,MAAM;CAEvC,QAAQ;CACR,SAAS;CACT,aAAa;CAEb,WAAW;CACX,cAAc;CAEd,SAAS;CACT,UAAU;CACV,QAAQ;CAER,SAAS;CACT,UAAU;CACV,OAAO;CACP,YAAY;CACb;AAED,SAAgB,uBACd,UACiB;AACjB,KAAI,CAAC,SAAU,QAAO;AACtB,QAAO;EAAE,GAAG;EAA2B,GAAG;EAAU"}