react-kd-grid 1.1.1 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-kd-grid",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "A feature-rich, performant React data grid component with virtualization, grouping, filtering, and export capabilities",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",

package/dist/workers/CustomGrid.d.ts

@@ -1,3 +0,0 @@
-import { CustomDataGridProps, CustomDataGridRef } from "./types";
-export declare const CustomDataGrid: import("react").ForwardRefExoticComponent<CustomDataGridProps & import("react").RefAttributes<CustomDataGridRef>>;
-export default CustomDataGrid;

package/dist/workers/components/ColumnFilterSelector.d.ts

@@ -1,18 +0,0 @@
-interface ColumnFilterSelectorProps {
-    columns: Array<{
-        key: string;
-        header: string;
-        filterable?: {
-            type?: string;
-            options?: Array<{
-                label: string;
-                value: string | number;
-            }>;
-            placeholder?: string;
-        };
-    }>;
-    columnFilters: Record<string, any>;
-    onColumnFilter?: (columnKey: string, filter: any) => void;
-}
-export declare const ColumnFilterSelector: ({ columns, columnFilters, onColumnFilter, }: ColumnFilterSelectorProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/CustomSelect.d.ts

@@ -1,14 +0,0 @@
-interface Option {
-    label: string;
-    value: string;
-}
-interface CustomSelectProps {
-    options: Option[];
-    value?: string;
-    placeholder?: string;
-    onChange: (value: string) => void;
-    searchable?: boolean;
-    className?: string;
-}
-export declare const CustomSelect: ({ options, value, placeholder, onChange, searchable, className, }: CustomSelectProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/FooterAggregate.d.ts

@@ -1,16 +0,0 @@
-import React from "react";
-import { GridColumn, GridRow } from "../types";
-interface FooterAggregateProps {
-    columns: (GridColumn & {
-        width: number;
-    })[];
-    data: GridRow[];
-    selectable: boolean;
-    /** Resolved row height so footer matches density */
-    rowHeight: number;
-    /** Pinned columns (same semantics as grid body) */
-    pinnedColumns?: Set<string>;
-    getRowId?: (row: GridRow) => string | number;
-}
-export declare const FooterAggregate: React.NamedExoticComponent<FooterAggregateProps>;
-export {};

package/dist/workers/components/GridHeader.d.ts

@@ -1,33 +0,0 @@
-import { GridColumn, SortConfig, ActiveFilters, ColumnFilterValue, GridRow } from "../types";
-interface GridHeaderProps {
-    pinnedColumns: GridColumn[];
-    unpinnedColumns: GridColumn[];
-    hvPadLeft?: number;
-    hvPadRight?: number;
-    headerHeight: number;
-    sortConfig: SortConfig;
-    columnFilters: ActiveFilters;
-    selectable: boolean;
-    selectedRows: Set<string | number>;
-    totalRows: number;
-    data: GridRow[];
-    onSort: (key: string) => void;
-    onColumnFilter: (key: string, filter: ColumnFilterValue | null) => void;
-    onSelectAll: () => void;
-    onColumnResize?: (columnKey: string, width: number) => void;
-    pinnedKeySet?: Set<string>;
-    onColumnPin?: (columnKey: string, pinned: boolean) => void;
-    groupable?: boolean;
-    groupedByColumn?: string | null;
-    onGroupBy?: (columnKey: string | null) => void;
-    groupedByColumns?: string[];
-    onGroupToggle?: (columnKey: string, nextGrouped: boolean) => void;
-    onAutosizeColumn?: (columnKey: string) => void;
-    onAutosizeAllColumns?: () => void;
-    onResetColumns?: () => void;
-    columnOrder: string[];
-    onColumnOrderChange: (order: string[]) => void;
-    paginationMode?: "client" | "server" | null;
-}
-export declare const GridHeader: ({ pinnedColumns, unpinnedColumns, hvPadLeft, hvPadRight, headerHeight, sortConfig, columnFilters, selectable, selectedRows, totalRows, data, onSort, onColumnFilter, onSelectAll, onColumnResize, pinnedKeySet, onColumnPin, groupable, groupedByColumn, onGroupBy, groupedByColumns, onGroupToggle, onAutosizeColumn, onAutosizeAllColumns, onResetColumns, columnOrder, onColumnOrderChange, paginationMode, }: GridHeaderProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/GridRows.d.ts

@@ -1,49 +0,0 @@
-import { CSSProperties, MouseEvent } from "react";
-import { GridRow, GridColumn, VirtualizedRange } from "../types";
-interface GridRowsProps {
-    data: GridRow[];
-    columns: GridColumn[];
-    selectedRows: Set<string | number>;
-    virtualized: boolean;
-    virtualizedRange: VirtualizedRange;
-    rowHeight: number;
-    selectable: boolean;
-    isRowSelectable?: (row: GridRow) => boolean;
-    onRowSelect: (rowId: string | number, isSelected: boolean) => void;
-    pinnedColumns?: Set<string>;
-    hvPadLeft?: number;
-    hvPadRight?: number;
-    rowStyle?: (row: GridRow) => CSSProperties | undefined;
-    globalFilter?: string;
-    onContextMenu?: (row: GridRow, event: MouseEvent) => void;
-    onRowDoubleClick?: (row: GridRow, event: MouseEvent) => void;
-    onRowClick?: (row: GridRow, event: MouseEvent) => void;
-    onCellClick?: (args: {
-        row: GridRow;
-        column: GridColumn;
-        value: any;
-        event: MouseEvent;
-    }) => void;
-    isCellFocused?: (rowId: string | number, columnKey: string) => boolean;
-    isCellSelected?: (rowId: string | number, columnKey: string) => boolean;
-    onCellContextMenu?: (args: {
-        row: GridRow;
-        column: GridColumn;
-        value: any;
-        displayValue: string;
-        event: MouseEvent;
-    }) => void;
-    onCellMouseDown?: (args: {
-        row: GridRow;
-        column: GridColumn;
-        event: MouseEvent;
-    }) => void;
-    onCellMouseEnter?: (args: {
-        row: GridRow;
-        column: GridColumn;
-        event: MouseEvent;
-    }) => void;
-    getRowId?: (row: GridRow) => string | number;
-}
-export declare const GridRows: import("react").MemoExoticComponent<({ data, columns, selectedRows, virtualized, virtualizedRange, rowHeight, selectable, isRowSelectable, onRowSelect, pinnedColumns, hvPadLeft, hvPadRight, rowStyle, globalFilter, onContextMenu, onRowDoubleClick, onRowClick, onCellClick, isCellFocused, isCellSelected, onCellContextMenu, onCellMouseDown, onCellMouseEnter, getRowId, }: GridRowsProps) => import("react/jsx-runtime").JSX.Element>;
-export {};

package/dist/workers/components/GroupBar.d.ts

@@ -1,12 +0,0 @@
-import type { GridColumn } from "../types";
-interface GroupBarProps {
-    columns: GridColumn[];
-    groupedKeys: string[];
-    onRemove: (columnKey: string) => void;
-    onReorder: (newOrder: string[]) => void;
-    onDropColumnKey: (columnKey: string) => void;
-    onToggleExpandAll?: () => void;
-    isAnyExpanded?: boolean;
-}
-export declare const GroupBar: ({ columns, groupedKeys, onRemove, onReorder, onDropColumnKey, onToggleExpandAll, isAnyExpanded, }: GroupBarProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/GroupHeader.d.ts

@@ -1,29 +0,0 @@
-import { GridRow, CustomDataGridProps } from "../types";
-interface GroupHeaderProps {
-    row: GridRow & {
-        _isGroupHeader?: boolean;
-        _groupKey?: string;
-        _groupCount?: number;
-    };
-    isExpanded: boolean;
-    onToggle: (groupKey: string) => void;
-    viewportWidth: number;
-    selectable: boolean;
-    rowHeight?: number;
-    /**
-     * Optional function to map a column key to its display label (header).
-     * If not provided, the raw column key will be used as a fallback.
-     */
-    getHeaderLabel?: (columnKey: string) => string;
-    /**
-     * Optional function to map a column key and raw group value to a display label.
-     * Useful to apply the column's formatter for group headers.
-     */
-    getValueLabel?: (columnKey: string, rawValue: any) => string;
-    /**
-     * Optional custom renderer for actions on grouped rows.
-     */
-    renderGroupActions?: CustomDataGridProps["renderGroupActions"];
-}
-export declare const GroupHeader: import("react").MemoExoticComponent<({ row, isExpanded, onToggle, viewportWidth, selectable, rowHeight, getHeaderLabel, getValueLabel, renderGroupActions, }: GroupHeaderProps) => import("react/jsx-runtime").JSX.Element>;
-export {};

package/dist/workers/components/NoDataMessage.d.ts

@@ -1,7 +0,0 @@
-interface NoDataMessageProps {
-    hasFilters?: boolean;
-    hasData?: boolean;
-    message?: string;
-}
-export declare const NoDataMessage: ({ hasFilters, hasData, message, }: NoDataMessageProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/PaginationControls.d.ts

@@ -1,15 +0,0 @@
-import { PaginationConfig } from "../types";
-interface PaginationControlsProps {
-    paginationConfig: PaginationConfig;
-    currentPage: number;
-    isServerLoading: boolean;
-    selectedRowsCount: number;
-    totalDataLength: number;
-    filteredDataLength?: number;
-    paginationMode?: "client" | "server";
-    onPageChange: (page: number, pageSize: number) => void;
-    onPageSizeChange: (pageSize: number) => void;
-    showNoDataMessage?: boolean;
-}
-export declare const PaginationControls: ({ paginationConfig, currentPage, isServerLoading, selectedRowsCount, totalDataLength, filteredDataLength, paginationMode, onPageChange, onPageSizeChange, }: PaginationControlsProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/Popover.d.ts

@@ -1,17 +0,0 @@
-import React from "react";
-import { type Placement } from "@floating-ui/react";
-interface PopoverProps {
-    open: boolean;
-    anchorEl: HTMLElement | null;
-    onClose: () => void;
-    placement?: Placement;
-    offset?: number;
-    sameWidth?: boolean;
-    maxHeight?: number | string;
-    zIndex?: number;
-    className?: string;
-    children: React.ReactNode;
-    shouldIgnoreClose?: (target: Node) => boolean;
-}
-export declare const Popover: React.FC<PopoverProps>;
-export default Popover;

package/dist/workers/components/RowContextMenu.d.ts

@@ -1,22 +0,0 @@
-import { ReactNode } from "react";
-import { GridRow } from "../types";
-export interface ContextMenuItem {
-    id: string;
-    label: string;
-    icon?: ReactNode;
-    onClick: (row: GridRow) => void;
-    disabled?: boolean;
-    separator?: boolean;
-}
-interface RowContextMenuProps {
-    row: GridRow;
-    position: {
-        x: number;
-        y: number;
-    };
-    isVisible: boolean;
-    onClose: () => void;
-    menuItems?: ContextMenuItem[];
-}
-export declare const RowContextMenu: ({ row, position, isVisible, onClose, menuItems, }: RowContextMenuProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/SearchToolbar.d.ts

@@ -1,79 +0,0 @@
-import { ReactNode, ChangeEvent } from "react";
-import type { Density } from "../types";
-export type ExportFormat = "csv" | "json" | "xlsx";
-export type BulkAction = "delete" | "archive" | "copy" | "edit" | "export";
-export interface BulkActionOption {
-    id: BulkAction;
-    label: string;
-    icon: ReactNode;
-    onClick: (selectedRows: Set<string | number>) => void;
-    disabled?: boolean;
-    destructive?: boolean;
-}
-interface ColumnVisibility {
-    [columnKey: string]: boolean;
-}
-interface SavedFilter {
-    id: string;
-    name: string;
-    globalFilter: string;
-    columnFilters: Record<string, any>;
-}
-interface SearchToolbarProps {
-    globalFilter: string;
-    filteredDataLength: number;
-    totalDataLength: number;
-    paginationMode?: "client" | "server";
-    totalRows?: number;
-    selectedRowsCount?: number;
-    selectedRows?: Set<string | number>;
-    showExport?: boolean;
-    showRefresh?: boolean;
-    showColumnToggle?: boolean;
-    showBulkActions?: boolean;
-    showSavedFilters?: boolean;
-    columns?: Array<{
-        key: string;
-        header: string;
-        visible?: boolean;
-        filterOptions?: Array<{
-            label: string;
-            value: string | number;
-        }>;
-        filterType?: "text" | "select" | "multiselect";
-        filterable?: any;
-    }>;
-    columnVisibility?: ColumnVisibility;
-    columnFilters?: Record<string, any>;
-    savedFilters?: SavedFilter[];
-    bulkActions?: BulkActionOption[];
-    isLoading?: boolean;
-    exportOptions?: {
-        enabled: boolean;
-        formats?: ExportFormat[];
-        filename?: string;
-        onExport?: (format: ExportFormat, exportSelected: boolean) => void;
-    };
-    onGlobalFilterChange: (e: ChangeEvent<HTMLInputElement>) => void;
-    onClearFilters?: () => void;
-    onRefresh?: () => void;
-    onColumnVisibilityChange?: (columnKey: string, visible: boolean) => void;
-    onColumnFilter?: (columnKey: string, filter: any) => void;
-    onSaveFilter?: (filter: Omit<SavedFilter, "id">) => void;
-    onLoadFilter?: (filter: SavedFilter) => void;
-    onDeleteFilter?: (filterId: string) => void;
-    onRowSelect?: (selectedRows: number[]) => void;
-    onToggleFilters?: (show: boolean) => void;
-    onResetColumns?: () => void;
-    columnOrder?: string[];
-    onColumnOrderChange?: (order: string[]) => void;
-    pinnedColumns?: Set<string>;
-    onScrollToColumn?: (columnKey: string) => void;
-    density?: Density;
-    onDensityChange?: (density: Density) => void;
-    showDensityControl?: boolean;
-    customLeftContent?: ReactNode;
-    customRightContent?: ReactNode;
-}
-export declare const SearchToolbar: ({ globalFilter, filteredDataLength, selectedRowsCount, selectedRows, showExport, showColumnToggle, showBulkActions, columns, columnVisibility, columnFilters, bulkActions, exportOptions, onGlobalFilterChange, onClearFilters, onColumnVisibilityChange, onColumnFilter, onResetColumns, columnOrder, onColumnOrderChange, pinnedColumns, onScrollToColumn, density, onDensityChange, showDensityControl, customLeftContent, customRightContent, }: SearchToolbarProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/filters/BooleanFilter.d.ts

@@ -1,7 +0,0 @@
-import { ColumnFilterValue } from "../../types";
-interface BooleanFilterProps {
-    value: ColumnFilterValue | null;
-    onChange: (value: ColumnFilterValue | null) => void;
-}
-export declare const BooleanFilter: ({ value, onChange }: BooleanFilterProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/filters/DateFilter.d.ts

@@ -1,9 +0,0 @@
-import { ColumnFilterValue } from "../../types";
-interface DateFilterProps {
-    value: ColumnFilterValue | null;
-    onChange: (value: ColumnFilterValue | null) => void;
-    min?: number;
-    max?: number;
-}
-export declare const DateFilter: ({ value, onChange, min, max }: DateFilterProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/filters/FilterContent.d.ts

@@ -1,9 +0,0 @@
-import { ColumnFilterValue, GridColumn, GridRow } from "../../types";
-interface FilterContentProps {
-    column: GridColumn;
-    data: GridRow[];
-    value: ColumnFilterValue | null;
-    onChange: (val: ColumnFilterValue | null) => void;
-}
-export declare const FilterContent: ({ column, data, value, onChange }: FilterContentProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/filters/FilterPopup.d.ts

@@ -1,2 +0,0 @@
-import { FilterPopupProps } from "../../types";
-export declare const FilterPopup: ({ column, data, currentFilter, onApplyFilter, onClose, position, autoApply, }: FilterPopupProps) => import("react/jsx-runtime").JSX.Element;

package/dist/workers/components/filters/MultiselectFilter.d.ts

@@ -1,10 +0,0 @@
-import { ColumnFilterValue, FilterOption, GridRow } from "../../types";
-interface MultiselectFilterProps {
-    value: ColumnFilterValue | null;
-    onChange: (value: ColumnFilterValue | null) => void;
-    options?: FilterOption[];
-    data: GridRow[];
-    columnKey: string;
-}
-export declare const MultiselectFilter: ({ value, onChange, options, data, columnKey, }: MultiselectFilterProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/filters/NumberFilter.d.ts

@@ -1,9 +0,0 @@
-import { ColumnFilterValue } from "../../types";
-interface NumberFilterProps {
-    value: ColumnFilterValue | null;
-    onChange: (value: ColumnFilterValue | null) => void;
-    min?: number;
-    max?: number;
-}
-export declare const NumberFilter: ({ value, onChange, min, max, }: NumberFilterProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/filters/TextFilter.d.ts

@@ -1,8 +0,0 @@
-import { ColumnFilterValue } from "../../types";
-interface TextFilterProps {
-    value: ColumnFilterValue | null;
-    onChange: (value: ColumnFilterValue | null) => void;
-    placeholder?: string;
-}
-export declare const TextFilter: ({ value, onChange, placeholder, }: TextFilterProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/workers/components/filters/index.d.ts

@@ -1,6 +0,0 @@
-export { TextFilter } from './TextFilter';
-export { NumberFilter } from './NumberFilter';
-export { DateFilter } from './DateFilter';
-export { MultiselectFilter } from './MultiselectFilter';
-export { BooleanFilter } from './BooleanFilter';
-export { FilterPopup } from './FilterPopup';

package/dist/workers/components/ui/DatePicker.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-interface DatePickerProps {
-    name?: string;
-    label?: string;
-    value: string | null;
-    onChange: (value: string | null) => void;
-    className?: string;
-}
-export declare const DatePicker: React.FC<DatePickerProps>;
-export {};

package/dist/workers/constants.d.ts

@@ -1 +0,0 @@
-export declare const SELECT_COL_WIDTH = 48;

package/dist/workers/dataWorker.js

@@ -1,2 +0,0 @@
-const t=self;t.onmessage=e=>{const r=e.data;if(r&&"process"===r.type)try{const{rows:e,sort:s}=r.payload,n=((t,e)=>{if(!t||0===t.length)return t;let r=t;if(e&&e.key){const{key:s,direction:n}=e,o="asc"===n?1:-1;r=[...t].sort((t,e)=>{const r=t?.[s],n=e?.[s];if(null==r&&null==n)return 0;if(null==r)return-1*o;if(null==n)return 1*o;if("number"==typeof r&&"number"==typeof n)return(r-n)*o;const l=String(r),a=String(n);return l.localeCompare(a)*o})}return r})(e,s??null),o={type:"result",payload:{rows:n}};t.postMessage(o)}catch(e){const s={type:"result",payload:{rows:r.payload.rows}};t.postMessage(s)}};
-//# sourceMappingURL=dataWorker.js.map

package/dist/workers/dataWorker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dataWorker.js","sources":["../../../workers/dataWorker.ts"],"sourcesContent":["// Web Worker for heavy data processing (sorting for now)\n// Message protocol\n// { type: 'process', payload: { rows: any[], sort?: { key: string; direction: 'asc' | 'desc' } } }\n// Response: { type: 'result', payload: { rows: any[] } }\n\nexport interface WorkerProcessMessage {\n  type: \"process\";\n  payload: {\n    rows: any[];\n    sort?: { key: string; direction: \"asc\" | \"desc\" } | null;\n  };\n}\n\nexport interface WorkerResultMessage {\n  type: \"result\";\n  payload: { rows: any[] };\n}\n\nconst ctx: any = self as any;\n\nconst processData = (\n  rows: any[],\n  sort?: { key: string; direction: \"asc\" | \"desc\" } | null\n) => {\n  if (!rows || rows.length === 0) return rows;\n  let out = rows;\n  if (sort && sort.key) {\n    const { key, direction } = sort;\n    const dir = direction === \"asc\" ? 1 : -1;\n    out = [...rows].sort((a, b) => {\n      const av = a?.[key];\n      const bv = b?.[key];\n      if (av == null && bv == null) return 0;\n      if (av == null) return -1 * dir;\n      if (bv == null) return 1 * dir;\n      if (typeof av === \"number\" && typeof bv === \"number\")\n        return (av - bv) * dir;\n      const as = String(av);\n      const bs = String(bv);\n      return as.localeCompare(bs) * dir;\n    });\n  }\n  return out;\n};\n\nctx.onmessage = (e: MessageEvent<WorkerProcessMessage>) => {\n  const msg = e.data;\n  if (!msg || msg.type !== \"process\") return;\n  try {\n    const { rows, sort } = msg.payload;\n    const result = processData(rows, sort ?? null);\n    const response: WorkerResultMessage = {\n      type: \"result\",\n      payload: { rows: result },\n    };\n    ctx.postMessage(response);\n  } catch (err) {\n    // In case of unexpected errors, return original rows to avoid blocking UI\n    const response: WorkerResultMessage = {\n      type: \"result\",\n      payload: { rows: msg.payload.rows },\n    };\n    ctx.postMessage(response);\n  }\n};\n"],"names":["ctx","self","onmessage","e","msg","data","type","rows","sort","payload","result","length","out","key","direction","dir","a","b","av","bv","as","String","bs","localeCompare","processData","response","postMessage","err"],"mappings":"AAkBA,MAAMA,EAAWC,KA2BjBD,EAAIE,UAAaC,IACf,MAAMC,EAAMD,EAAEE,KACd,GAAKD,GAAoB,YAAbA,EAAIE,KAChB,IACE,MAAMC,KAAEA,EAAIC,KAAEA,GAASJ,EAAIK,QACrBC,EA9BU,EAClBH,EACAC,KAEA,IAAKD,GAAwB,IAAhBA,EAAKI,OAAc,OAAOJ,EACvC,IAAIK,EAAML,EACV,GAAIC,GAAQA,EAAKK,IAAK,CACpB,MAAMA,IAAEA,EAAGC,UAAEA,GAAcN,EACrBO,EAAoB,QAAdD,EAAsB,GAAK,EACvCF,EAAM,IAAIL,GAAMC,KAAK,CAACQ,EAAGC,KACvB,MAAMC,EAAKF,IAAIH,GACTM,EAAKF,IAAIJ,GACf,GAAU,MAANK,GAAoB,MAANC,EAAY,OAAO,EACrC,GAAU,MAAND,EAAY,OAAQ,EAAIH,EAC5B,GAAU,MAANI,EAAY,OAAO,EAAIJ,EAC3B,GAAkB,iBAAPG,GAAiC,iBAAPC,EACnC,OAAQD,EAAKC,GAAMJ,EACrB,MAAMK,EAAKC,OAAOH,GACZI,EAAKD,OAAOF,GAClB,OAAOC,EAAGG,cAAcD,GAAMP,GAEjC,CACD,OAAOH,GAQUY,CAAYjB,EAAMC,GAAQ,MACnCiB,EAAgC,CACpCnB,KAAM,SACNG,QAAS,CAAEF,KAAMG,IAEnBV,EAAI0B,YAAYD,EACjB,CAAC,MAAOE,GAEP,MAAMF,EAAgC,CACpCnB,KAAM,SACNG,QAAS,CAAEF,KAAMH,EAAIK,QAAQF,OAE/BP,EAAI0B,YAAYD,EACjB"}

package/dist/workers/hooks/useAdvancedFiltering.d.ts

@@ -1,16 +0,0 @@
-import { GridRow, GridColumn, ActiveFilters, ColumnFilterValue } from "../types";
-interface UseAdvancedFilteringProps {
-    data: GridRow[];
-    columns: GridColumn[];
-}
-export declare const useAdvancedFiltering: ({ data, columns, }: UseAdvancedFilteringProps) => {
-    globalFilter: string;
-    setGlobalFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
-    columnFilters: ActiveFilters;
-    filteredData: GridRow[];
-    setColumnFilter: (columnKey: string, filter: ColumnFilterValue | null) => void;
-    clearColumnFilter: (columnKey: string) => void;
-    clearAllFilters: () => void;
-    getActiveFilterCount: () => number;
-};
-export {};

package/dist/workers/hooks/useDataWorker.d.ts

@@ -1,10 +0,0 @@
-type SortCfg = {
-    key: string;
-    direction: "asc" | "desc";
-} | null;
-export declare function useDataWorker(options?: {
-    enabled?: boolean;
-}): {
-    process: (rows: any[], sort: SortCfg) => Promise<any[]>;
-};
-export {};

package/dist/workers/hooks/useExport.d.ts

@@ -1,15 +0,0 @@
-import { GridRow, GridColumn } from "../types";
-export type ExportFormat = "csv" | "json" | "xlsx";
-interface UseExportProps {
-    data: GridRow[];
-    columns: GridColumn[];
-    selectedRows?: Set<string | number>;
-    filename?: string;
-    columnVisibility?: Record<string, boolean>;
-}
-export declare const useExport: ({ data, columns, selectedRows, filename, columnVisibility, }: UseExportProps) => {
-    exportData: (format: ExportFormat, exportSelected?: boolean) => void;
-    canExportSelected: boolean;
-    selectedCount: number;
-};
-export {};

package/dist/workers/hooks/useFilteringAndSorting.d.ts

@@ -1,16 +0,0 @@
-import { ChangeEvent } from "react";
-import { SortConfig, GridRow, GridColumn } from "../types";
-interface UseFilteringAndSortingProps {
-    data: GridRow[];
-    columns: GridColumn[];
-}
-export declare const useFilteringAndSorting: ({ data, columns, }: UseFilteringAndSortingProps) => {
-    sortConfig: SortConfig;
-    filters: Record<string, string>;
-    globalFilter: string;
-    filteredData: GridRow[];
-    handleSort: (key: string) => void;
-    handleFilter: (key: string, value: string) => void;
-    handleGlobalFilterChange: (e: ChangeEvent<HTMLInputElement>) => void;
-};
-export {};

package/dist/workers/hooks/useGrouping.d.ts

@@ -1,28 +0,0 @@
-import { GridRow, GroupConfig, GridColumn } from "../types";
-interface UseGroupingProps {
-    data: GridRow[];
-    columns: GridColumn[];
-}
-export declare const useGrouping: ({ data, columns }: UseGroupingProps) => {
-    groupConfig: GroupConfig;
-    displayData: (GridRow & {
-        _isGroupHeader?: boolean;
-        _groupKey?: string;
-        _groupCount?: number;
-        _groupLevel?: number;
-        _groupColumnKey?: string;
-        _groupValue?: string;
-        _groupRows?: GridRow[];
-        _isGroupFooter?: boolean;
-        _groupAgg?: Record<string, any>;
-    })[];
-    handleGroupBy: (columnKey: string | null) => void;
-    addGroupKey: (columnKey: string) => void;
-    removeGroupKey: (columnKey: string) => void;
-    setGroupKeys: (columnKeys: string[]) => void;
-    toggleGroupExpansion: (groupPath: string) => void;
-    expandAllGroups: () => void;
-    collapseAllGroups: () => void;
-    isGrouped: boolean;
-};
-export {};

package/dist/workers/hooks/usePagination.d.ts

@@ -1,28 +0,0 @@
-import { PaginationConfig, GridRow } from "../types";
-interface UsePaginationProps {
-    data: GridRow[];
-    pagination?: {
-        enabled?: boolean;
-        mode?: "client" | "server";
-        pageSize?: number;
-        showPageSizeSelector?: boolean;
-        pageSizeOptions?: number[];
-        serverConfig?: {
-            enabled: boolean;
-            onPageChange: (page: number, pageSize: number) => Promise<void> | void;
-            onPageSizeChange?: (pageSize: number) => Promise<void> | void;
-            loading?: boolean;
-            totalRows: number;
-        };
-    };
-}
-export declare const usePagination: ({ data, pagination }: UsePaginationProps) => {
-    currentPage: number;
-    resetPage: () => void;
-    paginationConfig: PaginationConfig;
-    paginatedData: GridRow[];
-    isServerLoading: boolean;
-    handlePageChange: (page: number) => Promise<void>;
-    handlePageSizeChange: (newPageSize: number) => Promise<void>;
-};
-export {};

package/dist/workers/hooks/useSelection.d.ts

@@ -1,13 +0,0 @@
-import { GridRow } from "../types";
-interface UseSelectionProps {
-    data: GridRow[];
-    selectedRowIds?: Iterable<string | number> | null;
-    onRowSelect?: (row: GridRow) => void;
-    getRowId?: (row: GridRow) => string | number;
-}
-export declare const useSelection: ({ data, selectedRowIds, onRowSelect, getRowId, }: UseSelectionProps) => {
-    selectedRows: Set<string | number>;
-    handleRowSelect: (rowId: string | number, isSelected: boolean) => void;
-    handleSelectAll: (isSelected: boolean) => void;
-};
-export {};

package/dist/workers/hooks/useVirtualization.d.ts

@@ -1,17 +0,0 @@
-import { UIEvent } from "react";
-import { VirtualizedRange, GridRow } from "../types";
-interface UseVirtualizationProps {
-    data: GridRow[];
-    virtualized?: boolean;
-    rowHeight?: number;
-    overscan?: number;
-    height: number;
-}
-export declare const useVirtualization: ({ data, virtualized, rowHeight, overscan, height, }: UseVirtualizationProps) => {
-    scrollRef: import("react").MutableRefObject<HTMLDivElement>;
-    virtualizedRange: VirtualizedRange;
-    visibleData: GridRow[];
-    totalHeight: number;
-    handleScroll: (e: UIEvent<HTMLDivElement>) => void;
-};
-export {};

package/dist/workers/index.d.ts

@@ -1,11 +0,0 @@
-export { default as CustomDataGrid } from "./CustomGrid";
-export * from "./types";
-export { usePagination } from "./hooks/usePagination";
-export { useVirtualization } from "./hooks/useVirtualization";
-export { useFilteringAndSorting } from "./hooks/useFilteringAndSorting";
-export { useSelection } from "./hooks/useSelection";
-export { PaginationControls } from "./components/PaginationControls";
-export { GridHeader } from "./components/GridHeader";
-export { GridRows } from "./components/GridRows";
-export { SearchToolbar } from "./components/SearchToolbar";
-export { FooterAggregate } from "./components/FooterAggregate";

package/dist/workers/types.d.ts

@@ -1,421 +0,0 @@
-import { CSSProperties, MouseEvent, ReactNode } from "react";
-export type FilterType = "text" | "multiselect" | "number" | "date" | "boolean";
-export type Density = "sm" | "md" | "lg";
-export interface FilterOption {
-    label: string;
-    value: any;
-}
-export interface ColumnFilter {
-    type: FilterType;
-    options?: FilterOption[];
-    placeholder?: string;
-    min?: number;
-    max?: number;
-}
-export interface GridColumn {
-    key: string;
-    header: string;
-    width?: number;
-    /**
-     * Flexible sizing. When true or a positive number, the column can expand to fill
-     * available horizontal space. If a number is provided, it represents the flex grow weight.
-     * Note: runtime support may require renderer updates; currently a type hint.
-     */
-    flex?: boolean | number;
-    /** Minimum width in pixels for this column */
-    minWidth?: number;
-    /** Maximum width in pixels for this column */
-    maxWidth?: number;
-    /** Allows column to be resizable via UI (if the header implements it) */
-    resizable?: boolean;
-    /**
-     * Whether the column is sortable. Defaults to true; set explicitly to false to disable.
-     */
-    sortable?: boolean;
-    filterable?: boolean | ColumnFilter;
-    formatter?: (value: any) => string;
-    cellRenderer?: (value: any, row: GridRow) => ReactNode;
-    visible?: boolean;
-    /**
-     * Group aggregate to compute for this column when grouping is enabled.
-     * If a function is provided, it will receive the array of raw cell values and should return the aggregate value.
-     */
-    aggregate?: "sum" | "avg" | "min" | "max" | ((values: any[]) => any);
-    /**
-     * Optional formatter for the aggregate value displayed in group footers.
-     * Falls back to the column's formatter if not provided.
-     */
-    aggregateFormatter?: (value: any) => string;
-    /**
-     * Footer aggregate to compute for this column and display at the bottom of all rows.
-     * If a function is provided, it will receive the array of raw cell values and should return the aggregate value.
-     */
-    footer_aggregate?: "count" | "sum" | "avg" | "min" | "max" | ((values: any[]) => any);
-    /**
-     * Optional formatter for the footer aggregate value.
-     * Falls back to the column's formatter if not provided.
-     */
-    footerAggregateFormatter?: (value: any) => string;
-    /**
-     * Horizontal alignment for cell content: left | center | right
-     */
-    align?: "left" | "center" | "right";
-    /**
-     * Horizontal alignment for header content: left | center | right
-     */
-    headerAlign?: "left" | "center" | "right";
-    /** Optional CSS class for body cells of this column */
-    className?: string | ((value: any, row: GridRow) => string);
-    /** Optional inline style for body cells of this column */
-    cellStyle?: CSSProperties | ((value: any, row: GridRow) => CSSProperties);
-    /** Optional CSS class for the header cell of this column */
-    headerClassName?: string;
-    /** If true, removes default padding from the cell container for this column */
-    noPadding?: boolean;
-    /** If false, do not wrap renderer output with the default truncation div */
-    wrapCellContent?: boolean;
-}
-export interface GridRow {
-    id?: string | number;
-    [key: string]: any;
-}
-export interface GroupConfig {
-    /** Ordered list of column keys to group by (multi-level). */
-    columnKeys: string[];
-    /**
-     * Expanded group paths. Each path is a stable string key built from the sequence of
-     * grouping values, e.g. "City=SF|Status=Open". Root groups are single segment.
-     */
-    expanded: Set<string>;
-}
-export interface GroupedData {
-    [groupValue: string]: {
-        rows: GridRow[];
-        count: number;
-    };
-}
-export type SearchMode = "contains" | "exact" | "startsWith" | "endsWith" | "regex";
-export type BulkAction = "delete" | "archive" | "copy" | "edit" | "export";
-export interface SavedFilter {
-    id: string;
-    name: string;
-    globalFilter: string;
-    columnFilters: Record<string, any>;
-    searchMode: SearchMode;
-}
-export interface BulkActionOption {
-    id: BulkAction;
-    label: string;
-    icon: ReactNode;
-    onClick: (selectedRows: Set<string | number>) => void;
-    disabled?: boolean;
-    destructive?: boolean;
-}
-export interface CustomDataGridProps {
-    data: GridRow[];
-    columns: GridColumn[];
-    /**
-     * Optional function to derive unique row identifier from a row object.
-     * Priority order:
-     *   1. If getRowId is provided, use it to extract the ID from the row
-     *   2. Else if row.id exists, use it
-     *   3. Else use the row's index as fallback (may cause issues with pagination/filtering)
-     *
-     * Examples:
-     *   - (row) => row.employeeId
-     *   - (row) => `${row.dept}_${row.name}` (composite key)
-     *   - (row) => row.uuid
-     *
-     * Recommendation: Always provide either row.id or getRowId prop for best results.
-     */
-    getRowId?: (row: GridRow) => string | number;
-    height?: number;
-    density?: Density;
-    onDensityChange?: (density: Density) => void;
-    /**
-     * Optional header size controls (independent of row density).
-     * - If headerHeight is provided, it takes precedence (fixed pixel height).
-     * - Else if headerDensity is provided, it maps to the density sizing (sm|md|lg).
-     * - Else defaults to medium (md).
-     */
-    headerDensity?: Density;
-    headerHeight?: number;
-    showDensityControl?: boolean;
-    onRowSelect?: (row: GridRow) => void;
-    onSelectedRowsChange?: (selectedRows: Set<string | number>) => void;
-    selectable?: boolean;
-    isRowSelectable?: (row: GridRow) => boolean;
-    showToolbar?: boolean;
-    showExport?: boolean;
-    /**
-     * Optional export options to control which formats are allowed and default filename.
-     * If not provided, only Excel ("xlsx") will be allowed by default.
-     */
-    exportOptions?: {
-        /** Allowed export formats (defaults to ["xlsx"]) */
-        formats?: Array<"csv" | "json" | "xlsx">;
-        /** Default exported filename without extension (defaults to "grid-data") */
-        filename?: string;
-        /** Enable/disable export action (defaults to true; combined with showExport) */
-        enabled?: boolean;
-        /** Export execution mode. Default: 'client'. */
-        exportMode?: "client" | "server";
-        /**
-         * Optional handler to perform server-side export when exportMode === 'server'.
-         * If exportSelected is true, selectedRowIds will contain the ids that are currently selected in the grid.
-         */
-        onServerExport?: (format: "csv" | "json" | "xlsx", exportSelected: boolean, selectedRowIds?: Array<string | number>) => void;
-    };
-    sortable?: boolean;
-    filterable?: boolean;
-    groupable?: boolean;
-    virtualized?: boolean;
-    rowHeight?: number;
-    overscan?: number;
-    rowStyle?: (row: GridRow) => CSSProperties | undefined;
-    onContextMenu?: (row: GridRow, event: MouseEvent) => void;
-    onRowDoubleClick?: (row: GridRow, event: MouseEvent) => void;
-    onRowClick?: (row: GridRow, event: MouseEvent) => void;
-    onCellClick?: (args: {
-        row: GridRow;
-        column: GridColumn;
-        value: any;
-        event: MouseEvent;
-    }) => void;
-    onCellContextMenu?: (args: {
-        row: GridRow;
-        column: GridColumn;
-        value: any;
-        displayValue: string;
-        event: MouseEvent;
-    }) => void;
-    cellFocusEnabled?: boolean;
-    onCellFocusChange?: (args: {
-        row: GridRow;
-        column: GridColumn;
-        value: any;
-        rowIndex: number;
-        colIndex: number;
-    }) => void;
-    cellSelectionEnabled?: boolean;
-    canSelectCell?: (row: GridRow, column: GridColumn) => boolean;
-    onCellSelectionChange?: (payload: {
-        bounds: {
-            rowStart: number;
-            rowEnd: number;
-            colStart: number;
-            colEnd: number;
-        } | null;
-        cells: Array<{
-            row: GridRow;
-            column: GridColumn;
-            value: any;
-            rowIndex: number;
-            colIndex: number;
-        }>;
-    }) => void;
-    onAutosizeColumn?: (columnKey: string) => void;
-    onAutosizeAllColumns?: () => void;
-    onResetColumns?: () => void;
-    pagination?: {
-        enabled?: boolean;
-        mode?: PaginationMode;
-        pageSize?: number;
-        showPageSizeSelector?: boolean;
-        pageSizeOptions?: number[];
-        serverConfig?: ServerPaginationConfig;
-    };
-    /** If provided, when total (post-filter) rows <= threshold virtualization is auto-disabled for simpler DOM (default: 300). */
-    virtualizationThreshold?: number;
-    onRefresh?: () => void;
-    isLoading?: boolean;
-    bulkActions?: BulkActionOption[];
-    savedFilters?: SavedFilter[];
-    onSaveFilter?: (filter: Omit<SavedFilter, "id">) => void;
-    onLoadFilter?: (filter: SavedFilter) => void;
-    onDeleteFilter?: (filterId: string) => void;
-    onFilterChange?: (payload: ServerFilterChangePayload) => void;
-    onSort?: (columnKey: string, direction: "asc" | "desc") => void;
-    onColumnConfigChange?: (config: ColumnConfig) => void;
-    initialColumnConfig?: Partial<ColumnConfig>;
-    toolbarLeft?: ReactNode;
-    toolbarRight?: ReactNode;
-    /**
-     * Controls the visibility of the Group Bar (the area where you can drop headers to group).
-     * - 'hidden': never show the bar
-     * - 'auto': show only when there are active grouped columns
-     * - 'visible': always show when groupable is true
-     */
-    groupBarVisibility?: "hidden" | "auto" | "visible";
-    /**
-     * How to render group aggregation footer rows when grouping is enabled.
-     * - 'chips': render a colored summary bar with chips (default)
-     * - 'columns': render a full-width colored row placing aggregate values under their respective columns
-     */
-    groupFooterVariant?: "chips" | "columns";
-    /**
-     * Optional custom renderer for actions on grouped rows.
-     * Receives information about the group and its rows.
-     */
-    renderGroupActions?: (groupInfo: {
-        groupKey: string;
-        columnKey: string;
-        groupValue: any;
-        rows: GridRow[];
-        count: number;
-        level: number;
-    }) => ReactNode;
-    /**
-     * Show expand/collapse all group buttons in the toolbar when grouping is enabled.
-     * Defaults to true.
-     */
-    showGroupExpandControls?: boolean;
-    /**
-     * Callback invoked when user copies cells (Ctrl/Cmd + C) while cell focus or rectangular selection is active.
-     * Provides the plain text that was written to the clipboard (tab/newline delimited) and metadata.
-     */
-    onCopyCells?: (payload: {
-        text: string;
-        /** Present only for rectangular selections */
-        bounds?: {
-            rowStart: number;
-            rowEnd: number;
-            colStart: number;
-            colEnd: number;
-        } | null;
-        cells: Array<{
-            row: GridRow;
-            column: GridColumn;
-            value: any;
-            rowIndex: number;
-            colIndex: number;
-        }>;
-        isRectangular: boolean;
-        isFocusedCell: boolean;
-    }) => void;
-    /** Optional controlled selection ids */
-    selectedRowIds?: Iterable<string | number> | null;
-    /** Performance optimization settings for large datasets */
-    performanceConfig?: {
-        /** Enable horizontal virtualization for large column sets (default: true) */
-        enableHorizontalVirtualization?: boolean;
-        /** Column count threshold to enable horizontal virtualization (default: 50) */
-        horizontalVirtualizationThreshold?: number;
-        /** Row count threshold to offload sorting to a Web Worker (default: 5000). Set to 0 to always sort inline. */
-        sortWorkerThreshold?: number;
-        /** Maximum cache size for filtering operations (default: 5000) */
-        maxFilterCacheSize?: number;
-        /** Enable aggressive memoization for large datasets (default: true) */
-        enableAggressiveMemoization?: boolean;
-    };
-}
-export interface ContextMenuItem {
-    id: string;
-    label: string;
-    icon?: ReactNode;
-    onClick: (row: GridRow) => void;
-    disabled?: boolean;
-    separator?: boolean;
-}
-export type SortDirection = "asc" | "desc" | null;
-export interface SortConfig {
-    key: string | null;
-    direction: SortDirection;
-}
-export interface VirtualizedRange {
-    startIndex: number;
-    endIndex: number;
-    offsetY: number;
-}
-export interface ColumnFilterValue {
-    type: FilterType;
-    value: any;
-    operator?: "equals" | "contains" | "startsWith" | "endsWith" | "gt" | "lt" | "gte" | "lte" | "between";
-    secondValue?: any;
-}
-export interface ActiveFilters {
-    [columnKey: string]: ColumnFilterValue;
-}
-export interface ColumnConfig {
-    columnWidths: Record<string, number>;
-    columnVisibility: Record<string, boolean>;
-    pinnedColumns: string[];
-    sortConfig: SortConfig;
-    /**
-     * Persisted grouping configuration. New multi-level shape uses columnKeys.
-     * The legacy single-key field (columnKey) is retained for backward compatibility.
-     */
-    groupConfig?: {
-        columnKeys?: string[];
-        columnKey?: string | null;
-    };
-    filters: {
-        globalFilter: string;
-        columnFilters: ActiveFilters;
-    };
-    columnOrder?: string[];
-    density?: Density;
-}
-export interface PaginationConfig {
-    enabled: boolean;
-    pageSize: number;
-    currentPage: number;
-    totalPages: number;
-    totalRows: number;
-    showPageSizeSelector?: boolean;
-    pageSizeOptions?: number[];
-}
-export interface ServerPaginationConfig {
-    enabled: boolean;
-    onPageChange: (page: number, pageSize: number) => Promise<void> | void;
-    onPageSizeChange?: (pageSize: number) => Promise<void> | void;
-    loading?: boolean;
-    totalRows: number;
-}
-export type PaginationMode = "client" | "server";
-export interface FilterPopupProps {
-    column: GridColumn;
-    data: GridRow[];
-    currentFilter?: ColumnFilterValue;
-    onApplyFilter: (filter: ColumnFilterValue | null) => void;
-    onClose: () => void;
-    position: {
-        top: number;
-        left: number;
-    };
-    autoApply?: boolean;
-}
-export interface ServerFilterChangePayload {
-    globalFilter: string;
-    columnFilters: ActiveFilters;
-    filterableKeys: string[];
-    searchMode?: SearchMode;
-}
-/**
- * Imperative handle for CustomDataGrid to allow external control of grouping.
- * Use with React.forwardRef and useImperativeHandle in the grid component.
- */
-export interface CustomDataGridRef {
-    /** Replace the entire ordered grouping keys */
-    setGroupKeys: (keys: string[]) => void;
-    /** Add a grouping key at the end if not already present */
-    addGroupKey: (key: string) => void;
-    /** Remove a specific grouping key */
-    removeGroupKey: (key: string) => void;
-    /** Expand all group paths for the current grouping keys */
-    expandAllGroups: () => void;
-    /** Collapse all group paths */
-    collapseAllGroups: () => void;
-    /** Toggle a specific group path, e.g. "City=SF|Status=Open" */
-    toggleGroupExpansion: (groupPath: string) => void;
-    /** Read the current in-grid grouping configuration */
-    getGroupConfig: () => GroupConfig;
-    /** Set a column filter programmatically */
-    setColumnFilter: (columnKey: string, filter: any) => void;
-    /** Clear a specific column filter */
-    clearColumnFilter: (columnKey: string) => void;
-    /** Clear all column filters */
-    clearAllFilters: () => void;
-    /** Set global filter */
-    setGlobalFilter: (value: string) => void;
-}

package/dist/workers/utils/highlightText.d.ts

@@ -1,15 +0,0 @@
-import React from "react";
-/**
- * Highlights matching text within a string based on a search query
- * @param text - The text to highlight
- * @param searchQuery - The search query to match against
- * @returns JSX element with highlighted matches
- */
-export declare const highlightText: (text: string, searchQuery: string) => React.ReactNode;
-/**
- * Checks if a value contains the search query (case-insensitive)
- * @param value - The value to check
- * @param searchQuery - The search query
- * @returns true if the value contains the search query
- */
-export declare const containsSearchQuery: (value: any, searchQuery: string) => boolean;

package/dist/workers/workers/dataWorker.d.ts

@@ -1,16 +0,0 @@
-export interface WorkerProcessMessage {
-    type: "process";
-    payload: {
-        rows: any[];
-        sort?: {
-            key: string;
-            direction: "asc" | "desc";
-        } | null;
-    };
-}
-export interface WorkerResultMessage {
-    type: "result";
-    payload: {
-        rows: any[];
-    };
-}