@adaptabletools/adaptable 12.1.8-canary.0 → 12.2.0-canary.1

package/index.css

@@ -2544,6 +2544,23 @@ template {
   --ab-cmp-datepicker__font-family: var(--ab__font-family);
   --ab-cmp-datepicker__cell-size: 30px; }
 
+:root {
+  --ab-cmp-toggle-button__background: #ccc;
+  --ab-cmp-toggle-button--active__background: var(--ab-color-success);
+  --ab-cmp-toggle-button__font-size: var(--ab-font-size-1);
+  --ab-cmp-toggle-button__color: var(--ab-color-text-on-primary);
+  --ab-cmp-toggle-button--checked__color: var(--ab-color-accentlight); }
+
+:root {
+  --ab-cmp-module-module-selector__tab-item__border: 1px solid var(--ab-color-primarydark);
+  --ab-cmp-module-module-selector__tab-item__border-radius: var(--ab__border-radius);
+  --ab-cmp-module-module-selector__tab-item__width: 160px;
+  --ab-cmp-module-module-selector__tab-item__header-input__color: var(--ab-color-text-on-primary);
+  --ab-cmp-module-module-selector__toolbar-item__border: 1px solid var(--ab-color-primary);
+  --ab-cmp-module-selector__unused-panel__border: 1px solid var(--ab-color-primarydark);
+  --ab-cmp-module-selector__unused-panel__border-radius: var(--ab__border-radius);
+  --ab-cmp-module-selector__unused-panel__background: var(--ab-color-defaultbackground); }
+
 :root {
   --ab-cmp-loader__background: var(--ab-color-primarydark);
   --ab-cmp-loader__border: var(--ab-color-text-on-primary);
@@ -2564,6 +2581,10 @@ template {
   --ab-cmp-icon__height: 17px;
   --ab-cmp-icon__width: 17px; }
 
+:root {
+  --ab-cmp-listgroupitem__padding: var(--ab-space-2);
+  --ab-cmp-listgroupitem__margin: 0; }
+
 :root {
   --ab-cmp-wizard__padding: var(--ab-space-5);
   --ab-cmp-wizard__margin: var(--ab-space-1);
@@ -2934,12 +2955,19 @@ template {
 
 .ab-DropdownButton {
   position: relative;
+  overflow: visible;
+  outline: none;
   --ab-overlay-horizontal-align: left; }
 
 .ab-DropdownButton__list {
   text-align: start;
   padding: var(--ab-space-1) 0;
-  box-shadow: var(--ab-cmp-dropdownbutton-list__box-shadow); }
+  box-shadow: var(--ab-cmp-dropdownbutton-list__box-shadow);
+  overflow: auto;
+  border: var(--ab-cmp-dropdownbutton-list__border);
+  borderradius: var(--ab-cmp-dropdownbutton-list__border-radius);
+  zindex: var(--ab-cmp-dropdownbutton-list__z-index);
+  background: var(--ab-cmp-dropdownbutton-list__background); }
 
 .ab-DropdownButton__content {
   font-family: var(--ab__font-family);
@@ -2971,11 +2999,23 @@ template {
   border-bottom: var(--ab-cmp-dropdownbutton-list-separator__border); }
 
 .ab-EmptyContent {
-  text-align: center; }
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  font-size: var(--ab-font-size-3);
+  text-align: center;
+  padding: var(--ab-space-4); }
 
 .ab-EmptyContent p {
     color: var(--ab-color-text-on-primary); }
 
+.ab-EmptyContent__wrapper {
+  position: relative;
+  width: 100%;
+  height: 100%; }
+
 .ab-ErrorBox {
   padding: var(--ab-cmp-error-box__padding);
   border-radius: var(--ab-cmp-error-box__border-radius);
@@ -3692,13 +3732,6 @@ input[type='number'].ab-Input:hover::-webkit-inner-spin-button:active {
 .ab-Datepicker-Overlay .rdp.rdp-with_weeknumber .rdp-row td:nth-child(8) {
       display: table-cell; }
 
-:root {
-  --ab-cmp-toggle-button__background: #ccc;
-  --ab-cmp-toggle-button--active__background: var(--ab-color-success);
-  --ab-cmp-toggle-button__font-size: var(--ab-font-size-1);
-  --ab-cmp-toggle-button__color: var(--ab-color-text-on-primary);
-  --ab-cmp-toggle-button--checked__color: var(--ab-color-accentlight); }
-
 .ab-ToggleButton {
   position: relative;
   display: inline-block;
@@ -3825,6 +3858,49 @@ input[type='number'].ab-Input:hover::-webkit-inner-spin-button:active {
   font-size: var(--ab-cmp-Tag__font-size);
   max-width: 100%; }
 
+.ab-ModuleSelector__TabItem {
+  display: flex;
+  flex-direction: column;
+  box-sizing: border-box;
+  margin-right: var(--ab-space-2);
+  width: var(--ab-cmp-module-module-selector__tab-item__width);
+  border: var(--ab-cmp-module-module-selector__tab-item__border);
+  border-radius: var(--ab-cmp-module-module-selector__tab-item__border-radius); }
+
+.ab-ModuleSelector__TabItem__header {
+  display: flex;
+  align-items: center;
+  padding: var(--ab-space-1);
+  border-bottom: var(--ab-cmp-module-module-selector__tab-item__border); }
+
+.ab-ModuleSelector__TabItem__header-input {
+  flex: 1;
+  width: 100%;
+  margin-left: var(--ab-space-1);
+  margin-right: var(--ab-space-1);
+  align-self: stretch;
+  background: transparent;
+  border: none;
+  color: var(--ab-cmp-module-module-selector__tab-item__header-input__color); }
+
+.ab-ModuleSelector__ToolbarList {
+  flex: 1;
+  padding: 4px;
+  padding-bottom: 0;
+  min-height: 200px; }
+
+.ab-ModuleSelector__ToolbarItem {
+  border: var(--ab-cmp-module-module-selector__toolbar-item__border);
+  padding-left: var(--ab-space-1);
+  margin-bottom: var(--ab-space-1); }
+
+.ab-ModuleSelector__UnusedPanel {
+  margin-bottom: var(--ab-space-2);
+  padding-bottom: var(--ab-space-1);
+  border: var(--ab-cmp-module-selector__unused-panel__border);
+  border-radius: var(--ab-cmp-module-selector__unused-panel__border-radius);
+  background-color: var(--ab-cmp-module-selector__unused-panel__background); }
+
 .ab-AdaptableOptions {
   background: var(--ab-cmp-adaptable-options__background-color); }
 
@@ -3846,6 +3922,9 @@ input[type='number'].ab-Input:hover::-webkit-inner-spin-button:active {
   color: var(--ab-cmp-listgroupitem--odd__color); }
 
 .ab-AdaptableObjectRow {
+  align-items: center;
+  padding: var(--ab-cmp-listgroupitem__padding);
+  margin: var(--ab-cmp-listgroupitem__margin);
   background: var(--ab-cmp-listgroupitem__background);
   color: var(--ab-cmp-listgroupitem__color);
   border-radius: var(--ab-cmp-listgroupitem__border-radius); }
@@ -3912,19 +3991,24 @@ html.ab--theme-dark .ab-ListBoxFilterForm--aggrid-style {
   bottom: -10px;
   transform: translate3d(-5px, 0px, 0px); }
 
-.ab-nocode-wizard {
+.ab-NocodeWizard {
   padding: var(--ab-cmp-wizard__padding);
   margin: var(--ab-cmp-wizard__margin);
   background: var(--ab-cmp-wizard__background);
   color: var(--ab-cmp-wizard__color);
   height: 100%; }
 
-.ab-nocode-wizard,
-  .ab-nocode-wizard *,
-  .ab-nocode-wizard *:before,
-  .ab-nocode-wizard *:after {
+.ab-NocodeWizard,
+  .ab-NocodeWizard *,
+  .ab-NocodeWizard *:before,
+  .ab-NocodeWizard *:after {
     box-sizing: border-box; }
 
+.ab-NocodeWizardFormBox {
+  border: 1px solid var(--ab-color-primarydark);
+  border-radius: var(--ab__border-radius);
+  background-color: var(--ab-color-defaultbackground); }
+
 .ab-AvailableDropZone .placeholder,
 .ab-SelectedDropZone .placeholder {
   width: 100%; }
@@ -4065,20 +4149,23 @@ html.ab--theme-dark .ab-ListBoxFilterForm--aggrid-style {
     padding: var(--ab-cmp-adaptable-popup--settings__padding);
     min-width: 0; }
 
+.ab-Adaptable-Popup__Panel {
+  width: 100%; }
+
 .ab-Adaptable-Popup__Panel__Header {
-  display: flex;
-  padding: 0 var(--ab-cmp-adaptable-popup-panel__padding);
-  margin-bottom: var(--ab-cmp-adaptable-popup-panel__margin-bottom);
-  margin-top: var(--ab-cmp-adaptable-popup-panel__margin-top); }
+    display: flex;
+    padding: 0 var(--ab-cmp-adaptable-popup-panel__padding);
+    margin-bottom: var(--ab-cmp-adaptable-popup-panel__margin-bottom);
+    margin-top: var(--ab-cmp-adaptable-popup-panel__margin-top); }
 
 .ab-Adaptable-Popup__Panel__Header__Title {
-    font-size: var(--ab-cmp-adaptable-popup-panel-title__font-size); }
+      font-size: var(--ab-cmp-adaptable-popup-panel-title__font-size); }
 
 .ab-Adaptable-Popup__Panel__Body {
-  padding: var(--ab-cmp-adaptable-popup-panel-body__padding);
-  flex: 1 1 0;
-  min-height: 0;
-  overflow: auto; }
+    padding: var(--ab-cmp-adaptable-popup-panel-body__padding);
+    flex: 1 1 0;
+    min-height: 0;
+    overflow: auto; }
 
 .ab-Adaptable-Popup--window .ab-Adaptable-Popup__TopBar {
   cursor: move; }
@@ -4211,6 +4298,28 @@ button.ab-StatusBar__SubPanel:hover {
   --ab-cmp-adaptable-permitted-values-selector__background-color: var(--ab-color-defaultbackground);
   --ab-cmp-adaptable-permitted-values-selector__padding: var(--ab-space-1); }
 
+.ab-ValueSelector {
+  overflow: hidden; }
+
+.ab-ValueSelector__option {
+    border-radius: 'var(--ab__border-radius)'; }
+
+.ab-ValueSelector__show-selected-only-checkbox {
+    position: sticky;
+    top: 0;
+    z-index: 10000; }
+
+.ab-ValueSelector__show-selected-only-checkbox__text {
+    position: absolute;
+    top: 2px;
+    right: 4px;
+    overflow: hidden;
+    border-radius: var(--ab__border-radius);
+    margin-right: var(--ab-space-1);
+    margin-top: var(--ab-space-1);
+    padding: 0 var(--ab-space-2);
+    font-size: var(--ab-font-size-2); }
+
 .ab-alert--error {
   background: var(--ab-color-error); }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptabletools/adaptable",
-  "version": "12.1.8-canary.0",
+  "version": "12.2.0-canary.1",
   "description": "Powerful data-agnostic HTML5 datagrid add-on that sits on top of an underlying grid component and provides all the rich functionality that advanced users expect from their DataGrids and Data Tables",
   "keywords": [
     "web-components",

package/publishTimestamp.d.ts

@@ -1,2 +1,2 @@
-declare const _default: 1661370166897;
+declare const _default: 1661757179502;
 export default _default;

package/publishTimestamp.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = 1661370166897;
+exports.default = 1661757179502;

package/src/AdaptableOptions/AdaptableQLOptions.d.ts

@@ -1,8 +1,10 @@
 import { ExpressionFunctionMap } from '../parser/src/types';
 import { AdaptablePredicateDef } from '../PredefinedConfig/Common/AdaptablePredicate';
-import { AdaptableModule, AdaptableQLModules } from '../PredefinedConfig/Common/Types';
+import { AdaptableModule, AdaptableQLModule, AdaptableQLModules } from '../PredefinedConfig/Common/Types';
+import { BaseContext } from '../PredefinedConfig/Common/BaseContext';
+import { AdaptableColumn } from '../PredefinedConfig/Common/AdaptableColumn';
 /**
- * Options for managing AdaptableQL - the Adaptable Query Lanaguage which evaluates Predicates and Expressions
+ * Options for managing AdaptableQL - the Adaptable Query Language which evaluates Predicates and Expressions
  */
 export interface AdaptableQLOptions {
     /**
@@ -17,10 +19,15 @@ export interface AdaptableQLOptions {
      *
      * @defaultValue undefined
      * @gridInfoItem
+     * @deprecated use `evaluateAdaptableQLExternally()` instead
      */
     externallyEvaluatedModules?: AdaptableQLModules;
     /**
-     * Options for managing Expressions in AdapTableQL
+     * Whether a specific expression (or all expressions in a given module) must be evaluated on the server
+     */
+    evaluateAdaptableQLExternally?: (context: EvaluateExpressionExternallyContext) => boolean;
+    /**
+     * Options for managing Expressions in AdaptableQL
      *
      */
     expressionOptions?: ExpressionOptions;
@@ -28,41 +35,47 @@ export interface AdaptableQLOptions {
      * Definitions for Custom provided Predicates
      */
     customPredicateDefs?: AdaptablePredicateDef[];
+    /**
+     * Whether to display the column friendly names in all expression overviews (instead of their technical IDs)
+     *
+     * @defaultValue true
+     */
+    displayColumnFriendlyNamesForExpressions?: boolean;
 }
 /**
- * Options for managing Expressions using AdapTableQL
+ * Options for managing Expressions using AdaptableQL
  */
 export interface ExpressionOptions {
     /**
-     * Boolean Expression Functions available in AdapTableQL
+     * Boolean Expression Functions available in AdaptableQL
      *
      * @defaultValue null (sets all)
      * @gridInfoItem
      */
     defaultBooleanFunctions?: ExpressionFunctionMap;
     /**
-     * Scalar Expression Functions available in AdapTableQL
+     * Scalar Expression Functions available in AdaptableQL
      *
      * @defaultValue null (sets all)
      * @gridInfoItem
      */
     defaultScalarFunctions?: ExpressionFunctionMap;
     /**
-     * Observable Expression Functions available in AdapTableQL
+     * Observable Expression Functions available in AdaptableQL
      *
      * @defaultValue null (sets all)
      * @gridInfoItem
      */
     defaultObservableFunctions?: ExpressionFunctionMap;
     /**
-     * Aggregated Boolean Expression Functions available in AdapTableQL
+     * Aggregated Boolean Expression Functions available in AdaptableQL
      *
      * @defaultValue null (sets all)
      * @gridInfoItem
      */
     defaultAggregatedBooleanFunctions?: ExpressionFunctionMap;
     /**
-     * Aggregated Scalar Expression Functions available in AdapTableQL
+     * Aggregated Scalar Expression Functions available in AdaptableQL
      *
      * @defaultValue null (sets all)
      * @gridInfoItem
@@ -78,7 +91,7 @@ export interface ExpressionOptions {
         [module in AdaptableModule]?: ModuleExpressionFunctions;
     };
     /**
-     * Columns that can be included in AdapTableQL Expressions; leave unset to include **ALL**, provide empty array to set **NONE**
+     * Columns that can be included in AdaptableQL Expressions; leave unset to include **ALL**, provide empty array to set **NONE**
      *
      * @defaultValue undefined
      * @gridInfoItem
@@ -98,6 +111,10 @@ export interface ExpressionOptions {
      * @gridInfoItem
      */
     maxTimeframeSize?: number;
+    /**
+     * Custom query variables allow values to be attached to variables so that a single value can easily be expressed multiple times within a query, or quickly changed to affect the results of a query. Variables are evaluated synchronously with each expression evaluation.
+     */
+    customQueryVariable?: Record<string, string | number | boolean | Date | ((context: CustomQueryVariableContext) => string | number | boolean | Date)>;
 }
 /**
  * Module specific Expression Functions
@@ -109,3 +126,20 @@ export interface ModuleExpressionFunctions {
     aggregatedBooleanFunctions?: ExpressionFunctionMap;
     aggregatedScalarFunctions?: ExpressionFunctionMap;
 }
+/**
+ * Context passed when evaluating `ExpressionOptions.customQueryVariable`
+ */
+export interface CustomQueryVariableContext extends BaseContext {
+    /**
+     * Optional variable arguments
+     */
+    args?: any[];
+}
+/**
+ * Context passed when evaluating `AdaptableQLOptions.evaluateExpressionExternally()`
+ */
+export interface EvaluateExpressionExternallyContext extends BaseContext {
+    module: AdaptableQLModule;
+    expression?: string;
+    referencedColumns?: AdaptableColumn[];
+}

package/src/AdaptableOptions/FinancePluginOptions.d.ts

@@ -37,14 +37,14 @@ export interface FinancePluginOptions {
          */
         customFDC3Intents?: CustomFDC3Intent[];
     };
-    /**
-     * Columns to use a Weighted Average aggregation
-     */
-    weightedAverageColumns?: WeightedAverageColumn[];
     /**
      * Intents to which to subscribe.
      */
     availableFDC3Intents?: (FDC3Intent | CustomFDC3Intent)[];
+    /**
+     * @deprecated - use Weighted Average Layout Aggregation
+     */
+    weightedAverageColumns?: WeightedAverageColumn[];
     /**
      * Called when an intent from `availableIntents` is raised.
      */
@@ -55,16 +55,10 @@ export interface FinancePluginOptions {
     onFDC3Context?: (context: FDC3Context, adaptableApi: AdaptableApi) => void;
 }
 /**
- * An Column which contains a Weighted Average aggregation
+ * @deprecated - use Weighted Average Layout Aggregation
  */
 export interface WeightedAverageColumn {
-    /**
-     * Column which will contain the aggregation
-     */
     columnId: string;
-    /**
-     * Column used to perform the aggreation calculation
-     */
     weightedColumnId: string;
 }
 /**

package/src/AdaptableOptions/GeneralOptions.d.ts

@@ -1,8 +1,9 @@
-import { AdaptableForm, AdaptableObject, AdaptableScope } from '../../types';
+import { AdaptableColumn, AdaptableForm, AdaptableObject, AdaptableScope, BaseContext } from '../../types';
 import { AdaptableComparerFunction } from '../PredefinedConfig/Common/AdaptableComparerFunction';
 import { AlternativeModuleName } from '../PredefinedConfig/Common/AlternativeModuleName';
 import { FormContext } from '../PredefinedConfig/Common/FormContext';
 import { CellSummaryOperation } from '../PredefinedConfig/Common/CellSummary';
+import { KeyCreatorParams } from '@ag-grid-community/all-modules';
 /**
  * General options for configuring AdapTable including managing Primary Keys
  */
@@ -60,6 +61,10 @@ export interface GeneralOptions {
      * Collection of Data Sets to provide Data to AdapTable
      */
     dataSets?: DataSet[];
+    /**
+     * Value to use for 'Unbalanced Groups' (string columns)
+     */
+    unbalancedGroupsKey?: string | ((context: UnbalancedGroupsKeyContext) => string);
 }
 /**
  * Comparer object for Column Values - used for custom sorting
@@ -100,3 +105,16 @@ export interface DataSetFormContext extends FormContext {
      */
     dataSet: DataSet;
 }
+/**
+ * Context used when setting a value for Unbalanced Row Groups
+ */
+export interface UnbalancedGroupsKeyContext extends BaseContext {
+    /**
+     * Adaptable Column being grouped
+     */
+    adaptableColumn: AdaptableColumn;
+    /**
+     * AG Grid's Key Creator Params
+     */
+    params: KeyCreatorParams;
+}

package/src/AdaptableOptions/StateOptions.d.ts

@@ -51,7 +51,7 @@ export interface AdaptableStateFunctionConfig {
      */
     userName: string;
     /**
-     * optional url
+     * @deprecated unused will be removed in v.13
      */
     url?: string;
 }

package/src/Api/Implementation/AlertApiImpl.js

@@ -313,10 +313,9 @@ class AlertApiImpl extends ApiBase_1.ApiBase {
         return scopeDescription + ' - ' + ruleDescription;
     }
     getAlertRuleDescription(alert) {
-        var _a, _b;
         let ruleDescription = alert.Rule.Predicate
             ? this.adaptable.api.predicateApi.predicateToString(alert.Rule.Predicate)
-            : (_b = (_a = alert.Rule.BooleanExpression) !== null && _a !== void 0 ? _a : alert.Rule.ObservableExpression) !== null && _b !== void 0 ? _b : alert.Rule.AggregatedBooleanExpression;
+            : this.adaptable.api.internalApi.getAdaptableQueryExpressionText(alert.Rule);
         return ruleDescription;
     }
 }

package/src/Api/Implementation/CellSummaryApiImpl.d.ts

@@ -9,4 +9,9 @@ export declare class CellSummaryApiImpl extends ApiBase implements CellSummaryAp
     setCurrentCellSummaryOperation(operation: SummaryOperation | string): void;
     getCellSummaryOperationValue(operation: SummaryOperation | string): any;
     getCurrentCellSummaryOperationValue(): any;
+    /**
+     * Weighted average is availabe only if the current layout has at leat a Weighted Average aggregation defined.
+     */
+    private isWeightedAvetageCellSummaryAvailable;
+    private getWeightedAverageCellSummaryOperation;
 }

package/src/Api/Implementation/CellSummaryApiImpl.js

@@ -6,12 +6,21 @@ const ApiBase_1 = require("./ApiBase");
 const ModuleConstants = tslib_1.__importStar(require("../../Utilities/Constants/ModuleConstants"));
 const SystemRedux = tslib_1.__importStar(require("../../Redux/ActionsReducers/SystemRedux"));
 const Enums_1 = require("../../PredefinedConfig/Common/Enums");
+const weightedAverage_1 = require("../../agGrid/weightedAverage");
 class CellSummaryApiImpl extends ApiBase_1.ApiBase {
     getCurrentCellSummaryOperation() {
         return this.getAdaptableState().System.CellSummaryOperation;
     }
     getCellSummaryOperationDefinitions() {
-        return this.getGeneralOptions().cellSummaryOperations;
+        var _a;
+        let cellSummaryOperations = (_a = this.getGeneralOptions().cellSummaryOperations) !== null && _a !== void 0 ? _a : [];
+        if (this.isWeightedAvetageCellSummaryAvailable()) {
+            cellSummaryOperations = [
+                ...cellSummaryOperations,
+                this.getWeightedAverageCellSummaryOperation(),
+            ];
+        }
+        return cellSummaryOperations;
     }
     showCellSummaryPopup() {
         this.showModulePopup(ModuleConstants.CellSummaryModuleId);
@@ -52,5 +61,18 @@ class CellSummaryApiImpl extends ApiBase_1.ApiBase {
             : cellSummaryOperation.operationName;
         return this.getCellSummaryOperationValue(summaryOperation);
     }
+    /**
+     * Weighted average is availabe only if the current layout has at leat a Weighted Average aggregation defined.
+     */
+    isWeightedAvetageCellSummaryAvailable() {
+        const currentLayout = this.getAdaptableApi().layoutApi.getCurrentLayout();
+        return Object.values(currentLayout.AggregationColumns).some((aggCol) => typeof aggCol === 'object' && aggCol.type === 'weightedAverage');
+    }
+    getWeightedAverageCellSummaryOperation() {
+        return {
+            operationName: 'Weighted Avg',
+            operationFunction: weightedAverage_1.cellSummaryWeightedAverage,
+        };
+    }
 }
 exports.CellSummaryApiImpl = CellSummaryApiImpl;

package/src/Api/Implementation/InternalApiImpl.d.ts

@@ -11,7 +11,7 @@ import { SelectedRowInfo } from '../../PredefinedConfig/Selection/SelectedRowInf
 import { AdaptableModule, AdaptableQLModule } from '../../PredefinedConfig/Common/Types';
 import { GridCell } from '../../PredefinedConfig/Selection/GridCell';
 import { CellDataChangedInfo } from '../../PredefinedConfig/Common/CellDataChangedInfo';
-import { AdaptableCellChangedAlert, AdaptableOptions, AdaptableRowChangedAlert, AdaptableState, AlertFormContext, BaseContext, Layout, LayoutAssociatedObject, SystemStatusMessageInfo, SharedEntity, AdaptableIcon } from '../../types';
+import { AdaptableCellChangedAlert, AdaptableOptions, AdaptableRowChangedAlert, AdaptableState, AlertFormContext, BaseContext, Layout, LayoutAssociatedObject, SystemStatusMessageInfo, SharedEntity, AdaptableIcon, AdaptableQuery } from '../../types';
 import { IValidationService } from '../../Utilities/Services/Interface/IValidationService';
 import { IModuleService } from '../../Utilities/Services/Interface/IModuleService';
 import { IReportService } from '../../Utilities/Services/Interface/IReportService';
@@ -102,6 +102,7 @@ export declare class InternalApiImpl extends ApiBase implements InternalApi {
     getModules(): IModuleCollection;
     getModuleFriendlyName(adaptableModule: AdaptableModule): string;
     runModuleInAdaptableQL(adaptableQLModule: AdaptableQLModule): boolean;
+    evaluateExpressionInAdaptableQL(module: AdaptableQLModule, expression?: string): boolean;
     forAllRowNodesDo(func: (rowNode: RowNode) => void): void;
     forAllVisibleRowNodesDo(func: (rowNode: RowNode) => void): void;
     buildStandaloneColumnHeader(column: AdaptableColumn): AdaptableMenuItem[];
@@ -140,4 +141,5 @@ export declare class InternalApiImpl extends ApiBase implements InternalApi {
     getLabelForTag(adaptableObjectTag: AdaptableObjectTag): string;
     getValueForTag(adaptableObjectTag: AdaptableObjectTag): string | number;
     getEditLookUpValuesForColumn(editLookUpItem: EditLookUpPermittedValues, column: AdaptableColumn, gridCell?: GridCell): any[] | undefined;
+    getAdaptableQueryExpressionText(query: Partial<AdaptableQuery>): string;
 }

package/src/Api/Implementation/InternalApiImpl.js

@@ -299,6 +299,30 @@ class InternalApiImpl extends ApiBase_1.ApiBase {
         const adaptableQLModules = this.getAdaptableQLOptions().externallyEvaluatedModules;
         return !adaptableQLModules.includes(adaptableQLModule);
     }
+    evaluateExpressionInAdaptableQL(module, expression) {
+        var _a;
+        // temporary, until `externallyEvaluatedModules` is removed completely
+        const externallyEvaluatedModules = this.getAdaptableQLOptions().externallyEvaluatedModules;
+        if (externallyEvaluatedModules === null || externallyEvaluatedModules === void 0 ? void 0 : externallyEvaluatedModules.length) {
+            // fallback to deprecated property
+            return this.runModuleInAdaptableQL(module);
+        }
+        const evaluateExpressionExternallyFn = (_a = this.getAdaptableQLOptions()) === null || _a === void 0 ? void 0 : _a.evaluateAdaptableQLExternally;
+        if (typeof evaluateExpressionExternallyFn !== 'function') {
+            return true;
+        }
+        const context = {
+            adaptableApi: this.getAdaptableApi(),
+            module,
+        };
+        if (expression) {
+            context.expression = expression;
+            context.referencedColumns = this.getAdaptableApi()
+                .queryLanguageApi.getColumnsFromExpression(expression)
+                .map((columnId) => this.getAdaptableApi().columnApi.getColumnFromId(columnId));
+        }
+        return evaluateExpressionExternallyFn(context);
+    }
     forAllRowNodesDo(func) {
         this.adaptable.forAllRowNodesDo(func);
     }
@@ -616,5 +640,15 @@ class InternalApiImpl extends ApiBase_1.ApiBase {
         // this will use the columnApi method that first looks for permitted values and then distinct values
         return this.adaptable.api.columnApi.getDistinctDisplayValuesForColumn(column.columnId);
     }
+    getAdaptableQueryExpressionText(query) {
+        var _a;
+        if (!query) {
+            return '';
+        }
+        const displayColumnFriendlyNames = (_a = this.adaptable.adaptableOptions.adaptableQLOptions) === null || _a === void 0 ? void 0 : _a.displayColumnFriendlyNamesForExpressions;
+        return displayColumnFriendlyNames
+            ? this.adaptable.api.queryLanguageApi.getAdaptableQueryExpressionWithColumnFriendlyNames(query)
+            : this.adaptable.api.queryLanguageApi.getAdaptableQueryExpression(query);
+    }
 }
 exports.InternalApiImpl = InternalApiImpl;

package/src/Api/Implementation/LayoutApiImpl.js

@@ -106,7 +106,7 @@ class LayoutApiImpl extends ApiBase_1.ApiBase {
             currentLayout = this.getAdaptableState().Grid.CurrentLayout || currentLayout;
         }
         if (currentLayout) {
-            this.saveLayout(currentLayout);
+            this.createOrUpdateLayout(currentLayout);
         }
     }
     doesLayoutExist(layout) {
@@ -244,7 +244,7 @@ class LayoutApiImpl extends ApiBase_1.ApiBase {
                         return acc;
                     }, {}),
                 }, gridState.Columns);
-                this.saveLayout(defaultLayout);
+                this.createOrUpdateLayout(defaultLayout);
                 return defaultLayout;
             }
         }

package/src/Api/Implementation/QueryLanguageApiImpl.d.ts

@@ -13,4 +13,5 @@ export declare class QueryLanguageApiImpl extends ApiBase implements QueryLangua
     getQueryableColumnIds(): string[] | undefined;
     getModuleExpressionFunctionMap(): ExpressionFunctionMap;
     getAdaptableQueryExpression(query: Partial<AdaptableQuery>): string | undefined;
+    getAdaptableQueryExpressionWithColumnFriendlyNames(query: Partial<AdaptableQuery>): string | undefined;
 }

package/src/Api/Implementation/QueryLanguageApiImpl.js

@@ -90,5 +90,10 @@ class QueryLanguageApiImpl extends ApiBase_1.ApiBase {
         var _a, _b, _c, _d;
         return ((_d = (_c = (_b = (_a = query.BooleanExpression) !== null && _a !== void 0 ? _a : query.ScalarExpression) !== null && _b !== void 0 ? _b : query.ObservableExpression) !== null && _c !== void 0 ? _c : query.AggregatedBooleanExpression) !== null && _d !== void 0 ? _d : query.AggregatedScalarExpression);
     }
+    getAdaptableQueryExpressionWithColumnFriendlyNames(query) {
+        return this.adaptable.api.internalApi
+            .getQueryLanguageService()
+            .getExpressionWithColumnFriendlyNames(this.getAdaptableQueryExpression(query));
+    }
 }
 exports.QueryLanguageApiImpl = QueryLanguageApiImpl;