@react-types/table 3.13.5 → 3.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-types/table",
-  "version": "3.13.5",
+  "version": "3.14.0",
   "description": "Spectrum UI components in React",
   "license": "Apache-2.0",
   "types": "src/index.d.ts",
@@ -9,14 +9,17 @@
     "url": "https://github.com/adobe/react-spectrum"
   },
   "dependencies": {
-    "@react-types/grid": "^3.3.7",
-    "@react-types/shared": "^3.33.0"
+    "@react-spectrum/table": "^3.18.0",
+    "@react-stately/table": "^3.16.0",
+    "@react-types/shared": "^3.34.0"
   },
   "peerDependencies": {
-    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
+    "@react-spectrum/provider": "^3.0.0",
+    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1",
+    "react-dom": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0-rc.1"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "66e51757606b43a89ed02c574ca24517323a2ab9"
+  "gitHead": "a6999bdf494a2e9c0381a5881908328bdd22ddae"
 }

package/src/index.d.ts

@@ -10,38 +10,12 @@
  * governing permissions and limitations under the License.
  */
 
-import {AriaLabelingProps, AsyncLoadable, DOMProps, Key, LinkDOMProps, LoadingState, MultipleSelection, Sortable, SpectrumSelectionProps, StyleProps} from '@react-types/shared';
-import {GridCollection, GridNode} from '@react-types/grid';
-import {JSX, ReactElement, ReactNode} from 'react';
+import {AriaLabelingProps, DOMProps, Key, SpectrumSelectionProps, StyleProps} from '@react-types/shared';
+import {ColumnSize, TableProps} from '@react-stately/table';
+import {JSX} from 'react';
 
-/** Widths that result in a constant pixel value for the same Table width. */
-export type ColumnStaticSize = number | `${number}` | `${number}%`; // match regex: /^(\d+)(?=%$)/
-/**
- * Widths that change size in relation to the remaining space and in ratio to other dynamic columns.
- * All numbers must be integers and greater than 0.
- * FR units take up remaining, if any, space in the table.
- */
-export type ColumnDynamicSize = `${number}fr`; // match regex: /^(\d+)(?=fr$)/
-/** All possible sizes a column can be assigned. */
-export type ColumnSize = ColumnStaticSize | ColumnDynamicSize;
-
-export interface TableProps<T> extends MultipleSelection, Sortable {
-  /** The elements that make up the table. Includes the TableHeader, TableBody, Columns, and Rows. */
-  children: [ReactElement<TableHeaderProps<T>>, ReactElement<TableBodyProps<T>>],
-  /** A list of row keys to disable. */
-  disabledKeys?: Iterable<Key>,
-  /**
-   * Whether pressing the escape key should clear selection in the table or not.
-   *
-   * Most experiences should not modify this option as it eliminates a keyboard user's ability to
-   * easily clear selection. Only use if the escape key is being handled externally or should not
-   * trigger selection clearing contextually.
-   * @default 'clearSelection'
-   */
-  escapeKeyBehavior?: 'clearSelection' | 'none',
-  /** Whether selection should occur on press up instead of press down. */
-  shouldSelectOnPressUp?: boolean
-}
+export {TableProps, ColumnStaticSize, ColumnDynamicSize, ColumnSize, TableHeaderProps, ColumnElement, ColumnRenderer, ColumnProps, RowElement, TableBodyProps, RowProps, CellProps, CellElement, CellRenderer, ITableCollection as TableCollection} from '@react-stately/table';
+export {SpectrumColumnProps} from '@react-spectrum/table';
 
 /**
  * @deprecated - use SpectrumTableProps from '@adobe/react-spectrum' instead.
@@ -79,109 +53,3 @@ export interface SpectrumTableProps<T> extends TableProps<T>, SpectrumSelectionP
    */
   onResizeEnd?: (widths: Map<Key, ColumnSize>) => void
 }
-
-export interface TableHeaderProps<T> {
-  /** A list of table columns. */
-  columns?: T[],
-  /** A list of `Column(s)` or a function. If the latter, a list of columns must be provided using the `columns` prop. */
-  children: ColumnElement<T> | ColumnElement<T>[] | ColumnRenderer<T>
-}
-
-type ColumnElement<T> = ReactElement<ColumnProps<T>>;
-type ColumnRenderer<T> = (item: T) => ColumnElement<T>;
-export interface ColumnProps<T> {
-  /** Rendered contents of the column if `children` contains child columns. */
-  title?: ReactNode,
-  /** Static child columns or content to render as the column header. */
-  children: ReactNode | ColumnElement<T> | ColumnElement<T>[],
-  /** A list of child columns used when dynamically rendering nested child columns. */
-  childColumns?: T[],
-  /** The width of the column. */
-  width?: ColumnSize | null,
-  /** The minimum width of the column. */
-  minWidth?: ColumnStaticSize | null,
-  /** The maximum width of the column. */
-  maxWidth?: ColumnStaticSize | null,
-  /** The default width of the column. */
-  defaultWidth?: ColumnSize | null,
-  /** Whether the column allows resizing. */
-  allowsResizing?: boolean,
-  /** Whether the column allows sorting. */
-  allowsSorting?: boolean,
-  /** Whether a column is a [row header](https://www.w3.org/TR/wai-aria-1.1/#rowheader) and should be announced by assistive technology during row navigation. */
-  isRowHeader?: boolean,
-  /** A string representation of the column's contents, used for accessibility announcements. */
-  textValue?: string
-}
-
-// TODO: how to support these in CollectionBuilder...
-export interface SpectrumColumnProps<T> extends ColumnProps<T> {
-  /**
-   * The alignment of the column's contents relative to its allotted width.
-   * @default 'start'
-   */
-  align?: 'start' | 'center' | 'end',
-  // /** Whether the column should stick to the viewport when scrolling. */
-  // isSticky?: boolean, // shouldStick?? Not implemented yet?
-  /** Whether the column should render a divider between it and the next column. */
-  showDivider?: boolean,
-  /**
-   * Whether the column should hide its header text. A tooltip with the column's header text
-   * will be displayed when the column header is focused instead. Note that this prop is specifically for columns
-   * that contain ActionButtons in place of text content.
-   */
-  hideHeader?: boolean
-}
-
-export type RowElement<T> = ReactElement<RowProps<T>>;
-export interface TableBodyProps<T> extends Omit<AsyncLoadable, 'isLoading'> {
-  /** The contents of the table body. Supports static items or a function for dynamic rendering. */
-  children: RowElement<T> | RowElement<T>[] | ((item: T) => RowElement<T>),
-  /** A list of row objects in the table body used when dynamically rendering rows. */
-  items?: Iterable<T>,
-  /** The current loading state of the table. */
-  loadingState?: LoadingState
-}
-
-export interface RowProps<T> extends LinkDOMProps {
-  /**
-   * A list of child item objects used when dynamically rendering row children. Requires the feature flag to be
-   * enabled along with UNSTABLE_allowsExpandableRows, see https://react-spectrum.adobe.com/react-spectrum/TableView.html#expandable-rows.
-   * @version alpha
-   * @private
-   */
-  UNSTABLE_childItems?: Iterable<T>,
-  // TODO: update when async loading is supported for expandable rows
-  // /** Whether this row has children, even if not loaded yet. */
-  // hasChildItems?: boolean,
-  /** Rendered contents of the row or row child items. */
-  children: CellElement | CellElement[] | CellRenderer,
-  /** A string representation of the row's contents, used for features like typeahead. */
-  textValue?: string // ???
-}
-
-export interface CellProps {
-  /** The contents of the cell. */
-  children: ReactNode,
-  /** A string representation of the cell's contents, used for features like typeahead. */
-  textValue?: string,
-  /** Indicates how many columns the data cell spans. */
-  colSpan?: number
-}
-
-export type CellElement = ReactElement<CellProps>;
-export type CellRenderer = (columnKey: Key) => CellElement;
-
-export interface TableCollection<T> extends GridCollection<T> {
-  // TODO perhaps elaborate on this? maybe not clear enough, essentially returns the table header rows (e.g. in a tiered headers table, will return the nodes containing the top tier column, next tier, etc)
-  /** A list of header row nodes in the table. */
-  headerRows: GridNode<T>[],
-  /** A list of column nodes in the table. */
-  columns: GridNode<T>[],
-  /** A set of column keys that serve as the [row header](https://www.w3.org/TR/wai-aria-1.1/#rowheader). */
-  rowHeaderColumnKeys: Set<Key>,
-  /** The node that makes up the header of the table. */
-  head?: GridNode<T>,
-  /** The node that makes up the body of the table. */
-  body: GridNode<T>
-}