@pagamio/frontend-commons-lib 0.8.357 → 0.8.359

package/lib/components/ui/DateRangePickerWithPresets.js

@@ -11,6 +11,12 @@ import { Popover, PopoverContent, PopoverTrigger } from './Popover';
 // =============================================================================
 // PRESET DEFINITIONS (used for display text + preset detection)
 // =============================================================================
+// "All Time" is intentionally not in PRESET_RANGES because it has no concrete
+// date range — it represents the absence of a date filter. It is surfaced in
+// the trigger label and the picker treats `selectedPreset === 'all_time'` as
+// "no value", letting consumers pass empty startDate/endDate to the backend.
+const ALL_TIME_PRESET_VALUE = 'all_time';
+const ALL_TIME_PRESET_LABEL = 'All Time';
 const PRESET_RANGES = [
     {
         label: 'Today',
@@ -113,6 +119,9 @@ const DateRangePickerWithPresets = ({ value, onChange, selectedPreset = 'last_7_
             }
             return format(value.from, dateFormat);
         }
+        if (selectedPreset === ALL_TIME_PRESET_VALUE) {
+            return ALL_TIME_PRESET_LABEL;
+        }
         if (selectedPreset && selectedPreset !== 'custom') {
             const match = PRESET_RANGES.find((p) => p.value === selectedPreset);
             if (match)
@@ -139,7 +148,9 @@ const DateRangePickerWithPresets = ({ value, onChange, selectedPreset = 'last_7_
         e.stopPropagation();
         onChange?.(undefined, undefined);
     };
-    return (_jsxs(Popover, { open: isOpen, onOpenChange: setIsOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", disabled: disabled, className: cn('w-auto justify-start text-left font-normal', !value && 'text-muted-foreground', className), children: [_jsx(CalendarIcon, { className: "mr-2 h-4 w-4" }), _jsx("span", { children: displayText }), showClearButton && value?.from && (_jsx(X, { className: "ml-2 h-4 w-4 opacity-50 hover:opacity-100 cursor-pointer", onClick: handleClear }))] }) }), _jsx(PopoverContent, { className: "w-auto p-0 bg-popover text-popover-foreground border border-border shadow-lg", align: "start", sideOffset: 8, children: _jsx(DateRangePicker, { ranges: [selectionRange], onChange: handleRangeChange, moveRangeOnFirstSelection: false, months: numberOfMonths, direction: "horizontal", showDateDisplay: false, showPreview: true, minDate: minDate, maxDate: maxDate, rangeColors: rangeColors, staticRanges: staticRanges, inputRanges: [] }) })] }));
+    return (_jsxs(Popover, { open: isOpen, onOpenChange: setIsOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", disabled: disabled, className: cn('w-auto justify-start text-left font-normal', !value && 'text-muted-foreground', className), children: [_jsx(CalendarIcon, { className: "mr-2 h-4 w-4" }), _jsx("span", { children: displayText }), showClearButton && value?.from && (_jsx(X, { className: "ml-2 h-4 w-4 opacity-50 hover:opacity-100 cursor-pointer", onClick: handleClear }))] }) }), _jsxs(PopoverContent, { className: "w-auto p-0 bg-popover text-popover-foreground border border-border shadow-lg", align: "start", sideOffset: 8, children: [_jsx("button", { type: "button", onClick: () => onChange?.(undefined, ALL_TIME_PRESET_VALUE), className: cn('w-full border-b border-border px-4 py-3 text-left text-sm transition-colors hover:bg-accent hover:text-accent-foreground', selectedPreset === ALL_TIME_PRESET_VALUE && !value?.from
+                            ? 'bg-accent font-semibold text-accent-foreground'
+                            : 'text-popover-foreground'), children: ALL_TIME_PRESET_LABEL }), _jsx(DateRangePicker, { ranges: [selectionRange], onChange: handleRangeChange, moveRangeOnFirstSelection: false, months: numberOfMonths, direction: "horizontal", showDateDisplay: false, showPreview: true, minDate: minDate, maxDate: maxDate, rangeColors: rangeColors, staticRanges: staticRanges, inputRanges: [] })] })] }));
 };
 DateRangePickerWithPresets.displayName = 'DateRangePickerWithPresets';
 export default DateRangePickerWithPresets;

package/lib/dashboard-visuals/v2/components/DashboardChartRow.js

@@ -80,7 +80,7 @@ const ChartRenderer = ({ config, loading }) => {
         case 'heatmap': {
             // Heatmap expects series: { name, data: { x, y }[] }[]
             const data = config.data;
-            return (_jsx(DashboardCard, { title: config.title, subtitle: config.subtitle, actions: config.action, footer: config.footer, className: config.cardClassName, children: _jsx(HeatmapChartV2, { series: data.series, height: chartHeight, colors: chartColors, className: config.chartClassName }) }));
+            return (_jsx(DashboardCard, { title: config.title, subtitle: config.subtitle, actions: config.action, footer: config.footer, className: config.cardClassName, children: _jsx(HeatmapChartV2, { series: data.series, height: chartHeight, colors: chartColors, options: config.options, className: config.chartClassName }) }));
         }
         default:
             return (_jsx(DashboardCard, { title: config.title, subtitle: config.subtitle, className: config.cardClassName, children: _jsxs("div", { className: "flex items-center justify-center text-muted-foreground", style: { height: chartHeight }, children: ["Unsupported chart type: ", config.type] }) }));

package/lib/pagamio-table/data-table/ExportButton.d.ts

@@ -52,10 +52,17 @@ type ExportDropdownProps<T extends Record<string, any>> = {
     csvOptions?: CsvExportOptions;
     exportAll?: boolean;
     fetchData?: (params?: Record<string, string>, onProgress?: (fetched: number, total: number) => void) => Promise<T[]>;
+    asyncExport?: {
+        threshold: number;
+        totalRows: number;
+        requestExport: (format: 'csv' | 'xlsx' | 'pdf') => Promise<void>;
+        onQueued?: (message: string) => void;
+        onError?: (error: Error) => void;
+    };
     enableEmailExport?: boolean;
     emailExportApiUrl?: string;
     onEmailExportSuccess?: (message: string) => void;
     onEmailExportError?: (error: Error) => void;
 };
-declare const ExportDropdown: <T extends Record<string, any>>({ data, columns, containerClassName, buttonClassName, extraOptions, pdfOptions, xlsxOptions, csvOptions, exportAll, fetchData, enableEmailExport, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }: ExportDropdownProps<T>) => import("react/jsx-runtime").JSX.Element;
+declare const ExportDropdown: <T extends Record<string, any>>({ data, columns, containerClassName, buttonClassName, extraOptions, pdfOptions, xlsxOptions, csvOptions, exportAll, fetchData, asyncExport, enableEmailExport, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }: ExportDropdownProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default ExportDropdown;

package/lib/pagamio-table/data-table/ExportButton.js

@@ -5,7 +5,7 @@ import { HiMail } from 'react-icons/hi';
 import { useEffect, useRef, useState } from 'react';
 import { Button, Modal, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '../../components';
 import { exportToCsv, exportToPdf, exportToXlsx, generateExportAsFile, sendExportEmail } from './exportUtils';
-const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, extraOptions = [], pdfOptions, xlsxOptions, csvOptions, exportAll = false, fetchData, enableEmailExport = false, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }) => {
+const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, extraOptions = [], pdfOptions, xlsxOptions, csvOptions, exportAll = false, fetchData, asyncExport, enableEmailExport = false, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }) => {
     const [exportType, setExportType] = useState(null);
     const [excludedColumns, setExcludedColumns] = useState(['action']);
     const [isExporting, setIsExporting] = useState(false);
@@ -114,11 +114,28 @@ const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, ex
         setPendingEmailFormat(null);
         setIsExporting(false);
     };
+    // When exporting all and the dataset is too large to pull into the browser,
+    // hand off to the async backend job instead of paging through it client-side.
+    const shouldQueueAsync = exportAllData && !!asyncExport && asyncExport.totalRows > asyncExport.threshold;
     const handleContinue = async () => {
         const includedColumns = getIncludedColumns();
         setIsExporting(true);
         setExportProgress(null);
         try {
+            if (shouldQueueAsync && asyncExport) {
+                // Async path: server generates the file off the request path and
+                // delivers it via export history / email. Nothing to render here.
+                const format = (isEmailExport ? emailFormat : exportType);
+                try {
+                    await asyncExport.requestExport(format);
+                    asyncExport.onQueued?.('Your export is being prepared. It will appear in export history when ready.');
+                }
+                catch (err) {
+                    asyncExport.onError?.(err instanceof Error ? err : new Error('Export request failed'));
+                }
+                setExportType(null);
+                return;
+            }
             const exportData = exportAllData && fetchData
                 ? await fetchData({ exportAll: 'true' }, (fetched, total) => setExportProgress({ fetched, total }))
                 : data;
@@ -162,7 +179,9 @@ const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, ex
     };
     // Show popover when exportType is set and Select is closed
     const popoverOpened = exportType !== null && !selectOpen;
-    return (_jsxs("div", { className: `w-40 ${containerClassName ?? ''}`, children: [_jsxs(Select, { value: exportType ?? 'none', open: selectOpen, onOpenChange: setSelectOpen, onValueChange: (value) => handleExportChange(value === 'none' ? null : value), children: [_jsx(SelectTrigger, { className: `w-full ${buttonClassName ?? ''}`, children: _jsx(SelectValue, { placeholder: "Export Data" }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "none", children: _jsx("span", { className: "text-muted-foreground", children: "Export Data As" }) }, "reset"), exportOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value))), extraOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value)))] })] }, "export-dropdown"), popoverOpened && (_jsxs("div", { ref: popoverRef, className: "mt-2 bg-background rounded-md shadow-lg p-4 z-50 absolute w-45", children: [_jsx("div", { className: "text-sm text-muted-foreground pb-3", children: "Uncheck to exclude column from export" }), _jsxs("div", { className: "mb-4 p-3 bg-muted rounded-md", children: [_jsxs("div", { className: "flex items-center gap-x-2", children: [_jsx(Checkbox, { id: "export-all-data", checked: exportAllData, onChange: (event) => setExportAllData(event.currentTarget.checked), className: "checked:!bg-primary checked:!border-primary" }), _jsx(Label, { htmlFor: "export-all-data", className: "text-sm font-medium", children: "Export all data" })] }), _jsx("p", { className: "text-xs text-muted-foreground mt-1 ml-6", children: "This will fetch all records for the table" })] }), _jsx(Stack, { children: columns.map((col) => {
+    return (_jsxs("div", { className: `w-40 ${containerClassName ?? ''}`, children: [_jsxs(Select, { value: exportType ?? 'none', open: selectOpen, onOpenChange: setSelectOpen, onValueChange: (value) => handleExportChange(value === 'none' ? null : value), children: [_jsx(SelectTrigger, { className: `w-full ${buttonClassName ?? ''}`, children: _jsx(SelectValue, { placeholder: "Export Data" }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "none", children: _jsx("span", { className: "text-muted-foreground", children: "Export Data As" }) }, "reset"), exportOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value))), extraOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value)))] })] }, "export-dropdown"), popoverOpened && (_jsxs("div", { ref: popoverRef, className: "mt-2 bg-background rounded-md shadow-lg p-4 z-50 absolute w-45", children: [_jsx("div", { className: "text-sm text-muted-foreground pb-3", children: "Uncheck to exclude column from export" }), _jsxs("div", { className: "mb-4 p-3 bg-muted rounded-md", children: [_jsxs("div", { className: "flex items-center gap-x-2", children: [_jsx(Checkbox, { id: "export-all-data", checked: exportAllData, onChange: (event) => setExportAllData(event.currentTarget.checked), className: "checked:!bg-primary checked:!border-primary" }), _jsx(Label, { htmlFor: "export-all-data", className: "text-sm font-medium", children: "Export all data" })] }), _jsx("p", { className: "text-xs text-muted-foreground mt-1 ml-6", children: shouldQueueAsync
+                                    ? 'This dataset is large — it will be prepared in the background and appear in export history.'
+                                    : 'This will fetch all records for the table' })] }), _jsx(Stack, { children: columns.map((col) => {
                             if (col.accessorKey !== 'action') {
                                 return (_jsxs("div", { className: "flex items-center gap-x-2", children: [_jsx(Checkbox, { id: col.header, checked: !excludedColumns.includes(col.accessorKey), onChange: (event) => handleCheckboxChange(col.accessorKey, !event.currentTarget.checked), className: "checked:!bg-primary checked:!border-primary" }), _jsx(Label, { htmlFor: "rememberMe", children: col.header })] }, col.accessorKey));
                             }

package/lib/pagamio-table/data-table/index.js

@@ -97,7 +97,7 @@ function CustomToolbar({ filters, appliedFilters, onFilterChange, onApply, onCle
             else {
                 handleFilter(name, value);
             }
-        }, handleApplyFilters: onApply, resetFilters: onClearFilters ?? (() => { }), showSearch: searchEnabled, searchQuery: searchQuery, onSearch: onSearch, isNarrow: isNarrow, children: _jsxs("div", { className: "flex flex-wrap items-center justify-end gap-2", children: [exportConfig?.enabled && (_jsx(ExportDropdown, { containerClassName: isNarrow ? 'w-full' : undefined, columns: columns, data: data, buttonClassName: "h-10", extraOptions: exportConfig.extraOptions, pdfOptions: exportConfig.pdf, xlsxOptions: exportConfig.xlsx, csvOptions: exportConfig.csv, exportAll: !!exportConfig.fetchAllData, fetchData: exportConfig.fetchAllData, enableEmailExport: !!exportConfig.email, emailExportApiUrl: exportConfig.email?.apiUrl, onEmailExportSuccess: exportConfig.email?.onSuccess, onEmailExportError: exportConfig.email?.onError })), addButton &&
+        }, handleApplyFilters: onApply, resetFilters: onClearFilters ?? (() => { }), showSearch: searchEnabled, searchQuery: searchQuery, onSearch: onSearch, isNarrow: isNarrow, children: _jsxs("div", { className: "flex flex-wrap items-center justify-end gap-2", children: [exportConfig?.enabled && (_jsx(ExportDropdown, { containerClassName: isNarrow ? 'w-full' : undefined, columns: columns, data: data, buttonClassName: "h-10", extraOptions: exportConfig.extraOptions, pdfOptions: exportConfig.pdf, xlsxOptions: exportConfig.xlsx, csvOptions: exportConfig.csv, exportAll: !!exportConfig.fetchAllData, fetchData: exportConfig.fetchAllData, asyncExport: exportConfig.asyncExport, enableEmailExport: !!exportConfig.email, emailExportApiUrl: exportConfig.email?.apiUrl, onEmailExportSuccess: exportConfig.email?.onSuccess, onEmailExportError: exportConfig.email?.onError })), addButton &&
                     (typeof addButton === 'boolean' ? (_jsx(IconButton, { onClick: onAdd ?? (() => { }), icon: HiPlusSm, label: "add-new-entry", className: cn('items-center text-nowrap', isNarrow ? 'w-full' : undefined), children: addText ?? 'Add New Entry' })) : (addButton))] }) }));
 }
 // ─── PagamioTable Component ──────────────────────────────────────────

package/lib/pagamio-table/data-table/types.d.ts

@@ -95,6 +95,29 @@ export interface ExportConfig<T extends Record<string, any>> {
         onSuccess?: (message: string) => void;
         onError?: (error: Error) => void;
     };
+    /**
+     * Async (queued) export for datasets too large to page through and render in
+     * the browser. When "Export all data" is checked and `totalRows > threshold`,
+     * the export button calls `requestExport(format)` instead of fetching the
+     * whole set client-side — the backend generates the file off the request path
+     * and delivers it via export history / email.
+     *
+     * `usePagamioTable` auto-wires `totalRows` from the table's row count; the
+     * consumer supplies `threshold` and `requestExport` (which POSTs to
+     * `/exports` with its `resourceKey` + current filters).
+     */
+    asyncExport?: {
+        /** Row count above which export is queued instead of run client-side. */
+        threshold: number;
+        /** Current total server rows (auto-wired by the hook). */
+        totalRows: number;
+        /** Queue a server-side export of the full dataset in the chosen format. */
+        requestExport: (format: 'csv' | 'xlsx' | 'pdf') => Promise<void>;
+        /** Called after a successful queue request (e.g. to toast the user). */
+        onQueued?: (message: string) => void;
+        /** Called if the queue request fails. */
+        onError?: (error: Error) => void;
+    };
 }
 export interface ToolbarConfig<T extends Record<string, any>> {
     filters?: BaseFilter[];

package/lib/shared/hooks/usePagamioTable.js

@@ -369,6 +369,14 @@ export const usePagamioTable = ({ queryKey, queryFn, enabled: queryEnabled = tru
                     export: {
                         ...toolbar.export,
                         fetchAllData: toolbar.export.fetchAllData ?? fetchAllPages,
+                        // Keep the async-export row count in sync with the live total so
+                        // the consumer only has to supply `threshold` + `requestExport`.
+                        ...(toolbar.export.asyncExport && {
+                            asyncExport: {
+                                ...toolbar.export.asyncExport,
+                                totalRows: totalItems,
+                            },
+                        }),
                     },
                 }),
             },

package/lib/styles.css

@@ -3936,6 +3936,84 @@ video {
   width: auto !important;
   min-width: 0 !important;
 }
+
+/* react-date-range ships a light-only theme. Re-skin its surfaces with our
+ * popover / muted / border tokens so the date-range picker matches dark mode.
+ * Selection highlight stays untouched — the component already drives that
+ * via the `rangeColors` prop pulled from `--primary` at runtime.
+ */
+.dark .rdrCalendarWrapper,
+.dark .rdrDateRangeWrapper,
+.dark .rdrDefinedRangesWrapper {
+  background: hsl(var(--popover)) !important;
+  color: hsl(var(--popover-foreground)) !important;
+}
+.dark .rdrDefinedRangesWrapper {
+  border-right: 1px solid hsl(var(--border)) !important;
+}
+.dark .rdrStaticRanges {
+  background: transparent !important;
+}
+.dark .rdrStaticRange {
+  background: transparent !important;
+  border-bottom: 1px solid hsl(var(--border)) !important;
+}
+.dark .rdrStaticRange:hover .rdrStaticRangeLabel,
+.dark .rdrStaticRange:focus .rdrStaticRangeLabel {
+  background: hsl(var(--accent)) !important;
+  color: hsl(var(--accent-foreground)) !important;
+}
+.dark .rdrStaticRangeLabel {
+  color: hsl(var(--popover-foreground)) !important;
+}
+.dark .rdrStaticRangeSelected .rdrStaticRangeLabel {
+  color: hsl(var(--primary)) !important;
+  font-weight: 600;
+}
+.dark .rdrMonthAndYearWrapper,
+.dark .rdrMonth {
+  background: transparent !important;
+  color: hsl(var(--popover-foreground)) !important;
+}
+.dark .rdrMonthName,
+.dark .rdrWeekDay {
+  color: hsl(var(--muted-foreground)) !important;
+}
+.dark .rdrMonthAndYearPickers select {
+  color: hsl(var(--popover-foreground)) !important;
+  background-color: transparent !important;
+}
+.dark .rdrMonthAndYearPickers select:hover {
+  background-color: hsl(var(--accent)) !important;
+}
+.dark .rdrNextPrevButton {
+  background: hsl(var(--muted)) !important;
+}
+.dark .rdrNextPrevButton:hover {
+  background: hsl(var(--accent)) !important;
+}
+.dark .rdrPprevButton i {
+  border-color: transparent hsl(var(--popover-foreground)) transparent transparent !important;
+}
+.dark .rdrNextButton i {
+  border-color: transparent transparent transparent hsl(var(--popover-foreground)) !important;
+}
+.dark .rdrDayNumber span {
+  color: hsl(var(--popover-foreground)) !important;
+}
+.dark .rdrDayPassive .rdrDayNumber span {
+  color: hsl(var(--muted-foreground)) !important;
+}
+.dark .rdrDayDisabled {
+  background: transparent !important;
+}
+.dark .rdrDayDisabled .rdrDayNumber span {
+  color: hsl(var(--muted-foreground)) !important;
+  opacity: 0.5;
+}
+.dark .rdrDayToday .rdrDayNumber span:after {
+  background: hsl(var(--primary)) !important;
+}
 .file\:-ms-4::file-selector-button {
   margin-inline-start: -1rem;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pagamio/frontend-commons-lib",
   "description": "Pagamio library for Frontend reusable components like the form engine and table container",
-  "version": "0.8.357",
+  "version": "0.8.359",
   "publishConfig": {
     "access": "public",
     "provenance": false