@reventlessdev/rescript-node 2.0.0-alpha.14 → 2.0.0-alpha.15

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 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.15 (2026-09-23)
+
+* feat(node)!: every command-line tool reads its arguments through parseArgs ([2e41979](https://github.com/ReventlessDev/reventless-core/commit/2e41979b73646c46356e197e17eb4a3da0154c73))
+
+### BREAKING CHANGES
+
+* NodeProcess.onSignal takes the new NodeProcess.signal
+variant (SIGINT | SIGTERM | SIGHUP) instead of a polymorphic variant:
+write onSignal(SIGINT, …) for onSignal(#SIGINT, …). Node receives the
+same string.
+
+
+
 # 2.0.0-alpha.14 (2026-09-23)
 
 ### Features

package/README.md

@@ -45,6 +45,7 @@ Add it to your `rescript.json` dependencies:
 | `NodeProcess` | the `process` global |
 | `NodeStreams` | `node:stream`, plus the stream-shaped parts of `node:fs` and `node:readline` |
 | `NodeUrl` | `node:url` |
+| `NodeUtil` | `parseArgs` from `node:util` |
 | `NodeZlib` | `node:zlib` |
 
 Every module specifier is `node:`-prefixed. Bare `"fs"` is what bundlers alias to a browser polyfill

package/package.json

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

package/rescript.json

@@ -26,6 +26,7 @@
         "NodeProcess",
         "NodeStreams",
         "NodeUrl",
+        "NodeUtil",
         "NodeZlib"
       ]
     }

package/src/NodeProcess.res

@@ -40,13 +40,20 @@ external kill: (int, int) => unit = "kill"
     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. */
+    closed variant 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"
 
+/** The signals a CLI cleans up on. Each constructor compiles to the name Node
+    reads. */
+type signal =
+  | @as("SIGINT") SIGINT
+  | @as("SIGTERM") SIGTERM
+  | @as("SIGHUP") SIGHUP
+
 @val @scope("process")
-external onSignal: ([#SIGINT | #SIGTERM | #SIGHUP], unit => unit) => unit = "on"
+external onSignal: (signal, 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

package/src/NodeUtil.res

@@ -0,0 +1,52 @@
+/** Bindings for `node:util`. `parseArgs` is stable from Node 20.
+
+    Node's string enums are regular variants whose constructors compile to the
+    exact strings Node reads and writes. `default` and `allowNegative` are left
+    out: the first is a string, a boolean or an array depending on the option,
+    and the second needs Node 22.4. */
+/** An option's `type`. */
+type optionType =
+  | @as("string") String
+  | @as("boolean") Boolean
+
+type optionConfig = {
+  @as("type") type_: optionType,
+  short?: string,
+  multiple?: bool,
+}
+
+type config = {
+  args?: array<string>,
+  options: dict<optionConfig>,
+  strict?: bool,
+  allowPositionals?: bool,
+  tokens?: bool,
+}
+
+/** A token's `kind`. The constructor names avoid `Option`, which would read as
+    the standard library module at every use site. */
+type tokenKind =
+  | @as("option") Flag
+  | @as("positional") Positional
+  | @as("option-terminator") Terminator
+
+type token = {
+  kind: tokenKind,
+  index: int,
+  name?: string,
+  rawName?: string,
+  value?: string,
+  inlineValue?: bool,
+}
+
+/** `values` mixes strings, booleans and arrays under one object, so it is
+    abstract and read through the typed accessors below. */
+type values
+
+type parsed = {values: values, positionals: array<string>, tokens?: array<token>}
+
+@module("node:util") external parseArgs: config => parsed = "parseArgs"
+
+@get_index external string: (values, string) => option<string> = ""
+@get_index external bool: (values, string) => option<bool> = ""
+@get_index external strings: (values, string) => option<array<string>> = ""

package/src/NodeUtil.res.mjs

@@ -0,0 +1,2 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+/* This output is empty. Its source's type definitions, externals and/or unused code got optimized away. */