@cube-dev/ui-kit 0.155.0 → 0.157.0

package/dist/components/data/DataTable/DataTable.js

@@ -0,0 +1,246 @@
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
+import { extractStyles } from "../../../utils/styles.js";
+import { useCombinedRefs } from "../../../utils/react/useCombinedRefs.js";
+import { useEvent } from "../../../_internal/hooks/use-event.js";
+import { useI18n } from "../../../i18n/useI18n.js";
+import { clampPage, getPageInfo } from "../../navigation/Pagination/use-pagination.js";
+import { ItemTableFooter } from "../ItemTable/ItemTableFooter.js";
+import { selectionRowKey } from "../TableBase/types.js";
+import { useCellSelection } from "../TableBase/use-cell-selection.js";
+import { useTableColumns } from "../TableBase/use-table-columns.js";
+import { ROW_NUMBER_COLUMN_KEY } from "../TableBase/use-table-selection.js";
+import { TableView } from "../TableBase/TableView.js";
+import { useContainerWidth } from "../TableBase/use-container-width.js";
+import { useTableSorts } from "../TableBase/use-table-sorts.js";
+import { useTableStorage } from "../TableBase/use-table-storage.js";
+import { CONTAINER_STYLES } from "@tenphi/tasty";
+import { forwardRef, useMemo, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+import { useControlledState } from "@react-stately/utils";
+
+//#region src/components/data/DataTable/DataTable.tsx
+/** Wide enough for five digits at the dense default. */
+const ROW_NUMBER_WIDTH = 56;
+const EMPTY_WIDTHS = {};
+function defaultGetRowKey(rowKey) {
+	return (row, index) => {
+		const value = row?.[rowKey];
+		return value == null ? index : value;
+	};
+}
+/**
+* A grid for query results.
+*
+* The same engine as `ItemTable` — one `TableView`, one column layout, one
+* value pipeline — with the defaults an analytical grid wants rather than a
+* list's: denser type, banded rows, resizable columns, multi-column sort, and
+* rows pinned for totals.
+*
+* It knows nothing about Cube. Measures, dimensions, pivots and drill-downs
+* reach it as ordinary columns, `render` output and `column.header.menu`
+* content, which is what keeps the ~34 kB of Cloud's column-header menu in
+* Cloud.
+*/
+function DataTable(props, ref) {
+	const { data, columns, rowKey = "id", getRowKey, pinnedTopRows, pinnedBottomRows, isLoading = false, loadingIndicator = "overlay", skeletonRowCount, error, emptyLabel, noResultsLabel, isFiltered, shape = "plain", size = "small", rowHeight, headerHeight, isStriped = true, isHeaderHidden, isHeaderSticky, showRowNumbers = false, sortMode, sorts: sortsProp, defaultSorts, onSortsChange, paginationMode = "client", page: pageProp, defaultPage, onPageChange, pageSize: pageSizeProp, defaultPageSize = 100, onPageSizeChange, pageSizeOptions, total: totalProp, totalPages, hasNextPage, summary = true, autoHidePagination = true, footerStart, footerCenter, footerEnd, cellSelectionMode = "range", isCellSelectable, selectedCellRange, defaultSelectedCellRange, onCellRangeChange, isRowMoveAnimated, isResizable = true, columnWidths: columnWidthsProp, defaultColumnWidths, onColumnResize, isVirtualized, virtualizeThreshold, overscan, getRowProps, storageKey, styles, headerStyles, headerCellStyles, bodyStyles, rowStyles, cellStyles, footerStyles, ariaLabel, qa, mods, ...rest } = props;
+	const rootRef = useCombinedRefs(ref, useRef(null));
+	const [scrollerEl, setScrollerEl] = useState(null);
+	const containerWidth = useContainerWidth(scrollerEl);
+	const storage = useTableStorage(storageKey);
+	/**
+	* `dataType` is presentational, so it is folded into the column here rather
+	* than reaching the renderer: `number` right-aligns and takes tabular figures
+	* so digits line up down the column.
+	*/
+	const resolvedColumns = useMemo(() => columns.map((column) => {
+		const isNumeric = column.dataType === "number";
+		return {
+			...column,
+			align: column.align ?? (isNumeric ? "end" : "start"),
+			cellStyles: isNumeric ? {
+				fontVariantNumeric: "tabular-nums",
+				...typeof column.cellStyles === "object" ? column.cellStyles : null
+			} : column.cellStyles
+		};
+	}), [columns]);
+	const { sorts, sortedRows, toggleSort, mode: resolvedSortMode } = useTableSorts({
+		columns: resolvedColumns,
+		rows: data,
+		mode: sortMode,
+		sorts: sortsProp,
+		defaultSorts,
+		onSortsChange
+	});
+	const [pageSize, setPageSizeState] = useControlledState(pageSizeProp, pageSizeProp === void 0 && storage.has("pageSize") ? storage.initial.pageSize ?? defaultPageSize : defaultPageSize, onPageSizeChange);
+	const [page, setPageState] = useControlledState(pageProp, defaultPage ?? 1, onPageChange);
+	const isPaginated = paginationMode !== "off";
+	const isServerPaginated = paginationMode === "server";
+	const total = isServerPaginated ? totalProp ?? 0 : sortedRows.length;
+	const pageInfo = getPageInfo({
+		page,
+		pageSize,
+		total,
+		totalPages: isServerPaginated ? totalPages : void 0
+	});
+	const setPage = useEvent((next) => setPageState(clampPage(next, pageInfo.totalPages)));
+	const setPageSize = useEvent((next) => {
+		setPageSizeState(next);
+		setPageState(1);
+		if (pageSizeProp === void 0) storage.write({ pageSize: next });
+	});
+	const visibleRows = paginationMode === "client" ? sortedRows.slice((pageInfo.page - 1) * pageSize, pageInfo.page * pageSize) : sortedRows;
+	const [ownColumnWidths, setOwnColumnWidths] = useState(() => (columnWidthsProp === void 0 && storage.has("columnWidths") ? storage.initial.columnWidths ?? defaultColumnWidths : defaultColumnWidths) ?? EMPTY_WIDTHS);
+	const [draftColumnWidths, setDraftColumnWidths] = useState(null);
+	const draftRef = useRef(null);
+	const baseColumnWidths = columnWidthsProp ?? ownColumnWidths;
+	const columnWidths = draftColumnWidths ?? baseColumnWidths;
+	const handleColumnResize = useEvent((key, width) => {
+		draftRef.current = {
+			...draftRef.current ?? baseColumnWidths,
+			[key]: Math.round(width)
+		};
+		setDraftColumnWidths(draftRef.current);
+	});
+	const handleColumnResizeEnd = useEvent((key) => {
+		const next = draftRef.current ?? baseColumnWidths;
+		if (columnWidthsProp === void 0) {
+			setOwnColumnWidths(next);
+			storage.write({ columnWidths: next });
+		}
+		onColumnResize?.(key, next[key], next);
+		draftRef.current = null;
+		setDraftColumnWidths(null);
+	});
+	const layout = useTableColumns({
+		columns: resolvedColumns,
+		containerWidth,
+		columnWidths,
+		leadingColumns: useMemo(() => showRowNumbers ? [{
+			key: ROW_NUMBER_COLUMN_KEY,
+			width: ROW_NUMBER_WIDTH
+		}] : void 0, [showRowNumbers])
+	});
+	const { t } = useI18n();
+	const resolvedGetRowKey = useMemo(() => getRowKey ?? defaultGetRowKey(rowKey), [getRowKey, rowKey]);
+	const selectionRows = useMemo(() => [
+		...pinnedTopRows ?? [],
+		...visibleRows,
+		...pinnedBottomRows ?? []
+	], [
+		pinnedTopRows,
+		visibleRows,
+		pinnedBottomRows
+	]);
+	const selectionRowKeys = useMemo(() => [
+		...(pinnedTopRows ?? []).map((row, index) => selectionRowKey("pinnedTop", resolvedGetRowKey(row, index))),
+		...visibleRows.map(resolvedGetRowKey),
+		...(pinnedBottomRows ?? []).map((row, index) => selectionRowKey("pinnedBottom", resolvedGetRowKey(row, index)))
+	], [
+		pinnedTopRows,
+		visibleRows,
+		pinnedBottomRows,
+		resolvedGetRowKey
+	]);
+	const resolveCellSelectable = useEvent((row, rowKey, columnKey) => {
+		if (!isCellSelectable) return true;
+		const index = selectionRowKeys.indexOf(rowKey);
+		const topCount = pinnedTopRows?.length ?? 0;
+		return isCellSelectable({
+			row,
+			rowKey,
+			columnKey,
+			section: index < topCount ? "pinnedTop" : index < topCount + visibleRows.length ? "body" : "pinnedBottom"
+		});
+	});
+	const cellSelection = useCellSelection({
+		mode: cellSelectionMode,
+		columns: layout.columns,
+		rows: selectionRows,
+		rowKeys: selectionRowKeys,
+		isCellSelectable: isCellSelectable ? resolveCellSelectable : void 0,
+		range: selectedCellRange,
+		defaultRange: defaultSelectedCellRange,
+		onRangeChange: onCellRangeChange
+	});
+	const rootStyles = {
+		...extractStyles(props, CONTAINER_STYLES),
+		...styles
+	};
+	const smallestPageSize = pageSizeOptions?.length ? Math.min(...pageSizeOptions) : pageSize;
+	const showPagination = isPaginated && !(autoHidePagination && !hasNextPage && pageInfo.totalPages <= 1 && total <= smallestPageSize);
+	const hasFooter = showPagination || footerStart != null || footerCenter != null || footerEnd != null;
+	return /* @__PURE__ */ jsx(TableView, {
+		...rest,
+		rootRef,
+		qa: qa || "DataTable",
+		rows: visibleRows,
+		pinnedTopRows,
+		pinnedBottomRows,
+		rowNumberOffset: paginationMode === "off" ? 0 : (pageInfo.page - 1) * pageSize,
+		rowIndexOffset: paginationMode === "off" ? 0 : (pageInfo.page - 1) * pageSize,
+		totalRowCount: total,
+		layout,
+		hasColumnDividers: true,
+		cellSelection,
+		getRowKey: resolvedGetRowKey,
+		onScrollerRef: setScrollerEl,
+		isLoading,
+		loadingIndicator,
+		skeletonRowCount,
+		error,
+		emptyLabel: emptyLabel ?? t("itemTable.noItems", "No items"),
+		noResultsLabel: noResultsLabel ?? t("itemTable.noResults", "No results found"),
+		isFiltered,
+		shape,
+		size,
+		rowHeight,
+		headerHeight,
+		isStriped,
+		isRowMoveAnimated,
+		isHeaderHidden,
+		isHeaderSticky,
+		contentPreset: "t4",
+		headerPreset: "t4m",
+		sortMode: resolvedSortMode,
+		sorts,
+		onColumnSort: toggleSort,
+		isVirtualized,
+		virtualizeThreshold,
+		overscan,
+		isResizable,
+		onColumnResize: handleColumnResize,
+		onColumnResizeEnd: handleColumnResizeEnd,
+		getRowProps,
+		ariaLabel,
+		styles: rootStyles,
+		headerStyles,
+		headerCellStyles,
+		bodyStyles,
+		rowStyles,
+		cellStyles,
+		mods,
+		footer: hasFooter ? /* @__PURE__ */ jsx(ItemTableFooter, {
+			start: footerStart,
+			center: footerCenter,
+			end: footerEnd,
+			styles: footerStyles,
+			pagination: showPagination ? {
+				page: pageInfo.page,
+				pageSize,
+				total,
+				totalPages: pageInfo.totalPages,
+				pageSizeOptions,
+				summary,
+				hasNextPage,
+				onPageChange: setPage,
+				onPageSizeChange: setPageSize
+			} : void 0
+		}) : null
+	});
+}
+const _DataTable = forwardRef(DataTable);
+_DataTable.displayName = "DataTable";
+
+//#endregion
+export { _DataTable };
+//# sourceMappingURL=DataTable.js.map

package/dist/components/data/DataTable/DataTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTable.js","names":[],"sources":["../../../../src/components/data/DataTable/DataTable.tsx"],"sourcesContent":["import { useControlledState } from '@react-stately/utils';\nimport { CONTAINER_STYLES } from '@tenphi/tasty';\nimport { forwardRef, useMemo, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal/hooks';\nimport { useI18n } from '../../../i18n';\nimport { useCombinedRefs } from '../../../utils/react';\nimport { extractStyles } from '../../../utils/styles';\nimport { clampPage, getPageInfo } from '../../navigation/Pagination';\nimport { ItemTableFooter } from '../ItemTable/ItemTableFooter';\nimport { TableView } from '../TableBase/TableView';\nimport { selectionRowKey } from '../TableBase/types';\nimport { useCellSelection } from '../TableBase/use-cell-selection';\nimport { useContainerWidth } from '../TableBase/use-container-width';\nimport { useTableColumns } from '../TableBase/use-table-columns';\nimport { ROW_NUMBER_COLUMN_KEY } from '../TableBase/use-table-selection';\nimport { useTableSorts } from '../TableBase/use-table-sorts';\nimport { useTableStorage } from '../TableBase/use-table-storage';\n\nimport type { Key } from '@react-types/shared';\nimport type { ForwardedRef, ReactElement } from 'react';\nimport type { CubeTableRowSection } from '../TableBase/types';\nimport type { CubeDataTableColumn, CubeDataTableProps } from './types';\n\n/** Wide enough for five digits at the dense default. */\nconst ROW_NUMBER_WIDTH = 56;\n\nconst EMPTY_WIDTHS: Record<string, number> = {};\n\nfunction defaultGetRowKey<T>(rowKey: string) {\n  return (row: T, index: number): Key => {\n    const value = (row as any)?.[rowKey];\n\n    return value == null ? index : (value as Key);\n  };\n}\n\n/**\n * A grid for query results.\n *\n * The same engine as `ItemTable` — one `TableView`, one column layout, one\n * value pipeline — with the defaults an analytical grid wants rather than a\n * list's: denser type, banded rows, resizable columns, multi-column sort, and\n * rows pinned for totals.\n *\n * It knows nothing about Cube. Measures, dimensions, pivots and drill-downs\n * reach it as ordinary columns, `render` output and `column.header.menu`\n * content, which is what keeps the ~34 kB of Cloud's column-header menu in\n * Cloud.\n */\nfunction DataTable<T = any>(\n  props: CubeDataTableProps<T>,\n  ref: ForwardedRef<HTMLDivElement>,\n) {\n  const {\n    data,\n    columns,\n    rowKey = 'id',\n    getRowKey,\n    pinnedTopRows,\n    pinnedBottomRows,\n    isLoading = false,\n    loadingIndicator = 'overlay',\n    skeletonRowCount,\n    error,\n    emptyLabel,\n    noResultsLabel,\n    isFiltered,\n    shape = 'plain',\n    // Denser than `ItemTable`'s `medium`: a result grid is read as a block, and\n    // more rows on screen is the point of it.\n    size = 'small',\n    rowHeight,\n    headerHeight,\n    isStriped = true,\n    isHeaderHidden,\n    isHeaderSticky,\n    showRowNumbers = false,\n    sortMode,\n    sorts: sortsProp,\n    defaultSorts,\n    onSortsChange,\n    paginationMode = 'client',\n    page: pageProp,\n    defaultPage,\n    onPageChange,\n    pageSize: pageSizeProp,\n    defaultPageSize = 100,\n    onPageSizeChange,\n    pageSizeOptions,\n    total: totalProp,\n    totalPages,\n    hasNextPage,\n    summary = true,\n    autoHidePagination = true,\n    footerStart,\n    footerCenter,\n    footerEnd,\n    cellSelectionMode = 'range',\n    isCellSelectable,\n    selectedCellRange,\n    defaultSelectedCellRange,\n    onCellRangeChange,\n    isRowMoveAnimated,\n    isResizable = true,\n    columnWidths: columnWidthsProp,\n    defaultColumnWidths,\n    onColumnResize,\n    isVirtualized,\n    virtualizeThreshold,\n    overscan,\n    getRowProps,\n    storageKey,\n    styles,\n    headerStyles,\n    headerCellStyles,\n    bodyStyles,\n    rowStyles,\n    cellStyles,\n    footerStyles,\n    ariaLabel,\n    qa,\n    mods,\n    ...rest\n  } = props;\n\n  const localRef = useRef<HTMLDivElement>(null);\n  const rootRef = useCombinedRefs(ref, localRef);\n  const [scrollerEl, setScrollerEl] = useState<HTMLElement | null>(null);\n  const containerWidth = useContainerWidth(scrollerEl);\n\n  const storage = useTableStorage(storageKey);\n\n  /**\n   * `dataType` is presentational, so it is folded into the column here rather\n   * than reaching the renderer: `number` right-aligns and takes tabular figures\n   * so digits line up down the column.\n   */\n  const resolvedColumns = useMemo(\n    () =>\n      columns.map((column) => {\n        const isNumeric = column.dataType === 'number';\n\n        return {\n          ...column,\n          align: column.align ?? (isNumeric ? 'end' : 'start'),\n          cellStyles: isNumeric\n            ? {\n                fontVariantNumeric: 'tabular-nums',\n                ...(typeof column.cellStyles === 'object'\n                  ? column.cellStyles\n                  : null),\n              }\n            : column.cellStyles,\n        } as CubeDataTableColumn<T>;\n      }),\n    [columns],\n  );\n\n  const {\n    sorts,\n    sortedRows,\n    toggleSort,\n    mode: resolvedSortMode,\n  } = useTableSorts<T>({\n    columns: resolvedColumns,\n    rows: data,\n    mode: sortMode,\n    sorts: sortsProp,\n    defaultSorts,\n    onSortsChange,\n  });\n\n  const [pageSize, setPageSizeState] = useControlledState<number>(\n    pageSizeProp as number,\n    (pageSizeProp === undefined && storage.has('pageSize')\n      ? storage.initial.pageSize ?? defaultPageSize\n      : defaultPageSize) as number,\n    onPageSizeChange as (value: number) => void,\n  );\n  const [page, setPageState] = useControlledState<number>(\n    pageProp as number,\n    defaultPage ?? 1,\n    onPageChange as (value: number) => void,\n  );\n\n  const isPaginated = paginationMode !== 'off';\n  const isServerPaginated = paginationMode === 'server';\n  const total = isServerPaginated ? totalProp ?? 0 : sortedRows.length;\n\n  const pageInfo = getPageInfo({\n    page,\n    pageSize,\n    total,\n    totalPages: isServerPaginated ? totalPages : undefined,\n  });\n\n  const setPage = useEvent((next: number) =>\n    setPageState(clampPage(next, pageInfo.totalPages)),\n  );\n  const setPageSize = useEvent((next: number) => {\n    setPageSizeState(next);\n    setPageState(1);\n\n    if (pageSizeProp === undefined) storage.write({ pageSize: next });\n  });\n\n  const visibleRows =\n    paginationMode === 'client'\n      ? sortedRows.slice(\n          (pageInfo.page - 1) * pageSize,\n          pageInfo.page * pageSize,\n        )\n      : sortedRows;\n\n  const [ownColumnWidths, setOwnColumnWidths] = useState<\n    Record<string, number>\n  >(\n    () =>\n      (columnWidthsProp === undefined && storage.has('columnWidths')\n        ? storage.initial.columnWidths ?? defaultColumnWidths\n        : defaultColumnWidths) ?? EMPTY_WIDTHS,\n  );\n  const [draftColumnWidths, setDraftColumnWidths] = useState<Record<\n    string,\n    number\n  > | null>(null);\n  const draftRef = useRef<Record<string, number> | null>(null);\n\n  const baseColumnWidths = columnWidthsProp ?? ownColumnWidths;\n  const columnWidths = draftColumnWidths ?? baseColumnWidths;\n\n  const handleColumnResize = useEvent((key: string, width: number) => {\n    draftRef.current = {\n      ...(draftRef.current ?? baseColumnWidths),\n      [key]: Math.round(width),\n    };\n    setDraftColumnWidths(draftRef.current);\n  });\n\n  const handleColumnResizeEnd = useEvent((key: string) => {\n    const next = draftRef.current ?? baseColumnWidths;\n\n    if (columnWidthsProp === undefined) {\n      setOwnColumnWidths(next);\n      storage.write({ columnWidths: next });\n    }\n\n    onColumnResize?.(key, next[key], next);\n    draftRef.current = null;\n    setDraftColumnWidths(null);\n  });\n\n  const leadingColumns = useMemo(\n    () =>\n      showRowNumbers\n        ? [{ key: ROW_NUMBER_COLUMN_KEY, width: ROW_NUMBER_WIDTH }]\n        : undefined,\n    [showRowNumbers],\n  );\n\n  const layout = useTableColumns<T>({\n    columns: resolvedColumns,\n    containerWidth,\n    columnWidths,\n    leadingColumns,\n  });\n\n  const { t } = useI18n();\n\n  const resolvedGetRowKey = useMemo(\n    () => getRowKey ?? defaultGetRowKey<T>(rowKey),\n    [getRowKey, rowKey],\n  );\n\n  // Every row a range can reach, in the order they appear on screen. Pinned rows\n  // are in it: a total is a figure like any other, and having to copy it\n  // separately from the column it sums is the wrong trade.\n  //\n  // The keys are built here rather than inside the hook so they cannot disagree\n  // with the ones the renderer stamps — a pinned row is keyed by its own index\n  // within its group, exactly as `renderPinnedRow` keys it.\n  const selectionRows = useMemo(\n    () => [\n      ...(pinnedTopRows ?? []),\n      ...visibleRows,\n      ...(pinnedBottomRows ?? []),\n    ],\n    [pinnedTopRows, visibleRows, pinnedBottomRows],\n  );\n  const selectionRowKeys = useMemo(\n    () => [\n      // Section-qualified, matching what the renderer stamps: the same record\n      // is routinely pinned at both edges, and one flat key space collapsed the\n      // two into whichever came first.\n      ...(pinnedTopRows ?? []).map((row, index) =>\n        selectionRowKey('pinnedTop', resolvedGetRowKey(row, index)),\n      ),\n      ...visibleRows.map(resolvedGetRowKey),\n      ...(pinnedBottomRows ?? []).map((row, index) =>\n        selectionRowKey('pinnedBottom', resolvedGetRowKey(row, index)),\n      ),\n    ],\n    [pinnedTopRows, visibleRows, pinnedBottomRows, resolvedGetRowKey],\n  );\n\n  // The hook works in one flat row order; the section a row belongs to is a\n  // property of where it sits in that order, so it is resolved here rather than\n  // asking the consumer to track it.\n  const resolveCellSelectable = useEvent(\n    (row: T, rowKey: Key, columnKey: string) => {\n      if (!isCellSelectable) return true;\n\n      const index = selectionRowKeys.indexOf(rowKey);\n      const topCount = pinnedTopRows?.length ?? 0;\n      const section: CubeTableRowSection =\n        index < topCount\n          ? 'pinnedTop'\n          : index < topCount + visibleRows.length\n            ? 'body'\n            : 'pinnedBottom';\n\n      return isCellSelectable({ row, rowKey, columnKey, section });\n    },\n  );\n\n  const cellSelection = useCellSelection<T>({\n    mode: cellSelectionMode,\n    columns: layout.columns,\n    rows: selectionRows,\n    rowKeys: selectionRowKeys,\n    isCellSelectable: isCellSelectable ? resolveCellSelectable : undefined,\n    range: selectedCellRange,\n    defaultRange: defaultSelectedCellRange,\n    onRangeChange: onCellRangeChange,\n  });\n\n  // Same as `ItemTable`: style props (`height`, `maxHeight`, `margin`, …) land\n  // on the root frame. `height` is the one that matters — there is no\n  // page-scroll mode, so bounding the grid is what turns the body into a\n  // scroller, pins the header, and lets virtualization engage at all.\n  const rootStyles = { ...extractStyles(props, CONTAINER_STYLES), ...styles };\n\n  const smallestPageSize = pageSizeOptions?.length\n    ? Math.min(...pageSizeOptions)\n    : pageSize;\n\n  const showPagination =\n    isPaginated &&\n    !(\n      autoHidePagination &&\n      !hasNextPage &&\n      pageInfo.totalPages <= 1 &&\n      total <= smallestPageSize\n    );\n\n  const hasFooter =\n    showPagination ||\n    footerStart != null ||\n    footerCenter != null ||\n    footerEnd != null;\n\n  return (\n    <TableView<T>\n      {...rest}\n      rootRef={rootRef}\n      qa={qa || 'DataTable'}\n      rows={visibleRows}\n      pinnedTopRows={pinnedTopRows}\n      pinnedBottomRows={pinnedBottomRows}\n      // Continuous across pages: row 101 is row 101, not row 1 of page two.\n      //\n      // Server mode counts too — the page and its size are known there just the\n      // same, and `rows` is that page. Only `'off'` starts at 1, because then\n      // there is no page to be on.\n      rowNumberOffset={\n        paginationMode === 'off' ? 0 : (pageInfo.page - 1) * pageSize\n      }\n      // The same offset drives `aria-rowindex`, which is document-absolute by\n      // contract — a screen reader on page 3 should hear \"row 51 of 240\", not\n      // \"row 1 of 25\".\n      rowIndexOffset={\n        paginationMode === 'off' ? 0 : (pageInfo.page - 1) * pageSize\n      }\n      totalRowCount={total}\n      layout={layout}\n      // Always on, unlike `ItemTable`. A result grid is read down a column, and\n      // once the values are wide and right-aligned the rule is what keeps a\n      // figure attached to its column — which is why Cloud's ag-grid theme sets\n      // `columnBorder` for `DataTable` and not for the list grids.\n      hasColumnDividers\n      cellSelection={cellSelection}\n      getRowKey={resolvedGetRowKey}\n      onScrollerRef={setScrollerEl}\n      isLoading={isLoading}\n      loadingIndicator={loadingIndicator}\n      skeletonRowCount={skeletonRowCount}\n      error={error}\n      // Same localized fallbacks as `ItemTable`: a grid that has finished\n      // loading and shows an unexplained blank rectangle reads as broken.\n      emptyLabel={emptyLabel ?? t('itemTable.noItems', 'No items')}\n      noResultsLabel={\n        noResultsLabel ?? t('itemTable.noResults', 'No results found')\n      }\n      isFiltered={isFiltered}\n      shape={shape}\n      size={size}\n      rowHeight={rowHeight}\n      headerHeight={headerHeight}\n      isStriped={isStriped}\n      isRowMoveAnimated={isRowMoveAnimated}\n      isHeaderHidden={isHeaderHidden}\n      isHeaderSticky={isHeaderSticky}\n      // The header shows the column name at body size — a result grid has no\n      // room for the uppercase caption a list header uses.\n      // `t4` throughout: a result grid is read as a block, and one step down\n      // from the list preset fits noticeably more on screen without losing\n      // legibility. The header takes the medium weight of the same step.\n      contentPreset=\"t4\"\n      headerPreset=\"t4m\"\n      sortMode={resolvedSortMode}\n      sorts={sorts}\n      onColumnSort={toggleSort}\n      isVirtualized={isVirtualized}\n      virtualizeThreshold={virtualizeThreshold}\n      overscan={overscan}\n      isResizable={isResizable}\n      onColumnResize={handleColumnResize}\n      onColumnResizeEnd={handleColumnResizeEnd}\n      getRowProps={getRowProps}\n      ariaLabel={ariaLabel}\n      styles={rootStyles}\n      headerStyles={headerStyles}\n      headerCellStyles={headerCellStyles}\n      bodyStyles={bodyStyles}\n      rowStyles={rowStyles}\n      cellStyles={cellStyles}\n      mods={mods}\n      footer={\n        hasFooter ? (\n          <ItemTableFooter\n            start={footerStart}\n            center={footerCenter}\n            end={footerEnd}\n            styles={footerStyles}\n            pagination={\n              showPagination\n                ? {\n                    page: pageInfo.page,\n                    pageSize,\n                    total,\n                    totalPages: pageInfo.totalPages,\n                    pageSizeOptions,\n                    summary,\n                    hasNextPage,\n                    onPageChange: setPage,\n                    onPageSizeChange: setPageSize,\n                  }\n                : undefined\n            }\n          />\n        ) : null\n      }\n    />\n  );\n}\n\nconst _DataTable = forwardRef(DataTable) as unknown as (<T = any>(\n  props: CubeDataTableProps<T> & { ref?: ForwardedRef<HTMLDivElement> },\n) => ReactElement) & { displayName?: string };\n\n_DataTable.displayName = 'DataTable';\n\nexport { _DataTable as DataTable };\n"],"mappings":"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"}

package/dist/components/data/DataTable/index.d.ts

@@ -0,0 +1,3 @@
+
+import { CubeDataTableColumn, CubeDataTableProps } from "./types.js";
+import { _DataTable } from "./DataTable.js";

package/dist/components/data/DataTable/types.d.ts

@@ -0,0 +1,145 @@
+
+import { SizeName } from "../../../tokens/sizes.js";
+import { CubeTablePageInfo } from "../../navigation/Pagination/types.js";
+import "../../navigation/Pagination/index.js";
+import "../../../tokens/index.js";
+import { CubeTableCellRange, CubeTableColumn, CubeTableLoadingIndicator, CubeTableRowContext, CubeTableRowSection, CubeTableSort } from "../TableBase/types.js";
+import { BaseProps, ContainerStyleProps, Styles } from "@tenphi/tasty";
+import { ReactNode } from "react";
+import { Key as Key$1 } from "@react-types/shared";
+
+//#region src/components/data/DataTable/types.d.ts
+/**
+ * A `DataTable` column.
+ *
+ * The same shape `ItemTable` uses. `dataType` is the one addition, and it is
+ * deliberately presentational — alignment and numeric formatting — rather than
+ * a Cube type: nothing under `src/components/data/` knows what a measure is.
+ */
+interface CubeDataTableColumn<T = any> extends CubeTableColumn<T> {
+  /**
+   * Drives the default alignment and numeric font. `number` right-aligns and
+   * switches to tabular figures so digits line up down the column.
+   */
+  dataType?: 'string' | 'number' | 'boolean' | 'date' | 'unknown';
+}
+interface CubeDataTableProps<T = any> extends BaseProps, ContainerStyleProps {
+  data: readonly T[];
+  columns: CubeDataTableColumn<T>[];
+  rowKey?: string;
+  getRowKey?: (row: T, index: number) => Key$1;
+  /**
+   * Totals and subtotals, pinned above and below the scrolling rows. Ordinary
+   * rows as far as the columns are concerned — the consumer decides what a
+   * total means.
+   */
+  pinnedTopRows?: readonly T[];
+  pinnedBottomRows?: readonly T[];
+  isLoading?: boolean;
+  /** @default 'overlay' */
+  loadingIndicator?: CubeTableLoadingIndicator;
+  skeletonRowCount?: number;
+  error?: ReactNode;
+  emptyLabel?: ReactNode;
+  noResultsLabel?: ReactNode;
+  isFiltered?: boolean;
+  shape?: 'plain' | 'card';
+  /** @default 'small' — an analytical grid packs more rows than a list. */
+  size?: SizeName;
+  rowHeight?: number;
+  headerHeight?: number;
+  /** @default true — banding is what makes a wide row readable across. */
+  isStriped?: boolean;
+  isHeaderHidden?: boolean;
+  isHeaderSticky?: boolean;
+  /**
+   * Slide rows to their new positions when the sort changes, instead of
+   * teleporting them. @default true
+   */
+  isRowMoveAnimated?: boolean;
+  /** Numbers each row down the side. @default false */
+  showRowNumbers?: boolean;
+  /** @default 'client' */
+  sortMode?: 'client' | 'server' | 'off';
+  /**
+   * Multi-column, unlike `ItemTable`'s single `sort`: an analytical grid is
+   * routinely sorted by one dimension then another, and Cloud's reports send
+   * an array of sorts to the query.
+   */
+  sorts?: CubeTableSort[];
+  defaultSorts?: CubeTableSort[];
+  onSortsChange?: (sorts: CubeTableSort[]) => void;
+  /** @default 'client' */
+  paginationMode?: 'client' | 'server' | 'off';
+  page?: number;
+  defaultPage?: number;
+  onPageChange?: (page: number) => void;
+  pageSize?: number;
+  defaultPageSize?: number;
+  onPageSizeChange?: (pageSize: number) => void;
+  pageSizeOptions?: number[];
+  total?: number;
+  totalPages?: number;
+  hasNextPage?: boolean;
+  summary?: boolean | ((info: CubeTablePageInfo) => ReactNode);
+  /** @default true */
+  autoHidePagination?: boolean;
+  footerStart?: ReactNode;
+  footerCenter?: ReactNode;
+  footerEnd?: ReactNode;
+  /**
+   * A list is acted on by row; a result grid is read by cell. Click selects a
+   * cell, shift-click and drag grow a rectangle, and ⌘/Ctrl+C copies it.
+   *
+   * `'cell'` allows one cell at a time; `'none'` turns the whole thing off.
+   * @default 'range'
+   */
+  cellSelectionMode?: 'none' | 'cell' | 'range';
+  /**
+   * Vetoes individual cells. A pinned total's label cell is the motivating case:
+   * `"Total"` is a caption for the row, not a figure, and there is nothing
+   * useful to do with it selected.
+   *
+   * ```tsx
+   * isCellSelectable={({ section, columnKey }) =>
+   *   !(section === 'pinnedBottom' && columnKey === 'region')
+   * }
+   * ```
+   *
+   * A vetoed cell is inert — it cannot anchor or receive a range, never
+   * highlights, and copies as an empty field so a block spanning it keeps its
+   * shape.
+   */
+  isCellSelectable?: (ctx: {
+    row: T;
+    rowKey: Key$1;
+    columnKey: string;
+    section: CubeTableRowSection;
+  }) => boolean;
+  selectedCellRange?: CubeTableCellRange | null;
+  defaultSelectedCellRange?: CubeTableCellRange | null;
+  onCellRangeChange?: (range: CubeTableCellRange | null) => void;
+  /** @default true — a result grid is the case resizing exists for. */
+  isResizable?: boolean;
+  columnWidths?: Record<string, number>;
+  defaultColumnWidths?: Record<string, number>;
+  onColumnResize?: (columnKey: string, width: number, all: Record<string, number>) => void;
+  isVirtualized?: boolean | 'auto';
+  virtualizeThreshold?: number;
+  overscan?: number;
+  getRowProps?: (ctx: CubeTableRowContext<T>) => Record<string, any> | undefined;
+  storageKey?: string;
+  styles?: Styles;
+  headerStyles?: Styles;
+  headerCellStyles?: Styles;
+  bodyStyles?: Styles;
+  rowStyles?: Styles;
+  cellStyles?: Styles;
+  footerStyles?: Styles;
+  ariaLabel?: string;
+  qa?: string;
+  mods?: Record<string, boolean>;
+}
+//#endregion
+export { CubeDataTableColumn, CubeDataTableProps };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/data/ItemTable/ItemTable.d.ts

@@ -0,0 +1,19 @@
+
+import { CubeItemTableProps } from "./types.js";
+import { ItemTableBulkBar } from "./ItemTableBulkBar.js";
+import { ItemTableSearch, ItemTableToolbar } from "./ItemTableToolbar.js";
+import { ForwardedRef, ReactElement } from "react";
+
+//#region src/components/data/ItemTable/ItemTable.d.ts
+declare const _ItemTable: (<T = any>(props: CubeItemTableProps<T> & {
+  ref?: ForwardedRef<HTMLDivElement>;
+}) => ReactElement) & {
+  displayName?: string;
+} & {
+  /** The table's search input, bound to the table's own state. */Search: typeof ItemTableSearch; /** The default toolbar row, for rebuilding it around extra content. */
+  Toolbar: typeof ItemTableToolbar; /** The selection action bar, for placing it outside the default chrome. */
+  BulkBar: typeof ItemTableBulkBar;
+};
+//#endregion
+export { _ItemTable };
+//# sourceMappingURL=ItemTable.d.ts.map