tp-react-elements 2.0.5 → 3.0.0

package/dist/components/PaginatedGrid/GenericPaginatedGrid.esm.js

@@ -1,9 +1,8 @@
 import { jsxs, jsx } from 'react/jsx-runtime';
-import { useMemo, useState, useRef, useLayoutEffect, useCallback } from 'react';
-import * as XLSX from 'xlsx-js-style';
+import { useMemo, useState, useRef, useLayoutEffect, useCallback, useEffect } from 'react';
 import { MRT_ToggleGlobalFilterButton, MRT_ShowHideColumnsButton, MRT_ToggleDensePaddingButton, MRT_ToggleFullScreenButton, useMaterialReactTable, MaterialReactTable } from 'material-react-table';
 import { useQuery, keepPreviousData } from '@tanstack/react-query';
-import { Box, Tooltip, IconButton, GlobalStyles, Typography, Select, MenuItem, CircularProgress } from '@mui/material';
+import { Box, Tooltip, IconButton, GlobalStyles, Typography, Select, MenuItem, Skeleton, CircularProgress } from '@mui/material';
 import RefreshIcon from '@mui/icons-material/Refresh';
 import FileDownloadIcon from '@mui/icons-material/FileDownload';
 import FirstPageIcon from '@mui/icons-material/FirstPage';
@@ -11,6 +10,7 @@ import LastPageIcon from '@mui/icons-material/LastPage';
 import ChevronLeftIcon from '@mui/icons-material/ChevronLeft';
 import ChevronRightIcon from '@mui/icons-material/ChevronRight';
 import DynamicFilterBar from './DynamicFilterBar.esm.js';
+import { getXLSX } from '../../utils/Constants/xlsx-js-style.esm.js';
 
 const UI_DENSITY_PRESETS = {
     default: {
@@ -194,27 +194,60 @@ const OverlayLoader = ({ message }) => (jsxs(Box, { sx: {
         bgcolor: 'rgba(255,255,255,0.80)', backdropFilter: 'blur(2px)',
         zIndex: 10, gap: 1.5,
     }, children: [jsx(CircularProgress, { size: 50, thickness: 4 }), jsx(Typography, { variant: "body2", color: "text.secondary", fontWeight: 500, children: message })] }));
-const PaginationFooter = ({ pageIndex, pageSize, totalRecords, isFetching, isLoading, canPrev, canNext, onFirst, onPrev, onNext, onLast, onPageSizeChange, pageSizeOptions, density, gridId, }) => {
+// ─── Internal: skeleton loader (initial load — no data on screen yet) ────────
+const SkeletonOverlay = ({ columnCount, rowCount = 10, }) => (jsx(Box, { sx: {
+        position: 'absolute', inset: 0,
+        display: 'flex', flexDirection: 'column',
+        bgcolor: 'background.paper',
+        zIndex: 10, p: 1.5, gap: 1,
+        overflow: 'hidden',
+    }, children: Array.from({ length: rowCount }).map((_, rowIdx) => (jsx(Box, { sx: { display: 'flex', gap: 1.5 }, children: Array.from({ length: Math.max(columnCount, 1) }).map((_, colIdx) => (jsx(Skeleton, { variant: "rounded", height: 28, sx: { flex: 1, minWidth: 0 }, animation: "wave" }, colIdx))) }, rowIdx))) }));
+const useResponsiveTier = (tabletBreakpoint, mobileBreakpoint, enabled) => {
+    const [tier, setTier] = useState('desktop');
+    useEffect(() => {
+        if (!enabled || typeof window === 'undefined') {
+            setTier('desktop');
+            return;
+        }
+        const mqlTablet = window.matchMedia(`(max-width: ${tabletBreakpoint}px)`);
+        const mqlMobile = window.matchMedia(`(max-width: ${mobileBreakpoint}px)`);
+        const update = () => {
+            setTier(mqlMobile.matches ? 'mobile' : mqlTablet.matches ? 'tablet' : 'desktop');
+        };
+        update();
+        mqlTablet.addEventListener('change', update);
+        mqlMobile.addEventListener('change', update);
+        return () => {
+            mqlTablet.removeEventListener('change', update);
+            mqlMobile.removeEventListener('change', update);
+        };
+    }, [tabletBreakpoint, mobileBreakpoint, enabled]);
+    return enabled ? tier : 'desktop';
+};
+const PaginationFooter = ({ pageIndex, pageSize, totalRecords, isFetching, isLoading, canPrev, canNext, onFirst, onPrev, onNext, onLast, onPageSizeChange, pageSizeOptions, density, gridId, isStacked, }) => {
     const fs = density.footerFontSize;
     const selectH = density.footerMinHeight - 8;
     const startRow = totalRecords === 0 ? 0 : pageIndex * pageSize + 1;
     const endRow = Math.min((pageIndex + 1) * pageSize, totalRecords);
     return (jsxs(Box, { sx: {
-            display: 'flex', alignItems: 'center', justifyContent: 'flex-end',
+            display: 'flex',
+            flexDirection: isStacked ? 'column' : 'row',
+            alignItems: isStacked ? 'stretch' : 'center',
+            justifyContent: isStacked ? 'center' : 'flex-end',
             gap: { xs: 1, md: 2 }, px: 1.5, py: density.footerPaddingY,
             borderTop: '1px solid', borderColor: 'divider',
             bgcolor: 'background.paper', flexWrap: 'wrap',
             minHeight: density.footerMinHeight,
             flexShrink: 0,
-        }, children: [jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 0.75 }, children: [jsx(Typography, { sx: { fontSize: fs }, color: "text.secondary", noWrap: true, children: "Rows per page:" }), jsx(Select, { value: pageSize, onChange: (e) => onPageSizeChange(Number(e.target.value)), inputProps: { id: `${gridId}_page_size_select` }, size: "small", variant: "outlined", sx: {
+        }, children: [jsxs(Box, { sx: { display: 'flex', alignItems: 'center', justifyContent: isStacked ? 'center' : 'flex-start', gap: 0.75 }, children: [jsx(Typography, { sx: { fontSize: fs }, color: "text.secondary", noWrap: true, children: "Rows per page:" }), jsx(Select, { value: pageSize, onChange: (e) => onPageSizeChange(Number(e.target.value)), inputProps: { id: `${gridId}_page_size_select` }, size: "small", variant: "outlined", sx: {
                             height: selectH, fontSize: fs - 1, minWidth: 72,
                             '.MuiSelect-select': { py: '2px !important' },
                             '.MuiOutlinedInput-notchedOutline': { borderColor: 'divider' },
-                        }, children: pageSizeOptions.map((opt) => (jsx(MenuItem, { value: opt, sx: { fontSize: fs - 1 }, children: opt.toLocaleString() }, opt))) })] }), jsx(Typography, { sx: { fontSize: fs }, color: "text.secondary", noWrap: true, children: isLoading || (isFetching && totalRecords === 0)
+                        }, children: pageSizeOptions.map((opt) => (jsx(MenuItem, { value: opt, sx: { fontSize: fs - 1 }, children: opt.toLocaleString() }, opt))) })] }), jsx(Typography, { sx: { fontSize: fs, textAlign: isStacked ? 'center' : 'left' }, color: "text.secondary", noWrap: true, children: isLoading || (isFetching && totalRecords === 0)
                     ? 'Loading…'
                     : totalRecords === 0
                         ? 'No records'
-                        : `${startRow.toLocaleString()}–${endRow.toLocaleString()} of ${totalRecords.toLocaleString()}` }), jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 0.25 }, children: [jsx(Tooltip, { title: "First page", children: jsx("span", { children: jsx(IconButton, { id: `${gridId}_first_page_icon`, size: "small", onClick: onFirst, disabled: !canPrev, sx: { p: 0.5 }, children: jsx(FirstPageIcon, { sx: { fontSize: density.footerIconSize } }) }) }) }), jsx(Tooltip, { title: "Previous page", children: jsx("span", { children: jsx(IconButton, { id: `${gridId}_prev_page_icon`, size: "small", onClick: onPrev, disabled: !canPrev, sx: { p: 0.5 }, children: jsx(ChevronLeftIcon, { sx: { fontSize: density.footerIconSize } }) }) }) }), jsx(Typography, { fontWeight: 600, sx: {
+                        : `${startRow.toLocaleString()}–${endRow.toLocaleString()} of ${totalRecords.toLocaleString()}` }), jsxs(Box, { sx: { display: 'flex', alignItems: 'center', justifyContent: isStacked ? 'center' : 'flex-start', gap: 0.25 }, children: [jsx(Tooltip, { title: "First page", children: jsx("span", { children: jsx(IconButton, { id: `${gridId}_first_page_icon`, size: "small", onClick: onFirst, disabled: !canPrev, sx: { p: 0.5 }, children: jsx(FirstPageIcon, { sx: { fontSize: density.footerIconSize } }) }) }) }), jsx(Tooltip, { title: "Previous page", children: jsx("span", { children: jsx(IconButton, { id: `${gridId}_prev_page_icon`, size: "small", onClick: onPrev, disabled: !canPrev, sx: { p: 0.5 }, children: jsx(ChevronLeftIcon, { sx: { fontSize: density.footerIconSize } }) }) }) }), jsx(Typography, { fontWeight: 600, sx: {
                             mx: 0.5,
                             minWidth: density.footerMinHeight - 12,
                             height: density.footerMinHeight - 12,
@@ -224,13 +257,29 @@ const PaginationFooter = ({ pageIndex, pageSize, totalRecords, isFetching, isLoa
                         }, children: pageIndex + 1 }), jsx(Tooltip, { title: "Next page", children: jsx("span", { children: jsx(IconButton, { id: `${gridId}_next_page_icon`, size: "small", onClick: onNext, disabled: !canNext, sx: { p: 0.5 }, children: jsx(ChevronRightIcon, { sx: { fontSize: density.footerIconSize } }) }) }) }), jsx(Tooltip, { title: "Last page", children: jsx("span", { children: jsx(IconButton, { id: `${gridId}_last_page_icon`, size: "small", onClick: onLast, disabled: !canNext, sx: { p: 0.5 }, children: jsx(LastPageIcon, { sx: { fontSize: density.footerIconSize } }) }) }) })] })] }));
 };
 // ─── GenericPaginatedGrid ─────────────────────────────────────────────────────
-function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs, defaultFilters, defaultVisibleFilterIds, batchSize = 10000, exportFilename = 'export', gridId, tableHeight, tableMinHeight = '300px', tableMaxHeight, autoFillViewport = true, layoutMode = 'grid', uiDensity = 'default', uiDensityOptions, pageSizeOptions = [1000, 5000, 10000], showGlobalSearchByDefault = false, headerBgColor, exportHeaderBgColor, exportHeaderTextColor, headerMinHeight, headerMaxHeight, headerMaxLines, headerFontSize, bodyFontSize, maxVisibleFilters = 4, muiTableBodyCellProps: gridBodyCellProps, muiTableHeadCellProps: gridHeadCellProps, renderDetailPanel, enableExpanding = !!renderDetailPanel, }) {
-    const densityTokens = useMemo(() => ({ ...UI_DENSITY_PRESETS[uiDensity], ...uiDensityOptions }), [uiDensity, uiDensityOptions]);
+function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs, defaultFilters, defaultVisibleFilterIds, batchSize = 10000, exportFilename = 'export', gridId, tableHeight, tableMinHeight = '300px', tableMaxHeight, autoFillViewport = true, layoutMode = 'grid', uiDensity, uiDensityOptions, responsiveBreakpoints, disableResponsive = false, pageSizeOptions = [1000, 5000, 10000], showGlobalSearchByDefault = false, showDensityToggle = false, headerBgColor, exportHeaderBgColor, exportHeaderTextColor, headerMinHeight, headerMaxHeight, headerMaxLines, headerFontSize, bodyFontSize, maxVisibleFilters = 4, muiTableBodyCellProps: gridBodyCellProps, muiTableHeadCellProps: gridHeadCellProps, renderDetailPanel, enableExpanding = !!renderDetailPanel, }) {
+    // ── Responsive tier detection ────────────────────────────────────────────────
+    // Three tiers (desktop / tablet / mobile) drive auto density, a progressively
+    // lower filter-chip cap, toolbar wrapping, and a stacked pagination footer —
+    // unless the consumer opts out via `disableResponsive` or pins `uiDensity`
+    // explicitly (density only).
+    const tier = useResponsiveTier(responsiveBreakpoints?.tablet ?? 1024, responsiveBreakpoints?.mobile ?? 640, !disableResponsive);
+    const isNarrow = tier !== 'desktop'; // tablet or mobile — density, toolbar wrap
+    const isMobileTier = tier === 'mobile'; // mobile only — footer stacking, tightest chip cap
+    const resolvedUiDensity = uiDensity ?? (isNarrow ? 'compact' : 'default');
+    const effectiveMaxVisibleFilters = disableResponsive
+        ? maxVisibleFilters
+        : tier === 'mobile'
+            ? Math.min(maxVisibleFilters, 2)
+            : tier === 'tablet'
+                ? Math.min(maxVisibleFilters, 3)
+                : maxVisibleFilters;
+    const densityTokens = useMemo(() => ({ ...UI_DENSITY_PRESETS[resolvedUiDensity], ...uiDensityOptions }), [resolvedUiDensity, uiDensityOptions]);
     const resolvedGridId = gridId ?? exportFilename;
-    const resolvedHeaderMinHeight = toCssSize(headerMinHeight, uiDensity === 'compact' ? '34px' : '40px');
-    const resolvedHeaderMaxHeight = toCssSize(headerMaxHeight, uiDensity === 'compact' ? '56px' : '72px');
-    const resolvedHeaderFontSize = toCssSize(headerFontSize ?? densityTokens.headerFontSize, uiDensity === 'compact' ? '11px' : '12px');
-    const resolvedBodyFontSize = toCssSize(bodyFontSize ?? densityTokens.bodyFontSize, uiDensity === 'compact' ? '11px' : '12px');
+    const resolvedHeaderMinHeight = toCssSize(headerMinHeight, resolvedUiDensity === 'compact' ? '34px' : '40px');
+    const resolvedHeaderMaxHeight = toCssSize(headerMaxHeight, resolvedUiDensity === 'compact' ? '56px' : '72px');
+    const resolvedHeaderFontSize = toCssSize(headerFontSize ?? densityTokens.headerFontSize, resolvedUiDensity === 'compact' ? '11px' : '12px');
+    const resolvedBodyFontSize = toCssSize(bodyFontSize ?? densityTokens.bodyFontSize, resolvedUiDensity === 'compact' ? '11px' : '12px');
     const tableStyleOverrides = useMemo(() => ({
         // Static rules folded in here so the whole object comes from one useMemo
         // and GlobalStyles receives a stable reference unless these props change.
@@ -239,6 +288,17 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
         '.tp-gpg-root button[aria-label="Move"]': { display: 'none !important' },
         '.tp-gpg-root [data-column-id="mrt-row-spacer"]': { display: 'none !important' },
         '.tp-gpg-root .Mui-TableHeadCell-ColumnSpacer': { display: 'none !important' },
+        // Visible horizontal scrollbar — touch devices (iOS) hide scrollbars by
+        // default, leaving no affordance that a horizontally-overflowing table
+        // (common on narrow viewports) can be scrolled.
+        '.tp-gpg-root .MuiTableContainer-root::-webkit-scrollbar': {
+            height: 6,
+            width: 6,
+        },
+        '.tp-gpg-root .MuiTableContainer-root::-webkit-scrollbar-thumb': {
+            backgroundColor: 'rgba(0,0,0,0.25)',
+            borderRadius: 4,
+        },
         ...buildHeaderGlobalStyles(resolvedHeaderMinHeight, resolvedHeaderMaxHeight, resolvedHeaderFontSize, headerBgColor),
         ...buildBodyGlobalStyles(resolvedBodyFontSize),
     }), [
@@ -333,14 +393,15 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
     const totalRecords = data?.totalRecords ?? 0;
     // ── Strip custom props + auto-inject filterFn before passing to MRT ──────────
     //
-    // `TPColumnDef` extends `MRT_ColumnDef` with `filterType` and `options`.
-    // MRT doesn't know these props, so we strip them here. We also inject the
-    // appropriate `filterFn` automatically so callers never have to write one.
+    // `TPColumnDef` extends `MRT_ColumnDef` with `filterType`, `options`, and
+    // `getSearchText`. MRT doesn't know these props, so we strip them here. We
+    // also inject the appropriate `filterFn` automatically so callers never
+    // have to write one.
     const processedColumns = useMemo(() => {
         const allowGrow = layoutMode === 'grid' || layoutMode === 'semantic';
         return columns.map((col) => {
             // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            const { filterType, options, ...mrtCol } = col;
+            const { filterType, options, getSearchText, ...mrtCol } = col;
             if (allowGrow && mrtCol.grow === undefined) {
                 mrtCol.grow = true;
             }
@@ -370,6 +431,41 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
             return mrtCol;
         });
     }, [columns, layoutMode]);
+    // ── Global Search: match formatted `Cell` text, not just the raw value ───────
+    //
+    // MRT's built-in global filter always compares against `row.getValue(columnId)`
+    // (the raw accessor value) and never against what `Cell` renders. A column
+    // whose `Cell` formats/maps that value for display (dates, currency, status
+    // labels, …) is therefore unsearchable by the text a user actually sees —
+    // typing "01 Jul 2026" finds nothing because the raw value is really
+    // "2026-07-01T00:00:00". `getSearchText` on `TPColumnDef` lets a column opt
+    // in to being matched against its formatted representation instead.
+    const searchTextGetters = useMemo(() => {
+        const map = new Map();
+        columns.forEach((col) => {
+            const getSearchText = col.getSearchText;
+            if ('accessorKey' in col && col.accessorKey && typeof getSearchText === 'function') {
+                map.set(col.accessorKey, getSearchText);
+            }
+        });
+        return map;
+    }, [columns]);
+    const tpGlobalSearchFn = useCallback((row, columnId, filterValue) => {
+        const needle = String(filterValue ?? '').trim().toLowerCase();
+        if (!needle)
+            return true;
+        const getSearchText = searchTextGetters.get(columnId);
+        const value = getSearchText ? getSearchText(row.original) : row.getValue(columnId);
+        if (value === null || value === undefined)
+            return false;
+        return String(value).toLowerCase().includes(needle);
+    }, [searchTextGetters]);
+    // Stable references for the two table options below — recreating either
+    // per render would defeat the memoization on every other MRT callback
+    // (see docs/arch-performance.mdx: all function/object props passed into
+    // useMaterialReactTable must be memoized).
+    const tpFilterFns = useMemo(() => ({ tpGlobalSearch: tpGlobalSearchFn }), [tpGlobalSearchFn]);
+    const getColumnCanGlobalFilter = useCallback(() => true, []);
     // ── Derive column list for filter chip picker ──────────────────────────────
     //
     // A column is excluded from the "Column Filters" section of Manage Filters
@@ -407,10 +503,15 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
     const handleToggleFilter = useCallback((id) => setVisibleFilterIds((prev) => {
         if (prev.includes(id))
             return prev.filter((v) => v !== id); // always allow remove
-        if (prev.length >= maxVisibleFilters)
+        if (prev.length >= effectiveMaxVisibleFilters)
             return prev; // cap reached — ignore add
         return [...prev, id];
-    }), [maxVisibleFilters]);
+    }), [effectiveMaxVisibleFilters]);
+    // Trim already-visible chips down to the new cap when the viewport narrows
+    // (e.g. resizing from desktop to mobile with 4 chips already shown).
+    useEffect(() => {
+        setVisibleFilterIds((prev) => prev.length > effectiveMaxVisibleFilters ? prev.slice(0, effectiveMaxVisibleFilters) : prev);
+    }, [effectiveMaxVisibleFilters]);
     const handleClearAll = useCallback(() => {
         setFilterValues(defaultFilters);
         setColumnFilters([]);
@@ -418,7 +519,10 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
         setGlobalFilter('');
         setPagination((p) => ({ ...p, pageIndex: 0 }));
     }, [defaultFilters, defaultVisible]);
-    const handleExport = useCallback(() => {
+    const handleExport = useCallback(async () => {
+        // Loaded on demand (and cached) so the xlsx-js-style library is excluded
+        // from the initial bundle for consumers who never click Export.
+        const XLSX = await getXLSX();
         const dataCols = columns.filter((c) => 'accessorKey' in c && c.accessorKey);
         // xlsx-js-style requires 8-char ARGB (AA + RRGGBB). Prepend full-opacity "FF".
         const toArgb = (hex, fallback = 'FF1565C0') => hex?.startsWith('#') ? 'FF' + hex.slice(1).toUpperCase().padEnd(6, '0') : fallback;
@@ -516,15 +620,20 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
     // ── Memoized toolbar render functions ─────────────────────────────────────
     // Defined with useCallback so MRT receives stable references and does not
     // re-render the toolbar on every isFetching / data update cycle.
-    const renderTopToolbarCustomActions = useCallback(() => (jsxs(Box, { sx: { display: 'flex', alignItems: 'center', flex: 1, minWidth: 0, pr: 1, gap: 0.5 }, children: [jsxs(Box, { sx: { display: 'flex', alignItems: 'center', flexShrink: 0, gap: 0.25 }, children: [jsx(Tooltip, { title: "Clear filters & refresh", children: jsx("span", { children: jsx(IconButton, { id: `${resolvedGridId}_refresh_icon`, size: "small", onClick: () => { handleClearAll(); refetch(); }, disabled: isFetching, sx: { p: uiDensity === 'compact' ? 0.35 : 0.5 }, children: jsx(RefreshIcon, { sx: { fontSize: uiDensity === 'compact' ? 18 : 20 } }) }) }) }), jsx(Tooltip, { title: "Export batch as Excel (.xlsx)", children: jsx("span", { children: jsx(IconButton, { id: `${resolvedGridId}_export_icon`, size: "small", onClick: handleExport, disabled: rows.length === 0 || isFetching, sx: { p: uiDensity === 'compact' ? 0.35 : 0.5 }, children: jsx(FileDownloadIcon, { sx: { fontSize: uiDensity === 'compact' ? 18 : 20 } }) }) }) })] }), jsx(Box, { sx: { flex: 1, minWidth: 0 }, children: jsx(DynamicFilterBar, { serverFilterDefs: serverFilterDefs, visibleFilterIds: visibleFilterIds, onToggleFilter: handleToggleFilter, filterValues: filterValues, onFilterValuesChange: handleFilterValuesChange, columnFilters: columnFilters, onColumnFilterChange: setColumnFilters, availableColumns: availableColumns, maxVisibleFilters: maxVisibleFilters, uiDensity: uiDensity, filterChipFontSize: densityTokens.filterChipFontSize, filterChipMinHeight: densityTokens.filterChipMinHeight, filterLabelFontSize: densityTokens.filterLabelFontSize, gridId: resolvedGridId }) })] })), [
-        resolvedGridId, isFetching, rows.length, uiDensity,
+    const renderTopToolbarCustomActions = useCallback(() => (jsxs(Box, { sx: {
+            display: 'flex',
+            alignItems: 'center',
+            flexWrap: isNarrow ? 'wrap' : 'nowrap',
+            flex: 1, minWidth: 0, pr: 1, gap: 0.5,
+        }, children: [jsxs(Box, { sx: { display: 'flex', alignItems: 'center', flexShrink: 0, gap: 0.25 }, children: [jsx(Tooltip, { title: "Clear filters & refresh", children: jsx("span", { children: jsx(IconButton, { id: `${resolvedGridId}_refresh_icon`, size: "small", onClick: () => { handleClearAll(); refetch(); }, disabled: isFetching, sx: { p: resolvedUiDensity === 'compact' ? 0.35 : 0.5 }, children: jsx(RefreshIcon, { sx: { fontSize: resolvedUiDensity === 'compact' ? 18 : 20 } }) }) }) }), jsx(Tooltip, { title: "Export batch as Excel (.xlsx)", children: jsx("span", { children: jsx(IconButton, { id: `${resolvedGridId}_export_icon`, size: "small", onClick: handleExport, disabled: rows.length === 0 || isFetching, sx: { p: resolvedUiDensity === 'compact' ? 0.35 : 0.5 }, children: jsx(FileDownloadIcon, { sx: { fontSize: resolvedUiDensity === 'compact' ? 18 : 20 } }) }) }) })] }), jsx(Box, { sx: { flex: 1, minWidth: isNarrow ? '100%' : 0 }, children: jsx(DynamicFilterBar, { serverFilterDefs: serverFilterDefs, visibleFilterIds: visibleFilterIds, onToggleFilter: handleToggleFilter, filterValues: filterValues, onFilterValuesChange: handleFilterValuesChange, columnFilters: columnFilters, onColumnFilterChange: setColumnFilters, availableColumns: availableColumns, maxVisibleFilters: effectiveMaxVisibleFilters, uiDensity: resolvedUiDensity, filterChipFontSize: densityTokens.filterChipFontSize, filterChipMinHeight: densityTokens.filterChipMinHeight, filterLabelFontSize: densityTokens.filterLabelFontSize, gridId: resolvedGridId }) })] })), [
+        resolvedGridId, isFetching, rows.length, resolvedUiDensity, isNarrow,
         handleClearAll, refetch, handleExport,
         serverFilterDefs, visibleFilterIds, handleToggleFilter,
         filterValues, handleFilterValuesChange, columnFilters, setColumnFilters,
-        availableColumns, maxVisibleFilters, densityTokens, handleToggleFilter,
+        availableColumns, effectiveMaxVisibleFilters, densityTokens, handleToggleFilter,
     ]);
-    const renderToolbarInternalActions = useCallback(({ table: t }) => (jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 0.5 }, children: [jsx(MRT_ToggleGlobalFilterButton, { table: t, id: `${resolvedGridId}_global_search_icon` }), jsx(MRT_ShowHideColumnsButton, { table: t, id: `${resolvedGridId}_columns_icon` }), jsx(MRT_ToggleDensePaddingButton, { table: t, id: `${resolvedGridId}_density_icon` }), jsx(MRT_ToggleFullScreenButton, { table: t, id: `${resolvedGridId}_fullscreen_icon` })] })), [resolvedGridId]);
-    const renderBottomToolbar = useCallback(({ table: t }) => (jsx(PaginationFooter, { pageIndex: t.getState().pagination.pageIndex, pageSize: t.getState().pagination.pageSize, totalRecords: totalRecords, isFetching: isFetching, isLoading: isLoading, canPrev: t.getCanPreviousPage() && !isFetching, canNext: t.getCanNextPage() && !isFetching, onFirst: () => t.firstPage(), onPrev: () => t.previousPage(), onNext: () => t.nextPage(), onLast: () => t.lastPage(), onPageSizeChange: (s) => t.setPageSize(s), pageSizeOptions: pageSizeOptions, density: densityTokens, gridId: resolvedGridId })), [totalRecords, isFetching, isLoading, pageSizeOptions, densityTokens, resolvedGridId]);
+    const renderToolbarInternalActions = useCallback(({ table: t }) => (jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 0.5 }, children: [jsx(MRT_ToggleGlobalFilterButton, { table: t, id: `${resolvedGridId}_global_search_icon` }), jsx(MRT_ShowHideColumnsButton, { table: t, id: `${resolvedGridId}_columns_icon` }), showDensityToggle && (jsx(MRT_ToggleDensePaddingButton, { table: t, id: `${resolvedGridId}_density_icon` })), jsx(MRT_ToggleFullScreenButton, { table: t, id: `${resolvedGridId}_fullscreen_icon` })] })), [resolvedGridId, showDensityToggle]);
+    const renderBottomToolbar = useCallback(({ table: t }) => (jsx(PaginationFooter, { pageIndex: t.getState().pagination.pageIndex, pageSize: t.getState().pagination.pageSize, totalRecords: totalRecords, isFetching: isFetching, isLoading: isLoading, canPrev: t.getCanPreviousPage() && !isFetching, canNext: t.getCanNextPage() && !isFetching, onFirst: () => t.firstPage(), onPrev: () => t.previousPage(), onNext: () => t.nextPage(), onLast: () => t.lastPage(), onPageSizeChange: (s) => t.setPageSize(s), pageSizeOptions: pageSizeOptions, density: densityTokens, gridId: resolvedGridId, isStacked: isMobileTier })), [totalRecords, isFetching, isLoading, pageSizeOptions, densityTokens, resolvedGridId, isMobileTier]);
     // ── Table instance ─────────────────────────────────────────────────────────
     const table = useMaterialReactTable({
         columns: processedColumns,
@@ -603,7 +712,21 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
         enableFilters: true,
         enableColumnFilters: false,
         enableGlobalFilter: true,
-        enableDensityToggle: true,
+        // Custom global filter (see `tpGlobalSearchFn` above) so columns with a
+        // formatting `Cell` are matched by their displayed text, not just the
+        // raw accessor value. Registered under `filterFns` and selected by name
+        // via `globalFilterFn` — MRT resolves `globalFilterFn` strings against
+        // this map rather than accepting a function directly.
+        filterFns: tpFilterFns,
+        globalFilterFn: 'tpGlobalSearch',
+        // MRT's default `getColumnCanGlobalFilter` only allows a column into
+        // Global Search when the very first fetched row's raw value happens to
+        // be a `string`/`number` — a null/undefined first row silently drops
+        // that column from search entirely. Our filterFn already handles
+        // null/undefined per-row, so allow every column (columns can still opt
+        // out individually via `enableGlobalFilter: false`).
+        getColumnCanGlobalFilter,
+        enableDensityToggle: showDensityToggle,
         enableFullScreenToggle: true,
         enableHiding: true,
         enableStickyHeader: true,
@@ -621,6 +744,7 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
                 minHeight: 0,
                 maxHeight: '100%',
                 overflow: 'auto',
+                WebkitOverflowScrolling: 'touch',
             },
         },
         muiTablePaperProps: {
@@ -636,10 +760,10 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
         muiTopToolbarProps: {
             sx: {
                 alignItems: 'center',
-                flexWrap: 'nowrap',
+                flexWrap: isNarrow ? 'wrap' : 'nowrap',
                 minHeight: densityTokens.filterChipMinHeight + 12,
-                py: uiDensity === 'compact' ? 0.25 : 0.5,
-                '& .MuiIconButton-root': { p: uiDensity === 'compact' ? 0.35 : 0.5 },
+                py: resolvedUiDensity === 'compact' ? 0.25 : 0.5,
+                '& .MuiIconButton-root': { p: resolvedUiDensity === 'compact' ? 0.35 : 0.5 },
                 '& .MuiIconButton-root svg': { fontSize: densityTokens.toolbarIconFontSize === 'small' ? 18 : 20 },
             },
         },
@@ -650,7 +774,7 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
             size: 'small',
             variant: 'outlined',
             sx: {
-                minWidth: uiDensity === 'compact' ? 160 : 200,
+                minWidth: resolvedUiDensity === 'compact' ? 160 : 200,
                 '& .MuiOutlinedInput-root': {
                     height: densityTokens.filterChipMinHeight,
                     fontSize: densityTokens.filterChipFontSize,
@@ -700,7 +824,7 @@ function GenericPaginatedGrid({ columns, fetchPage, queryKey, serverFilterDefs,
             display: 'flex',
             flexDirection: 'column',
             overflow: 'hidden',
-        }, children: [jsx(GlobalStyles, { styles: tableStyleOverrides }), isLoading && jsx(OverlayLoader, { message: "Loading data\u2026" }), !isLoading && isFetching && jsx(OverlayLoader, { message: "Updating data\u2026" }), jsx(Box, { sx: { flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column', overflow: 'hidden' }, children: jsx(MaterialReactTable, { table: table }) })] }));
+        }, children: [jsx(GlobalStyles, { styles: tableStyleOverrides }), isLoading && jsx(SkeletonOverlay, { columnCount: processedColumns.length }), !isLoading && isFetching && jsx(OverlayLoader, { message: "Updating data\u2026" }), jsx(Box, { sx: { flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column', overflow: 'hidden' }, children: jsx(MaterialReactTable, { table: table }) })] }));
 }
 
 export { GenericPaginatedGrid as default };

package/dist/components/PaginatedGrid/types.d.ts

@@ -75,6 +75,31 @@ export type TPColumnDef<TData extends object = object, TValue = any> = MRT_Colum
      * ```
      */
     defaultVisible?: boolean;
+    /**
+     * Text/number the Global Search box should match against for this column.
+     *
+     * MRT's built-in Global Search always matches the raw accessor value
+     * (`row.getValue(columnId)`) — **never** what `Cell` renders. So a column
+     * whose `Cell` formats or maps the raw value for display (dates, currency,
+     * status labels, etc.) becomes unsearchable by the text a user actually
+     * sees on screen: typing the formatted text finds nothing because it's
+     * being compared against the untouched raw value underneath.
+     *
+     * Set `getSearchText` to the same formatted representation `Cell` renders,
+     * and `GenericPaginatedGrid` will match Global Search against it instead:
+     *
+     * ```ts
+     * {
+     *   accessorKey: 'InvoiceDate',
+     *   Cell: ({ cell }) => formatDate(cell.getValue<string>()),
+     *   getSearchText: (row) => formatDate(row.InvoiceDate), // "01 Jul 2026" now matches
+     * }
+     * ```
+     *
+     * Omit when `Cell` is absent or simply displays the raw value unchanged —
+     * the raw accessor value is matched by default in that case.
+     */
+    getSearchText?: (row: TData) => string | number | null | undefined;
 };
 export interface InvoiceDetail {
     Data_from: string;

package/dist/components/SelectField/MultiSelectFieldComponent.esm.js

@@ -1,12 +1,12 @@
 import { jsx, jsxs } from 'react/jsx-runtime';
-import { Box, TextField, FormControlLabel, Tooltip } from '@mui/material';
+import { Tooltip, Box, TextField, FormControlLabel } from '@mui/material';
 import Checkbox from '@mui/material/Checkbox';
 import FormControl from '@mui/material/FormControl';
 import ListItemText from '@mui/material/ListItemText';
 import MenuItem from '@mui/material/MenuItem';
 import Select from '@mui/material/Select';
-import * as React from 'react';
-import { useState, useCallback } from 'react';
+import * as require$$0 from 'react';
+import { useState, useMemo, useCallback } from 'react';
 
 const ITEM_HEIGHT = 36;
 const ITEM_PADDING_TOP = 2;
@@ -16,29 +16,26 @@ const extractValuesToArray = (inputString) => {
     return trimmedArray;
 };
 function MultiSelectFieldComponent({ value, options, onChangeFn, disable = false, optionFontSize = '13px', donotEnableMultiselectOrder = false }) {
-    const [personName, setPersonName] = React.useState(value ? extractValuesToArray(value) : []);
+    const [personName, setPersonName] = require$$0.useState(value ? extractValuesToArray(value) : []);
     const [searchText, setSearchText] = useState('');
     const [selectAll, setSelectAll] = useState(false);
-    const textfieldRef = React.useRef(null);
-    const containerRef = React.useRef(null);
+    const textfieldRef = require$$0.useRef(null);
+    const containerRef = require$$0.useRef(null);
     const fieldValue = value;
-    const [savedSortValue, setSavedSortValue] = React.useState(fieldValue);
-    const sortedOptions = React.useMemo(() => {
+    const [savedSortValue, setSavedSortValue] = require$$0.useState(fieldValue);
+    const sortedOptions = require$$0.useMemo(() => {
         const selectedArray = savedSortValue ? savedSortValue.split(',') : [];
         const selectedItems = options.filter((opt) => selectedArray.includes(String(opt.value)));
         const unselectedItems = options.filter((opt) => !selectedArray.includes(String(opt.value)));
         return [...selectedItems, ...unselectedItems];
     }, [options, savedSortValue]);
-    const [filterOptions, setFilterOptions] = useState(sortedOptions);
-    React.useEffect(() => {
-        if (searchText !== '') {
-            setFilterOptions(sortedOptions.filter((item) => item.label.toLowerCase().includes(searchText.toLowerCase())));
-        }
-        else {
-            setFilterOptions(sortedOptions);
-        }
-    }, [sortedOptions, searchText]);
-    React.useEffect(() => {
+    // Derived directly from sortedOptions/searchText — previously a
+    // useState+useEffect pair that duplicated this computation and forced an
+    // extra render pass every time either dependency changed.
+    const filterOptions = useMemo(() => searchText !== ''
+        ? sortedOptions.filter((item) => item.label.toLowerCase().includes(searchText.toLowerCase()))
+        : sortedOptions, [sortedOptions, searchText]);
+    require$$0.useEffect(() => {
         const values = fieldValue ? fieldValue.split(',').filter(Boolean) : [];
         const filterIdStrings = filterOptions.map((item) => String(item.value));
         if (values.length === 0 || filterOptions.length === 0) {
@@ -57,8 +54,9 @@ function MultiSelectFieldComponent({ value, options, onChangeFn, disable = false
         setPersonName(typeof value === 'string' ? value?.split(',') : value);
         onChangeFn((typeof value === 'string' ? value?.split(',') : value).join(','));
     }, [onChangeFn]);
-    const selectedOptions = options.filter((item) => fieldValue?.split(',').some((value) => value === item.value));
-    const selectedValues = selectedOptions.map((item) => item.label).join(' , ');
+    const selectedOptions = useMemo(() => options.filter((item) => fieldValue?.split(',').some((value) => value === item.value)), [options, fieldValue]);
+    const selectedValues = useMemo(() => selectedOptions.map((item) => item.label).join(' , '), [selectedOptions]);
+    const renderSelectedValue = useCallback(() => (jsx(Tooltip, { title: selectedValues, children: jsx("span", { children: selectedOptions.length > 3 ? `${selectedOptions.length} Selected` : selectedValues }) })), [selectedOptions, selectedValues]);
     return (jsx(Box, { children: jsx(FormControl, { fullWidth: true, ref: containerRef, sx: {
                 '& .css-kichxs-MuiFormLabel-root-MuiInputLabel-root,.css-1holvmy': {
                     top: '-10px',
@@ -81,7 +79,7 @@ function MultiSelectFieldComponent({ value, options, onChangeFn, disable = false
                     if (!donotEnableMultiselectOrder) {
                         setSavedSortValue(fieldValue);
                     }
-                }, renderValue: () => (jsx(Tooltip, { title: selectedValues, children: jsx("span", { children: selectedOptions.length > 3 ? `${selectedOptions.length} Selected` : selectedValues }) })), MenuProps: {
+                }, renderValue: renderSelectedValue, MenuProps: {
                     PaperProps: {
                         style: {
                             maxHeight: ITEM_HEIGHT * 5.5 + ITEM_PADDING_TOP,

package/dist/node_modules/react-date-range/dist/components/Calendar/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as Calendar } from '../../../../../_virtual/index.esm7.js';
-import React__default from 'react';
+import { __exports as Calendar } from '../../../../../_virtual/index.esm6.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 import { __require as requireDayCell } from '../DayCell/index.esm.js';
 import { __require as requireMonth } from '../Month/index.esm.js';
@@ -23,7 +23,7 @@ function requireCalendar () {
 	  value: true
 	});
 	Calendar.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	var _DayCell = requireDayCell();
 	var _Month = _interopRequireDefault(requireMonth());

package/dist/node_modules/react-date-range/dist/components/DateInput/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as DateInput } from '../../../../../_virtual/index.esm13.js';
-import React__default from 'react';
+import { __exports as DateInput } from '../../../../../_virtual/index.esm14.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 import { __require as requireClassnames } from '../../../../classnames/index.esm.js';
 import { __require as requireDateFns } from '../../../../date-fns/index.esm.js';
@@ -14,7 +14,7 @@ function requireDateInput () {
 	  value: true
 	});
 	DateInput.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	var _classnames = _interopRequireDefault(requireClassnames());
 	var _dateFns = /*@__PURE__*/ requireDateFns();

package/dist/node_modules/react-date-range/dist/components/DateRange/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as DateRange } from '../../../../../_virtual/index.esm6.js';
-import React__default from 'react';
+import { __exports as DateRange } from '../../../../../_virtual/index.esm7.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 import { __require as requireCalendar } from '../Calendar/index.esm.js';
 import { __require as requireDayCell } from '../DayCell/index.esm.js';
@@ -18,7 +18,7 @@ function requireDateRange () {
 	  value: true
 	});
 	DateRange.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	var _Calendar = _interopRequireDefault(requireCalendar());
 	var _DayCell = requireDayCell();

package/dist/node_modules/react-date-range/dist/components/DateRangePicker/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as DateRangePicker } from '../../../../../_virtual/index.esm4.js';
-import React__default from 'react';
+import { __exports as DateRangePicker } from '../../../../../_virtual/index.esm5.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 import { __require as requireDateRange } from '../DateRange/index.esm.js';
 import { __require as requireDefinedRange } from '../DefinedRange/index.esm.js';
@@ -17,7 +17,7 @@ function requireDateRangePicker () {
 	  value: true
 	});
 	DateRangePicker.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	var _DateRange = _interopRequireDefault(requireDateRange());
 	var _DefinedRange = _interopRequireDefault(requireDefinedRange());

package/dist/node_modules/react-date-range/dist/components/DayCell/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as DayCell } from '../../../../../_virtual/index.esm12.js';
-import React__default from 'react';
+import { __exports as DayCell } from '../../../../../_virtual/index.esm11.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 import { __require as requireClassnames } from '../../../../classnames/index.esm.js';
 import { __require as requireDateFns } from '../../../../date-fns/index.esm.js';
@@ -14,7 +14,7 @@ function requireDayCell () {
 	  value: true
 	});
 	DayCell.rangeShape = DayCell.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	var _classnames = _interopRequireDefault(requireClassnames());
 	var _dateFns = /*@__PURE__*/ requireDateFns();

package/dist/node_modules/react-date-range/dist/components/DefinedRange/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as DefinedRange } from '../../../../../_virtual/index.esm5.js';
-import React__default from 'react';
+import { __exports as DefinedRange } from '../../../../../_virtual/index.esm4.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 import { __require as requireStyles } from '../../styles.esm.js';
 import { __require as requireDefaultRanges } from '../../defaultRanges.esm.js';
@@ -17,7 +17,7 @@ function requireDefinedRange () {
 	  value: true
 	});
 	DefinedRange.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	var _styles = _interopRequireDefault(requireStyles());
 	var _defaultRanges = requireDefaultRanges();

package/dist/node_modules/react-date-range/dist/components/InputRangeField/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as InputRangeField } from '../../../../../_virtual/index.esm11.js';
-import React__default from 'react';
+import { __exports as InputRangeField } from '../../../../../_virtual/index.esm12.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 
 var hasRequiredInputRangeField;
@@ -12,7 +12,7 @@ function requireInputRangeField () {
 	  value: true
 	});
 	InputRangeField.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 	function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }

package/dist/node_modules/react-date-range/dist/components/Month/index.esm.js

@@ -1,5 +1,5 @@
-import { __exports as Month } from '../../../../../_virtual/index.esm14.js';
-import React__default from 'react';
+import { __exports as Month } from '../../../../../_virtual/index.esm13.js';
+import require$$0__default from 'react';
 import { __require as requirePropTypes } from '../../../../prop-types/index.esm.js';
 import { __require as requireDayCell } from '../DayCell/index.esm.js';
 import { __require as requireDateFns } from '../../../../date-fns/index.esm.js';
@@ -15,7 +15,7 @@ function requireMonth () {
 	  value: true
 	});
 	Month.default = void 0;
-	var _react = _interopRequireWildcard(React__default);
+	var _react = _interopRequireWildcard(require$$0__default);
 	var _propTypes = _interopRequireDefault(/*@__PURE__*/ requirePropTypes());
 	var _DayCell = _interopRequireWildcard(requireDayCell());
 	var _dateFns = /*@__PURE__*/ requireDateFns();

package/dist/node_modules/react-list/react-list.esm.js

@@ -1,5 +1,5 @@
 import { __exports as reactList } from '../../_virtual/react-list.esm.js';
-import React__default from 'react';
+import require$$0__default from 'react';
 import require$$1 from 'react/jsx-runtime';
 
 var hasRequiredReactList;
@@ -10,7 +10,7 @@ function requireReactList () {
 	(function (exports$1) {
 		(function (global, factory) {
 		  {
-		    factory(exports$1, React__default, require$$1);
+		    factory(exports$1, require$$0__default, require$$1);
 		  }
 		})(typeof globalThis !== "undefined" ? globalThis : typeof self !== "undefined" ? self : reactList, function (_exports, _react, _jsxRuntime) {