@orkestrel/process 0.0.11 → 0.0.12

package/dist/src/core/index.d.cts

@@ -64,8 +64,12 @@ export declare interface DetachOptions {
  * Supplies the lookup inputs for resolving a command file to an executable path.
  *
  * @remarks
- * `workspace` is searched before `PATH`, matching Windows command semantics. `environment` is the
- * child's effective environment, so the lookup reads the same `PATH` and `PATHEXT` the child will.
+ * {@link buildExecutableCandidates} searches `workspace` before `PATH`, matching Windows command
+ * semantics. For an extensionless Windows name, it enumerates `PATHEXT` candidates. For an
+ * extension-bearing Windows name, it enumerates the literal path before `PATHEXT` candidates.
+ * `environment` is the child's effective environment, so the lookup reads the same `PATH` and
+ * `PATHEXT` the child will. On a lookup miss, {@link buildSpawn} preserves the command file as
+ * written for native spawning.
  */
 export declare interface ExecutableOptions {
     /** Names the directory searched first. Default: the current working directory. */

package/dist/src/core/index.d.ts

@@ -64,8 +64,12 @@ export declare interface DetachOptions {
  * Supplies the lookup inputs for resolving a command file to an executable path.
  *
  * @remarks
- * `workspace` is searched before `PATH`, matching Windows command semantics. `environment` is the
- * child's effective environment, so the lookup reads the same `PATH` and `PATHEXT` the child will.
+ * {@link buildExecutableCandidates} searches `workspace` before `PATH`, matching Windows command
+ * semantics. For an extensionless Windows name, it enumerates `PATHEXT` candidates. For an
+ * extension-bearing Windows name, it enumerates the literal path before `PATHEXT` candidates.
+ * `environment` is the child's effective environment, so the lookup reads the same `PATH` and
+ * `PATHEXT` the child will. On a lookup miss, {@link buildSpawn} preserves the command file as
+ * written for native spawning.
  */
 export declare interface ExecutableOptions {
     /** Names the directory searched first. Default: the current working directory. */

package/dist/src/server/index.cjs

@@ -274,15 +274,15 @@ function isFile(target) {
 *
 * @remarks
 * Windows alone needs this list: the host searches the working directory before `PATH` and applies
-* `PATHEXT`, and Node reproduces neither for a direct spawn. Within each searched directory the
-* literal name is tried first and each `PATHEXT` candidate after it, whether or not the name already
-* carries an extension — so `report.txt` resolves to a `report.txt` file where one exists and to
-* `report.txt.cmd` where none does. The lookup reads the child's effective environment, so an
-* overridden `PATH` selects the executable the child would have found. A POSIX host resolves the
-* file itself, so the candidate list there is empty. An appended extension is spelled the way
-* `PATHEXT` spells it rather than the way the directory entry does, which the case-insensitive host
-* treats as the same file. A non-Windows platform returns an empty list because `execvp` performs
-* its own lookup.
+* `PATHEXT`, and Node reproduces neither for a direct spawn. Within each searched directory,
+* {@link buildExecutableCandidates} enumerates `PATHEXT` candidates for an extensionless name. For
+* an extension-bearing name, it enumerates the literal path before `PATHEXT` candidates, so
+* `report.txt` resolves to a `report.txt` file where one exists and to `report.txt.cmd` where none
+* does. The lookup reads the child's effective environment, so an overridden `PATH` selects the
+* executable the child would have found. A POSIX host resolves the file itself, so the candidate
+* list there is empty. A `PATHEXT` candidate keeps the extension spelling from `PATHEXT`, which the
+* case-insensitive host treats as the same file. A non-Windows platform returns an empty list
+* because `execvp` performs its own lookup.
 *
 * @param file - The command executable name or path
 * @param workspace - The directory searched first
@@ -297,7 +297,8 @@ function isFile(target) {
 */
 function buildExecutableCandidates(file, workspace, environment, platform) {
 	if (platform !== "win32") return Object.freeze([]);
-	const candidates = [file, ...(readPlatformVariable(environment, "PATHEXT", platform) ?? _src_core.PROCESS_PATHEXT).split(";").filter((extension) => extension.length > 0).map((extension) => `${file}${extension}`)];
+	const extensions = (readPlatformVariable(environment, "PATHEXT", platform) ?? _src_core.PROCESS_PATHEXT).split(";").filter((extension) => extension.length > 0);
+	const candidates = node_path.win32.extname(file).length === 0 ? extensions.map((extension) => `${file}${extension}`) : [file, ...extensions.map((extension) => `${file}${extension}`)];
 	const directories = file.includes("/") || file.includes("\\") ? [workspace] : [workspace, ...(readPlatformVariable(environment, "PATH", platform) ?? "").split(";")];
 	const targets = [];
 	for (const directory of directories) {
@@ -310,6 +311,10 @@ function buildExecutableCandidates(file, workspace, environment, platform) {
 * Resolves a command file to the executable path the host would launch, or to `undefined` on a POSIX
 * host, which performs its own lookup.
 *
+* @remarks
+* A Windows lookup miss also returns `undefined`. {@link buildSpawn} preserves the command file as
+* written for native spawning.
+*
 * @param file - The command executable name or path
 * @param options - The directory searched first and the child's effective environment
 * @returns The resolved absolute path, or `undefined` when no candidate is a regular file
@@ -394,6 +399,10 @@ function buildPlatformSpawn(command, file, environment, platform) {
 /**
 * Builds the resolved spawn form of one command for the current host.
 *
+* @remarks
+* When executable lookup returns no regular-file candidate, {@link buildSpawn} preserves the
+* command file as written for native spawning.
+*
 * @param command - The executable and its argument vector
 * @param options - The directory searched first and the child's effective environment
 * @returns The file, argument vector, and verbatim flag to spawn with