@fable-org/fable-library-js 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+---
+last_commit_released: 63bcd3d90f37cb3934edcc59b5f54f49ffab3896
+updaters:
+  - package.json:
+      file: package.json
+  - regex:
+      file: ./../Fable.Transforms/Global/Compiler.fs
+      pattern: (?<=let JS_LIBRARY_VERSION = ").*(?=")
+---
+
 # Changelog
 
 All notable changes to this project will be documented in this file.
@@ -5,7 +15,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
+## 2.1.0 - 2026-05-28
+
+### 🚀 Features
+
+* *(js/ts/python)* Add missing standard DateTime format specifiers for JS/TS and Python (#4547) ([90f5eb7](https://github.com/fable-compiler/Fable/commit/90f5eb7f61710bc679f6fdec30ff5d864984ac08))
+* *(js/ts/python)* Add missing StringBuilder.Append overloads for numeric types (#4568) ([b402c30](https://github.com/fable-compiler/Fable/commit/b402c30d04bfca8644314ba4b21894abfff6a713))
+
+### 🐞 Bug Fixes
+
+* [JS/TS] Fix DatetimeOffset.ToString("s") (#4596) ([3ce6f3f](https://github.com/fable-compiler/Fable/commit/3ce6f3fd88cc7f67e34e2bbc311e722c55ffbf45))
+* *(js/ts)* Fix datetime custom format off by one year (#4558) ([83bdbb5](https://github.com/fable-compiler/Fable/commit/83bdbb5b34e70eae203831a3a442d477d15911e1))
+* *(js/ts)* Hex format specifier uses no padding unless precision is specified (#4603) ([ba9857a](https://github.com/fable-compiler/Fable/commit/ba9857a4dcbf7ab1f936241f6619fda43e039040))
+* *(js/ts)* Fix Decimal.GetBits returning incorrect mantissa after round arithmetic result (#4561) ([345bcd4](https://github.com/fable-compiler/Fable/commit/345bcd4b99417b304c71059966126fad74cf3a97))
+* *(js/ts)* Fix G/g format specifier corrupting exponential notation when trimming trailing zeros (#4587) ([773c098](https://github.com/fable-compiler/Fable/commit/773c098a8f7ac7e8db1d4e490dec1294a80321ee))
+* *(js/ts/python)* Fix FSharpOption not recognized as union type in F# reflection (#4529) ([d78a37d](https://github.com/fable-compiler/Fable/commit/d78a37db9f4c25eb51fac8afcd320b4ea36c60a7))
+* *(ts)* Enforce browser-only compatibility in fable-library-ts tsconfig (#4563) ([10c81c1](https://github.com/fable-compiler/Fable/commit/10c81c1361208eb61f5fa78c6704e6fccc068fb1))
+
+<strong><small>[View changes on Github](https://github.com/fable-compiler/Fable/compare/b471dc16fc3b5132af77b5974d1669c9b8220cca..63bcd3d90f37cb3934edcc59b5f54f49ffab3896)</small></strong>
 
 ## 2.0.0 - 2026-04-21
 

package/Date.js

@@ -254,13 +254,13 @@ function dateToStringWithCustomFormat(date, format, utc) {
                 cursorPos += tokenLength;
                 switch (tokenLength) {
                     case 1:
-                        result += localizedDate.getFullYear() % 100;
+                        result += year(localizedDate) % 100;
                         break;
                     case 2:
-                        result += padWithZeros(localizedDate.getFullYear() % 100, 2);
+                        result += padWithZeros(year(localizedDate) % 100, 2);
                         break;
                     default:
-                        result += padWithZeros(localizedDate.getFullYear(), tokenLength);
+                        result += padWithZeros(year(localizedDate), tokenLength);
                         break;
                 }
                 break;
@@ -384,10 +384,32 @@ function dateToStringWithOffset(date, format) {
         switch (format) {
             case "D": return dateToString_D(d);
             case "d": return dateToString_d(d);
-            case "T": return dateToString_T(toUniversalTime(d));
-            case "t": return dateToString_t(toUniversalTime(d));
+            case "F": return dateToString_D(d) + " " + dateToString_T(d);
+            case "f": return dateToString_D(d) + " " + dateToString_t(d);
+            case "G": return dateToString_d(d) + " " + dateToString_T(d);
+            case "g": return dateToString_d(d) + " " + dateToString_t(d);
+            case "M":
+            case "m": return dateToString_M(d);
             case "O":
             case "o": return dateToISOStringWithOffset(d, (date.offset ?? 0));
+            case "R":
+            case "r": {
+                const utcDate = DateTime(date.getTime(), DateTimeKind.Utc);
+                return dateToString_R(utcDate);
+            }
+            case "s": return dateToString_s(toUniversalTime(d));
+            case "T": return dateToString_T(toUniversalTime(d));
+            case "t": return dateToString_t(toUniversalTime(d));
+            case "u": {
+                const utcDate = DateTime(date.getTime(), DateTimeKind.Utc);
+                return dateToString_u(utcDate);
+            }
+            case "U": {
+                const utcDate = DateTime(date.getTime(), DateTimeKind.Utc);
+                return dateToString_D(utcDate) + " " + dateToString_T(utcDate);
+            }
+            case "Y":
+            case "y": return dateToString_Y(d);
             default: throw new Exception("Unrecognized Date print format");
         }
     }
@@ -415,6 +437,44 @@ function dateToString_t(date) {
     return padWithZeros(hour(date), 2)
         + ":" + padWithZeros(minute(date), 2);
 }
+// RFC 1123: "Thu, 01 Jan 2009 00:00:00 GMT" — always UTC
+function dateToString_R(date) {
+    const utcDate = toUniversalTime(date);
+    return shortDays[dayOfWeek(utcDate)] + ", "
+        + padWithZeros(day(utcDate), 2) + " "
+        + shortMonths[month(utcDate) - 1] + " "
+        + year(utcDate) + " "
+        + padWithZeros(hour(utcDate), 2) + ":"
+        + padWithZeros(minute(utcDate), 2) + ":"
+        + padWithZeros(second(utcDate), 2) + " GMT";
+}
+// Sortable ISO 8601, no timezone: "2009-06-15T13:45:30"
+function dateToString_s(date) {
+    return padWithZeros(year(date), 4) + "-"
+        + padWithZeros(month(date), 2) + "-"
+        + padWithZeros(day(date), 2) + "T"
+        + padWithZeros(hour(date), 2) + ":"
+        + padWithZeros(minute(date), 2) + ":"
+        + padWithZeros(second(date), 2);
+}
+// Universal sortable: "2009-06-15 13:45:30Z" — always UTC
+function dateToString_u(date) {
+    const utcDate = toUniversalTime(date);
+    return padWithZeros(year(utcDate), 4) + "-"
+        + padWithZeros(month(utcDate), 2) + "-"
+        + padWithZeros(day(utcDate), 2) + " "
+        + padWithZeros(hour(utcDate), 2) + ":"
+        + padWithZeros(minute(utcDate), 2) + ":"
+        + padWithZeros(second(utcDate), 2) + "Z";
+}
+// Month/day (InvariantCulture "MMMM dd"): "June 15"
+function dateToString_M(date) {
+    return longMonths[month(date) - 1] + " " + padWithZeros(day(date), 2);
+}
+// Year/month (InvariantCulture "yyyy MMMM"): "2009 June"
+function dateToString_Y(date) {
+    return year(date) + " " + longMonths[month(date) - 1];
+}
 function dateToStringWithKind(date, format) {
     const utc = date.kind === DateTimeKind.Utc;
     if (typeof format !== "string") {
@@ -424,11 +484,23 @@ function dateToStringWithKind(date, format) {
         switch (format) {
             case "D": return dateToString_D(date);
             case "d": return dateToString_d(date);
+            case "F": return dateToString_D(date) + " " + dateToString_T(date);
+            case "f": return dateToString_D(date) + " " + dateToString_t(date);
+            case "G": return dateToString_d(date) + " " + dateToString_T(date);
+            case "g": return dateToString_d(date) + " " + dateToString_t(date);
+            case "M":
+            case "m": return dateToString_M(date);
+            case "O":
+            case "o": return dateToISOString(date, utc);
+            case "R":
+            case "r": return dateToString_R(date);
+            case "s": return dateToString_s(date);
             case "T": return dateToString_T(date);
             case "t": return dateToString_t(date);
-            case "O":
-            case "o":
-                return dateToISOString(date, utc);
+            case "u": return dateToString_u(date);
+            case "U": return dateToString_D(toUniversalTime(date)) + " " + dateToString_T(toUniversalTime(date));
+            case "Y":
+            case "y": return dateToString_Y(date);
             default:
                 throw new Exception("Unrecognized Date print format");
         }

package/Decimal.js

@@ -207,14 +207,16 @@ export function fromParts(low, mid, high, isNegative, scale) {
 }
 export function getBits(d) {
     const bitSize = 96;
-    const decDigits = Uint8Array.from(d.c);
+    const decStr = d.toString();
+    const absStr = decStr[0] === "-" ? decStr.slice(1) : decStr;
+    const dotPos = absStr.indexOf(".");
+    const scale = dotPos < 0 ? 0 : absStr.length - dotPos - 1;
+    const mantissaStr = absStr.replace(".", "");
+    const decDigits = Uint8Array.from(mantissaStr, ch => ch.charCodeAt(0) - 48);
     const hexDigits = decimalToHex(decDigits, bitSize);
     const low = getInt32Bits(hexDigits, 0);
     const mid = getInt32Bits(hexDigits, 8);
     const high = getInt32Bits(hexDigits, 16);
-    const decStr = d.toString();
-    const dotPos = decStr.indexOf(".");
-    const scale = dotPos < 0 ? 0 : decStr.length - dotPos - 1;
     const signExp = ((scale & 0x7F) << 16) | (d.s < 0 ? 0x80000000 : 0);
     return [low, mid, high, signExp];
 }

package/Reflection.js

@@ -1,6 +1,7 @@
 import { Record, Union } from "./Types.js";
 import { Exception, combineHashCodes, equalArraysWith, stringHash } from "./Util.js";
 import Decimal from "./Decimal.js";
+import { Some, some } from "./Option.js";
 export class CaseInfo {
     constructor(declaringType, tag, name, fields) {
         this.declaringType = declaringType;
@@ -85,7 +86,11 @@ export function lambda_type(argType, returnType) {
     return new TypeInfo("Microsoft.FSharp.Core.FSharpFunc`2", [argType, returnType]);
 }
 export function option_type(generic) {
-    return new TypeInfo("Microsoft.FSharp.Core.FSharpOption`1", [generic]);
+    const t = new TypeInfo("Microsoft.FSharp.Core.FSharpOption`1", [generic], undefined, undefined, undefined, () => [
+        new CaseInfo(t, 0, "None"),
+        new CaseInfo(t, 1, "Some", [["value", generic]])
+    ]);
+    return t;
 }
 export function list_type(generic) {
     return new TypeInfo("Microsoft.FSharp.Collections.FSharpList`1", [generic]);
@@ -351,6 +356,16 @@ export function isFunction(t) {
 // FSharpValue
 export function getUnionFields(v, t) {
     const cases = getUnionCases(t);
+    // Special handling for option types (None is undefined, Some is the value or a Some wrapper)
+    if (t.fullname === "Microsoft.FSharp.Core.FSharpOption`1") {
+        if (v == null) {
+            return [cases[0], []]; // None case
+        }
+        else {
+            const innerValue = v instanceof Some ? v.value : v;
+            return [cases[1], [innerValue]]; // Some case
+        }
+    }
     const case_ = cases[v.tag];
     if (case_ == null) {
         throw new Exception(`Cannot find case ${v.name} in union type`);
@@ -380,6 +395,10 @@ export function makeUnion(uci, values) {
     if (values.length !== expectedLength) {
         throw new Exception(`Expected an array of length ${expectedLength} but got ${values.length}`);
     }
+    // Special handling for option types
+    if (uci.declaringType.fullname === "Microsoft.FSharp.Core.FSharpOption`1") {
+        return uci.tag === 0 ? undefined : some(values[0]);
+    }
     const construct = uci.declaringType.construct;
     if (construct == null) {
         return {};

package/String.js

@@ -382,11 +382,24 @@ export function format(str, ...args) {
                     }
                     break;
                 case "g":
-                case "G":
+                case "G": {
                     rep = precision != null ? toPrecision(rep, precision) : toPrecision(rep);
-                    // TODO: Check why some numbers are formatted with decimal part
-                    rep = trimEnd(trimEnd(rep, "0"), ".");
+                    // Handle exponential notation: only trim trailing zeros from mantissa, not from exponent.
+                    // .NET G format guarantees an exponent of at least 2 digits with an explicit sign (e.g. "E-07").
+                    const eIdx = rep.indexOf("e");
+                    if (eIdx >= 0) {
+                        const mantissa = trimEnd(trimEnd(rep.slice(0, eIdx), "0"), ".");
+                        const expSign = rep[eIdx + 1]; // toPrecision always emits "+" or "-"
+                        const expDigits = rep.slice(eIdx + 2);
+                        const paddedExpDigits = expDigits.length < 2 ? "0" + expDigits : expDigits;
+                        const eChar = format === "G" ? "E" : "e";
+                        rep = mantissa + eChar + expSign + paddedExpDigits;
+                    }
+                    else {
+                        rep = trimEnd(trimEnd(rep, "0"), ".");
+                    }
                     break;
+                }
                 case "n":
                 case "N":
                     precision = precision != null ? precision : 2;
@@ -419,7 +432,7 @@ export function format(str, ...args) {
                     if (!isIntegral(rep)) {
                         throw new Exception("Format specifier was invalid.");
                     }
-                    precision = precision != null ? precision : 2;
+                    precision = precision != null ? precision : 1;
                     rep = padLeft(toHex(rep), precision, "0");
                     if (format === "X") {
                         rep = rep.toUpperCase();

package/System.Text.js

@@ -1,7 +1,7 @@
 import { replace, format, replicate, substring, isNullOrEmpty, join } from "./String.js";
 import { class_type } from "./Reflection.js";
 import { toString } from "./Types.js";
-import { Exception, clear, int32ToString } from "./Util.js";
+import { Exception, clear, int64ToString, int32ToString, int16ToString } from "./Util.js";
 import { setItem, item } from "./Array.js";
 export class StringBuilder {
     constructor(value, capacity) {
@@ -47,10 +47,42 @@ export function StringBuilder__Append_61B1CA(x, c, repeatCount) {
     void (x.buf.push(s));
     return x;
 }
+export function StringBuilder__Append_Z510FF069(x, o) {
+    void (x.buf.push(o.toString()));
+    return x;
+}
+export function StringBuilder__Append_244D3E44(x, o) {
+    void (x.buf.push(o.toString()));
+    return x;
+}
+export function StringBuilder__Append_Z524259E6(x, o) {
+    void (x.buf.push(int16ToString(o)));
+    return x;
+}
+export function StringBuilder__Append_Z6EF82811(x, o) {
+    void (x.buf.push(o.toString()));
+    return x;
+}
 export function StringBuilder__Append_Z524259A4(x, o) {
     void (x.buf.push(int32ToString(o)));
     return x;
 }
+export function StringBuilder__Append_Z6EF827D7(x, o) {
+    void (x.buf.push(o.toString()));
+    return x;
+}
+export function StringBuilder__Append_Z524259C1(x, o) {
+    void (x.buf.push(int64ToString(o)));
+    return x;
+}
+export function StringBuilder__Append_Z6EF827B6(x, o) {
+    void (x.buf.push(o.toString()));
+    return x;
+}
+export function StringBuilder__Append_Z7138B98C(x, o) {
+    void (x.buf.push(o.toString()));
+    return x;
+}
 export function StringBuilder__Append_5E38073B(x, o) {
     void (x.buf.push(o.toString()));
     return x;

package/package.json

@@ -3,7 +3,7 @@
     "private": false,
     "type": "module",
     "name": "@fable-org/fable-library-js",
-    "version": "2.0.0",
+    "version": "2.1.0",
     "description": "Core library used by F# projects compiled with fable.io",
     "author": "Fable Contributors",
     "license": "MIT",