@shell-shock/core 0.17.10 → 0.17.12

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

@@ -1,9 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_types_command = require('../types/command.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
 let _alloy_js_core = require("@alloy-js/core");
+let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
 let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let _alloy_js_typescript = require("@alloy-js/typescript");
 let _stryke_string_format_list = require("@stryke/string-format/list");
@@ -40,7 +38,7 @@ function CommandValidationLogic(props) {
 				return __assignType((option) => [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 						get when() {
-							return !option.optional;
+							return option.required;
 						},
 						get children() {
 							return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
@@ -69,7 +67,7 @@ function CommandValidationLogic(props) {
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 						get when() {
-							return option.kind === require_types_command.CommandParameterKinds.number;
+							return option.type === "number";
 						},
 						get children() {
 							return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
@@ -101,7 +99,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.choices && option.choices.length > 0;
+							return (option.type === "string" || option.type === "number") && option.choices && option.choices.length > 0;
 						},
 						get children() {
 							return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
@@ -111,12 +109,12 @@ function CommandValidationLogic(props) {
 								get fallback() {
 									return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 										get when() {
-											return !option.optional;
+											return option.required;
 										},
 										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(__assignType((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice, [
+													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(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -134,7 +132,7 @@ function CommandValidationLogic(props) {
 										get children() {
 											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(__assignType((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice, [
+													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(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -154,12 +152,12 @@ function CommandValidationLogic(props) {
 								get children() {
 									return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 										get when() {
-											return !option.optional;
+											return option.required;
 										},
 										get fallback() {
 											return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
 												get condition() {
-													return _alloy_js_core.code`![${option.choices?.map(__assignType((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice, [
+													return _alloy_js_core.code`![${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -177,7 +175,7 @@ function CommandValidationLogic(props) {
 										get children() {
 											return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
 												get condition() {
-													return _alloy_js_core.code`![${option.choices?.map(__assignType((choice) => option.kind === require_types_command.CommandParameterKinds.string ? `"${choice}"` : choice, [
+													return _alloy_js_core.code`![${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -213,7 +211,7 @@ function CommandValidationLogic(props) {
 			get children() {
 				return __assignType((argument) => [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 					get when() {
-						return !argument.optional;
+						return argument.required;
 					},
 					get children() {
 						return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
@@ -241,7 +239,7 @@ function CommandValidationLogic(props) {
 					}
 				}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 					get when() {
-						return argument.kind === require_types_command.CommandParameterKinds.number;
+						return argument.type === "number";
 					},
 					get children() {
 						return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
@@ -289,4 +287,5 @@ CommandValidationLogic.__type = [
 
 //#endregion
 exports.CommandValidationLogic = CommandValidationLogic;
-exports.__ΩCommandValidationLogicProps = __ΩCommandValidationLogicProps;
+exports.__ΩCommandValidationLogicProps = __ΩCommandValidationLogicProps;
+//# sourceMappingURL=command-validation-logic.cjs.map

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

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

package/dist/components/command-validation-logic.d.cts

@@ -1,6 +1,4 @@
 import { CommandTree } from "../types/command.cjs";
-import * as _$_alloy_js_core0 from "@alloy-js/core";
-
 //#region src/components/command-validation-logic.d.ts
 interface CommandValidationLogicProps {
   command: CommandTree;
@@ -8,7 +6,7 @@ interface CommandValidationLogicProps {
 /**
  * A component that generates command validation logic for required options and arguments.
  */
-declare function CommandValidationLogic(props: CommandValidationLogicProps): _$_alloy_js_core0.Children;
+declare function CommandValidationLogic(props: CommandValidationLogicProps): import("@alloy-js/core").Children;
 //#endregion
 export { CommandValidationLogic, CommandValidationLogicProps };
 //# sourceMappingURL=command-validation-logic.d.cts.map

package/dist/components/command-validation-logic.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"command-validation-logic.d.cts","names":[],"sources":["../../src/components/command-validation-logic.tsx"],"mappings":";;;;UAkCiB,2BAAA;EACf,OAAA,EAAS,WAAA;AAAA;;AADX;;iBAOgB,sBAAA,CAAuB,KAAA,EAAO,2BAAA,GAA2B,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"command-validation-logic.d.cts","names":[],"sources":["../../src/components/command-validation-logic.tsx"],"mappings":";;UAiCiB,2BAAA;EACf,OAAA,EAAS,WAAW;AAAA;AADtB;;;AAAA,iBAOgB,sBAAA,CAAuB,KAAA,EAAO,2BAA2B,4BAAA,QAAA"}

package/dist/components/command-validation-logic.d.mts

@@ -1,6 +1,4 @@
 import { CommandTree } from "../types/command.mjs";
-import * as _$_alloy_js_core0 from "@alloy-js/core";
-
 //#region src/components/command-validation-logic.d.ts
 interface CommandValidationLogicProps {
   command: CommandTree;
@@ -8,7 +6,7 @@ interface CommandValidationLogicProps {
 /**
  * A component that generates command validation logic for required options and arguments.
  */
-declare function CommandValidationLogic(props: CommandValidationLogicProps): _$_alloy_js_core0.Children;
+declare function CommandValidationLogic(props: CommandValidationLogicProps): import("@alloy-js/core").Children;
 //#endregion
 export { CommandValidationLogic, CommandValidationLogicProps };
 //# sourceMappingURL=command-validation-logic.d.mts.map

package/dist/components/command-validation-logic.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-validation-logic.d.mts","names":[],"sources":["../../src/components/command-validation-logic.tsx"],"mappings":";;;;UAkCiB,2BAAA;EACf,OAAA,EAAS,WAAA;AAAA;;AADX;;iBAOgB,sBAAA,CAAuB,KAAA,EAAO,2BAAA,GAA2B,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"command-validation-logic.d.mts","names":[],"sources":["../../src/components/command-validation-logic.tsx"],"mappings":""}

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

@@ -1,7 +1,6 @@
-import { CommandParameterKinds } from "../types/command.mjs";
 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 { camelCase } from "@stryke/string-format/camel-case";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { ElseIfClause, IfStatement, VarDeclaration } from "@alloy-js/typescript";
 import { list } from "@stryke/string-format/list";
@@ -38,7 +37,7 @@ function CommandValidationLogic(props) {
 				return __assignType((option) => [
 					createComponent(Show, {
 						get when() {
-							return !option.optional;
+							return option.required;
 						},
 						get children() {
 							return [createComponent(IfStatement, {
@@ -67,7 +66,7 @@ function CommandValidationLogic(props) {
 					}),
 					createComponent(Show, {
 						get when() {
-							return option.kind === CommandParameterKinds.number;
+							return option.type === "number";
 						},
 						get children() {
 							return createComponent(Show, {
@@ -99,7 +98,7 @@ function CommandValidationLogic(props) {
 					}),
 					createComponent(Show, {
 						get when() {
-							return (option.kind === CommandParameterKinds.string || option.kind === CommandParameterKinds.number) && option.choices && option.choices.length > 0;
+							return (option.type === "string" || option.type === "number") && option.choices && option.choices.length > 0;
 						},
 						get children() {
 							return createComponent(Show, {
@@ -109,12 +108,12 @@ function CommandValidationLogic(props) {
 								get fallback() {
 									return createComponent(Show, {
 										get when() {
-											return !option.optional;
+											return option.required;
 										},
 										get fallback() {
 											return createComponent(IfStatement, {
 												get condition() {
-													return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.every(value => [${option.choices?.map(__assignType((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice, [
+													return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.every(value => [${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -132,7 +131,7 @@ function CommandValidationLogic(props) {
 										get children() {
 											return createComponent(ElseIfClause, {
 												get condition() {
-													return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.every(value => [${option.choices?.map(__assignType((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice, [
+													return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.every(value => [${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -152,12 +151,12 @@ function CommandValidationLogic(props) {
 								get children() {
 									return createComponent(Show, {
 										get when() {
-											return !option.optional;
+											return option.required;
 										},
 										get fallback() {
 											return createComponent(IfStatement, {
 												get condition() {
-													return code`![${option.choices?.map(__assignType((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice, [
+													return code`![${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -175,7 +174,7 @@ function CommandValidationLogic(props) {
 										get children() {
 											return createComponent(ElseIfClause, {
 												get condition() {
-													return code`![${option.choices?.map(__assignType((choice) => option.kind === CommandParameterKinds.string ? `"${choice}"` : choice, [
+													return code`![${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
 														"choice",
 														"",
 														"P\"2!\"/\""
@@ -211,7 +210,7 @@ function CommandValidationLogic(props) {
 			get children() {
 				return __assignType((argument) => [createComponent(Show, {
 					get when() {
-						return !argument.optional;
+						return argument.required;
 					},
 					get children() {
 						return [createComponent(IfStatement, {
@@ -239,7 +238,7 @@ function CommandValidationLogic(props) {
 					}
 				}), createComponent(Show, {
 					get when() {
-						return argument.kind === CommandParameterKinds.number;
+						return argument.type === "number";
 					},
 					get children() {
 						return createComponent(Show, {

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 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 when={argument.variadic}>\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":[],"mappings":""}

package/dist/components/docs.cjs

@@ -1,13 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_contexts_command = require('../contexts/command.cjs');
 const require_docs_helpers = require('../helpers/docs-helpers.cjs');
 const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
 const require_reflect = require('../plugin-utils/reflect.cjs');
 const require_components_usage = require('./usage.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let defu = require("defu");
 let _alloy_js_core = require("@alloy-js/core");
+let defu = require("defu");
 let _alloy_js_markdown = require("@alloy-js/markdown");
 let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
@@ -49,7 +48,7 @@ function CommandOptionsDocs(props) {
 				name: option.name.trim(),
 				description: option.description.trim(),
 				defaultValue: option.default ? String(option.default)?.includes("\"") ? option.default : `\`${Array.isArray(option.default) ? option.default.join(", ") : option.default}\`` : "",
-				required: option.optional || option.default ? "" : "✔"
+				required: !option.required || option.default ? "" : "✔"
 			};
 		}, [
 			"option",
@@ -226,8 +225,8 @@ function CommandDocsFile(props) {
 						id: command.id,
 						name: command.name,
 						path: command.path,
-						reference: command.reference,
-						isVirtual: command.isVirtual,
+						reference: command.docs,
+						virtual: command.virtual,
 						title: command.title,
 						description: command.description,
 						tags: command.tags
@@ -262,4 +261,5 @@ exports.CommandOptionsDocs = CommandOptionsDocs;
 exports.__ΩCommandDocsFileProps = __ΩCommandDocsFileProps;
 exports.__ΩCommandDocsProps = __ΩCommandDocsProps;
 exports.__ΩCommandDocsUsageExampleProps = __ΩCommandDocsUsageExampleProps;
-exports.__ΩCommandOptionsDocsProps = __ΩCommandOptionsDocsProps;
+exports.__ΩCommandOptionsDocsProps = __ΩCommandOptionsDocsProps;
+//# sourceMappingURL=docs.cjs.map

package/dist/components/docs.cjs.map

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

package/dist/components/docs.d.cts

@@ -1,5 +1,4 @@
 import { CommandTree } from "../types/command.cjs";
-import * as _$_alloy_js_core0 from "@alloy-js/core";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
@@ -12,7 +11,7 @@ interface CommandOptionsDocsProps {
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _$_alloy_js_core0.Children;
+declare function CommandOptionsDocs(props: CommandOptionsDocsProps): import("@alloy-js/core").Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -31,7 +30,7 @@ interface CommandDocsUsageExampleProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _$_alloy_js_core0.Children;
+declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): import("@alloy-js/core").Children;
 interface CommandDocsProps {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -56,7 +55,7 @@ interface CommandDocsProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocs(props: CommandDocsProps): _$_alloy_js_core0.Children;
+declare function CommandDocs(props: CommandDocsProps): import("@alloy-js/core").Children;
 interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -75,7 +74,7 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
 /**
  * Generates the markdown documentation file for a command.
  */
-declare function CommandDocsFile(props: CommandDocsFileProps): _$_alloy_js_core0.Children;
+declare function CommandDocsFile(props: CommandDocsFileProps): import("@alloy-js/core").Children;
 //#endregion
 export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
 //# sourceMappingURL=docs.d.cts.map

package/dist/components/docs.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.cts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":";;;;;UAmCiB,uBAAA;;;AAAjB;EAIE,OAAA,EAAS,WAAA;AAAA;;;AAMX;iBAAgB,kBAAA,CAAmB,KAAA,EAAO,uBAAA,GAAuB,iBAAA,CAAA,QAAA;AAAA,UA4BhD,4BAAA;EA5BgD;;;;;;AA4BjE;;EASE,cAAA;EAKoB;;;EAApB,OAAA,EAAS,WAAA;AAAA;;AAMX;;iBAAgB,uBAAA,CAAwB,KAAA,EAAO,4BAAA,GAA4B,iBAAA,CAAA,QAAA;AAAA,UAsB1D,gBAAA;EAtB8B;;;;;AAsB/C;;;EASE,WAAA;EAYyB;;;EAPzB,OAAA,EAAS,WAAA;EALT;;;;;EAYA,aAAA,GAAgB,QAAA,CAAS,4BAAA;AAAA;;AAM3B;;iBAAgB,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,iBAAA,CAAA,QAAA;AAAA,UAwClC,oBAAA,SAA6B,OAAA,CAAQ,iBAAA;EAxCnB;;;;;AAwCnC;;;EASE,WAAA;EAKS;;;EAAT,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,eAAA,CAAgB,KAAA,EAAO,oBAAA,GAAoB,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"docs.d.cts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":";;;;UAmCiB,uBAAA;;AAAjB;;EAIE,OAAA,EAAS,WAAW;AAAA;AAAA;AAMtB;;AANsB,iBAMN,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA;AAAA,UA4BhD,4BAAA;EA5ByB;;;;AAAuB;AA4BjE;;;EASE,cAAA;EAAA;;;EAKA,OAAA,EAAS,WAAW;AAAA;AAMtB;;;AAAA,iBAAgB,uBAAA,CAAwB,KAAA,EAAO,4BAA4B,4BAAA,QAAA;AAAA,UAsB1D,gBAAA;EAtBuB;;;AAAmC;AAsB3E;;;;EASE,WAAA;EAYgB;;;EAPhB,OAAA,EAAS,WAAA;EAAT;;;;;EAOA,aAAA,GAAgB,QAAA,CAAS,4BAAA;AAAA;AAM3B;;;AAAA,iBAAgB,WAAA,CAAY,KAAA,EAAO,gBAAgB,4BAAA,QAAA;AAAA,UAwClC,oBAAA,SAA6B,OAAA,CAAQ,iBAAA;EAxC1B;;;AAAuB;AAwCnD;;;;EASE,WAAA;EAT4C;;;EAc5C,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,eAAA,CAAgB,KAAA,EAAO,oBAAoB,4BAAA,QAAA"}

package/dist/components/docs.d.mts

@@ -1,5 +1,4 @@
 import { CommandTree } from "../types/command.mjs";
-import * as _$_alloy_js_core0 from "@alloy-js/core";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
@@ -12,7 +11,7 @@ interface CommandOptionsDocsProps {
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _$_alloy_js_core0.Children;
+declare function CommandOptionsDocs(props: CommandOptionsDocsProps): import("@alloy-js/core").Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -31,7 +30,7 @@ interface CommandDocsUsageExampleProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _$_alloy_js_core0.Children;
+declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): import("@alloy-js/core").Children;
 interface CommandDocsProps {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -56,7 +55,7 @@ interface CommandDocsProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocs(props: CommandDocsProps): _$_alloy_js_core0.Children;
+declare function CommandDocs(props: CommandDocsProps): import("@alloy-js/core").Children;
 interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -75,7 +74,7 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
 /**
  * Generates the markdown documentation file for a command.
  */
-declare function CommandDocsFile(props: CommandDocsFileProps): _$_alloy_js_core0.Children;
+declare function CommandDocsFile(props: CommandDocsFileProps): import("@alloy-js/core").Children;
 //#endregion
 export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
 //# sourceMappingURL=docs.d.mts.map

package/dist/components/docs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.mts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":";;;;;UAmCiB,uBAAA;;;AAAjB;EAIE,OAAA,EAAS,WAAA;AAAA;;;AAMX;iBAAgB,kBAAA,CAAmB,KAAA,EAAO,uBAAA,GAAuB,iBAAA,CAAA,QAAA;AAAA,UA4BhD,4BAAA;EA5BgD;;;;;;AA4BjE;;EASE,cAAA;EAKoB;;;EAApB,OAAA,EAAS,WAAA;AAAA;;AAMX;;iBAAgB,uBAAA,CAAwB,KAAA,EAAO,4BAAA,GAA4B,iBAAA,CAAA,QAAA;AAAA,UAsB1D,gBAAA;EAtB8B;;;;;AAsB/C;;;EASE,WAAA;EAYyB;;;EAPzB,OAAA,EAAS,WAAA;EALT;;;;;EAYA,aAAA,GAAgB,QAAA,CAAS,4BAAA;AAAA;;AAM3B;;iBAAgB,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,iBAAA,CAAA,QAAA;AAAA,UAwClC,oBAAA,SAA6B,OAAA,CAAQ,iBAAA;EAxCnB;;;;;AAwCnC;;;EASE,WAAA;EAKS;;;EAAT,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,eAAA,CAAgB,KAAA,EAAO,oBAAA,GAAoB,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"docs.d.mts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":""}

package/dist/components/docs.mjs

@@ -4,8 +4,8 @@ import { getAppBin } from "../plugin-utils/context-helpers.mjs";
 import { sortOptions } from "../plugin-utils/reflect.mjs";
 import { Usage } from "./usage.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { defu } from "defu";
 import { For, Show, code, memo as memo$1 } from "@alloy-js/core";
+import { defu } from "defu";
 import { Heading } from "@alloy-js/markdown";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
@@ -47,7 +47,7 @@ function CommandOptionsDocs(props) {
 				name: option.name.trim(),
 				description: option.description.trim(),
 				defaultValue: option.default ? String(option.default)?.includes("\"") ? option.default : `\`${Array.isArray(option.default) ? option.default.join(", ") : option.default}\`` : "",
-				required: option.optional || option.default ? "" : "✔"
+				required: !option.required || option.default ? "" : "✔"
 			};
 		}, [
 			"option",
@@ -224,8 +224,8 @@ function CommandDocsFile(props) {
 						id: command.id,
 						name: command.name,
 						path: command.path,
-						reference: command.reference,
-						isVirtual: command.isVirtual,
+						reference: command.docs,
+						virtual: command.virtual,
 						title: command.title,
 						description: command.description,
 						tags: command.tags

package/dist/components/docs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"docs.mjs","names":[],"sources":["../../src/components/docs.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, memo, Show } from \"@alloy-js/core\";\nimport { Heading } from \"@alloy-js/markdown\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { MarkdownFileProps } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownFile } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownTable } from \"@powerlines/plugin-alloy/markdown/components/markdown-table\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { defu } from \"defu\";\nimport { CommandContext } from \"../contexts/command\";\nimport { getDocsOutputPath } from \"../helpers/docs-helpers\";\nimport { getAppBin } from \"../plugin-utils/context-helpers\";\nimport { sortOptions } from \"../plugin-utils/reflect\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { Usage } from \"./usage\";\n\nexport interface CommandOptionsDocsProps {\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the options markdown documentation for a command.\n */\nexport function CommandOptionsDocs(props: CommandOptionsDocsProps) {\n  const { command } = props;\n  if (Object.keys(command.options).length === 0) {\n    return code`This command does not have any options.`;\n  }\n\n  return (\n    <MarkdownTable\n      data={sortOptions(Object.values(command.options)).map(option => {\n        return {\n          name: option.name.trim(),\n          description: option.description.trim(),\n          defaultValue: option.default\n            ? String(option.default)?.includes('\"')\n              ? option.default\n              : `\\`${\n                  Array.isArray(option.default)\n                    ? option.default.join(\", \")\n                    : option.default\n                }\\``\n            : \"\",\n          required: option.optional || option.default ? \"\" : \"✔\"\n        };\n      })}\n    />\n  );\n}\n\nexport interface CommandDocsUsageExampleProps {\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The command to generate the usage example for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocsUsageExample(props: CommandDocsUsageExampleProps) {\n  const { packageManager = \"npm\", command } = props;\n\n  const context = usePowerlines<Context>();\n\n  return (\n    <>\n      <hbr />\n      {code`\\`\\`\\`bash `}\n      <hbr />\n      <Usage\n        command={command}\n        bin={getAppBin(context)}\n        packageManager={packageManager}\n      />\n      <hbr />\n      {code`\\`\\`\\``}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandDocsProps {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n\n  /**\n   * Optional usage examples to include in the documentation.\n   *\n   * @defaultValue `[\"npm\"]`\n   */\n  usageExamples?: Required<CommandDocsUsageExampleProps>[\"packageManager\"][];\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocs(props: CommandDocsProps) {\n  const { levelOffset = 0, command, usageExamples } = props;\n\n  return (\n    <>\n      <Heading level={1 + levelOffset}>{command.title}</Heading>\n      <Spacing />\n      {code`${command.description}`}\n      <Spacing />\n      <Heading level={2 + levelOffset}>Usage</Heading>\n      <Spacing />\n      {code`The ${command.name} command can be executed using the following syntax: `}\n      <Spacing />\n      <Show\n        when={usageExamples && usageExamples.length > 0}\n        fallback={\n          <CommandDocsUsageExample packageManager=\"npm\" command={command} />\n        }>\n        <For each={usageExamples!} hardline>\n          {packageManager => (\n            <CommandDocsUsageExample\n              packageManager={packageManager}\n              command={command}\n            />\n          )}\n        </For>\n      </Show>\n      <Spacing />\n      <Heading level={2 + levelOffset}>Options</Heading>\n      <Spacing />\n      {code`The following options are available for the ${\n        command.name\n      } command:`}\n      <Spacing />\n      <CommandOptionsDocs command={command} />\n      <Spacing />\n    </>\n  );\n}\n\nexport interface CommandDocsFileProps extends Partial<MarkdownFileProps> {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation file for a command.\n */\nexport function CommandDocsFile(props: CommandDocsFileProps) {\n  const { levelOffset = 0, command, frontMatter, ...rest } = props;\n\n  const context = usePowerlines<Context>();\n  const usageExamples = memo(\n    () => [\"npm\", \"yarn\", \"pnpm\", \"bun\"] as CommandDocsProps[\"usageExamples\"]\n  );\n\n  return (\n    <CommandContext.Provider value={command}>\n      <MarkdownFile\n        path={joinPaths(getDocsOutputPath(context), `${command.path}.md`)}\n        {...rest}\n        frontMatter={defu(frontMatter ?? {}, {\n          id: command.id,\n          name: command.name,\n          path: command.path,\n          reference: command.reference,\n          isVirtual: command.isVirtual,\n          title: command.title,\n          description: command.description,\n          tags: command.tags\n        })}>\n        <CommandDocs\n          levelOffset={levelOffset}\n          command={command}\n          usageExamples={usageExamples()}\n        />\n      </MarkdownFile>\n    </CommandContext.Provider>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"docs.mjs","names":[],"sources":[],"mappings":""}

package/dist/components/exec-builtin.cjs

@@ -1,10 +1,9 @@
 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 _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _alloy_js_core = require("@alloy-js/core");
 let defu = require("defu");
 defu = require_runtime.__toESM(defu);
-let _alloy_js_core = require("@alloy-js/core");
 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");
@@ -330,10 +329,8 @@ function ExecBuiltin(props) {
 								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, {
-										get type() {
-											return _powerlines_deepkit_vendor_type.ReflectionKind.number;
-										},
-										defaultValue: "300000"
+										type: "number",
+										defaultValue: "300_000"
 									});
 								}
 							}),
@@ -419,14 +416,14 @@ function ExecBuiltin(props) {
 					}, {
 						name: "optionsOrTimeoutMs",
 						type: "number | SpawnOptions",
-						default: "300000"
+						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
@@ -674,7 +671,7 @@ return new Promise((resolve, reject) => {
 					}, {
 						name: "optionsOrTimeoutMs",
 						type: "number | SpawnOptions",
-						default: "300000"
+						default: "300_000"
 					}],
 					returnType: "Promise<string>",
 					children: _alloy_js_core.code`const spawnResult = await spawn(argv, optionsOrTimeoutMs);
@@ -718,7 +715,7 @@ return new Promise((resolve, reject) => {
 					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
@@ -745,4 +742,5 @@ ExecBuiltin.__type = [
 
 //#endregion
 exports.ExecBuiltin = ExecBuiltin;
-exports.__ΩExecBuiltinProps = __ΩExecBuiltinProps;
+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":""}