{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "data-explorer",
  "title": "ResponsiveDataExplorer",
  "description": "A responsive data-management workflow with search, filters, sorting, pagination, selection, URL state, desktop tables, and mobile cards.",
  "dependencies": [
    "@tanstack/react-table@^9.1.2"
  ],
  "registryDependencies": [
    "https://elsecase.vercel.app/r/async-state.json"
  ],
  "files": [
    {
      "path": "registry/data-explorer/data-explorer.tsx",
      "content": "\"use client\"\n\nimport {\n  createColumnHelper,\n  createPaginatedRowModel,\n  createSortedRowModel,\n  rowPaginationFeature,\n  rowSelectionFeature,\n  rowSortingFeature,\n  sortFn_alphanumeric,\n  sortFn_alphanumericCaseSensitive,\n  sortFn_basic,\n  sortFn_datetime,\n  sortFn_text,\n  sortFn_textCaseSensitive,\n  tableFeatures,\n  useTable,\n  type CellData,\n  type ColumnDef,\n  type RowData,\n  type RowSelectionState,\n  type SortingState,\n  type Updater,\n} from \"@tanstack/react-table\"\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type InputHTMLAttributes,\n  type ReactNode,\n} from \"react\"\n\nimport { AsyncState, type AsyncStatus } from \"@/components/async-state\"\n\nexport interface DataExplorerPagination {\n  pageIndex: number\n  pageSize: number\n}\n\nexport interface DataExplorerSearchConfig<TData> {\n  getSearchText: (row: TData) => string\n  label?: string\n  placeholder?: string\n}\n\nexport interface DataExplorerFilterOption {\n  label: string\n  value: string\n}\n\nexport interface DataExplorerFilterConfig<TData> {\n  id: string\n  label: string\n  getValue: (row: TData) => string\n  options: DataExplorerFilterOption[]\n}\n\nexport interface DataExplorerUrlState {\n  search: string\n  filters: Record<string, string>\n  pagination: DataExplorerPagination\n  sorting: SortingState\n}\n\nconst dataExplorerFeatures = tableFeatures({\n  rowSortingFeature,\n  sortedRowModel: createSortedRowModel(),\n  sortFns: {\n    alphanumeric: sortFn_alphanumeric,\n    alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,\n    basic: sortFn_basic,\n    datetime: sortFn_datetime,\n    text: sortFn_text,\n    textCaseSensitive: sortFn_textCaseSensitive,\n  },\n  rowPaginationFeature,\n  paginatedRowModel: createPaginatedRowModel(),\n  rowSelectionFeature,\n})\n\nexport type DataExplorerColumnDef<TData extends RowData> = ColumnDef<\n  typeof dataExplorerFeatures,\n  TData,\n  CellData\n>\n\nexport function createDataExplorerColumnHelper<TData extends RowData>() {\n  return createColumnHelper<typeof dataExplorerFeatures, TData>()\n}\n\nexport interface DataExplorerProps<TData extends RowData> {\n  data: TData[]\n  columns: DataExplorerColumnDef<TData>[]\n  getRowId: (row: TData) => string\n  status?: AsyncStatus\n  error?: unknown\n  search?: DataExplorerSearchConfig<TData>\n  filters?: DataExplorerFilterConfig<TData>[]\n  pagination?: DataExplorerPagination\n  sorting?: SortingState\n  selection?: RowSelectionState\n  mobileCard: (row: TData) => ReactNode\n  bulkActions?: ReactNode\n  emptyState?: ReactNode\n  noResultsState?: ReactNode\n  onRetry?: () => void | Promise<void>\n  onPaginationChange?: (pagination: DataExplorerPagination) => void\n  onSortingChange?: (sorting: SortingState) => void\n  onSelectionChange?: (selection: RowSelectionState) => void\n  syncStateToUrl?: boolean\n}\n\nconst defaultPagination: DataExplorerPagination = {\n  pageIndex: 0,\n  pageSize: 10,\n}\nconst emptyFilters: [] = []\n\nconst searchParameter = \"q\"\nconst sortParameter = \"sort\"\nconst pageParameter = \"page\"\nconst pageSizeParameter = \"size\"\nconst filterPrefix = \"filter.\"\n\nfunction resolveUpdater<T>(updater: Updater<T>, previous: T): T {\n  return typeof updater === \"function\"\n    ? (updater as (value: T) => T)(previous)\n    : updater\n}\n\nfunction validPositiveInteger(value: string | null, fallback: number) {\n  const parsed = Number(value)\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback\n}\n\nfunction parseSorting(value: string | null): SortingState {\n  if (!value) return []\n\n  return value\n    .split(\",\")\n    .map((entry) => {\n      const separator = entry.lastIndexOf(\".\")\n      if (separator < 1) return null\n      let id: string\n      try {\n        id = decodeURIComponent(entry.slice(0, separator))\n      } catch {\n        return null\n      }\n      const direction = entry.slice(separator + 1)\n      if (!id || (direction !== \"asc\" && direction !== \"desc\")) return null\n      return { id, desc: direction === \"desc\" }\n    })\n    .filter((entry): entry is SortingState[number] => entry !== null)\n}\n\nfunction serializeSorting(sorting: SortingState) {\n  return sorting\n    .map(({ id, desc }) => `${encodeURIComponent(id)}.${desc ? \"desc\" : \"asc\"}`)\n    .join(\",\")\n}\n\nexport function parseDataExplorerUrlState(\n  parameters: URLSearchParams,\n  filterIds: string[],\n  fallbackPagination: DataExplorerPagination = defaultPagination,\n): DataExplorerUrlState {\n  const filters = Object.fromEntries(\n    filterIds.map((id) => [id, parameters.get(`${filterPrefix}${id}`) ?? \"\"]),\n  )\n\n  return {\n    search: parameters.get(searchParameter) ?? \"\",\n    filters,\n    sorting: parseSorting(parameters.get(sortParameter)),\n    pagination: {\n      pageIndex: validPositiveInteger(parameters.get(pageParameter), 1) - 1,\n      pageSize: validPositiveInteger(\n        parameters.get(pageSizeParameter),\n        fallbackPagination.pageSize,\n      ),\n    },\n  }\n}\n\nexport function serializeDataExplorerUrlState(\n  current: URLSearchParams,\n  state: DataExplorerUrlState,\n  filterIds: string[],\n  fallbackPagination: DataExplorerPagination = defaultPagination,\n) {\n  const parameters = new URLSearchParams(current.toString())\n  const setOrDelete = (key: string, value: string, defaultValue = \"\") => {\n    if (value === defaultValue) parameters.delete(key)\n    else parameters.set(key, value)\n  }\n\n  setOrDelete(searchParameter, state.search.trim())\n  setOrDelete(sortParameter, serializeSorting(state.sorting))\n  setOrDelete(pageParameter, String(state.pagination.pageIndex + 1), \"1\")\n  setOrDelete(\n    pageSizeParameter,\n    String(state.pagination.pageSize),\n    String(fallbackPagination.pageSize),\n  )\n  filterIds.forEach((id) =>\n    setOrDelete(`${filterPrefix}${id}`, state.filters[id] ?? \"\"),\n  )\n\n  return parameters\n}\n\nexport function filterDataExplorerRows<TData>(\n  data: TData[],\n  search: string,\n  searchConfig: DataExplorerSearchConfig<TData> | undefined,\n  filters: DataExplorerFilterConfig<TData>[],\n  filterValues: Record<string, string>,\n) {\n  const normalizedSearch = search.trim().toLocaleLowerCase()\n\n  return data.filter((row) => {\n    const matchesSearch =\n      !normalizedSearch ||\n      !searchConfig ||\n      searchConfig\n        .getSearchText(row)\n        .toLocaleLowerCase()\n        .includes(normalizedSearch)\n    const matchesFilters = filters.every((filter) => {\n      const expected = filterValues[filter.id]\n      return !expected || filter.getValue(row) === expected\n    })\n    return matchesSearch && matchesFilters\n  })\n}\n\nfunction IndeterminateCheckbox({\n  className,\n  indeterminate,\n  ...props\n}: InputHTMLAttributes<HTMLInputElement> & { indeterminate?: boolean }) {\n  const ref = useRef<HTMLInputElement>(null)\n\n  useEffect(() => {\n    if (ref.current) ref.current.indeterminate = Boolean(indeterminate)\n  }, [indeterminate])\n\n  return (\n    <input\n      {...props}\n      className={joinClassNames(\n        \"border-input accent-primary focus-visible:ring-ring size-5 shrink-0 rounded border focus-visible:ring-2 focus-visible:ring-offset-2\",\n        className,\n      )}\n      ref={ref}\n      type=\"checkbox\"\n    />\n  )\n}\n\nfunction DefaultEmptyState() {\n  return (\n    <div className=\"bg-card flex min-h-52 flex-col items-center justify-center gap-2 rounded-lg border p-8 text-center\">\n      <p className=\"font-semibold\">No records yet</p>\n      <p className=\"text-muted-foreground max-w-sm text-sm\">\n        Data will appear here when records are available.\n      </p>\n    </div>\n  )\n}\n\nfunction joinClassNames(...values: Array<string | false | undefined>) {\n  return values.filter(Boolean).join(\" \")\n}\n\nexport function ResponsiveDataExplorer<TData extends RowData>({\n  data,\n  columns,\n  getRowId,\n  status,\n  error,\n  search: searchConfig,\n  filters,\n  pagination,\n  sorting,\n  selection,\n  mobileCard,\n  bulkActions,\n  emptyState,\n  noResultsState,\n  onRetry,\n  onPaginationChange,\n  onSortingChange,\n  onSelectionChange,\n  syncStateToUrl = false,\n}: DataExplorerProps<TData>) {\n  const activeFilters = filters ?? emptyFilters\n  const initialPagination = pagination ?? defaultPagination\n  const [searchValue, setSearchValue] = useState(\"\")\n  const [filterValues, setFilterValues] = useState<Record<string, string>>({})\n  const [internalPagination, setInternalPagination] =\n    useState<DataExplorerPagination>(initialPagination)\n  const [internalSorting, setInternalSorting] = useState<SortingState>(\n    sorting ?? [],\n  )\n  const [internalSelection, setInternalSelection] = useState<RowSelectionState>(\n    selection ?? {},\n  )\n  const [urlReady, setUrlReady] = useState(!syncStateToUrl)\n\n  const activePagination = pagination ?? internalPagination\n  const activeSorting = sorting ?? internalSorting\n  const activeSelection = selection ?? internalSelection\n  const filterIds = useMemo(\n    () => activeFilters.map(({ id }) => id),\n    [activeFilters],\n  )\n  const filterIdsKey = filterIds.join(\"\\u001f\")\n  const didRestoreUrl = useRef(false)\n\n  const changePagination = useCallback(\n    (updater: Updater<DataExplorerPagination>) => {\n      const next = resolveUpdater(updater, activePagination)\n      if (pagination === undefined) setInternalPagination(next)\n      onPaginationChange?.(next)\n    },\n    [activePagination, onPaginationChange, pagination],\n  )\n\n  const changeSorting = useCallback(\n    (updater: Updater<SortingState>) => {\n      const next = resolveUpdater(updater, activeSorting)\n      if (sorting === undefined) setInternalSorting(next)\n      onSortingChange?.(next)\n    },\n    [activeSorting, onSortingChange, sorting],\n  )\n\n  const changeSelection = useCallback(\n    (updater: Updater<RowSelectionState>) => {\n      const next = resolveUpdater(updater, activeSelection)\n      if (selection === undefined) setInternalSelection(next)\n      onSelectionChange?.(next)\n    },\n    [activeSelection, onSelectionChange, selection],\n  )\n\n  useEffect(() => {\n    if (!syncStateToUrl) return\n    const restoreUrlState = () => {\n      const restored = parseDataExplorerUrlState(\n        new URLSearchParams(window.location.search),\n        filterIdsKey ? filterIdsKey.split(\"\\u001f\") : [],\n        initialPagination,\n      )\n      setSearchValue(restored.search)\n      setFilterValues(restored.filters)\n      if (pagination === undefined) setInternalPagination(restored.pagination)\n      onPaginationChange?.(restored.pagination)\n      if (sorting === undefined) setInternalSorting(restored.sorting)\n      onSortingChange?.(restored.sorting)\n      setUrlReady(true)\n    }\n    if (!didRestoreUrl.current) {\n      didRestoreUrl.current = true\n      restoreUrlState()\n    }\n    window.addEventListener(\"popstate\", restoreUrlState)\n    return () => window.removeEventListener(\"popstate\", restoreUrlState)\n  }, [\n    filterIdsKey,\n    initialPagination,\n    onPaginationChange,\n    onSortingChange,\n    pagination,\n    sorting,\n    syncStateToUrl,\n  ])\n\n  useEffect(() => {\n    if (!syncStateToUrl || !urlReady) return\n    const next = serializeDataExplorerUrlState(\n      new URLSearchParams(window.location.search),\n      {\n        search: searchValue,\n        filters: filterValues,\n        pagination: activePagination,\n        sorting: activeSorting,\n      },\n      filterIds,\n      initialPagination,\n    )\n    const query = next.toString()\n    const nextUrl = `${window.location.pathname}${query ? `?${query}` : \"\"}${window.location.hash}`\n    window.history.replaceState(window.history.state, \"\", nextUrl)\n  }, [\n    activePagination,\n    activeSorting,\n    filterIds,\n    filterIdsKey,\n    filterValues,\n    initialPagination,\n    searchValue,\n    syncStateToUrl,\n    urlReady,\n  ])\n\n  const filteredData = useMemo(\n    () =>\n      filterDataExplorerRows(\n        data,\n        searchValue,\n        searchConfig,\n        activeFilters,\n        filterValues,\n      ),\n    [activeFilters, data, filterValues, searchConfig, searchValue],\n  )\n\n  const table = useTable({\n    features: dataExplorerFeatures,\n    columns,\n    data: filteredData,\n    getRowId,\n    state: {\n      pagination: activePagination,\n      rowSelection: activeSelection,\n      sorting: activeSorting,\n    },\n    onPaginationChange: changePagination,\n    onRowSelectionChange: changeSelection,\n    onSortingChange: changeSorting,\n  })\n\n  const resetPage = () =>\n    changePagination({ ...activePagination, pageIndex: 0 })\n  const hasActiveQuery =\n    Boolean(searchValue.trim()) || Object.values(filterValues).some(Boolean)\n  const resolvedStatus =\n    status === undefined || status === \"success\"\n      ? data.length === 0\n        ? \"empty\"\n        : \"success\"\n      : status\n  const rows = table.getRowModel().rows\n  const selectedCount = Object.values(activeSelection).filter(Boolean).length\n  const firstVisible =\n    filteredData.length === 0\n      ? 0\n      : activePagination.pageIndex * activePagination.pageSize + 1\n  const lastVisible = Math.min(\n    filteredData.length,\n    firstVisible + rows.length - 1,\n  )\n\n  const clearQuery = () => {\n    setSearchValue(\"\")\n    setFilterValues({})\n    resetPage()\n  }\n\n  const results =\n    filteredData.length === 0 && data.length > 0 ? (\n      (noResultsState ?? (\n        <div className=\"bg-card flex min-h-52 flex-col items-center justify-center gap-3 rounded-lg border p-8 text-center\">\n          <div>\n            <p className=\"font-semibold\">No matching results</p>\n            <p className=\"text-muted-foreground mt-1 text-sm\">\n              Try changing or clearing the current search and filters.\n            </p>\n          </div>\n          <button\n            className=\"bg-background hover:bg-muted focus-visible:ring-ring min-h-11 rounded-md border px-4 text-sm font-semibold focus-visible:ring-2\"\n            onClick={clearQuery}\n            type=\"button\"\n          >\n            Clear search and filters\n          </button>\n        </div>\n      ))\n    ) : (\n      <>\n        <div className=\"hidden overflow-x-auto rounded-lg border md:block\">\n          <table className=\"w-full min-w-184 border-collapse text-left text-sm\">\n            <thead className=\"bg-muted/50\">\n              {table.getHeaderGroups().map((headerGroup) => (\n                <tr key={headerGroup.id}>\n                  <th className=\"w-12 border-b p-4\" scope=\"col\">\n                    <IndeterminateCheckbox\n                      aria-label=\"Select all rows on this page\"\n                      checked={table.getIsAllPageRowsSelected()}\n                      indeterminate={table.getIsSomePageRowsSelected()}\n                      onChange={table.getToggleAllPageRowsSelectedHandler()}\n                    />\n                  </th>\n                  {headerGroup.headers.map((header) => {\n                    const direction = header.column.getIsSorted()\n                    return (\n                      <th\n                        aria-sort={\n                          direction === \"asc\"\n                            ? \"ascending\"\n                            : direction === \"desc\"\n                              ? \"descending\"\n                              : undefined\n                        }\n                        className=\"border-b p-4 font-semibold\"\n                        key={header.id}\n                        scope=\"col\"\n                      >\n                        {header.isPlaceholder ? null : header.column.getCanSort() ? (\n                          <button\n                            className=\"focus-visible:ring-ring -m-2 inline-flex min-h-11 items-center gap-2 rounded px-2 text-left focus-visible:ring-2\"\n                            onClick={header.column.getToggleSortingHandler()}\n                            type=\"button\"\n                          >\n                            <table.FlexRender header={header} />\n                            <span aria-hidden=\"true\">\n                              {direction === \"asc\"\n                                ? \"↑\"\n                                : direction === \"desc\"\n                                  ? \"↓\"\n                                  : \"↕\"}\n                            </span>\n                          </button>\n                        ) : (\n                          <table.FlexRender header={header} />\n                        )}\n                      </th>\n                    )\n                  })}\n                </tr>\n              ))}\n            </thead>\n            <tbody>\n              {rows.map((row) => (\n                <tr\n                  className=\"hover:bg-muted/30 data-[selected=true]:bg-muted/50\"\n                  data-selected={row.getIsSelected()}\n                  key={row.id}\n                >\n                  <td className=\"border-b p-4\">\n                    <IndeterminateCheckbox\n                      aria-label={`Select row ${row.id}`}\n                      checked={row.getIsSelected()}\n                      disabled={!row.getCanSelect()}\n                      onChange={row.getToggleSelectedHandler()}\n                    />\n                  </td>\n                  {row.getAllCells().map((cell) => (\n                    <td className=\"border-b p-4 align-middle\" key={cell.id}>\n                      <table.FlexRender cell={cell} />\n                    </td>\n                  ))}\n                </tr>\n              ))}\n            </tbody>\n          </table>\n        </div>\n\n        <ul className=\"grid list-none gap-3 p-0 md:hidden\">\n          {rows.map((row) => (\n            <li\n              className=\"bg-card data-[selected=true]:ring-ring relative rounded-lg border p-5 pl-14 data-[selected=true]:ring-2\"\n              data-selected={row.getIsSelected()}\n              key={row.id}\n            >\n              <IndeterminateCheckbox\n                aria-label={`Select row ${row.id}`}\n                checked={row.getIsSelected()}\n                className=\"absolute top-5 left-5\"\n                disabled={!row.getCanSelect()}\n                onChange={row.getToggleSelectedHandler()}\n              />\n              {mobileCard(row.original)}\n            </li>\n          ))}\n        </ul>\n\n        <div className=\"mt-4 flex items-center justify-between gap-4 max-sm:flex-col max-sm:items-stretch\">\n          <p aria-live=\"polite\" className=\"text-muted-foreground m-0 text-sm\">\n            Showing {firstVisible}–{lastVisible} of {filteredData.length}\n          </p>\n          <div className=\"flex items-center gap-2 max-sm:grid max-sm:grid-cols-2\">\n            <button\n              className=\"bg-background hover:bg-muted focus-visible:ring-ring min-h-11 rounded-md border px-4 text-sm font-semibold focus-visible:ring-2 disabled:cursor-not-allowed disabled:opacity-50\"\n              disabled={!table.getCanPreviousPage()}\n              onClick={() => table.previousPage()}\n              type=\"button\"\n            >\n              Previous\n            </button>\n            <span className=\"text-muted-foreground px-2 text-center text-sm max-sm:col-span-2 max-sm:row-start-1\">\n              Page {activePagination.pageIndex + 1} of {table.getPageCount()}\n            </span>\n            <button\n              className=\"bg-background hover:bg-muted focus-visible:ring-ring min-h-11 rounded-md border px-4 text-sm font-semibold focus-visible:ring-2 disabled:cursor-not-allowed disabled:opacity-50\"\n              disabled={!table.getCanNextPage()}\n              onClick={() => table.nextPage()}\n              type=\"button\"\n            >\n              Next\n            </button>\n          </div>\n        </div>\n      </>\n    )\n\n  return (\n    <section className=\"min-w-0\" data-slot=\"responsive-data-explorer\">\n      {(searchConfig || activeFilters.length > 0) && (\n        <div className=\"mb-4 grid gap-3 sm:grid-cols-2 lg:flex\">\n          {searchConfig ? (\n            <label className=\"grid min-w-0 flex-1 gap-2 text-sm font-medium\">\n              {searchConfig.label ?? \"Search\"}\n              <input\n                className=\"bg-background focus-visible:ring-ring min-h-11 w-full rounded-md border px-3 outline-none focus-visible:ring-2\"\n                onChange={(event) => {\n                  setSearchValue(event.target.value)\n                  resetPage()\n                }}\n                placeholder={searchConfig.placeholder ?? \"Search records…\"}\n                type=\"search\"\n                value={searchValue}\n              />\n            </label>\n          ) : null}\n          {activeFilters.map((filter) => (\n            <label\n              className=\"grid min-w-40 gap-2 text-sm font-medium\"\n              key={filter.id}\n            >\n              {filter.label}\n              <select\n                className=\"bg-background focus-visible:ring-ring min-h-11 rounded-md border px-3 outline-none focus-visible:ring-2\"\n                onChange={(event) => {\n                  setFilterValues((current) => ({\n                    ...current,\n                    [filter.id]: event.target.value,\n                  }))\n                  resetPage()\n                }}\n                value={filterValues[filter.id] ?? \"\"}\n              >\n                <option value=\"\">All {filter.label.toLocaleLowerCase()}</option>\n                {filter.options.map((option) => (\n                  <option key={option.value} value={option.value}>\n                    {option.label}\n                  </option>\n                ))}\n              </select>\n            </label>\n          ))}\n        </div>\n      )}\n\n      {selectedCount > 0 ? (\n        <div\n          className=\"mb-4 flex items-center justify-between gap-4 rounded-lg border p-4\"\n          data-slot=\"data-explorer-bulk-actions\"\n        >\n          <p aria-live=\"polite\" className=\"m-0 text-sm font-semibold\">\n            {selectedCount} {selectedCount === 1 ? \"row\" : \"rows\"} selected\n          </p>\n          {bulkActions}\n        </div>\n      ) : null}\n\n      <AsyncState\n        empty={emptyState ?? <DefaultEmptyState />}\n        errorValue={error}\n        onRetry={onRetry}\n        status={resolvedStatus}\n      >\n        {results}\n      </AsyncState>\n\n      {hasActiveQuery ? (\n        <p className=\"sr-only\" aria-live=\"polite\">\n          {filteredData.length} matching records\n        </p>\n      ) : null}\n    </section>\n  )\n}\n",
      "type": "registry:component",
      "target": "components/data-explorer.tsx"
    }
  ],
  "type": "registry:component"
}