@adaptabletools/adaptable-cjs 22.0.0-canary.6 → 22.0.0-canary.8

package/src/agGrid/AdaptableAgGrid.js

@@ -10,6 +10,7 @@ const DocumentationLinkConstants_1 = require("../Utilities/Constants/Documentati
 const StringExtensions_1 = tslib_1.__importDefault(require("../Utilities/Extensions/StringExtensions"));
 const Emitter_1 = tslib_1.__importDefault(require("../Utilities/Emitter"));
 const DefaultAdaptableOptions_1 = require("../AdaptableOptions/DefaultAdaptableOptions");
+const resolveContainerElement_1 = require("../Utilities/resolveContainerElement");
 const AgGridAdapter_1 = require("./AgGridAdapter");
 const GeneralConstants = tslib_1.__importStar(require("../Utilities/Constants/GeneralConstants"));
 const GeneralConstants_1 = require("../Utilities/Constants/GeneralConstants");
@@ -225,6 +226,8 @@ class AdaptableAgGrid {
      * Temporary, these are MIGRATION technical debts, and should be removed as soon as possible
      */
     adaptableStatusPanelKeys = [];
+    adaptableStatusPanelDefs = [];
+    hasAdaptableStatusBar;
     // see #no_additional_react_root
     _PRIVATE_adaptableJSXElement;
     _prevLayout;
@@ -363,7 +366,7 @@ class AdaptableAgGrid {
         this.adaptableOptions = this.normalizeAdaptableOptions(this.adaptableOptions);
         const { showLoadingScreen, loadingScreenDelay, loadingScreenText, loadingScreenTitle } = this.adaptableOptions.userInterfaceOptions.loadingScreenOptions;
         if (showLoadingScreen) {
-            this.logger.info(`Show Loading Screen`);
+            this.logger.info('Showing loading screen');
             // it's important to use ensureLoadingScreenPortalElement
             // and not ensurePortalElement, because multiple adaptable instances share the same portal element
             // so when displaying the second one, the react root associated to the portal element
@@ -379,7 +382,7 @@ class AdaptableAgGrid {
                 }), portalElement);
             }
             else {
-                this.logger.consoleError(`Adaptable failed to show the loading screen!`);
+                this.logger.consoleError('Failed to create loading screen portal element.');
             }
         }
         this.forPlugins((plugin) => plugin.afterInitOptions(this, this.adaptableOptions));
@@ -438,7 +441,7 @@ class AdaptableAgGrid {
         // see #map_dateString_to_date
         this.agGridAdapter.patchColDefs(columnDefs, (colDef) => {
             if (colDef.cellDataType === 'dateString') {
-                this.logger.consoleError(`AG Grid: Column '${colDef.colId}' specifies cellDataType='dateString' which is no longer supported. It has been automatically replaced with cellDataType='date'. Please update your column definition.`);
+                this.logger.consoleError(`Column "${colDef.colId}" uses cellDataType="dateString" which is no longer supported. It has been replaced with cellDataType="date". Please update your column definition.`);
                 colDef.cellDataType = 'date';
             }
         });
@@ -469,8 +472,8 @@ class AdaptableAgGrid {
         const agGridApi = await this.initializeAgGrid(gridOptions, config.modules, config.renderAgGridFrameworkComponent);
         if (agGridApi === false) {
             this.midwayDestroy();
-            this.logger.consoleError(`Adaptable failed to initialize AG Grid!`);
-            return Promise.reject('Adaptable failed to initialize AG Grid!');
+            this.logger.consoleError('Failed to initialize AG Grid.');
+            return Promise.reject('Failed to initialize AG Grid.');
         }
         this.layoutManager = new src_1.LayoutManager({
             gridApi: agGridApi,
@@ -495,7 +498,7 @@ class AdaptableAgGrid {
         this.layoutManager.onColumnDefsChanged(() => {
             this.updateColumnModelAndRefreshGrid();
         });
-        this.logger.info(`Hide Loading Screen`);
+        this.logger.info('Hiding loading screen');
         this.unmountLoadingScreen?.();
         perfInitAgGrid.end();
         initAgGridMarker.end();
@@ -506,7 +509,7 @@ class AdaptableAgGrid {
         this.lifecycleState = 'agGridReady';
         this.api.entitlementApi.internalApi.setModulesAgGridDepsInfos();
         this.ModuleService.logMissingAgGridDepsInfos();
-        this.logger.info(`Registered AG Grid modules (incl. dependent modules): `, this.agGridModulesAdapter.getAgGridRegisteredModuleNames().sort());
+        this.logger.info('Registered AG Grid modules (including dependents):', this.agGridModulesAdapter.getAgGridRegisteredModuleNames().sort());
         /**
          * At this point AG Grid is initialized!
          */
@@ -596,10 +599,7 @@ class AdaptableAgGrid {
         const layoutState = state.Layout;
         // ensure that at least one Layout has been provided
         if (!layoutState || !layoutState.Layouts?.length) {
-            this.logger
-                .consoleError(`You have not defined any Layout in your InitialState.Layout.Layouts[] state!
-
-You need to define at least one Layout!`);
+            this.logger.consoleError('No Layouts defined in InitialState.Layout.Layouts[]. At least one Layout is required.');
         }
         // ensure CurrentLayout is valid
         if (!layoutState.CurrentLayout ||
@@ -762,21 +762,90 @@ You need to define at least one Layout!`);
     hideQuickFilter() {
         this.agGridAdapter.getAgGridApi().setGridOption('floatingFiltersHeight', 0);
     }
+    showAdaptableToolPanel() {
+        if (!this.hasAdaptableToolPanel) {
+            // don't re-add the ToolPanel if it's hidden by entitlement
+            if (this.api.entitlementApi.isModuleHiddenEntitlement('ToolPanel')) {
+                return;
+            }
+            const currentSideBar = this.agGridAdapter.getGridOption('sideBar');
+            if (currentSideBar?.toolPanels) {
+                const updatedSideBar = {
+                    ...currentSideBar,
+                    toolPanels: [...currentSideBar.toolPanels, this.buildAdaptableToolPanelDef()],
+                };
+                this.agGridAdapter.setGridOption('sideBar', updatedSideBar);
+                this.hasAdaptableToolPanel = true;
+            }
+        }
+    }
+    hideAdaptableToolPanel() {
+        if (this.hasAdaptableToolPanel) {
+            // close the tool panel if it's currently open
+            this.api.toolPanelApi.closeAdapTableToolPanel();
+            const currentSideBar = this.agGridAdapter.getGridOption('sideBar');
+            if (currentSideBar?.toolPanels) {
+                const updatedSideBar = {
+                    ...currentSideBar,
+                    toolPanels: currentSideBar.toolPanels.filter((toolPanelDef) => {
+                        if (typeof toolPanelDef === 'string') {
+                            return toolPanelDef !== GeneralConstants.ADAPTABLE_TOOLPANEL_ID;
+                        }
+                        return toolPanelDef.id !== GeneralConstants.ADAPTABLE_TOOLPANEL_ID;
+                    }),
+                };
+                this.agGridAdapter.setGridOption('sideBar', updatedSideBar);
+            }
+            this.hasAdaptableToolPanel = false;
+        }
+    }
+    buildAdaptableToolPanelDef() {
+        return {
+            id: GeneralConstants.ADAPTABLE_TOOLPANEL_ID,
+            toolPanel: GeneralConstants.ADAPTABLE_TOOLPANEL_COMPONENT,
+            labelDefault: GeneralConstants.ADAPTABLE,
+            labelKey: 'adaptable',
+            iconKey: 'menu',
+            width: UIHelper_1.default.getAdaptableToolPanelWidth(),
+            minWidth: UIHelper_1.default.getAdaptableToolPanelWidth(),
+        };
+    }
+    showAdaptableStatusBar() {
+        if (!this.hasAdaptableStatusBar && this.adaptableStatusPanelDefs.length > 0) {
+            const currentStatusBar = this.agGridAdapter.getGridOption('statusBar');
+            if (currentStatusBar) {
+                // filter out any Adaptable panels that may already exist to avoid duplicates
+                const existingNonAdaptablePanels = (currentStatusBar.statusPanels ?? []).filter((panel) => !this.adaptableStatusPanelKeys.includes(panel.key));
+                const updatedStatusBar = {
+                    ...currentStatusBar,
+                    statusPanels: [...existingNonAdaptablePanels, ...this.adaptableStatusPanelDefs],
+                };
+                this.agGridAdapter.setGridOption('statusBar', updatedStatusBar);
+                this.hasAdaptableStatusBar = true;
+            }
+        }
+    }
+    hideAdaptableStatusBar() {
+        if (this.hasAdaptableStatusBar) {
+            const currentStatusBar = this.agGridAdapter.getGridOption('statusBar');
+            if (currentStatusBar?.statusPanels) {
+                const updatedStatusBar = {
+                    ...currentStatusBar,
+                    statusPanels: currentStatusBar.statusPanels.filter((panel) => !this.adaptableStatusPanelKeys.includes(panel.key)),
+                };
+                this.agGridAdapter.setGridOption('statusBar', updatedStatusBar);
+            }
+            this.hasAdaptableStatusBar = false;
+        }
+    }
     normalizeAdaptableOptions(adaptableOptions) {
         if (this.hasAutogeneratedPrimaryKey) {
-            this.logger
-                .warn(`Autogenerated primary key (adaptableOptions.autogeneratedPrimaryKey = TRUE) should be used only as a last resort,
-      when no unique column is available, as it limits some Adaptable functionalities!
-
-      For more details see: ${DocumentationLinkConstants_1.PrimaryKeyDocsLink}`);
+            this.logger.warn(`Autogenerated primary key is enabled (adaptableOptions.autogeneratedPrimaryKey = true). This should be a last resort as it limits some Adaptable features. See: ${DocumentationLinkConstants_1.PrimaryKeyDocsLink}`);
             this.adaptableOptions.primaryKey = GeneralConstants_1.AUTOGENERATED_PK_COLUMN;
             return this.adaptableOptions;
         }
         if (StringExtensions_1.default.IsNullOrEmpty(adaptableOptions.primaryKey)) {
-            this.logger.consoleError(`AdaptableOptions.primaryKey is required and cannot be empty or null!
-      As a fallback, you can set adaptableOptions.autogeneratedPrimaryKey = TRUE
-
-      For more details see: ${DocumentationLinkConstants_1.PrimaryKeyDocsLink}`);
+            this.logger.consoleError(`adaptableOptions.primaryKey is required and must not be empty. As a fallback, set adaptableOptions.autogeneratedPrimaryKey = true. See: ${DocumentationLinkConstants_1.PrimaryKeyDocsLink}`);
         }
         return adaptableOptions;
     }
@@ -808,7 +877,7 @@ You need to define at least one Layout!`);
          */
         this.agGridOptionsService.setGridOptionsProperty(gridOptions, 'defaultColDef', (original_defaultColDef) => {
             if (original_defaultColDef?.headerValueGetter) {
-                this.logger.warn(`defaultColDef.headerValueGetter and overrides the Adaptable custom header mechanism! We recommend using a ColumnOptions.columnHeader instead!`);
+                this.logger.warn('defaultColDef.headerValueGetter overrides the Adaptable header mechanism. Consider using ColumnOptions.columnHeader instead.');
                 return original_defaultColDef;
             }
             // #customize_header
@@ -825,7 +894,7 @@ You need to define at least one Layout!`);
          */
         this.agGridOptionsService.setGridOptionsProperty(gridOptions, 'defaultColGroupDef', (original_defaultColGroupDef) => {
             if (original_defaultColGroupDef?.headerValueGetter) {
-                this.logger.warn(`defaultColGroupDef.headerValueGetter and overrides the Adaptable custom header mechanism! We recommend using a ColumnOptions.tableColumnHeader instead!`);
+                this.logger.warn('defaultColGroupDef.headerValueGetter overrides the Adaptable header mechanism. Consider using ColumnOptions.tableColumnHeader instead.');
                 return original_defaultColGroupDef;
             }
             const defaultColGroupDef = { ...original_defaultColGroupDef };
@@ -845,12 +914,11 @@ You need to define at least one Layout!`);
             }
             if (original_autoGroupColumnDef?.filter === false) {
                 // if user disables filter on autoGroupColumnDef, we respect that
-                this.logger.info(`autoGroupColumnDef.filter is disabled as per user configuration.`);
+                this.logger.info('autoGroupColumnDef.filter is disabled via user configuration.');
                 return original_autoGroupColumnDef;
             }
             if (typeof original_autoGroupColumnDef?.filter === 'object') {
-                this.logger.consoleWarn(`autoGroupColumnDef.filter is set and overrides the Adaptable custom filter mechanism, so Adaptable will not be able to manage filtering for the Group Column!
-                      Please contact the Adaptable Support Team for further assistance and investigation.`);
+                this.logger.consoleWarn('autoGroupColumnDef.filter overrides the Adaptable filtering mechanism for the Group Column. Adaptable-managed filters will not apply to this column. Contact support for alternatives.');
                 return original_autoGroupColumnDef;
             }
             const autoGroupColumnDef = { ...original_autoGroupColumnDef };
@@ -858,8 +926,7 @@ You need to define at least one Layout!`);
             // !! DO NOT REMOVE THIS !!
             // see https://github.com/ag-grid/ag-grid/blob/6f43ff257c2e285068eb425b655e58d6eeb89816/packages/ag-grid-enterprise/src/rowHierarchy/autoColService.ts#L225
             autoGroupColumnDef.filterValueGetter = (params) => {
-                this.logger.consoleWarn(`An unexpected invocation of autoGroupColumnDef.filterValueGetter was detected. This execution path is not expected under normal operation.
-                      Please contact the Adaptable Support Team for further assistance and investigation.`, params);
+                this.logger.consoleWarn('Unexpected invocation of autoGroupColumnDef.filterValueGetter. This is not expected under normal operation. Please contact support.', params);
                 return '';
             };
             // !! it is important that we always return the same component / handler instances
@@ -1173,16 +1240,7 @@ You need to define at least one Layout!`);
                     return original_sideBar;
                 }
                 const isAdaptableToolPanelHidden = this.api.entitlementApi.isModuleHiddenEntitlement('ToolPanel');
-                const adaptableToolPanelDef = {
-                    id: GeneralConstants.ADAPTABLE_TOOLPANEL_ID,
-                    toolPanel: GeneralConstants.ADAPTABLE_TOOLPANEL_COMPONENT,
-                    labelDefault: GeneralConstants.ADAPTABLE,
-                    labelKey: 'adaptable',
-                    iconKey: 'menu',
-                    width: UIHelper_1.default.getAdaptableToolPanelWidth(),
-                    minWidth: UIHelper_1.default.getAdaptableToolPanelWidth(),
-                    // maxWidth = undefined,
-                };
+                const adaptableToolPanelDef = this.buildAdaptableToolPanelDef();
                 const mapToolPanelDefs = (toolPanelDefs = []) => {
                     // if it's an alias for the adaptable tool panel, map it to a ToolPanelDef, otherwise return it as it is
                     return toolPanelDefs.map((toolPanelDef) => toolPanelDef === GeneralConstants.ADAPTABLE_TOOLPANEL_ID
@@ -1257,19 +1315,29 @@ You need to define at least one Layout!`);
             this.agGridOptionsService.setGridOptionsProperty(gridOptions, 'statusBar', (original_statusBar) => {
                 const statusPanels = (original_statusBar?.statusPanels ?? [])?.map((statusPanel) => {
                     if (statusPanel.statusPanel === StatusBarState_1.ADAPTABLE_STATUS_PANEL) {
+                        if (!statusPanel.key) {
+                            this.logger.consoleWarn('AdaptableStatusPanel is missing a "key" property. This panel will not be managed by HideAdaptableUI. Please provide a unique key.');
+                            return statusPanel;
+                        }
                         this.adaptableStatusPanelKeys.push(statusPanel.key);
                         const context = {
                             Key: statusPanel.key,
                         };
-                        return {
+                        const adaptablePanelDef = {
                             ...statusPanel,
                             statusPanel: (0, createAgStatusPanelComponent_1.createAgStatusPanelComponent)(AdaptableStatusBar_1.AdaptableStatusBar, this, context),
                         };
+                        this.adaptableStatusPanelDefs.push(adaptablePanelDef);
+                        return adaptablePanelDef;
                     }
                     return statusPanel;
                 });
                 return { ...original_statusBar, statusPanels };
             });
+            this.hasAdaptableStatusBar = this.adaptableStatusPanelKeys.length > 0;
+        }
+        else {
+            this.hasAdaptableStatusBar = false;
         }
         /**
          * `getRowStyle`
@@ -1429,15 +1497,14 @@ You need to define at least one Layout!`);
             const rowData = agGridApi.getGridOption('rowData');
             this.initWithLazyData = rowData == undefined || rowData.length === 0;
             if (this.initWithLazyData) {
-                this.logger.info('initWithLazyData = TRUE');
+                this.logger.info('Initializing with lazy data (no initial rowData).');
             }
             if (!this.getAgGridContainerElement()) {
                 // initialize the agGridContainerElement from the AgGrid instance
                 const gridRoot = this.agGridAdapter.getAgGridRootElement();
                 const gridContainer = gridRoot?.closest('[class*="ag-theme"]');
                 if (!gridContainer) {
-                    this.logger.consoleError(`No AG Grid container could be derived from the Adaptable framework wrapper.
-            Please contact AdapTable Support and in the meantime provide a valid container element in 'ContainerOptions.agGridContainer'!`);
+                    this.logger.consoleError('Failed to derive AG Grid container from the framework wrapper. Please provide a valid container element via ContainerOptions.agGridContainer.');
                 }
                 this.DANGER_USE_GETTER_agGridContainerElement = gridContainer;
             }
@@ -1445,7 +1512,7 @@ You need to define at least one Layout!`);
         }
         const agGridContainer = this.getAgGridContainerElement();
         if (!agGridContainer) {
-            this.logger.consoleError('No AG Grid container element found in the DOM. Please provide a valid container element in `ContainerOptions.agGridContainer`');
+            this.logger.consoleError('AG Grid container element not found in the DOM. Please provide a valid element via ContainerOptions.agGridContainer.');
             return Promise.resolve(false);
         }
         let gridParams;
@@ -1458,21 +1525,22 @@ You need to define at least one Layout!`);
     useRowNodeLookUp() {
         return this.agGridAdapter.getAgGridApi().getGridOption('getRowId') != undefined;
     }
+    buildInitContainerContext() {
+        return {
+            adaptableId: this.adaptableOptions?.adaptableId ?? '',
+            adaptableStateKey: this.adaptableOptions?.adaptableStateKey ?? '',
+            adaptableContext: this.adaptableOptions?.adaptableContext,
+        };
+    }
     getAgGridContainerElement() {
         if (!this.DANGER_USE_GETTER_agGridContainerElement) {
-            this.DANGER_USE_GETTER_agGridContainerElement =
-                typeof this.adaptableOptions?.containerOptions?.agGridContainer === 'string'
-                    ? document.getElementById(this.adaptableOptions?.containerOptions?.agGridContainer)
-                    : this.adaptableOptions?.containerOptions?.agGridContainer;
+            this.DANGER_USE_GETTER_agGridContainerElement = (0, resolveContainerElement_1.resolveContainerElement)(this.adaptableOptions?.containerOptions?.agGridContainer, this.buildInitContainerContext());
         }
         return this.DANGER_USE_GETTER_agGridContainerElement;
     }
     getAdaptableContainerElement() {
         if (!this.DANGER_USE_GETTER_adaptableContainerElement) {
-            this.DANGER_USE_GETTER_adaptableContainerElement =
-                typeof this.adaptableOptions?.containerOptions?.adaptableContainer === 'string'
-                    ? document.getElementById(this.adaptableOptions?.containerOptions?.adaptableContainer)
-                    : this.adaptableOptions?.containerOptions?.adaptableContainer;
+            this.DANGER_USE_GETTER_adaptableContainerElement = (0, resolveContainerElement_1.resolveContainerElement)(this.adaptableOptions?.containerOptions?.adaptableContainer, this.buildInitContainerContext());
         }
         return this.DANGER_USE_GETTER_adaptableContainerElement;
     }
@@ -1860,7 +1928,7 @@ You need to define at least one Layout!`);
             // if no primary key column then lets check the first row to see if its a data item
             const primaryKeyDataItem = this.getFirstRowNode()?.data[primaryKey];
             if (!primaryKeyDataItem) {
-                errorMessage = `The Primary Key '${this.adaptableOptions.primaryKey}' does not exist.  This will affect many functions in AdapTable.`;
+                errorMessage = `Primary key column "${this.adaptableOptions.primaryKey}" not found. This will affect many Adaptable features.`;
                 if (this.adaptableOptions.alertOptions.showMissingPrimaryKeyAlert) {
                     // show an alert if that is the option
                     this.api.alertApi.showAlertError('No Primary Key', errorMessage);
@@ -1917,12 +1985,12 @@ You need to define at least one Layout!`);
     checkShouldClearExistingFiltersOrSearches() {
         // if they have selected to clear Filters on startup then do it
         if (this.adaptableOptions.filterOptions.clearFiltersOnStartUp) {
-            this.logger.warn('Clearing any saved Filters as "clearFiltersOnStartUp" is true');
+            this.logger.warn('Clearing saved filters (clearFiltersOnStartUp is enabled).');
             this.api.filterApi.clearAllFilters();
         }
         // if they have selected to clear searches on startup then do it
         if (this.adaptableOptions.quickSearchOptions.clearQuickSearchOnStartUp) {
-            this.logger.warn('Clearing any saved Searches as "clearQuickSearchOnStartUp" is true');
+            this.logger.warn('Clearing saved Quick Search (clearQuickSearchOnStartUp is enabled).');
             this.api.quickSearchApi.clearQuickSearch();
         }
     }
@@ -2151,7 +2219,7 @@ You need to define at least one Layout!`);
         }
     }
     _updateColumnModelAndRefreshGridNow() {
-        this.logger.info(`Updating Column Model and Refreshing Grid.`);
+        this.logger.info('Updating column model and refreshing grid.');
         this.deriveAdaptableColumnStateFromAgGrid();
         this.agGridColumnAdapter.setupColumns();
         this.redrawBody();
@@ -2177,7 +2245,7 @@ You need to define at least one Layout!`);
             this.agGridAdapter.getAgGridApi().redrawRows(redrawRowsParams);
         }
         catch (ex) {
-            this.logger.consoleError('AG Grid redrawRows was unable to find some row nodes. Tried to redraw row nodes: ', rowNodes, ex);
+            this.logger.consoleError('AG Grid redrawRows failed to locate some row nodes.', rowNodes, ex);
         }
     }
     redrawRow(rowNode) {
@@ -2471,31 +2539,31 @@ You need to define at least one Layout!`);
             });
         }
     }
-    async manageGridRows(dataRows, config = {}) {
+    async manageGridRows(dataRowConfig, dataUpdateConfig = {}) {
         const result = {
             addedRows: [],
             updatedRows: [],
             removedRows: [],
         };
-        if (!dataRows) {
+        if (!dataRowConfig || !dataRowConfig.dataRows) {
             return result;
         }
-        const addDataRows = dataRows.add;
-        const updateDataRows = dataRows.update;
-        const removeDataRows = dataRows.delete;
+        const addDataRows = dataRowConfig.dataRows.add;
+        const updateDataRows = dataRowConfig.dataRows.update;
+        const removeDataRows = dataRowConfig.dataRows.delete;
         if (this.hasAutogeneratedPrimaryKey) {
             this.addSyntheticPrimaryKeyIfMissing(addDataRows);
         }
-        if (config.runAsync) {
+        if (dataUpdateConfig.runAsync) {
             return new Promise((resolve) => {
                 this.applyAgGridTransactionAsync({
                     update: updateDataRows,
                     add: addDataRows,
                     remove: removeDataRows,
-                    addIndex: config.addIndex,
+                    addIndex: dataUpdateConfig.addIndex,
                 }, (transaction) => {
-                    if (typeof config.callback === 'function') {
-                        config.callback(transaction);
+                    if (typeof dataUpdateConfig.callback === 'function') {
+                        dataUpdateConfig.callback(transaction);
                     }
                     if (transaction?.add) {
                         this.updateRowGroupsAndColumnGroupsExpandedState();
@@ -2506,7 +2574,7 @@ You need to define at least one Layout!`);
                         removedRows: transaction?.remove,
                     });
                 });
-                if (config.flushAsync) {
+                if (dataUpdateConfig.flushAsync) {
                     this.agGridAdapter.getAgGridApi().flushAsyncTransactions();
                 }
             });
@@ -2516,12 +2584,12 @@ You need to define at least one Layout!`);
                 update: updateDataRows,
                 add: addDataRows,
                 remove: removeDataRows,
-                addIndex: config.addIndex,
+                addIndex: dataUpdateConfig.addIndex,
             });
             if (transaction?.add) {
                 this.updateRowGroupsAndColumnGroupsExpandedState();
             }
-            if (config.flushAsync) {
+            if (dataUpdateConfig.flushAsync) {
                 this.agGridAdapter.getAgGridApi().flushAsyncTransactions();
             }
             return Promise.resolve({
@@ -2587,14 +2655,14 @@ You need to define at least one Layout!`);
     }
     autoSizeColumns(columnIds) {
         if (!this.agGridModulesAdapter.isAgGridModuleRegistered('ColumnAutoSizeModule')) {
-            this.logger.consoleError(`Could not auto-size columns [${columnIds}] - missing required AG Grid module 'ColumnAutoSizeModule'`);
+            this.logger.consoleError(`Auto-sizing columns [${columnIds}] requires the AG Grid "ColumnAutoSizeModule". Please register this module.`);
             return;
         }
         this.layoutManager.autoSizeColumns(columnIds);
     }
     autoSizeAllColumns() {
         if (!this.agGridModulesAdapter.isAgGridModuleRegistered('ColumnAutoSizeModule')) {
-            this.logger.consoleError(`Could not auto-size all columns - missing required AG Grid module 'ColumnAutoSizeModule'`);
+            this.logger.consoleError('Auto-sizing all columns requires the AG Grid "ColumnAutoSizeModule". Please register this module.');
             return;
         }
         const agGridApi = this.agGridAdapter.getAgGridApi();
@@ -2752,7 +2820,7 @@ You need to define at least one Layout!`);
                 customInFilterValuesResult = await customInFilterValues(customInFilterValuesContext);
             }
             catch (error) {
-                this.logger.consoleError(`Failed to fetch custom filter values`, column, error);
+                this.logger.consoleError('Failed to retrieve custom filter values.', column, error);
             }
             return customInFilterValuesResult;
         }
@@ -2792,7 +2860,7 @@ You need to define at least one Layout!`);
                     customDistinctValues = await customEditColumnValues(customEditValuesContext);
                 }
                 catch (error) {
-                    this.logger.consoleError(`Failed to fetch custom edit values`, column, error);
+                    this.logger.consoleError('Failed to retrieve custom edit values.', column, error);
                 }
                 return customDistinctValues ?? [];
             }
@@ -3247,7 +3315,7 @@ You need to define at least one Layout!`);
         if (this.getAgGridRowModelType() !== 'clientSide') {
             // only in client-side row model can we loop through filtered&sorted rows
             // see https://www.ag-grid.com/javascript-data-grid/accessing-data/#iterating-rows
-            this.logger.warn('`forAllVisibleRowNodesDo()` is only supported in client-side row model. `forAllRowNodesDo` will be used instead.');
+            this.logger.warn('forAllVisibleRowNodesDo() is only supported with client-side row model. Falling back to forAllRowNodesDo().');
             return this.forAllRowNodesDo(func, config);
         }
         this.agGridAdapter.getAgGridApi().forEachNodeAfterFilterAndSort((rowNode, rowIndex) => {
@@ -3299,14 +3367,14 @@ You need to define at least one Layout!`);
     }
     selectNode(rowNode, clearSelection) {
         if (!rowNode) {
-            this.logger.error('No node to select');
+            this.logger.error('Cannot select: row node is null.');
             return;
         }
         rowNode.setSelected(true, clearSelection);
     }
     deSelectNode(rowNode, clearSelection) {
         if (!rowNode) {
-            this.logger.error('No node to deselect');
+            this.logger.error('Cannot deselect: row node is null.');
             return;
         }
         rowNode.setSelected(false, clearSelection);
@@ -3394,7 +3462,7 @@ You need to define at least one Layout!`);
     }
     showChart(chartDefinition, container) {
         if (!this.isReady) {
-            this.logger.consoleError('Adaptable must be instantiated before calling showChart');
+            this.logger.consoleError('Cannot call showChart before Adaptable is fully initialized.');
             return null;
         }
         /**
@@ -3415,7 +3483,7 @@ You need to define at least one Layout!`);
     }
     updateChart(chart) {
         if (!chart.Model) {
-            this.logger.consoleError(`Chart definition must have a Model property to be updated: ${chart.Name}`);
+            this.logger.consoleError(`Cannot update chart "${chart.Name}": the chart definition is missing the required Model property.`);
             return;
         }
         const upgradableProperties = {
@@ -3441,7 +3509,7 @@ You need to define at least one Layout!`);
     }
     getChartModels() {
         if (!this.isReady) {
-            this.logger.consoleError('Adaptable must be instantiated before calling getChartModels');
+            this.logger.consoleError('Cannot call getChartModels before Adaptable is fully initialized.');
             return [];
         }
         return this.agGridAdapter.getAgGridApi().getChartModels();
@@ -3475,7 +3543,7 @@ You need to define at least one Layout!`);
     }
     setAgGridQuickSearch(searchText) {
         if (!this.agGridModulesAdapter.isAgGridModuleRegistered('QuickFilterModule')) {
-            this.logger.consoleError(`Can NOT set Quick Search text - missing required AG Grid module 'QuickFilterModule'`);
+            this.logger.consoleError('Quick Search requires the AG Grid "QuickFilterModule". Please register this module to enable Quick Search.');
             return;
         }
         this.agGridAdapter.setGridOption('quickFilterText', searchText);
@@ -3485,7 +3553,7 @@ You need to define at least one Layout!`);
     }
     setAgGridFindSearchValue(searchText) {
         if (!this.agGridModulesAdapter.isAgGridModuleRegistered('FindModule')) {
-            this.logger.consoleError(`Can NOT set Find Search text - missing required AG Grid module 'FindModule'`);
+            this.logger.consoleError('Find Search requires the AG Grid "FindModule". Please register this module to enable Find Search.');
             return;
         }
         this.agGridAdapter.setGridOption('findSearchValue', searchText);
@@ -4014,7 +4082,7 @@ You need to define at least one Layout!`);
         cellDataChangedInfos.forEach((cellDataChangedInfo) => {
             // if a Cell Data Change is undone, log to the Console
             if (cellDataChangedInfo.trigger === 'undo') {
-                this.logger.info(`Undo data change: PK(${cellDataChangedInfo.primaryKeyValue}) Col(${cellDataChangedInfo.column}) RevertedValue(${cellDataChangedInfo.oldValue}) OriginalValue(${cellDataChangedInfo.newValue})`);
+                this.logger.info(`Data change reverted: column="${cellDataChangedInfo.column}", primaryKey="${cellDataChangedInfo.primaryKeyValue}", from=${cellDataChangedInfo.newValue} to=${cellDataChangedInfo.oldValue}`);
             }
             // For Changes except Aggregations, reset cell selection if required
             if (cellDataChangedInfo.trigger === 'edit' ||
@@ -4219,7 +4287,7 @@ You need to define at least one Layout!`);
         this.api.layoutApi.createOrUpdateLayout(layout);
     }
     refreshAdaptableAfterLayoutChange(layout) {
-        this.logger.info('refreshAdaptableAfterLayoutChange()');
+        this.logger.info('Refreshing Adaptable after layout change.');
         const prevLayoutForRefresh = this.__prevLayoutForRefresh || this.api.layoutApi.getCurrentLayout();
         // see #on-regroup-expect-group-column-to-be-recomputed-and-setup-properly
         const rowGroupsChanged = this.isRowGroupDifferentInLayout(prevLayoutForRefresh, layout);
@@ -4265,7 +4333,7 @@ You need to define at least one Layout!`);
                 .forEach((colType) => {
                 const newValidCellDataType = (0, VersionUpgrade20_1.mapOldTypeToDataType)(colType);
                 if (newValidCellDataType) {
-                    this.logger.consoleWarn(`Column ${columnDefinition.colId ?? columnDefinition.field} has a type of ${colType} which is no longer in use${newValidCellDataType !== 'unknown' ? `. Please use 'colDef.cellDataType' instead: ${newValidCellDataType}` : ''}`);
+                    this.logger.consoleWarn(`Column "${columnDefinition.colId ?? columnDefinition.field}" uses deprecated type "${colType}"${newValidCellDataType !== 'unknown' ? `. Use colDef.cellDataType="${newValidCellDataType}" instead.` : '. This type is no longer supported.'}`);
                 }
             });
         });

package/src/agGrid/AgGridAdapter.js

@@ -149,7 +149,7 @@ class AgGridAdapter {
                     }
                 }
                 options['columnDefs'] = colDefsWithSpecialColumns;
-                self.logger.info(`Added SpecialColumns on GridOptions.columnDefs update (source=${source})`);
+                self.logger.info(`Added special columns on GridOptions.columnDefs update (source="${source}").`);
             }
             // `context`
             const passedContext = options.context;
@@ -169,7 +169,7 @@ class AgGridAdapter {
         }
         const agGridColumnFilterService = this.DANGER_getPrivateAgGridBeans()?.colFilter;
         if (!agGridColumnFilterService) {
-            this.logger.consoleError('Could not get hold of ColumnFilterService! This is a critical error and will prevent Adaptable from working correctly.');
+            this.logger.consoleError('Failed to initialize ColumnFilterService. Filtering and related features will not function correctly.');
             return;
         }
         const self = this;
@@ -215,7 +215,7 @@ class AgGridAdapter {
     DANGER_getPrivateAgGridBeans() {
         const beans = DANGER_AG_GRID_BEANS_MAP[this._agGridId];
         if (!beans) {
-            this.logger.consoleError('Could not get hold of AgGridBeans! This is a critical error and will prevent Adaptable from working correctly.');
+            this.logger.consoleError('Failed to access AG Grid internal beans. Adaptable will not function correctly.');
         }
         return beans;
     }
@@ -359,7 +359,7 @@ class AgGridAdapter {
                     if (isEndRowPin) {
                         shouldIncludeRange = false;
                     }
-                    this.logger.consoleWarn('Cannot select pinned rows in AG Grid.');
+                    this.logger.consoleWarn('Pinned rows cannot be selected in AG Grid.');
                 }
                 if (shouldIncludeRange) {
                     const y1 = Math.min(rangeSelection.startRow.rowIndex, rangeSelection.endRow.rowIndex);
@@ -529,7 +529,7 @@ class AgGridAdapter {
     deriveAdaptableColumnDataType(agColumn, logWarning = true) {
         // Some columns can have no ID or Title. we return string as a consequence but it needs testing
         if (!agColumn) {
-            this.logger.warn(`Column is undefined, returning 'text' for Type`);
+            this.logger.warn('Column is undefined. Defaulting data type to "text".');
             return 'text';
         }
         if (this.adaptableApi.columnApi.isAutoRowGroupColumnForSingle(agColumn.getId())) {
@@ -572,7 +572,7 @@ class AgGridAdapter {
         let row = this.getAgGridApi().getDisplayedRowAtIndex(0);
         if (row == null) {
             // possible that there will be no data.
-            this.logger.consoleError(`No data in grid, returning type "unknown" for Column: "${agColumn.getColId()}". This will impact several Adaptable features, such as Filters and ColumnFormats.`);
+            this.logger.consoleError(`No data in grid. Returning type "unknown" for column "${agColumn.getColId()}". This will affect features such as Filters and Column Formats.`);
             return 'unknown';
         }
         // // if it's a group we need the content of the group
@@ -614,7 +614,7 @@ class AgGridAdapter {
                 dataType = arrayDataType;
             }
         }
-        this.logger.consoleWarn(`No defined type for column '${agColumn.getColId()}'. Defaulting to type of first row value: ${dataType}`);
+        this.logger.consoleWarn(`No explicit type for column "${agColumn.getColId()}". Inferred type from first row value: "${dataType}".`);
         return dataType;
     }
     isColumnReadonly(colDef) {
@@ -800,7 +800,7 @@ class AgGridAdapter {
                 colDef.colId = colDef.field;
             }
             if (!colDef.colId) {
-                this.logger.warn('A column is missing the colId - please check ', colDef, 'Either pass a "field" property or a "colId" property.');
+                this.logger.warn('Column definition is missing colId. Provide either a "field" or "colId" property.', colDef);
             }
         };
         this.patchColDefs(colDefs, assignColId);