@skdx/react 0.32.0 → 0.34.0

package/dist/table/TableTreeTrigger.d.cts

@@ -0,0 +1,17 @@
+import type * as React from 'react';
+import type { TableTreeTriggerProps } from './types.cjs';
+/**
+ * Disclosure button in a tree parent's first cell that reveals its child rows, drawing a chevron by default.
+ *
+ * @example
+ * ```tsx
+ * <TableCell>
+ *   <TableTreeTrigger rowId={row.id} aria-label={`Children of ${row.name}`} />
+ *   {row.name}
+ * </TableCell>
+ * ```
+ */
+export declare const TableTreeTrigger: {
+    ({ rowId, ref: forwardedRef, ...props }: TableTreeTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/table/TableTreeTrigger.d.ts

@@ -0,0 +1,17 @@
+import type * as React from 'react';
+import type { TableTreeTriggerProps } from './types.js';
+/**
+ * Disclosure button in a tree parent's first cell that reveals its child rows, drawing a chevron by default.
+ *
+ * @example
+ * ```tsx
+ * <TableCell>
+ *   <TableTreeTrigger rowId={row.id} aria-label={`Children of ${row.name}`} />
+ *   {row.name}
+ * </TableCell>
+ * ```
+ */
+export declare const TableTreeTrigger: {
+    ({ rowId, ref: forwardedRef, ...props }: TableTreeTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/table/index.d.cts

@@ -1,4 +1,4 @@
 export { Table, useTableContext } from './Table.cjs';
 export { TableRow } from './TableRow.cjs';
 export { TableCell } from './TableCell.cjs';
-export type { TableColumn, TableColumnWidths, TableContextValue, TableProps, TableRowProps, TableCellProps, TableSort, TableSortState, TableFilterState, SortDirection, TableSelectionMode, } from './types.cjs';
+export type { TableColumn, TableColumnPins, TableColumnWidths, TableContextValue, TableProps, TableRowProps, TableCellProps, TableSort, TableSortState, TableFilterState, SortDirection, TableSelectionMode, } from './types.cjs';

package/dist/table/index.d.ts

@@ -1,4 +1,4 @@
 export { Table, useTableContext } from './Table.js';
 export { TableRow } from './TableRow.js';
 export { TableCell } from './TableCell.js';
-export type { TableColumn, TableColumnWidths, TableContextValue, TableProps, TableRowProps, TableCellProps, TableSort, TableSortState, TableFilterState, SortDirection, TableSelectionMode, } from './types.js';
+export type { TableColumn, TableColumnPins, TableColumnWidths, TableContextValue, TableProps, TableRowProps, TableCellProps, TableSort, TableSortState, TableFilterState, SortDirection, TableSelectionMode, } from './types.js';

package/dist/table/primitives.d.cts

@@ -21,7 +21,7 @@
  * </TableRoot>
  * ```
  */
-export { TableRoot, useTableContext, defaultGetSortLabel } from './Table.cjs';
+export { TableRoot, useTableContext, defaultGetSortLabel, defaultGetMoveLabel } from './Table.cjs';
 export { TableHeader } from './TableHeader.cjs';
 export { TableBody } from './TableBody.cjs';
 export { TableFooter } from './TableFooter.cjs';
@@ -38,4 +38,8 @@ export { TableSortIndicator } from './TableSortIndicator.cjs';
 export { TableSelectAllCheckbox, defaultSelectAllLabel } from './TableSelectAllCheckbox.cjs';
 export { TableRowSelectCheckbox } from './TableRowSelectCheckbox.cjs';
 export { TableColumnResizeTrigger } from './TableColumnResizeTrigger.cjs';
-export type { TableRootProps, TableHeaderProps, TableBodyProps, TableFooterProps, TableRowProps, TableHeaderCellProps, TableCellProps, TableCaptionProps, TableSortState, TableSort, SortDirection, TableSelectionMode, TableColumnWidths, TableContextValue, TableExpandTriggerProps, TableExpandedRowProps, TableEmptyProps, TableColumnHeaderSortTriggerProps, TableColumnHeaderFilterInputProps, TableFilterState, TableSortIndicatorProps, TableSelectAllCheckboxProps, TableSelectAllScope, TableRowSelectCheckboxProps, TableColumnResizeTriggerProps, } from './types.cjs';
+export { TableColumnReorderTrigger } from './TableColumnReorderTrigger.cjs';
+export { TableColumnPinTrigger } from './TableColumnPinTrigger.cjs';
+export { TableGroupRow } from './TableGroupRow.cjs';
+export { TableTreeTrigger } from './TableTreeTrigger.cjs';
+export type { TableRootProps, TableHeaderProps, TableBodyProps, TableFooterProps, TableRowProps, TableHeaderCellProps, TableCellProps, TableCaptionProps, TableSortState, TableSort, SortDirection, TableSelectionMode, TableColumnWidths, TableContextValue, TableExpandTriggerProps, TableExpandedRowProps, TableEmptyProps, TableColumnHeaderSortTriggerProps, TableColumnHeaderFilterInputProps, TableFilterState, TableSortIndicatorProps, TableSelectAllCheckboxProps, TableSelectAllScope, TableRowSelectCheckboxProps, TableColumnResizeTriggerProps, TableColumnReorderTriggerProps, TableColumnPinTriggerProps, TableColumnPins, TableGroupRowProps, TableTreeTriggerProps, } from './types.cjs';

package/dist/table/primitives.d.ts

@@ -21,7 +21,7 @@
  * </TableRoot>
  * ```
  */
-export { TableRoot, useTableContext, defaultGetSortLabel } from './Table.js';
+export { TableRoot, useTableContext, defaultGetSortLabel, defaultGetMoveLabel } from './Table.js';
 export { TableHeader } from './TableHeader.js';
 export { TableBody } from './TableBody.js';
 export { TableFooter } from './TableFooter.js';
@@ -38,4 +38,8 @@ export { TableSortIndicator } from './TableSortIndicator.js';
 export { TableSelectAllCheckbox, defaultSelectAllLabel } from './TableSelectAllCheckbox.js';
 export { TableRowSelectCheckbox } from './TableRowSelectCheckbox.js';
 export { TableColumnResizeTrigger } from './TableColumnResizeTrigger.js';
-export type { TableRootProps, TableHeaderProps, TableBodyProps, TableFooterProps, TableRowProps, TableHeaderCellProps, TableCellProps, TableCaptionProps, TableSortState, TableSort, SortDirection, TableSelectionMode, TableColumnWidths, TableContextValue, TableExpandTriggerProps, TableExpandedRowProps, TableEmptyProps, TableColumnHeaderSortTriggerProps, TableColumnHeaderFilterInputProps, TableFilterState, TableSortIndicatorProps, TableSelectAllCheckboxProps, TableSelectAllScope, TableRowSelectCheckboxProps, TableColumnResizeTriggerProps, } from './types.js';
+export { TableColumnReorderTrigger } from './TableColumnReorderTrigger.js';
+export { TableColumnPinTrigger } from './TableColumnPinTrigger.js';
+export { TableGroupRow } from './TableGroupRow.js';
+export { TableTreeTrigger } from './TableTreeTrigger.js';
+export type { TableRootProps, TableHeaderProps, TableBodyProps, TableFooterProps, TableRowProps, TableHeaderCellProps, TableCellProps, TableCaptionProps, TableSortState, TableSort, SortDirection, TableSelectionMode, TableColumnWidths, TableContextValue, TableExpandTriggerProps, TableExpandedRowProps, TableEmptyProps, TableColumnHeaderSortTriggerProps, TableColumnHeaderFilterInputProps, TableFilterState, TableSortIndicatorProps, TableSelectAllCheckboxProps, TableSelectAllScope, TableRowSelectCheckboxProps, TableColumnResizeTriggerProps, TableColumnReorderTriggerProps, TableColumnPinTriggerProps, TableColumnPins, TableGroupRowProps, TableTreeTriggerProps, } from './types.js';

package/dist/table/types.d.cts

@@ -18,6 +18,8 @@ export type TableSelectAllScope = 'page' | 'all';
 export type TableSelectionMode = 'single' | 'multiple' | 'none';
 /** Per-column pixel widths keyed by `columnKey`. */
 export type TableColumnWidths = Record<string, number>;
+/** Pinned columns keyed by `columnKey`; an unpinned column is absent from the map. */
+export type TableColumnPins = Record<string, 'start' | 'end'>;
 /** Shared sort/selection state distributed from `Table` to its parts. */
 export interface TableContextValue {
     /** Unique per-table id for stable detail row `id`/`aria-controls` pairs. */
@@ -50,6 +52,28 @@ export interface TableContextValue {
     headerCellCount: number;
     /** @internal Counts a mounted `TableHeaderCell` into `headerCellCount`; the returned callback removes it. */
     registerHeaderCell: () => () => void;
+    /** @internal Display order of column keys; keys left out follow in source order. */
+    columnOrder: string[];
+    /** @internal Moves one column to `toIndex` in header DOM order and announces the new position. */
+    moveColumn: (columnKey: string, toIndex: number, columnLabel?: string) => void;
+    /** @internal Which columns are pinned, and to which edge of the table. */
+    columnPins: TableColumnPins;
+    /** @internal Pins a column to one edge, or unpins it when given `null`. */
+    setColumnPin: (columnKey: string, side: 'start' | 'end' | null) => void;
+    /** @internal Measured sticky offset in pixels for each pinned column. */
+    pinOffsets: Record<string, number>;
+    /** @internal Group keys whose rows are currently hidden by their group row. */
+    collapsedGroups: Set<string>;
+    /** @internal Collapses an expanded group, or expands a collapsed one. */
+    toggleGroup: (groupKey: string) => void;
+    /** @internal Whether this group's rows are hidden right now. */
+    isGroupCollapsed: (groupKey: string) => boolean;
+    /** @internal Row ids of the tree parents whose children are rendered. */
+    expandedNodes: Set<string>;
+    /** @internal Expands a collapsed tree parent, or collapses an expanded one. */
+    toggleNode: (rowId: string) => void;
+    /** @internal Whether this tree parent currently renders its child rows. */
+    isNodeExpanded: (rowId: string) => boolean;
     /** Deselect all or select all given row ids. */
     toggleAll: (allIds: string[]) => void;
     isAllSelected: (allIds: string[]) => boolean;
@@ -68,6 +92,12 @@ export interface TableHeaderCellContextValue {
     maxWidth?: number | undefined;
     resizeLabel?: string | undefined;
     resizeStep?: number | undefined;
+    /** Whether this column can be moved by its reorder trigger. */
+    reorderable?: boolean | undefined;
+    /** Whether this column can be pinned by its pin trigger. */
+    pinnable?: boolean | undefined;
+    reorderLabel?: string | undefined;
+    pinLabel?: string | undefined;
 }
 /** Props for `TableRoot`, a native table with optional sorting and selection state. */
 export interface TableRootProps extends Omit<PrimitivePropsWithRef<'table'>, 'onChange'> {
@@ -181,6 +211,71 @@ export interface TableRootProps extends Omit<PrimitivePropsWithRef<'table'>, 'on
      * @default undefined
      */
     onColumnWidthsCommit?: ((widths: TableColumnWidths) => void) | undefined;
+    /**
+     * Display order of column keys for controlled usage; keys left out follow in source order.
+     * @default undefined
+     */
+    columnOrder?: string[] | undefined;
+    /**
+     * Initial display order of column keys for uncontrolled usage.
+     * @default []
+     */
+    defaultColumnOrder?: string[] | undefined;
+    /**
+     * Fires with the full column order whenever a reorder trigger moves a column.
+     * @default undefined
+     */
+    onColumnOrderChange?: ((columnOrder: string[]) => void) | undefined;
+    /**
+     * Pinned columns keyed by `columnKey` for controlled usage, each pinned to one edge.
+     * @default undefined
+     */
+    columnPins?: TableColumnPins | undefined;
+    /**
+     * Initially pinned columns for uncontrolled usage, keyed by `columnKey`.
+     * @default {}
+     */
+    defaultColumnPins?: TableColumnPins | undefined;
+    /**
+     * Fires with the full pin map whenever a pin trigger is activated.
+     * @default undefined
+     */
+    onColumnPinsChange?: ((columnPins: TableColumnPins) => void) | undefined;
+    /**
+     * Format the message announced after a column is moved, given its 1-based position.
+     * @default defaultGetMoveLabel
+     */
+    getMoveLabel?: ((column: string, position: number, count: number) => string) | undefined;
+    /**
+     * Group keys whose rows are hidden for controlled usage; groups start expanded.
+     * @default undefined
+     */
+    collapsedGroups?: string[] | undefined;
+    /**
+     * Initially collapsed group keys for uncontrolled usage.
+     * @default []
+     */
+    defaultCollapsedGroups?: string[] | undefined;
+    /**
+     * Fires with the collapsed group keys whenever a group row is toggled.
+     * @default undefined
+     */
+    onCollapsedGroupsChange?: ((groupKeys: string[]) => void) | undefined;
+    /**
+     * Tree parents whose child rows are rendered, for controlled usage.
+     * @default undefined
+     */
+    expandedNodeIds?: string[] | undefined;
+    /**
+     * Initially expanded tree parents for uncontrolled usage.
+     * @default []
+     */
+    defaultExpandedNodeIds?: string[] | undefined;
+    /**
+     * Fires with the expanded tree parents whenever a tree trigger is activated.
+     * @default undefined
+     */
+    onExpandedNodeIdsChange?: ((rowIds: string[]) => void) | undefined;
     /**
      * Spacing rung the skin packs the cells by, mirrored to `data-density`.
      * @default undefined — the skin's own default spacing.
@@ -221,6 +316,16 @@ export interface TableColumn<T extends object = object> {
      * @default inherits root's `filterable`
      */
     filterable?: boolean | undefined;
+    /**
+     * Override the root's `reorderable` for this column alone.
+     * @default inherits root's `reorderable`
+     */
+    reorderable?: boolean | undefined;
+    /**
+     * Override the root's `pinnable` for this column alone.
+     * @default inherits root's `pinnable`
+     */
+    pinnable?: boolean | undefined;
     /** @default 40 */
     minWidth?: number | undefined;
     /** @default 1000 */
@@ -262,6 +367,31 @@ export interface TableProps<T extends object = object> extends Omit<TableRootPro
      * @default false
      */
     filterable?: boolean | undefined;
+    /**
+     * Default `reorderable` for every column that doesn't set its own, deriving a reorder trigger.
+     * @default false
+     */
+    reorderable?: boolean | undefined;
+    /**
+     * Default `pinnable` for every column that doesn't set its own, deriving a pin trigger.
+     * @default false
+     */
+    pinnable?: boolean | undefined;
+    /**
+     * Column key to group rows by, emitting one collapsible group row per distinct value.
+     * @default no grouping
+     */
+    groupBy?: (Extract<keyof T, string> | (string & {})) | undefined;
+    /**
+     * Render one derived group row's label from its key and rows.
+     * @default `${groupKey} (${rows.length})`
+     */
+    renderGroupHeader?: ((groupKey: string, rows: T[]) => React.ReactNode) | undefined;
+    /**
+     * Return a row's child rows to render the data as an expandable tree.
+     * @default no tree rows
+     */
+    getSubRows?: ((row: T) => T[] | undefined) | undefined;
     /**
      * Content for a derived empty row shown when data is empty.
      * @default no empty row
@@ -309,6 +439,11 @@ export interface TableRowProps extends PrimitivePropsWithRef<'tr'> {
      * @default undefined
      */
     rowId?: string | undefined;
+    /**
+     * Tree depth of this row, `0` at the top level, published for the skin to indent by.
+     * @default undefined — the row carries no depth.
+     */
+    level?: number | undefined;
 }
 /** Props for a column header cell, optionally sortable and resizable. */
 export interface TableHeaderCellProps extends PrimitivePropsWithRef<'th'> {
@@ -357,6 +492,26 @@ export interface TableHeaderCellProps extends PrimitivePropsWithRef<'th'> {
      * @default 8
      */
     resizeStep?: number | undefined;
+    /**
+     * Renders a reorder trigger after the label, moved with the arrow keys or dragged.
+     * @default false
+     */
+    reorderable?: boolean | undefined;
+    /**
+     * Renders a pin trigger after the label, sticking this column to one edge.
+     * @default false
+     */
+    pinnable?: boolean | undefined;
+    /**
+     * Accessible name for the derived reorder trigger.
+     * @default 'Move column'
+     */
+    reorderLabel?: string | undefined;
+    /**
+     * Accessible name for the derived pin trigger.
+     * @default 'Pin column'
+     */
+    pinLabel?: string | undefined;
 }
 /** Props for the button inside a header cell that cycles column sort. */
 export interface TableColumnHeaderSortTriggerProps extends PrimitivePropsWithRef<'button'> {
@@ -431,8 +586,59 @@ export interface TableColumnResizeTriggerProps extends PrimitivePropsWithRef<'sp
      */
     label?: string | undefined;
 }
+/** Props for the button that moves its column left or right. */
+export interface TableColumnReorderTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /**
+     * Column this trigger moves, inherited from the enclosing `TableHeaderCell`'s `columnKey`.
+     * @default enclosing `TableHeaderCell`'s `columnKey`
+     */
+    columnKey?: string | undefined;
+    /**
+     * Accessible name for the trigger, which draws only a drag glyph by default.
+     * @default enclosing `TableHeaderCell`'s `reorderLabel` or `'Move column'`
+     */
+    label?: string | undefined;
+}
+/** Props for the toggle button that pins its column to one edge. */
+export interface TableColumnPinTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /**
+     * Column this trigger pins, inherited from the enclosing `TableHeaderCell`'s `columnKey`.
+     * @default enclosing `TableHeaderCell`'s `columnKey`
+     */
+    columnKey?: string | undefined;
+    /**
+     * Which edge of the table this trigger pins its column to.
+     * @default 'start'
+     */
+    side?: 'start' | 'end' | undefined;
+    /**
+     * Accessible name for the trigger, which draws only a pin glyph by default.
+     * @default enclosing `TableHeaderCell`'s `pinLabel` or `'Pin column'`
+     */
+    label?: string | undefined;
+}
+/** Props for the row that heads and collapses one group of rows. */
+export interface TableGroupRowProps extends PrimitivePropsWithRef<'tr'> {
+    /** Key of the group this row heads, as it appears in `collapsedGroups`. */
+    groupKey: string;
+    /**
+     * How many columns the group cell spans.
+     * @default undefined — the table's own header cell count, so a column added later still spans.
+     */
+    colSpan?: number | undefined;
+}
+/** Props for the disclosure button that reveals a tree row's children. */
+export interface TableTreeTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /** Id of the parent row whose child rows this trigger reveals. */
+    rowId: string;
+}
 /** Props for a single body cell. */
 export interface TableCellProps extends PrimitivePropsWithRef<'td'> {
+    /**
+     * Column this cell belongs to, so it follows that column's pinning.
+     * @default undefined — the cell never pins.
+     */
+    columnKey?: string | undefined;
 }
 /** Props for the table caption. */
 export interface TableCaptionProps extends PrimitivePropsWithRef<'caption'> {

package/dist/table/types.d.ts

@@ -18,6 +18,8 @@ export type TableSelectAllScope = 'page' | 'all';
 export type TableSelectionMode = 'single' | 'multiple' | 'none';
 /** Per-column pixel widths keyed by `columnKey`. */
 export type TableColumnWidths = Record<string, number>;
+/** Pinned columns keyed by `columnKey`; an unpinned column is absent from the map. */
+export type TableColumnPins = Record<string, 'start' | 'end'>;
 /** Shared sort/selection state distributed from `Table` to its parts. */
 export interface TableContextValue {
     /** Unique per-table id for stable detail row `id`/`aria-controls` pairs. */
@@ -50,6 +52,28 @@ export interface TableContextValue {
     headerCellCount: number;
     /** @internal Counts a mounted `TableHeaderCell` into `headerCellCount`; the returned callback removes it. */
     registerHeaderCell: () => () => void;
+    /** @internal Display order of column keys; keys left out follow in source order. */
+    columnOrder: string[];
+    /** @internal Moves one column to `toIndex` in header DOM order and announces the new position. */
+    moveColumn: (columnKey: string, toIndex: number, columnLabel?: string) => void;
+    /** @internal Which columns are pinned, and to which edge of the table. */
+    columnPins: TableColumnPins;
+    /** @internal Pins a column to one edge, or unpins it when given `null`. */
+    setColumnPin: (columnKey: string, side: 'start' | 'end' | null) => void;
+    /** @internal Measured sticky offset in pixels for each pinned column. */
+    pinOffsets: Record<string, number>;
+    /** @internal Group keys whose rows are currently hidden by their group row. */
+    collapsedGroups: Set<string>;
+    /** @internal Collapses an expanded group, or expands a collapsed one. */
+    toggleGroup: (groupKey: string) => void;
+    /** @internal Whether this group's rows are hidden right now. */
+    isGroupCollapsed: (groupKey: string) => boolean;
+    /** @internal Row ids of the tree parents whose children are rendered. */
+    expandedNodes: Set<string>;
+    /** @internal Expands a collapsed tree parent, or collapses an expanded one. */
+    toggleNode: (rowId: string) => void;
+    /** @internal Whether this tree parent currently renders its child rows. */
+    isNodeExpanded: (rowId: string) => boolean;
     /** Deselect all or select all given row ids. */
     toggleAll: (allIds: string[]) => void;
     isAllSelected: (allIds: string[]) => boolean;
@@ -68,6 +92,12 @@ export interface TableHeaderCellContextValue {
     maxWidth?: number | undefined;
     resizeLabel?: string | undefined;
     resizeStep?: number | undefined;
+    /** Whether this column can be moved by its reorder trigger. */
+    reorderable?: boolean | undefined;
+    /** Whether this column can be pinned by its pin trigger. */
+    pinnable?: boolean | undefined;
+    reorderLabel?: string | undefined;
+    pinLabel?: string | undefined;
 }
 /** Props for `TableRoot`, a native table with optional sorting and selection state. */
 export interface TableRootProps extends Omit<PrimitivePropsWithRef<'table'>, 'onChange'> {
@@ -181,6 +211,71 @@ export interface TableRootProps extends Omit<PrimitivePropsWithRef<'table'>, 'on
      * @default undefined
      */
     onColumnWidthsCommit?: ((widths: TableColumnWidths) => void) | undefined;
+    /**
+     * Display order of column keys for controlled usage; keys left out follow in source order.
+     * @default undefined
+     */
+    columnOrder?: string[] | undefined;
+    /**
+     * Initial display order of column keys for uncontrolled usage.
+     * @default []
+     */
+    defaultColumnOrder?: string[] | undefined;
+    /**
+     * Fires with the full column order whenever a reorder trigger moves a column.
+     * @default undefined
+     */
+    onColumnOrderChange?: ((columnOrder: string[]) => void) | undefined;
+    /**
+     * Pinned columns keyed by `columnKey` for controlled usage, each pinned to one edge.
+     * @default undefined
+     */
+    columnPins?: TableColumnPins | undefined;
+    /**
+     * Initially pinned columns for uncontrolled usage, keyed by `columnKey`.
+     * @default {}
+     */
+    defaultColumnPins?: TableColumnPins | undefined;
+    /**
+     * Fires with the full pin map whenever a pin trigger is activated.
+     * @default undefined
+     */
+    onColumnPinsChange?: ((columnPins: TableColumnPins) => void) | undefined;
+    /**
+     * Format the message announced after a column is moved, given its 1-based position.
+     * @default defaultGetMoveLabel
+     */
+    getMoveLabel?: ((column: string, position: number, count: number) => string) | undefined;
+    /**
+     * Group keys whose rows are hidden for controlled usage; groups start expanded.
+     * @default undefined
+     */
+    collapsedGroups?: string[] | undefined;
+    /**
+     * Initially collapsed group keys for uncontrolled usage.
+     * @default []
+     */
+    defaultCollapsedGroups?: string[] | undefined;
+    /**
+     * Fires with the collapsed group keys whenever a group row is toggled.
+     * @default undefined
+     */
+    onCollapsedGroupsChange?: ((groupKeys: string[]) => void) | undefined;
+    /**
+     * Tree parents whose child rows are rendered, for controlled usage.
+     * @default undefined
+     */
+    expandedNodeIds?: string[] | undefined;
+    /**
+     * Initially expanded tree parents for uncontrolled usage.
+     * @default []
+     */
+    defaultExpandedNodeIds?: string[] | undefined;
+    /**
+     * Fires with the expanded tree parents whenever a tree trigger is activated.
+     * @default undefined
+     */
+    onExpandedNodeIdsChange?: ((rowIds: string[]) => void) | undefined;
     /**
      * Spacing rung the skin packs the cells by, mirrored to `data-density`.
      * @default undefined — the skin's own default spacing.
@@ -221,6 +316,16 @@ export interface TableColumn<T extends object = object> {
      * @default inherits root's `filterable`
      */
     filterable?: boolean | undefined;
+    /**
+     * Override the root's `reorderable` for this column alone.
+     * @default inherits root's `reorderable`
+     */
+    reorderable?: boolean | undefined;
+    /**
+     * Override the root's `pinnable` for this column alone.
+     * @default inherits root's `pinnable`
+     */
+    pinnable?: boolean | undefined;
     /** @default 40 */
     minWidth?: number | undefined;
     /** @default 1000 */
@@ -262,6 +367,31 @@ export interface TableProps<T extends object = object> extends Omit<TableRootPro
      * @default false
      */
     filterable?: boolean | undefined;
+    /**
+     * Default `reorderable` for every column that doesn't set its own, deriving a reorder trigger.
+     * @default false
+     */
+    reorderable?: boolean | undefined;
+    /**
+     * Default `pinnable` for every column that doesn't set its own, deriving a pin trigger.
+     * @default false
+     */
+    pinnable?: boolean | undefined;
+    /**
+     * Column key to group rows by, emitting one collapsible group row per distinct value.
+     * @default no grouping
+     */
+    groupBy?: (Extract<keyof T, string> | (string & {})) | undefined;
+    /**
+     * Render one derived group row's label from its key and rows.
+     * @default `${groupKey} (${rows.length})`
+     */
+    renderGroupHeader?: ((groupKey: string, rows: T[]) => React.ReactNode) | undefined;
+    /**
+     * Return a row's child rows to render the data as an expandable tree.
+     * @default no tree rows
+     */
+    getSubRows?: ((row: T) => T[] | undefined) | undefined;
     /**
      * Content for a derived empty row shown when data is empty.
      * @default no empty row
@@ -309,6 +439,11 @@ export interface TableRowProps extends PrimitivePropsWithRef<'tr'> {
      * @default undefined
      */
     rowId?: string | undefined;
+    /**
+     * Tree depth of this row, `0` at the top level, published for the skin to indent by.
+     * @default undefined — the row carries no depth.
+     */
+    level?: number | undefined;
 }
 /** Props for a column header cell, optionally sortable and resizable. */
 export interface TableHeaderCellProps extends PrimitivePropsWithRef<'th'> {
@@ -357,6 +492,26 @@ export interface TableHeaderCellProps extends PrimitivePropsWithRef<'th'> {
      * @default 8
      */
     resizeStep?: number | undefined;
+    /**
+     * Renders a reorder trigger after the label, moved with the arrow keys or dragged.
+     * @default false
+     */
+    reorderable?: boolean | undefined;
+    /**
+     * Renders a pin trigger after the label, sticking this column to one edge.
+     * @default false
+     */
+    pinnable?: boolean | undefined;
+    /**
+     * Accessible name for the derived reorder trigger.
+     * @default 'Move column'
+     */
+    reorderLabel?: string | undefined;
+    /**
+     * Accessible name for the derived pin trigger.
+     * @default 'Pin column'
+     */
+    pinLabel?: string | undefined;
 }
 /** Props for the button inside a header cell that cycles column sort. */
 export interface TableColumnHeaderSortTriggerProps extends PrimitivePropsWithRef<'button'> {
@@ -431,8 +586,59 @@ export interface TableColumnResizeTriggerProps extends PrimitivePropsWithRef<'sp
      */
     label?: string | undefined;
 }
+/** Props for the button that moves its column left or right. */
+export interface TableColumnReorderTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /**
+     * Column this trigger moves, inherited from the enclosing `TableHeaderCell`'s `columnKey`.
+     * @default enclosing `TableHeaderCell`'s `columnKey`
+     */
+    columnKey?: string | undefined;
+    /**
+     * Accessible name for the trigger, which draws only a drag glyph by default.
+     * @default enclosing `TableHeaderCell`'s `reorderLabel` or `'Move column'`
+     */
+    label?: string | undefined;
+}
+/** Props for the toggle button that pins its column to one edge. */
+export interface TableColumnPinTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /**
+     * Column this trigger pins, inherited from the enclosing `TableHeaderCell`'s `columnKey`.
+     * @default enclosing `TableHeaderCell`'s `columnKey`
+     */
+    columnKey?: string | undefined;
+    /**
+     * Which edge of the table this trigger pins its column to.
+     * @default 'start'
+     */
+    side?: 'start' | 'end' | undefined;
+    /**
+     * Accessible name for the trigger, which draws only a pin glyph by default.
+     * @default enclosing `TableHeaderCell`'s `pinLabel` or `'Pin column'`
+     */
+    label?: string | undefined;
+}
+/** Props for the row that heads and collapses one group of rows. */
+export interface TableGroupRowProps extends PrimitivePropsWithRef<'tr'> {
+    /** Key of the group this row heads, as it appears in `collapsedGroups`. */
+    groupKey: string;
+    /**
+     * How many columns the group cell spans.
+     * @default undefined — the table's own header cell count, so a column added later still spans.
+     */
+    colSpan?: number | undefined;
+}
+/** Props for the disclosure button that reveals a tree row's children. */
+export interface TableTreeTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /** Id of the parent row whose child rows this trigger reveals. */
+    rowId: string;
+}
 /** Props for a single body cell. */
 export interface TableCellProps extends PrimitivePropsWithRef<'td'> {
+    /**
+     * Column this cell belongs to, so it follows that column's pinning.
+     * @default undefined — the cell never pins.
+     */
+    columnKey?: string | undefined;
 }
 /** Props for the table caption. */
 export interface TableCaptionProps extends PrimitivePropsWithRef<'caption'> {

package/dist/table/useColumnOrder.d.cts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+import type { TableColumnPins } from './types.cjs';
+/** Default `getMoveLabel`: `"Amount moved to position 2 of 5"`, counting from one. */
+export declare function defaultGetMoveLabel(column: string, position: number, count: number): string;
+/** Controlled-or-uncontrolled column order plus the announcing move handler TableRoot publishes. */
+export declare function useColumnOrder(tableRef: React.RefObject<HTMLTableElement | null>, prop: string[] | undefined, defaultProp: string[] | undefined, onChange: ((columnOrder: string[]) => void) | undefined, getMoveLabel?: (column: string, position: number, count: number) => string): [string[], (columnKey: string, toIndex: number, columnLabel?: string) => void];
+/** Controlled-or-uncontrolled column pins plus the sticky offsets measured from the pinned header cells. */
+export declare function useColumnPins(tableRef: React.RefObject<HTMLTableElement | null>, prop: TableColumnPins | undefined, defaultProp: TableColumnPins | undefined, onChange: ((columnPins: TableColumnPins) => void) | undefined): [
+    TableColumnPins,
+    (columnKey: string, side: 'start' | 'end' | null) => void,
+    Record<string, number>
+];

package/dist/table/useColumnOrder.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+import type { TableColumnPins } from './types.js';
+/** Default `getMoveLabel`: `"Amount moved to position 2 of 5"`, counting from one. */
+export declare function defaultGetMoveLabel(column: string, position: number, count: number): string;
+/** Controlled-or-uncontrolled column order plus the announcing move handler TableRoot publishes. */
+export declare function useColumnOrder(tableRef: React.RefObject<HTMLTableElement | null>, prop: string[] | undefined, defaultProp: string[] | undefined, onChange: ((columnOrder: string[]) => void) | undefined, getMoveLabel?: (column: string, position: number, count: number) => string): [string[], (columnKey: string, toIndex: number, columnLabel?: string) => void];
+/** Controlled-or-uncontrolled column pins plus the sticky offsets measured from the pinned header cells. */
+export declare function useColumnPins(tableRef: React.RefObject<HTMLTableElement | null>, prop: TableColumnPins | undefined, defaultProp: TableColumnPins | undefined, onChange: ((columnPins: TableColumnPins) => void) | undefined): [
+    TableColumnPins,
+    (columnKey: string, side: 'start' | 'end' | null) => void,
+    Record<string, number>
+];

package/dist/table/useIdSet.d.cts

@@ -0,0 +1,2 @@
+/** Controlled-or-uncontrolled id list as a Set, with the toggle and membership test TableRoot publishes. */
+export declare function useIdSet(prop: string[] | undefined, defaultProp: string[] | undefined, onChange: ((ids: string[]) => void) | undefined): [Set<string>, (id: string) => void, (id: string) => boolean];

package/dist/table/useIdSet.d.ts

@@ -0,0 +1,2 @@
+/** Controlled-or-uncontrolled id list as a Set, with the toggle and membership test TableRoot publishes. */
+export declare function useIdSet(prop: string[] | undefined, defaultProp: string[] | undefined, onChange: ((ids: string[]) => void) | undefined): [Set<string>, (id: string) => void, (id: string) => boolean];