@magic-xpa/engine 4.1300.0-dev4130.183 → 4.1300.0-dev4130.185

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@magic-xpa/engine",
-  "version": "4.1300.0-dev4130.183",
+  "version": "4.1300.0-dev4130.185",
   "description": "magic engine package",
   "license": "SEE LICENSE IN EULA.pdf",
   "dependencies": {
-    "@magic-xpa/mscorelib": "4.1300.0-dev4130.183",
-    "@magic-xpa/utils": "4.1300.0-dev4130.183",
-    "@magic-xpa/gui": "4.1300.0-dev4130.183",
+    "@magic-xpa/mscorelib": "4.1300.0-dev4130.185",
+    "@magic-xpa/utils": "4.1300.0-dev4130.185",
+    "@magic-xpa/gui": "4.1300.0-dev4130.185",
     "@angular/common": "^21.1.4",
     "socket.io": "^4.8.3",
     "socket.io-client": "^4.8.3",

package/types/magic-xpa-engine.d.ts

@@ -3945,6 +3945,70 @@ declare class ExpressionEvaluator extends GuiExpressionEvaluator {
     private eval_op_time_brk;
     private eval_op_addDateTime;
     private eval_op_difdt;
+    /**
+     * Safely extracts date/time parts from a JS Date using Intl.DateTimeFormat.
+     *
+     * WHY: Native JS Date has known pitfalls — century year bug (year < 100 mapped to 1900+year),
+     * silent leap year rollovers, DST gaps, and 0-based months. Intl.DateTimeFormat avoids all
+     * of these by using the browser's IANA timezone database internally.
+     *
+     * Used by both eval_op_localToUTC and eval_op_utcToLocal as a single safe extraction point.
+     *
+     * @param date     - A valid JS Date object
+     * @param timeZone - IANA timezone string (e.g. 'Asia/Kolkata', 'UTC').
+     *                   Defaults to browser's local timezone — correct for any user, any country.
+     * @returns Parsed parts (month is 1-based) or null if date is invalid
+     */
+    private convertDateTimeParts;
+    /**
+     * Validates that a time value (in total seconds) is within a valid day range
+     */
+    private isValidTimeSec;
+    /**
+     * Splits total seconds since midnight into hours, minutes, seconds.
+     * e.g. 3661 → { hours: 1, minutes: 1, seconds: 1 }
+     */
+    private splitTimeSec;
+    /**
+     * Writes a time (seconds) and date (Magic numeric) into their respective output fields.
+     */
+    private writeDateTimeToFields;
+    /**
+     * Converts local date/time to UTC and writes the result into output fields.
+     *
+     * Edge cases handled:
+     *  - Century years  — setFullYear() avoids JS year < 100 bug
+     *  - Leap years     — round-trip validation catches silent date rollovers
+     *  - DST gaps       — Intl.DateTimeFormat resolves correctly per IANA tz rules
+     *  - DST ambiguity  — Intl uses first occurrence consistently
+     *  - Cross-midnight — JS Date handles automatically
+     *  - Out-of-range   — time < 0 or > 86399 explicitly rejected
+     *
+     * @param resVal       - Output: Boolean result (true = success)
+     * @param localTimeVal - Input: Local time as total seconds since midnight (Magic numeric)
+     * @param localDateVal - Input: Local date as Magic numeric
+     * @param utcTimeVar   - Input: Field index for the UTC time output field
+     * @param utcDateVar   - Input: Field index for the UTC date output field
+     */
+    private eval_op_localToUTC;
+    /**
+     * Converts UTC date/time to local and writes the result into output fields.
+     *
+     * Edge cases handled:
+     *  - Century years  — Date.UTC() does not have the year < 100 bug
+     *  - Leap years     — round-trip validation catches silent date rollovers
+     *  - DST gaps       — Intl.DateTimeFormat resolves to correct local time automatically
+     *  - DST ambiguity  — Intl uses first occurrence consistently
+     *  - Cross-midnight — JS Date handles automatically
+     *  - Out-of-range   — time < 0 or > 86399 explicitly rejected
+     *
+     * @param resVal       - Output: Boolean result (true = success)
+     * @param utcTimeVal   - Input: UTC time as total seconds since midnight (Magic numeric)
+     * @param utcDateVal   - Input: UTC date as Magic numeric
+     * @param localTimeVar - Input: Field index for the local time output field
+     * @param localDateVar - Input: Field index for the local date output field
+     */
+    private eval_op_utcToLocal;
     private eval_op_ndow;
     private eval_op_nmonth;
     mul_add(num: NUM_TYPE, mul: number, add: number): NUM_TYPE;