@singularsystems/neo-core 1.0.0-alpha.4 → 1.0.0-beta.1

package/README.md

@@ -1,6 +1,6 @@
 # neo-core
 
-This project contains the core functionality of the neo client library. The code in this library is referenced by the neo-vue and neo-react projects.
+This project contains the core functionality of the neo client library. 
 
 ## Testing
 

package/dist/ApiClient/ReadApiClient.d.ts

@@ -1,6 +1,6 @@
 import { AxiosPromise } from 'axios';
-import { PlainObject } from '../Model/IModelBase';
 import { ApiClientBase } from './ApiClientBase';
+import { PlainObject } from '../Model/IModelBase';
 export interface IReadApiClient<TModel, TKey extends string | number> {
     /** Gets a list of entities. */
     get(): AxiosPromise<PlainObject<TModel>[]>;

package/dist/ApiClient/ReadApiClient.js

@@ -1,7 +1,7 @@
 import { __extends } from "tslib";
+import { ApiClientBase } from './ApiClientBase';
 import { Globals } from '../Misc';
 import { NeoTypes } from '../AppServices';
-import { ApiClientBase } from './ApiClientBase';
 var ReadApiClient = /** @class */ (function (_super) {
     __extends(ReadApiClient, _super);
     function ReadApiClient(apiPath, axios) {

package/dist/Components/ButtonOptions.d.ts

@@ -46,6 +46,10 @@ export interface IButtonOptions {
      * Adds a pulse animation to the button.
      */
     pulse?: boolean;
+    /**
+     * Set a custom variant for when a standard variant is not provided.
+     */
+    customVariant?: string;
 }
 export interface IButtonDropDownItem {
     /** Menu item text or component */

package/dist/Components/DatePicker/DatePicker.d.ts

@@ -10,7 +10,6 @@ export default class DatePicker {
     private headerAnimationHelper;
     private inputHasChanged;
     private canAutoSetDate;
-    private suspendLayout;
     private input;
     private popup;
     private headerContainer;
@@ -25,6 +24,7 @@ export default class DatePicker {
     private today;
     private currentViewDate;
     constructor(container: HTMLDivElement, options?: IPartialDateProps);
+    static mustShowInput(options?: IPartialDateProps): boolean | undefined;
     inputFocused(e: FocusEvent): void;
     inputBlurred(): void;
     onInputBlurred(closePopup: boolean): void;
@@ -65,6 +65,7 @@ export default class DatePicker {
     private previousClick;
     private nextClick;
     private moveCurrent;
+    private autoSetDay;
     private createAndAppend;
     destroy(): void;
 }

package/dist/Components/DatePicker/DatePicker.js

@@ -2,7 +2,6 @@ import DateUtils from '../../Dates/DateUtils';
 import AnimationHelper from '../AnimationHelper';
 import { YearsInYearView, ProcessedDatePickerOptions } from './DatePickerOptions';
 import PositionHelper from '../PositionHelper';
-import { Utils } from '../../Utils';
 // TODO: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat
 // TODO: Allow input to be shown with inline picker, and specify position.
 var ViewType;
@@ -17,7 +16,6 @@ var DatePicker = /** @class */ (function () {
         this.isReadOnly = false;
         this.inputHasChanged = false;
         this.canAutoSetDate = false;
-        this.suspendLayout = false;
         this.currentBindValue = null;
         this.boundDateNoTime = null;
         this.options = ProcessedDatePickerOptions.fromPartial(options || {});
@@ -25,7 +23,7 @@ var DatePicker = /** @class */ (function () {
         this.inputBlurred = this.inputBlurred.bind(this);
         this.inputChanged = this.inputChanged.bind(this);
         this.inputKeyDown = this.inputKeyDown.bind(this);
-        if (!this.options.alwaysShow) {
+        if (DatePicker.mustShowInput(options)) {
             this.input = this.container.getElementsByTagName('input')[0];
             this.input.addEventListener("focus", this.inputFocused);
             this.input.addEventListener("mousedown", this.inputFocused);
@@ -36,7 +34,13 @@ var DatePicker = /** @class */ (function () {
                 this.input.placeholder = "hh:mm" + (this.options.formatString.indexOf("s") > 0 ? ":ss" : "");
             }
         }
+        if (this.options.alwaysShow) {
+            container.classList.add("neo-datepicker-always-show");
+        }
     }
+    DatePicker.mustShowInput = function (options) {
+        return !options || !options.alwaysShow || options.showInput;
+    };
     DatePicker.prototype.inputFocused = function (e) {
         if (!this.popup && !this.isReadOnly) {
             this.show();
@@ -111,7 +115,7 @@ var DatePicker = /** @class */ (function () {
         }
     };
     DatePicker.prototype.removePopup = function (animate) {
-        if (this.popup) {
+        if (this.popup && !this.options.alwaysShow) {
             if (animate) {
                 AnimationHelper.scale(this.popup, DatePicker.AnimationClassName, 1, 0);
                 AnimationHelper.beginRemove(this.container, this.popup);
@@ -134,26 +138,26 @@ var DatePicker = /** @class */ (function () {
         // Note: this may have the side effect of calling update().
         this.setBindProperty(dateValue, false);
         this.setInputValue();
-        if (!this.options.alwaysShow && options.close) {
+        if (options.close) {
             this.removePopup(true);
         }
+        if (!options.close || this.options.alwaysShow) {
+            this.resetCurrentViewDate();
+            this.populateContentContainer(true);
+        }
     };
     DatePicker.prototype.setBindProperty = function (dateValue, suspend) {
-        var _this = this;
         if (dateValue) {
             dateValue = DateUtils.max(DateUtils.min(dateValue, this.options.maxDate), this.options.minDate);
         }
-        if (suspend)
-            this.suspendLayout = true;
+        this.currentBindValue = dateValue;
         this.bindProperty.value = dateValue;
-        if (suspend)
-            Utils.nextTick(function () { return _this.suspendLayout = false; });
         if (this.options.onDateSelected !== undefined) {
             this.options.onDateSelected(!suspend);
         }
     };
     DatePicker.prototype.setInputValue = function () {
-        if (!this.options.alwaysShow) {
+        if (this.input) {
             var displayValue = "";
             if (this.bindProperty.value) {
                 displayValue = DateUtils.format(this.bindProperty.value, this.options.formatString);
@@ -191,13 +195,9 @@ var DatePicker = /** @class */ (function () {
             this.currentBindValue = bindProperty === null || bindProperty === void 0 ? void 0 : bindProperty.value;
             this.resetCurrentViewDate();
             if (this.options.alwaysShow) {
-                if (!this.suspendLayout) {
-                    this.createComponents();
-                }
-            }
-            else {
-                this.setInputValue();
+                this.createComponents();
             }
+            this.setInputValue();
         }
     };
     DatePicker.prototype.resetCurrentViewDate = function () {
@@ -312,13 +312,7 @@ var DatePicker = /** @class */ (function () {
         var currentDate = new Date(this.currentViewDate);
         var lastDayOfMonth = DateUtils.monthEnd(currentDate);
         this.prevButton.disabled = this.options.minDateNoTime.getTime() >= currentDate.getTime();
-        if (this.canAutoSetDate && this.options.autoChangeDate == "start") {
-            this.setBindProperty(currentDate, true);
-        }
         this.nextButton.disabled = this.options.maxDateNoTime.getTime() <= lastDayOfMonth.getTime();
-        if (this.canAutoSetDate && this.options.autoChangeDate == "end") {
-            this.setBindProperty(lastDayOfMonth, true);
-        }
         // Start with the first Sunday before the first of the month.
         currentDate.setDate(currentDate.getDate() - currentDate.getDay());
         var first = true;
@@ -471,6 +465,7 @@ var DatePicker = /** @class */ (function () {
         if (this.currentViewType == ViewType.Days) {
             this.canAutoSetDate = true;
             this.currentViewDate.setMonth(this.currentViewDate.getMonth() + delta, 1);
+            this.autoSetDay();
         }
         else {
             this.currentViewDate.setFullYear(this.currentViewDate.getFullYear() + delta * (this.currentViewType == ViewType.Months ? 1 : YearsInYearView));
@@ -478,6 +473,20 @@ var DatePicker = /** @class */ (function () {
         this.populateContentContainer(false, true);
         this.contentAnimationHelper.slide(delta, true);
     };
+    DatePicker.prototype.autoSetDay = function () {
+        var autoDate = null;
+        if (this.options.autoChangeDate === "end") {
+            // Forward
+            autoDate = DateUtils.monthEnd(this.currentViewDate);
+        }
+        else if (this.options.autoChangeDate === "start") {
+            // Back
+            autoDate = this.currentViewDate;
+        }
+        if (autoDate) {
+            this.setBindValue(autoDate, { preserveTime: true, close: false });
+        }
+    };
     DatePicker.prototype.createAndAppend = function (parent, elementType, className) {
         if (className === void 0) { className = ""; }
         var newElement = document.createElement(elementType);

package/dist/Components/DatePicker/DatePickerOptions.d.ts

@@ -13,6 +13,8 @@ export default class DatePickerOptions {
     timeOnly: boolean;
     /** Displays the picker inline and without an input control */
     alwaysShow: boolean;
+    /** Shows the input when using `alwaysShow`. */
+    showInput: boolean;
     minDate: Date;
     maxDate: Date;
     /** Automatically sets the date to the start or end of the displayed month when scrolling through months. */

package/dist/Components/ErrorHandler.d.ts

@@ -33,7 +33,11 @@ export declare enum ErrorDisplayType {
 }
 export declare class ErrorHandler implements IErrorHandler {
     private notifications;
-    constructor(notifications: INotificationHelper);
+    private blobType;
+    constructor(notifications: INotificationHelper, blobType?: {
+        new (blobParts?: BlobPart[] | undefined, options?: BlobPropertyBag | undefined): Blob;
+        prototype: Blob;
+    });
     showError(error: any, displayType: ErrorDisplayType): Promise<void>;
     parseError(error: any): Promise<IErrorDisplay>;
     protected getAxiosError(error: AxiosError, response?: AxiosResponse): Promise<IErrorDisplay>;

package/dist/Components/ErrorHandler.js

@@ -2,7 +2,6 @@ import { __awaiter, __decorate, __generator, __metadata, __param } from "tslib";
 import { injectable, inject } from 'inversify';
 import { ModalUtils } from './Modal/ModalUtils';
 import NeoTypes from '../AppServices/NeoTypes';
-import { Blob } from 'buffer';
 export var ErrorDisplayType;
 (function (ErrorDisplayType) {
     /** Show the error text in a modal. */
@@ -13,8 +12,10 @@ export var ErrorDisplayType;
     ErrorDisplayType[ErrorDisplayType["ThrowError"] = 2] = "ThrowError";
 })(ErrorDisplayType || (ErrorDisplayType = {}));
 export var ErrorHandler = /** @class */ (function () {
-    function ErrorHandler(notifications) {
+    function ErrorHandler(notifications, blobType) {
+        if (blobType === void 0) { blobType = Blob; }
         this.notifications = notifications;
+        this.blobType = blobType;
     }
     ErrorHandler.prototype.showError = function (error, displayType) {
         return __awaiter(this, void 0, void 0, function () {
@@ -163,7 +164,7 @@ export var ErrorHandler = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (!(responseData instanceof Blob)) return [3 /*break*/, 2];
+                        if (!(responseData instanceof this.blobType)) return [3 /*break*/, 2];
                         return [4 /*yield*/, responseData.text()];
                     case 1:
                         errorText = _a.sent();
@@ -204,7 +205,7 @@ export var ErrorHandler = /** @class */ (function () {
     ErrorHandler = __decorate([
         injectable(),
         __param(0, inject(NeoTypes.UI.GlobalNotifications.symbol)),
-        __metadata("design:paramtypes", [Object])
+        __metadata("design:paramtypes", [Object, Object])
     ], ErrorHandler);
     return ErrorHandler;
 }());

package/dist/Components/Modal/ModalOptions.d.ts

@@ -27,6 +27,8 @@ export interface IModalOptionsBase {
     footerContent?: any;
     /** Callback to handle when the modal is closed / cancelled by the user. Not called on accept. */
     onClose?: (event: any) => void;
+    /** Called after the modal animation completes. */
+    afterClose?: () => void;
 }
 export default interface IModalOptions extends IModalOptionsBase {
     /** Controls the visibility of the modal. */

package/dist/Data/Paging/PageManager.d.ts

@@ -79,6 +79,10 @@ export interface IPageManager {
      * @param taskRunner Optional alternate task runner to use.
      */
     refreshData(getCount?: boolean, taskRunner?: ITaskRunner): Promise<void>;
+    /**
+     * Refresh the data only if the page manager has initialised.
+     */
+    invalidateData(taskRunner?: ITaskRunner): Promise<void>;
     /**
      * Refresh the data by calling the api endpoint with the current criteria.
      * This will not reset the page index, and will not update the total record count, therefore should only be called if your criteria has not changed since the last full fetch using refreshData().
@@ -128,6 +132,10 @@ export declare class PageManager<TCriteria extends ValueObject, TModel extends I
      * @param taskRunner Optional alternate task runner to use.
      */
     refreshData(getCount?: boolean, taskRunner?: ITaskRunner): Promise<void>;
+    /**
+     * Refresh the data only if the page manager has initialised.
+     */
+    invalidateData(taskRunner?: ITaskRunner): Promise<void>;
     /**
      * Refresh the data by calling the api endpoint with the current criteria.
      * This will not reset the page index, and will not update the total record count, therefore should only be called if your criteria has not changed since the last full fetch using refreshData().

package/dist/Data/Paging/PageManager.js

@@ -166,13 +166,43 @@ export var PageManager = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Refresh the data only if the page manager has initialised.
+     */
+    PageManager.prototype.invalidateData = function (taskRunner) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.hasInitialised) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.refreshData(true, taskRunner)];
+                    case 1:
+                        _a.sent();
+                        _a.label = 2;
+                    case 2: return [2 /*return*/];
+                }
+            });
+        });
+    };
     /**
      * Refresh the data by calling the api endpoint with the current criteria.
      * This will not reset the page index, and will not update the total record count, therefore should only be called if your criteria has not changed since the last full fetch using refreshData().
      * @param taskRunner Optional alternate task runner to use.
      */
     PageManager.prototype.refreshPage = function (taskRunner) {
-        return this.refreshData(false, taskRunner);
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.hasInitialised) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.refreshData(false, taskRunner)];
+                    case 1:
+                        _a.sent();
+                        _a.label = 2;
+                    case 2: return [2 /*return*/];
+                }
+            });
+        });
     };
     PageManager.prototype.fetchAndSetData = function (request) {
         var _a;

package/dist/Dates/DateUtils.js

@@ -187,6 +187,14 @@ var DateUtils = /** @class */ (function () {
         var newDate = new Date();
         newDate.setFullYear(date.getFullYear() + ((_a = timeSpan.years) !== null && _a !== void 0 ? _a : 0), date.getMonth() + ((_b = timeSpan.months) !== null && _b !== void 0 ? _b : 0), date.getDate() + ((_c = timeSpan.days) !== null && _c !== void 0 ? _c : 0));
         newDate.setHours(date.getHours() + ((_d = timeSpan.hours) !== null && _d !== void 0 ? _d : 0), date.getMinutes() + ((_e = timeSpan.minutes) !== null && _e !== void 0 ? _e : 0), date.getSeconds() + ((_f = timeSpan.seconds) !== null && _f !== void 0 ? _f : 0), date.getMilliseconds() + ((_g = timeSpan.milliseconds) !== null && _g !== void 0 ? _g : 0));
+        if (timeSpan.months && !timeSpan.days) {
+            // 31 May - 1 month == 31 April == 1 May, this will fix that:
+            var newMonth = newDate.getMonth();
+            var oldMonth = date.getMonth();
+            if (newMonth !== oldMonth + (timeSpan.months % 12)) {
+                newDate.setDate(0);
+            }
+        }
         return newDate;
     };
     /**

package/dist/Model/BindableBase.d.ts

@@ -29,7 +29,7 @@ export declare abstract class BindableBase {
      * Must be called in the constructor, preferably directly after the super() call.
      * This method can be used as an alternative to the @NeoModel decorator.
      */
-    protected makeObservable(): void;
+    protected makeObservable(options?: IMakeBindableOptions): void;
     /**
      * Makes the model bindable (and observable if it inherits from ModelBase) by creating its 'meta' object.
      * Must be called in the constructor, preferably directly after the super() call.

package/dist/Model/BindableBase.js

@@ -41,8 +41,11 @@ export var BindableBase = /** @class */ (function () {
      * Must be called in the constructor, preferably directly after the super() call.
      * This method can be used as an alternative to the @NeoModel decorator.
      */
-    BindableBase.prototype.makeObservable = function () {
-        this.makeBindable({ makeObservable: true });
+    BindableBase.prototype.makeObservable = function (options) {
+        var _a;
+        options !== null && options !== void 0 ? options : (options = {});
+        (_a = options.makeObservable) !== null && _a !== void 0 ? _a : (options.makeObservable = true);
+        this.makeBindable(options);
     };
     /**
      * Makes the model bindable (and observable if it inherits from ModelBase) by creating its 'meta' object.

package/dist/Model/Decorators.d.ts

@@ -43,5 +43,8 @@ export declare function OnChanged<T>(callback: (target: T) => (oldValue: any, ne
 export declare function Debounce(value?: boolean): (type: any, propertyKey: string) => void;
 /** Converts a getter into a computed. Note, when using NeoModel you do not need to do this. */
 export declare function Computed(isComputed?: boolean): (type: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+/** Specifies whether a method is a mobx action. By default all methods are actions.
+ * Use this decorator to suppress this behaviour (by passing in false), or change the default behaviour in the makeObservable options passed to makeObservable. */
+export declare function Action(isAction?: boolean): (type: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 /** Sets this property as the display member to be used in drop downs / radio lists etc. */
 export declare function DisplayMember(): (type: any, propertyKey: string) => void;

package/dist/Model/Decorators.js

@@ -173,10 +173,17 @@ export function Computed(isComputed) {
         ensureTypeInfo(type.constructor).neo.addComputed(propertyKey, descriptor, isComputed);
     };
 }
+/** Specifies whether a method is a mobx action. By default all methods are actions.
+ * Use this decorator to suppress this behaviour (by passing in false), or change the default behaviour in the makeObservable options passed to makeObservable. */
+export function Action(isAction) {
+    return function (type, propertyKey, descriptor) {
+        ensureTypeInfo(type.constructor).neo.addMethod(propertyKey).isAction = isAction;
+    };
+}
 /** Sets this property as the display member to be used in drop downs / radio lists etc. */
 export function DisplayMember() {
     return function (type, propertyKey) {
         var pi = getOrAddPropertyInfo(type, propertyKey);
-        type.constructor.neo.displayMember = pi;
+        ensureTypeInfo(type.constructor).neo.displayMember = pi;
     };
 }

package/dist/Model/IModelBase.d.ts

@@ -26,15 +26,20 @@ type RemoveChildren<T> = Pick<T, {
 export type PartialOrNull<T> = {
     [P in keyof T]?: T[P] | null;
 };
+/** Removes ModelBase properties (isNew, isDirty etc), removes methods, and changes list types to arrays. */
 export type PlainObject<T> = TransformLists<NoModelBase<T>>;
+/** PlainObject plus tracking state and entity identifier.  */
 export type PlainTrackedObject<T> = PlainObject<T> & {
     trackingState?: Misc.TrackingState;
     entityIdentifier?: string;
 };
+/** Plain object with no tracking state, and no lists. */
 export type PlainFlatObject<T> = Pick<T, Exclude<keyof T, keyof IModelBase> & keyof RemoveMethods<T> & keyof RemoveChildren<T>>;
+/** Plain object where the meta property is not allowed. Used to accept any Plain* object. */
 export type PartialPlainObject<T> = Partial<PlainObject<T>> & {
     meta?: never;
 };
+/** Plain object where the meta and tracking state properties are not allowed. Used to accept PlainObject and PlainFlatObject. */
 export type PartialPlainNonTrackedObject<T> = PartialPlainObject<T> & {
     trackingState?: never;
 };
@@ -49,6 +54,10 @@ export interface IMakeBindableOptions {
      * * If `undefined`, only types that inherit from `ModelBase` will be observable by default.
      */
     makeObservable?: boolean;
+    /**
+     * Specifies whether methods should be converted to mobx actions. This is `true` by default.
+     * Use `Attributes.Action()` to override this per method. */
+    autoActions?: boolean;
     /**
      * If `true`, this instance will not be converted. In inheritence heirarchies, use this to ensure only the last derived type converts the instance.
      */

package/dist/Model/MethodInfo.d.ts

@@ -0,0 +1,8 @@
+export default class MethodInfo {
+    name: string;
+    constructor(name: string);
+    /**
+     * Specifies whether the method should be converted to a mobx action.
+     */
+    isAction?: boolean;
+}

package/dist/Model/MethodInfo.js

@@ -0,0 +1,7 @@
+var MethodInfo = /** @class */ (function () {
+    function MethodInfo(name) {
+        this.name = name;
+    }
+    return MethodInfo;
+}());
+export default MethodInfo;

package/dist/Model/ModelCreatorBase.d.ts

@@ -19,6 +19,5 @@ export declare abstract class ModelCreatorBase implements IModelCreatorBase {
      */
     protected ensureChildInfo(instance: {}, propertyInfo: PropertyInfo): void;
     protected addMethodInfo(methodName: string, method: Function): void;
-    protected addProperty(propertyName: string, descriptor: PropertyDescriptor): void;
     abstract convertInstance(instance: {}, options: IMakeBindableOptions): {};
 }

package/dist/Model/ModelCreatorBase.js

@@ -5,6 +5,7 @@ import { RelationType } from './Misc';
 import { ChildList, ChildObject } from './Decorators';
 import ValueObject from './ValueObject';
 import { BindableBase } from './BindableBase';
+var nonActionMethods = ["addBusinessRules", "toString"];
 export var ModelCreatorBase = /** @class */ (function () {
     function ModelCreatorBase() {
         this.alwaysInitialiseMembers = false;
@@ -49,10 +50,6 @@ export var ModelCreatorBase = /** @class */ (function () {
                     if (this.typeInfo.inheritsBindableBase) {
                         this.typeInfo.addComputed(propertyName, descriptor);
                     }
-                    else {
-                        // for general objects, getters must explicitly define @Computed to become computed properties.
-                        this.addProperty(propertyName, descriptor);
-                    }
                 }
             }
         }
@@ -82,8 +79,10 @@ export var ModelCreatorBase = /** @class */ (function () {
         }
     };
     ModelCreatorBase.prototype.addMethodInfo = function (methodName, method) {
-    };
-    ModelCreatorBase.prototype.addProperty = function (propertyName, descriptor) {
+        var methodInfo = this.typeInfo.addMethod(methodName);
+        if (nonActionMethods.indexOf(methodInfo.name) >= 0) {
+            methodInfo.isAction = false;
+        }
     };
     ModelCreatorBase = __decorate([
         injectable()

package/dist/Model/NeoTypeInfo.d.ts

@@ -2,6 +2,7 @@ import { Rule } from '../Validation/Rules';
 import { PropertyInstanceMap } from './PropertyInstance';
 import PropertyInfo, { PropertyInfoMap } from './PropertyInfo';
 import { NeoModelConstructor, IModelBase, IMetaItem, IMakeBindableOptions } from './IModelBase';
+import MethodInfo from './MethodInfo';
 export declare class NeoTypeInfo {
     private modelCreator;
     private objectConstructor;
@@ -11,6 +12,7 @@ export declare class NeoTypeInfo {
     private _metaItem;
     properties: PropertyInfo[];
     propertyMap: PropertyInfoMap;
+    methods: Map<string, MethodInfo>;
     children: PropertyInfo[];
     parentProperties: PropertyInfo[];
     parentProperty?: PropertyInfo;
@@ -24,6 +26,7 @@ export declare class NeoTypeInfo {
     private addPropertyInfo;
     getOrAddProperty(propertyName: string): PropertyInfo;
     addComputed(propertyName: string, descriptor: PropertyDescriptor, isComputed?: boolean): void;
+    addMethod(methodName: string): MethodInfo;
     addAttributeRule(propertyName: string, rule: Rule): void;
     /**
      * Ensures the type has all the information it needs in order to convert instances of this type.

package/dist/Model/NeoTypeInfo.js

@@ -7,7 +7,7 @@ import { ValidationRules } from '../Validation/ValidationRules';
 import ModelProxy from '../Validation/ModelProxy';
 import NeoTypes from '../AppServices/NeoTypes';
 import { RelationType } from './Misc';
-var ignoredPropertyNames = ["$mobx"];
+import MethodInfo from './MethodInfo';
 var inversifyMetadataKey = "inversify:tagged";
 var hasConvertedSymbol = Symbol("hasConvertedModel");
 var NeoTypeInfo = /** @class */ (function () {
@@ -18,6 +18,7 @@ var NeoTypeInfo = /** @class */ (function () {
         this.properties = [];
         // Property info dictionary for easy lookup.
         this.propertyMap = {};
+        this.methods = new Map();
         // Properties of type List<T>, or marked with the ChildList or ChildObject decorator.
         this.children = [];
         // Properties marked with the parent decorator, multiple if a class can be child of more than one type.
@@ -80,6 +81,9 @@ var NeoTypeInfo = /** @class */ (function () {
         pi.isReadOnly = descriptor.set === undefined;
         pi.descriptor = descriptor;
     };
+    NeoTypeInfo.prototype.addMethod = function (methodName) {
+        return this.methods.getOrAdd(methodName, function () { return new MethodInfo(methodName); });
+    };
     NeoTypeInfo.prototype.addAttributeRule = function (propertyName, rule) {
         this.getOrAddProperty(propertyName).addAttributeRule(rule);
     };
@@ -99,13 +103,22 @@ var NeoTypeInfo = /** @class */ (function () {
             }
             this.modelCreator.initialise(this, this.objectConstructor);
             if (instance && this.modelCreator.shouldInitialiseAllMembers) {
-                for (var _i = 0, _a = Object.getOwnPropertyNames(instance); _i < _a.length; _i++) {
+                var allProperties = __spreadArray([], this.properties, true);
+                var ownProperties = [];
+                for (var _i = 0, _a = Object.keys(instance); _i < _a.length; _i++) {
                     var propertyName = _a[_i];
-                    if (ignoredPropertyNames.indexOf(propertyName) < 0) {
+                    if (!(typeof instance[propertyName] === "function")) {
                         var pi = this.getOrAddProperty(propertyName);
                         pi.setupFromInstance(instance);
+                        // Properties with decorators will be added before own properties.
+                        // Mobx as of version 6 deletes properties, and re-adds them, 
+                        // causing future Object.keys evaulations to return the keys in the order they are passed to mobX.
+                        // This will preserve the order of the keys as they were defined in the object.
+                        allProperties.remove(pi);
+                        ownProperties.push(pi);
                     }
                 }
+                this.properties = __spreadArray(__spreadArray([], ownProperties, true), allProperties, true);
             }
             if (instance)
                 this.addRules(instance);
@@ -247,7 +260,13 @@ var NeoTypeInfo = /** @class */ (function () {
             else {
                 instance[hasConvertedSymbol] = true;
             }
-            return this.modelCreator.convertInstance(instance, options);
+            try {
+                return this.modelCreator.convertInstance(instance, options);
+            }
+            catch (e) {
+                console.error("Error converting model type " + instance.constructor.name);
+                throw e;
+            }
         }
         return instance;
     };

package/dist/Model/PropertyInfo.js

@@ -7,7 +7,6 @@ var PropertyInfo = /** @class */ (function () {
         this.attributeRules = [];
         /** Name to use on labels for this property */
         this.displayName = "";
-        // TODO: noTrack and Observable should be combined and use an enum?
         /** True if the property does not cause the object to become dirty. */
         this.noTrack = false;
         /**

package/dist/NumberUtils.d.ts

@@ -11,12 +11,16 @@ export declare enum NumberFormat {
 }
 export default class NumberUtils {
     static thousandsSeparator: string;
+    static decimalSeparator?: string;
+    /** Set this to `","` if you want to allow a comma as a decimal separator when parsing string input. */
+    static allowAsDecimalSeparator?: string;
     static defaultCurrencySymbol: string;
-    static numberFormats: {
-        [key in NumberFormat]: string;
-    };
+    static numberFormats: {};
     /** If values typed into numeric editors should be divided by 100 when stored. */
     static transformPercent: boolean;
+    static initialise(): void;
+    /** Uses the users local decimal separator when formatting and parsing numbers. */
+    static useLocaleDecimalSeparator(): void;
     /** Gets a format string for the pre-defined number format.
      * @param displayDecimals No of decimals to display if using a decimals format.
     */

package/dist/NumberUtils.js

@@ -1,10 +1,9 @@
-var _a;
 import Decimal from "decimal.js-light";
 import { DataType } from "./Model/Misc";
 import Globals from './Globals';
 export var NumberFormat;
 (function (NumberFormat) {
-    // Mask is [Thousands Seperator, Decimals (2 places), Percent, Currency Symbol]
+    // Mask is [Thousands Separator, Decimals (2 places), Percent, Currency Symbol]
     NumberFormat[NumberFormat["None"] = 0] = "None";
     NumberFormat[NumberFormat["NoDecimals"] = 4096] = "NoDecimals";
     NumberFormat[NumberFormat["Decimals"] = 4352] = "Decimals";
@@ -16,6 +15,22 @@ export var NumberFormat;
 var NumberUtils = /** @class */ (function () {
     function NumberUtils() {
     }
+    NumberUtils.initialise = function () {
+        NumberUtils.numberFormats[NumberFormat.None] = "#";
+        NumberUtils.numberFormats[NumberFormat.NoDecimals] = "#,##0;(#,##0)";
+        NumberUtils.numberFormats[NumberFormat.Decimals] = "#,##0.00;(#,##0.00)";
+        NumberUtils.numberFormats[NumberFormat.PercentNoDecimals] = "#,##0%;(#,##0)%";
+        NumberUtils.numberFormats[NumberFormat.PercentDecimals] = "#,##0.00%;(#,##0.00%)";
+        NumberUtils.numberFormats[NumberFormat.CurrencyNoDecimals] = "_#,##0;(_#,##0)";
+        NumberUtils.numberFormats[NumberFormat.CurrencyDecimals] = "_#,##0.00;(_#,##0.00)";
+    };
+    /** Uses the users local decimal separator when formatting and parsing numbers. */
+    NumberUtils.useLocaleDecimalSeparator = function () {
+        this.decimalSeparator = 1.1.toLocaleString().substring(1, 2);
+        if (this.decimalSeparator !== ".") {
+            this.allowAsDecimalSeparator = this.decimalSeparator;
+        }
+    };
     /** Gets a format string for the pre-defined number format.
      * @param displayDecimals No of decimals to display if using a decimals format.
     */
@@ -224,6 +239,9 @@ var NumberUtils = /** @class */ (function () {
             }
             numberStrings[0] = str;
         }
+        if (this.decimalSeparator) {
+            decimal = this.decimalSeparator;
+        }
         numberStrings[1] = (numberParts[1] && numberStrings[1]) ? decimal + numberStrings[1] : "";
         numberStrings[0] = numberStrings[0].replace(/,/g, NumberUtils.thousandsSeparator);
         return beforeText + numberStrings[0] + numberStrings[1] + afterText; //put back any negation and combine integer and fraction.
@@ -231,17 +249,10 @@ var NumberUtils = /** @class */ (function () {
     ;
     NumberUtils.thousandsSeparator = "\xA0"; // non breaking space.
     NumberUtils.defaultCurrencySymbol = "R";
-    NumberUtils.numberFormats = (_a = {},
-        _a[NumberFormat.None] = "#",
-        _a[NumberFormat.NoDecimals] = "#,##0;(#,##0)",
-        _a[NumberFormat.Decimals] = "#,##0.00;(#,##0.00)",
-        _a[NumberFormat.PercentNoDecimals] = "#,##0%;(#,##0)%",
-        _a[NumberFormat.PercentDecimals] = "#,##0.00%;(#,##0.00%)",
-        _a[NumberFormat.CurrencyNoDecimals] = "_#,##0;(_#,##0)",
-        _a[NumberFormat.CurrencyDecimals] = "_#,##0.00;(_#,##0.00)",
-        _a);
+    NumberUtils.numberFormats = {};
     /** If values typed into numeric editors should be divided by 100 when stored. */
     NumberUtils.transformPercent = true;
     return NumberUtils;
 }());
 export default NumberUtils;
+NumberUtils.initialise();

package/dist/Settings.d.ts

@@ -2,6 +2,8 @@ import { ValidationDisplayMode } from './Validation/Misc';
 import { IButtonOptions } from './Components/ButtonOptions';
 import { DataType } from './Model/Misc';
 export declare const Settings: {
+    /** Specify this if your app has a header that is fixed to the top of the screen. */
+    fixedAppHeaderElement: (() => HTMLElement | null) | null;
     /**
      * Time the css animation takes to show / hide a modal. Note: This must match the css animation time.
      */
@@ -38,6 +40,11 @@ export declare const Settings: {
         expandButton: IButtonOptions;
         boolTrueClass: string;
         boolFalseClass: string;
+        /**
+         * Will cause headers to stick to the top of the screen / scroll element when scrolling.
+         * This will apply to all NeoGrids, but can be overridden per grid.
+         */
+        useStickyHeaders: boolean;
     };
     modal: {
         acceptButton: IButtonOptions;

package/dist/Settings.js

@@ -1,6 +1,8 @@
 import { ValidationDisplayMode } from './Validation/Misc';
 import { DataType } from './Model/Misc';
 export var Settings = {
+    /** Specify this if your app has a header that is fixed to the top of the screen. */
+    fixedAppHeaderElement: null,
     /**
      * Time the css animation takes to show / hide a modal. Note: This must match the css animation time.
      */
@@ -60,7 +62,12 @@ export var Settings = {
             tabIndex: -1
         },
         boolTrueClass: "far fa-lg fa-check-square",
-        boolFalseClass: "far fa-lg fa-square text-light"
+        boolFalseClass: "far fa-lg fa-square text-light",
+        /**
+         * Will cause headers to stick to the top of the screen / scroll element when scrolling.
+         * This will apply to all NeoGrids, but can be overridden per grid.
+         */
+        useStickyHeaders: false,
     },
     modal: {
         acceptButton: {

package/dist/SignalR/HubBase.d.ts

@@ -2,6 +2,7 @@ import * as signalR from '@microsoft/signalr';
 import { IHubReceiver } from "./HubReceiver";
 import { AppServices } from '../';
 import { IConnection, ConnectionState } from '../ConnectionManager';
+import { IDisposable } from '../Misc';
 export interface IHubBase extends IConnection {
     /**
      * Connects to the server hub if the connection state is disconnected.
@@ -31,7 +32,7 @@ export interface IHubOptions {
     /** Log level in production. Defaults to Error. */
     releaseLogLevel: signalR.LogLevel;
 }
-export declare class HubBase implements IHubBase {
+export declare class HubBase implements IHubBase, IDisposable {
     private url;
     private authenticationService;
     private connection;
@@ -53,6 +54,8 @@ export declare class HubBase implements IHubBase {
     connect(): Promise<boolean>;
     connectIfAuthenticated(): Promise<boolean>;
     disconnect(): Promise<void>;
+    /** Disconnects the hub client from the hub. Subscriptions are not disposed. */
+    dispose(): void;
     /**
      * Invokes a method on the server hub, returning a promise.
      * The Promise is resolved with the return value (if any) when the method on the server returns.

package/dist/SignalR/HubBase.js

@@ -119,6 +119,10 @@ var HubBase = /** @class */ (function () {
     HubBase.prototype.disconnect = function () {
         return this.connection.stop();
     };
+    /** Disconnects the hub client from the hub. Subscriptions are not disposed. */
+    HubBase.prototype.dispose = function () {
+        this.disconnect();
+    };
     /**
      * Invokes a method on the server hub, returning a promise.
      * The Promise is resolved with the return value (if any) when the method on the server returns.

package/dist/Utils.js

@@ -1,5 +1,6 @@
 import { __spreadArray } from "tslib";
 import { DebounceHelper } from './DebounceHelper';
+import { ensureTypeInfo } from './Model/NeoTypeInfo';
 var lut = [];
 for (var i = 0; i < 256; i++) {
     lut[i] = (i < 16 ? '0' : '') + (i).toString(16);
@@ -76,7 +77,7 @@ var Utils = /** @class */ (function () {
             args[_i - 1] = arguments[_i];
         }
         if (type.prototype.constructor.neo) {
-            return type.prototype.constructor.neo.createInstance(args);
+            return ensureTypeInfo(type).neo.createInstance(args);
         }
         else {
             throw "Cannot instantiate '".concat(type.name, "' because it does not have an @NeoModel attribute.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singularsystems/neo-core",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-beta.1",
   "description": "Core functionality for the Neo client library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",