Update NuGet and npm dependencies and add Temporal flag (#69)

Author: nojaf

.config/dotnet-tools.json

@@ -3,12 +3,12 @@
   "isRoot": true,
   "tools": {
     "fantomas": {
-      "version": "8.0.0-alpha-025",
+      "version": "8.0.0-beta-002",
       "commands": ["fantomas"],
       "rollForward": false
     },
     "fsdocs-tool": {
-      "version": "22.1.0",
+      "version": "23.0.0-alpha.1",
       "commands": ["fsdocs"],
       "rollForward": false
     },

CHANGELOG.md

@@ -5,6 +5,16 @@ 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) from version [0.1.0] moving forward.
 
+## [0.5.0] - 2026-09-09
+
+### Added
+
+- `temporal` option. Compiles the .NET date and time types to the Temporal API instead of `Date`, with tick precision and .NET's arithmetic across DST changes. It is Fable's experimental `--test:js-temporal` flag passed through, and the plugin adds no polyfill. Off by default, so existing output is unchanged. See [Temporal](https://fable.io/vite-plugin-fable/recipes.html#Temporal).
+
+### Changed
+
+- Updated Fable.Compiler to 5.16.0 and `@fable-org/fable-library-js` to 2.7.0. Numeric formatting in the emitted JavaScript now matches .NET for the `G`, `E` and custom format strings, and `E` is accepted on `int64` and `uint64`.
+
 ## [0.4.0] - 2026-09-03
 
 ### Fixed

Directory.Packages.props

@@ -4,24 +4,24 @@
     <CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
   </PropertyGroup>
   <ItemGroup>
-    <PackageVersion Include="Fable.React" Version="7.4.3" />
-    <PackageVersion Include="FSharp.Core" Version="10.1.203" />
+    <PackageVersion Include="Fable.React" Version="9.4.0" />
+    <PackageVersion Include="FSharp.Core" Version="10.1.401" />
     <PackageVersion Include="FSharp.SystemTextJson" Version="1.4.36" />
     <PackageVersion Include="StreamJsonRpc" Version="2.25.29" />
-    <PackageVersion Include="Fable.Compiler" Version="5.15.0" />
-    <PackageVersion Include="Suave" Version="2.6.2" />
-    <PackageVersion Include="protobuf-net" Version="3.2.30" />
+    <PackageVersion Include="Fable.Compiler" Version="5.16.0" />
+    <PackageVersion Include="Suave" Version="3.4.6" />
+    <PackageVersion Include="protobuf-net" Version="3.4.21" />
     <!-- lock transitive dependencies -->
-    <PackageVersion Include="Fable.AST" Version="5.0.0" />
+    <PackageVersion Include="Fable.AST" Version="5.1.0" />
     <PackageVersion Include="System.Collections" Version="4.3.0" />
     <PackageVersion Include="System.Diagnostics.Debug" Version="4.3.0" />
     <PackageVersion Include="System.IO.FileSystem.Primitives" Version="4.3.0" />
     <PackageVersion Include="System.Runtime.Extensions" Version="4.3.1" />
     <PackageVersion Include="MessagePack" Version="2.5.302" />
     <!-- unit test project -->
-    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.13.0" />
-    <PackageVersion Include="Nerdbank.Streams" Version="2.13.31" />
-    <PackageVersion Include="NUnit" Version="4.3.2" />
-    <PackageVersion Include="NUnit3TestAdapter" Version="5.0.0" />
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.9.0" />
+    <PackageVersion Include="Nerdbank.Streams" Version="2.14.354" />
+    <PackageVersion Include="NUnit" Version="4.6.1" />
+    <PackageVersion Include="NUnit3TestAdapter" Version="6.3.0" />
   </ItemGroup>
-</Project>
+</Project>

bun.lock

@@ -18,20 +18,21 @@ Every option the plugin accepts. All of them are optional.
 | `configuration`           | <code>"Debug" &#124; "Release"</code>                   | `Release` on build, `Debug` on dev | MSBuild configuration. See [Debug or Release](#Debug-or-Release).                                                                             |
 | `jsx`                     | <code>"automatic" &#124; "transform" &#124; null</code> | `null`                             | Transform JSX that Fable emitted. See [Fable.Core.JSX](#Fable-Core-JSX).                                                                      |
 | `noReflection`            | `boolean`                                               | `false`                            | Passed to Fable. Skips emitting reflection info, which produces smaller output.                                                               |
+| `temporal`                | `boolean`                                               | `false`                            | Passed to Fable. Compiles the .NET date and time types to the Temporal API instead of `Date`. See [Temporal](#Temporal).                      |
 | `exclude`                 | `string[]`                                              | `[]`                               | Passed to Fable. Excludes assemblies from compilation, typically Fable plugins.                                                               |
 | `debug`                   | `boolean`                                               | `false`                            | Print what the plugin is doing, and start the daemon's debug server. See [Seeing what the plugin is doing](#Seeing-what-the-plugin-is-doing). |
 | `fableModulesDiagnostics` | `boolean`                                               | `false`                            | Report diagnostics for files under `fable_modules`. See [Diagnostics from restored packages](#Diagnostics-from-restored-packages).            |
 
-`noReflection` and `exclude` are handed to Fable.Compiler unchanged; they mean what they mean for
-the `dotnet fable` CLI. Changing either invalidates the plugin's build caches, so you do not need
-to clear `obj/` yourself.
+`noReflection`, `temporal` and `exclude` are handed to Fable.Compiler unchanged; they mean what
+they mean for the `dotnet fable` CLI. Changing any of them invalidates the plugin's build caches,
+so you do not need to clear `obj/` yourself.
 
 Unknown or badly typed options are rejected when the config loads, so a misspelled one fails with
 a message rather than being quietly ignored:
 
 ```
 vite-plugin-fable: unknown option "noRefleciton". Did you mean "noReflection"?
-Known options: fsproj, jsx, noReflection, exclude, configuration, debug, fableModulesDiagnostics.
+Known options: fsproj, jsx, noReflection, temporal, exclude, configuration, debug, fableModulesDiagnostics.
 ```
 
 If you write your Vite config in TypeScript you get the same feedback in the editor. The plugin
@@ -59,6 +60,23 @@ takes the only signal with it: nothing is printed and `vite build` exits 0, even
 emitted nothing usable for that file. If a build succeeds and the app is broken in a way that
 points at a package, turn this on first.
 
+## Temporal
+
+Fable compiles `DateTime`, `DateTimeOffset`, `DateOnly`, `TimeOnly` and `TimeSpan` to JavaScript's
+`Date` by default, which is millisecond precise and does arithmetic across DST changes differently
+from .NET. Fable 5.16 can target the
+[Temporal API](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal)
+instead, which is tick precise and matches .NET's wall-clock semantics:
+
+```js
+fable({ temporal: true });
+```
+
+It is experimental in Fable, where it is the hidden `--test:js-temporal` flag, and the plugin only
+passes it through. It sets the `FABLE_COMPILER_JAVASCRIPT_TEMPORAL` define as `dotnet fable` does,
+so F# code can branch on it. The plugin adds no polyfill: check that the browsers and runtimes you
+target ship `Temporal`, and load one yourself if they do not.
+
 ## Seeing what the plugin is doing
 
 By default the plugin prints one line per compile, plus any diagnostics and errors:

docs/recipes.md

@@ -7,7 +7,7 @@
       "sample-project"
     ],
     "catalog": {
-      "@fable-org/fable-library-js": "2.6.0",
+      "@fable-org/fable-library-js": "2.7.0",
       "vite": "^8.2.2",
       "vite-plugin-inspect": "^12.0.2"
     }
@@ -33,12 +33,12 @@
   },
   "devDependencies": {
     "@nojaf/oxlint-plugin-annotate-non-primitives": "^0.1.1",
-    "@types/bun": "^1.4.0",
+    "@types/bun": "^1.4.2",
     "copy-to-clipboard": "^4.0.2",
-    "keep-a-changelog": "^3.1.0",
+    "keep-a-changelog": "^3.2.0",
     "lit": "^3.3.3",
-    "oxfmt": "0.66.0",
-    "oxlint": "^1.81.0",
+    "oxfmt": "0.67.0",
+    "oxlint": "^1.82.0",
     "typescript": "7.0.2"
   }
 }

package.json

@@ -22,6 +22,7 @@ let sampleApp =
         Configuration = "Release"
         Exclude = Array.empty
         NoReflection = false
+        Temporal = false
     }
 
 let telplin =
@@ -31,6 +32,7 @@ let telplin =
         Configuration = "Debug"
         Exclude = Array.empty
         NoReflection = false
+        Temporal = false
     }
 
 let fantomasTools =
@@ -44,6 +46,7 @@ let fantomasTools =
         Configuration = "Debug"
         Exclude = Array.empty
         NoReflection = false
+        Temporal = false
     }
 
 // let ronnies =
@@ -53,6 +56,7 @@ let fantomasTools =
 //         Configuration = "Debug"
 //         Exclude = [| "Nojaf.Fable.React.Plugin" |]
 //         NoReflection = true
+//         Temporal = false
 //     }
 
 [<Test>]
@@ -147,7 +151,7 @@ let ``a failing dotnet msbuild call reports what MSBuild said`` () =
         let! finished = Task.WhenAny (run :> Task, Task.Delay (TimeSpan.FromMinutes 2.))
         Assert.That (finished, Is.SameAs (run :> Task), "dotnet msbuild never came back")
 
-        let error = Assert.Throws<AggregateException>(fun () -> run.Wait ())
+        let error = Assert.Throws<AggregateException>(Action (fun () -> run.Wait ()))
 
         Assert.That (
             error.InnerException.Message,
@@ -389,6 +393,22 @@ module CacheKeyTests =
         | Ok _ -> Assert.Pass ()
         | Error reason -> Assert.Fail $"expected the cache to be reusable, got %A{reason}"
 
+    [<Test>]
+    let ``turning on temporal invalidates the cache`` () =
+        // The option has no field in the cache; it rides on the define `dotnet fable` sets for it.
+        Caching.writeDesignTimeBuild (mkKey [] false) emptyResponse
+
+        let withTemporal =
+            { mkKey [] false with
+                Defines = Set.ofList [ "FABLE_COMPILER" ; "FABLE_COMPILER_JAVASCRIPT_TEMPORAL" ]
+            }
+
+        match Caching.canReuseDesignTimeBuildCache withTemporal with
+        | Error (Caching.InvalidCacheReason.DefinesMismatch (cached, current)) ->
+            Assert.That (current, Does.Contain "FABLE_COMPILER_JAVASCRIPT_TEMPORAL")
+            Assert.That (cached, Does.Not.Contain "FABLE_COMPILER_JAVASCRIPT_TEMPORAL")
+        | other -> Assert.Fail $"expected a defines mismatch, got %A{other}"
+
     [<Test>]
     let ``changing noReflection invalidates the cache`` () =
         Caching.writeDesignTimeBuild (mkKey [] false) emptyResponse
@@ -536,6 +556,7 @@ module DebugServerTests =
             FableLibrary = fableLibrary
             Exclude = []
             NoReflection = false
+            Temporal = false
             SourceFiles = [| mathFs ; libraryFs |]
             DependentFiles = [| Path.CombineNormalize (sampleProjectDir, "App.fsproj") |]
             TargetFramework = Some "net10.0"

packages/vite-plugin-fable/Fable.Daemon.Tests/DebugTests.fs

@@ -8,26 +8,16 @@ open System.Collections.Concurrent
 open System.IO
 open System.Net
 open System.Threading
+open System.Threading.Tasks
 open Suave
 open Suave.Filters
 open Suave.Operators
 open Suave.Successful
-open Suave.Logging
-open Suave.Sockets
-open Suave.Sockets.Control
 open Suave.WebSocket
 open Microsoft.Extensions.Logging
 
 let defaultPort = 9014us
 
-/// We can't log anything to the stdout!
-let zeroSuaveLogger : Logger =
-    { new Logger with
-        member x.log level _ = ()
-        member x.logWithAck _ _ = async.Zero ()
-        member x.name = [| "vite-plugin-fable" |]
-    }
-
 /// Next to the assembly rather than `__SOURCE_DIRECTORY__`, which bakes in the path the daemon was
 /// compiled in. That was the same folder while the daemon was built on the machine that ran it, and
 /// is a stranger's home directory now that it ships prebuilt.
@@ -76,11 +66,11 @@ type InMemoryLogger() =
                 |> Seq.skip currentCount
                 |> HTML.mapLogEntriesToListItems
                 |> Encoding.UTF8.GetBytes
-                |> ByteSegment
+                |> Memory<byte>
 
-            client.send Text messages true //
-            |> Async.Ignore
-            |> Async.RunSynchronously
+            // Suave 3 hands back a ValueTask<Result<_, _>>; a failed send only means the client is
+            // gone, and the read loop in `ws` drops it on its next turn.
+            (client.send Text messages true).AsTask().GetAwaiter().GetResult() |> ignore
 
             connectedClients.[client] <- entries.Count
 
@@ -131,6 +121,7 @@ type ProjectState =
         FableLibrary : FullPath
         Exclude : string list
         NoReflection : bool
+        Temporal : bool
         SourceFiles : FullPath array
         DependentFiles : FullPath array
         TargetFramework : string option
@@ -437,6 +428,7 @@ let projectPayload (includes : string) (project : ProjectState) =
         fableLibrary = project.FableLibrary
         exclude = project.Exclude
         noReflection = project.NoReflection
+        temporal = project.Temporal
         targetFramework = Option.toObj project.TargetFramework
         outputType = Option.toObj project.OutputType
         sourceFiles =
@@ -714,25 +706,40 @@ let api (logger : InMemoryLogger) (port : uint16) : WebPart =
             )
         ]
 
-let ws (logger : InMemoryLogger) (webSocket : WebSocket) (context : HttpContext) =
-    context.runtime.logger.info (Message.eventX $"New websocket connection")
+let ws
+    (logger : InMemoryLogger)
+    (webSocket : WebSocket)
+    (_context : HttpContext)
+    : ValueTask<Result<unit, Suave.Sockets.Error>>
+    =
     connectedClients.TryAdd (webSocket, logger.Count) |> ignore
 
-    socket {
-        let mutable loop = true
+    let loop =
+        task {
+            let mutable result = Result.Ok ()
+            let mutable loop = true
 
-        while loop do
-            let! msg = webSocket.read ()
+            while loop do
+                let! msg = webSocket.read ()
 
-            match msg with
-            | Close, _, _ ->
-                connectedClients.TryRemove webSocket |> ignore
-                let emptyResponse = [||] |> ByteSegment
-                do! webSocket.send Close emptyResponse true
-                loop <- false
+                match msg with
+                | Result.Ok (Close, _, _) ->
+                    connectedClients.TryRemove webSocket |> ignore
+                    let! closed = webSocket.send Close Memory<byte>.Empty true
+                    result <- closed
+                    loop <- false
 
-            | _ -> ()
-    }
+                | Result.Ok _ -> ()
+
+                | Result.Error err ->
+                    connectedClients.TryRemove webSocket |> ignore
+                    result <- Result.Error err
+                    loop <- false
+
+            return result
+        }
+
+    ValueTask<Result<unit, Suave.Sockets.Error>> loop
 
 let webApp (logger : InMemoryLogger) (port : uint16) : WebPart =
     let allLogs ctx =
@@ -816,7 +823,6 @@ let startWebserver (logger : InMemoryLogger) (port : uint16) (cancellationToken
         { defaultConfig with
             cancellationToken = cancellationToken
             homeFolder = Some homeFolder
-            logger = zeroSuaveLogger
             bindings = [ HttpBinding.create HTTP IPAddress.Loopback port ]
         }
 
@@ -826,4 +832,4 @@ let startWebserver (logger : InMemoryLogger) (port : uint16) (cancellationToken
     serverEnabled <- true
     writeDiscoveryFile port cancellationToken
     let _listening, server = startWebServerAsync conf (webApp logger port)
-    server
+    Async.AwaitTask server

packages/vite-plugin-fable/Fable.Daemon/Debug.fs

@@ -23,6 +23,7 @@ type ProjectState =
         FableLibrary : FullPath
         Exclude : string list
         NoReflection : bool
+        Temporal : bool
         /// Every source file, in compilation order.
         SourceFiles : FullPath array
         /// The MSBuild inputs a change to which forces a re-crack.

packages/vite-plugin-fable/Fable.Daemon/Debug.fsi

@@ -143,14 +143,25 @@ let tryTypeCheckProject
                                 TypedArrays = false
                                 ClampByteArrays = false
                                 Language = Language.JavaScript
-                                Define = [ "FABLE_COMPILER" ; "FABLE_COMPILER_4" ; "FABLE_COMPILER_JAVASCRIPT" ]
+                                Define =
+                                    [
+                                        "FABLE_COMPILER"
+                                        "FABLE_COMPILER_4"
+                                        "FABLE_COMPILER_JAVASCRIPT"
+                                        // The define is what `dotnet fable` sets alongside the flag, and it is
+                                        // part of the design time build cache key, so flipping the option
+                                        // invalidates the cache without a field of its own.
+                                        if payload.Temporal then
+                                            "FABLE_COMPILER_JAVASCRIPT_TEMPORAL"
+                                    ]
                                 DebugMode = false
                                 OptimizeFSharpAst = false
                                 Verbosity = Verbosity.Verbose
                                 // We keep using `.fs` for the compiled FSharp file, even though the contents will be JavaScript.
                                 FileExtension = ".fs"
                                 TriggeredByDependency = false
                                 NoReflection = payload.NoReflection
+                                JsTemporal = payload.Temporal
                             }
                         RunProcess = None
                         Verbosity = Verbosity.Verbose
@@ -310,6 +321,7 @@ let private describeProject
         FableLibrary = payload.FableLibrary
         Exclude = List.ofArray payload.Exclude
         NoReflection = payload.NoReflection
+        Temporal = payload.Temporal
         SourceFiles = result.CrackerResponse.ProjectOptions.SourceFiles
         DependentFiles = result.DependentFiles
         TargetFramework = result.CrackerResponse.TargetFramework