ezux 1.1.13 → 1.1.18

package/dist/table.d.ts

@@ -1,1059 +1,2 @@
-import { ColumnDef } from '@tanstack/react-table';
-import { ColumnFiltersState } from '@tanstack/react-table';
-import { default as default_2 } from 'react';
-import { JSX } from 'react/jsx-runtime';
-import { PaginationState } from '@tanstack/react-table';
-import { Row } from '@tanstack/react-table';
-import { RowSelectionState } from '@tanstack/react-table';
-import { SortingState } from '@tanstack/react-table';
-import { Table } from '@tanstack/react-table';
-import { TableState } from '@tanstack/react-table';
-import { Updater } from '@tanstack/react-table';
-
-/**
- * Base Component Types
- */
-declare interface BaseComponentProps {
-    /** Unique identifier for the component instance @group Properties */
-    id?: string;
-    /** Custom class names for styling @group Properties */
-    className?: string;
-    /** Inline styles @group Properties */
-    style?: default_2.CSSProperties;
-    /** Data attribute for testing @group Properties */
-    dataTestId?: string;
-    /** Direction of the text (ltr, rtl, auto) @group Properties */
-    dir?: 'ltr' | 'rtl' | 'auto';
-}
-
-/**
- * Systemic column width calculator for EzTable.
- * Accounts for font metrics, padding, and interactive library icons.
- */
-export declare const calculateColWidth: (text: string, options?: {
-    fontSize?: string;
-    fontWeight?: string;
-    fontFamily?: string;
-    padding?: number;
-    hasIcons?: boolean;
-}) => number;
-
-/**
- * Common event callback types
- * Contains ONLY events that are truly shared across components with identical signatures.
- * Component-specific events (onCellClick, onRowClick, etc) should be defined in each component's types.
- */
-declare interface ComponentEventCallbacks<TData = unknown> {
-    /**
-     * Callback when component is created.
-     * @group Events
-     */
-    onCreated?: () => void;
-    /**
-     * Callback when component is destroyed.
-     * @group Events
-     */
-    onDestroyed?: () => void;
-    /**
-     * Callback when grid/component render starts.
-     * @group Events
-     */
-    onGridRenderStart?: () => void;
-    /**
-     * Callback when grid/component render completes.
-     * @group Events
-     */
-    onGridRenderComplete?: () => void;
-    /**
-     * Callback when data changes.
-     * @group Events
-     */
-    onDataChange?: (data: TData[]) => void;
-    /**
-     * Callback when data loads.
-     * @group Events
-     */
-    onDataLoad?: (data: TData[]) => void;
-    /**
-     * Callback when data is requested.
-     * @group Events
-     */
-    onDataRequest?: (query: DataQuery) => void;
-    /**
-     * Callback when data change starts.
-     * @group Events
-     */
-    onDataChangeStart?: (args: {
-        action: 'add' | 'edit' | 'delete';
-        data: TData | TData[];
-    }) => void;
-    /**
-     * Callback when data change completes.
-     * @group Events
-     */
-    onDataChangeComplete?: (args: {
-        action: 'add' | 'edit' | 'delete';
-        data: TData | TData[];
-    }) => void;
-    /**
-     * Callback when data change is cancelled.
-     * @group Events
-     */
-    onDataChangeCancel?: (args: {
-        action: 'add' | 'edit' | 'delete';
-        row?: TData;
-    }) => void;
-    /**
-     * Callback when data change is requested.
-     * @group Events
-     */
-    onDataChangeRequest?: (args: {
-        action: 'add' | 'edit' | 'delete';
-        data: TData;
-    }) => void;
-    /**
-     * Callback on error.
-     * @group Events
-     */
-    onError?: (error: Error | unknown) => void;
-    /**
-     * Callback on refresh.
-     * @group Events
-     */
-    onRefresh?: () => void;
-}
-
-/**
- * Represents a structured request for data fetching/filtering.
- */
-declare interface DataQuery {
-    filters?: FilterRule[] | FilterGroup;
-    sort?: SortModel[];
-    pagination?: PaginationModel;
-    search?: string;
-    [key: string]: any;
-}
-
-/**
- * Configuration for editing behavior.
- * @group Models
- */
-declare interface EditSettings {
-    /** Whether to allow adding new rows. @group Properties */
-    allowAdding?: boolean;
-    /** Whether to allow editing existing rows. @group Properties */
-    allowEditing?: boolean;
-    /** Whether to allow deleting rows. @group Properties */
-    allowDeleting?: boolean;
-    /** Edit mode. @group Properties */
-    mode?: 'Normal' | 'Dialog' | 'Batch';
-    /** Position for newly added rows. @group Properties */
-    newRowPosition?: 'Top' | 'Bottom';
-    /** Whether to allow editing on double-click. @group Properties */
-    allowEditOnDblClick?: boolean;
-    /** Primary key field(s) for identification. @group Properties */
-    primaryKey?: string | string[];
-}
-
-/**
- * EzTable is a high-performance, enterprise-grade data grid engine.
- * Built on TanStack Table v8, it combines lightweight core logic with powerful
- * features like virtualization, advanced filtering, and modular editing.
- *
-
- * ### Core Capabilities
- * - **Superior Performance**: Row and column virtualization for smooth handling of 100k+ records.
- * - **Smart Data Fetching**: Support for infinite scroll, server-side pagination, and caching via React Query.
- * - **Flexible Editing**: Choose between `Normal` (inline), `Dialog` (form-based), or `Batch` editing modes.
- * - **Advanced Interactivity**: Range selection, drag-and-drop column reordering, and context menus.
- * - **Data Intelligence**: Built-in export (Excel/CSV/PDF), column pinning, and grouping.
- *
- * ### Minimal Example
- * ```tsx
- * <EzTable
- *   data={employees}
- *   columns={[
- *     { accessorKey: 'name', header: 'Name' },
- *     { accessorKey: 'role', header: 'Role' }
- *   ]}
- *   pagination
- *   enableFiltering
- * />
- * ```
- *
- * ### Advanced Config: Editing & Persistence
- * ```tsx
- * <EzTable
- *   data={data}
- *   columns={columns}
- *   editSettings={{
- *     allowEditing: true,
- *     mode: 'Batch',
- *     primaryKey: 'id'
- *   }}
- *   enablePersistence
- *   persistenceKey="user-table-grid"
- *   onBatchSave={(changes) => saveToDatabase(changes)}
- * />
- * ```
- *
- * @group Core Components
- */
-export declare const EzTable: <TData extends object>(props: EzTableProps<TData> & {
-    ref?: default_2.ForwardedRef<EzTableRef<TData>>;
-}) => default_2.ReactElement;
-
-/**
- * Custom CSS class names for internal table elements.
- * @group Models
- */
-declare interface EzTableClassNames<TData = unknown> {
-    /** Root container class. @group Properties */
-    root?: string;
-    /** Header class. @group Properties */
-    header?: string;
-    /** Body class. @group Properties */
-    body?: string;
-    /** Row class or function. @group Properties */
-    row?: string | ((row: Row<TData>) => string);
-    /** Cell class or function. @group Properties */
-    cell?: string | ((cell: unknown) => string);
-    /** Footer class. @group Properties */
-    footer?: string;
-}
-
-/**
- * Custom icons for table elements.
- * @group Models
- */
-declare interface EzTableIcons {
-    /** Sorting ascending icon. @group Properties */
-    sortAsc?: default_2.ReactNode;
-    /** Sorting descending icon. @group Properties */
-    sortDesc?: default_2.ReactNode;
-    /** Filter icon. @group Properties */
-    filter?: default_2.ReactNode;
-    /** Context menu trigger icon. @group Properties */
-    contextMenu?: default_2.ReactNode;
-    /** Expanded row/group icon. @group Properties */
-    expanded?: default_2.ReactNode;
-    /** Collapsed row/group icon. @group Properties */
-    collapsed?: default_2.ReactNode;
-    /** First page icon. @group Properties */
-    firstPage?: default_2.ReactNode;
-    /** Last page icon. @group Properties */
-    lastPage?: default_2.ReactNode;
-    /** Next page icon. @group Properties */
-    nextPage?: default_2.ReactNode;
-    /** Previous page icon. @group Properties */
-    previousPage?: default_2.ReactNode;
-}
-
-/**
- * Localization strings for the table component.
- * @group Models
- */
-declare interface EzTableLocalization {
-    /** "No records to display" label. @group Properties */
-    noRowsLabel?: string;
-    /** "Loading..." label. @group Properties */
-    loadingLabel?: string;
-    /** Column menu label. @group Properties */
-    columnMenuLabel?: string;
-    /** "Contains" filter operator label. @group Properties */
-    filterOperatorContains?: string;
-    /** Next page label. @group Properties */
-    nextPage?: string;
-    /** Previous page label. @group Properties */
-    previousPage?: string;
-    /** First page label. @group Properties */
-    firstPage?: string;
-    /** Last page label. @group Properties */
-    lastPage?: string;
-    /** Search input placeholder. @group Properties */
-    searchPlaceholder?: string;
-    /** Rows per page label. @group Properties */
-    rowsPerPageLabel?: string;
-    /** Rows label. @group Properties */
-    rowsLabel?: string;
-    /** Total label. @group Properties */
-    totalLabel?: string;
-    /** Records label. @group Properties */
-    recordsLabel?: string;
-    /** Page label. @group Properties */
-    pageLabel?: string;
-    /** "of" label. @group Properties */
-    ofLabel?: string;
-    /** "Go to" label. @group Properties */
-    goToLabel?: string;
-    /** Pager status message. @group Properties */
-    pagerMessage?: string;
-}
-
-export declare const EzTablePrimitive: default_2.ForwardRefExoticComponent<EzTableProps<object> & default_2.RefAttributes<EzTableRef<object>>>;
-
-/**
- * Props for the EzTable component.
- *
- * @example
- * ```tsx
- * import { EzTable, useEzTable } from 'ezux';
- *
- * const table = useEzTable({
- *   data: [{ id: 1, name: 'John' }],
- *   columns: [{ accessorKey: 'name', header: 'Name' }]
- * });
- *
- * return <EzTable table={table} />;
- * ```
- */
-declare interface EzTableProps<TData extends object> extends SharedBaseProps<TData> {
-    /**
-     * The data to display in the table.
-     * Can be an array of objects or an empty array.
-     * @group Properties
-     */
-    data: TData[];
-    /**
-     * Configuration for the table columns.
-     * Defines headers, accessors, cell rendering, and other per-column options.
-     * @group Properties
-     */
-    columns: ColumnDef<TData>[];
-    /**
-     * Controlled state object for the table.
-     * Use this to control pagination, sorting, filtering, etc. from outside.
-     * @group Properties
-     */
-    state?: Partial<TableState>;
-    /**
-     * Initial state object for the table.
-     * Use this to set the initial pagination, sorting, filtering, etc.
-     * @group Properties
-     */
-    initialState?: Partial<TableState>;
-    /**
-     * Callback fired when the table state changes.
-     * @group Events
-     */
-    onStateChange?: (updater: Updater<TableState>) => void;
-    /**
-     * Custom slots to override default internal components.
-     * @group Properties
-     */
-    slots?: EzTableSlots<TData>;
-    /**
-     * Props to pass to the custom slots.
-     * @group Properties
-     */
-    slotProps?: Record<string, unknown>;
-    /**
-     * Custom class names for internal table elements.
-     * Use strict mode class names or functions for dynamic styling.
-     * @group Properties
-     */
-    classNames?: EzTableClassNames<TData>;
-    /**
-     * Custom icons for table elements (sort, filter, pagination, etc.).
-     * @group Properties
-     */
-    icons?: EzTableIcons;
-    /**
-     * Function to derive a unique ID for a row.
-     * Defaults to looking for `id` property.
-     * @group Properties
-     */
-    getRowId?: (row: TData) => string;
-    /**
-     * Callback to process a row update before it is committed.
-     * Useful for validation or transformation.
-     * @group Events
-     */
-    onProcessRowUpdate?: (newRow: TData, oldRow: TData) => Promise<TData>;
-    /**
-     * Alias for onDataRequest. Triggered when data needs to be fetched (e.g. pagination/sorting in server-side mode).
-     * @group Events
-     */
-    onFetchData?: (params: unknown) => void;
-    /**
-     * Localization strings for the table (e.g. pagination labels, no rows message).
-     * @group Properties
-     */
-    localization?: EzTableLocalization;
-    /**
-     * Estimated row height for virtualization.
-     * Increase this if your rows are taller than 48px to improve scroll performance.
-     * Default: 48
-     * @group Properties
-     */
-    estimatedRowHeight?: number;
-    /**
-     * Progressive rendering for large datasets.
-     * Renders rows in chunks to keep the UI responsive.
-     * @group Properties
-     */
-    progressiveRendering?: boolean;
-    /**
-     * Distance in items to prefetch during scrolling.
-     * @group Properties
-     */
-    prefetchDistance?: number;
-    /**
-     * Number of items to render outside the visible area.
-     * Higher values reduce blank space during fast scrolling but increase memory usage.
-     * @group Properties
-     */
-    overscanCount?: number;
-    /**
-     * Enable debug logging for virtualization.
-     * @group Properties
-     */
-    debugVirtualization?: boolean;
-    /**
-     * Enable adaptive sizing for dynamic item heights.
-     * @group Properties
-     */
-    adaptiveSizing?: boolean;
-    /**
-     * Scroll padding start (pixels) to offset sticky elements or top padding.
-     * @group Properties
-     */
-    scrollPaddingStart?: number;
-    /**
-     * Scroll padding end (pixels) to offset sticky elements.
-     * @group Properties
-     */
-    scrollPaddingEnd?: number;
-    /**
-     * Scroll margin (pixels) to apply to scroll container.
-     * @group Properties
-     */
-    scrollMargin?: number;
-    /**
-     * Enable horizontal column virtualization.
-     * Recommended for tables with many columns (e.g. 50+).
-     * @group Properties
-     */
-    enableColumnVirtualization?: boolean;
-    /**
-     * Number of columns after which virtualization kicks in.
-     * @group Properties
-     */
-    columnVirtualizationThreshold?: number;
-    /**
-     * Enable Infinite Scrolling.
-     * If true, `onEndReached` will be called when the user scrolls to the bottom.
-     * @group Properties
-     */
-    enableInfiniteScroll?: boolean;
-    /**
-     * Callback when the table is scrolled to the bottom.
-     * Used for Infinite Scroll to load more data.
-     * @group Events
-     */
-    onEndReached?: () => void;
-    /**
-     * @deprecated Use `data` instead.
-     * @remarks Providing `dataSource` without `data` will trigger a runtime warning.
-     * @group Properties
-     */
-    dataSource?: TData[];
-    /**
-     * Configuration for pagination.
-     * Defines page size, available page sizes, and initial page.
-     * @group Properties
-     */
-    pageSettings?: {
-        pageSize?: number;
-        pageCount?: number;
-        currentPage?: number;
-        pageSizes?: number[];
-    };
-    /**
-     * Configuration for column aggregates (e.g. Sum, Average).
-     * Displayed in the table footer.
-     * @group Properties
-     */
-    aggregates?: {
-        field: string;
-        type: 'Sum' | 'Average' | 'Min' | 'Max' | 'Count' | 'Custom';
-        footerTemplate?: string;
-    }[];
-    /**
-     * Text clipping mode for all columns.
-     * - `clip`: Text is clipped.
-     * - `ellipsis`: Text is truncated with an ellipsis.
-     * - `ellipsis-tooltip`: Text is truncated and a tooltip is shown on hover.
-     * @group Properties
-     */
-    clipMode?: 'clip' | 'ellipsis' | 'ellipsis-tooltip';
-    /**
-     * Total expected rows if knowing beforehand.
-     * Crucial for server-side pagination to calculate total pages.
-     * @group Properties
-     */
-    rowCount?: number;
-    /**
-     * Enable pagination.
-     * @group Properties
-     */
-    pagination?: boolean;
-    /**
-     * Number of rows per page.
-     * @group Properties
-     */
-    pageSize?: number;
-    /**
-     * Grid line configuration.
-     * @group Properties
-     */
-    gridLines?: 'Both' | 'Horizontal' | 'Vertical' | 'None';
-    /**
-     * Enable keyboard navigation features.
-     * @group Properties
-     */
-    allowKeyboard?: boolean;
-    /**
-     * Enable alternating row background colors (zebra striping).
-     * @group Properties
-     */
-    enableAltRow?: boolean;
-    /**
-     * Enable row hover effect.
-     * @group Properties
-     */
-    enableHover?: boolean;
-    /**
-     * Enable HTML sanitizer for cell content.
-     * @group Properties
-     */
-    enableHtmlSanitizer?: boolean;
-    /**
-     * Width of the table.
-     * Accepts pixel number or CSS string (e.g. '100%').
-     * @group Properties
-     */
-    width?: string | number;
-    /**
-     * Height of the table.
-     * Accepts pixel number or CSS string (e.g. '500px').
-     * @group Properties
-     */
-    height?: string | number;
-    /**
-     * Fixed row height for all rows.
-     * Required for efficient virtualization.
-     * @group Properties
-     */
-    rowHeight?: number;
-    /**
-     * Configuration for row/cell selection behavior.
-     * @group Properties
-     */
-    selectionSettings?: SelectionSettings;
-    /**
-     * Configuration for filtering behavior (UI type, mode, etc).
-     * @group Properties
-     */
-    filterSettings?: FilterSettings;
-    /**
-     * Configuration for global search behavior.
-     * @group Properties
-     */
-    searchSettings?: SearchSettings;
-    /**
-     * Configuration for sorting behavior.
-     * @group Properties
-     */
-    sortSettings?: SortSettings;
-    /**
-     * Configuration for editing behavior (mode, new row position).
-     * @group Properties
-     */
-    editSettings?: EditSettings;
-    /**
-     * Configuration for text wrapping in cells and headers.
-     * @group Properties
-     */
-    textWrapSettings?: TextWrapSettings;
-    /**
-     * Toolbar items configuration.
-     * Accepts an array of item names (strings) or detailed item objects.
-     * @group Properties
-     */
-    toolbar?: (ToolbarItemType | ToolbarItem)[];
-    /**
-     * Generic query parameters for server-side operations.
-     * Passed to `onDataRequest`.
-     * @group Properties
-     */
-    query?: unknown;
-    /**
-     * Callback when grid renders starts.
-     * @group Events
-     */
-    onGridRenderStart?: () => void;
-    /**
-     * Callback when grid renders completes.
-     * @group Events
-     */
-    onGridRenderComplete?: () => void;
-    /**
-     * Callback when a cell is focused.
-     * @group Events
-     */
-    onCellFocus?: (args: {
-        cell: unknown;
-        row: Row<TData>;
-    }) => void;
-    /**
-     * Callback when a toolbar item is clicked.
-     * @group Events
-     */
-    onToolbarItemClick?: (args: {
-        item: ToolbarItem;
-        originalEvent: default_2.MouseEvent;
-    }) => void;
-    /**
-     * Callback when a row is deselected.
-     * @group Events
-     */
-    onRowDeselect?: (args: {
-        row?: Row<TData>;
-        data: TData;
-        rowIndex: number;
-    }) => void;
-    /**
-     * Callback when a row is clicked.
-     * @group Events
-     */
-    onRowClick?: (args: {
-        row: Row<TData>;
-        data: TData;
-        rowIndex: number;
-        originalEvent: default_2.MouseEvent;
-    }) => void;
-    /**
-     * Callback when a row is selected.
-     * @group Events
-     */
-    onRowSelect?: (args: {
-        row?: Row<TData>;
-        data: TData;
-        rowIndex: number;
-        originalEvent?: default_2.SyntheticEvent;
-    }) => void;
-    /**
-     * Callback when a row is double-clicked.
-     * @group Events
-     */
-    onRowDoubleClick?: (args: {
-        row: Row<TData>;
-        data: TData;
-        rowIndex: number;
-        originalEvent: default_2.MouseEvent;
-    }) => void;
-    /**
-     * Callback before a new row is added. Return false to cancel.
-     * @group Events
-     */
-    onRowAddStart?: (args: {
-        data: Partial<TData>;
-    }) => void;
-    /**
-     * Callback before a row is edited. Return false to cancel.
-     * @group Events
-     */
-    onRowEditStart?: (args: {
-        row: Row<TData>;
-        data: TData;
-    }) => void;
-    /**
-     * Callback when batch changes are saved.
-     * @group Events
-     */
-    onBatchSave?: (changes: {
-        addedRecords: TData[];
-        changedRecords: TData[];
-        deletedRecords: TData[];
-    }) => void;
-    /**
-     * Callback when a record fails validation before saving.
-     * @group Events
-     */
-    onActionFailure?: (args: {
-        error: unknown;
-    }) => void;
-    /**
-     * Callback when a record is successfully saved.
-     * @group Events
-     */
-    onActionComplete?: (args: {
-        action: 'add' | 'edit' | 'delete';
-        data: TData;
-    }) => void;
-    /**
-     * Formats cell data on the fly.
-     * @group Events
-     */
-    queryCellInfo?: (args: {
-        row: Row<TData>;
-        data: TData;
-        column: ColumnDef<TData>;
-        cell: unknown;
-    }) => void;
-    /**
-     * Sets class names for specific rows.
-     * @group Events
-     */
-    setRowClass?: (row: Row<TData>) => string;
-    /**
-     * Component validation hook for custom validation.
-     */
-    validateField?: (params: any) => string | boolean;
-    enableSearchHighlighting?: boolean;
-    enableEditing?: boolean;
-    isRowEditable?: (row: TData) => boolean;
-    isCellEditable?: (row: TData, columnId: string) => boolean;
-    enableAdvancedFiltering?: boolean;
-    enableExport?: boolean;
-    onExportExcel?: (table: Table<TData>) => void;
-    onExportCSV?: (table: Table<TData>) => void;
-    onExportPDF?: (table: Table<TData>) => void;
-    enableStickyHeader?: boolean;
-    enableStickyPagination?: boolean;
-    enableChangeTracking?: boolean;
-    enableColumnPinning?: boolean;
-    enableTreeData?: boolean;
-    getSubRows?: (originalRow: TData, index: number) => TData[] | undefined;
-    manualPagination?: boolean;
-    manualSorting?: boolean;
-    manualFiltering?: boolean;
-    enablePersistence?: boolean;
-    persistenceKey?: string;
-    defaultGrouping?: string[];
-    onSortingChange?: (updaterOrValue: Updater<SortingState>) => void;
-    onSort?: (args: {
-        columns: {
-            direction: 'Ascending' | 'Descending' | 'None';
-            name: string;
-        }[];
-    }) => void;
-    onPaginationChange?: (updaterOrValue: Updater<PaginationState>) => void;
-    onPageChange?: (args: {
-        action: string;
-        currentPage: number;
-    }) => void;
-    onRowSelectionChange?: (updaterOrValue: Updater<RowSelectionState>) => void;
-    onColumnOrderChange?: (updaterOrValue: Updater<string[]>) => void;
-    onColumnFiltersChange?: (updaterOrValue: Updater<ColumnFiltersState>) => void;
-    onGlobalFilterChange?: (updaterOrValue: Updater<any>) => void;
-    onFilter?: (args: {
-        columns: any;
-    }) => void;
-    onSearch?: (query: string) => void;
-    onActionBegin?: (args: any) => void;
-    enableRangeSelection?: boolean;
-    pageCount?: number;
-    enableRowSelection?: boolean;
-    enableRowPinning?: boolean;
-    density?: 'standard' | 'comfortable' | 'compact';
-    service?: ITableService<TData>;
-    serviceName?: string;
-    isLoading?: boolean;
-    onBatchDiscard?: () => void;
-    enableContextMenu?: boolean;
-    onContextMenuItemClick?: (item: unknown) => void;
-    renderDetailPanel?: (row: Row<TData>) => default_2.ReactNode;
-    enableGrouping?: boolean;
-    enableColumnReorder?: boolean;
-    onFormRender?: (props: unknown) => default_2.ReactNode;
-    scrollBehavior?: ScrollBehavior;
-    renderNoRowsOverlay?: () => default_2.ReactNode;
-    /**
-     * Whether to show the status bar at the bottom of the table.
-     * Defaults to true.
-     * @group Properties
-     */
-    enableStatusBar?: boolean;
-}
-
-declare interface EzTableRef<TData extends object> {
-    getState: () => TableState;
-    getSelectedRows: () => TData[];
-    saveChanges: () => Promise<void>;
-    cancelChanges: () => void;
-    getChanges: () => any;
-    validateField: (field: string) => boolean;
-    validateEditForm: () => boolean;
-    [key: string]: any;
-}
-
-export declare const EzTableRoot: <TData extends object>({ data, children }: EzTableRootProps<TData>) => JSX.Element;
-
-declare interface EzTableRootProps<TData> {
-    data: TData[];
-    children: default_2.ReactNode;
-}
-
-/**
- * Custom component slots for override.
- * @group Models
- */
-declare interface EzTableSlots<TData = unknown> {
-    /** Custom toolbar component. @group Properties */
-    toolbar?: default_2.ComponentType<unknown>;
-    /** Custom footer component. @group Properties */
-    footer?: default_2.ComponentType<unknown>;
-    /** Custom overlay for empty state. @group Properties */
-    noRowsOverlay?: default_2.ComponentType<unknown>;
-    /** Custom loading overlay. @group Properties */
-    loadingOverlay?: default_2.ComponentType<unknown>;
-    /** Custom header component. @group Properties */
-    header?: default_2.ComponentType<unknown>;
-    /** Custom row component. @group Properties */
-    row?: default_2.ComponentType<{
-        row: Row<TData>;
-    }>;
-    /** Custom empty record component. @group Properties */
-    emptyRecord?: default_2.ComponentType<unknown>;
-    /** Custom loading component. @group Properties */
-    loading?: default_2.ComponentType<unknown>;
-}
-
-declare interface FilterGroup {
-    kind?: 'group';
-    id?: string;
-    logic: 'AND' | 'OR';
-    filters: (FilterRule | FilterGroup)[];
-}
-
-/**
- * Filter Utilities Types
- */
-declare type FilterOperator = 'contains' | 'doesNotContain' | 'shouldContain' | 'equals' | 'notEquals' | 'doesNotEqual' | 'startsWith' | 'endsWith' | 'empty' | 'notEmpty' | 'gt' | 'greaterThan' | 'lt' | 'lessThan' | 'gte' | 'greaterThanOrEqual' | 'lte' | 'lessThanOrEqual' | 'between' | 'in' | 'notIn';
-
-declare interface FilterRule<TValue = unknown> {
-    kind?: 'rule';
-    id?: string;
-    field: string;
-    operator: FilterOperator;
-    value: TValue;
-    condition?: 'and' | 'or';
-}
-
-/**
- * Configuration for filtering behavior.
- * @group Models
- */
-declare interface FilterSettings {
-    /** Filter UI type. @group Properties */
-    type?: 'Menu' | 'CheckBox' | 'Excel';
-    /** Whether to ignore accents during filtering. @group Properties */
-    ignoreAccent?: boolean;
-    /** Filter application mode. @group Properties */
-    mode?: 'Immediate' | 'OnEnter';
-    /** Whether to show the filter bar status. @group Properties */
-    showFilterBarStatus?: boolean;
-}
-
-/**
- * Base interface for all services in the EzUX ecosystem.
- * @group Services
- */
-declare interface IService {
-    /** Unique name of the service for registration and lookup. @group Data */
-    name: string;
-    /** Optional cleanup logic to run when the service is unregistered. @group Methods */
-    cleanup?: () => void;
-}
-
-declare interface ITableService<TData extends object> {
-    fetchData: (query: unknown) => Promise<{
-        data: TData[];
-        rowCount?: number;
-    }>;
-    getData: (params: TableParams<TData>) => Promise<{
-        data: TData[];
-        rowCount?: number;
-    } | {
-        data: TData[];
-        totalCount: number;
-    }>;
-    createRow: (row: Partial<TData>) => Promise<TData>;
-    updateRow: (id: string | number, updates: Partial<TData>) => Promise<TData>;
-    deleteRow: (id: string | number) => Promise<void>;
-}
-
-/**
- * Common pagination model
- */
-declare interface PaginationModel {
-    pageIndex: number;
-    pageSize: number;
-    totalRows?: number;
-}
-
-/**
- * Configuration for global search behavior.
- * @group Models
- */
-declare interface SearchSettings {
-    /** Specific fields to search in. @group Properties */
-    fields?: string[];
-    /** Search operator. @group Properties */
-    operator?: 'contains' | 'startsWith' | 'endsWith' | 'equal';
-    /** Search key/term. @group Properties */
-    key?: string;
-    /** Whether to ignore case during search. @group Properties */
-    ignoreCase?: boolean;
-}
-
-/**
- * Configuration for row/cell selection behavior.
- * @group Models
- */
-declare interface SelectionSettings {
-    /** Selection mode. @group Properties */
-    mode?: 'Row' | 'Cell' | 'Both';
-    /** Selection type. @group Properties */
-    type?: 'Single' | 'Multiple';
-    /** Whether to allow selection only via checkbox. @group Properties */
-    checkboxOnly?: boolean;
-    /** Whether to persist selection across data updates. @group Properties */
-    persistSelection?: boolean;
-}
-
-/**
- * Interface for a service repository that manages service lifecycles and dependency injection.
- * @group Services
- */
-declare interface ServiceRegistry {
-    /** Registers a service instance by name. @group Methods */
-    register<T extends IService>(name: string, service: T): void;
-    /** Retrieves a service instance by name, if it exists. @group Methods */
-    get<T extends IService>(name: string): T | undefined;
-    /** Retrieves a service or throws an error if not found. @group Methods */
-    getOrThrow<T extends IService>(name: string): T;
-    /** Removes a service from the registry and triggers its cleanup. @group Methods */
-    unregister(name: string): void;
-    /** Triggers cleanup for all registered services. @group Methods */
-    cleanupAll(): void;
-    /** Subscribes to registry state changes (e.g. services added or removed). @group Methods */
-    subscribe(listener: (state: ServiceRegistryState) => void): () => void;
-}
-
-declare interface ServiceRegistryState {
-    serviceNames: string[];
-}
-
-declare interface SharedBaseProps<TData = unknown> extends BaseComponentProps, ComponentEventCallbacks<TData> {
-    /**
-     * The shared service registry instance.
-     * This is required to access shared services like HierarchyService, FocusManagerService, etc.
-     * @group Services
-     */
-    serviceRegistry?: ServiceRegistry;
-}
-
-/**
- * Common sort direction
- */
-declare type SortDirection = 'asc' | 'desc' | false;
-
-/**
- * Common sort model
- */
-declare interface SortModel {
-    field: string;
-    direction: SortDirection;
-}
-
-/**
- * Configuration for sorting behavior.
- * @group Models
- */
-declare interface SortSettings {
-    /** Sort mode (single or multiple columns). @group Properties */
-    mode?: 'Single' | 'Multiple';
-    /** Whether to allow unsorting columns. @group Properties */
-    allowUnsort?: boolean;
-}
-
-export declare const TableInstanceContext: default_2.Context<Table<any> | null>;
-
-/* Excluded from this release type: TableParams */
-
-/**
- * Configuration for text wrapping.
- * @group Models
- */
-declare interface TextWrapSettings {
-    /** Wrap mode for header, content or both. @group Properties */
-    wrapMode?: 'Both' | 'Header' | 'Content';
-}
-
-/**
- * Represents an item in the table toolbar.
- * @group Models
- */
-declare interface ToolbarItem {
-    /** Display text for the item. @group Properties */
-    text?: string;
-    /** Tooltip text for the item. @group Properties */
-    tooltipText?: string;
-    /** Prefix icon for the item. @group Properties */
-    prefixIcon?: string | default_2.ReactNode;
-    /** Unique identifier for the item. @group Properties */
-    id?: string;
-    /** Alignment in the toolbar. @group Properties */
-    align?: 'Left' | 'Right' | 'Center';
-    /** Predefined or custom type. @group Properties */
-    type?: ToolbarItemType;
-    /** Custom template for rendering the item. @group Properties */
-    template?: default_2.ReactNode;
-    /** Callback when the item is clicked. @group Events */
-    onClick?: (e: default_2.MouseEvent) => void;
-}
-
-declare type ToolbarItemType = 'Search' | 'Print' | 'Export' | 'Add' | 'Edit' | 'Delete' | 'Update' | 'Cancel' | 'ColumnChooser' | string;
-
-export declare const useTableStore: <T>(selector: (state: any) => T) => T;
-
-export { }
-
-
-declare module '@tanstack/react-table' {
-    interface TableMeta<TData extends RowData> {
-        updateData?: (rowIndex: number, columnId: string, value: unknown) => void;
-        editingRows?: Record<string, boolean>;
-        toggleRowEditing?: (rowIndex: number, editing?: boolean) => void;
-        focusedCell?: {
-            r: number;
-            c: number;
-        } | null;
-        setFocusedCell?: (cell: {
-            r: number;
-            c: number;
-        } | null) => void;
-        navigateFocus?: (dr: number, dc: number) => void;
-        enableEditing?: boolean;
-        isRowEditable?: (row: TData) => boolean;
-        isCellEditable?: (row: TData, columnId: string) => boolean;
-        enableSearchHighlighting?: boolean;
-        selectionSettings?: SelectionSettings;
-        editSettings?: EditSettings;
-        filterSettings?: FilterSettings;
-        searchSettings?: SearchSettings;
-        sortSettings?: SortSettings;
-        textWrapSettings?: TextWrapSettings;
-        classNames?: EzTableClassNames<TData>;
-        icons?: EzTableIcons;
-        slots?: EzTableSlots<TData>;
-        slotProps?: Record<string, unknown>;
-        localization?: EzTableLocalization;
-        gridLines?: 'Both' | 'Horizontal' | 'Vertical' | 'None';
-    }
-    interface ColumnMeta<TData extends RowData, TValue> extends EzColumnMeta {
-    }
-}
+export * from './components/EzTable/index.js'
+export {}