@singularsystems/neo-core 1.6.4 → 1.6.6

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Neo core changelog
 
+## Version 1.6.6 (5 October 2026)
+
+- Added `autoFocus` prop to form options.
+- Added `autoFocusForm` setting to global modal options to allow modals to focus first input by default.
+
+## Version 1.6.5 (28 September 2026)
+
+- Fixed position helper not correctly positioning fixed elements that are within a fixed container.
+- Added support for local timezone format for dates. Timezone type can be defaulted using `DateUtils.defaultTimeZoneFormat`.
+    - Can be used if datetime values in your database are not stored as UTC.
+
 ## Version 1.6.4 (15 September 2026)
 
 - Added support for `AbortSignal` in ConfigService and AuthenticationService. Equivalent to CancellationToken.

package/dist/Components/FormOptions.d.ts

@@ -34,4 +34,10 @@ export interface IFormOptions<T extends IModelBase> extends IFormContextOptions
      * Text to show in summary modal title. Setting this prop infers showSummaryModal. Defaults to: Invalid data
      */
     invalidSummaryTitle?: string;
+    /**
+     * Causes the form to automatically focus an element when it is rendered.
+     * If set to true, the first input will be focused.
+     * If set to a string, it should be a CSS selector for the element to focus.
+     */
+    autoFocus?: boolean | string;
 }

package/dist/Components/Modal/ModalHelper.js

@@ -164,8 +164,10 @@ var ModalHelper = /** @class */ (function () {
         if (this.modals.length == 1) {
             var modal = this.modals[this.modals.length - 1];
             if (e.target == this.modalsContainer || e.target == modal.container) {
-                if (modal.onDismiss)
+                if (modal.onDismiss) {
+                    e.preventDefault();
                     modal.onDismiss(e);
+                }
             }
         }
     };

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

@@ -29,6 +29,12 @@ export interface IModalOptionsBase {
     onClose?: (event: any) => void;
     /** Called after the modal animation completes. */
     afterClose?: () => void;
+    /**
+     * Causes the inner form to automatically focus an element when it is opened.
+     * If set to true, the first input will be focused.
+     * If set to a string, it should be a CSS selector for the element to focus.
+     */
+    autoFocusForm?: boolean | string;
 }
 export default interface IModalOptions extends IModalOptionsBase {
     /** Controls the visibility of the modal. */

package/dist/Components/Modal/ModalUtils.js

@@ -78,7 +78,7 @@ var ModalHelpers = /** @class */ (function () {
                 onClose: function () { return resolve(ModalResult.Cancel); },
                 acceptButton: { text: NeoStrings.modals.ok, onClick: function () { return resolve(ModalResult.Yes); } },
                 closeButton: __assign(__assign({}, Settings.modal.cancelButton), { text: NeoStrings.modals.cancel, onClick: function () { return resolve(ModalResult.Cancel); } }),
-                formProps: { model: model },
+                formProps: { model: model, autoFocus: true },
             });
         });
     };

package/dist/Components/PositionHelper.js

@@ -131,14 +131,18 @@ var FixedPositionHelper = /** @class */ (function () {
         }
     };
     FixedPositionHelper.prototype.positionFixedPopup = function () {
+        var _a, _b, _c;
         var rect = this.anchorElement.getBoundingClientRect();
-        this.popupElement.style.top = (Math.floor(rect.top) + this.topOffset) + "px";
+        var containingRect = (_a = this.popupElement.offsetParent) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+        var offsetLeft = (_b = containingRect === null || containingRect === void 0 ? void 0 : containingRect.left) !== null && _b !== void 0 ? _b : 0;
+        var offsetTop = (_c = containingRect === null || containingRect === void 0 ? void 0 : containingRect.top) !== null && _c !== void 0 ? _c : 0;
+        this.popupElement.style.top = (Math.floor(rect.top - offsetTop) + this.topOffset) + "px";
         this.popupElement.style.right = "auto";
         if (this.positionInfo.left !== undefined) {
-            this.popupElement.style.left = (rect.left + this.positionInfo.left) + "px";
+            this.popupElement.style.left = (rect.left - offsetLeft + this.positionInfo.left) + "px";
         }
         else {
-            this.popupElement.style.left = (rect.right - this.popupElement.offsetWidth) + "px";
+            this.popupElement.style.left = (rect.right - offsetLeft - this.popupElement.offsetWidth) + "px";
         }
     };
     FixedPositionHelper.prototype.dispose = function () {

package/dist/Data/Serialiser.js

@@ -70,6 +70,7 @@ var Serialiser = /** @class */ (function () {
         this.objectRefs = {};
     };
     Serialiser.prototype.serialiseObject = function (from, to, isDictionary) {
+        var _a;
         if (isDictionary === void 0) { isDictionary = false; }
         //check that this object hasnt already been serialised.
         var referenceId = from[referenceIdKey];
@@ -152,8 +153,14 @@ var Serialiser = /** @class */ (function () {
                                 if (fromValue !== null && propertyInfo.propertyType === DataType.Decimal) {
                                     to[key] = NumberUtils.decimalService.toNumber(fromValue);
                                 }
-                                else if (propertyInfo.timeZoneSerialisation === TimeZoneFormat.None && fromValue instanceof Date) {
-                                    to[key] = DateUtils.formatApi(fromValue, propertyInfo.timeZoneSerialisation);
+                                else if (fromValue instanceof Date) {
+                                    var timezoneFormat = (_a = propertyInfo.timeZoneSerialisation) !== null && _a !== void 0 ? _a : DateUtils.defaultTimeZoneFormat;
+                                    if (timezoneFormat === TimeZoneFormat.UTC) {
+                                        to[key] = fromValue;
+                                    }
+                                    else {
+                                        to[key] = DateUtils.formatApi(fromValue, timezoneFormat);
+                                    }
                                 }
                                 else {
                                     to[key] = fromValue;

package/dist/Dates/DateUtils.d.ts

@@ -4,6 +4,11 @@ import { ITimeValues, TimeSpan } from "./TimeSpan";
 export default class DateUtils {
     static defaultFormatString: string;
     static defaultFormatStringWithTime: string;
+    /**
+     * The default time zone format to use when serialising dates.
+     * Can be overridden using `@Attributes.Date`.
+     */
+    static defaultTimeZoneFormat: TimeZoneFormat;
     private static token;
     private static timezone;
     private static timezoneClip;
@@ -17,6 +22,10 @@ export default class DateUtils {
      * Formats a date using api standards.
      */
     static formatApi(date: Date, timezoneFormat: TimeZoneFormat): string;
+    /**
+     * Converts the date instance to a string, without adding a timezone offset or UTC indicator.
+     */
+    static formatLocal(date: Date): string;
     private static pad;
     /**
      * Tries to parse a date from a string using the supplied format string

package/dist/Dates/DateUtils.js

@@ -64,10 +64,25 @@ var DateUtils = /** @class */ (function () {
         if (timezoneFormat === TimeZoneFormat.UTC) {
             return date.toISOString();
         }
+        else if (timezoneFormat === TimeZoneFormat.Local) {
+            return this.formatLocal(date);
+        }
         else {
             return DateUtils.format(date, "yyyy-MM-dd");
         }
     };
+    /**
+     * Converts the date instance to a string, without adding a timezone offset or UTC indicator.
+     */
+    DateUtils.formatLocal = function (date) {
+        var dateString = DateUtils.format(date, "yyyy-MM-dd");
+        if (date.getMilliseconds() != 0) {
+            return dateString + "T" + DateUtils.format(date, "HH:mm:ss.l");
+        }
+        else {
+            return dateString + "T" + DateUtils.format(date, "HH:mm:ss");
+        }
+    };
     DateUtils.pad = function (val, len) {
         if (len === void 0) { len = 2; }
         val = String(val);
@@ -227,6 +242,11 @@ var DateUtils = /** @class */ (function () {
     };
     DateUtils.defaultFormatString = "dd MMM yyyy";
     DateUtils.defaultFormatStringWithTime = "dd MMM yyyy HH:mm";
+    /**
+     * The default time zone format to use when serialising dates.
+     * Can be overridden using `@Attributes.Date`.
+     */
+    DateUtils.defaultTimeZoneFormat = TimeZoneFormat.UTC;
     DateUtils.token = /d{1,4}|M{1,4}|yy(?:yy)?|([HhmsTt])\1?|[LloSZ]|"[^"]*"|'[^']*'/g;
     DateUtils.timezone = /\b(?:[PMCEA][SDP]T|(?:Pacific|Mountain|Central|Eastern|Atlantic) (?:Standard|Daylight|Prevailing) Time|(?:GMT|UTC)(?:[-+]\d{4})?)\b/g;
     DateUtils.timezoneClip = /[^-+\dA-Z]/g;

package/dist/DomUtils.d.ts

@@ -0,0 +1,11 @@
+export default class DomUtils {
+    /** CSS selector for input, select, and textarea elements that are not disabled. Excludes buttons. */
+    static Selector_InputNonDisabled: string;
+    /**
+     * Focuses the next focusable element within the specified parent or the document body if no parent is provided.
+     * @param currentElement The current element from which to start searching for the next focusable element. Will use the current active element if not provided.
+     * @param parentOrSelector The parent element or selector within which to search for the next focusable element. If not provided, the document body is used.
+     * @param filter The CSS selector to filter the focusable elements. Defaults to DomUtils.Selector_Focusable.
+     */
+    static focusNextElement(currentElement?: HTMLElement | null, parentOrSelector?: string | HTMLElement | null, filter?: string): void;
+}

package/dist/DomUtils.js

@@ -0,0 +1,30 @@
+var DomUtils = /** @class */ (function () {
+    function DomUtils() {
+    }
+    /**
+     * Focuses the next focusable element within the specified parent or the document body if no parent is provided.
+     * @param currentElement The current element from which to start searching for the next focusable element. Will use the current active element if not provided.
+     * @param parentOrSelector The parent element or selector within which to search for the next focusable element. If not provided, the document body is used.
+     * @param filter The CSS selector to filter the focusable elements. Defaults to DomUtils.Selector_Focusable.
+     */
+    DomUtils.focusNextElement = function (currentElement, parentOrSelector, filter) {
+        var parent = null;
+        if (parentOrSelector instanceof HTMLElement) {
+            parent = parentOrSelector;
+        }
+        else if (typeof parentOrSelector === "string") {
+            parent = document.querySelector(parentOrSelector);
+        }
+        parent !== null && parent !== void 0 ? parent : (parent = document.body);
+        currentElement !== null && currentElement !== void 0 ? currentElement : (currentElement = document.activeElement);
+        var focusableElements = parent.querySelectorAll(filter !== null && filter !== void 0 ? filter : DomUtils.Selector_InputNonDisabled);
+        var currentIndex = currentElement ? Array.from(focusableElements).indexOf(currentElement) : -1;
+        if (currentIndex < focusableElements.length - 1) {
+            focusableElements[currentIndex + 1].focus();
+        }
+    };
+    /** CSS selector for input, select, and textarea elements that are not disabled. Excludes buttons. */
+    DomUtils.Selector_InputNonDisabled = "input:not(:disabled), select:not(:disabled), textarea:not(:disabled)";
+    return DomUtils;
+}());
+export default DomUtils;

package/dist/Model/Decorators.js

@@ -1,5 +1,5 @@
 import { ensureTypeInfo } from './NeoTypeInfo';
-import { SerialiseType, RelationType, OnChangedOptions, DataType, TimeZoneFormat } from './Misc';
+import { SerialiseType, RelationType, OnChangedOptions, DataType } from './Misc';
 import { Utils } from "../Utils";
 function getOrAddPropertyInfo(type, propertyName) {
     return ensureTypeInfo(type.constructor).neo.getOrAddProperty(propertyName);
@@ -12,7 +12,6 @@ export function Display(name) {
 }
 /** Indicates that this is a date property. Json strings will be converted to date objects on deserialisation. */
 export function Date(timeZoneSerialisation) {
-    if (timeZoneSerialisation === void 0) { timeZoneSerialisation = TimeZoneFormat.UTC; }
     return function (type, propertyKey, descriptor) {
         var pi = getOrAddPropertyInfo(type, propertyKey);
         pi.propertyType = DataType.Date;

package/dist/Model/Misc.d.ts

@@ -15,10 +15,12 @@ export declare enum SerialiseType {
     Never = 4
 }
 export declare enum TimeZoneFormat {
+    /** Date will be serialised without time zone info. */
+    None = 0,
     /** Date will be serialised as UTC with Z */
     UTC = 1,
-    /** Date will be serialised without time zone info. */
-    None = 2
+    /** Date will be serialised as local time (no conversion from value supplied by user). */
+    Local = 2
 }
 export declare enum RelationType {
     None = 0,

package/dist/Model/Misc.js

@@ -16,10 +16,12 @@ export var SerialiseType;
 })(SerialiseType || (SerialiseType = {}));
 export var TimeZoneFormat;
 (function (TimeZoneFormat) {
+    /** Date will be serialised without time zone info. */
+    TimeZoneFormat[TimeZoneFormat["None"] = 0] = "None";
     /** Date will be serialised as UTC with Z */
     TimeZoneFormat[TimeZoneFormat["UTC"] = 1] = "UTC";
-    /** Date will be serialised without time zone info. */
-    TimeZoneFormat[TimeZoneFormat["None"] = 2] = "None";
+    /** Date will be serialised as local time (no conversion from value supplied by user). */
+    TimeZoneFormat[TimeZoneFormat["Local"] = 2] = "Local";
 })(TimeZoneFormat || (TimeZoneFormat = {}));
 export var RelationType;
 (function (RelationType) {

package/dist/Model/ObservableStack.d.ts

@@ -0,0 +1,18 @@
+/** A stack that keeps track of the current item and allows selection by key. */
+export declare class ObservableStack<T> {
+    constructor();
+    private items;
+    private _current?;
+    /**
+     * Adds an item to the stack.
+     * The `current` property will be updated to the newly added item.
+     * The item can be removed by calling the dispose method on the returned object. */
+    register(item: T, key?: string): {
+        /** Removes the item from the stack and updates the `current` property if this item is the current one. */
+        dispose: () => void;
+    };
+    /** Selects an item by its key. Will set `current` to undefined if not found. */
+    select(key?: string): void;
+    /** The current item. */
+    get current(): T | undefined;
+}

package/dist/Model/ObservableStack.js

@@ -0,0 +1,49 @@
+import { __decorate, __metadata } from "tslib";
+import { Attributes } from "..";
+import { NeoTypeInfo } from "./NeoTypeInfo";
+/** A stack that keeps track of the current item and allows selection by key. */
+var ObservableStack = /** @class */ (function () {
+    function ObservableStack() {
+        this.items = [];
+        this._current = undefined;
+        NeoTypeInfo.makeObservable(this);
+    }
+    /**
+     * Adds an item to the stack.
+     * The `current` property will be updated to the newly added item.
+     * The item can be removed by calling the dispose method on the returned object. */
+    ObservableStack.prototype.register = function (item, key) {
+        var _this = this;
+        var keyedItem = { key: key, item: item };
+        this.items.push(keyedItem);
+        this._current = keyedItem;
+        return {
+            /** Removes the item from the stack and updates the `current` property if this item is the current one. */
+            dispose: function () {
+                _this.items.remove(keyedItem);
+                if (_this._current === keyedItem) {
+                    _this._current = _this.items[_this.items.length - 1];
+                }
+            }
+        };
+    };
+    /** Selects an item by its key. Will set `current` to undefined if not found. */
+    ObservableStack.prototype.select = function (key) {
+        this._current = this.items.find(function (c) { return c.key === key; });
+    };
+    Object.defineProperty(ObservableStack.prototype, "current", {
+        /** The current item. */
+        get: function () {
+            var _a;
+            return (_a = this._current) === null || _a === void 0 ? void 0 : _a.item;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    __decorate([
+        Attributes.Observable(),
+        __metadata("design:type", Object)
+    ], ObservableStack.prototype, "_current", void 0);
+    return ObservableStack;
+}());
+export { ObservableStack };

package/dist/Model/PropertyInfo.d.ts

@@ -25,7 +25,7 @@ export default class PropertyInfo {
     observableType: Nullable<ObservableType>;
     /** See SerialiseType */
     serialise: SerialiseType;
-    timeZoneSerialisation: TimeZoneFormat;
+    timeZoneSerialisation?: TimeZoneFormat;
     /** Type of parent / child if this property is related to another model. 'type' property must be set if this is not 'none'. */
     relationType: RelationType;
     /** Data type of the property. */

package/dist/Model/index.d.ts

@@ -7,6 +7,7 @@ export { ObservableProperty } from './ObservableProperty';
 export { ISelectedItem } from './Misc';
 export { IEnumItem } from './EnumHelper';
 export { ModelFieldInfo, IModelFieldInfoContainer } from './ModelFieldInfo';
+export { ObservableStack } from './ObservableStack';
 import * as GraphTraverser from './ModelGraphTraverser';
 export { GraphTraverser, PropertyInfo };
 export { AuditValues, AuditValuesBase } from './BaseModels/AuditValues';

package/dist/Model/index.js

@@ -3,6 +3,7 @@ import PropertyInfo from './PropertyInfo';
 export { ObservableValue, ValueWrapper } from './ObservableValue';
 export { ObservableProperty } from './ObservableProperty';
 export { ModelFieldInfo } from './ModelFieldInfo';
+export { ObservableStack } from './ObservableStack';
 import * as GraphTraverser from './ModelGraphTraverser';
 export { GraphTraverser, PropertyInfo };
 // Base Models

package/dist/Security/Oidc/OidcAuthService.js

@@ -45,7 +45,7 @@ var OidcAuthService = /** @class */ (function () {
     });
     OidcAuthService.prototype.loadUserFromSession = function (options) {
         return __awaiter(this, void 0, void 0, function () {
-            var userData, userDataJson;
+            var userData, trySilentSignIn, useCachedData, userDataJson;
             var _a, _b;
             return __generator(this, function (_c) {
                 switch (_c.label) {
@@ -60,11 +60,13 @@ var OidcAuthService = /** @class */ (function () {
                         _c.sent();
                         return [2 /*return*/, this.user];
                     case 3:
+                        trySilentSignIn = (_a = options === null || options === void 0 ? void 0 : options.silentSignIn) !== null && _a !== void 0 ? _a : !!window.opener, useCachedData = NetworkUtils.useCachedData(this.config);
+                        if (!(useCachedData || trySilentSignIn)) return [3 /*break*/, 9];
                         userDataJson = localStorage.getItem(storageKey);
                         if (userDataJson) {
                             userData = JSON.parse(userDataJson);
                         }
-                        if (!NetworkUtils.useCachedData(this.config)) return [3 /*break*/, 6];
+                        if (!useCachedData) return [3 /*break*/, 6];
                         if (!userData) return [3 /*break*/, 5];
                         return [4 /*yield*/, this.setUserDataAsync(userData)];
                     case 4:
@@ -72,7 +74,7 @@ var OidcAuthService = /** @class */ (function () {
                         _c.label = 5;
                     case 5: return [2 /*return*/, this.user];
                     case 6:
-                        if (!((_a = options === null || options === void 0 ? void 0 : options.silentSignIn) !== null && _a !== void 0 ? _a : !!window.opener)) return [3 /*break*/, 9];
+                        if (!trySilentSignIn) return [3 /*break*/, 9];
                         return [4 /*yield*/, AbortHelper.race(this.signinSilent(), options === null || options === void 0 ? void 0 : options.abortSignal)];
                     case 7:
                         _c.sent();

package/dist/Settings.d.ts

@@ -86,6 +86,8 @@ export declare const Settings: {
         closeButton: IButtonOptions;
         /** Settings for cancel button shown in footer. */
         cancelButton: IButtonOptions;
+        /** Causes modals to focus the first element in the form when opened. Will not apply if the form is suppressed. */
+        autoFocusForm: boolean;
     };
     pager: {
         firstText: string;

package/dist/Settings.js

@@ -113,6 +113,8 @@ export var Settings = {
             variant: "light",
             isOutline: false,
         },
+        /** Causes modals to focus the first element in the form when opened. Will not apply if the form is suppressed. */
+        autoFocusForm: false,
     },
     pager: {
         firstText: "«",

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import AxiosUtils from "./AxiosUtils";
 import List from './Model/List';
 import NeoModel from './Model/NeoModel';
 import DateUtils from './Dates/DateUtils';
+import DomUtils from './DomUtils';
 import NumberUtils from './NumberUtils';
 import StringUtils from './StringUtils';
 import { ModalUtils } from './Components/Modal/ModalUtils';
@@ -32,7 +33,7 @@ import * as SignalR from './SignalR';
 import * as Validation from './Validation';
 import * as Views from './Views/IViewBase';
 declare const NotifyUtils: Components.INotificationHelper;
-export { AbortHelper, AxiosUtils, AppServices, Attributes, Components, Data, DateUtils, DebounceHelper, EnumHelper, FileUtils, JsonSchema, Localisation, List, MenuUtils, Misc, ModalUtils, Model, NeoModel, NeoStrings, Network, NotifyUtils, Numeric, NumberUtils, Routing, Rules, Security, SignalR, StringUtils, Validation, Views, };
+export { AbortHelper, AxiosUtils, AppServices, Attributes, Components, Data, DateUtils, DebounceHelper, DomUtils, EnumHelper, FileUtils, JsonSchema, Localisation, List, MenuUtils, Misc, ModalUtils, Model, NeoModel, NeoStrings, Network, NotifyUtils, Numeric, NumberUtils, Routing, Rules, Security, SignalR, StringUtils, Validation, Views, };
 export { runInTask, createProperty };
 export { default as ModelBase } from './Model/ModelBase';
 export { default as ValueObject } from './Model/ValueObject';

package/dist/index.js

@@ -6,6 +6,7 @@ import AxiosUtils from "./AxiosUtils";
 import List from './Model/List';
 import NeoModel from './Model/NeoModel';
 import DateUtils from './Dates/DateUtils';
+import DomUtils from './DomUtils';
 import NumberUtils from './NumberUtils';
 import StringUtils from './StringUtils';
 import { ModalUtils } from './Components/Modal/ModalUtils';
@@ -37,7 +38,7 @@ import * as Views from './Views/IViewBase';
 import { NotificationHelper } from './Components/Notifications/NotificationHelper';
 var NotifyUtils = new NotificationHelper();
 // Types
-export { AbortHelper, AxiosUtils, AppServices, Attributes, Components, Data, DateUtils, DebounceHelper, EnumHelper, FileUtils, JsonSchema, Localisation, List, MenuUtils, Misc, ModalUtils, Model, NeoModel, NeoStrings, Network, NotifyUtils, Numeric, NumberUtils, Routing, Rules, Security, SignalR, StringUtils, Validation, Views, };
+export { AbortHelper, AxiosUtils, AppServices, Attributes, Components, Data, DateUtils, DebounceHelper, DomUtils, EnumHelper, FileUtils, JsonSchema, Localisation, List, MenuUtils, Misc, ModalUtils, Model, NeoModel, NeoStrings, Network, NotifyUtils, Numeric, NumberUtils, Routing, Rules, Security, SignalR, StringUtils, Validation, Views, };
 // Functions
 export { runInTask, createProperty };
 export { default as ModelBase } from './Model/ModelBase';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singularsystems/neo-core",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "Core functionality for the Neo client library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,23 +16,23 @@
   "license": "ISC",
   "devDependencies": {
     "@types/jest": "30.0.0",
-    "@types/node": "25.3.0",
+    "@types/node": "26.6.4",
     "decimal.js-light": "2.5.1",
-    "jest": "30.2.0",
-    "jest-util": "30.2.0",
-    "ts-jest": "29.4.6",
+    "jest": "30.5.2",
+    "jest-util": "30.5.1",
+    "ts-jest": "29.4.14",
     "typescript": "5.9.3"
   },
   "dependencies": {
-    "@microsoft/signalr": "10.0.0",
-    "axios": "1.13.5",
+    "@microsoft/signalr": "10.0.11",
+    "axios": "1.20.0",
     "inversify": "6.0.2",
     "reflect-metadata": "0.2.2",
     "tslib": "2.8.1"
   },
   "peerDependencies": {
-    "axios": ">=1.4.0",
-    "inversify": ">=5.0.1"
+    "axios": ">=1.20.0",
+    "inversify": ">=6.0.2"
   },
   "packageManager": "yarn@4.9.2"
 }