@datum-cloud/datum-ui 1.0.0 → 1.2.0

package/dist/components/features/data-table/core/filter-engine.d.ts

@@ -13,9 +13,12 @@ interface FilterStrategies {
     [key: string]: FilterFn;
 }
 export declare const FILTER_STRATEGIES: FilterStrategies;
-export declare function applyFilters<TData>(data: TData[], filters: Record<string, unknown>, search: string, registeredFilters: Map<string, FilterStrategy>, customFilterFns: Record<string, FilterFn>, searchConfig: {
+export interface SearchConfig<TData> {
     searchFn?: (row: TData, query: string) => boolean;
     searchableColumns?: string[];
-}): TData[];
+}
+/** True when a row matches a free-text query (custom fn → columns → all values). */
+export declare function rowMatchesSearch<TData>(row: TData, search: string, config: SearchConfig<TData>): boolean;
+export declare function applyFilters<TData>(data: TData[], filters: Record<string, unknown>, search: string, registeredFilters: Map<string, FilterStrategy>, customFilterFns: Record<string, FilterFn>, searchConfig: SearchConfig<TData>): TData[];
 export {};
 //# sourceMappingURL=filter-engine.d.ts.map

package/dist/components/features/data-table/core/filter-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-engine.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/data-table/core/filter-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,KAAK,QAAQ,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,CAAA;AAErE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAW/D;AAED,UAAU,gBAAgB;IACxB,UAAU,EAAE,QAAQ,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,UAAU,EAAE,QAAQ,CAAA;IACpB,UAAU,EAAE,QAAQ,CAAA;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;CACxB;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAsC/B,CAAA;AAUD,wBAAgB,YAAY,CAAC,KAAK,EAChC,IAAI,EAAE,KAAK,EAAE,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAC9C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACzC,YAAY,EAAE;IACZ,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IACjD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC7B,GACA,KAAK,EAAE,CA0CT"}
+{"version":3,"file":"filter-engine.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/data-table/core/filter-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,KAAK,QAAQ,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,CAAA;AAErE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAW/D;AAED,UAAU,gBAAgB;IACxB,UAAU,EAAE,QAAQ,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,UAAU,EAAE,QAAQ,CAAA;IACpB,UAAU,EAAE,QAAQ,CAAA;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;CACxB;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAsC/B,CAAA;AAUD,MAAM,WAAW,YAAY,CAAC,KAAK;IACjC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IACjD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC7B;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EACpC,GAAG,EAAE,KAAK,EACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAC1B,OAAO,CAgBT;AAED,wBAAgB,YAAY,CAAC,KAAK,EAChC,IAAI,EAAE,KAAK,EAAE,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAC9C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACzC,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,GAChC,KAAK,EAAE,CA0BT"}

package/dist/components/features/data-table/index.d.ts

@@ -1,7 +1,11 @@
 export { useNuqsAdapter } from './adapters/nuqs-adapter';
 export type { UseNuqsAdapterOptions } from './adapters/nuqs-adapter';
 export { createSelectionColumn } from './columns/selection-column';
+export { DataTableColumnHeader } from './components/column-header';
+export { DataTableRowActions } from './components/row-actions';
 export { DEFAULT_DEBOUNCE_MS, DEFAULT_LOADING_ROWS, DEFAULT_PAGE_SIZE, DEFAULT_PAGE_SIZES, } from './constants';
+export { resolvePath, rowMatchesSearch } from './core/filter-engine';
+export type { SearchConfig } from './core/filter-engine';
 export { createDataTableStore } from './core/store';
 export { DataTable } from './data-table';
 export { useDataTableFilters, useDataTableInlineContents, useDataTableLoading, useDataTablePagination, useDataTableRows, useDataTableSearch, useDataTableSelection, useDataTableSorting, } from './hooks/use-selectors';

package/dist/components/features/data-table/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/features/data-table/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAGlE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAA;AAG9B,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/features/data-table/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAG9D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEpE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAA;AAG9B,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,SAAS,CAAA"}

package/dist/components/features/grouped-table/components/grouped-skeleton.d.ts

@@ -0,0 +1,7 @@
+export interface GroupedSkeletonProps {
+    columns?: number;
+    groups?: number;
+    rowsPerGroup?: number;
+}
+export declare function GroupedSkeleton({ columns, groups, rowsPerGroup }: GroupedSkeletonProps): import("react").JSX.Element;
+//# sourceMappingURL=grouped-skeleton.d.ts.map

package/dist/components/features/grouped-table/components/grouped-skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped-skeleton.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/grouped-table/components/grouped-skeleton.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,eAAe,CAAC,EAAE,OAAW,EAAE,MAAU,EAAE,YAAgB,EAAE,EAAE,oBAAoB,+BA2BlG"}

package/dist/components/features/grouped-table/components/grouped-toolbar.d.ts

@@ -0,0 +1,9 @@
+export interface GroupedToolbarProps {
+    search: string;
+    onSearchChange: (value: string) => void;
+    placeholder?: string;
+    debounceMs?: number;
+    className?: string;
+}
+export declare function GroupedToolbar({ search, onSearchChange, placeholder, debounceMs, className, }: GroupedToolbarProps): import("react").JSX.Element;
+//# sourceMappingURL=grouped-toolbar.d.ts.map

package/dist/components/features/grouped-table/components/grouped-toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped-toolbar.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/grouped-table/components/grouped-toolbar.tsx"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,cAAc,EACd,WAAyB,EACzB,UAAgC,EAChC,SAAS,GACV,EAAE,mBAAmB,+BA0BrB"}

package/dist/components/features/grouped-table/grouped-table.d.ts

@@ -0,0 +1,3 @@
+import type { GroupedTableProps } from './types';
+export declare function GroupedTable<TData>(props: GroupedTableProps<TData>): import("react").JSX.Element;
+//# sourceMappingURL=grouped-table.d.ts.map

package/dist/components/features/grouped-table/grouped-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped-table.d.ts","sourceRoot":"","sources":["../../../../src/components/features/grouped-table/grouped-table.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAoDhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,+BAyLlE"}

package/dist/components/features/grouped-table/index.d.ts

@@ -0,0 +1,3 @@
+export { GroupedTable } from './grouped-table';
+export type { DefaultExpanded, GroupedTableGroup, GroupedTableProps } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/grouped-table/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/features/grouped-table/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA"}

package/dist/components/features/grouped-table/lib/bucket-rows.d.ts

@@ -0,0 +1,14 @@
+import type { Row } from '@tanstack/react-table';
+interface GroupLike {
+    id: string;
+    rows: unknown[];
+}
+/**
+ * Build per-group buckets of `filteredRows`, preserving the filtered order.
+ * `coreRows` are the unfiltered rows in group-concatenated order; we use their
+ * positions to learn which row id belongs to which group, so bucketing is correct
+ * regardless of a custom getRowId.
+ */
+export declare function bucketRows<TData>(groups: GroupLike[], coreRows: Row<TData>[], filteredRows: Row<TData>[]): Map<string, Row<TData>[]>;
+export {};
+//# sourceMappingURL=bucket-rows.d.ts.map

package/dist/components/features/grouped-table/lib/bucket-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket-rows.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/grouped-table/lib/bucket-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAEhD,UAAU,SAAS;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE;AAEnD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,EACtB,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,GACzB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAmB3B"}

package/dist/components/features/grouped-table/lib/compose-columns.d.ts

@@ -0,0 +1,11 @@
+import type { ColumnDef } from '@tanstack/react-table';
+import type { SelectionColumnOptions } from '../../data-table/types';
+import type { ActionItem } from '../../more-actions/types';
+export interface ComposeOptions<TData> {
+    enableRowSelection?: boolean | SelectionColumnOptions;
+    enableSorting?: boolean;
+    rowActions?: (row: TData) => ActionItem<TData>[];
+    rowActionsSheetTitle?: string;
+}
+export declare function composeColumns<TData>(columns: ColumnDef<TData, unknown>[], options: ComposeOptions<TData>): ColumnDef<TData, unknown>[];
+//# sourceMappingURL=compose-columns.d.ts.map

package/dist/components/features/grouped-table/lib/compose-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-columns.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/grouped-table/lib/compose-columns.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAG1D,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,kBAAkB,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;IACrD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,UAAU,CAAC,KAAK,CAAC,EAAE,CAAA;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAgBD,wBAAgB,cAAc,CAAC,KAAK,EAClC,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EACpC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAC7B,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CA4B7B"}

package/dist/components/features/grouped-table/lib/sort-rows.d.ts

@@ -0,0 +1,7 @@
+import type { Row, SortingState } from '@tanstack/react-table';
+/**
+ * Sort a single group's rows by the active sort (first entry; v1 is single-sort).
+ * Returns the same reference when there is no sort, so React can skip re-renders.
+ */
+export declare function sortRows<TData>(rows: Row<TData>[], sorting: SortingState): Row<TData>[];
+//# sourceMappingURL=sort-rows.d.ts.map

package/dist/components/features/grouped-table/lib/sort-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-rows.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/grouped-table/lib/sort-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAc9D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAQvF"}

package/dist/components/features/grouped-table/lib/use-controllable-state.d.ts

@@ -0,0 +1,8 @@
+export type Updater<T> = T | ((prev: T) => T);
+/**
+ * Uncontrolled-by-default state with an optional controlled override.
+ * When `controlled` is undefined the hook owns the value; otherwise the prop wins.
+ * `onChange` always fires. Accepts TanStack-style updater functions.
+ */
+export declare function useControllableState<T>(controlled: T | undefined, defaultValue: T, onChange?: (value: T) => void): readonly [T, (next: Updater<T>) => void];
+//# sourceMappingURL=use-controllable-state.d.ts.map

package/dist/components/features/grouped-table/lib/use-controllable-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-controllable-state.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/grouped-table/lib/use-controllable-state.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;AAE7C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,UAAU,EAAE,CAAC,GAAG,SAAS,EACzB,YAAY,EAAE,CAAC,EACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC5B,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAiB1C"}

package/dist/components/features/grouped-table/types.d.ts

@@ -0,0 +1,74 @@
+import type { Cell, ColumnDef, Row, RowSelectionState, SortingState } from '@tanstack/react-table';
+import type { ReactNode } from 'react';
+import type { SelectionColumnOptions } from '../data-table/types';
+import type { ActionItem } from '../more-actions/types';
+export type DefaultExpanded = 'all' | 'none' | string[];
+export interface GroupedTableGroup<TData> {
+    /** Stable key used for expand state. */
+    id: string;
+    /** Group header label. */
+    title: ReactNode;
+    /** Right-aligned header slot — count, badges, actions. */
+    meta?: ReactNode;
+    rows: TData[];
+    /** Per-group override of the table-level default. */
+    defaultOpen?: boolean;
+}
+export interface GroupedTableProps<TData> {
+    /** TanStack column defs. `size` (px) drives the shared grid template; unsized columns flex. */
+    columns: ColumnDef<TData, unknown>[];
+    groups: GroupedTableGroup<TData>[];
+    /** Uncontrolled initial state. Default `'all'`. A string[] opens exactly those ids. */
+    defaultExpanded?: DefaultExpanded;
+    /** Controlled open ids. When set, the component does not own expansion state. */
+    expanded?: string[];
+    onExpandedChange?: (openIds: string[]) => void;
+    /**
+     * Stable row identity, passed through to TanStack. Supply this when consumers
+     * reorder rows or groups so React keys stay stable across renders instead of
+     * defaulting to the flattened row index.
+     */
+    getRowId?: (row: TData, index: number) => string;
+    /** Prepend a checkbox column; pass options to customize. */
+    enableRowSelection?: boolean | SelectionColumnOptions;
+    rowSelection?: RowSelectionState;
+    onRowSelectionChange?: (selection: RowSelectionState) => void;
+    /** Append a "⋯" actions column. Receives the row to allow conditional actions. */
+    rowActions?: (row: TData) => ActionItem<TData>[];
+    rowActionsSheetTitle?: string;
+    /** Enable sortable headers; sorting is applied within each group. */
+    enableSorting?: boolean;
+    sorting?: SortingState;
+    onSortingChange?: (sorting: SortingState) => void;
+    /** Render a built-in debounced search input above the table. */
+    enableSearch?: boolean;
+    searchPlaceholder?: string;
+    searchableColumns?: string[];
+    searchFn?: (row: TData, query: string) => boolean;
+    search?: string;
+    onSearchChange?: (search: string) => void;
+    searchDebounceMs?: number;
+    /** Render a skeleton instead of rows. */
+    isLoading?: boolean;
+    /** Rendered when there are no groups, every group is empty, or search clears everything. */
+    empty?: ReactNode;
+    /** Root wrapper. */
+    className?: string;
+    /** Search toolbar wrapper (when `enableSearch`). */
+    toolbarClassName?: string;
+    /** Every `<table>` element (shared header + each group body). */
+    tableClassName?: string;
+    /** The column-header `<tr>`. */
+    headerRowClassName?: string;
+    /** Each column-header `<th>`. */
+    headerCellClassName?: string;
+    /** Each group's collapsible header band; receives the group for per-group styling. */
+    groupHeaderClassName?: string | ((group: GroupedTableGroup<TData>) => string);
+    /** Each group's `<tbody>`. */
+    bodyClassName?: string;
+    /** Each data `<tr>`; receives the row for per-row styling. */
+    rowClassName?: string | ((row: Row<TData>) => string);
+    /** Each data `<td>`; receives the cell for per-cell styling. */
+    cellClassName?: string | ((cell: Cell<TData, unknown>) => string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/features/grouped-table/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/features/grouped-table/types.ts"],"names":[],"mappings":"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"}

package/dist/components/features/grouped-table/use-grouped-expansion.d.ts

@@ -0,0 +1,10 @@
+import type { DefaultExpanded, GroupedTableGroup } from './types';
+export declare function useGroupedExpansion<TData>(groups: GroupedTableGroup<TData>[], opts: {
+    defaultExpanded?: DefaultExpanded;
+    expanded?: string[];
+    onExpandedChange?: (ids: string[]) => void;
+}): {
+    isOpen: (id: string) => boolean;
+    toggle: (id: string) => void;
+};
+//# sourceMappingURL=use-grouped-expansion.d.ts.map

package/dist/components/features/grouped-table/use-grouped-expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-grouped-expansion.d.ts","sourceRoot":"","sources":["../../../../src/components/features/grouped-table/use-grouped-expansion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAajE,wBAAgB,mBAAmB,CAAC,KAAK,EACvC,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAClC,IAAI,EAAE;IAAE,eAAe,CAAC,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;CAAE;iBAQ5E,MAAM,KAAG,OAAO;iBAShB,MAAM;EASvC"}