boneless-table 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 boneless-table contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# boneless-table
+
+An accessible, virtualized, unstyled React data table renderer built on TanStack Table.
+
+## Install
+
+```bash
+npm install boneless-table
+```
+
+## Styling and icons
+
+The package ships no CSS, Tailwind utilities, or icon dependency. Apply classes through
+`className` and `classNames`, target stable `data-slot` attributes in your stylesheet, and pass
+optional icons through `icons`. The documentation app contains a complete Tailwind theme built on
+those hooks.
+
+## Usage
+
+```tsx
+import { BonelessTable, type BonelessTableColumn } from 'boneless-table'
+
+type Account = { id: string; name: string; plan: string }
+
+const columns: BonelessTableColumn<Account>[] = [
+  { key: 'name', header: 'Account' },
+  { key: 'plan', header: 'Plan' },
+]
+
+export function AccountsTable({ data }: { data: Account[] }) {
+  return <BonelessTable data={data} columns={columns} />
+}
+```
+
+See the repository documentation site for the complete API and configuration guide.
+
+## Layout and virtualization
+
+Content-sized tables (`scroller="auto"`, the default) render all rows. Virtualization is enabled
+when `scroller="fill"`, which must be placed in a parent with a stable height. Virtual rows are
+measured after rendering, so cells may wrap or render variable-height content. Use
+`virtualization={false}` to opt out in a fill layout.
+
+For non-text column headers, set `meta.columnLabel` to provide the label shown in the built-in
+column chooser; otherwise the chooser falls back to the column id.
+
+## Filtering performance
+
+Text filters debounce updates by 150ms by default, so large client-side row models are not
+recomputed on every keystroke. Set `filterDebounceMs={0}` for immediate filtering, or increase
+the value when working with larger local datasets. This delay also reduces request churn for
+server-filtered tables.
+
+## Expandable rows
+
+Pass TanStack's `getSubRows` together with `tree` to render nested records. The default toolbar
+adds one Expand all / Collapse all control, and indentation is contained inside the selected cell
+so tree depth never changes column widths.
+
+```tsx
+<BonelessTable
+  data={family}
+  columns={columns}
+  getSubRows={(person) => person.children}
+  tree={{ columnId: 'name', indentPx: 18 }}
+/>
+```

package/dist/index.d.mts

@@ -0,0 +1,258 @@
+import { RowData, ColumnDef, Table, TableOptions, TableState, Column } from '@tanstack/react-table';
+export { ColumnDef, ColumnFiltersState, ColumnOrderState, ExpandedState, SortingState, Table, TableOptions, VisibilityState, createColumnHelper, flexRender, getCoreRowModel, getExpandedRowModel, getFilteredRowModel, getSortedRowModel, useReactTable } from '@tanstack/react-table';
+import * as react from 'react';
+import { ReactNode, RefObject, ComponentType, AnchorHTMLAttributes, MouseEvent, KeyboardEvent } from 'react';
+
+type ColumnAlignment = 'left' | 'right';
+type ColumnBorders = 'none' | 'left' | 'right' | 'both';
+type FilterType = 'text' | 'select';
+type RevealMode = 'always' | 'hover';
+type BonelessTableColumnSizing = {
+    widthPx: number;
+} | {
+    minPx: number;
+    flex?: number;
+};
+type BonelessTableColumnSettings = {
+    sizing?: BonelessTableColumnSizing;
+    align?: ColumnAlignment;
+    borders?: ColumnBorders;
+    sorting?: {
+        enabled?: boolean;
+        reveal?: RevealMode;
+    };
+    filtering?: {
+        type: FilterType;
+        options?: readonly string[];
+        reveal?: RevealMode;
+    };
+    valueDisplay?: {
+        truncateAt: number;
+        suffix?: string;
+    };
+};
+type BonelessTableSettings = {
+    columnDefaults: Required<Pick<BonelessTableColumnSettings, 'align' | 'borders'>> & {
+        sizing: Required<NonNullable<BonelessTableColumnSettings['sizing']>>;
+        sorting: Required<NonNullable<BonelessTableColumnSettings['sorting']>>;
+    };
+    interactions: {
+        filterReveal: RevealMode;
+        horizontalOverflow: 'auto' | 'scroll';
+    };
+};
+declare const defaultBonelessTableSettings: BonelessTableSettings;
+declare function mergeBonelessTableSettings(override?: DeepPartial<BonelessTableSettings>, base?: BonelessTableSettings): BonelessTableSettings;
+declare function resolveColumnSettings(settings: BonelessTableSettings, column: {
+    columnDef: {
+        meta?: {
+            bonelessTable?: BonelessTableColumnSettings;
+        };
+    };
+}): {
+    sizing: {
+        minPx?: number | undefined;
+        flex?: number;
+        widthPx: number;
+    } | {
+        minPx: number;
+        flex: number;
+    };
+    align: ColumnAlignment;
+    borders: ColumnBorders;
+    sorting: {
+        enabled: boolean;
+        reveal: RevealMode;
+    };
+    filtering: {
+        type: FilterType;
+        options?: readonly string[];
+        reveal?: RevealMode;
+    } | undefined;
+    valueDisplay: {
+        truncateAt: number;
+        suffix?: string;
+    } | undefined;
+};
+declare function compactValue(value: unknown, settings?: BonelessTableColumnSettings): string;
+
+declare module '@tanstack/react-table' {
+    interface ColumnMeta<TData extends RowData, TValue> {
+        bonelessTable?: BonelessTableColumnSettings;
+        /** Accessible label used for this column in the built-in column chooser. */
+        columnLabel?: string;
+    }
+}
+/**
+ * A friendlier column input: use `key` for a data property instead of TanStack's `accessorKey`.
+ * `accessorKey` remains accepted for interoperability with existing TanStack column definitions.
+ */
+type BonelessTableColumn<TData extends RowData, TValue = unknown> = ColumnDef<TData, TValue> | (Omit<ColumnDef<TData, TValue>, 'accessorKey'> & {
+    key: keyof TData & string;
+});
+type ResolvedBonelessTableColumn<TData extends RowData, TValue = unknown> = ColumnDef<TData, TValue>;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+
+type ColumnMenuIcons = Partial<{
+    close: ReactNode;
+    moveEarlier: ReactNode;
+    moveLater: ReactNode;
+}>;
+declare function ColumnMenu<TData>({ table, onClose, onMoveColumn, className, icons, id, triggerRef, }: {
+    table: Table<TData>;
+    onClose: () => void;
+    onMoveColumn: (id: string, direction: -1 | 1) => void;
+    className?: string;
+    /** Optional consumer-owned icons. Text labels remain available without them. */
+    icons?: ColumnMenuIcons;
+    id?: string;
+    /** The menu trigger is not an outside click; this lets it reliably toggle the dialog closed. */
+    triggerRef?: RefObject<HTMLElement | null>;
+}): react.JSX.Element;
+
+type BonelessTableRowLinkComponentProps = {
+    children: ReactNode;
+    className: string;
+    href: string;
+    'aria-label'?: string;
+    target?: AnchorHTMLAttributes<HTMLAnchorElement>['target'];
+    rel?: string;
+};
+type BonelessTableRowLink<TData extends RowData> = {
+    /** A framework-specific component such as Next.js Link that wraps each resolved row. */
+    component: ComponentType<BonelessTableRowLinkComponentProps>;
+    href: string | ((row: TData) => string | undefined);
+    label?: string | ((row: TData) => string | undefined);
+    target?: AnchorHTMLAttributes<HTMLAnchorElement>['target'];
+    rel?: string;
+};
+declare function resolveRowHref<TData extends RowData>(link: Pick<BonelessTableRowLink<TData>, 'href'>, row: TData): string | undefined;
+declare function resolveRowLinkLabel<TData extends RowData>(link: Pick<BonelessTableRowLink<TData>, 'label'>, row: TData): string | undefined;
+
+type BonelessTableToolbarLayout<TData extends RowData> = (context: {
+    table: Table<TData>;
+    summary: ReactNode;
+    actions: ReactNode;
+}) => ReactNode;
+type BonelessTableSlot<TData extends RowData> = boolean | ReactNode | ((table: Table<TData>) => ReactNode);
+type BonelessTableRowClickEvent = MouseEvent<HTMLDivElement> | KeyboardEvent<HTMLDivElement>;
+/**
+ * Named hooks for your stylesheet. The renderer applies no default class names or visual styles.
+ */
+type BonelessTableClassNames = Partial<{
+    root: string;
+    toolbar: string;
+    toolbarSummary: string;
+    toolbarHint: string;
+    toolbarActions: string;
+    scroller: string;
+    table: string;
+    headerGroup: string;
+    headerRow: string;
+    header: string;
+    headerButton: string;
+    sortIndicator: string;
+    rowGroup: string;
+    row: string;
+    cell: string;
+    footer: string;
+    filter: string;
+    columnMenu: string;
+    rowLink: string;
+    emptyState: string;
+    skeleton: string;
+}>;
+/** Optional consumer-owned icons. Omit these for a text-only renderer. */
+type BonelessTableIcons = ColumnMenuIcons & {
+    reset?: ReactNode;
+    columns?: ReactNode;
+    search?: ReactNode;
+    sort?: (direction: false | 'asc' | 'desc') => ReactNode;
+    expand?: ReactNode;
+    collapse?: ReactNode;
+};
+type BonelessTableTreeOptions = {
+    /** Column that receives the in-cell indentation and row control. Defaults to the first visible column. */
+    columnId?: string;
+    /** Pixel increment per tree level. Indentation stays inside the cell and never changes the grid. */
+    indentPx?: number;
+    expandAllLabel?: string;
+    collapseAllLabel?: string;
+};
+type BonelessTablePresentationOptions<TData extends RowData> = {
+    settings?: DeepPartial<BonelessTableSettings>;
+    className?: string;
+    classNames?: BonelessTableClassNames;
+    icons?: BonelessTableIcons;
+    /** Enables nested row controls when used with TanStack's getSubRows option. */
+    tree?: boolean | BonelessTableTreeOptions;
+    isLoading?: boolean;
+    isFetchingMore?: boolean;
+    skeletonRows?: number;
+    skeletonLabel?: string;
+    onNearEnd?: () => void;
+    /** Enables onNearEnd. Keep this false while there is no next page or a request is in flight. */
+    canLoadMore?: boolean;
+    nearEndOffset?: number;
+    /** Delay text-filter updates to avoid recomputing large client-side row models on every keystroke. */
+    filterDebounceMs?: number;
+    /** Content-sized by default. Use fill only inside a parent that provides a stable height. */
+    scroller?: 'fill' | 'auto';
+    toolbar?: BonelessTableSlot<TData>;
+    /** Reposition the default summary and action controls without rebuilding their behavior. */
+    toolbarLayout?: BonelessTableToolbarLayout<TData>;
+    footer?: BonelessTableSlot<TData>;
+    totalCount?: number;
+    resultLabel?: string;
+    resultHint?: string;
+    onReset?: () => void;
+    onRowClick?: (row: TData, event: BonelessTableRowClickEvent) => void;
+    scrollToTopOn?: unknown;
+    rowLink?: BonelessTableRowLink<TData>;
+    /** Content shown when loading is complete and no rows match the current table state. */
+    emptyState?: ReactNode | ((table: Table<TData>) => ReactNode);
+    /** Set to false to render every row, or configure virtual rows when scroller is "fill". */
+    virtualization?: false | {
+        estimateSize?: number;
+        overscan?: number;
+    };
+};
+/**
+ * TanStack options supported by this renderer. Grouping, pagination, selection,
+ * pinning, sizing, and faceting are intentionally outside this component's UI contract.
+ * Nested expansion is supported through getSubRows together with the tree presentation option.
+ */
+type BonelessTableOptions<TData extends RowData> = Omit<Pick<TableOptions<TData>, 'getRowId' | 'getCoreRowModel' | 'getFilteredRowModel' | 'getSortedRowModel' | 'getSubRows' | 'onSortingChange' | 'onColumnFiltersChange' | 'onColumnVisibilityChange' | 'onColumnOrderChange' | 'onExpandedChange' | 'manualSorting' | 'manualFiltering' | 'enableSorting' | 'enableMultiSort' | 'enableSortingRemoval' | 'enableMultiRemove' | 'maxMultiSortColCount' | 'filterFromLeafRows' | 'maxLeafRowFilterDepth' | 'isMultiSortEvent' | 'sortDescFirst' | 'sortingFns' | 'enableFilters' | 'filterFns' | 'defaultColumn' | 'renderFallbackValue' | 'meta' | 'debugTable' | 'debugHeaders' | 'debugColumns'>, 'getCoreRowModel' | 'getFilteredRowModel' | 'getSortedRowModel'> & Partial<Pick<TableOptions<TData>, 'getCoreRowModel' | 'getFilteredRowModel' | 'getSortedRowModel'>> & {
+    state?: Partial<Pick<TableState, 'sorting' | 'columnFilters' | 'columnVisibility' | 'columnOrder' | 'expanded'>>;
+    initialState?: Partial<Pick<TableState, 'sorting' | 'columnFilters' | 'columnVisibility' | 'columnOrder' | 'expanded'>>;
+};
+type BonelessTableProps<TData extends RowData> = BonelessTableOptions<TData> & BonelessTablePresentationOptions<TData> & {
+    data: TData[];
+    columns: BonelessTableColumn<TData>[];
+};
+declare function BonelessTable<TData extends RowData>({ data, columns, settings: settingsOverride, className, classNames, icons, tree: treeOption, isLoading, isFetchingMore, skeletonRows, skeletonLabel, onNearEnd, canLoadMore, nearEndOffset, filterDebounceMs, scroller, toolbar, toolbarLayout, footer, totalCount, resultLabel, resultHint, onReset, onRowClick, scrollToTopOn, rowLink, emptyState, virtualization, ...tableOptions }: BonelessTableProps<TData>): react.JSX.Element;
+
+declare function defineColumns<TData extends RowData>(columns: BonelessTableColumn<TData>[]): BonelessTableColumn<TData>[];
+declare function resolveColumns<TData extends RowData>(columns: BonelessTableColumn<TData>[]): ResolvedBonelessTableColumn<TData>[];
+declare function withDefaultCells<TData extends RowData>(columns: ResolvedBonelessTableColumn<TData>[]): ResolvedBonelessTableColumn<TData>[];
+declare function getColumnIds<TData extends RowData>(columns: BonelessTableColumn<TData>[]): string[];
+
+declare function ColumnFilter<TData extends RowData>({ column, settings, className, icon, debounceMs, }: {
+    column: Column<TData, unknown>;
+    settings: NonNullable<BonelessTableColumnSettings['filtering']>;
+    className?: string;
+    /** Optional consumer-owned icon rendered before a text input. */
+    icon?: ReactNode;
+    debounceMs?: number;
+}): react.JSX.Element;
+
+declare function TableSkeleton({ columnCount, rows, label, classNames, }: {
+    columnCount: number;
+    rows: number;
+    label?: string;
+    classNames?: Pick<BonelessTableClassNames, 'row' | 'cell' | 'skeleton'>;
+}): react.JSX.Element;
+
+export { BonelessTable, type BonelessTableClassNames, type BonelessTableColumn, type BonelessTableColumnSettings, type BonelessTableIcons, type BonelessTableOptions, type BonelessTablePresentationOptions, type BonelessTableProps, type BonelessTableRowClickEvent, type BonelessTableRowLink, type BonelessTableRowLinkComponentProps, type BonelessTableSettings, type BonelessTableSlot, type BonelessTableToolbarLayout, type BonelessTableTreeOptions, type ColumnAlignment, type ColumnBorders, ColumnFilter, ColumnMenu, type DeepPartial, type FilterType, type ResolvedBonelessTableColumn, type RevealMode, TableSkeleton, compactValue, defaultBonelessTableSettings, defineColumns, getColumnIds, mergeBonelessTableSettings, resolveColumnSettings, resolveColumns, resolveRowHref, resolveRowLinkLabel, withDefaultCells };

package/dist/index.d.ts

@@ -0,0 +1,258 @@
+import { RowData, ColumnDef, Table, TableOptions, TableState, Column } from '@tanstack/react-table';
+export { ColumnDef, ColumnFiltersState, ColumnOrderState, ExpandedState, SortingState, Table, TableOptions, VisibilityState, createColumnHelper, flexRender, getCoreRowModel, getExpandedRowModel, getFilteredRowModel, getSortedRowModel, useReactTable } from '@tanstack/react-table';
+import * as react from 'react';
+import { ReactNode, RefObject, ComponentType, AnchorHTMLAttributes, MouseEvent, KeyboardEvent } from 'react';
+
+type ColumnAlignment = 'left' | 'right';
+type ColumnBorders = 'none' | 'left' | 'right' | 'both';
+type FilterType = 'text' | 'select';
+type RevealMode = 'always' | 'hover';
+type BonelessTableColumnSizing = {
+    widthPx: number;
+} | {
+    minPx: number;
+    flex?: number;
+};
+type BonelessTableColumnSettings = {
+    sizing?: BonelessTableColumnSizing;
+    align?: ColumnAlignment;
+    borders?: ColumnBorders;
+    sorting?: {
+        enabled?: boolean;
+        reveal?: RevealMode;
+    };
+    filtering?: {
+        type: FilterType;
+        options?: readonly string[];
+        reveal?: RevealMode;
+    };
+    valueDisplay?: {
+        truncateAt: number;
+        suffix?: string;
+    };
+};
+type BonelessTableSettings = {
+    columnDefaults: Required<Pick<BonelessTableColumnSettings, 'align' | 'borders'>> & {
+        sizing: Required<NonNullable<BonelessTableColumnSettings['sizing']>>;
+        sorting: Required<NonNullable<BonelessTableColumnSettings['sorting']>>;
+    };
+    interactions: {
+        filterReveal: RevealMode;
+        horizontalOverflow: 'auto' | 'scroll';
+    };
+};
+declare const defaultBonelessTableSettings: BonelessTableSettings;
+declare function mergeBonelessTableSettings(override?: DeepPartial<BonelessTableSettings>, base?: BonelessTableSettings): BonelessTableSettings;
+declare function resolveColumnSettings(settings: BonelessTableSettings, column: {
+    columnDef: {
+        meta?: {
+            bonelessTable?: BonelessTableColumnSettings;
+        };
+    };
+}): {
+    sizing: {
+        minPx?: number | undefined;
+        flex?: number;
+        widthPx: number;
+    } | {
+        minPx: number;
+        flex: number;
+    };
+    align: ColumnAlignment;
+    borders: ColumnBorders;
+    sorting: {
+        enabled: boolean;
+        reveal: RevealMode;
+    };
+    filtering: {
+        type: FilterType;
+        options?: readonly string[];
+        reveal?: RevealMode;
+    } | undefined;
+    valueDisplay: {
+        truncateAt: number;
+        suffix?: string;
+    } | undefined;
+};
+declare function compactValue(value: unknown, settings?: BonelessTableColumnSettings): string;
+
+declare module '@tanstack/react-table' {
+    interface ColumnMeta<TData extends RowData, TValue> {
+        bonelessTable?: BonelessTableColumnSettings;
+        /** Accessible label used for this column in the built-in column chooser. */
+        columnLabel?: string;
+    }
+}
+/**
+ * A friendlier column input: use `key` for a data property instead of TanStack's `accessorKey`.
+ * `accessorKey` remains accepted for interoperability with existing TanStack column definitions.
+ */
+type BonelessTableColumn<TData extends RowData, TValue = unknown> = ColumnDef<TData, TValue> | (Omit<ColumnDef<TData, TValue>, 'accessorKey'> & {
+    key: keyof TData & string;
+});
+type ResolvedBonelessTableColumn<TData extends RowData, TValue = unknown> = ColumnDef<TData, TValue>;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+
+type ColumnMenuIcons = Partial<{
+    close: ReactNode;
+    moveEarlier: ReactNode;
+    moveLater: ReactNode;
+}>;
+declare function ColumnMenu<TData>({ table, onClose, onMoveColumn, className, icons, id, triggerRef, }: {
+    table: Table<TData>;
+    onClose: () => void;
+    onMoveColumn: (id: string, direction: -1 | 1) => void;
+    className?: string;
+    /** Optional consumer-owned icons. Text labels remain available without them. */
+    icons?: ColumnMenuIcons;
+    id?: string;
+    /** The menu trigger is not an outside click; this lets it reliably toggle the dialog closed. */
+    triggerRef?: RefObject<HTMLElement | null>;
+}): react.JSX.Element;
+
+type BonelessTableRowLinkComponentProps = {
+    children: ReactNode;
+    className: string;
+    href: string;
+    'aria-label'?: string;
+    target?: AnchorHTMLAttributes<HTMLAnchorElement>['target'];
+    rel?: string;
+};
+type BonelessTableRowLink<TData extends RowData> = {
+    /** A framework-specific component such as Next.js Link that wraps each resolved row. */
+    component: ComponentType<BonelessTableRowLinkComponentProps>;
+    href: string | ((row: TData) => string | undefined);
+    label?: string | ((row: TData) => string | undefined);
+    target?: AnchorHTMLAttributes<HTMLAnchorElement>['target'];
+    rel?: string;
+};
+declare function resolveRowHref<TData extends RowData>(link: Pick<BonelessTableRowLink<TData>, 'href'>, row: TData): string | undefined;
+declare function resolveRowLinkLabel<TData extends RowData>(link: Pick<BonelessTableRowLink<TData>, 'label'>, row: TData): string | undefined;
+
+type BonelessTableToolbarLayout<TData extends RowData> = (context: {
+    table: Table<TData>;
+    summary: ReactNode;
+    actions: ReactNode;
+}) => ReactNode;
+type BonelessTableSlot<TData extends RowData> = boolean | ReactNode | ((table: Table<TData>) => ReactNode);
+type BonelessTableRowClickEvent = MouseEvent<HTMLDivElement> | KeyboardEvent<HTMLDivElement>;
+/**
+ * Named hooks for your stylesheet. The renderer applies no default class names or visual styles.
+ */
+type BonelessTableClassNames = Partial<{
+    root: string;
+    toolbar: string;
+    toolbarSummary: string;
+    toolbarHint: string;
+    toolbarActions: string;
+    scroller: string;
+    table: string;
+    headerGroup: string;
+    headerRow: string;
+    header: string;
+    headerButton: string;
+    sortIndicator: string;
+    rowGroup: string;
+    row: string;
+    cell: string;
+    footer: string;
+    filter: string;
+    columnMenu: string;
+    rowLink: string;
+    emptyState: string;
+    skeleton: string;
+}>;
+/** Optional consumer-owned icons. Omit these for a text-only renderer. */
+type BonelessTableIcons = ColumnMenuIcons & {
+    reset?: ReactNode;
+    columns?: ReactNode;
+    search?: ReactNode;
+    sort?: (direction: false | 'asc' | 'desc') => ReactNode;
+    expand?: ReactNode;
+    collapse?: ReactNode;
+};
+type BonelessTableTreeOptions = {
+    /** Column that receives the in-cell indentation and row control. Defaults to the first visible column. */
+    columnId?: string;
+    /** Pixel increment per tree level. Indentation stays inside the cell and never changes the grid. */
+    indentPx?: number;
+    expandAllLabel?: string;
+    collapseAllLabel?: string;
+};
+type BonelessTablePresentationOptions<TData extends RowData> = {
+    settings?: DeepPartial<BonelessTableSettings>;
+    className?: string;
+    classNames?: BonelessTableClassNames;
+    icons?: BonelessTableIcons;
+    /** Enables nested row controls when used with TanStack's getSubRows option. */
+    tree?: boolean | BonelessTableTreeOptions;
+    isLoading?: boolean;
+    isFetchingMore?: boolean;
+    skeletonRows?: number;
+    skeletonLabel?: string;
+    onNearEnd?: () => void;
+    /** Enables onNearEnd. Keep this false while there is no next page or a request is in flight. */
+    canLoadMore?: boolean;
+    nearEndOffset?: number;
+    /** Delay text-filter updates to avoid recomputing large client-side row models on every keystroke. */
+    filterDebounceMs?: number;
+    /** Content-sized by default. Use fill only inside a parent that provides a stable height. */
+    scroller?: 'fill' | 'auto';
+    toolbar?: BonelessTableSlot<TData>;
+    /** Reposition the default summary and action controls without rebuilding their behavior. */
+    toolbarLayout?: BonelessTableToolbarLayout<TData>;
+    footer?: BonelessTableSlot<TData>;
+    totalCount?: number;
+    resultLabel?: string;
+    resultHint?: string;
+    onReset?: () => void;
+    onRowClick?: (row: TData, event: BonelessTableRowClickEvent) => void;
+    scrollToTopOn?: unknown;
+    rowLink?: BonelessTableRowLink<TData>;
+    /** Content shown when loading is complete and no rows match the current table state. */
+    emptyState?: ReactNode | ((table: Table<TData>) => ReactNode);
+    /** Set to false to render every row, or configure virtual rows when scroller is "fill". */
+    virtualization?: false | {
+        estimateSize?: number;
+        overscan?: number;
+    };
+};
+/**
+ * TanStack options supported by this renderer. Grouping, pagination, selection,
+ * pinning, sizing, and faceting are intentionally outside this component's UI contract.
+ * Nested expansion is supported through getSubRows together with the tree presentation option.
+ */
+type BonelessTableOptions<TData extends RowData> = Omit<Pick<TableOptions<TData>, 'getRowId' | 'getCoreRowModel' | 'getFilteredRowModel' | 'getSortedRowModel' | 'getSubRows' | 'onSortingChange' | 'onColumnFiltersChange' | 'onColumnVisibilityChange' | 'onColumnOrderChange' | 'onExpandedChange' | 'manualSorting' | 'manualFiltering' | 'enableSorting' | 'enableMultiSort' | 'enableSortingRemoval' | 'enableMultiRemove' | 'maxMultiSortColCount' | 'filterFromLeafRows' | 'maxLeafRowFilterDepth' | 'isMultiSortEvent' | 'sortDescFirst' | 'sortingFns' | 'enableFilters' | 'filterFns' | 'defaultColumn' | 'renderFallbackValue' | 'meta' | 'debugTable' | 'debugHeaders' | 'debugColumns'>, 'getCoreRowModel' | 'getFilteredRowModel' | 'getSortedRowModel'> & Partial<Pick<TableOptions<TData>, 'getCoreRowModel' | 'getFilteredRowModel' | 'getSortedRowModel'>> & {
+    state?: Partial<Pick<TableState, 'sorting' | 'columnFilters' | 'columnVisibility' | 'columnOrder' | 'expanded'>>;
+    initialState?: Partial<Pick<TableState, 'sorting' | 'columnFilters' | 'columnVisibility' | 'columnOrder' | 'expanded'>>;
+};
+type BonelessTableProps<TData extends RowData> = BonelessTableOptions<TData> & BonelessTablePresentationOptions<TData> & {
+    data: TData[];
+    columns: BonelessTableColumn<TData>[];
+};
+declare function BonelessTable<TData extends RowData>({ data, columns, settings: settingsOverride, className, classNames, icons, tree: treeOption, isLoading, isFetchingMore, skeletonRows, skeletonLabel, onNearEnd, canLoadMore, nearEndOffset, filterDebounceMs, scroller, toolbar, toolbarLayout, footer, totalCount, resultLabel, resultHint, onReset, onRowClick, scrollToTopOn, rowLink, emptyState, virtualization, ...tableOptions }: BonelessTableProps<TData>): react.JSX.Element;
+
+declare function defineColumns<TData extends RowData>(columns: BonelessTableColumn<TData>[]): BonelessTableColumn<TData>[];
+declare function resolveColumns<TData extends RowData>(columns: BonelessTableColumn<TData>[]): ResolvedBonelessTableColumn<TData>[];
+declare function withDefaultCells<TData extends RowData>(columns: ResolvedBonelessTableColumn<TData>[]): ResolvedBonelessTableColumn<TData>[];
+declare function getColumnIds<TData extends RowData>(columns: BonelessTableColumn<TData>[]): string[];
+
+declare function ColumnFilter<TData extends RowData>({ column, settings, className, icon, debounceMs, }: {
+    column: Column<TData, unknown>;
+    settings: NonNullable<BonelessTableColumnSettings['filtering']>;
+    className?: string;
+    /** Optional consumer-owned icon rendered before a text input. */
+    icon?: ReactNode;
+    debounceMs?: number;
+}): react.JSX.Element;
+
+declare function TableSkeleton({ columnCount, rows, label, classNames, }: {
+    columnCount: number;
+    rows: number;
+    label?: string;
+    classNames?: Pick<BonelessTableClassNames, 'row' | 'cell' | 'skeleton'>;
+}): react.JSX.Element;
+
+export { BonelessTable, type BonelessTableClassNames, type BonelessTableColumn, type BonelessTableColumnSettings, type BonelessTableIcons, type BonelessTableOptions, type BonelessTablePresentationOptions, type BonelessTableProps, type BonelessTableRowClickEvent, type BonelessTableRowLink, type BonelessTableRowLinkComponentProps, type BonelessTableSettings, type BonelessTableSlot, type BonelessTableToolbarLayout, type BonelessTableTreeOptions, type ColumnAlignment, type ColumnBorders, ColumnFilter, ColumnMenu, type DeepPartial, type FilterType, type ResolvedBonelessTableColumn, type RevealMode, TableSkeleton, compactValue, defaultBonelessTableSettings, defineColumns, getColumnIds, mergeBonelessTableSettings, resolveColumnSettings, resolveColumns, resolveRowHref, resolveRowLinkLabel, withDefaultCells };