@jmruthers/pace-core 0.2.6 → 0.4.1

package/src/components/DataTable/index.ts

@@ -1,68 +0,0 @@
-/**
- * @file DataTable Module Exports
- * @package @jmruthers/pace-core
- * @module Components/DataTable
- * @since 0.3.0
- */
-
-// Main component
-export { DataTable } from './DataTable';
-export type { DataTableProps } from './DataTable';
-
-// New architecture components
-export { DataTableCore } from './components/DataTableCore';
-export { DataTableErrorBoundary } from './components/DataTableErrorBoundary';
-
-// Enhanced DataTable features are now integrated into the main DataTable component
-
-// Performance utilities
-export * from './utils/performanceUtils';
-
-// Virtualization is now integrated into the main DataTable component
-
-// Enhanced pagination
-export { PaginationControls, EnhancedPaginationControls } from './components/PaginationControls';
-
-// Performance hook
-export { useDataTablePerformance } from '../../hooks/useDataTablePerformance';
-export type { UseDataTablePerformanceOptions, UseDataTablePerformanceReturn } from '../../hooks/useDataTablePerformance';
-
-// Type definitions
-export type { 
-  DataTableColumn, 
-  DataTableAction, 
-  DataTableToolbarButton,
-  AggregateConfig,
-  EmptyStateConfig,
-  GetRowId,
-  SimpleColumn,
-  // Feature configuration types
-  DataTableFeatureConfig,
-  // Performance types
-  PaginationMode,
-  PerformanceConfig,
-  ServerSideConfig,
-  ChunkingConfig,
-  SearchIndexConfig
-} from './types';
-
-// Re-export TanStack types for convenience
-export type { ColumnDef, SortingState, ColumnFiltersState } from '@tanstack/react-table';
-
-// Core architecture exports
-export * from './core/interfaces';
-export { DataManager } from './core/DataManager';
-export { ColumnManagerImpl as ColumnManager } from './core/ColumnManager';
-export { ActionManagerImpl as ActionManager } from './core/ActionManager';
-export { StateManagerImpl as StateManager } from './core/StateManager';
-export { PluginRegistryImpl as PluginRegistry } from './core/PluginRegistry';
-export { LocalDataAdapter } from './core/LocalDataAdapter';
-export { ColumnFactory } from './core/ColumnFactory';
-export { DataTableProvider, useDataTableContext, useDataManager, useColumnManager, useActionManager, useStateManager, usePluginRegistry } from './core/DataTableContext';
-
-// Components
-export * from './components';
-
-// Utility functions
-export * from './utils';
-

package/src/components/DataTable/styles.ts

@@ -1,171 +0,0 @@
-/**
- * @file DataTable Styling Constants
- * @package @jmruthers/pace-core
- * @module Components/DataTable
- * @since 0.4.0
- *
- * Centralized styling constants for all DataTable components.
- * This ensures consistent styling across regular and virtualized tables.
- */
-
-import { cn } from '../../utils/cn';
-
-// ============================================================================
-// TABLE BASE STYLES
-// ============================================================================
-
-export const tableStyles = {
-  // Main table container
-  table: 'w-full caption-bottom text-sm',
-  tableFixed: 'w-full table-fixed',
-  
-  // Table sections
-  header: '[&_tr]:border-b',
-  body: '[&_tr:last-child]:border-0',
-  footer: 'border-t bg-muted/50 font-medium [&>tr]:last:border-b-0',
-  
-  // Table rows
-  row: 'border-b transition-colors hover:bg-muted/50 data-[state=selected]:bg-muted',
-  rowHover: 'hover:bg-sec-50 transition-colors',
-  rowSelected: 'bg-main-50',
-  
-  // Table cells
-  head: 'h-12 px-4 text-left align-middle font-medium text-muted-foreground [&:has([role=checkbox])]:pr-0',
-  headSortable: 'cursor-pointer select-none hover:bg-muted/50',
-  cell: 'p-4 align-middle [&:has([role=checkbox])]:pr-0',
-  cellCompact: 'px-3 py-2 align-middle [&:has([role=checkbox])]:pr-0',
-  cellVirtualized: 'px-4 py-2 text-sm border-b border-sec-200 whitespace-normal',
-  cellSortable: 'cursor-pointer select-none',
-  
-  // Table layout
-  mainContainer: 'w-full max-w-full',
-  container: 'overflow-x-auto w-full',
-  containerVirtualized: 'overflow-hidden',
-  
-  // Sticky positioning
-  stickyHeader: 'sticky top-0 z-10',
-  
-  // Empty state
-  emptyState: 'flex items-center justify-center py-12',
-  emptyStateContent: 'text-center',
-  emptyStateIcon: 'text-sec-400 text-lg mb-2',
-  emptyStateText: 'text-sec-500',
-} as const;
-
-// ============================================================================
-// STYLING UTILITIES
-// ============================================================================
-
-/**
- * Get table cell classes based on context
- */
-export const getTableCellClasses = (options: {
-  isVirtualized?: boolean;
-  isCompact?: boolean;
-  isSortable?: boolean;
-  className?: string;
-} = {}) => {
-  const { isVirtualized = false, isCompact = false, isSortable = false, className } = options;
-  
-  if (isVirtualized) {
-    return cn(
-      tableStyles.cellVirtualized,
-      isSortable && tableStyles.cellSortable,
-      className
-    );
-  }
-  
-  return cn(
-    isCompact ? tableStyles.cellCompact : tableStyles.cell,
-    isSortable && tableStyles.cellSortable,
-    className
-  );
-};
-
-/**
- * Get table head classes based on context
- */
-export const getTableHeadClasses = (options: {
-  isSortable?: boolean;
-  className?: string;
-} = {}) => {
-  const { isSortable = false, className } = options;
-  
-  return cn(
-    tableStyles.head,
-    isSortable && tableStyles.headSortable,
-    className
-  );
-};
-
-/**
- * Get table row classes based on context
- */
-export const getTableRowClasses = (options: {
-  isSelected?: boolean;
-  isVirtualized?: boolean;
-  className?: string;
-} = {}) => {
-  const { isSelected = false, isVirtualized = false, className } = options;
-  
-  if (isVirtualized) {
-    return cn(
-      tableStyles.rowHover,
-      isSelected && tableStyles.rowSelected,
-      className
-    );
-  }
-  
-  return cn(
-    tableStyles.row,
-    isSelected && tableStyles.rowSelected,
-    className
-  );
-};
-
-/**
- * Get table container classes based on context
- */
-export const getTableContainerClasses = (options: {
-  isVirtualized?: boolean;
-  className?: string;
-} = {}) => {
-  const { isVirtualized = false, className } = options;
-  
-  return cn(
-    isVirtualized ? tableStyles.containerVirtualized : tableStyles.container,
-    className
-  );
-};
-
-/**
- * Get table classes based on context
- */
-export const getTableClasses = (options: {
-  isFixed?: boolean;
-  variant?: 'default' | 'compact' | 'spacious';
-  className?: string;
-} = {}) => {
-  const { isFixed = false, variant = 'default', className } = options;
-  
-  return cn(
-    isFixed ? tableStyles.tableFixed : tableStyles.table,
-    variant === 'compact' && 'text-sm',
-    variant === 'spacious' && 'text-base',
-    className
-  );
-};
-
-/**
- * Get main DataTable container classes
- */
-export const getMainContainerClasses = (options: {
-  className?: string;
-} = {}) => {
-  const { className } = options;
-  
-  return cn(
-    tableStyles.mainContainer,
-    className
-  );
-};

package/src/components/DataTable/types.ts

@@ -1,473 +0,0 @@
-/**
- * @file DataTable Type Definitions
- * @package @jmruthers/pace-core
- * @module Components/DataTable/Types
- * @since 0.2.0
- */
-
-import React from 'react';
-import type { 
-  SortingState, 
-  ColumnFiltersState, 
-  VisibilityState, 
-  GroupingState, 
-  ExpandedState,
-  PaginationState,
-  ColumnDef
-} from '@tanstack/react-table';
-import type { ImportModalConfig } from './components/ImportModal';
-
-// ============================================================================
-// CORE DATA TYPES
-// ============================================================================
-
-/**
- * Generic data record type - all DataTable data must extend this
- */
-export type DataRecord = Record<string, any>;
-
-/**
- * Row identifier function type
- */
-export type GetRowId<TData extends DataRecord> = (row: TData, index: number) => string;
-
-// ============================================================================
-// HIERARCHICAL DATA TYPES
-// ============================================================================
-
-/**
- * Hierarchical data row interface for parent/child relationships
- */
-export interface HierarchicalDataRow extends DataRecord {
-  /** Whether this row is a parent row */
-  isParent: boolean;
-  /** For child rows, references the parent row ID */
-  parentId?: string;
-  /** Unique identifier for this row */
-  id: string;
-}
-
-/**
- * Hierarchical configuration for DataTable
- */
-export interface HierarchicalConfig {
-  /** Enable hierarchical functionality */
-  enabled: boolean;
-  /** Default expanded state - true = all expanded, false = all collapsed, array = specific IDs */
-  defaultExpanded?: boolean | string[];
-  /** Callback when expanded state changes */
-  onExpandedChange?: (expandedIds: string[]) => void;
-  /** Custom expand/collapse button component */
-  expandButton?: React.ComponentType<ExpandButtonProps>;
-  /** Visual indentation for child rows (in pixels) */
-  indentSize?: number;
-  /** Custom styling for parent rows */
-  parentRowClassName?: string;
-  /** Custom styling for child rows */
-  childRowClassName?: string;
-}
-
-/**
- * Props for the expand/collapse button component
- */
-export interface ExpandButtonProps {
-  /** Row ID */
-  rowId: string;
-  /** Whether the row is currently expanded */
-  isExpanded: boolean;
-  /** Whether this row has children */
-  hasChildren: boolean;
-  /** Click handler */
-  onClick: () => void;
-  /** Additional CSS classes */
-  className?: string;
-}
-
-// ============================================================================
-// PERFORMANCE & PAGINATION TYPES
-// ============================================================================
-
-/**
- * Pagination mode determines how data is handled
- */
-export type PaginationMode = 'client' | 'server' | 'hybrid';
-
-/**
- * Performance configuration for large datasets
- */
-export interface PerformanceConfig {
-  /** Enable virtual scrolling */
-  virtualScrolling?: boolean;
-  /** Virtual scrolling overscan count */
-  overscan?: number;
-  /** Enable memoization of cell renderers */
-  memoizeCells?: boolean;
-  /** Enable debounced search */
-  debounceSearch?: number;
-  /** Enable data chunking for memory management */
-  enableChunking?: boolean;
-  /** Chunk size for data processing */
-  chunkSize?: number;
-  /** Enable Web Workers for heavy operations */
-  enableWebWorkers?: boolean;
-  /** Threshold for switching to server-side mode */
-  serverSideThreshold?: number;
-}
-
-/**
- * Server-side data fetching configuration
- */
-export interface ServerSideConfig<TData extends DataRecord> {
-  /** Function to fetch data from server */
-  fetchData: (params: ServerSideParams) => Promise<ServerSideResponse<TData>>;
-  /** Enable server-side sorting */
-  enableServerSorting?: boolean;
-  /** Enable server-side filtering */
-  enableServerFiltering?: boolean;
-  /** Enable server-side search */
-  enableServerSearch?: boolean;
-  /** Enable server-side pagination */
-  enableServerPagination?: boolean;
-  /** Debounce delay for server requests */
-  debounceMs?: number;
-  /** Cache duration for server responses */
-  cacheMs?: number;
-}
-
-/**
- * Parameters sent to server for data fetching
- */
-export interface ServerSideParams {
-  /** Current page index */
-  pageIndex: number;
-  /** Page size */
-  pageSize: number;
-  /** Sorting configuration */
-  sorting: SortingState;
-  /** Column filters */
-  columnFilters: ColumnFiltersState;
-  /** Global filter/search term */
-  globalFilter: string;
-  /** Grouping configuration */
-  grouping: GroupingState;
-}
-
-/**
- * Response from server for data fetching
- */
-export interface ServerSideResponse<TData extends DataRecord> {
-  /** Array of data records */
-  data: TData[];
-  /** Total number of records (for pagination) */
-  totalCount: number;
-  /** Current page index */
-  pageIndex: number;
-  /** Page size */
-  pageSize: number;
-  /** Total number of pages */
-  pageCount: number;
-  /** Whether there are more pages */
-  hasNextPage: boolean;
-  /** Whether there are previous pages */
-  hasPreviousPage: boolean;
-}
-
-/**
- * Data chunking configuration
- */
-export interface ChunkingConfig {
-  /** Size of each data chunk */
-  chunkSize: number;
-  /** Number of chunks to keep in memory */
-  maxChunksInMemory: number;
-  /** Enable progressive loading */
-  progressiveLoading?: boolean;
-}
-
-/**
- * Search index configuration for performance
- */
-export interface SearchIndexConfig {
-  /** Fields to index for search */
-  indexedFields: string[];
-  /** Enable fuzzy search */
-  fuzzySearch?: boolean;
-  /** Fuzzy search threshold */
-  fuzzyThreshold?: number;
-  /** Enable search highlighting */
-  enableHighlighting?: boolean;
-}
-
-// ============================================================================
-// COLUMN DEFINITIONS
-// ============================================================================
-
-/**
- * Enhanced column definition that extends TanStack's ColumnDef
- */
-export interface DataTableColumn<TData extends DataRecord = DataRecord> extends Omit<ColumnDef<TData>, 'id' | 'accessorKey'> {
-  /** Column identifier */
-  id?: string;
-  /** Accessor key for data */
-  accessorKey?: string;
-  /** Custom header label for the column */
-  header: string;
-  /** Whether this column should be searchable in global filter */
-  searchable?: boolean;
-  /** Enable sorting */
-  sortable?: boolean;
-  /** Enable column filter (inherits from ColumnDef) */
-  enableColumnFilter?: boolean;
-  /** Enable grouping (inherits from ColumnDef) */
-  enableGrouping?: boolean;
-  /** Enable hiding (inherits from ColumnDef) */
-  enableHiding?: boolean;
-  /** Aggregate configuration for this column */
-  aggregate?: AggregateConfig;
-  /** Enable virtual scrolling for this column */
-  virtualizable?: boolean;
-  /** Custom cell renderer with memoization */
-  memoizedCell?: React.ComponentType<any>;
-  /** Field type for editing (text, select, date, etc.) */
-  fieldType?: 'text' | 'select' | 'date' | 'number' | 'boolean';
-  /** Options for select fields */
-  fieldOptions?: Array<{ value: string | number; label: string }>;
-  /** Filter type for column filtering (text, select, number, date) */
-  filterType?: 'text' | 'select' | 'number' | 'date';
-  
-  // Hierarchical rendering
-  /** Custom renderer for parent rows */
-  renderForParent?: (row: TData) => React.ReactNode;
-  /** Custom renderer for child rows */
-  renderForChild?: (row: TData) => React.ReactNode;
-  /** Hide this column for parent rows */
-  hideForParent?: boolean;
-  /** Hide this column for child rows */
-  hideForChild?: boolean;
-}
-
-/**
- * Simple column interface for basic use cases
- */
-export interface SimpleColumn<TData extends DataRecord = DataRecord> {
-  /** Data accessor key */
-  key: keyof TData | string;
-  /** Display label */
-  label: string;
-  /** Enable sorting */
-  sortable?: boolean;
-  /** Enable filtering */
-  filterable?: boolean;
-}
-
-// ============================================================================
-// ACTION DEFINITIONS
-// ============================================================================
-
-/**
- * Action definition for row-level operations
- */
-export interface DataTableAction<TData extends DataRecord> {
-  /** Display label for the action */
-  label: string;
-  /** Icon component */
-  icon?: React.ComponentType<{ className?: string }>;
-  /** Action handler */
-  onClick: (row: TData) => void;
-  /** Visual variant */
-  variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost';
-  /** Whether action is disabled */
-  disabled?: (row: TData) => boolean;
-  /** Test ID for testing */
-  testId?: string;
-  /** Whether this action should only show for parent rows (hierarchical mode) */
-  showForParent?: boolean;
-  /** Whether this action should only show for child rows (hierarchical mode) */
-  showForChild?: boolean;
-  /** Icon component for parent rows (overrides icon when showForParent is true) */
-  parentIcon?: React.ComponentType<{ className?: string }>;
-  /** Icon component for child rows (overrides icon when showForChild is true) */
-  childIcon?: React.ComponentType<{ className?: string }>;
-  /** Label for parent rows (overrides label when showForParent is true) */
-  parentLabel?: string;
-  /** Label for child rows (overrides label when showForChild is true) */
-  childLabel?: string;
-}
-
-/**
- * Toolbar button definition
- */
-export interface DataTableToolbarButton {
-  /** Display label */
-  label: string;
-  /** Icon component */
-  icon?: React.ComponentType<{ className?: string }>;
-  /** Click handler */
-  onClick: () => void;
-  /** Visual variant */
-  variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost';
-  /** Whether button is disabled */
-  disabled?: boolean;
-  /** Test ID for testing */
-  testId?: string;
-}
-
-// ============================================================================
-// CONFIGURATION TYPES
-// ============================================================================
-
-/**
- * Aggregate configuration
- */
-export interface AggregateConfig {
-  field: string;
-  function: 'sum' | 'avg' | 'count' | 'min' | 'max';
-  label: string;
-}
-
-/**
- * Empty state configuration
- */
-export interface EmptyStateConfig {
-  title?: string;
-  description?: string;
-  icon?: React.ComponentType<{ className?: string }>;
-  action?: {
-    label: string;
-    onClick: () => void;
-  };
-}
-
-// ============================================================================
-// FEATURE CONFIGURATION TYPES
-// ============================================================================
-
-/**
- * Unified feature configuration for DataTable
- * All features are disabled by default and must be explicitly enabled
- */
-export interface DataTableFeatureConfig {
-  // Core Features
-  /** Enable global search functionality */
-  search: boolean;
-  /** Enable pagination controls */
-  pagination: boolean;
-  /** Enable column sorting */
-  sorting: boolean;
-  /** Enable column filtering */
-  filtering: boolean;
-  
-  // Data Management
-  /** Enable data import functionality */
-  import: boolean;
-  /** Enable data export functionality */
-  export: boolean;
-  
-  // Row Operations
-  /** Enable row selection for bulk operations */
-  selection: boolean;
-  /** Enable row creation */
-  creation: boolean;
-  /** Enable row editing */
-  editing: boolean;
-  /** Enable row deletion */
-  deletion: boolean;
-  /** Enable bulk deletion of selected rows */
-  deleteSelected: boolean;
-  
-  // Table Customization
-  /** Enable data grouping */
-  grouping: boolean;
-  /** Enable column visibility controls */
-  columnVisibility: boolean;
-  /** Enable column reordering */
-  columnReordering: boolean;
-  /** Enable hierarchical parent/child rows */
-  hierarchical: boolean;
-  
-  // Performance
-  // Virtualization is now handled automatically based on data size
-  
-  // Layout
-}
-
-
-
-// ============================================================================
-// MAIN COMPONENT PROPS
-// ============================================================================
-
-/**
- * Enhanced DataTable props with unified feature configuration
- */
-export interface DataTableProps<TData extends DataRecord> {
-  // Core data
-  /** Array of data to display */
-  data: TData[];
-  /** Column definitions - supports both DataTableColumn and SimpleColumn formats */
-  columns: (DataTableColumn<TData> | SimpleColumn<TData>)[];
-
-  // Display
-  /** Table title */
-  title?: string;
-  /** Table description */
-  description?: string;
-  /** Theme variant */
-  variant?: 'default' | 'compact' | 'spacious';
-  /** Custom CSS classes */
-  className?: string;
-
-  // NEW: Unified feature configuration
-  /** Feature configuration - all features are disabled by default */
-  features: DataTableFeatureConfig;
-
-  // Hierarchical Configuration
-  /** Hierarchical parent/child row configuration */
-  hierarchical?: HierarchicalConfig;
-
-  // Performance Configuration
-  /** Performance optimization settings */
-  performance?: PerformanceConfig;
-  /** Server-side data fetching configuration */
-  serverSide?: ServerSideConfig<TData>;
-  /** Pagination mode */
-  paginationMode?: PaginationMode;
-  /** Data chunking configuration */
-  chunking?: ChunkingConfig;
-  /** Search index configuration */
-  searchIndex?: SearchIndexConfig;
-  /** Initial page size for pagination */
-  initialPageSize?: number;
-
-  // Event handlers
-  /** Row edit handler */
-  onEditRow?: (row: TData, data: Partial<TData>) => void;
-  /** Row deletion handler */
-  onDeleteRow?: (row: TData) => void;
-  /** Row creation handler */
-  onCreateRow?: (data: Partial<TData>) => void;
-  /** Import handler */
-  onImport?: (data: TData[]) => void | Promise<void>;
-  /** Row selection change handler */
-  onRowSelectionChange?: (selection: Record<string, boolean>) => void;
-  /** Controlled selection state */
-  selection?: Record<string, boolean>;
-  /** Bulk delete selected rows handler */
-  onDeleteSelected?: (selectedRows: Record<string, boolean>) => void;
-
-  // Utilities
-  /** Function to get unique ID for each row */
-  getRowId?: GetRowId<TData>;
-  /** Loading state */
-  isLoading?: boolean;
-  /** Empty state customization */
-  emptyState?: EmptyStateConfig;
-  /** Aggregate configurations */
-  aggregates?: AggregateConfig[];
-
-  // Import Modal Configuration
-  /** Import modal configuration */
-  importModalConfig?: ImportModalConfig;
-}
-
-