@shell-shock/core 0.17.8 → 0.17.11

package/dist/components/exec-builtin.cjs

@@ -1,4 +1,84 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.cjs`);let t=require(`@alloy-js/core/jsx-runtime`),n=require(`@powerlines/deepkit/vendor/type`),r=require(`defu`);r=e.__toESM(r);let i=require(`@alloy-js/core`),a=require(`@powerlines/plugin-alloy/core/components/spacing`),o=require(`@alloy-js/typescript`),s=require(`@powerlines/plugin-alloy/typescript/components/builtin-file`),c=require(`@powerlines/plugin-alloy/typescript/components/tsdoc`);const l=[`T`,`K`,()=>u,()=>d,`Omit`,`b!b"e!!e!!ge!"o$#o##w%y`],u=[`T`,`K`,`Pick`,`l+e#!e"!fRb!b"Pde""N#!w#y`],d=[`T`,`U`,`Exclude`,`l6!Re$!RPe#!e$"qk#%QRb!b"Pde"!p)w#y`],f=[()=>l,`id`,`description`,`ExecBuiltinProps`,`P!P.".#Jo!#Mw$y`];function p(e){let[{children:l},u]=(0,i.splitProps)(e,[`children`]);return(0,t.createComponent)(s.BuiltinFile,(0,t.mergeProps)({id:`exec`,description:`A module to handle command execution in a Shell Shock application.`},u,{get imports(){return(0,r.default)(u.imports??{},{"node:path":[`basename`,`extname`,`dirname`,`join`],"node:fs":[`existsSync`],"node:child_process":[{name:`spawn`,alias:`_spawn`},`execFileSync`],"node:stream":[{name:`Stream`,default:!0,type:!0}]})},get builtinImports(){return(0,r.default)(u.builtinImports??{},{env:[`isWindows`,`env`]})},get children(){return[(0,t.createComponent)(o.FunctionDeclaration,{name:`resolveCommandEnv`,parameters:[{name:`params`,type:`{ argv: string[]; env?: NodeJS.ProcessEnv; }`}],returnType:`NodeJS.ProcessEnv`,children:i.code`const argv = params.argv;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _alloy_js_typescript = require("@alloy-js/typescript");
+let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
+let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+
+//#region src/components/exec-builtin.tsx
+const __ΩOmit = [
+	"T",
+	"K",
+	() => __ΩPick,
+	() => __ΩExclude,
+	"Omit",
+	"b!b\"e!!e!!ge!\"o$#o##w%y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩExclude = [
+	"T",
+	"U",
+	"Exclude",
+	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
+];
+const __ΩExecBuiltinProps = [
+	() => __ΩOmit,
+	"id",
+	"description",
+	"ExecBuiltinProps",
+	"P!P.\".#Jo!#Mw$y"
+];
+/**
+* A built-in module for handling command execution in Shell Shock.
+*/
+function ExecBuiltin(props) {
+	const [{ children }, rest] = (0, _alloy_js_core.splitProps)(props, ["children"]);
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
+		id: "exec",
+		description: "A module to handle command execution in a Shell Shock application."
+	}, rest, {
+		get imports() {
+			return (0, defu.default)(rest.imports ?? {}, {
+				"node:path": [
+					"basename",
+					"extname",
+					"dirname",
+					"join"
+				],
+				"node:fs": ["existsSync"],
+				"node:child_process": [{
+					name: "spawn",
+					alias: "_spawn"
+				}, "execFileSync"],
+				"node:stream": [{
+					name: "Stream",
+					default: true,
+					type: true
+				}]
+			});
+		},
+		get builtinImports() {
+			return (0, defu.default)(rest.builtinImports ?? {}, { env: ["isWindows", "env"] });
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "resolveCommandEnv",
+					parameters: [{
+						name: "params",
+						type: "{ argv: string[]; env?: NodeJS.ProcessEnv; }"
+					}],
+					returnType: "NodeJS.ProcessEnv",
+					children: _alloy_js_core.code`const argv = params.argv;
           const shouldSuppressNpmFund = (() => {
             const cmd = basename(argv[0] ?? "");
             if (cmd === "npm" || cmd === "npm.cmd" || cmd === "npm.exe") {
@@ -24,12 +104,32 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=requi
             result.NPM_CONFIG_FUND ??= "false";
             result.npm_config_fund ??= "false";
           }
-          return result; `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`isWindowsBatchCommand`,parameters:[{name:`resolvedCommand`,type:`string`}],returnType:`boolean`,children:i.code`if (!isWindows) {
+          return result; `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "isWindowsBatchCommand",
+					parameters: [{
+						name: "resolvedCommand",
+						type: "string"
+					}],
+					returnType: "boolean",
+					children: _alloy_js_core.code`if (!isWindows) {
             return false;
           }
           const ext = extname(resolvedCommand).toLowerCase();
 
-          return ext === ".cmd" || ext === ".bat"; `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`escapeForCmdExe`,parameters:[{name:`arg`,type:`string`}],returnType:`string`,children:i.code`if (/[&|<>^%\\\\r\\\\n]/.test(arg)) {
+          return ext === ".cmd" || ext === ".bat"; `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "escapeForCmdExe",
+					parameters: [{
+						name: "arg",
+						type: "string"
+					}],
+					returnType: "string",
+					children: _alloy_js_core.code`if (/[&|<>^%\\\\r\\\\n]/.test(arg)) {
           throw new Error(
             \`Unsafe Windows cmd.exe argument detected: \${JSON.stringify(arg)}. \` +
               "Pass an explicit shell-wrapper argv at the call site instead."
@@ -38,9 +138,33 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=requi
         if (!arg.includes(" ") && !arg.includes('"')) {
           return arg;
         }
-        return \`"\${arg.replace(/"/g, '""')}"\`; `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`buildCmdExeCommandLine`,parameters:[{name:`resolvedCommand`,type:`string`},{name:`args`,type:`string[]`}],returnType:`string`,children:i.code`return [escapeForCmdExe(resolvedCommand), ...args.map(escapeForCmdExe)].join(
+        return \`"\${arg.replace(/"/g, '""')}"\`; `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "buildCmdExeCommandLine",
+					parameters: [{
+						name: "resolvedCommand",
+						type: "string"
+					}, {
+						name: "args",
+						type: "string[]"
+					}],
+					returnType: "string",
+					children: _alloy_js_core.code`return [escapeForCmdExe(resolvedCommand), ...args.map(escapeForCmdExe)].join(
           " "
-        ); `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`resolveNpmArgvForWindows`,doc:`On Windows, Node 18.20.2+ (CVE-2024-27980) rejects spawning .cmd/.bat directly without shell, causing EINVAL. Resolve npm/npx to node + cli script so we spawn node.exe instead of npm.cmd.`,parameters:[{name:`argv`,type:`string[]`}],returnType:`string[] | null`,children:i.code`if (!isWindows || argv.length === 0) {
+        ); `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "resolveNpmArgvForWindows",
+					doc: "On Windows, Node 18.20.2+ (CVE-2024-27980) rejects spawning .cmd/.bat directly without shell, causing EINVAL. Resolve npm/npx to node + cli script so we spawn node.exe instead of npm.cmd.",
+					parameters: [{
+						name: "argv",
+						type: "string[]"
+					}],
+					returnType: "string[] | null",
+					children: _alloy_js_core.code`if (!isWindows || argv.length === 0) {
             return null;
           }
           const base = basename(argv[0] ?? "")
@@ -60,7 +184,18 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=requi
 
             return [shimmedCommand, ...argv.slice(1)];
           }
-          return [process.execPath, cliPath, ...argv.slice(1)]; `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`resolveCommand`,doc:`Resolves a command for Windows compatibility. On Windows, non-.exe commands (like pnpm, yarn) are resolved to .cmd; npm/npx are handled by resolveNpmArgvForWindows to avoid spawn EINVAL (no direct .cmd).`,parameters:[{name:`command`,type:`string`}],returnType:`string`,children:i.code`if (!isWindows) {
+          return [process.execPath, cliPath, ...argv.slice(1)]; `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "resolveCommand",
+					doc: "Resolves a command for Windows compatibility. On Windows, non-.exe commands (like pnpm, yarn) are resolved to .cmd; npm/npx are handled by resolveNpmArgvForWindows to avoid spawn EINVAL (no direct .cmd).",
+					parameters: [{
+						name: "command",
+						type: "string"
+					}],
+					returnType: "string",
+					children: _alloy_js_core.code`if (!isWindows) {
             return command;
           }
           const base = basename(command).toLowerCase();
@@ -70,13 +205,33 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=requi
           if (["pnpm", "yarn"].includes(base)) {
             return \`\${command}.cmd\`;
           }
-          return command; `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`resolveCommandStdio`,parameters:[{name:`params`,type:`{ hasInput: boolean; preferInherit: boolean; }`}],returnType:`["pipe" | "inherit" | "ignore", "pipe", "pipe"]`,children:i.code`const stdin = params.hasInput
+          return command; `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "resolveCommandStdio",
+					parameters: [{
+						name: "params",
+						type: "{ hasInput: boolean; preferInherit: boolean; }"
+					}],
+					returnType: "[\"pipe\" | \"inherit\" | \"ignore\", \"pipe\", \"pipe\"]",
+					children: _alloy_js_core.code`const stdin = params.hasInput
           ? "pipe"
           : params.preferInherit
             ? "inherit"
             : "pipe";
 
-        return [stdin, "pipe", "pipe"]; `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`resolveProcessExitCode`,parameters:[{name:`params`,type:`{ explicitCode: number | null | undefined; childExitCode: number | null | undefined; resolvedSignal: NodeJS.Signals | null; usesWindowsExitCodeShim: boolean; timedOut: boolean; noOutputTimedOut: boolean; killIssuedByTimeout: boolean; }`}],returnType:`number | null`,children:i.code`return (
+        return [stdin, "pipe", "pipe"]; `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "resolveProcessExitCode",
+					parameters: [{
+						name: "params",
+						type: "{ explicitCode: number | null | undefined; childExitCode: number | null | undefined; resolvedSignal: NodeJS.Signals | null; usesWindowsExitCodeShim: boolean; timedOut: boolean; noOutputTimedOut: boolean; killIssuedByTimeout: boolean; }"
+					}],
+					returnType: "number | null",
+					children: _alloy_js_core.code`return (
           params.explicitCode ??
           params.childExitCode ??
           (params.usesWindowsExitCodeShim &&
@@ -86,17 +241,189 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=requi
           !params.killIssuedByTimeout
             ? 0
             : null)
-        ); `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.FunctionDeclaration,{name:`shouldSpawnWithShell`,parameters:[{name:`params`,type:`{ resolvedCommand: string; platform: NodeJS.Platform; }`}],returnType:`boolean`,children:i.code`// SECURITY: never enable \`shell\` for argv-based execution.
+        ); `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "shouldSpawnWithShell",
+					parameters: [{
+						name: "params",
+						type: "{ resolvedCommand: string; platform: NodeJS.Platform; }"
+					}],
+					returnType: "boolean",
+					children: _alloy_js_core.code`// SECURITY: never enable \`shell\` for argv-based execution.
           // \`shell\` routes through cmd.exe on Windows, which turns untrusted argv values
           // (like chat prompts passed as CLI args) into command-injection primitives.
           // If you need a shell, use an explicit shell-wrapper argv (e.g. \`cmd.exe /c ...\`)
           // and validate/escape at the call site.
           void params;
-          return false; `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The result of a spawn operation.`}),(0,t.createComponent)(o.InterfaceDeclaration,{export:!0,name:`SpawnResult`,get children(){return[(0,t.createComponent)(c.TSDoc,{heading:`The PID of the spawned child process, if available.`}),(0,t.createComponent)(o.InterfaceMember,{name:`pid`,optional:!0,type:`number`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The standard output produced by the child process.`}),(0,t.createComponent)(o.InterfaceMember,{name:`stdout`,type:`string`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The standard error produced by the child process.`}),(0,t.createComponent)(o.InterfaceMember,{name:`stderr`,type:`string`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The exit code of the child process, if available.`}),(0,t.createComponent)(o.InterfaceMember,{name:`code`,type:`number | null`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The signal that caused the child process to terminate, if it was killed by a signal.`}),(0,t.createComponent)(o.InterfaceMember,{name:`signal`,type:`NodeJS.Signals | null`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`Whether the child process was killed.`}),(0,t.createComponent)(o.InterfaceMember,{name:`killed`,type:`boolean`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The reason for the child process termination.`}),(0,t.createComponent)(o.InterfaceMember,{name:`termination`,type:i.code`"exit" | "timeout" | "no-output-timeout" | "signal"`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`Whether the child process timed out due to no output.`}),(0,t.createComponent)(o.InterfaceMember,{name:`noOutputTimedOut`,optional:!0,type:`boolean`})]}}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`Options for spawning a child process.`}),(0,t.createComponent)(o.InterfaceDeclaration,{export:!0,name:`SpawnOptions`,get children(){return[(0,t.createComponent)(c.TSDoc,{heading:"The timeout in milliseconds for the spawn operation. If the process runs longer than this, it will be killed and the spawn promise will reject. This can also be provided as a number directly to the spawn function for convenience. Providing \\`-1\\` will disable the timeout.",get children(){return(0,t.createComponent)(c.TSDocDefaultValue,{get type(){return n.ReflectionKind.number},defaultValue:`300000`})}}),(0,t.createComponent)(o.InterfaceMember,{name:`timeoutMs`,optional:!0,type:`number`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The current working directory of the child process.`}),(0,t.createComponent)(o.InterfaceMember,{name:`cwd`,optional:!0,type:`string`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The input to be passed to the child process.`}),(0,t.createComponent)(o.InterfaceMember,{name:`input`,optional:!0,type:`string`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The environment variables for the child process.`}),(0,t.createComponent)(o.InterfaceMember,{name:`env`,optional:!0,type:`NodeJS.ProcessEnv`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`Whether to pass arguments to the child process verbatim on Windows.`}),(0,t.createComponent)(o.InterfaceMember,{name:`windowsVerbatimArguments`,optional:!0,type:`boolean`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`The timeout in milliseconds for the child process to produce output on stdout or stderr. If the process produces no output for this duration, it will be killed and the spawn promise will reject with a no-output-timeout termination reason.`}),(0,t.createComponent)(o.InterfaceMember,{name:`noOutputTimeoutMs`,optional:!0,type:`number`})]}}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.VarDeclaration,{const:!0,name:`WINDOWS_CLOSE_STATE_SETTLE_TIMEOUT_MS`,initializer:i.code`250`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(o.VarDeclaration,{const:!0,name:`WINDOWS_CLOSE_STATE_POLL_MS`,initializer:i.code`10`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`Spawns a child process with the given arguments and options, returning a promise that resolves with the result of the spawn operation.`,get children(){return[(0,t.createComponent)(c.TSDocParam,{name:`argv`,children:`The command and its arguments to spawn.`}),(0,t.createComponent)(c.TSDocParam,{name:`optionsOrTimeoutMs`,children:"The options for spawning the command, or a number representing the timeout in milliseconds. This allows for a convenient shorthand when only a timeout is needed. Providing `-1` will disable the timeout. If no options or timeout are provided, a default timeout of 5 minutes will be used."}),(0,t.createComponent)(c.TSDocReturns,{children:`A promise that resolves with the result of the spawn operation, including stdout, stderr, exit code, signal, and termination reason.`})]}}),(0,t.createComponent)(o.FunctionDeclaration,{export:!0,async:!0,name:`spawn`,parameters:[{name:`argv`,type:`string[]`},{name:`optionsOrTimeoutMs`,type:`number | SpawnOptions`,default:`300000`}],returnType:`Promise<SpawnResult>`,children:i.code`const options: SpawnOptions =
+          return false; `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The result of a spawn operation." }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+					"export": true,
+					name: "SpawnResult",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The PID of the spawned child process, if available." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "pid",
+								optional: true,
+								type: "number"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The standard output produced by the child process." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "stdout",
+								type: "string"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The standard error produced by the child process." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "stderr",
+								type: "string"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The exit code of the child process, if available." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "code",
+								type: "number | null"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The signal that caused the child process to terminate, if it was killed by a signal." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "signal",
+								type: "NodeJS.Signals | null"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "Whether the child process was killed." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "killed",
+								type: "boolean"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The reason for the child process termination." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "termination",
+								type: _alloy_js_core.code`"exit" | "timeout" | "no-output-timeout" | "signal"`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "Whether the child process timed out due to no output." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "noOutputTimedOut",
+								optional: true,
+								type: "boolean"
+							})
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "Options for spawning a child process." }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+					"export": true,
+					name: "SpawnOptions",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+								heading: "The timeout in milliseconds for the spawn operation. If the process runs longer than this, it will be killed and the spawn promise will reject. This can also be provided as a number directly to the spawn function for convenience. Providing \\`-1\\` will disable the timeout.",
+								get children() {
+									return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocDefaultValue, {
+										type: "number",
+										defaultValue: "300_000"
+									});
+								}
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "timeoutMs",
+								optional: true,
+								type: "number"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The current working directory of the child process." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "cwd",
+								optional: true,
+								type: "string"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The input to be passed to the child process." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "input",
+								optional: true,
+								type: "string"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The environment variables for the child process." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "env",
+								optional: true,
+								type: "NodeJS.ProcessEnv"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "Whether to pass arguments to the child process verbatim on Windows." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "windowsVerbatimArguments",
+								optional: true,
+								type: "boolean"
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The timeout in milliseconds for the child process to produce output on stdout or stderr. If the process produces no output for this duration, it will be killed and the spawn promise will reject with a no-output-timeout termination reason." }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+								name: "noOutputTimeoutMs",
+								optional: true,
+								type: "number"
+							})
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+					"const": true,
+					name: "WINDOWS_CLOSE_STATE_SETTLE_TIMEOUT_MS",
+					initializer: _alloy_js_core.code`250`
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+					"const": true,
+					name: "WINDOWS_CLOSE_STATE_POLL_MS",
+					initializer: _alloy_js_core.code`10`
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+					heading: "Spawns a child process with the given arguments and options, returning a promise that resolves with the result of the spawn operation.",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+								name: "argv",
+								children: "The command and its arguments to spawn."
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+								name: "optionsOrTimeoutMs",
+								children: `The options for spawning the command, or a number representing the timeout in milliseconds. This allows for a convenient shorthand when only a timeout is needed. Providing \`-1\` will disable the timeout. If no options or timeout are provided, a default timeout of 5 minutes will be used.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "A promise that resolves with the result of the spawn operation, including stdout, stderr, exit code, signal, and termination reason." })
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					"export": true,
+					async: true,
+					name: "spawn",
+					parameters: [{
+						name: "argv",
+						type: "string[]"
+					}, {
+						name: "optionsOrTimeoutMs",
+						type: "number | SpawnOptions",
+						default: "300_000"
+					}],
+					returnType: "Promise<SpawnResult>",
+					children: _alloy_js_core.code`const options: SpawnOptions =
   typeof optionsOrTimeoutMs === "number"
     ? { timeoutMs: optionsOrTimeoutMs }
     : optionsOrTimeoutMs;
-const { timeoutMs = 300000, cwd, input, noOutputTimeoutMs } = options;
+const { timeoutMs = 300_000, cwd, input, noOutputTimeoutMs } = options;
 
 const resolvedArgv =
   isWindows
@@ -315,18 +642,105 @@ return new Promise((resolve, reject) => {
     };
     waitForExitState();
   });
-});`}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:`A helper function that executes a command and returns its stdout.`,get children(){return[(0,t.createComponent)(c.TSDocParam,{name:`argv`,children:"The command and its arguments to spawn. This is passed directly to the spawn function. Remember that on Windows, commands like `npm` or `pnpm` will be resolved to their .cmd shims, so you can just pass `npm` without worrying about the extension."}),(0,t.createComponent)(c.TSDocParam,{name:`optionsOrTimeoutMs`,children:"The options for spawning the command, or a number representing the timeout in milliseconds. This is passed directly to the spawn function. Providing `-1` will disable the timeout. If no options or timeout are provided, a default timeout of 5 minutes will be used."}),(0,t.createComponent)(c.TSDocReturns,{children:`A promise that resolves with the result of the spawn operation if the command exits with code 0, or rejects with an error if the command exits with a non-zero code or if there is a problem spawning the process.`})]}}),(0,t.createComponent)(o.FunctionDeclaration,{export:!0,async:!0,name:`exec`,parameters:[{name:`argv`,type:`string[]`},{name:`optionsOrTimeoutMs`,type:`number | SpawnOptions`,default:`300000`}],returnType:`Promise<string>`,children:i.code`const spawnResult = await spawn(argv, optionsOrTimeoutMs);
+});`
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+					heading: "A helper function that executes a command and returns its stdout.",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+								name: "argv",
+								children: `The command and its arguments to spawn. This is passed directly to the spawn function. Remember that on Windows, commands like \`npm\` or \`pnpm\` will be resolved to their .cmd shims, so you can just pass \`npm\` without worrying about the extension.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+								name: "optionsOrTimeoutMs",
+								children: `The options for spawning the command, or a number representing the timeout in milliseconds. This is passed directly to the spawn function. Providing \`-1\` will disable the timeout. If no options or timeout are provided, a default timeout of 5 minutes will be used.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "A promise that resolves with the result of the spawn operation if the command exits with code 0, or rejects with an error if the command exits with a non-zero code or if there is a problem spawning the process." })
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					"export": true,
+					async: true,
+					name: "exec",
+					parameters: [{
+						name: "argv",
+						type: "string[]"
+					}, {
+						name: "optionsOrTimeoutMs",
+						type: "number | SpawnOptions",
+						default: "300_000"
+					}],
+					returnType: "Promise<string>",
+					children: _alloy_js_core.code`const spawnResult = await spawn(argv, optionsOrTimeoutMs);
           if (spawnResult.code !== 0) {
             throw Object.assign(new Error(
               \`Command "\${argv.join(" ")}" exited with code \${spawnResult.code} and signal \${spawnResult.signal}\`
             ), spawnResult);
           }
 
-          return spawnResult.stdout.trim(); `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(c.TSDoc,{heading:"A helper function that executes a command synchronously and returns its stdout. This is a thin wrapper around \\`child_process.execFileSync\\` with some added Windows compatibility handling.",get children(){return[(0,t.createComponent)(c.TSDocParam,{name:`argv`,children:"The command and its arguments to spawn. This is passed directly to `execFileSync` after Windows-specific resolution. Remember that on Windows, commands like `npm` or `pnpm` will be resolved to their .cmd shims, so you can just pass `npm` without worrying about the extension."}),(0,t.createComponent)(c.TSDocParam,{name:`options`,children:"The options for spawning the command. This is passed directly to `execFileSync` after some processing. The timeout option is supported, but note that it will throw an error if the process runs longer than the specified timeout. If no options are provided, a default timeout of 5 minutes will be used."}),(0,t.createComponent)(c.TSDocReturns,{children:`The standard output produced by the command if it exits with code 0. If the command exits with a non-zero code or if there is a problem spawning the process, an error will be thrown.`})]}}),(0,t.createComponent)(o.FunctionDeclaration,{export:!0,name:`execSync`,parameters:[{name:`argv`,type:`string[]`},{name:`options`,type:`SpawnOptions`,default:`{}`}],returnType:`string`,children:i.code`return execFileSync(argv.length > 0 ? argv[0] : "", argv.slice(1), {
+          return spawnResult.stdout.trim(); `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+					heading: "A helper function that executes a command synchronously and returns its stdout. This is a thin wrapper around \\`child_process.execFileSync\\` with some added Windows compatibility handling.",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+								name: "argv",
+								children: `The command and its arguments to spawn. This is passed directly to \`execFileSync\` after Windows-specific resolution. Remember that on Windows, commands like \`npm\` or \`pnpm\` will be resolved to their .cmd shims, so you can just pass \`npm\` without worrying about the extension.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+								name: "options",
+								children: `The options for spawning the command. This is passed directly to \`execFileSync\` after some processing. The timeout option is supported, but note that it will throw an error if the process runs longer than the specified timeout. If no options are provided, a default timeout of 5 minutes will be used.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "The standard output produced by the command if it exits with code 0. If the command exits with a non-zero code or if there is a problem spawning the process, an error will be thrown." })
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					"export": true,
+					name: "execSync",
+					parameters: [{
+						name: "argv",
+						type: "string[]"
+					}, {
+						name: "options",
+						type: "SpawnOptions",
+						default: "{}"
+					}],
+					returnType: "string",
+					children: _alloy_js_core.code`return execFileSync(argv.length > 0 ? argv[0] : "", argv.slice(1), {
           encoding: "utf8",
           stdio: ["ignore", "pipe", "ignore"],
-          timeout: options.timeoutMs ?? 300000,
+          timeout: options.timeoutMs ?? 300_000,
           env: resolveCommandEnv({ argv, env: options.env }),
           cwd: options.cwd || process.cwd(),
           windowsHide: true
-        }).trim(); `}),(0,t.createComponent)(a.Spacing,{}),(0,t.createComponent)(i.Show,{get when(){return!!l},children:l})]}}))}p.__type=[()=>f,`props`,`ExecBuiltin`,`A built-in module for handling command execution in Shell Shock.`,`Pn!2""/#?$`],exports.ExecBuiltin=p,exports.__ΩExecBuiltinProps=f;
+        }).trim(); `
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+ExecBuiltin.__type = [
+	() => __ΩExecBuiltinProps,
+	"props",
+	"ExecBuiltin",
+	"A built-in module for handling command execution in Shell Shock.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+exports.ExecBuiltin = ExecBuiltin;
+exports.__ΩExecBuiltinProps = __ΩExecBuiltinProps;
+//# sourceMappingURL=exec-builtin.cjs.map

package/dist/components/exec-builtin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-builtin.cjs","names":[],"sources":[],"mappings":""}

package/dist/components/exec-builtin.d.cts

@@ -1,4 +1,3 @@
-import * as _$_alloy_js_core0 from "@alloy-js/core";
 import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 
 //#region src/components/exec-builtin.d.ts
@@ -6,7 +5,7 @@ interface ExecBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
 /**
  * A built-in module for handling command execution in Shell Shock.
  */
-declare function ExecBuiltin(props: ExecBuiltinProps): _$_alloy_js_core0.Children;
+declare function ExecBuiltin(props: ExecBuiltinProps): import("@alloy-js/core").Children;
 //#endregion
 export { ExecBuiltin, ExecBuiltinProps };
 //# sourceMappingURL=exec-builtin.d.cts.map

package/dist/components/exec-builtin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"exec-builtin.d.cts","names":[],"sources":["../../src/components/exec-builtin.tsx"],"mappings":";;;;UAqCiB,gBAAA,SAAyB,IAAA,CACxC,gBAAA;;AADF;;iBAQgB,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"exec-builtin.d.cts","names":[],"sources":["../../src/components/exec-builtin.tsx"],"mappings":";;;UAoCiB,gBAAA,SAAyB,IAAI,CAC5C,gBAAA;AADF;;;AAAA,iBAQgB,WAAA,CAAY,KAAA,EAAO,gBAAgB,4BAAA,QAAA"}

package/dist/components/exec-builtin.d.mts

@@ -1,4 +1,3 @@
-import * as _$_alloy_js_core0 from "@alloy-js/core";
 import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 
 //#region src/components/exec-builtin.d.ts
@@ -6,7 +5,7 @@ interface ExecBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
 /**
  * A built-in module for handling command execution in Shell Shock.
  */
-declare function ExecBuiltin(props: ExecBuiltinProps): _$_alloy_js_core0.Children;
+declare function ExecBuiltin(props: ExecBuiltinProps): import("@alloy-js/core").Children;
 //#endregion
 export { ExecBuiltin, ExecBuiltinProps };
 //# sourceMappingURL=exec-builtin.d.mts.map

package/dist/components/exec-builtin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"exec-builtin.d.mts","names":[],"sources":["../../src/components/exec-builtin.tsx"],"mappings":";;;;UAqCiB,gBAAA,SAAyB,IAAA,CACxC,gBAAA;;AADF;;iBAQgB,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"exec-builtin.d.mts","names":[],"sources":["../../src/components/exec-builtin.tsx"],"mappings":""}