@shell-shock/core 0.11.0 → 0.12.1

package/dist/components/docs.d.mts

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

package/dist/components/helpers.cjs

@@ -1,4 +1,5 @@
 const require_rolldown_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 __alloy_js_core = require("@alloy-js/core");
 
@@ -52,9 +53,17 @@ function IsNotVerbose() {
 		__alloy_js_core.code`)`
 	];
 }
+/**
+* Write the type declaration for a command parameter based on its configuration.
+*/
+function CommandParameterType(props) {
+	const { parameter } = props;
+	return __alloy_js_core.code`${(parameter.kind === require_types_command.CommandParameterKinds.string || parameter.kind === require_types_command.CommandParameterKinds.number) && parameter.choices && parameter.choices.length > 0 ? parameter.choices.map((choice) => typeof choice === "string" ? `"${choice}"` : choice).join(" | ") : parameter.kind === require_types_command.CommandParameterKinds.boolean ? "boolean" : parameter.kind === require_types_command.CommandParameterKinds.number ? "number" : "string"}${(parameter.kind === require_types_command.CommandParameterKinds.string || parameter.kind === require_types_command.CommandParameterKinds.number) && parameter.variadic ? "[]" : ""}${parameter.optional ? " | undefined" : ""}`;
+}
 
 //#endregion
 exports.BooleanInputParserLogic = BooleanInputParserLogic;
+exports.CommandParameterType = CommandParameterType;
 exports.IsDebug = IsDebug;
 exports.IsNotDebug = IsNotDebug;
 exports.IsNotVerbose = IsNotVerbose;

package/dist/components/helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.cjs","names":["code","BooleanInputParserLogic","props","name","IsDebug","IsNotDebug","_$createComponent","IsVerbose","IsNotVerbose"],"sources":["../../src/components/helpers.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 } from \"@alloy-js/core\";\n\nexport interface BooleanInputParserLogicProps {\n  name: string;\n}\n\n/**\n * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.\n */\nexport function BooleanInputParserLogic(props: BooleanInputParserLogicProps) {\n  const { name } = props;\n\n  return (\n    <>{code` !!${name} && ${name}.toLowerCase() !== \"false\" && ${\n      name\n    }.toLowerCase() !== \"f\" && ${name}.toLowerCase() !== \"no\" && ${\n      name\n    } !== \"n\" && ${name}.toLowerCase() !== \"0\" && ${\n      name\n    }.toLowerCase() !== \"off\" && ${\n      name\n    } !== \"disable\" && ${name}.toLowerCase() !== \"disabled\" && ${\n      name\n    }.toLowerCase() !== \"never\" && (Number.isNaN(Number.parseFloat(${\n      name\n    })) || Number.parseFloat(${name}) > 0) `}</>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in debug mode.\n *\n * @remarks\n * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.\n */\nexport function IsDebug() {\n  return code`isDevelopment || isDebug || env.LOG_LEVEL === \"debug\"`;\n}\n\n/**\n * Write the logic to determine if the application is **not** running in debug mode.\n */\nexport function IsNotDebug() {\n  return (\n    <>\n      {code`!(`}\n      <IsDebug />\n      {code`)`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in verbose mode.\n *\n * @remarks\n * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.\n */\nexport function IsVerbose() {\n  return (\n    <>\n      {code`( `}\n      <IsDebug />\n      {code`|| hasFlag([\"verbose\", \"verbose=true\", \"verbose=always\"]))`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is **not** running in verbose mode.\n */\nexport function IsNotVerbose() {\n  return (\n    <>\n      {code`!(`}\n      <IsVerbose />\n      {code`)`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;AA2BA,SAAgBC,wBAAwBC,OAAqC;CAC3E,MAAM,EAAEC,SAASD;AAEjB,QAAA,CACKF,oBAAI,MAAMG,KAAI,MAAOA,KAAI,gCAC1BA,KAAI,4BACuBA,KAAI,6BAC/BA,KAAI,cACSA,KAAI,4BACjBA,KAAI,8BAEJA,KAAI,oBACeA,KAAI,mCACvBA,KAAI,gEAEJA,KAAI,0BACqBA,KAAI,SAAS;;;;;;;;AAU5C,SAAgBC,UAAU;AACxB,QAAOJ,oBAAI;;;;;AAMb,SAAgBK,aAAa;AAC3B,QAAA;EAEKL,oBAAI;mDACJI,SAAO,EAAA,CAAA;EACPJ,oBAAI;EAAG;;;;;;;;AAWd,SAAgBO,YAAY;AAC1B,QAAA;EAEKP,oBAAI;mDACJI,SAAO,EAAA,CAAA;EACPJ,oBAAI;EAA4D;;;;;AAQvE,SAAgBQ,eAAe;AAC7B,QAAA;EAEKR,oBAAI;mDACJO,WAAS,EAAA,CAAA;EACTP,oBAAI;EAAG"}
+{"version":3,"file":"helpers.cjs","names":["code","CommandParameterKinds","BooleanInputParserLogic","props","name","IsDebug","IsNotDebug","_$createComponent","IsVerbose","IsNotVerbose","CommandParameterType","parameter","kind","string","number","choices","length","map","choice","join","boolean","variadic","optional"],"sources":["../../src/components/helpers.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 } from \"@alloy-js/core\";\nimport type { CommandParameter } from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface BooleanInputParserLogicProps {\n  name: string;\n}\n\n/**\n * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.\n */\nexport function BooleanInputParserLogic(props: BooleanInputParserLogicProps) {\n  const { name } = props;\n\n  return (\n    <>{code` !!${name} && ${name}.toLowerCase() !== \"false\" && ${\n      name\n    }.toLowerCase() !== \"f\" && ${name}.toLowerCase() !== \"no\" && ${\n      name\n    } !== \"n\" && ${name}.toLowerCase() !== \"0\" && ${\n      name\n    }.toLowerCase() !== \"off\" && ${\n      name\n    } !== \"disable\" && ${name}.toLowerCase() !== \"disabled\" && ${\n      name\n    }.toLowerCase() !== \"never\" && (Number.isNaN(Number.parseFloat(${\n      name\n    })) || Number.parseFloat(${name}) > 0) `}</>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in debug mode.\n *\n * @remarks\n * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.\n */\nexport function IsDebug() {\n  return code`isDevelopment || isDebug || env.LOG_LEVEL === \"debug\"`;\n}\n\n/**\n * Write the logic to determine if the application is **not** running in debug mode.\n */\nexport function IsNotDebug() {\n  return (\n    <>\n      {code`!(`}\n      <IsDebug />\n      {code`)`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in verbose mode.\n *\n * @remarks\n * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.\n */\nexport function IsVerbose() {\n  return (\n    <>\n      {code`( `}\n      <IsDebug />\n      {code`|| hasFlag([\"verbose\", \"verbose=true\", \"verbose=always\"]))`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is **not** running in verbose mode.\n */\nexport function IsNotVerbose() {\n  return (\n    <>\n      {code`!(`}\n      <IsVerbose />\n      {code`)`}\n    </>\n  );\n}\n\n/**\n * Write the type declaration for a command parameter based on its configuration.\n */\nexport function CommandParameterType(props: { parameter: CommandParameter }) {\n  const { parameter } = props;\n\n  return code`${\n    (parameter.kind === CommandParameterKinds.string ||\n      parameter.kind === CommandParameterKinds.number) &&\n    parameter.choices &&\n    parameter.choices.length > 0\n      ? parameter.choices\n          .map(choice => (typeof choice === \"string\" ? `\"${choice}\"` : choice))\n          .join(\" | \")\n      : parameter.kind === CommandParameterKinds.boolean\n        ? \"boolean\"\n        : parameter.kind === CommandParameterKinds.number\n          ? \"number\"\n          : \"string\"\n  }${\n    (parameter.kind === CommandParameterKinds.string ||\n      parameter.kind === CommandParameterKinds.number) &&\n    parameter.variadic\n      ? \"[]\"\n      : \"\"\n  }${parameter.optional ? \" | undefined\" : \"\"}`;\n}\n"],"mappings":";;;;;;;;;AA6BA,SAAgBE,wBAAwBC,OAAqC;CAC3E,MAAM,EAAEC,SAASD;AAEjB,QAAA,CACKH,oBAAI,MAAMI,KAAI,MAAOA,KAAI,gCAC1BA,KAAI,4BACuBA,KAAI,6BAC/BA,KAAI,cACSA,KAAI,4BACjBA,KAAI,8BAEJA,KAAI,oBACeA,KAAI,mCACvBA,KAAI,gEAEJA,KAAI,0BACqBA,KAAI,SAAS;;;;;;;;AAU5C,SAAgBC,UAAU;AACxB,QAAOL,oBAAI;;;;;AAMb,SAAgBM,aAAa;AAC3B,QAAA;EAEKN,oBAAI;mDACJK,SAAO,EAAA,CAAA;EACPL,oBAAI;EAAG;;;;;;;;AAWd,SAAgBQ,YAAY;AAC1B,QAAA;EAEKR,oBAAI;mDACJK,SAAO,EAAA,CAAA;EACPL,oBAAI;EAA4D;;;;;AAQvE,SAAgBS,eAAe;AAC7B,QAAA;EAEKT,oBAAI;mDACJQ,WAAS,EAAA,CAAA;EACTR,oBAAI;EAAG;;;;;AAQd,SAAgBU,qBAAqBP,OAAwC;CAC3E,MAAM,EAAEQ,cAAcR;AAEtB,QAAOH,oBAAI,IACRW,UAAUC,SAASX,4CAAsBY,UACxCF,UAAUC,SAASX,4CAAsBa,WAC3CH,UAAUI,WACVJ,UAAUI,QAAQC,SAAS,IACvBL,UAAUI,QACPE,KAAIC,WAAW,OAAOA,WAAW,WAAW,IAAIA,OAAM,KAAMA,OAAQ,CACpEC,KAAK,MAAM,GACdR,UAAUC,SAASX,4CAAsBmB,UACvC,YACAT,UAAUC,SAASX,4CAAsBa,SACvC,WACA,YAEPH,UAAUC,SAASX,4CAAsBY,UACxCF,UAAUC,SAASX,4CAAsBa,WAC3CH,UAAUU,WACN,OACA,KACHV,UAAUW,WAAW,iBAAiB"}

package/dist/components/helpers.d.cts

@@ -1,4 +1,6 @@
-import * as _alloy_js_core19 from "@alloy-js/core";
+import { CommandParameter } from "../types/command.cjs";
+import "../types/index.cjs";
+import * as _alloy_js_core11 from "@alloy-js/core";
 
 //#region src/components/helpers.d.ts
 interface BooleanInputParserLogicProps {
@@ -7,29 +9,35 @@ interface BooleanInputParserLogicProps {
 /**
  * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.
  */
-declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core19.Children;
+declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core11.Children;
 /**
  * Write the logic to determine if the application is running in debug mode.
  *
  * @remarks
  * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.
  */
-declare function IsDebug(): _alloy_js_core19.Children;
+declare function IsDebug(): _alloy_js_core11.Children;
 /**
  * Write the logic to determine if the application is **not** running in debug mode.
  */
-declare function IsNotDebug(): _alloy_js_core19.Children;
+declare function IsNotDebug(): _alloy_js_core11.Children;
 /**
  * Write the logic to determine if the application is running in verbose mode.
  *
  * @remarks
  * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.
  */
-declare function IsVerbose(): _alloy_js_core19.Children;
+declare function IsVerbose(): _alloy_js_core11.Children;
 /**
  * Write the logic to determine if the application is **not** running in verbose mode.
  */
-declare function IsNotVerbose(): _alloy_js_core19.Children;
+declare function IsNotVerbose(): _alloy_js_core11.Children;
+/**
+ * Write the type declaration for a command parameter based on its configuration.
+ */
+declare function CommandParameterType(props: {
+  parameter: CommandParameter;
+}): _alloy_js_core11.Children;
 //#endregion
-export { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
+export { BooleanInputParserLogic, BooleanInputParserLogicProps, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
 //# sourceMappingURL=helpers.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;AA0BA;AAOgB,iBAjCA,uBAAA,CAiCU,KAAA,EAjCqB,4BAiCrB,CAAA,EAjCiD,gBAAA,CAAA,QAiCjD;AAgB1B;AAaA;;;;;iBApCgB,OAAA,CAAA,GAAO,gBAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,gBAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,gBAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,gBAAA,CAAA"}
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;;;UAsBiB,4BAAA;;;;AAAjB;AAOA;AA0BgB,iBA1BA,uBAAA,CA0BO,KAAA,EA1BwB,4BA0BxB,CAAA,EA1BoD,gBAAA,CAAA,QA0BpD;AAOvB;AAgBA;AAaA;AAaA;;;iBAjDgB,OAAA,CAAA,GAAO,gBAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,gBAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,gBAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,gBAAA,CAAA;;;;iBAaZ,oBAAA;aAAyC;IAAgB,gBAAA,CAAE"}

package/dist/components/helpers.d.mts

@@ -1,4 +1,6 @@
-import * as _alloy_js_core20 from "@alloy-js/core";
+import { CommandParameter } from "../types/command.mjs";
+import "../types/index.mjs";
+import * as _alloy_js_core7 from "@alloy-js/core";
 
 //#region src/components/helpers.d.ts
 interface BooleanInputParserLogicProps {
@@ -7,29 +9,35 @@ interface BooleanInputParserLogicProps {
 /**
  * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.
  */
-declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core20.Children;
+declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core7.Children;
 /**
  * Write the logic to determine if the application is running in debug mode.
  *
  * @remarks
  * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.
  */
-declare function IsDebug(): _alloy_js_core20.Children;
+declare function IsDebug(): _alloy_js_core7.Children;
 /**
  * Write the logic to determine if the application is **not** running in debug mode.
  */
-declare function IsNotDebug(): _alloy_js_core20.Children;
+declare function IsNotDebug(): _alloy_js_core7.Children;
 /**
  * Write the logic to determine if the application is running in verbose mode.
  *
  * @remarks
  * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.
  */
-declare function IsVerbose(): _alloy_js_core20.Children;
+declare function IsVerbose(): _alloy_js_core7.Children;
 /**
  * Write the logic to determine if the application is **not** running in verbose mode.
  */
-declare function IsNotVerbose(): _alloy_js_core20.Children;
+declare function IsNotVerbose(): _alloy_js_core7.Children;
+/**
+ * Write the type declaration for a command parameter based on its configuration.
+ */
+declare function CommandParameterType(props: {
+  parameter: CommandParameter;
+}): _alloy_js_core7.Children;
 //#endregion
-export { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
+export { BooleanInputParserLogic, BooleanInputParserLogicProps, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
 //# sourceMappingURL=helpers.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;AA0BA;AAOgB,iBAjCA,uBAAA,CAiCU,KAAA,EAjCqB,4BAiCrB,CAAA,EAjCiD,gBAAA,CAAA,QAiCjD;AAgB1B;AAaA;;;;;iBApCgB,OAAA,CAAA,GAAO,gBAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,gBAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,gBAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,gBAAA,CAAA"}
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;;;UAsBiB,4BAAA;;;;AAAjB;AAOA;AA0BgB,iBA1BA,uBAAA,CA0BO,KAAA,EA1BwB,4BA0BxB,CAAA,EA1BoD,eAAA,CAAA,QA0BpD;AAOvB;AAgBA;AAaA;AAaA;;;iBAjDgB,OAAA,CAAA,GAAO,eAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,eAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,eAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,eAAA,CAAA;;;;iBAaZ,oBAAA;aAAyC;IAAgB,eAAA,CAAE"}

package/dist/components/helpers.mjs

@@ -1,3 +1,4 @@
+import { CommandParameterKinds } from "../types/command.mjs";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
 import { code } from "@alloy-js/core";
 
@@ -51,7 +52,14 @@ function IsNotVerbose() {
 		code`)`
 	];
 }
+/**
+* Write the type declaration for a command parameter based on its configuration.
+*/
+function CommandParameterType(props) {
+	const { parameter } = props;
+	return code`${(parameter.kind === CommandParameterKinds.string || parameter.kind === CommandParameterKinds.number) && parameter.choices && parameter.choices.length > 0 ? parameter.choices.map((choice) => typeof choice === "string" ? `"${choice}"` : choice).join(" | ") : parameter.kind === CommandParameterKinds.boolean ? "boolean" : parameter.kind === CommandParameterKinds.number ? "number" : "string"}${(parameter.kind === CommandParameterKinds.string || parameter.kind === CommandParameterKinds.number) && parameter.variadic ? "[]" : ""}${parameter.optional ? " | undefined" : ""}`;
+}
 
 //#endregion
-export { BooleanInputParserLogic, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
+export { BooleanInputParserLogic, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
 //# sourceMappingURL=helpers.mjs.map

package/dist/components/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":["code","BooleanInputParserLogic","props","name","IsDebug","IsNotDebug","_$createComponent","IsVerbose","IsNotVerbose"],"sources":["../../src/components/helpers.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 } from \"@alloy-js/core\";\n\nexport interface BooleanInputParserLogicProps {\n  name: string;\n}\n\n/**\n * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.\n */\nexport function BooleanInputParserLogic(props: BooleanInputParserLogicProps) {\n  const { name } = props;\n\n  return (\n    <>{code` !!${name} && ${name}.toLowerCase() !== \"false\" && ${\n      name\n    }.toLowerCase() !== \"f\" && ${name}.toLowerCase() !== \"no\" && ${\n      name\n    } !== \"n\" && ${name}.toLowerCase() !== \"0\" && ${\n      name\n    }.toLowerCase() !== \"off\" && ${\n      name\n    } !== \"disable\" && ${name}.toLowerCase() !== \"disabled\" && ${\n      name\n    }.toLowerCase() !== \"never\" && (Number.isNaN(Number.parseFloat(${\n      name\n    })) || Number.parseFloat(${name}) > 0) `}</>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in debug mode.\n *\n * @remarks\n * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.\n */\nexport function IsDebug() {\n  return code`isDevelopment || isDebug || env.LOG_LEVEL === \"debug\"`;\n}\n\n/**\n * Write the logic to determine if the application is **not** running in debug mode.\n */\nexport function IsNotDebug() {\n  return (\n    <>\n      {code`!(`}\n      <IsDebug />\n      {code`)`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in verbose mode.\n *\n * @remarks\n * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.\n */\nexport function IsVerbose() {\n  return (\n    <>\n      {code`( `}\n      <IsDebug />\n      {code`|| hasFlag([\"verbose\", \"verbose=true\", \"verbose=always\"]))`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is **not** running in verbose mode.\n */\nexport function IsNotVerbose() {\n  return (\n    <>\n      {code`!(`}\n      <IsVerbose />\n      {code`)`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;AA2BA,SAAgBC,wBAAwBC,OAAqC;CAC3E,MAAM,EAAEC,SAASD;AAEjB,QAAA,CACKF,IAAI,MAAMG,KAAI,MAAOA,KAAI,gCAC1BA,KAAI,4BACuBA,KAAI,6BAC/BA,KAAI,cACSA,KAAI,4BACjBA,KAAI,8BAEJA,KAAI,oBACeA,KAAI,mCACvBA,KAAI,gEAEJA,KAAI,0BACqBA,KAAI,SAAS;;;;;;;;AAU5C,SAAgBC,UAAU;AACxB,QAAOJ,IAAI;;;;;AAMb,SAAgBK,aAAa;AAC3B,QAAA;EAEKL,IAAI;EAAIM,gBACRF,SAAO,EAAA,CAAA;EACPJ,IAAI;EAAG;;;;;;;;AAWd,SAAgBO,YAAY;AAC1B,QAAA;EAEKP,IAAI;EAAIM,gBACRF,SAAO,EAAA,CAAA;EACPJ,IAAI;EAA4D;;;;;AAQvE,SAAgBQ,eAAe;AAC7B,QAAA;EAEKR,IAAI;EAAIM,gBACRC,WAAS,EAAA,CAAA;EACTP,IAAI;EAAG"}
+{"version":3,"file":"helpers.mjs","names":["code","CommandParameterKinds","BooleanInputParserLogic","props","name","IsDebug","IsNotDebug","_$createComponent","IsVerbose","IsNotVerbose","CommandParameterType","parameter","kind","string","number","choices","length","map","choice","join","boolean","variadic","optional"],"sources":["../../src/components/helpers.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 } from \"@alloy-js/core\";\nimport type { CommandParameter } from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface BooleanInputParserLogicProps {\n  name: string;\n}\n\n/**\n * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.\n */\nexport function BooleanInputParserLogic(props: BooleanInputParserLogicProps) {\n  const { name } = props;\n\n  return (\n    <>{code` !!${name} && ${name}.toLowerCase() !== \"false\" && ${\n      name\n    }.toLowerCase() !== \"f\" && ${name}.toLowerCase() !== \"no\" && ${\n      name\n    } !== \"n\" && ${name}.toLowerCase() !== \"0\" && ${\n      name\n    }.toLowerCase() !== \"off\" && ${\n      name\n    } !== \"disable\" && ${name}.toLowerCase() !== \"disabled\" && ${\n      name\n    }.toLowerCase() !== \"never\" && (Number.isNaN(Number.parseFloat(${\n      name\n    })) || Number.parseFloat(${name}) > 0) `}</>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in debug mode.\n *\n * @remarks\n * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.\n */\nexport function IsDebug() {\n  return code`isDevelopment || isDebug || env.LOG_LEVEL === \"debug\"`;\n}\n\n/**\n * Write the logic to determine if the application is **not** running in debug mode.\n */\nexport function IsNotDebug() {\n  return (\n    <>\n      {code`!(`}\n      <IsDebug />\n      {code`)`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is running in verbose mode.\n *\n * @remarks\n * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.\n */\nexport function IsVerbose() {\n  return (\n    <>\n      {code`( `}\n      <IsDebug />\n      {code`|| hasFlag([\"verbose\", \"verbose=true\", \"verbose=always\"]))`}\n    </>\n  );\n}\n\n/**\n * Write the logic to determine if the application is **not** running in verbose mode.\n */\nexport function IsNotVerbose() {\n  return (\n    <>\n      {code`!(`}\n      <IsVerbose />\n      {code`)`}\n    </>\n  );\n}\n\n/**\n * Write the type declaration for a command parameter based on its configuration.\n */\nexport function CommandParameterType(props: { parameter: CommandParameter }) {\n  const { parameter } = props;\n\n  return code`${\n    (parameter.kind === CommandParameterKinds.string ||\n      parameter.kind === CommandParameterKinds.number) &&\n    parameter.choices &&\n    parameter.choices.length > 0\n      ? parameter.choices\n          .map(choice => (typeof choice === \"string\" ? `\"${choice}\"` : choice))\n          .join(\" | \")\n      : parameter.kind === CommandParameterKinds.boolean\n        ? \"boolean\"\n        : parameter.kind === CommandParameterKinds.number\n          ? \"number\"\n          : \"string\"\n  }${\n    (parameter.kind === CommandParameterKinds.string ||\n      parameter.kind === CommandParameterKinds.number) &&\n    parameter.variadic\n      ? \"[]\"\n      : \"\"\n  }${parameter.optional ? \" | undefined\" : \"\"}`;\n}\n"],"mappings":";;;;;;;;AA6BA,SAAgBE,wBAAwBC,OAAqC;CAC3E,MAAM,EAAEC,SAASD;AAEjB,QAAA,CACKH,IAAI,MAAMI,KAAI,MAAOA,KAAI,gCAC1BA,KAAI,4BACuBA,KAAI,6BAC/BA,KAAI,cACSA,KAAI,4BACjBA,KAAI,8BAEJA,KAAI,oBACeA,KAAI,mCACvBA,KAAI,gEAEJA,KAAI,0BACqBA,KAAI,SAAS;;;;;;;;AAU5C,SAAgBC,UAAU;AACxB,QAAOL,IAAI;;;;;AAMb,SAAgBM,aAAa;AAC3B,QAAA;EAEKN,IAAI;EAAIO,gBACRF,SAAO,EAAA,CAAA;EACPL,IAAI;EAAG;;;;;;;;AAWd,SAAgBQ,YAAY;AAC1B,QAAA;EAEKR,IAAI;EAAIO,gBACRF,SAAO,EAAA,CAAA;EACPL,IAAI;EAA4D;;;;;AAQvE,SAAgBS,eAAe;AAC7B,QAAA;EAEKT,IAAI;EAAIO,gBACRC,WAAS,EAAA,CAAA;EACTR,IAAI;EAAG;;;;;AAQd,SAAgBU,qBAAqBP,OAAwC;CAC3E,MAAM,EAAEQ,cAAcR;AAEtB,QAAOH,IAAI,IACRW,UAAUC,SAASX,sBAAsBY,UACxCF,UAAUC,SAASX,sBAAsBa,WAC3CH,UAAUI,WACVJ,UAAUI,QAAQC,SAAS,IACvBL,UAAUI,QACPE,KAAIC,WAAW,OAAOA,WAAW,WAAW,IAAIA,OAAM,KAAMA,OAAQ,CACpEC,KAAK,MAAM,GACdR,UAAUC,SAASX,sBAAsBmB,UACvC,YACAT,UAAUC,SAASX,sBAAsBa,SACvC,WACA,YAEPH,UAAUC,SAASX,sBAAsBY,UACxCF,UAAUC,SAASX,sBAAsBa,WAC3CH,UAAUU,WACN,OACA,KACHV,UAAUW,WAAW,iBAAiB"}

package/dist/components/index.cjs

@@ -12,6 +12,7 @@ exports.CommandDocs = require_components_docs.CommandDocs;
 exports.CommandDocsFile = require_components_docs.CommandDocsFile;
 exports.CommandDocsUsageExample = require_components_docs.CommandDocsUsageExample;
 exports.CommandOptionsDocs = require_components_docs.CommandOptionsDocs;
+exports.CommandParameterType = require_components_helpers.CommandParameterType;
 exports.CommandParserLogic = require_components_options_parser_logic.CommandParserLogic;
 exports.ContextUtilities = require_components_utils_builtin.ContextUtilities;
 exports.DynamicSegmentsParserLogic = require_components_options_parser_logic.DynamicSegmentsParserLogic;

package/dist/components/index.d.cts

@@ -1,6 +1,6 @@
 import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps } from "./docs.cjs";
-import { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.cjs";
+import { BooleanInputParserLogic, BooleanInputParserLogicProps, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.cjs";
 import { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps } from "./options-parser-logic.cjs";
 import { Usage, UsageProps } from "./usage.cjs";
 import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.cjs";
-export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };
+export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParameterType, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };

package/dist/components/index.d.mts

@@ -1,6 +1,6 @@
 import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps } from "./docs.mjs";
-import { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.mjs";
+import { BooleanInputParserLogic, BooleanInputParserLogicProps, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.mjs";
 import { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps } from "./options-parser-logic.mjs";
 import { Usage, UsageProps } from "./usage.mjs";
 import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.mjs";
-export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };
+export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParameterType, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };

package/dist/components/index.mjs

@@ -1,7 +1,7 @@
 import { Usage } from "./usage.mjs";
 import { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs } from "./docs.mjs";
 import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin } from "./utils-builtin.mjs";
-import { BooleanInputParserLogic, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.mjs";
+import { BooleanInputParserLogic, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.mjs";
 import { ArgumentsParserLogic, CommandParserLogic, DynamicSegmentsParserLogic, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic } from "./options-parser-logic.mjs";
 
-export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParserLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, SpawnFunctionDeclaration, Usage, UtilsBuiltin };
+export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParameterType, CommandParserLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, SpawnFunctionDeclaration, Usage, UtilsBuiltin };