@omniviewdev/base-ui 0.4.3 → 0.5.0

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import { Checkbox as Checkbox_2 } from '@base-ui/react/checkbox';
 import { CheckboxGroup as CheckboxGroup_2 } from '@base-ui/react/checkbox-group';
 import { ClipboardEvent as ClipboardEvent_2 } from 'react';
 import { ColumnDef as ColumnDef_2 } from '@tanstack/react-table';
+import { ColumnFiltersState } from '@tanstack/react-table';
 import { ColumnOrderState } from '@tanstack/react-table';
 import { ColumnPinningState } from '@tanstack/react-table';
 import { ColumnSizingState } from '@tanstack/react-table';
@@ -42,6 +43,7 @@ import { FieldLabelProps } from '@base-ui/react';
 import { FieldsetHTMLAttributes } from 'react';
 import { FocusEvent as FocusEvent_2 } from 'react';
 import { ForwardRefExoticComponent } from 'react';
+import { GroupingState } from '@tanstack/react-table';
 import { HTMLAttributes } from 'react';
 import { ImgHTMLAttributes } from 'react';
 import { Input as Input_2 } from '@base-ui/react/input';
@@ -1384,6 +1386,7 @@ export declare const DataTable: DataTableCompound;
 declare const DataTableBody: ForwardRefExoticComponent<DataTableBodyProps & RefAttributes<HTMLTableSectionElement>>;
 
 export declare interface DataTableBodyProps extends HTMLAttributes<HTMLTableSectionElement> {
+    /** Use DataTable.ExpansionToggle, or mark a custom disclosure with data-ov-expansion-toggle="". */
     renderExpandedRow?: (row: unknown) => ReactNode;
 }
 
@@ -1403,10 +1406,12 @@ declare type DataTableCompound = typeof DataTableRoot & {
     Pagination: typeof DataTablePagination;
     Empty: typeof DataTableEmpty;
     Loading: typeof DataTableLoading;
+    ExpansionToggle: typeof DataTableExpansionToggle;
 };
 
 declare const DataTableContainer: ForwardRefExoticComponent<DataTableContainerProps & RefAttributes<HTMLDivElement>>;
 
+/** Supply aria-label/aria-labelledby to name the viewport focus fallback. */
 export declare interface DataTableContainerProps extends HTMLAttributes<HTMLDivElement> {
     height?: number | string;
     maxHeight?: number | string;
@@ -1428,6 +1433,17 @@ export declare interface DataTableEmptyProps extends HTMLAttributes<HTMLDivEleme
     description?: string;
 }
 
+/** Native Tab/Enter/Space behavior; does not turn the table into a grid. */
+declare function DataTableExpansionToggle<TData>({ row, label, getAccessibleLabel, className, children, disabled, onClick, ...props }: DataTableExpansionToggleProps<TData>): JSX.Element;
+
+declare interface DataTableExpansionToggleProps<TData> extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'aria-label' | 'aria-expanded'> {
+    row: Row<TData>;
+    /** Row-specific accessible name, e.g. the displayed resource name. */
+    label: string;
+    /** Localize the complete accessible name; defaults to English Expand/Collapse plus label. */
+    getAccessibleLabel?: (expanded: boolean, label: string) => string;
+}
+
 export declare interface DataTableFeatures {
     sorting?: boolean;
     filtering?: boolean;
@@ -1475,25 +1491,27 @@ export declare interface DataTableToolbarProps extends HTMLAttributes<HTMLDivEle
     searchPlaceholder?: string;
 }
 
-declare const DataTableVirtualBody: ForwardRefExoticComponent<DataTableVirtualBodyProps & RefAttributes<HTMLTableSectionElement>>;
+declare const DataTableVirtualBody: <TData = unknown>(props: DataTableVirtualBodyProps<TData> & RefAttributes<HTMLTableSectionElement>) => ReactElement | null;
 
-export declare interface DataTableVirtualBodyProps extends HTMLAttributes<HTMLTableSectionElement> {
+export declare interface DataTableVirtualBodyProps<TData = unknown> extends HTMLAttributes<HTMLTableSectionElement> {
     estimateRowSize?: number;
     overscan?: number;
-    /**
-     * When true, skips dynamic row measurement via `getBoundingClientRect`.
-     * Use this when all rows have the same height (set via `estimateRowSize`)
-     * to avoid forced reflow on mount — a significant perf win for large tables.
-     */
+    /** Fixed parent-row height only. Expanded content is always dynamically measured. */
     fixedRowHeight?: boolean;
-    /** Called when a row is clicked. Not called if a `getRowProps` onClick prevents default. */
-    onRowClick?: (row: Row<any>, event: MouseEvent_2<HTMLTableRowElement>) => void;
+    /** Estimate for an unmeasured detail slot; actual asynchronous height is observed. */
+    estimateExpandedRowSize?: number;
     /**
-     * Extra props for each `<tr>` (className, aria/data attributes, handlers).
-     * Positioning styles and data attributes owned by the table take precedence.
-     * Memoize it (e.g. `useCallback`): a new function re-renders every row.
+     * Same original-data slot as Body. Children mount only while expanded AND in
+     * the virtual range. Retain query/cache ownership outside this component if
+     * it must survive scrolling away. Collapse always removes the slot.
+     * Use DataTable.ExpansionToggle for the disclosure. Custom disclosure buttons
+     * need data-ov-expansion-toggle="" for parent-focus recovery after collapse.
      */
-    getRowProps?: (row: Row<any>) => HTMLAttributes<HTMLTableRowElement>;
+    renderExpandedRow?: (original: TData) => ReactNode;
+    /** Plain-cell pointer convenience; expose equivalent actions in native controls. */
+    onRowClick?: (row: Row<TData>, event: MouseEvent_2<HTMLTableRowElement>) => void;
+    /** Internal positioning and measurement attributes take precedence. */
+    getRowProps?: (row: Row<TData>) => HTMLAttributes<HTMLTableRowElement>;
 }
 
 /**
@@ -4639,7 +4657,7 @@ export declare function useCommandListItem(store: CommandListStore, key: Key_2):
 
 export declare function useCommandListStoreContext(): CommandListStore;
 
-export declare function useDataTable<TData = any>(options: UseDataTableOptions<TData>): Table_2<TData>;
+export declare function useDataTable<TData = unknown>(options: UseDataTableOptions<TData>): Table_2<TData>;
 
 export declare function useDataTableContext(): DataTableContextValue;
 
@@ -4648,15 +4666,24 @@ export declare interface UseDataTableOptions<TData> {
     columns: ColumnDef_2<TData, unknown>[];
     features?: DataTableFeatures;
     initialState?: Partial<TableState>;
+    /** Controlled slices override internal state. Callbacks request host edits. */
+    state?: Partial<TableState>;
     getRowId?: (row: TData, index: number) => string;
     getSubRows?: (row: TData) => TData[] | undefined;
     getRowCanExpand?: (row: {
         original: TData;
         depth: number;
     }) => boolean;
+    getRowCanSelect?: (row: {
+        original: TData;
+        depth: number;
+    }) => boolean;
     persistenceKey?: string;
     onRowSelectionChange?: (selection: RowSelectionState) => void;
     onSortingChange?: (sorting: SortingState) => void;
+    onGlobalFilterChange?: (filter: string) => void;
+    onColumnFiltersChange?: (filters: ColumnFiltersState) => void;
+    onGroupingChange?: (grouping: GroupingState) => void;
     onColumnVisibilityChange?: (visibility: VisibilityState) => void;
     onColumnOrderChange?: (order: ColumnOrderState) => void;
     onColumnSizingChange?: (sizing: ColumnSizingState) => void;
@@ -4669,6 +4696,10 @@ export declare interface UseDataTableOptions<TData> {
     manualSorting?: boolean;
     manualFiltering?: boolean;
     manualPagination?: boolean;
+    /** Host-prepared groups/subrows are never regrouped in the browser. */
+    manualGrouping?: boolean;
+    manualExpanding?: boolean;
+    rowCount?: number;
     pageCount?: number;
     globalFilterFn?: 'auto' | 'includesString' | 'includesStringSensitive';
 }