@reventlessdev/rescript-node 2.0.0-alpha.5 → 2.0.0-alpha.7

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.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
+
+* **local:** let the seed tools address a platform, not a guessed file ([98862ad](https://github.com/ReventlessDev/reventless-core/commit/98862adaa4111f605553e4a78bc52a8a488a4ef3))
+
+
 # 2.0.0-alpha.5 (2026-08-13)
 
 ### Features

package/package.json

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

package/src/NodeFs.res

@@ -38,6 +38,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

package/src/NodeProcess.res

@@ -21,6 +21,30 @@ external chdir: string => unit = "chdir"
 @val @scope("process")
 external exit: int => unit = "exit"
 
+@val @scope("process")
+external pid: int = "pid"
+
+/** Signalling another process — or, with signal `0`, asking whether it is still
+    there without disturbing it. Throws when the pid is gone (`ESRCH`) or not
+    ours to signal (`EPERM`), so a liveness check is a `try`. */
+@val @scope("process")
+external kill: (int, int) => unit = "kill"
+
+/** `process.on` for the two shutdown paths a CLI has to clean up on.
+
+    Split into an `exit` binding and a signal binding because the handlers are
+    not interchangeable: `exit` fires with the exit code and may only do
+    synchronous work, while a signal handler receives the signal name and fires
+    *before* the process is committed to leaving — code that registers one and
+    expects the other's timing gets a cleanup that never runs. Signals are a
+    polyvariant so a typo is a compile error rather than a handler that is never
+    called. */
+@val @scope("process")
+external onExit: (@as("exit") _, int => unit) => unit = "on"
+
+@val @scope("process")
+external onSignal: ([#SIGINT | #SIGTERM | #SIGHUP], unit => unit) => unit = "on"
+
 /** The standard streams. `write`, `isTTY`, `pause` and `unref` are what the
     interactive prompts in this repository reach for; the type is abstract so it
     can also be handed to `readline.createInterface`. */