@fable-org/fable-library-js 2.11.0 → 2.12.0

package/CHANGELOG.md

@@ -1,5 +1,5 @@
 ---
-last_commit_released: ce886964cb4521dc4c01c8da089b97c9d9742814
+last_commit_released: cac5ddd9a99205e0bb5272f1ffd8f0cca937824c
 updaters:
   - package.json:
       file: package.json
@@ -15,6 +15,15 @@ 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).
 
+## 2.12.0 - 2026-10-29
+
+### 🚀 Features
+
+* *(js/ts)* Support the "R" numeric format and choose "G" notation like .NET (#5212) ([24d9c41a](https://github.com/fable-compiler/Fable/commit/24d9c41ad69993f0c4e843558133bcd787a960d4))
+* *(js/ts/python/dart/beam)* Support ArgumentException.ParamName (#5203) ([8ed77788](https://github.com/fable-compiler/Fable/commit/8ed7778893bab48c7dd41d7322d26d2bcaba6d99))
+
+<strong><small>[View changes on Github](https://github.com/fable-compiler/Fable/compare/ce886964cb4521dc4c01c8da089b97c9d9742814..cac5ddd9a99205e0bb5272f1ffd8f0cca937824c)</small></strong>
+
 ## 2.11.0 - 2026-10-29
 
 ### 🚀 Features

package/String.js

@@ -344,6 +344,53 @@ function splitIntAndDecimalPart(value) {
 function thousandSeparate(value) {
     return value.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
 }
+function splitExponential(s) {
+    const eIdx = s.indexOf("e");
+    return [s.slice(0, eIdx).replace(".", ""), Number(s.slice(eIdx + 1))];
+}
+function shortestSingle(x) {
+    // 100 digits tell where a float32 lies between two candidates, and 9 digits always round-trip
+    const [digits, exponent] = splitExponential(x.toExponential(99));
+    for (let p = 1;; p++) {
+        const down = Number(digits.slice(0, p));
+        const rest = digits.slice(p);
+        const half = "5".padEnd(rest.length, "0");
+        const roundUp = rest > half || rest === half && down % 2 === 1;
+        for (const n of roundUp ? [down + 1, down] : [down, down + 1]) {
+            if (Math.fround(Number(n + "e" + (exponent - p + 1))) === x) {
+                return [String(n), exponent + String(n).length - p];
+            }
+        }
+    }
+}
+// .NET "G" and "R": fixed notation unless the exponent is below -4 or reaches the precision (17 for the shortest digits, 9 for a float32)
+function formatGeneral(x, format, precision, isSingle = false) {
+    if (!Number.isFinite(x)) {
+        return String(x);
+    }
+    const sign = x < 0 || Object.is(x, -0) ? "-" : "";
+    x = Math.abs(x);
+    // R ignores the precision and G0 is G
+    const p = format === "r" || format === "R" ? 0 : precision ?? 0;
+    const [significand, exponent] = p > 0 ? splitExponential(x.toExponential(p - 1)) : isSingle ? shortestSingle(x) : splitExponential(x.toExponential());
+    const digits = trimEnd(significand, "0") || "0";
+    if (exponent < -4 || exponent >= (p > 0 ? p : isSingle ? 9 : 17)) {
+        const mantissa = digits.length > 1 ? digits[0] + "." + digits.slice(1) : digits;
+        const eChar = format === "G" || format === "R" ? "E" : "e";
+        return sign + mantissa + eChar + (exponent < 0 ? "-" : "+") + padLeft(String(Math.abs(exponent)), 2, "0");
+    }
+    else if (exponent < 0) {
+        return sign + "0." + "0".repeat(-exponent - 1) + digits;
+    }
+    else {
+        const decimals = digits.slice(exponent + 1);
+        return sign + digits.slice(0, exponent + 1).padEnd(exponent + 1, "0") + (decimals ? "." + decimals : "");
+    }
+}
+export function formatSingle(str, x) {
+    const m = /^\{0:([GgRr])(\d{0,2})\}$/.exec(str);
+    return m != null ? formatGeneral(Math.fround(x), m[1], m[2] ? parseInt(m[2], 10) : null, true) : format(str, x);
+}
 export function format(str, ...args) {
     let str2;
     if (typeof str === "object") {
@@ -423,12 +470,18 @@ export function format(str, ...args) {
                     }
                     break;
                 case "g":
-                case "G": {
-                    if (precision == null && typeof rep !== "number" && typeof rep !== "bigint") {
+                case "G":
+                case "r":
+                case "R": {
+                    if (typeof rep === "number") {
+                        rep = formatGeneral(rep, format, precision);
+                        break;
+                    }
+                    if (precision == null) {
                         rep = String(rep);
                         break;
                     }
-                    rep = precision != null ? toPrecision(rep, precision) : toPrecision(rep);
+                    rep = toPrecision(rep, precision);
                     // 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");
@@ -437,7 +490,7 @@ export function format(str, ...args) {
                         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";
+                        const eChar = format === "G" || format === "R" ? "E" : "e";
                         rep = mantissa + eChar + expSign + paddedExpDigits;
                     }
                     else if (rep.indexOf(".") >= 0) {
@@ -469,9 +522,6 @@ export function format(str, ...args) {
                         rep = thousandSeparate(parts.integral) + " %";
                     }
                     break;
-                case "r":
-                case "R":
-                    throw new Exception("The round-trip format is not supported by Fable");
                 case "x":
                 case "X":
                     if (!isIntegral(rep)) {

package/System.js

@@ -239,16 +239,16 @@ export function ArgumentException_$ctor_Z60A2B367(message, paramName, innerExcep
     return new ArgumentException(message, paramName, innerException);
 }
 export function ArgumentException_$ctor() {
-    return ArgumentException_$ctor_Z60A2B367(SR_Arg_ArgumentException, "", defaultOf());
+    return ArgumentException_$ctor_Z60A2B367(SR_Arg_ArgumentException, defaultOf(), defaultOf());
 }
 export function ArgumentException_$ctor_Z721C83C5(message) {
-    return ArgumentException_$ctor_Z60A2B367(message, "", defaultOf());
+    return ArgumentException_$ctor_Z60A2B367(message, defaultOf(), defaultOf());
 }
 export function ArgumentException_$ctor_Z384F8060(message, paramName) {
     return ArgumentException_$ctor_Z60A2B367(message, paramName, defaultOf());
 }
 export function ArgumentException_$ctor_68CE3CA2(message, innerException) {
-    return ArgumentException_$ctor_Z60A2B367(message, "", innerException);
+    return ArgumentException_$ctor_Z60A2B367(message, defaultOf(), innerException);
 }
 export function ArgumentException__get_ParamName(_) {
     return _.paramName;
@@ -268,7 +268,7 @@ export function ArgumentNullException_$ctor_Z721C83C5(paramName) {
     return ArgumentNullException_$ctor_Z384F8060(paramName, SR_ArgumentNull_Generic);
 }
 export function ArgumentNullException_$ctor() {
-    return ArgumentNullException_$ctor_Z721C83C5("");
+    return ArgumentNullException_$ctor_Z721C83C5(defaultOf());
 }
 export class ArgumentOutOfRangeException extends ArgumentException {
     constructor(paramName, message) {
@@ -285,5 +285,5 @@ export function ArgumentOutOfRangeException_$ctor_Z721C83C5(paramName) {
     return ArgumentOutOfRangeException_$ctor_Z384F8060(paramName, SR_Arg_ArgumentOutOfRangeException);
 }
 export function ArgumentOutOfRangeException_$ctor() {
-    return ArgumentOutOfRangeException_$ctor_Z721C83C5("");
+    return ArgumentOutOfRangeException_$ctor_Z721C83C5(defaultOf());
 }

package/package.json

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