@memberjunction/ng-entity-viewer 2.132.0 → 2.133.0

package/dist/lib/entity-data-grid/entity-data-grid.component.d.ts

@@ -0,0 +1,792 @@
+import { EventEmitter, OnInit, OnDestroy, ChangeDetectorRef, ElementRef } from '@angular/core';
+import { BaseEntity, RunViewParams, EntityInfo } from '@memberjunction/core';
+import { UserViewEntityExtended } from '@memberjunction/core-entities';
+import { ColDef, GridReadyEvent, RowClickedEvent, RowDoubleClickedEvent, RowSelectionOptions, GetRowIdParams, SortChangedEvent as AgSortChangedEvent, ColumnResizedEvent, ColumnMovedEvent, SelectionChangedEvent, GridOptions } from 'ag-grid-community';
+import { GridSelectionMode, GridEditMode, GridLinesMode, GridColumnConfig, GridToolbarConfig, GridToolbarButton, GridState, GridRowData, ColumnRuntimeState, ViewGridStateConfig, GridStateChangedEvent, EntityActionConfig, GridVisualConfig } from './models/grid-types';
+import { BeforeRowSelectEventArgs, AfterRowSelectEventArgs, BeforeRowDeselectEventArgs, AfterRowDeselectEventArgs, BeforeRowClickEventArgs, AfterRowClickEventArgs, BeforeRowDoubleClickEventArgs, AfterRowDoubleClickEventArgs, BeforeCellEditEventArgs, AfterCellEditBeginEventArgs, BeforeCellEditCommitEventArgs, AfterCellEditCommitEventArgs, BeforeCellEditCancelEventArgs, AfterCellEditCancelEventArgs, BeforeRowSaveEventArgs, AfterRowSaveEventArgs, BeforeRowDeleteEventArgs, AfterRowDeleteEventArgs, BeforeDataLoadEventArgs, AfterDataLoadEventArgs, BeforeDataRefreshEventArgs, AfterDataRefreshEventArgs, BeforeSortEventArgs, AfterSortEventArgs, BeforeColumnReorderEventArgs, AfterColumnReorderEventArgs, BeforeColumnResizeEventArgs, AfterColumnResizeEventArgs, BeforeColumnVisibilityChangeEventArgs, AfterColumnVisibilityChangeEventArgs } from './events/grid-events';
+import { ExportService, ExportDialogConfig, ExportDialogResult } from '@memberjunction/ng-export-service';
+import { ExportOptions, ExportResult } from '@memberjunction/export-engine';
+import * as i0 from "@angular/core";
+/**
+ * A modern, flexible data grid component for displaying and managing entity data.
+ * Built on AG Grid Community edition with a rich Before/After cancelable event system.
+ *
+ * Features:
+ * - RunView-based data loading with automatic refresh
+ * - AG Grid for high-performance rendering
+ * - Rich event system with Before/After cancelable patterns
+ * - Column configuration with type-aware formatters
+ * - Row selection (single, multiple, checkbox modes)
+ * - Inline cell and row editing
+ * - Column reordering, resizing, and visibility toggle
+ * - State persistence to User Settings
+ * - Compatible with ViewGridStateConfig from User Views
+ *
+ * @example
+ * ```html
+ * <mj-entity-data-grid
+ *   [entityName]="'Contacts'"
+ *   [showToolbar]="true"
+ *   [allowSorting]="true"
+ *   [selectionMode]="'multiple'"
+ *   (afterRowDoubleClick)="onRowDoubleClick($event)">
+ * </mj-entity-data-grid>
+ * ```
+ */
+export declare class EntityDataGridComponent implements OnInit, OnDestroy {
+    private cdr;
+    private elementRef;
+    private exportService;
+    private _params;
+    /**
+     * RunViewParams for data loading - the primary way to specify data source.
+     * Supports stored views (ViewID, ViewName, ViewEntity) and dynamic views (EntityName + filters).
+     * Mutually exclusive with the legacy entityName/extraFilter inputs.
+     * When Params is provided, it takes precedence over legacy inputs.
+     */
+    set Params(value: RunViewParams | null);
+    get Params(): RunViewParams | null;
+    private _allowLoad;
+    /**
+     * Controls whether data loading is allowed.
+     * Set to false to defer loading until ready (useful for complex forms where params may change multiple times).
+     * When set to true and Params is provided, triggers a data load.
+     */
+    set AllowLoad(value: boolean);
+    get AllowLoad(): boolean;
+    private _autoRefreshOnParamsChange;
+    /**
+     * When true, automatically refreshes data when Params changes.
+     * When false, you must call Refresh() manually after changing Params.
+     */
+    set AutoRefreshOnParamsChange(value: boolean);
+    get AutoRefreshOnParamsChange(): boolean;
+    private _paginationMode;
+    /**
+     * Pagination mode for the grid:
+     * - 'client': All data loaded upfront (default, legacy behavior)
+     * - 'infinite': Server-side pagination with infinite scroll (recommended for large datasets)
+     */
+    set PaginationMode(value: 'client' | 'infinite');
+    get PaginationMode(): 'client' | 'infinite';
+    private _pageSize;
+    /**
+     * Number of rows to fetch per page when using infinite pagination mode.
+     * Default is 100 rows per page.
+     */
+    set PageSize(value: number);
+    get PageSize(): number;
+    private _cacheBlockSize;
+    /**
+     * Size of each cache block in infinite scroll mode.
+     * Should match or be a multiple of PageSize for optimal performance.
+     */
+    set CacheBlockSize(value: number);
+    get CacheBlockSize(): number;
+    private _maxBlocksInCache;
+    /**
+     * Maximum number of blocks to keep in cache.
+     * When exceeded, oldest blocks are purged.
+     */
+    set MaxBlocksInCache(value: number);
+    get MaxBlocksInCache(): number;
+    private _data;
+    /**
+     * Pre-loaded data (bypass RunView, use provided data).
+     * When provided, the grid displays this data instead of loading via RunView.
+     * Parent component is responsible for data loading and passing results here.
+     */
+    set Data(value: BaseEntity[]);
+    get Data(): BaseEntity[];
+    private _columns;
+    /**
+     * Column definitions - if not provided, auto-generates from entity metadata
+     */
+    set Columns(value: GridColumnConfig[]);
+    get Columns(): GridColumnConfig[];
+    private _gridState;
+    /**
+     * Grid state from a User View - controls columns, widths, order, sort
+     * When provided, this takes precedence over auto-generated columns
+     */
+    set GridState(value: ViewGridStateConfig | null);
+    get GridState(): ViewGridStateConfig | null;
+    private _allowColumnReorder;
+    set AllowColumnReorder(value: boolean);
+    get AllowColumnReorder(): boolean;
+    private _allowColumnResize;
+    set AllowColumnResize(value: boolean);
+    get AllowColumnResize(): boolean;
+    private _allowColumnToggle;
+    set AllowColumnToggle(value: boolean);
+    get AllowColumnToggle(): boolean;
+    private _showHeader;
+    set ShowHeader(value: boolean);
+    get ShowHeader(): boolean;
+    private _allowSorting;
+    set AllowSorting(value: boolean);
+    get AllowSorting(): boolean;
+    private _allowMultiSort;
+    set AllowMultiSort(value: boolean);
+    get AllowMultiSort(): boolean;
+    private _serverSideSorting;
+    /**
+     * Whether sorting is handled server-side
+     * When true, sort changes trigger a new data load
+     */
+    set ServerSideSorting(value: boolean);
+    get ServerSideSorting(): boolean;
+    private _allowColumnFilters;
+    set AllowColumnFilters(value: boolean);
+    get AllowColumnFilters(): boolean;
+    private _showSearch;
+    set ShowSearch(value: boolean);
+    get ShowSearch(): boolean;
+    private _selectionMode;
+    set SelectionMode(value: GridSelectionMode);
+    get SelectionMode(): GridSelectionMode;
+    private _selectedKeys;
+    set SelectedKeys(value: string[]);
+    get SelectedKeys(): string[];
+    private _keyField;
+    set KeyField(value: string);
+    get KeyField(): string;
+    private _editMode;
+    set EditMode(value: GridEditMode);
+    get EditMode(): GridEditMode;
+    private _allowAdd;
+    set AllowAdd(value: boolean);
+    get AllowAdd(): boolean;
+    private _allowDelete;
+    set AllowDelete(value: boolean);
+    get AllowDelete(): boolean;
+    private _height;
+    set Height(value: number | 'auto' | 'fit-content');
+    get Height(): number | 'auto' | 'fit-content';
+    private _rowHeight;
+    set RowHeight(value: number);
+    get RowHeight(): number;
+    private _virtualScroll;
+    set VirtualScroll(value: boolean);
+    get VirtualScroll(): boolean;
+    private _showRowNumbers;
+    set ShowRowNumbers(value: boolean);
+    get ShowRowNumbers(): boolean;
+    private _striped;
+    set Striped(value: boolean);
+    get Striped(): boolean;
+    private _gridLines;
+    set GridLines(value: GridLinesMode);
+    get GridLines(): GridLinesMode;
+    private _visualConfig;
+    /**
+     * Visual configuration for the grid appearance.
+     * Allows customization of header styles, row colors, cell formatting, and more.
+     * All properties are optional - unset properties use attractive defaults.
+     */
+    set VisualConfig(value: GridVisualConfig);
+    get VisualConfig(): GridVisualConfig;
+    /**
+     * Get the effective visual config (user config merged with defaults)
+     */
+    get effectiveVisualConfig(): Required<GridVisualConfig>;
+    private _showToolbar;
+    set ShowToolbar(value: boolean);
+    get ShowToolbar(): boolean;
+    private _toolbarConfig;
+    set ToolbarConfig(value: GridToolbarConfig);
+    get ToolbarConfig(): GridToolbarConfig;
+    private _stateKey;
+    set StateKey(value: string);
+    get StateKey(): string;
+    private _autoPersistState;
+    /**
+     * When true and using a stored view (ViewID/ViewName/ViewEntity in Params),
+     * automatically persists grid state changes (column widths, order, sort) to the UserView entity.
+     * Only saves if the user has edit permission on the view.
+     * For dynamic views, only emits the gridStateChanged event.
+     */
+    set AutoPersistState(value: boolean);
+    get AutoPersistState(): boolean;
+    private _statePersistDebounce;
+    /**
+     * Debounce time in milliseconds before persisting state changes to the server.
+     * Default is 5000ms (5 seconds) to avoid excessive server calls during rapid column adjustments.
+     */
+    set StatePersistDebounce(value: number);
+    get StatePersistDebounce(): number;
+    private _refreshDebounce;
+    set RefreshDebounce(value: number);
+    get RefreshDebounce(): number;
+    private _filterText;
+    /**
+     * Text to highlight in grid cells.
+     * Supports SQL-style % wildcards for pattern matching.
+     */
+    set FilterText(value: string);
+    get FilterText(): string;
+    private _showNewButton;
+    /**
+     * Show the "New" button in toolbar (creates new record)
+     */
+    set ShowNewButton(value: boolean);
+    get ShowNewButton(): boolean;
+    private _showRefreshButton;
+    /**
+     * Show the "Refresh" button in toolbar
+     */
+    set ShowRefreshButton(value: boolean);
+    get ShowRefreshButton(): boolean;
+    private _showExportButton;
+    /**
+     * Show the "Export to Excel" button in toolbar
+     */
+    set ShowExportButton(value: boolean);
+    get ShowExportButton(): boolean;
+    private _showDeleteButton;
+    /**
+     * Show the "Delete" button in toolbar (deletes selected rows)
+     */
+    set ShowDeleteButton(value: boolean);
+    get ShowDeleteButton(): boolean;
+    private _showCompareButton;
+    /**
+     * Show the "Compare" button in toolbar (compare selected records)
+     */
+    set ShowCompareButton(value: boolean);
+    get ShowCompareButton(): boolean;
+    private _showMergeButton;
+    /**
+     * Show the "Merge" button in toolbar (merge selected records)
+     */
+    set ShowMergeButton(value: boolean);
+    get ShowMergeButton(): boolean;
+    private _showAddToListButton;
+    /**
+     * Show the "Add to List" button in toolbar
+     */
+    set ShowAddToListButton(value: boolean);
+    get ShowAddToListButton(): boolean;
+    private _showDuplicateSearchButton;
+    /**
+     * Show the "Search for Duplicates" button in toolbar
+     */
+    set ShowDuplicateSearchButton(value: boolean);
+    get ShowDuplicateSearchButton(): boolean;
+    private _showCommunicationButton;
+    /**
+     * Show the "Send Message" button in toolbar (if entity supports communication)
+     */
+    set ShowCommunicationButton(value: boolean);
+    get ShowCommunicationButton(): boolean;
+    private _autoNavigate;
+    /**
+     * When true, clicking or double-clicking a row will emit a navigation request.
+     * The parent component can handle the navigationRequested event to open the record.
+     */
+    set AutoNavigate(value: boolean);
+    get AutoNavigate(): boolean;
+    private _navigateOnDoubleClick;
+    /**
+     * When true, navigation is triggered on double-click only.
+     * When false, navigation is triggered on single click.
+     * Only applies when AutoNavigate is true.
+     */
+    set NavigateOnDoubleClick(value: boolean);
+    get NavigateOnDoubleClick(): boolean;
+    private _createRecordMode;
+    /**
+     * How to open new records when the "New" button is clicked:
+     * - 'Tab': Emit event to open in a new tab (default)
+     * - 'Dialog': Emit event to open in a dialog
+     */
+    set CreateRecordMode(value: 'Dialog' | 'Tab');
+    get CreateRecordMode(): 'Dialog' | 'Tab';
+    private _newRecordValues;
+    /**
+     * Default values to set on new records.
+     * These values are passed with the newRecordDialogRequested event.
+     */
+    set NewRecordValues(value: Record<string, unknown>);
+    get NewRecordValues(): Record<string, unknown>;
+    private _showEntityActionButtons;
+    /**
+     * When true, displays entity action buttons in the toolbar overflow menu.
+     * Entity actions are loaded dynamically based on the current entity.
+     * The entityActionsLoaded event is emitted when actions are ready.
+     */
+    set ShowEntityActionButtons(value: boolean);
+    get ShowEntityActionButtons(): boolean;
+    private _entityActions;
+    /**
+     * Array of entity actions to display in the toolbar.
+     * Set this after receiving the entityActionsLoaded event.
+     */
+    set EntityActions(value: EntityActionConfig[]);
+    get EntityActions(): EntityActionConfig[];
+    BeforeRowSelect: EventEmitter<BeforeRowSelectEventArgs>;
+    AfterRowSelect: EventEmitter<AfterRowSelectEventArgs>;
+    BeforeRowDeselect: EventEmitter<BeforeRowDeselectEventArgs>;
+    AfterRowDeselect: EventEmitter<AfterRowDeselectEventArgs>;
+    SelectionChange: EventEmitter<string[]>;
+    BeforeRowClick: EventEmitter<BeforeRowClickEventArgs>;
+    AfterRowClick: EventEmitter<AfterRowClickEventArgs>;
+    BeforeRowDoubleClick: EventEmitter<BeforeRowDoubleClickEventArgs>;
+    AfterRowDoubleClick: EventEmitter<AfterRowDoubleClickEventArgs>;
+    BeforeCellEdit: EventEmitter<BeforeCellEditEventArgs>;
+    AfterCellEditBegin: EventEmitter<AfterCellEditBeginEventArgs>;
+    BeforeCellEditCommit: EventEmitter<BeforeCellEditCommitEventArgs>;
+    AfterCellEditCommit: EventEmitter<AfterCellEditCommitEventArgs>;
+    BeforeCellEditCancel: EventEmitter<BeforeCellEditCancelEventArgs>;
+    AfterCellEditCancel: EventEmitter<AfterCellEditCancelEventArgs>;
+    BeforeRowSave: EventEmitter<BeforeRowSaveEventArgs>;
+    AfterRowSave: EventEmitter<AfterRowSaveEventArgs>;
+    BeforeRowDelete: EventEmitter<BeforeRowDeleteEventArgs>;
+    AfterRowDelete: EventEmitter<AfterRowDeleteEventArgs>;
+    BeforeDataLoad: EventEmitter<BeforeDataLoadEventArgs>;
+    AfterDataLoad: EventEmitter<AfterDataLoadEventArgs>;
+    BeforeDataRefresh: EventEmitter<BeforeDataRefreshEventArgs>;
+    AfterDataRefresh: EventEmitter<AfterDataRefreshEventArgs>;
+    BeforeSort: EventEmitter<BeforeSortEventArgs>;
+    AfterSort: EventEmitter<AfterSortEventArgs>;
+    BeforeColumnReorder: EventEmitter<BeforeColumnReorderEventArgs>;
+    AfterColumnReorder: EventEmitter<AfterColumnReorderEventArgs>;
+    BeforeColumnResize: EventEmitter<BeforeColumnResizeEventArgs>;
+    AfterColumnResize: EventEmitter<AfterColumnResizeEventArgs>;
+    BeforeColumnVisibilityChange: EventEmitter<BeforeColumnVisibilityChangeEventArgs>;
+    AfterColumnVisibilityChange: EventEmitter<AfterColumnVisibilityChangeEventArgs>;
+    GridStateChanged: EventEmitter<GridStateChangedEvent>;
+    AddRequested: EventEmitter<void>;
+    DeleteRequested: EventEmitter<BaseEntity<unknown>[]>;
+    ExportRequested: EventEmitter<void>;
+    NewButtonClick: EventEmitter<void>;
+    RefreshButtonClick: EventEmitter<void>;
+    ExportButtonClick: EventEmitter<void>;
+    DeleteButtonClick: EventEmitter<BaseEntity<unknown>[]>;
+    CompareButtonClick: EventEmitter<BaseEntity<unknown>[]>;
+    MergeButtonClick: EventEmitter<BaseEntity<unknown>[]>;
+    AddToListButtonClick: EventEmitter<BaseEntity<unknown>[]>;
+    DuplicateSearchButtonClick: EventEmitter<BaseEntity<unknown>[]>;
+    CommunicationButtonClick: EventEmitter<BaseEntity<unknown>[]>;
+    /**
+     * Emitted when a row is clicked/double-clicked and AutoNavigate is enabled.
+     * Parent components should handle this to open the entity record.
+     */
+    NavigationRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        record: BaseEntity;
+        compositeKey: string;
+    }>;
+    /**
+     * Emitted when the "New" button is clicked and CreateRecordMode is 'Dialog'.
+     * Parent components should handle this to show a new record dialog.
+     */
+    NewRecordDialogRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        defaultValues: Record<string, unknown>;
+    }>;
+    /**
+     * Emitted when the "New" button is clicked and CreateRecordMode is 'Tab'.
+     * Parent components should handle this to open a new record in a tab.
+     */
+    NewRecordTabRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        defaultValues: Record<string, unknown>;
+    }>;
+    /**
+     * Emitted when Compare Records functionality is requested.
+     * Parent components should handle this to show the compare dialog.
+     */
+    CompareRecordsRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        records: BaseEntity[];
+    }>;
+    /**
+     * Emitted when Merge Records functionality is requested.
+     * Parent components should handle this to show the merge dialog.
+     */
+    MergeRecordsRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        records: BaseEntity[];
+    }>;
+    /**
+     * Emitted when Communication/Send Message functionality is requested.
+     * Parent components should handle this to show the communication dialog.
+     */
+    CommunicationRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        records: BaseEntity[];
+        viewParams: RunViewParams | null;
+    }>;
+    /**
+     * Emitted when duplicate search functionality is requested.
+     * Parent components should handle this to show the duplicate search results.
+     */
+    DuplicateSearchRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        records: BaseEntity[];
+    }>;
+    /**
+     * Emitted when the Add to List button is clicked.
+     * Parent components should handle this to show the list management dialog.
+     */
+    AddToListRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        records: BaseEntity[];
+        recordIds: string[];
+    }>;
+    /**
+     * Emitted when entity actions need to be loaded.
+     * Parent components should load actions and set the EntityActions input.
+     */
+    LoadEntityActionsRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+    }>;
+    /**
+     * Emitted when an entity action is selected for execution.
+     * Parent components should handle the action execution.
+     */
+    EntityActionRequested: EventEmitter<{
+        entityInfo: EntityInfo;
+        action: EntityActionConfig;
+        selectedRecords: BaseEntity[];
+    }>;
+    gridContainer: ElementRef<HTMLDivElement>;
+    /** AG Grid column definitions */
+    agColumnDefs: ColDef[];
+    /** AG Grid row data */
+    rowData: Record<string, unknown>[];
+    /** AG Grid API reference */
+    private gridApi;
+    /** AG Grid theme (v34+) with custom selection colors */
+    agGridTheme: import("ag-grid-community").Theme<import("ag-grid-community").ThemeDefaultParams>;
+    /** AG Grid row selection configuration */
+    agRowSelection: RowSelectionOptions;
+    /** Default column settings */
+    defaultColDef: ColDef;
+    /** Get row ID function for AG Grid */
+    getRowId: (params: GetRowIdParams<Record<string, unknown>>) => string;
+    /** Suppress sort changed events during programmatic updates */
+    private suppressSortEvents;
+    /** AG Grid options for infinite scroll mode */
+    gridOptions: GridOptions;
+    /** Datasource for infinite scroll mode */
+    private infiniteDatasource;
+    private _useExternalData;
+    private _allData;
+    private _rowDataMap;
+    private _entityInfo;
+    private _viewEntity;
+    private _columnStates;
+    private _sortState;
+    private _filterState;
+    private _editingRowKey;
+    private _editingField;
+    private _pendingChanges;
+    /**
+     * The loaded view entity if using a stored view (ViewID, ViewName, or ViewEntity in Params).
+     * Null for dynamic views or when using legacy entityName input.
+     */
+    get ViewEntity(): UserViewEntityExtended | null;
+    /**
+     * The entity metadata for the current data source.
+     * Available after Params is set and data is loaded.
+     */
+    get EntityInfo(): EntityInfo | null;
+    /**
+     * True if using a dynamic view (EntityName only) rather than a stored view.
+     * False if using ViewID, ViewName, ViewEntity in Params, or viewEntity input.
+     */
+    get IsDynamicView(): boolean;
+    loading: boolean;
+    errorMessage: string;
+    totalRowCount: number;
+    private _loadDataPromise;
+    private destroy$;
+    private refreshSubject;
+    private statesSaveSubject;
+    private statePersistSubject;
+    private userDefaultsPersistSubject;
+    private pendingStateToSave;
+    private isSavingState;
+    /**
+     * Pending state waiting to be persisted (for flushing on destroy).
+     * Tracks state for both saved views and user defaults separately.
+     */
+    private _pendingViewStateToPersist;
+    private _pendingUserDefaultsToPersist;
+    /**
+     * Flag to suppress state persistence during view transitions.
+     * When true, emitGridStateChanged will not trigger persistence.
+     * This prevents the old view's column state from being saved to the new view.
+     */
+    private _suppressPersist;
+    /**
+     * Dirty flag to track if grid state has actually been modified by user actions.
+     * Only set to true when: column resize, column move, or sort change.
+     * Reset to false: when view loads, after successful persistence.
+     * This prevents emitting gridStateChanged events when no real change occurred.
+     */
+    private _isGridStateDirty;
+    /**
+     * Whether the current user can edit the view.
+     * For dynamic views, always true (persists to user settings).
+     * For saved views, depends on view ownership and permissions.
+     */
+    get canEditCurrentView(): boolean;
+    showOverflowMenu: boolean;
+    showExportDialog: boolean;
+    exportDialogConfig: ExportDialogConfig | null;
+    constructor(cdr: ChangeDetectorRef, elementRef: ElementRef, exportService: ExportService);
+    ngOnInit(): Promise<void>;
+    ngOnDestroy(): void;
+    /**
+     * Immediately persists any pending state changes without waiting for debounce.
+     * Called on component destroy to ensure changes aren't lost.
+     */
+    private flushPendingPersistence;
+    private setupRefreshDebounce;
+    private setupStatePersistDebounce;
+    private setupUserDefaultsPersistDebounce;
+    /**
+     * Called when Params input changes. Handles loading view entity metadata
+     * and triggering data load if allowed.
+     */
+    private onParamsChanged;
+    /**
+     * Gets a view from the UserViewEngine cache by ID.
+     * Returns undefined if not found or engine not initialized.
+     */
+    private getViewFromEngine;
+    /**
+     * Gets a view from the UserViewEngine cache by name.
+     * Returns undefined if not found or engine not initialized.
+     */
+    private getViewFromEngineByName;
+    /**
+     * Loads user's saved grid state defaults for a dynamic view.
+     * Uses UserInfoEngine to retrieve settings stored with key format: "default-view-setting/{entityName}"
+     */
+    private loadUserDefaultGridState;
+    /**
+     * Persists the current grid state as user defaults for a dynamic view.
+     * Uses UserInfoEngine to store settings with key format: "default-view-setting/{entityName}"
+     */
+    private persistUserDefaultGridState;
+    /**
+     * Applies settings from a loaded ViewEntity (column configuration, sort state, etc.)
+     *
+     * Precedence rules (highest to lowest):
+     * 1. Props passed directly (gridState, orderBy, etc.) - always take precedence
+     * 2. Settings from ViewEntity.GridState (persisted column/sort configuration)
+     * 3. Settings from ViewEntity.SortInfo (legacy sort configuration)
+     * 4. Auto-generated defaults from entity metadata
+     */
+    private applyViewEntitySettings;
+    private onGridStateChanged;
+    private onFilterTextChanged;
+    private generateColumnsFromMetadata;
+    private shouldShowField;
+    private estimateColumnWidth;
+    private mapFieldTypeToGridType;
+    private initializeColumnStates;
+    private buildAgColumnDefs;
+    private buildAgColumnDefsFromGridState;
+    private mapColumnConfigToColDef;
+    private generateAgColumnDefs;
+    private applyFieldFormatter;
+    /**
+     * Helper to wrap content with an inline style span
+     */
+    private wrapWithStyle;
+    /**
+     * Build a CSS style string from a ColumnTextStyle object
+     */
+    private buildCssStyle;
+    /**
+     * Build a style object for AG Grid from a ColumnTextStyle object
+     */
+    private buildStyleObject;
+    /**
+     * Format a value using custom ColumnFormat settings
+     */
+    private formatValueWithCustomFormat;
+    private formatCustomNumber;
+    private formatCustomCurrency;
+    private formatCustomPercent;
+    private formatCustomDate;
+    private formatCustomBoolean;
+    private updateAgRowSelection;
+    loadData(isAutoRefresh?: boolean): Promise<void>;
+    /**
+     * Internal method that performs the actual data loading.
+     * Called by loadData() which handles promise deduplication.
+     */
+    private executeLoadData;
+    /**
+     * Builds RunViewParams from the Params input.
+     * Requires Params to be set - the grid needs a data source configured.
+     */
+    private buildRunViewParams;
+    private buildOrderByClause;
+    /**
+     * Creates and returns an AG Grid IDatasource for infinite scroll mode.
+     * This datasource fetches data in pages from the server as the user scrolls.
+     */
+    private createInfiniteDatasource;
+    /**
+     * Converts a BaseEntity to AG Grid row data format.
+     * This is used by both client and infinite scroll modes for consistent data formatting.
+     */
+    private entityToRowData;
+    /**
+     * Sets up the grid for infinite scroll mode.
+     * Called when PaginationMode is 'infinite'.
+     */
+    private setupInfiniteScroll;
+    /**
+     * Refreshes the infinite scroll cache.
+     * Call this when data source parameters change.
+     */
+    private refreshInfiniteCache;
+    private processData;
+    private getRowKey;
+    private computeRowClasses;
+    onGridReady(event: GridReadyEvent): void;
+    /**
+     * Smart column auto-sizing that respects our width estimates
+     * while ensuring the grid fills available space appropriately
+     */
+    private autoSizeColumnsSmartly;
+    onAgRowClicked(event: RowClickedEvent): void;
+    onAgRowDoubleClicked(event: RowDoubleClickedEvent): void;
+    /**
+     * Emits a navigation request for the given entity record.
+     */
+    private emitNavigationRequest;
+    onAgSortChanged(event: AgSortChangedEvent): void;
+    onAgSelectionChanged(event: SelectionChangedEvent): void;
+    onAgColumnResized(event: ColumnResizedEvent): void;
+    onAgColumnMoved(event: ColumnMovedEvent): void;
+    private emitGridStateChanged;
+    /**
+     * Persists the grid state to the UserView entity.
+     * Only saves if the user has edit permission on the view.
+     */
+    private persistGridStateToView;
+    private buildCurrentGridState;
+    private applySortStateToGrid;
+    private updateSelection;
+    private updateRowSelectionState;
+    SelectRows(keys: string[], additive?: boolean): void;
+    DeselectRows(keys: string[]): void;
+    SelectAll(): void;
+    ClearSelection(): void;
+    GetSelectedRows(): BaseEntity[];
+    IsRowSelected(key: string): boolean;
+    /**
+     * Scrolls the grid to make the specified row visible.
+     * @param key The primary key of the row to scroll to
+     * @param position Where to position the row: 'top', 'middle', or 'bottom'
+     */
+    EnsureRowVisible(key: string, position?: 'top' | 'middle' | 'bottom'): void;
+    Refresh(): Promise<void>;
+    Clear(): void;
+    GetData(): BaseEntity[];
+    GetRowByKey(key: string): BaseEntity | undefined;
+    GetRowByIndex(index: number): BaseEntity | undefined;
+    GetState(): GridState;
+    SetState(state: GridState): void;
+    ResetState(): void;
+    private scheduleStateSave;
+    private loadPersistedState;
+    onAddClick(): void;
+    onDeleteClick(): void;
+    onExportClick(): void;
+    /**
+     * Shows the export dialog for the current grid data
+     */
+    private showExportDialogForCurrentData;
+    /**
+     * Handle export dialog close
+     */
+    onExportDialogClosed(result: ExportDialogResult): void;
+    /**
+     * Export grid data directly without showing dialog.
+     * Use this for programmatic export with specific options.
+     * @param options Export options (format, sampling, etc.)
+     * @param download If true, automatically downloads the file. Default true.
+     * @returns Export result with data buffer and metadata
+     */
+    Export(options?: Partial<ExportOptions>, download?: boolean): Promise<ExportResult>;
+    /**
+     * Export to Excel format directly (convenience method)
+     * @param download If true, automatically downloads the file. Default true.
+     */
+    ExportToExcel(download?: boolean): Promise<ExportResult>;
+    /**
+     * Export to CSV format directly (convenience method)
+     * @param download If true, automatically downloads the file. Default true.
+     */
+    ExportToCSV(download?: boolean): Promise<ExportResult>;
+    /**
+     * Export to JSON format directly (convenience method)
+     * @param download If true, automatically downloads the file. Default true.
+     */
+    ExportToJSON(download?: boolean): Promise<ExportResult>;
+    /**
+     * Get the current grid data formatted for export
+     */
+    private getExportData;
+    /**
+     * Get column definitions for export based on current grid columns
+     */
+    private getExportColumns;
+    /**
+     * Map MemberJunction field types to export column types
+     */
+    private mapFieldTypeToExportType;
+    /**
+     * Generate default file name for export
+     */
+    private getDefaultExportFileName;
+    onRefreshClick(): void;
+    onCompareClick(): void;
+    onMergeClick(): void;
+    onAddToListClick(): void;
+    onDuplicateSearchClick(): void;
+    onCommunicationClick(): void;
+    onColumnChooserClick(): void;
+    /**
+     * Handles entity action click from the overflow menu
+     */
+    onEntityActionClick(action: EntityActionConfig): void;
+    /**
+     * Checks if an entity action is currently enabled based on selection requirements
+     */
+    isEntityActionEnabled(action: EntityActionConfig): boolean;
+    toggleOverflowMenu(): void;
+    closeOverflowMenu(): void;
+    private handleOutsideClick;
+    get hasOverflowMenuItems(): boolean;
+    get showExportInOverflow(): boolean;
+    get showColumnChooserInOverflow(): boolean;
+    get hasSelectionDependentOverflowActions(): boolean;
+    get showCommunicationInOverflow(): boolean;
+    get HasSelection(): boolean;
+    get HasMultipleSelection(): boolean;
+    get gridContainerClasses(): string[];
+    /**
+     * Apply visual configuration by setting CSS custom properties
+     */
+    private applyVisualConfig;
+    get gridHeightStyle(): string;
+    isButtonVisible(button: GridToolbarButton): boolean;
+    isButtonDisabled(button: GridToolbarButton): boolean;
+    onToolbarButtonClick(button: GridToolbarButton): void;
+    get VisibleRows(): GridRowData[];
+    get VisibleColumnStates(): ColumnRuntimeState[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<EntityDataGridComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EntityDataGridComponent, "mj-entity-data-grid", never, { "Params": { "alias": "Params"; "required": false; }; "AllowLoad": { "alias": "AllowLoad"; "required": false; }; "AutoRefreshOnParamsChange": { "alias": "AutoRefreshOnParamsChange"; "required": false; }; "PaginationMode": { "alias": "PaginationMode"; "required": false; }; "PageSize": { "alias": "PageSize"; "required": false; }; "CacheBlockSize": { "alias": "CacheBlockSize"; "required": false; }; "MaxBlocksInCache": { "alias": "MaxBlocksInCache"; "required": false; }; "Data": { "alias": "Data"; "required": false; }; "Columns": { "alias": "Columns"; "required": false; }; "GridState": { "alias": "GridState"; "required": false; }; "AllowColumnReorder": { "alias": "AllowColumnReorder"; "required": false; }; "AllowColumnResize": { "alias": "AllowColumnResize"; "required": false; }; "AllowColumnToggle": { "alias": "AllowColumnToggle"; "required": false; }; "ShowHeader": { "alias": "ShowHeader"; "required": false; }; "AllowSorting": { "alias": "AllowSorting"; "required": false; }; "AllowMultiSort": { "alias": "AllowMultiSort"; "required": false; }; "ServerSideSorting": { "alias": "ServerSideSorting"; "required": false; }; "AllowColumnFilters": { "alias": "AllowColumnFilters"; "required": false; }; "ShowSearch": { "alias": "ShowSearch"; "required": false; }; "SelectionMode": { "alias": "SelectionMode"; "required": false; }; "SelectedKeys": { "alias": "SelectedKeys"; "required": false; }; "KeyField": { "alias": "KeyField"; "required": false; }; "EditMode": { "alias": "EditMode"; "required": false; }; "AllowAdd": { "alias": "AllowAdd"; "required": false; }; "AllowDelete": { "alias": "AllowDelete"; "required": false; }; "Height": { "alias": "Height"; "required": false; }; "RowHeight": { "alias": "RowHeight"; "required": false; }; "VirtualScroll": { "alias": "VirtualScroll"; "required": false; }; "ShowRowNumbers": { "alias": "ShowRowNumbers"; "required": false; }; "Striped": { "alias": "Striped"; "required": false; }; "GridLines": { "alias": "GridLines"; "required": false; }; "VisualConfig": { "alias": "VisualConfig"; "required": false; }; "ShowToolbar": { "alias": "ShowToolbar"; "required": false; }; "ToolbarConfig": { "alias": "ToolbarConfig"; "required": false; }; "StateKey": { "alias": "StateKey"; "required": false; }; "AutoPersistState": { "alias": "AutoPersistState"; "required": false; }; "StatePersistDebounce": { "alias": "StatePersistDebounce"; "required": false; }; "RefreshDebounce": { "alias": "RefreshDebounce"; "required": false; }; "FilterText": { "alias": "FilterText"; "required": false; }; "ShowNewButton": { "alias": "ShowNewButton"; "required": false; }; "ShowRefreshButton": { "alias": "ShowRefreshButton"; "required": false; }; "ShowExportButton": { "alias": "ShowExportButton"; "required": false; }; "ShowDeleteButton": { "alias": "ShowDeleteButton"; "required": false; }; "ShowCompareButton": { "alias": "ShowCompareButton"; "required": false; }; "ShowMergeButton": { "alias": "ShowMergeButton"; "required": false; }; "ShowAddToListButton": { "alias": "ShowAddToListButton"; "required": false; }; "ShowDuplicateSearchButton": { "alias": "ShowDuplicateSearchButton"; "required": false; }; "ShowCommunicationButton": { "alias": "ShowCommunicationButton"; "required": false; }; "AutoNavigate": { "alias": "AutoNavigate"; "required": false; }; "NavigateOnDoubleClick": { "alias": "NavigateOnDoubleClick"; "required": false; }; "CreateRecordMode": { "alias": "CreateRecordMode"; "required": false; }; "NewRecordValues": { "alias": "NewRecordValues"; "required": false; }; "ShowEntityActionButtons": { "alias": "ShowEntityActionButtons"; "required": false; }; "EntityActions": { "alias": "EntityActions"; "required": false; }; }, { "BeforeRowSelect": "BeforeRowSelect"; "AfterRowSelect": "AfterRowSelect"; "BeforeRowDeselect": "BeforeRowDeselect"; "AfterRowDeselect": "AfterRowDeselect"; "SelectionChange": "SelectionChange"; "BeforeRowClick": "BeforeRowClick"; "AfterRowClick": "AfterRowClick"; "BeforeRowDoubleClick": "BeforeRowDoubleClick"; "AfterRowDoubleClick": "AfterRowDoubleClick"; "BeforeCellEdit": "BeforeCellEdit"; "AfterCellEditBegin": "AfterCellEditBegin"; "BeforeCellEditCommit": "BeforeCellEditCommit"; "AfterCellEditCommit": "AfterCellEditCommit"; "BeforeCellEditCancel": "BeforeCellEditCancel"; "AfterCellEditCancel": "AfterCellEditCancel"; "BeforeRowSave": "BeforeRowSave"; "AfterRowSave": "AfterRowSave"; "BeforeRowDelete": "BeforeRowDelete"; "AfterRowDelete": "AfterRowDelete"; "BeforeDataLoad": "BeforeDataLoad"; "AfterDataLoad": "AfterDataLoad"; "BeforeDataRefresh": "BeforeDataRefresh"; "AfterDataRefresh": "AfterDataRefresh"; "BeforeSort": "BeforeSort"; "AfterSort": "AfterSort"; "BeforeColumnReorder": "BeforeColumnReorder"; "AfterColumnReorder": "AfterColumnReorder"; "BeforeColumnResize": "BeforeColumnResize"; "AfterColumnResize": "AfterColumnResize"; "BeforeColumnVisibilityChange": "BeforeColumnVisibilityChange"; "AfterColumnVisibilityChange": "AfterColumnVisibilityChange"; "GridStateChanged": "GridStateChanged"; "AddRequested": "AddRequested"; "DeleteRequested": "DeleteRequested"; "ExportRequested": "ExportRequested"; "NewButtonClick": "NewButtonClick"; "RefreshButtonClick": "RefreshButtonClick"; "ExportButtonClick": "ExportButtonClick"; "DeleteButtonClick": "DeleteButtonClick"; "CompareButtonClick": "CompareButtonClick"; "MergeButtonClick": "MergeButtonClick"; "AddToListButtonClick": "AddToListButtonClick"; "DuplicateSearchButtonClick": "DuplicateSearchButtonClick"; "CommunicationButtonClick": "CommunicationButtonClick"; "NavigationRequested": "NavigationRequested"; "NewRecordDialogRequested": "NewRecordDialogRequested"; "NewRecordTabRequested": "NewRecordTabRequested"; "CompareRecordsRequested": "CompareRecordsRequested"; "MergeRecordsRequested": "MergeRecordsRequested"; "CommunicationRequested": "CommunicationRequested"; "DuplicateSearchRequested": "DuplicateSearchRequested"; "AddToListRequested": "AddToListRequested"; "LoadEntityActionsRequested": "LoadEntityActionsRequested"; "EntityActionRequested": "EntityActionRequested"; }, never, never, false, never>;
+}
+//# sourceMappingURL=entity-data-grid.component.d.ts.map