@shell-shock/core 0.17.8 → 0.17.11

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,2 +1,289 @@
-import{CommandParameterKinds as e}from"../types/command.mjs";import{createComponent as t,createIntrinsic as n}from"@alloy-js/core/jsx-runtime";import{camelCase as r}from"@stryke/string-format/camel-case";import{For as i,Show as a,code as o}from"@alloy-js/core";import{Spacing as s}from"@powerlines/plugin-alloy/core/components/spacing";import{ElseIfClause as c,IfStatement as l,VarDeclaration as u}from"@alloy-js/typescript";import{list as d}from"@stryke/string-format/list";function f(e,t){return e.__type=t,e}const p=[`CommandTree`,`command`,`CommandValidationLogicProps`,`P"w!4"Mw#y`];function m(p){let{command:m}=p;return[t(u,{name:`failures`,type:`string[]`,initializer:o`[];`}),n(`hbr`,{}),t(i,{get each(){return Object.values(m.options??{})},doubleHardline:!0,get children(){return f(n=>[t(a,{get when(){return!n.optional},get children(){return[t(l,{get condition(){return o`!options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}`},get children(){return o`failures.push("Missing required \\"${n.name}\\" option");`}}),t(a,{get when(){return n.variadic},get children(){return t(c,{get condition(){return o`options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}.length === 0`},get children(){return o`failures.push("No values were provided to the required \\"${n.name}\\" array option");`}})}})]}}),t(a,{get when(){return n.kind===e.number},get children(){return t(a,{get when(){return n.variadic},get fallback(){return t(l,{get condition(){return o`options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`} && Number.isNaN(options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`})`},get children(){return o`failures.push("Invalid numeric value provided for the \\"${n.name}\\" option");`}})},get children(){return t(l,{get condition(){return o`options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}.some(value => Number.isNaN(value))`},get children(){return o`failures.push("Invalid numeric value provided in the \\"${n.name}\\" array option");`}})}})}}),t(a,{get when(){return(n.kind===e.string||n.kind===e.number)&&n.choices&&n.choices.length>0},get children(){return t(a,{get when(){return!n.variadic},get fallback(){return t(a,{get when(){return!n.optional},get fallback(){return t(l,{get condition(){return o`!options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}.every(value => [${n.choices?.map(f(t=>n.kind===e.string?`"${t}"`:t,[`choice`,``,`P"2!"/"`])).join(`, `)}].includes(value))`},get children(){return o`failures.push(\`Invalid value provided for the \\"${n.name}\\" option - valid values include: ${d(n?.choices?.map(f(e=>String(e),[`choice`,``,`P"2!"/"`]))??[])}; provided: \${options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}}\`);`}})},get children(){return t(c,{get condition(){return o`!options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}.every(value => [${n.choices?.map(f(t=>n.kind===e.string?`"${t}"`:t,[`choice`,``,`P"2!"/"`])).join(`, `)}].includes(value))`},get children(){return o`failures.push(\`Invalid value provided for the \\"${n.name}\\" option - valid values include: ${d(n?.choices?.map(f(e=>String(e),[`choice`,``,`P"2!"/"`]))??[])}; provided: \${options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}}\`);`}})}})},get children(){return t(a,{get when(){return!n.optional},get fallback(){return t(l,{get condition(){return o`![${n.choices?.map(f(t=>n.kind===e.string?`"${t}"`:t,[`choice`,``,`P"2!"/"`])).join(`, `)}].includes(options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`})`},get children(){return o`failures.push(\`Invalid value provided for the \\"${n.name}\\" option - valid values include: ${d(n?.choices?.map(f(e=>String(e),[`choice`,``,`P"2!"/"`]))??[])}; provided: \${options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}}\`);`}})},get children(){return t(c,{get condition(){return o`![${n.choices?.map(f(t=>n.kind===e.string?`"${t}"`:t,[`choice`,``,`P"2!"/"`])).join(`, `)}].includes(options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`})`},get children(){return o`failures.push(\`Invalid value provided for the \\"${n.name}\\" option - valid values include: ${d(n?.choices?.map(f(e=>String(e),[`choice`,``,`P"2!"/"`]))??[])}; provided: \${options${n.name.includes(`?`)?`["${n.name}"]`:`.${r(n.name)}`}}\`);`}})}})}})}})],[`option`,``,`P"2!"/"`])}}),t(s,{}),t(i,{get each(){return m.args},doubleHardline:!0,get children(){return f(n=>[t(a,{get when(){return!n.optional},get children(){return[t(l,{get condition(){return o`!${r(n.name)}`},get children(){return o`failures.push("Missing required \\"${n.name}\\" positional argument");`}}),t(a,{get when(){return n.variadic},get children(){return t(c,{get condition(){return o`${r(n.name)}.length === 0`},get children(){return o`failures.push("No values were provided to the required \\"${n.name}\\" array positional argument");`}})}})]}}),t(a,{get when(){return n.kind===e.number},get children(){return t(a,{get when(){return n.variadic},get fallback(){return t(l,{get condition(){return o`${r(n.name)} && Number.isNaN(${r(n.name)})`},get children(){return o`failures.push("Invalid numeric value provided for the \\"${n.name}\\" positional argument");`}})},get children(){return t(l,{get condition(){return o`${r(n.name)}.some(value => Number.isNaN(value))`},get children(){return o`failures.push("Invalid numeric value provided in the \\"${n.name}\\" array positional argument");`}})}})}})],[`argument`,``,`P"2!"/"`])}})]}m.__type=[()=>p,`props`,`CommandValidationLogic`,`A component that generates command validation logic for required options and arguments.`,`Pn!2""/#?$`];export{m as CommandValidationLogic,p as __ΩCommandValidationLogicProps};
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+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";
+
+//#region src/components/command-validation-logic.tsx
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const __ΩCommandValidationLogicProps = [
+	"CommandTree",
+	"command",
+	"CommandValidationLogicProps",
+	"P\"w!4\"Mw#y"
+];
+/**
+* A component that generates command validation logic for required options and arguments.
+*/
+function CommandValidationLogic(props) {
+	const { command } = props;
+	return [
+		createComponent(VarDeclaration, {
+			name: "failures",
+			type: "string[]",
+			initializer: code`[];`
+		}),
+		createIntrinsic("hbr", {}),
+		createComponent(For, {
+			get each() {
+				return Object.values(command.options ?? {});
+			},
+			doubleHardline: true,
+			get children() {
+				return __assignType((option) => [
+					createComponent(Show, {
+						get when() {
+							return option.required;
+						},
+						get children() {
+							return [createComponent(IfStatement, {
+								get condition() {
+									return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}`;
+								},
+								get children() {
+									return code`failures.push("Missing required \\"${option.name}\\" option");`;
+								}
+							}), createComponent(Show, {
+								get when() {
+									return option.variadic;
+								},
+								get children() {
+									return createComponent(ElseIfClause, {
+										get condition() {
+											return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.length === 0`;
+										},
+										get children() {
+											return code`failures.push("No values were provided to the required \\"${option.name}\\" array option");`;
+										}
+									});
+								}
+							})];
+						}
+					}),
+					createComponent(Show, {
+						get when() {
+							return option.type === "number";
+						},
+						get children() {
+							return createComponent(Show, {
+								get when() {
+									return option.variadic;
+								},
+								get fallback() {
+									return createComponent(IfStatement, {
+										get condition() {
+											return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} && Number.isNaN(options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`})`;
+										},
+										get children() {
+											return code`failures.push("Invalid numeric value provided for the \\"${option.name}\\" option");`;
+										}
+									});
+								},
+								get children() {
+									return createComponent(IfStatement, {
+										get condition() {
+											return code`options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}.some(value => Number.isNaN(value))`;
+										},
+										get children() {
+											return code`failures.push("Invalid numeric value provided in the \\"${option.name}\\" array option");`;
+										}
+									});
+								}
+							});
+						}
+					}),
+					createComponent(Show, {
+						get when() {
+							return (option.type === "string" || option.type === "number") && option.choices && option.choices.length > 0;
+						},
+						get children() {
+							return createComponent(Show, {
+								get when() {
+									return !option.variadic;
+								},
+								get fallback() {
+									return createComponent(Show, {
+										get when() {
+											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.type === "string" ? `"${choice}"` : choice, [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])).join(", ")}].includes(value))`;
+												},
+												get children() {
+													return code`failures.push(\`Invalid value provided for the \\"${option.name}\\" option - valid values include: ${list(option?.choices?.map(__assignType((choice) => String(choice), [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+												}
+											});
+										},
+										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.type === "string" ? `"${choice}"` : choice, [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])).join(", ")}].includes(value))`;
+												},
+												get children() {
+													return code`failures.push(\`Invalid value provided for the \\"${option.name}\\" option - valid values include: ${list(option?.choices?.map(__assignType((choice) => String(choice), [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+												}
+											});
+										}
+									});
+								},
+								get children() {
+									return createComponent(Show, {
+										get when() {
+											return option.required;
+										},
+										get fallback() {
+											return createComponent(IfStatement, {
+												get condition() {
+													return code`![${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])).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(__assignType((choice) => String(choice), [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+												}
+											});
+										},
+										get children() {
+											return createComponent(ElseIfClause, {
+												get condition() {
+													return code`![${option.choices?.map(__assignType((choice) => option.type === "string" ? `"${choice}"` : choice, [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])).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(__assignType((choice) => String(choice), [
+														"choice",
+														"",
+														"P\"2!\"/\""
+													])) ?? [])}; provided: \${options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}}\`);`;
+												}
+											});
+										}
+									});
+								}
+							});
+						}
+					})
+				], [
+					"option",
+					"",
+					"P\"2!\"/\""
+				]);
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(For, {
+			get each() {
+				return command.args;
+			},
+			doubleHardline: true,
+			get children() {
+				return __assignType((argument) => [createComponent(Show, {
+					get when() {
+						return argument.required;
+					},
+					get children() {
+						return [createComponent(IfStatement, {
+							get condition() {
+								return code`!${camelCase(argument.name)}`;
+							},
+							get children() {
+								return code`failures.push("Missing required \\"${argument.name}\\" positional argument");`;
+							}
+						}), createComponent(Show, {
+							get when() {
+								return argument.variadic;
+							},
+							get children() {
+								return createComponent(ElseIfClause, {
+									get condition() {
+										return code`${camelCase(argument.name)}.length === 0`;
+									},
+									get children() {
+										return code`failures.push("No values were provided to the required \\"${argument.name}\\" array positional argument");`;
+									}
+								});
+							}
+						})];
+					}
+				}), createComponent(Show, {
+					get when() {
+						return argument.type === "number";
+					},
+					get children() {
+						return createComponent(Show, {
+							get when() {
+								return argument.variadic;
+							},
+							get fallback() {
+								return createComponent(IfStatement, {
+									get condition() {
+										return code`${camelCase(argument.name)} && Number.isNaN(${camelCase(argument.name)})`;
+									},
+									get children() {
+										return code`failures.push("Invalid numeric value provided for the \\"${argument.name}\\" positional argument");`;
+									}
+								});
+							},
+							get children() {
+								return createComponent(IfStatement, {
+									get condition() {
+										return code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`;
+									},
+									get children() {
+										return code`failures.push("Invalid numeric value provided in the \\"${argument.name}\\" array positional argument");`;
+									}
+								});
+							}
+						});
+					}
+				})], [
+					"argument",
+					"",
+					"P\"2!\"/\""
+				]);
+			}
+		})
+	];
+}
+CommandValidationLogic.__type = [
+	() => __ΩCommandValidationLogicProps,
+	"props",
+	"CommandValidationLogic",
+	"A component that generates command validation logic for required options and arguments.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+export { CommandValidationLogic, __ΩCommandValidationLogicProps };
 //# sourceMappingURL=command-validation-logic.mjs.map

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 +1,265 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../contexts/command.cjs`),t=require(`../helpers/docs-helpers.cjs`),n=require(`../plugin-utils/context-helpers.cjs`),r=require(`../plugin-utils/reflect.cjs`),i=require(`./usage.cjs`);let a=require(`@alloy-js/core/jsx-runtime`),o=require(`defu`),s=require(`@alloy-js/core`),c=require(`@alloy-js/markdown`),l=require(`@powerlines/plugin-alloy/core/components/spacing`),u=require(`@powerlines/plugin-alloy/core/contexts/context`),d=require(`@powerlines/plugin-alloy/markdown/components/markdown-file`),f=require(`@powerlines/plugin-alloy/markdown/components/markdown-table`),p=require(`@stryke/path/join`);const m=[`T`,`Required`,`l+e#!e"!fRb!Pde"!gN##w"y`],h=[`T`,`Partial`,`l+e#!e"!fRb!Pde"!gN#"w"y`];function g(e,t){return e.__type=t,e}const _=[`CommandTree`,`command`,`The command to generate options documentation for.`,`CommandOptionsDocsProps`,`P"w!4"?#Mw$y`];function v(e){let{command:t}=e;return Object.keys(t.options).length===0?s.code`This command does not have any options.`:(0,a.createComponent)(f.MarkdownTable,{get data(){return r.sortOptions(Object.values(t.options)).map(g(e=>({name:e.name.trim(),description:e.description.trim(),defaultValue:e.default?String(e.default)?.includes(`"`)?e.default:`\`${Array.isArray(e.default)?e.default.join(`, `):e.default}\``:``,required:e.optional||e.default?``:`✔`}),[`option`,``,`P"2!"/"`]))}})}v.__type=[()=>_,`props`,`CommandOptionsDocs`,`Generates the options markdown documentation for a command.`,`Pn!2""/#?$`];const y=[`npm`,`yarn`,`pnpm`,`bun`,`packageManager`,`npm`,`The package manager to generate the usage example for.`,`CommandTree`,`command`,`The command to generate the usage example for.`,`CommandDocsUsageExampleProps`,`PP.!.".#.$J4%8>&?'"w(4)?*Mw+y`];function b(e){let{packageManager:t=`npm`,command:r}=e,o=(u.usePowerlines.Ω=[[`Context`,`"w!`]],(0,u.usePowerlines)());return[(0,a.createIntrinsic)(`hbr`,{}),s.code`\`\`\`bash `,(0,a.createIntrinsic)(`hbr`,{}),(0,a.createComponent)(i.Usage,{command:r,get bin(){return n.getAppBin(o)},packageManager:t}),(0,a.createIntrinsic)(`hbr`,{}),s.code`\`\`\``,(0,a.createIntrinsic)(`hbr`,{})]}b.__type=[()=>y,`props`,`CommandDocsUsageExample`,`Generates the markdown documentation for a command.`,`Pn!2""/#?$`];const x=[`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`CommandTree`,`command`,`The command to generate options documentation for.`,()=>m,()=>y,`packageManager`,`usageExamples`,'`["npm"]`',`Optional usage examples to include in the documentation.`,`CommandDocsProps`,`P'4!8>"?#"w$4%?&n(o'".)fF4*8>+?,Mw-y`];function S(e){let{levelOffset:t=0,command:n,usageExamples:r}=e;return[(0,a.createComponent)(c.Heading,{level:1+t,get children(){return n.title}}),(0,a.createComponent)(l.Spacing,{}),(0,a.memo)(()=>s.code`${n.description}`),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(c.Heading,{level:2+t,children:`Usage`}),(0,a.createComponent)(l.Spacing,{}),(0,a.memo)(()=>s.code`The ${n.name} command can be executed using the following syntax: `),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(s.Show,{get when(){return r&&r.length>0},get fallback(){return(0,a.createComponent)(b,{packageManager:`npm`,command:n})},get children(){return(0,a.createComponent)(s.For,{each:r,hardline:!0,get children(){return g(e=>(0,a.createComponent)(b,{packageManager:e,command:n}),[`packageManager`,``,`P"2!"/"`])}})}}),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(c.Heading,{level:2+t,children:`Options`}),(0,a.createComponent)(l.Spacing,{}),(0,a.memo)(()=>s.code`The following options are available for the ${n.name} command:`),(0,a.createComponent)(l.Spacing,{}),(0,a.createComponent)(v,{command:n}),(0,a.createComponent)(l.Spacing,{})]}S.__type=[()=>x,`props`,`CommandDocs`,`Generates the markdown documentation for a command.`,`Pn!2""/#?$`];const C=[()=>h,`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`CommandTree`,`command`,`The command to generate documentation for.`,`CommandDocsFileProps`,`P!o!"'4"8>#?$"w%4&?'Mw(y`];function w(n){let{levelOffset:r=0,command:i,frontMatter:c,...l}=n,f=(u.usePowerlines.Ω=[[`Context`,`"w!`]],(0,u.usePowerlines)()),m=(0,s.memo)(()=>[`npm`,`yarn`,`pnpm`,`bun`]);return(0,a.createComponent)(e.CommandContext.Provider,{value:i,get children(){return(0,a.createComponent)(d.MarkdownFile,(0,a.mergeProps)({get path(){return(0,p.joinPaths)(t.getDocsOutputPath(f),`${i.path}.md`)}},l,{get frontMatter(){return(0,o.defu)(c??{},{id:i.id,name:i.name,path:i.path,reference:i.reference,isVirtual:i.isVirtual,title:i.title,description:i.description,tags:i.tags})},get children(){return(0,a.createComponent)(S,{levelOffset:r,command:i,get usageExamples(){return m()}})}}))}})}w.__type=[()=>C,`props`,`CommandDocsFile`,`Generates the markdown documentation file for a command.`,`Pn!2""/#?$`],exports.CommandDocs=S,exports.CommandDocsFile=w,exports.CommandDocsUsageExample=b,exports.CommandOptionsDocs=v,exports.__ΩCommandDocsFileProps=C,exports.__ΩCommandDocsProps=x,exports.__ΩCommandDocsUsageExampleProps=y,exports.__ΩCommandOptionsDocsProps=_;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+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 _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");
+let _powerlines_plugin_alloy_markdown_components_markdown_file = require("@powerlines/plugin-alloy/markdown/components/markdown-file");
+let _powerlines_plugin_alloy_markdown_components_markdown_table = require("@powerlines/plugin-alloy/markdown/components/markdown-table");
+let _stryke_path_join = require("@stryke/path/join");
+
+//#region src/components/docs.tsx
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const __ΩCommandOptionsDocsProps = [
+	"CommandTree",
+	"command",
+	"The command to generate options documentation for.",
+	"CommandOptionsDocsProps",
+	"P\"w!4\"?#Mw$y"
+];
+/**
+* Generates the options markdown documentation for a command.
+*/
+function CommandOptionsDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return _alloy_js_core.code`This command does not have any options.`;
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+		return require_reflect.sortOptions(Object.values(command.options)).map(__assignType((option) => {
+			return {
+				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.required || option.default ? "" : "✔"
+			};
+		}, [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]));
+	} });
+}
+CommandOptionsDocs.__type = [
+	() => __ΩCommandOptionsDocsProps,
+	"props",
+	"CommandOptionsDocs",
+	"Generates the options markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsUsageExampleProps = [
+	"npm",
+	"yarn",
+	"pnpm",
+	"bun",
+	"packageManager",
+	"npm",
+	"The package manager to generate the usage example for.",
+	"CommandTree",
+	"command",
+	"The command to generate the usage example for.",
+	"CommandDocsUsageExampleProps",
+	"PP.!.\".#.$J4%8>&?'\"w(4)?*Mw+y"
+];
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocsUsageExample(props) {
+	const { packageManager = "npm", command } = props;
+	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
+	return [
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		_alloy_js_core.code`\`\`\`bash `,
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_usage.Usage, {
+			command,
+			get bin() {
+				return require_context_helpers.getAppBin(context);
+			},
+			packageManager
+		}),
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		_alloy_js_core.code`\`\`\``,
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+CommandDocsUsageExample.__type = [
+	() => __ΩCommandDocsUsageExampleProps,
+	"props",
+	"CommandDocsUsageExample",
+	"Generates the markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsProps = [
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"CommandTree",
+	"command",
+	"The command to generate options documentation for.",
+	() => __ΩRequired,
+	() => __ΩCommandDocsUsageExampleProps,
+	"packageManager",
+	"usageExamples",
+	"`[\"npm\"]`",
+	"Optional usage examples to include in the documentation.",
+	"CommandDocsProps",
+	"P'4!8>\"?#\"w$4%?&n(o'\".)fF4*8>+?,Mw-y"
+];
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocs(props) {
+	const { levelOffset = 0, command, usageExamples } = props;
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 1 + levelOffset,
+			get children() {
+				return command.title;
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`${command.description}`),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 2 + levelOffset,
+			children: "Usage"
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The ${command.name} command can be executed using the following syntax: `),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return usageExamples && usageExamples.length > 0;
+			},
+			get fallback() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocsUsageExample, {
+					packageManager: "npm",
+					command
+				});
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+					each: usageExamples,
+					hardline: true,
+					get children() {
+						return __assignType((packageManager) => (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocsUsageExample, {
+							packageManager,
+							command
+						}), [
+							"packageManager",
+							"",
+							"P\"2!\"/\""
+						]);
+					}
+				});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 2 + levelOffset,
+			children: "Options"
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following options are available for the ${command.name} command:`),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(CommandOptionsDocs, { command }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+	];
+}
+CommandDocs.__type = [
+	() => __ΩCommandDocsProps,
+	"props",
+	"CommandDocs",
+	"Generates the markdown documentation for a command.",
+	"Pn!2\"\"/#?$"
+];
+const __ΩCommandDocsFileProps = [
+	() => __ΩPartial,
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"CommandTree",
+	"command",
+	"The command to generate documentation for.",
+	"CommandDocsFileProps",
+	"P!o!\"'4\"8>#?$\"w%4&?'Mw(y"
+];
+/**
+* Generates the markdown documentation file for a command.
+*/
+function CommandDocsFile(props) {
+	const { levelOffset = 0, command, frontMatter, ...rest } = props;
+	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
+	const usageExamples = (0, _alloy_js_core.memo)(() => [
+		"npm",
+		"yarn",
+		"pnpm",
+		"bun"
+	]);
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_contexts_command.CommandContext.Provider, {
+		value: command,
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_markdown_file.MarkdownFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({ get path() {
+				return (0, _stryke_path_join.joinPaths)(require_docs_helpers.getDocsOutputPath(context), `${command.path}.md`);
+			} }, rest, {
+				get frontMatter() {
+					return (0, defu.defu)(frontMatter ?? {}, {
+						id: command.id,
+						name: command.name,
+						path: command.path,
+						reference: command.docs,
+						virtual: command.virtual,
+						title: command.title,
+						description: command.description,
+						tags: command.tags
+					});
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocs, {
+						levelOffset,
+						command,
+						get usageExamples() {
+							return usageExamples();
+						}
+					});
+				}
+			}));
+		}
+	});
+}
+CommandDocsFile.__type = [
+	() => __ΩCommandDocsFileProps,
+	"props",
+	"CommandDocsFile",
+	"Generates the markdown documentation file for a command.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+exports.CommandDocs = CommandDocs;
+exports.CommandDocsFile = CommandDocsFile;
+exports.CommandDocsUsageExample = CommandDocsUsageExample;
+exports.CommandOptionsDocs = CommandOptionsDocs;
+exports.__ΩCommandDocsFileProps = __ΩCommandDocsFileProps;
+exports.__ΩCommandDocsProps = __ΩCommandDocsProps;
+exports.__ΩCommandDocsUsageExampleProps = __ΩCommandDocsUsageExampleProps;
+exports.__ΩCommandOptionsDocsProps = __ΩCommandOptionsDocsProps;
+//# sourceMappingURL=docs.cjs.map

package/dist/components/docs.cjs.map

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