@adaptabletools/adaptable 12.0.0-canary.4 → 12.0.0-canary.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptabletools/adaptable",
-  "version": "12.0.0-canary.4",
+  "version": "12.0.0-canary.5",
   "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: 1655156262671;
+declare const _default: 1655288118527;
 export default _default;

package/publishTimestamp.js

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

package/src/AdaptableOptions/ColumnOptions.d.ts

@@ -5,10 +5,14 @@ import { Column } from '@ag-grid-community/all-modules';
 export interface ColumnOptions {
     /**
      * Provide an alternative Friendly Name for a Column
+     *
+     * @defaultValue  undefined
      */
     columnFriendlyName?: (columnFriendlyNameContext: ColumnFriendlyNameContext) => string | undefined;
     /**
      * Optional list of Column Types - used primarily for Special Columns
+     *
+     * @defaultValue  []
      */
     columnTypes?: string[];
     /**

package/src/AdaptableOptions/DataChangeHistoryOptions.d.ts

@@ -47,6 +47,8 @@ export interface DataChangeHistoryOptions {
     showDataChange?: (cellDataChangedInfo: CellDataChangedInfo) => boolean;
     /**
      * Action button definition. Can be used to implement undo functionality.
+     *
+     * @defaultValue undefined
      */
     changeHistoryButton?: DataChangeHistoryButton | DataChangeHistoryButton[];
 }

package/src/AdaptableOptions/EditOptions.d.ts

@@ -8,6 +8,8 @@ import { GridCell } from '../PredefinedConfig/Selection/GridCell';
 export interface EditOptions {
     /**
      * Function to validate on Server Adaptable data edits
+     *
+     * @defaultValue undefined
      */
     validateOnServer?: (cellDataChangedInfo: CellDataChangedInfo) => Promise<ValidationResult>;
     /**
@@ -19,10 +21,14 @@ export interface EditOptions {
     displayServerValidationMessages?: boolean;
     /**
      * Function which checks if given Grid Cell is editable
+     *
+     * @defaultValue undefined
      */
     isCellEditable?: (gridCell: GridCell) => boolean;
     /**
      * Custom Operations to use in Smart Edit
+     *
+     * @defaultValue undefined
      */
     smartEditCustomOperations?: SmartEditCustomOperation[];
 }

package/src/AdaptableOptions/LayoutOptions.d.ts

@@ -68,15 +68,20 @@ export interface LayoutOptions {
 export interface LayoutTagOptions {
     /**
      * Automatically generate an Object Tag for each Layout
+     *
+     * @defaultValue false
      */
     autoGenerateTagsForLayouts?: boolean | ((context: AutoGenerateTagsForLayoutsContext) => AdaptableObjectTag[]);
     /**
      * Checks if the provided Adaptable Object is available in the given Layout
+     *
+     * @defaultValue undefined
      */
     isObjectAvailableInLayout?: (context: LayoutAvailableContext) => boolean;
     /**
      * Automatically checks if Adaptable Objects Tags are available in current Layout
-     *  @defaultValue false
+     *
+     * @defaultValue false
      */
     autoCheckTagsForLayouts?: boolean;
 }

package/src/AdaptableOptions/SettingsPanelOptions.d.ts

@@ -29,6 +29,8 @@ export interface SettingsPanelOptions {
     alwaysShowInToolPanel?: boolean;
     /**
      * Ordered items to display at side of Settings Panel
+     *
+     * @defaultValue all available AdapTable modules
      */
     navigation?: {
         items?: (AdaptableSettingsPanel | string | '-')[];

package/src/AdaptableOptions/StateOptions.d.ts

@@ -5,22 +5,32 @@ import { AdaptableState } from '../PredefinedConfig/AdaptableState';
 export interface StateOptions {
     /**
      * Allows the customization of state persistence
+     *
+     * @defaultValue persists state to local storage
      */
     persistState?: AdaptablePersistStateFunction;
     /**
      * Allows the customization of Adaptable State loading
+     *
+     * @defaultValue loads state from local storage
      */
     loadState?: AdaptableLoadStateFunction;
     /**
      * Allows the customization of the Adaptable State that is going to be persisted
+     *
+     * @defaultValue undefined
      */
     saveState?: AdaptableSaveStateFunction;
     /**
      * Allows hooking into Adaptable State hydration
+     *
+     * @defaultValue undefined
      */
     applyState?: (state: any) => any;
     /**
      * Allows clearing of remote Adaptable State
+     *
+     * @defaultValue undefined
      */
     clearState?: AdaptableClearStateFunction;
     /**

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

@@ -10,6 +10,6 @@ export declare class SmartEditApiImpl extends ApiBase implements SmartEditApi {
     getSmartEditValue(): number;
     showSmartEditPopup(): void;
     applySmartEdit(gridCells: GridCell[]): void;
-    getSmartEditCustomOperations(): SmartEditCustomOperation[] | undefined;
+    getSmartEditCustomOperations(): SmartEditCustomOperation[];
     setCustomSmartEditOperation(customOperationName: string): void;
 }

package/src/Api/Implementation/SmartEditApiImpl.js

@@ -26,7 +26,8 @@ class SmartEditApiImpl extends ApiBase_1.ApiBase {
         this.dispatchAction(SmartEditRedux.SmartEditApply(gridCells));
     }
     getSmartEditCustomOperations() {
-        return this.getEditOptions().smartEditCustomOperations;
+        var _a;
+        return (_a = this.getEditOptions().smartEditCustomOperations) !== null && _a !== void 0 ? _a : [];
     }
     setCustomSmartEditOperation(customOperationName) {
         const customOperation = this.getSmartEditCustomOperations().find((so) => so.name == customOperationName);

package/src/Api/SmartEditApi.d.ts

@@ -41,5 +41,5 @@ export interface SmartEditApi {
     /**
      * Retrieves an Smart Edit Custom Operations (provided in Edit Options)
      */
-    getSmartEditCustomOperations(): SmartEditCustomOperation[] | undefined;
+    getSmartEditCustomOperations(): SmartEditCustomOperation[];
 }

package/src/PredefinedConfig/Common/AdaptablePredicate.js

@@ -389,7 +389,7 @@ exports.SystemPredicateDefs = [
         columnScope: { DataTypes: ['Date'] },
         moduleScope: ['filter', 'alert', 'flashingcell', 'conditionalstyle'],
         inputs: [{ type: 'date' }],
-        handler: ({ value, inputs }) => isAfter_1.default(DateHelper_1.parseDateValue(value), new Date(inputs[0])),
+        handler: ({ value, inputs }) => isAfter_1.default(DateHelper_1.parseFilterValueDate(value), DateHelper_1.parseFilterInputDate(inputs[0])),
         toString: ({ inputs }) => `> ${inputs[0]}`,
     },
     {
@@ -399,7 +399,7 @@ exports.SystemPredicateDefs = [
         columnScope: { DataTypes: ['Date'] },
         moduleScope: ['filter', 'alert', 'flashingcell', 'conditionalstyle'],
         inputs: [{ type: 'date' }],
-        handler: ({ value, inputs }) => isBefore_1.default(DateHelper_1.parseDateValue(value), new Date(inputs[0])),
+        handler: ({ value, inputs }) => isBefore_1.default(DateHelper_1.parseFilterValueDate(value), DateHelper_1.parseFilterInputDate(inputs[0])),
         toString: ({ inputs }) => `< ${inputs[0]}`,
     },
     {
@@ -409,7 +409,7 @@ exports.SystemPredicateDefs = [
         columnScope: { DataTypes: ['Date'] },
         moduleScope: ['filter', 'alert', 'flashingcell', 'conditionalstyle'],
         inputs: [{ type: 'date' }],
-        handler: ({ value, inputs }) => isSameDay_1.default(DateHelper_1.parseDateValue(value), new Date(inputs[0])),
+        handler: ({ value, inputs }) => isSameDay_1.default(DateHelper_1.parseFilterValueDate(value), DateHelper_1.parseFilterInputDate(inputs[0])),
         toString: ({ inputs }) => `= ${inputs[0]}`,
     },
     {
@@ -419,7 +419,7 @@ exports.SystemPredicateDefs = [
         columnScope: { DataTypes: ['Date'] },
         moduleScope: ['filter', 'alert', 'flashingcell', 'conditionalstyle'],
         inputs: [{ type: 'date' }],
-        handler: ({ value, inputs }) => !isSameDay_1.default(DateHelper_1.parseDateValue(value), new Date(inputs[0])),
+        handler: ({ value, inputs }) => !isSameDay_1.default(DateHelper_1.parseFilterValueDate(value), DateHelper_1.parseFilterInputDate(inputs[0])),
         toString: ({ inputs }) => `!= ${inputs[0]}`,
     },
     {
@@ -428,7 +428,7 @@ exports.SystemPredicateDefs = [
         icon: { name: 'calendar' },
         columnScope: { DataTypes: ['Date'] },
         moduleScope: ['filter', 'alert', 'flashingcell', 'conditionalstyle'],
-        handler: ({ value, api }) => isSameDay_1.default(DateHelper_1.parseDateValue(value), CalendarHelper_1.default.getNextWorkingDay()),
+        handler: ({ value, api }) => isSameDay_1.default(DateHelper_1.parseFilterValueDate(value), CalendarHelper_1.default.getNextWorkingDay()),
     },
     {
         id: 'LastWorkDay',

package/src/Utilities/Constants/DocumentationLinkConstants.d.ts

@@ -8,3 +8,4 @@ export declare const AggregatedScalarQueryDocsLink: string;
 export declare const PredicateDocsLink: string;
 export declare const PrimaryKeyDocsLink: string;
 export declare const LicenseDocsLink: string;
+export declare const AdaptableOptionsDocsLink: string;

package/src/Utilities/Constants/DocumentationLinkConstants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LicenseDocsLink = exports.PrimaryKeyDocsLink = exports.PredicateDocsLink = exports.AggregatedScalarQueryDocsLink = exports.AggregatedBooleanQueryDocsLink = exports.ObservableQueryDocsLink = exports.ScalarQueryDocsLink = exports.BooleanQueryDocsLink = exports.ExpressionEditorDocsLink = exports.HOST_URL_DOCS = void 0;
+exports.AdaptableOptionsDocsLink = exports.LicenseDocsLink = exports.PrimaryKeyDocsLink = exports.PredicateDocsLink = exports.AggregatedScalarQueryDocsLink = exports.AggregatedBooleanQueryDocsLink = exports.ObservableQueryDocsLink = exports.ScalarQueryDocsLink = exports.BooleanQueryDocsLink = exports.ExpressionEditorDocsLink = exports.HOST_URL_DOCS = void 0;
 exports.HOST_URL_DOCS = 'https://docs.adaptabletools.com';
 //export const HOST_URL_DOCS = 'http://localhost:3000';
 exports.ExpressionEditorDocsLink = `${exports.HOST_URL_DOCS}/guide/ui-expression-editor`;
@@ -12,3 +12,4 @@ exports.AggregatedScalarQueryDocsLink = `${exports.HOST_URL_DOCS}/guide/adaptabl
 exports.PredicateDocsLink = `${exports.HOST_URL_DOCS}/guide/adaptable-ql-predicate`;
 exports.PrimaryKeyDocsLink = `${exports.HOST_URL_DOCS}/guide/dev-guide-tutorial-primary-key`;
 exports.LicenseDocsLink = `${exports.HOST_URL_DOCS}/guide/licensing`;
+exports.AdaptableOptionsDocsLink = `${exports.HOST_URL_DOCS}/guide/reference-options-overview`;

package/src/Utilities/Defaults/DefaultAdaptableOptions.js

@@ -12,6 +12,7 @@ const aggregatedBooleanExpressionFunctions_1 = require("../ExpressionFunctions/a
 const AdaptablePredicate_1 = require("../../PredefinedConfig/Common/AdaptablePredicate");
 const Enums_1 = require("../../PredefinedConfig/Common/Enums");
 const aggregatedScalarExpressionFunctions_1 = require("../ExpressionFunctions/aggregatedScalarExpressionFunctions");
+// change type to DeepRequired<AdaptableOptions> to check which properties have no default values defined
 exports.DefaultAdaptableOptions = {
     adaptableId: GeneralConstants.ADAPTABLE_ID,
     adaptableStateKey: undefined,
@@ -28,6 +29,7 @@ exports.DefaultAdaptableOptions = {
         statusbarHighlightDuration: 2000,
         dataChangeDetectionPolicy: 'rawValue',
         actionHandlers: undefined,
+        alertMessageText: undefined,
     },
     notificationsOptions: {
         maxNotifications: 3,
@@ -80,6 +82,7 @@ exports.DefaultAdaptableOptions = {
         alertContainer: undefined,
     },
     columnOptions: {
+        columnFriendlyName: undefined,
         columnTypes: GeneralConstants_1.EMPTY_ARRAY,
         showMissingColumnsWarning: true,
         autoOrderGroupedColumns: true,
@@ -110,6 +113,7 @@ exports.DefaultAdaptableOptions = {
         validateOnServer: undefined,
         displayServerValidationMessages: true,
         isCellEditable: undefined,
+        smartEditCustomOperations: undefined,
     },
     entitlementOptions: {
         defaultAccessLevel: 'Full',
@@ -157,6 +161,8 @@ exports.DefaultAdaptableOptions = {
             maxColumnsToDisplay: 10,
         },
         layoutTagOptions: {
+            autoGenerateTagsForLayouts: false,
+            isObjectAvailableInLayout: undefined,
             autoCheckTagsForLayouts: false,
         },
     },
@@ -211,6 +217,7 @@ exports.DefaultAdaptableOptions = {
         saveState: (state) => state,
         loadState: undefined,
         persistState: undefined,
+        clearState: undefined,
     },
     teamSharingOptions: {
         enableTeamSharing: false,
@@ -249,6 +256,7 @@ exports.DefaultAdaptableOptions = {
     dataChangeHistoryOptions: {
         activeByDefault: false,
         showDataChange: undefined,
+        changeHistoryButton: undefined,
     },
     settingsPanelOptions: {
         popupType: 'window',

package/src/Utilities/Extensions/TypeExtensions.d.ts

@@ -43,4 +43,34 @@ export declare type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<
 }[Keys];
 /** Similar to the builtin Extract, but checks the filter strictly */
 export declare type StrictExtract<T, U extends Partial<T>> = Extract<T, U>;
+/**
+ * DeepRequired
+ *
+ * from https://github.com/piotrwitek/utility-types
+ *
+ * @desc Required that works for deeply nested structure
+ * @example
+ *   // Expect: {
+ *   //   first: {
+ *   //     second: {
+ *   //       name: string;
+ *   //     };
+ *   //   };
+ *   // }
+ *   type NestedProps = {
+ *     first?: {
+ *       second?: {
+ *         name?: string;
+ *       };
+ *     };
+ *   };
+ *   type RequiredNestedProps = DeepRequired<NestedProps>;
+ */
+export declare type DeepRequired<T> = T extends (...args: any[]) => any ? T : T extends any[] ? _DeepRequiredArray<T[number]> : T extends object ? _DeepRequiredObject<T> : T;
+export interface _DeepRequiredArray<T> extends Array<DeepRequired<NonUndefined<T>>> {
+}
+export declare type _DeepRequiredObject<T> = {
+    [P in keyof T]-?: DeepRequired<NonUndefined<T[P]>>;
+};
+export declare type NonUndefined<A> = A extends undefined ? never : A;
 export {};

package/src/Utilities/Helpers/AdaptableHelper.d.ts

@@ -9,15 +9,13 @@ export declare function initPredefinedConfigWithUuids(predefinedConfig: Predefin
 export declare function checkValidPrimaryKey(adaptable: IAdaptable): boolean;
 export declare function AdaptableObjectExistsInState(array: AdaptableObject[], itemToCheck: AdaptableObject): boolean;
 export declare function getAppropriateAccessLevel(adaptableObject: AdaptableObject, moduleAccessLevel: AccessLevel): AccessLevel;
-export declare function checkAdaptableOptions(adaptableOptions: AdaptableOptions): void;
 export declare function runAdaptableComparerFunction(columnId: string, columnValues: any[], adaptable: IAdaptable): AdaptableComparerFunction;
 export declare function addAdaptableObjectUuidAndSource(adaptableObject: AdaptableObject): AdaptableObject;
 export declare const AdaptableHelper: {
-    assignadaptableOptions: typeof assignAdaptableOptions;
+    assignAdaptableOptions: typeof assignAdaptableOptions;
     initPredefinedConfigWithUuids: typeof initPredefinedConfigWithUuids;
     checkValidPrimaryKey: typeof checkValidPrimaryKey;
     AdaptableObjectExistsInState: typeof AdaptableObjectExistsInState;
-    checkAdaptableOptions: typeof checkAdaptableOptions;
     runAdaptableComparerFunction: typeof runAdaptableComparerFunction;
     getAppropriateAccessLevel: typeof getAppropriateAccessLevel;
     addUuidAndSource: typeof addAdaptableObjectUuidAndSource;

package/src/Utilities/Helpers/AdaptableHelper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdaptableHelper = exports.addAdaptableObjectUuidAndSource = exports.runAdaptableComparerFunction = exports.checkAdaptableOptions = exports.getAppropriateAccessLevel = exports.AdaptableObjectExistsInState = exports.checkValidPrimaryKey = exports.initPredefinedConfigWithUuids = exports.assignAdaptableOptions = void 0;
+exports.AdaptableHelper = exports.addAdaptableObjectUuidAndSource = exports.runAdaptableComparerFunction = exports.getAppropriateAccessLevel = exports.AdaptableObjectExistsInState = exports.checkValidPrimaryKey = exports.initPredefinedConfigWithUuids = exports.assignAdaptableOptions = void 0;
 const tslib_1 = require("tslib");
 const cloneDeepWith_1 = tslib_1.__importDefault(require("lodash/cloneDeepWith"));
 const isPlainObject_1 = tslib_1.__importDefault(require("lodash/isPlainObject"));
@@ -98,16 +98,6 @@ function getAppropriateAccessLevel(adaptableObject, moduleAccessLevel) {
     return moduleAccessLevel;
 }
 exports.getAppropriateAccessLevel = getAppropriateAccessLevel;
-// perform any checks that are necessary here
-// for now just adaptableId
-function checkAdaptableOptions(adaptableOptions) {
-    if (adaptableOptions.adaptableId) {
-        if (adaptableOptions.adaptableId.includes('.')) {
-            LoggingHelper_1.ConsoleLogWarning("The 'adaptableId' property in adaptableOptions should not include a '.'.  We strongly recommend that you remove this.");
-        }
-    }
-}
-exports.checkAdaptableOptions = checkAdaptableOptions;
 function runAdaptableComparerFunction(columnId, columnValues, adaptable) {
     return function compareItemsOfCustomSort(valueA, valueB, nodeA, nodeB) {
         let firstElementValueString = nodeA
@@ -149,11 +139,10 @@ function addAdaptableObjectUuidAndSource(adaptableObject) {
 }
 exports.addAdaptableObjectUuidAndSource = addAdaptableObjectUuidAndSource;
 exports.AdaptableHelper = {
-    assignadaptableOptions: assignAdaptableOptions,
+    assignAdaptableOptions,
     initPredefinedConfigWithUuids,
     checkValidPrimaryKey,
     AdaptableObjectExistsInState,
-    checkAdaptableOptions,
     runAdaptableComparerFunction,
     getAppropriateAccessLevel,
     addUuidAndSource: addAdaptableObjectUuidAndSource,

package/src/Utilities/Helpers/DateHelper.d.ts

@@ -8,3 +8,30 @@ export declare const isValueValidDate: (data: any) => boolean;
 export declare const dateToISO: (date: Date | number | string) => string;
 export declare const parseToISO: (date: string | Date | number, dateFormat?: string) => string;
 export declare const parseDateValue: (dateValue: string | Date | number, dateFormat?: string) => Date | undefined;
+/**
+ * Creates a date with the same day/month/year/hour with the current timezone.
+ * '2022-06-01T17:00:00.000Z' => '2022-06-01T17:00:00.000+03:00' // RO time
+ *
+ * new Date() always creates the date using the current timezone.
+ * To compare two dates, they need to be in the same timezone.
+ *
+ * @param date Date
+ */
+export declare const utcDateToSameDateInLocale: (date: Date) => Date;
+/**
+ * To make sure selected/input date is correct and in the current time-zone.
+ 
+ *
+ * '2022-06-14' is considered to be '2022-06-13 00:00:00.
+ * And when date object is created it uses the current timezone.
+ *
+ * '2022-06-14' => Mon Jun 13 2022 20:00:00 GMT-0400 (Eastern Daylight Time)
+ *
+ * @param stringDate date string
+ */
+export declare const parseFilterInputDate: (stringDate: string) => Date;
+/**
+ * Used to parse the date from rowDate inside date predicates.
+ * The date is parsed in moved to local timezone.
+ */
+export declare const parseFilterValueDate: (value: any) => Date;

package/src/Utilities/Helpers/DateHelper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseDateValue = exports.parseToISO = exports.dateToISO = exports.isValueValidDate = exports.isValidDate = void 0;
+exports.parseFilterValueDate = exports.parseFilterInputDate = exports.utcDateToSameDateInLocale = exports.parseDateValue = exports.parseToISO = exports.dateToISO = exports.isValueValidDate = exports.isValidDate = void 0;
 const tslib_1 = require("tslib");
 const parseISO_1 = tslib_1.__importDefault(require("date-fns/parseISO"));
 const parse_1 = tslib_1.__importDefault(require("date-fns/parse"));
@@ -63,3 +63,35 @@ const parseDateValue = (dateValue, dateFormat) => {
     return dateInstance;
 };
 exports.parseDateValue = parseDateValue;
+/**
+ * Creates a date with the same day/month/year/hour with the current timezone.
+ * '2022-06-01T17:00:00.000Z' => '2022-06-01T17:00:00.000+03:00' // RO time
+ *
+ * new Date() always creates the date using the current timezone.
+ * To compare two dates, they need to be in the same timezone.
+ *
+ * @param date Date
+ */
+const utcDateToSameDateInLocale = (date) => {
+    return new Date(date.getTime() + date.getTimezoneOffset() * 60 * 1000);
+};
+exports.utcDateToSameDateInLocale = utcDateToSameDateInLocale;
+/**
+ * To make sure selected/input date is correct and in the current time-zone.
+ 
+ *
+ * '2022-06-14' is considered to be '2022-06-13 00:00:00.
+ * And when date object is created it uses the current timezone.
+ *
+ * '2022-06-14' => Mon Jun 13 2022 20:00:00 GMT-0400 (Eastern Daylight Time)
+ *
+ * @param stringDate date string
+ */
+const parseFilterInputDate = (stringDate) => exports.utcDateToSameDateInLocale(new Date(stringDate));
+exports.parseFilterInputDate = parseFilterInputDate;
+/**
+ * Used to parse the date from rowDate inside date predicates.
+ * The date is parsed in moved to local timezone.
+ */
+const parseFilterValueDate = (value) => exports.utcDateToSameDateInLocale(exports.parseDateValue(value));
+exports.parseFilterValueDate = parseFilterValueDate;

package/src/Utilities/Services/Interface/IMetamodelService.d.ts

@@ -11,4 +11,5 @@ export interface GridInfoOption {
 }
 export interface IMetamodelService extends IAdaptableService {
     getGridInfoOptions(): GridInfoOptions;
+    validateAdaptableOptionsValues(): void;
 }

package/src/Utilities/Services/MetamodelService.d.ts

@@ -5,7 +5,13 @@ export declare class MetamodelService implements IMetamodelService {
     private gridInfoOptions;
     constructor(adaptableApi: AdaptableApi);
     getGridInfoOptions(): GridInfoOptions;
+    validateAdaptableOptionsValues(): void;
+    private validateOptionsObject;
+    private getExpectedOptionsValueType;
     private buildGridInfoOptions;
     private mapGridInfoContainerItems;
-    destroy(): void;
+    private getAdaptableOptionsDefaultValues;
+    private getAdaptableMetamodel;
+    private getAdaptableOptionsMetamodel;
+    private getAdaptableOptions;
 }

package/src/Utilities/Services/MetamodelService.js

@@ -3,6 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetamodelService = void 0;
 const adaptable_metamodel_1 = require("../../metamodel/adaptable.metamodel");
 const DefaultAdaptableOptions_1 = require("../Defaults/DefaultAdaptableOptions");
+const LoggingHelper_1 = require("../Helpers/LoggingHelper");
+const DocumentationLinkConstants_1 = require("../Constants/DocumentationLinkConstants");
+const supportedMetamodelTypes = [
+    'string',
+    'number',
+    'boolean',
+    'array',
+    'function',
+    'REFERENCE',
+];
 class MetamodelService {
     constructor(adaptableApi) {
         this.adaptableApi = adaptableApi;
@@ -13,17 +23,72 @@ class MetamodelService {
     getGridInfoOptions() {
         return this.gridInfoOptions;
     }
+    validateAdaptableOptionsValues() {
+        var _a;
+        LoggingHelper_1.LogAdaptableInfo('Validating Adaptable Options...');
+        const adaptableOptionsValues = this.getAdaptableOptions();
+        const adaptableOptionsMetamodel = this.getAdaptableOptionsMetamodel();
+        const adaptableOptionsDefaultValues = this.getAdaptableOptionsDefaultValues();
+        if ((_a = adaptableOptionsValues.adaptableId) === null || _a === void 0 ? void 0 : _a.includes('.')) {
+            LoggingHelper_1.ConsoleLogWarning("The 'AdaptableOptions.adaptableId' property should NOT include a '.' character.  We strongly recommend to remove it to avoid unexpected AdapTable behavior.");
+        }
+        const validationErrors = [];
+        this.validateOptionsObject(validationErrors, 'AdaptableOptions', adaptableOptionsValues, adaptableOptionsMetamodel, adaptableOptionsDefaultValues);
+        if (validationErrors.length) {
+            LoggingHelper_1.LogAdaptableWarning([
+                'AdaptableOptions validation errors:',
+                '\n',
+                ...validationErrors,
+                '\n',
+                `See AdaptableOptions documentation at ${DocumentationLinkConstants_1.AdaptableOptionsDocsLink} for details`,
+            ].join('\n'));
+        }
+    }
+    validateOptionsObject(validationErrors, optionsObjectName, optionsObject, optionsObjectMetamodel, optionsObjectDefaultValues) {
+        Object.entries(optionsObject).forEach(([optionKey, optionValue]) => {
+            const optionMetamodel = optionsObjectMetamodel.properties.find((metamodelProperty) => metamodelProperty.name === optionKey);
+            if (!optionMetamodel) {
+                validationErrors.push(`${optionsObjectName}.${optionKey} (value=${optionValue}) :: unknown/unsupported property, will be ignored`);
+                return;
+            }
+            // let's try to validate the type of the provided value
+            const expectedOptionsValueType = this.getExpectedOptionsValueType(optionMetamodel);
+            const providedOptionsValueType = Array.isArray(optionValue) ? 'array' : typeof optionValue;
+            if (!expectedOptionsValueType) {
+                return;
+            }
+            // if it's a REFERENCE, we try to go (recursively) deeper
+            if (expectedOptionsValueType === 'REFERENCE') {
+                const referenceObjectName = optionMetamodel.reference;
+                const referenceObject = optionsObject[optionKey];
+                const referenceObjectMetamodel = this.getAdaptableMetamodel()[referenceObjectName];
+                if (referenceObject && (referenceObjectMetamodel === null || referenceObjectMetamodel === void 0 ? void 0 : referenceObjectMetamodel.kind) === 'Interface') {
+                    this.validateOptionsObject(validationErrors, referenceObjectName, referenceObject, referenceObjectMetamodel, optionsObjectDefaultValues === null || optionsObjectDefaultValues === void 0 ? void 0 : optionsObjectDefaultValues[optionKey]);
+                }
+            }
+            else if (supportedMetamodelTypes.includes(providedOptionsValueType) &&
+                providedOptionsValueType !== expectedOptionsValueType) {
+                validationErrors.push(`${optionsObjectName}.${optionKey} (value=${optionValue}) :: wrong type (${providedOptionsValueType}), expected ${expectedOptionsValueType}`);
+            }
+        });
+    }
+    getExpectedOptionsValueType(metamodelProperty) {
+        const metamodelPropertyKind = metamodelProperty.kind;
+        if (supportedMetamodelTypes.includes(metamodelPropertyKind)) {
+            return metamodelPropertyKind;
+        }
+    }
     buildGridInfoOptions() {
         const gridInfoOptions = new Map();
-        const adaptableMetamodel = adaptable_metamodel_1.ADAPTABLE_METAMODEL;
-        const adaptableOptionsMetamodel = adaptableMetamodel['AdaptableOptions'];
-        const adaptableOptionsValues = this.adaptableApi.internalApi.getAdaptableOptions();
-        const adaptableOptionsDefaultValues = DefaultAdaptableOptions_1.DefaultAdaptableOptions;
+        const adaptableMetamodel = this.getAdaptableMetamodel();
+        const adaptableOptionsMetamodel = this.getAdaptableOptionsMetamodel();
+        const adaptableOptionsValues = this.getAdaptableOptions();
+        const adaptableOptionsDefaultValues = this.getAdaptableOptionsDefaultValues();
         if (!adaptableOptionsMetamodel) {
             // should never happen
             return gridInfoOptions;
         }
-        // root-level properties are grouped in a syntethic 'Base Options' container
+        // root-level properties are grouped in a synthetic 'Base Options' container
         const baseOptionsItems = this.mapGridInfoContainerItems(adaptableOptionsMetamodel, adaptableOptionsValues, adaptableOptionsDefaultValues);
         gridInfoOptions.set('baseOptions', {
             containerLabel: 'Base Options',
@@ -65,6 +130,17 @@ class MetamodelService {
             };
         });
     }
-    destroy() { }
+    getAdaptableOptionsDefaultValues() {
+        return DefaultAdaptableOptions_1.DefaultAdaptableOptions;
+    }
+    getAdaptableMetamodel() {
+        return adaptable_metamodel_1.ADAPTABLE_METAMODEL;
+    }
+    getAdaptableOptionsMetamodel() {
+        return this.getAdaptableMetamodel()['AdaptableOptions'];
+    }
+    getAdaptableOptions() {
+        return this.adaptableApi.internalApi.getAdaptableOptions();
+    }
 }
 exports.MetamodelService = MetamodelService;

package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/ConfigurationWizard.js

@@ -21,14 +21,16 @@ const ConfigurationWizard = (props) => {
     const handleFinish = () => {
         const newAdaptableOptions = Object.assign({}, adaptableOptions);
         newAdaptableOptions.gridOptions = Object.assign({}, adaptableOptions.gridOptions);
-        newAdaptableOptions.gridOptions.columnDefs = columnsHandle
-            .current.getColumns()
-            .map((column) => {
-            const newColumn = Object.assign(Object.assign({}, column), { headerName: column.caption || StringExtensions_1.default.Humanize(column.field) });
-            delete newColumn.caption;
-            return newColumn;
-        });
-        newAdaptableOptions.primaryKey = columnsHandle.current.getPrimaryKey();
+        if (columnsHandle.current) {
+            newAdaptableOptions.gridOptions.columnDefs = columnsHandle
+                .current.getColumns()
+                .map((column) => {
+                const newColumn = Object.assign(Object.assign({}, column), { headerName: column.caption || StringExtensions_1.default.Humanize(column.field) });
+                delete newColumn.caption;
+                return newColumn;
+            });
+            newAdaptableOptions.primaryKey = columnsHandle.current.getPrimaryKey();
+        }
         setAdaptableOptions(newAdaptableOptions);
         props.onFinish(newAdaptableOptions);
     };

package/src/View/Components/AdaptableDateInput/index.js

@@ -21,7 +21,7 @@ const AdaptableDateInput = React.forwardRef((props, ref) => {
             });
         },
     });
-    const dateValue = new Date(value);
+    const dateValue = DateHelper_1.parseFilterInputDate(value);
     const datepickerProps = Object.assign({ 
         // this is OK as long as we do not support range datepicker
         value: dateValue, onChange: (dateValue) => { var _a;