@reventlessdev/rescript-node 2.0.0-alpha.6 → 2.0.0-alpha.8

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 2.0.0-alpha.8 (2026-08-18)
+
+### Features
+
+* **core:** read a command's lifecycle guard off the GWT corpus, and check [@transition](https://github.com/transition) against it ([057c898](https://github.com/ReventlessDev/reventless-core/commit/057c898761917bd6fc5eb9ac6867c8125709eab4))
+
+
+# 2.0.0-alpha.7 (2026-08-15)
+
+### Features
+
+* **local:** serve ui-hints.json edits without restarting the platform ([b29b104](https://github.com/ReventlessDev/reventless-core/commit/b29b1044f31f620071423c618486daef9692c614))
+
+
 # 2.0.0-alpha.6 (2026-08-14)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/rescript-node",
-  "version": "2.0.0-alpha.6",
+  "version": "2.0.0-alpha.8",
   "description": "ReScript bindings for the Node.js standard library",
   "license": "Apache-2.0",
   "devDependencies": {

package/src/NodeFs.res

@@ -17,6 +17,15 @@ external existsSync: string => bool = "existsSync"
 @module("node:fs")
 external realpathSync: string => string = "realpathSync"
 
+/** Set a file's access and modification times, in seconds since the epoch.
+
+    The reason this exists here rather than as a shell-out to `touch`: a build
+    whose compiler caches on source mtime cannot be made to re-run a side effect
+    of compilation — emitting a sidecar, say — by any argument passed to it. The
+    input has to look newer. */
+@module("node:fs")
+external utimesSync: (string, float, float) => unit = "utimesSync"
+
 // ── Reading ──────────────────────────────────────────────────────────────────
 
 @module("node:fs")
@@ -38,6 +47,34 @@ external writeFileSync: (string, string, @as("utf8") _) => unit = "writeFileSync
 @module("node:fs")
 external writeFileSyncBuffer: (string, Uint8Array.t) => unit = "writeFileSync"
 
+// ── Watching ─────────────────────────────────────────────────────────────────
+
+/** A handle from {!watch}. Held so it can be closed, and so it can be `unref`ed
+    — an active watcher keeps the event loop alive, which turns a stray watch in
+    a test into a run that never exits. */
+type watcher
+
+/** Stop watching. */
+@send external watcherClose: watcher => unit = "close"
+
+/** Take the watcher off the event loop's reference count, so it never by itself
+    keeps the process running. Returns the same watcher, as Node does. */
+@send external watcherUnref: watcher => watcher = "unref"
+
+/** [`fs.watch`](https://nodejs.org/api/fs.html#fswatchfilename-options-listener).
+
+    The listener takes the event type (`"rename"` or `"change"`) and the
+    basename, which Node may report as null on some platforms — hence
+    `Nullable.t`.
+
+    **Watch the directory, not the file**, when the file is one an editor
+    writes: a save that replaces rather than rewrites (write-temp-then-rename,
+    which is how most editors save atomically) gives the path a new inode, and a
+    watcher registered on the old one goes silent with no error. Watching the
+    containing directory and filtering on the basename survives that. */
+@module("node:fs")
+external watch: (string, (string, Nullable.t<string>) => unit) => watcher = "watch"
+
 // ── Directories ──────────────────────────────────────────────────────────────
 
 type dirent