@singularsystems/neo-core 1.0.0-beta.0 → 1.0.0-beta.1

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

@@ -24,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;
@@ -64,7 +65,7 @@ export default class DatePicker {
     private previousClick;
     private nextClick;
     private moveCurrent;
-    private autoSetDate;
+    private autoSetDay;
     private createAndAppend;
     destroy(): void;
 }

package/dist/Components/DatePicker/DatePicker.js

@@ -23,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);
@@ -34,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();
@@ -109,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);
@@ -132,9 +138,13 @@ 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) {
         if (dateValue) {
@@ -147,7 +157,7 @@ var DatePicker = /** @class */ (function () {
         }
     };
     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);
@@ -187,8 +197,8 @@ var DatePicker = /** @class */ (function () {
             if (this.options.alwaysShow) {
                 this.createComponents();
             }
+            this.setInputValue();
         }
-        this.setInputValue();
     };
     DatePicker.prototype.resetCurrentViewDate = function () {
         this.setCurrentViewDate(this.bindProperty.value);
@@ -302,15 +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.setCurrentViewDate(currentDate)
-            //this.setBindProperty(currentDate, true);
-        }
         this.nextButton.disabled = this.options.maxDateNoTime.getTime() <= lastDayOfMonth.getTime();
-        if (this.canAutoSetDate && this.options.autoChangeDate == "end") {
-            //this.setCurrentViewDate(lastDayOfMonth)
-            //this.setBindProperty(lastDayOfMonth, true);
-        }
         // Start with the first Sunday before the first of the month.
         currentDate.setDate(currentDate.getDate() - currentDate.getDay());
         var first = true;
@@ -463,7 +465,7 @@ var DatePicker = /** @class */ (function () {
         if (this.currentViewType == ViewType.Days) {
             this.canAutoSetDate = true;
             this.currentViewDate.setMonth(this.currentViewDate.getMonth() + delta, 1);
-            this.autoSetDate(delta);
+            this.autoSetDay();
         }
         else {
             this.currentViewDate.setFullYear(this.currentViewDate.getFullYear() + delta * (this.currentViewType == ViewType.Months ? 1 : YearsInYearView));
@@ -471,7 +473,7 @@ var DatePicker = /** @class */ (function () {
         this.populateContentContainer(false, true);
         this.contentAnimationHelper.slide(delta, true);
     };
-    DatePicker.prototype.autoSetDate = function (delta) {
+    DatePicker.prototype.autoSetDay = function () {
         var autoDate = null;
         if (this.options.autoChangeDate === "end") {
             // Forward
@@ -482,8 +484,7 @@ var DatePicker = /** @class */ (function () {
             autoDate = this.currentViewDate;
         }
         if (autoDate) {
-            this.setBindProperty(autoDate, true);
-            this.setCurrentViewDate(this.bindProperty.value);
+            this.setBindValue(autoDate, { preserveTime: true, close: false });
         }
     };
     DatePicker.prototype.createAndAppend = function (parent, elementType, className) {

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/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/Decorators.js

@@ -184,6 +184,6 @@ export function Action(isAction) {
 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

@@ -56,7 +56,7 @@ export interface IMakeBindableOptions {
     makeObservable?: boolean;
     /**
      * Specifies whether methods should be converted to mobx actions. This is `true` by default.
-     * Use `Attributes.Action()` to override this per methis. */
+     * 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/ModelBase.js

@@ -1,8 +1,7 @@
 import { __decorate, __extends, __metadata } from "tslib";
 import * as ModelTraverser from './ModelGraphTraverser';
-import { Action, Computed, NoTracking, Observable } from './Decorators';
+import { Computed, NoTracking, Observable } from './Decorators';
 import { JSFormatter } from '../Data/Serialiser';
-import { ValidationRules } from '../Validation/ValidationRules';
 import { BindableBase } from './BindableBase';
 import { Misc } from '../';
 import { SerialiseType } from './Misc';
@@ -178,12 +177,6 @@ var ModelBase = /** @class */ (function (_super) {
         __metadata("design:type", Object),
         __metadata("design:paramtypes", [])
     ], ModelBase.prototype, "readyToSave", null);
-    __decorate([
-        Action(false),
-        __metadata("design:type", Function),
-        __metadata("design:paramtypes", [ValidationRules]),
-        __metadata("design:returntype", void 0)
-    ], ModelBase.prototype, "addBusinessRules", null);
     return ModelBase;
 }(BindableBase));
 export default ModelBase;

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-beta.0",
+  "version": "1.0.0-beta.1",
   "description": "Core functionality for the Neo client library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",