@shell-shock/core 0.17.2 → 0.17.4

package/dist/api.cjs

@@ -63,7 +63,8 @@ var ShellShockAPI = class ShellShockAPI {
 		"docs",
 		"finalize",
 		"ShellShockAPI",
-		"!3!P\"w\"2#&2$8P7%`0&sP!2'\"0(P!2)$`0*P!2)$`0+P!2)$`0,P!2)$`0-P!2)$`0.P$`0/5w0"
+		"The Shell Shock API class.",
+		"!3!P\"w\"2#&2$8P7%`0&sP!2'\"0(P!2)$`0*P!2)$`0+P!2)$`0,P!2)$`0-P!2)$`0.P$`0/5w0?1"
 	];
 };
 /**
@@ -85,10 +86,10 @@ createShellShock.__type = [
 	() => ({}),
 	() => ShellShockAPI,
 	"createShellShock",
-	"P\"w\"o!\"2#>$P7%`/&"
+	"Creates a new {@link ShellShockAPI} instance.",
+	"P\"w\"o!\"2#>$P7%`/&?'"
 ];
 
 //#endregion
 exports.ShellShockAPI = ShellShockAPI;
-exports.createShellShock = createShellShock;
-//# sourceMappingURL=api.cjs.map
+exports.createShellShock = createShellShock;

package/dist/api.mjs

@@ -61,7 +61,8 @@ var ShellShockAPI = class ShellShockAPI {
 		"docs",
 		"finalize",
 		"ShellShockAPI",
-		"!3!P\"w\"2#&2$8P7%`0&sP!2'\"0(P!2)$`0*P!2)$`0+P!2)$`0,P!2)$`0-P!2)$`0.P$`0/5w0"
+		"The Shell Shock API class.",
+		"!3!P\"w\"2#&2$8P7%`0&sP!2'\"0(P!2)$`0*P!2)$`0+P!2)$`0,P!2)$`0-P!2)$`0.P$`0/5w0?1"
 	];
 };
 /**
@@ -83,7 +84,8 @@ createShellShock.__type = [
 	() => ({}),
 	() => ShellShockAPI,
 	"createShellShock",
-	"P\"w\"o!\"2#>$P7%`/&"
+	"Creates a new {@link ShellShockAPI} instance.",
+	"P\"w\"o!\"2#>$P7%`/&?'"
 ];
 
 //#endregion

package/dist/api.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.mjs","names":[],"sources":["../src/api.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  BuildInlineConfig,\n  CleanInlineConfig,\n  DocsInlineConfig,\n  LintInlineConfig,\n  PluginConfig,\n  PrepareInlineConfig\n} from \"powerlines\";\nimport { createPowerlines, PowerlinesAPI } from \"powerlines\";\nimport { plugin } from \"./plugin\";\nimport type { UserConfig } from \"./types/config\";\n\n/**\n * The Shell Shock API class.\n *\n * @remarks\n * This class provides methods to interact with the Shell Shock build system, including cleaning, preparing, linting, building, generating documentation, and finalizing projects.\n */\nexport class ShellShockAPI {\n  #powerlines: PowerlinesAPI;\n\n  public static async from(\n    config: UserConfig,\n    workspaceRoot?: string\n  ): Promise<ShellShockAPI> {\n    const userConfig = {\n      framework: \"shell-shock\",\n      ...config,\n      plugins: [plugin(), ...(config.plugins ?? [])] as PluginConfig<any>[]\n    };\n\n    const powerlines = await (workspaceRoot\n      ? PowerlinesAPI.from(workspaceRoot, userConfig)\n      : createPowerlines(userConfig));\n\n    return new ShellShockAPI(powerlines);\n  }\n\n  private constructor(powerlines: PowerlinesAPI) {\n    this.#powerlines = powerlines;\n  }\n\n  public async clean(inlineConfig: CleanInlineConfig): Promise<void> {\n    return this.#powerlines.clean(inlineConfig);\n  }\n\n  public async prepare(inlineConfig: PrepareInlineConfig): Promise<void> {\n    return this.#powerlines.prepare(inlineConfig);\n  }\n\n  public async lint(inlineConfig: LintInlineConfig): Promise<void> {\n    return this.#powerlines.lint(inlineConfig);\n  }\n\n  public async build(inlineConfig: BuildInlineConfig): Promise<void> {\n    return this.#powerlines.build(inlineConfig);\n  }\n\n  public async docs(inlineConfig: DocsInlineConfig): Promise<void> {\n    return this.#powerlines.docs(inlineConfig);\n  }\n\n  public async finalize(): Promise<void> {\n    return this.#powerlines.finalize();\n  }\n}\n\n/**\n * Creates a new {@link ShellShockAPI} instance.\n *\n * @param options - The user configuration options.\n * @returns A promise that resolves to a {@link ShellShockAPI} instance.\n */\nexport async function createShellShock(\n  options: Partial<UserConfig> = {}\n): Promise<ShellShockAPI> {\n  return ShellShockAPI.from({ root: process.cwd(), ...options });\n}\n"],"mappings":";;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;;;;;;AAS/D,IAAa,gBAAb,MAAa,cAAc;CAC1B;CACA,aAAgB,KAAK,QAAK,eAAa;EAChC,MAAM,aAAa;;GAErB,GAAQ;;GAEL;AAIP,SAAA,IAAiB,qCAFP,cAAA,KAAA,eAAA,WAAA,GACV,iBAAiB,WAAA,EACA;;CAEjB,YAAA,YAAgB;AAChB,QAAA,aAAY;;CAEZ,MAAM,MAAA,cAAW;AACX,SAAC,MAAA,WAAkB,MAAA,aAAsB;;CAEjD,MAAO,QAAO,cAAkB;;;CAG7B,MAAI,KAAM,cAAe;AAC3B,SAAA,MAAA,WAAA,KAAA,aAAA;;CAEE,MAAK,MAAM,cAAgB;AAC5B,SAAA,MAAA,WAAA,MAAA,aAAA;;CAEC,MAAA,KAAY,cAAa;;;CAGxB,MAAM,WAAE;AACR,SAAA,MAAgB,WAAA,UAAA;;CAEhB,OAAM,SAAU;EAAC;EAAE;EAAA;EAAA;QAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;;;;;;;;AAQvB,eAAQ,iBAA6B,UAAA,EAAA,EAAA;;;;;;AAGrC,iBAAE,SAAA;OAAA;CAAA;CAAA;QAAA,EAAA;OAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"api.mjs","names":[],"sources":["../src/api.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  BuildInlineConfig,\n  CleanInlineConfig,\n  DocsInlineConfig,\n  LintInlineConfig,\n  PluginConfig,\n  PrepareInlineConfig\n} from \"powerlines\";\nimport { createPowerlines, PowerlinesAPI } from \"powerlines\";\nimport { plugin } from \"./plugin\";\nimport type { UserConfig } from \"./types/config\";\n\n/**\n * The Shell Shock API class.\n *\n * @remarks\n * This class provides methods to interact with the Shell Shock build system, including cleaning, preparing, linting, building, generating documentation, and finalizing projects.\n */\nexport class ShellShockAPI {\n  #powerlines: PowerlinesAPI;\n\n  public static async from(\n    config: UserConfig,\n    workspaceRoot?: string\n  ): Promise<ShellShockAPI> {\n    const userConfig = {\n      framework: \"shell-shock\",\n      ...config,\n      plugins: [plugin(), ...(config.plugins ?? [])] as PluginConfig<any>[]\n    };\n\n    const powerlines = await (workspaceRoot\n      ? PowerlinesAPI.from(workspaceRoot, userConfig)\n      : createPowerlines(userConfig));\n\n    return new ShellShockAPI(powerlines);\n  }\n\n  private constructor(powerlines: PowerlinesAPI) {\n    this.#powerlines = powerlines;\n  }\n\n  public async clean(inlineConfig: CleanInlineConfig): Promise<void> {\n    return this.#powerlines.clean(inlineConfig);\n  }\n\n  public async prepare(inlineConfig: PrepareInlineConfig): Promise<void> {\n    return this.#powerlines.prepare(inlineConfig);\n  }\n\n  public async lint(inlineConfig: LintInlineConfig): Promise<void> {\n    return this.#powerlines.lint(inlineConfig);\n  }\n\n  public async build(inlineConfig: BuildInlineConfig): Promise<void> {\n    return this.#powerlines.build(inlineConfig);\n  }\n\n  public async docs(inlineConfig: DocsInlineConfig): Promise<void> {\n    return this.#powerlines.docs(inlineConfig);\n  }\n\n  public async finalize(): Promise<void> {\n    return this.#powerlines.finalize();\n  }\n}\n\n/**\n * Creates a new {@link ShellShockAPI} instance.\n *\n * @param options - The user configuration options.\n * @returns A promise that resolves to a {@link ShellShockAPI} instance.\n */\nexport async function createShellShock(\n  options: Partial<UserConfig> = {}\n): Promise<ShellShockAPI> {\n  return ShellShockAPI.from({ root: process.cwd(), ...options });\n}\n"],"mappings":";;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;;;;;;AAS/D,IAAa,gBAAb,MAAa,cAAc;CAC1B;CACA,aAAgB,KAAK,QAAK,eAAa;EAChC,MAAM,aAAa;;GAErB,GAAQ;;GAEL;AAIP,SAAA,IAAiB,qCAFP,cAAA,KAAA,eAAA,WAAA,GACV,iBAAiB,WAAA,EACA;;CAEjB,YAAA,YAAgB;AAChB,QAAA,aAAY;;CAEZ,MAAM,MAAA,cAAW;AACX,SAAC,MAAA,WAAkB,MAAA,aAAsB;;CAEjD,MAAO,QAAO,cAAkB;;;CAG7B,MAAI,KAAM,cAAe;AAC3B,SAAA,MAAA,WAAA,KAAA,aAAA;;CAEE,MAAK,MAAM,cAAgB;AAC5B,SAAA,MAAA,WAAA,MAAA,aAAA;;CAEC,MAAA,KAAY,cAAa;;;CAGxB,MAAM,WAAE;AACR,SAAA,MAAgB,WAAA,UAAA;;CAEhB,OAAM,SAAU;EAAC;EAAE;EAAA;EAAA;QAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;;;;;;;;AAQvB,eAAQ,iBAA6B,UAAA,EAAA,EAAA;;;;;;AAGrC,iBAAE,SAAA;OAAA;CAAA;CAAA;QAAA,EAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/components/command-validation-logic.cjs

@@ -41,7 +41,7 @@ function CommandValidationLogic(props) {
 							}
 						}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 							get when() {
-								return (option.kind === require_types_command.CommandParameterKinds.string || option.kind === require_types_command.CommandParameterKinds.number) && option.variadic;
+								return option.variadic;
 							},
 							get children() {
 								return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
@@ -98,22 +98,56 @@ function CommandValidationLogic(props) {
 								return !option.variadic;
 							},
 							get fallback() {
-								return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
-									get condition() {
-										return _alloy_js_core.code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}.every(value => [${option.choices?.map((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(value))`;
+								return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+									get when() {
+										return !option.optional;
+									},
+									get fallback() {
+										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+											get condition() {
+												return _alloy_js_core.code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}.every(value => [${option.choices?.map((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(value))`;
+											},
+											get children() {
+												return _alloy_js_core.code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${(0, _stryke_string_format_list.list)(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}}\`);`;
+											}
+										});
 									},
 									get children() {
-										return _alloy_js_core.code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${(0, _stryke_string_format_list.list)(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}}\`);`;
+										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
+											get condition() {
+												return _alloy_js_core.code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}.every(value => [${option.choices?.map((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(value))`;
+											},
+											get children() {
+												return _alloy_js_core.code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${(0, _stryke_string_format_list.list)(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}}\`);`;
+											}
+										});
 									}
 								});
 							},
 							get children() {
-								return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
-									get condition() {
-										return _alloy_js_core.code`![${option.choices?.map((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`})`;
+								return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+									get when() {
+										return !option.optional;
+									},
+									get fallback() {
+										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+											get condition() {
+												return _alloy_js_core.code`![${option.choices?.map((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`})`;
+											},
+											get children() {
+												return _alloy_js_core.code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${(0, _stryke_string_format_list.list)(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}}\`);`;
+											}
+										});
 									},
 									get children() {
-										return _alloy_js_core.code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${(0, _stryke_string_format_list.list)(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}}\`);`;
+										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
+											get condition() {
+												return _alloy_js_core.code`![${option.choices?.map((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`})`;
+											},
+											get children() {
+												return _alloy_js_core.code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${(0, _stryke_string_format_list.list)(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, _stryke_string_format_camel_case.camelCase)(option.name)}`}}\`);`;
+											}
+										});
 									}
 								});
 							}
@@ -193,5 +227,4 @@ function CommandValidationLogic(props) {
 }
 
 //#endregion
-exports.CommandValidationLogic = CommandValidationLogic;
-//# sourceMappingURL=command-validation-logic.cjs.map
+exports.CommandValidationLogic = CommandValidationLogic;

package/dist/components/command-validation-logic.mjs

@@ -1,5 +1,5 @@
 import { CommandParameterKinds } from "../types/command.mjs";
-import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
 import { camelCase } from "@stryke/string-format/camel-case";
 import { For, Show, code } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
@@ -39,7 +39,7 @@ function CommandValidationLogic(props) {
 							}
 						}), createComponent(Show, {
 							get when() {
-								return (option.kind === CommandParameterKinds.string || option.kind === CommandParameterKinds.number) && option.variadic;
+								return option.variadic;
 							},
 							get children() {
 								return createComponent(ElseIfClause, {
@@ -96,22 +96,56 @@ function CommandValidationLogic(props) {
 								return !option.variadic;
 							},
 							get fallback() {
-								return createComponent(ElseIfClause, {
-									get condition() {
-										return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.every(value => [${option.choices?.map((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(value))`;
+								return createComponent(Show, {
+									get when() {
+										return !option.optional;
+									},
+									get fallback() {
+										return createComponent(IfStatement, {
+											get condition() {
+												return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.every(value => [${option.choices?.map((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(value))`;
+											},
+											get children() {
+												return code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${list(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+											}
+										});
 									},
 									get children() {
-										return code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${list(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+										return createComponent(ElseIfClause, {
+											get condition() {
+												return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.every(value => [${option.choices?.map((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(value))`;
+											},
+											get children() {
+												return code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${list(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+											}
+										});
 									}
 								});
 							},
 							get children() {
-								return createComponent(ElseIfClause, {
-									get condition() {
-										return code`![${option.choices?.map((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`})`;
+								return createComponent(Show, {
+									get when() {
+										return !option.optional;
+									},
+									get fallback() {
+										return createComponent(IfStatement, {
+											get condition() {
+												return code`![${option.choices?.map((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`})`;
+											},
+											get children() {
+												return code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${list(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+											}
+										});
 									},
 									get children() {
-										return code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${list(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+										return createComponent(ElseIfClause, {
+											get condition() {
+												return code`![${option.choices?.map((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice).join(", ")}].includes(options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`})`;
+											},
+											get children() {
+												return code`failures.push(\`Invalid value provided for the ${option.name} option - valid values include: ${list(option?.choices?.map((choice) => String(choice)) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+											}
+										});
 									}
 								});
 							}

package/dist/components/command-validation-logic.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-validation-logic.mjs","names":[],"sources":["../../src/components/command-validation-logic.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { list } from \"@stryke/string-format/list\";\nimport type {\n  CommandTree,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required ${option.name} option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === CommandParameterKinds.string ||\n                    option.kind === CommandParameterKinds.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required ${\n                    option.name\n                  } array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={(option as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the ${\n                      option.name\n                    } option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the ${\n                    option.name\n                  } array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n            <Show\n              when={\n                (option.kind === CommandParameterKinds.string ||\n                  option.kind === CommandParameterKinds.number) &&\n                option.choices &&\n                option.choices.length > 0\n              }>\n              <Show\n                when={!option.variadic}\n                fallback={\n                  <ElseIfClause\n                    condition={code`!options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    }.every(value => [${(\n                      option as StringCommandParameter | NumberCommandParameter\n                    ).choices\n                      ?.map(choice =>\n                        option.kind === CommandParameterKinds.string\n                          ? `\"${choice}\"`\n                          : choice\n                      )\n                      .join(\", \")}].includes(value))`}>\n                    {code`failures.push(\\`Invalid value provided for the ${\n                      option.name\n                    } option - valid values include: ${list(\n                      (\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      )?.choices?.map(choice => String(choice)) ?? []\n                    )}; provided: \\${options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    }}\\`);`}\n                  </ElseIfClause>\n                }>\n                <ElseIfClause\n                  condition={code`![${(\n                    option as StringCommandParameter | NumberCommandParameter\n                  ).choices\n                    ?.map(choice =>\n                      option.kind === CommandParameterKinds.string\n                        ? `\"${choice}\"`\n                        : choice\n                    )\n                    .join(\", \")}].includes(options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  })`}>\n                  {code`failures.push(\\`Invalid value provided for the ${\n                    option.name\n                  } option - valid values include: ${list(\n                    (\n                      option as StringCommandParameter | NumberCommandParameter\n                    )?.choices?.map(choice => String(choice)) ?? []\n                  )}; provided: \\${options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }}\\`);`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === CommandParameterKinds.string ||\n                    argument.kind === CommandParameterKinds.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required ${\n                    argument.name\n                  } array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the ${\n                      argument.name\n                    } positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the ${\n                    argument.name\n                  } array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-validation-logic.mjs","names":[],"sources":["../../src/components/command-validation-logic.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { list } from \"@stryke/string-format/list\";\nimport type {\n  CommandTree,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required ${option.name} option\");`}\n              </IfStatement>\n              <Show when={option.variadic}>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required ${\n                    option.name\n                  } array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === CommandParameterKinds.number}>\n              <Show\n                when={option.variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the ${\n                      option.name\n                    } option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the ${\n                    option.name\n                  } array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n            <Show\n              when={\n                (option.kind === CommandParameterKinds.string ||\n                  option.kind === CommandParameterKinds.number) &&\n                option.choices &&\n                option.choices.length > 0\n              }>\n              <Show\n                when={!option.variadic}\n                fallback={\n                  <Show\n                    when={!option.optional}\n                    fallback={\n                      <IfStatement\n                        condition={code`!options${\n                          option.name.includes(\"?\")\n                            ? `[\"${option.name}\"]`\n                            : `.${camelCase(option.name)}`\n                        }.every(value => [${(\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        ).choices\n                          ?.map(choice =>\n                            option.kind === CommandParameterKinds.string\n                              ? `\"${choice}\"`\n                              : choice\n                          )\n                          .join(\", \")}].includes(value))`}>\n                        {code`failures.push(\\`Invalid value provided for the ${\n                          option.name\n                        } option - valid values include: ${list(\n                          (\n                            option as\n                              | StringCommandParameter\n                              | NumberCommandParameter\n                          )?.choices?.map(choice => String(choice)) ?? []\n                        )}; provided: \\${options${\n                          option.name.includes(\"?\")\n                            ? `[\"${option.name}\"]`\n                            : `.${camelCase(option.name)}`\n                        }}\\`);`}\n                      </IfStatement>\n                    }>\n                    <ElseIfClause\n                      condition={code`!options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }.every(value => [${(\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      ).choices\n                        ?.map(choice =>\n                          option.kind === CommandParameterKinds.string\n                            ? `\"${choice}\"`\n                            : choice\n                        )\n                        .join(\", \")}].includes(value))`}>\n                      {code`failures.push(\\`Invalid value provided for the ${\n                        option.name\n                      } option - valid values include: ${list(\n                        (\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        )?.choices?.map(choice => String(choice)) ?? []\n                      )}; provided: \\${options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }}\\`);`}\n                    </ElseIfClause>\n                  </Show>\n                }>\n                <Show\n                  when={!option.optional}\n                  fallback={\n                    <IfStatement\n                      condition={code`![${(\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      ).choices\n                        ?.map(choice =>\n                          option.kind === CommandParameterKinds.string\n                            ? `\"${choice}\"`\n                            : choice\n                        )\n                        .join(\", \")}].includes(options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      })`}>\n                      {code`failures.push(\\`Invalid value provided for the ${\n                        option.name\n                      } option - valid values include: ${list(\n                        (\n                          option as\n                            | StringCommandParameter\n                            | NumberCommandParameter\n                        )?.choices?.map(choice => String(choice)) ?? []\n                      )}; provided: \\${options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }}\\`);`}\n                    </IfStatement>\n                  }>\n                  <ElseIfClause\n                    condition={code`![${(\n                      option as StringCommandParameter | NumberCommandParameter\n                    ).choices\n                      ?.map(choice =>\n                        option.kind === CommandParameterKinds.string\n                          ? `\"${choice}\"`\n                          : choice\n                      )\n                      .join(\", \")}].includes(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\\`Invalid value provided for the ${\n                      option.name\n                    } option - valid values include: ${list(\n                      (\n                        option as\n                          | StringCommandParameter\n                          | NumberCommandParameter\n                      )?.choices?.map(choice => String(choice)) ?? []\n                    )}; provided: \\${options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    }}\\`);`}\n                  </ElseIfClause>\n                </Show>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.args} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === CommandParameterKinds.string ||\n                    argument.kind === CommandParameterKinds.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required ${\n                    argument.name\n                  } array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === CommandParameterKinds.number}>\n              <Show\n                when={(argument as NumberCommandParameter).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the ${\n                      argument.name\n                    } positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the ${\n                    argument.name\n                  } array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/docs.cjs

@@ -158,5 +158,4 @@ function CommandDocsFile(props) {
 exports.CommandDocs = CommandDocs;
 exports.CommandDocsFile = CommandDocsFile;
 exports.CommandDocsUsageExample = CommandDocsUsageExample;
-exports.CommandOptionsDocs = CommandOptionsDocs;
-//# sourceMappingURL=docs.cjs.map
+exports.CommandOptionsDocs = CommandOptionsDocs;

package/dist/components/exec-builtin.cjs

@@ -41,14 +41,7 @@ function ExecBuiltin(props) {
 			});
 		},
 		get builtinImports() {
-			return (0, defu.default)(rest.builtinImports ?? {}, { env: [
-				"isWindows",
-				"env",
-				{
-					name: "Env",
-					type: true
-				}
-			] });
+			return (0, defu.default)(rest.builtinImports ?? {}, { env: ["isWindows", "env"] });
 		},
 		get children() {
 			return [
@@ -60,32 +53,32 @@ function ExecBuiltin(props) {
 					}],
 					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") {
-    return true;
-  }
-  if (cmd === "node" || cmd === "node.exe") {
-    const script = argv[1] ?? "";
+          const shouldSuppressNpmFund = (() => {
+            const cmd = basename(argv[0] ?? "");
+            if (cmd === "npm" || cmd === "npm.cmd" || cmd === "npm.exe") {
+              return true;
+            }
+            if (cmd === "node" || cmd === "node.exe") {
+              const script = argv[1] ?? "";
 
-    return script.includes("npm-cli.js");
-  }
-  return false;
-})();
+              return script.includes("npm-cli.js");
+            }
+            return false;
+          })();
 
-const result = Object.fromEntries(
-  Object.entries({
-  ...env,
-  ...(params.env ?? {})
-})
-  .filter(([, value]) => value !== undefined)
-  .map(([key, value]) => [key, String(value)])
-);
-if (shouldSuppressNpmFund) {
-  result.NPM_CONFIG_FUND ??= "false";
-  result.npm_config_fund ??= "false";
-}
-return result; `
+          const result = Object.fromEntries(
+            Object.entries({
+            ...env,
+            ...(params.env ?? {})
+          })
+            .filter(([, value]) => value !== undefined)
+            .map(([key, value]) => [key, String(value)])
+          );
+          if (shouldSuppressNpmFund) {
+            result.NPM_CONFIG_FUND ??= "false";
+            result.npm_config_fund ??= "false";
+          }
+          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, {
@@ -96,11 +89,11 @@ return result; `
 					}],
 					returnType: "boolean",
 					children: _alloy_js_core.code`if (!isWindows) {
-  return false;
-}
-const ext = extname(resolvedCommand).toLowerCase();
+            return false;
+          }
+          const ext = extname(resolvedCommand).toLowerCase();
 
-return ext === ".cmd" || ext === ".bat";`
+          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, {
@@ -111,15 +104,15 @@ return ext === ".cmd" || ext === ".bat";`
 					}],
 					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."
-  );
-}
-if (!arg.includes(" ") && !arg.includes('"')) {
-  return arg;
-}
-return \`"\${arg.replace(/"/g, '""')}"\`;`
+          throw new Error(
+            \`Unsafe Windows cmd.exe argument detected: \${JSON.stringify(arg)}. \` +
+              "Pass an explicit shell-wrapper argv at the call site instead."
+          );
+        }
+        if (!arg.includes(" ") && !arg.includes('"')) {
+          return arg;
+        }
+        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, {
@@ -133,8 +126,8 @@ return \`"\${arg.replace(/"/g, '""')}"\`;`
 					}],
 					returnType: "string",
 					children: _alloy_js_core.code`return [escapeForCmdExe(resolvedCommand), ...args.map(escapeForCmdExe)].join(
-  " "
-);`
+          " "
+        ); `
 				}),
 				(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, {
@@ -146,26 +139,26 @@ return \`"\${arg.replace(/"/g, '""')}"\`;`
 					}],
 					returnType: "string[] | null",
 					children: _alloy_js_core.code`if (!isWindows || argv.length === 0) {
-  return null;
-}
-const base = basename(argv[0] ?? "")
-  .toLowerCase()
-  .replace(/\.(?:cmd|exe|bat)$/, "");
-const cliName =
-  base === "npx" ? "npx-cli.js" : base === "npm" ? "npm-cli.js" : null;
-if (!cliName) {
-  return null;
-}
-const nodeDir = dirname(process.execPath);
-const cliPath = join(nodeDir, "node_modules", "npm", "bin", cliName);
-if (!existsSync(cliPath)) {
-  const command = argv[0] ?? "";
-  const ext = extname(command).toLowerCase();
-  const shimmedCommand = ext ? command : \`\${command}.cmd\`;
+            return null;
+          }
+          const base = basename(argv[0] ?? "")
+            .toLowerCase()
+            .replace(/\.(?:cmd|exe|bat)$/, "");
+          const cliName =
+            base === "npx" ? "npx-cli.js" : base === "npm" ? "npm-cli.js" : null;
+          if (!cliName) {
+            return null;
+          }
+          const nodeDir = dirname(process.execPath);
+          const cliPath = join(nodeDir, "node_modules", "npm", "bin", cliName);
+          if (!existsSync(cliPath)) {
+            const command = argv[0] ?? "";
+            const ext = extname(command).toLowerCase();
+            const shimmedCommand = ext ? command : \`\${command}.cmd\`;
 
-  return [shimmedCommand, ...argv.slice(1)];
-}
-return [process.execPath, cliPath, ...argv.slice(1)];`
+            return [shimmedCommand, ...argv.slice(1)];
+          }
+          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, {
@@ -177,16 +170,16 @@ return [process.execPath, cliPath, ...argv.slice(1)];`
 					}],
 					returnType: "string",
 					children: _alloy_js_core.code`if (!isWindows) {
-  return command;
-}
-const base = basename(command).toLowerCase();
-if (extname(base)) {
-  return command;
-}
-if (["pnpm", "yarn"].includes(base)) {
-  return \`\${command}.cmd\`;
-}
-return command;`
+            return command;
+          }
+          const base = basename(command).toLowerCase();
+          if (extname(base)) {
+            return command;
+          }
+          if (["pnpm", "yarn"].includes(base)) {
+            return \`\${command}.cmd\`;
+          }
+          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, {
@@ -197,12 +190,12 @@ return command;`
 					}],
 					returnType: "[\"pipe\" | \"inherit\" | \"ignore\", \"pipe\", \"pipe\"]",
 					children: _alloy_js_core.code`const stdin = params.hasInput
-  ? "pipe"
-  : params.preferInherit
-    ? "inherit"
-    : "pipe";
+          ? "pipe"
+          : params.preferInherit
+            ? "inherit"
+            : "pipe";
 
-return [stdin, "pipe", "pipe"];`
+        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, {
@@ -213,16 +206,16 @@ return [stdin, "pipe", "pipe"];`
 					}],
 					returnType: "number | null",
 					children: _alloy_js_core.code`return (
-  params.explicitCode ??
-  params.childExitCode ??
-  (params.usesWindowsExitCodeShim &&
-  params.resolvedSignal == null &&
-  !params.timedOut &&
-  !params.noOutputTimedOut &&
-  !params.killIssuedByTimeout
-    ? 0
-    : null)
-);`
+          params.explicitCode ??
+          params.childExitCode ??
+          (params.usesWindowsExitCodeShim &&
+          params.resolvedSignal == null &&
+          !params.timedOut &&
+          !params.noOutputTimedOut &&
+          !params.killIssuedByTimeout
+            ? 0
+            : null)
+        ); `
 				}),
 				(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, {
@@ -233,12 +226,12 @@ return [stdin, "pipe", "pipe"];`
 					}],
 					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;`
+          // \`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, _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." }),
@@ -717,5 +710,4 @@ return new Promise((resolve, reject) => {
 }
 
 //#endregion
-exports.ExecBuiltin = ExecBuiltin;
-//# sourceMappingURL=exec-builtin.cjs.map
+exports.ExecBuiltin = ExecBuiltin;