@fable-org/fable-library-ts 2.3.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,5 @@
 ---
-last_commit_released: c977d78b39225a51c7bd051a1fe363ed0ccbe201
+last_commit_released: 7f915f1dd66b9a5fbbd56f858b07d39b98519b65
 updaters:
   - package.json:
       file: package.json
@@ -15,6 +15,19 @@ 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.4.0 - 2026-07-05
+
+### 🚀 Features
+
+* *(js/ts)* Add `System.IO.Path` and `System.IO.File` API support ([ec99fac5](https://github.com/fable-compiler/Fable/commit/ec99fac5fd7a9428ee54f66f878ef4edad0904cb))
+* *(js/ts/python)* Add Environment and Console.Error support ([6e082f95](https://github.com/fable-compiler/Fable/commit/6e082f955140676da3388a43b55378ea4ad20f1c))
+
+### 🐞 Bug Fixes
+
+* *(js/ts)* DateTime.ToString() and %A are now consistent across all DateTimeKind values (#4714) ([de98b0e4](https://github.com/fable-compiler/Fable/commit/de98b0e466c8824b0ba8b941d20efae70d232abb))
+
+<strong><small>[View changes on Github](https://github.com/fable-compiler/Fable/compare/c977d78b39225a51c7bd051a1fe363ed0ccbe201..7f915f1dd66b9a5fbbd56f858b07d39b98519b65)</small></strong>
+
 ## 2.3.0 - 2026-06-30
 
 ### 🚀 Features

package/Date.ts

@@ -509,7 +509,7 @@ function dateToString_Y(date: IDateTime) {
 function dateToStringWithKind(date: IDateTime, format?: string) {
   const utc = date.kind === DateTimeKind.Utc;
   if (typeof format !== "string") {
-    return utc ? date.toUTCString() : date.toLocaleString();
+    return dateToString_d(date) + " " + dateToString_T(date);
   } else if (format.length === 1) {
     switch (format) {
       case "D": return dateToString_D(date);

package/Environment.ts

@@ -0,0 +1,7 @@
+// process.env is Node-specific; there is no browser equivalent for reading
+// environment variables, so this only works when running under Node.
+declare const process: { env: Record<string, string | undefined> };
+
+export function getEnvironmentVariable(name: string): string {
+  return process.env[name] as string;
+}

package/File.ts

@@ -0,0 +1,35 @@
+// This library doesn't depend on @types/node (to stay browser-compatible),
+// so this Node.js built-in import can't be type-checked; the exported
+// functions below still declare their own types for callers to rely on.
+// @ts-ignore
+import { readFileSync, writeFileSync } from "node:fs";
+import { MutableArray } from "./Util.ts";
+
+// byte[] is represented as a plain JS/TS array of numbers, not a typed array
+// (see e.g. BitConverter.ts), so convert the Buffer returned by readFileSync.
+export function readAllBytes(path: string): number[] {
+  return Array.from(readFileSync(path));
+}
+
+export function readAllLines(path: string): string[] {
+  const lines = readFileSync(path, "utf8").split(/\r\n|\r|\n/);
+
+  if (lines[lines.length - 1] === "") {
+    lines.pop();
+  }
+
+  return lines;
+}
+
+export function readAllText(path: string): string {
+  return readFileSync(path, "utf8");
+}
+
+export function writeAllBytes(path: string, bytes: MutableArray<number>): void {
+  // Convert back from the plain array representation to a typed array Node's fs accepts.
+  writeFileSync(path, Uint8Array.from(bytes));
+}
+
+export function writeAllLines(path: string, lines: MutableArray<string>): void {
+  writeFileSync(path, lines.join("\n"));
+}

package/Path.ts

@@ -0,0 +1,37 @@
+// This library doesn't depend on @types/node (to stay browser-compatible),
+// so these Node.js built-in imports can't be type-checked; the exported
+// functions below still declare their own types for callers to rely on.
+// @ts-ignore
+import { basename, extname, join } from "node:path";
+// @ts-ignore
+import { tmpdir } from "node:os";
+// @ts-ignore
+import { writeFileSync } from "node:fs";
+
+// Mirrors the format of .NET's Path.GetRandomFileName(): 8 random hex chars,
+// a dot, then 3 more random hex chars.
+export function getRandomFileName(): string {
+  const nameBytes = new Uint8Array(4);
+  crypto.getRandomValues(nameBytes);
+  const name = Array.from(nameBytes, (b) => b.toString(16).padStart(2, "0")).join("");
+
+  const extBytes = new Uint8Array(2);
+  crypto.getRandomValues(extBytes);
+  const ext = Array.from(extBytes, (b) => b.toString(16).padStart(2, "0")).join("").slice(0, 3);
+
+  return `${name}.${ext}`;
+}
+
+export function getFileNameWithoutExtension(path: string): string {
+  return basename(path, extname(path));
+}
+
+export function hasExtension(path: string): boolean {
+  return extname(path) !== "";
+}
+
+export function getTempFileName(): string {
+  const path = join(tmpdir(), getRandomFileName());
+  writeFileSync(path, "");
+  return path;
+}

package/package.json

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