cecomponent 2.0.84 → 2.0.85

package/dist/components/Common/DataGrid/CEDataGridDynamicsTable.d.ts

@@ -1,6 +1,7 @@
 import { default as React } from 'react';
 import { CustomAction } from '../../../types/customActions';
 export type ComponentType = "text-input" | "number-input" | "auto-suggest" | "date-picker" | "label-text" | "drop-down-input";
+type FreezeColumnsInput = number | Array<string | number>;
 export interface ColumnConfig {
     id: string;
     label?: string;
@@ -11,7 +12,27 @@ export interface ColumnConfig {
     elementType?: ComponentType;
     required?: boolean;
 }
-type FreezeColumnsInput = number | Array<string | number>;
+export interface GridContextState {
+    currentPage: number;
+    rowsPerPage: number;
+    sortConfig: {
+        column: string;
+        direction: "asc" | "desc";
+    } | null;
+    filters: {
+        [key: string]: {
+            value: string;
+            operator: string;
+        };
+    };
+    searchQuery: string;
+    /** Optional persisted column visibility state */
+    visibleColumns?: string[];
+    /** Optional persisted column order state */
+    columnOrder?: string[];
+    /** Optional persisted frozen column ids */
+    frozenColumnIds?: string[];
+}
 interface CEDataGridDynamicTableProps {
     title?: React.ReactNode;
     jsonData: any[];
@@ -46,6 +67,18 @@ interface CEDataGridDynamicTableProps {
     handleCancelClick?: (row: any, rowIndex: number) => void;
     handleCopyClick?: (row: any, rowIndex: number) => void;
     handleViewClick?: (row: any, rowIndex: number) => void;
+    /** Enables inline row-level edit mode (Edit → Save/Cancel) inside the grid. */
+    enableRowLevelEdit?: boolean;
+    /**
+     * Custom icon (img src URL or SVG path) to use for the inline row-edit trigger button.
+     * When omitted, the default Edit icon is used.
+     * Has no effect when enableRowLevelEdit is false.
+     */
+    rowEditIcon?: string;
+    /** Optional explicit allow-list of columns that can be edited in row edit mode. */
+    editableColumns?: string[];
+    /** Optional predicate for fine-grained editability by row+column. Returns true to allow editing. */
+    editableCellPredicate?: (rowData: any, columnId: string) => boolean;
     clickableColumns?: string[];
     isExportAllToExcel?: boolean;
     conditionalClickableColumns?: Record<string, string[]>;
@@ -87,7 +120,7 @@ interface CEDataGridDynamicTableProps {
     onDataUpdate?: (updatedData: {
         fullData: any[];
         updatedRow: any;
-    }) => void;
+    }) => void | Promise<void>;
     isOverrideCSS?: any;
     showPagination?: boolean;
     shouldResetSearchOnDataChange?: boolean;
@@ -130,18 +163,47 @@ interface CEDataGridDynamicTableProps {
      */
     customActions?: CustomAction[];
     shouldColumnPersist?: boolean;
+    enableFreezeControls?: boolean;
     /**
-     * Freeze columns on the left side of the grid.
-     * - number: freezes first N visible columns
-     * - (string | number)[]: freezes by ids/labels and/or 1-based visible indexes
+     * Controlled freeze: freeze columns by id, label, or 1-based visible index.
+     * - number: freeze first N visible columns
+     * - (string | number)[]: freeze by column id/label or 1-based index
      */
     freezeColumns?: FreezeColumnsInput;
-    /** Initial freeze config for uncontrolled mode. */
+    /** Initial freeze config for uncontrolled mode (applied once on mount). */
     defaultFreezeColumns?: FreezeColumnsInput;
-    /** Show pin and unpin controls in the Column Visibility modal. */
-    enableFreezeControls?: boolean;
-    /** Emits normalized frozen column ids when users update freeze settings from UI. */
+    /** Emits the current frozen column ids whenever the user pins or unpins a column. */
     onFreezeColumnsChange?: (frozenColumnIds: string[]) => void;
+    /**
+     * Unique identifier for this grid instance (required for view management)
+     */
+    gridId?: string;
+    /**
+     * Enable automatic saving of grid state (columns, pagination)
+     * @default false
+     */
+    enableAutoSave?: boolean;
+    /**
+     * Enable automatic restoration of grid state on mount
+     * @default false
+     */
+    enableAutoRestore?: boolean;
+    /**
+     * Exposes manual Save/Restore actions so external buttons can control persistence.
+     */
+    onViewPersistenceReady?: (actions: {
+        saveView: () => void;
+        restoreView: () => void;
+    }) => void;
+    /**
+     * Optional external grid context to restore/drive page, page-size, sort, filters and search.
+     * Consumers can persist this object and pass it back after data refresh.
+     */
+    gridContext?: Partial<GridContextState>;
+    /**
+     * Emits whenever local grid context changes.
+     */
+    onGridContextChange?: (context: GridContextState) => void;
 }
 declare const CEDataGridDynamicTable: React.FC<CEDataGridDynamicTableProps>;
 export default CEDataGridDynamicTable;

package/dist/components/Common/DataGrid/ManageViewsModal.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { SavedView } from './types/ViewConfig';
+interface ManageViewsModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    views: SavedView[];
+    onLoadView: (viewId: string) => void;
+    onDeleteView: (viewId: string) => void;
+    onRenameView: (viewId: string, newName: string) => void;
+    isLoading?: boolean;
+}
+declare const ManageViewsModal: React.FC<ManageViewsModalProps>;
+export default ManageViewsModal;

package/dist/components/Common/DataGrid/SaveViewModal.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+interface SaveViewModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSave: (payload: {
+        name: string;
+        description: string;
+        includeFilters: boolean;
+        includeSort: boolean;
+        includeSearch: boolean;
+    }) => void;
+    isLoading?: boolean;
+}
+declare const SaveViewModal: React.FC<SaveViewModalProps>;
+export default SaveViewModal;

package/dist/components/Common/DataGrid/ViewPersistenceControls.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+/**
+ * Example component demonstrating how to use useViewPersistence hook
+ * with external Save/Restore buttons outside the grid
+ */
+interface ViewPersistenceControlsProps {
+    gridId?: string;
+    onSave?: () => void;
+    onRestore?: () => void;
+    /** @deprecated Use onRestore instead. */
+    onLoad?: () => void;
+}
+export declare const ViewPersistenceControls: React.FC<ViewPersistenceControlsProps>;
+export default ViewPersistenceControls;

package/dist/components/Common/DataGrid/hooks/useViewPersistence.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Hook for managing automatic view persistence
+ * Automatically saves changes and provides save/load methods
+ */
+export declare const useViewPersistence: (gridId: string | undefined, enabled?: boolean) => {
+    autoSave: (visibleColumns: string[], columnOrder: string[], frozenColumnIds: string[] | undefined, currentPage: number, rowsPerPage: number, sortConfig?: any, filters?: any, searchQuery?: string) => void;
+    autoRestore: () => {
+        visibleColumns: string[];
+        columnOrder: string[];
+        frozenColumnIds?: string[];
+        currentPage: number;
+        rowsPerPage: number;
+        sort?: any;
+        filters?: any;
+        searchQuery?: string;
+    } | null;
+    saveView: (visibleColumns: string[], columnOrder: string[], frozenColumnIds: string[] | undefined, currentPage: number, rowsPerPage: number, viewName?: string, sortConfig?: any, filters?: any, searchQuery?: string) => string | null;
+    loadView: (viewId?: string) => {
+        visibleColumns: string[];
+        columnOrder: string[];
+        frozenColumnIds?: string[];
+        currentPage: number;
+        rowsPerPage: number;
+        sort?: any;
+        filters?: any;
+        searchQuery?: string;
+    } | null;
+    getSavedViews: () => import('../types/ViewConfig').SavedView[];
+    clearAllViews: () => boolean;
+};
+export default useViewPersistence;

package/dist/components/Common/DataGrid/types/ViewConfig.d.ts

@@ -0,0 +1,44 @@
+/**
+ * View Configuration Types
+ * Defines structure for saving and loading grid view states
+ */
+export interface PaginationState {
+    currentPage: number;
+    rowsPerPage: number;
+}
+export interface ColumnState {
+    visibleColumns: string[];
+    columnOrder: string[];
+    frozenColumnIds?: string[];
+}
+export interface SortState {
+    column: string;
+    direction: "asc" | "desc";
+}
+export interface FilterState {
+    [key: string]: {
+        value: string;
+        operator: string;
+    };
+}
+export interface ViewConfig {
+    name: string;
+    description?: string;
+    timestamp: number;
+    columns: ColumnState;
+    pagination: PaginationState;
+    sort?: SortState | null;
+    filters?: FilterState;
+    searchQuery?: string;
+}
+export interface SavedView {
+    id: string;
+    config: ViewConfig;
+}
+export interface ViewContextPayload {
+    name: string;
+    description?: string;
+    includeFilters?: boolean;
+    includeSort?: boolean;
+    includeSearch?: boolean;
+}

package/dist/components/Common/DataGrid/utils/ViewManager.d.ts

@@ -0,0 +1,53 @@
+import { ViewConfig, SavedView, ColumnState, PaginationState, ViewContextPayload } from '../types/ViewConfig';
+export declare class ViewManager {
+    private storageKeyPrefix;
+    /**
+     * Generate unique storage key for a grid instance
+     */
+    private getStorageKey;
+    /**
+     * Get all saved views for a grid
+     */
+    getSavedViews(gridId: string): SavedView[];
+    /**
+     * Save a new view configuration
+     */
+    saveView(gridId: string, payload: ViewContextPayload, columns: ColumnState, pagination: PaginationState, additionalData?: {
+        sort?: any;
+        filters?: any;
+        searchQuery?: string;
+    }): SavedView;
+    /**
+     * Update an existing view
+     */
+    updateView(gridId: string, viewId: string, columns: ColumnState, pagination: PaginationState, additionalData?: {
+        sort?: any;
+        filters?: any;
+        searchQuery?: string;
+    }): SavedView | null;
+    /**
+     * Load a saved view configuration
+     */
+    loadView(gridId: string, viewId: string): ViewConfig | null;
+    /**
+     * Delete a saved view
+     */
+    deleteView(gridId: string, viewId: string): boolean;
+    /**
+     * Rename a saved view
+     */
+    renameView(gridId: string, viewId: string, newName: string, description?: string): SavedView | null;
+    /**
+     * Clear all views for a grid
+     */
+    clearAllViews(gridId: string): boolean;
+    /**
+     * Export views as JSON
+     */
+    exportViews(gridId: string): string;
+    /**
+     * Import views from JSON
+     */
+    importViews(gridId: string, jsonString: string): boolean;
+}
+export declare const viewManager: ViewManager;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cecomponent",
   "description": "A React component library for building modern UIs for Cleanearth",
-  "version": "2.0.84",
+  "version": "2.0.85",
   "main": "dist/ce-component-lib.js",
   "module": "dist/ce-component-lib.mjs",
   "types": "dist/idex.d.ts",