release: @-xun/[email protected] [skip ci]

## ✨ Features

- **packages/run:** add `elideNodeDebuggerStringsFromStderr` option ([596a4ca][2])

## 🪄 Fixes

- **packages/run:** improve `runnerFactory` intellisense ([dd1e2c7][3])

## ⚙️ Build System

- **deps:** bump rejoinder from 1.2.4 to 1.2.5 ([e950bdc][4])
- **deps:** bump type-fest from 4.34.1 to 4.37.0 ([129df48][5])

[1]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
[2]: 596a4ca
[3]: dd1e2c7
[4]: e950bdc
[5]: 129df48

Author: Xunnamius

packages/run/CHANGELOG.md

@@ -6,43 +6,65 @@ this project adheres to [Semantic Versioning][2].
 
 <br />
 
-## @-xun/run[@1.0.0][3] (2025-02-16)
+## @-xun/run[@1.1.0][3] (2025-03-06)
 
 ### ✨ Features
 
-- **packages/run:** greatly improve exported types and debug output ([6bc3c2f][4])
+- **packages/run:** add `elideNodeDebuggerStringsFromStderr` option ([596a4ca][4])
+
+### 🪄 Fixes
+
+- **packages/run:** improve `runnerFactory` intellisense ([dd1e2c7][5])
+
+### ⚙️ Build System
+
+- **deps:** bump rejoinder from 1.2.4 to 1.2.5 ([e950bdc][6])
+- **deps:** bump type-fest from 4.34.1 to 4.37.0 ([129df48][7])
+
+<br />
+
+## @-xun/run[@1.0.0][8] (2025-02-16)
+
+### ✨ Features
+
+- **packages/run:** greatly improve exported types and debug output ([6bc3c2f][9])
 
 <br />
 
-### 🏗️ Patch @-xun/run[@1.0.3][5] (2025-02-22)
+### 🏗️ Patch @-xun/run[@1.0.3][10] (2025-02-22)
 
 #### 🪄 Fixes
 
-- **packages/run:** ensure `runWithInheritedIo` inherits all io file descriptors ([3ca5d5a][6])
+- **packages/run:** ensure `runWithInheritedIo` inherits all io file descriptors ([3ca5d5a][11])
 
 <br />
 
-### 🏗️ Patch @-xun/run[@1.0.2][7] (2025-02-18)
+### 🏗️ Patch @-xun/run[@1.0.2][12] (2025-02-18)
 
 #### 🪄 Fixes
 
-- **packages/run:** account for generic parameters; simplify type logic ([0673591][8])
+- **packages/run:** account for generic parameters; simplify type logic ([0673591][13])
 
 <br />
 
-### 🏗️ Patch @-xun/run[@1.0.1][9] (2025-02-17)
+### 🏗️ Patch @-xun/run[@1.0.1][14] (2025-02-17)
 
 #### 🪄 Fixes
 
-- Improve types and intellisense, ensure functionality matches documentation ([99f80c9][10])
+- Improve types and intellisense, ensure functionality matches documentation ([99f80c9][15])
 
 [1]: https://conventionalcommits.org
 [2]: https://semver.org
-[3]: https://github.com/Xunnamius/exec-utils/compare/6bc3c2f64e318fb45aac40a5534d0b575a57f170...@-xun/[email protected]
-[4]: https://github.com/Xunnamius/exec-utils/commit/6bc3c2f64e318fb45aac40a5534d0b575a57f170
-[5]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
-[6]: https://github.com/Xunnamius/exec-utils/commit/3ca5d5a48edf233b2c3f06a5558c6dca408bd366
-[7]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
-[8]: https://github.com/Xunnamius/exec-utils/commit/06735914ae278783fb4ee6a4cc1a3732191459ee
-[9]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
-[10]: https://github.com/Xunnamius/exec-utils/commit/99f80c9423153055098aa3bf7b6f903f3ee1b65f
+[3]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
+[4]: https://github.com/Xunnamius/exec-utils/commit/596a4ca63a2b17b0a8e1d7467f14581cfd100d5d
+[5]: https://github.com/Xunnamius/exec-utils/commit/dd1e2c7feb508649e5b5164f882176380432901f
+[6]: https://github.com/Xunnamius/exec-utils/commit/e950bdc88246d4df68cb4e148b36441b3b936f55
+[7]: https://github.com/Xunnamius/exec-utils/commit/129df486660f117039b2de4cd8ed17bd7f5a2f35
+[8]: https://github.com/Xunnamius/exec-utils/compare/6bc3c2f64e318fb45aac40a5534d0b575a57f170...@-xun/[email protected]
+[9]: https://github.com/Xunnamius/exec-utils/commit/6bc3c2f64e318fb45aac40a5534d0b575a57f170
+[10]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
+[11]: https://github.com/Xunnamius/exec-utils/commit/3ca5d5a48edf233b2c3f06a5558c6dca408bd366
+[12]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
+[13]: https://github.com/Xunnamius/exec-utils/commit/06735914ae278783fb4ee6a4cc1a3732191459ee
+[14]: https://github.com/Xunnamius/exec-utils/compare/@-xun/[email protected]...@-xun/[email protected]
+[15]: https://github.com/Xunnamius/exec-utils/commit/99f80c9423153055098aa3bf7b6f903f3ee1b65f

packages/run/docs/constant/variables/globalDebuggerNamespace.md

@@ -8,6 +8,6 @@
 
 > `const` **globalDebuggerNamespace**: `"xrun"` = `'xrun'`
 
-Defined in: [packages/run/src/constant.ts:4](https://github.com/Xunnamius/exec-utils/blob/bf5e65a2582e7e8aeaba89dc9f922437cbff4809/packages/run/src/constant.ts#L4)
+Defined in: [packages/run/src/constant.ts:4](https://github.com/Xunnamius/exec-utils/blob/49a686926412eee8a176a3c8893c62abf78eaebf/packages/run/src/constant.ts#L4)
 
 The project-wide namespace that appears in debugger output.

packages/run/docs/index/README.md

@@ -31,6 +31,12 @@ Re-exports [RunIntermediateReturnType](../types/type-aliases/RunIntermediateRetu
 
 ***
 
+### RunnerFactoryReturnType
+
+Re-exports [RunnerFactoryReturnType](../types/type-aliases/RunnerFactoryReturnType.md)
+
+***
+
 ### RunOptions
 
 Re-exports [RunOptions](../types/type-aliases/RunOptions.md)

packages/run/docs/index/functions/run.md

@@ -10,7 +10,7 @@
 
 > **run**(`file`, `args`?, `options`?): `Promise`\<\{ `all`: `undefined`; `cause`: `unknown`; `code`: `undefined` \| `string`; `command`: `string`; `cwd`: `string`; `durationMs`: `number`; `escapedCommand`: `string`; `exitCode`: `number`; `failed`: `boolean`; `ipcOutput`: \[\] \| (`null` \| `string` \| `number` \| `boolean` \| `object` \| readonly `JsonMessage`[] \| \{\})[]; `isCanceled`: `boolean`; `isForcefullyTerminated`: `boolean`; `isGracefullyCanceled`: `boolean`; `isMaxBuffer`: `boolean`; `isTerminated`: `boolean`; `message`: `undefined` \| `string`; `name`: `undefined` \| `string`; `originalMessage`: `undefined` \| `string`; `pipedFrom`: `Result`\<`Options`\>[]; `shortMessage`: `undefined` \| `string`; `signal`: `Signals`; `signalDescription`: `string`; `stack`: `undefined` \| `string`; `stderr`: `string`; `stdio`: `MapResultStdio`\<readonly \[`StdinOptionCommon`\<`false`, `false`\>, `StdoutStderrOptionCommon`\<`false`, `false`\>, `StdoutStderrOptionCommon`\<`false`, `false`\>, `StdioExtraOptionCommon`\<`false`\>\] \| readonly \[`undefined`, `undefined`, `undefined`\] \| readonly \[`"pipe"`, `"pipe"`, `"pipe"`\] \| readonly \[`"inherit"`, `"inherit"`, `"inherit"`\] \| readonly \[`"ignore"`, `"ignore"`, `"ignore"`\] \| readonly \[`"overlapped"`, `"overlapped"`, `"overlapped"`\]\>; `stdout`: `string`; `timedOut`: `boolean`; \}\>
 
-Defined in: [packages/run/src/index.ts:31](https://github.com/Xunnamius/exec-utils/blob/bf5e65a2582e7e8aeaba89dc9f922437cbff4809/packages/run/src/index.ts#L31)
+Defined in: [packages/run/src/index.ts:40](https://github.com/Xunnamius/exec-utils/blob/49a686926412eee8a176a3c8893c62abf78eaebf/packages/run/src/index.ts#L40)
 
 Runs (executes) `file` with the given `args` with respect to the given
 `options`.
@@ -23,6 +23,9 @@ Note that, by default, this function:
 2. Coerces output to a string. Set `coerceOutputToString: false` (or `lines:
    true`) to override this.
 
+3. Elides Node.js debugger strings. Set `elideNodeDebuggerStringsFromStderr:
+   false` to override this.
+
 ### Parameters
 
 #### file
@@ -43,9 +46,9 @@ Note that, by default, this function:
 
 ## Call Signature
 
-> **run**\<`OptionsType`\>(`file`, `args`?, `options`?): `Promise`\<\{ \[KeyType in string \| number \| symbol\]: (\[\{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<OptionsType\> & \{ \[Key in (keyof Options) \| "useIntermediate" \| "coerceOutputToString" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<OptionsType\>)\[KeyType\] \}\] extends \[ReifiedOptionsType\] ? ReifiedOptionsType extends \{ lines: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\> & \{ \[Key in "stdout" \| "stderr" \| "all" \| "cwd" \| "stdio" \| "name" \| "message" \| "stack" \| "cause" \| "shortMessage" \| "originalMessage" \| "code" \| "ipcOutput" \| "pipedFrom" \| "command" \| "escapedCommand" \| "durationMs" \| "failed" \| "timedOut" \| "isCanceled" \| "isGracefullyCanceled" \| "isMaxBuffer" \| "isTerminated" \| "isForcefullyTerminated" \| "exitCode" \| "signal" \| "signalDescription" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\>)\[KeyType\] \} : ReifiedOptionsType extends \{ coerceOutputToString: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<(...) & (...)\> & \{ \[Key in (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) as (...) extends (...) ? (...) : (...)\]: (...)\[(...)\] \} & OmitIndexSignature\<(...) & (...)\>)\[KeyType\] \} : Result\<ReifiedOptionsType\> : never)\[KeyType\] \}\>
+> **run**\<`OptionsType`\>(`file`, `args`?, `options`?): `Promise`\<\{ \[KeyType in string \| number \| symbol\]: (\[\{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<OptionsType\> & \{ \[Key in (keyof Options) \| "useIntermediate" \| "coerceOutputToString" \| "elideNodeDebuggerStringsFromStderr" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<OptionsType\>)\[KeyType\] \}\] extends \[ReifiedOptionsType\] ? ReifiedOptionsType extends \{ lines: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\> & \{ \[Key in "stdout" \| "stderr" \| "all" \| "cwd" \| "stdio" \| "name" \| "message" \| "stack" \| "cause" \| "shortMessage" \| "originalMessage" \| "code" \| "ipcOutput" \| "pipedFrom" \| "command" \| "escapedCommand" \| "durationMs" \| "failed" \| "timedOut" \| "isCanceled" \| "isGracefullyCanceled" \| "isMaxBuffer" \| "isTerminated" \| "isForcefullyTerminated" \| "exitCode" \| "signal" \| "signalDescription" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\>)\[KeyType\] \} : ReifiedOptionsType extends \{ coerceOutputToString: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<(...) & (...)\> & \{ \[Key in (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) as (...) extends (...) ? (...) : (...)\]: (...)\[(...)\] \} & OmitIndexSignature\<(...) & (...)\>)\[KeyType\] \} : Result\<ReifiedOptionsType\> : never)\[KeyType\] \}\>
 
-Defined in: [packages/run/src/index.ts:36](https://github.com/Xunnamius/exec-utils/blob/bf5e65a2582e7e8aeaba89dc9f922437cbff4809/packages/run/src/index.ts#L36)
+Defined in: [packages/run/src/index.ts:45](https://github.com/Xunnamius/exec-utils/blob/49a686926412eee8a176a3c8893c62abf78eaebf/packages/run/src/index.ts#L45)
 
 Runs (executes) `file` with the given `args` with respect to the given
 `options`.
@@ -58,6 +61,9 @@ Note that, by default, this function:
 2. Coerces output to a string. Set `coerceOutputToString: false` (or `lines:
    true`) to override this.
 
+3. Elides Node.js debugger strings. Set `elideNodeDebuggerStringsFromStderr:
+   false` to override this.
+
 ### Type Parameters
 
 • **OptionsType** *extends* [`RunOptions`](../../types/type-aliases/RunOptions.md)
@@ -78,4 +84,4 @@ Note that, by default, this function:
 
 ### Returns
 
-`Promise`\<\{ \[KeyType in string \| number \| symbol\]: (\[\{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<OptionsType\> & \{ \[Key in (keyof Options) \| "useIntermediate" \| "coerceOutputToString" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<OptionsType\>)\[KeyType\] \}\] extends \[ReifiedOptionsType\] ? ReifiedOptionsType extends \{ lines: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\> & \{ \[Key in "stdout" \| "stderr" \| "all" \| "cwd" \| "stdio" \| "name" \| "message" \| "stack" \| "cause" \| "shortMessage" \| "originalMessage" \| "code" \| "ipcOutput" \| "pipedFrom" \| "command" \| "escapedCommand" \| "durationMs" \| "failed" \| "timedOut" \| "isCanceled" \| "isGracefullyCanceled" \| "isMaxBuffer" \| "isTerminated" \| "isForcefullyTerminated" \| "exitCode" \| "signal" \| "signalDescription" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\>)\[KeyType\] \} : ReifiedOptionsType extends \{ coerceOutputToString: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<(...) & (...)\> & \{ \[Key in (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) as (...) extends (...) ? (...) : (...)\]: (...)\[(...)\] \} & OmitIndexSignature\<(...) & (...)\>)\[KeyType\] \} : Result\<ReifiedOptionsType\> : never)\[KeyType\] \}\>
+`Promise`\<\{ \[KeyType in string \| number \| symbol\]: (\[\{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<OptionsType\> & \{ \[Key in (keyof Options) \| "useIntermediate" \| "coerceOutputToString" \| "elideNodeDebuggerStringsFromStderr" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<OptionsType\>)\[KeyType\] \}\] extends \[ReifiedOptionsType\] ? ReifiedOptionsType extends \{ lines: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\> & \{ \[Key in "stdout" \| "stderr" \| "all" \| "cwd" \| "stdio" \| "name" \| "message" \| "stack" \| "cause" \| "shortMessage" \| "originalMessage" \| "code" \| "ipcOutput" \| "pipedFrom" \| "command" \| "escapedCommand" \| "durationMs" \| "failed" \| "timedOut" \| "isCanceled" \| "isGracefullyCanceled" \| "isMaxBuffer" \| "isTerminated" \| "isForcefullyTerminated" \| "exitCode" \| "signal" \| "signalDescription" as Key extends keyof (...) ? never : Key\]: OmitIndexSignature\<(...)\>\[Key\] \} & OmitIndexSignature\<\{ stderr: ...; stdout: ... \} & ((...) extends (...) ? (...) : (...))\>)\[KeyType\] \} : ReifiedOptionsType extends \{ coerceOutputToString: true \} ? \{ \[KeyType in string \| number \| symbol\]: (\{\} & PickIndexSignature\<(...) & (...)\> & \{ \[Key in (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) \| (...) as (...) extends (...) ? (...) : (...)\]: (...)\[(...)\] \} & OmitIndexSignature\<(...) & (...)\>)\[KeyType\] \} : Result\<ReifiedOptionsType\> : never)\[KeyType\] \}\>