@fluentui/react-table 9.0.0-alpha.1 → 9.0.0-alpha.2

package/CHANGELOG.json

@@ -2,7 +2,138 @@
   "name": "@fluentui/react-table",
   "entries": [
     {
-      "date": "Wed, 03 Aug 2022 16:00:30 GMT",
+      "date": "Thu, 15 Sep 2022 09:44:47 GMT",
+      "tag": "@fluentui/react-table_v9.0.0-alpha.2",
+      "version": "9.0.0-alpha.2",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "851d0fd82f7d802d048be89dc363271f7cf1720a",
+            "comment": "implement `useTable` state hook"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "e79be7955cfeef07aa3377bf123b88800e4af1cc",
+            "comment": "feat: Remove TableCellPrimaryLayout, adds `appearance` prop to TableCellLayout for primary layout"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "b51ebaec4a0681dc71e8f67a28a9d28b051bcba8",
+            "comment": "BREAKING: TableCell layouts are handled by layout components"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "059b48cc66cbeb9c545b60ef842407895cd4e505",
+            "comment": "feat: Implement table cell layout components"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "8f420a1c55f283156b758bda1e7ef0591ec57a78",
+            "comment": "feat: Remove inferred row state and add `rowEnhancer` option"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "cf7b0b6c6941c1b798a57ead0bc67b98e4e0ddbb",
+            "comment": "feat: Implement unstable navigation modes"
+          },
+          {
+            "author": "olfedias@microsoft.com",
+            "package": "@fluentui/react-table",
+            "commit": "e610024474cfe5d45f61501a8b6a21daf4c794a2",
+            "comment": "chore: Update Griffel to latest version"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "02a6a76a3350adfb4fd95cdfc178864801c8e2bf",
+            "comment": "refactor(useTable): selection manager to avoid calling multiple hooks"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "b9b2c4cf2b69e8d5e4b0a8a01fcc8458b1c8efc6",
+            "comment": "feat: Implement `TableSelectionCell`"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "f5398157ebbea5c748d8d7336f18b378a8bdec16",
+            "comment": "refactor: Stop using context selector for Table primitives"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "573289549f9712357c5561057fc24e97f62a6c63",
+            "comment": "feat: autocontrolled `useTable` hook"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "9253171aac6e08d6830361d125d657f21ddfc90a",
+            "comment": "feat: Implement `TableCellActions` and `TablePrimaryCell`"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-table",
+            "comment": "Bump @fluentui/react-aria to v9.2.0",
+            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-table",
+            "comment": "Bump @fluentui/react-checkbox to v9.0.5",
+            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-table",
+            "comment": "Bump @fluentui/react-tabster to v9.1.1",
+            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-table",
+            "comment": "Bump @fluentui/react-theme to v9.1.0",
+            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-table",
+            "comment": "Bump @fluentui/react-utilities to v9.1.0",
+            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-table",
+            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.13",
+            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
+          }
+        ],
+        "none": [
+          {
+            "author": "martinhochel@microsoft.com",
+            "package": "@fluentui/react-table",
+            "commit": "e6cf183695d6d67a24e038c49a876224e5ed35e5",
+            "comment": "chore: update package scaffold"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-table",
+            "commit": "9e604a18ef914090301b4d0cd0b602f646f5719c",
+            "comment": "chore: Add preview warning for Table component"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 03 Aug 2022 16:04:03 GMT",
       "tag": "@fluentui/react-table_v9.0.0-alpha.1",
       "version": "9.0.0-alpha.1",
       "comments": {
@@ -23,19 +154,19 @@
             "author": "beachball",
             "package": "@fluentui/react-table",
             "comment": "Bump @fluentui/react-aria to v9.1.0",
-            "commit": "54bc6105c5c9c9023da35d4670239e44117ed4a5"
+            "commit": "ee4a8be0d0831a6615f878f98db6a97cc61a802d"
           },
           {
             "author": "beachball",
             "package": "@fluentui/react-table",
             "comment": "Bump @fluentui/react-tabster to v9.1.0",
-            "commit": "54bc6105c5c9c9023da35d4670239e44117ed4a5"
+            "commit": "ee4a8be0d0831a6615f878f98db6a97cc61a802d"
           },
           {
             "author": "beachball",
             "package": "@fluentui/react-table",
             "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.12",
-            "commit": "54bc6105c5c9c9023da35d4670239e44117ed4a5"
+            "commit": "ee4a8be0d0831a6615f878f98db6a97cc61a802d"
           }
         ]
       }

package/CHANGELOG.md

@@ -1,21 +1,47 @@
 # Change Log - @fluentui/react-table
 
-This log was last generated on Wed, 03 Aug 2022 16:00:30 GMT and should not be manually modified.
+This log was last generated on Thu, 15 Sep 2022 09:44:47 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## [9.0.0-alpha.2](https://github.com/microsoft/fluentui/tree/@fluentui/react-table_v9.0.0-alpha.2)
+
+Thu, 15 Sep 2022 09:44:47 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-table_v9.0.0-alpha.1..@fluentui/react-table_v9.0.0-alpha.2)
+
+### Changes
+
+- implement `useTable` state hook ([PR #24329](https://github.com/microsoft/fluentui/pull/24329) by lingfangao@hotmail.com)
+- feat: Remove TableCellPrimaryLayout, adds `appearance` prop to TableCellLayout for primary layout ([PR #24789](https://github.com/microsoft/fluentui/pull/24789) by lingfangao@hotmail.com)
+- BREAKING: TableCell layouts are handled by layout components ([PR #24762](https://github.com/microsoft/fluentui/pull/24762) by lingfangao@hotmail.com)
+- feat: Implement table cell layout components ([PR #24773](https://github.com/microsoft/fluentui/pull/24773) by lingfangao@hotmail.com)
+- feat: Remove inferred row state and add `rowEnhancer` option ([PR #24346](https://github.com/microsoft/fluentui/pull/24346) by lingfangao@hotmail.com)
+- feat: Implement unstable navigation modes ([PR #24383](https://github.com/microsoft/fluentui/pull/24383) by lingfangao@hotmail.com)
+- chore: Update Griffel to latest version ([PR #24221](https://github.com/microsoft/fluentui/pull/24221) by olfedias@microsoft.com)
+- refactor(useTable): selection manager to avoid calling multiple hooks ([PR #24377](https://github.com/microsoft/fluentui/pull/24377) by lingfangao@hotmail.com)
+- feat: Implement `TableSelectionCell` ([PR #24252](https://github.com/microsoft/fluentui/pull/24252) by lingfangao@hotmail.com)
+- refactor: Stop using context selector for Table primitives ([PR #24806](https://github.com/microsoft/fluentui/pull/24806) by lingfangao@hotmail.com)
+- feat: autocontrolled `useTable` hook ([PR #24688](https://github.com/microsoft/fluentui/pull/24688) by lingfangao@hotmail.com)
+- feat: Implement `TableCellActions` and `TablePrimaryCell` ([PR #24232](https://github.com/microsoft/fluentui/pull/24232) by lingfangao@hotmail.com)
+- Bump @fluentui/react-aria to v9.2.0 ([PR #24808](https://github.com/microsoft/fluentui/pull/24808) by beachball)
+- Bump @fluentui/react-checkbox to v9.0.5 ([PR #24808](https://github.com/microsoft/fluentui/pull/24808) by beachball)
+- Bump @fluentui/react-tabster to v9.1.1 ([PR #24808](https://github.com/microsoft/fluentui/pull/24808) by beachball)
+- Bump @fluentui/react-theme to v9.1.0 ([PR #24808](https://github.com/microsoft/fluentui/pull/24808) by beachball)
+- Bump @fluentui/react-utilities to v9.1.0 ([PR #24808](https://github.com/microsoft/fluentui/pull/24808) by beachball)
+- Bump @fluentui/react-conformance-griffel to v9.0.0-beta.13 ([PR #24808](https://github.com/microsoft/fluentui/pull/24808) by beachball)
+
 ## [9.0.0-alpha.1](https://github.com/microsoft/fluentui/tree/@fluentui/react-table_v9.0.0-alpha.1)
 
-Wed, 03 Aug 2022 16:00:30 GMT 
+Wed, 03 Aug 2022 16:04:03 GMT 
 [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-table_v9.0.0-alpha.0..@fluentui/react-table_v9.0.0-alpha.1)
 
 ### Changes
 
 - feat: Make sorting more primitive ([PR #24198](https://github.com/microsoft/fluentui/pull/24198) by lingfangao@hotmail.com)
 - feat: Release package in `alpha` ([PR #24182](https://github.com/microsoft/fluentui/pull/24182) by lingfangao@hotmail.com)
-- Bump @fluentui/react-aria to v9.1.0 ([PR #24201](https://github.com/microsoft/fluentui/pull/24201) by beachball)
-- Bump @fluentui/react-tabster to v9.1.0 ([PR #24201](https://github.com/microsoft/fluentui/pull/24201) by beachball)
-- Bump @fluentui/react-conformance-griffel to v9.0.0-beta.12 ([PR #24201](https://github.com/microsoft/fluentui/pull/24201) by beachball)
+- Bump @fluentui/react-aria to v9.1.0 ([PR #24131](https://github.com/microsoft/fluentui/pull/24131) by beachball)
+- Bump @fluentui/react-tabster to v9.1.0 ([PR #24131](https://github.com/microsoft/fluentui/pull/24131) by beachball)
+- Bump @fluentui/react-conformance-griffel to v9.0.0-beta.12 ([PR #24131](https://github.com/microsoft/fluentui/pull/24131) by beachball)
 
 ## [9.0.0-alpha.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-table_v9.0.0-alpha.0)
 

package/dist/index.d.ts

@@ -1,17 +1,29 @@
 /// <reference types="react" />
 
 import { ARIAButtonSlotProps } from '@fluentui/react-aria';
+import type { Checkbox } from '@fluentui/react-checkbox';
+import type { CheckboxProps } from '@fluentui/react-checkbox';
 import type { ComponentProps } from '@fluentui/react-utilities';
 import type { ComponentState } from '@fluentui/react-utilities';
-import { ContextSelector } from '@fluentui/react-context-selector';
-import { FC } from 'react';
 import type { ForwardRefComponent } from '@fluentui/react-utilities';
-import { Provider } from 'react';
-import { ProviderProps } from 'react';
 import * as React_2 from 'react';
 import type { Slot } from '@fluentui/react-utilities';
 import type { SlotClassNames } from '@fluentui/react-utilities';
 
+export declare interface ColumnDefinition<TItem> {
+    columnId: ColumnId;
+    compare?: (a: TItem, b: TItem) => number;
+}
+
+export declare type ColumnId = string | number;
+
+declare type OnSelectionChangeCallback = (selectedItems: Set<RowId>) => void;
+
+declare type OnSortChangeCallback = (state: {
+    sortColumn: ColumnId | undefined;
+    sortDirection: SortDirection;
+}) => void;
+
 /**
  * Render the final JSX of Table
  */
@@ -27,6 +39,16 @@ export declare const renderTableBody_unstable: (state: TableBodyState) => JSX.El
  */
 export declare const renderTableCell_unstable: (state: TableCellState) => JSX.Element;
 
+/**
+ * Render the final JSX of TableCellActions
+ */
+export declare const renderTableCellActions_unstable: (state: TableCellActionsState) => JSX.Element;
+
+/**
+ * Render the final JSX of TableCellLayout
+ */
+export declare const renderTableCellLayout_unstable: (state: TableCellLayoutState) => JSX.Element;
+
 /**
  * Render the final JSX of TableHeader
  */
@@ -42,12 +64,37 @@ export declare const renderTableHeaderCell_unstable: (state: TableHeaderCellStat
  */
 export declare const renderTableRow_unstable: (state: TableRowState) => JSX.Element;
 
+/**
+ * Render the final JSX of TableSelectionCell
+ */
+export declare const renderTableSelectionCell_unstable: (state: TableSelectionCellState) => JSX.Element;
+
+declare type RowEnhancer<TItem, TRowState extends RowState<TItem> = RowState<TItem>> = (row: RowState<TItem>, state: {
+    selection: TableSelectionState;
+    sort: TableSortState;
+}) => TRowState;
+
+export declare type RowId = string | number;
+
+export declare interface RowState<TItem> {
+    /**
+     * User provided data
+     */
+    item: TItem;
+    /**
+     * The row id, defaults to index position in the collection
+     */
+    rowId: RowId;
+}
+
+declare type SelectionMode_2 = 'single' | 'multiselect';
+
 export declare type SortDirection = 'ascending' | 'descending';
 
-declare type SortState = {
-    sortColumn: string | undefined;
-    sortDirection: 'ascending' | 'descending';
-};
+declare interface SortState {
+    sortColumn: ColumnId | undefined;
+    sortDirection: SortDirection;
+}
 
 /**
  * Table component - TODO: add more docs
@@ -82,10 +129,70 @@ export declare type TableBodyState = ComponentState<TableBodySlots>;
  */
 export declare const TableCell: ForwardRefComponent<TableCellProps>;
 
+/**
+ * TableCellActions component - TODO: add more docs
+ */
+export declare const TableCellActions: ForwardRefComponent<TableCellActionsProps>;
+
+export declare const tableCellActionsClassNames: SlotClassNames<TableCellActionsSlots>;
+
+/**
+ * TableCellActions Props
+ */
+export declare type TableCellActionsProps = ComponentProps<TableCellActionsSlots> & {};
+
+export declare type TableCellActionsSlots = {
+    root: Slot<'div'>;
+};
+
+/**
+ * State used in rendering TableCellActions
+ */
+export declare type TableCellActionsState = ComponentState<TableCellActionsSlots>;
+
 export declare const tableCellClassName = "fui-TableCell";
 
 export declare const tableCellClassNames: SlotClassNames<TableCellSlots>;
 
+/**
+ * TableCellLayout component - TODO: add more docs
+ */
+export declare const TableCellLayout: ForwardRefComponent<TableCellLayoutProps>;
+
+export declare const tableCellLayoutClassNames: SlotClassNames<TableCellLayoutSlots>;
+
+/**
+ * TableCellLayout Props
+ */
+export declare type TableCellLayoutProps = ComponentProps<Partial<TableCellLayoutSlots>> & {
+    appearance?: 'primary';
+};
+
+export declare type TableCellLayoutSlots = {
+    root: Slot<'div'>;
+    /**
+     * Slot for an icon or other visual element
+     */
+    media: Slot<'span'>;
+    /**
+     * Main text for the table cell. Children of the root slot are automatically rendered here
+     */
+    main: Slot<'span'>;
+    /**
+     * Secondary text that describes or complements the main text
+     */
+    description: Slot<'span'>;
+    /**
+     * A layout wrapper for the main and description slots
+     */
+    wrapper: Slot<'div'>;
+};
+
+/**
+ * State used in rendering TableCellLayout
+ */
+export declare type TableCellLayoutState = ComponentState<TableCellLayoutSlots> & Pick<TableCellLayoutProps, 'appearance'>;
+
 /**
  * TableCell Props
  */
@@ -93,7 +200,6 @@ export declare type TableCellProps = ComponentProps<TableCellSlots> & {};
 
 export declare type TableCellSlots = {
     root: Slot<'td', 'div'>;
-    media?: Slot<'span'>;
 };
 
 /**
@@ -105,7 +211,7 @@ export declare const tableClassName = "fui-Table";
 
 export declare const tableClassNames: SlotClassNames<TableSlots>;
 
-export declare const TableContextProvider: Provider<TableContextValue | undefined> & FC<ProviderProps<TableContextValue | undefined>>;
+export declare const TableContextProvider: React_2.Provider<TableContextValue | undefined>;
 
 export declare type TableContextValue = {
     size: 'small' | 'smaller' | 'medium';
@@ -175,16 +281,7 @@ export declare type TableHeaderState = ComponentState<TableHeaderSlots>;
 /**
  * Table Props
  */
-export declare type TableProps = ComponentProps<TableSlots> & {} & Partial<TableContextValue> & {
-    /**
-     * Called when the sorted column changes
-     */
-    onSortColumnChange?: (e: React_2.MouseEvent<HTMLElement> | React_2.KeyboardEvent<HTMLElement>, data: {
-        sortState: SortState;
-    }) => void;
-    sortState?: SortState;
-    defaultSortState?: SortState;
-};
+export declare type TableProps = ComponentProps<TableSlots> & Partial<TableContextValue>;
 
 /**
  * TableRow component - TODO: add more docs
@@ -211,15 +308,129 @@ export declare type TableRowState = ComponentState<TableRowSlots> & {
     size: TableState['size'];
 };
 
+/**
+ * TableSelectionCell component - TODO: add more docs
+ */
+export declare const TableSelectionCell: ForwardRefComponent<TableSelectionCellProps>;
+
+export declare const tableSelectionCellClassNames: SlotClassNames<TableSelectionCellSlots>;
+
+/**
+ * TableSelectionCell Props
+ */
+export declare type TableSelectionCellProps = ComponentProps<Partial<Omit<TableSelectionCellSlots, 'media'>>> & {
+    /**
+     * A table can have two kinds of selection modes
+     */
+    type?: 'checkbox' | 'radio';
+    checked?: CheckboxProps['checked'];
+};
+
+export declare type TableSelectionCellSlots = {
+    /**
+     * Selection indicator if selection type is checkbox
+     */
+    checkboxIndicator: Slot<typeof Checkbox>;
+    /**
+     * Selection indicator if selection type is radio
+     */
+    radioIndicator: Slot<'span'>;
+} & Pick<TableCellSlots, 'root'>;
+
+/**
+ * State used in rendering TableSelectionCell
+ */
+export declare type TableSelectionCellState = ComponentState<TableSelectionCellSlots> & Pick<Required<TableSelectionCellProps>, 'type' | 'checked'>;
+
+export declare interface TableSelectionState {
+    /**
+     * Clears all selected rows
+     */
+    clearRows: () => void;
+    /**
+     * Selects single row
+     */
+    selectRow: (rowId: RowId) => void;
+    /**
+     * De-selects single row
+     */
+    deselectRow: (rowId: RowId) => void;
+    /**
+     * Toggle selection of all rows
+     */
+    toggleAllRows: () => void;
+    /**
+     * Toggle selection of single row
+     */
+    toggleRow: (rowId: RowId) => void;
+    /**
+     * Collection of row ids corresponding to selected rows
+     */
+    selectedRows: RowId[];
+    /**
+     * Whether all rows are selected
+     */
+    allRowsSelected: boolean;
+    /**
+     * Whether some rows are selected
+     */
+    someRowsSelected: boolean;
+    /**
+     * Checks if a given rowId is selected
+     */
+    isRowSelected: (rowId: RowId) => boolean;
+}
+
 export declare type TableSlots = {
     root: Slot<'table', 'div'>;
 };
 
+export declare interface TableSortState {
+    /**
+     * Current sort direction
+     */
+    sortDirection: SortDirection;
+    /**
+     * Column id of the currently sorted column
+     */
+    sortColumn: ColumnId | undefined;
+    /**
+     * Set the sort direction for the specified column
+     */
+    setColumnSort: (columnId: ColumnId, sortDirection: SortDirection) => void;
+    /**
+     * Toggles the sort direction for specified column
+     */
+    toggleColumnSort: (columnId: ColumnId) => void;
+    /**
+     * Returns the sort direction if a column is sorted,
+     * returns undefined if the column is not sorted
+     */
+    getSortDirection: (columnId: ColumnId) => SortDirection | undefined;
+}
+
 /**
  * State used in rendering Table
  */
 export declare type TableState = ComponentState<TableSlots> & Pick<Required<TableProps>, 'size' | 'noNativeElements'> & TableContextValue;
 
+declare interface TableState_2<TItem, TRowState extends RowState<TItem> = RowState<TItem>> {
+    /**
+     * The row data for rendering
+     */
+    rows: TRowState[];
+    /**
+     * State and actions to manage row selection
+     */
+    selection: TableSelectionState;
+    /**
+     * State and actions to manage row sorting
+     */
+    sort: TableSortState;
+}
+
+export declare function useTable<TItem, TRowState extends RowState<TItem> = RowState<TItem>>(options: UseTableOptions<TItem, TRowState>): TableState_2<TItem, TRowState>;
+
 /**
  * Create the state required to render Table.
  *
@@ -258,12 +469,44 @@ export declare const useTableBodyStyles_unstable: (state: TableBodyState) => Tab
  */
 export declare const useTableCell_unstable: (props: TableCellProps, ref: React_2.Ref<HTMLElement>) => TableCellState;
 
+/**
+ * Create the state required to render TableCellActions.
+ *
+ * The returned state can be modified with hooks such as useTableCellActionsStyles_unstable,
+ * before being passed to renderTableCellActions_unstable.
+ *
+ * @param props - props from this instance of TableCellActions
+ * @param ref - reference to root HTMLElement of TableCellActions
+ */
+export declare const useTableCellActions_unstable: (props: TableCellActionsProps, ref: React_2.Ref<HTMLElement>) => TableCellActionsState;
+
+/**
+ * Apply styling to the TableCellActions slots based on the state
+ */
+export declare const useTableCellActionsStyles_unstable: (state: TableCellActionsState) => TableCellActionsState;
+
+/**
+ * Create the state required to render TableCellLayout.
+ *
+ * The returned state can be modified with hooks such as useTableCellLayoutStyles_unstable,
+ * before being passed to renderTableCellLayout_unstable.
+ *
+ * @param props - props from this instance of TableCellLayout
+ * @param ref - reference to root HTMLElement of TableCellLayout
+ */
+export declare const useTableCellLayout_unstable: (props: TableCellLayoutProps, ref: React_2.Ref<HTMLElement>) => TableCellLayoutState;
+
+/**
+ * Apply styling to the TableCellLayout slots based on the state
+ */
+export declare const useTableCellLayoutStyles_unstable: (state: TableCellLayoutState) => TableCellLayoutState;
+
 /**
  * Apply styling to the TableCell slots based on the state
  */
 export declare const useTableCellStyles_unstable: (state: TableCellState) => TableCellState;
 
-export declare const useTableContext: <T>(selector: ContextSelector<TableContextValue, T>) => T;
+export declare const useTableContext: () => TableContextValue;
 
 /**
  * Create the state required to render TableHeader.
@@ -297,6 +540,38 @@ export declare const useTableHeaderCellStyles_unstable: (state: TableHeaderCellS
  */
 export declare const useTableHeaderStyles_unstable: (state: TableHeaderState) => TableHeaderState;
 
+export declare interface UseTableOptions<TItem, TRowState extends RowState<TItem> = RowState<TItem>> {
+    columns: ColumnDefinition<TItem>[];
+    items: TItem[];
+    selectionMode?: SelectionMode_2;
+    /**
+     * Used in uncontrolled mode to set initial selected rows on mount
+     */
+    defaultSelectedRows?: Set<RowId>;
+    /**
+     * Used to control row selection
+     */
+    selectedRows?: Set<RowId>;
+    /**
+     * Called when selection changes
+     */
+    onSelectionChange?: OnSelectionChangeCallback;
+    /**
+     * Used to control sorting
+     */
+    sortState?: SortState;
+    /**
+     * Used in uncontrolled mode to set initial sort column and direction on mount
+     */
+    defaultSortState?: SortState;
+    /**
+     * Called when sort changes
+     */
+    onSortChange?: OnSortChangeCallback;
+    getRowId?: (item: TItem) => RowId;
+    rowEnhancer?: RowEnhancer<TItem, TRowState>;
+}
+
 /**
  * Create the state required to render TableRow.
  *
@@ -313,6 +588,22 @@ export declare const useTableRow_unstable: (props: TableRowProps, ref: React_2.R
  */
 export declare const useTableRowStyles_unstable: (state: TableRowState) => TableRowState;
 
+/**
+ * Create the state required to render TableSelectionCell.
+ *
+ * The returned state can be modified with hooks such as useTableSelectionCellStyles_unstable,
+ * before being passed to renderTableSelectionCell_unstable.
+ *
+ * @param props - props from this instance of TableSelectionCell
+ * @param ref - reference to root HTMLElement of TableSelectionCell
+ */
+export declare const useTableSelectionCell_unstable: (props: TableSelectionCellProps, ref: React_2.Ref<HTMLElement>) => TableSelectionCellState;
+
+/**
+ * Apply styling to the TableSelectionCell slots based on the state
+ */
+export declare const useTableSelectionCellStyles_unstable: (state: TableSelectionCellState) => TableSelectionCellState;
+
 /**
  * Apply styling to the Table slots based on the state
  */

package/lib/TableCellActions.js

@@ -0,0 +1,2 @@
+export * from './components/TableCellActions/index';
+//# sourceMappingURL=TableCellActions.js.map

package/lib/TableCellActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableCellActions.js","sourceRoot":"../src/","sources":["TableCellActions.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC","sourcesContent":["export * from './components/TableCellActions/index';\n"]}

package/lib/TableCellLayout.js

@@ -0,0 +1,2 @@
+export * from './components/TableCellLayout/index';
+//# sourceMappingURL=TableCellLayout.js.map

package/lib/TableCellLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableCellLayout.js","sourceRoot":"../src/","sources":["TableCellLayout.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC","sourcesContent":["export * from './components/TableCellLayout/index';\n"]}

package/lib/TableCellPrimaryLayout.js

@@ -0,0 +1,2 @@
+export * from './components/TableCellLayout/index';
+//# sourceMappingURL=TableCellPrimaryLayout.js.map

package/lib/TableCellPrimaryLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableCellPrimaryLayout.js","sourceRoot":"../src/","sources":["TableCellPrimaryLayout.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC","sourcesContent":["export * from './components/TableCellLayout/index';\n"]}

package/lib/TableSelectionCell.js

@@ -0,0 +1,2 @@
+export * from './components/TableSelectionCell/index';
+//# sourceMappingURL=TableSelectionCell.js.map

package/lib/TableSelectionCell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableSelectionCell.js","sourceRoot":"../src/","sources":["TableSelectionCell.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC","sourcesContent":["export * from './components/TableSelectionCell/index';\n"]}