@swiftuijs/twill-shell 0.3.1 → 0.4.0

package/README.md

@@ -1,5 +1,10 @@
 # <img src="https://twill.evecalm.com/logo.png" alt="Twill hummingbird" align="right" width="40" height="40" /> Twill shell
 
+[![npm version](https://img.shields.io/npm/v/%40swiftuijs%2Ftwill-shell)](https://www.npmjs.com/package/@swiftuijs/twill-shell)
+[![npm monthly downloads](https://img.shields.io/npm/dm/%40swiftuijs%2Ftwill-shell)](https://www.npmjs.com/package/@swiftuijs/twill-shell)
+[![CI](https://img.shields.io/github/actions/workflow/status/swiftuijs/twill/ci.yml?branch=main&label=CI)](https://github.com/swiftuijs/twill/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/%40swiftuijs%2Ftwill-shell)](https://github.com/swiftuijs/twill/blob/main/LICENSE)
+
 Swift-inspired subprocess tools for Twill and ordinary Node JS/TS scripts, Node-based in 0.3.0.
 
 ## Install in your project
@@ -7,10 +12,10 @@ Swift-inspired subprocess tools for Twill and ordinary Node JS/TS scripts, Node-
 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@0.3.1
+npm install @swiftuijs/twill-shell@0.4.0
 ```
 
-With pnpm, use `pnpm add @swiftuijs/twill-shell@0.3.1`. 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.
+With pnpm, use `pnpm add @swiftuijs/twill-shell@0.4.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
 
@@ -37,8 +42,8 @@ Run `node command.mjs`. Expected output is `Hello from a child process`. This wo
 Install the compiler as well:
 
 ```sh
-npm install --save-dev @swiftuijs/twill@0.3.1
-# pnpm add -D @swiftuijs/twill@0.3.1
+npm install --save-dev @swiftuijs/twill@0.4.0
+# pnpm add -D @swiftuijs/twill@0.4.0
 ```
 
 Copy the JavaScript example to `command.twill` and add `#!/usr/bin/env twill` as its first line. Use the local command:
@@ -48,7 +53,7 @@ npm exec -- twill command.twill
 # pnpm exec twill command.twill
 ```
 
-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.1` 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.
+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.4.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.
 

package/dist/cwd.js

@@ -1,9 +1,8 @@
 import { isAbsolute, win32 } from "node:path";
-//#region src/cwd.twill
+// 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/environment.js

@@ -1,5 +1,5 @@
 import { childEnvironment } from "./values.js";
-//#region src/environment.twill
+// src/environment.twill
 var windowsRequired = [
 	"HOMEDRIVE",
 	"HOMEPATH",
@@ -26,7 +26,6 @@ function environmentSnapshot(policy, platform = process.platform, parent = proce
 	}
 	return environment;
 }
-//#endregion
 export { environmentSnapshot };
 
 //# sourceMappingURL=environment.js.map

package/dist/errors.js

@@ -1,4 +1,4 @@
-//#region src/errors.twill
+// src/errors.twill
 var ProcessError = class extends Error {
 	processIdentifier;
 	terminationStatus;
@@ -59,7 +59,6 @@ var ProcessExitError = class extends ProcessError {
 		Object.assign(this, result);
 	}
 };
-//#endregion
 export { OutputLimitError, ProcessAbortError, ProcessError, ProcessExitError, ProcessIOError, ProcessLaunchError, ProcessTeardownError, ProcessTimeoutError };
 
 //# sourceMappingURL=errors.js.map

package/dist/index.js

@@ -1,11 +1,11 @@
 import { cwdSnapshot } from "./cwd.js";
-import { Command, Environment, Input, Output, settings } from "./values.js";
 import { environmentSnapshot } from "./environment.js";
+import { Command, Environment, Input, Output, settings } from "./values.js";
 import { OutputLimitError, ProcessAbortError, ProcessError, ProcessExitError, ProcessIOError, ProcessLaunchError, ProcessTeardownError, ProcessTimeoutError } from "./errors.js";
 import childProcess from "node:child_process";
 import { performance } from "node:perf_hooks";
 import { addAbortListener } from "node:events";
-//#region src/index.twill
+// src/index.twill
 var Capture = class {
 	reader;
 	policy;
@@ -218,7 +218,6 @@ function run(cmd, options = emptyOptions) {
 	});
 }
 var Subprocess = Object.freeze({ run });
-//#endregion
 export { Command, Environment, Input, Output, OutputLimitError, ProcessAbortError, ProcessError, ProcessExitError, ProcessIOError, ProcessLaunchError, ProcessTeardownError, ProcessTimeoutError, Subprocess };
 
 //# sourceMappingURL=index.js.map

package/dist/values.js

@@ -1,6 +1,6 @@
 import { isAbsolute } from "node:path";
 import { constants } from "node:buffer";
-//#region src/values.twill
+// src/values.twill
 var commandBrand = Symbol.for("@swiftuijs/twill-shell/command/v1");
 var environmentBrand = Symbol.for("@swiftuijs/twill-shell/environment/v1");
 var outputBrand = Symbol.for("@swiftuijs/twill-shell/output/v1");
@@ -170,7 +170,6 @@ function childEnvironment(policy, platform = process.platform) {
 	else env[key] = value;
 	return env;
 }
-//#endregion
 export { Command, Environment, Input, Output, childEnvironment, settings };
 
 //# sourceMappingURL=values.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swiftuijs/twill-shell",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Swift-inspired subprocess toolkit for Twill and native Node scripts: explicit arguments, bounded output and owned teardown.",
   "type": "module",
   "license": "MIT",
@@ -37,10 +37,10 @@
     "vitest": "^5.0.3",
     "@vitest/coverage-v8": "^5.0.3",
     "prettier": "^3.9.9",
-    "vite": "^8.3.2",
-    "@swiftuijs/twill-formatter": "0.3.1",
-    "@swiftuijs/twill": "0.3.1",
-    "@swiftuijs/twill-export": "0.3.1"
+    "vite": "^8.3.5",
+    "@swiftuijs/twill-formatter": "0.4.0",
+    "@swiftuijs/twill": "0.4.0",
+    "@swiftuijs/twill-export": "0.4.0"
   },
   "author": {
     "name": "forth.ink",