@zvndev/yable-react 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,10 +1,43 @@
-import { Table as Table$1, RowData, Cell, Header, Row, TableOptions, Column, ColumnDef, SortDirection, CellContext, ClipboardOptions, CellFlashInfo } from '@zvndev/yable-core';
+import { RowData, ColumnDefBase, ColumnDefExtensions, Row, ColumnDef, Table as Table$1, Cell, Header, TableOptions, SortingState, ColumnFiltersState, PaginationState, TableState, Updater, Column, SortDirection, CellContext, ClipboardOptions, CellFlashInfo } from '@zvndev/yable-core';
 export { AccessorFnColumnDef, AccessorKeyColumnDef, AggregationFn, Cell, CellStatus as CellCommitStatus, CellContext, CellFlashEvent, CellPatch, ClipboardOptions, Column, ColumnDef, ColumnDefBase, ColumnFiltersState, ColumnMeta, ColumnOrderState, ColumnPinningState, ColumnSizingInfoState, ColumnSizingState, CommitError, CommitErrorCells, CommitRecord, CommitResult, CommitsSlice, DisplayColumnDef, EditingState, ExpandedState, FillHandleState, FilterFn, FormulaEngine, FormulaError, FormulaFunction, FormulaState, GroupColumnDef, Header, HeaderContext, HeaderGroup, KeyboardNavigationAction, KeyboardNavigationCell, KeyboardNavigationDirection, KeyboardNavigationState, OnChangeFn, OnCommitFn, PaginationState, PartialLocale, PivotColumn, PivotConfig, PivotEngine, PivotFieldConfig, PivotRow, PivotState, PivotValueConfig, Row, RowData, RowDragEndEvent, RowDragEvent, RowDragState, RowEditCommitEvent, RowEditEvent, RowPinningState, RowReorderEvent, RowSelectionState, SortDirection, SortingFn, SortingState, Table as TableInstance, TableOptions, TableOptionsResolved, TableState, UndoAction, UndoRedoOptions, UndoRedoState, UndoStack, Updater, VisibilityState, YableLocale, aggregationFns, createColumnHelper, createLocale, createUndoRedoIntegration, en, filterFns, formulaFunctions, functionalUpdate, generatePivotColumnDefs, getDefaultLocale, getInitialPivotState, getPivotRowModel, resetLocale, setDefaultLocale, sortingFns } from '@zvndev/yable-core';
 import * as React$1 from 'react';
-import React__default, { HTMLAttributes, TdHTMLAttributes, ThHTMLAttributes } from 'react';
+import React__default, { CSSProperties, HTMLAttributes, TdHTMLAttributes, ThHTMLAttributes, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { RowDragState } from '@zvndev/yable-core/features/rowDragging';
 
+type YableTableVisualConfig = Partial<Pick<TableProps<any>, 'striped' | 'bordered' | 'compact' | 'stickyHeader' | 'theme' | 'direction' | 'ariaLabel' | 'clickableRows' | 'floatingFilters' | 'columnVirtualization' | 'columnVirtualizationOverscan' | 'statusBar' | 'sidebar' | 'sidebarPanels' | 'defaultSidebarPanel'>>;
+type YableColumnConfig<TData extends RowData = any, TValue = unknown> = Partial<ColumnDefBase<TData, TValue>> & Partial<ColumnDefExtensions<TData, TValue>>;
+interface YableRowConfig<TData extends RowData = any> {
+    className?: string | ((row: Row<TData>) => string | undefined);
+    style?: CSSProperties | ((row: Row<TData>) => CSSProperties);
+}
+type YableCellConfig<TData extends RowData = any, TValue = unknown> = Pick<YableColumnConfig<TData, TValue>, 'cell' | 'cellType' | 'cellTypeProps' | 'cellClassName' | 'cellStyle' | 'editable' | 'editConfig' | 'tooltip' | 'tooltipDelay'>;
+interface YableColumnConfigSet<TData extends RowData = any> {
+    default?: YableColumnConfig<TData>;
+    byId?: Record<string, YableColumnConfig<TData>>;
+}
+interface YableCellConfigSet<TData extends RowData = any> {
+    default?: YableCellConfig<TData>;
+    named?: Record<string, YableCellConfig<TData>>;
+    byColumn?: Record<string, YableCellConfig<TData>>;
+}
+interface YableTableProfile<TData extends RowData = any> {
+    table?: YableTableVisualConfig;
+    columns?: YableColumnConfigSet<TData>;
+    rows?: YableRowConfig<TData>;
+    cells?: YableCellConfigSet<TData>;
+}
+interface YableConfig<TData extends RowData = any> extends YableTableProfile<TData> {
+    profiles?: Record<string, YableTableProfile<TData>>;
+}
+interface ResolvedYableProfile<TData extends RowData = any> extends YableTableProfile<TData> {
+    name: string;
+}
+declare function createYableConfig<TData extends RowData = any>(config: YableConfig<TData>): YableConfig<TData>;
+declare function resolveYableProfile<TData extends RowData = any>(config?: YableConfig<TData>, profileName?: string): ResolvedYableProfile<TData>;
+declare function getYableDefaultColumnDef<TData extends RowData>(profile?: YableTableProfile<TData>): YableColumnConfig<TData> | undefined;
+declare function applyYableConfigToColumns<TData extends RowData>(columns: ColumnDef<TData, any>[], profile?: YableTableProfile<TData>): ColumnDef<TData, any>[];
+
 interface TableProps<TData extends RowData> extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
     table: Table$1<TData>;
     /** Enable sticky header */
@@ -17,6 +50,10 @@ interface TableProps<TData extends RowData> extends Omit<HTMLAttributes<HTMLDivE
     compact?: boolean;
     /** Theme variant */
     theme?: string;
+    /** Named table profile from `YableProvider config` */
+    configProfile?: string;
+    /** Table-local config; overrides provider config for this component */
+    config?: YableConfig<TData>;
     /** Whether rows are clickable (adds cursor + hover) */
     clickableRows?: boolean;
     /** Show footer */
@@ -83,6 +120,12 @@ interface TableHeaderCellProps<TData extends RowData, TValue = unknown> extends
     header: Header<TData, TValue>;
 }
 
+type UseTableOptions<TData extends RowData> = TableOptions<TData> & {
+    /** Table-local config; overrides provider config for this table instance. */
+    config?: YableConfig<TData>;
+    /** Named profile from `YableProvider config`; overrides provider `tableProfile`. */
+    configProfile?: string;
+};
 /**
  * React hook that wraps the framework-agnostic core table engine.
  *
@@ -97,7 +140,124 @@ interface TableHeaderCellProps<TData extends RowData, TValue = unknown> extends
  * function identity from the parent is always invoked — even if every other
  * option key is shallow-equal to the previous render.
  */
-declare function useTable<TData extends RowData>(options: TableOptions<TData>): Table$1<TData>;
+declare function useTable<TData extends RowData>(options: UseTableOptions<TData>): Table$1<TData>;
+
+interface ServerTableFetchArgs {
+    sorting: SortingState;
+    columnFilters: ColumnFiltersState;
+    globalFilter: string;
+    pagination: PaginationState;
+    cursor: unknown;
+    signal: AbortSignal;
+}
+interface ServerTableFetchResult<TData extends RowData> {
+    rows: TData[];
+    cursor?: unknown;
+    hasMore?: boolean;
+    rowCount?: number;
+    pageCount?: number;
+}
+interface ServerTableUpdateArgs<TData extends RowData> {
+    rowId: string;
+    patch: Partial<TData>;
+    previousRow?: TData;
+    signal: AbortSignal;
+}
+interface UseServerTableOptions<TData extends RowData> extends Omit<UseTableOptions<TData>, 'data' | 'state' | 'manualSorting' | 'manualFiltering' | 'manualPagination' | 'onSortingChange' | 'onColumnFiltersChange' | 'onGlobalFilterChange' | 'onPaginationChange' | 'rowCount' | 'pageCount'> {
+    fetchData: (args: ServerTableFetchArgs) => Promise<ServerTableFetchResult<TData>>;
+    updateRow?: (args: ServerTableUpdateArgs<TData>) => Promise<TData | Partial<TData> | void>;
+    initialRows?: TData[];
+    initialCursor?: unknown;
+    initialHasMore?: boolean;
+    initialRowCount?: number;
+    initialPageCount?: number;
+    initialSorting?: SortingState;
+    initialColumnFilters?: ColumnFiltersState;
+    initialGlobalFilter?: string;
+    initialPagination?: PaginationState;
+    autoLoad?: boolean;
+}
+interface ServerTableController<TData extends RowData> {
+    table: Table$1<TData>;
+    rows: TData[];
+    loading: boolean;
+    error: unknown;
+    cursor: unknown;
+    hasMore: boolean;
+    rowCount?: number;
+    pageCount?: number;
+    sorting: SortingState;
+    columnFilters: ColumnFiltersState;
+    globalFilter: string;
+    pagination: PaginationState;
+    refresh: () => Promise<void>;
+    loadMore: () => Promise<void>;
+    updateRow: (rowId: string, patch: Partial<TData>) => Promise<void>;
+}
+declare function useServerTable<TData extends RowData>({ fetchData, updateRow, initialRows, initialCursor, initialHasMore, initialRowCount, initialPageCount, initialSorting, initialColumnFilters, initialGlobalFilter, initialPagination, autoLoad, getRowId, ...tableOptions }: UseServerTableOptions<TData>): ServerTableController<TData>;
+
+interface UseTablePersistenceOptions {
+    /** Storage key used for getItem/setItem. */
+    key: string;
+    /** Which TableState slices to persist. Defaults to column layout keys. */
+    persistedKeys?: (keyof TableState)[];
+    /** Milliseconds to debounce storage writes. Default: 100. */
+    debounce?: number;
+    /** Schema version — bumping this discards any stale stored data. */
+    version?: number;
+    /** Custom Storage implementation. Default: localStorage. */
+    storage?: Storage;
+}
+interface UseTablePersistenceReturn {
+    /**
+     * Partial state hydrated from storage — pass to `useTable({ initialState })`.
+     * Only useful when NOT passing `onStateChange` (i.e., uncontrolled mode).
+     */
+    initialState: Partial<TableState>;
+    /**
+     * State-change handler that persists relevant slices on each update.
+     * When passed to `useTable({ onStateChange })`, the persistence hook
+     * takes over state management (controlled mode). You MUST also pass
+     * `state` to useTable in this case.
+     */
+    onStateChange: (updater: Updater<TableState>) => void;
+    /**
+     * Current table state managed by the persistence hook.
+     * Pass to `useTable({ state })` alongside `onStateChange`.
+     */
+    state: Partial<TableState>;
+    /** Manually clear all persisted state for this key. */
+    clearPersistedState: () => void;
+}
+/**
+ * React hook that persists selected table state slices to storage.
+ *
+ * Returns `initialState` (hydrated from storage), `state`, and
+ * `onStateChange` — pass all three to `useTable` so that persisted
+ * slices survive page reloads.
+ *
+ * @example
+ * ```tsx
+ * const persistence = useTablePersistence({ key: 'my-table', version: 1 })
+ *
+ * // Controlled mode (recommended) — persistence manages state:
+ * const table = useTable({
+ *   data,
+ *   columns,
+ *   initialState: persistence.initialState,
+ *   state: persistence.state,
+ *   onStateChange: persistence.onStateChange,
+ * })
+ *
+ * // Uncontrolled mode — only hydrate, no live persistence:
+ * const table = useTable({
+ *   data,
+ *   columns,
+ *   initialState: persistence.initialState,
+ * })
+ * ```
+ */
+declare function useTablePersistence(options: UseTablePersistenceOptions): UseTablePersistenceReturn;
 
 interface VirtualRow {
     index: number;
@@ -114,6 +274,12 @@ interface UseVirtualizationOptions {
     pretextHeights?: Float64Array | null;
     /** Pre-computed prefix sums for O(log n) scroll lookups */
     pretextPrefixSums?: Float64Array | null;
+    /**
+     * Opaque key that changes when column widths change.
+     * When this value changes the height cache is invalidated because column
+     * resizing can affect text wrapping and therefore row heights.
+     */
+    columnSizingHash?: string | number;
 }
 interface UseVirtualizationResult {
     virtualRows: VirtualRow[];
@@ -121,19 +287,26 @@ interface UseVirtualizationResult {
     startIndex: number;
     endIndex: number;
     scrollTo: (index: number) => void;
+    /**
+     * Manually clear the row-height cache and force recalculation.
+     * Call this when cell content changes (data mutations, font-size changes, etc.)
+     * that may affect row heights.
+     */
+    invalidateRowHeights: () => void;
 }
 /**
  * Computes which rows are visible in a scrollable container and returns
  * positioning data so only those rows (plus an overscan buffer) are rendered.
  *
- * Returns `{ virtualRows, totalHeight, startIndex, endIndex, scrollTo }`.
+ * Returns `{ virtualRows, totalHeight, startIndex, endIndex, scrollTo, invalidateRowHeights }`.
  * Re-renders are triggered by scroll (rAF-throttled) and ResizeObserver
  * container resize. Supports fixed, variable, and Pretext-pre-measured heights.
  *
- * Gotcha: variable-height mode caches measured heights per index — pass new
- * `pretextHeights` arrays (or change `totalRows`) to invalidate the cache.
+ * The height cache is automatically invalidated when `totalRows`, `isFixedHeight`,
+ * or `columnSizingHash` changes. For manual invalidation (e.g. after data mutations
+ * or font-size changes), call `invalidateRowHeights()`.
  */
-declare function useVirtualization({ containerRef, totalRows, rowHeight, overscan, estimateRowHeight: _estimateRowHeight, pretextHeights, pretextPrefixSums, }: UseVirtualizationOptions): UseVirtualizationResult;
+declare function useVirtualization({ containerRef, totalRows, rowHeight, overscan, estimateRowHeight: _estimateRowHeight, pretextHeights, pretextPrefixSums, columnSizingHash, }: UseVirtualizationOptions): UseVirtualizationResult;
 
 interface VirtualColumn<TData extends RowData> {
     column: Column<TData, unknown>;
@@ -146,6 +319,7 @@ interface UseColumnVirtualizationOptions<TData extends RowData> {
     columns: Column<TData, unknown>[];
     overscan?: number;
     enabled?: boolean;
+    sizingKey?: string;
 }
 interface UseColumnVirtualizationResult<TData extends RowData> {
     virtualColumns: VirtualColumn<TData>[];
@@ -158,7 +332,7 @@ interface UseColumnVirtualizationResult<TData extends RowData> {
     isVirtualized: boolean;
     scrollToIndex: (index: number) => void;
 }
-declare function useColumnVirtualization<TData extends RowData>({ containerRef, columns, overscan, enabled, }: UseColumnVirtualizationOptions<TData>): UseColumnVirtualizationResult<TData>;
+declare function useColumnVirtualization<TData extends RowData>({ containerRef, columns, overscan, enabled, sizingKey, }: UseColumnVirtualizationOptions<TData>): UseColumnVirtualizationResult<TData>;
 
 interface CellMeasurement {
     /** Column ID */
@@ -393,7 +567,59 @@ declare function getRegisteredCellTypes(): readonly string[];
 declare const TableProvider: React$1.Provider<Table$1<any> | null>;
 declare function useTableContext<TData extends RowData>(): Table$1<TData>;
 
-declare function Table<TData extends RowData>({ table, stickyHeader, striped, bordered, compact, theme, clickableRows, footer, loading, loadingComponent, loadingText, emptyMessage, emptyComponent, emptyIcon, emptyDetail, renderEmpty, renderLoading, children, className, direction, statusBar, statusBarPanels, sidebar, sidebarPanels, defaultSidebarPanel, floatingFilters, columnVirtualization, columnVirtualizationOverscan, ariaLabel, ...rest }: TableProps<TData>): react_jsx_runtime.JSX.Element;
+/**
+ * Project-wide default table and column options.
+ *
+ * Wrap your app (or a subtree) in `<YableProvider>` so every `<Table>` and
+ * `useTable` call inherits these defaults without repeating config.
+ *
+ * Component-level and hook-level values always take precedence over provider
+ * defaults.
+ */
+interface YableDefaults {
+    /** Layered project config with default and named table/cell profiles */
+    config?: YableConfig;
+    /** Named config profile used by descendants unless overridden */
+    tableProfile?: string;
+    /** Default props applied to every `<Table>` in the subtree */
+    tableProps?: Partial<Pick<TableProps<any>, 'striped' | 'bordered' | 'compact' | 'stickyHeader' | 'theme' | 'direction' | 'ariaLabel'>>;
+    /** Default column definition merged under every table's own `defaultColumnDef` */
+    defaultColumnDef?: Partial<ColumnDefBase<any, unknown>> & Partial<ColumnDefExtensions<any, unknown>>;
+}
+/**
+ * Read the nearest `YableProvider` defaults.
+ *
+ * Safe to call outside a provider — returns an empty object.
+ */
+declare function useYableDefaults(): YableDefaults;
+/**
+ * Provide project-wide defaults for all Yable tables in a subtree.
+ *
+ * @example
+ * ```tsx
+ * <YableProvider
+ *   striped
+ *   stickyHeader
+ *   theme="stripe"
+ *   defaultColumnDef={{ enableSorting: true }}
+ * >
+ *   <EmployeeTable />
+ *   <ProjectTable />
+ * </YableProvider>
+ * ```
+ */
+declare function YableProvider({ children, config, tableProfile, defaultColumnDef, striped, stickyHeader, bordered, compact, theme, direction, ariaLabel, }: YableDefaults & {
+    children: ReactNode;
+    striped?: boolean;
+    stickyHeader?: boolean;
+    bordered?: boolean;
+    compact?: boolean;
+    theme?: string;
+    direction?: 'ltr' | 'rtl';
+    ariaLabel?: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function Table<TData extends RowData>({ table, stickyHeader: stickyHeaderProp, striped: stripedProp, bordered: borderedProp, compact: compactProp, theme: themeProp, config, configProfile, clickableRows, footer, loading, loadingComponent, loadingText, emptyMessage, emptyComponent, emptyIcon, emptyDetail, renderEmpty, renderLoading, children, className, direction: directionProp, statusBar, statusBarPanels, sidebar, sidebarPanels, defaultSidebarPanel, floatingFilters, columnVirtualization, columnVirtualizationOverscan, ariaLabel: ariaLabelProp, ...rest }: TableProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableHeaderProps<TData extends RowData> {
     table: Table$1<TData>;
@@ -404,8 +630,9 @@ declare function TableHeader<TData extends RowData>({ table, floatingFilters, }:
 interface TableBodyProps<TData extends RowData> {
     table: Table$1<TData>;
     clickableRows?: boolean;
+    colgroup?: React__default.ReactNode;
 }
-declare function TableBody<TData extends RowData>({ table, clickableRows }: TableBodyProps<TData>): react_jsx_runtime.JSX.Element;
+declare function TableBody<TData extends RowData>({ table, clickableRows, colgroup, }: TableBodyProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableCellProps<TData extends RowData> {
     cell: Cell<TData, unknown>;
@@ -946,16 +1173,19 @@ interface ContextMenuProps<TData extends RowData> {
     y: number;
     onClose: () => void;
     table: Table$1<TData>;
+    /** Column the menu was opened on (right-clicked header/cell). */
+    targetColumnId?: string;
     customItems?: ContextMenuItemDef[];
 }
-declare function ContextMenu<TData extends RowData>({ x, y, onClose, table, customItems, }: ContextMenuProps<TData>): react_jsx_runtime.JSX.Element;
+declare function ContextMenu<TData extends RowData>({ x, y, onClose, table, targetColumnId, customItems, }: ContextMenuProps<TData>): react_jsx_runtime.JSX.Element;
 
 declare function useContextMenu(): {
     isOpen: boolean;
     x: number;
     y: number;
     targetTable: Table$1<any> | null;
-    open: <TData extends RowData>(clientX: number, clientY: number, table: Table$1<TData>) => void;
+    targetColumnId: string | undefined;
+    open: <TData extends RowData>(clientX: number, clientY: number, table: Table$1<TData>, columnId?: string) => void;
     close: () => void;
 };
 
@@ -972,7 +1202,7 @@ declare function Sidebar<TData extends RowData>({ table, open, onClose, panels,
 interface ColumnsPanelProps<TData extends RowData> {
     table: Table$1<TData>;
 }
-declare function ColumnsPanel<TData extends RowData>({ table, }: ColumnsPanelProps<TData>): react_jsx_runtime.JSX.Element;
+declare function ColumnsPanel<TData extends RowData>({ table }: ColumnsPanelProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface FiltersPanelProps<TData extends RowData> {
     table: Table$1<TData>;
@@ -1015,11 +1245,89 @@ interface UseThemeOptions {
 declare function useTheme(options?: UseThemeOptions): {
     theme: string;
     setTheme: (newTheme: string) => void;
-    colorScheme: "auto" | "light" | "dark";
+    colorScheme: "auto" | "dark" | "light";
     setColorScheme: (scheme: "light" | "dark" | "auto") => void;
     toggleColorScheme: () => void;
-    resolvedColorScheme: "light" | "dark";
+    resolvedColorScheme: "dark" | "light";
     containerRef: React$1.RefObject<HTMLElement | null>;
 };
 
-export { type AutoMeasurementsOptions, CellBadge, type CellBadgeProps, CellBoolean, type CellBooleanProps, CellCheckbox, CellCurrency, type CellCurrencyProps, CellDate, CellDatePicker, type CellDateProps, CellErrorBoundary, CellInput, CellLink, type CellLinkProps, type CellMeasureRecipe, type CellMeasurement, CellNumeric, type CellNumericProps, CellProgress, type CellProgressProps, CellRating, type CellRatingProps, CellSelect, CellStatus, CellStatusBadge, type CellStatusBadgeProps, type CellStatusProps, CellToggle, ColumnsPanel, ContextMenu, ContextMenuItem, type ContextMenuItemDef, DEFAULT_TEXT_RECIPE, DragHandle, ErrorBoundary, ExpandIcon, FillHandle, type FillHandleDragState, type FillHandleProps, FiltersPanel, FlashCell, FloatingFilter, GlobalFilter, LoadingOverlay, type LoadingOverlayProps, MasterDetail, NoRowsOverlay, type NoRowsOverlayProps, Pagination, PivotConfigPanel, type PivotConfigProps, type PivotFieldItem, type PivotValueItem, PrintLayout, SetFilter, Sidebar, SortIndicator, StatusBar, StatusBarPanelComponent, type StatusBarPanelComponentProps, type StatusBarPanelConfig, type StatusBarPanelProps, Table, TableBody, TableCell, type TableCellProps$1 as TableCellProps, TableFooter, TableHeader, type TableHeaderCellProps, type TableProps, TableProvider, type TableRowProps, Tooltip, type TooltipPosition, type TooltipProps, TreeToggle, type UseCellFlashOptions, type UseClipboardOptions, type UseColumnVirtualizationOptions, type UseColumnVirtualizationResult, type UseFillHandleOptions, type UseFillHandleReturn, type UseKeyboardNavigationOptions, type UsePretextMeasurementOptions, type UsePretextMeasurementResult, type UsePrintLayoutOptions, type UseRowAnimationOptions, type UseRowDragOptions, type UseRowDragReturn, type UseTableRowHeightsOptions, type UseThemeOptions, type UseTooltipOptions, type UseVirtualizationOptions, type UseVirtualizationResult, type VirtualColumn, type VirtualRow, getMeasureRecipeForCellType, getRegisteredCellTypes, resolveMeasureRecipe, useAutoMeasurements, useCellFlash, useClipboard, useColumnVirtualization, useContextMenu, useFillHandle, useKeyboardNavigation, usePretextMeasurement, usePrintLayout, useRowAnimation, useRowDrag, useTable, useTableContext, useTableRowHeights, useTheme, useTooltip, useVirtualization };
+interface SelectColumnOptions {
+    id?: string;
+    size?: number;
+    headerAriaLabel?: string;
+}
+declare function selectColumn<TData extends RowData>(options?: SelectColumnOptions): ColumnDef<TData, unknown>;
+
+interface RowNumberColumnOptions {
+    id?: string;
+    header?: string;
+    size?: number;
+    startFrom?: number;
+}
+declare function rowNumberColumn<TData extends RowData>(options?: RowNumberColumnOptions): ColumnDef<TData, unknown>;
+
+interface ActionItem<TData extends RowData> {
+    label: string;
+    icon?: ReactNode;
+    onClick: (row: Row<TData>) => void;
+    hidden?: (row: Row<TData>) => boolean;
+    disabled?: (row: Row<TData>) => boolean;
+}
+interface ActionsColumnOptions<TData extends RowData> {
+    id?: string;
+    header?: string;
+    size?: number;
+    actions: ActionItem<TData>[] | ((row: Row<TData>) => ActionItem<TData>[]);
+}
+declare function actionsColumn<TData extends RowData>(options: ActionsColumnOptions<TData>): ColumnDef<TData, unknown>;
+
+interface ExpandColumnOptions {
+    id?: string;
+    size?: number;
+}
+declare function expandColumn<TData extends RowData>(options?: ExpandColumnOptions): ColumnDef<TData, unknown>;
+
+interface CellStackProps {
+    children: React__default.ReactNode;
+    gap?: number;
+}
+declare function CellStack({ children, gap }: CellStackProps): react_jsx_runtime.JSX.Element;
+
+interface CellRowProps {
+    children: React__default.ReactNode;
+    gap?: number;
+    align?: 'start' | 'center' | 'end' | 'baseline';
+    justify?: 'start' | 'center' | 'end' | 'between';
+}
+declare function CellRow({ children, gap, align, justify }: CellRowProps): react_jsx_runtime.JSX.Element;
+
+interface CellWithIconProps {
+    icon: React__default.ReactNode;
+    children: React__default.ReactNode;
+    gap?: number;
+    iconSize?: number;
+}
+declare function CellWithIcon({ icon, children, gap, iconSize }: CellWithIconProps): react_jsx_runtime.JSX.Element;
+
+interface CellTextProps {
+    children: React__default.ReactNode;
+    variant?: 'primary' | 'secondary' | 'muted';
+    bold?: boolean;
+    truncate?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+}
+declare function CellText({ children, variant, bold, truncate, size, }: CellTextProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Merges edit-commit changes into a data array, returning a new array
+ * with matching rows shallow-merged. Rows without changes keep their
+ * original reference so downstream memoisation works.
+ *
+ * @param data     Current data array
+ * @param changes  Map of row ID -> partial row values (same shape as `onEditCommit`)
+ * @param getRowId Optional row-ID resolver; defaults to string index
+ */
+declare function mergeEditChanges<TData>(data: TData[], changes: Record<string, Partial<TData>>, getRowId?: (row: TData, index: number) => string): TData[];
+
+export { type ActionItem, type ActionsColumnOptions, type AutoMeasurementsOptions, CellBadge, type CellBadgeProps, CellBoolean, type CellBooleanProps, CellCheckbox, CellCurrency, type CellCurrencyProps, CellDate, CellDatePicker, type CellDateProps, CellErrorBoundary, CellInput, CellLink, type CellLinkProps, type CellMeasureRecipe, type CellMeasurement, CellNumeric, type CellNumericProps, CellProgress, type CellProgressProps, CellRating, type CellRatingProps, CellRow, type CellRowProps, CellSelect, CellStack, type CellStackProps, CellStatus, CellStatusBadge, type CellStatusBadgeProps, type CellStatusProps, CellText, type CellTextProps, CellToggle, CellWithIcon, type CellWithIconProps, ColumnsPanel, ContextMenu, ContextMenuItem, type ContextMenuItemDef, DEFAULT_TEXT_RECIPE, DragHandle, ErrorBoundary, type ExpandColumnOptions, ExpandIcon, FillHandle, type FillHandleDragState, type FillHandleProps, FiltersPanel, FlashCell, FloatingFilter, GlobalFilter, LoadingOverlay, type LoadingOverlayProps, MasterDetail, NoRowsOverlay, type NoRowsOverlayProps, Pagination, PivotConfigPanel, type PivotConfigProps, type PivotFieldItem, type PivotValueItem, PrintLayout, type ResolvedYableProfile, type RowNumberColumnOptions, type SelectColumnOptions, type ServerTableController, type ServerTableFetchArgs, type ServerTableFetchResult, type ServerTableUpdateArgs, SetFilter, Sidebar, SortIndicator, StatusBar, StatusBarPanelComponent, type StatusBarPanelComponentProps, type StatusBarPanelConfig, type StatusBarPanelProps, Table, TableBody, TableCell, type TableCellProps$1 as TableCellProps, TableFooter, TableHeader, type TableHeaderCellProps, type TableProps, TableProvider, type TableRowProps, Tooltip, type TooltipPosition, type TooltipProps, TreeToggle, type UseCellFlashOptions, type UseClipboardOptions, type UseColumnVirtualizationOptions, type UseColumnVirtualizationResult, type UseFillHandleOptions, type UseFillHandleReturn, type UseKeyboardNavigationOptions, type UsePretextMeasurementOptions, type UsePretextMeasurementResult, type UsePrintLayoutOptions, type UseRowAnimationOptions, type UseRowDragOptions, type UseRowDragReturn, type UseServerTableOptions, type UseTableOptions, type UseTablePersistenceOptions, type UseTablePersistenceReturn, type UseTableRowHeightsOptions, type UseThemeOptions, type UseTooltipOptions, type UseVirtualizationOptions, type UseVirtualizationResult, type VirtualColumn, type VirtualRow, type YableCellConfig, type YableCellConfigSet, type YableColumnConfig, type YableColumnConfigSet, type YableConfig, type YableDefaults, YableProvider, type YableRowConfig, type YableTableProfile, type YableTableVisualConfig, actionsColumn, applyYableConfigToColumns, createYableConfig, expandColumn, getMeasureRecipeForCellType, getRegisteredCellTypes, getYableDefaultColumnDef, mergeEditChanges, resolveMeasureRecipe, resolveYableProfile, rowNumberColumn, selectColumn, useAutoMeasurements, useCellFlash, useClipboard, useColumnVirtualization, useContextMenu, useFillHandle, useKeyboardNavigation, usePretextMeasurement, usePrintLayout, useRowAnimation, useRowDrag, useServerTable, useTable, useTableContext, useTablePersistence, useTableRowHeights, useTheme, useTooltip, useVirtualization, useYableDefaults };