@cube-dev/ui-kit 0.156.0 → 0.157.0

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

package/dist/components/data/ItemTable/ItemTable.js

@@ -0,0 +1,350 @@
+/** @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 { DraggableCollection } from "../../shared/DraggableCollection.js";
+import { clampPage, getPageInfo } from "../../navigation/Pagination/use-pagination.js";
+import { ItemTableFooter } from "./ItemTableFooter.js";
+import { ROW_MENU_COLUMN_KEY, ROW_MENU_COLUMN_WIDTH } from "../TableBase/row-menu.js";
+import { useTableColumns } from "../TableBase/use-table-columns.js";
+import { SELECTION_COLUMN_KEY, SELECTION_COLUMN_WIDTH, useTableSelection } from "../TableBase/use-table-selection.js";
+import { TableView } from "../TableBase/TableView.js";
+import { useContainerWidth } from "../TableBase/use-container-width.js";
+import { useTableSort } from "../TableBase/use-table-sort.js";
+import { useTableStorage } from "../TableBase/use-table-storage.js";
+import { useTableSearch } from "../TableBase/use-table-search.js";
+import { ItemTableChromeProvider, ItemTableSearch, ItemTableToolbar } from "./ItemTableToolbar.js";
+import { ItemTableBulkBar } from "./ItemTableBulkBar.js";
+import { ItemTableDragPreview } from "./ItemTableDragPreview.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/ItemTable/ItemTable.tsx
+/** Stable identity, so the uncontrolled default does not change every render. */
+const EMPTY_WIDTHS = {};
+function defaultGetRowKey(rowKey) {
+	return (row, index) => {
+		const value = row?.[rowKey];
+		return value == null ? index : value;
+	};
+}
+function ItemTable(props, ref) {
+	const { data, columns, rowKey = "id", getRowKey, isLoading = false, loadingIndicator = "overlay", selectionMode, bulkActions, rowLink, onRowAction, rowMenu, rowContextMenu = false, onRowMenuAction, rowMenuTriggerProps, bulkBarPlacement = "floating", bulkBarStyles, selectedKeys: selectedKeysProp, defaultSelectedKeys, onSelectionChange, selectAllMode = "page", isRowSelectable, selectionTooltip, disabledKeys, skeletonRowCount = 6, emptyLabel, noResultsLabel, error, isFiltered, toolbar, isSearchable = false, searchMode = "client", searchPlaceholder, searchValue: searchValueProp, defaultSearchValue, onSearchChange, searchDelay = 500, searchFilter, filters, actions, onRefresh, paginationMode = "client", pageSize: pageSizeProp, defaultPageSize = 50, autoHidePagination = true, onLoadMore, hasMore, isLoadingMore, loadMoreMargin, storageKey, persist, isReorderable = false, onReorder, dropOnRow, getItemDragInfo, isResizable = false, columnWidths: columnWidthsProp, defaultColumnWidths, onColumnResize, onPageSizeChange, pageSizeOptions = [
+		10,
+		20,
+		50,
+		100,
+		500
+	], page: pageProp, defaultPage, onPageChange, total: totalProp, totalPages, hasNextPage, summary = true, footer, footerStart, footerCenter, footerEnd, sortMode, sort: sortProp, defaultSort, onSortChange, shape = "plain", size = "medium", rowHeight, headerHeight, isStriped = false, isHeaderHidden = false, isHeaderSticky = true, isVirtualized = "auto", virtualizeThreshold = 50, overscan = 20, getRowProps, ariaLabel, qa, mods, styles, headerStyles, headerCellStyles, headerPreset = "c3", toolbarStyles, searchStyles, footerStyles, bodyStyles, rowStyles, cellStyles, isRowMoveAnimated } = props;
+	const { t } = useI18n();
+	const rootRef = useCombinedRefs(ref, useRef(null));
+	const [scrollerEl, setScrollerEl] = useState(null);
+	const containerWidth = useContainerWidth(scrollerEl);
+	const rootStyles = {
+		...extractStyles(props, CONTAINER_STYLES),
+		...styles
+	};
+	const { searchValue, setSearchValue, searchedRows, isFiltered: isSearching } = useTableSearch({
+		columns,
+		rows: data,
+		mode: searchMode,
+		value: searchValueProp,
+		defaultValue: defaultSearchValue,
+		onChange: onSearchChange,
+		delay: searchDelay,
+		filter: searchFilter
+	});
+	const storage = useTableStorage(storageKey, persist);
+	const { sort, sortedRows, toggleSort, mode: resolvedSortMode } = useTableSort({
+		columns,
+		rows: searchedRows,
+		mode: sortMode,
+		sort: sortProp,
+		defaultSort: sortProp === void 0 && storage.has("sort") ? storage.initial.sort ?? defaultSort : defaultSort,
+		onSortChange: useEvent((next) => {
+			if (sortProp === void 0) storage.write({ sort: next });
+			onSortChange?.(next);
+		})
+	});
+	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 isInfinite = paginationMode === "infinite";
+	const isPaginated = paginationMode !== "off" && !isInfinite;
+	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);
+		if (pageSizeProp === void 0) storage.write({ pageSize: next });
+		setPageState(1);
+	});
+	const visibleRows = paginationMode === "client" ? sortedRows.slice((pageInfo.page - 1) * pageSize, pageInfo.page * pageSize) : sortedRows;
+	const resolvedGetRowKey = useMemo(() => getRowKey ?? defaultGetRowKey(rowKey), [getRowKey, rowKey]);
+	const resolvedSelectionMode = selectionMode ?? (bulkActions?.length ? "multiple" : "none");
+	const selection = useTableSelection({
+		rows: visibleRows,
+		filteredRows: paginationMode === "client" ? sortedRows : visibleRows,
+		getRowKey: resolvedGetRowKey,
+		selectionMode: resolvedSelectionMode,
+		selectedKeys: selectedKeysProp,
+		defaultSelectedKeys,
+		onSelectionChange,
+		selectAllMode,
+		isRowSelectable,
+		disabledKeys
+	});
+	const resolveRowMenu = useMemo(() => rowMenu == null ? void 0 : typeof rowMenu === "function" ? rowMenu : () => rowMenu, [rowMenu]);
+	const trailingColumns = useMemo(() => resolveRowMenu && rowContextMenu === true ? [{
+		key: ROW_MENU_COLUMN_KEY,
+		width: ROW_MENU_COLUMN_WIDTH[size] ?? ROW_MENU_COLUMN_WIDTH.medium,
+		align: "center"
+	}] : void 0, [
+		resolveRowMenu,
+		rowContextMenu,
+		size
+	]);
+	const leadingColumns = useMemo(() => selection.isEnabled ? [{
+		key: SELECTION_COLUMN_KEY,
+		width: SELECTION_COLUMN_WIDTH[size] ?? SELECTION_COLUMN_WIDTH.medium,
+		align: "center"
+	}] : void 0, [selection.isEnabled, size]);
+	/**
+	* Column widths, in three layers.
+	*
+	* The draft exists because a resize has to be visible *while* it happens, and
+	* a controlled `columnWidths` cannot be: the consumer only learns the new
+	* width from `onColumnResize`, which fires when the gesture ends. Without a
+	* draft a controlled table simply would not move under the pointer.
+	*/
+	const [ownColumnWidths, setOwnColumnWidths] = useState(() => (columnWidthsProp === void 0 && storage.has("columnWidths") ? storage.initial.columnWidths ?? defaultColumnWidths : defaultColumnWidths) ?? EMPTY_WIDTHS);
+	const [draftColumnWidths, setDraftColumnWidths] = useState(null);
+	/**
+	* The same draft, in a ref.
+	*
+	* A keyboard resize runs `useMove`'s whole start → move → end cycle inside
+	* one key press, so the end handler would read the state from before the
+	* move. The ref is what it actually settles on; the state exists only to
+	* trigger the render.
+	*/
+	const draftColumnWidthsRef = useRef(null);
+	const baseColumnWidths = columnWidthsProp ?? ownColumnWidths;
+	const columnWidths = draftColumnWidths ?? baseColumnWidths;
+	const handleColumnResize = useEvent((key, width) => {
+		draftColumnWidthsRef.current = {
+			...draftColumnWidthsRef.current ?? baseColumnWidths,
+			[key]: Math.round(width)
+		};
+		setDraftColumnWidths(draftColumnWidthsRef.current);
+	});
+	const handleColumnResizeEnd = useEvent((key) => {
+		const next = draftColumnWidthsRef.current ?? baseColumnWidths;
+		if (columnWidthsProp === void 0) {
+			setOwnColumnWidths(next);
+			storage.write({ columnWidths: next });
+		}
+		onColumnResize?.(key, next[key], next);
+		draftColumnWidthsRef.current = null;
+		setDraftColumnWidths(null);
+	});
+	const layout = useTableColumns({
+		columns,
+		containerWidth,
+		columnWidths,
+		leadingColumns,
+		trailingColumns
+	});
+	const bulkBar = bulkActions != null && bulkActions.length > 0 && selection.selectedCount > 0 ? /* @__PURE__ */ jsx(ItemTableBulkBar, {
+		actions: bulkActions,
+		placement: bulkBarPlacement,
+		styles: bulkBarStyles
+	}) : null;
+	const isBulkBarInToolbar = bulkBar != null && bulkBarPlacement === "toolbar";
+	const toolbarNode = toolbar !== void 0 || isSearchable || filters != null || actions != null || onRefresh != null || isBulkBarInToolbar ? toolbar ?? /* @__PURE__ */ jsx(ItemTableToolbar, {
+		isSearchable,
+		filters,
+		actions: isBulkBarInToolbar ? bulkBar : actions,
+		isLoading,
+		styles: toolbarStyles,
+		searchStyles,
+		onRefresh
+	}) : null;
+	/**
+	* Pagination that cannot do anything is noise: one page of five rows still
+	* renders "1–5 of 5", a page-size selector whose every option shows the same
+	* five rows, and a solitary "1" button.
+	*
+	* "Cannot do anything" is both conditions together — a single page *and* a
+	* total that even the smallest page size would not split. A 15-row single
+	* page stays, because choosing "10 / page" would genuinely paginate it.
+	*/
+	const smallestPageSize = pageSizeOptions?.length ? Math.min(...pageSizeOptions) : pageSize;
+	const isPaginationUseless = autoHidePagination && !hasNextPage && pageInfo.totalPages <= 1 && total <= smallestPageSize;
+	const showPagination = isPaginated && !isPaginationUseless;
+	const footerNode = footer !== void 0 || showPagination || footerStart != null || footerCenter != null || footerEnd != null ? footer ?? /* @__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 bodyRef = useRef(null);
+	const rowKeys = useMemo(() => visibleRows.map((row, index) => String(resolvedGetRowKey(row, index))), [visibleRows, resolvedGetRowKey]);
+	const handleReorder = useEvent((nextKeys) => {
+		const byKey = new Map(visibleRows.map((row, index) => [String(resolvedGetRowKey(row, index)), row]));
+		onReorder?.(nextKeys, nextKeys.map((key) => byKey.get(key)).filter((row) => row !== void 0));
+	});
+	/**
+	* `DraggableCollection` owns the React Aria drag/drop hooks and hands the two
+	* states down. It is only mounted when reordering is on, so a plain table
+	* pays nothing for it.
+	*
+	* `RowCollection` and the `SelectionManager` from `useTableSelection` satisfy
+	* its structural `state` contract unchanged — both exist even when selection
+	* itself is off.
+	*/
+	const renderTable = (dragState, dropState, collectionProps) => /* @__PURE__ */ jsx(TableView, {
+		rootRef,
+		dragState,
+		dropState,
+		collectionProps,
+		bodyRef,
+		qa: qa || "ItemTable",
+		rows: visibleRows,
+		rowIndexOffset: isPaginated ? (pageInfo.page - 1) * pageSize : 0,
+		totalRowCount: total,
+		getRowKey: resolvedGetRowKey,
+		layout,
+		onScrollerRef: setScrollerEl,
+		size,
+		shape,
+		rowHeight,
+		headerHeight,
+		isHeaderHidden,
+		isHeaderSticky,
+		isVirtualized,
+		virtualizeThreshold,
+		overscan,
+		isStriped,
+		isRowMoveAnimated,
+		isLoading,
+		loadingIndicator,
+		selection,
+		selectionTooltip,
+		rowLink,
+		onRowAction,
+		onLoadMore: isInfinite ? onLoadMore : void 0,
+		hasMore,
+		isLoadingMore,
+		loadMoreMargin,
+		isReorderable: isDragEnabled,
+		isResizable,
+		onColumnResize: handleColumnResize,
+		onColumnResizeEnd: handleColumnResizeEnd,
+		rowMenu: resolveRowMenu,
+		rowContextMenu,
+		onRowMenuAction,
+		rowMenuTriggerProps,
+		skeletonRowCount,
+		emptyLabel: emptyLabel ?? t("itemTable.noItems", "No items"),
+		noResultsLabel: noResultsLabel ?? t("itemTable.noResults", "No results found"),
+		error,
+		toolbar: toolbarNode,
+		footer: footerNode,
+		isFiltered: isFiltered ?? isSearching,
+		sortMode: resolvedSortMode,
+		sort,
+		onColumnSort: toggleSort,
+		getRowProps,
+		ariaLabel,
+		styles: rootStyles,
+		headerStyles,
+		headerCellStyles,
+		headerPreset,
+		bodyStyles,
+		rowStyles,
+		cellStyles,
+		mods,
+		overlay: bulkBarPlacement === "floating" ? bulkBar : null
+	});
+	const rowByKeyForDrop = useMemo(() => {
+		const map = /* @__PURE__ */ new Map();
+		visibleRows.forEach((row, index) => map.set(String(resolvedGetRowKey(row, index)), row));
+		return map;
+	}, [visibleRows, resolvedGetRowKey]);
+	const handleItemDrop = useEvent((targetKey, draggedKeys) => {
+		if (!dropOnRow) return;
+		const target = rowByKeyForDrop.get(String(targetKey));
+		if (!target) return;
+		const dragged = draggedKeys.map((key) => rowByKeyForDrop.get(String(key))).filter((row) => row !== void 0 && row !== target);
+		if (!dragged.length) return;
+		if (dropOnRow.isAllowed && !dropOnRow.isAllowed(dragged, target)) return;
+		dropOnRow.onDrop(dragged, target);
+	});
+	const renderDragPreview = useEvent((keys) => /* @__PURE__ */ jsx(ItemTableDragPreview, {
+		rows: keys.map((key) => rowByKeyForDrop.get(String(key))).filter((row) => row !== void 0),
+		getItemDragInfo
+	}));
+	const shouldAcceptItemDrop = useEvent((targetKey) => {
+		const target = rowByKeyForDrop.get(String(targetKey));
+		return target != null && (dropOnRow?.isTarget(target) ?? false);
+	});
+	const isDragEnabled = isReorderable || dropOnRow != null;
+	const table = isDragEnabled ? /* @__PURE__ */ jsx(DraggableCollection, {
+		state: {
+			collection: selection.collection,
+			selectionManager: selection.selectionManager,
+			disabledKeys: new Set(disabledKeys ?? [])
+		},
+		listRef: bodyRef,
+		orderedKeys: rowKeys,
+		orientation: "vertical",
+		onReorder: isReorderable ? handleReorder : void 0,
+		onItemDrop: dropOnRow ? handleItemDrop : void 0,
+		shouldAcceptItemDrop: dropOnRow ? shouldAcceptItemDrop : void 0,
+		renderPreview: getItemDragInfo ? renderDragPreview : void 0,
+		children: (dragState, dropState, collectionProps) => renderTable(dragState, dropState, collectionProps)
+	}) : renderTable();
+	return /* @__PURE__ */ jsx(ItemTableChromeProvider, {
+		value: {
+			searchValue,
+			setSearchValue,
+			searchPlaceholder,
+			isLoading,
+			onRefresh,
+			selectedKeys: selection.selectedKeys,
+			selectedRows: selection.selectedRows,
+			selectedCount: selection.selectedCount,
+			clearSelection: selection.clearSelection
+		},
+		children: table
+	});
+}
+const _ItemTable = Object.assign(forwardRef(ItemTable), {
+	Search: ItemTableSearch,
+	Toolbar: ItemTableToolbar,
+	BulkBar: ItemTableBulkBar
+});
+_ItemTable.displayName = "ItemTable";
+
+//#endregion
+export { _ItemTable };
+//# sourceMappingURL=ItemTable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ItemTable.js","names":[],"sources":["../../../../src/components/data/ItemTable/ItemTable.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 { DraggableCollection } from '../../shared/DraggableCollection';\nimport {\n  ROW_MENU_COLUMN_KEY,\n  ROW_MENU_COLUMN_WIDTH,\n} from '../TableBase/row-menu';\nimport { TableView } from '../TableBase/TableView';\nimport { useContainerWidth } from '../TableBase/use-container-width';\nimport { useTableColumns } from '../TableBase/use-table-columns';\nimport { useTableSearch } from '../TableBase/use-table-search';\nimport {\n  SELECTION_COLUMN_KEY,\n  SELECTION_COLUMN_WIDTH,\n  useTableSelection,\n} from '../TableBase/use-table-selection';\nimport { useTableSort } from '../TableBase/use-table-sort';\nimport { useTableStorage } from '../TableBase/use-table-storage';\n\nimport { ItemTableBulkBar } from './ItemTableBulkBar';\nimport { ItemTableDragPreview } from './ItemTableDragPreview';\nimport { ItemTableFooter } from './ItemTableFooter';\nimport {\n  ItemTableChromeProvider,\n  ItemTableSearch,\n  ItemTableToolbar,\n} from './ItemTableToolbar';\n\nimport type { Key } from '@react-types/shared';\nimport type { ForwardedRef, ReactElement, ReactNode } from 'react';\nimport type { CubeTableRowContext, CubeTableSort } from '../TableBase/types';\nimport type { CubeItemTableProps } from './types';\n\n/** Stable identity, so the uncontrolled default does not change every render. */\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\nfunction ItemTable<T = any>(\n  props: CubeItemTableProps<T>,\n  ref: ForwardedRef<HTMLDivElement>,\n): ReactElement {\n  const {\n    data,\n    columns,\n    rowKey = 'id',\n    getRowKey,\n    isLoading = false,\n    loadingIndicator = 'overlay',\n    selectionMode,\n    bulkActions,\n    rowLink,\n    onRowAction,\n    rowMenu,\n    rowContextMenu = false,\n    onRowMenuAction,\n    rowMenuTriggerProps,\n    bulkBarPlacement = 'floating',\n    bulkBarStyles,\n    selectedKeys: selectedKeysProp,\n    defaultSelectedKeys,\n    onSelectionChange,\n    selectAllMode = 'page',\n    isRowSelectable,\n    selectionTooltip,\n    disabledKeys,\n    skeletonRowCount = 6,\n    emptyLabel,\n    noResultsLabel,\n    error,\n    isFiltered,\n    toolbar,\n    isSearchable = false,\n    searchMode = 'client',\n    searchPlaceholder,\n    searchValue: searchValueProp,\n    defaultSearchValue,\n    onSearchChange,\n    searchDelay = 500,\n    searchFilter,\n    filters,\n    actions,\n    onRefresh,\n    paginationMode = 'client',\n    pageSize: pageSizeProp,\n    defaultPageSize = 50,\n    autoHidePagination = true,\n    onLoadMore,\n    hasMore,\n    isLoadingMore,\n    loadMoreMargin,\n    storageKey,\n    persist,\n    isReorderable = false,\n    onReorder,\n    dropOnRow,\n    getItemDragInfo,\n    isResizable = false,\n    columnWidths: columnWidthsProp,\n    defaultColumnWidths,\n    onColumnResize,\n    onPageSizeChange,\n    pageSizeOptions = [10, 20, 50, 100, 500],\n    page: pageProp,\n    defaultPage,\n    onPageChange,\n    total: totalProp,\n    totalPages,\n    hasNextPage,\n    summary = true,\n    footer,\n    footerStart,\n    footerCenter,\n    footerEnd,\n    sortMode,\n    sort: sortProp,\n    defaultSort,\n    onSortChange,\n    shape = 'plain',\n    size = 'medium',\n    rowHeight,\n    headerHeight,\n    isStriped = false,\n    isHeaderHidden = false,\n    isHeaderSticky = true,\n    isVirtualized = 'auto',\n    virtualizeThreshold = 50,\n    overscan = 20,\n    getRowProps,\n    ariaLabel,\n    qa,\n    mods,\n    styles,\n    headerStyles,\n    headerCellStyles,\n    headerPreset = 'c3',\n    toolbarStyles,\n    searchStyles,\n    footerStyles,\n    bodyStyles,\n    rowStyles,\n    cellStyles,\n    isRowMoveAnimated,\n  } = props;\n\n  const { t } = useI18n();\n\n  const localRef = useRef<HTMLDivElement>(null);\n  const rootRef = useCombinedRefs(ref, localRef);\n\n  // Held in state, not a ref: the virtualized path's scroller is created by\n  // Virtuoso and arrives through a callback, and the column layout has to\n  // re-derive once it does.\n  const [scrollerEl, setScrollerEl] = useState<HTMLDivElement | null>(null);\n  const containerWidth = useContainerWidth(scrollerEl);\n\n  // Style props (`height`, `maxHeight`, `margin`, …) land on the root frame.\n  // `height` matters most: there is no page-scroll mode, so bounding the table\n  // is what turns the body into a scroller and pins the header.\n  const rootStyles = { ...extractStyles(props, CONTAINER_STYLES), ...styles };\n\n  const {\n    searchValue,\n    setSearchValue,\n    searchedRows,\n    isFiltered: isSearching,\n  } = useTableSearch<T>({\n    columns,\n    rows: data,\n    mode: searchMode,\n    value: searchValueProp,\n    defaultValue: defaultSearchValue,\n    onChange: onSearchChange,\n    delay: searchDelay,\n    filter: searchFilter,\n  });\n\n  const storage = useTableStorage(storageKey, persist);\n\n  const {\n    sort,\n    sortedRows,\n    toggleSort,\n    mode: resolvedSortMode,\n  } = useTableSort<T>({\n    columns,\n    rows: searchedRows,\n    mode: sortMode,\n    sort: sortProp,\n    // Only restore what the table owns: a controlled `sort` belongs to the page,\n    // and overriding it here would fight the page's own source of truth.\n    defaultSort:\n      sortProp === undefined && storage.has('sort')\n        ? storage.initial.sort ?? defaultSort\n        : defaultSort,\n    onSortChange: useEvent((next: CubeTableSort | null) => {\n      if (sortProp === undefined) storage.write({ sort: next });\n      onSortChange?.(next);\n    }),\n  });\n\n  // Search → sort → paginate. Paging last, so a page always reflects the rows\n  // the user is actually looking at.\n  //\n  // Deliberately not `usePagination`: that hook owns an in-memory array, and in\n  // server mode `data` is a single page. Deriving the bounds from it would clamp\n  // the page to 1 and swallow every page change.\n  const [pageSize, setPageSizeState] = useControlledState<number>(\n    pageSizeProp as number,\n    pageSizeProp === undefined && storage.has('pageSize')\n      ? storage.initial.pageSize ?? defaultPageSize\n      : defaultPageSize,\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 isInfinite = paginationMode === 'infinite';\n  // Infinite scroll replaces the page control rather than adding to it.\n  const isPaginated = paginationMode !== 'off' && !isInfinite;\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\n    if (pageSizeProp === undefined) storage.write({ pageSize: next });\n\n    // The old page index points at different rows under a new page size, so\n    // staying on it would silently move the user.\n    setPageState(1);\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 resolvedGetRowKey = useMemo(\n    () => getRowKey ?? defaultGetRowKey<T>(rowKey),\n    [getRowKey, rowKey],\n  );\n\n  // A bulk action with no way to select rows is a contradiction, so supplying\n  // any implies multiple selection unless the consumer says otherwise.\n  const resolvedSelectionMode =\n    selectionMode ?? (bulkActions?.length ? 'multiple' : 'none');\n\n  const selection = useTableSelection<T>({\n    rows: visibleRows,\n    // The wider set the header checkbox can reach under\n    // `selectAllMode=\"filtered\"`. In server mode the client only ever holds one\n    // page, so the two coincide.\n    filteredRows: paginationMode === 'client' ? sortedRows : visibleRows,\n    getRowKey: resolvedGetRowKey,\n    selectionMode: resolvedSelectionMode,\n    selectedKeys: selectedKeysProp,\n    defaultSelectedKeys,\n    onSelectionChange,\n    selectAllMode,\n    isRowSelectable,\n    disabledKeys,\n  });\n\n  // A `ReactNode` menu applies to every row; a function decides per row. The\n  // renderer only ever sees the function form.\n  const resolveRowMenu = useMemo(\n    () =>\n      rowMenu == null\n        ? undefined\n        : typeof rowMenu === 'function'\n          ? (rowMenu as (\n              row: T,\n              ctx: CubeTableRowContext<T>,\n            ) => ReactNode | null)\n          : () => rowMenu as ReactNode,\n    [rowMenu],\n  );\n\n  const trailingColumns = useMemo(\n    () =>\n      resolveRowMenu && rowContextMenu === true\n        ? [\n            {\n              key: ROW_MENU_COLUMN_KEY,\n              width:\n                ROW_MENU_COLUMN_WIDTH[size] ?? ROW_MENU_COLUMN_WIDTH.medium,\n              align: 'center' as const,\n            },\n          ]\n        : undefined,\n    [resolveRowMenu, rowContextMenu, size],\n  );\n\n  const leadingColumns = useMemo(\n    () =>\n      selection.isEnabled\n        ? [\n            {\n              key: SELECTION_COLUMN_KEY,\n              width:\n                SELECTION_COLUMN_WIDTH[size] ?? SELECTION_COLUMN_WIDTH.medium,\n              align: 'center' as const,\n            },\n          ]\n        : undefined,\n    [selection.isEnabled, size],\n  );\n\n  /**\n   * Column widths, in three layers.\n   *\n   * The draft exists because a resize has to be visible *while* it happens, and\n   * a controlled `columnWidths` cannot be: the consumer only learns the new\n   * width from `onColumnResize`, which fires when the gesture ends. Without a\n   * draft a controlled table simply would not move under the pointer.\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\n  /**\n   * The same draft, in a ref.\n   *\n   * A keyboard resize runs `useMove`'s whole start → move → end cycle inside\n   * one key press, so the end handler would read the state from before the\n   * move. The ref is what it actually settles on; the state exists only to\n   * trigger the render.\n   */\n  const draftColumnWidthsRef = 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    draftColumnWidthsRef.current = {\n      ...(draftColumnWidthsRef.current ?? baseColumnWidths),\n      [key]: Math.round(width),\n    };\n    setDraftColumnWidths(draftColumnWidthsRef.current);\n  });\n\n  // Once at the end: a callback per pixel would be unusable, and persisting\n  // every frame would hammer `localStorage`.\n  const handleColumnResizeEnd = useEvent((key: string) => {\n    const next = draftColumnWidthsRef.current ?? baseColumnWidths;\n\n    if (columnWidthsProp === undefined) {\n      setOwnColumnWidths(next);\n      storage.write({ columnWidths: next });\n    }\n\n    onColumnResize?.(key, next[key], next);\n\n    // The prop (or `ownColumnWidths`) is the source of truth again. A\n    // controlled consumer that ignores the callback reverts, which is what\n    // being controlled means.\n    draftColumnWidthsRef.current = null;\n    setDraftColumnWidths(null);\n  });\n\n  const layout = useTableColumns<T>({\n    columns,\n    containerWidth,\n    columnWidths,\n    leadingColumns,\n    trailingColumns,\n  });\n\n  const hasBulkSelection =\n    bulkActions != null &&\n    bulkActions.length > 0 &&\n    selection.selectedCount > 0;\n\n  const bulkBar = hasBulkSelection ? (\n    <ItemTableBulkBar<T>\n      actions={bulkActions!}\n      placement={bulkBarPlacement}\n      styles={bulkBarStyles}\n    />\n  ) : null;\n\n  const isBulkBarInToolbar = bulkBar != null && bulkBarPlacement === 'toolbar';\n\n  const hasToolbar =\n    toolbar !== undefined ||\n    isSearchable ||\n    filters != null ||\n    actions != null ||\n    onRefresh != null ||\n    isBulkBarInToolbar;\n\n  const toolbarNode = hasToolbar\n    ? toolbar ?? (\n        <ItemTableToolbar\n          isSearchable={isSearchable}\n          filters={filters}\n          // The bar takes the actions group rather than sitting beside it: the\n          // two compete for the same space, and while rows are selected the\n          // bulk actions are what the user is reaching for.\n          actions={isBulkBarInToolbar ? bulkBar : actions}\n          isLoading={isLoading}\n          styles={toolbarStyles}\n          searchStyles={searchStyles}\n          onRefresh={onRefresh}\n        />\n      )\n    : null;\n\n  /**\n   * Pagination that cannot do anything is noise: one page of five rows still\n   * renders \"1–5 of 5\", a page-size selector whose every option shows the same\n   * five rows, and a solitary \"1\" button.\n   *\n   * \"Cannot do anything\" is both conditions together — a single page *and* a\n   * total that even the smallest page size would not split. A 15-row single\n   * page stays, because choosing \"10 / page\" would genuinely paginate it.\n   */\n  const smallestPageSize = pageSizeOptions?.length\n    ? Math.min(...pageSizeOptions)\n    : pageSize;\n\n  const isPaginationUseless =\n    autoHidePagination &&\n    !hasNextPage &&\n    pageInfo.totalPages <= 1 &&\n    total <= smallestPageSize;\n\n  const showPagination = isPaginated && !isPaginationUseless;\n\n  const hasFooter =\n    footer !== undefined ||\n    showPagination ||\n    footerStart != null ||\n    footerCenter != null ||\n    footerEnd != null;\n\n  const footerNode = hasFooter\n    ? footer ?? (\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      )\n    : null;\n\n  const bodyRef = useRef<HTMLTableSectionElement>(null);\n\n  const rowKeys = useMemo(\n    () =>\n      visibleRows.map((row, index) => String(resolvedGetRowKey(row, index))),\n    [visibleRows, resolvedGetRowKey],\n  );\n\n  const handleReorder = useEvent((nextKeys: string[]) => {\n    const byKey = new Map(\n      visibleRows.map((row, index) => [\n        String(resolvedGetRowKey(row, index)),\n        row,\n      ]),\n    );\n\n    onReorder?.(\n      nextKeys,\n      nextKeys\n        .map((key) => byKey.get(key))\n        .filter((row): row is T => row !== undefined),\n    );\n  });\n\n  /**\n   * `DraggableCollection` owns the React Aria drag/drop hooks and hands the two\n   * states down. It is only mounted when reordering is on, so a plain table\n   * pays nothing for it.\n   *\n   * `RowCollection` and the `SelectionManager` from `useTableSelection` satisfy\n   * its structural `state` contract unchanged — both exist even when selection\n   * itself is off.\n   */\n  const renderTable = (\n    dragState?: any,\n    dropState?: any,\n    collectionProps?: Record<string, any>,\n  ) => (\n    <TableView<T>\n      rootRef={rootRef}\n      dragState={dragState}\n      dropState={dropState}\n      collectionProps={collectionProps}\n      bodyRef={bodyRef}\n      qa={qa || 'ItemTable'}\n      rows={visibleRows}\n      // `aria-rowindex` is document-absolute by contract: on page 3 a screen\n      // reader should hear \"row 51 of 240\", not \"row 1 of 25\". Infinite scroll\n      // never offsets — every loaded row is already in `visibleRows`.\n      // `isPaginated` already excludes infinite scroll, where every loaded row\n      // is in `visibleRows` and there is no page to offset by.\n      rowIndexOffset={isPaginated ? (pageInfo.page - 1) * pageSize : 0}\n      totalRowCount={total}\n      getRowKey={resolvedGetRowKey}\n      layout={layout}\n      onScrollerRef={setScrollerEl}\n      size={size}\n      shape={shape}\n      rowHeight={rowHeight}\n      headerHeight={headerHeight}\n      isHeaderHidden={isHeaderHidden}\n      isHeaderSticky={isHeaderSticky}\n      isVirtualized={isVirtualized}\n      virtualizeThreshold={virtualizeThreshold}\n      overscan={overscan}\n      isStriped={isStriped}\n      isRowMoveAnimated={isRowMoveAnimated}\n      isLoading={isLoading}\n      loadingIndicator={loadingIndicator}\n      selection={selection}\n      selectionTooltip={selectionTooltip}\n      rowLink={rowLink}\n      onRowAction={onRowAction}\n      onLoadMore={isInfinite ? onLoadMore : undefined}\n      hasMore={hasMore}\n      isLoadingMore={isLoadingMore}\n      loadMoreMargin={loadMoreMargin}\n      isReorderable={isDragEnabled}\n      isResizable={isResizable}\n      onColumnResize={handleColumnResize}\n      onColumnResizeEnd={handleColumnResizeEnd}\n      rowMenu={resolveRowMenu}\n      rowContextMenu={rowContextMenu}\n      onRowMenuAction={onRowMenuAction}\n      rowMenuTriggerProps={rowMenuTriggerProps}\n      skeletonRowCount={skeletonRowCount}\n      emptyLabel={emptyLabel ?? t('itemTable.noItems', 'No items')}\n      noResultsLabel={\n        noResultsLabel ?? t('itemTable.noResults', 'No results found')\n      }\n      error={error}\n      toolbar={toolbarNode}\n      footer={footerNode}\n      isFiltered={isFiltered ?? isSearching}\n      sortMode={resolvedSortMode}\n      sort={sort}\n      onColumnSort={toggleSort}\n      getRowProps={getRowProps}\n      ariaLabel={ariaLabel}\n      styles={rootStyles}\n      headerStyles={headerStyles}\n      headerCellStyles={headerCellStyles}\n      headerPreset={headerPreset}\n      bodyStyles={bodyStyles}\n      rowStyles={rowStyles}\n      cellStyles={cellStyles}\n      mods={mods}\n      overlay={bulkBarPlacement === 'floating' ? bulkBar : null}\n    />\n  );\n\n  const rowByKeyForDrop = useMemo(() => {\n    const map = new Map<string, T>();\n\n    visibleRows.forEach((row, index) =>\n      map.set(String(resolvedGetRowKey(row, index)), row),\n    );\n\n    return map;\n  }, [visibleRows, resolvedGetRowKey]);\n\n  const handleItemDrop = useEvent((targetKey: Key, draggedKeys: Key[]) => {\n    if (!dropOnRow) return;\n\n    const target = rowByKeyForDrop.get(String(targetKey));\n\n    if (!target) return;\n\n    const dragged = draggedKeys\n      .map((key) => rowByKeyForDrop.get(String(key)))\n      // A row cannot be dropped on itself.\n      .filter((row): row is T => row !== undefined && row !== target);\n\n    if (!dragged.length) return;\n    if (dropOnRow.isAllowed && !dropOnRow.isAllowed(dragged, target)) return;\n\n    void dropOnRow.onDrop(dragged, target);\n  });\n\n  const renderDragPreview = useEvent((keys: Key[]) => (\n    <ItemTableDragPreview<T>\n      rows={keys\n        .map((key) => rowByKeyForDrop.get(String(key)))\n        .filter((row): row is T => row !== undefined)}\n      getItemDragInfo={getItemDragInfo!}\n    />\n  ));\n\n  const shouldAcceptItemDrop = useEvent((targetKey: Key) => {\n    const target = rowByKeyForDrop.get(String(targetKey));\n\n    return target != null && (dropOnRow?.isTarget(target) ?? false);\n  });\n\n  // Dropping onto a row and reordering both need the drag machinery.\n  const isDragEnabled = isReorderable || dropOnRow != null;\n\n  const table = isDragEnabled ? (\n    <DraggableCollection\n      state={{\n        collection: selection.collection,\n        selectionManager: selection.selectionManager as any,\n        disabledKeys: new Set(disabledKeys ?? []),\n      }}\n      // The element that directly contains the rows. React Aria's\n      // `ListDropTargetDelegate` measures the drop position from this element's\n      // children, so pointing it at the table root would leave every drop\n      // unresolvable — the row lifts but never lands.\n      listRef={bodyRef}\n      orderedKeys={rowKeys}\n      orientation=\"vertical\"\n      onReorder={isReorderable ? handleReorder : undefined}\n      onItemDrop={dropOnRow ? handleItemDrop : undefined}\n      shouldAcceptItemDrop={dropOnRow ? shouldAcceptItemDrop : undefined}\n      renderPreview={getItemDragInfo ? renderDragPreview : undefined}\n    >\n      {(dragState, dropState, collectionProps) =>\n        renderTable(dragState, dropState, collectionProps)\n      }\n    </DraggableCollection>\n  ) : (\n    renderTable()\n  );\n\n  // The provider always wraps, so `ItemTable.Search` works from a custom\n  // `toolbar` as well as from the built-in one.\n  return (\n    <ItemTableChromeProvider\n      value={{\n        searchValue,\n        setSearchValue,\n        searchPlaceholder,\n        isLoading,\n        onRefresh,\n        selectedKeys: selection.selectedKeys,\n        selectedRows: selection.selectedRows,\n        selectedCount: selection.selectedCount,\n        clearSelection: selection.clearSelection,\n      }}\n    >\n      {table}\n    </ItemTableChromeProvider>\n  );\n}\n\nconst _ItemTable = Object.assign(\n  forwardRef(ItemTable) as unknown as (<T = any>(\n    props: CubeItemTableProps<T> & { ref?: ForwardedRef<HTMLDivElement> },\n  ) => ReactElement) & { displayName?: string },\n  {\n    /** The table's search input, bound to the table's own state. */\n    Search: ItemTableSearch,\n    /** The default toolbar row, for rebuilding it around extra content. */\n    Toolbar: ItemTableToolbar,\n    /** The selection action bar, for placing it outside the default chrome. */\n    BulkBar: ItemTableBulkBar,\n  },\n);\n\n_ItemTable.displayName = 'ItemTable';\n\nexport { _ItemTable as ItemTable };\n"],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+
+import { CubeTableBulkAction } from "./types.js";
+import { Styles } from "@tenphi/tasty";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/data/ItemTable/ItemTableBulkBar.d.ts
+interface ItemTableBulkBarProps<T = any> {
+  actions: CubeTableBulkAction<T>[];
+  /** @default 'floating' */
+  placement?: 'floating' | 'toolbar';
+  styles?: Styles;
+}
+/**
+ * The action bar shown while rows are selected.
+ *
+ * Reads the selection from context rather than props, so a consumer rebuilding
+ * the toolbar can drop `<ItemTable.BulkBar>` wherever it likes and still have
+ * one owner of the selection.
+ */
+declare function ItemTableBulkBar<T = any>(props: ItemTableBulkBarProps<T>): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { ItemTableBulkBar };
+//# sourceMappingURL=ItemTableBulkBar.d.ts.map