@ackplus/react-tanstack-data-table 1.1.20 → 1.1.21

package/src/lib/types/export.types.ts

@@ -1,223 +0,0 @@
-/**
- * Export Configuration Types
- * Consolidated export-related interfaces from export-utils.ts
- */
-
-import { TableState } from './table.types';
-
-
-export type ExportFormat = 'csv' | 'excel';
-export type ExportConcurrencyMode = 'ignoreIfRunning' | 'cancelAndRestart' | 'queue';
-export type ExportPhase =
-    | 'starting'
-    | 'fetching'
-    | 'processing'
-    | 'downloading'
-    | 'completed'
-    | 'cancelled'
-    | 'error';
-
-export type ExportValueFormat = 'auto' | 'string' | 'number' | 'boolean' | 'json' | 'date';
-
-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;
-    queueLength?: number;
-}
-
-export interface ExportProgressPayload {
-    processedRows?: number;
-    totalRows?: number;
-    percentage?: number;
-}
-
-export interface ServerExportDataResult<T = any> {
-    data: T[];
-    total: number;
-}
-
-export interface ServerExportBlobResult {
-    blob: Blob;
-    filename?: string;
-    mimeType?: string;
-    total?: number;
-}
-
-export interface ServerExportFileUrlResult {
-    fileUrl: string;
-    filename?: string;
-    mimeType?: string;
-    total?: number;
-}
-
-export type ServerExportResult<T = any> =
-    | ServerExportDataResult<T>
-    | ServerExportBlobResult
-    | ServerExportFileUrlResult;
-
-/**
- * Server export column configuration
- */
-export interface ServerExportColumn<T = any> {
-    id: string;
-    header: string;
-    accessor: keyof T | string;
-    formatter?: (value: any, row: T) => string;
-}
-
-/**
- * Export options configuration
- */
-export interface ExportOptions {
-    filename?: string;
-    format: ExportFormat;
-    includeHeaders?: boolean;
-    onlyVisibleColumns?: boolean;
-    onlyFilteredData?: boolean;
-    // New options for large datasets
-    chunkSize?: number;
-    onProgress?: (progress: ExportProgress) => void;
-    onComplete?: (result: ExportResult) => void;
-    onError?: (error: ExportError) => void;
-    signal?: AbortSignal; // For cancellation
-}
-
-/**
- * Export progress information
- */
-export interface ExportProgress {
-    processedRows?: number;
-    totalRows?: number;
-    percentage?: number;
-    currentChunk?: number;
-    totalChunks?: number;
-    estimatedTimeRemaining?: number;
-}
-
-/**
- * Export result information
- */
-export interface ExportResult {
-    success: boolean;
-    filename: string;
-    totalRows: number;
-    totalColumns: number;
-    processingTime: number;
-    fileSize?: number;
-}
-
-/**
- * Export error information
- */
-export interface ExportError {
-    message: string;
-    code: 'CANCELLED' | 'MEMORY_ERROR' | 'PROCESSING_ERROR' | 'UNKNOWN' | 'EXPORT_IN_PROGRESS';
-    details?: any;
-}
-
-/**
- * Export configuration for DataTable
- */
-export interface ExportConfig {
-    enabled: boolean;
-    formats: ExportFormat[];
-    filename?: string;
-    includeHeaders?: boolean;
-    onlyVisibleColumns?: boolean;
-    onlyFilteredData?: boolean;
-    // New configuration for large datasets
-    chunkSize?: number;
-    strictTotalCheck?: boolean;
-    sanitizeCSV?: boolean;
-    concurrency?: ExportConcurrencyMode;
-    enableProgressTracking?: boolean;
-    maxMemoryThreshold?: number; // MB
-}
-
-/**
- * Export state for tracking ongoing exports
- */
-export interface ExportState {
-    isExporting: boolean;
-    progress?: ExportProgress;
-    controller?: AbortController;
-    startTime?: number;
-}
-
-/**
- * Chunked data processing configuration
- */
-export interface ChunkProcessingConfig {
-    chunkSize: number;
-    delayBetweenChunks: number; // ms
-    useWebWorker: boolean;
-}
-
-/**
- * Styling options for pinned columns (actual implementation)
- */
-export interface PinnedColumnStyleOptions {
-    width?: number | string;
-    minWidth?: number;
-    maxWidth?: number;
-    isPinned?: 'left' | 'right' | false;
-    pinnedPosition?: number;
-    pinnedRightPosition?: number;
-    zIndex?: number;
-    disableStickyHeader?: boolean;
-    isLastLeftPinnedColumn?: boolean;
-    isFirstRightPinnedColumn?: boolean;
-    wrapText?: boolean; // If true, text will wrap; if false, text will truncate with ellipsis (default: false)
-}
-
-/**
- * Simplified Export Types for DataTable
- */
-
-export interface SimpleExportOptions {
-    filename?: string;
-    format: ExportFormat;
-    includeHeaders?: boolean;
-    onlyVisibleColumns?: boolean;
-    onlySelectedRows?: boolean;
-    chunkSize?: number;
-    strictTotalCheck?: boolean;
-    sanitizeCSV?: boolean;
-}
-
-/**
- * Selection data for server exports
- */
-export interface SelectionExportData {
-    selectAllMatching?: boolean;
-    excludedIds?: string[];
-    selectedIds?: string[];
-    hasSelection?: boolean;
-}
-
-export interface ServerExportOptions extends SimpleExportOptions {
-    fetchData: (
-        filters?: Partial<TableState>,
-        selection?: SelectionExportData,
-        signal?: AbortSignal
-    ) => Promise<ServerExportResult<any>>;
-    currentFilters?: any; // Current table filters/state
-    pageSize?: number;
-    selection?: SelectionExportData;
-}
-
-export interface ExportCallbacks {
-    onProgress?: (progress: ExportProgress) => void;
-    onComplete?: (result: ExportResult) => void;
-    onError?: (error: ExportError) => void;
-    onStateChange?: (state: ExportStateChange) => void;
-}

package/src/lib/types/index.ts

@@ -1,24 +0,0 @@
-/**
- * Consolidated Types Index
- * All DataTable types in one organized location
- */
-
-// Column-related types
-export * from './column.types';
-
-// Table state and configuration types
-export * from './table.types';
-
-// Export functionality types
-export * from './export.types';
-
-// API types (already exists)
-export * from './data-table-api';
-
-// Slots and slotProps types
-export * from './slots.types';
-
-// DataTable types
-export * from './data-table.types';
-// Re-export commonly used types for convenience
-export type { DataTableApi } from './data-table-api';

package/src/lib/types/slots.types.ts

@@ -1,342 +0,0 @@
-/**
- * Enhanced Slots and SlotProps Type System for DataTable
- *
- * This file defines all available slots and their corresponding prop types,
- * following the MUI DataGrid pattern for maximum flexibility and extensibility.
- * 
- * Key improvements:
- * - Full component props inheritance without limitations
- * - Better type safety with generic support
- * - Flexible prop merging and overriding
- * - Support for custom styling and behavior
- */
-import { TableProps, TableContainerProps, BoxProps, ToolbarProps, TableRowProps, TableCellProps, TableHeadProps, TableBodyProps } from '@mui/material';
-import { Table, Row, Column } from '@tanstack/react-table';
-import { ComponentType, ReactNode, HTMLAttributes, ComponentProps } from 'react';
-
-import { DataTableColumn, TableFilters, ExportProgress, ExportResult, ExportError, ServerExportColumn, ExportStateChange } from './index';
-import { DataTableSize } from '../utils/table-helpers';
-import { DataTablePaginationProps } from "../components/pagination";
-import { DataTableToolbarProps } from '../components/toolbar/data-table-toolbar';
-
-/**
- * Enhanced slot component type that supports full component customization
- */
-export type SlotComponent<TProps = any> = ComponentType<TProps>;
-
-/**
- * Base slot props interface that includes common props for all slots
- */
-export interface BaseSlotProps<T = any> {
-    table: Table<T>;
-}
-
-/**
- * Enhanced slot props that merge base props with component-specific props
- */
-export type EnhancedSlotProps<TBase, TComponent> = TBase & TComponent & {
-    // Allow any additional props for maximum flexibility
-    [key: string]: any;
-};
-
-/**
- * Available slots for customization with enhanced typing
- */
-export interface DataTableSlots<T = any> {
-    // Container and wrapper slots
-    root?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, BoxProps & { children: ReactNode }>>;
-    tableContainer?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableContainerProps & { 
-        children: ReactNode;
-        enableStickyHeader?: boolean;
-        maxHeight?: string | number;
-        enableVirtualization?: boolean;
-    }>>;
-    table?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableProps & { 
-        children: ReactNode;
-        tableSize?: DataTableSize;
-        enableStickyHeader?: boolean;
-        fitToScreen?: boolean;
-        tableStyle?: React.CSSProperties;
-    }>>;
-
-    // Header slots
-    toolbar?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, ToolbarProps & DataTableToolbarProps & {
-        title?: string;
-        subtitle?: string;
-        enableGlobalFilter?: boolean;
-        enableColumnVisibility?: boolean;
-        enableColumnFilter?: boolean;
-        enableExport?: boolean;
-        enableReset?: boolean;
-        enableTableSizeControl?: boolean;
-        enableColumnPinning?: boolean;
-        enableRefresh?: boolean;
-        extraFilter?: ReactNode;
-        serverExport?: {
-            fetchData: (page: number, pageSize: number, filters: TableFilters) => Promise<{ data: T[]; total: number }>;
-            columns: ServerExportColumn<T>[];
-            pageSize?: number;
-        };
-        currentFilters?: TableFilters;
-        onExportStart?: (format: 'csv' | 'excel', summary: { mode: 'client' | 'server'; totalRows: number; estimatedMemoryMB?: number }) => void;
-        onExportProgress?: (progress: ExportProgress) => void;
-        onExportComplete?: (result: ExportResult) => void;
-        onExportError?: (error: ExportError) => void;
-        onExportCancel?: () => void;
-        onExportStateChange?: (state: ExportStateChange) => void;
-    }>>;
-
-    header?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableHeadProps & {
-        enableSorting?: boolean;
-        draggable?: boolean;
-        enableColumnResizing?: boolean;
-        enableStickyHeader?: boolean;
-        fitToScreen?: boolean;
-        onColumnReorder?: (draggedColumnId: string, targetColumnId: string) => void;
-    }>>;
-
-    headerRow?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableRowProps & {
-        headerGroups: any[];
-    }>>;
-
-    headerCell?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableCellProps & {
-        header: any;
-        column: Column<T>;
-        enableSorting?: boolean;
-        draggable?: boolean;
-        enableColumnResizing?: boolean;
-        onColumnReorder?: (draggedColumnId: string, targetColumnId: string) => void;
-        isPinned?: boolean | 'left' | 'right';
-        pinnedPosition?: number;
-        pinnedRightPosition?: number;
-    }>>;
-
-    // Icon slots with full component props
-    sortIconAsc?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    sortIconDesc?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-
-    // Body slots
-    body?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableBodyProps & {
-        children: ReactNode;
-        rows: Row<T>[];
-        loading?: boolean;
-        emptyMessage?: string;
-        enableVirtualization?: boolean;
-        enablePagination?: boolean;
-    }>>;
-
-    row?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableRowProps & {
-        row: Row<T>;
-        index: number;
-        enableHover?: boolean;
-        enableStripes?: boolean;
-        isOdd?: boolean;
-        renderSubComponent?: (row: Row<T>) => ReactNode;
-        disableStickyHeader?: boolean;
-    }>>;
-
-    cell?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableCellProps & {
-        row: Row<T>;
-        cell: any;
-        column: Column<T>;
-        value: any;
-        isPinned?: boolean | 'left' | 'right';
-        pinnedPosition?: number;
-        pinnedRightPosition?: number;
-        alignment?: 'left' | 'center' | 'right';
-    }>>;
-
-    // Special row slots
-    loadingRow?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableRowProps & {
-        rowCount: number;
-        colSpan: number;
-    }>>;
-
-    emptyRow?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableRowProps & {
-        colSpan: number;
-        message: string;
-    }>>;
-
-    expandedRow?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, TableRowProps & {
-        row: Row<T>;
-        colSpan: number;
-        children: ReactNode;
-    }>>;
-
-    // Footer slots
-    footer?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, BoxProps & {
-        children: ReactNode;
-        enableStickyFooter?: boolean;
-    }>>;
-
-    pagination?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, DataTablePaginationProps>>;
-
-    // Toolbar component slots with full component inheritance
-    searchInput?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, ComponentProps<'input'> & {
-        value: string;
-        onChange: (value: string) => void;
-        placeholder?: string;
-        autoFocus?: boolean;
-    }>>;
-
-    columnVisibilityControl?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, HTMLAttributes<HTMLDivElement>>>;
-    columnCustomFilterControl?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, HTMLAttributes<HTMLDivElement>>>;
-    columnPinningControl?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, HTMLAttributes<HTMLDivElement>>>;
-    resetButton?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, ComponentProps<'button'>>>;
-    tableSizeControl?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, HTMLAttributes<HTMLDivElement>>>;
-
-    // Bulk action slots
-    bulkActionsToolbar?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, ToolbarProps & {
-        selectionState: any;
-        selectedRowCount: number;
-        bulkActions?: (selectionState: any) => ReactNode;
-        onBulkAction?: (action: string, selectionState: T[]) => void;
-        enableSelectAll?: boolean;
-        onSelectAll?: () => void;
-        onDeselectAll?: () => void;
-    }>>;
-
-    exportButton?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, ComponentProps<'button'> & {
-        filename?: string;
-        dataMode?: 'client' | 'server';
-        serverExport?: {
-            fetchData: (page: number, pageSize: number, filters: TableFilters) => Promise<{ data: T[]; total: number }>;
-            columns: ServerExportColumn<T>[];
-            pageSize?: number;
-        };
-        currentFilters?: TableFilters;
-        onExportStart?: (format: 'csv' | 'excel', summary: { mode: 'client' | 'server'; totalRows: number; estimatedMemoryMB?: number }) => void;
-        onExportProgress?: (progress: ExportProgress) => void;
-        onExportComplete?: (result: ExportResult) => void;
-        onExportError?: (error: ExportError) => void;
-        onExportCancel?: () => void;
-        onExportStateChange?: (state: ExportStateChange) => void;
-    }>>;
-
-    refreshButton?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, ComponentProps<'button'> & {
-        loading?: boolean;
-        showSpinnerWhileLoading?: boolean;
-        onRefresh?: () => void;
-    }>>;
-
-    // Icon slots with full SVG component props
-    searchIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    refreshIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    clearIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    exportIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    columnIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    resetIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    moreIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    filterIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    pinIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    unpinIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    leftIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    rightIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    csvIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    excelIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    selectAllIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    deselectIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    tableSizeIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    tableSizeSmallIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    tableSizeMediumIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-
-    // Selection slots
-    checkboxSelection?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, ComponentProps<'input'> & {
-        row?: Row<T>;
-        checked: boolean;
-        indeterminate?: boolean;
-        onChange: (checked: boolean) => void;
-        disabled?: boolean;
-    }>>;
-
-    // Expansion slots
-    expandIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-    collapseIcon?: SlotComponent<ComponentProps<'svg'> & { [key: string]: any }>;
-
-    // Loading and empty state slots
-    loadingSkeleton?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, HTMLAttributes<HTMLDivElement> & {
-        rows: number;
-        columns: number;
-    }>>;
-
-    noDataOverlay?: SlotComponent<EnhancedSlotProps<BaseSlotProps<T>, HTMLAttributes<HTMLDivElement> & {
-        message: string;
-    }>>;
-
-
-
-    // Special column slots
-    selectionColumn?: DataTableColumn<T>;
-    expandColumn?: DataTableColumn<T>;
-}
-
-/**
- * Enhanced slot props type that allows full customization
- */
-export type DataTableSlotProps<T = any> = {
-    [K in keyof DataTableSlots<T>]?: Record<string, any>;
-};
-
-/**
- * Columns panel props for slot customization
- */
-export interface ColumnsPanelSlotProps<T = any> {
-    getTogglableColumns?: (columns: DataTableColumn<T>[]) => DataTableColumn<T>[];
-    getPinnableColumns?: (columns: DataTableColumn<T>[]) => DataTableColumn<T>[];
-}
-
-/**
- * Utility type to make all slot props optional for easier usage
- */
-export type PartialSlotProps<T = any> = {
-    [K in keyof DataTableSlotProps<T>]?: Partial<DataTableSlotProps<T>[K]>;
-} & {
-    // Special props for columns panel
-    columnsPanel?: ColumnsPanelSlotProps<T>;
-};
-
-/**
- * Utility type for slot component props with proper generic support
- */
-export type SlotComponentProps<
-    TSlot extends keyof DataTableSlots<T>,
-    T = any
-> = DataTableSlots<T>[TSlot] extends SlotComponent<infer TProps> ? TProps : never;
-
-/**
- * Helper type to extract component props from a slot
- */
-export type ExtractSlotProps<TSlot> = TSlot extends SlotComponent<infer TProps> ? TProps : never;
-
-/**
- * Default slot components - can be overridden by users
- */
-// export interface DefaultSlots<T = any> extends DataTableSlots<T> {
-//     // All slots should have default implementations
-// }
-
-/**
- * Enhanced slot configuration with better prop merging
- */
-export interface SlotConfiguration<T = any> {
-    slots?: Partial<DataTableSlots<T>>;
-    slotProps?: PartialSlotProps<T>;
-}
-
-/**
- * Slot override configuration for advanced customization
- */
-export interface SlotOverrideConfig<T = any> {
-    // Override specific slot behavior
-    overrideSlot?: <K extends keyof DataTableSlots<T>>(
-        slotName: K,
-        component: DataTableSlots<T>[K],
-        props?: Partial<SlotComponentProps<K, T>>
-    ) => void;
-    
-    // Merge props with existing slot props
-    mergeSlotProps?: <K extends keyof DataTableSlots<T>>(
-        slotName: K,
-        props: Partial<SlotComponentProps<K, T>>
-    ) => Partial<SlotComponentProps<K, T>>;
-}

package/src/lib/types/table.types.ts

@@ -1,88 +0,0 @@
-import { SortingState } from '@tanstack/react-table';
-
-import { ColumnFilterRule, SelectionState } from '../features';
-
-
-/**
- * Table State and Configuration Types
- * Consolidated table-related interfaces from data-table.types.ts
- */
-
-/**
- * Table filters configuration
- */
-
-export type TableSize = 'small' | 'medium';
-
-// Extended table state interface with custom column filter support
-
-export interface TableState {
-    columnFilter: ColumnFilterState;
-    selectionState?: SelectionState; // Selection state for CustomSelectionFeature
-    globalFilter?: string;
-    sorting?: SortingState;
-    pagination?: {
-        pageIndex: number;
-        pageSize: number;
-    };
-    columnOrder?: string[];
-    columnPinning?: {
-        left?: string[];
-        right?: string[];
-    };
-    columnVisibility?: Record<string, boolean>;
-    columnSizing?: Record<string, number>;
-}
-
-export interface TableFilters {
-    globalFilter: string;
-    columnFilter: ColumnFilterState;
-    sorting: SortingState;
-    pagination: {
-        pageIndex: number;
-        pageSize: number;
-    };
-    columnOrder: string[];
-    columnPinning: {
-        left?: string[];
-        right?: string[];
-    };
-}
-
-export interface TableFiltersForFetch extends Partial<TableFilters> {
-    search?: string;
-    page?: number;
-    pageSize?: number;
-}
-
-export interface ColumnFilterState {
-    filters: ColumnFilterRule[];
-    logic: 'AND' | 'OR';
-    // Add pending state for draft filters before applying
-    pendingFilters: ColumnFilterRule[];
-    pendingLogic: 'AND' | 'OR';
-}
-
-/**
- * Table performance metrics
- */
-export interface TablePerformanceMetrics {
-    renderTime: number;
-    dataProcessingTime: number;
-    totalRows: number;
-    visibleRows: number;
-    memoryUsage?: number;
-}
-
-/**
- * Table metrics for debugging and optimization
- */
-export interface TableMetrics {
-    totalRows: number;
-    visibleRows: number;
-    totalColumns?: number;
-    visibleColumns?: number;
-    pinnedColumns?: number;
-    renderTime: number;
-    lastUpdated?: Date;
-}