@sankhyalabs/ezui 6.0.1 → 6.1.0-dev.1

package/dist/esm/ez-grid.entry.js

@@ -1,12 +1,12 @@
-import { h, r as registerInstance, c as createEvent, H as Host, g as getElement } from './index-5a720e56.js';
-import { Action, DataUnit, ObjectUtils as ObjectUtils$1, HTMLBuilder, ApplicationContext, StringUtils as StringUtils$1, UserInterface, LockManager, LockManagerOperation, NumberUtils as NumberUtils$1, MaskFormatter, DataType, SortMode, ElementIDUtils, ColumnFilterManager as ColumnFilterManager$1, DateUtils as DateUtils$1, ArrayUtils as ArrayUtils$1, FieldComparator, JSUtils, OverflowWatcher, OVERFLOWED_CLASS_NAME, KeyboardManager } from '@sankhyalabs/core';
+import { h, r as registerInstance, c as createEvent, H as Host, g as getElement } from './index-baa5e267.js';
+import { Action, DataUnit, ObjectUtils as ObjectUtils$1, UserInterface, HTMLBuilder, ApplicationContext, StringUtils as StringUtils$1, LockManager, LockManagerOperation, DataType, NumberUtils as NumberUtils$1, MaskFormatter, SortMode, ElementIDUtils, ColumnFilterManager as ColumnFilterManager$1, DateUtils as DateUtils$1, ArrayUtils as ArrayUtils$1, FieldComparator, JSUtils, OverflowWatcher, OVERFLOWED_CLASS_NAME, KeyboardManager } from '@sankhyalabs/core';
 import { SelectionMode } from '@sankhyalabs/core/dist/dataunit/DataUnit';
 import { A as ApplicationUtils } from './ApplicationUtils-eaf91331.js';
 import './DialogType-54a62731.js';
 import './CheckMode-bdb2ec19.js';
-import { C as CustomEditorSource, a as CustomRenderSource } from './ICustomRender-875b5a40.js';
-import { D as DISTINCT_FILTER_NAME_PREFIX, E as EZ_GRID_LOADING_SOURCE } from './constants-4e0d35b7.js';
-import { b as buildFieldMetadata, R as RecordValidationProcessor, D as DataBinder } from './DataBinder-9c877244.js';
+import { C as CustomEditorSource, a as CustomRenderSource } from './FormLayout-071d324c.js';
+import { b as buildFieldMetadata, R as RecordValidationProcessor, D as DataBinder, S as SHORTCUT_SEARCH_FIELD, f as focusOnFieldSerch, c as SEARCH_FIELD_FULL_WIDTH, d as LABEL_SEARCH_COLUMN, a as buildFieldSearch } from './search-column-e609d513.js';
+import { D as DISTINCT_FILTER_NAME_PREFIX, E as EZ_GRID_LOADING_SOURCE, P as PRESENTATION_COL_ID_PROP_NAME, a as PRESENTATION_FROM_COL_PROP_NAME } from './constants-b036528f.js';
 import { F as FocusResolver } from './FocusResolver-1ccbf850.js';
 
 /**
@@ -432,6 +432,7 @@ function removeAllReferences(obj, objectName) {
         // leave all basic types - this is needed for GridAPI to leave the "destroyed: boolean" attribute alone
         if (typeof value === 'function') {
             var func = function () {
+                console.warn("AG Grid: " + objectName + " function " + key + "() cannot be called as the grid has been destroyed.\n                     Please don't call grid API functions on destroyed grids - as a matter of fact you shouldn't\n                     be keeping the API reference, your application has a memory leak! Remove the API reference\n                     when the grid is destroyed.");
             };
             properties[key] = { value: func, writable: true };
         }
@@ -602,6 +603,9 @@ function waitUntil(condition, callback, timeout, timeoutMessage) {
                 window.clearInterval(interval);
                 interval = null;
             }
+            if (reachedTimeout && timeoutMessage) {
+                console.warn(timeoutMessage);
+            }
         }
     };
     internalCallback();
@@ -703,9 +707,14 @@ var Context = /** @class */ (function () {
     Context.prototype.createBeanWrapper = function (BeanClass) {
         var metaData = BeanClass.__agBeanMetaData;
         if (!metaData) {
+            var beanName = void 0;
             if (BeanClass.prototype.constructor) {
-                getFunctionName(BeanClass.prototype.constructor);
+                beanName = getFunctionName(BeanClass.prototype.constructor);
+            }
+            else {
+                beanName = "" + BeanClass;
             }
+            console.error("Context item " + beanName + " is not a bean");
             return;
         }
         var beanEntry = {
@@ -777,6 +786,7 @@ var Context = /** @class */ (function () {
         return beansList;
     };
     Context.prototype.lookupBeanInstance = function (wiringBean, beanName, optional) {
+        if (optional === void 0) { optional = false; }
         if (beanName === "context") {
             return this;
         }
@@ -787,6 +797,9 @@ var Context = /** @class */ (function () {
         if (beanEntry) {
             return beanEntry.beanInstance;
         }
+        if (!optional) {
+            console.error("AG Grid: unable to find bean reference " + beanName + " while initialising " + wiringBean);
+        }
         return null;
     };
     Context.prototype.callLifeCycleMethods = function (beanInstances, lifeCycleMethod) {
@@ -893,9 +906,11 @@ function Optional(name) {
 }
 function autowiredFunc(target, name, optional, classPrototype, methodOrAttributeName, index) {
     if (name === null) {
+        console.error("AG Grid: Autowired name should not be null");
         return;
     }
     if (typeof index === "number") {
+        console.error("AG Grid: Autowired should be on an attribute");
         return;
     }
     // it's an attribute on the class
@@ -1227,6 +1242,8 @@ var ModuleRegistry = /** @class */ (function () {
         else {
             if (ModuleRegistry.moduleBased !== moduleBased) {
                 doOnce(function () {
+                    console.warn("AG Grid: You are mixing modules (i.e. @ag-grid-community/core) and packages (ag-grid-community) - you can only use one or the other of these mechanisms.");
+                    console.warn('Please see https://www.ag-grid.com/javascript-grid/packages-modules/ for more information.');
                 }, 'ModulePackageCheck');
             }
         }
@@ -1244,7 +1261,15 @@ var ModuleRegistry = /** @class */ (function () {
             return true;
         }
         var warningKey = reason + moduleName;
+        var warningMessage;
+        if (ModuleRegistry.moduleBased) {
+            warningMessage = "AG Grid: unable to use " + reason + " as module " + moduleName + " is not present. Please see: https://www.ag-grid.com/javascript-grid/modules/";
+        }
+        else {
+            warningMessage = "AG Grid: unable to use " + reason + " as package 'ag-grid-enterprise' is not present. Please see: https://www.ag-grid.com/javascript-grid/packages/";
+        }
         doOnce(function () {
+            console.warn(warningMessage);
         }, warningKey);
         return false;
     };
@@ -1437,9 +1462,11 @@ var Column = /** @class */ (function () {
         var colDefAny = this.colDef;
         function warnOnce(msg, key, obj) {
             doOnce(function () {
-                if (obj) ;
+                if (obj) {
+                    console.warn(msg, obj);
+                }
                 else {
-                    doOnce(function () { return (void 0); }, key);
+                    doOnce(function () { return console.warn(msg); }, key);
                 }
             }, key);
         }
@@ -1907,16 +1934,19 @@ var Column = /** @class */ (function () {
     // this used to be needed, as previous version of ag-grid had lockPosition as column state,
     // so couldn't depend on colDef version.
     Column.prototype.isLockPosition = function () {
+        console.warn('AG Grid: since v21, col.isLockPosition() should not be used, please use col.getColDef().lockPosition instead.');
         return this.colDef ? !!this.colDef.lockPosition : false;
     };
     // this used to be needed, as previous version of ag-grid had lockVisible as column state,
     // so couldn't depend on colDef version.
     Column.prototype.isLockVisible = function () {
+        console.warn('AG Grid: since v21, col.isLockVisible() should not be used, please use col.getColDef().lockVisible instead.');
         return this.colDef ? !!this.colDef.lockVisible : false;
     };
     // this used to be needed, as previous version of ag-grid had lockPinned as column state,
     // so couldn't depend on colDef version.
     Column.prototype.isLockPinned = function () {
+        console.warn('AG Grid: since v21, col.isLockPinned() should not be used, please use col.getColDef().lockPinned instead.');
         return this.colDef ? !!this.colDef.lockPinned : false;
     };
     // + renderedHeaderCell - for making header cell transparent when moving
@@ -2312,6 +2342,7 @@ var ColumnGroup = /** @class */ (function () {
     };
     /** @deprecated getOriginalColumnGroup is deprecated, use getOriginalColumnGroup. */
     ColumnGroup.prototype.getOriginalColumnGroup = function () {
+        console.warn('AG Grid: columnGroup.getOriginalColumnGroup() is deprecated due to a method rename, use columnGroup.getProvidedColumnGroup() instead');
         return this.getProvidedColumnGroup();
     };
     ColumnGroup.prototype.getPaddingLevel = function () {
@@ -3187,7 +3218,9 @@ var ColumnFactory = /** @class */ (function (_super) {
         var typeKeys = [];
         if (type instanceof Array) {
             var invalidArray = type.some(function (a) { return typeof a !== 'string'; });
-            if (invalidArray) ;
+            if (invalidArray) {
+                console.warn("AG Grid: if colDef.type is supplied an array it should be of type 'string[]'");
+            }
             else {
                 typeKeys = type;
             }
@@ -3196,13 +3229,16 @@ var ColumnFactory = /** @class */ (function (_super) {
             typeKeys = type.split(',');
         }
         else {
+            console.warn("AG Grid: colDef.type should be of type 'string' | 'string[]'");
             return;
         }
         // merge user defined with default column types
         var allColumnTypes = Object.assign({}, DefaultColumnTypes);
         var userTypes = this.gridOptionsWrapper.getColumnTypes() || {};
         iterateObject(userTypes, function (key, value) {
-            if (key in allColumnTypes) ;
+            if (key in allColumnTypes) {
+                console.warn("AG Grid: the column type '" + key + "' is a default column type and cannot be overridden.");
+            }
             else {
                 allColumnTypes[key] = value;
             }
@@ -3212,12 +3248,34 @@ var ColumnFactory = /** @class */ (function (_super) {
             if (typeColDef) {
                 mergeDeep(colDefMerged, typeColDef, false, true);
             }
+            else {
+                console.warn("AG Grid: colDef.type '" + t + "' does not correspond to defined gridOptions.columnTypes");
+            }
         });
     };
     ColumnFactory.prototype.checkForDeprecatedItems = function (colDef) {
         if (colDef) {
             var colDefNoType = colDef; // take out the type, so we can access attributes not defined in the type
+            if (colDefNoType.group !== undefined) {
+                console.warn('AG Grid: colDef.group is invalid, please check documentation on how to do grouping as it changed in version 3');
+            }
+            if (colDefNoType.headerGroup !== undefined) {
+                console.warn('AG Grid: colDef.headerGroup is invalid, please check documentation on how to do grouping as it changed in version 3');
+            }
+            if (colDefNoType.headerGroupShow !== undefined) {
+                console.warn('AG Grid: colDef.headerGroupShow is invalid, should be columnGroupShow, please check documentation on how to do grouping as it changed in version 3');
+            }
+            if (colDefNoType.suppressRowGroup !== undefined) {
+                console.warn('AG Grid: colDef.suppressRowGroup is deprecated, please use colDef.type instead');
+            }
+            if (colDefNoType.suppressAggregation !== undefined) {
+                console.warn('AG Grid: colDef.suppressAggregation is deprecated, please use colDef.type instead');
+            }
+            if (colDefNoType.suppressRowGroup || colDefNoType.suppressAggregation) {
+                console.warn('AG Grid: colDef.suppressAggregation and colDef.suppressRowGroup are deprecated, use allowRowGroup, allowPivot and allowValue instead');
+            }
             if (colDefNoType.displayName) {
+                console.warn("AG Grid: Found displayName " + colDefNoType.displayName + ", please use headerName instead, displayName is deprecated.");
                 colDefNoType.headerName = colDefNoType.displayName;
             }
         }
@@ -4279,6 +4337,7 @@ var SideBarDefParser = /** @class */ (function () {
             toParse.forEach(function (key) {
                 var lookupResult = SideBarDefParser.DEFAULT_BY_KEY[key];
                 if (!lookupResult) {
+                    console.warn("AG Grid: the key " + key + " is not a valid key for specifying a tool panel, valid keys are: " + Object.keys(SideBarDefParser.DEFAULT_BY_KEY).join(','));
                     return;
                 }
                 comps_1.push(lookupResult);
@@ -4309,6 +4368,7 @@ var SideBarDefParser = /** @class */ (function () {
             if (typeof it === 'string') {
                 var lookupResult = SideBarDefParser.DEFAULT_BY_KEY[it];
                 if (!lookupResult) {
+                    console.warn("AG Grid: the key " + it + " is not a valid key for specifying a tool panel, valid keys are: " + Object.keys(SideBarDefParser.DEFAULT_BY_KEY).join(','));
                     return;
                 }
                 toAdd = lookupResult;
@@ -4905,6 +4965,7 @@ var GridOptionsWrapper = /** @class */ (function () {
         this.destroyed = true;
     };
     GridOptionsWrapper.prototype.init = function () {
+        var _this = this;
         if (this.gridOptions.suppressPropertyNamesCheck !== true) {
             this.checkGridOptionsProperties();
             this.checkColumnDefProperties();
@@ -4915,26 +4976,61 @@ var GridOptionsWrapper = /** @class */ (function () {
         }
         var async = this.useAsyncEvents();
         this.eventService.addGlobalListener(this.globalEventHandler.bind(this), async);
-        if (this.isGroupSelectsChildren() && this.isSuppressParentsInRowNodes()) ;
+        if (this.isGroupSelectsChildren() && this.isSuppressParentsInRowNodes()) {
+            console.warn("AG Grid: 'groupSelectsChildren' does not work with 'suppressParentsInRowNodes', this selection method needs the part in rowNode to work");
+        }
         if (this.isGroupSelectsChildren()) {
-            if (!this.isRowSelectionMulti()) ;
-            if (this.isRowModelServerSide()) ;
+            if (!this.isRowSelectionMulti()) {
+                console.warn("AG Grid: rowSelection must be 'multiple' for groupSelectsChildren to make sense");
+            }
+            if (this.isRowModelServerSide()) {
+                console.warn('AG Grid: group selects children is NOT support for Server Side Row Model. ' +
+                    'This is because the rows are lazy loaded, so selecting a group is not possible as' +
+                    'the grid has no way of knowing what the children are.');
+            }
+        }
+        if (this.isGroupRemoveSingleChildren() && this.isGroupHideOpenParents()) {
+            console.warn("AG Grid: groupRemoveSingleChildren and groupHideOpenParents do not work with each other, you need to pick one. And don't ask us how to use these together on our support forum either, you will get the same answer!");
         }
-        if (this.isGroupRemoveSingleChildren() && this.isGroupHideOpenParents()) ;
         if (this.isRowModelServerSide()) {
-            if (exists(this.gridOptions.groupDefaultExpanded)) ;
-            if (exists(this.gridOptions.groupDefaultExpanded)) ;
-            if (exists(this.gridOptions.groupDefaultExpanded)) ;
+            var msg = function (prop) { return "AG Grid: '" + prop + "' is not supported on the Server-Side Row Model"; };
+            if (exists(this.gridOptions.groupDefaultExpanded)) {
+                console.warn(msg('groupDefaultExpanded'));
+            }
+            if (exists(this.gridOptions.groupDefaultExpanded)) {
+                console.warn(msg('groupIncludeFooter'));
+            }
+            if (exists(this.gridOptions.groupDefaultExpanded)) {
+                console.warn(msg('groupIncludeTotalFooter'));
+            }
         }
         if (isTrue(this.gridOptions.enableRangeSelection)) {
             ModuleRegistry.assertRegistered(ModuleNames.RangeSelectionModule, 'enableRangeSelection');
         }
-        else if (this.isEnableRangeHandle() || this.isEnableFillHandle()) ;
+        else if (this.isEnableRangeHandle() || this.isEnableFillHandle()) {
+            console.warn("AG Grid: 'enableRangeHandle' or 'enableFillHandle' will not work unless 'enableRangeSelection' is set to true");
+        }
         if (this.isGroupRowsSticky()) {
-            if (this.isGroupHideOpenParents()) ;
-            if (this.isMasterDetail()) ;
-            if (this.isPagination()) ;
+            if (this.isGroupHideOpenParents()) {
+                console.warn("AG Grid: groupRowsSticky and groupHideOpenParents do not work with each other, you need to pick one.");
+            }
+            if (this.isMasterDetail()) {
+                console.warn("AG Grid: groupRowsSticky and masterDetail do not work with each other, you need to pick one.");
+            }
+            if (this.isPagination()) {
+                console.warn("AG Grid: groupRowsSticky and pagination do not work with each other, you need to pick one.");
+            }
         }
+        var warnOfDeprecaredIcon = function (name) {
+            if (_this.gridOptions.icons && _this.gridOptions.icons[name]) {
+                console.warn("gridOptions.icons." + name + " is no longer supported. For information on how to style checkboxes and radio buttons, see https://www.ag-grid.com/javascript-grid-icons/");
+            }
+        };
+        warnOfDeprecaredIcon('radioButtonOff');
+        warnOfDeprecaredIcon('radioButtonOn');
+        warnOfDeprecaredIcon('checkboxChecked');
+        warnOfDeprecaredIcon('checkboxUnchecked');
+        warnOfDeprecaredIcon('checkboxIndeterminate');
         // sets an initial calculation for the scrollbar width
         this.getScrollbarWidth();
     };
@@ -4958,7 +5054,11 @@ var GridOptionsWrapper = /** @class */ (function () {
     GridOptionsWrapper.prototype.checkProperties = function (userProperties, validPropertiesAndExceptions, validProperties, containerName, docsUrl) {
         var invalidProperties = fuzzyCheckStrings(userProperties, validPropertiesAndExceptions, validProperties);
         iterateObject(invalidProperties, function (key, value) {
+            console.warn("ag-grid: invalid " + containerName + " property '" + key + "' did you mean any of these: " + value.slice(0, 8).join(", "));
         });
+        if (Object.keys(invalidProperties).length > 0) {
+            console.warn("ag-grid: to see all the valid " + containerName + " properties please check: " + docsUrl);
+        }
     };
     /**
     * Wrap the user callback and attach the api, columnApi and context to the params object on the way through.
@@ -5217,7 +5317,7 @@ var GridOptionsWrapper = /** @class */ (function () {
         ];
         if (validLayouts.indexOf(domLayout) === -1) {
             doOnce(function () {
-                return (void 0);
+                return console.warn("AG Grid: " + domLayout + " is not valid for DOM Layout, valid values are " + Constants.DOM_LAYOUT_NORMAL + ", " + Constants.DOM_LAYOUT_AUTO_HEIGHT + " and " + Constants.DOM_LAYOUT_PRINT);
             }, 'warn about dom layout values');
             return Constants.DOM_LAYOUT_NORMAL;
         }
@@ -5612,7 +5712,7 @@ var GridOptionsWrapper = /** @class */ (function () {
             return 'xy';
         }
         if (direction !== 'x' && direction !== 'y' && direction !== 'xy') {
-            doOnce(function () { return (void 0); }, 'warn invalid fill direction');
+            doOnce(function () { return console.warn("AG Grid: valid values for fillHandleDirection are 'x', 'y' and 'xy'. Default to 'xy'."); }, 'warn invalid fill direction');
             return 'xy';
         }
         return direction;
@@ -5711,6 +5811,7 @@ var GridOptionsWrapper = /** @class */ (function () {
     };
     GridOptionsWrapper.prototype.getDefaultExportParams = function (type) {
         if (this.gridOptions.defaultExportParams) {
+            console.warn("AG Grid: Since v25.2 `defaultExportParams`  has been replaced by `default" + capitalise(type) + "ExportParams`'");
             if (type === 'csv') {
                 return this.gridOptions.defaultExportParams;
             }
@@ -5843,7 +5944,7 @@ var GridOptionsWrapper = /** @class */ (function () {
     GridOptionsWrapper.prototype.isServerSideSortAllLevels = function () {
         var isEnabled = isTrue(this.gridOptions.serverSideSortAllLevels);
         if (!this.isRowModelServerSide() && isEnabled) {
-            doOnce(function () { return (void 0); }, 'serverSideSortAllLevels');
+            doOnce(function () { return console.warn('AG Grid: The `serverSideSortAllLevels` property can only be used with the server side row model.'); }, 'serverSideSortAllLevels');
             return false;
         }
         return isEnabled;
@@ -5851,7 +5952,7 @@ var GridOptionsWrapper = /** @class */ (function () {
     GridOptionsWrapper.prototype.isServerSideFilterAllLevels = function () {
         var isEnabled = isTrue(this.gridOptions.serverSideFilterAllLevels);
         if (!this.isRowModelServerSide() && isEnabled) {
-            doOnce(function () { return (void 0); }, 'serverSideFilterAllLevels');
+            doOnce(function () { return console.warn('AG Grid: The `serverSideFilterAllLevels` property can only be used with the server side row model.'); }, 'serverSideFilterAllLevels');
             return false;
         }
         return isEnabled;
@@ -5859,11 +5960,11 @@ var GridOptionsWrapper = /** @class */ (function () {
     GridOptionsWrapper.prototype.isServerSideSortOnServer = function () {
         var isEnabled = isTrue(this.gridOptions.serverSideSortOnServer);
         if (!this.isRowModelServerSide() && isEnabled) {
-            doOnce(function () { return (void 0); }, 'serverSideSortOnServerRowModel');
+            doOnce(function () { return console.warn('AG Grid: The `serverSideSortOnServer` property can only be used with the server side row model.'); }, 'serverSideSortOnServerRowModel');
             return false;
         }
         if (this.isTreeData() && isEnabled) {
-            doOnce(function () { return (void 0); }, 'serverSideSortOnServerTreeData');
+            doOnce(function () { return console.warn('AG Grid: The `serverSideSortOnServer` property cannot be used while using tree data.'); }, 'serverSideSortOnServerTreeData');
             return false;
         }
         return isEnabled;
@@ -5871,11 +5972,11 @@ var GridOptionsWrapper = /** @class */ (function () {
     GridOptionsWrapper.prototype.isServerSideFilterOnServer = function () {
         var isEnabled = isTrue(this.gridOptions.serverSideFilterOnServer);
         if (!this.isRowModelServerSide() && isEnabled) {
-            doOnce(function () { return (void 0); }, 'serverSideFilterOnServerRowModel');
+            doOnce(function () { return console.warn('AG Grid: The `serverSideFilterOnServer` property can only be used with the server side row model.'); }, 'serverSideFilterOnServerRowModel');
             return false;
         }
         if (this.isTreeData() && isEnabled) {
-            doOnce(function () { return (void 0); }, 'serverSideFilterOnServerTreeData');
+            doOnce(function () { return console.warn('AG Grid: The `serverSideFilterOnServer` property cannot be used while using tree data.'); }, 'serverSideFilterOnServerTreeData');
             return false;
         }
         return isEnabled;
@@ -5984,7 +6085,7 @@ var GridOptionsWrapper = /** @class */ (function () {
         var capitalisedType = capitalise(type);
         if (exists(delay)) {
             if (delay < 0) {
-                doOnce(function () { return (void 0); }, "tooltip" + capitalisedType + "DelayWarn");
+                doOnce(function () { return console.warn("ag-grid: tooltip" + capitalisedType + "Delay should not be lower than 0"); }, "tooltip" + capitalisedType + "DelayWarn");
             }
             return Math.max(200, delay);
         }
@@ -6035,7 +6136,7 @@ var GridOptionsWrapper = /** @class */ (function () {
         var rowBuffer = this.gridOptions.rowBuffer;
         if (typeof rowBuffer === 'number') {
             if (rowBuffer < 0) {
-                doOnce(function () { return (void 0); }, 'warn rowBuffer negative');
+                doOnce(function () { return console.warn("AG Grid: rowBuffer should not be negative"); }, 'warn rowBuffer negative');
                 this.gridOptions.rowBuffer = rowBuffer = 0;
             }
         }
@@ -6069,23 +6170,45 @@ var GridOptionsWrapper = /** @class */ (function () {
         // casting to generic object, so typescript compiles even though
         // we are looking for attributes that don't exist
         var options = this.gridOptions;
+        if (options.deprecatedEmbedFullWidthRows) {
+            console.warn("AG Grid: since v21.2, deprecatedEmbedFullWidthRows has been replaced with embedFullWidthRows.");
+        }
+        if (options.rowDeselection) {
+            console.warn('AG Grid: since v24.x, rowDeselection is deprecated and the behaviour is true by default. Please use `suppressRowDeselection` to prevent rows from being deselected.');
+        }
         if (options.enableMultiRowDragging) {
             options.rowDragMultiRow = true;
             delete options.enableMultiRowDragging;
+            console.warn('AG Grid: since v26.1, `enableMultiRowDragging` is deprecated. Please use `rowDragMultiRow`.');
         }
         var checkRenamedProperty = function (oldProp, newProp, version) {
             if (options[oldProp] != null) {
+                console.warn("AG Grid: since version " + version + ", '" + oldProp + "' is deprecated / renamed, please use the new property name '" + newProp + "' instead.");
                 if (options[newProp] == null) {
                     options[newProp] = options[oldProp];
                 }
             }
         };
-        checkRenamedProperty('batchUpdateWaitMillis', 'asyncTransactionWaitMillis');
-        checkRenamedProperty('deltaRowDataMode', 'immutableData');
-        checkRenamedProperty('serverSideFilteringAlwaysResets', 'serverSideFilterAllLevels');
-        checkRenamedProperty('serverSideSortingAlwaysResets', 'serverSideSortAllLevels');
-        checkRenamedProperty('suppressSetColumnStateEvents', 'suppressColumnStateEvents');
+        checkRenamedProperty('batchUpdateWaitMillis', 'asyncTransactionWaitMillis', '23.1.x');
+        checkRenamedProperty('deltaRowDataMode', 'immutableData', '23.1.x');
+        checkRenamedProperty('serverSideFilteringAlwaysResets', 'serverSideFilterAllLevels', '28.0.0');
+        checkRenamedProperty('serverSideSortingAlwaysResets', 'serverSideSortAllLevels', '28.0.0');
+        if (options.immutableColumns || options.deltaColumnMode) {
+            console.warn('AG Grid: since v24.0, immutableColumns and deltaColumnMode properties are gone. The grid now works like this as default. To keep column order maintained, set grid property applyColumnDefOrder=true');
+        }
+        checkRenamedProperty('suppressSetColumnStateEvents', 'suppressColumnStateEvents', '24.0.x');
         if (options.groupRowInnerRenderer || options.groupRowInnerRendererParams || options.groupRowInnerRendererFramework) {
+            console.warn('AG Grid: since v24.0, grid properties groupRowInnerRenderer, groupRowInnerRendererFramework and groupRowInnerRendererParams are no longer used.');
+            console.warn('  Instead use the grid properties groupRowRendererParams.innerRenderer, groupRowRendererParams.innerRendererFramework and groupRowRendererParams.innerRendererParams.');
+            console.warn('  For example instead of this:');
+            console.warn('    groupRowInnerRenderer: "myRenderer"');
+            console.warn('    groupRowInnerRendererParams: {x: a}');
+            console.warn('  Replace with this:');
+            console.warn('    groupRowRendererParams: {');
+            console.warn('      innerRenderer: "myRenderer",');
+            console.warn('      innerRendererParams: {x: a}');
+            console.warn('    }');
+            console.warn('  We have copied the properties over for you. However to stop this error message, please change your application code.');
             if (!options.groupRowRendererParams) {
                 options.groupRowRendererParams = {};
             }
@@ -6100,36 +6223,105 @@ var GridOptionsWrapper = /** @class */ (function () {
                 params.innerRendererFramework = options.groupRowInnerRendererFramework;
             }
         }
+        if (options.rememberGroupStateWhenNewData) {
+            console.warn('AG Grid: since v24.0, grid property rememberGroupStateWhenNewData is deprecated. This feature was provided before Transaction Updates worked (which keep group state). Now that transaction updates are possible and they keep group state, this feature is no longer needed.');
+        }
         if (options.detailCellRendererParams && options.detailCellRendererParams.autoHeight) {
+            console.warn('AG Grid: since v24.1, grid property detailCellRendererParams.autoHeight is replaced with grid property detailRowAutoHeight. This allows this feature to work when you provide a custom DetailCellRenderer');
             options.detailRowAutoHeight = true;
         }
+        if (options.suppressKeyboardEvent) {
+            console.warn("AG Grid: since v24.1 suppressKeyboardEvent in the gridOptions has been deprecated and will be removed in\n                 future versions of AG Grid. If you need this to be set for every column use the defaultColDef property.");
+        }
+        if (options.suppressEnterpriseResetOnNewColumns) {
+            console.warn('AG Grid: since v25, grid property suppressEnterpriseResetOnNewColumns is deprecated. This was a temporary property to allow changing columns in Server Side Row Model without triggering a reload. Now that it is possible to dynamically change columns in the grid, this is no longer needed.');
+        }
+        if (options.suppressColumnStateEvents) {
+            console.warn('AG Grid: since v25, grid property suppressColumnStateEvents no longer works due to a refactor that we did. It should be possible to achieve similar using event.source, which would be "api" if the event was due to setting column state via the API');
+        }
+        if (options.defaultExportParams) {
+            console.warn('AG Grid: since v25.2, the grid property `defaultExportParams` has been replaced by `defaultCsvExportParams` and `defaultExcelExportParams`.');
+        }
         if (options.stopEditingWhenGridLosesFocus) {
+            console.warn('AG Grid: since v25.2.2, the grid property `stopEditingWhenGridLosesFocus` has been replaced by `stopEditingWhenCellsLoseFocus`.');
             options.stopEditingWhenCellsLoseFocus = true;
         }
+        if (options.applyColumnDefOrder) {
+            console.warn('AG Grid: since v26.0, the grid property `applyColumnDefOrder` is no longer needed, as this is the default behaviour. To turn this behaviour off, set maintainColumnOrder=true');
+        }
         if (options.groupMultiAutoColumn) {
+            console.warn("AG Grid: since v26.0, the grid property `groupMultiAutoColumn` has been replaced by `groupDisplayType = 'multipleColumns'`");
             options.groupDisplayType = 'multipleColumns';
         }
         if (options.groupUseEntireRow) {
+            console.warn("AG Grid: since v26.0, the grid property `groupUseEntireRow` has been replaced by `groupDisplayType = 'groupRows'`");
             options.groupDisplayType = 'groupRows';
         }
         if (options.groupSuppressAutoColumn) {
+            var propName = options.treeData ? 'treeDataDisplayType' : 'groupDisplayType';
+            console.warn("AG Grid: since v26.0, the grid property `groupSuppressAutoColumn` has been replaced by `" + propName + " = 'custom'`");
             options.groupDisplayType = 'custom';
         }
+        if (options.defaultGroupOrderComparator) {
+            console.warn("AG Grid: since v27.2, the grid property `defaultGroupOrderComparator` is deprecated and has been replaced by `initialGroupOrderComparator` and now receives a single params object.");
+        }
         if (options.defaultGroupSortComparator) {
+            console.warn("AG Grid: since v26.0, the grid property `defaultGroupSortComparator` has been replaced by `initialGroupOrderComparator`");
             options.defaultGroupOrderComparator = options.defaultGroupSortComparator;
         }
+        if (options.groupRowAggNodes) {
+            console.warn("AG Grid: since v27.2, the grid property `groupRowAggNodes` is deprecated and has been replaced by `getGroupRowAgg` and now receives a single params object.");
+        }
+        if (options.postSort) {
+            console.warn("AG Grid: since v27.2, the grid property `postSort` is deprecated and has been replaced by `postSortRows` and now receives a single params object.");
+        }
+        if (options.isFullWidthCell) {
+            console.warn("AG Grid: since v27.2, the grid property `isFullWidthCell` is deprecated and has been replaced by `isFullWidthRow` and now receives a single params object.");
+        }
+        if (options.localeTextFunc) {
+            console.warn("AG Grid: since v27.2, the grid property `localeTextFunc` is deprecated and has been replaced by `getLocaleText` and now receives a single params object.");
+        }
+        if (options.colWidth) {
+            console.warn('AG Grid: since v26.1, the grid property `colWidth` is deprecated and should be set via `defaultColDef.width`.');
+        }
+        if (options.minColWidth) {
+            console.warn('AG Grid: since v26.1, the grid property `minColWidth` is deprecated and should be set via `defaultColDef.minWidth`.');
+        }
+        if (options.maxColWidth) {
+            console.warn('AG Grid: since v26.1, the grid property `maxColWidth` is deprecated and should be set via `defaultColDef.maxWidth`.');
+        }
+        if (options.reactUi) {
+            console.warn('AG Grid: since v27.0, React UI is on by default, so no need for reactUi=true. To turn it off, set suppressReactUi=true.');
+        }
+        if (options.suppressReactUi) {
+            console.warn('AG Grid: The legacy React rendering engine is deprecated and will be removed in the next major version of the grid.');
+        }
         if (options.suppressCellSelection) {
+            console.warn('AG Grid: since v27.0, `suppressCellSelection` has been replaced by `suppressCellFocus`.');
             options.suppressCellFocus = options.suppressCellSelection;
         }
+        if (options.getRowNodeId) {
+            console.warn('AG Grid: since v27.1, `getRowNodeId` is deprecated and has been replaced by `getRowId`. The difference: if getRowId() is implemented then immutable data is enabled by default.');
+        }
+        if (options.immutableData) {
+            if (options.getRowId) {
+                console.warn('AG Grid: since v27.1, `immutableData` is deprecated. With the `getRowId` callback implemented, immutable data is enabled by default so you can remove `immutableData=true`.');
+            }
+            else {
+                console.warn('AG Grid: since v27.1, `immutableData` is deprecated. To enable immutable data you must implement the `getRowId()` callback.');
+            }
+        }
         if (options.clipboardDeliminator) {
+            console.warn('AG Grid: since v27.1, `clipboardDeliminator` has been replaced by `clipboardDelimiter`.');
             options.clipboardDelimiter = options.clipboardDeliminator;
         }
-        checkRenamedProperty('processSecondaryColDef', 'processPivotResultColDef');
-        checkRenamedProperty('processSecondaryColGroupDef', 'processPivotResultColGroupDef');
+        checkRenamedProperty('processSecondaryColDef', 'processPivotResultColDef', '28.0.x');
+        checkRenamedProperty('processSecondaryColGroupDef', 'processPivotResultColGroupDef', '28.0.x');
         if (options.serverSideStoreType) {
+            console.warn('AG Grid: since v28.0, `serverSideStoreType` has been replaced by `serverSideInfiniteScroll`. Set to true to use Partial Store, and false to use Full Store.');
             options.serverSideInfiniteScroll = options.serverSideStoreType === 'partial';
         }
-        checkRenamedProperty('getServerSideStoreParams', 'getServerSideGroupLevelParams');
+        checkRenamedProperty('getServerSideStoreParams', 'getServerSideGroupLevelParams', '28.0.x');
     };
     GridOptionsWrapper.prototype.checkForViolations = function () {
         if (this.isTreeData()) {
@@ -6138,11 +6330,20 @@ var GridOptionsWrapper = /** @class */ (function () {
     };
     GridOptionsWrapper.prototype.treeDataViolations = function () {
         if (this.isRowModelDefault()) {
-            if (missing(this.getDataPathFunc())) ;
+            if (missing(this.getDataPathFunc())) {
+                console.warn('AG Grid: property usingTreeData=true with rowModel=clientSide, but you did not ' +
+                    'provide getDataPath function, please provide getDataPath function if using tree data.');
+            }
         }
         if (this.isRowModelServerSide()) {
-            if (missing(this.getIsServerSideGroupFunc())) ;
-            if (missing(this.getServerSideGroupKeyFunc())) ;
+            if (missing(this.getIsServerSideGroupFunc())) {
+                console.warn('AG Grid: property usingTreeData=true with rowModel=serverSide, but you did not ' +
+                    'provide isServerSideGroup function, please provide isServerSideGroup function if using tree data.');
+            }
+            if (missing(this.getServerSideGroupKeyFunc())) {
+                console.warn('AG Grid: property usingTreeData=true with rowModel=serverSide, but you did not ' +
+                    'provide getServerSideGroupKey function, please provide getServerSideGroupKey function if using tree data.');
+            }
         }
     };
     GridOptionsWrapper.prototype.getLocaleTextFunc = function () {
@@ -6211,6 +6412,7 @@ var GridOptionsWrapper = /** @class */ (function () {
             this.setRowHeightVariable(rowHeight);
             return rowHeight;
         }
+        console.warn('AG Grid row height must be a number if not using standard row model');
         return this.getDefaultRowHeight();
     };
     GridOptionsWrapper.prototype.isGetRowHeightFunction = function () {
@@ -6235,7 +6437,7 @@ var GridOptionsWrapper = /** @class */ (function () {
             var height = this.mergeGridCommonParams(this.gridOptions.getRowHeight)(params);
             if (this.isNumeric(height)) {
                 if (height === 0) {
-                    doOnce(function () { return (void 0); }, 'invalidRowHeight');
+                    doOnce(function () { return console.warn('AG Grid: The return of `getRowHeight` cannot be zero. If the intention is to hide rows, use a filter instead.'); }, 'invalidRowHeight');
                 }
                 return { height: Math.max(1, height), estimated: false };
             }
@@ -6280,6 +6482,7 @@ var GridOptionsWrapper = /** @class */ (function () {
     GridOptionsWrapper.prototype.matchesGroupDisplayType = function (toMatch, supplied) {
         var groupDisplayTypeValues = ['groupRows', 'multipleColumns', 'custom', 'singleColumn'];
         if (groupDisplayTypeValues.indexOf(supplied) < 0) {
+            console.warn("AG Grid: '" + supplied + "' is not a valid groupDisplayType value - possible values are: '" + groupDisplayTypeValues.join("', '") + "'");
             return false;
         }
         return supplied === toMatch;
@@ -6287,6 +6490,7 @@ var GridOptionsWrapper = /** @class */ (function () {
     GridOptionsWrapper.prototype.matchesTreeDataDisplayType = function (toMatch, supplied) {
         var treeDataDisplayTypeValues = ['auto', 'custom'];
         if (treeDataDisplayTypeValues.indexOf(supplied) < 0) {
+            console.warn("AG Grid: '" + supplied + "' is not a valid treeDataDisplayType value - possible values are: '" + treeDataDisplayTypeValues.join("', '") + "'");
             return false;
         }
         return supplied === toMatch;
@@ -6671,6 +6875,7 @@ var ColumnModel = /** @class */ (function (_super) {
     };
     ColumnModel.prototype.isPivotSettingAllowed = function (pivot) {
         if (pivot && this.gridOptionsWrapper.isTreeData()) {
+            console.warn("AG Grid: Pivot mode not available in conjunction Tree Data i.e. 'gridOptions.treeData: true'");
             return false;
         }
         return true;
@@ -7301,6 +7506,7 @@ var ColumnModel = /** @class */ (function (_super) {
                 if (loopCount > 1000) {
                     // this should never happen, but in the future, someone might introduce a bug here,
                     // so we stop the browser from hanging and report bug properly
+                    console.error('AG Grid: infinite loop in resizeColumnSets');
                     return "break";
                 }
                 finishedColsGrew = false;
@@ -7418,6 +7624,8 @@ var ColumnModel = /** @class */ (function (_super) {
         if (source === void 0) { source = "api"; }
         this.columnAnimationService.start();
         if (toIndex > this.gridColumns.length - columnsToMoveKeys.length) {
+            console.warn('AG Grid: tried to insert columns in invalid location, toIndex = ' + toIndex);
+            console.warn('AG Grid: remember that you should not count the moving columns when calculating the new index');
             return;
         }
         // we want to pull all the columns out first and put them into an ordered list
@@ -7670,6 +7878,7 @@ var ColumnModel = /** @class */ (function (_super) {
     ColumnModel.prototype.setColumnsPinned = function (keys, pinned, source) {
         if (source === void 0) { source = "api"; }
         if (this.gridOptionsWrapper.getDomLayout() === 'print') {
+            console.warn("Changing the column pinning status is not allowed with domLayout='print'");
             return;
         }
         this.columnAnimationService.start();
@@ -7939,6 +8148,7 @@ var ColumnModel = /** @class */ (function (_super) {
             return false;
         }
         if (params && params.state && !params.state.forEach) {
+            console.warn('AG Grid: applyColumnState() - the state attribute should be an array, however an array was not found. Please provide an array of items (one for each col you want to change) for state.');
             return false;
         }
         var applyStates = function (states, existingColumns, getById) {
@@ -8085,6 +8295,7 @@ var ColumnModel = /** @class */ (function (_super) {
         // is less sexy for the code here, but it keeps consistency.
         newOrder = this.placeLockedColumns(newOrder);
         if (!this.doesMovePassMarryChildren(newOrder)) {
+            console.warn('AG Grid: Applying column order broke a group where columns should be married together. Applying new order has been discarded.');
             return;
         }
         this.gridColumns = newOrder;
@@ -8336,7 +8547,11 @@ var ColumnModel = /** @class */ (function (_super) {
                 }
             }
             else {
-                if (exists(aggFunc)) ;
+                if (exists(aggFunc)) {
+                    console.warn('AG Grid: stateItem.aggFunc must be a string. if using your own aggregation ' +
+                        'functions, register the functions first before using them in get/set state. This is because it is ' +
+                        'intended for the column state to be stored and retrieved as simple JSON.');
+                }
                 // Note: we do not call column.setAggFunc(null), so that next time we aggregate
                 // by this column (eg drag the column to the agg section int he toolpanel) it will
                 // default to the last aggregation function.
@@ -8404,6 +8619,9 @@ var ColumnModel = /** @class */ (function (_super) {
             return null;
         }
         var column = this.getGridColumn(key);
+        if (!column) {
+            console.warn('AG Grid: could not find column ' + key);
+        }
         return column;
     };
     ColumnModel.prototype.getPrimaryColumn = function (key) {
@@ -8506,6 +8724,7 @@ var ColumnModel = /** @class */ (function (_super) {
                 // valueGetter is an expression, so execute the expression
                 return this.expressionService.evaluate(headerValueGetter, params);
             }
+            console.warn('ag-grid: headerValueGetter must be a function or a string');
             return '';
         }
         else if (colDef.headerName != null) {
@@ -8800,6 +9019,10 @@ var ColumnModel = /** @class */ (function (_super) {
         this.setColumnGroupState([{ groupId: keyAsString, open: newValue }], source);
     };
     ColumnModel.prototype.getProvidedColumnGroup = function (key) {
+        // if (key instanceof ProvidedColumnGroup) { return key; }
+        if (typeof key !== 'string') {
+            console.error('AG Grid: group key must be a string');
+        }
         // otherwise, search for the column group by id
         var res = null;
         this.columnUtils.depthFirstOriginalTreeSearch(null, this.gridBalancedTree, function (node) {
@@ -9010,7 +9233,8 @@ var ColumnModel = /** @class */ (function (_super) {
             var rowModelType = this.rowModel.getType();
             var supportedRowModel = rowModelType === Constants.ROW_MODEL_TYPE_CLIENT_SIDE || rowModelType === Constants.ROW_MODEL_TYPE_SERVER_SIDE;
             if (!supportedRowModel) {
-                doOnce(function () { return (void 0); }, 'autoHeightActive.wrongRowModel');
+                var message_1 = 'AG Grid - autoHeight columns only work with Client Side Row Model and Server Side Row Model.';
+                doOnce(function () { return console.warn(message_1); }, 'autoHeightActive.wrongRowModel');
             }
         }
     };
@@ -10002,6 +10226,7 @@ var DisplayedGroupCreator = /** @class */ (function (_super) {
         if (found) {
             return result;
         }
+        console.warn('AG Grid: could not get path');
         return null;
     };
     DisplayedGroupCreator = __decorate$36([
@@ -11685,12 +11910,14 @@ function createIconNoSpan(iconName, gridOptionsWrapper, column, forceCreate) {
         if (isNodeOrElement(rendererResult)) {
             return rendererResult;
         }
+        console.warn('AG Grid: iconRenderer should return back a string or a dom object');
     }
     else {
         var span = document.createElement('span');
         var cssClass = iconNameClassMap[iconName];
         if (!cssClass) {
             if (!forceCreate) {
+                console.warn("AG Grid: Did not find icon " + iconName);
                 cssClass = '';
             }
             else {
@@ -12129,6 +12356,7 @@ var AgPromise = /** @class */ (function () {
         this.waiters.forEach(function (waiter) { return waiter(value); });
     };
     AgPromise.prototype.onReject = function (params) {
+        console.warn('TBI');
     };
     return AgPromise;
 }());
@@ -12754,9 +12982,11 @@ function RefSelector(ref) {
 }
 function querySelectorFunc(selector, refSelector, classPrototype, methodOrAttributeName, index) {
     if (selector === null) {
+        console.error('AG Grid: QuerySelector selector should not be null');
         return;
     }
     if (typeof index === 'number') {
+        console.error('AG Grid: QuerySelector should be on an attribute');
         return;
     }
     addToObjectProps(classPrototype, 'querySelectors', {
@@ -12991,8 +13221,12 @@ var OptionsFactory = /** @class */ (function () {
         this.checkForDeprecatedParams();
     };
     OptionsFactory.prototype.checkForDeprecatedParams = function () {
-        if (this.filterOptions.some(function (opt) { return typeof opt != 'string' && opt.test != null; })) ;
-        if (this.filterOptions.some(function (opt) { return typeof opt != 'string' && opt.hideFilterInput != null; })) ;
+        if (this.filterOptions.some(function (opt) { return typeof opt != 'string' && opt.test != null; })) {
+            console.warn("AG Grid: [IFilterOptionDef] since v26.2.0, test() has been replaced with predicate().");
+        }
+        if (this.filterOptions.some(function (opt) { return typeof opt != 'string' && opt.hideFilterInput != null; })) {
+            console.warn("AG Grid: [IFilterOptionDef] since v26.2.0, useOfHideFilterInput has been replaced with numberOfInputs.");
+        }
     };
     OptionsFactory.prototype.getFilterOptions = function () {
         return this.filterOptions;
@@ -13009,6 +13243,7 @@ var OptionsFactory = /** @class */ (function () {
             var requiredProperties = [['displayKey'], ['displayName'], ['predicate', 'test']];
             var propertyCheck = function (keys) {
                 if (!keys.some(function (key) { return filterOption[key] != null; })) {
+                    console.warn("AG Grid: ignoring FilterOptionDef as it doesn't contain one of '" + keys + "'");
                     return false;
                 }
                 return true;
@@ -13042,9 +13277,13 @@ var OptionsFactory = /** @class */ (function () {
             else if (firstFilterOption.displayKey) {
                 this.defaultOption = firstFilterOption.displayKey;
             }
-            else ;
+            else {
+                console.warn("AG Grid: invalid FilterOptionDef supplied as it doesn't contain a 'displayKey'");
+            }
+        }
+        else {
+            console.warn('AG Grid: no filter options for filter');
         }
-        else ;
     };
     OptionsFactory.prototype.getDefaultOption = function () {
         return this.defaultOption;
@@ -13307,6 +13546,7 @@ var ProvidedFilter = /** @class */ (function (_super) {
                     clickListener = function (e) { _this.onBtCancel(e); };
                     break;
                 default:
+                    console.warn('AG Grid: Unknown button type specified');
                     return;
             }
             var buttonType = type === 'apply' ? 'submit' : 'button';
@@ -13447,6 +13687,9 @@ var ProvidedFilter = /** @class */ (function (_super) {
     // static, as used by floating filter also
     ProvidedFilter.getDebounceMs = function (params, debounceDefault) {
         if (ProvidedFilter.isUseApplyButton(params)) {
+            if (params.debounceMs != null) {
+                console.warn('AG Grid: debounceMs is ignored when apply button is present');
+            }
             return 0;
         }
         return params.debounceMs != null ? params.debounceMs : debounceDefault;
@@ -14823,6 +15066,7 @@ var ScalarFilter = /** @class */ (function (_super) {
             case ScalarFilter.NOT_BLANK:
                 return !this.isBlank(cellValue);
             default:
+                console.warn('AG Grid: Unexpected type of filter "' + filterModel.type + '", it looks like the filter was configured with incorrect Filter Options');
                 return true;
         }
     };
@@ -14916,11 +15160,17 @@ var DateFilter = /** @class */ (function (_super) {
                 if (!isNaN(params[param])) {
                     return params[param] == null ? fallback : Number(params[param]);
                 }
+                else {
+                    console.warn("AG Grid: DateFilter " + param + " is not a number");
+                }
             }
             return fallback;
         };
         this.minValidYear = yearParser('minValidYear', DEFAULT_MIN_YEAR);
         this.maxValidYear = yearParser('maxValidYear', DEFAULT_MAX_YEAR);
+        if (this.minValidYear > this.maxValidYear) {
+            console.warn("AG Grid: DateFilter minValidYear should be <= maxValidYear");
+        }
         this.createDateComponents();
     };
     DateFilter.prototype.createDateComponents = function () {
@@ -15621,7 +15871,7 @@ var TextFilter = /** @class */ (function (_super) {
     TextFilter.prototype.getTextMatcher = function () {
         var legacyComparator = this.textFilterParams.textCustomComparator;
         if (legacyComparator) {
-            _.doOnce(function () { return (void 0); }, 'textCustomComparator.deprecated');
+            _.doOnce(function () { return console.warn('AG Grid - textCustomComparator is deprecated, use textMatcher instead.'); }, 'textCustomComparator.deprecated');
             return function (_a) {
                 var filterOption = _a.filterOption, value = _a.value, filterText = _a.filterText;
                 return legacyComparator(filterOption, value, filterText);
@@ -16547,7 +16797,8 @@ var HeaderGroupComp = /** @class */ (function (_super) {
     HeaderGroupComp.prototype.checkWarnings = function () {
         var paramsAny = this.params;
         if (paramsAny.template) {
-            doOnce(function () { return (void 0); }, 'HeaderGroupComp.templateNotSupported');
+            var message_1 = "AG Grid: A template was provided for Header Group Comp - templates are only supported for Header Comps (not groups)";
+            doOnce(function () { return console.warn(message_1); }, 'HeaderGroupComp.templateNotSupported');
         }
     };
     HeaderGroupComp.prototype.setupExpandIcons = function () {
@@ -16778,6 +17029,7 @@ var SelectCellEditor = /** @class */ (function (_super) {
         var _this = this;
         this.focusAfterAttached = params.cellStartedEdit;
         if (missing(params.values)) {
+            console.warn('AG Grid: no values found for select cellEditor');
             return;
         }
         this.startedByEnter = params.eventKey != null ? params.eventKey === KeyCode.ENTER : false;
@@ -16851,7 +17103,7 @@ var PopupSelectCellEditor = /** @class */ (function (_super) {
     __extends$2_(PopupSelectCellEditor, _super);
     function PopupSelectCellEditor() {
         var _this = _super.call(this) || this;
-        doOnce(function () { return (void 0); }, 'PopupSelectCellEditor.deprecated');
+        doOnce(function () { return console.warn('AG Grid: The PopupSelectCellEditor (agPopupSelectCellEditor) is deprecated. Instead use {cellEditor: "agSelectCellEditor", cellEditorPopup: true} '); }, 'PopupSelectCellEditor.deprecated');
         return _this;
     }
     PopupSelectCellEditor.prototype.isPopup = function () {
@@ -17005,7 +17257,7 @@ var PopupTextCellEditor = /** @class */ (function (_super) {
     __extends$2Y(PopupTextCellEditor, _super);
     function PopupTextCellEditor() {
         var _this = _super.call(this) || this;
-        doOnce(function () { return (void 0); }, 'PopupTextCellEditor.deprecated');
+        doOnce(function () { return console.warn('AG Grid: The PopupTextCellEditor (agPopupTextCellEditor) is deprecated. Instead use {cellEditor: "agTextCellEditor", cellEditorPopup: true} '); }, 'PopupTextCellEditor.deprecated');
         return _this;
     }
     PopupTextCellEditor.prototype.isPopup = function () {
@@ -17382,7 +17634,9 @@ var RowNode = /** @class */ (function () {
                 });
                 // make sure id provided doesn't start with 'row-group-' as this is reserved. also check that
                 // it has 'startsWith' in case the user provided a number.
-                if (this.id !== null && typeof this.id === 'string' && this.id.startsWith(RowNode.ID_PREFIX_ROW_GROUP)) ;
+                if (this.id !== null && typeof this.id === 'string' && this.id.startsWith(RowNode.ID_PREFIX_ROW_GROUP)) {
+                    console.error("AG Grid: Row IDs cannot start with " + RowNode.ID_PREFIX_ROW_GROUP + ", this is a reserved prefix for AG Grid's row grouping feature.");
+                }
                 // force id to be a string
                 if (this.id !== null && typeof this.id !== 'string') {
                     this.id = '' + this.id;
@@ -17841,9 +18095,11 @@ var RowNode = /** @class */ (function () {
         // groupSelectsFiltered only makes sense when group selects children
         var groupSelectsFiltered = groupSelectsChildren && (params.groupSelectsFiltered === true);
         if (this.id === undefined) {
+            console.warn('AG Grid: cannot select node until id for node is known');
             return 0;
         }
         if (this.rowPinned) {
+            console.warn('AG Grid: cannot select pinned rows');
             return 0;
         }
         // if we are a footer, we don't do selection, just pass the info
@@ -18618,7 +18874,9 @@ var DragAndDropService = /** @class */ (function (_super) {
             }
         }
         this.eGhostParent = targetEl;
-        if (!this.eGhostParent) ;
+        if (!this.eGhostParent) {
+            console.warn('AG Grid: could not find document body, it is needed for dragging columns');
+        }
         else {
             this.eGhostParent.appendChild(this.eGhost);
         }
@@ -18781,7 +19039,7 @@ var RowDragComp = /** @class */ (function (_super) {
         var treeData = this.beans.gridOptionsWrapper.isTreeData();
         if (treeData && managed) {
             doOnce(function () {
-                return (void 0);
+                return console.warn('AG Grid: If using row drag with tree data, you cannot have rowDragManaged=true');
             }, 'RowDragComp.managedAndTreeData');
         }
     };
@@ -19190,7 +19448,9 @@ var GroupCellRendererCtrl = /** @class */ (function (_super) {
             else if (typeof footerValueGetter === 'string') {
                 footerValue = this.expressionService.evaluate(footerValueGetter, paramsClone);
             }
-            else ;
+            else {
+                console.warn('AG Grid: footerValueGetter should be either a function or a string (expression)');
+            }
         }
         else {
             footerValue = 'Total ' + (this.params.value != null ? this.params.value : '');
@@ -19408,7 +19668,7 @@ var GroupCellRendererCtrl = /** @class */ (function (_super) {
         var paddingCount = manyDimensionThisColumn ? rowNode.uiLevel : 0;
         var userProvidedPaddingPixelsTheDeprecatedWay = params.padding >= 0;
         if (userProvidedPaddingPixelsTheDeprecatedWay) {
-            doOnce(function () { return (void 0); }, 'groupCellRenderer->doDeprecatedWay');
+            doOnce(function () { return console.warn('AG Grid: cellRendererParams.padding no longer works, it was deprecated in since v14.2 and removed in v26, configuring padding for groupCellRenderer should be done with Sass variables and themes. Please see the AG Grid documentation page for Themes, in particular the property $row-group-indent-size.'); }, 'groupCellRenderer->doDeprecatedWay');
         }
         if (this.indentClass) {
             this.comp.addOrRemoveCssClass(this.indentClass, false);
@@ -19913,6 +20173,7 @@ var UserComponentRegistry = /** @class */ (function (_super) {
     UserComponentRegistry.prototype.registerDefaultComponent = function (rawName, component) {
         var name = this.translateIfDeprecated(rawName);
         if (this.agGridDefaults[name]) {
+            console.error("Trying to overwrite a default component. You should call registerComponent");
             return;
         }
         this.agGridDefaults[name] = component;
@@ -19920,6 +20181,7 @@ var UserComponentRegistry = /** @class */ (function (_super) {
     UserComponentRegistry.prototype.registerJsComponent = function (rawName, component) {
         var name = this.translateIfDeprecated(rawName);
         if (this.fwComps[name]) {
+            console.error("Trying to register a component that you have already registered for frameworks: " + name);
             return;
         }
         this.jsComps[name] = component;
@@ -19929,7 +20191,8 @@ var UserComponentRegistry = /** @class */ (function (_super) {
      * A the agGridComponent interface (ie IHeaderComp). The final object acceptable by ag-grid
      */
     UserComponentRegistry.prototype.registerFwComponent = function (rawName, component) {
-        doOnce(function () { return (void 0); }, "UserComponentRegistry.frameworkComponentsDeprecated");
+        var warningMessage = "AG Grid: As of v27, registering components via grid property frameworkComponents is deprecated. Instead register both JavaScript AND Framework Components via the components property.";
+        doOnce(function () { return console.warn(warningMessage); }, "UserComponentRegistry.frameworkComponentsDeprecated");
         var name = this.translateIfDeprecated(rawName);
         this.fwComps[name] = component;
     };
@@ -19956,13 +20219,16 @@ var UserComponentRegistry = /** @class */ (function (_super) {
         if (defaultComponent) {
             return createResult(defaultComponent, false);
         }
-        if (Object.keys(this.agGridDefaults).indexOf(name) < 0) ;
+        if (Object.keys(this.agGridDefaults).indexOf(name) < 0) {
+            console.warn("AG Grid: Looking for component [" + name + "] but it wasn't found.");
+        }
         return null;
     };
     UserComponentRegistry.prototype.translateIfDeprecated = function (raw) {
         var deprecatedInfo = this.agDeprecatedNames[raw];
         if (deprecatedInfo != null) {
             doOnce(function () {
+                console.warn("ag-grid. Since v15.0 component names have been renamed to be namespaced. You should rename " + deprecatedInfo.propertyHolder + ":" + raw + " to " + deprecatedInfo.propertyHolder + ":" + deprecatedInfo.newComponentName);
             }, 'DEPRECATE_COMPONENT_' + raw);
             return deprecatedInfo.newComponentName;
         }
@@ -20180,6 +20446,7 @@ var UserComponentFactory = /** @class */ (function (_super) {
     };
     UserComponentFactory.prototype.getCompDetails = function (defObject, type, defaultName, params, mandatory) {
         var _this = this;
+        if (mandatory === void 0) { mandatory = false; }
         var propertyName = type.propertyName, cellRenderer = type.cellRenderer;
         var _a = this.getCompKeys(defObject, type, params), compName = _a.compName, jsComp = _a.jsComp, fwComp = _a.fwComp, paramsFromSelector = _a.paramsFromSelector, popupFromSelector = _a.popupFromSelector, popupPositionFromSelector = _a.popupPositionFromSelector;
         var lookupFromRegistry = function (key) {
@@ -20202,6 +20469,9 @@ var UserComponentFactory = /** @class */ (function (_super) {
             jsComp = this.agComponentUtils.adaptFunction(propertyName, jsComp);
         }
         if (!jsComp && !fwComp) {
+            if (mandatory) {
+                console.error("Could not find component " + compName + ", did you forget to configure this component?");
+            }
             return;
         }
         var paramsMerged = this.mergeParamsWithApplicationProvidedParams(defObject, type, params, paramsFromSelector);
@@ -20238,7 +20508,8 @@ var UserComponentFactory = /** @class */ (function (_super) {
             var selectorRes = selectorFunc ? selectorFunc(params) : null;
             var assignComp = function (providedJsComp, providedFwComp) {
                 var xxxFrameworkDeprecatedWarn = function () {
-                    doOnce(function () { return (void 0); }, "UserComponentFactory." + propertyName + "FrameworkDeprecated");
+                    var warningMessage = "AG Grid: As of v27, the property " + propertyName + "Framework is deprecated. The property " + propertyName + " can now be used for JavaScript AND Framework Components.";
+                    doOnce(function () { return console.warn(warningMessage); }, "UserComponentFactory." + propertyName + "FrameworkDeprecated");
                 };
                 if (typeof providedJsComp === 'string') {
                     compName = providedJsComp;
@@ -20264,7 +20535,8 @@ var UserComponentFactory = /** @class */ (function (_super) {
             };
             if (selectorRes) {
                 if (selectorRes.frameworkComponent != null) {
-                    doOnce(function () { return (void 0); }, "UserComponentFactory." + propertyName + "FrameworkSelectorDeprecated");
+                    var warningMessage_1 = "AG Grid: As of v27, the return for " + propertyName + "Selector has attributes [component, params] only. The attribute frameworkComponent is deprecated. You should now return back Framework Components using the 'component' attribute and the grid works out if it's a framework component or not.";
+                    doOnce(function () { return console.warn(warningMessage_1); }, "UserComponentFactory." + propertyName + "FrameworkSelectorDeprecated");
                     assignComp(selectorRes.frameworkComponent, undefined);
                 }
                 else {
@@ -20769,13 +21041,16 @@ var FilterManager = /** @class */ (function (_super) {
             modelKeys_1.forEach(function (colId) {
                 var column = _this.columnModel.getPrimaryColumn(colId) || _this.columnModel.getGridColumn(colId);
                 if (!column) {
+                    console.warn('AG Grid: setFilterModel() - no column found for colId: ' + colId);
                     return;
                 }
                 if (!column.isFilterAllowed()) {
+                    console.warn('AG Grid: setFilterModel() - unable to fully apply model, filtering disabled for colId: ' + colId);
                     return;
                 }
                 var filterWrapper = _this.getOrCreateFilterWrapper(column, 'NO_UI');
                 if (!filterWrapper) {
+                    console.warn('AG-Grid: setFilterModel() - unable to fully apply model, unable to create filter for colId: ' + colId);
                     return;
                 }
                 allPromises.push(_this.setModelOnFilterWrapper(filterWrapper.filterPromise, model[colId]));
@@ -20805,6 +21080,7 @@ var FilterManager = /** @class */ (function (_super) {
         return new AgPromise(function (resolve) {
             filterPromise.then(function (filter) {
                 if (typeof filter.setModel !== 'function') {
+                    console.warn('AG Grid: filter missing setModel method, which is needed for setFilterModel');
                     resolve();
                 }
                 (filter.setModel(newModel) || AgPromise.resolve()).then(function () { return resolve(); });
@@ -20821,6 +21097,7 @@ var FilterManager = /** @class */ (function (_super) {
                 return null;
             }
             if (typeof filter.getModel !== 'function') {
+                console.warn('AG Grid: filter API missing getModel method, which is needed for getFilterModel');
                 return;
             }
             var model = filter.getModel();
@@ -20854,6 +21131,7 @@ var FilterManager = /** @class */ (function (_super) {
                 return false;
             } // this never happens, including to avoid compile error
             if (!filter.isFilterActive) {
+                console.warn('AG Grid: Filter is missing isFilterActive() method');
                 return false;
             }
             return filter.isFilterActive();
@@ -20927,12 +21205,14 @@ var FilterManager = /** @class */ (function (_super) {
             return null;
         }
         if (!this.gridOptionsWrapper.isRowModelDefault()) {
+            console.warn('AG Grid - Quick filtering only works with the Client-Side Row Model');
             return null;
         }
         return newFilter.toUpperCase();
     };
     FilterManager.prototype.setQuickFilter = function (newFilter) {
         if (newFilter != null && typeof newFilter !== 'string') {
+            console.warn("AG Grid - setQuickFilter() only supports string inputs, received: " + typeof newFilter);
             return;
         }
         var parsedFilter = this.parseQuickFilter(newFilter);
@@ -21192,7 +21472,9 @@ var FilterManager = /** @class */ (function (_super) {
         filterWrapper.guiPromise = new AgPromise(function (resolve) {
             filterWrapper.filterPromise.then(function (filter) {
                 var guiFromFilter = filter.getGui();
-                if (!exists(guiFromFilter)) ;
+                if (!exists(guiFromFilter)) {
+                    console.warn("AG Grid: getGui method from filter returned " + guiFromFilter + ", it should be a DOM element or an HTML template string.");
+                }
                 // for backwards compatibility with Angular 1 - we
                 // used to allow providing back HTML from getGui().
                 // once we move away from supporting Angular 1
@@ -21784,6 +22066,7 @@ var GridBodyScrollFeature = /** @class */ (function (_super) {
         }
         var rowCount = this.paginationProxy.getRowCount();
         if (typeof index !== 'number' || index < 0 || index >= rowCount) {
+            console.warn('invalid row index for ensureIndexVisible: ' + index);
             return;
         }
         var isPaging = this.gridOptionsWrapper.isPagination();
@@ -22278,10 +22561,11 @@ var RowDragFeature = /** @class */ (function (_super) {
     RowDragFeature.prototype.addRowDropZone = function (params) {
         var _this = this;
         if (!params.getContainer()) {
-            doOnce(function () { return (void 0); }, 'add-drop-zone-empty-target');
+            doOnce(function () { return console.warn('AG Grid: addRowDropZone - A container target needs to be provided'); }, 'add-drop-zone-empty-target');
             return;
         }
         if (this.dragAndDropService.findExternalZone(params)) {
+            console.warn('AG Grid: addRowDropZone - target already exists in the list of DropZones. Use `removeRowDropZone` before adding it again.');
             return;
         }
         var processedParams = {
@@ -22808,7 +23092,10 @@ var GridBodyCtrl = /** @class */ (function (_super) {
                 _this.sizeColumnsToFit(params, -1);
             }, 500);
         }
-        else ;
+        else {
+            console.warn('AG Grid: tried to call sizeColumnsToFit() but the grid is coming back with ' +
+                'zero width, maybe the grid is not visible yet on the screen?');
+        }
     };
     // + rangeService
     GridBodyCtrl.prototype.addScrollEventListener = function (listener) {
@@ -24469,6 +24756,7 @@ var CellCtrl = /** @class */ (function (_super) {
     CellCtrl.prototype.createCellRendererParams = function () {
         var _this = this;
         var addRowCompListener = function (eventType, listener) {
+            console.warn('AG Grid: since AG Grid v26, params.addRowCompListener() is deprecated. If you need this functionality, please contact AG Grid support and advise why so that we can revert with an appropriate workaround, as we dont have any valid use cases for it. This method was originally provided as a work around to know when cells were destroyed in AG Grid before custom Cell Renderers could be provided.');
             _this.rowCtrl.addEventListener(eventType, listener);
         };
         var res = {
@@ -24997,11 +25285,11 @@ var CellCtrl = /** @class */ (function (_super) {
         if (rowDragManaged) {
             // row dragging only available in default row model
             if (!clientSideRowModelActive) {
-                doOnce(function () { return (void 0); }, 'CellComp.addRowDragging');
+                doOnce(function () { return console.warn('AG Grid: managed row dragging is only allowed in the Client Side Row Model'); }, 'CellComp.addRowDragging');
                 return;
             }
             if (pagination) {
-                doOnce(function () { return (void 0); }, 'CellComp.addRowDragging');
+                doOnce(function () { return console.warn('AG Grid: managed row dragging is not possible when doing pagination'); }, 'CellComp.addRowDragging');
                 return;
             }
         }
@@ -25218,6 +25506,7 @@ var RowCtrl = /** @class */ (function (_super) {
         var gow = this.beans.gridOptionsWrapper;
         if (gow.isEnableRangeSelection()) {
             doOnce(function () {
+                console.warn('AG Grid: Setting `rowDragEntireRow: true` in the gridOptions doesn\'t work with `enableRangeSelection: true`');
             }, 'rowDragAndRangeSelectionEnabled');
             return;
         }
@@ -25230,7 +25519,12 @@ var RowCtrl = /** @class */ (function (_super) {
         var params = this.createFullWidthParams(gui.element, pinned);
         var masterDetailModuleLoaded = ModuleRegistry.isRegistered(ModuleNames.MasterDetailModule);
         if (this.rowType == RowType$1.FullWidthDetail && !masterDetailModuleLoaded) {
-            if (ModuleRegistry.isPackageBased()) ;
+            if (ModuleRegistry.isPackageBased()) {
+                console.warn("AG Grid: cell renderer 'agDetailCellRenderer' (for master detail) not found. Can only be used with ag-grid-enterprise package.");
+            }
+            else {
+                console.warn("AG Grid: cell renderer 'agDetailCellRenderer' (for master detail) not found. Can only be used with AG Grid Enterprise Module " + ModuleNames.MasterDetailModule);
+            }
             return;
         }
         var compDetails;
@@ -25981,6 +26275,7 @@ var RowCtrl = /** @class */ (function (_super) {
         // part 1 - rowStyle
         var rowStyle = this.beans.gridOptionsWrapper.getRowStyle();
         if (rowStyle && typeof rowStyle === 'function') {
+            console.warn('AG Grid: rowStyle should be an object of key/value styles, not be a function, use getRowStyle() instead');
             return;
         }
         // part 1 - rowStyleFunc
@@ -26095,12 +26390,14 @@ var RowCtrl = /** @class */ (function (_super) {
     RowCtrl.prototype.addEventListener = function (eventType, listener) {
         if (eventType === 'renderedRowRemoved' || eventType === 'rowRemoved') {
             eventType = Events.EVENT_VIRTUAL_ROW_REMOVED;
+            console.warn('AG Grid: Since version 11, event renderedRowRemoved is now called ' + Events.EVENT_VIRTUAL_ROW_REMOVED);
         }
         _super.prototype.addEventListener.call(this, eventType, listener);
     };
     RowCtrl.prototype.removeEventListener = function (eventType, listener) {
         if (eventType === 'renderedRowRemoved' || eventType === 'rowRemoved') {
             eventType = Events.EVENT_VIRTUAL_ROW_REMOVED;
+            console.warn('AG Grid: Since version 11, event renderedRowRemoved and rowRemoved is now called ' + Events.EVENT_VIRTUAL_ROW_REMOVED);
         }
         _super.prototype.removeEventListener.call(this, eventType, listener);
     };
@@ -28260,7 +28557,7 @@ var NavigationService = /** @class */ (function (_super) {
                 var userCell = userFunc(params);
                 if (exists(userCell)) {
                     if (userCell.floating) {
-                        doOnce(function () { }, 'no floating in userCell');
+                        doOnce(function () { console.warn("AG Grid: tabToNextCellFunc return type should have attributes: rowIndex, rowPinned, column. However you had 'floating', maybe you meant 'rowPinned'?"); }, 'no floating in userCell');
                         userCell.rowPinned = userCell.floating;
                     }
                     nextPosition = {
@@ -28393,7 +28690,7 @@ var NavigationService = /** @class */ (function (_super) {
                 var userCell = userFunc(params);
                 if (exists(userCell)) {
                     if (userCell.floating) {
-                        doOnce(function () { }, 'no floating in userCell');
+                        doOnce(function () { console.warn("AG Grid: tabToNextCellFunc return type should have attributes: rowIndex, rowPinned, column. However you had 'floating', maybe you meant 'rowPinned'?"); }, 'no floating in userCell');
                         userCell.rowPinned = userCell.floating;
                     }
                     nextCell = {
@@ -28948,6 +29245,7 @@ var CellComp = /** @class */ (function (_super) {
             return;
         }
         if (!cellEditor.getGui) {
+            console.warn("AG Grid: cellEditor for column " + this.column.getId() + " is missing getGui() method");
             this.beans.context.destroyBean(cellEditor);
             return;
         }
@@ -28985,7 +29283,10 @@ var CellComp = /** @class */ (function (_super) {
     };
     CellComp.prototype.addPopupCellEditor = function (params, position) {
         var _this = this;
-        if (this.beans.gridOptionsWrapper.isFullRowEdit()) ;
+        if (this.beans.gridOptionsWrapper.isFullRowEdit()) {
+            console.warn('AG Grid: popup cellEditor does not work with fullRowEdit - you cannot use them both ' +
+                '- either turn off fullRowEdit, or stop using popup editors.');
+        }
         var cellEditor = this.cellEditor;
         // if a popup, then we wrap in a popup editor and return the popup
         this.cellEditorPopupWrapper = this.beans.context.createBean(new PopupEditorWrapper(params));
@@ -29169,6 +29470,9 @@ var RowComp = /** @class */ (function (_super) {
     };
     RowComp.prototype.setFullWidthRowComp = function (fullWidthRowComponent) {
         var _this = this;
+        if (this.fullWidthCellRenderer) {
+            console.error('AG Grid - should not be setting fullWidthRowComponent twice');
+        }
         this.fullWidthCellRenderer = fullWidthRowComponent;
         this.addDestroyFunc(function () {
             _this.fullWidthCellRenderer = _this.beans.context.destroyBean(_this.fullWidthCellRenderer);
@@ -29593,6 +29897,7 @@ var MoveColumnFeature = /** @class */ (function () {
             switch (hDirection) {
                 case HorizontalDirection.Left: return HorizontalDirection.Right;
                 case HorizontalDirection.Right: return HorizontalDirection.Left;
+                default: console.error("AG Grid: Unknown direction " + hDirection);
             }
         }
         else {
@@ -30633,6 +30938,7 @@ var GridApi = /** @class */ (function () {
         }
         var exportMode = this.getExcelExportMode(params);
         if (this.excelCreator.getFactoryMode(exportMode) === ExcelFactoryMode.MULTI_SHEET) {
+            console.warn('AG Grid: The Excel Exporter is currently on Multi Sheet mode. End that operation by calling `api.getMultipleSheetAsExcel()` or `api.exportMultipleSheetsAsExcel()`');
             return;
         }
         return this.excelCreator.getDataAsExcel(params);
@@ -30644,6 +30950,7 @@ var GridApi = /** @class */ (function () {
         }
         var exportMode = this.getExcelExportMode(params);
         if (this.excelCreator.getFactoryMode(exportMode) === ExcelFactoryMode.MULTI_SHEET) {
+            console.warn('AG Grid: The Excel Exporter is currently on Multi Sheet mode. End that operation by calling `api.getMultipleSheetAsExcel()` or `api.exportMultipleSheetsAsExcel()`');
             return;
         }
         this.excelCreator.exportDataAsExcel(params);
@@ -30671,6 +30978,7 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid: since version 18.x, api.setEnterpriseDatasource() should be replaced with api.setServerSideDatasource() */
     GridApi.prototype.setEnterpriseDatasource = function (datasource) {
+        console.warn("AG Grid: since version 18.x, api.setEnterpriseDatasource() should be replaced with api.setServerSideDatasource()");
         this.setServerSideDatasource(datasource);
     };
     /**
@@ -30699,6 +31007,9 @@ var GridApi = /** @class */ (function () {
             // should really have an IEnterpriseRowModel interface, so we are not casting to any
             this.serverSideRowModel.setDatasource(datasource);
         }
+        else {
+            console.warn("AG Grid: you can only use an enterprise datasource when gridOptions.rowModelType is '" + Constants.ROW_MODEL_TYPE_SERVER_SIDE + "'");
+        }
     };
     /**
      * Updates the `cacheBlockSize` used by `serverSideInfiniteScroll` when requesting data from the server.
@@ -30707,6 +31018,7 @@ var GridApi = /** @class */ (function () {
      * */
     GridApi.prototype.setCacheBlockSize = function (blockSize) {
         if (!this.serverSideRowModel) {
+            console.warn("AG Grid: you can only set cacheBlockSize with gridOptions.rowModelType '" + Constants.ROW_MODEL_TYPE_SERVER_SIDE + "'");
             return;
         }
         this.gridOptionsWrapper.setProperty('cacheBlockSize', blockSize);
@@ -30717,6 +31029,9 @@ var GridApi = /** @class */ (function () {
         if (this.gridOptionsWrapper.isRowModelInfinite()) {
             this.rowModel.setDatasource(datasource);
         }
+        else {
+            console.warn("AG Grid: you can only use a datasource when gridOptions.rowModelType is '" + Constants.ROW_MODEL_TYPE_INFINITE + "'");
+        }
     };
     /** Set new datasource for Viewport Row Model. */
     GridApi.prototype.setViewportDatasource = function (viewportDatasource) {
@@ -30726,12 +31041,16 @@ var GridApi = /** @class */ (function () {
             // the enterprise implement it, rather than casting to 'any' here
             this.rowModel.setViewportDatasource(viewportDatasource);
         }
+        else {
+            console.warn("AG Grid: you can only use a viewport datasource when gridOptions.rowModelType is '" + Constants.ROW_MODEL_TYPE_VIEWPORT + "'");
+        }
     };
     /** Set the row data. */
     GridApi.prototype.setRowData = function (rowData) {
         // immutable service is part of the CSRM module, if missing, no CSRM
         var missingImmutableService = this.immutableService == null;
         if (missingImmutableService) {
+            console.warn('AG Grid: you can only set rowData when using the Client Side Row Model');
             return;
         }
         // if no keys provided provided for rows, then we can tread the operation as Immutable
@@ -30745,26 +31064,32 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid: since v12, api.setFloatingTopRowData() is now api.setPinnedTopRowData() */
     GridApi.prototype.setFloatingTopRowData = function (rows) {
+        console.warn('AG Grid: since v12, api.setFloatingTopRowData() is now api.setPinnedTopRowData()');
         this.setPinnedTopRowData(rows);
     };
     /** @deprecated AG Grid: since v12, api.setFloatingBottomRowData() is now api.setPinnedBottomRowData() */
     GridApi.prototype.setFloatingBottomRowData = function (rows) {
+        console.warn('AG Grid: since v12, api.setFloatingBottomRowData() is now api.setPinnedBottomRowData()');
         this.setPinnedBottomRowData(rows);
     };
     /** @deprecated AG Grid: since v12, api.getFloatingTopRowCount() is now api.getPinnedTopRowCount() */
     GridApi.prototype.getFloatingTopRowCount = function () {
+        console.warn('AG Grid: since v12, api.getFloatingTopRowCount() is now api.getPinnedTopRowCount()');
         return this.getPinnedTopRowCount();
     };
     /** @deprecated AG Grid: since v12, api.getFloatingBottomRowCount() is now api.getPinnedBottomRowCount() */
     GridApi.prototype.getFloatingBottomRowCount = function () {
+        console.warn('AG Grid: since v12, api.getFloatingBottomRowCount() is now api.getPinnedBottomRowCount()');
         return this.getPinnedBottomRowCount();
     };
     /** @deprecated AG Grid: since v12, api.getFloatingTopRow() is now api.getPinnedTopRow() */
     GridApi.prototype.getFloatingTopRow = function (index) {
+        console.warn('AG Grid: since v12, api.getFloatingTopRow() is now api.getPinnedTopRow()');
         return this.getPinnedTopRow(index);
     };
     /** @deprecated AG Grid: since v12, api.getFloatingBottomRow() is now api.getPinnedBottomRow() */
     GridApi.prototype.getFloatingBottomRow = function (index) {
+        console.warn('AG Grid: since v12, api.getFloatingBottomRow() is now api.getPinnedBottomRow()');
         return this.getPinnedBottomRow(index);
     };
     /** Set the top pinned rows. Call with no rows / undefined to clear top pinned rows. */
@@ -30845,6 +31170,7 @@ var GridApi = /** @class */ (function () {
         if (params === void 0) { params = {}; }
         if (Array.isArray(params)) {
             // the old version of refreshCells() took an array of rowNodes for the first argument
+            console.warn('since AG Grid v11.1, refreshCells() now takes parameters, please see the documentation.');
             return;
         }
         this.rowRenderer.refreshCells(params);
@@ -30898,8 +31224,12 @@ var GridApi = /** @class */ (function () {
      *  It will work out the final set of 'to be displayed' rows again (i.e. expand or collapse the group visually).
      */
     GridApi.prototype.onGroupExpandedOrCollapsed = function (deprecated_refreshFromIndex) {
-        if (missing(this.clientSideRowModel)) ;
-        if (exists(deprecated_refreshFromIndex)) ;
+        if (missing(this.clientSideRowModel)) {
+            console.warn('AG Grid: cannot call onGroupExpandedOrCollapsed unless using normal row model');
+        }
+        if (exists(deprecated_refreshFromIndex)) {
+            console.warn('AG Grid: api.onGroupExpandedOrCollapsed - refreshFromIndex parameter is no longer used, the grid will refresh all rows');
+        }
         // we don't really want the user calling this if only one rowNode was expanded, instead they should be
         // calling rowNode.setExpanded(boolean) - this way we do a 'keepRenderedRows=false' so that the whole
         // grid gets refreshed again - otherwise the row with the rowNodes that were changed won't get updated,
@@ -30908,6 +31238,7 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid: since version 18.x, api.refreshInMemoryRowModel() should be replaced with api.refreshClientSideRowModel() */
     GridApi.prototype.refreshInMemoryRowModel = function (step) {
+        console.warn("AG Grid: since version 18.x, api.refreshInMemoryRowModel() should be replaced with api.refreshClientSideRowModel()");
         this.refreshClientSideRowModel(step);
     };
     /**
@@ -30915,7 +31246,9 @@ var GridApi = /** @class */ (function () {
      * Optionally provide the step you wish the refresh to apply from. Defaults to `everything`.
      */
     GridApi.prototype.refreshClientSideRowModel = function (step) {
-        if (missing(this.clientSideRowModel)) ;
+        if (missing(this.clientSideRowModel)) {
+            console.warn('cannot call refreshClientSideRowModel unless using normal row model');
+        }
         var paramsStep = ClientSideRowModelSteps.EVERYTHING;
         var stepsMapped = {
             everything: ClientSideRowModelSteps.EVERYTHING,
@@ -30930,6 +31263,7 @@ var GridApi = /** @class */ (function () {
             paramsStep = stepsMapped[step];
         }
         if (missing(paramsStep)) {
+            console.error("AG Grid: invalid step " + step + ", available steps are " + Object.keys(stepsMapped).join(', '));
             return;
         }
         var animate = !this.gridOptionsWrapper.isSuppressAnimationFrame();
@@ -30975,7 +31309,9 @@ var GridApi = /** @class */ (function () {
         else if (this.serverSideRowModel) {
             this.serverSideRowModel.expandAll(true);
         }
-        else ;
+        else {
+            console.warn('AG Grid: expandAll only works with Client Side Row Model and Server Side Row Model');
+        }
     };
     /** Collapse all groups. */
     GridApi.prototype.collapseAll = function () {
@@ -30985,17 +31321,23 @@ var GridApi = /** @class */ (function () {
         else if (this.serverSideRowModel) {
             this.serverSideRowModel.expandAll(false);
         }
-        else ;
+        else {
+            console.warn('AG Grid: collapseAll only works with Client Side Row Model and Server Side Row Model');
+        }
     };
     /** Gets the tool panel instance corresponding to the supplied `id`. */
     GridApi.prototype.getToolPanelInstance = function (id) {
         if (!this.sideBarComp) {
+            console.warn('AG Grid: toolPanel is only available in AG Grid Enterprise');
             return;
         }
         var comp = this.sideBarComp.getToolPanelInstance(id);
         return unwrapUserComp(comp);
     };
     GridApi.prototype.addVirtualRowListener = function (eventName, rowIndex, callback) {
+        if (typeof eventName !== 'string') {
+            console.warn('AG Grid: addVirtualRowListener is deprecated, please use addRenderedRowListener.');
+        }
         this.addRenderedRowListener(eventName, rowIndex, callback);
     };
     /**
@@ -31006,6 +31348,9 @@ var GridApi = /** @class */ (function () {
      * listen for this event if your `cellRenderer` needs to do cleanup when the row no longer exists.
      */
     GridApi.prototype.addRenderedRowListener = function (eventName, rowIndex, callback) {
+        if (eventName === 'virtualRowSelected') {
+            console.warn("AG Grid: event virtualRowSelected is deprecated, to register for individual row\n                selection events, add a listener directly to the row node.");
+        }
         this.rowRenderer.addRenderedRowListener(eventName, rowIndex, callback);
     };
     /** Pass a quick filter text into the grid for filtering. */
@@ -31014,19 +31359,38 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid: do not use api for selection, call rowNode.setSelected(value) instead */
     GridApi.prototype.selectIndex = function (index, tryMulti, suppressEvents) {
+        console.warn('AG Grid: do not use api for selection, call rowNode.setSelected(value) instead');
+        if (suppressEvents) {
+            console.warn('AG Grid: suppressEvents is no longer supported, stop listening for the event if you no longer want it');
+        }
         this.selectionService.selectIndex(index, tryMulti);
     };
     /** @deprecated AG Grid: do not use api for selection, call rowNode.setSelected(value) instead. */
     GridApi.prototype.deselectIndex = function (index, suppressEvents) {
+        if (suppressEvents === void 0) { suppressEvents = false; }
+        console.warn('AG Grid: do not use api for selection, call rowNode.setSelected(value) instead');
+        if (suppressEvents) {
+            console.warn('AG Grid: suppressEvents is no longer supported, stop listening for the event if you no longer want it');
+        }
         this.selectionService.deselectIndex(index);
     };
     /** @deprecated AG Grid: API for selection is deprecated, call rowNode.setSelected(value) instead. */
     GridApi.prototype.selectNode = function (node, tryMulti, suppressEvents) {
         if (tryMulti === void 0) { tryMulti = false; }
+        if (suppressEvents === void 0) { suppressEvents = false; }
+        console.warn('AG Grid: API for selection is deprecated, call rowNode.setSelected(value) instead');
+        if (suppressEvents) {
+            console.warn('AG Grid: suppressEvents is no longer supported, stop listening for the event if you no longer want it');
+        }
         node.setSelectedParams({ newValue: true, clearSelection: !tryMulti });
     };
     /** @deprecated AG Grid: API for selection is deprecated, call rowNode.setSelected(value) instead. */
     GridApi.prototype.deselectNode = function (node, suppressEvents) {
+        if (suppressEvents === void 0) { suppressEvents = false; }
+        console.warn('AG Grid: API for selection is deprecated, call rowNode.setSelected(value) instead');
+        if (suppressEvents) {
+            console.warn('AG Grid: suppressEvents is no longer supported, stop listening for the event if you no longer want it');
+        }
         node.setSelectedParams({ newValue: false });
     };
     /** Select all rows, regardless of filtering and rows that are not visible due to grouping being enabled and their groups not expanded. */
@@ -31047,7 +31411,10 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated recomputeAggregates is deprecated, please call api.refreshClientSideRowModel('aggregate') instead */
     GridApi.prototype.recomputeAggregates = function () {
-        if (missing(this.clientSideRowModel)) ;
+        if (missing(this.clientSideRowModel)) {
+            console.warn('cannot call recomputeAggregates unless using normal row model');
+        }
+        console.warn("recomputeAggregates is deprecated, please call api.refreshClientSideRowModel('aggregate') instead");
         this.clientSideRowModel.refreshModel({ step: ClientSideRowModelSteps.AGGREGATE });
     };
     /**
@@ -31069,10 +31436,12 @@ var GridApi = /** @class */ (function () {
         this.overlayWrapperComp.hideOverlay();
     };
     GridApi.prototype.isNodeSelected = function (node) {
+        console.warn('AG Grid: no need to call api.isNodeSelected(), just call node.isSelected() instead');
         return node.isSelected();
     };
     /** @deprecated Use getSelectedNodesById no longer exists, use getSelectedNodes(). */
     GridApi.prototype.getSelectedNodesById = function () {
+        console.error('AG Grid: since version 3.4, getSelectedNodesById no longer exists, use getSelectedNodes() instead');
         return null;
     };
     /**
@@ -31101,6 +31470,7 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated ensureColIndexVisible(index) no longer supported, use ensureColumnVisible(colKey) instead. */
     GridApi.prototype.ensureColIndexVisible = function (index) {
+        console.warn('AG Grid: ensureColIndexVisible(index) no longer supported, use ensureColumnVisible(colKey) instead.');
     };
     /**
      *  Ensures the column is visible by scrolling the table if needed.
@@ -31142,7 +31512,9 @@ var GridApi = /** @class */ (function () {
      * but excluding groups the grid created where gaps were missing in the hierarchy.
      */
     GridApi.prototype.forEachLeafNode = function (callback) {
-        if (missing(this.clientSideRowModel)) ;
+        if (missing(this.clientSideRowModel)) {
+            console.warn('cannot call forEachNode unless using normal row model');
+        }
         this.clientSideRowModel.forEachLeafNode(callback);
     };
     /**
@@ -31156,12 +31528,16 @@ var GridApi = /** @class */ (function () {
     };
     /** Similar to `forEachNode`, except skips any filtered out data. */
     GridApi.prototype.forEachNodeAfterFilter = function (callback) {
-        if (missing(this.clientSideRowModel)) ;
+        if (missing(this.clientSideRowModel)) {
+            console.warn('cannot call forEachNodeAfterFilter unless using normal row model');
+        }
         this.clientSideRowModel.forEachNodeAfterFilter(callback);
     };
     /** Similar to `forEachNodeAfterFilter`, except the callbacks are called in the order the rows are displayed in the grid. */
     GridApi.prototype.forEachNodeAfterFilterAndSort = function (callback) {
-        if (missing(this.clientSideRowModel)) ;
+        if (missing(this.clientSideRowModel)) {
+            console.warn('cannot call forEachNodeAfterFilterAndSort unless using normal row model');
+        }
         this.clientSideRowModel.forEachNodeAfterFilterAndSort(callback);
     };
     /**
@@ -31399,10 +31775,12 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated use `setProcessPivotResultColDef` instead */
     GridApi.prototype.setProcessSecondaryColDef = function (processSecondaryColDefFunc) {
+        console.warn('AG Grid: since version 28.0.x setProcessSecondaryColDef has been renamed, please use setProcessPivotResultColDef instead');
         this.setProcessPivotResultColDef(processSecondaryColDefFunc);
     };
     /** @deprecated use `setProcessPivotResultColGroupDef` instead */
     GridApi.prototype.setProcessSecondaryColGroupDef = function (processSecondaryColGroupDefFunc) {
+        console.warn('AG Grid: since version 28.0.x setProcessSecondaryColGroupDef has been renamed, please use setProcessPivotResultColGroupDef instead');
         this.setProcessPivotResultColGroupDef(processSecondaryColGroupDefFunc);
     };
     GridApi.prototype.setProcessPivotResultColDef = function (processPivotResultColDefFunc) {
@@ -31458,6 +31836,9 @@ var GridApi = /** @class */ (function () {
     /** Show/hide the entire side bar, including any visible panel and the tab buttons. */
     GridApi.prototype.setSideBarVisible = function (show) {
         if (!this.sideBarComp) {
+            if (show) {
+                console.warn('AG Grid: sideBar is not loaded');
+            }
             return;
         }
         this.sideBarComp.setDisplayed(show);
@@ -31465,6 +31846,7 @@ var GridApi = /** @class */ (function () {
     /** Sets the side bar position relative to the grid. Possible values are `'left'` or `'right'`. */
     GridApi.prototype.setSideBarPosition = function (position) {
         if (!this.sideBarComp) {
+            console.warn('AG Grid: sideBar is not loaded');
             return;
         }
         this.sideBarComp.setSideBarPosition(position);
@@ -31472,6 +31854,7 @@ var GridApi = /** @class */ (function () {
     /** Opens a particular tool panel. Provide the ID of the tool panel to open. */
     GridApi.prototype.openToolPanel = function (key) {
         if (!this.sideBarComp) {
+            console.warn('AG Grid: toolPanel is only available in AG Grid Enterprise');
             return;
         }
         this.sideBarComp.openToolPanel(key);
@@ -31479,6 +31862,7 @@ var GridApi = /** @class */ (function () {
     /** Closes the currently open tool panel (if any). */
     GridApi.prototype.closeToolPanel = function () {
         if (!this.sideBarComp) {
+            console.warn('AG Grid: toolPanel is only available in AG Grid Enterprise');
             return;
         }
         this.sideBarComp.close();
@@ -31504,12 +31888,14 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid - since version 25.1, doLayout was taken out, as it's not needed. The grid responds to grid size changes automatically. */
     GridApi.prototype.doLayout = function () {
-        doOnce(function () { return (void 0); }, 'doLayoutDeprecated');
+        var message = "AG Grid - since version 25.1, doLayout was taken out, as it's not needed. The grid responds to grid size changes automatically";
+        doOnce(function () { return console.warn(message); }, 'doLayoutDeprecated');
     };
     /** Tells the grid to recalculate the row heights. */
     GridApi.prototype.resetRowHeights = function () {
         if (exists(this.clientSideRowModel)) {
             if (this.columnModel.isAutoRowHeightActive()) {
+                console.warn('AG Grid: calling gridApi.resetRowHeights() makes no sense when using Auto Row Height.');
                 return;
             }
             this.clientSideRowModel.resetRowHeights();
@@ -31596,6 +31982,9 @@ var GridApi = /** @class */ (function () {
         setTimeout(removeAllReferences.bind(window, this, 'Grid API'), 100);
     };
     GridApi.prototype.warnIfDestroyed = function (methodName) {
+        if (this.destroyCalled) {
+            console.warn("AG Grid: Grid API method " + methodName + " was called on a grid that was destroyed.");
+        }
         return this.destroyCalled;
     };
     /** Reset the quick filter cache text on every rowNode. */
@@ -31607,6 +31996,7 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid: in v20.1.x, api.getRangeSelections() is gone, please use getCellRanges() instead. */
     GridApi.prototype.getRangeSelections = function () {
+        console.warn("AG Grid: in v20.1.x, api.getRangeSelections() is gone, please use getCellRanges() instead.\n        We had to change how cell selections works a small bit to allow charting to integrate. The return type of\n        getCellRanges() is a bit different, please check the AG Grid documentation.");
         return null;
     };
     /** Returns the list of selected cell ranges. */
@@ -31614,6 +32004,7 @@ var GridApi = /** @class */ (function () {
         if (this.rangeService) {
             return this.rangeService.getCellRanges();
         }
+        console.warn('AG Grid: cell range selection is only available in AG Grid Enterprise');
         return null;
     };
     GridApi.prototype.camelCaseToHumanReadable = function (camelCase) {
@@ -31621,13 +32012,20 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid: As of version 21.x, range selection changed slightly to allow charting integration. Please call api.addCellRange() instead of api.addRangeSelection() */
     GridApi.prototype.addRangeSelection = function (deprecatedNoLongerUsed) {
+        console.warn('AG Grid: As of version 21.x, range selection changed slightly to allow charting integration. Please call api.addCellRange() instead of api.addRangeSelection()');
     };
     /** Adds the provided cell range to the selected ranges. */
     GridApi.prototype.addCellRange = function (params) {
+        if (!this.rangeService) {
+            console.warn('AG Grid: cell range selection is only available in AG Grid Enterprise');
+        }
         this.rangeService.addCellRange(params);
     };
     /** Clears the selected ranges. */
     GridApi.prototype.clearRangeSelection = function () {
+        if (!this.rangeService) {
+            console.warn('AG Grid: cell range selection is only available in AG Grid Enterprise');
+        }
         this.rangeService.removeAllCellRanges();
     };
     /** Reverts the last cell edit. */
@@ -31714,18 +32112,30 @@ var GridApi = /** @class */ (function () {
     };
     /** Copies data to clipboard by following the same rules as pressing Ctrl+C. */
     GridApi.prototype.copyToClipboard = function (params) {
+        if (!this.clipboardService) {
+            console.warn('AG Grid: clipboard is only available in AG Grid Enterprise');
+        }
         this.clipboardService.copyToClipboard(params);
     };
     /** Copies the selected rows to the clipboard. */
     GridApi.prototype.copySelectedRowsToClipboard = function (params) {
+        if (!this.clipboardService) {
+            console.warn('AG Grid: clipboard is only available in AG Grid Enterprise');
+        }
         this.clipboardService.copySelectedRowsToClipboard(params);
     };
     /** Copies the selected ranges to the clipboard. */
     GridApi.prototype.copySelectedRangeToClipboard = function (params) {
+        if (!this.clipboardService) {
+            console.warn('AG Grid: clipboard is only available in AG Grid Enterprise');
+        }
         this.clipboardService.copySelectedRangeToClipboard(params);
     };
     /** Copies the selected range down, similar to `Ctrl + D` in Excel. */
     GridApi.prototype.copySelectedRangeDown = function () {
+        if (!this.clipboardService) {
+            console.warn('AG Grid: clipboard is only available in AG Grid Enterprise');
+        }
         this.clipboardService.copyRangeDown();
     };
     /** Shows the column menu after and positions it relative to the provided button element. Use in conjunction with your own header template. */
@@ -31742,6 +32152,7 @@ var GridApi = /** @class */ (function () {
             column = this.columnModel.getPrimaryColumn(colKey);
         }
         if (!column) {
+            console.error("AG Grid: column '" + colKey + "' not found");
             return;
         }
         this.menuFactory.showMenuAfterMouseEvent(column, mouseEvent);
@@ -31794,6 +32205,7 @@ var GridApi = /** @class */ (function () {
     GridApi.prototype.startEditingCell = function (params) {
         var column = this.columnModel.getGridColumn(params.colKey);
         if (!column) {
+            console.warn("AG Grid: no column found for " + params.colKey);
             return;
         }
         var cellPosition = {
@@ -31832,12 +32244,14 @@ var GridApi = /** @class */ (function () {
     /** Apply transactions to the server side row model. */
     GridApi.prototype.applyServerSideTransaction = function (transaction) {
         if (!this.serverSideTransactionManager) {
+            console.warn('AG Grid: Cannot apply Server Side Transaction if not using the Server Side Row Model.');
             return;
         }
         return this.serverSideTransactionManager.applyTransaction(transaction);
     };
     GridApi.prototype.applyServerSideTransactionAsync = function (transaction, callback) {
         if (!this.serverSideTransactionManager) {
+            console.warn('AG Grid: Cannot apply Server Side Transaction if not using the Server Side Row Model.');
             return;
         }
         return this.serverSideTransactionManager.applyTransactionAsync(transaction, callback);
@@ -31845,12 +32259,14 @@ var GridApi = /** @class */ (function () {
     /** Gets all failed server side loads to retry. */
     GridApi.prototype.retryServerSideLoads = function () {
         if (!this.serverSideRowModel) {
+            console.warn('AG Grid: API retryServerSideLoads() can only be used when using Server-Side Row Model.');
             return;
         }
         this.serverSideRowModel.retryLoads();
     };
     GridApi.prototype.flushServerSideAsyncTransactions = function () {
         if (!this.serverSideTransactionManager) {
+            console.warn('AG Grid: Cannot flush Server Side Transaction if not using the Server Side Row Model.');
             return;
         }
         return this.serverSideTransactionManager.flushAsyncTransactions();
@@ -31858,6 +32274,7 @@ var GridApi = /** @class */ (function () {
     /** Update row data. Pass a transaction object with lists for `add`, `remove` and `update`. */
     GridApi.prototype.applyTransaction = function (rowDataTransaction) {
         if (!this.clientSideRowModel) {
+            console.error('AG Grid: updateRowData() only works with ClientSideRowModel. Working with InfiniteRowModel was deprecated in v23.1 and removed in v24.1');
             return;
         }
         var res = this.clientSideRowModel.updateRowData(rowDataTransaction);
@@ -31875,12 +32292,14 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated AG Grid: as of v23.1, grid API updateRowData(transaction) is now called applyTransaction(transaction). */
     GridApi.prototype.updateRowData = function (rowDataTransaction) {
-        doOnce(function () { return (void 0); }, 'updateRowData deprecated');
+        var message = 'AG Grid: as of v23.1, grid API updateRowData(transaction) is now called applyTransaction(transaction). updateRowData is deprecated and will be removed in a future major release.';
+        doOnce(function () { return console.warn(message); }, 'updateRowData deprecated');
         return this.applyTransaction(rowDataTransaction);
     };
     /** Same as `applyTransaction` except executes asynchronously for efficiency. */
     GridApi.prototype.applyTransactionAsync = function (rowDataTransaction, callback) {
         if (!this.clientSideRowModel) {
+            console.error('AG Grid: api.applyTransactionAsync() only works with ClientSideRowModel.');
             return;
         }
         this.clientSideRowModel.batchUpdateRowData(rowDataTransaction, callback);
@@ -31888,34 +32307,41 @@ var GridApi = /** @class */ (function () {
     /** Executes any remaining asynchronous grid transactions, if any are waiting to be executed. */
     GridApi.prototype.flushAsyncTransactions = function () {
         if (!this.clientSideRowModel) {
+            console.error('AG Grid: api.applyTransactionAsync() only works with ClientSideRowModel.');
             return;
         }
         this.clientSideRowModel.flushAsyncTransactions();
     };
     /** @deprecated AG Grid: as of v23.1, grid API batchUpdateRowData(transaction, callback) is now called applyTransactionAsync(transaction, callback). */
     GridApi.prototype.batchUpdateRowData = function (rowDataTransaction, callback) {
-        doOnce(function () { return (void 0); }, 'batchUpdateRowData deprecated');
+        var message = 'AG Grid: as of v23.1, grid API batchUpdateRowData(transaction, callback) is now called applyTransactionAsync(transaction, callback). batchUpdateRowData is deprecated and will be removed in a future major release.';
+        doOnce(function () { return console.warn(message); }, 'batchUpdateRowData deprecated');
         this.applyTransactionAsync(rowDataTransaction, callback);
     };
     /** @deprecated AG Grid: insertItemsAtIndex() is deprecated, use updateRowData(transaction) instead.*/
     GridApi.prototype.insertItemsAtIndex = function (index, items, skipRefresh) {
+        console.warn('AG Grid: insertItemsAtIndex() is deprecated, use updateRowData(transaction) instead.');
         this.updateRowData({ add: items, addIndex: index, update: null, remove: null });
     };
     /** @deprecated AG Grid: removeItems() is deprecated, use updateRowData(transaction) instead. */
     GridApi.prototype.removeItems = function (rowNodes, skipRefresh) {
+        console.warn('AG Grid: removeItems() is deprecated, use updateRowData(transaction) instead.');
         var dataToRemove = rowNodes.map(function (rowNode) { return rowNode.data; });
         this.updateRowData({ add: null, addIndex: null, update: null, remove: dataToRemove });
     };
     /** @deprecated AG Grid: addItems() is deprecated, use updateRowData(transaction) instead. */
     GridApi.prototype.addItems = function (items, skipRefresh) {
+        console.warn('AG Grid: addItems() is deprecated, use updateRowData(transaction) instead.');
         this.updateRowData({ add: items, addIndex: null, update: null, remove: null });
     };
     /** @deprecated AG Grid: refreshVirtualPageCache() is now called refreshInfiniteCache(), please call refreshInfiniteCache() instead */
     GridApi.prototype.refreshVirtualPageCache = function () {
+        console.warn('AG Grid: refreshVirtualPageCache() is now called refreshInfiniteCache(), please call refreshInfiniteCache() instead');
         this.refreshInfiniteCache();
     };
     /** @deprecated AG Grid: refreshInfinitePageCache() is now called refreshInfiniteCache(), please call refreshInfiniteCache() instead */
     GridApi.prototype.refreshInfinitePageCache = function () {
+        console.warn('AG Grid: refreshInfinitePageCache() is now called refreshInfiniteCache(), please call refreshInfiniteCache() instead');
         this.refreshInfiniteCache();
     };
     /**
@@ -31927,13 +32353,18 @@ var GridApi = /** @class */ (function () {
         if (this.infiniteRowModel) {
             this.infiniteRowModel.refreshCache();
         }
+        else {
+            console.warn("AG Grid: api.refreshInfiniteCache is only available when rowModelType='infinite'.");
+        }
     };
     /** @deprecated AG Grid: purgeVirtualPageCache() is now called purgeInfiniteCache(), please call purgeInfiniteCache() instead */
     GridApi.prototype.purgeVirtualPageCache = function () {
+        console.warn('AG Grid: purgeVirtualPageCache() is now called purgeInfiniteCache(), please call purgeInfiniteCache() instead');
         this.purgeInfinitePageCache();
     };
     /** @deprecated AG Grid: purgeInfinitePageCache() is now called purgeInfiniteCache(), please call purgeInfiniteCache() instead */
     GridApi.prototype.purgeInfinitePageCache = function () {
+        console.warn('AG Grid: purgeInfinitePageCache() is now called purgeInfiniteCache(), please call purgeInfiniteCache() instead');
         this.purgeInfiniteCache();
     };
     /**
@@ -31946,20 +32377,28 @@ var GridApi = /** @class */ (function () {
         if (this.infiniteRowModel) {
             this.infiniteRowModel.purgeCache();
         }
+        else {
+            console.warn("AG Grid: api.purgeInfiniteCache is only available when rowModelType='infinite'.");
+        }
     };
     /** @deprecated AG Grid: since version 18.x, api.purgeEnterpriseCache() should be replaced with api.refreshServerSide({purge: true}) */
     GridApi.prototype.purgeEnterpriseCache = function (route) {
+        console.warn("AG Grid: since version 18.x, api.purgeEnterpriseCache() should be replaced with api.refreshServerSide({purge: true})");
         this.purgeServerSideCache(route);
     };
     /** @deprecated AG Grid: since v25.0, api.purgeServerSideCache is deprecated. Please use api.refreshServerSide({purge: true}) instead. */
     GridApi.prototype.purgeServerSideCache = function (route) {
         if (route === void 0) { route = []; }
         if (this.serverSideRowModel) {
+            console.warn("AG Grid: since v25.0, api.purgeServerSideCache is deprecated. Please use api.refreshServerSide({purge: true}) instead.");
             this.refreshServerSide({
                 route: route,
                 purge: true
             });
         }
+        else {
+            console.warn("AG Grid: api.purgeServerSideCache is only available when rowModelType='serverSide'.");
+        }
     };
     /**
      * Refresh a server-side level.
@@ -31968,29 +32407,34 @@ var GridApi = /** @class */ (function () {
      */
     GridApi.prototype.refreshServerSide = function (params) {
         if (!this.serverSideRowModel) {
+            console.warn("AG Grid: api.refreshServerSide is only available when rowModelType='serverSide'.");
             return;
         }
         this.serverSideRowModel.refreshStore(params);
     };
     /** @deprecated use `refreshServerSide` instead */
     GridApi.prototype.refreshServerSideStore = function (params) {
-        doOnce(function () { return (void 0); }, 'refreshServerSideStore-renamed');
+        var message = "AG Grid: Grid API refreshServerSideStore() was renamed to refreshServerSide() in v28.0";
+        doOnce(function () { return console.warn(message); }, 'refreshServerSideStore-renamed');
         return this.refreshServerSide(params);
     };
     /** @deprecated use `getServerSideGroupLevelState` instead */
     GridApi.prototype.getServerSideStoreState = function () {
-        doOnce(function () { return (void 0); }, 'getServerSideStoreState-renamed');
+        var message = "AG Grid: Grid API getServerSideStoreState() was renamed to getServerSideGroupLevelState() in v28.0";
+        doOnce(function () { return console.warn(message); }, 'getServerSideStoreState-renamed');
         return this.getServerSideGroupLevelState();
     };
     /** Returns info on all server side group levels. */
     GridApi.prototype.getServerSideGroupLevelState = function () {
         if (!this.serverSideRowModel) {
+            console.warn("AG Grid: api.getServerSideGroupLevelState is only available when rowModelType='serverSide'.");
             return [];
         }
         return this.serverSideRowModel.getStoreState();
     };
     /** @deprecated AG Grid: getVirtualRowCount() is now called getInfiniteRowCount(), please call getInfiniteRowCount() instead */
     GridApi.prototype.getVirtualRowCount = function () {
+        console.warn('AG Grid: getVirtualRowCount() is now called getInfiniteRowCount(), please call getInfiniteRowCount() instead');
         return this.getInfiniteRowCount();
     };
     /** The row count defines how many rows the grid allows scrolling to. */
@@ -31998,9 +32442,13 @@ var GridApi = /** @class */ (function () {
         if (this.infiniteRowModel) {
             return this.infiniteRowModel.getRowCount();
         }
+        else {
+            console.warn("AG Grid: api.getVirtualRowCount is only available when rowModelType='virtual'.");
+        }
     };
     /** @deprecated AG Grid: api.isMaxRowFound is deprecated, please use api.isLastRowIndexKnown() */
     GridApi.prototype.isMaxRowFound = function () {
+        console.warn("AG Grid: api.isMaxRowFound is deprecated, please use api.isLastRowIndexKnown()");
         return this.isLastRowIndexKnown();
     };
     /** Returns `true` if grid allows for scrolling past the last row to load more rows, thus providing infinite scroll. */
@@ -32008,13 +32456,18 @@ var GridApi = /** @class */ (function () {
         if (this.infiniteRowModel) {
             return this.infiniteRowModel.isLastRowIndexKnown();
         }
+        else {
+            console.warn("AG Grid: api.isMaxRowFound is only available when rowModelType='virtual'.");
+        }
     };
     /** @deprecated AG Grid: setVirtualRowCount() is now called setInfiniteRowCount(), please call setInfiniteRowCount() instead */
     GridApi.prototype.setVirtualRowCount = function (rowCount, maxRowFound) {
+        console.warn('AG Grid: setVirtualRowCount() is now called setInfiniteRowCount(), please call setInfiniteRowCount() instead');
         this.setRowCount(rowCount, maxRowFound);
     };
     /** @deprecated AG Grid: setInfiniteRowCount() is now called setRowCount(), please call setRowCount() instead */
     GridApi.prototype.setInfiniteRowCount = function (rowCount, maxRowFound) {
+        console.warn('AG Grid: setInfiniteRowCount() is now called setRowCount(), please call setRowCount() instead');
         this.setRowCount(rowCount, maxRowFound);
     };
     /**
@@ -32028,13 +32481,18 @@ var GridApi = /** @class */ (function () {
         if (this.infiniteRowModel) {
             this.infiniteRowModel.setRowCount(rowCount, maxRowFound);
         }
+        else {
+            console.warn("AG Grid: api.setRowCount is only available for Infinite Row Model.");
+        }
     };
     /** @deprecated AG Grid: getVirtualPageState() is now called getCacheBlockState(), please call getCacheBlockState() instead */
     GridApi.prototype.getVirtualPageState = function () {
+        console.warn('AG Grid: getVirtualPageState() is now called getCacheBlockState(), please call getCacheBlockState() instead');
         return this.getCacheBlockState();
     };
     /** @deprecated getInfinitePageState() is now called getCacheBlockState(), please call getCacheBlockState() instead */
     GridApi.prototype.getInfinitePageState = function () {
+        console.warn('AG Grid: getInfinitePageState() is now called getCacheBlockState(), please call getCacheBlockState() instead');
         return this.getCacheBlockState();
     };
     /**
@@ -32045,9 +32503,11 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated  In AG Grid v25.2.0, checkGridSize() was removed, as it was legacy and didn't do anything useful. */
     GridApi.prototype.checkGridSize = function () {
+        console.warn("In AG Grid v25.2.0, checkGridSize() was removed, as it was legacy and didn't do anything useful.");
     };
     /** @deprecated  In AG Grid v12, getFirstRenderedRow() was renamed to getFirstDisplayedRow() */
     GridApi.prototype.getFirstRenderedRow = function () {
+        console.warn('In AG Grid v12, getFirstRenderedRow() was renamed to getFirstDisplayedRow()');
         return this.getFirstDisplayedRow();
     };
     /** Get the index of the first displayed row due to scrolling (includes invisible rendered rows in the buffer). */
@@ -32056,6 +32516,7 @@ var GridApi = /** @class */ (function () {
     };
     /** @deprecated In AG Grid v12, getLastRenderedRow() was renamed to getLastDisplayedRow() */
     GridApi.prototype.getLastRenderedRow = function () {
+        console.warn('in AG Grid v12, getLastRenderedRow() was renamed to getLastDisplayedRow()');
         return this.getLastDisplayedRow();
     };
     /** Get the index of the last displayed row due to scrolling (includes invisible rendered rows in the buffer). */
@@ -33107,7 +33568,11 @@ var SelectAllFeature = /** @class */ (function (_super) {
         };
     };
     SelectAllFeature.prototype.checkRightRowModelType = function () {
-        this.rowModel.getType();
+        var rowModelType = this.rowModel.getType();
+        var rowModelMatches = rowModelType === Constants.ROW_MODEL_TYPE_CLIENT_SIDE;
+        if (!rowModelMatches) {
+            console.warn("AG Grid: selectAllCheckbox is only available if using normal row model, you are using " + rowModelType);
+        }
     };
     SelectAllFeature.prototype.onCbSelectAll = function () {
         if (this.processingEventFromCheckbox) {
@@ -33139,12 +33604,15 @@ var SelectAllFeature = /** @class */ (function (_super) {
         }
         if (result) {
             if (this.gridOptionsWrapper.isRowModelServerSide()) {
+                console.warn('AG Grid: headerCheckboxSelection is not supported for Server Side Row Model');
                 return false;
             }
             if (this.gridOptionsWrapper.isRowModelInfinite()) {
+                console.warn('AG Grid: headerCheckboxSelection is not supported for Infinite Row Model');
                 return false;
             }
             if (this.gridOptionsWrapper.isRowModelViewport()) {
+                console.warn('AG Grid: headerCheckboxSelection is not supported for Viewport Row Model');
                 return false;
             }
             // otherwise the row model is compatible, so return true
@@ -35761,6 +36229,9 @@ var AnimationFrameService = /** @class */ (function (_super) {
     // frames. this stops bugs - where some code is asking for a frame to be executed
     // when it should not.
     AnimationFrameService.prototype.verifyAnimationFrameOn = function (methodName) {
+        if (this.useAnimationFrame === false) {
+            console.warn("AG Grid: AnimationFrameService." + methodName + " called but animation frames are off");
+        }
     };
     AnimationFrameService.prototype.createTask = function (task, index, list) {
         this.verifyAnimationFrameOn(list);
@@ -36997,10 +37468,10 @@ var RowRenderer = /** @class */ (function (_super) {
         this.addManagedListener(this.gridOptionsWrapper, GridOptionsWrapper.PROP_ROW_CLASS, this.redrawRows.bind(this));
         if (this.gridOptionsWrapper.isGroupRowsSticky()) {
             if (this.rowModel.getType() != Constants.ROW_MODEL_TYPE_CLIENT_SIDE) {
-                doOnce(function () { return (void 0); }, 'rowRenderer.stickyWorksWithCsrmOnly');
+                doOnce(function () { return console.warn('AG Grid: The feature Sticky Row Groups only works with the Client Side Row Model'); }, 'rowRenderer.stickyWorksWithCsrmOnly');
             }
             else if (this.gridOptionsWrapper.isTreeData()) {
-                doOnce(function () { return (void 0); }, 'rowRenderer.stickyDoesNotWorkWithTreeData');
+                doOnce(function () { return console.warn('AG Grid: The feature Sticky Row Groups does not work with Tree Data.'); }, 'rowRenderer.stickyDoesNotWorkWithTreeData');
             }
             else {
                 this.stickyRowFeature = this.createManagedBean(new StickyRowFeature(this.createRowCon.bind(this), this.destroyRowCtrls.bind(this)));
@@ -41144,7 +41615,9 @@ var AgMenuList = /** @class */ (function (_super) {
             if (menuItemOrString === 'separator') {
                 _this.addSeparator();
             }
-            else if (typeof menuItemOrString === 'string') ;
+            else if (typeof menuItemOrString === 'string') {
+                console.warn("AG Grid: unrecognised menu item " + menuItemOrString);
+            }
             else {
                 _this.addItem(menuItemOrString);
             }
@@ -41509,7 +41982,9 @@ var AgMenuItemComponent = /** @class */ (function (_super) {
             else if (typeof this.params.icon === 'string') {
                 icon.innerHTML = this.params.icon;
             }
-            else ;
+            else {
+                console.warn('AG Grid: menu item icon must be DOM node or string');
+            }
         }
         this.getGui().appendChild(icon);
     };
@@ -42459,6 +42934,7 @@ var PopupService = /** @class */ (function (_super) {
         var eDocument = this.gridOptionsWrapper.getDocument();
         var destroyPositionTracker = new AgPromise(function (resolve) { return resolve(function () { }); });
         if (!eDocument) {
+            console.warn('ag-grid: could not find the document, document is empty');
             return { hideFunc: function () { }, stopAnchoringPromise: destroyPositionTracker };
         }
         var pos = this.popupList.findIndex(function (popup) { return popup.element === eChild; });
@@ -42871,6 +43347,7 @@ var VirtualList = /** @class */ (function (_super) {
     VirtualList.prototype.ensureIndexVisible = function (index) {
         var lastRow = this.model.getRowCount();
         if (typeof index !== 'number' || index < 0 || index >= lastRow) {
+            console.warn('AG Grid: invalid row index for ensureIndexVisible: ' + index);
             return;
         }
         var rowTopPixel = index * this.rowHeight;
@@ -43174,6 +43651,7 @@ var CellNavigationService = /** @class */ (function (_super) {
                     break;
                 default:
                     pointer = null;
+                    console.warn('AG Grid: unknown key for navigation ' + key);
                     break;
             }
             if (pointer) {
@@ -43568,6 +44046,12 @@ var AlignedGridsService = /** @class */ (function (_super) {
                     var groupOpenedEvent = event;
                     _this.processGroupOpenedEvent(groupOpenedEvent);
                     break;
+                case Events.EVENT_COLUMN_PIVOT_CHANGED:
+                    // we cannot support pivoting with aligned grids as the columns will be out of sync as the
+                    // grids will have columns created based on the row data of the grid.
+                    console.warn('AG Grid: pivoting is not supported with aligned grids. ' +
+                        'You can only use one of these features at a time in a grid.');
+                    break;
             }
         });
     };
@@ -43869,11 +44353,13 @@ var SelectionService = /** @class */ (function (_super) {
     // where groups don't actually appear in the selection normally.
     SelectionService.prototype.getBestCostNodeSelection = function () {
         if (this.rowModel.getType() !== Constants.ROW_MODEL_TYPE_CLIENT_SIDE) {
+            console.warn('AG Grid: `getBestCostNodeSelection` is only available when using normal row model');
             return;
         }
         var clientSideRowModel = this.rowModel;
         var topLevelNodes = clientSideRowModel.getTopLevelNodes();
         if (topLevelNodes === null) {
+            console.warn('AG Grid: `selectAll` not available doing `rowModel=virtual`');
             return;
         }
         var result = [];
@@ -43915,6 +44401,7 @@ var SelectionService = /** @class */ (function (_super) {
         var rowModelClientSide = this.rowModel.getType() === Constants.ROW_MODEL_TYPE_CLIENT_SIDE;
         if (justFiltered) {
             if (!rowModelClientSide) {
+                console.error('AG Grid: selecting just filtered only works with In Memory Row Model');
                 return;
             }
             var clientSideRowModel = this.rowModel;
@@ -44027,6 +44514,11 @@ var ColumnApi = /** @class */ (function () {
     }
     /** Gets the grid to size the columns to the specified width in pixels, e.g. `sizeColumnsToFit(900)`. To have the grid fit the columns to the grid's width, use the Grid API `gridApi.sizeColumnsToFit()` instead. */
     ColumnApi.prototype.sizeColumnsToFit = function (gridWidth) {
+        // AG-3403 validate that gridWidth is provided because this method has the same name as
+        // a method on the grid API that takes no arguments, and it's easy to confuse the two
+        if (typeof gridWidth === "undefined") {
+            console.error('AG Grid: missing parameter to columnApi.sizeColumnsToFit(gridWidth)');
+        }
         this.columnModel.sizeColumnsToFit(gridWidth, 'api');
     };
     /** Call this if you want to open or close a column group. */
@@ -44095,6 +44587,7 @@ var ColumnApi = /** @class */ (function () {
     ColumnApi.prototype.moveColumn = function (key, toIndex) {
         if (typeof key === 'number') {
             // moveColumn used to take indexes, so this is advising user who hasn't moved to new method name
+            console.warn('AG Grid: you are using moveColumn(fromIndex, toIndex) - moveColumn takes a column key and a destination index, not two indexes, to move with indexes use moveColumnByIndex(from,to) instead');
             this.columnModel.moveColumnByIndex(key, toIndex, 'api');
         }
         else {
@@ -44125,6 +44618,7 @@ var ColumnApi = /** @class */ (function () {
     ColumnApi.prototype.isPivotMode = function () { return this.columnModel.isPivotMode(); };
     /** @deprecated Use `getPivotResultColumn` instead */
     ColumnApi.prototype.getSecondaryPivotColumn = function (pivotKeys, valueColKey) {
+        console.warn('AG Grid: since version 28.0.x getSecondaryPivotColumn has been renamed, please use getPivotResultColumn instead');
         return this.getPivotResultColumn(pivotKeys, valueColKey);
     };
     /** Returns the pivot result column for the given `pivotKeys` and `valueColId`. Useful to then call operations on the pivot column. */
@@ -44183,18 +44677,21 @@ var ColumnApi = /** @class */ (function () {
     ColumnApi.prototype.autoSizeAllColumns = function (skipHeader) { this.columnModel.autoSizeAllColumns(skipHeader, 'api'); };
     /** @deprecated Use `setPivotResultColumns` instead. */
     ColumnApi.prototype.setSecondaryColumns = function (colDefs) {
+        console.warn('AG Grid: since version 28.0.x setSecondaryColumns has been renamed, please use setPivotResultColumns instead');
         this.setPivotResultColumns(colDefs);
     };
     /** Set the pivot result columns. */
     ColumnApi.prototype.setPivotResultColumns = function (colDefs) { this.columnModel.setSecondaryColumns(colDefs, 'api'); };
     /** @deprecated Use `getPivotResultColumns` instead. */
     ColumnApi.prototype.getSecondaryColumns = function () {
+        console.warn('AG Grid: since version 28.0.x getSecondaryColumns has been renamed, please use getPivotResultColumns instead');
         return this.getPivotResultColumns();
     };
     /** Returns the grid's pivot result columns. */
     ColumnApi.prototype.getPivotResultColumns = function () { return this.columnModel.getSecondaryColumns(); };
     /** @deprecated Use `getColumns` instead. */
     ColumnApi.prototype.getPrimaryColumns = function () {
+        console.warn('AG Grid: since version 28.0.x getPrimaryColumns has been renamed, please use getColumns instead');
         return this.getColumns();
     };
     ColumnApi.prototype.cleanDownReferencesToAvoidMemoryLeakInCaseApplicationIsKeepingReferenceToDestroyedGrid = function () {
@@ -44213,66 +44710,82 @@ var ColumnApi = /** @class */ (function () {
     // }
     /** @deprecated Use `getColumns` instead */
     ColumnApi.prototype.getAllColumns = function () {
+        console.warn('AG Grid: since version 28.0.x getAllColumns has been renamed, please use getColumns instead');
         return this.getColumns();
     };
     /** @deprecated columnGroupOpened no longer exists, use setColumnGroupOpened */
     ColumnApi.prototype.columnGroupOpened = function (group, newValue) {
+        console.error('AG Grid: columnGroupOpened no longer exists, use setColumnGroupOpened');
         this.setColumnGroupOpened(group, newValue);
     };
     /** @deprecated hideColumns is deprecated, use setColumnsVisible */
     ColumnApi.prototype.hideColumns = function (colIds, hide) {
+        console.error('AG Grid: hideColumns is deprecated, use setColumnsVisible');
         this.columnModel.setColumnsVisible(colIds, !hide, 'api');
     };
     /** @deprecated hideColumn is deprecated, use setColumnVisible */
     ColumnApi.prototype.hideColumn = function (colId, hide) {
+        console.error('AG Grid: hideColumn is deprecated, use setColumnVisible');
         this.columnModel.setColumnVisible(colId, !hide, 'api');
     };
     /** @deprecated setState is deprecated, use setColumnState */
     ColumnApi.prototype.setState = function (columnState) {
+        console.error('AG Grid: setState is deprecated, use setColumnState');
         return this.setColumnState(columnState);
     };
     /** @deprecated getState is deprecated, use getColumnState */
     ColumnApi.prototype.getState = function () {
+        console.error('AG Grid: getState is deprecated, use getColumnState');
         return this.getColumnState();
     };
     /** @deprecated resetState is deprecated, use resetColumnState */
     ColumnApi.prototype.resetState = function () {
+        console.error('AG Grid: resetState is deprecated, use resetColumnState');
         this.resetColumnState();
     };
     /** @deprecated getAggregationColumns is deprecated, use getValueColumns */
     ColumnApi.prototype.getAggregationColumns = function () {
+        console.error('AG Grid: getAggregationColumns is deprecated, use getValueColumns');
         return this.columnModel.getValueColumns();
     };
     /** @deprecated removeAggregationColumn is deprecated, use removeValueColumn */
     ColumnApi.prototype.removeAggregationColumn = function (colKey) {
+        console.error('AG Grid: removeAggregationColumn is deprecated, use removeValueColumn');
         this.columnModel.removeValueColumn(colKey, 'api');
     };
     /** @deprecated removeAggregationColumns is deprecated, use removeValueColumns */
     ColumnApi.prototype.removeAggregationColumns = function (colKeys) {
+        console.error('AG Grid: removeAggregationColumns is deprecated, use removeValueColumns');
         this.columnModel.removeValueColumns(colKeys, 'api');
     };
     /** @deprecated addAggregationColumn is deprecated, use addValueColumn */
     ColumnApi.prototype.addAggregationColumn = function (colKey) {
+        console.error('AG Grid: addAggregationColumn is deprecated, use addValueColumn');
         this.columnModel.addValueColumn(colKey, 'api');
     };
     /** @deprecated addAggregationColumns is deprecated, use addValueColumns */
     ColumnApi.prototype.addAggregationColumns = function (colKeys) {
+        console.error('AG Grid: addAggregationColumns is deprecated, use addValueColumns');
         this.columnModel.addValueColumns(colKeys, 'api');
     };
     /** @deprecated setColumnAggFunction is deprecated, use setColumnAggFunc */
     ColumnApi.prototype.setColumnAggFunction = function (column, aggFunc) {
+        console.error('AG Grid: setColumnAggFunction is deprecated, use setColumnAggFunc');
         this.columnModel.setColumnAggFunc(column, aggFunc, 'api');
     };
     /** @deprecated getDisplayNameForCol is deprecated, use getDisplayNameForColumn */
     ColumnApi.prototype.getDisplayNameForCol = function (column) {
+        console.error('AG Grid: getDisplayNameForCol is deprecated, use getDisplayNameForColumn');
         return this.getDisplayNameForColumn(column, null);
     };
     /** @deprecated setColumnState is deprecated, use applyColumnState. */
     ColumnApi.prototype.setColumnState = function (columnState) {
+        console.error('AG Grid: setColumnState is deprecated, use applyColumnState');
         return this.columnModel.applyColumnState({ state: columnState, applyOrder: true }, 'api');
     };
     /** @deprecated getOriginalColumnGroup is deprecated, use getProvidedColumnGroup. */
     ColumnApi.prototype.getOriginalColumnGroup = function (name) {
+        console.error('AG Grid: getOriginalColumnGroup is deprecated, use getProvidedColumnGroup');
         return this.columnModel.getProvidedColumnGroup(name);
     };
     __decorate$1n([
@@ -44425,6 +44938,7 @@ var ValueService = /** @class */ (function (_super) {
         // need either a field or a newValueHandler for this to work
         if (missing(field) && missing(newValueHandler) && missing(valueSetter)) {
             // we don't tell user about newValueHandler, as that is deprecated
+            console.warn("AG Grid: you need either field or valueSetter set on colDef for editing to work");
             return false;
         }
         var params = {
@@ -44601,6 +45115,7 @@ var ValueService = /** @class */ (function (_super) {
         result = String(result);
         if (result === '[object Object]') {
             doOnce(function () {
+                console.warn('AG Grid: a column you are grouping or pivoting by has objects as values. If you want to group by complex objects then either a) use a colDef.keyCreator (se AG Grid docs) or b) to toString() on the object to return a key');
             }, 'getKeyForNode - warn about [object,object]');
         }
         return result;
@@ -44672,7 +45187,9 @@ var ExpressionService = /** @class */ (function (_super) {
             var expression = expressionOrFunc;
             return this.evaluateExpression(expression, params);
         }
-        else ;
+        else {
+            console.error('AG Grid: value should be either a string or a function', expressionOrFunc);
+        }
     };
     ExpressionService.prototype.evaluateExpression = function (expression, params) {
         try {
@@ -44686,9 +45203,13 @@ var ExpressionService = /** @class */ (function (_super) {
             // the expression failed, which can happen, as it's the client that
             // provides the expression. so print a nice message
             // tslint:disable-next-line
+            console.log('Processing of the expression failed');
             // tslint:disable-next-line
+            console.log('Expression = ' + expression);
             // tslint:disable-next-line
+            console.log('Params =', params);
             // tslint:disable-next-line
+            console.log('Exception = ' + e);
             return null;
         }
     };
@@ -44786,6 +45307,7 @@ var TemplateService = /** @class */ (function (_super) {
     };
     TemplateService.prototype.handleHttpResult = function (httpResult, url) {
         if (httpResult.status !== 200 || httpResult.response === null) {
+            console.warn("AG Grid: Unable to get template error " + httpResult.status + " - " + url);
             return;
         }
         // response success, so process it
@@ -44866,7 +45388,10 @@ var Logger = /** @class */ (function () {
         return this.isLoggingFunc();
     };
     Logger.prototype.log = function (message) {
-        if (this.isLoggingFunc()) ;
+        if (this.isLoggingFunc()) {
+            // tslint:disable-next-line
+            console.log('AG Grid.' + this.name + ': ' + message);
+        }
     };
     return Logger;
 }());
@@ -45266,6 +45791,7 @@ var SortController = /** @class */ (function (_super) {
             sortingOrder = SortController_1.DEFAULT_SORTING_ORDER;
         }
         if (!Array.isArray(sortingOrder) || sortingOrder.length <= 0) {
+            console.warn("AG Grid: sortingOrder must be an array with at least one element, currently it's " + sortingOrder);
             return null;
         }
         var currentIndex = sortingOrder.indexOf(column.getSort());
@@ -45280,6 +45806,7 @@ var SortController = /** @class */ (function (_super) {
         }
         // verify the sort type exists, as the user could provide the sortingOrder, need to make sure it's valid
         if (SortController_1.DEFAULT_SORTING_ORDER.indexOf(result) < 0) {
+            console.warn('AG Grid: invalid sort type ' + result);
             return null;
         }
         return result;
@@ -45608,6 +46135,7 @@ var AutoGroupColService = /** @class */ (function (_super) {
         var doingTreeData = this.gridOptionsWrapper.isTreeData();
         var doingMultiAutoColumn = this.gridOptionsWrapper.isGroupMultiAutoColumn();
         if (doingTreeData && doingMultiAutoColumn) {
+            console.warn('AG Grid: you cannot mix groupMultiAutoColumn with treeData, only one column can be used to display groups when doing tree data');
             doingMultiAutoColumn = false;
         }
         // if doing groupMultiAutoColumn, then we call the method multiple times, once
@@ -46291,8 +46819,8 @@ var Environment = /** @class */ (function (_super) {
         var theme = themeMatch[0];
         var usingOldTheme = themeMatch[2] === undefined;
         if (usingOldTheme) {
-            theme.replace('ag-', 'ag-theme-');
-            doOnce(function () { return (void 0); }, 'using-old-theme');
+            var newTheme_1 = theme.replace('ag-', 'ag-theme-');
+            doOnce(function () { return console.warn("AG Grid: As of v19 old theme are no longer provided. Please replace " + theme + " with " + newTheme_1 + "."); }, 'using-old-theme');
         }
         return { theme: theme, el: el, themeFamily: theme.replace(/-dark$/, ''), allThemes: allThemes };
     };
@@ -47798,6 +48326,7 @@ var RowCssClassCalculator = /** @class */ (function () {
         var rowClass = this.gridOptionsWrapper.getRowClass();
         if (rowClass) {
             if (typeof rowClass === 'function') {
+                console.warn('AG Grid: rowClass should not be a function, please use getRowClass instead');
                 return [];
             }
             process(rowClass);
@@ -48638,6 +49167,7 @@ var __spread$6 = (undefined && undefined.__spread) || function () {
 var Grid = /** @class */ (function () {
     function Grid(eGridDiv, gridOptions, params) {
         if (!gridOptions) {
+            console.error('AG Grid: no gridOptions provided to the grid');
             return;
         }
         this.gridOptions = gridOptions;
@@ -48843,7 +49373,32 @@ var GridCoreCreator = /** @class */ (function () {
         if (exists(rowModelClass)) {
             return rowModelClass;
         }
-        if (ModuleRegistry.isPackageBased()) ;
+        if (ModuleRegistry.isPackageBased()) {
+            if ([Constants.ROW_MODEL_TYPE_VIEWPORT, Constants.ROW_MODEL_TYPE_SERVER_SIDE].includes(rowModelType)) {
+                // If package based only the enterprise row models could be missing.
+                console.error("AG Grid: Row Model \"" + rowModelType + "\" not found. Please ensure the package 'ag-grid-enterprise' is imported. Please see: https://www.ag-grid.com/javascript-grid/packages/");
+            }
+            else {
+                console.error('AG Grid: could not find row model for rowModelType ' + rowModelType);
+            }
+        }
+        else {
+            if (rowModelType === Constants.ROW_MODEL_TYPE_INFINITE) {
+                console.error("AG Grid: Row Model \"Infinite\" not found. Please ensure the " + ModuleNames.InfiniteRowModelModule + " module is registered. Please see: https://www.ag-grid.com/javascript-grid/modules/");
+            }
+            else if (rowModelType === Constants.ROW_MODEL_TYPE_VIEWPORT) {
+                console.error("AG Grid: Row Model \"Viewport\" not found. Please ensure the AG Grid Enterprise Module " + ModuleNames.ViewportRowModelModule + " module is registered. Please see: https://www.ag-grid.com/javascript-grid/modules/");
+            }
+            else if (rowModelType === Constants.ROW_MODEL_TYPE_SERVER_SIDE) {
+                console.error("AG Grid: Row Model \"Server Side\" not found. Please ensure the AG Grid Enterprise Module " + ModuleNames.ServerSideRowModelModule + " module is registered. Please see: https://www.ag-grid.com/javascript-grid/modules/");
+            }
+            else if (rowModelType === Constants.ROW_MODEL_TYPE_CLIENT_SIDE) {
+                console.error("AG Grid: Row Model \"Client Side\" not found. Please ensure the " + ModuleNames.ClientSideRowModelModule + " module is registered. Please see: https://www.ag-grid.com/javascript-grid/modules/");
+            }
+            else {
+                console.error('AG Grid: could not find row model for rowModelType ' + rowModelType);
+            }
+        }
     };
     return GridCoreCreator;
 }());
@@ -49105,15 +49660,51 @@ var LicenseManager = /** @class */ (function (_super) {
         }
     };
     LicenseManager.prototype.outputInvalidLicenseKey = function () {
+        console.error('*****************************************************************************************************************');
+        console.error('***************************************** AG Grid Enterprise License ********************************************');
+        console.error('********************************************* Invalid License ***************************************************');
+        console.error('* Your license for AG Grid Enterprise is not valid - please contact info@ag-grid.com to obtain a valid license. *');
+        console.error('*****************************************************************************************************************');
+        console.error('*****************************************************************************************************************');
         this.watermarkMessage = "Invalid License";
     };
     LicenseManager.prototype.outputExpiredTrialKey = function (formattedExpiryDate) {
+        console.error('****************************************************************************************************************');
+        console.error('***************************************** AG Grid Enterprise License *******************************************');
+        console.error('*****************************************   Trial Period Expired.    *******************************************');
+        console.error("* Your license for AG Grid Enterprise expired on " + formattedExpiryDate + ".                                                *");
+        console.error('* Please email info@ag-grid.com to purchase a license.                                                         *');
+        console.error('****************************************************************************************************************');
+        console.error('****************************************************************************************************************');
         this.watermarkMessage = "Trial Period Expired";
     };
     LicenseManager.prototype.outputMissingLicenseKey = function () {
+        console.error('****************************************************************************************************************');
+        console.error('***************************************** AG Grid Enterprise License *******************************************');
+        console.error('****************************************** License Key Not Found ***********************************************');
+        console.error('* All AG Grid Enterprise features are unlocked.                                                                *');
+        console.error('* This is an evaluation only version, it is not licensed for development projects intended for production.     *');
+        console.error('* If you want to hide the watermark, please email info@ag-grid.com for a trial license.                        *');
+        console.error('****************************************************************************************************************');
+        console.error('****************************************************************************************************************');
         this.watermarkMessage = "For Trial Use Only";
     };
     LicenseManager.prototype.outputIncompatibleVersion = function (formattedExpiryDate, formattedReleaseDate) {
+        console.error('****************************************************************************************************************************');
+        console.error('****************************************************************************************************************************');
+        console.error('*                                             AG Grid Enterprise License                                                   *');
+        console.error('*                           License not compatible with installed version of AG Grid Enterprise.                           *');
+        console.error('*                                                                                                                          *');
+        console.error("* Your AG Grid License entitles you to all versions of AG Grid that we release within the time covered by your license     *");
+        console.error("* - typically we provide one year licenses which entitles you to all releases / updates of AG Grid within that year.       *");
+        console.error("* Your license has an end (expiry) date which stops the license key working with versions of AG Grid released after the    *");
+        console.error("* license end date. The license key that you have expires on " + formattedExpiryDate + ", however the version of AG Grid you    *");
+        console.error("* are trying to use was released on " + formattedReleaseDate + ".                                                               *");
+        console.error('*                                                                                                                          *');
+        console.error('* Please contact info@ag-grid.com to renew your subscription to new versions and get a new license key to work with this   *');
+        console.error('* version of AG Grid.                                                                                                      *');
+        console.error('****************************************************************************************************************************');
+        console.error('****************************************************************************************************************************');
         this.watermarkMessage = "License Expired";
     };
     var LicenseManager_1;
@@ -49655,14 +50246,20 @@ class DataSource {
           return indexA - indexB;
         });
         this._dataUnit.metadata.fields.forEach(f => {
-          var _a;
+          var _a, _b;
           if (f.visible !== false && f.name !== this.RECORD_ARCHIVE) {
             const props = new Map();
             const properties = this._dataUnit.getField(f.name).properties;
             for (const value in properties) {
               props.set(value, properties[value]);
             }
-            columnDefs.push({ label: f.label, name: f.name, userInterface: f.userInterface, options: (_a = this._dataUnit.getField(f.name).properties) === null || _a === void 0 ? void 0 : _a.options, props });
+            const col = { label: f.label, name: f.name, userInterface: f.userInterface, options: (_a = this._dataUnit.getField(f.name).properties) === null || _a === void 0 ? void 0 : _a.options, props };
+            columnDefs.push(col);
+            if (f.userInterface === UserInterface.SEARCHPLUS && ((_b = f.properties) === null || _b === void 0 ? void 0 : _b.DESCRIPTIONFIELD)) {
+              const descriptionCol = this.buildDescriptionColumn(f);
+              columnDefs.push(descriptionCol);
+              f.properties[PRESENTATION_COL_ID_PROP_NAME] = descriptionCol.name;
+            }
           }
         });
       }
@@ -49672,6 +50269,19 @@ class DataSource {
       console.warn(error);
     }
   }
+  buildDescriptionColumn(field) {
+    var _a, _b, _c, _d;
+    const props = new Map();
+    props.set(PRESENTATION_FROM_COL_PROP_NAME, field.name);
+    const descriptionFieldName = `${(_a = field.properties) === null || _a === void 0 ? void 0 : _a.ENTITYNAME}.${(_b = field.properties) === null || _b === void 0 ? void 0 : _b.DESCRIPTIONFIELD}`;
+    this._dataUnit.addSourceFieldValue(descriptionFieldName, field.name);
+    return {
+      label: `${(_c = field.properties) === null || _c === void 0 ? void 0 : _c.DESCRIPTIONFIELDLABEL} (${(_d = field.properties) === null || _d === void 0 ? void 0 : _d.DESCRIPTIONENTITY})`,
+      name: descriptionFieldName,
+      userInterface: UserInterface.SHORTTEXT,
+      props
+    };
+  }
 }
 
 class EzGridCustomHeader {
@@ -50082,6 +50692,21 @@ const buildSwitch = (fieldMetadata) => {
   return combo;
 };
 
+const buildSearchPlus = ({ name, required, readOnly, dataUnit }) => {
+  const ezSearch = HTMLBuilder.parseElement(`<ez-search-plus
+          class="ez-grid grid_editor"
+          mode="slim"
+          suppress-empty-option=${required}
+          enabled=${!readOnly}
+          hide-description-input=${true}
+    />`);
+  const loader = ApplicationContext.getContextValue("__EZUI__SEARCH__PLUS__OPTION__LOADER__");
+  ezSearch.optionLoader = (argument) => loader(argument, name, dataUnit);
+  ezSearch.autoFocus = true;
+  ezSearch.valueGetter = () => ezSearch.getValueAsync();
+  return ezSearch;
+};
+
 const buildSearch = ({ name, required, readOnly, eGridCell, dataUnit }) => {
   var _a;
   const ezSearch = HTMLBuilder.parseElement(`<ez-search
@@ -50114,6 +50739,7 @@ uiBuilders.set(UserInterface.CHECKBOX, buildSwitch);
 uiBuilders.set(UserInterface.OPTIONSELECTOR, buildComboBox);
 uiBuilders.set(UserInterface.LONGTEXT, buildTextAreaInput);
 uiBuilders.set(UserInterface.SEARCH, buildSearch);
+uiBuilders.set(UserInterface.SEARCHPLUS, buildSearchPlus);
 class EzCellEditor {
   init(params) {
     this._rowData = params.data;
@@ -50312,6 +50938,7 @@ class EzGridCustomCellRender extends EzCellRender {
 
 class GridEditionManager {
   constructor(dataUnit, useEnterLikeTab, recordsValidator, editionIsDisabled, customEditors, customRenders, enableContinuousInsert, enableGridInsert, lockerId) {
+    this._inProgressChanges = [];
     this._dataUnit = dataUnit;
     this._recordValidationProcessor = new RecordValidationProcessor(this._dataUnit, {
       getRequiredFields: () => this.getRequiredFields(),
@@ -50411,6 +51038,12 @@ class GridEditionManager {
     return this._enableContinuousInsert && (this._dataUnit.records.length - 1) === ((_a = this._lastCellEdited) === null || _a === void 0 ? void 0 : _a.rowIndex);
   }
   async proceedAutoSave() {
+    var _a;
+    //Aguarda outras promises entrarem na fila
+    await new Promise(resolve => setTimeout(resolve, 100));
+    if (this._inProgressChanges.length) {
+      await Promise.all((_a = this._inProgressChanges) === null || _a === void 0 ? void 0 : _a.map(({ promise }) => promise));
+    }
     if (!this._dataUnit.isDirty()) {
       this.saveSuccess();
       return true;
@@ -50481,7 +51114,9 @@ class GridEditionManager {
   }
   configureColumn(col) {
     col.cellEditor = 'ezCellEditor';
-    col.editable = params => this.canEdit(params);
+    if (col.editable != false) {
+      col.editable = params => this.canEdit(params);
+    }
     col.suppressKeyboardEvent = (params) => {
       if (params.event.key === KeyCode.ESCAPE && params.editing) {
         return this._dataUnit.isDirty();
@@ -50665,6 +51300,14 @@ class GridEditionManager {
       return;
     }
     if (value instanceof Promise) {
+      const progressChange = {
+        promise: undefined,
+        resolve: () => { }
+      };
+      progressChange.promise = new Promise((resolve) => {
+        progressChange.resolve = resolve;
+      });
+      this._inProgressChanges.push(progressChange);
       this.handlePromiseValue(event, value);
       return;
     }
@@ -50678,20 +51321,26 @@ class GridEditionManager {
     const resolved = await value;
     return this.updateCellValue(event, resolved);
   }
-  updateCellValue(event, newValue) {
-    var _a;
+  async updateCellValue(event, newValue) {
+    var _a, _b, _c;
     const fieldName = event.colDef.field;
     const fieldDescriptor = this._dataUnit.getField(fieldName);
     if (newValue == '' && newValue != this._dataUnit.getFieldValue(fieldName) && (fieldDescriptor === null || fieldDescriptor === void 0 ? void 0 : fieldDescriptor.userInterface) === UserInterface.SEARCH) {
       newValue = this._dataUnit.getFieldValue(fieldName);
     }
+    const newData = { [fieldName]: newValue };
+    const descriptionColName = (_a = fieldDescriptor === null || fieldDescriptor === void 0 ? void 0 : fieldDescriptor.properties) === null || _a === void 0 ? void 0 : _a[PRESENTATION_COL_ID_PROP_NAME];
+    if (!StringUtils$1.isEmpty(descriptionColName)) {
+      newData[descriptionColName] = newValue === null || newValue === void 0 ? void 0 : newValue.label;
+    }
     event.node.setData(Object.assign(Object.assign({}, event.data), { [fieldName]: newValue }));
-    (_a = this._currentEditLock) === null || _a === void 0 ? void 0 : _a.call(this);
+    (_b = this._currentEditLock) === null || _b === void 0 ? void 0 : _b.call(this);
     if (event.oldValue !== newValue) {
       this._isGridEdition = true;
-      this._dataUnit.setFieldValue(fieldName, newValue, [event.data.__record__id__], { suppressCreateNewRecord: true });
+      await this._dataUnit.setFieldValue(fieldName, newValue, [event.data.__record__id__], { suppressCreateNewRecord: true });
       this._lastCellEdited = { rowIndex: event.rowIndex, column: event.column, rowPinned: undefined };
     }
+    (_c = this._inProgressChanges) === null || _c === void 0 ? void 0 : _c.forEach(({ resolve }) => resolve(newValue));
   }
   setCellEditors(customEditors) {
     var _a;
@@ -51480,10 +52129,12 @@ var RangeService = /** @class */ (function (_super) {
         var isSameColumn = columnFrom === columnTo;
         var fromIndex = allColumns.indexOf(columnFrom);
         if (fromIndex < 0) {
+            console.warn("AG Grid: column " + columnFrom.getId() + " is not visible");
             return;
         }
         var toIndex = isSameColumn ? fromIndex : allColumns.indexOf(columnTo);
         if (toIndex < 0) {
+            console.warn("AG Grid: column " + columnTo.getId() + " is not visible");
             return;
         }
         if (isSameColumn) {
@@ -52418,10 +53069,12 @@ var ServerSideRowModel = /** @class */ (function (_super) {
     };
     ServerSideRowModel.prototype.verifyProps = function () {
         if (this.gridOptionsWrapper.getInitialGroupOrderComparator() != null) {
-            _.doOnce(function () { return (void 0); }, 'SSRM.InitialGroupOrderComparator');
+            var message_1 = "AG Grid: initialGroupOrderComparator cannot be used with Server Side Row Model. If using Full Store, then provide the rows to the grid in the desired sort order. If using Infinite Scroll, then sorting is done on the server side, nothing to do with the client.";
+            _.doOnce(function () { return console.warn(message_1); }, 'SSRM.InitialGroupOrderComparator');
         }
         if (this.gridOptionsWrapper.isRowSelection() && this.gridOptionsWrapper.getRowIdFunc() == null) {
-            _.doOnce(function () { return (void 0); }, 'SSRM.SelectionNeedsRowNodeIdFunc');
+            var message_2 = "AG Grid: getRowId callback must be provided for Server Side Row Model selection to work correctly.";
+            _.doOnce(function () { return console.warn(message_2); }, 'SSRM.SelectionNeedsRowNodeIdFunc');
         }
     };
     ServerSideRowModel.prototype.setDatasource = function (datasource) {
@@ -52971,6 +53624,11 @@ var BlockUtils = /** @class */ (function (_super) {
         rowNode.key = this.valueService.getValue(rowNode.rowGroupColumn, rowNode);
         if (rowNode.key === null || rowNode.key === undefined) {
             _.doOnce(function () {
+                console.warn("AG Grid: null and undefined values are not allowed for server side row model keys");
+                if (rowNode.rowGroupColumn) {
+                    console.warn("column = " + rowNode.rowGroupColumn.getId());
+                }
+                console.warn("data is ", rowNode.data);
             }, 'ServerSideBlock-CannotHaveNullOrUndefinedForKey');
         }
     };
@@ -53087,6 +53745,7 @@ var BlockUtils = /** @class */ (function (_super) {
         var bottomPointer = 0;
         var topPointer = rowNodes.length - 1;
         if (_.missing(topPointer) || _.missing(bottomPointer)) {
+            console.warn("AG Grid: error: topPointer = " + topPointer + ", bottomPointer = " + bottomPointer);
             return undefined;
         }
         while (true) {
@@ -53115,6 +53774,7 @@ var BlockUtils = /** @class */ (function (_super) {
                 topPointer = midPointer - 1;
             }
             else {
+                console.warn("AG Grid: error: unable to locate rowIndex = " + displayRowIndex + " in cache");
                 return undefined;
             }
         }
@@ -53230,6 +53890,11 @@ var NodeManager = /** @class */ (function () {
     }
     NodeManager.prototype.addRowNode = function (rowNode) {
         var id = rowNode.id;
+        if (this.rowNodes[id]) {
+            console.warn("AG Grid: Duplicate node id " + rowNode.id + ". Row ID's are provided via the getRowId() callback. Please modify the getRowId() callback code to provide unique row id values.");
+            console.warn('first instance', this.rowNodes[id].data);
+            console.warn('second instance', rowNode.data);
+        }
         this.rowNodes[id] = rowNode;
     };
     NodeManager.prototype.removeNode = function (rowNode) {
@@ -54161,7 +54826,8 @@ var InfiniteStore = /** @class */ (function (_super) {
             Object.assign(this.info, info);
         }
         if (!params.rowData) {
-            _.doOnce(function () { return (void 0); }, 'InfiniteStore.noData');
+            var message_1 = 'AG Grid: "params.rowData" is missing from Server-Side Row Model success() callback. Please use the "rowData" attribute. If no data is returned, set an empty list.';
+            _.doOnce(function () { return console.warn(message_1, params); }, 'InfiniteStore.noData');
         }
         var finalRowCount = params.rowCount != null && params.rowCount >= 0 ? params.rowCount : undefined;
         // if we are not active, then we ignore all events, otherwise we could end up getting the
@@ -54920,7 +55586,8 @@ var FullStore = /** @class */ (function (_super) {
         this.nodesAfterFilter = [];
         this.allNodesMap = {};
         if (!params.rowData) {
-            _.doOnce(function () { return (void 0); }, 'FullStore.noData');
+            var message_1 = 'AG Grid: "params.data" is missing from Server-Side Row Model success() callback. Please use the "data" attribute. If no data is returned, set an empty list.';
+            _.doOnce(function () { return console.warn(message_1, params); }, 'FullStore.noData');
         }
         this.createOrRecycleNodes(nodesToRecycle, params.rowData);
         if (nodesToRecycle) {
@@ -55295,6 +55962,7 @@ var FullStore = /** @class */ (function (_super) {
             });
             rowNode = this.allNodesMap[id];
             if (!rowNode) {
+                console.error("AG Grid: could not find row id=" + id + ", data item was not found for this id");
                 return null;
             }
         }
@@ -55302,6 +55970,7 @@ var FullStore = /** @class */ (function (_super) {
             // find rowNode using object references
             rowNode = this.allRowNodes.find(function (currentRowNode) { return currentRowNode.data === data; });
             if (!rowNode) {
+                console.error("AG Grid: could not find data item as object was not found", data);
                 return null;
             }
         }
@@ -55449,11 +56118,15 @@ var StoreFactory = /** @class */ (function () {
             return undefined;
         }
         if (ssrmParams.dynamicRowHeight) {
-            _.doOnce(function () { return (void 0); }, 'storeFactory.maxBlocksInCache.dynamicRowHeight');
+            var message_1 = 'AG Grid: Server Side Row Model does not support Dynamic Row Height and Cache Purging. ' +
+                'Either a) remove getRowHeight() callback or b) remove maxBlocksInCache property. Purging has been disabled.';
+            _.doOnce(function () { return console.warn(message_1); }, 'storeFactory.maxBlocksInCache.dynamicRowHeight');
             return undefined;
         }
         if (this.columnModel.isAutoRowHeightActive()) {
-            _.doOnce(function () { return (void 0); }, 'storeFactory.maxBlocksInCache.autoRowHeightActive');
+            var message_2 = 'AG Grid: Server Side Row Model does not support Auto Row Height and Cache Purging. ' +
+                'Either a) remove colDef.autoHeight or b) remove maxBlocksInCache property. Purging has been disabled.';
+            _.doOnce(function () { return console.warn(message_2); }, 'storeFactory.maxBlocksInCache.autoRowHeightActive');
             return undefined;
         }
         return maxBlocksInCache;
@@ -55681,6 +56354,7 @@ var Downloader = /** @class */ (function () {
     Downloader.download = function (fileName, content) {
         var win = document.defaultView || window;
         if (!win) {
+            console.warn('AG Grid: There is no `window` associated with the current `document`');
             return;
         }
         var element = document.createElement('a');
@@ -55814,6 +56488,7 @@ var CsvSerializingSession = /** @class */ (function (_super) {
             stringValue = value.toString();
         }
         else {
+            console.warn('AG Grid: unknown value type during csv conversion');
             stringValue = '';
         }
         // replace each " with "" (ie two sets of double quotes is how to do double quotes in csv)
@@ -55868,6 +56543,7 @@ var CsvCreator = /** @class */ (function (_super) {
     };
     CsvCreator.prototype.export = function (userParams) {
         if (this.isExportSuppressed()) {
+            console.warn("AG Grid: Export cancelled. Export is not allowed as per your configuration.");
             return '';
         }
         var mergedParams = this.getMergedParams(userParams);
@@ -55987,7 +56663,7 @@ var GridSerializer = /** @class */ (function (_super) {
         var shouldSkipLowestGroup = skipLowestSingleChildrenGroup && node.leafGroup;
         var shouldSkipCurrentGroup = node.allChildrenCount === 1 && (skipSingleChildrenGroup || shouldSkipLowestGroup);
         if (skipRowGroups && params.skipGroups) {
-            _.doOnce(function () { return (void 0); }, 'gridSerializer-skipGroups');
+            _.doOnce(function () { return console.warn('AG Grid: Since v25.2 `skipGroups` has been renamed to `skipRowGroups`.'); }, 'gridSerializer-skipGroups');
         }
         if ((!isLeafNode && (params.skipRowGroups || shouldSkipCurrentGroup || hideOpenParents)) ||
             (params.onlySelected && !node.isSelected()) ||
@@ -56021,7 +56697,7 @@ var GridSerializer = /** @class */ (function (_super) {
             var appendContent = params.customFooter || params.appendContent;
             if (appendContent) {
                 if (params.customFooter) {
-                    _.doOnce(function () { return (void 0); }, 'gridSerializer-customFooter');
+                    _.doOnce(function () { return console.warn('AG Grid: Since version 25.2.0 the `customFooter` param has been deprecated. Use `appendContent` instead.'); }, 'gridSerializer-customFooter');
                 }
                 gridSerializingSession.addCustomContent(appendContent);
             }
@@ -56033,7 +56709,7 @@ var GridSerializer = /** @class */ (function (_super) {
             var prependContent = params.customHeader || params.prependContent;
             if (prependContent) {
                 if (params.customHeader) {
-                    _.doOnce(function () { return (void 0); }, 'gridSerializer-customHeader');
+                    _.doOnce(function () { return console.warn('AG Grid: Since version 25.2.0 the `customHeader` param has been deprecated. Use `prependContent` instead.'); }, 'gridSerializer-customHeader');
                 }
                 gridSerializingSession.addCustomContent(prependContent);
             }
@@ -56055,7 +56731,7 @@ var GridSerializer = /** @class */ (function (_super) {
                 _this.recursivelyAddHeaderGroups(displayedGroups, gridSerializingSession, params.processGroupHeaderCallback);
             }
             else if (params.columnGroups) {
-                _.doOnce(function () { return (void 0); }, 'gridSerializer-columnGroups');
+                _.doOnce(function () { return console.warn('AG Grid: Since v25.2 the `columnGroups` param has deprecated, and groups are exported by default.'); }, 'gridSerializer-columnGroups');
             }
             return gridSerializingSession;
         };
@@ -56069,7 +56745,7 @@ var GridSerializer = /** @class */ (function (_super) {
                 });
             }
             else if (params.skipHeader) {
-                _.doOnce(function () { return (void 0); }, 'gridSerializer-skipHeader');
+                _.doOnce(function () { return console.warn('AG Grid: Since v25.2 the `skipHeader` param has been renamed to `skipColumnHeaders`.'); }, 'gridSerializer-skipHeader');
             }
             return gridSerializingSession;
         };
@@ -56317,6 +56993,12 @@ var ClipboardService = /** @class */ (function (_super) {
                 .then(this.processClipboardData.bind(this))
                 .catch(function (e) {
                 _.doOnce(function () {
+                    console.warn(e);
+                    console.warn('AG Grid: Unable to use the Clipboard API (navigator.clipboard.readText()). ' +
+                        'The reason why it could not be used has been logged in the previous line. ' +
+                        'For this reason the grid has defaulted to using a workaround which doesn\'t perform as well. ' +
+                        'Either fix why Clipboard API is blocked, OR stop this message from appearing by setting grid ' +
+                        'property suppressClipboardApi=true (which will default the grid to using the workaround rather than the API');
                 }, 'clipboardApiError');
                 _this.navigatorApiFailed = true;
                 _this.pasteFromClipboardLegacy();
@@ -56843,6 +57525,12 @@ var ClipboardService = /** @class */ (function (_super) {
         if (allowNavigator && navigator.clipboard) {
             navigator.clipboard.writeText(data).catch(function (e) {
                 _.doOnce(function () {
+                    console.warn(e);
+                    console.warn('AG Grid: Unable to use the Clipboard API (navigator.clipboard.writeText()). ' +
+                        'The reason why it could not be used has been logged in the previous line. ' +
+                        'For this reason the grid has defaulted to using a workaround which doesn\'t perform as well. ' +
+                        'Either fix why Clipboard API is blocked, OR stop this message from appearing by setting grid ' +
+                        'property suppressClipboardApi=true (which will default the grid to using the workaround rather than the API.');
                 }, 'clipboardApiError');
                 _this.copyDataToClipboardLegacy(data);
             });
@@ -56859,7 +57547,12 @@ var ClipboardService = /** @class */ (function (_super) {
             element.value = data || ' '; // has to be non-empty value or execCommand will not do anything
             element.select();
             element.focus({ preventScroll: true });
-            eDocument.execCommand('copy');
+            var result = eDocument.execCommand('copy');
+            if (!result) {
+                console.warn('AG Grid: Browser did not allow document.execCommand(\'copy\'). Ensure ' +
+                    'api.copySelectedRowsToClipboard() is invoked via a user event, i.e. button click, otherwise ' +
+                    'the browser will prevent it for security reasons.');
+            }
             if (focusedElementBefore != null && focusedElementBefore.focus != null) {
                 focusedElementBefore.focus({ preventScroll: true });
             }
@@ -56883,6 +57576,7 @@ var ClipboardService = /** @class */ (function (_super) {
             callbackNow(eTempInput);
         }
         catch (err) {
+            console.warn('AG Grid: Browser does not support document.execCommand(\'copy\') for clipboard operations');
         }
         //It needs 100 otherwise OS X seemed to not always be able to paste... Go figure...
         if (callbackAfter) {
@@ -58155,6 +58849,7 @@ var ToolPanelColumnComp = /** @class */ (function (_super) {
         return false;
     };
     ToolPanelColumnComp.prototype.setExpanded = function (value) {
+        console.warn('AG Grid: can not expand a column item that does not represent a column group header');
     };
     ToolPanelColumnComp.TEMPLATE = "<div class=\"ag-column-select-column\" aria-hidden=\"true\">\n            <ag-checkbox ref=\"cbSelect\" class=\"ag-column-select-checkbox\"></ag-checkbox>\n            <span class=\"ag-column-select-column-label\" ref=\"eLabel\"></span>\n        </div>";
     __decorate$q([
@@ -58449,7 +59144,10 @@ var PRIMARY_COLS_LIST_PANEL_CLASS = 'ag-column-select-list';
                 expandedGroupIds.push(groupId);
             }
         });
-        groupIds.filter(function (groupId) { return !_.includes(expandedGroupIds, groupId); });
+        var unrecognisedGroupIds = groupIds.filter(function (groupId) { return !_.includes(expandedGroupIds, groupId); });
+        if (unrecognisedGroupIds.length > 0) {
+            console.warn('AG Grid: unable to find group(s) for supplied groupIds:', unrecognisedGroupIds);
+        }
     };
     PrimaryColsListPanel.prototype.getExpandState = function () {
         var expandedCount = 0;
@@ -58843,6 +59541,7 @@ var __decorate$n = (undefined && undefined.__decorate) || function (decorators,
             this.aggFuncService.getAggFunc(aggFuncOrString) :
             aggFuncOrString;
         if (typeof aggFunc !== 'function') {
+            console.error("AG Grid: unrecognised aggregation function " + aggFuncOrString);
             return null;
         }
         var aggFuncAny = aggFunc;
@@ -59369,6 +60068,9 @@ var __spread$2 = (undefined && undefined.__spread) || function () {
     GroupStage.prototype.insertOneNode = function (childNode, details, isMove) {
         var path = this.getGroupInfo(childNode, details);
         var parentGroup = this.findParentForNode(childNode, path, details);
+        if (!parentGroup.group) {
+            console.warn("AG Grid: duplicate group keys for row data, keys should be unique", [parentGroup.data, childNode.data]);
+        }
         if (this.usingTreeData) {
             this.swapGroupWithUserNode(parentGroup, childNode, isMove);
         }
@@ -59506,7 +60208,7 @@ var __spread$2 = (undefined && undefined.__spread) || function () {
     GroupStage.prototype.getGroupInfoFromCallback = function (rowNode) {
         var keys = this.getDataPath ? this.getDataPath(rowNode.data) : null;
         if (keys === null || keys === undefined || keys.length === 0) {
-            _.doOnce(function () { return (void 0); }, 'groupStage.getGroupInfoFromCallback');
+            _.doOnce(function () { return console.warn("AG Grid: getDataPath() should not return an empty path for data", rowNode.data); }, 'groupStage.getGroupInfoFromCallback');
         }
         var groupInfoMapper = function (key) { return ({ key: key, field: null, rowGroupColumn: null }); };
         return keys ? keys.map(groupInfoMapper) : [];
@@ -62231,6 +62933,7 @@ var ToolPanelWrapper = /** @class */ (function (_super) {
         var compDetails = this.userComponentFactory.getToolPanelCompDetails(toolPanelDef, params);
         var componentPromise = compDetails.newAgStackInstance();
         if (componentPromise == null) {
+            console.warn("AG Grid: error processing tool panel component " + id + ". You need to specify either 'toolPanel' or 'toolPanelFramework'");
             return;
         }
         componentPromise.then(this.setToolPanelComponent.bind(this));
@@ -62425,6 +63128,7 @@ var __decorate$5 = (undefined && undefined.__decorate) || function (decorators,
         var _this = this;
         defs.forEach(function (def) {
             if (def.id == null) {
+                console.warn("AG Grid: please review all your toolPanel components, it seems like at least one of them doesn't have an id");
                 return;
             }
             // helpers, in case user doesn't have the right module loaded
@@ -62470,6 +63174,7 @@ var __decorate$5 = (undefined && undefined.__decorate) || function (decorators,
     SideBarComp.prototype.getToolPanelInstance = function (key) {
         var toolPanelWrapper = this.toolPanelWrappers.filter(function (toolPanel) { return toolPanel.getToolPanelId() === key; })[0];
         if (!toolPanelWrapper) {
+            console.warn("AG Grid: unable to lookup Tool Panel as invalid key supplied: " + key);
             return;
         }
         return toolPanelWrapper.getToolPanelInstance();
@@ -62555,6 +63260,7 @@ var __decorate$4 = (undefined && undefined.__decorate) || function (decorators,
     }
     ToolPanelColDefService.prototype.createColumnTree = function (colDefs) {
         var _this = this;
+        var invalidColIds = [];
         var createDummyColGroup = function (abstractColDef, depth) {
             if (_this.isColGroupDef(abstractColDef)) {
                 // creating 'dummy' group which is not associated with grid column group
@@ -62576,6 +63282,9 @@ var __decorate$4 = (undefined && undefined.__decorate) || function (decorators,
                 var colDef = abstractColDef;
                 var key = colDef.colId ? colDef.colId : colDef.field;
                 var column = _this.columnModel.getPrimaryColumn(key);
+                if (!column) {
+                    invalidColIds.push(colDef);
+                }
                 return column;
             }
         };
@@ -62587,6 +63296,9 @@ var __decorate$4 = (undefined && undefined.__decorate) || function (decorators,
                 mappedResults.push(result);
             }
         });
+        if (invalidColIds.length > 0) {
+            console.warn('AG Grid: unable to find grid columns for the supplied colDef(s):', invalidColIds);
+        }
         return mappedResults;
     };
     ToolPanelColDefService.prototype.syncLayoutWithGrid = function (syncLayoutCallback) {
@@ -63141,10 +63853,15 @@ var EnterpriseMenu = /** @class */ (function (_super) {
     };
     EnterpriseMenu.prototype.isValidMenuTabItem = function (menuTabName) {
         var isValid = true;
+        var itemsToConsider = EnterpriseMenu.TABS_DEFAULT;
         if (this.restrictTo != null) {
             isValid = this.restrictTo.indexOf(menuTabName) > -1;
+            itemsToConsider = this.restrictTo;
         }
         isValid = isValid && EnterpriseMenu.TABS_DEFAULT.indexOf(menuTabName) > -1;
+        if (!isValid) {
+            console.warn("AG Grid: Trying to render an invalid menu item '" + menuTabName + "'. Check that your 'menuTabs' contains one of [" + itemsToConsider + "]");
+        }
         return isValid;
     };
     EnterpriseMenu.prototype.isNotSuppressed = function (menuTabName) {
@@ -63855,6 +64572,7 @@ var MenuItemMapper = /** @class */ (function (_super) {
                     return chartMenuItem;
                 }
                 else {
+                    console.warn("AG Grid: unknown menu item type " + key);
                     return null;
                 }
         }
@@ -64098,7 +64816,8 @@ class AgGridController {
   }
   showFilterColumn(configs) {
     var _a;
-    (_a = this._filterColumn) === null || _a === void 0 ? void 0 : _a.show(configs);
+    const presentationMetadata = this.resolveDescriptionColMetadata(configs.columnName);
+    (_a = this._filterColumn) === null || _a === void 0 ? void 0 : _a.show(Object.assign(Object.assign({}, configs), { fieldDescriptor: presentationMetadata }));
   }
   constructor(_enterprise) {
     this.DEFAULT_ROW_HEIGHT = 30;
@@ -64119,6 +64838,7 @@ class AgGridController {
     this._customFormatters = new Map();
     this._gridShowDom = false;
     this.peddingExecutionsOnGridShow = [];
+    this._lastColsConfig = undefined;
     ModuleRegistry.registerModules([
       EnterpriseCoreModule,
       RangeSelectionModule,
@@ -64130,8 +64850,25 @@ class AgGridController {
   getGridConfig() {
     return this._gridConfig;
   }
-  locateColumn(columnName) {
+  locateColumn(columnName, gridElement) {
     this._gridOptions.api.ensureColumnVisible(columnName);
+    requestAnimationFrame(() => {
+      this.highlightColumnHeader(columnName, gridElement);
+    });
+  }
+  highlightColumnHeader(columnName, gridElement) {
+    const headerElement = gridElement.querySelector(`.ag-header-cell[col-id="${columnName}"]`);
+    if (!headerElement)
+      return;
+    headerElement.classList.add("ez-grid__column-highlight-header");
+    headerElement.setAttribute("tabindex", "0");
+    const removeHighlight = (event) => {
+      if (!headerElement.contains(event.target)) {
+        headerElement.classList.remove("ez-grid__column-highlight-header");
+        document.removeEventListener("click", removeHighlight);
+      }
+    };
+    document.addEventListener("click", removeHighlight);
   }
   getSort(_dataUnitName, defaultSorting) {
     const sortedColumns = [];
@@ -64153,10 +64890,15 @@ class AgGridController {
       return;
     }
     return Array.from(this._filteredColumns.entries())
-      .map(([column, items]) => {
+      .map(([col, items]) => {
       var _a;
       const checkedOptions = items.filter(option => option.check);
       if (checkedOptions.length > 0) {
+        let column = col;
+        const presentationFrom = this.getCodeColFromDescriptionCol(col);
+        if (!StringUtils$1.isEmpty(presentationFrom)) {
+          column = presentationFrom;
+        }
         const fieldDescriptor = this._dataUnit.getField(column);
         const dataType = (_a = fieldDescriptor === null || fieldDescriptor === void 0 ? void 0 : fieldDescriptor.dataType) !== null && _a !== void 0 ? _a : DataType.TEXT;
         let placeholders = '';
@@ -64223,6 +64965,7 @@ class AgGridController {
         this._dataUnit.addFilterProvider(this);
       }
       this._gridOptions = {
+        suppressHorizontalScroll: options.suppressHorizontalScroll,
         localeText: gridTerms,
         enableRangeSelection: this._multipleSelection,
         rowSelection: this._multipleSelection ? 'multiple' : 'single',
@@ -64350,6 +65093,23 @@ class AgGridController {
       action: () => this.showFilterColumn({ columnName, columnLabel, leftPosition: this._filterColumnleftPosition, filteredOptions: this._filteredColumns.get(columnName) }),
     };
   }
+  resolveDescriptionColMetadata(columnName) {
+    var _a;
+    const colDef = (_a = this._gridOptions.columnApi.getColumn(columnName)) === null || _a === void 0 ? void 0 : _a.getColDef();
+    const presentationFrom = this.getCodeColFromDescriptionCol(columnName);
+    if (!StringUtils$1.isEmpty(presentationFrom)) {
+      return {
+        label: colDef.headerName,
+        name: columnName,
+        userInterface: UserInterface.SHORTTEXT,
+        dataType: DataType.TEXT,
+        properties: {
+          [PRESENTATION_FROM_COL_PROP_NAME]: presentationFrom
+        }
+      };
+    }
+    return undefined;
+  }
   buildMenuItemOptionPin(params) {
     const { column, columnApi } = params;
     const isPinned = params.column.isPinned();
@@ -64676,7 +65436,7 @@ class AgGridController {
   }
   syncSelectWithDataUnit() {
     const rowNode = this._gridOptions.api.getRowNode(this._dataUnit.getSelectedRecord().__record__id__);
-    if ((rowNode === null || rowNode === void 0 ? void 0 : rowNode.rowIndex) < 0)
+    if (!rowNode || (rowNode === null || rowNode === void 0 ? void 0 : rowNode.rowIndex) < 0)
       return;
     const rowRange = this._gridOptions.api.getCellRanges().find(row => row.startRow.rowIndex === rowNode.rowIndex);
     if ((rowRange === null || rowRange === void 0 ? void 0 : rowRange.columns.length) > 0) {
@@ -64713,7 +65473,9 @@ class AgGridController {
     }
   }
   isColumnEditable(rowIndex, column) {
-    if (column.getColDef().headerName === '' || rowIndex === -1)
+    if (column.getColDef().headerName === ''
+      || column.getColDef().headerName === this.CHECK_BOX_COL_ID
+      || rowIndex === -1)
       return false;
     const rowId = this._dataUnit.records[rowIndex][this._idAttribName];
     const rowNode = this._gridOptions.api.getRowNode(rowId);
@@ -64731,7 +65493,7 @@ class AgGridController {
     this._gridOptions.api.setFocusedCell(rowIndex, firstCell);
   }
   setColumnsDef(cols) {
-    const checkBoxColumn = Object.assign({ colId: this.CHECK_BOX_COL_ID, headerName: '', checkboxSelection: true, width: 29, suppressMovable: true, suppressAutoSize: true, suppressMenu: true, lockPosition: true, pinned: true }, (this._multipleSelection && { headerComponent: 'ezGridHeaderComponent', headerClass: 'ag-column-select-header' }));
+    const checkBoxColumn = Object.assign({ colId: this.CHECK_BOX_COL_ID, headerName: this.CHECK_BOX_COL_ID, checkboxSelection: true, width: 29, suppressMovable: true, suppressAutoSize: true, suppressMenu: true, lockPosition: true, pinned: true }, (this._multipleSelection && { headerComponent: 'ezGridHeaderComponent', headerClass: 'ag-column-select-header' }));
     const newColDefs = this._options.suppressCheckBoxCol ? [] : [checkBoxColumn];
     if (this._statusResolver != undefined) {
       newColDefs.push({
@@ -64759,8 +65521,39 @@ class AgGridController {
     });
     this._colDefs = newColDefs;
     if (this._gridOptions && this._gridOptions.api) {
+      this.setColsDefsWithStateIfNeeded(this._colDefs);
+    }
+  }
+  setColsDefsWithStateIfNeeded(colDefs) {
+    if (!this._lastColsConfig) {
       this._gridOptions.api.setColumnDefs(this._colDefs);
     }
+    /*
+      Caso a definição de colunas esteja sendo atualizada,
+      e existe uma config aplicada, temos que considerar essa
+      config ao adicionar nova definição de colunas.
+      PS: Poderia apenas chamar o setColumnsState, porém,
+      isso impactaria em performance, e o usuário ia perceber
+      a mudança das colunas visualmente na grade, o que traria
+      uma experiencia ruim.
+    */
+    const colDefsWithConfigs = this.getColsDefWithConfigApplied(colDefs, this._lastColsConfig);
+    this._gridOptions.api.setColumnDefs(colDefsWithConfigs);
+  }
+  getColsDefWithConfigApplied(colDefs, colsConfig) {
+    //Cria map de colunas existentes na config e seu índice
+    const orderMap = colsConfig.reduce((map, col, index) => {
+      map[col.name] = index;
+      return map;
+    }, {});
+    //Remove colunas que não existem na config
+    const filteredColsDefs = colDefs.filter((col) => !orderMap.hasOwnProperty(col.colId));
+    //Ordena colunas baseada na config aplicada
+    const sortedColumnDefs = filteredColsDefs.sort((a, b) => {
+      var _a, _b;
+      return ((_a = orderMap[a.field]) !== null && _a !== void 0 ? _a : Number.MAX_VALUE) - ((_b = orderMap[b.field]) !== null && _b !== void 0 ? _b : Number.MAX_VALUE);
+    });
+    return sortedColumnDefs;
   }
   clearRangeSelection() {
     this._gridOptions.api.clearRangeSelection();
@@ -64797,6 +65590,7 @@ class AgGridController {
     if (this._grid === undefined) {
       throw new Error('Erro interno: Grid ainda não inicializado.');
     }
+    this._lastColsConfig = state;
     const colDef = this._gridOptions.columnApi.getColumns();
     let columns = this.getColumnsDef();
     let visibleColumns = [];
@@ -64805,14 +65599,39 @@ class AgGridController {
     const columnsOffset = colDef.length - columns.length;
     this._gridConfig = state;
     let sort = [];
-    state.forEach((cfgColumn, index) => {
+    let currentIndex = 0;
+    state.forEach((cfgColumn) => {
+      var _a, _b;
       const colWidth = this.getColumnWidth(cfgColumn);
-      this._gridOptions.columnApi.moveColumn(cfgColumn.name, index + columnsOffset);
+      this._gridOptions.columnApi.moveColumn(cfgColumn.name, currentIndex + columnsOffset);
       this._gridOptions.columnApi.setColumnWidth(cfgColumn.name, colWidth);
       visibleColumns.push(cfgColumn.name);
       if (cfgColumn.ascending !== undefined) {
         sort.push({ colId: cfgColumn.name, sort: cfgColumn.ascending !== true ? 'desc' : 'asc', sortIndex: cfgColumn.orderIndex });
       }
+      currentIndex++;
+      const fieldMD = (_a = this._dataUnit) === null || _a === void 0 ? void 0 : _a.getField(cfgColumn.name);
+      /*
+        Migração para o SEARCHPLUS, caso de uso:
+          - Agora existe uma coluna para o campo de descrição do relaciona
+          - Essa col, não existe na config da grade que já foi salva pelo DS
+          - Nesse caso, precisamos inserir a coluna de descrição automaticamente para que
+            os usuários não percam a apresentação do campo de descrição.
+          PS: Caso esteja herdando do HTML5, devemos manter a config como está la
+      */
+      if (this.needToAddDescriptionColumn(cfgColumn, fieldMD, state)) {
+        const descriptionColID = (_b = fieldMD === null || fieldMD === void 0 ? void 0 : fieldMD.properties) === null || _b === void 0 ? void 0 : _b[PRESENTATION_COL_ID_PROP_NAME];
+        if (!descriptionColID)
+          return;
+        const descriptionCol = this._gridOptions.columnApi.getColumn(descriptionColID);
+        const descriptionColDef = descriptionCol === null || descriptionCol === void 0 ? void 0 : descriptionCol.getColDef();
+        const descriptionHeaderName = descriptionColDef === null || descriptionColDef === void 0 ? void 0 : descriptionColDef.headerName;
+        const descriptionColSize = this.getColumnWidthByLabel(descriptionHeaderName);
+        this._gridOptions.columnApi.moveColumn(descriptionColID, currentIndex + columnsOffset);
+        this._gridOptions.columnApi.setColumnWidth(descriptionColID, descriptionColSize);
+        visibleColumns.push(descriptionColID);
+        currentIndex++;
+      }
     });
     let invisibleColumns = columns.filter(column => !visibleColumns.includes(column.name)).map(column => column.name);
     this._gridOptions.columnApi.setColumnsVisible(visibleColumns, true);
@@ -64822,6 +65641,16 @@ class AgGridController {
       defaultState: { sort: null },
     });
   }
+  needToAddDescriptionColumn(cfgColumn, fieldMD, stateConfig) {
+    var _a, _b;
+    if (!fieldMD) {
+      return false;
+    }
+    const configVersion = ((_a = cfgColumn.configVersion) !== null && _a !== void 0 ? _a : 0);
+    const isSearchPlus = (fieldMD === null || fieldMD === void 0 ? void 0 : fieldMD.userInterface) == UserInterface.SEARCHPLUS;
+    const descriptionColID = (_b = fieldMD === null || fieldMD === void 0 ? void 0 : fieldMD.properties) === null || _b === void 0 ? void 0 : _b[PRESENTATION_COL_ID_PROP_NAME];
+    return isSearchPlus && configVersion < 1 && stateConfig.find(col => col.name === descriptionColID) != undefined;
+  }
   getColumnsState() {
     if (this._grid === undefined) {
       throw new Error('Erro interno: Grid ainda não inicializado.');
@@ -64881,7 +65710,7 @@ class AgGridController {
     return filterOptions.map(item => item.check).includes(true);
   }
   buildColDef(source) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     let tooltip = undefined;
     const propSortable = StringUtils$1.getBooleanValue((_a = source.props) === null || _a === void 0 ? void 0 : _a.get('gridSortable'), true);
     if ((_b = source.props) === null || _b === void 0 ? void 0 : _b.get('gridHeaderTooltip')) {
@@ -64890,6 +65719,7 @@ class AgGridController {
     else if (propSortable === false) {
       tooltip = 'Coluna não pode ser ordenada';
     }
+    const presentationFrom = (_d = source === null || source === void 0 ? void 0 : source.props) === null || _d === void 0 ? void 0 : _d.get(PRESENTATION_FROM_COL_PROP_NAME);
     return this._editionManager.configureColumn({
       headerName: source.label,
       field: source.name,
@@ -64897,12 +65727,17 @@ class AgGridController {
       resizable: true,
       headerComponent: 'ezGridCustomHeader',
       headerComponentParams: {
+        presentationFrom,
         tooltip: tooltip,
         isSortable: propSortable,
         hasFilter: () => this.hasFilterColumn(source.name),
         showColumnFilter: (leftPosition) => this.showFilterColumn({ columnName: source.name, columnLabel: source.label, leftPosition, filteredOptions: this._filteredColumns.get(source.name), fromIcon: true }),
       },
       valueFormatter: params => {
+        var _a, _b, _c;
+        if (presentationFrom) {
+          return (_c = (_b = (_a = params === null || params === void 0 ? void 0 : params.data) === null || _a === void 0 ? void 0 : _a[presentationFrom]) === null || _b === void 0 ? void 0 : _b.label) !== null && _c !== void 0 ? _c : "";
+        }
         if (params.value === undefined || params.value === null) {
           return "";
         }
@@ -64922,6 +65757,7 @@ class AgGridController {
         return this.getFormatterByColumn(params, source);
       },
       cellStyle: this.getStyleByColumn(source),
+      editable: !((_e = source.props) === null || _e === void 0 ? void 0 : _e.has(PRESENTATION_FROM_COL_PROP_NAME))
     });
   }
   setCustomFormatters(customFormatters) {
@@ -64937,8 +65773,11 @@ class AgGridController {
     };
   }
   getStyleByColumn(source) {
+    var _a;
     let cellStyle = this.getInitCellStyle();
-    switch (source === null || source === void 0 ? void 0 : source.userInterface) {
+    const primitiveUIType = (_a = source === null || source === void 0 ? void 0 : source.props) === null || _a === void 0 ? void 0 : _a.get("PRIMITIVETUIYPE");
+    const uitype = source === null || source === void 0 ? void 0 : source.userInterface;
+    switch (primitiveUIType !== null && primitiveUIType !== void 0 ? primitiveUIType : uitype) {
       case UserInterface.DECIMALNUMBER:
       case UserInterface.INTEGERNUMBER:
         cellStyle['text-align'] = 'right';
@@ -64954,7 +65793,7 @@ class AgGridController {
     return cellStyle;
   }
   getFormatterByColumn(params, source) {
-    var _a;
+    var _a, _b, _c, _d;
     if ((source === null || source === void 0 ? void 0 : source.userInterface) === 'OPTIONSELECTOR' && source.options) {
       const prop = source === null || source === void 0 ? void 0 : source.options;
       let options;
@@ -64991,6 +65830,9 @@ class AgGridController {
         return params === null || params === void 0 ? void 0 : params.value;
       }
     }
+    if ((source === null || source === void 0 ? void 0 : source.userInterface) === UserInterface.SEARCHPLUS) {
+      return (_d = (_c = (_b = params === null || params === void 0 ? void 0 : params.value) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : params === null || params === void 0 ? void 0 : params.value) !== null && _d !== void 0 ? _d : "";
+    }
     if ((source === null || source === void 0 ? void 0 : source.userInterface) === UserInterface.DECIMALNUMBER) {
       if (params.value != undefined) {
         const precision = Number(source.props.get('precision')) || 2;
@@ -65164,7 +66006,7 @@ class AgGridController {
     this._gridOptions.api.stopEditing();
   }
   getColumnWidth(cfgColumn) {
-    var _a, _b;
+    var _a, _b, _c, _d, _e, _f;
     if (cfgColumn == undefined) {
       return;
     }
@@ -65178,12 +66020,22 @@ class AgGridController {
         return parseWidth + this.DEFAULT_FONT_SIZE_HTML5;
     }
     const field = (_a = this._dataUnit) === null || _a === void 0 ? void 0 : _a.getField(cfgColumn.name);
+    const label = (_b = field === null || field === void 0 ? void 0 : field.label) !== null && _b !== void 0 ? _b : (_f = (_e = (_d = (_c = this._gridOptions) === null || _c === void 0 ? void 0 : _c.columnApi) === null || _d === void 0 ? void 0 : _d.getColumn(cfgColumn.name)) === null || _e === void 0 ? void 0 : _e.getColDef()) === null || _f === void 0 ? void 0 : _f.headerName;
     if ((field === null || field === void 0 ? void 0 : field.userInterface) === UserInterface.SEARCH) {
       return this.DEFAULT_MAX_SIZE;
     }
-    const labelSize = (((_b = field === null || field === void 0 ? void 0 : field.label) === null || _b === void 0 ? void 0 : _b.length) || 0) * this.DEFAULT_FONT_SIZE + this.DEFAULT_ICON_SIZE;
+    return this.getColumnWidthByLabel(label);
+  }
+  getColumnWidthByLabel(label) {
+    const labelSize = ((label === null || label === void 0 ? void 0 : label.length) || 0) * this.DEFAULT_FONT_SIZE + this.DEFAULT_ICON_SIZE;
     return labelSize > this.DEFAULT_MAX_SIZE ? this.DEFAULT_MAX_SIZE : labelSize;
   }
+  getCodeColFromDescriptionCol(descriptionColName) {
+    var _a;
+    const colGrid = this._gridOptions.columnApi.getColumn(descriptionColName);
+    const colDef = colGrid === null || colGrid === void 0 ? void 0 : colGrid.getColDef();
+    return (_a = colDef === null || colDef === void 0 ? void 0 : colDef.headerComponentParams) === null || _a === void 0 ? void 0 : _a.presentationFrom;
+  }
 }
 
 function enableSelectAll(total) {
@@ -65360,7 +66212,7 @@ class InMemoryFilterColumnDataSource {
   }
 }
 
-const ezGridCss = ".sc-ez-grid-h{display:grid;grid-template-rows:auto 1fr auto;height:100%;width:100%;--ez-grid__header--background-color:var(--background--xlight, #FFF);--ez-grid__selection-counter--z-index:var(--visible, 1);--ez-grid__container--shadow:var(--shadow);--ez-grid--min-height:300px;--ez-grid__container--shadow--outline:var(--shadow--outline) var(--color--strokes);--ez-grid__header--shadow:var(--shadow--xsmall);--ez-grid__header--shadow--outline:var(--shadow--outline) var(--color--strokes);--ez-grid__header--outline:none;--ez-grid__header--border:none;min-height:var(--ez-grid--min-height)}.grid-header.sc-ez-grid{display:grid;justify-content:space-between;align-items:center;grid-row-start:1;grid-template-columns:1fr;background-color:var(--ez-grid__header--background-color, #FFF)}.grid-header.shadow-mode.sc-ez-grid{box-shadow:var(--ez-grid__header--shadow);border:var(--ez-grid__header--border);outline:var(--ez-grid__header--outline)}.grid-header.outline-mode.sc-ez-grid{box-shadow:var(--ez-grid__header--shadow--outline);border:var(--ez-grid__header--border);outline:var(--ez-grid__header--outline)}.header-overlay.sc-ez-grid{padding-top:15px;margin-top:-12px}.grid__container.sc-ez-grid{outline:none;box-shadow:var(--ez-grid__container--shadow);background-color:var(--ez-grid__header--background-color);border:var(--border--small) var(--color--strokes);border-radius:var(--border--radius-small)}.sc-ez-grid-h:not([no-header]) .grid__container.sc-ez-grid{border:none}.grid__container.outline-mode.sc-ez-grid{box-shadow:var(--ez-grid__container--shadow--outline);border:none;outline:none}.grid-header__popover.sc-ez-grid{position:relative;top:var(--space--sm, 16px)}.grid-header__container.sc-ez-grid{display:flex;align-items:center;flex-grow:1;flex-shrink:1}.grid-header__position.sc-ez-grid{display:flex;align-items:center;justify-content:space-between}.grid__selection-counter.sc-ez-grid{position:fixed;white-space:nowrap;transform:translate(-50%, 0px);left:50%;opacity:0;bottom:-100%;transition:opacity 0.1s, bottom 0.5s}.grid__selection-counter--opened.sc-ez-grid{opacity:1;bottom:0px}.grid__btn-close.sc-ez-grid{display:flex;align-items:center;justify-content:center;padding:0;outline:none;width:20px;height:20px;border:none;background-color:unset;cursor:pointer}.grid__btn-clear.sc-ez-grid{--ez-button--link-color:var(--color--alert-warning-900, #8C6B00);--ez-button--link--hover-color:var(--color--alert-warning-900, #8C6B00)}[no-header].sc-ez-grid-h .grid-header.sc-ez-grid{height:0;padding:0}.grid-header__pagination.sc-ez-grid{justify-content:flex-end;flex-wrap:nowrap;flex-shrink:1;flex-grow:1}.grid-header__pagination-label.sc-ez-grid{width:100%;white-space:nowrap}.overflowed.sc-ez-grid{display:none}.pagination-contracted.sc-ez-grid{width:100px}.pagination-expanded.sc-ez-grid{min-width:150px}.left__header-contracted.sc-ez-grid{width:auto}.left__header-expanded.sc-ez-grid{flex-grow:1}.grid__footer.sc-ez-grid{background-color:var(--background--xlight, #FFF);border-radius:0 0 var(--border--radius-medium) var(--border--radius-medium);box-shadow:var(--shadow--small)}.cancel-pagination.sc-ez-grid{display:flex;flex-direction:row;align-items:center;justify-content:space-between;gap:4px;padding:8px;width:180px}.cancel-pagination-btn.sc-ez-grid{color:var(--color--error);font-size:var(--text--medium);font-weight:var(--text-weight--large);font-family:var(--font-pattern, Roboto);text-wrap:nowrap;cursor:pointer}.spin.sc-ez-grid{animation-name:spin;animation-duration:5000ms;animation-iteration-count:infinite;animation-timing-function:linear}@keyframes spin{from{transform:rotate(0deg)}to{transform:rotate(360deg)}}";
+const ezGridCss = ".sc-ez-grid-h{display:grid;grid-template-rows:auto 1fr auto;height:100%;width:100%;--ez-grid__header--background-color:var(--background--xlight, #FFF);--ez-grid__selection-counter--z-index:var(--visible, 1);--ez-grid__container--shadow:var(--shadow);--ez-grid--min-height:300px;--ez-grid__container--shadow--outline:var(--shadow--outline) var(--color--strokes);--ez-grid__header--shadow:var(--shadow--xsmall);--ez-grid__header--shadow--outline:var(--shadow--outline) var(--color--strokes);--ez-grid__header--outline:none;--ez-grid__header--border:none;min-height:var(--ez-grid--min-height)}.grid-header.sc-ez-grid{display:grid;justify-content:space-between;align-items:center;grid-row-start:1;grid-template-columns:1fr;background-color:var(--ez-grid__header--background-color, #FFF)}.grid-header.shadow-mode.sc-ez-grid{box-shadow:var(--ez-grid__header--shadow);border:var(--ez-grid__header--border);outline:var(--ez-grid__header--outline)}.grid-header.outline-mode.sc-ez-grid{box-shadow:var(--ez-grid__header--shadow--outline);border:var(--ez-grid__header--border);outline:var(--ez-grid__header--outline)}.header-overlay.sc-ez-grid{padding-top:15px;margin-top:-12px}.grid__container.sc-ez-grid{outline:none;box-shadow:var(--ez-grid__container--shadow);background-color:var(--ez-grid__header--background-color);border:var(--border--small) var(--color--strokes);border-radius:var(--border--radius-small)}.grid__container.no-scroll.sc-ez-grid{width:100vw}.sc-ez-grid-h:not([no-header]) .grid__container.sc-ez-grid{border:none}.grid__container.outline-mode.sc-ez-grid{box-shadow:var(--ez-grid__container--shadow--outline);border:none;outline:none}.grid-header__popover.sc-ez-grid{position:relative;top:var(--space--sm, 16px)}.grid-header__container.sc-ez-grid{display:flex;align-items:center;flex-grow:1;flex-shrink:1}.grid-header__position.sc-ez-grid{display:flex;align-items:center;justify-content:space-between}.grid__selection-counter.sc-ez-grid{position:fixed;white-space:nowrap;transform:translate(-50%, 0px);left:50%;opacity:0;bottom:-100%;transition:opacity 0.1s, bottom 0.5s}.grid__selection-counter--opened.sc-ez-grid{opacity:1;bottom:0px}.grid__btn-close.sc-ez-grid{display:flex;align-items:center;justify-content:center;padding:0;outline:none;width:20px;height:20px;border:none;background-color:unset;cursor:pointer}.grid__btn-clear.sc-ez-grid{--ez-button--link-color:var(--color--alert-warning-900, #8C6B00);--ez-button--link--hover-color:var(--color--alert-warning-900, #8C6B00)}[no-header].sc-ez-grid-h .grid-header.sc-ez-grid{height:0;padding:0}.grid-header__pagination.sc-ez-grid{justify-content:flex-end;flex-wrap:nowrap;flex-shrink:1;flex-grow:1}.grid-header__pagination-label.sc-ez-grid{width:100%;white-space:nowrap}.overflowed.sc-ez-grid{display:none}.pagination-contracted.sc-ez-grid{width:100px}.pagination-expanded.sc-ez-grid{min-width:150px}.left__header-contracted.sc-ez-grid{width:auto}.left__header-expanded.sc-ez-grid{flex-grow:1}.grid__footer.sc-ez-grid{background-color:var(--background--xlight, #FFF);border-radius:0 0 var(--border--radius-medium) var(--border--radius-medium);box-shadow:var(--shadow--small)}.cancel-pagination.sc-ez-grid{display:flex;flex-direction:row;align-items:center;justify-content:space-between;gap:4px;padding:8px;width:180px}.cancel-pagination-btn.sc-ez-grid{color:var(--color--error);font-size:var(--text--medium);font-weight:var(--text-weight--large);font-family:var(--font-pattern, Roboto);text-wrap:nowrap;cursor:pointer}.spin.sc-ez-grid{animation-name:spin;animation-duration:5000ms;animation-iteration-count:infinite;animation-timing-function:linear}@keyframes spin{from{transform:rotate(0deg)}to{transform:rotate(360deg)}}";
 
 const windowInstace = window;
 const matches = (text, filter) => {
@@ -65408,6 +66260,9 @@ const EzGrid = class {
     this.outlineMode = false;
     this.enableRowTableStriped = true;
     this.compact = false;
+    this.useSearchColumn = true;
+    this.suppressHorizontalScroll = false;
+    this.mode = "complete";
   }
   /**
    * Aplica a definição de colunas.
@@ -65461,7 +66316,7 @@ const EzGrid = class {
    * Localiza determinada coluna tornando-a visível.
    */
   async locateColumn(columnName) {
-    this._gridController.locateColumn(columnName);
+    this._gridController.locateColumn(columnName, this._element);
   }
   /**
    * Usa um argumento para filtrar as colunas po label
@@ -65564,6 +66419,14 @@ const EzGrid = class {
       this._showPaginationDescription();
     }
   }
+  async observeModeChange(newMode = this.mode) {
+    if (newMode === "simple") {
+      this.canEdit = false;
+      this.multipleSelection = false;
+      this.suppressCheckboxColumn = true;
+      this.compact = true;
+    }
+  }
   onSelectionChange(evt) {
     this._currentPageSelected = evt.detail.selectionHeaderStatus === true;
     if (this.dataUnit) {
@@ -65816,6 +66679,7 @@ const EzGrid = class {
       enableLockManagerTaskbarClick: this.enableLockManagerTaskbarClick,
       enableLockManagerLoadingComp: this.enableLockManagerLoadingComp,
       enableRowTableStriped: this.enableRowTableStriped,
+      suppressHorizontalScroll: this.suppressHorizontalScroll
     });
     if (this.config) {
       this.observeConfig(this.config);
@@ -65916,6 +66780,7 @@ const EzGrid = class {
   }
   connectedCallback() {
     var _a;
+    this.observeModeChange();
     (_a = this._gridController) === null || _a === void 0 ? void 0 : _a.registryListeners();
   }
   componentWillRender() {
@@ -65948,6 +66813,9 @@ const EzGrid = class {
     return this.columnfilterDataSource;
   }
   hideHeader() {
+    if (this.mode === "simple") {
+      return true;
+    }
     return !this._hasLeftButtons && !this._paginationInfo;
   }
   resolveLeftHeaderClass() {
@@ -65984,15 +66852,42 @@ const EzGrid = class {
         this.nextPage();
       }
     }, { description: "Avança para a próxima página.", element: this._element });
+    if (this.useSearchColumn) {
+      this._keyboardManager.bind(SHORTCUT_SEARCH_FIELD, async () => {
+        if (!this._container || !this._ezPopoverSearchColumn)
+          return;
+        const container = this._container.getBoundingClientRect();
+        await focusOnFieldSerch(this._columnSearch);
+        this._ezPopoverSearchColumn.showUnder(this._container, { horizontalGap: container.width - (SEARCH_FIELD_FULL_WIDTH), verticalGap: container.height * -1 });
+      }, { description: LABEL_SEARCH_COLUMN, element: this._element });
+    }
   }
   async removeShortcuts() {
-    if (this._keyboardManager) {
-      this._keyboardManager
-        .unbind("ctrl + .")
-        .unbind("ctrl + ,")
-        .unbind("ctrl + alt + ArrowLeft")
-        .unbind("ctrl + alt + ArrowRight");
-    }
+    var _a;
+    (_a = this._keyboardManager) === null || _a === void 0 ? void 0 : _a.unbindAllShortcutKeys();
+  }
+  renderFieldSearchColumn() {
+    this._columnSearch = buildFieldSearch({
+      value: StringUtils$1.generateUUID(),
+      label: LABEL_SEARCH_COLUMN,
+    }, ({ argument }) => new Promise(accept => {
+      this.filterColumns(argument).then((columns) => {
+        accept(columns
+          .filter(column => !column.hidden)
+          .map(column => ({ label: column.label, value: column.name })));
+      });
+    }), async (option) => {
+      if (option != undefined && option.value != undefined) {
+        await this.locateColumn(option.value);
+        if (this._ezPopoverSearchColumn) {
+          this._ezPopoverSearchColumn.hide();
+        }
+        if (this._container) {
+          requestAnimationFrame(() => this._container.focus());
+        }
+      }
+    });
+    return this._columnSearch;
   }
   render() {
     var _a;
@@ -66002,11 +66897,12 @@ const EzGrid = class {
         'shadow-mode': !this.outlineMode,
         'no-padding': this.compact,
         'header-overlay': !this.hideHeader(),
-      }, ref: elem => (this._container = elem) }), h("div", { class: {
+        'no-scroll': this.suppressHorizontalScroll
+      }, ref: elem => (this._container = elem), tabindex: "0" }), h("div", { class: {
         'ez-box ez-padding--small grid-header': true,
         'outline-mode': this.outlineMode,
         'shadow-mode': !this.outlineMode && !this.hideHeader(),
-      } }, h("filter-column", { class: "grid-header__popover", noHeaderTaskBar: !this._hasLeftButtons, dataSource: this.getDataSource(), dataUnit: this.dataUnit, gridHeaderHidden: this.hideHeader(), ref: (element) => (this._filterColumn = element) }), h("div", { class: "grid-header__position" }, h("div", { class: `grid-header__container grid-header__left-container ${this.resolveLeftHeaderClass()}` }, h("slot", { name: "leftButtons" })), this.getPaginationControl())), h("div", { ref: (ref) => (this._gridSelectionCounter = ref), class: `grid__selection-counter  ez-elevation--4
+      }, tabindex: "0" }, h("filter-column", { class: "grid-header__popover", noHeaderTaskBar: !this._hasLeftButtons, dataSource: this.getDataSource(), dataUnit: this.dataUnit, gridHeaderHidden: this.hideHeader(), ref: (element) => (this._filterColumn = element) }), h("div", { class: "grid-header__position" }, h("div", { class: `grid-header__container grid-header__left-container ${this.resolveLeftHeaderClass()}` }, h("slot", { name: "leftButtons" })), this.getPaginationControl())), h("ez-popover", { ref: elem => (this._ezPopoverSearchColumn = elem), overlayType: "none" }, this.renderFieldSearchColumn()), h("div", { ref: (ref) => (this._gridSelectionCounter = ref), class: `grid__selection-counter  ez-elevation--4
           ${this._showSelectionCounter ? 'grid__selection-counter--opened' : ''}
         ` }, h(SelectionCounter, { selectionCount: this._selectionCount, currentPageSelected: this._currentPageSelected, paginationInfo: this._paginationInfo, canSelectAll: (_a = this.selectionToastConfig) === null || _a === void 0 ? void 0 : _a.canSelectAll, allRecordSelected: this._isAllSelection, onSelectAll: () => this.onSelectAllRecords(), onSelectPage: () => this.onSelectPageRecords(), onClearAll: () => this.onClearSelectedRecords(), onClose: () => (this._showSelectionCounter = false) })), h("div", { class: "grid__footer" }, h("slot", { name: "footer" }))));
   }
@@ -66015,7 +66911,8 @@ const EzGrid = class {
   static get watchers() { return {
     "config": ["observeConfig"],
     "_paginationInfo": ["updatePaginationTooltip"],
-    "paginationCounterMode": ["observePaginationCounterMode"]
+    "paginationCounterMode": ["observePaginationCounterMode"],
+    "mode": ["observeModeChange"]
   }; }
 };
 EzGrid.style = ezGridCss;