@shell-shock/core 0.15.1 → 0.16.0

package/dist/components/utils-builtin.mjs

@@ -3,7 +3,7 @@ import defu$1 from "defu";
 import { Show, code, splitProps } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { FunctionDeclaration, InterfaceDeclaration, InterfaceMember, TypeDeclaration, VarDeclaration } from "@alloy-js/typescript";
+import { FunctionDeclaration, InterfaceDeclaration, InterfaceMember, VarDeclaration } from "@alloy-js/typescript";
 import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 import { TSDoc, TSDocInternal, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
 
@@ -542,407 +542,6 @@ function HyperlinkSupportUtilities() {
 	];
 }
 /**
-* Generates utilities for detecting terminal color support.
-*/
-function ArgsUtilities() {
-	return [
-		createComponent(TSDoc, {
-			heading: "Retrieves the command-line arguments from Deno or Node.js environments.",
-			get children() {
-				return [
-					createComponent(TSDocRemarks, { children: "This function is only intended for internal use. Please use `useArgs()` instead." }),
-					createComponent(Spacing, {}),
-					createComponent(TSDocInternal, {}),
-					createComponent(Spacing, {}),
-					createComponent(TSDocReturns, { children: "An array of command-line arguments from Deno or Node.js environments." })
-				];
-			}
-		}),
-		createComponent(FunctionDeclaration, {
-			"export": true,
-			name: "getArgs",
-			returnType: "string[]",
-			children: code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`
-		}),
-		createComponent(Spacing, {}),
-		createComponent(TSDoc, {
-			heading: "Checks if a specific flag is present in the command-line arguments.",
-			get children() {
-				return [
-					createComponent(TSDocLink, { children: "https://github.com/sindresorhus/has-flag/blob/main/index.js" }),
-					createComponent(TSDocParam, {
-						name: "flag",
-						children: "The flag (or an array of flags/aliases) to check for, e.g., \"color\", \"no-color\"."
-					}),
-					createComponent(TSDocParam, {
-						name: "argv",
-						children: "The command-line arguments to check against. Defaults to global Deno args or process args."
-					}),
-					createComponent(TSDocReturns, { children: "True if the flag is present, false otherwise." })
-				];
-			}
-		}),
-		createComponent(FunctionDeclaration, {
-			"export": true,
-			name: "hasFlag",
-			parameters: [{
-				name: "flag",
-				type: "string | string[]"
-			}, {
-				name: "argv",
-				type: "string[]",
-				default: "useArgs()"
-			}],
-			get children() {
-				return [
-					createComponent(VarDeclaration, {
-						"const": true,
-						name: "position",
-						type: "number",
-						initializer: code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {
-            const pos = argv.findIndex(arg => (f.startsWith("-") ? "" : (f.length === 1 ? "-" : "--") + f)?.toLowerCase() === arg?.toLowerCase() || arg?.toLowerCase().startsWith((f.length === 1 ? "-" : "--") + f + "="));
-            return pos !== -1 ? pos : ret;
-          }, -1);`
-					}),
-					createIntrinsic("hbr", {}),
-					code`return position !== -1 && argv.indexOf("--") === -1 || position < argv.indexOf("--");`
-				];
-			}
-		}),
-		createComponent(Spacing, {}),
-		createComponent(VarDeclaration, {
-			"export": true,
-			name: "isHelp",
-			type: "boolean",
-			initializer: code` !isCI && hasFlag(["help", "h", "?"]); `
-		})
-	];
-}
-/**
-* Generates the `spawn` function declaration, which is a cross-platform utility for spawning child processes with proper color support and environment variable handling.
-*/
-function SpawnFunctionDeclaration() {
-	return [
-		createComponent(FunctionDeclaration, {
-			async: true,
-			name: "resolveCommand",
-			parameters: [
-				{
-					name: "command",
-					type: "string"
-				},
-				{
-					name: "options",
-					type: "Record<string, any>",
-					default: "{}"
-				},
-				{
-					name: "pathExt",
-					type: "string",
-					default: "process.env.PATHEXT || [\".EXE\", \".CMD\", \".BAT\", \".COM\"].join(delimiter)"
-				}
-			],
-			children: code`const env = options.env || process.env;
-        const cwd = process.cwd();
-        if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {
-          try {
-            process.chdir(options.cwd);
-          } catch (err) {
-            // Do nothing
-          }
-        }
-
-        let resolved;
-        try {
-          let extensions = [""];
-          if (isWindows) {
-            extensions = pathExt.split(delimiter).flatMap((item) => [item, item.toLowerCase()]);
-            if (command.includes(".") && extensions[0] !== "") {
-              extensions.unshift("");
-            }
-          }
-
-          for (const envPart of (command.match(new RegExp(\`[\${posix.sep}\${sep === posix.sep ? "" : sep}]\`.replace(/(\\\\)/g, "\\\\$1"))))
-            ? [...(isWindows ? [process.cwd()] : []), ...(process.env.PATH || "").split(delimiter)]
-            : [""]
-          ) {
-            const part =  \`\${!(/^".*"$/.test(envPart) ? envPart.slice(1, -1) : envPart) && new RegExp(\`^\\.\${new RegExp(\`[\${posix.sep}\${sep === posix.sep ? "" : sep}]\`.replace(/(\\\\)/g, "\\\\$1")).source}\`).test(command) ? command.slice(0, 2) : ""}\${join(/^".*"$/.test(envPart) ? envPart.slice(1, -1) : envPart, command)}\`;
-            for (const extension of extensions) {
-              if (isWindows) {
-                const filePath = part + extension;
-                if ((await stat(filePath)).isFile() && extensions.some((ext) => filePath.substring(filePath.length - ext.length).toLowerCase() === ext.toLowerCase())) {
-                  resolved = filePath;
-                  break;
-                }
-              } else {
-                const file = await stat(part + extension);
-                if (file.isFile() && (file.mode & 0o111) !== 0) {
-                  resolved = part + extension;
-                  break;
-                }
-              }
-            }
-          }
-        } catch (err) {
-          // Do nothing
-        } finally {
-          if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {
-            process.chdir(cwd);
-          }
-        }
-
-
-        if (resolved) {
-          resolved = resolve(
-            options.cwd ? options.cwd : "",
-            resolved
-          );
-        }
-
-        return resolved; `
-		}),
-		createComponent(Spacing, {}),
-		createComponent(InterfaceDeclaration, {
-			name: "SpawnBaseOptions",
-			doc: "Options for the `spawn` handler function.",
-			get children() {
-				return [
-					createComponent(InterfaceMember, {
-						name: "stdout",
-						optional: true,
-						type: "(data: string) => void",
-						doc: "The writable stream to use for prompt output, defaults to process.stdout"
-					}),
-					createIntrinsic("hbr", {}),
-					createComponent(InterfaceMember, {
-						name: "stderr",
-						optional: true,
-						type: "(data: string) => void",
-						doc: "The writable stream to use for prompt error output, defaults to process.stderr"
-					}),
-					createIntrinsic("hbr", {}),
-					createComponent(InterfaceMember, {
-						name: "rejectOnError",
-						optional: true,
-						type: "boolean",
-						doc: "Whether to reject the promise on error. Defaults to false."
-					}),
-					createIntrinsic("hbr", {}),
-					createComponent(InterfaceMember, {
-						name: "file",
-						optional: true,
-						type: "string",
-						doc: "The file to execute."
-					}),
-					createIntrinsic("hbr", {}),
-					createComponent(InterfaceMember, {
-						name: "shell",
-						optional: true,
-						type: "boolean | string",
-						doc: "If true, runs command inside of a shell. Uses '/bin/sh' on UNIX, and process.env.ComSpec on Windows. If a string is provided, it specifies the shell to use."
-					}),
-					createIntrinsic("hbr", {}),
-					createComponent(InterfaceMember, {
-						name: "forceShell",
-						optional: true,
-						type: "boolean",
-						doc: "If true, forces the command to run inside of a shell, even if the command is a file."
-					})
-				];
-			}
-		}),
-		createComponent(Spacing, {}),
-		createComponent(TypeDeclaration, {
-			"export": true,
-			name: "SpawnOptions",
-			children: code`SpawnBaseOptions & Parameters<typeof _spawn>[1]`
-		}),
-		createComponent(Spacing, {}),
-		createComponent(TSDoc, {
-			heading: "A function to spawn child processes with proper color support and environment variable handling.",
-			get children() {
-				return [
-					createComponent(TSDocParam, {
-						name: "command",
-						children: `The command to execute.`
-					}),
-					createComponent(TSDocParam, {
-						name: "args",
-						children: `The command-line arguments to pass to the command. Defaults to an empty array.`
-					}),
-					createComponent(TSDocParam, {
-						name: "options",
-						children: `Additional options for spawning the process, such as the current working directory (\`cwd\`).`
-					}),
-					createComponent(TSDocReturns, { children: `The result of the spawned process.` })
-				];
-			}
-		}),
-		createComponent(FunctionDeclaration, {
-			"export": true,
-			async: true,
-			name: "spawn",
-			parameters: [
-				{
-					name: "command",
-					type: "string"
-				},
-				{
-					name: "args",
-					type: "string[] | SpawnOptions",
-					default: "{} as SpawnOptions"
-				},
-				{
-					name: "options",
-					type: "SpawnOptions",
-					default: "{} as SpawnOptions"
-				}
-			],
-			children: code`const normalized = {
-          command,
-          args: [] as string[],
-          options: options as SpawnOptions | any,
-          file: undefined as string | undefined,
-          original: {
-            command,
-            args,
-          },
-        };
-
-        if (args) {
-          if (Array.isArray(args)) {
-            if (args.length > 0) {
-              normalized.args = args.slice(0);
-            }
-          } else {
-            normalized.options = { ...args } as SpawnOptions | any;
-            normalized.args = [];
-          }
-        }
-
-        if (!normalized.options.shell && isWindows) {
-          normalized.file = (await resolveCommand(normalized.command, normalized.options)) || (await resolveCommand(normalized.command, normalized.options, delimiter));
-
-          let commandFile = normalized.file;
-          if (normalized.file) {
-            let shebang: string | undefined;
-            const buffer = Buffer.alloc(150);
-
-            try {
-              const fd = openSync(normalized.file, "r");
-              await promisify(read)(fd, buffer, 0, 150, 0);
-              closeSync(fd);
-            } catch (err) {
-              // Do nothing
-            }
-
-            const matched = buffer.toString().match(/^#!(.*)/);
-            if (matched) {
-              const [path, argument] = matched[0].replace(/#! ?/, "").split(" ");
-	            const binary = path.split("/").pop();
-              if (binary === "env") {
-                shebang = argument;
-              } else {
-                shebang = argument ? \`\${binary} \${argument}\` : binary;
-              }
-            }
-
-            if (shebang) {
-              normalized.args.unshift(normalized.file);
-              normalized.command = shebang;
-
-              commandFile = await resolveCommand(normalized.command, normalized.options);
-            }
-          }
-
-          if (commandFile && (normalized.options.forceShell || /\\.(?:com|exe)$/i.test(commandFile))) {
-            normalized.command = normalize(normalized.command).replace(/([()\\][%!^"\`<>&|;, *?])/g, "^$1");
-
-            normalized.args = ["/d", "/s", "/c", \`"\${normalized.command} \${normalized.args.map(arg =>
-              \`\${arg}\`.replace(/(?=(\\\\+?)?)\\1"/g, "$1$1\\"").replace(/(?=(\\\\+?)?)\\1$/, "$1$1")
-            ).map(arg =>
-              \`"\${arg}"\`.replace(/([()\\][%!^"\`<>&|;, *?])/g, "^$1")
-            ).map(arg =>
-              /node_modules[\\\\/].bin[\\\\/][^\\\\/]+\\.cmd$/i.test(commandFile) ? arg.replace(/([()\\][%!^"\`<>&|;, *?])/g, "^$1") : arg
-            ).join(" ")}"\`];
-            normalized.command = process.env.comspec || "cmd.exe";
-            normalized.options.windowsVerbatimArguments = true;
-          }
-        }
-
-        let stdout = "";
-        let stderr = "";
-
-        const child = _spawn(normalized.command, normalized.args, {
-          cwd: process.cwd(),
-          env: {
-            ...process.env,
-            FORCE_COLOR: isColorSupported ? "1" : "0",
-          },
-          ...normalized.options,
-        }) as ReturnType<typeof _spawn>;
-
-        if (isWindows) {
-          const emit = child.emit;
-          child.emit = (eventName: string | symbol, ...eventArgs: any[]) => {
-            if (eventName === "exit") {
-              let err: Error | null = null;
-              if (eventArgs[0] === 1 && !normalized.file) {
-                err = Object.assign(new Error(\`spawn \${normalized.original.command} ENOENT\`), {
-                  code: "ENOENT",
-                  errno: "ENOENT",
-                  syscall: \`spawn \${normalized.original.command}\`,
-                  path: normalized.original.command,
-                  spawnargs: normalized.original.args,
-                });
-              }
-
-              if (err) {
-                return emit.call(child, "error", err);
-              }
-            }
-
-            return emit.apply(child, [eventName, ...eventArgs]);
-          };
-        }
-
-        return new Promise((resolve, reject) => {
-          if (normalized.options.stdin !== undefined) {
-            child.stdin?.write(normalized.options.stdin);
-          }
-
-          child.stdin?.end();
-
-          child.stdout?.on("data", data => {
-            stdout += data;
-            if (normalized.options.stdout) {
-              normalized.options.stdout(data);
-            }
-          });
-
-          child.stderr?.on("data", data => {
-            stderr += data;
-            if (normalized.options.stderr) {
-              normalized.options.stderr(data);
-            }
-          });
-
-          if (normalized.options.rejectOnError) {
-            child.addListener("error", reject);
-          }
-
-          child.on("close", code => {
-            if (code !== 0 && normalized.options.rejectOnError) {
-              reject(stderr);
-            } else {
-              resolve({ stdout, stderr });
-            }
-          });
-        }); `
-		})
-	];
-}
-/**
 * Generates the `resolveModule` function declaration, which is a utility for resolving file paths across different platforms.
 */
 function ResolveModuleFunctionDeclaration() {
@@ -1503,7 +1102,7 @@ function ResolveModuleFunctionDeclaration() {
 
         if (!validPackageName) {
           const err = new Error(
-            \`Invalid module "\${specifier}" is not a valid package name imported from \${fileURLToPath(base)}\`
+            \`Invalid module \\\`\${specifier}\\\` is not a valid package name imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_INVALID_MODULE_SPECIFIER";
           throw err;
@@ -1604,10 +1203,9 @@ function ResolveModuleFunctionDeclaration() {
           return new URL(packageSubpath, packageJsonUrl);
         } while (packageJsonPath.length !== lastPath!.length);
 
-        const err = new Error(
-          \`Cannot find package '\${packageName}' imported from \${fileURLToPath(base)}\`
-        );
+        const err = new Error(\`Cannot find package \\\`\${packageName}\\\`\`);
         (err as any).code = "ERR_MODULE_NOT_FOUND";
+
         throw err;`
 		}),
 		createComponent(Spacing, {}),
@@ -1623,9 +1221,10 @@ function ResolveModuleFunctionDeclaration() {
 			returnType: "URL",
 			children: code`if (/%2f|%5c/i.test(resolved.pathname)) {
           const err = new Error(
-            \`Invalid module "\${resolved.pathname}" must not include encoded "/" or "\\\\" characters imported from \${fileURLToPath(base)}\`
+            \`Invalid module \\\`\${resolved.pathname}\\\` must not include encoded "/" or "\\\\" characters imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_INVALID_MODULE_SPECIFIER";
+
           throw err;
         }
 
@@ -1638,7 +1237,7 @@ function ResolveModuleFunctionDeclaration() {
 
         if (stat && stat.isDirectory()) {
           const err = new Error(
-            \`Directory import '\${filePath}' is not supported resolving ES modules imported from \${fileURLToPath(base)}\`
+            \`Directory import \\\`\${filePath}\\\` is not supported resolving ES modules imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_UNSUPPORTED_DIR_IMPORT";
           throw err;
@@ -1646,7 +1245,7 @@ function ResolveModuleFunctionDeclaration() {
 
         if (!stat || !stat.isFile()) {
           const err = new Error(
-            \`Cannot find module '\${filePath}' imported from \${fileURLToPath(base)}\`
+            \`Cannot find module \\\`\${filePath}\\\` imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_MODULE_NOT_FOUND";
           throw err;
@@ -1691,7 +1290,7 @@ function ResolveModuleFunctionDeclaration() {
             resolved = new URL(specifier, base);
           } catch (error_: any) {
             const err = new Error(
-              \`Failed to resolve module specifier "\${specifier}" from "\${base}": Invalid relative URL or base scheme is not hierarchical.\`
+              \`Failed to resolve module specifier \\\`\${specifier}\\\` from "\${base}": Invalid relative URL or base scheme is not hierarchical.\`
             );
             err.cause = error_;
             throw err;
@@ -1750,7 +1349,7 @@ function ResolveModuleFunctionDeclaration() {
 
           if (!resolved) {
             const err = new Error(
-              \`Package import specifier "\${specifier}" is not defined in package imported from \${fileURLToPath(base)}\`
+              \`Package import specifier \\\`\${specifier}\\\` is not defined in package imported from \${fileURLToPath(base)}\`
             );
             (err as any).code = "ERR_PACKAGE_IMPORT_NOT_DEFINED";
             throw err;
@@ -1822,6 +1421,7 @@ function ResolveModuleFunctionDeclaration() {
 		}),
 		createComponent(FunctionDeclaration, {
 			async: true,
+			"export": true,
 			name: "resolveModule",
 			parameters: [{
 				name: "specifier",
@@ -1922,9 +1522,10 @@ function ResolveModuleFunctionDeclaration() {
 
         if (!resolved) {
           const err = new Error(
-            \`Cannot find module \${specifier} imported from \${base.href}\`
+            \`Cannot find module \\\`\${specifier}\\\`\`
           );
           (err as any).code = "ERR_MODULE_NOT_FOUND";
+
           throw err;
         }
 
@@ -1934,88 +1535,6 @@ function ResolveModuleFunctionDeclaration() {
 		})
 	];
 }
-function ContextUtilities() {
-	return code`
-  /**
-   * The global Shell Shock - Application context instance.
-   *
-   * @internal
-   */
-  export let internal_appContext = new AsyncLocalStorage<Map<string, any>>();
-
-  /**
-   * Get the Shell Shock - Application context for the current application.
-   *
-   * @param options - The options to use when getting the context.
-   * @returns The Shell Shock - Application context for the current application or undefined if the context is not available.
-   */
-  export function useApp(): Map<string, any> | undefined {
-    return internal_appContext.getStore();
-  }
-
-  /**
-   * A utility hook function to get the command-line arguments from the application context.
-   *
-   * @returns An array of command-line arguments from the application context.
-   * @throws If the application context is not available.
-   */
-  export function useArgs(): string[] {
-    return useApp()?.get("args") ?? getArgs();
-  }
-
-  /**
-   * The context object for the current command execution, containing the command path and segments.
-   */
-  export interface CommandContext {
-    path: string;
-    segments: string[];
-  }
-
-  /**
-   * The global Shell Shock - Command context instance.
-   *
-   * @internal
-   */
-  export let internal_commandContext = new AsyncLocalStorage<CommandContext>();
-
-  /**
-   * Get the Shell Shock - Command context for the current application.
-   *
-   * @param options - The options to use when getting the context.
-   * @returns The Shell Shock - Command context for the current application.
-   * @throws If the Shell Shock - Command context is not available.
-   */
-  export function useCommand(): CommandContext {
-    const result = internal_commandContext.getStore();
-    if (!result) {
-      throw new Error(
-        \`The Shell Shock - Command context is not available. Make sure to call useCommand() within a valid context scope.\`
-      );
-    }
-    return result;
-  }
-
-  /**
-   * A utility hook function to get the individual segments of the current command path.
-   *
-   * @returns An array of command path segments.
-   * @throws If the command context is not available.
-   */
-  export function useSegments(): string[] {
-    return useCommand().segments;
-  }
-
-  /**
-   * A utility hook function to get the full command path as a string.
-   *
-   * @returns The full command path as a string.
-   * @throws If the command context is not available.
-   */
-  export function usePath(): string {
-    return useCommand().path;
-  }
-  `;
-}
 /**
 * A built-in utilities module for Shell Shock.
 */
@@ -2050,12 +1569,7 @@ function UtilsBuiltin(props) {
 				"node:fs/promises": ["stat"],
 				"node:util": ["promisify"],
 				"node:url": ["fileURLToPath", "pathToFileURL"],
-				"node:module": ["builtinModules"],
-				"node:child_process": [{
-					name: "spawn",
-					alias: "_spawn"
-				}],
-				"node:async_hooks": ["AsyncLocalStorage"]
+				"node:module": ["builtinModules"]
 			});
 		},
 		get builtinImports() {
@@ -2072,7 +1586,8 @@ function UtilsBuiltin(props) {
 					"isWindows",
 					"isDevelopment",
 					"isDebug"
-				]
+				],
+				state: ["hasFlag"]
 			});
 		},
 		get children() {
@@ -2097,18 +1612,12 @@ function UtilsBuiltin(props) {
 					children: code`return new Promise((resolve) => setTimeout(resolve, durationMs)); `
 				}),
 				createComponent(Spacing, {}),
-				createComponent(ContextUtilities, {}),
-				createComponent(Spacing, {}),
-				createComponent(ArgsUtilities, {}),
-				createComponent(Spacing, {}),
 				createComponent(EnvSupportUtilities, {}),
 				createComponent(Spacing, {}),
 				createComponent(HyperlinkSupportUtilities, {}),
 				createComponent(Spacing, {}),
 				createComponent(ColorSupportUtilities, {}),
 				createComponent(Spacing, {}),
-				createComponent(SpawnFunctionDeclaration, {}),
-				createComponent(Spacing, {}),
 				createComponent(ResolveModuleFunctionDeclaration, {}),
 				createComponent(Spacing, {}),
 				createComponent(FindSuggestionsDeclaration, {}),
@@ -2125,5 +1634,5 @@ function UtilsBuiltin(props) {
 }
 
 //#endregion
-export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, SpawnFunctionDeclaration, UtilsBuiltin };
+export { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, UtilsBuiltin };
 //# sourceMappingURL=utils-builtin.mjs.map