@reactorui/datagrid 1.0.20 → 1.0.21

package/dist/types/index.d.ts

@@ -15,9 +15,10 @@ export interface Column<T = BaseRowData> {
     align?: 'left' | 'center' | 'right';
     render?: (value: any, row: T, index: number) => ReactNode;
 }
+export type FilterOperator = 'eq' | 'neq' | 'contains' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte';
 export interface ActiveFilter {
     column: string;
-    operator: string;
+    operator: FilterOperator | string;
     value: any;
     dataType: string;
     label: string;
@@ -35,38 +36,27 @@ export interface PaginationInfo {
     end: number;
     hasNext: boolean;
     hasPrevious: boolean;
-    continuationToken?: string;
 }
-export interface ServerRequest {
-    page: number;
-    pageSize: number;
-    search: string;
-    filters: ActiveFilter[];
-    continuationToken?: string;
-}
-export interface ServerResponse<T = BaseRowData> {
-    Items: T[];
-    ContinuationToken?: string;
-    HasMore: boolean;
-    Count: number;
-}
-export interface HttpConfig {
-    bearerToken?: string;
-    apiKey?: string;
-    customHeaders?: Record<string, string>;
-    method?: 'GET' | 'POST';
-    postDataFormat?: 'form' | 'json';
-    withCredentials?: boolean;
-    timeout?: number;
+export interface LoadingState {
+    /** Data is being fetched (shows table skeleton, disables all controls) */
+    data?: boolean;
+    /** Filter is being applied */
+    filter?: boolean;
+    /** Search is being executed */
+    search?: boolean;
+    /** Refresh is in progress */
+    refresh?: boolean;
+    /** Delete operation is in progress */
+    delete?: boolean;
 }
-export type OnDataLoadCallback<T = BaseRowData> = (data: ServerResponse<T>) => void;
-export type OnDataErrorCallback = (error: Error, context: string) => void;
-export type OnLoadingStateChangeCallback = (loading: boolean, context: string) => void;
 export type OnPageChangeCallback = (page: number, paginationInfo: PaginationInfo) => void;
-export type OnPageSizeChangeCallback = (pageSize: number, paginationInfo: PaginationInfo) => void;
+export type OnPageSizeChangeCallback = (pageSize: number) => void;
 export type OnSortChangeCallback = (sortConfig: SortConfig) => void;
-export type OnFilterChangeCallback = (filters: ActiveFilter[]) => void;
 export type OnSearchChangeCallback = (searchTerm: string) => void;
+export type OnApplyFilterCallback = (filter: ActiveFilter, allFilters: ActiveFilter[]) => void;
+export type OnRemoveFilterCallback = (removedFilter: ActiveFilter, remainingFilters: ActiveFilter[]) => void;
+export type OnClearFiltersCallback = () => void;
+export type OnFilterChangeCallback = (filters: ActiveFilter[]) => void;
 export type OnTableRowClickCallback<T = BaseRowData> = (row: T, event: React.MouseEvent) => void;
 export type OnTableRowDoubleClickCallback<T = BaseRowData> = (row: T, event: React.MouseEvent) => boolean | void;
 export type OnRowSelectCallback<T = BaseRowData> = (row: T, isSelected: boolean) => void;
@@ -76,38 +66,86 @@ export type OnCellClickCallback<T = BaseRowData> = (value: any, row: T, column:
 export type OnTableRefreshCallback = () => void;
 export type OnBulkDeleteCallback<T = BaseRowData> = (selectedRows: T[]) => void;
 export interface DataGridProps<T = BaseRowData> extends Omit<HTMLAttributes<HTMLDivElement>, 'onError'> {
-    data?: T[];
-    endpoint?: string;
+    /** The data array to display - parent is responsible for fetching/filtering */
+    data: T[];
+    /** Column definitions - auto-detected if not provided */
     columns?: Column<T>[];
+    /**
+     * Granular loading states for different actions.
+     * @example { data: true } - Shows table skeleton
+     * @example { filter: true } - Shows spinner on Apply Filter button
+     * @example { refresh: true } - Shows spinner on Refresh button
+     */
+    loadingState?: LoadingState;
+    /**
+     * Simple loading flag - sets loadingState.data = true.
+     * Use this OR loadingState, not both.
+     * @deprecated Prefer loadingState for granular control
+     */
+    loading?: boolean;
+    /** Total records for pagination display (server-side) */
+    totalRecords?: number;
+    /** Whether more data is available (server-side) */
+    hasMore?: boolean;
+    /** Error message to display */
+    error?: string | null;
     enableSearch?: boolean;
     enableSorting?: boolean;
     enableFilters?: boolean;
     enableSelection?: boolean;
     enableDelete?: boolean;
+    enableRefresh?: boolean;
     deleteConfirmation?: boolean;
     pageSize?: number;
-    serverPageSize?: number;
     pageSizeOptions?: number[];
-    enableRefresh?: boolean;
-    httpConfig?: HttpConfig;
+    /** Current page (controlled mode for server-side) */
+    currentPage?: number;
+    /**
+     * Set a max height for the grid - enables scrollable table body.
+     * Can be any CSS value: '400px', '50vh', 'calc(100vh - 200px)'
+     */
+    maxHeight?: string | number;
+    /**
+     * Keep table header visible while scrolling (sticky header).
+     * Automatically enabled when maxHeight is set.
+     */
+    stickyHeader?: boolean;
     className?: string;
     variant?: 'default' | 'striped' | 'bordered';
     size?: 'sm' | 'md' | 'lg';
-    onDataLoad?: OnDataLoadCallback<T>;
-    onDataError?: OnDataErrorCallback;
-    onLoadingStateChange?: OnLoadingStateChangeCallback;
     onPageChange?: OnPageChangeCallback;
     onPageSizeChange?: OnPageSizeChangeCallback;
     onSortChange?: OnSortChangeCallback;
-    onFilterChange?: OnFilterChangeCallback;
     onSearchChange?: OnSearchChangeCallback;
-    onTableRefresh?: OnTableRefreshCallback;
+    /** Called when Apply Filter button is clicked */
+    onApplyFilter?: OnApplyFilterCallback;
+    /** Called when a filter tag is removed */
+    onRemoveFilter?: OnRemoveFilterCallback;
+    /** Called when Clear All is clicked */
+    onClearFilters?: OnClearFiltersCallback;
+    /** Called whenever filters change (convenience callback) */
+    onFilterChange?: OnFilterChangeCallback;
     onTableRowClick?: OnTableRowClickCallback<T>;
     onTableRowDoubleClick?: OnTableRowDoubleClickCallback<T>;
     onRowSelect?: OnRowSelectCallback<T>;
     onSelectionChange?: OnSelectionChangeCallback<T>;
     onTableRowHover?: OnTableRowHoverCallback<T>;
     onCellClick?: OnCellClickCallback<T>;
+    onTableRefresh?: OnTableRefreshCallback;
     onBulkDelete?: OnBulkDeleteCallback<T>;
 }
+/** Request object that parent can use to build API calls */
+export interface DataGridRequest {
+    page: number;
+    pageSize: number;
+    search: string;
+    filters: ActiveFilter[];
+    sort: SortConfig;
+}
+/** Helper type for building API responses */
+export interface DataGridResponse<T = BaseRowData> {
+    items: T[];
+    totalRecords: number;
+    hasMore?: boolean;
+}
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -1 +1,2 @@
+// File: src/types/index.ts
 export {};

package/dist/utils/index.d.ts

@@ -1,12 +1,21 @@
-import { HttpConfig, ServerRequest, ServerResponse } from '../types';
+import type { ActiveFilter, SortConfig, DataGridRequest } from '../types';
 export declare const formatters: {
     date: (value: string, includeTime?: boolean) => string;
-    currency: (value: number, currency?: string) => string;
-    number: (value: number, decimals?: number) => string;
+    currency: (value: number, currency?: string, locale?: string) => string;
+    number: (value: number, decimals?: number, locale?: string) => string;
     truncate: (text: string, length: number) => string;
+    percentage: (value: number, decimals?: number) => string;
 };
 export declare const compareValues: (dataValue: any, filterValue: any, operator: string, dataType: string) => boolean;
-export declare const createApiRequest: <T>(endpoint: string, request: ServerRequest, config?: HttpConfig) => Promise<ServerResponse<T>>;
-export declare const mapServerResponse: <T>(data: any) => ServerResponse<T>;
 export declare const sortData: <T>(data: T[], sortColumn: string, direction: "asc" | "desc") => T[];
+export declare const inferDataType: (value: any) => "string" | "number" | "boolean" | "date" | "datetime";
+export declare const inferColumns: <T extends Record<string, any>>(data: T[]) => Array<{
+    key: string;
+    label: string;
+    sortable: boolean;
+    filterable: boolean;
+    dataType: "string" | "number" | "boolean" | "date" | "datetime";
+}>;
+export declare const generateRowId: <T extends Record<string, any>>(row: T, index: number) => string;
+export declare const buildRequest: (page: number, pageSize: number, search: string, filters: ActiveFilter[], sort: SortConfig) => DataGridRequest;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGrE,eAAO,MAAM,UAAU;kBACP,MAAM;sBAMF,MAAM;oBAOR,MAAM;qBAOL,MAAM,UAAU,MAAM;CAIxC,CAAC;AAGF,eAAO,MAAM,aAAa,GACxB,WAAW,GAAG,EACd,aAAa,GAAG,EAChB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAkEF,CAAC;AAGF,eAAO,MAAM,gBAAgB,GAAU,CAAC,EACtC,UAAU,MAAM,EAChB,SAAS,aAAa,EACtB,SAAQ,UAAe,KACtB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CA2D3B,CAAC;AAGF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,MAAM,GAAG,KAAG,cAAc,CAAC,CAAC,CA6DhE,CAAC;AAGF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,YAAY,MAAM,EAAE,WAAW,KAAK,GAAG,MAAM,KAAG,CAAC,EAiBvF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM1E,eAAO,MAAM,UAAU;kBACP,MAAM,4BAAwB,MAAM;sBAMhC,MAAM,yCAAuC,MAAM;oBAOrD,MAAM,yCAAmC,MAAM;qBAO9C,MAAM,UAAU,MAAM,KAAG,MAAM;wBAK5B,MAAM,wBAAiB,MAAM;CAGlD,CAAC;AAMF,eAAO,MAAM,aAAa,GACxB,WAAW,GAAG,EACd,aAAa,GAAG,EAChB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAgBF,CAAC;AA0EF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,YAAY,MAAM,EAAE,WAAW,KAAK,GAAG,MAAM,KAAG,CAAC,EA6BvF,CAAC;AAMF,eAAO,MAAM,aAAa,GACxB,OAAO,GAAG,KACT,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAiB7C,CAAC;AAMF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxD,MAAM,CAAC,EAAE,KACR,KAAK,CAAC;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;CACjE,CAWA,CAAC;AAcF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,MAAM,KAAG,MAYpF,CAAC;AAMF,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,SAAS,YAAY,EAAE,EACvB,MAAM,UAAU,KACf,eAMD,CAAC"}

package/dist/utils/index.js

@@ -1,4 +1,7 @@
-// Data formatting utilities (keeping existing ones)
+// File: src/utils/index.ts
+// ============================================================================
+// Data Formatting Utilities
+// ============================================================================
 export const formatters = {
     date: (value, includeTime = false) => {
         if (!value)
@@ -6,14 +9,14 @@ export const formatters = {
         const date = new Date(value);
         return includeTime ? date.toLocaleString() : date.toLocaleDateString();
     },
-    currency: (value, currency = 'USD') => {
-        return new Intl.NumberFormat('en-US', {
+    currency: (value, currency = 'USD', locale = 'en-US') => {
+        return new Intl.NumberFormat(locale, {
             style: 'currency',
             currency,
         }).format(value);
     },
-    number: (value, decimals = 0) => {
-        return new Intl.NumberFormat('en-US', {
+    number: (value, decimals = 0, locale = 'en-US') => {
+        return new Intl.NumberFormat(locale, {
             minimumFractionDigits: decimals,
             maximumFractionDigits: decimals,
         }).format(value);
@@ -23,187 +26,194 @@ export const formatters = {
             return text;
         return text.substring(0, length) + '...';
     },
+    percentage: (value, decimals = 0) => {
+        return `${(value * 100).toFixed(decimals)}%`;
+    },
 };
-// Filter comparison functions (keeping existing implementation)
+// ============================================================================
+// Filter Comparison Functions
+// ============================================================================
 export const compareValues = (dataValue, filterValue, operator, dataType) => {
     if (dataValue == null)
         return false;
     switch (dataType) {
         case 'string':
-            const str = dataValue.toString().toLowerCase();
-            const filter = filterValue.toString().toLowerCase();
-            switch (operator) {
-                case 'eq':
-                    return str === filter;
-                case 'contains':
-                    return str.includes(filter);
-                case 'startsWith':
-                    return str.startsWith(filter);
-                case 'endsWith':
-                    return str.endsWith(filter);
-                default:
-                    return str.includes(filter);
-            }
+            return compareString(dataValue, filterValue, operator);
         case 'number':
-            const num = parseFloat(dataValue);
-            const filterNum = parseFloat(filterValue);
-            switch (operator) {
-                case 'eq':
-                    return num === filterNum;
-                case 'gt':
-                    return num > filterNum;
-                case 'gte':
-                    return num >= filterNum;
-                case 'lt':
-                    return num < filterNum;
-                case 'lte':
-                    return num <= filterNum;
-                default:
-                    return num === filterNum;
-            }
+            return compareNumber(dataValue, filterValue, operator);
         case 'date':
         case 'datetime':
-            const date = new Date(dataValue).getTime();
-            const filterDate = new Date(filterValue).getTime();
-            switch (operator) {
-                case 'eq':
-                    return date === filterDate;
-                case 'gt':
-                    return date > filterDate;
-                case 'gte':
-                    return date >= filterDate;
-                case 'lt':
-                    return date < filterDate;
-                case 'lte':
-                    return date <= filterDate;
-                default:
-                    return date === filterDate;
-            }
+            return compareDate(dataValue, filterValue, operator);
         case 'boolean':
-            return Boolean(dataValue) === Boolean(filterValue);
+            return Boolean(dataValue) === (filterValue === 'true' || filterValue === true);
         default:
             return String(dataValue).toLowerCase().includes(String(filterValue).toLowerCase());
     }
 };
-// Simplified API utilities
-export const createApiRequest = async (endpoint, request, config = {}) => {
-    const { method = 'GET', bearerToken, apiKey, customHeaders = {}, withCredentials = false, timeout = 30000, } = config;
-    // Build headers
-    const headers = {
-        'Content-Type': 'application/json',
-        ...customHeaders,
-    };
-    if (bearerToken) {
-        headers.Authorization = `Bearer ${bearerToken}`;
-    }
-    if (apiKey) {
-        headers['X-API-Key'] = apiKey;
-    }
-    // Build request
-    const requestOptions = {
-        method,
-        headers,
-        credentials: withCredentials ? 'include' : 'same-origin',
-    };
-    let url = endpoint;
-    if (method === 'POST') {
-        requestOptions.body = JSON.stringify({ request });
-    }
-    else {
-        const params = new URLSearchParams({ request: JSON.stringify(request) });
-        url = `${endpoint}?${params.toString()}`;
-    }
-    // Create timeout
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeout);
-    requestOptions.signal = controller.signal;
-    try {
-        const response = await fetch(url, requestOptions);
-        clearTimeout(timeoutId);
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-        }
-        const data = await response.json();
-        return mapServerResponse(data);
-    }
-    catch (error) {
-        clearTimeout(timeoutId);
-        throw error;
+const compareString = (value, filter, operator) => {
+    const str = String(value).toLowerCase();
+    const filterStr = String(filter).toLowerCase();
+    switch (operator) {
+        case 'eq':
+            return str === filterStr;
+        case 'neq':
+            return str !== filterStr;
+        case 'contains':
+            return str.includes(filterStr);
+        case 'startsWith':
+            return str.startsWith(filterStr);
+        case 'endsWith':
+            return str.endsWith(filterStr);
+        default:
+            return str.includes(filterStr);
     }
 };
-// Simplified server response mapping with flexible casing
-export const mapServerResponse = (data) => {
-    // Helper to get value with flexible casing
-    const getValue = (obj, keys) => {
-        for (const key of keys) {
-            if (obj[key] !== undefined)
-                return obj[key];
-        }
-        return undefined;
-    };
-    // Get items with flexible casing
-    const items = getValue(data, ['Items', 'items', 'data', 'Data']);
-    // Get continuation token with flexible casing
-    const continuationToken = getValue(data, [
-        'ContinuationToken',
-        'continuationToken',
-        'continuationtoken',
-        'nextToken',
-        'next_token',
-        'NextToken',
-    ]);
-    // Get hasMore with flexible casing
-    const hasMore = getValue(data, [
-        'HasMore',
-        'hasMore',
-        'hasmore',
-        'has_more',
-        'hasNextPage',
-        'has_next_page',
-    ]);
-    // Get count with flexible casing
-    const count = getValue(data, ['Count', 'count', 'COUNT', 'total', 'Total', 'length', 'size']);
-    // Direct mapping for arrays
-    if (Array.isArray(data)) {
-        return {
-            Items: data,
-            HasMore: false,
-            Count: data.length,
-        };
+const compareNumber = (value, filter, operator) => {
+    const num = parseFloat(value);
+    const filterNum = parseFloat(filter);
+    if (isNaN(num) || isNaN(filterNum))
+        return false;
+    switch (operator) {
+        case 'eq':
+            return num === filterNum;
+        case 'neq':
+            return num !== filterNum;
+        case 'gt':
+            return num > filterNum;
+        case 'gte':
+            return num >= filterNum;
+        case 'lt':
+            return num < filterNum;
+        case 'lte':
+            return num <= filterNum;
+        default:
+            return num === filterNum;
     }
-    // AWS DynamoDB style response (special case)
-    if (data.Items && data.LastEvaluatedKey) {
-        return {
-            Items: data.Items,
-            ContinuationToken: JSON.stringify(data.LastEvaluatedKey),
-            HasMore: !!data.LastEvaluatedKey,
-            Count: data.Count || data.Items.length,
-        };
+};
+const compareDate = (value, filter, operator) => {
+    const date = new Date(value).getTime();
+    const filterDate = new Date(filter).getTime();
+    if (isNaN(date) || isNaN(filterDate))
+        return false;
+    switch (operator) {
+        case 'eq':
+            return date === filterDate;
+        case 'neq':
+            return date !== filterDate;
+        case 'gt':
+            return date > filterDate;
+        case 'gte':
+            return date >= filterDate;
+        case 'lt':
+            return date < filterDate;
+        case 'lte':
+            return date <= filterDate;
+        default:
+            return date === filterDate;
     }
-    // Standard response mapping
-    return {
-        Items: Array.isArray(items) ? items : [],
-        ContinuationToken: continuationToken,
-        HasMore: Boolean(hasMore),
-        Count: Number(count) || 0,
-    };
 };
-// Sorting utilities (keeping existing implementation)
+// ============================================================================
+// Sorting Utilities
+// ============================================================================
 export const sortData = (data, sortColumn, direction) => {
-    if (!sortColumn)
+    if (!sortColumn || data.length === 0)
         return data;
     return [...data].sort((a, b) => {
         const aVal = a[sortColumn];
         const bVal = b[sortColumn];
+        // Handle nulls - always sort to end
         if (aVal == null && bVal == null)
             return 0;
         if (aVal == null)
             return 1;
         if (bVal == null)
             return -1;
-        const aStr = String(aVal).toLowerCase();
-        const bStr = String(bVal).toLowerCase();
-        const result = aStr.localeCompare(bStr, undefined, { numeric: true });
+        // Compare based on type
+        let result;
+        if (typeof aVal === 'number' && typeof bVal === 'number') {
+            result = aVal - bVal;
+        }
+        else if (aVal instanceof Date && bVal instanceof Date) {
+            result = aVal.getTime() - bVal.getTime();
+        }
+        else {
+            // String comparison with natural sorting
+            result = String(aVal).localeCompare(String(bVal), undefined, {
+                numeric: true,
+                sensitivity: 'base',
+            });
+        }
         return direction === 'desc' ? -result : result;
     });
 };
+// ============================================================================
+// Data Type Inference
+// ============================================================================
+export const inferDataType = (value) => {
+    if (value == null)
+        return 'string';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    if (typeof value === 'number')
+        return 'number';
+    if (typeof value === 'string') {
+        // Check for ISO date format
+        const isoDateRegex = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2})?/;
+        if (isoDateRegex.test(value)) {
+            const date = new Date(value);
+            if (!isNaN(date.getTime()) && date.getFullYear() > 1900) {
+                return value.includes('T') ? 'datetime' : 'date';
+            }
+        }
+    }
+    return 'string';
+};
+// ============================================================================
+// Column Auto-Detection
+// ============================================================================
+export const inferColumns = (data) => {
+    if (data.length === 0)
+        return [];
+    const firstRow = data[0];
+    return Object.keys(firstRow).map((key) => ({
+        key,
+        label: formatColumnLabel(key),
+        sortable: true,
+        filterable: true,
+        dataType: inferDataType(firstRow[key]),
+    }));
+};
+const formatColumnLabel = (key) => {
+    return key
+        .replace(/([A-Z])/g, ' $1') // Add space before capitals
+        .replace(/[_-]/g, ' ') // Replace underscores/hyphens with spaces
+        .replace(/^\w/, (c) => c.toUpperCase()) // Capitalize first letter
+        .trim();
+};
+// ============================================================================
+// Row ID Utilities
+// ============================================================================
+export const generateRowId = (row, index) => {
+    // Prefer existing id field
+    if (row.id !== undefined)
+        return String(row.id);
+    if (row._id !== undefined)
+        return String(row._id);
+    if (row.key !== undefined)
+        return String(row.key);
+    // Generate stable ID from content
+    const contentHash = JSON.stringify(row)
+        .slice(0, 50)
+        .replace(/[^a-zA-Z0-9]/g, '');
+    return `row-${index}-${contentHash}`;
+};
+// ============================================================================
+// Export Helper for Building Requests (for parent component use)
+// ============================================================================
+export const buildRequest = (page, pageSize, search, filters, sort) => ({
+    page,
+    pageSize,
+    search,
+    filters,
+    sort,
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactorui/datagrid",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "High-performance React data grid with TypeScript support, server-side integration, and continuation token pagination",
   "main": "dist/index.js",
   "module": "dist/index.js",