@bleedingdev/modern-js-utils 3.9.3-ultramodern.6 → 3.9.3-ultramodern.8

package/dist/compiled/dotenv-expand/licenses-cjs.txt

@@ -1,17 +1,22 @@
 dotenv-expand
-BSD-2-Clause
+BSD-3-Clause
+BSD 3-Clause License
+
 Copyright (c) 2016, Scott Motte
-All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:
 
-* Redistributions of source code must retain the above copyright notice, this
-  list of conditions and the following disclaimer.
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
 
-* Redistributions in binary form must reproduce the above copyright notice,
-  this list of conditions and the following disclaimer in the documentation
-  and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

package/dist/compiled/dotenv-expand/package.json

@@ -1 +1 @@
-{"name":"dotenv-expand","author":"motdotla","version":"13.0.0","funding":"https://dotenvx.com","license":"BSD-2-Clause","types":"index.d.ts"}
+{"name":"dotenv-expand","author":"motdotla","version":"1000.0.0","funding":"https://dotenvx.com","license":"BSD-3-Clause","types":"index.d.ts"}

package/dist/compiled/dotenv-expand/provenance.json

@@ -1,12 +1,12 @@
 {
   "name": "dotenv-expand",
   "sourceName": "dotenv-expand",
-  "version": "13.0.0",
-  "entrySha256": "64fdc611ea529ebc566910b2791cf5f059c3a08ac23005884a8c095dbffffc4d",
-  "license": "BSD-2-Clause",
+  "version": "1000.0.0",
+  "entrySha256": "332a3969578532906a92863856031fc6c2eaa60be9a31906cb8662f8526071d8",
+  "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
-    "url": "https://github.com/motdotla/dotenv-expand"
+    "url": "git+https://github.com/dotenvx/dotenv-expand.git"
   },
   "producer": "scripts/prebundle",
   "ncc": "0.45.0",
@@ -14,9 +14,9 @@
   "declarationSources": [
     {
       "name": "dotenv-expand",
-      "version": "13.0.0",
-      "license": "BSD-2-Clause"
+      "version": "1000.0.0",
+      "license": "BSD-3-Clause"
     }
   ],
-  "lockfileSha256": "486928a3a1b80a640cc67d3eeba705a259b639085fe1299dd4f566602b51ede6"
+  "lockfileSha256": "581051621a0801558eea756bc6ec0f69d769c47dae2513e61f5cf51555720121"
 }

package/dist/compiled/execa/index.d.mts

@@ -428,26 +428,30 @@ type IpcMethods<
 		getEachMessage: undefined;
 	};
 
-// Whether IPC is enabled, based on the `ipc`, `ipcInput` and `gracefulCancel` options
+// Whether IPC is enabled, based on the `ipc`, `node`, `ipcInput` and `gracefulCancel` options
 type HasIpc<OptionsType extends Options> = HasIpcOption<
 	OptionsType['ipc'],
+	'node' extends keyof OptionsType ? OptionsType['node'] : undefined,
 	'ipcInput' extends keyof OptionsType ? OptionsType['ipcInput'] : undefined,
 	'gracefulCancel' extends keyof OptionsType ? OptionsType['gracefulCancel'] : undefined
 >;
 
 type HasIpcOption<
 	IpcOption extends Options['ipc'],
+	NodeOption extends Options['node'],
 	IpcInputOption extends Options['ipcInput'],
 	GracefulCancelOption extends Options['gracefulCancel'],
 > = IpcOption extends true
 	? true
 	: IpcOption extends false
 		? false
-		: IpcInputOption extends undefined
-			? GracefulCancelOption extends true
-				? true
-				: false
-			: true;
+		: NodeOption extends true
+			? true
+			: IpcInputOption extends undefined
+				? GracefulCancelOption extends true
+					? true
+					: false
+				: true;
 
 type FileDescriptorOption = `fd${number}`;
 
@@ -781,11 +785,16 @@ type AllLinesFd<OptionsType extends CommonOptions> =
 	FdSpecificOption<OptionsType['lines'], '1'> extends true ? '1' : '2';
 
 // `result.stdio`
-type ResultStdioArray<OptionsType extends CommonOptions> =
-	MapResultStdio<StdioOptionNormalizedArray<OptionsType>, OptionsType>;
+type ResultStdioArray<
+	IsSync extends boolean,
+	OptionsType extends CommonOptions,
+> = [
+	...MapResultStdio<StdioOptionNormalizedArray<OptionsType>, OptionsType>,
+	...ResultIpcStdio<IsSync, OptionsType>,
+];
 
 type MapResultStdio<
-	StdioOptionsArrayType,
+	StdioOptionsArrayType extends readonly unknown[],
 	OptionsType extends CommonOptions,
 > = {
 	-readonly [FdNumber in keyof StdioOptionsArrayType]: ResultStdioNotAll<
@@ -794,6 +803,16 @@ type MapResultStdio<
 	>
 };
 
+// With the `ipc` option, the subprocess' IPC channel adds one last file descriptor, which has no output. Synchronous methods do not support IPC.
+type ResultIpcStdio<
+	IsSync extends boolean,
+	OptionsType extends CommonOptions,
+> = IsSync extends true
+	? []
+	: HasIpc<StricterOptions<OptionsType, Options>> extends true
+		? [undefined]
+		: [];
+
 // `result.ipcOutput`
 // This is empty unless the `ipc` option is `true`.
 // Also, this is empty if the `buffer` option is `false`.
@@ -845,7 +864,7 @@ declare abstract class CommonResult<
 
 	This requires the `all` option to be `true`.
 
-	This is `undefined` if both `stdout` and `stderr` options are set to only `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+	This is `undefined` if both `stdout` and `stderr` options are set to only `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false` for both.
 
 	This is an array if the `lines` option is `true`, or if either the `stdout` or `stderr` option is a transform in object mode.
 	*/
@@ -856,9 +875,11 @@ declare abstract class CommonResult<
 
 	Items are `undefined` when their corresponding `stdio` option is set to only `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
 
+	With the `ipc` option, the last item is the subprocess' IPC channel, which is always `undefined`.
+
 	Items are arrays when their corresponding `stdio` option is a transform in object mode.
 	*/
-	stdio: ResultStdioArray<OptionsType>;
+	stdio: ResultStdioArray<IsSync, OptionsType>;
 
 	/**
 	All the messages sent by the subprocess to the current process.
@@ -872,7 +893,7 @@ declare abstract class CommonResult<
 
 	This array is initially empty and is populated each time the `subprocess.pipe()` method resolves.
 	*/
-	pipedFrom: Unless<IsSync, Result[], []>;
+	pipedFrom: Unless<IsSync, Array<Result | ExecaError>, []>;
 
 	/**
 	The file and arguments that were run.
@@ -881,6 +902,8 @@ declare abstract class CommonResult<
 
 	/**
 	Same as `command` but escaped.
+
+	With the `shell` option, the command is not quoted, since the shell interprets it.
 	*/
 	escapedCommand: string;
 
@@ -1037,7 +1060,7 @@ type GenericVerboseObject = {
 	- `'output'`: one line from `result.stdout` or `result.stderr`
 	- `'ipc'`: one IPC message from `result.ipcOutput`
 	- `'error'`: the `error.shortMessage`
-	- `'duration'`: the `result.durationMs`
+	- `'duration'`: the `result.durationMs`, formatted as `(done in 29ms)`
 	*/
 	message: string;
 
@@ -1061,7 +1084,7 @@ type GenericVerboseObject = {
 	timestamp: Date;
 
 	/**
-	Whether another subprocess is piped into this subprocess. This is `false` when `result.pipedFrom` is empty.
+	Whether this subprocess is the destination of another subprocess' `pipe()` method. This is `true` when it was spawned using the template string or array syntax of `pipe()`, `false` otherwise.
 	*/
 	piped: boolean;
 };
@@ -1178,13 +1201,13 @@ type CommonOptions<
 
 	Unless the `extendEnv` option is `false`, the subprocess also uses the current process' environment variables ([`process.env`](https://nodejs.org/api/process.html#processenv)).
 
-	@default [process.env](https://nodejs.org/api/process.html#processenv)
+	@default {}
 	*/
 	readonly env?: Readonly<Partial<Record<string, string>>>;
 
 	/**
 	If `true`, the subprocess uses both the `env` option and the current process' environment variables ([`process.env`](https://nodejs.org/api/process.html#processenv)).
-	If `false`, only the `env` option is used, not `process.env`.
+	If `false`, only the `env` option is used, not `process.env`. However, when `env` has no `PATH`, the `preferLocal` and `node` options still add their directories to `process.env.PATH`.
 
 	@default true
 	*/
@@ -1258,6 +1281,8 @@ type CommonOptions<
 
 	The output is available with `result.stdout`, `result.stderr` and `result.stdio`.
 
+	String input passed with the `input` or `stdin` option is always encoded with UTF-8, whatever this option is. With a text encoding, `stdin` transforms also decode their input with UTF-8.
+
 	@default 'utf8'
 	*/
 	readonly encoding?: Encoding;
@@ -1289,6 +1314,8 @@ type CommonOptions<
 
 	By default, this applies to both `stdout` and `stderr`, but different values can also be passed.
 
+	With synchronous methods, this cannot be enforced per file descriptor while the subprocess runs, since `spawnSync()` only accepts a single value, which limits the total output of all file descriptors. The `maxBuffer.stdout` value is used for it. The other file descriptors' own values are enforced from the output, once the subprocess ended, and cannot be higher than `maxBuffer.stdout`. Also, with synchronous methods, this is measured in bytes instead of characters or lines, for the same reason.
+
 	When reached, `error.isMaxBuffer` becomes `true`.
 
 	@default 100_000_000
@@ -1348,7 +1375,7 @@ type CommonOptions<
 	readonly reject?: boolean;
 
 	/**
-	If `timeout` is greater than `0`, the subprocess will be terminated if it runs for longer than that amount of milliseconds.
+	If `timeout` is greater than `0`, the subprocess will be terminated if it runs for longer than that amount of milliseconds. It must be a non-negative integer, up to `2147483647` (about 24.8 days).
 
 	On timeout, `error.timedOut` becomes `true`.
 
@@ -1397,7 +1424,7 @@ type CommonOptions<
 	readonly gracefulCancel?: Unless<IsSync, boolean>;
 
 	/**
-	If the subprocess is terminated but does not exit, forcefully exit it by sending [`SIGKILL`](https://en.wikipedia.org/wiki/Signal_(IPC)#SIGKILL).
+	If the subprocess is terminated but does not exit, forcefully exit it by sending [`SIGKILL`](https://en.wikipedia.org/wiki/Signal_(IPC)#SIGKILL). The delay must be a non-negative integer, up to `2147483647` milliseconds (about 24.8 days). When `true`, the default `5000` is used. When `false`, the subprocess is not forcefully exited.
 
 	When this happens, `error.isForcefullyTerminated` becomes `true`.
 
@@ -1435,7 +1462,7 @@ type CommonOptions<
 
 	On Unix, this spawns the subprocess in its own [process group](https://en.wikipedia.org/wiki/Process_group). On Windows, this uses [`taskkill`](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/taskkill).
 
-	This is best-effort: descendant processes that create their own process group or session are not terminated.
+	This is best-effort: descendant processes that create their own process group or session are not terminated. Also, on Windows, descendants are not terminated once the subprocess exited, since its PID might then belong to an unrelated process.
 
 	@default false
 	*/
@@ -1675,16 +1702,18 @@ type InputOutputStream<IsInput extends boolean> = IsInput extends true
 // `subprocess.stdio`
 type SubprocessStdioArray<OptionsType extends Options> = MapStdioStreams<StdioOptionNormalizedArray<OptionsType>, OptionsType>;
 
-// We cannot use mapped types because it must be compatible with Node.js `ChildProcess["stdio"]` which uses a tuple with exactly 5 items
+// File descriptors beyond `stderr` are only present when the `stdio` option is an array with more items.
+// The subprocess' IPC channel, if any, is set as the last file descriptor by Node.js itself.
+// Since any `Subprocess` can be passed where the default one is expected, the list is kept open-ended.
 type MapStdioStreams<
-	StdioOptionsArrayType,
+	StdioOptionsArrayType extends readonly unknown[],
 	OptionsType extends Options,
 > = [
-	SubprocessStdioStream<'0', OptionsType>,
-	SubprocessStdioStream<'1', OptionsType>,
-	SubprocessStdioStream<'2', OptionsType>,
-	'3' extends keyof StdioOptionsArrayType ? SubprocessStdioStream<'3', OptionsType> : never,
-	'4' extends keyof StdioOptionsArrayType ? SubprocessStdioStream<'4', OptionsType> : never,
+	...{
+		-readonly [FdNumber in keyof StdioOptionsArrayType]: SubprocessStdioStream<FdNumber extends string ? FdNumber : string, OptionsType>
+	},
+	...(HasIpc<OptionsType> extends true ? [null] : []),
+	...Array<Readable | Writable | null>,
 ];
 
 // `subprocess.all`
@@ -1710,7 +1739,7 @@ type SubprocessResultMethods<OptionsType extends Options = Options> = {
 
 	This requires the `all` option to be `true`.
 
-	This is `undefined` if `stdout` and `stderr` options are set to `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+	This is `undefined` if both `stdout` and `stderr` options are set to `'inherit'`, `'ignore'`, `Writable` or `integer`.
 	*/
 	all: SubprocessAll<OptionsType>;
 
@@ -1757,21 +1786,23 @@ type ExecaCustomSubprocess<OptionsType extends Options> =
 		/**
 		The subprocess [`stdout`](https://en.wikipedia.org/wiki/Standard_streams#Standard_output_(stdout)) as a stream.
 
-		This is `null` if the `stdout` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+		This is `null` if the `stdout` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`.
 		*/
 		stdout: SubprocessStdioStream<'1', OptionsType>;
 
 		/**
 		The subprocess [`stderr`](https://en.wikipedia.org/wiki/Standard_streams#Standard_error_(stderr)) as a stream.
 
-		This is `null` if the `stderr` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+		This is `null` if the `stderr` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`.
 		*/
 		stderr: SubprocessStdioStream<'2', OptionsType>;
 
 		/**
 		The subprocess `stdin`, `stdout`, `stderr` and other files descriptors as an array of streams.
 
-		Each array item is `null` if the corresponding `stdin`, `stdout`, `stderr` or `stdio` option is set to `'inherit'`, `'ignore'`, `Stream` or `integer`, or if the `buffer` option is `false`.
+		Each array item is `null` if the corresponding `stdin`, `stdout`, `stderr` or `stdio` option is set to `'inherit'`, `'ignore'`, `Stream` or `integer`.
+
+		With the `ipc` option, the last item is the subprocess' IPC channel, which is always `null`.
 		*/
 		stdio: SubprocessStdioArray<OptionsType>;
 
@@ -2435,17 +2466,20 @@ type ExecaNodeBind<OptionsType extends Options> =
 // `execaNode`command`` template syntax
 type ExecaNodeTemplate<OptionsType extends Options> =
 	(...templateString: TemplateString)
-	=> ResultPromise<OptionsType>;
+	=> ResultPromise<NodeOptions<OptionsType>>;
 
 // `execaNode('script', ['argument'], {})` array syntax
 type ExecaNodeArrayLong<OptionsType extends Options> =
 	<NewOptionsType extends Options = {}>(scriptPath: string | URL, arguments?: readonly string[], options?: NewOptionsType)
-	=> ResultPromise<OptionsType & NewOptionsType>;
+	=> ResultPromise<NodeOptions<OptionsType & NewOptionsType>>;
 
 // `execaNode('script', {})` array syntax
 type ExecaNodeArrayShort<OptionsType extends Options> =
 	<NewOptionsType extends Options = {}>(scriptPath: string | URL, options?: NewOptionsType)
-	=> ResultPromise<OptionsType & NewOptionsType>;
+	=> ResultPromise<NodeOptions<OptionsType & NewOptionsType>>;
+
+// `execaNode()` always uses the `node` option, which also enables the `ipc` option by default
+type NodeOptions<OptionsType extends Options> = OptionsType & {readonly node: true};
 
 export { $, ExecaError, ExecaSyncError, execa, execaNode, execaSync, getCancelSignal, getEachMessage, getOneMessage, parseCommandString, sendMessage };
 export type { ExecaMethod, ExecaNodeMethod, ExecaScriptMethod, ExecaScriptSyncMethod, ExecaSyncMethod, Message, Options, Result, ResultPromise, StdinOption, StdinSyncOption, StdoutStderrOption, StdoutStderrSyncOption, Subprocess, SyncOptions, SyncResult, SyncVerboseObject, TemplateExpression, VerboseObject };

package/dist/compiled/execa/index.d.ts

@@ -428,26 +428,30 @@ type IpcMethods<
 		getEachMessage: undefined;
 	};
 
-// Whether IPC is enabled, based on the `ipc`, `ipcInput` and `gracefulCancel` options
+// Whether IPC is enabled, based on the `ipc`, `node`, `ipcInput` and `gracefulCancel` options
 type HasIpc<OptionsType extends Options> = HasIpcOption<
 	OptionsType['ipc'],
+	'node' extends keyof OptionsType ? OptionsType['node'] : undefined,
 	'ipcInput' extends keyof OptionsType ? OptionsType['ipcInput'] : undefined,
 	'gracefulCancel' extends keyof OptionsType ? OptionsType['gracefulCancel'] : undefined
 >;
 
 type HasIpcOption<
 	IpcOption extends Options['ipc'],
+	NodeOption extends Options['node'],
 	IpcInputOption extends Options['ipcInput'],
 	GracefulCancelOption extends Options['gracefulCancel'],
 > = IpcOption extends true
 	? true
 	: IpcOption extends false
 		? false
-		: IpcInputOption extends undefined
-			? GracefulCancelOption extends true
-				? true
-				: false
-			: true;
+		: NodeOption extends true
+			? true
+			: IpcInputOption extends undefined
+				? GracefulCancelOption extends true
+					? true
+					: false
+				: true;
 
 type FileDescriptorOption = `fd${number}`;
 
@@ -781,11 +785,16 @@ type AllLinesFd<OptionsType extends CommonOptions> =
 	FdSpecificOption<OptionsType['lines'], '1'> extends true ? '1' : '2';
 
 // `result.stdio`
-type ResultStdioArray<OptionsType extends CommonOptions> =
-	MapResultStdio<StdioOptionNormalizedArray<OptionsType>, OptionsType>;
+type ResultStdioArray<
+	IsSync extends boolean,
+	OptionsType extends CommonOptions,
+> = [
+	...MapResultStdio<StdioOptionNormalizedArray<OptionsType>, OptionsType>,
+	...ResultIpcStdio<IsSync, OptionsType>,
+];
 
 type MapResultStdio<
-	StdioOptionsArrayType,
+	StdioOptionsArrayType extends readonly unknown[],
 	OptionsType extends CommonOptions,
 > = {
 	-readonly [FdNumber in keyof StdioOptionsArrayType]: ResultStdioNotAll<
@@ -794,6 +803,16 @@ type MapResultStdio<
 	>
 };
 
+// With the `ipc` option, the subprocess' IPC channel adds one last file descriptor, which has no output. Synchronous methods do not support IPC.
+type ResultIpcStdio<
+	IsSync extends boolean,
+	OptionsType extends CommonOptions,
+> = IsSync extends true
+	? []
+	: HasIpc<StricterOptions<OptionsType, Options>> extends true
+		? [undefined]
+		: [];
+
 // `result.ipcOutput`
 // This is empty unless the `ipc` option is `true`.
 // Also, this is empty if the `buffer` option is `false`.
@@ -845,7 +864,7 @@ declare abstract class CommonResult<
 
 	This requires the `all` option to be `true`.
 
-	This is `undefined` if both `stdout` and `stderr` options are set to only `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+	This is `undefined` if both `stdout` and `stderr` options are set to only `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false` for both.
 
 	This is an array if the `lines` option is `true`, or if either the `stdout` or `stderr` option is a transform in object mode.
 	*/
@@ -856,9 +875,11 @@ declare abstract class CommonResult<
 
 	Items are `undefined` when their corresponding `stdio` option is set to only `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
 
+	With the `ipc` option, the last item is the subprocess' IPC channel, which is always `undefined`.
+
 	Items are arrays when their corresponding `stdio` option is a transform in object mode.
 	*/
-	stdio: ResultStdioArray<OptionsType>;
+	stdio: ResultStdioArray<IsSync, OptionsType>;
 
 	/**
 	All the messages sent by the subprocess to the current process.
@@ -872,7 +893,7 @@ declare abstract class CommonResult<
 
 	This array is initially empty and is populated each time the `subprocess.pipe()` method resolves.
 	*/
-	pipedFrom: Unless<IsSync, Result[], []>;
+	pipedFrom: Unless<IsSync, Array<Result | ExecaError>, []>;
 
 	/**
 	The file and arguments that were run.
@@ -881,6 +902,8 @@ declare abstract class CommonResult<
 
 	/**
 	Same as `command` but escaped.
+
+	With the `shell` option, the command is not quoted, since the shell interprets it.
 	*/
 	escapedCommand: string;
 
@@ -1037,7 +1060,7 @@ type GenericVerboseObject = {
 	- `'output'`: one line from `result.stdout` or `result.stderr`
 	- `'ipc'`: one IPC message from `result.ipcOutput`
 	- `'error'`: the `error.shortMessage`
-	- `'duration'`: the `result.durationMs`
+	- `'duration'`: the `result.durationMs`, formatted as `(done in 29ms)`
 	*/
 	message: string;
 
@@ -1061,7 +1084,7 @@ type GenericVerboseObject = {
 	timestamp: Date;
 
 	/**
-	Whether another subprocess is piped into this subprocess. This is `false` when `result.pipedFrom` is empty.
+	Whether this subprocess is the destination of another subprocess' `pipe()` method. This is `true` when it was spawned using the template string or array syntax of `pipe()`, `false` otherwise.
 	*/
 	piped: boolean;
 };
@@ -1178,13 +1201,13 @@ type CommonOptions<
 
 	Unless the `extendEnv` option is `false`, the subprocess also uses the current process' environment variables ([`process.env`](https://nodejs.org/api/process.html#processenv)).
 
-	@default [process.env](https://nodejs.org/api/process.html#processenv)
+	@default {}
 	*/
 	readonly env?: Readonly<Partial<Record<string, string>>>;
 
 	/**
 	If `true`, the subprocess uses both the `env` option and the current process' environment variables ([`process.env`](https://nodejs.org/api/process.html#processenv)).
-	If `false`, only the `env` option is used, not `process.env`.
+	If `false`, only the `env` option is used, not `process.env`. However, when `env` has no `PATH`, the `preferLocal` and `node` options still add their directories to `process.env.PATH`.
 
 	@default true
 	*/
@@ -1258,6 +1281,8 @@ type CommonOptions<
 
 	The output is available with `result.stdout`, `result.stderr` and `result.stdio`.
 
+	String input passed with the `input` or `stdin` option is always encoded with UTF-8, whatever this option is. With a text encoding, `stdin` transforms also decode their input with UTF-8.
+
 	@default 'utf8'
 	*/
 	readonly encoding?: Encoding;
@@ -1289,6 +1314,8 @@ type CommonOptions<
 
 	By default, this applies to both `stdout` and `stderr`, but different values can also be passed.
 
+	With synchronous methods, this cannot be enforced per file descriptor while the subprocess runs, since `spawnSync()` only accepts a single value, which limits the total output of all file descriptors. The `maxBuffer.stdout` value is used for it. The other file descriptors' own values are enforced from the output, once the subprocess ended, and cannot be higher than `maxBuffer.stdout`. Also, with synchronous methods, this is measured in bytes instead of characters or lines, for the same reason.
+
 	When reached, `error.isMaxBuffer` becomes `true`.
 
 	@default 100_000_000
@@ -1348,7 +1375,7 @@ type CommonOptions<
 	readonly reject?: boolean;
 
 	/**
-	If `timeout` is greater than `0`, the subprocess will be terminated if it runs for longer than that amount of milliseconds.
+	If `timeout` is greater than `0`, the subprocess will be terminated if it runs for longer than that amount of milliseconds. It must be a non-negative integer, up to `2147483647` (about 24.8 days).
 
 	On timeout, `error.timedOut` becomes `true`.
 
@@ -1397,7 +1424,7 @@ type CommonOptions<
 	readonly gracefulCancel?: Unless<IsSync, boolean>;
 
 	/**
-	If the subprocess is terminated but does not exit, forcefully exit it by sending [`SIGKILL`](https://en.wikipedia.org/wiki/Signal_(IPC)#SIGKILL).
+	If the subprocess is terminated but does not exit, forcefully exit it by sending [`SIGKILL`](https://en.wikipedia.org/wiki/Signal_(IPC)#SIGKILL). The delay must be a non-negative integer, up to `2147483647` milliseconds (about 24.8 days). When `true`, the default `5000` is used. When `false`, the subprocess is not forcefully exited.
 
 	When this happens, `error.isForcefullyTerminated` becomes `true`.
 
@@ -1435,7 +1462,7 @@ type CommonOptions<
 
 	On Unix, this spawns the subprocess in its own [process group](https://en.wikipedia.org/wiki/Process_group). On Windows, this uses [`taskkill`](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/taskkill).
 
-	This is best-effort: descendant processes that create their own process group or session are not terminated.
+	This is best-effort: descendant processes that create their own process group or session are not terminated. Also, on Windows, descendants are not terminated once the subprocess exited, since its PID might then belong to an unrelated process.
 
 	@default false
 	*/
@@ -1675,16 +1702,18 @@ type InputOutputStream<IsInput extends boolean> = IsInput extends true
 // `subprocess.stdio`
 type SubprocessStdioArray<OptionsType extends Options> = MapStdioStreams<StdioOptionNormalizedArray<OptionsType>, OptionsType>;
 
-// We cannot use mapped types because it must be compatible with Node.js `ChildProcess["stdio"]` which uses a tuple with exactly 5 items
+// File descriptors beyond `stderr` are only present when the `stdio` option is an array with more items.
+// The subprocess' IPC channel, if any, is set as the last file descriptor by Node.js itself.
+// Since any `Subprocess` can be passed where the default one is expected, the list is kept open-ended.
 type MapStdioStreams<
-	StdioOptionsArrayType,
+	StdioOptionsArrayType extends readonly unknown[],
 	OptionsType extends Options,
 > = [
-	SubprocessStdioStream<'0', OptionsType>,
-	SubprocessStdioStream<'1', OptionsType>,
-	SubprocessStdioStream<'2', OptionsType>,
-	'3' extends keyof StdioOptionsArrayType ? SubprocessStdioStream<'3', OptionsType> : never,
-	'4' extends keyof StdioOptionsArrayType ? SubprocessStdioStream<'4', OptionsType> : never,
+	...{
+		-readonly [FdNumber in keyof StdioOptionsArrayType]: SubprocessStdioStream<FdNumber extends string ? FdNumber : string, OptionsType>
+	},
+	...(HasIpc<OptionsType> extends true ? [null] : []),
+	...Array<Readable | Writable | null>,
 ];
 
 // `subprocess.all`
@@ -1710,7 +1739,7 @@ type SubprocessResultMethods<OptionsType extends Options = Options> = {
 
 	This requires the `all` option to be `true`.
 
-	This is `undefined` if `stdout` and `stderr` options are set to `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+	This is `undefined` if both `stdout` and `stderr` options are set to `'inherit'`, `'ignore'`, `Writable` or `integer`.
 	*/
 	all: SubprocessAll<OptionsType>;
 
@@ -1757,21 +1786,23 @@ type ExecaCustomSubprocess<OptionsType extends Options> =
 		/**
 		The subprocess [`stdout`](https://en.wikipedia.org/wiki/Standard_streams#Standard_output_(stdout)) as a stream.
 
-		This is `null` if the `stdout` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+		This is `null` if the `stdout` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`.
 		*/
 		stdout: SubprocessStdioStream<'1', OptionsType>;
 
 		/**
 		The subprocess [`stderr`](https://en.wikipedia.org/wiki/Standard_streams#Standard_error_(stderr)) as a stream.
 
-		This is `null` if the `stderr` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`, or if the `buffer` option is `false`.
+		This is `null` if the `stderr` option is set to `'inherit'`, `'ignore'`, `Writable` or `integer`.
 		*/
 		stderr: SubprocessStdioStream<'2', OptionsType>;
 
 		/**
 		The subprocess `stdin`, `stdout`, `stderr` and other files descriptors as an array of streams.
 
-		Each array item is `null` if the corresponding `stdin`, `stdout`, `stderr` or `stdio` option is set to `'inherit'`, `'ignore'`, `Stream` or `integer`, or if the `buffer` option is `false`.
+		Each array item is `null` if the corresponding `stdin`, `stdout`, `stderr` or `stdio` option is set to `'inherit'`, `'ignore'`, `Stream` or `integer`.
+
+		With the `ipc` option, the last item is the subprocess' IPC channel, which is always `null`.
 		*/
 		stdio: SubprocessStdioArray<OptionsType>;
 
@@ -2435,17 +2466,20 @@ type ExecaNodeBind<OptionsType extends Options> =
 // `execaNode`command`` template syntax
 type ExecaNodeTemplate<OptionsType extends Options> =
 	(...templateString: TemplateString)
-	=> ResultPromise<OptionsType>;
+	=> ResultPromise<NodeOptions<OptionsType>>;
 
 // `execaNode('script', ['argument'], {})` array syntax
 type ExecaNodeArrayLong<OptionsType extends Options> =
 	<NewOptionsType extends Options = {}>(scriptPath: string | URL, arguments?: readonly string[], options?: NewOptionsType)
-	=> ResultPromise<OptionsType & NewOptionsType>;
+	=> ResultPromise<NodeOptions<OptionsType & NewOptionsType>>;
 
 // `execaNode('script', {})` array syntax
 type ExecaNodeArrayShort<OptionsType extends Options> =
 	<NewOptionsType extends Options = {}>(scriptPath: string | URL, options?: NewOptionsType)
-	=> ResultPromise<OptionsType & NewOptionsType>;
+	=> ResultPromise<NodeOptions<OptionsType & NewOptionsType>>;
+
+// `execaNode()` always uses the `node` option, which also enables the `ipc` option by default
+type NodeOptions<OptionsType extends Options> = OptionsType & {readonly node: true};
 
 export { $, ExecaError, ExecaSyncError, execa, execaNode, execaSync, getCancelSignal, getEachMessage, getOneMessage, parseCommandString, sendMessage };
 export type { ExecaMethod, ExecaNodeMethod, ExecaScriptMethod, ExecaScriptSyncMethod, ExecaSyncMethod, Message, Options, Result, ResultPromise, StdinOption, StdinSyncOption, StdoutStderrOption, StdoutStderrSyncOption, Subprocess, SyncOptions, SyncResult, SyncVerboseObject, TemplateExpression, VerboseObject };