@adaptabletools/adaptable-cjs 22.0.0-canary.0 → 22.0.0-canary.10

package/src/Utilities/Services/DataService.js

@@ -8,10 +8,16 @@ const Helper_1 = tslib_1.__importDefault(require("../Helpers/Helper"));
 // ~ 8 hours
 const MAX_TIMEFRAME_SIZE = 86400000;
 class DataService {
+    adaptable;
+    emitter;
+    cellDataChangeLogSubject$;
+    cellDataChangeLog$;
+    rowDataChangeLogSubject$;
+    rowDataChangeLog$;
+    undoChangeLog;
+    undoChangeTimers;
     constructor(adaptable) {
         this.adaptable = adaptable;
-        this.on = (eventName, callback) => this.emitter.on(eventName, callback);
-        this.emit = (eventName, data) => this.emitter.emit(eventName, data);
         this.adaptable = adaptable;
         this.emitter = new Emitter_1.default();
         this.cellDataChangeLogSubject$ = new rxjs_1.Subject();
@@ -35,6 +41,8 @@ class DataService {
         this.undoChangeTimers.clear();
         this.undoChangeTimers = null;
     }
+    on = (eventName, callback) => this.emitter.on(eventName, callback);
+    emit = (eventName, data) => this.emitter.emit(eventName, data);
     CreateCellDataChangedEvent(cellDataChangedInfo) {
         if (cellDataChangedInfo.newValue != cellDataChangedInfo.oldValue) {
             this.emitter.emitSync('CellDataChanged', cellDataChangedInfo);
@@ -60,7 +68,7 @@ class DataService {
         // why 2 and not 3 or 1? no good reason, only seems like a reasonable waiting time :)
         const UNDO_WAIT = 2000;
         const timeoutId = setTimeout(() => {
-            this.adaptable.logger.warn(`Undo change was NOT handled, this should NOT happen: PK(${change.primaryKeyValue}) Col(${change.column}) RevertedValue(${change.newValue}) NewValue(${change.oldValue})`);
+            this.adaptable.logger.warn(`Undo change was not handled within timeout: column="${change.column}", primaryKey="${change.primaryKeyValue}", from=${change.newValue} to=${change.oldValue}.`);
             this.extractUndoChange(change);
         }, UNDO_WAIT);
         this.undoChangeTimers.set(undoChangeKey, timeoutId);

package/src/Utilities/Services/Fdc3Service.js

@@ -4,11 +4,13 @@ exports.Fdc3Service = void 0;
 const Fdc3Context_1 = require("../../AdaptableState/Common/Fdc3Context");
 const Fdc3Intent_1 = require("../../AdaptableState/Common/Fdc3Intent");
 class Fdc3Service {
+    adaptableApi;
+    contextHandlerSubscriptions = [];
+    intentHandlerSubscriptions = [];
+    loggedAgentError = false;
+    uiControlsDefaultConfiguration;
     constructor(adaptableApi) {
         this.adaptableApi = adaptableApi;
-        this.contextHandlerSubscriptions = [];
-        this.intentHandlerSubscriptions = [];
-        this.loggedAgentError = false;
         // 1. Subscribe to FDC3 events
         const adaptableHandleIntentFn = this.getFdc3Options().intents?.handleIntent;
         const listenForIntents = this.getFdc3Options().intents?.listensFor ?? [];
@@ -79,7 +81,7 @@ class Fdc3Service {
     getDesktopAgent() {
         if (globalThis.fdc3 == null && !this.loggedAgentError) {
             this.loggedAgentError = true;
-            this.adaptableApi.consoleError('FDC3 Desktop Agent not found. This should be provided by the wrapper application.');
+            this.adaptableApi.consoleError('FDC3 Desktop Agent not found. The host application must provide the FDC3 agent on globalThis.fdc3.');
         }
         return globalThis.fdc3;
     }
@@ -162,11 +164,11 @@ class Fdc3Service {
         if (!this.getFdc3Options().enableLogging) {
             return;
         }
-        this.adaptableApi.consoleLog(`FDC3::${type} - `, params.join(' : '));
+        this.adaptableApi.consoleLog(`FDC3 ${type}: ${params.join(' : ')}`);
     }
     logFdc3Error(error) {
-        this.adaptableApi.consoleError(`FDC3 error`, error);
-        this.adaptableApi.alertApi.showAlertError('FDC3 Error', 'See console for details');
+        this.adaptableApi.consoleError('FDC3 operation failed.', error);
+        this.adaptableApi.alertApi.showAlertError('FDC3', 'An error occurred. See the browser console for details.');
     }
     getFdc3Api() {
         return this.adaptableApi.fdc3Api;

package/src/Utilities/Services/FlashingCellService.js

@@ -6,6 +6,11 @@ exports.FLASHING_CELL_ROW_KEY = '__ROW';
  * This service manages Flashing Cells
  */
 class FlashingCellService {
+    api;
+    // map of rowPrimaryKey -> ColIdOrRowId -> FlashingCellUuid
+    gridCellsCurrentlyFlashing;
+    // map of FlashingCellUuid -> FlashingCell
+    flashingCellsMapping;
     constructor(api) {
         this.api = api;
         this.gridCellsCurrentlyFlashing = {};

package/src/Utilities/Services/LicenseService/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.LicenseService=exports.LicenseValidityType=void 0;const e=require("tslib"),a=require("../../../Redux/ActionsReducers/InternalRedux"),t=require("../../../Redux/ActionsReducers/PopupRedux"),s=e.__importDefault(require("../../ObjectFactory")),i=e.__importDefault(require("lodash/clamp")),o=require("../../Constants/DocumentationLinkConstants"),n=require("../../license/decode"),r=require("./shouldLogThankYouMessage"),l="sales@adaptabletools.com",c=10,d=864e5;var p;!function(e){e.INVALID_LICENSE="INVALID_LICENSE",e.NO_LICENSE="NO_LICENSE",e.NON_PRODUCTION_VALID="NON_PRODUCTION_VALID",e.NON_PRODUCTION_EXPIRED_IN_SCOPE="NON_PRODUCTION_EXPIRED_IN_SCOPE",e.NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE="NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE",e.COMMERCIAL_VALID="COMMERCIAL_VALID",e.COMMERCIAL_EXPIRED_IN_SCOPE="COMMERCIAL_EXPIRED_IN_SCOPE",e.COMMERCIAL_EXPIRED_OUT_OF_SCOPE="COMMERCIAL_EXPIRED_OUT_OF_SCOPE"}(p||(exports.LicenseValidityType=p={}));const h=()=>"undefined"!=typeof window?window.location.origin:"",E=()=>{const e=h(),[a,t,s]=Array.from(/(https):\/\/\d+\-\d+\-\d+\-(sandpack\.codesandbox\.io)/g.exec(e)||[]);return"https"===t&&"sandpack.codesandbox.io"===s},_=()=>{const e=h(),[a,t,s]=Array.from(/(https):\/\/\S+(\.csb\.app)/g.exec(e)||[]);return"https"===t&&".csb.app"===s},I=()=>{const e=h(),[a,t,s]=Array.from(/(https):\/\/\S+(\.adaptabletools\.com)/g.exec(e)||[]);return"https"===t&&".adaptabletools.com"===s};class O{constructor(e,a,t){this.adaptable=e,this.licenseKey=a,this.packageDetails=t,this.adaptable=e,this.adaptable.api.eventApi.on("AdaptableReady",()=>{requestAnimationFrame(()=>{this.adaptable.isDestroyed||this.init()})})}init(){let e=null;if(this.licenseKey)try{e=(0,n.decode)(this.licenseKey)}catch(a){e=a}E()||_()||I()||this.handleLicenseValidation(e,this.getValidityType(e,this.packageDetails))}getValidityType(e,a){if(!e)return p.NO_LICENSE;if(e instanceof Error)return p.INVALID_LICENSE;const t=new Date(a.publishedAt),s=new Date(e.end),i=s<new Date,o=e.trial;let n=null;return n=i?s>t?o?p.NON_PRODUCTION_EXPIRED_IN_SCOPE:p.COMMERCIAL_EXPIRED_IN_SCOPE:o?p.NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE:p.COMMERCIAL_EXPIRED_OUT_OF_SCOPE:o?p.NON_PRODUCTION_VALID:p.COMMERCIAL_VALID,n}handleLicenseValidation(e,a){const t=new Date;t.setHours(0,0,0,0);let s=0;e instanceof Error||!e?.end||(s=Math.floor((e?.end?.getTime()-t.getTime())/d),s=(0,i.default)(s,0,1/0));let p="",h="";!e||e instanceof Error||!e.appName||e.appName==n.GENERIC_APP_NAME||(p=e.appName,h=" for application [APP_NAME]");const E=(e,a=o.LicenseDocsLink,t=l,i=s,n=p)=>e.replace("[LINK]",a).replace("[EMAIL]",t).replace("[APP_NAME]",n).replace("[DAYS]",`${i}`);switch(a){case"NO_LICENSE":case"NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE":this.adaptable.logger.consoleLogByMessageType(E("This instance of AdapTable does not have a license, and some functionality has therefore been removed. In order to use a fully-featured version of AdapTable, please contact [EMAIL]. You can learn more about the different AdapTable license options at [LINK]."),"Error"),this.showNotification("No AdapTable License found."),this.showWatermark("This instance of AdapTable does not have a license, and some functionality has therefore been removed."),this.disableStatePersistence();break;case"INVALID_LICENSE":this.adaptable.logger.consoleLogByMessageType(E("This instance of AdapTable seems to use a corrupted License, and some functionality has therefore been removed. In order to use a fully-featured version of AdapTable, please contact [EMAIL]. You can learn more about the different AdapTable license options at [LINK]."),"Error"),this.showNotification("Corrupted AdapTable License found."),this.showWatermark("This instance of AdapTable has a corrupted License, and some functionality has therefore been removed."),this.disableStatePersistence();break;case"NON_PRODUCTION_VALID":this.adaptable.logger.consoleLogByMessageType(E("This AdapTable trial license expires in [DAYS] days. Please contact [EMAIL] to upgrade to a commercial version of AdapTable. You can learn more about the different AdapTable license options at [LINK]."),"Info");break;case"NON_PRODUCTION_EXPIRED_IN_SCOPE":this.adaptable.logger.consoleLogByMessageType(E("This AdapTable trial license has now expired. Please contact [EMAIL] to upgrade to a commercial version of AdapTable. You can learn more about the different AdapTable license options at [LINK]."),"Warning"),this.showWatermark("AdapTable License has expired");break;case"COMMERCIAL_VALID":if(s<=c)this.adaptable.logger.consoleLogByMessageType(E(`This AdapTable license${h} expires in [DAYS] days.  Please contact [EMAIL] to renew (giving you access to Support and Updates)`),"Info");else try{(0,r.shouldLogThankYouMessage)()&&this.adaptable.logger.consoleLogByMessageType(E(`Thank you for using a valid AdapTable license${h}. Your license will expire in [DAYS] days.`),"Info")}catch(e){}break;case"COMMERCIAL_EXPIRED_IN_SCOPE":this.adaptable.logger.consoleLogByMessageType(E(`This AdapTable license${h} has expired.  Please contact [EMAIL] if you wish to renew (giving you access to Support and Updates)`),"Warning");break;case"COMMERCIAL_EXPIRED_OUT_OF_SCOPE":this.adaptable.logger.consoleLogByMessageType(E(`This AdapTable license${h} has expired. Adaptable version was published after the license expired. Please contact [EMAIL] if you wish to renew your license.`),"Error"),this.showNotification("Adaptable License has expired"),this.showWatermark("Adaptable License has expired")}}showNotification(e){this.adaptable.api.internalApi.dispatchReduxAction((0,t.PopupShowAlert)({alertType:"generic",header:"License Error",message:e,alertDefinition:s.default.CreateInternalAlertDefinitionForMessages("Error")}))}showWatermark(e){this.adaptable.api.internalApi.dispatchReduxAction((0,a.LicenseShowWatermark)(e))}disableStatePersistence(){this.adaptable.api.internalApi.dispatchReduxAction((0,a.LicenseDisablePersistence)())}destroy(){}}exports.LicenseService=O;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.LicenseService=exports.LicenseValidityType=void 0;const e=require("tslib"),a=require("../../../Redux/ActionsReducers/InternalRedux"),t=require("../../../Redux/ActionsReducers/PopupRedux"),s=e.__importDefault(require("../../ObjectFactory")),i=e.__importDefault(require("lodash/clamp")),o=require("../../Constants/DocumentationLinkConstants"),n=require("../../license/decode"),r=require("./shouldLogThankYouMessage"),l="sales@adaptabletools.com",c=10,d=864e5;var p;!function(e){e.INVALID_LICENSE="INVALID_LICENSE",e.NO_LICENSE="NO_LICENSE",e.NON_PRODUCTION_VALID="NON_PRODUCTION_VALID",e.NON_PRODUCTION_EXPIRED_IN_SCOPE="NON_PRODUCTION_EXPIRED_IN_SCOPE",e.NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE="NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE",e.COMMERCIAL_VALID="COMMERCIAL_VALID",e.COMMERCIAL_EXPIRED_IN_SCOPE="COMMERCIAL_EXPIRED_IN_SCOPE",e.COMMERCIAL_EXPIRED_OUT_OF_SCOPE="COMMERCIAL_EXPIRED_OUT_OF_SCOPE"}(p||(exports.LicenseValidityType=p={}));const h=()=>"undefined"!=typeof window?window.location.origin:"",E=()=>{const e=h(),[a,t,s]=Array.from(/(https):\/\/\d+\-\d+\-\d+\-(sandpack\.codesandbox\.io)/g.exec(e)||[]);return"https"===t&&"sandpack.codesandbox.io"===s},_=()=>{const e=h(),[a,t,s]=Array.from(/(https):\/\/\S+(\.csb\.app)/g.exec(e)||[]);return"https"===t&&".csb.app"===s},I=()=>{const e=h(),[a,t,s]=Array.from(/(https):\/\/\S+(\.adaptabletools\.com)/g.exec(e)||[]);return"https"===t&&".adaptabletools.com"===s};class O{adaptable;licenseKey;packageDetails;constructor(e,a,t){this.adaptable=e,this.licenseKey=a,this.packageDetails=t,this.adaptable=e,this.adaptable.api.eventApi.on("AdaptableReady",()=>{requestAnimationFrame(()=>{this.adaptable.isDestroyed||this.init()})})}init(){let e=null;if(this.licenseKey)try{e=(0,n.decode)(this.licenseKey)}catch(a){e=a}E()||_()||I()||this.handleLicenseValidation(e,this.getValidityType(e,this.packageDetails))}getValidityType(e,a){if(!e)return p.NO_LICENSE;if(e instanceof Error)return p.INVALID_LICENSE;const t=new Date(a.publishedAt),s=new Date(e.end),i=s<new Date,o=e.trial;let n=null;return n=i?s>t?o?p.NON_PRODUCTION_EXPIRED_IN_SCOPE:p.COMMERCIAL_EXPIRED_IN_SCOPE:o?p.NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE:p.COMMERCIAL_EXPIRED_OUT_OF_SCOPE:o?p.NON_PRODUCTION_VALID:p.COMMERCIAL_VALID,n}handleLicenseValidation(e,a){const t=new Date;t.setHours(0,0,0,0);let s=0;e instanceof Error||!e?.end||(s=Math.floor((e?.end?.getTime()-t.getTime())/d),s=(0,i.default)(s,0,1/0));let p="",h="";!e||e instanceof Error||!e.appName||e.appName==n.GENERIC_APP_NAME||(p=e.appName,h=" for application [APP_NAME]");const E=(e,a=o.LicenseDocsLink,t=l,i=s,n=p)=>e.replace("[LINK]",a).replace("[EMAIL]",t).replace("[APP_NAME]",n).replace("[DAYS]",`${i}`);switch(a){case"NO_LICENSE":case"NON_PRODUCTION_EXPIRED_OUT_OF_SCOPE":this.adaptable.logger.consoleLogByMessageType(E("This instance of AdapTable does not have a license, and some functionality has therefore been removed. In order to use a fully-featured version of AdapTable, please contact [EMAIL]. You can learn more about the different AdapTable license options at [LINK]."),"Error"),this.showNotification("No AdapTable License found."),this.showWatermark("This instance of AdapTable does not have a license, and some functionality has therefore been removed."),this.disableStatePersistence();break;case"INVALID_LICENSE":this.adaptable.logger.consoleLogByMessageType(E("This instance of AdapTable seems to use a corrupted License, and some functionality has therefore been removed. In order to use a fully-featured version of AdapTable, please contact [EMAIL]. You can learn more about the different AdapTable license options at [LINK]."),"Error"),this.showNotification("Corrupted AdapTable License found."),this.showWatermark("This instance of AdapTable has a corrupted License, and some functionality has therefore been removed."),this.disableStatePersistence();break;case"NON_PRODUCTION_VALID":this.adaptable.logger.consoleLogByMessageType(E("This AdapTable trial license expires in [DAYS] days. Please contact [EMAIL] to upgrade to a commercial version of AdapTable. You can learn more about the different AdapTable license options at [LINK]."),"Info");break;case"NON_PRODUCTION_EXPIRED_IN_SCOPE":this.adaptable.logger.consoleLogByMessageType(E("This AdapTable trial license has now expired. Please contact [EMAIL] to upgrade to a commercial version of AdapTable. You can learn more about the different AdapTable license options at [LINK]."),"Warning"),this.showWatermark("AdapTable License has expired");break;case"COMMERCIAL_VALID":if(s<=c)this.adaptable.logger.consoleLogByMessageType(E(`This AdapTable license${h} expires in [DAYS] days.  Please contact [EMAIL] to renew (giving you access to Support and Updates)`),"Info");else try{(0,r.shouldLogThankYouMessage)()&&this.adaptable.logger.consoleLogByMessageType(E(`Thank you for using a valid AdapTable license${h}. Your license will expire in [DAYS] days.`),"Info")}catch(e){}break;case"COMMERCIAL_EXPIRED_IN_SCOPE":this.adaptable.logger.consoleLogByMessageType(E(`This AdapTable license${h} has expired.  Please contact [EMAIL] if you wish to renew (giving you access to Support and Updates)`),"Warning");break;case"COMMERCIAL_EXPIRED_OUT_OF_SCOPE":this.adaptable.logger.consoleLogByMessageType(E(`This AdapTable license${h} has expired. Adaptable version was published after the license expired. Please contact [EMAIL] if you wish to renew your license.`),"Error"),this.showNotification("Adaptable License has expired"),this.showWatermark("Adaptable License has expired")}}showNotification(e){this.adaptable.api.internalApi.dispatchReduxAction((0,t.PopupShowAlert)({alertType:"generic",header:"License Error",message:e,alertDefinition:s.default.CreateInternalAlertDefinitionForMessages("Error")}))}showWatermark(e){this.adaptable.api.internalApi.dispatchReduxAction((0,a.LicenseShowWatermark)(e))}disableStatePersistence(){this.adaptable.api.internalApi.dispatchReduxAction((0,a.LicenseDisablePersistence)())}destroy(){}}exports.LicenseService=O;

package/src/Utilities/Services/MetamodelService.js

@@ -9,9 +9,9 @@ const AdaptableLogger_1 = require("../../agGrid/AdaptableLogger");
 const DefaultAdaptableOptions_1 = require("../../AdaptableOptions/DefaultAdaptableOptions");
 const supportedMetamodelTypes = ['s', 'n', 'b', 'a', 'f', 'R'];
 class MetamodelService {
+    gridInfoOptions = new Map();
+    getAdaptableOptions = () => null;
     constructor(getAdaptableOptions, validateOptions) {
-        this.gridInfoOptions = new Map();
-        this.getAdaptableOptions = () => null;
         this.getAdaptableOptions = getAdaptableOptions;
         this.gridInfoOptions = this.buildGridInfoOptions();
         if (validateOptions) {

package/src/Utilities/Services/ModuleService.js

@@ -5,6 +5,7 @@ const tslib_1 = require("tslib");
 const Helper_1 = tslib_1.__importDefault(require("../Helpers/Helper"));
 const DocumentationLinkConstants_1 = require("../Constants/DocumentationLinkConstants");
 class ModuleService {
+    adaptableApi;
     constructor(adaptableApi) {
         this.adaptableApi = adaptableApi;
         this.adaptableApi = adaptableApi;
@@ -35,9 +36,7 @@ class ModuleService {
         const registeredAgGridModuleNames = agGridModulesAdapter.getAgGridRegisteredModuleNames();
         const missingAgGridModuleNames = mandatoryAgGridModuleNames.filter((moduleName) => !registeredAgGridModuleNames.includes(moduleName));
         if (missingAgGridModuleNames.length) {
-            this.adaptableApi.consoleError(`AdapTable requires the following AG Grid modules to be registered: ${missingAgGridModuleNames.join(', ')}.
-
-        See for more information: ${DocumentationLinkConstants_1.AgGridRequiredModulesDocsLink}`);
+            this.adaptableApi.consoleError(`Adaptable requires these AG Grid modules: ${missingAgGridModuleNames.join(', ')}. Please register them. See: ${DocumentationLinkConstants_1.AgGridRequiredModulesDocsLink}`);
         }
         // log optional missing AG Grid dependencies for all modules
         this.getModuleCollection().forEach((adaptableModule) => {
@@ -109,84 +108,83 @@ class ModuleService {
     }
     getModuleDocumentationPageByModule(adaptableModule) {
         let url = `${DocumentationLinkConstants_1.HOST_URL_DOCS}/`;
-        let learnUrl = url + 'guide/';
         switch (adaptableModule) {
             case 'Alert':
-                return learnUrl + 'handbook-alerting';
+                return url + 'handbook-alerting';
             case 'BulkUpdate':
                 return url + 'handbook-editing-bulk-update';
             case 'CalculatedColumn':
-                return learnUrl + 'handbook-calculated-column';
+                return url + 'handbook-calculated-column';
             case 'CellSummary':
-                return learnUrl + 'handbook-summarising';
+                return url + 'handbook-summarising-cells';
             case 'Charting':
-                return learnUrl + 'handbook-charts';
+                return url + 'handbook-charts';
             case 'ColumnFilter':
-                return learnUrl + 'handbook-column-filter';
+                return url + 'handbook-column-filter';
             case 'ColumnInfo':
-                return learnUrl + 'dev-guide-column-grid-column-info';
+                return url + 'dev-guide-columns-column-info';
             case 'Comment':
-                return learnUrl + 'handbook-comments';
+                return url + 'handbook-comments';
             case 'CustomSort':
-                return learnUrl + 'handbook-custom-sorting';
+                return url + 'handbook-custom-sorting';
             case 'Dashboard':
-                return learnUrl + 'ui-dashboard';
+                return url + 'ui-dashboard';
             case 'DataChangeHistory':
-                return learnUrl + 'handbook-monitoring-data-change-history';
+                return url + 'handbook-monitoring-data-change-history';
             case 'DataImport':
-                return learnUrl + 'handbook-importing';
+                return url + 'handbook-importing';
             case 'DataSet':
-                return learnUrl + 'handbook-data-sets';
+                return url + 'handbook-data-sets';
             case 'Export':
-                return learnUrl + 'handbook-exporting';
+                return url + 'handbook-exporting';
             case 'Fdc3':
-                return learnUrl + 'handbook-fdc3';
+                return url + 'handbook-fdc3';
             case 'FlashingCell':
-                return learnUrl + 'handbook-flashing-cell';
+                return url + 'handbook-flashing-cell';
             case 'FormatColumn':
-                return learnUrl + 'handbook-column-formatting';
+                return url + 'handbook-column-formatting';
             case 'FreeTextColumn':
-                return learnUrl + 'handbook-freetext-column';
+                return url + 'handbook-freetext-column';
             case 'GridFilter':
-                return learnUrl + 'handbook-grid-filter';
+                return url + 'handbook-grid-filter';
             case 'GridInfo':
-                return learnUrl + 'dev-guide-column-grid-column-info';
+                return url + 'dev-guide-support-monitoring';
             case 'Layout':
-                return learnUrl + 'handbook-layouts';
+                return url + 'handbook-layouts';
             case 'NamedQuery':
-                return learnUrl + 'handbook-named-queries';
+                return url + 'handbook-named-queries';
             case 'Note':
-                return learnUrl + 'handbook-notes';
+                return url + 'handbook-notes';
             case 'PlusMinus':
-                return learnUrl + 'handbook-editing-plus-minus';
+                return url + 'handbook-editing-plus-minus';
             case 'QuickSearch':
-                return learnUrl + 'handbook-quick-search';
+                return url + 'handbook-quick-search';
             case 'Schedule':
-                return learnUrl + 'handbook-scheduling';
+                return url + 'handbook-scheduling';
             case 'SettingsPanel':
-                return learnUrl + 'ui-settings-panel';
+                return url + 'ui-settings-panel';
             case 'Shortcut':
-                return learnUrl + 'handbook-editing-shortcut';
+                return url + 'handbook-editing-shortcut';
             case 'SmartEdit':
-                return learnUrl + 'handbook-editing-smart-edit';
+                return url + 'handbook-editing-smart-edit';
             case 'StateManagement':
-                return learnUrl + 'dev-guide-adaptable-state-management';
+                return url + 'dev-guide-adaptable-state-management';
             case 'StatusBar':
-                return learnUrl + 'ui-status-bar';
+                return url + 'ui-status-bar';
             case 'StyledColumn':
-                return learnUrl + 'handbook-styled-column-overview';
+                return url + 'handbook-styled-column-overview';
             case 'SystemStatus':
-                return learnUrl + 'handbook-system-status-message';
+                return url + 'handbook-system-status-message';
             case 'TeamSharing':
-                return learnUrl + 'handbook-team-sharing';
+                return url + 'handbook-team-sharing';
             case 'Theme':
-                return learnUrl + 'handbook-theming';
+                return url + 'handbook-theming';
             case 'ToolPanel':
-                return learnUrl + 'ui-tool-panel';
+                return url + 'ui-tool-panel';
             case 'IPushPull':
-                return learnUrl + 'integrations-ipushpull';
+                return url + 'integrations-ipushpull';
             case 'OpenFin':
-                return learnUrl + 'integrations-openfin';
+                return url + 'integrations-openfin';
             default:
                 return 'good';
         }

package/src/Utilities/Services/QueryLanguageService.js

@@ -13,13 +13,14 @@ const scalarExpressionFunctions_1 = require("../ExpressionFunctions/scalarExpres
 const TypeExtensions_1 = require("../Extensions/TypeExtensions");
 const AggregatedScalarLiveValue_1 = require("./AggregatedScalarLiveValue");
 class QueryLanguageService {
+    adaptableApi;
+    cacheBooleanValidation = new Map();
+    cacheObservableValidation = new Map();
+    cacheAggregatedBooleanValidation = new Map();
+    cacheAggregatedScalarValidation = new Map();
+    cacheModuleSpecificExpressionFunctions = new Map();
     constructor(adaptableApi) {
         this.adaptableApi = adaptableApi;
-        this.cacheBooleanValidation = new Map();
-        this.cacheObservableValidation = new Map();
-        this.cacheAggregatedBooleanValidation = new Map();
-        this.cacheAggregatedScalarValidation = new Map();
-        this.cacheModuleSpecificExpressionFunctions = new Map();
     }
     evaluateBooleanExpression(expression, module, rowNode, evalContext) {
         if (expression == undefined) {

package/src/Utilities/Services/RowFormService.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RowFormService = void 0;
 class RowFormService {
+    adaptableApi;
     constructor(adaptableApi) {
         this.adaptableApi = adaptableApi;
         if (adaptableApi.optionsApi.getRowFormOptions().autoHandle) {

package/src/Utilities/Services/RowSummaryService.js

@@ -14,15 +14,12 @@ const isEqual_1 = tslib_1.__importDefault(require("lodash/isEqual"));
  * The logic is extracted here to make it easier to follow
  */
 class RowSummaryService {
+    api;
+    cachedCellSummary = new Map();
+    previousRowSummaries;
+    previousLayout;
     constructor(api) {
         this.api = api;
-        this.cachedCellSummary = new Map();
-        this._throttleAcumulatedColumnsThatChanged = new Set();
-        /**
-         *
-         * @param colId optional to evaluate only one column
-         */
-        this._throttledEvaluateRowSummary = (0, throttle_1.default)(this.evaluateRowSummary, 300);
     }
     onAdaptableReady() {
         this.rowSummariesSubscriptions();
@@ -70,12 +67,18 @@ class RowSummaryService {
             this.throttledEvaluateRowSummary();
         });
     }
+    _throttleAcumulatedColumnsThatChanged = new Set();
     throttledEvaluateRowSummary(reason) {
         if (reason) {
             reason.columnIds.forEach((col) => this._throttleAcumulatedColumnsThatChanged.add(col));
         }
         this._throttledEvaluateRowSummary(reason);
     }
+    /**
+     *
+     * @param colId optional to evaluate only one column
+     */
+    _throttledEvaluateRowSummary = (0, throttle_1.default)(this.evaluateRowSummary, 300);
     evaluateRowSummary(reason) {
         if (this._throttleAcumulatedColumnsThatChanged.size > 0) {
             const columnIds = Array.from(this._throttleAcumulatedColumnsThatChanged.values());

package/src/Utilities/Services/TeamSharingService.js

@@ -5,9 +5,11 @@ const tslib_1 = require("tslib");
 const Uuid_1 = require("../../AdaptableState/Uuid");
 const ObjectFactory_1 = tslib_1.__importDefault(require("../ObjectFactory"));
 class TeamSharingService {
+    adaptableApi;
+    dismissedNotifications = [];
+    updateCheckTimerId;
     constructor(adaptableApi) {
         this.adaptableApi = adaptableApi;
-        this.dismissedNotifications = [];
         const teamSharingOptions = adaptableApi.optionsApi.getTeamSharingOptions();
         if (teamSharingOptions.updateInterval > 0) {
             // convert minutes to millis

package/src/Utilities/Services/ThemeService.js

@@ -2,16 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ThemeService = void 0;
 class ThemeService {
+    api;
+    unsubscribe = () => { };
+    styleSheetObject;
     constructor(api) {
-        this.unsubscribe = () => { };
-        this.onThemeChanged = () => {
-            let currentTheme = this.api.themeApi.getCurrentThemeObject();
-            currentTheme = this.mapOsTheme(currentTheme);
-            this.applyNewThemeVariables(currentTheme);
-            // this needs to be called after variables are set
-            // as it may show the warning for a custom/runtime theme
-            this.showMissingThemeFiles(currentTheme);
-        };
         this.api = api;
         this.subscribe();
         if (!this.styleSheetObject) {
@@ -36,6 +30,14 @@ class ThemeService {
             prefferedColorSchemeUnsubscribe();
         };
     }
+    onThemeChanged = () => {
+        let currentTheme = this.api.themeApi.getCurrentThemeObject();
+        currentTheme = this.mapOsTheme(currentTheme);
+        this.applyNewThemeVariables(currentTheme);
+        // this needs to be called after variables are set
+        // as it may show the warning for a custom/runtime theme
+        this.showMissingThemeFiles(currentTheme);
+    };
     applyNewThemeVariables(theme) {
         const variables = theme.CSSVariables;
         if (!variables || Object.keys(variables).length === 0) {
@@ -71,15 +73,11 @@ class ThemeService {
             return val;
         });
         if (abLoaded !== '777') {
-            logger.consoleError('Please import Adaptable styles from "@adaptabletools/adaptable/index.css"');
+            logger.consoleError('Adaptable styles not detected. Please import "@adaptabletools/adaptable/index.css".');
         }
         const isCustomUserTheme = !this.api.themeApi.internalApi.isSystemTheme(themeName);
         if (!isCustomUserTheme && abThemeLoaded !== themeName) {
-            logger.consoleWarn(`Theme "${themeName}" doesn't seem to be loaded! Make sure you import the css file for the "${themeName}" theme!
-
-If it's an AdapTable system theme, try
-
-import "@adaptabletools/adaptable/themes/${themeName}.css"`);
+            logger.consoleWarn(`Theme "${themeName}" does not appear to be loaded. Ensure the CSS file is imported, e.g.: import "@adaptabletools/adaptable/themes/${themeName}.css".`);
         }
     }
     // prefers-color-scheme

package/src/Utilities/Services/ValidationService.js

@@ -8,6 +8,7 @@ const ModuleConstants_1 = require("../Constants/ModuleConstants");
 const GeneralConstants_1 = require("../Constants/GeneralConstants");
 const AdaptableLogger_1 = require("../../agGrid/AdaptableLogger");
 class ValidationService {
+    adaptableApi;
     constructor(adaptableApi) {
         this.adaptableApi = adaptableApi;
         this.adaptableApi = adaptableApi;
@@ -56,7 +57,7 @@ class ValidationService {
             let alert = {
                 alertType: 'cellChanged',
                 header: 'Alert',
-                message: 'Perform Edit Alert Fired',
+                message: 'A validation rule was triggered for this edit.',
                 alertDefinition: failedRules[0],
                 cellDataChangedInfo: cellDataChangedInfo,
             };

package/src/Utilities/createAgStatusPanelComponent.js

@@ -23,6 +23,9 @@ const createAgStatusPanelComponent = (component, adaptable, context) => {
         };
     }
     return class StatusBarRenderer {
+        params;
+        eGui;
+        unmountReactRoot;
         init(params) {
             this.params = params;
             this.eGui = document.createElement('div');

package/src/Utilities/logDeprecation.js

@@ -14,16 +14,15 @@ const doOnce = (func, key) => {
 };
 const logDeprecation = (logger, typeName, oldProp, newProp, message) => {
     const newPropMsg = newProp ? `Please use '${typeName}.${newProp}()' instead. ` : '';
-    doOnce(() => logger.consoleWarn(`'${typeName}.${oldProp}()' is deprecated. ${newPropMsg}${message ?? ''}`), `Deprecated_${oldProp}`);
+    doOnce(() => logger.consoleWarn(`${typeName}.${oldProp}() is deprecated. ${newPropMsg}${message ?? ''}`), `Deprecated_${oldProp}`);
 };
 exports.logDeprecation = logDeprecation;
 const logDeprecationExternal = (logger, oldTypeName, oldProp, newTypeName, newProp, message) => {
     const newPropMsg = newProp ? `Please use '${newTypeName}.${newProp}()' instead. ` : '';
-    doOnce(() => logger.consoleWarn(`'${oldTypeName}.${oldProp}()' is deprecated. ${newPropMsg}${message ?? ''}`), `Deprecated_${oldProp}`);
+    doOnce(() => logger.consoleWarn(`${oldTypeName}.${oldProp}() is deprecated. ${newPropMsg}${message ?? ''}`), `Deprecated_${oldProp}`);
 };
 exports.logDeprecationExternal = logDeprecationExternal;
 const logDeprecationInternal = (logger, typeName, oldProp) => {
-    doOnce(() => logger.consoleWarn(`'${typeName}.${oldProp}()' is deprecated. The method will be removed in the next major release.
-        Please contact support if you need the missing functionality.`), `Deprecated_${oldProp}`);
+    doOnce(() => logger.consoleWarn(`${typeName}.${oldProp}() is deprecated and will be removed in the next major release. Contact support if you need this functionality.`), `Deprecated_${oldProp}`);
 };
 exports.logDeprecationInternal = logDeprecationInternal;

package/src/Utilities/resolveContainerElement.d.ts

@@ -0,0 +1,23 @@
+import type { AdaptableContainerValue, ContainerContext, InitContainerContext } from '../AdaptableOptions/ContainerOptions';
+/**
+ * The union type representing any container option value (static or function).
+ */
+type AnyContainerOption = AdaptableContainerValue | ((context: any) => AdaptableContainerValue);
+/**
+ * Resolves a container option value to an `HTMLElement`.
+ *
+ * Resolution order:
+ * 1. If `container` is `null`/`undefined`, returns `null`.
+ * 2. If `container` is a function, it is called with the provided `context` and the result is resolved.
+ * 3. If the value is an `HTMLElement`, it is returned directly.
+ * 4. If the value is an `AdaptableCSSSelector` (`{ selector: string }`), `document.querySelectorAll` is used.
+ *    If multiple elements match, the first is returned and a console warning is logged.
+ * 5. If the value is a `string`, it is treated as an element ID and `document.getElementById` is used.
+ *
+ * @param container - The container reference to resolve.
+ * @param context - Optional context passed to the function form of the container.
+ * @param doc - The document to query against (defaults to `globalThis.document`).
+ * @returns The resolved `HTMLElement`, or `null` if not found.
+ */
+export declare function resolveContainerElement(container: AnyContainerOption | undefined | null, context?: ContainerContext | InitContainerContext, doc?: Document): HTMLElement | null;
+export {};

package/src/Utilities/resolveContainerElement.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveContainerElement = resolveContainerElement;
+/**
+ * Resolves a container option value to an `HTMLElement`.
+ *
+ * Resolution order:
+ * 1. If `container` is `null`/`undefined`, returns `null`.
+ * 2. If `container` is a function, it is called with the provided `context` and the result is resolved.
+ * 3. If the value is an `HTMLElement`, it is returned directly.
+ * 4. If the value is an `AdaptableCSSSelector` (`{ selector: string }`), `document.querySelectorAll` is used.
+ *    If multiple elements match, the first is returned and a console warning is logged.
+ * 5. If the value is a `string`, it is treated as an element ID and `document.getElementById` is used.
+ *
+ * @param container - The container reference to resolve.
+ * @param context - Optional context passed to the function form of the container.
+ * @param doc - The document to query against (defaults to `globalThis.document`).
+ * @returns The resolved `HTMLElement`, or `null` if not found.
+ */
+function resolveContainerElement(container, context, doc = globalThis.document) {
+    if (container == null) {
+        return null;
+    }
+    // Unwrap function form — pass context if the container is a function
+    const value = typeof container === 'function' ? container(context) : container;
+    // Guard against null/undefined returned by a callback (e.g. document.getElementById(...))
+    if (value == null) {
+        return null;
+    }
+    // Direct HTMLElement reference
+    if (value instanceof HTMLElement) {
+        return value;
+    }
+    // CSS Selector object
+    if (typeof value === 'object' && 'selector' in value) {
+        const matches = doc.querySelectorAll(value.selector);
+        if (matches.length > 1) {
+            console.warn(`[AdapTable] CSS selector "${value.selector}" matched ${matches.length} elements. Using the first match. Consider using a more specific selector.`);
+        }
+        return matches[0] ?? null;
+    }
+    // String element ID
+    if (typeof value === 'string') {
+        return doc.getElementById(value);
+    }
+    return null;
+}

package/src/View/AdaptablePopover/index.d.ts

@@ -17,6 +17,7 @@ export interface AdaptablePopoverProps extends React.ClassAttributes<React.Props
     popupPadding?: 0 | 2;
     alignPosition?: OverlayShowParams['alignPosition'];
     visible?: boolean;
+    disabled?: boolean;
 }
 export declare class AdaptablePopover extends React.Component<React.PropsWithChildren<AdaptablePopoverProps>, {}> {
     render(): React.JSX.Element;

package/src/View/AdaptablePopover/index.js

@@ -39,7 +39,7 @@ class AdaptablePopover extends React.Component {
                 // showTriangle
                 visible: this.props.visible, render: () => popoverClickRootClose, showEvent: (this.props.showEvent || 'mouseenter'), hideEvent: (this.props.hideEvent || 'mouseleave'), style: {
                     overflow: 'visible',
-                }, alignPosition: this.props.alignPosition }, useButton ? (React.createElement(ButtonInfo_1.ButtonInfo, { style: iconStyle, variant: "text", onClick: () => null, icon: showIcon && icon, tooltip: this.props.tooltipText }, this.props.children)) : (React.createElement("div", { title: this.props.tooltipText, tabIndex: 0, style: { cursor: 'pointer', display: 'inline-block' } },
+                }, alignPosition: this.props.alignPosition }, useButton ? (React.createElement(ButtonInfo_1.ButtonInfo, { style: iconStyle, variant: "text", onClick: () => null, icon: showIcon && icon, tooltip: this.props.tooltipText, disabled: this.props.disabled }, this.props.children)) : (React.createElement("div", { title: this.props.tooltipText, tabIndex: 0, style: { cursor: 'pointer', display: 'inline-block' } },
                 this.props.children,
                 showIcon && React.createElement(icons_1.Icon, { name: icon, style: iconStyle }))))));
     }

package/src/View/Alert/ActiveAlertsPanel.js

@@ -11,6 +11,14 @@ const ActiveAlertsPanel = () => {
     const adaptable = (0, AdaptableContext_1.useAdaptable)();
     const filterModule = adaptable.ModuleService.getModuleById(ModuleConstants.AlertModuleId);
     const alerts = (0, react_redux_1.useSelector)((state) => state.Internal.AdaptableAlerts);
+    // map the suspended property from the underlying AlertDefinitions
+    alerts.forEach((alert) => {
+        const liveAlertDef = adaptable.api.alertApi.getAlertDefinitionById(alert.alertDefinition.Uuid);
+        if (liveAlertDef) {
+            // @ts-ignore theoretically AdaptableAlert is not Suspendable; practically <AdaptableObjectCompactList> expects it
+            alert.IsSuspended = liveAlertDef.IsSuspended;
+        }
+    });
     return React.createElement(AdaptableObjectCompactList_1.AdaptableObjectCompactList, { abObjects: alerts, module: filterModule });
 };
 exports.ActiveAlertsPanel = ActiveAlertsPanel;

package/src/View/Alert/AlertViewPanel.js

@@ -6,10 +6,11 @@ const React = tslib_1.__importStar(require("react"));
 const react_redux_1 = require("react-redux");
 const InternalRedux = tslib_1.__importStar(require("../../Redux/ActionsReducers/InternalRedux"));
 const AdaptablePopover_1 = require("../AdaptablePopover");
-const UIHelper_1 = tslib_1.__importDefault(require("../UIHelper"));
 const getAlertButtonStyle_1 = require("./Utilities/getAlertButtonStyle");
 const ActiveAlertsPanel_1 = require("./ActiveAlertsPanel");
 const Flex_1 = require("../../components/Flex");
+const ButtonClear_1 = require("../Components/Buttons/ButtonClear");
+const clsx_1 = tslib_1.__importDefault(require("clsx"));
 class AlertViewPanelComponent extends React.Component {
     constructor(props) {
         super(props);
@@ -24,7 +25,6 @@ class AlertViewPanelComponent extends React.Component {
         }
     }
     render() {
-        const messageType = UIHelper_1.default.getMessageTypeFromAdaptableAlerts(this.props.AdaptableAlerts);
         const { color: buttonTextColor, background: buttonBackground } = (0, getAlertButtonStyle_1.getAlertButtonStyle)(this.props.AdaptableAlerts);
         const collapsedText = this.props.AdaptableAlerts.length == 0
             ? '0 Alerts'
@@ -32,13 +32,17 @@ class AlertViewPanelComponent extends React.Component {
                 ? '1 Alert'
                 : this.props.AdaptableAlerts.length + ' Alerts';
         const alertsPanel = React.createElement(ActiveAlertsPanel_1.ActiveAlertsPanel, null);
-        const elementType = this.props.viewType === 'Toolbar' ? 'DashboardToolbar' : 'ToolPanel';
-        return (React.createElement(Flex_1.Flex, { alignItems: "stretch", className: `ab-${elementType}__Alert__wrap` },
-            React.createElement(Flex_1.Flex, { className: `ab-${elementType}__Alert__text twa:rounded-standard twa:mr-2 twa:p-2 text-2`, style: { color: buttonTextColor, backgroundColor: buttonBackground }, alignItems: "center" }, collapsedText),
-            this.props.AdaptableAlerts.length > 0 && (React.createElement(Flex_1.Flex, { alignItems: "center" },
-                React.createElement(AdaptablePopover_1.AdaptablePopover, { className: `ab-${elementType}__Alert__info`, headerText: "", 
-                    // tooltipText="Alerts"
-                    bodyText: [alertsPanel], MessageType: messageType, useButton: true, showEvent: 'focus', hideEvent: "blur", popoverMinWidth: 400 })))));
+        const isToolbar = this.props.viewType === 'Toolbar';
+        const elementType = isToolbar ? 'DashboardToolbar' : 'ToolPanel';
+        return (React.createElement(Flex_1.Flex, { alignItems: "stretch", className: (0, clsx_1.default)(`ab-${elementType}__Alert__wrap twa:gap-1`, {
+                'twa:min-w-[140px] twa:w-[140px]': isToolbar,
+                [`twa:flex-1`]: !isToolbar,
+            }) },
+            React.createElement(Flex_1.Flex, { key: `${buttonTextColor}_${buttonBackground}_${collapsedText}`, className: `ab-${elementType}__Alert__text twa:flex-1 twa:rounded-standard twa:p-2 text-2 twa:items-center twa:justify-center twa:min-h-input`, style: { color: buttonTextColor, backgroundColor: buttonBackground } }, collapsedText),
+            this.props.AdaptableAlerts.length > 0 && (React.createElement(Flex_1.Flex, { className: 'twa:gap-1' },
+                React.createElement(Flex_1.Flex, { className: "twa:flex twa:box-border" },
+                    React.createElement(ButtonClear_1.ButtonClear, { "aria-label": 'Clear All Alerts', variant: 'outlined', className: `ab-${elementType}__Alert__clear`, onClick: () => this.props.onDeleteAllAlert(this.state.Alerts), tooltip: "Clear All Alerts", showText: this.props.viewType === 'ToolPanel' }, 'Clear Alerts')),
+                React.createElement(AdaptablePopover_1.AdaptablePopover, { className: `ab-${elementType}__Alert__info`, headerText: "Alerts Details", bodyText: [alertsPanel], MessageType: 'Info', useButton: true, showEvent: 'focus', hideEvent: "blur", popoverMinWidth: 400 })))));
     }
 }
 function mapStateToProps(state, ownProps) {

package/src/View/Alert/Utilities/getAlertButtonStyle.d.ts

@@ -2,4 +2,5 @@ import { AdaptableAlert } from '../../../../types';
 export declare const getAlertButtonStyle: (alerts: AdaptableAlert[]) => {
     color: string;
     background: string;
+    cssClasses: string;
 };