@ackplus/mui-tanstack-data-grid 1.0.0

package/dist/types/data-table.types.d.ts

@@ -0,0 +1,161 @@
+import type { ReactNode, MouseEvent, RefObject } from 'react';
+import type { Row, SortingState, ColumnResizeMode, ColumnPinningState, PaginationState, ColumnDef } from '@tanstack/react-table';
+import type { DataTableDensity } from '../theme/tokens';
+import type { ColumnFilterState } from './filter.types';
+import type { SelectionState, SelectMode } from './selection.types';
+import type { DataTableLoggingOptions } from './logging.types';
+import type { DataTableApi } from './api.types';
+import type { DataTableSlots, PartialSlotProps } from './slots.types';
+import type { ExportConcurrencyMode, ExportProgressPayload, ExportStateChange, ServerExportResult } from './export.types';
+import type { TableState, TableFilters, DataFetchMeta, DataRefreshContext } from './state.types';
+/**
+ * Props for the `<DataTable>` component.
+ *
+ * Naming conventions: `enableX` = feature toggle · `onXChange` = state callback ·
+ * `xMode` = client/server · `renderX` = render function · plain adjectives
+ * (`striped`, `hover`) = visual modifiers. v1 names are kept as `@deprecated`
+ * aliases and removed in v3.
+ */
+export interface DataTableProps<T> {
+    /** Column definitions. */
+    columns: ColumnDef<T, any>[];
+    /** Row data (client mode). */
+    data?: T[];
+    /** Total row count for server mode. */
+    rowCount?: number;
+    /** Returns a stable id for a row. Defaults to `row[idKey]`. */
+    getRowId?: (row: T, index: number) => string;
+    /** Shorthand for `getRowId` when the id is a single field (default: `'id'`). */
+    idKey?: keyof T;
+    extraFilter?: ReactNode | null;
+    footerFilter?: ReactNode | null;
+    /** @deprecated Renamed to `rowCount`. */
+    totalRow?: number;
+    dataMode?: 'client' | 'server';
+    initialState?: Partial<TableState>;
+    initialLoadData?: boolean;
+    onDataStateChange?: (state: Partial<TableState>) => void;
+    onFetchData?: (filters: Partial<TableFilters>, meta?: DataFetchMeta) => Promise<{
+        data: T[];
+        total: number;
+    }>;
+    onFetchStateChange?: (filters: Partial<TableState>, options?: DataFetchMeta) => void;
+    onRefreshData?: (context: DataRefreshContext) => void | Promise<void>;
+    exportFilename?: string;
+    exportConcurrency?: ExportConcurrencyMode;
+    exportChunkSize?: number;
+    exportStrictTotalCheck?: boolean;
+    exportSanitizeCSV?: boolean;
+    onExportProgress?: (progress: ExportProgressPayload) => void;
+    onExportComplete?: (result: {
+        success: boolean;
+        filename: string;
+        totalRows: number;
+    }) => void;
+    onExportError?: (error: {
+        message: string;
+        code: string;
+    }) => void;
+    onExportStateChange?: (state: ExportStateChange) => void;
+    onServerExport?: (filters?: Partial<TableState>, selection?: SelectionState, signal?: AbortSignal) => Promise<ServerExportResult<any>>;
+    onExportCancel?: () => void;
+    enableRowSelection?: boolean | ((row: Row<T>) => boolean);
+    enableMultiRowSelection?: boolean;
+    selectMode?: SelectMode;
+    isRowSelectable?: (params: {
+        row: T;
+        id: string;
+    }) => boolean;
+    onSelectionChange?: (selection: SelectionState) => void;
+    onRowClick?: (event: MouseEvent<HTMLDivElement>, row: Row<T>) => void;
+    selectOnRowClick?: boolean;
+    enableBulkActions?: boolean;
+    renderBulkActions?: (selectionState: SelectionState) => ReactNode;
+    /** @deprecated Renamed to `renderBulkActions`. */
+    bulkActions?: (selectionState: SelectionState) => ReactNode;
+    enableColumnResizing?: boolean;
+    columnResizeMode?: ColumnResizeMode;
+    onColumnSizingChange?: (sizing: Record<string, number>) => void;
+    enableColumnReordering?: boolean;
+    onColumnOrderChange?: (columnOrder: string[]) => void;
+    /** @deprecated Renamed to `enableColumnReordering`. */
+    enableColumnDragging?: boolean;
+    /** @deprecated Renamed to `onColumnOrderChange`. */
+    onColumnDragEnd?: (columnOrder: string[]) => void;
+    enableColumnPinning?: boolean;
+    onColumnPinningChange?: (pinning: ColumnPinningState) => void;
+    enableColumnVisibility?: boolean;
+    onColumnVisibilityChange?: (visibility: Record<string, boolean>) => void;
+    enableRowExpansion?: boolean;
+    getRowCanExpand?: (row: Row<T>) => boolean;
+    renderDetailPanel?: (row: Row<T>) => ReactNode;
+    /** @deprecated Renamed to `enableRowExpansion`. */
+    enableExpanding?: boolean;
+    /** @deprecated Renamed to `renderDetailPanel`. */
+    renderSubComponent?: (row: Row<T>) => ReactNode;
+    enablePagination?: boolean;
+    paginationMode?: 'client' | 'server';
+    onPaginationChange?: (pagination: PaginationState) => void;
+    enableGlobalFilter?: boolean;
+    enableColumnFilter?: boolean;
+    filterMode?: 'client' | 'server';
+    onColumnFilterChange?: (state: ColumnFilterState, isApplied?: boolean) => void;
+    onGlobalFilterChange?: (globalFilter: string) => void;
+    /** @deprecated Use `onColumnFilterChange` (its second arg is `isApplied`). */
+    onColumnFiltersChange?: (filterState: ColumnFilterState, isApplied?: boolean) => void;
+    enableSorting?: boolean;
+    sortingMode?: 'client' | 'server';
+    onSortingChange?: (sorting: SortingState) => void;
+    /** Row density. Maps v1 `small`→`compact`, `medium`→`standard`. */
+    density?: DataTableDensity;
+    hover?: boolean;
+    striped?: boolean;
+    /** Columns stretch to fill the width (and still respect min/max). */
+    fitToScreen?: boolean;
+    /** @deprecated Renamed to `density` (`small`→`compact`, `medium`→`standard`). */
+    tableSize?: 'small' | 'medium';
+    /** @deprecated Renamed to `hover`. */
+    enableHover?: boolean;
+    /** @deprecated Renamed to `striped`. */
+    enableStripes?: boolean;
+    /** Conditional class for a row. */
+    getRowClassName?: (params: {
+        row: Row<T>;
+        index: number;
+    }) => string;
+    /** Conditional class for a cell. */
+    getCellClassName?: (params: {
+        row: Row<T>;
+        columnId: string;
+        value: any;
+    }) => string;
+    stickyHeader?: boolean;
+    stickyFooter?: boolean;
+    maxHeight?: string | number;
+    /** @deprecated Renamed to `stickyHeader`. */
+    enableStickyHeaderOrFooter?: boolean;
+    enableVirtualization?: boolean;
+    estimatedRowHeight?: number;
+    /** @deprecated Renamed to `estimatedRowHeight`. */
+    estimateRowHeight?: number;
+    enableDensitySelector?: boolean;
+    enableExport?: boolean;
+    enableReset?: boolean;
+    enableRefresh?: boolean;
+    /** @deprecated Renamed to `enableDensitySelector`. */
+    enableTableSizeControl?: boolean;
+    loading?: boolean;
+    noRowsMessage?: string | ReactNode;
+    skeletonRows?: number;
+    /** @deprecated Renamed to `noRowsMessage`. */
+    emptyMessage?: string | ReactNode;
+    slots?: Partial<DataTableSlots>;
+    slotProps?: PartialSlotProps;
+    /** Imperative handle (data CRUD, selection, sorting, export, …). */
+    apiRef?: RefObject<DataTableApi<T> | null>;
+    /** Per-instance style overrides on the root. */
+    sx?: Record<string, any>;
+    className?: string;
+    logging?: boolean | DataTableLoggingOptions;
+}
+//# sourceMappingURL=data-table.types.d.ts.map

package/dist/types/data-table.types.d.ts.map

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

package/dist/types/data-table.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/export.types.d.ts

@@ -0,0 +1,32 @@
+export type ExportFormat = 'csv' | 'excel';
+export type ExportConcurrencyMode = 'ignoreIfRunning' | 'cancelAndRestart' | 'queue';
+export type ExportPhase = 'starting' | 'fetching' | 'processing' | 'downloading' | 'completed' | 'cancelled' | 'error';
+export interface ExportProgressPayload {
+    processedRows?: number;
+    totalRows?: number;
+    percentage?: number;
+}
+export interface ExportStateChange {
+    phase: ExportPhase;
+    mode?: 'client' | 'server';
+    format?: ExportFormat;
+    filename?: string;
+    processedRows?: number;
+    totalRows?: number;
+    percentage?: number;
+    message?: string;
+    code?: string;
+    startedAt?: number;
+    endedAt?: number;
+}
+export type ServerExportResult<T = any> = {
+    data: T[];
+    total?: number;
+} | {
+    blob: Blob;
+    filename?: string;
+} | {
+    fileUrl: string;
+    filename?: string;
+};
+//# sourceMappingURL=export.types.d.ts.map

package/dist/types/export.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.types.d.ts","sourceRoot":"","sources":["../../src/types/export.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,OAAO,CAAC;AAErF,MAAM,MAAM,WAAW,GACjB,UAAU,GACV,UAAU,GACV,YAAY,GACZ,aAAa,GACb,WAAW,GACX,WAAW,GACX,OAAO,CAAC;AAEd,MAAM,WAAW,qBAAqB;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAChC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/export.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/filter.types.d.ts

@@ -0,0 +1,15 @@
+export type ColumnFilterLogic = 'AND' | 'OR';
+export interface ColumnFilterRule {
+    id: string;
+    columnId: string;
+    operator: string;
+    value: any;
+    columnType?: string;
+}
+export interface ColumnFilterState {
+    filters: ColumnFilterRule[];
+    logic: ColumnFilterLogic;
+    pendingFilters: ColumnFilterRule[];
+    pendingLogic: ColumnFilterLogic;
+}
+//# sourceMappingURL=filter.types.d.ts.map

package/dist/types/filter.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.types.d.ts","sourceRoot":"","sources":["../../src/types/filter.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE,iBAAiB,CAAC;IACzB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,YAAY,EAAE,iBAAiB,CAAC;CACnC"}

package/dist/types/filter.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export * from './selection.types';
+export * from './filter.types';
+export * from './export.types';
+export * from './logging.types';
+export * from './state.types';
+export * from './column.types';
+export * from './slots.types';
+export * from './api.types';
+export * from './data-table.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./selection.types"), exports);
+__exportStar(require("./filter.types"), exports);
+__exportStar(require("./export.types"), exports);
+__exportStar(require("./logging.types"), exports);
+__exportStar(require("./state.types"), exports);
+__exportStar(require("./column.types"), exports);
+__exportStar(require("./slots.types"), exports);
+__exportStar(require("./api.types"), exports);
+__exportStar(require("./data-table.types"), exports);

package/dist/types/logging.types.d.ts

@@ -0,0 +1,23 @@
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+export interface ConsoleLike {
+    debug?: (...args: unknown[]) => void;
+    info?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    log?: (...args: unknown[]) => void;
+}
+export interface DataTableLoggingOptions {
+    /** Whether logging is enabled. */
+    enabled?: boolean;
+    /** Minimum level emitted (default: `warn`). */
+    level?: LogLevel;
+    /** Prefix on every message (default: `DataTable`). */
+    prefix?: string;
+    /** Optional scope appended after the prefix. */
+    scope?: string;
+    /** Prepend an ISO timestamp. */
+    includeTimestamp?: boolean;
+    /** Custom logger backend (default: `console`). */
+    logger?: ConsoleLike;
+}
+//# sourceMappingURL=logging.types.d.ts.map

package/dist/types/logging.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.types.d.ts","sourceRoot":"","sources":["../../src/types/logging.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACpC,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB"}

package/dist/types/logging.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/selection.types.d.ts

@@ -0,0 +1,7 @@
+export type SelectMode = 'page' | 'all';
+export interface SelectionState {
+    ids: string[];
+    type: 'include' | 'exclude';
+    selectMode?: SelectMode;
+}
+//# sourceMappingURL=selection.types.d.ts.map

package/dist/types/selection.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.types.d.ts","sourceRoot":"","sources":["../../src/types/selection.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAExC,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B"}

package/dist/types/selection.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/slots.types.d.ts

@@ -0,0 +1,41 @@
+import type { ComponentType } from 'react';
+/**
+ * Replaceable sub-components. Pass a component to fully swap a part; pair with
+ * `slotProps` to inject props/`sx` without replacing it. (MUI `slots`/`slotProps` pattern.)
+ *
+ * The index signature keeps this extensible while the full set is filled in across phases.
+ */
+export interface DataTableSlots {
+    root?: ComponentType<any>;
+    scroller?: ComponentType<any>;
+    grid?: ComponentType<any>;
+    header?: ComponentType<any>;
+    headerRow?: ComponentType<any>;
+    headerCell?: ComponentType<any>;
+    body?: ComponentType<any>;
+    row?: ComponentType<any>;
+    cell?: ComponentType<any>;
+    detailPanel?: ComponentType<any>;
+    footer?: ComponentType<any>;
+    pagination?: ComponentType<any>;
+    loadingOverlay?: ComponentType<any>;
+    noRowsOverlay?: ComponentType<any>;
+    toolbar?: ComponentType<any>;
+    searchInput?: ComponentType<any>;
+    columnVisibilityControl?: ComponentType<any>;
+    columnFilterControl?: ComponentType<any>;
+    columnPinningControl?: ComponentType<any>;
+    densityControl?: ComponentType<any>;
+    resetButton?: ComponentType<any>;
+    refreshButton?: ComponentType<any>;
+    exportButton?: ComponentType<any>;
+    bulkActionsToolbar?: ComponentType<any>;
+    sortIconAsc?: ComponentType<any>;
+    sortIconDesc?: ComponentType<any>;
+    [slot: string]: ComponentType<any> | undefined;
+}
+export type DataTableSlotProps = {
+    [K in keyof DataTableSlots]?: Record<string, any>;
+};
+export type PartialSlotProps = DataTableSlotProps;
+//# sourceMappingURL=slots.types.d.ts.map

package/dist/types/slots.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.types.d.ts","sourceRoot":"","sources":["../../src/types/slots.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAE3B,IAAI,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,SAAS,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC1B,GAAG,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAEhC,cAAc,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAEnC,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,uBAAuB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7C,mBAAmB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACzC,oBAAoB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,kBAAkB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAExC,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAElC,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,MAAM,kBAAkB,GAAG;KAC5B,CAAC,IAAI,MAAM,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,CAAC"}

package/dist/types/slots.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/state.types.d.ts

@@ -0,0 +1,46 @@
+import type { SortingState, ColumnPinningState, ColumnOrderState, VisibilityState } from '@tanstack/react-table';
+import type { ColumnFilterState } from './filter.types';
+import type { SelectionState } from './selection.types';
+export interface PaginationModel {
+    pageIndex: number;
+    pageSize: number;
+}
+/** Full controllable table-state snapshot. */
+export interface TableState {
+    sorting?: SortingState;
+    pagination?: PaginationModel;
+    globalFilter?: string;
+    columnFilter?: ColumnFilterState;
+    columnVisibility?: VisibilityState;
+    columnSizing?: Record<string, number>;
+    columnOrder?: ColumnOrderState;
+    columnPinning?: ColumnPinningState;
+    selectionState?: SelectionState;
+    expanded?: Record<string, boolean>;
+}
+/** Normalised filter/state passed to the server fetch handler. */
+export interface TableFilters {
+    globalFilter?: string;
+    pagination?: PaginationModel;
+    columnFilter?: ColumnFilterState;
+    sorting?: SortingState;
+}
+export type DataRefreshReason = 'initial' | 'state-change' | 'refresh' | 'reload' | 'reset' | (string & {});
+export interface DataFetchMeta {
+    reason?: DataRefreshReason;
+    delay?: number;
+    force?: boolean;
+}
+export interface DataRefreshOptions extends DataFetchMeta {
+    resetPagination?: boolean;
+}
+export interface DataRefreshContext {
+    filters: Partial<TableFilters>;
+    state: Partial<TableState>;
+    options: {
+        resetPagination: boolean;
+        force: boolean;
+        reason: string;
+    };
+}
+//# sourceMappingURL=state.types.d.ts.map

package/dist/types/state.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.types.d.ts","sourceRoot":"","sources":["../../src/types/state.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,OAAO,CAAC,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5G,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE"}

package/dist/types/state.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/column-helpers.d.ts

@@ -0,0 +1,9 @@
+import type { Column, ColumnDef } from '@tanstack/react-table';
+export type ColumnType = 'text' | 'number' | 'date' | 'boolean' | 'select' | 'actions';
+export declare function getColumnType(column: Column<any, unknown>): ColumnType;
+export declare function getCustomFilterComponent(column: Column<any, unknown>): any;
+export declare function getColumnOptions(column: Column<any, unknown>): any[];
+/** Ensure every column (and nested group) has a stable `id`. */
+export declare function withIdsDeep<T>(cols: ColumnDef<T, any>[]): ColumnDef<T, any>[];
+export declare function isColumnFilterable(column: Column<any, unknown>): boolean;
+//# sourceMappingURL=column-helpers.d.ts.map

package/dist/utils/column-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/column-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,UAAU,CAGtE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,CAE1E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,EAAE,CASpE;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAM7E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,OAAO,CAGxE"}

package/dist/utils/column-helpers.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getColumnType = getColumnType;
+exports.getCustomFilterComponent = getCustomFilterComponent;
+exports.getColumnOptions = getColumnOptions;
+exports.withIdsDeep = withIdsDeep;
+exports.isColumnFilterable = isColumnFilterable;
+function getColumnType(column) {
+    var _a;
+    if ((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.type)
+        return column.columnDef.type;
+    return 'text';
+}
+function getCustomFilterComponent(column) {
+    var _a, _b;
+    return ((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.filterComponent) || ((_b = column === null || column === void 0 ? void 0 : column.columnDef) === null || _b === void 0 ? void 0 : _b.editComponent);
+}
+function getColumnOptions(column) {
+    var _a;
+    if ((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.options)
+        return column.columnDef.options || [];
+    if (getColumnType(column) === 'boolean') {
+        return [
+            { value: true, label: 'Yes' },
+            { value: false, label: 'No' },
+        ];
+    }
+    return [];
+}
+/** Ensure every column (and nested group) has a stable `id`. */
+function withIdsDeep(cols) {
+    return cols.map((c, i) => {
+        var _a, _b;
+        return ({
+            ...c,
+            id: (_b = (_a = c.id) !== null && _a !== void 0 ? _a : c.accessorKey) !== null && _b !== void 0 ? _b : `col_${i}`,
+            ...(Array.isArray(c.columns) && { columns: withIdsDeep(c.columns) }),
+        });
+    });
+}
+function isColumnFilterable(column) {
+    var _a;
+    if (((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.filterable) !== undefined)
+        return column.columnDef.filterable;
+    return true;
+}

package/dist/utils/debounced-fetch.utils.d.ts

@@ -0,0 +1,22 @@
+import type { DataFetchMeta, TableFilters } from '../types/state.types';
+interface DebouncedFetchOptions {
+    debounceDelay?: number;
+    meta?: DataFetchMeta;
+}
+interface UseDebouncedFetchReturn<T extends Record<string, any>> {
+    debouncedFetch: (filters: Partial<TableFilters>, optionsOrDelay?: number | DebouncedFetchOptions) => Promise<{
+        data: T[];
+        total: number;
+    } | null>;
+    isLoading: boolean;
+}
+/**
+ * Debounced, race-safe fetch hook: collapses rapid state changes into one call
+ * and ignores stale responses. Ported from v1 unchanged.
+ */
+export declare function useDebouncedFetch<T extends Record<string, any>>(onFetchData: ((filters: Partial<TableFilters>, meta?: DataFetchMeta) => Promise<{
+    data: T[];
+    total: number;
+}>) | undefined): UseDebouncedFetchReturn<T>;
+export {};
+//# sourceMappingURL=debounced-fetch.utils.d.ts.map

package/dist/utils/debounced-fetch.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounced-fetch.utils.d.ts","sourceRoot":"","sources":["../../src/utils/debounced-fetch.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIxE,UAAU,qBAAqB;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,UAAU,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3D,cAAc,EAAE,CACZ,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,qBAAqB,KAC9C,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAClD,SAAS,EAAE,OAAO,CAAC;CACtB;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,WAAW,EACL,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GACjG,SAAS,GAChB,uBAAuB,CAAC,CAAC,CAAC,CA+E5B"}

package/dist/utils/debounced-fetch.utils.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDebouncedFetch = useDebouncedFetch;
+const react_1 = require("react");
+const DEFAULT_DEBOUNCE_DELAY = 300;
+/**
+ * Debounced, race-safe fetch hook: collapses rapid state changes into one call
+ * and ignores stale responses. Ported from v1 unchanged.
+ */
+function useDebouncedFetch(onFetchData) {
+    const [isLoading, setIsLoading] = (0, react_1.useState)(false);
+    const debounceTimer = (0, react_1.useRef)(null);
+    const pendingRequestRef = (0, react_1.useRef)(null);
+    const latestRequestIdRef = (0, react_1.useRef)(0);
+    const activeRequestCountRef = (0, react_1.useRef)(0);
+    const isMountedRef = (0, react_1.useRef)(true);
+    const resetLoadingIfIdle = (0, react_1.useCallback)(() => {
+        if (!isMountedRef.current)
+            return;
+        if (!debounceTimer.current && !pendingRequestRef.current && activeRequestCountRef.current === 0) {
+            setIsLoading(false);
+        }
+    }, []);
+    const debouncedFetch = (0, react_1.useCallback)(async (filters, optionsOrDelay = DEFAULT_DEBOUNCE_DELAY) => {
+        var _a;
+        if (!onFetchData)
+            return null;
+        const options = typeof optionsOrDelay === 'number' ? { debounceDelay: optionsOrDelay } : optionsOrDelay;
+        const debounceDelay = (_a = options.debounceDelay) !== null && _a !== void 0 ? _a : DEFAULT_DEBOUNCE_DELAY;
+        const requestId = latestRequestIdRef.current + 1;
+        latestRequestIdRef.current = requestId;
+        if (debounceTimer.current) {
+            clearTimeout(debounceTimer.current);
+            debounceTimer.current = null;
+        }
+        if (pendingRequestRef.current) {
+            pendingRequestRef.current.resolve(null);
+            pendingRequestRef.current = null;
+        }
+        setIsLoading(true);
+        return new Promise((resolve, reject) => {
+            pendingRequestRef.current = { id: requestId, resolve, reject };
+            debounceTimer.current = setTimeout(async () => {
+                const pendingRequest = pendingRequestRef.current;
+                if (!pendingRequest || pendingRequest.id !== requestId)
+                    return;
+                pendingRequestRef.current = null;
+                debounceTimer.current = null;
+                activeRequestCountRef.current += 1;
+                try {
+                    const result = await onFetchData(filters, options.meta);
+                    if (requestId === latestRequestIdRef.current)
+                        resolve(result);
+                    else
+                        resolve(null);
+                }
+                catch (error) {
+                    if (requestId === latestRequestIdRef.current)
+                        reject(error);
+                    else
+                        resolve(null);
+                }
+                finally {
+                    activeRequestCountRef.current = Math.max(0, activeRequestCountRef.current - 1);
+                    resetLoadingIfIdle();
+                }
+            }, debounceDelay);
+        });
+    }, [onFetchData, resetLoadingIfIdle]);
+    (0, react_1.useEffect)(() => {
+        isMountedRef.current = true;
+        return () => {
+            isMountedRef.current = false;
+            if (debounceTimer.current) {
+                clearTimeout(debounceTimer.current);
+                debounceTimer.current = null;
+            }
+            if (pendingRequestRef.current) {
+                pendingRequestRef.current.resolve(null);
+                pendingRequestRef.current = null;
+            }
+        };
+    }, []);
+    return { debouncedFetch, isLoading };
+}