{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "data-grid",
  "type": "registry:ui",
  "title": "Data Grid",
  "description": "A table of records a person works in: sorting by one or several columns, a filter per column and a search across all, grouping with totals, columns pinned to the start, shown and hidden, rows chosen by checkbox, pages or a window of rows for thousands, and cells edited in place; one tab stop and arrow keys from cell to cell, to the WAI-ARIA grid pattern.",
  "categories": [
    "ui"
  ],
  "dependencies": [
    "lucide-react"
  ],
  "registryDependencies": [
    "@rivier-ui/theme",
    "@rivier-ui/announce",
    "@rivier-ui/button",
    "@rivier-ui/checkbox",
    "@rivier-ui/cn",
    "@rivier-ui/dropdown-menu",
    "@rivier-ui/input",
    "@rivier-ui/use-controllable-state"
  ],
  "files": [
    {
      "path": "registry/ui/data-grid.tsx",
      "type": "registry:ui",
      "target": "components/ui/data-grid.tsx",
      "content": "\"use client\";\n/**\n * @name data-grid\n * @category ui\n * @description A table of records a person works in: sorting by one or several columns, a filter per column and a search across all, grouping with totals, columns pinned to the start, shown and hidden, rows chosen by checkbox, pages or a window of rows for thousands, and cells edited in place; one tab stop and arrow keys from cell to cell, to the WAI-ARIA grid pattern.\n * @when Lists of records that are sorted, narrowed, compared and changed: orders, accounts, files, results. For a few rows to read use table; for side-by-side comparison of two to four things use compare-table; for an endless feed use virtual-list.\n * @example\n * <DataGrid\n *   label=\"Orders\"\n *   rows={orders}\n *   rowId={(order) => order.id}\n *   columns={[\n *     { key: \"id\", header: \"Order\", pin: \"start\", width: 110 },\n *     { key: \"customer\", header: \"Customer\" },\n *     { key: \"status\", header: \"Status\" },\n *     { key: \"total\", header: \"Total\", type: \"number\", aggregate: \"sum\", editable: true },\n *   ]}\n *   selectable\n *   pageSize={20}\n *   onCellEdit={(id, key, value) => save(id, key, value)}\n * />\n */\nimport { ArrowDown, ArrowUp, ArrowUpDown, ChevronDown, ChevronRight, Columns3, Search } from \"lucide-react\";\nimport { createContext, use, useId, useMemo, useRef, useState, type ComponentProps, type KeyboardEvent, type ReactNode } from \"react\";\nimport { announce } from \"@/lib/announce\";\nimport { cn } from \"@/lib/cn\";\nimport { useControllableState } from \"@/lib/use-controllable-state\";\nimport { Button } from \"@/components/ui/button\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuLabel, DropdownMenuTrigger } from \"@/components/ui/dropdown-menu\";\nimport { Input } from \"@/components/ui/input\";\n\nexport type DataGridAggregate = \"sum\" | \"mean\" | \"count\" | \"min\" | \"max\";\n\nexport type DataGridColumn<T> = {\n  /** The field the column shows. */\n  key: keyof T & string;\n  header: string;\n  /** How values sort, align and are typed when edited. Default \"text\". */\n  type?: \"text\" | \"number\" | \"date\";\n  /** Width in pixels. Pinned columns need one; others share the space. */\n  width?: number;\n  /** Text for a value: in the cell, the search and the filter. Default: Intl for numbers, the value as text otherwise. */\n  format?: (value: unknown, row: T) => string;\n  /** The cell's content, when it is more than text. The text of `format` is still what is searched. */\n  render?: (row: T) => ReactNode;\n  sortable?: boolean;\n  filterable?: boolean;\n  /** The cell can be changed: Enter or F2 starts, Enter keeps, Escape leaves it as it was. */\n  editable?: boolean;\n  /** What a group's row shows for this column. */\n  aggregate?: DataGridAggregate;\n  /** Stays in view at the start while the rest scrolls sideways. */\n  pin?: \"start\";\n};\n\nexport type DataGridSort = { key: string; direction: \"ascending\" | \"descending\" };\n\nexport type DataGridLabels = {\n  search: string;\n  columns: string;\n  filter: (column: string) => string;\n  sortBy: (column: string) => string;\n  sorted: (column: string, direction: \"ascending\" | \"descending\") => string;\n  noResults: string;\n  selectAll: string;\n  selectRow: (row: number) => string;\n  selected: (count: string) => string;\n  results: (shown: string, total: string) => string;\n  page: (page: string, pages: string) => string;\n  previous: string;\n  next: string;\n  group: (value: string, count: string) => string;\n  expand: string;\n  collapse: string;\n  editHint: string;\n  empty: string;\n};\n\nconst LABELS: DataGridLabels = {\n  search: \"Search\",\n  columns: \"Columns\",\n  filter: (column) => `Filter ${column}`,\n  sortBy: (column) => `Sort by ${column}`,\n  sorted: (column, direction) => `Sorted by ${column}, ${direction}`,\n  noResults: \"Nothing matches.\",\n  selectAll: \"Choose every row on this page\",\n  selectRow: (row) => `Choose row ${row}`,\n  selected: (count) => `${count} chosen`,\n  results: (shown, total) => `${shown} of ${total}`,\n  page: (page, pages) => `Page ${page} of ${pages}`,\n  previous: \"Previous page\",\n  next: \"Next page\",\n  group: (value, count) => `${value} (${count})`,\n  expand: \"Show the group\",\n  collapse: \"Hide the group\",\n  editHint: \"Enter to edit\",\n  empty: \"(empty)\",\n};\n\ntype GridState<T> = {\n  id: string;\n  label: string;\n  columns: readonly DataGridColumn<T>[];\n  visible: readonly DataGridColumn<T>[];\n  hidden: readonly string[];\n  setHidden: (next: readonly string[]) => void;\n  sort: readonly DataGridSort[];\n  setSort: (next: readonly DataGridSort[]) => void;\n  filters: Readonly<Record<string, string>>;\n  setFilters: (next: Readonly<Record<string, string>>) => void;\n  search: string;\n  setSearch: (next: string) => void;\n  groupBy: string | null;\n  page: number;\n  setPage: (next: number) => void;\n  pages: number;\n  pageRows: readonly Line<T>[];\n  matched: readonly T[];\n  total: number;\n  selected: readonly string[];\n  setSelected: (next: readonly string[]) => void;\n  selectable: boolean;\n  rowId: (row: T) => string;\n  text: (column: DataGridColumn<T>, row: T) => string;\n  labels: DataGridLabels;\n  locale: string;\n  collapsed: readonly string[];\n  toggleGroup: (value: string) => void;\n  onCellEdit: ((id: string, key: string, value: string | number) => void) | undefined;\n  height: number | undefined;\n  rowHeight: number;\n};\n\ntype Line<T> = { kind: \"row\"; row: T; index: number } | { kind: \"group\"; value: string; rows: readonly T[] };\n\n// The context holds the grid of one row type; parts read it without knowing the type.\nconst GridContext = createContext<GridState<object> | null>(null);\n\nfunction useGrid(part: string): GridState<object> {\n  const context = use(GridContext);\n  if (!context) throw new Error(`${part} must be inside a DataGrid.`);\n  return context;\n}\n\nexport type DataGridProps<T extends object> = Omit<ComponentProps<\"div\">, \"children\" | \"defaultValue\"> & {\n  /** What the grid holds, for assistive technology: \"Orders\". */\n  label: string;\n  rows: readonly T[];\n  columns: readonly DataGridColumn<T>[];\n  /** A stable id for each row: selection and editing keep to it as rows move. */\n  rowId: (row: T) => string;\n  sort?: readonly DataGridSort[];\n  defaultSort?: readonly DataGridSort[];\n  onSortChange?: (sort: readonly DataGridSort[]) => void;\n  /** A column key to group rows by, with a row per group showing its count and aggregates. */\n  groupBy?: string | null;\n  hidden?: readonly string[];\n  defaultHidden?: readonly string[];\n  onHiddenChange?: (hidden: readonly string[]) => void;\n  /** A checkbox on each row and one for the page. */\n  selectable?: boolean;\n  selected?: readonly string[];\n  defaultSelected?: readonly string[];\n  onSelectedChange?: (selected: readonly string[]) => void;\n  /** Rows per page. Leave out (or 0) for one page; with `height`, only the rows in view are drawn. */\n  pageSize?: number;\n  /** A fixed height in pixels for the scrolling body; long lists then draw only the rows in view. */\n  height?: number;\n  /** The height of a row in pixels, for drawing only the rows in view. Default 40. */\n  rowHeight?: number;\n  /** Called when a cell is edited: the row's id, the column key and the new value. The project changes `rows`. */\n  onCellEdit?: (id: string, key: string, value: string | number) => void;\n  labels?: Partial<DataGridLabels>;\n  locale?: string;\n  /** The parts, arranged by the project. Left out: toolbar, grid and pages. */\n  children?: ReactNode;\n};\n\nconst EMPTY: readonly never[] = [];\n\nfunction aggregateOf(kind: DataGridAggregate, values: number[]): number {\n  if (kind === \"count\") return values.length;\n  if (values.length === 0) return 0;\n  if (kind === \"sum\") return values.reduce((a, b) => a + b, 0);\n  if (kind === \"mean\") return values.reduce((a, b) => a + b, 0) / values.length;\n  if (kind === \"min\") return Math.min(...values);\n  return Math.max(...values);\n}\n\nexport function DataGrid<T extends object>({\n  label,\n  rows,\n  columns,\n  rowId,\n  sort: sortProp,\n  defaultSort = EMPTY,\n  onSortChange,\n  groupBy = null,\n  hidden: hiddenProp,\n  defaultHidden = EMPTY,\n  onHiddenChange,\n  selectable = false,\n  selected: selectedProp,\n  defaultSelected = EMPTY,\n  onSelectedChange,\n  pageSize = 0,\n  height,\n  rowHeight = 40,\n  onCellEdit,\n  labels: given,\n  locale = \"en-US\",\n  className,\n  children,\n  ...props\n}: DataGridProps<T>) {\n  const id = useId();\n  const labels = { ...LABELS, ...given };\n  const [sort, setSort] = useControllableState<readonly DataGridSort[]>({ value: sortProp, defaultValue: defaultSort, onChange: onSortChange });\n  const [hidden, setHidden] = useControllableState<readonly string[]>({ value: hiddenProp, defaultValue: defaultHidden, onChange: onHiddenChange });\n  const [selected, setSelected] = useControllableState<readonly string[]>({ value: selectedProp, defaultValue: defaultSelected, onChange: onSelectedChange });\n  const [filters, setFilters] = useState<Readonly<Record<string, string>>>({});\n  const [search, setSearch] = useState(\"\");\n  const [page, setPage] = useState(0);\n  const [collapsed, setCollapsed] = useState<readonly string[]>([]);\n\n  const numbers = useMemo(() => new Intl.NumberFormat(locale, { maximumFractionDigits: 2 }), [locale]);\n  const text = (column: DataGridColumn<T>, row: T): string => {\n    const value = (row as Record<string, unknown>)[column.key];\n    if (column.format) return column.format(value, row);\n    if (typeof value === \"number\") return numbers.format(value);\n    return value === null || value === undefined ? \"\" : String(value);\n  };\n  const visible = columns.filter((column) => !hidden.includes(column.key));\n  // Pinned columns first, so they can stick at the start.\n  const ordered = [...visible.filter((c) => c.pin === \"start\"), ...visible.filter((c) => c.pin !== \"start\")];\n\n  const matched = useMemo(() => {\n    const needle = search.trim().toLocaleLowerCase(locale);\n    const active = Object.entries(filters).filter(([, value]) => value.trim() !== \"\");\n    const out = rows.filter((row) => {\n      if (needle && !columns.some((column) => text(column, row).toLocaleLowerCase(locale).includes(needle))) return false;\n      return active.every(([key, value]) => {\n        const column = columns.find((c) => c.key === key);\n        return column ? text(column, row).toLocaleLowerCase(locale).includes(value.trim().toLocaleLowerCase(locale)) : true;\n      });\n    });\n    const collator = new Intl.Collator(locale, { numeric: true, sensitivity: \"base\" });\n    if (sort.length > 0) {\n      out.sort((a, b) => {\n        for (const item of sort) {\n          const column = columns.find((c) => c.key === item.key);\n          if (!column) continue;\n          const va = (a as Record<string, unknown>)[item.key];\n          const vb = (b as Record<string, unknown>)[item.key];\n          let order: number;\n          if (column.type === \"number\") order = (typeof va === \"number\" ? va : -Infinity) - (typeof vb === \"number\" ? vb : -Infinity);\n          else if (column.type === \"date\") order = String(va ?? \"\").localeCompare(String(vb ?? \"\"));\n          else order = collator.compare(text(column, a), text(column, b));\n          if (order !== 0) return item.direction === \"ascending\" ? order : -order;\n        }\n        return 0;\n      });\n    }\n    return out;\n    // `text` follows `columns` and `locale`, which are listed.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [rows, columns, filters, search, sort, locale]);\n\n  const lines = useMemo((): Line<T>[] => {\n    if (!groupBy) return matched.map((row, index) => ({ kind: \"row\", row, index }));\n    const column = columns.find((c) => c.key === groupBy);\n    const groups = new Map<string, T[]>();\n    for (const row of matched) {\n      const value = column ? text(column, row) : String((row as Record<string, unknown>)[groupBy] ?? \"\");\n      groups.set(value, [...(groups.get(value) ?? []), row]);\n    }\n    let index = 0;\n    return [...groups].flatMap(([value, members]) => [\n      { kind: \"group\" as const, value, rows: members },\n      ...(collapsed.includes(value) ? [] : members.map((row) => ({ kind: \"row\" as const, row, index: index++ }))),\n    ]);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [matched, groupBy, columns, collapsed]);\n\n  const size = pageSize > 0 ? pageSize : Math.max(1, lines.length);\n  const pages = Math.max(1, Math.ceil(lines.length / size));\n  const current = Math.min(page, pages - 1);\n  const pageRows = lines.slice(current * size, current * size + size);\n\n  const state: GridState<T> = {\n    id,\n    label,\n    columns,\n    visible: ordered,\n    hidden,\n    setHidden,\n    sort,\n    setSort: (next) => {\n      setSort(next);\n      const first = next[0];\n      const column = columns.find((c) => c.key === first?.key);\n      if (first && column) announce(labels.sorted(column.header, first.direction));\n    },\n    filters,\n    setFilters: (next) => {\n      setFilters(next);\n      setPage(0);\n    },\n    search,\n    setSearch: (next) => {\n      setSearch(next);\n      setPage(0);\n    },\n    groupBy,\n    page: current,\n    setPage,\n    pages,\n    pageRows,\n    matched,\n    total: rows.length,\n    selected,\n    setSelected,\n    selectable,\n    rowId,\n    text,\n    labels,\n    locale,\n    collapsed,\n    toggleGroup: (value) => setCollapsed((list) => (list.includes(value) ? list.filter((v) => v !== value) : [...list, value])),\n    onCellEdit,\n    height,\n    rowHeight,\n  };\n\n  return (\n    <GridContext value={state as unknown as GridState<object>}>\n      <div data-slot=\"data-grid\" className={cn(\"@container flex w-full min-w-0 flex-col gap-3\", className)} {...props}>\n        {children ?? (\n          <>\n            <DataGridToolbar>\n              <DataGridSearch />\n              <DataGridColumns />\n            </DataGridToolbar>\n            <DataGridTable />\n            <DataGridFooter />\n          </>\n        )}\n      </div>\n    </GridContext>\n  );\n}\n\n/** A row of controls over the grid: search, the columns menu, actions of the project's own. */\nexport function DataGridToolbar({ className, ...props }: ComponentProps<\"div\">) {\n  return <div data-slot=\"data-grid-toolbar\" className={cn(\"flex flex-wrap items-center gap-2\", className)} {...props} />;\n}\n\n/** One field that narrows the rows by any column's text. */\nexport function DataGridSearch({ className, ...props }: Omit<ComponentProps<\"input\">, \"value\" | \"onChange\" | \"size\">) {\n  const grid = useGrid(\"DataGridSearch\");\n  return (\n    <div className={cn(\"relative min-w-0 flex-1 @md:max-w-xs\", className)}>\n      <Search aria-hidden=\"true\" className=\"pointer-events-none absolute start-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground\" />\n      <Input type=\"search\" aria-label={grid.labels.search} placeholder={grid.labels.search} value={grid.search} onChange={(event) => grid.setSearch(event.target.value)} className=\"ps-9\" {...props} />\n    </div>\n  );\n}\n\n/** A menu of the columns, each shown or hidden by a checkbox item. */\nexport function DataGridColumns({ className }: { className?: string }) {\n  const grid = useGrid(\"DataGridColumns\");\n  return (\n    <DropdownMenu>\n      <DropdownMenuTrigger asChild>\n        <Button variant=\"outline\" className={className}>\n          <Columns3 aria-hidden=\"true\" />\n          {grid.labels.columns}\n        </Button>\n      </DropdownMenuTrigger>\n      <DropdownMenuContent align=\"end\">\n        <DropdownMenuLabel>{grid.labels.columns}</DropdownMenuLabel>\n        {grid.columns.map((column) => (\n          <DropdownMenuCheckboxItem\n            key={column.key}\n            checked={!grid.hidden.includes(column.key)}\n            // At least one column stays.\n            disabled={!grid.hidden.includes(column.key) && grid.columns.length - grid.hidden.length <= 1}\n            onCheckedChange={(on) => grid.setHidden(on ? grid.hidden.filter((key) => key !== column.key) : [...grid.hidden, column.key])}\n            onSelect={(event) => event.preventDefault()}\n          >\n            {column.header}\n          </DropdownMenuCheckboxItem>\n        ))}\n      </DropdownMenuContent>\n    </DropdownMenu>\n  );\n}\n\n/** The grid itself: headers with sorting and filters, rows, group rows, and the keys of the grid pattern. */\nexport function DataGridTable({ className, showFilters = true, ...props }: ComponentProps<\"div\"> & { showFilters?: boolean }) {\n  const grid = useGrid(\"DataGridTable\");\n  const { visible, pageRows, labels, selectable } = grid;\n  const [focus, setFocus] = useState<{ row: number; column: number }>({ row: 0, column: 0 });\n  const [editing, setEditing] = useState<{ row: number; column: number; value: string } | null>(null);\n  const [scroll, setScroll] = useState(0);\n  const tableRef = useRef<HTMLTableElement>(null);\n  const columnCount = visible.length + (selectable ? 1 : 0);\n  // Grid rows: the header, the filter row, then the body. Positions are 0-based here.\n  const headRows = showFilters ? 2 : 1;\n  const rowCount = headRows + pageRows.length;\n  const lead = selectable ? 1 : 0;\n  const pinnedWidths = visible.map((column) => (column.pin === \"start\" ? (column.width ?? 160) : 0));\n  const offsetOf = (index: number): number => (selectable ? 48 : 0) + pinnedWidths.slice(0, index).reduce((a, b) => a + b, 0);\n\n  // Only the rows in view are drawn when the body has a fixed height.\n  const windowed = grid.height !== undefined && pageRows.length > 60;\n  const first = windowed ? Math.max(0, Math.floor(scroll / grid.rowHeight) - 10) : 0;\n  const last = windowed ? Math.min(pageRows.length, first + Math.ceil((grid.height ?? 0) / grid.rowHeight) + 20) : pageRows.length;\n\n  const moveTo = (row: number, column: number): void => {\n    const next = { row: Math.max(0, Math.min(rowCount - 1, row)), column: Math.max(0, Math.min(columnCount - 1, column)) };\n    setFocus(next);\n    requestAnimationFrame(() => {\n      const cell = tableRef.current?.querySelector<HTMLElement>(`[data-cell=\"${next.row}:${next.column}\"]`);\n      // A cell holding one control hands focus to it, as the grid pattern asks.\n      const inner = cell?.querySelector<HTMLElement>(\"button, input, [role=checkbox]\");\n      (inner ?? cell)?.focus();\n      if (!cell && windowed && tableRef.current?.parentElement) tableRef.current.parentElement.scrollTop = (next.row - headRows) * grid.rowHeight;\n    });\n  };\n  const sortBy = (column: DataGridColumn<object>, add: boolean): void => {\n    const existing = grid.sort.find((item) => item.key === column.key);\n    const direction: DataGridSort[\"direction\"] = existing?.direction === \"ascending\" ? \"descending\" : \"ascending\";\n    const rest = add ? grid.sort.filter((item) => item.key !== column.key) : [];\n    grid.setSort(existing?.direction === \"descending\" && !add ? [] : [...rest, { key: column.key, direction }]);\n  };\n  const commit = (): void => {\n    if (!editing) return;\n    const line = pageRows[editing.row - headRows];\n    const column = visible[editing.column - lead];\n    if (line?.kind === \"row\" && column) {\n      const value = column.type === \"number\" ? Number(editing.value) : editing.value;\n      if (!(column.type === \"number\" && !Number.isFinite(value))) grid.onCellEdit?.(grid.rowId(line.row), column.key, value);\n    }\n    setEditing(null);\n    moveTo(editing.row, editing.column);\n  };\n  const onKeyDown = (event: KeyboardEvent<HTMLTableElement>): void => {\n    if (editing) return;\n    const target = event.target as HTMLElement;\n    if (target.tagName === \"INPUT\" && (target as HTMLInputElement).type !== \"checkbox\" && ![\"ArrowUp\", \"ArrowDown\", \"Escape\"].includes(event.key)) return;\n    const page = Math.max(1, Math.floor((grid.height ?? 400) / grid.rowHeight) - 1);\n    const { row, column } = focus;\n    const rtl = getComputedStyle(event.currentTarget).direction === \"rtl\";\n    const ahead = rtl ? \"ArrowLeft\" : \"ArrowRight\";\n    const back = rtl ? \"ArrowRight\" : \"ArrowLeft\";\n    if (event.key === ahead) moveTo(row, column + 1);\n    else if (event.key === back) moveTo(row, column - 1);\n    else if (event.key === \"ArrowDown\") moveTo(row + 1, column);\n    else if (event.key === \"ArrowUp\") moveTo(row - 1, column);\n    else if (event.key === \"Home\") moveTo(event.ctrlKey ? 0 : row, 0);\n    else if (event.key === \"End\") moveTo(event.ctrlKey ? rowCount - 1 : row, columnCount - 1);\n    else if (event.key === \"PageDown\") moveTo(row + page, column);\n    else if (event.key === \"PageUp\") moveTo(row - page, column);\n    else if ((event.key === \"Enter\" || event.key === \"F2\") && row >= headRows) {\n      const column_ = visible[column - lead];\n      const line = pageRows[row - headRows];\n      if (line?.kind === \"group\") {\n        grid.toggleGroup(line.value);\n      } else if (column_?.editable && line?.kind === \"row\" && grid.onCellEdit) {\n        setEditing({ row, column, value: String((line.row as Record<string, unknown>)[column_.key] ?? \"\") });\n      } else return;\n    } else return;\n    event.preventDefault();\n  };\n  const cellProps = (row: number, column: number): { \"data-cell\": string; tabIndex: number; onFocus: () => void } => ({\n    \"data-cell\": `${row}:${column}`,\n    tabIndex: focus.row === row && focus.column === column ? 0 : -1,\n    onFocus: () => setFocus({ row, column }),\n  });\n  const pin = (index: number): { className: string; style: { insetInlineStart: number; width: number; minWidth: number } } | { className: string; style?: undefined } =>\n    visible[index]?.pin === \"start\"\n      ? { className: \"sticky z-10 bg-card\", style: { insetInlineStart: offsetOf(index), width: pinnedWidths[index] ?? 160, minWidth: pinnedWidths[index] ?? 160 } }\n      : { className: \"\" };\n  const pageIds = pageRows.flatMap((line) => (line.kind === \"row\" ? [grid.rowId(line.row)] : []));\n  const allChosen = pageIds.length > 0 && pageIds.every((rid) => grid.selected.includes(rid));\n  const someChosen = pageIds.some((rid) => grid.selected.includes(rid));\n  const aggregate = (column: DataGridColumn<object>, members: readonly object[]): string => {\n    if (!column.aggregate) return \"\";\n    const values = members.map((row) => (row as Record<string, unknown>)[column.key]).filter((v): v is number => typeof v === \"number\");\n    return new Intl.NumberFormat(grid.locale, { maximumFractionDigits: 2 }).format(aggregateOf(column.aggregate, values));\n  };\n\n  return (\n    <div\n      data-slot=\"data-grid-scroller\"\n      className={cn(\"relative w-full overflow-auto rounded-surface border\", className)}\n      style={grid.height !== undefined ? { maxHeight: grid.height } : undefined}\n      onScroll={windowed ? (event) => setScroll(event.currentTarget.scrollTop) : undefined}\n      {...props}\n    >\n      <table\n        ref={tableRef}\n        role=\"grid\"\n        aria-label={grid.label}\n        aria-rowcount={headRows + (grid.groupBy ? pageRows.length : grid.matched.length)}\n        aria-colcount={columnCount}\n        className=\"w-full border-separate border-spacing-0 text-sm\"\n        onKeyDown={onKeyDown}\n      >\n        <thead className=\"sticky top-0 z-20 bg-card\">\n          <tr aria-rowindex={1}>\n            {selectable ? (\n              <th scope=\"col\" className=\"sticky start-0 z-10 w-12 border-b bg-card px-3\" {...cellProps(0, 0)}>\n                <Checkbox\n                  aria-label={labels.selectAll}\n                  checked={allChosen ? true : someChosen ? \"indeterminate\" : false}\n                  onCheckedChange={(on) => grid.setSelected(on === true ? [...new Set([...grid.selected, ...pageIds])] : grid.selected.filter((rid) => !pageIds.includes(rid)))}\n                  tabIndex={-1}\n                />\n              </th>\n            ) : null}\n            {visible.map((column, index) => {\n              const sorted = grid.sort.find((item) => item.key === column.key);\n              const position = grid.sort.length > 1 && sorted ? grid.sort.indexOf(sorted) + 1 : null;\n              const Icon = sorted ? (sorted.direction === \"ascending\" ? ArrowUp : ArrowDown) : ArrowUpDown;\n              const p = pin(index);\n              return (\n                <th\n                  key={column.key}\n                  scope=\"col\"\n                  aria-sort={sorted ? sorted.direction : column.sortable === false ? undefined : \"none\"}\n                  className={cn(\"h-10 border-b px-3 text-start font-medium whitespace-nowrap text-muted-foreground\", column.type === \"number\" && \"text-end\", p.className)}\n                  style={p.style ?? (column.width ? { width: column.width } : undefined)}\n                  {...cellProps(0, index + lead)}\n                >\n                  {column.sortable === false ? (\n                    column.header\n                  ) : (\n                    <button\n                      type=\"button\"\n                      tabIndex={-1}\n                      aria-label={labels.sortBy(column.header)}\n                      onClick={(event) => sortBy(column, event.shiftKey)}\n                      className={cn(\"inline-flex min-h-8 items-center gap-1 rounded-control hover:text-foreground\", sorted && \"text-foreground\")}\n                    >\n                      {column.header}\n                      <Icon aria-hidden=\"true\" className={cn(\"size-3.5\", !sorted && \"opacity-50\")} />\n                      {position ? <span className=\"text-xs tabular-nums\">{position}</span> : null}\n                    </button>\n                  )}\n                </th>\n              );\n            })}\n          </tr>\n          {showFilters ? (\n            <tr aria-rowindex={2}>\n              {selectable ? <td className=\"sticky start-0 z-10 border-b bg-card\" {...cellProps(1, 0)} /> : null}\n              {visible.map((column, index) => {\n                const p = pin(index);\n                return (\n                  <td key={column.key} className={cn(\"border-b px-2 py-1.5\", p.className)} style={p.style} {...cellProps(1, index + lead)}>\n                    {column.filterable === false ? null : (\n                      <Input\n                        size=\"sm\"\n                        tabIndex={-1}\n                        aria-label={labels.filter(column.header)}\n                        value={grid.filters[column.key] ?? \"\"}\n                        onChange={(event) => grid.setFilters({ ...grid.filters, [column.key]: event.target.value })}\n                        className=\"min-w-16\"\n                      />\n                    )}\n                  </td>\n                );\n              })}\n            </tr>\n          ) : null}\n        </thead>\n        <tbody>\n          {pageRows.length === 0 ? (\n            <tr>\n              <td colSpan={columnCount} className=\"px-3 py-8 text-center text-muted-foreground\">\n                {labels.noResults}\n              </td>\n            </tr>\n          ) : null}\n          {windowed && first > 0 ? (\n            <tr aria-hidden=\"true\">\n              <td colSpan={columnCount} style={{ height: first * grid.rowHeight, padding: 0 }} />\n            </tr>\n          ) : null}\n          {pageRows.slice(first, last).map((line, offset) => {\n            const position = first + offset;\n            const row = headRows + position;\n            if (line.kind === \"group\") {\n              const open = !grid.collapsed.includes(line.value);\n              return (\n                <tr key={`group:${line.value}`} data-group={line.value} aria-rowindex={row + 1} className=\"bg-muted\">\n                  {selectable ? <td className=\"sticky start-0 z-10 border-b bg-muted\" /> : null}\n                  {visible.map((column, index) => {\n                    const p = pin(index);\n                    return (\n                      <td\n                        key={column.key}\n                        className={cn(\"border-b px-3 font-medium\", column.type === \"number\" && \"text-end tabular-nums\", p.className, p.className && \"bg-muted\")}\n                        style={{ ...p.style, height: grid.rowHeight }}\n                        {...cellProps(row, index + lead)}\n                      >\n                        {index === 0 ? (\n                          <button\n                            type=\"button\"\n                            tabIndex={-1}\n                            aria-expanded={open}\n                            onClick={() => grid.toggleGroup(line.value)}\n                            aria-label={`${open ? labels.collapse : labels.expand}: ${line.value}`}\n                            className=\"inline-flex items-center gap-1 rounded-control\"\n                          >\n                            {open ? <ChevronDown aria-hidden=\"true\" className=\"size-4\" /> : <ChevronRight aria-hidden=\"true\" className=\"size-4 rtl:-scale-x-100\" />}\n                            {labels.group(line.value || labels.empty, new Intl.NumberFormat(grid.locale).format(line.rows.length))}\n                          </button>\n                        ) : (\n                          aggregate(column, line.rows)\n                        )}\n                      </td>\n                    );\n                  })}\n                </tr>\n              );\n            }\n            const rid = grid.rowId(line.row);\n            const chosen = grid.selected.includes(rid);\n            return (\n              <tr\n                key={rid}\n                aria-rowindex={headRows + line.index + 1}\n                aria-selected={selectable ? chosen : undefined}\n                className={cn(\"hover:bg-accent\", chosen && \"bg-highlight-soft hover:bg-highlight-soft\")}\n              >\n                {selectable ? (\n                  <td className={cn(\"sticky start-0 z-10 border-b px-3\", chosen ? \"bg-highlight-soft\" : \"bg-card\")} style={{ height: grid.rowHeight }} {...cellProps(row, 0)}>\n                    <Checkbox\n                      aria-label={labels.selectRow(line.index + 1)}\n                      checked={chosen}\n                      tabIndex={-1}\n                      onCheckedChange={(on) => grid.setSelected(on === true ? [...grid.selected, rid] : grid.selected.filter((x) => x !== rid))}\n                    />\n                  </td>\n                ) : null}\n                {visible.map((column, index) => {\n                  const p = pin(index);\n                  const isEditing = editing?.row === row && editing.column === index + lead;\n                  return (\n                    <td\n                      key={column.key}\n                      className={cn(\"border-b px-3 whitespace-nowrap\", column.type === \"number\" && \"text-end tabular-nums\", p.className, p.className && chosen && \"bg-highlight-soft\")}\n                      style={{ ...p.style, height: grid.rowHeight }}\n                      aria-description={column.editable && grid.onCellEdit ? labels.editHint : undefined}\n                      {...cellProps(row, index + lead)}\n                    >\n                      {isEditing ? (\n                        <Input\n                          size=\"sm\"\n                          // The field is the edit: it takes focus as it opens.\n                          autoFocus\n                          aria-label={column.header}\n                          type={column.type === \"number\" ? \"number\" : \"text\"}\n                          value={editing.value}\n                          onChange={(event) => setEditing({ ...editing, value: event.target.value })}\n                          onKeyDown={(event) => {\n                            if (event.key === \"Enter\") {\n                              event.preventDefault();\n                              commit();\n                            } else if (event.key === \"Escape\") {\n                              event.preventDefault();\n                              setEditing(null);\n                              moveTo(row, index + lead);\n                            }\n                            event.stopPropagation();\n                          }}\n                          onBlur={commit}\n                        />\n                      ) : column.render ? (\n                        column.render(line.row)\n                      ) : (\n                        grid.text(column, line.row)\n                      )}\n                    </td>\n                  );\n                })}\n              </tr>\n            );\n          })}\n          {windowed && last < pageRows.length ? (\n            <tr aria-hidden=\"true\">\n              <td colSpan={columnCount} style={{ height: (pageRows.length - last) * grid.rowHeight, padding: 0 }} />\n            </tr>\n          ) : null}\n        </tbody>\n      </table>\n    </div>\n  );\n}\n\n/** Under the grid: how many rows match, how many are chosen, and the pages. */\nexport function DataGridFooter({ className, ...props }: ComponentProps<\"div\">) {\n  const grid = useGrid(\"DataGridFooter\");\n  const n = (value: number): string => new Intl.NumberFormat(grid.locale).format(value);\n  return (\n    <div data-slot=\"data-grid-footer\" className={cn(\"flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground\", className)} {...props}>\n      <p data-slot=\"data-grid-status\" role=\"status\" className=\"tabular-nums\">\n        {grid.labels.results(n(grid.matched.length), n(grid.total))}\n        {grid.selectable && grid.selected.length > 0 ? ` · ${grid.labels.selected(n(grid.selected.length))}` : \"\"}\n      </p>\n      {grid.pages > 1 ? (\n        <div className=\"flex items-center gap-2\">\n          <Button variant=\"outline\" size=\"sm\" onClick={() => grid.setPage(grid.page - 1)} disabled={grid.page === 0} aria-label={grid.labels.previous}>\n            <ChevronRight aria-hidden=\"true\" className=\"-scale-x-100 rtl:scale-x-100\" />\n          </Button>\n          <span className=\"tabular-nums\">{grid.labels.page(n(grid.page + 1), n(grid.pages))}</span>\n          <Button variant=\"outline\" size=\"sm\" onClick={() => grid.setPage(grid.page + 1)} disabled={grid.page >= grid.pages - 1} aria-label={grid.labels.next}>\n            <ChevronRight aria-hidden=\"true\" className=\"rtl:-scale-x-100\" />\n          </Button>\n        </div>\n      ) : null}\n    </div>\n  );\n}\n"
    }
  ],
  "meta": {
    "category": "ui",
    "when": "Lists of records that are sorted, narrowed, compared and changed: orders, accounts, files, results. For a few rows to read use table; for side-by-side comparison of two to four things use compare-table; for an endless feed use virtual-list.",
    "example": "<DataGrid\n  label=\"Orders\"\n  rows={orders}\n  rowId={(order) => order.id}\n  columns={[\n    { key: \"id\", header: \"Order\", pin: \"start\", width: 110 },\n    { key: \"customer\", header: \"Customer\" },\n    { key: \"status\", header: \"Status\" },\n    { key: \"total\", header: \"Total\", type: \"number\", aggregate: \"sum\", editable: true },\n  ]}\n  selectable\n  pageSize={20}\n  onCellEdit={(id, key, value) => save(id, key, value)}\n/>",
    "client": true
  }
}
