periplo-ui 4.13.0 → 4.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,4 +4,4 @@ import * as React from 'react';
4
4
  * A feature-rich data table component built on top of TanStack Table.
5
5
  * Provides sorting, filtering, pagination, and column visibility controls.
6
6
  */
7
- export declare function DataTable<TData extends object>({ columns: userColumns, data, getRowId, columnVisibility: columnVisibilityConfig, isLoading, pagination, grouping, primaryFilters, secondaryFilters, activePrimaryFiltersCount, activeSecondaryFiltersCount, selection, labels, emptyState, className, tableClassName, }: DataTableProps<TData>): React.JSX.Element;
7
+ export declare function DataTable<TData extends object>({ columns: userColumns, data, getRowId, columnVisibility: columnVisibilityConfig, isLoading, pagination, grouping, primaryFilters, secondaryFilters, activePrimaryFiltersCount, activeSecondaryFiltersCount, selection, labels, emptyState, className, tableClassName, sorting, }: DataTableProps<TData>): React.JSX.Element;
@@ -1,19 +1,27 @@
1
1
  "use client";
2
2
  "use client";
3
3
  import { cn } from "../../../lib/utils.js";
4
+ import { TooltipProvider } from "../Tooltip/Tooltip.js";
4
5
  import { Table, TableHead, TableHeader, TableRow } from "../Table/Table.js";
5
6
  import { getDataTableCellClassName } from "./components/dataTableCellStyles.js";
6
7
  import { DataTableBody } from "./components/DataTableBody.js";
8
+ import { DataTableColumnHeader } from "./components/DataTableColumnHeader.js";
7
9
  import { DataTablePagination } from "./components/DataTablePagination.js";
8
10
  import { DataTableToolbar } from "./components/DataTableToolbar.js";
9
11
  import { useGroupExpansion } from "./hooks/useGroupExpansion.js";
10
12
  import { useSelectColumn } from "./hooks/useSelectColumn.js";
11
13
  import { useSelection } from "./hooks/useSelection.js";
14
+ import { useSorting } from "./hooks/useSorting.js";
12
15
  import { flattenLeaves } from "./utils.js";
13
16
  import * as React$1 from "react";
14
17
  import { jsx, jsxs } from "react/jsx-runtime";
15
- import { flexRender, getCoreRowModel, getExpandedRowModel, getPaginationRowModel, useReactTable } from "@tanstack/react-table";
18
+ import { flexRender, getCoreRowModel, getExpandedRowModel, getPaginationRowModel, getSortedRowModel, useReactTable } from "@tanstack/react-table";
16
19
  //#region src/components/data-display/DataTable/DataTable.tsx
20
+ var ARIA_SORT = {
21
+ asc: "ascending",
22
+ desc: "descending",
23
+ none: "none"
24
+ };
17
25
  /**
18
26
  * A feature-rich data table component built on top of TanStack Table.
19
27
  * Provides sorting, filtering, pagination, and column visibility controls.
@@ -24,7 +32,7 @@ function DataTable({ columns: userColumns, data, getRowId = (row) => row.id, col
24
32
  }, emptyState = {
25
33
  title: "No data available",
26
34
  description: "Try adjusting your filters or search criteria"
27
- }, className, tableClassName }) {
35
+ }, className, tableClassName, sorting }) {
28
36
  const [internalColumnVisibility, setInternalColumnVisibility] = React$1.useState({});
29
37
  const [pageIndex, setPageIndex] = React$1.useState(0);
30
38
  const columnVisibilityState = columnVisibilityConfig?.state ?? internalColumnVisibility;
@@ -95,6 +103,7 @@ function DataTable({ columns: userColumns, data, getRowId = (row) => row.id, col
95
103
  setPageIndex(newState.pageIndex);
96
104
  }
97
105
  }, [pageIndex, pageSize]);
106
+ const { orderBy, order, sortingState, isBackendSorting, toggleSort } = useSorting(sorting);
98
107
  const groupConfig = React$1.useMemo(() => {
99
108
  if (!grouping) return void 0;
100
109
  return {
@@ -116,6 +125,7 @@ function DataTable({ columns: userColumns, data, getRowId = (row) => row.id, col
116
125
  columns: tableColumns,
117
126
  getCoreRowModel: getCoreRowModel(),
118
127
  getPaginationRowModel: tableGetPaginationRowModel,
128
+ getSortedRowModel: getSortedRowModel(),
119
129
  getSubRows: grouping?.getSubRows,
120
130
  getExpandedRowModel: grouping ? getExpandedRowModel() : void 0,
121
131
  onColumnVisibilityChange: setColumnVisibilityState,
@@ -125,10 +135,12 @@ function DataTable({ columns: userColumns, data, getRowId = (row) => row.id, col
125
135
  columnVisibility: columnVisibilityState,
126
136
  rowSelection,
127
137
  pagination: tablePaginationState,
128
- expanded: grouping ? true : void 0
138
+ expanded: grouping ? true : void 0,
139
+ sorting: sortingState
129
140
  },
130
141
  manualPagination: isBackendPagination,
131
- onPaginationChange: isBackendPagination ? void 0 : tableOnPaginationChange
142
+ onPaginationChange: isBackendPagination ? void 0 : tableOnPaginationChange,
143
+ manualSorting: isBackendSorting
132
144
  });
133
145
  const isEmptyState = !isLoading && table.getRowModel().rows.length === 0;
134
146
  return /* @__PURE__ */ jsxs("div", {
@@ -151,17 +163,32 @@ function DataTable({ columns: userColumns, data, getRowId = (row) => row.id, col
151
163
  tableClassName: cn("min-w-max", tableClassName),
152
164
  children: [/* @__PURE__ */ jsx(TableHeader, {
153
165
  className: "sticky top-0 z-10 bg-neutral-50",
154
- children: table.getHeaderGroups().map((headerGroup) => /* @__PURE__ */ jsx(TableRow, { children: headerGroup.headers.map((header) => /* @__PURE__ */ jsx(TableHead, {
155
- style: { width: header.column.columnDef.size },
156
- className: "h-auto p-0 text-neutral-900",
157
- children: /* @__PURE__ */ jsx("div", {
158
- className: getDataTableCellClassName({
159
- columnId: header.column.id,
160
- kind: "header"
161
- }),
162
- children: header.isPlaceholder ? null : flexRender(header.column.columnDef.header, header.getContext())
163
- })
164
- }, header.id)) }, headerGroup.id))
166
+ children: /* @__PURE__ */ jsx(TooltipProvider, {
167
+ delayDuration: 300,
168
+ children: table.getHeaderGroups().map((headerGroup) => /* @__PURE__ */ jsx(TableRow, { children: headerGroup.headers.map((header) => {
169
+ const columnId = header.column.id;
170
+ const sortLabels = header.isPlaceholder ? void 0 : sorting?.sortableColumns[columnId];
171
+ const activeOrder = orderBy === columnId ? order : void 0;
172
+ const content = header.isPlaceholder ? null : flexRender(header.column.columnDef.header, header.getContext());
173
+ return /* @__PURE__ */ jsx(TableHead, {
174
+ style: { width: header.column.columnDef.size },
175
+ className: "h-auto p-0 text-neutral-900",
176
+ "aria-sort": sortLabels ? ARIA_SORT[activeOrder ?? "none"] : void 0,
177
+ children: /* @__PURE__ */ jsx("div", {
178
+ className: getDataTableCellClassName({
179
+ columnId,
180
+ kind: "header"
181
+ }),
182
+ children: sortLabels ? /* @__PURE__ */ jsx(DataTableColumnHeader, {
183
+ order: activeOrder,
184
+ labels: sortLabels,
185
+ onSort: () => toggleSort(columnId),
186
+ children: content
187
+ }) : content
188
+ })
189
+ }, header.id);
190
+ }) }, headerGroup.id))
191
+ })
165
192
  }), /* @__PURE__ */ jsx(DataTableBody, {
166
193
  table,
167
194
  isLoading,
@@ -1 +1 @@
1
- {"version":3,"file":"DataTable.js","names":["React","TableComponent"],"sources":["../../../../src/components/data-display/DataTable/DataTable.tsx"],"sourcesContent":["'use client'\n\nimport {\n flexRender,\n getCoreRowModel,\n getExpandedRowModel,\n getPaginationRowModel,\n useReactTable,\n VisibilityState,\n PaginationState,\n Updater,\n} from '@tanstack/react-table'\nimport * as React from 'react'\n\nimport { Table as TableComponent, TableHeader, TableHead, TableRow } from '../Table'\n\nimport { DataTableBody } from './components/DataTableBody'\nimport { getDataTableCellClassName } from './components/dataTableCellStyles'\nimport { DataTablePagination } from './components/DataTablePagination'\nimport { DataTableToolbar } from './components/DataTableToolbar'\nimport { useGroupExpansion } from './hooks/useGroupExpansion'\nimport { useSelectColumn } from './hooks/useSelectColumn'\nimport { useSelection } from './hooks/useSelection'\nimport { DataTableProps } from './types'\nimport { flattenLeaves } from './utils'\n\nimport { cn } from '@/lib/utils'\n\n/**\n * A feature-rich data table component built on top of TanStack Table.\n * Provides sorting, filtering, pagination, and column visibility controls.\n */\nexport function DataTable<TData extends object>({\n columns: userColumns,\n data,\n getRowId = (row: TData) => (row as { id: string }).id,\n columnVisibility: columnVisibilityConfig,\n isLoading = false,\n pagination,\n grouping,\n primaryFilters,\n secondaryFilters,\n activePrimaryFiltersCount = 0,\n activeSecondaryFiltersCount = 0,\n selection,\n labels = {\n filters: 'Filters',\n moreFilters: 'More filters',\n },\n emptyState = {\n title: 'No data available',\n description: 'Try adjusting your filters or search criteria',\n },\n className,\n tableClassName,\n}: DataTableProps<TData>) {\n const [internalColumnVisibility, setInternalColumnVisibility] = React.useState<VisibilityState>({})\n const [pageIndex, setPageIndex] = React.useState(0)\n\n const columnVisibilityState = columnVisibilityConfig?.state ?? internalColumnVisibility\n const setColumnVisibilityState = columnVisibilityConfig?.onChange ?? setInternalColumnVisibility\n\n const { isGroupOpen, toggleGroup } = useGroupExpansion({ grouping, data, getRowId })\n\n const selectionData = React.useMemo(\n () => (grouping ? flattenLeaves(data, grouping.getSubRows) : data),\n [grouping, data],\n )\n\n const isBackendPagination = pagination !== undefined && 'onPageChange' in pagination\n\n const total = isBackendPagination ? pagination.total : data.length\n const pageSize = pagination?.pageSize ?? (isLoading ? 10 : data.length)\n const totalPages = Math.ceil(total / pageSize)\n\n const { selectedIds, handleRowSelect, handleSelectAll } = useSelection({\n data: selectionData,\n getRowId,\n selection,\n })\n\n const rowSelection = React.useMemo(\n () => Object.fromEntries(Array.from(selectedIds).map((id) => [id, true])),\n [selectedIds],\n )\n\n const selectColumn = useSelectColumn({\n selection,\n selectedIds,\n selectionData,\n getRowId,\n handleRowSelect,\n handleSelectAll,\n isBackendPagination,\n isLoading,\n })\n\n const tableColumns = React.useMemo(() => {\n if (!selectColumn) return userColumns\n return [selectColumn.column, ...userColumns]\n }, [userColumns, selectColumn])\n\n const toolbarSelectionProps = React.useMemo(() => {\n if (isBackendPagination && selection) {\n return {\n isSelectionStarted: selection.isSelectionStarted,\n onSelectionStart: selection.onSelectionStart,\n onSelectionCancel: selection.onSelectionCancel,\n selectionSummary: selection.labels?.selectionSummary,\n isSelectionDisabled: selection.isSelectionDisabled,\n labels: selection.labels,\n }\n }\n return undefined\n }, [isBackendPagination, selection])\n\n const currentPage = isBackendPagination ? pagination.currentPage : pageIndex + 1\n const handlePageChange = isBackendPagination ? pagination.onPageChange : (page: number) => setPageIndex(page - 1)\n\n const tablePaginationState = React.useMemo(() => {\n if (!pagination) {\n return undefined\n }\n return {\n pageIndex: isBackendPagination ? pagination.currentPage - 1 : pageIndex,\n pageSize,\n }\n }, [pagination, isBackendPagination, pageIndex, pageSize])\n\n const tableGetPaginationRowModel = React.useMemo(() => {\n return pagination && !isBackendPagination ? getPaginationRowModel() : undefined\n }, [pagination, isBackendPagination])\n\n const tableOnPaginationChange = React.useCallback(\n (updater: Updater<PaginationState>) => {\n if (typeof updater === 'function') {\n const newState = updater({ pageIndex, pageSize })\n setPageIndex(newState.pageIndex)\n }\n },\n [pageIndex, pageSize],\n )\n\n const groupConfig = React.useMemo(() => {\n if (!grouping) return undefined\n\n return {\n renderGroupRow: grouping.renderGroupRow,\n renderGroupSelector: selectColumn?.GroupSelectCell,\n isGroupOpen,\n toggleGroup,\n getRowId,\n }\n }, [grouping, selectColumn, isGroupOpen, toggleGroup, getRowId])\n\n const table = useReactTable({\n data,\n columns: tableColumns,\n getCoreRowModel: getCoreRowModel(),\n getPaginationRowModel: tableGetPaginationRowModel,\n getSubRows: grouping?.getSubRows,\n getExpandedRowModel: grouping ? getExpandedRowModel() : undefined,\n onColumnVisibilityChange: setColumnVisibilityState,\n enableRowSelection: !!selection,\n getRowId,\n state: {\n columnVisibility: columnVisibilityState,\n rowSelection,\n pagination: tablePaginationState,\n expanded: grouping ? true : undefined,\n },\n manualPagination: isBackendPagination,\n onPaginationChange: isBackendPagination ? undefined : tableOnPaginationChange,\n })\n\n const isEmptyState = !isLoading && table.getRowModel().rows.length === 0\n\n return (\n <div className={cn('flex h-full min-h-0 w-full flex-1 flex-col gap-2 overflow-hidden', className)}>\n <DataTableToolbar\n table={table}\n columnVisibility={columnVisibilityConfig}\n primaryFilters={primaryFilters}\n secondaryFilters={secondaryFilters}\n activePrimaryFiltersCount={activePrimaryFiltersCount}\n activeSecondaryFiltersCount={activeSecondaryFiltersCount}\n labels={labels}\n selection={toolbarSelectionProps}\n />\n\n <div className=\"flex min-h-0 flex-1 flex-col rounded-md border bg-white\">\n <div className=\"min-h-0 flex-1 overflow-auto overscroll-x-none overscroll-y-auto\">\n <TableComponent\n className={cn('w-full', isEmptyState && 'h-full')}\n tableClassName={cn('min-w-max', tableClassName)}\n >\n <TableHeader className=\"sticky top-0 z-10 bg-neutral-50\">\n {table.getHeaderGroups().map((headerGroup) => (\n <TableRow key={headerGroup.id}>\n {headerGroup.headers.map((header) => (\n <TableHead\n key={header.id}\n style={{ width: header.column.columnDef.size }}\n className=\"h-auto p-0 text-neutral-900\"\n >\n <div className={getDataTableCellClassName({ columnId: header.column.id, kind: 'header' })}>\n {header.isPlaceholder ? null : flexRender(header.column.columnDef.header, header.getContext())}\n </div>\n </TableHead>\n ))}\n </TableRow>\n ))}\n </TableHeader>\n <DataTableBody\n table={table}\n isLoading={isLoading}\n pageSize={pageSize}\n getRowId={getRowId}\n rowSelection={rowSelection}\n emptyState={emptyState}\n group={groupConfig}\n />\n </TableComponent>\n </div>\n {!!pagination && (\n <div className=\"border-t px-4 py-2\">\n <DataTablePagination\n table={table}\n total={total}\n pageSize={pageSize}\n currentPage={currentPage}\n totalPages={totalPages}\n onPageChange={handlePageChange}\n isLoading={pagination.isLoading}\n labels={pagination.labels}\n />\n </div>\n )}\n </div>\n </div>\n )\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"DataTable.js","names":["React","TableComponent"],"sources":["../../../../src/components/data-display/DataTable/DataTable.tsx"],"sourcesContent":["'use client'\n\nimport {\n flexRender,\n getCoreRowModel,\n getExpandedRowModel,\n getPaginationRowModel,\n getSortedRowModel,\n useReactTable,\n VisibilityState,\n PaginationState,\n Updater,\n} from '@tanstack/react-table'\nimport * as React from 'react'\n\nimport { Table as TableComponent, TableHeader, TableHead, TableRow } from '../Table'\nimport { TooltipProvider } from '../Tooltip'\n\nimport { DataTableBody } from './components/DataTableBody'\nimport { getDataTableCellClassName } from './components/dataTableCellStyles'\nimport { DataTableColumnHeader } from './components/DataTableColumnHeader'\nimport { DataTablePagination } from './components/DataTablePagination'\nimport { DataTableToolbar } from './components/DataTableToolbar'\nimport { useGroupExpansion } from './hooks/useGroupExpansion'\nimport { useSelectColumn } from './hooks/useSelectColumn'\nimport { useSelection } from './hooks/useSelection'\nimport { useSorting } from './hooks/useSorting'\nimport { DataTableProps } from './types'\nimport { flattenLeaves } from './utils'\n\nimport { cn } from '@/lib/utils'\n\nconst ARIA_SORT = { asc: 'ascending', desc: 'descending', none: 'none' } as const\n\n/**\n * A feature-rich data table component built on top of TanStack Table.\n * Provides sorting, filtering, pagination, and column visibility controls.\n */\nexport function DataTable<TData extends object>({\n columns: userColumns,\n data,\n getRowId = (row: TData) => (row as { id: string }).id,\n columnVisibility: columnVisibilityConfig,\n isLoading = false,\n pagination,\n grouping,\n primaryFilters,\n secondaryFilters,\n activePrimaryFiltersCount = 0,\n activeSecondaryFiltersCount = 0,\n selection,\n labels = {\n filters: 'Filters',\n moreFilters: 'More filters',\n },\n emptyState = {\n title: 'No data available',\n description: 'Try adjusting your filters or search criteria',\n },\n className,\n tableClassName,\n sorting,\n}: DataTableProps<TData>) {\n const [internalColumnVisibility, setInternalColumnVisibility] = React.useState<VisibilityState>({})\n const [pageIndex, setPageIndex] = React.useState(0)\n\n const columnVisibilityState = columnVisibilityConfig?.state ?? internalColumnVisibility\n const setColumnVisibilityState = columnVisibilityConfig?.onChange ?? setInternalColumnVisibility\n\n const { isGroupOpen, toggleGroup } = useGroupExpansion({ grouping, data, getRowId })\n\n const selectionData = React.useMemo(\n () => (grouping ? flattenLeaves(data, grouping.getSubRows) : data),\n [grouping, data],\n )\n\n const isBackendPagination = pagination !== undefined && 'onPageChange' in pagination\n\n const total = isBackendPagination ? pagination.total : data.length\n const pageSize = pagination?.pageSize ?? (isLoading ? 10 : data.length)\n const totalPages = Math.ceil(total / pageSize)\n\n const { selectedIds, handleRowSelect, handleSelectAll } = useSelection({\n data: selectionData,\n getRowId,\n selection,\n })\n\n const rowSelection = React.useMemo(\n () => Object.fromEntries(Array.from(selectedIds).map((id) => [id, true])),\n [selectedIds],\n )\n\n const selectColumn = useSelectColumn({\n selection,\n selectedIds,\n selectionData,\n getRowId,\n handleRowSelect,\n handleSelectAll,\n isBackendPagination,\n isLoading,\n })\n\n const tableColumns = React.useMemo(() => {\n if (!selectColumn) return userColumns\n return [selectColumn.column, ...userColumns]\n }, [userColumns, selectColumn])\n\n const toolbarSelectionProps = React.useMemo(() => {\n if (isBackendPagination && selection) {\n return {\n isSelectionStarted: selection.isSelectionStarted,\n onSelectionStart: selection.onSelectionStart,\n onSelectionCancel: selection.onSelectionCancel,\n selectionSummary: selection.labels?.selectionSummary,\n isSelectionDisabled: selection.isSelectionDisabled,\n labels: selection.labels,\n }\n }\n return undefined\n }, [isBackendPagination, selection])\n\n const currentPage = isBackendPagination ? pagination.currentPage : pageIndex + 1\n const handlePageChange = isBackendPagination ? pagination.onPageChange : (page: number) => setPageIndex(page - 1)\n\n const tablePaginationState = React.useMemo(() => {\n if (!pagination) {\n return undefined\n }\n return {\n pageIndex: isBackendPagination ? pagination.currentPage - 1 : pageIndex,\n pageSize,\n }\n }, [pagination, isBackendPagination, pageIndex, pageSize])\n\n const tableGetPaginationRowModel = React.useMemo(() => {\n return pagination && !isBackendPagination ? getPaginationRowModel() : undefined\n }, [pagination, isBackendPagination])\n\n const tableOnPaginationChange = React.useCallback(\n (updater: Updater<PaginationState>) => {\n if (typeof updater === 'function') {\n const newState = updater({ pageIndex, pageSize })\n setPageIndex(newState.pageIndex)\n }\n },\n [pageIndex, pageSize],\n )\n\n const { orderBy, order, sortingState, isBackendSorting, toggleSort } = useSorting(sorting)\n\n const groupConfig = React.useMemo(() => {\n if (!grouping) return undefined\n\n return {\n renderGroupRow: grouping.renderGroupRow,\n renderGroupSelector: selectColumn?.GroupSelectCell,\n isGroupOpen,\n toggleGroup,\n getRowId,\n }\n }, [grouping, selectColumn, isGroupOpen, toggleGroup, getRowId])\n\n const table = useReactTable({\n data,\n columns: tableColumns,\n getCoreRowModel: getCoreRowModel(),\n getPaginationRowModel: tableGetPaginationRowModel,\n getSortedRowModel: getSortedRowModel(),\n getSubRows: grouping?.getSubRows,\n getExpandedRowModel: grouping ? getExpandedRowModel() : undefined,\n onColumnVisibilityChange: setColumnVisibilityState,\n enableRowSelection: !!selection,\n getRowId,\n state: {\n columnVisibility: columnVisibilityState,\n rowSelection,\n pagination: tablePaginationState,\n expanded: grouping ? true : undefined,\n sorting: sortingState,\n },\n manualPagination: isBackendPagination,\n onPaginationChange: isBackendPagination ? undefined : tableOnPaginationChange,\n manualSorting: isBackendSorting,\n })\n\n const isEmptyState = !isLoading && table.getRowModel().rows.length === 0\n\n return (\n <div className={cn('flex h-full min-h-0 w-full flex-1 flex-col gap-2 overflow-hidden', className)}>\n <DataTableToolbar\n table={table}\n columnVisibility={columnVisibilityConfig}\n primaryFilters={primaryFilters}\n secondaryFilters={secondaryFilters}\n activePrimaryFiltersCount={activePrimaryFiltersCount}\n activeSecondaryFiltersCount={activeSecondaryFiltersCount}\n labels={labels}\n selection={toolbarSelectionProps}\n />\n\n <div className=\"flex min-h-0 flex-1 flex-col rounded-md border bg-white\">\n <div className=\"min-h-0 flex-1 overflow-auto overscroll-x-none overscroll-y-auto\">\n <TableComponent\n className={cn('w-full', isEmptyState && 'h-full')}\n tableClassName={cn('min-w-max', tableClassName)}\n >\n <TableHeader className=\"sticky top-0 z-10 bg-neutral-50\">\n <TooltipProvider delayDuration={300}>\n {table.getHeaderGroups().map((headerGroup) => (\n <TableRow key={headerGroup.id}>\n {headerGroup.headers.map((header) => {\n const columnId = header.column.id\n const sortLabels = header.isPlaceholder ? undefined : sorting?.sortableColumns[columnId]\n const activeOrder = orderBy === columnId ? order : undefined\n const content = header.isPlaceholder\n ? null\n : flexRender(header.column.columnDef.header, header.getContext())\n\n return (\n <TableHead\n key={header.id}\n style={{ width: header.column.columnDef.size }}\n className=\"h-auto p-0 text-neutral-900\"\n aria-sort={sortLabels ? ARIA_SORT[activeOrder ?? 'none'] : undefined}\n >\n <div className={getDataTableCellClassName({ columnId, kind: 'header' })}>\n {sortLabels ? (\n <DataTableColumnHeader\n order={activeOrder}\n labels={sortLabels}\n onSort={() => toggleSort(columnId)}\n >\n {content}\n </DataTableColumnHeader>\n ) : (\n content\n )}\n </div>\n </TableHead>\n )\n })}\n </TableRow>\n ))}\n </TooltipProvider>\n </TableHeader>\n <DataTableBody\n table={table}\n isLoading={isLoading}\n pageSize={pageSize}\n getRowId={getRowId}\n rowSelection={rowSelection}\n emptyState={emptyState}\n group={groupConfig}\n />\n </TableComponent>\n </div>\n {!!pagination && (\n <div className=\"border-t px-4 py-2\">\n <DataTablePagination\n table={table}\n total={total}\n pageSize={pageSize}\n currentPage={currentPage}\n totalPages={totalPages}\n onPageChange={handlePageChange}\n isLoading={pagination.isLoading}\n labels={pagination.labels}\n />\n </div>\n )}\n </div>\n </div>\n )\n}\n"],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { SortOrder } from '../types';
2
+ import * as React from 'react';
3
+ type DataTableColumnHeaderProps = {
4
+ readonly order?: SortOrder;
5
+ readonly labels: Readonly<Record<SortOrder, string>>;
6
+ readonly onSort: () => void;
7
+ readonly children: React.ReactNode;
8
+ };
9
+ export declare function DataTableColumnHeader({ order, labels, onSort, children }: DataTableColumnHeaderProps): React.JSX.Element;
10
+ export {};
@@ -0,0 +1,42 @@
1
+ import { cn } from "../../../../lib/utils.js";
2
+ import { TooltipContent, TooltipRoot, TooltipTrigger } from "../../Tooltip/Tooltip.js";
3
+ import * as React$1 from "react";
4
+ import { jsx, jsxs } from "react/jsx-runtime";
5
+ import { CaretDownIcon } from "@phosphor-icons/react/dist/ssr/CaretDown";
6
+ import { CaretUpDownIcon } from "@phosphor-icons/react/dist/ssr/CaretUpDown";
7
+ import { CaretUpIcon } from "@phosphor-icons/react/dist/ssr/CaretUp";
8
+ //#region src/components/data-display/DataTable/components/DataTableColumnHeader.tsx
9
+ var ORDER_ICONS = {
10
+ asc: CaretUpIcon,
11
+ desc: CaretDownIcon
12
+ };
13
+ var keepOpen = (event) => event.preventDefault();
14
+ function DataTableColumnHeader({ order, labels, onSort, children }) {
15
+ const Icon = order ? ORDER_ICONS[order] : CaretUpDownIcon;
16
+ const [isOpen, setIsOpen] = React$1.useState(false);
17
+ return /* @__PURE__ */ jsxs(TooltipRoot, {
18
+ open: isOpen && !!order,
19
+ onOpenChange: setIsOpen,
20
+ children: [/* @__PURE__ */ jsx(TooltipTrigger, {
21
+ asChild: true,
22
+ onClick: keepOpen,
23
+ onPointerDown: keepOpen,
24
+ children: /* @__PURE__ */ jsxs("button", {
25
+ type: "button",
26
+ onClick: onSort,
27
+ className: "group focus-visible:ring-ring inline-flex cursor-pointer items-center gap-1 rounded-sm focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:outline-hidden",
28
+ children: [children, /* @__PURE__ */ jsx(Icon, {
29
+ "aria-hidden": true,
30
+ className: cn("h-4 w-4 shrink-0 transition-colors", order ? "text-neutral-900" : "text-neutral-500 group-hover:text-neutral-900")
31
+ })]
32
+ })
33
+ }), /* @__PURE__ */ jsx(TooltipContent, {
34
+ onPointerDownOutside: keepOpen,
35
+ children: order && labels[order]
36
+ })]
37
+ });
38
+ }
39
+ //#endregion
40
+ export { DataTableColumnHeader };
41
+
42
+ //# sourceMappingURL=DataTableColumnHeader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DataTableColumnHeader.js","names":["React"],"sources":["../../../../../src/components/data-display/DataTable/components/DataTableColumnHeader.tsx"],"sourcesContent":["import { CaretDownIcon } from '@phosphor-icons/react/dist/ssr/CaretDown'\nimport { CaretUpIcon } from '@phosphor-icons/react/dist/ssr/CaretUp'\nimport { CaretUpDownIcon } from '@phosphor-icons/react/dist/ssr/CaretUpDown'\nimport * as React from 'react'\n\nimport { SortOrder } from '../types'\n\nimport { TooltipContent, TooltipRoot, TooltipTrigger } from '@/components/data-display/Tooltip'\nimport { cn } from '@/lib/utils'\n\nconst ORDER_ICONS = { asc: CaretUpIcon, desc: CaretDownIcon }\n\nconst keepOpen = (event: { preventDefault: () => void }) => event.preventDefault()\n\ntype DataTableColumnHeaderProps = {\n readonly order?: SortOrder\n readonly labels: Readonly<Record<SortOrder, string>>\n readonly onSort: () => void\n readonly children: React.ReactNode\n}\n\nexport function DataTableColumnHeader({ order, labels, onSort, children }: DataTableColumnHeaderProps) {\n const Icon = order ? ORDER_ICONS[order] : CaretUpDownIcon\n const [isOpen, setIsOpen] = React.useState(false)\n\n return (\n <TooltipRoot open={isOpen && !!order} onOpenChange={setIsOpen}>\n <TooltipTrigger asChild onClick={keepOpen} onPointerDown={keepOpen}>\n <button\n type=\"button\"\n onClick={onSort}\n className=\"group focus-visible:ring-ring inline-flex cursor-pointer items-center gap-1 rounded-sm focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:outline-hidden\"\n >\n {children}\n <Icon\n aria-hidden\n className={cn(\n 'h-4 w-4 shrink-0 transition-colors',\n order ? 'text-neutral-900' : 'text-neutral-500 group-hover:text-neutral-900',\n )}\n />\n </button>\n </TooltipTrigger>\n <TooltipContent onPointerDownOutside={keepOpen}>{order && labels[order]}</TooltipContent>\n </TooltipRoot>\n )\n}\n"],"mappings":";;;;;;;;AAUA,IAAM,cAAc;CAAE,KAAK;CAAa,MAAM;AAAc;AAE5D,IAAM,YAAY,UAA0C,MAAM,eAAe;AASjF,SAAgB,sBAAsB,EAAE,OAAO,QAAQ,QAAQ,YAAwC;CACrG,MAAM,OAAO,QAAQ,YAAY,SAAS;CAC1C,MAAM,CAAC,QAAQ,aAAaA,QAAM,SAAS,KAAK;CAEhD,OACE,qBAAC,aAAD;EAAa,MAAM,UAAU,CAAC,CAAC;EAAO,cAAc;EAApD,UAAA,CACE,oBAAC,gBAAD;GAAgB,SAAA;GAAQ,SAAS;GAAU,eAAe;GACxD,UAAA,qBAAC,UAAD;IACE,MAAK;IACL,SAAS;IACT,WAAU;IAHZ,UAAA,CAKG,UACD,oBAAC,MAAD;KACE,eAAA;KACA,WAAW,GACT,sCACA,QAAQ,qBAAqB,+CAC/B;IACD,CAAA,CACK;;EACM,CAAA,GAChB,oBAAC,gBAAD;GAAgB,sBAAsB;GAAW,UAAA,SAAS,OAAO;EAAuB,CAAA,CAC7E;;AAEjB"}
@@ -0,0 +1,9 @@
1
+ import { SortingState } from '@tanstack/react-table';
2
+ import { BackendSortingProps, BaseSortingProps, SortOrder } from '../types';
3
+ export declare function useSorting(sorting: BaseSortingProps | BackendSortingProps | undefined): {
4
+ orderBy: string | undefined;
5
+ order: SortOrder;
6
+ sortingState: SortingState;
7
+ isBackendSorting: boolean;
8
+ toggleSort: (columnId: string) => void;
9
+ };
@@ -0,0 +1,30 @@
1
+ import * as React$1 from "react";
2
+ //#region src/components/data-display/DataTable/hooks/useSorting.ts
3
+ function useSorting(sorting) {
4
+ const isBackendSorting = sorting !== void 0 && "onSortChange" in sorting;
5
+ const [clientSort, setClientSort] = React$1.useState(sorting ?? {});
6
+ const { orderBy, order = "desc" } = isBackendSorting ? sorting : clientSort;
7
+ const sortingState = React$1.useMemo(() => orderBy ? [{
8
+ id: orderBy,
9
+ desc: order === "desc"
10
+ }] : [], [orderBy, order]);
11
+ const toggleSort = (columnId) => {
12
+ const nextOrder = orderBy === columnId && order === "desc" ? "asc" : "desc";
13
+ if (isBackendSorting) sorting.onSortChange(columnId, nextOrder);
14
+ else setClientSort({
15
+ orderBy: columnId,
16
+ order: nextOrder
17
+ });
18
+ };
19
+ return {
20
+ orderBy,
21
+ order,
22
+ sortingState,
23
+ isBackendSorting,
24
+ toggleSort
25
+ };
26
+ }
27
+ //#endregion
28
+ export { useSorting };
29
+
30
+ //# sourceMappingURL=useSorting.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useSorting.js","names":["React"],"sources":["../../../../../src/components/data-display/DataTable/hooks/useSorting.ts"],"sourcesContent":["import { SortingState } from '@tanstack/react-table'\nimport * as React from 'react'\n\nimport { BackendSortingProps, BaseSortingProps, SortOrder } from '../types'\n\nexport function useSorting(sorting: BaseSortingProps | BackendSortingProps | undefined) {\n const isBackendSorting = sorting !== undefined && 'onSortChange' in sorting\n const [clientSort, setClientSort] = React.useState<{ orderBy?: string; order?: SortOrder }>(sorting ?? {})\n const { orderBy, order = 'desc' } = isBackendSorting ? sorting : clientSort\n\n const sortingState = React.useMemo<SortingState>(\n () => (orderBy ? [{ id: orderBy, desc: order === 'desc' }] : []),\n [orderBy, order],\n )\n\n const toggleSort = (columnId: string) => {\n const nextOrder = orderBy === columnId && order === 'desc' ? 'asc' : 'desc'\n\n if (isBackendSorting) {\n sorting.onSortChange(columnId, nextOrder)\n } else {\n setClientSort({ orderBy: columnId, order: nextOrder })\n }\n }\n\n return { orderBy, order, sortingState, isBackendSorting, toggleSort }\n}\n"],"mappings":";;AAKA,SAAgB,WAAW,SAA6D;CACtF,MAAM,mBAAmB,YAAY,KAAA,KAAa,kBAAkB;CACpE,MAAM,CAAC,YAAY,iBAAiBA,QAAM,SAAkD,WAAW,CAAC,CAAC;CACzG,MAAM,EAAE,SAAS,QAAQ,WAAW,mBAAmB,UAAU;CAEjE,MAAM,eAAeA,QAAM,cAClB,UAAU,CAAC;EAAE,IAAI;EAAS,MAAM,UAAU;CAAO,CAAC,IAAI,CAAC,GAC9D,CAAC,SAAS,KAAK,CACjB;CAEA,MAAM,cAAc,aAAqB;EACvC,MAAM,YAAY,YAAY,YAAY,UAAU,SAAS,QAAQ;EAErE,IAAI,kBACF,QAAQ,aAAa,UAAU,SAAS;OAExC,cAAc;GAAE,SAAS;GAAU,OAAO;EAAU,CAAC;CAEzD;CAEA,OAAO;EAAE;EAAS;EAAO;EAAc;EAAkB;CAAW;AACtE"}
@@ -107,6 +107,19 @@ export type BackendPaginationProps = {
107
107
  /** Callback when page changes */
108
108
  readonly onPageChange: (page: number) => void;
109
109
  } & BasePaginationProps;
110
+ export type SortOrder = 'asc' | 'desc';
111
+ export type BaseSortingProps = {
112
+ /** Id of the sorted column. Initial value in client mode. There is no unsorted state. */
113
+ readonly orderBy: string;
114
+ /** Sort direction (default: "desc"). Initial value in client mode. */
115
+ readonly order?: SortOrder;
116
+ /** Sortable column ids, each with the tooltip text shown for every order (e.g. "Newest first" / "Oldest first") */
117
+ readonly sortableColumns: Readonly<Record<string, Readonly<Record<SortOrder, string>>>>;
118
+ };
119
+ export type BackendSortingProps = {
120
+ /** Callback when the sort changes. Rows are not sorted client-side and the consumer resets its page. */
121
+ readonly onSortChange: (orderBy: string, order: SortOrder) => void;
122
+ } & BaseSortingProps;
110
123
  export type EmptyStateConfig = {
111
124
  /** Title for the empty state */
112
125
  title: string;
@@ -165,6 +178,8 @@ type DataTableBaseProps<TData> = {
165
178
  readonly className?: string;
166
179
  /** Optional className for the table */
167
180
  readonly tableClassName?: string;
181
+ /** Column sorting configuration */
182
+ readonly sorting?: BaseSortingProps | BackendSortingProps;
168
183
  };
169
184
  type IdProps<TData> = HasId<TData> extends true ? {
170
185
  /** Function to get unique identifier from a row. Not needed when data has 'id' property */
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "periplo-ui",
3
3
  "description": "IATI UI library",
4
4
  "private": false,
5
- "version": "4.13.0",
5
+ "version": "4.14.0",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",
8
8
  "types": "dist/index.d.ts",