@swiftuijs/twill-shell 0.2.0 → 0.3.0

package/README.md

@@ -1,38 +1,73 @@
 # <img src="https://twill.evecalm.com/logo.png" alt="Twill hummingbird" align="right" width="40" height="40" /> Twill shell
 
-Swift-inspired subprocess tools for Twill and ordinary Node JS/TS scripts, available in 0.2.0.
+Swift-inspired subprocess tools for Twill and ordinary Node JS/TS scripts, Node-based in 0.3.0.
+
+## Install in your project
+
+Use Node 24 LTS for a new setup (supported range: `^20.19.0 || >=22.12.0`). Run from the directory containing your `package.json`; for a new project, run `npm init -y` first. Install the SDK as a production dependency:
 
 ```sh
-npm install @swiftuijs/twill-shell
-# For .twill source scripts:
-npm install --save-dev @swiftuijs/twill
+npm install @swiftuijs/twill-shell@0.3.0
 ```
 
-Commands execute through one Rust process engine with literal argv, without shell interpretation or command compilation (`shell: false`). The prebuilt implementation dependency installs automatically; users need no Rust toolchain and do not choose a backend. Native JS/TS needs no Twill compiler. One async reactor per Node environment coordinates already-started children and pipes independently of libuv's worker pool.
+With pnpm, use `pnpm add @swiftuijs/twill-shell@0.3.0`. This package supplies the process API; `@swiftuijs/twill` supplies the optional Twill source runner. A global compiler does not make this SDK available to project imports. Keep Twill packages on the same version.
+
+## Run ordinary JavaScript
+
+The SDK uses Node spawn/streams with literal argv (`shell: false`), bounded capture and owned cancellation/timeout teardown. It has zero production dependencies; native JS/TS needs no Twill compiler or Rust toolchain.
+
+Changed in 0.3.0: the SDK no longer depends on `@swiftuijs/twill-shell-native`. Older npm 0.2.0 still requires the retired Rust addon; its versions remain downloadable for compatibility. The public command/policy/error API remains; abrupt worker/process-exit cleanup and unnamed Unix signal reporting change to Node's boundaries. See the [scripting guide](https://twill.evecalm.com/scripting#execution-and-version-boundary).
 
-Supported prebuilds: Linux glibc x64/ARM64 (glibc 2.28+), Linux musl x64/ARM64 (musl 1.2.5+), macOS x64/ARM64 and Windows x64/ARM64. Missing/incompatible binaries and unsupported platforms reject before launch, without fallback, install-time builds or downloads. See [performance](https://twill.evecalm.com/performance#rust-shell-backend) for measured warm gains and cold/polling limits.
+Save this as `command.mjs`:
 
-```twill
-#!/usr/bin/env twill
+```js
 import { Command, Output, Subprocess } from '@swiftuijs/twill-shell';
 
-const result = await Subprocess.run(Command.name('git', ['status', '--short']), {
-  output: Output.text({ limit: 64 * 1024 }),
-  timeoutMs: 5000,
-});
-console.log(result.standardOutput);
+const result = await Subprocess.run(
+  Command.path(process.execPath, ['-e', 'console.log("Hello from a child process")']),
+  { output: Output.text({ limit: 64 * 1024 }), timeoutMs: 5000 },
+);
+console.log(result.standardOutput.trim());
+```
+
+Run `node command.mjs`. Expected output is `Hello from a child process`. This works without Git, a Twill compiler or a global installation. Native TypeScript uses your existing TS runner/build.
+
+## Run Twill source
+
+Install the compiler as well:
+
+```sh
+npm install --save-dev @swiftuijs/twill@0.3.0
+# pnpm add -D @swiftuijs/twill@0.3.0
+```
+
+Copy the JavaScript example to `command.twill` and add `#!/usr/bin/env twill` as its first line. Use the local command:
+
+```sh
+npm exec -- twill command.twill
+# pnpm exec twill command.twill
 ```
 
-The compiler runner supplies the `twill` binary. Save this as `status.twill`, then use `twill status.twill` or `twill run status.twill`. On Linux/macOS, `chmod +x status.twill` enables `./status.twill` when `twill` is on PATH; `pnpm exec ./status.twill` uses a project-local binary. Windows uses the explicit CLI. Arguments after the script path pass through unchanged. Application dependencies resolve from the script's location. Use the compiler and SDK from 0.2.0 or newer.
+On Linux/macOS, `chmod +x command.twill` enables `npm exec --call './command.twill'` or `pnpm exec ./command.twill`. To run `./command.twill` directly, install the compiler globally with `npm install --global @swiftuijs/twill@0.3.0` and keep its executable directory on PATH. Windows uses the explicit CLI. Arguments after the script path pass through unchanged. Application dependencies resolve from the script's location. Use compiler and SDK 0.3.0 or newer.
+
+For package scripts, Node type declarations, error handling and troubleshooting, follow the [complete shell scripting guide](https://twill.evecalm.com/scripting). [Getting started](https://twill.evecalm.com/getting-started) covers application modules and build integration.
+
+## Process contracts
 
 Use `Command.path(absolutePath, args)` for a trusted executable; `Command.name(name, args)` uses native PATH search. Arguments are immutable snapshots and remain literal strings, including spaces, quotes, newlines and shell metacharacters. Tool-specific options still matter: use `--` before user-supplied filenames when the executable supports it.
 
 Stdin defaults to EOF; stdout/stderr inherit without capture. `Input.inherit()` inherits stdin; a string or `Uint8Array` writes input with native backpressure. Byte input is copied at submission; cwd and environment are snapshotted then. `Output.text({limit})` and `Output.bytes({limit})` require positive byte limits; `Output.discard()` retains nothing. Output-limit failure rejects after teardown, never returns silent truncation. Capture limits bound retained stream bytes, not total process memory or the final UTF-8 string/buffer allocation.
 
-Named Unix signals use Node names; unnamed signals retain their numeric OS value. A successful result contains `processIdentifier`, `terminationStatus`, `standardOutput` and `standardError`. Nonzero/signal exits reject with `ProcessExitError`; `check: false` returns that status. Launch/I/O failures, abort, timeout and output overflow always reject. Use ordinary `try/catch` and exported error classes. Errors can carry bounded output and native causes; the SDK never logs them automatically.
+From 0.3.0, statuses follow Node reports, including its unnamed-signal limitations. Released 0.2.0 preserves numeric unnamed Unix signals. A successful result contains `processIdentifier`, `terminationStatus`, `standardOutput` and `standardError`. Nonzero/signal exits reject with `ProcessExitError`; `check: false` returns that status. Launch/I/O failures, abort, timeout and output overflow always reject. Use ordinary `try/catch` and exported error classes. Errors can carry bounded output and native causes; the SDK never logs them automatically.
 
 `cwd` and `Environment.inherit(updates)` / `.replace(values)` apply only to the child. Pass an `AbortSignal` or `timeoutMs` for cancellation. The default grace period is 250 ms before forced termination, followed by at most 1000 ms joining time. Settlement normally waits for child close and owned I/O. Failed teardown reports `unresolvedProcessIdentifier` and `cleanupErrors`, preserving the first failure. Ownership covers the direct child; descendants and arbitrary process trees are outside this contract. Windows uses its native process handle for termination, without POSIX graceful-signal guarantees.
 
 This first stage does not implement scoped streaming, pipelines, shell templates or shell-text execution. Node ESM is required (`^20.19.0 || >=22.12.0`). Twill source execution uses its existing loader; exported/native JS only needs this SDK. See the [scripting guide](https://twill.evecalm.com/scripting), [RFC 0034](https://github.com/swiftuijs/twill/blob/main/docs/rfcs/0034-shell-scripting-toolkit.md) and [official AI skill](https://twill.evecalm.com/ai). Twill's sibling UI project is [SwiftUI.js](https://swiftuijs.evecalm.com/).
 
-Worker termination cancels that environment's children. Explicit `process.exit()` and environment teardown use a native cleanup barrier bounded to 1.1 seconds; JS callbacks do not run during exit. OS creation/uninterruptible kernel waits are not hard real-time guarantees, and SIGKILL/native faults cannot run cleanup handlers.
+Cancel and await outstanding work before a worker shuts down. Set `process.exitCode` after awaited work; forced `Worker.terminate()` and `process.exit()` cannot perform an asynchronous join. Version 0.3.0 removes the old native cleanup barrier. OS creation and event-loop scheduling are not hard real-time deadlines.
+
+Bounded capture and lifecycle checks add overhead. The reviewed Linux/Node 24 report measured about 17% median overhead for native dual 1 MiB capture and 11% for full duplex, accepted for 0.3.0. See the [recorded costs](https://twill.evecalm.com/performance#node-shell-sdk); this is not a universal native-parity guarantee.
+
+## Development
+
+This package's implementation uses Twill and emits ordinary JavaScript. Build and check a checkout with the workspace tools; see [developing tooling in Twill](https://github.com/swiftuijs/twill/blob/main/docs/contributing/dogfooding.md) for bootstrap and contribution instructions.

package/dist/cwd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cwd.d.ts","sourceRoot":"","sources":["../src/cwd.ts"],"names":[],"mappings":"AACA,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,kBAAmB,EAC3B,MAAM,SAAgB,GACrB,MAAM,CAQR"}
+{"version":3,"file":"cwd.d.ts","mappings":"AACA,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,kBAAmB,EAC3B,MAAM,SAAgB,GACrB,MAAM","names":[],"ignoreList":[],"sources":["../src/cwd.twill"]}

package/dist/cwd.js

@@ -1,11 +1,9 @@
-import { isAbsolute, win32 } from 'node:path';
-export function cwdSnapshot(cwd, platform = process.platform, parent = process.cwd()) {
-    return cwd === undefined
-        ? parent
-        : platform === 'win32'
-            ? win32.resolve(parent, cwd)
-            : isAbsolute(cwd)
-                ? cwd
-                : `${parent}/${cwd}`;
+import { isAbsolute, win32 } from "node:path";
+//#region src/cwd.twill
+function cwdSnapshot(cwd, platform = process.platform, parent = process.cwd()) {
+	return cwd === void 0 ? parent : platform === "win32" ? win32.resolve(parent, cwd) : isAbsolute(cwd) ? cwd : `${parent}/${cwd}`;
 }
+//#endregion
+export { cwdSnapshot };
+
 //# sourceMappingURL=cwd.js.map

package/dist/cwd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cwd.js","sourceRoot":"","sources":["../src/cwd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC9C,MAAM,UAAU,WAAW,CACzB,GAAuB,EACvB,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;IAEtB,OAAO,GAAG,KAAK,SAAS;QACtB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,QAAQ,KAAK,OAAO;YACpB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;YAC5B,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;gBACf,CAAC,CAAC,GAAG;gBACL,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"cwd.js","names":[],"sources":["../src/cwd.twill"],"mappings":";;AACA,SAAgB,YACd,KACA,WAAW,QAAQ,UACnB,SAAS,QAAQ,IAAG,GAAE;CAEtB,OAAO,QAAQ,KAAA,IACX,SACA,aAAa,UACX,MAAM,QAAQ,QAAQ,GAAG,IACzB,WAAW,GAAG,IACZ,MACA,GAAG,OAAM,GAAI;AACvB"}

package/dist/environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiB/C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,QAAQ,kBAAmB,EAC3B,MAAM,oBAAc;;EAgBrB"}
+{"version":3,"file":"environment.d.ts","mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAgB;AAiBjD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,QAAQ,kBAAmB,EAC3B,MAAM,oBAAc","names":[],"ignoreList":[],"sources":["../src/environment.twill"]}

package/dist/environment.js

@@ -1,32 +1,32 @@
-import { childEnvironment } from './values.js';
-// Match Node/libuv's mandatory Windows spawn environment additions (including
-// replacement/removal policies). Explicit empty values still override defaults.
-const windowsRequired = [
-    'HOMEDRIVE',
-    'HOMEPATH',
-    'LOGONSERVER',
-    'PATH',
-    'SYSTEMDRIVE',
-    'SYSTEMROOT',
-    'TEMP',
-    'USERDOMAIN',
-    'USERNAME',
-    'USERPROFILE',
-    'WINDIR',
+import { childEnvironment } from "./values.js";
+//#region src/environment.twill
+var windowsRequired = [
+	"HOMEDRIVE",
+	"HOMEPATH",
+	"LOGONSERVER",
+	"PATH",
+	"SYSTEMDRIVE",
+	"SYSTEMROOT",
+	"TEMP",
+	"USERDOMAIN",
+	"USERNAME",
+	"USERPROFILE",
+	"WINDIR"
 ];
-export function environmentSnapshot(policy, platform = process.platform, parent = process.env) {
-    const environment = { ...(childEnvironment(policy, platform) ?? parent) };
-    if (parent.NODE_V8_COVERAGE && !Object.hasOwn(environment, 'NODE_V8_COVERAGE'))
-        environment.NODE_V8_COVERAGE = parent.NODE_V8_COVERAGE;
-    if (platform === 'win32') {
-        const selected = new Set(Object.keys(environment).map((key) => key.toUpperCase()));
-        const inherited = new Map(Object.entries(parent).map(([key, value]) => [key.toUpperCase(), value]));
-        for (const key of windowsRequired) {
-            const value = inherited.get(key);
-            if (!selected.has(key) && value !== undefined)
-                environment[key] = value;
-        }
-    }
-    return environment;
+function environmentSnapshot(policy, platform = process.platform, parent = process.env) {
+	const environment = { ...childEnvironment(policy, platform) ?? parent };
+	if (parent.NODE_V8_COVERAGE && !Object.hasOwn(environment, "NODE_V8_COVERAGE")) environment.NODE_V8_COVERAGE = parent.NODE_V8_COVERAGE;
+	if (platform === "win32") {
+		const selected = new Set(Object.keys(environment).map((key) => key.toUpperCase()));
+		const inherited = new Map(Object.entries(parent).map(([key, value]) => [key.toUpperCase(), value]));
+		for (const key of windowsRequired) {
+			const value = inherited.get(key);
+			if (!selected.has(key) && value !== void 0) environment[key] = value;
+		}
+	}
+	return environment;
 }
+//#endregion
+export { environmentSnapshot };
+
 //# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,eAAe,GAAG;IACtB,WAAW;IACX,UAAU;IACV,aAAa;IACb,MAAM;IACN,aAAa;IACb,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,UAAU;IACV,aAAa;IACb,QAAQ;CACT,CAAC;AACF,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,MAAM,GAAG,OAAO,CAAC,GAAG;IAEpB,MAAM,WAAW,GAAG,EAAE,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC;IAC1E,IAAI,MAAM,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,CAAC;QAC5E,WAAW,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACzD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC,CACzE,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS;gBAAE,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"environment.js","names":[],"sources":["../src/environment.twill"],"mappings":";;AAKA,IAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;AACD,SAAgB,oBACd,QACA,WAAW,QAAQ,UACnB,SAAS,QAAQ,KAAG;CAEpB,MAAM,cAAc,EAAE,GAAI,iBAAiB,QAAQ,QAAQ,KAAK,OAAO;CACvE,IAAI,OAAO,oBAAoB,CAAC,OAAO,OAAO,aAAa,kBAAkB,GAC3E,YAAY,mBAAmB,OAAO;CACxC,IAAI,aAAa,SAAS;EACxB,MAAM,WAAW,IAAI,IAAI,OAAO,KAAK,WAAW,CAAC,CAAC,KAAK,QAAQ,IAAI,YAAW,CAAE,CAAC;EACjF,MAAM,YAAY,IAAI,IACpB,OAAO,QAAQ,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,IAAI,YAAW,GAAI,KAAK,CAAC,CAAC;EAE1E,KAAK,MAAM,OAAO,iBAAiB;GACjC,MAAM,QAAQ,UAAU,IAAI,GAAG;GAC/B,IAAI,CAAC,SAAS,IAAI,GAAG,KAAK,UAAU,KAAA,GAAW,YAAY,OAAO;EACpE;CACF;CACA,OAAO;AACT"}

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,SAAS,KAAK,EAAE,CAAM;gBAClC,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKhF;AACD,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,KAAK,EAAE,OAAO;CAG3B;AACD,qBAAa,cAAe,SAAQ,YAAY;IAE5C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ;gBAArC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAC9C,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,KAAK,EAAE,OAAO;CAIjB;AACD,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,iBAAiB,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO;CAGnE;AACD,qBAAa,mBAAoB,SAAQ,YAAY;IAEjD,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EAC1B,iBAAiB,EAAE,MAAM,GAAG,SAAS;CAIxC;AACD,qBAAa,gBAAiB,SAAQ,YAAY;IAE9C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM;gBADb,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAC3B,KAAK,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,GAAG,SAAS;CAIxC;AACD,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,iBAAiB,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAIvD;AACD,qBAAa,gBAAiB,SAAQ,YAAY;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe;gBAAvB,MAAM,EAAE,eAAe;CAI7C"}
+{"version":3,"file":"errors.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAe;AAEvE,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM;IACxC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM;IAC7C,QAAQ,CAAC,aAAa,EAAE,SAAS,KAAK,EAAE;gBAC5B,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;;AAMjF,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,KAAK,EAAE,OAAO;;AAI5B,qBAAa,cAAe,SAAQ,YAAY;IAE5C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ;gBAArC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAC9C,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,KAAK,EAAE,OAAO;;AAKlB,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,iBAAiB,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO;;AAIpE,qBAAa,mBAAoB,SAAQ,YAAY;IAEjD,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EAC1B,iBAAiB,EAAE,MAAM,GAAG,SAAS;;AAKzC,qBAAa,gBAAiB,SAAQ,YAAY;IAE9C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM;gBADb,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAC3B,KAAK,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,GAAG,SAAS;;AAKzC,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,iBAAiB,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;;AAKxD,qBAAa,gBAAiB,SAAQ,YAAY;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe;gBAAvB,MAAM,EAAE,eAAe","names":[],"ignoreList":[],"sources":["../src/errors.twill"]}

package/dist/errors.js

@@ -1,61 +1,65 @@
-export class ProcessError extends Error {
-    processIdentifier;
-    terminationStatus;
-    standardOutput;
-    standardError;
-    unresolvedProcessIdentifier;
-    cleanupErrors = [];
-    constructor(message, processIdentifier, options) {
-        super(message, options);
-        this.name = new.target.name;
-        this.processIdentifier = processIdentifier;
-    }
-}
-export class ProcessLaunchError extends ProcessError {
-    constructor(cause) {
-        super('Subprocess could not start', undefined, { cause });
-    }
-}
-export class ProcessIOError extends ProcessError {
-    stream;
-    constructor(stream, processIdentifier, cause) {
-        super(`Subprocess ${stream} failed`, processIdentifier, { cause });
-        this.stream = stream;
-    }
-}
-export class ProcessAbortError extends ProcessError {
-    constructor(processIdentifier, reason) {
-        super('Subprocess aborted', processIdentifier, { cause: reason });
-    }
-}
-export class ProcessTimeoutError extends ProcessError {
-    timeoutMs;
-    constructor(timeoutMs, processIdentifier) {
-        super('Subprocess timed out', processIdentifier);
-        this.timeoutMs = timeoutMs;
-    }
-}
-export class OutputLimitError extends ProcessError {
-    stream;
-    limit;
-    constructor(stream, limit, processIdentifier) {
-        super(`Subprocess ${stream} exceeded its byte limit`, processIdentifier);
-        this.stream = stream;
-        this.limit = limit;
-    }
-}
-export class ProcessTeardownError extends ProcessError {
-    constructor(processIdentifier, cause) {
-        super('Owned subprocess could not be terminated', processIdentifier, { cause });
-        Object.assign(this, { unresolvedProcessIdentifier: processIdentifier });
-    }
-}
-export class ProcessExitError extends ProcessError {
-    result;
-    constructor(result) {
-        super('Subprocess exited unsuccessfully', result.processIdentifier);
-        this.result = result;
-        Object.assign(this, result);
-    }
-}
+//#region src/errors.twill
+var ProcessError = class extends Error {
+	processIdentifier;
+	terminationStatus;
+	standardOutput;
+	standardError;
+	unresolvedProcessIdentifier;
+	cleanupErrors = [];
+	constructor(message, processIdentifier, options) {
+		super(message, options);
+		this.name = new.target.name;
+		this.processIdentifier = processIdentifier;
+	}
+};
+var ProcessLaunchError = class extends ProcessError {
+	constructor(cause) {
+		super("Subprocess could not start", void 0, { cause });
+	}
+};
+var ProcessIOError = class extends ProcessError {
+	stream;
+	constructor(stream, processIdentifier, cause) {
+		super(`Subprocess ${stream} failed`, processIdentifier, { cause });
+		this.stream = stream;
+	}
+};
+var ProcessAbortError = class extends ProcessError {
+	constructor(processIdentifier, reason) {
+		super("Subprocess aborted", processIdentifier, { cause: reason });
+	}
+};
+var ProcessTimeoutError = class extends ProcessError {
+	timeoutMs;
+	constructor(timeoutMs, processIdentifier) {
+		super("Subprocess timed out", processIdentifier);
+		this.timeoutMs = timeoutMs;
+	}
+};
+var OutputLimitError = class extends ProcessError {
+	stream;
+	limit;
+	constructor(stream, limit, processIdentifier) {
+		super(`Subprocess ${stream} exceeded its byte limit`, processIdentifier);
+		this.stream = stream;
+		this.limit = limit;
+	}
+};
+var ProcessTeardownError = class extends ProcessError {
+	constructor(processIdentifier, cause) {
+		super("Owned subprocess could not be terminated", processIdentifier, { cause });
+		Object.assign(this, { unresolvedProcessIdentifier: processIdentifier });
+	}
+};
+var ProcessExitError = class extends ProcessError {
+	result;
+	constructor(result) {
+		super("Subprocess exited unsuccessfully", result.processIdentifier);
+		this.result = result;
+		Object.assign(this, result);
+	}
+};
+//#endregion
+export { OutputLimitError, ProcessAbortError, ProcessError, ProcessExitError, ProcessIOError, ProcessLaunchError, ProcessTeardownError, ProcessTimeoutError };
+
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,iBAAiB,CAAU;IAC3B,iBAAiB,CAAqB;IACtC,cAAc,CAAmB;IACjC,aAAa,CAAmB;IAChC,2BAA2B,CAAU;IACrC,aAAa,GAAqB,EAAE,CAAC;IAC9C,YAAY,OAAe,EAAE,iBAA0B,EAAE,OAAsB;QAC7E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AACD,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,KAAc;QACxB,KAAK,CAAC,4BAA4B,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF;AACD,MAAM,OAAO,cAAe,SAAQ,YAAY;IAEnC;IADX,YACW,MAAqC,EAC9C,iBAAqC,EACrC,KAAc;QAEd,KAAK,CAAC,cAAc,MAAM,SAAS,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAJ1D,WAAM,GAAN,MAAM,CAA+B;IAKhD,CAAC;CACF;AACD,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD,YAAY,iBAAqC,EAAE,MAAe;QAChE,KAAK,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;CACF;AACD,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IAExC;IADX,YACW,SAAiB,EAC1B,iBAAqC;QAErC,KAAK,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;QAHxC,cAAS,GAAT,SAAS,CAAQ;IAI5B,CAAC;CACF;AACD,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAErC;IACA;IAFX,YACW,MAA2B,EAC3B,KAAa,EACtB,iBAAqC;QAErC,KAAK,CAAC,cAAc,MAAM,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;QAJhE,WAAM,GAAN,MAAM,CAAqB;QAC3B,UAAK,GAAL,KAAK,CAAQ;IAIxB,CAAC;CACF;AACD,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,iBAAyB,EAAE,KAAe;QACpD,KAAK,CAAC,0CAA0C,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF;AACD,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAC3B;IAArB,YAAqB,MAAuB;QAC1C,KAAK,CAAC,kCAAkC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;QADjD,WAAM,GAAN,MAAM,CAAiB;QAE1C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.twill"],"mappings":";AAEA,IAAa,eAAb,cAAkC,MAAK;CAC5B;CACA;CACA;CACA;CACA;CACA,gBAAkC,CAAA;CAC3C,YAAY,SAAiB,mBAA4B,SAAsB;EAC7E,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO,WAAW;EACvB,KAAK,oBAAoB;CAC3B;AACF;AACA,IAAa,qBAAb,cAAwC,aAAY;CAClD,YAAY,OAAc;EACxB,MAAM,8BAA8B,KAAA,GAAW,EAAE,MAAK,CAAE;CAC1D;AACF;AACA,IAAa,iBAAb,cAAoC,aAAY;CAEnC;CADX,YACW,QACT,mBACA,OAAc;EAEd,MAAM,cAAc,OAAM,UAAW,mBAAmB,EAAE,MAAK,CAAE;EAJxD,KAAA,SAAA;CAKX;AACF;AACA,IAAa,oBAAb,cAAuC,aAAY;CACjD,YAAY,mBAAuC,QAAe;EAChE,MAAM,sBAAsB,mBAAmB,EAAE,OAAO,OAAM,CAAE;CAClE;AACF;AACA,IAAa,sBAAb,cAAyC,aAAY;CAExC;CADX,YACW,WACT,mBAAqC;EAErC,MAAM,wBAAwB,iBAAiB;EAHtC,KAAA,YAAA;CAIX;AACF;AACA,IAAa,mBAAb,cAAsC,aAAY;CAErC;CACA;CAFX,YACW,QACA,OACT,mBAAqC;EAErC,MAAM,cAAc,OAAM,2BAA4B,iBAAiB;EAJ9D,KAAA,SAAA;EACA,KAAA,QAAA;CAIX;AACF;AACA,IAAa,uBAAb,cAA0C,aAAY;CACpD,YAAY,mBAA2B,OAAe;EACpD,MAAM,4CAA4C,mBAAmB,EAAE,MAAK,CAAE;EAC9E,OAAO,OAAO,MAAM,EAAE,6BAA6B,kBAAiB,CAAE;CACxE;AACF;AACA,IAAa,mBAAb,cAAsC,aAAY;CAC3B;CAArB,YAAqB,QAAuB;EAC1C,MAAM,oCAAoC,OAAO,iBAAiB;EAD/C,KAAA,SAAA;EAEnB,OAAO,OAAO,MAAM,MAAM;CAC5B;AACF"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type Command, type RunOptions, type OutputPolicy, type OutputValue, type InheritedOutput } from './values.js';
+import { Command, type OutputPolicy, type OutputValue, type RunOptions, type InheritedOutput } from './values.js';
 export { Command, Environment, Input, Output } from './values.js';
 export type { OutputPolicy, OutputValue, RunOptions, ProcessInput, InputPolicy, InheritedOutput, DiscardedOutput, TextOutput, ByteOutput, } from './values.js';
 export { ProcessError, ProcessLaunchError, ProcessAbortError, ProcessTimeoutError, ProcessExitError, ProcessIOError, OutputLimitError, ProcessTeardownError, } from './errors.js';
@@ -17,7 +17,7 @@ export interface ExecutionResult<O extends OutputPolicy = OutputPolicy, E extend
 }
 type ExactOptions<O> = O & Record<Exclude<keyof O, keyof RunOptions>, never>;
 type SelectedOutput<P> = Extract<P, OutputPolicy> | (undefined extends P ? InheritedOutput : never);
-declare function run<Options extends RunOptions = RunOptions<InheritedOutput, InheritedOutput>>(command: Command, options?: ExactOptions<Options>): Promise<ExecutionResult<SelectedOutput<Options['output']>, SelectedOutput<Options['error']>>>;
+declare function run<Options extends RunOptions = RunOptions<InheritedOutput, InheritedOutput>>(cmd: Command, options?: ExactOptions<Options>): Promise<ExecutionResult<SelectedOutput<Options['output']>, SelectedOutput<Options['error']>>>;
 export declare const Subprocess: Readonly<{
     run: typeof run;
 }>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAYrB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,eAAe,EACf,UAAU,EACV,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAC5E,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,YAAY,GAAG,YAAY;IAErC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACxC;AAED,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;AAC7E,KAAK,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,GAAG,eAAe,GAAG,KAAK,CAAC,CAAC;AASpG,iBAAS,GAAG,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,EACpF,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAY,CAAC,OAAO,CAAyC,GACrE,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAyJ/F;AACD,eAAO,MAAM,UAAU;;EAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","mappings":"AAMA,OAAO,EACL,OAAO,EAEP,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,aAAgB;AAWvB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAgB;AACpE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,eAAe,EACf,UAAU,EACV,UAAU,GACX,MAAM,aAAgB;AACvB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAgB;AAEvB,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM;CAAC,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM;CAAE;AAC3E,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,YAAY,GAAG,YAAY;IAErC,QAAQ,CAAC,iBAAiB,EAAE,MAAM;IAClC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB;IAC7C,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;;AA4CxC,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,UAAU,CAAC,EAAE,KAAK,CAAC;AAC5E,KAAK,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,GAAG,eAAe,GAAG,KAAK,CAAC;AACnG,iBAAS,GAAG,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,EACpF,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,YAAY,CAAC,OAAO,CAAyC,GACrE,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAuOhG,eAAO,MAAM,UAAU;;EAAyB","names":[],"ignoreList":[],"sources":["../src/index.twill"]}