@shell-shock/preset-cli 0.7.13 → 0.8.0

package/dist/components/banner-function-declaration.d.cts

@@ -1,11 +1,11 @@
-import * as _alloy_js_core3 from "@alloy-js/core";
+import * as _alloy_js_core1 from "@alloy-js/core";
 import { BannerFunctionDeclarationProps } from "@shell-shock/preset-script/components/banner-function-declaration";
 
 //#region src/components/banner-function-declaration.d.ts
 /**
  * A component to generate the `banner` function in the `shell-shock:console` builtin module.
  */
-declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): _alloy_js_core3.Children;
+declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): _alloy_js_core1.Children;
 //#endregion
 export { BannerFunctionDeclaration };
 //# sourceMappingURL=banner-function-declaration.d.cts.map

package/dist/components/banner-function-declaration.d.mts

@@ -1,11 +1,11 @@
-import * as _alloy_js_core3 from "@alloy-js/core";
+import * as _alloy_js_core2 from "@alloy-js/core";
 import { BannerFunctionDeclarationProps } from "@shell-shock/preset-script/components/banner-function-declaration";
 
 //#region src/components/banner-function-declaration.d.ts
 /**
  * A component to generate the `banner` function in the `shell-shock:console` builtin module.
  */
-declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): _alloy_js_core3.Children;
+declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): _alloy_js_core2.Children;
 //#endregion
 export { BannerFunctionDeclaration };
 //# sourceMappingURL=banner-function-declaration.d.mts.map

package/dist/components/command-entry.cjs

@@ -135,17 +135,34 @@ function CommandEntry(props) {
 																return __alloy_js_core.code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}`;
 															},
 															get children() {
-																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Switch, { get children() {
-																	return [
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return option.kind === __shell_shock_core.CommandParameterKinds.string;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+																	get when() {
+																		return option.kind === __shell_shock_core.CommandParameterKinds.boolean || !option.choices || option.choices.length === 0;
+																	},
+																	get fallback() {
+																		return __alloy_js_core.code`const value = await select({
+                              message: \`Please select a value for the \${colors.italic("${option.name}")} option\`, ${option.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
+                              ` : ""}options: [ ${option.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${option.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(option.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
+                          `;
+																	},
+																	get children() {
+																		return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Switch, { get children() {
+																			return [
+																				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+																					get when() {
+																						return option.kind === __shell_shock_core.CommandParameterKinds.string;
+																					},
+																					get children() {
+																						return __alloy_js_core.code`
                             const value = await text({
                               message: \`Please provide a value for the \${colors.italic("${option.name}")} option\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this option";
@@ -160,17 +177,17 @@ function CommandEntry(props) {
 
                             options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return option.kind === __shell_shock_core.CommandParameterKinds.number;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+																					get when() {
+																						return option.kind === __shell_shock_core.CommandParameterKinds.number;
+																					},
+																					get children() {
+																						return __alloy_js_core.code`
                             const value = await numeric({
                               message: \`Please provide a numeric value for the \${colors.italic("${option.name}")} option\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -179,17 +196,17 @@ function CommandEntry(props) {
 
                             options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return option.kind === __shell_shock_core.CommandParameterKinds.boolean;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+																					get when() {
+																						return option.kind === __shell_shock_core.CommandParameterKinds.boolean;
+																					},
+																					get children() {
+																						return __alloy_js_core.code`
                             const value = await toggle({
                               message: \`Please select a value for the \${colors.italic("${option.name}")} option\`,
-                            ${option.description ? `description: "${option.description}",
+                            ${option.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -198,10 +215,12 @@ function CommandEntry(props) {
 
                             options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} = value;
                           `;
-																			}
-																		})
-																	];
-																} });
+																					}
+																				})
+																			];
+																		} });
+																	}
+																});
 															}
 														}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 															get when() {
@@ -216,7 +235,7 @@ function CommandEntry(props) {
 																		return __alloy_js_core.code`
                             const value = await text({
                               message: \`Please provide one or more${option.kind === __shell_shock_core.CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${option.name}")} option (values are separated by a \\",\\" character)\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatDescription)(option.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this option";
@@ -260,17 +279,35 @@ function CommandEntry(props) {
 																return __alloy_js_core.code`!${(0, __stryke_string_format_camel_case.camelCase)(arg.name)}`;
 															},
 															get children() {
-																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Switch, { get children() {
-																	return [
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return arg.kind === __shell_shock_core.CommandParameterKinds.string;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+																	get when() {
+																		return arg.kind === __shell_shock_core.CommandParameterKinds.boolean || !arg.choices || arg.choices.length === 0;
+																	},
+																	get fallback() {
+																		return __alloy_js_core.code`const value = await select({
+                              message: \`Please select a value for the \${colors.italic("${arg.name}")} argument\`,${arg.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatDescription)(arg.description)}\`,
+                              ` : ""}
+                              options: [ ${arg.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${arg.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value;
+                          `;
+																	},
+																	get children() {
+																		return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Switch, { get children() {
+																			return [
+																				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+																					get when() {
+																						return arg.kind === __shell_shock_core.CommandParameterKinds.string;
+																					},
+																					get children() {
+																						return __alloy_js_core.code`
                             const value = await text({
                               message: \`Please provide a value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this argument";
@@ -285,17 +322,17 @@ function CommandEntry(props) {
 
                             ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return arg.kind === __shell_shock_core.CommandParameterKinds.number;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+																					get when() {
+																						return arg.kind === __shell_shock_core.CommandParameterKinds.number;
+																					},
+																					get children() {
+																						return __alloy_js_core.code`
                             const value = await numeric({
                               message: \`Please provide a numeric value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -304,17 +341,17 @@ function CommandEntry(props) {
 
                             ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value;
                           `;
-																			}
-																		}),
-																		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
-																			get when() {
-																				return arg.kind === __shell_shock_core.CommandParameterKinds.boolean;
-																			},
-																			get children() {
-																				return __alloy_js_core.code`
+																					}
+																				}),
+																				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+																					get when() {
+																						return arg.kind === __shell_shock_core.CommandParameterKinds.boolean;
+																					},
+																					get children() {
+																						return __alloy_js_core.code`
                             const value = await toggle({
                               message: \`Please select a value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -323,10 +360,12 @@ function CommandEntry(props) {
 
                             ${(0, __stryke_string_format_camel_case.camelCase)(arg.name)} = value;
                           `;
-																			}
-																		})
-																	];
-																} });
+																					}
+																				})
+																			];
+																		} });
+																	}
+																});
 															}
 														}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 															get when() {
@@ -341,7 +380,7 @@ function CommandEntry(props) {
 																		return __alloy_js_core.code`
                             const value = await text({
                               message: \`Please provide one or more${arg.kind === __shell_shock_core.CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${arg.name}")} argument (values are separated by a \\",\\" character)\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(arg.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this argument";

package/dist/components/command-entry.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core2 from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
 import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandTree } from "@shell-shock/core";
 
@@ -9,7 +9,7 @@ interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinitio
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core2.Children;
+declare function CommandEntry(props: CommandEntryProps): _alloy_js_core0.Children;
 //#endregion
 export { CommandEntry, CommandEntryProps };
 //# sourceMappingURL=command-entry.d.cts.map

package/dist/components/command-entry.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAyCiB,iBAAA,SAA0B,KACzC;WAGS;;AAJX;;;AAA2C,iBAU3B,YAAA,CAV2B,KAAA,EAUP,iBAVO,CAAA,EAUU,eAAA,CAAA,QAVV"}
+{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAiDiB,iBAAA,SAA0B,KACzC;WAGS;;AAJX;;;AAA2C,iBAU3B,YAAA,CAV2B,KAAA,EAUP,iBAVO,CAAA,EAUU,eAAA,CAAA,QAVV"}

package/dist/components/command-entry.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core2 from "@alloy-js/core";
+import * as _alloy_js_core3 from "@alloy-js/core";
 import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandTree } from "@shell-shock/core";
 
@@ -9,7 +9,7 @@ interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinitio
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core2.Children;
+declare function CommandEntry(props: CommandEntryProps): _alloy_js_core3.Children;
 //#endregion
 export { CommandEntry, CommandEntryProps };
 //# sourceMappingURL=command-entry.d.mts.map

package/dist/components/command-entry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAyCiB,iBAAA,SAA0B,KACzC;WAGS;;AAJX;;;AAA2C,iBAU3B,YAAA,CAV2B,KAAA,EAUP,iBAVO,CAAA,EAUU,eAAA,CAAA,QAVV"}
+{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;UAiDiB,iBAAA,SAA0B,KACzC;WAGS;;AAJX;;;AAA2C,iBAU3B,YAAA,CAV2B,KAAA,EAUP,iBAVO,CAAA,EAUU,eAAA,CAAA,QAVV"}

package/dist/components/command-entry.mjs

@@ -5,7 +5,7 @@ import { For, Match, Show, Switch, code, computed } from "@alloy-js/core";
 import { ElseIfClause, IfStatement } from "@alloy-js/typescript";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
+import { formatDescription, formatShortDescription, isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
 import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandParameterKinds } from "@shell-shock/core";
 import { CommandHandlerDeclaration, CommandValidationLogic } from "@shell-shock/preset-script/components/command-entry";
@@ -133,17 +133,34 @@ function CommandEntry(props) {
 																return code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`}`;
 															},
 															get children() {
-																return createComponent(Switch, { get children() {
-																	return [
-																		createComponent(Match, {
-																			get when() {
-																				return option.kind === CommandParameterKinds.string;
-																			},
-																			get children() {
-																				return code`
+																return createComponent(Show, {
+																	get when() {
+																		return option.kind === CommandParameterKinds.boolean || !option.choices || option.choices.length === 0;
+																	},
+																	get fallback() {
+																		return code`const value = await select({
+                              message: \`Please select a value for the \${colors.italic("${option.name}")} option\`, ${option.description ? `description: \`${formatDescription(option.description)}\`,
+                              ` : ""}options: [ ${option.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${option.description ? `description: \`${formatShortDescription(option.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
+                          `;
+																	},
+																	get children() {
+																		return createComponent(Switch, { get children() {
+																			return [
+																				createComponent(Match, {
+																					get when() {
+																						return option.kind === CommandParameterKinds.string;
+																					},
+																					get children() {
+																						return code`
                             const value = await text({
                               message: \`Please provide a value for the \${colors.italic("${option.name}")} option\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${formatDescription(option.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this option";
@@ -158,17 +175,17 @@ function CommandEntry(props) {
 
                             options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
                           `;
-																			}
-																		}),
-																		createComponent(Match, {
-																			get when() {
-																				return option.kind === CommandParameterKinds.number;
-																			},
-																			get children() {
-																				return code`
+																					}
+																				}),
+																				createComponent(Match, {
+																					get when() {
+																						return option.kind === CommandParameterKinds.number;
+																					},
+																					get children() {
+																						return code`
                             const value = await numeric({
                               message: \`Please provide a numeric value for the \${colors.italic("${option.name}")} option\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${formatDescription(option.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -177,17 +194,17 @@ function CommandEntry(props) {
 
                             options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
                           `;
-																			}
-																		}),
-																		createComponent(Match, {
-																			get when() {
-																				return option.kind === CommandParameterKinds.boolean;
-																			},
-																			get children() {
-																				return code`
+																					}
+																				}),
+																				createComponent(Match, {
+																					get when() {
+																						return option.kind === CommandParameterKinds.boolean;
+																					},
+																					get children() {
+																						return code`
                             const value = await toggle({
                               message: \`Please select a value for the \${colors.italic("${option.name}")} option\`,
-                            ${option.description ? `description: "${option.description}",
+                            ${option.description ? `description: \`${formatDescription(option.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -196,10 +213,12 @@ function CommandEntry(props) {
 
                             options${option.name.includes("?") ? `["${option.name}"]` : `.${camelCase(option.name)}`} = value;
                           `;
-																			}
-																		})
-																	];
-																} });
+																					}
+																				})
+																			];
+																		} });
+																	}
+																});
 															}
 														}), createComponent(Show, {
 															get when() {
@@ -214,7 +233,7 @@ function CommandEntry(props) {
 																		return code`
                             const value = await text({
                               message: \`Please provide one or more${option.kind === CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${option.name}")} option (values are separated by a \\",\\" character)\`,
-                              ${option.description ? `description: "${option.description}",
+                              ${option.description ? `description: \`${formatDescription(option.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this option";
@@ -258,17 +277,35 @@ function CommandEntry(props) {
 																return code`!${camelCase(arg.name)}`;
 															},
 															get children() {
-																return createComponent(Switch, { get children() {
-																	return [
-																		createComponent(Match, {
-																			get when() {
-																				return arg.kind === CommandParameterKinds.string;
-																			},
-																			get children() {
-																				return code`
+																return createComponent(Show, {
+																	get when() {
+																		return arg.kind === CommandParameterKinds.boolean || !arg.choices || arg.choices.length === 0;
+																	},
+																	get fallback() {
+																		return code`const value = await select({
+                              message: \`Please select a value for the \${colors.italic("${arg.name}")} argument\`,${arg.description ? `description: \`${formatDescription(arg.description)}\`,
+                              ` : ""}
+                              options: [ ${arg.choices?.map((choice) => `{ value: ${JSON.stringify(choice)}, label: "${choice}", ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`` : ""} }`).join(", ")} ]
+                            });
+                            if (isCancel(value)) {
+                              return;
+                            }
+
+                            ${camelCase(arg.name)} = value;
+                          `;
+																	},
+																	get children() {
+																		return createComponent(Switch, { get children() {
+																			return [
+																				createComponent(Match, {
+																					get when() {
+																						return arg.kind === CommandParameterKinds.string;
+																					},
+																					get children() {
+																						return code`
                             const value = await text({
                               message: \`Please provide a value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this argument";
@@ -283,17 +320,17 @@ function CommandEntry(props) {
 
                             ${camelCase(arg.name)} = value;
                           `;
-																			}
-																		}),
-																		createComponent(Match, {
-																			get when() {
-																				return arg.kind === CommandParameterKinds.number;
-																			},
-																			get children() {
-																				return code`
+																					}
+																				}),
+																				createComponent(Match, {
+																					get when() {
+																						return arg.kind === CommandParameterKinds.number;
+																					},
+																					get children() {
+																						return code`
                             const value = await numeric({
                               message: \`Please provide a numeric value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -302,17 +339,17 @@ function CommandEntry(props) {
 
                             ${camelCase(arg.name)} = value;
                           `;
-																			}
-																		}),
-																		createComponent(Match, {
-																			get when() {
-																				return arg.kind === CommandParameterKinds.boolean;
-																			},
-																			get children() {
-																				return code`
+																					}
+																				}),
+																				createComponent(Match, {
+																					get when() {
+																						return arg.kind === CommandParameterKinds.boolean;
+																					},
+																					get children() {
+																						return code`
                             const value = await toggle({
                               message: \`Please select a value for the \${colors.italic("${arg.name}")} argument\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
                               ` : ""}
                             });
                             if (isCancel(value)) {
@@ -321,10 +358,12 @@ function CommandEntry(props) {
 
                             ${camelCase(arg.name)} = value;
                           `;
-																			}
-																		})
-																	];
-																} });
+																					}
+																				})
+																			];
+																		} });
+																	}
+																});
 															}
 														}), createComponent(Show, {
 															get when() {
@@ -339,7 +378,7 @@ function CommandEntry(props) {
 																		return code`
                             const value = await text({
                               message: \`Please provide one or more${arg.kind === CommandParameterKinds.number ? " numeric" : ""} values for the \${colors.italic("${arg.name}")} argument (values are separated by a \\",\\" character)\`,
-                              ${arg.description ? `description: "${arg.description}",
+                              ${arg.description ? `description: \`${formatShortDescription(arg.description)}\`,
                               ` : ""}validate(val) {
                                 if (!val || val.trim() === "") {
                                   return "A value must be provided for this argument";

package/dist/components/command-entry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Match","Show","Switch","ElseIfClause","IfStatement","Spacing","usePowerlines","EntryFile","CommandParameterKinds","isDynamicPathSegment","CommandHandlerDeclaration","CommandValidationLogic","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","pascalCase","defu","BannerFunctionDeclaration","VirtualCommandEntry","CommandEntry","props","command","imports","builtinImports","rest","context","filePath","segments","filter","segment","join","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$createComponent","_$mergeProps","path","name","prompts","env","console","utils","upgrade","children","_$createIntrinsic","banner","condition","when","Object","values","options","option","optional","length","args","arg","map","kind","string","number","variadic","includes","each","doubleHardline","description","boolean","child","isVirtual","fallback"],"sources":["../../src/components/command-entry.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, computed, For, Match, Show, Switch } from \"@alloy-js/core\";\nimport { ElseIfClause, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport {\n  CommandHandlerDeclaration,\n  CommandValidationLogic\n} from \"@shell-shock/preset-script/components/command-entry\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { CLIPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<CLIPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(\n    () =>\n      `./${replaceExtension(\n        relativePath(\n          joinPaths(context.entryPath, findFilePath(filePath.value)),\n          command.entry.input?.file || command.entry.file\n        )\n      )}`\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`,\n          prompts: \"prompts\"\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\", \"paths\"],\n          console: [\n            \"debug\",\n            \"info\",\n            \"help\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"cursor\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\",\n            \"createSpinner\"\n          ],\n          utils: [\n            \"useApp\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isInteractive\",\n            \"isHelp\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ],\n          prompts: [\n            \"text\",\n            \"numeric\",\n            \"toggle\",\n            \"select\",\n            \"confirm\",\n            \"waitForKeyPress\",\n            \"isCancel\",\n            \"sleep\"\n          ],\n          upgrade: [\"checkForUpdates\", \"isCheckForUpdatesRequired\", \"upgrade\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await banner(); `}>\n          <IfStatement condition={code`!isInteractive`}>\n            <CommandValidationLogic command={command} />\n          </IfStatement>\n          <Show\n            when={\n              Object.values(command.options ?? {}).filter(\n                option => !option.optional\n              ).length > 0 ||\n              Object.values(command.args ?? {}).filter(arg => !arg.optional)\n                .length > 0\n            }>\n            <ElseIfClause\n              condition={code`!isHelp && (${Object.values(command.options ?? {})\n                .filter(option => !option.optional)\n                .map(option =>\n                  (option.kind === CommandParameterKinds.string ||\n                    option.kind === CommandParameterKinds.number) &&\n                  option.variadic\n                    ? `(!options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      } || options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }.length === 0)`\n                    : `options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      } === undefined`\n                )\n                .join(\" || \")}${\n                Object.values(command.options ?? {}).filter(\n                  option => !option.optional\n                ).length > 0 &&\n                Object.values(command.args ?? {}).filter(arg => !arg.optional)\n                  .length > 0\n                  ? \" || \"\n                  : \"\"\n              }${Object.values(command.args ?? {})\n                .filter(arg => !arg.optional)\n                .map(arg =>\n                  (arg.kind === CommandParameterKinds.string ||\n                    arg.kind === CommandParameterKinds.number) &&\n                  arg.variadic\n                    ? `(!${camelCase(\n                        arg.name\n                      )} || ${camelCase(arg.name)}.length === 0)`\n                    : `${camelCase(arg.name)} === undefined`\n                )\n                .join(\" || \")}) `}>\n              {code`writeLine(\"\"); `}\n              <Spacing />\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                        <Switch>\n                          <Match\n                            when={\n                              option.kind === CommandParameterKinds.string\n                            }>{code`\n                            const value = await text({\n                              message: \\`Please provide a value for the \\${colors.italic(\"${option.name}\")} option\\`,\n                              ${\n                                option.description\n                                  ? `description: \"${option.description}\",\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this option\";\n                                }\n\n                                return null;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value;\n                          `}</Match>\n                          <Match\n                            when={\n                              option.kind === CommandParameterKinds.number\n                            }>{code`\n                            const value = await numeric({\n                              message: \\`Please provide a numeric value for the \\${colors.italic(\"${option.name}\")} option\\`,\n                              ${\n                                option.description\n                                  ? `description: \"${option.description}\",\n                              `\n                                  : \"\"\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value;\n                          `}</Match>\n                          <Match\n                            when={\n                              option.kind === CommandParameterKinds.boolean\n                            }>{code`\n                            const value = await toggle({\n                              message: \\`Please select a value for the \\${colors.italic(\"${option.name}\")} option\\`,\n                            ${\n                              option.description\n                                ? `description: \"${option.description}\",\n                              `\n                                : \"\"\n                            }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value;\n                          `}</Match>\n                        </Switch>\n                      </IfStatement>\n                      <Show\n                        when={\n                          (option.kind === CommandParameterKinds.string ||\n                            option.kind === CommandParameterKinds.number) &&\n                          option.variadic\n                        }>\n                        <ElseIfClause\n                          condition={code`options${\n                            option.name.includes(\"?\")\n                              ? `[\"${option.name}\"]`\n                              : `.${camelCase(option.name)}`\n                          }.length === 0`}>\n                          {code`\n                            const value = await text({\n                              message: \\`Please provide one or more${\n                                option.kind === CommandParameterKinds.number\n                                  ? \" numeric\"\n                                  : \"\"\n                              } values for the \\${colors.italic(\"${option.name}\")} option (values are separated by a \\\\\",\\\\\" character)\\`,\n                              ${\n                                option.description\n                                  ? `description: \"${option.description}\",\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this option\";\n                                }\n                                if (val.split(\",\").map(v => v.trim()).filter(Boolean).length === 0) {\n                                  return \"At least one value must be provided for this option\";\n                                }\n                                ${\n                                  option.kind === CommandParameterKinds.number\n                                    ? `const invalidIndex = val.split(\",\").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));\n                                    if (invalidIndex !== -1) {\n                                      return \\`Invalid numeric value provided for item #\\${invalidIndex + 1} - all provided items must be a valid number\\`;\n                                    } `\n                                    : \"\"\n                                }\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value.split(\",\").map(value => value.trim()).filter(Boolean)${\n                              option.kind === CommandParameterKinds.number\n                                ? `.map(Number)`\n                                : \"\"\n                            } ;\n                          `}\n                        </ElseIfClause>\n                      </Show>\n                    </Show>\n                  </>\n                )}\n              </For>\n              <Spacing />\n              <For each={command.args} doubleHardline>\n                {arg => (\n                  <>\n                    <Show when={!arg.optional}>\n                      <IfStatement condition={code`!${camelCase(arg.name)}`}>\n                        <Switch>\n                          <Match\n                            when={\n                              arg.kind === CommandParameterKinds.string\n                            }>{code`\n                            const value = await text({\n                              message: \\`Please provide a value for the \\${colors.italic(\"${arg.name}\")} argument\\`,\n                              ${\n                                arg.description\n                                  ? `description: \"${arg.description}\",\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this argument\";\n                                }\n\n                                return null;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value;\n                          `}</Match>\n                          <Match\n                            when={\n                              arg.kind === CommandParameterKinds.number\n                            }>{code`\n                            const value = await numeric({\n                              message: \\`Please provide a numeric value for the \\${colors.italic(\"${arg.name}\")} argument\\`,\n                              ${\n                                arg.description\n                                  ? `description: \"${arg.description}\",\n                              `\n                                  : \"\"\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value;\n                          `}</Match>\n                          <Match\n                            when={\n                              arg.kind === CommandParameterKinds.boolean\n                            }>{code`\n                            const value = await toggle({\n                              message: \\`Please select a value for the \\${colors.italic(\"${arg.name}\")} argument\\`,\n                              ${\n                                arg.description\n                                  ? `description: \"${arg.description}\",\n                              `\n                                  : \"\"\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value;\n                          `}</Match>\n                        </Switch>\n                      </IfStatement>\n                      <Show\n                        when={\n                          (arg.kind === CommandParameterKinds.string ||\n                            arg.kind === CommandParameterKinds.number) &&\n                          arg.variadic\n                        }>\n                        <ElseIfClause\n                          condition={code`${camelCase(arg.name)}.length === 0`}>\n                          {code`\n                            const value = await text({\n                              message: \\`Please provide one or more${\n                                arg.kind === CommandParameterKinds.number\n                                  ? \" numeric\"\n                                  : \"\"\n                              } values for the \\${colors.italic(\"${arg.name}\")} argument (values are separated by a \\\\\",\\\\\" character)\\`,\n                              ${\n                                arg.description\n                                  ? `description: \"${arg.description}\",\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this argument\";\n                                }\n                                if (val.split(\",\").map(v => v.trim()).filter(Boolean).length === 0) {\n                                  return \"At least one value must be provided for this argument\";\n                                }\n                                ${\n                                  arg.kind === CommandParameterKinds.number\n                                    ? `const invalidIndex = val.split(\",\").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));\n                                    if (invalidIndex !== -1) {\n                                      return \\`Invalid numeric value provided for item #\\${invalidIndex + 1} - all provided items must be a valid number\\`;\n                                    } `\n                                    : \"\"\n                                }\n\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value.split(\",\").map(value => value.trim()).filter(Boolean)${\n                              arg.kind === CommandParameterKinds.number\n                                ? `.map(Number)`\n                                : \"\"\n                            } ;\n                          `}\n                        </ElseIfClause>\n                      </Show>\n                    </Show>\n                  </>\n                )}\n              </For>\n              {code`writeLine(\"\"); `}\n              <Spacing />\n            </ElseIfClause>\n          </Show>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Match","Show","Switch","ElseIfClause","IfStatement","Spacing","usePowerlines","EntryFile","CommandParameterKinds","formatDescription","formatShortDescription","isDynamicPathSegment","CommandHandlerDeclaration","CommandValidationLogic","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","pascalCase","defu","BannerFunctionDeclaration","VirtualCommandEntry","CommandEntry","props","command","imports","builtinImports","rest","context","filePath","segments","filter","segment","join","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$createComponent","_$mergeProps","path","name","prompts","env","console","utils","upgrade","children","_$createIntrinsic","banner","condition","when","Object","values","options","option","optional","length","args","arg","map","kind","string","number","variadic","includes","each","doubleHardline","boolean","choices","fallback","description","choice","JSON","stringify","child","isVirtual"],"sources":["../../src/components/command-entry.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, computed, For, Match, Show, Switch } from \"@alloy-js/core\";\nimport { ElseIfClause, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport type {\n  CommandTree,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n  formatDescription,\n  formatShortDescription,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport {\n  CommandHandlerDeclaration,\n  CommandValidationLogic\n} from \"@shell-shock/preset-script/components/command-entry\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { CLIPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<CLIPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(\n    () =>\n      `./${replaceExtension(\n        relativePath(\n          joinPaths(context.entryPath, findFilePath(filePath.value)),\n          command.entry.input?.file || command.entry.file\n        )\n      )}`\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`,\n          prompts: \"prompts\"\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\", \"paths\"],\n          console: [\n            \"debug\",\n            \"info\",\n            \"help\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"cursor\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\",\n            \"createSpinner\"\n          ],\n          utils: [\n            \"useApp\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isInteractive\",\n            \"isHelp\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ],\n          prompts: [\n            \"text\",\n            \"numeric\",\n            \"toggle\",\n            \"select\",\n            \"confirm\",\n            \"waitForKeyPress\",\n            \"isCancel\",\n            \"sleep\"\n          ],\n          upgrade: [\"checkForUpdates\", \"isCheckForUpdatesRequired\", \"upgrade\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await banner(); `}>\n          <IfStatement condition={code`!isInteractive`}>\n            <CommandValidationLogic command={command} />\n          </IfStatement>\n          <Show\n            when={\n              Object.values(command.options ?? {}).filter(\n                option => !option.optional\n              ).length > 0 ||\n              Object.values(command.args ?? {}).filter(arg => !arg.optional)\n                .length > 0\n            }>\n            <ElseIfClause\n              condition={code`!isHelp && (${Object.values(command.options ?? {})\n                .filter(option => !option.optional)\n                .map(option =>\n                  (option.kind === CommandParameterKinds.string ||\n                    option.kind === CommandParameterKinds.number) &&\n                  option.variadic\n                    ? `(!options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      } || options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      }.length === 0)`\n                    : `options${\n                        option.name.includes(\"?\")\n                          ? `[\"${option.name}\"]`\n                          : `.${camelCase(option.name)}`\n                      } === undefined`\n                )\n                .join(\" || \")}${\n                Object.values(command.options ?? {}).filter(\n                  option => !option.optional\n                ).length > 0 &&\n                Object.values(command.args ?? {}).filter(arg => !arg.optional)\n                  .length > 0\n                  ? \" || \"\n                  : \"\"\n              }${Object.values(command.args ?? {})\n                .filter(arg => !arg.optional)\n                .map(arg =>\n                  (arg.kind === CommandParameterKinds.string ||\n                    arg.kind === CommandParameterKinds.number) &&\n                  arg.variadic\n                    ? `(!${camelCase(\n                        arg.name\n                      )} || ${camelCase(arg.name)}.length === 0)`\n                    : `${camelCase(arg.name)} === undefined`\n                )\n                .join(\" || \")}) `}>\n              {code`writeLine(\"\"); `}\n              <Spacing />\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                        <Show\n                          when={\n                            option.kind === CommandParameterKinds.boolean ||\n                            !option.choices ||\n                            option.choices.length === 0\n                          }\n                          fallback={code`const value = await select({\n                              message: \\`Please select a value for the \\${colors.italic(\"${\n                                option.name\n                              }\")} option\\`, ${\n                                option.description\n                                  ? `description: \\`${formatDescription(\n                                      option.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }options: [ ${(\n                                option as\n                                  | StringCommandParameter\n                                  | NumberCommandParameter\n                              ).choices\n                                ?.map(\n                                  choice =>\n                                    `{ value: ${JSON.stringify(\n                                      choice\n                                    )}, label: \"${choice}\", ${\n                                      option.description\n                                        ? `description: \\`${formatShortDescription(\n                                            option.description\n                                          )}\\``\n                                        : \"\"\n                                    } }`\n                                )\n                                .join(\", \")} ]\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value;\n                          `}>\n                          <Switch>\n                            <Match\n                              when={\n                                option.kind === CommandParameterKinds.string\n                              }>{code`\n                            const value = await text({\n                              message: \\`Please provide a value for the \\${colors.italic(\"${\n                                option.name\n                              }\")} option\\`,\n                              ${\n                                option.description\n                                  ? `description: \\`${formatDescription(\n                                      option.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this option\";\n                                }\n\n                                return null;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value;\n                          `}</Match>\n                            <Match\n                              when={\n                                option.kind === CommandParameterKinds.number\n                              }>{code`\n                            const value = await numeric({\n                              message: \\`Please provide a numeric value for the \\${colors.italic(\"${option.name}\")} option\\`,\n                              ${\n                                option.description\n                                  ? `description: \\`${formatDescription(\n                                      option.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value;\n                          `}</Match>\n                            <Match\n                              when={\n                                option.kind === CommandParameterKinds.boolean\n                              }>{code`\n                            const value = await toggle({\n                              message: \\`Please select a value for the \\${colors.italic(\"${option.name}\")} option\\`,\n                            ${\n                              option.description\n                                ? `description: \\`${formatDescription(\n                                    option.description\n                                  )}\\`,\n                              `\n                                : \"\"\n                            }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value;\n                          `}</Match>\n                          </Switch>\n                        </Show>\n                      </IfStatement>\n                      <Show\n                        when={\n                          (option.kind === CommandParameterKinds.string ||\n                            option.kind === CommandParameterKinds.number) &&\n                          option.variadic\n                        }>\n                        <ElseIfClause\n                          condition={code`options${\n                            option.name.includes(\"?\")\n                              ? `[\"${option.name}\"]`\n                              : `.${camelCase(option.name)}`\n                          }.length === 0`}>\n                          {code`\n                            const value = await text({\n                              message: \\`Please provide one or more${\n                                option.kind === CommandParameterKinds.number\n                                  ? \" numeric\"\n                                  : \"\"\n                              } values for the \\${colors.italic(\"${\n                                option.name\n                              }\")} option (values are separated by a \\\\\",\\\\\" character)\\`,\n                              ${\n                                option.description\n                                  ? `description: \\`${formatDescription(\n                                      option.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this option\";\n                                }\n                                if (val.split(\",\").map(v => v.trim()).filter(Boolean).length === 0) {\n                                  return \"At least one value must be provided for this option\";\n                                }\n                                ${\n                                  option.kind === CommandParameterKinds.number\n                                    ? `const invalidIndex = val.split(\",\").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));\n                                    if (invalidIndex !== -1) {\n                                      return \\`Invalid numeric value provided for item #\\${invalidIndex + 1} - all provided items must be a valid number\\`;\n                                    } `\n                                    : \"\"\n                                }\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            options${\n                              option.name.includes(\"?\")\n                                ? `[\"${option.name}\"]`\n                                : `.${camelCase(option.name)}`\n                            } = value.split(\",\").map(value => value.trim()).filter(Boolean)${\n                              option.kind === CommandParameterKinds.number\n                                ? `.map(Number)`\n                                : \"\"\n                            } ;\n                          `}\n                        </ElseIfClause>\n                      </Show>\n                    </Show>\n                  </>\n                )}\n              </For>\n              <Spacing />\n              <For each={command.args} doubleHardline>\n                {arg => (\n                  <>\n                    <Show when={!arg.optional}>\n                      <IfStatement condition={code`!${camelCase(arg.name)}`}>\n                        <Show\n                          when={\n                            arg.kind === CommandParameterKinds.boolean ||\n                            !arg.choices ||\n                            arg.choices.length === 0\n                          }\n                          fallback={code`const value = await select({\n                              message: \\`Please select a value for the \\${colors.italic(\"${\n                                arg.name\n                              }\")} argument\\`,${\n                                arg.description\n                                  ? `description: \\`${formatDescription(\n                                      arg.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }\n                              options: [ ${(\n                                arg as\n                                  | StringCommandParameter\n                                  | NumberCommandParameter\n                              ).choices\n                                ?.map(\n                                  choice =>\n                                    `{ value: ${JSON.stringify(\n                                      choice\n                                    )}, label: \"${choice}\", ${\n                                      arg.description\n                                        ? `description: \\`${formatShortDescription(\n                                            arg.description\n                                          )}\\``\n                                        : \"\"\n                                    } }`\n                                )\n                                .join(\", \")} ]\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value;\n                          `}>\n                          <Switch>\n                            <Match\n                              when={\n                                arg.kind === CommandParameterKinds.string\n                              }>{code`\n                            const value = await text({\n                              message: \\`Please provide a value for the \\${colors.italic(\"${arg.name}\")} argument\\`,\n                              ${\n                                arg.description\n                                  ? `description: \\`${formatShortDescription(\n                                      arg.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this argument\";\n                                }\n\n                                return null;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value;\n                          `}</Match>\n                            <Match\n                              when={\n                                arg.kind === CommandParameterKinds.number\n                              }>{code`\n                            const value = await numeric({\n                              message: \\`Please provide a numeric value for the \\${colors.italic(\"${arg.name}\")} argument\\`,\n                              ${\n                                arg.description\n                                  ? `description: \\`${formatShortDescription(\n                                      arg.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value;\n                          `}</Match>\n                            <Match\n                              when={\n                                arg.kind === CommandParameterKinds.boolean\n                              }>{code`\n                            const value = await toggle({\n                              message: \\`Please select a value for the \\${colors.italic(\"${arg.name}\")} argument\\`,\n                              ${\n                                arg.description\n                                  ? `description: \\`${formatShortDescription(\n                                      arg.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value;\n                          `}</Match>\n                          </Switch>\n                        </Show>\n                      </IfStatement>\n                      <Show\n                        when={\n                          (arg.kind === CommandParameterKinds.string ||\n                            arg.kind === CommandParameterKinds.number) &&\n                          arg.variadic\n                        }>\n                        <ElseIfClause\n                          condition={code`${camelCase(arg.name)}.length === 0`}>\n                          {code`\n                            const value = await text({\n                              message: \\`Please provide one or more${\n                                arg.kind === CommandParameterKinds.number\n                                  ? \" numeric\"\n                                  : \"\"\n                              } values for the \\${colors.italic(\"${arg.name}\")} argument (values are separated by a \\\\\",\\\\\" character)\\`,\n                              ${\n                                arg.description\n                                  ? `description: \\`${formatShortDescription(\n                                      arg.description\n                                    )}\\`,\n                              `\n                                  : \"\"\n                              }validate(val) {\n                                if (!val || val.trim() === \"\") {\n                                  return \"A value must be provided for this argument\";\n                                }\n                                if (val.split(\",\").map(v => v.trim()).filter(Boolean).length === 0) {\n                                  return \"At least one value must be provided for this argument\";\n                                }\n                                ${\n                                  arg.kind === CommandParameterKinds.number\n                                    ? `const invalidIndex = val.split(\",\").map(v => v.trim()).filter(Boolean).findIndex(v => Number.isNaN(Number(v));\n                                    if (invalidIndex !== -1) {\n                                      return \\`Invalid numeric value provided for item #\\${invalidIndex + 1} - all provided items must be a valid number\\`;\n                                    } `\n                                    : \"\"\n                                }\n\n                                return undefined;\n                              }\n                            });\n                            if (isCancel(value)) {\n                              return;\n                            }\n\n                            ${camelCase(arg.name)} = value.split(\",\").map(value => value.trim()).filter(Boolean)${\n                              arg.kind === CommandParameterKinds.number\n                                ? `.map(Number)`\n                                : \"\"\n                            } ;\n                          `}\n                        </ElseIfClause>\n                      </Show>\n                    </Show>\n                  </>\n                )}\n              </For>\n              {code`writeLine(\"\"); `}\n              <Spacing />\n            </ElseIfClause>\n          </Show>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-router.cjs

@@ -3,6 +3,7 @@ let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 let __alloy_js_typescript = require("@alloy-js/typescript");
 let __powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let __shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
 let __shell_shock_preset_script_components = require("@shell-shock/preset-script/components");
 
 //#region src/components/command-router.tsx
@@ -16,7 +17,7 @@ function CommandRouterSelectOptions(props) {
 		hardline: true,
 		children: (command) => command.isVirtual ? (0, __alloy_js_core_jsx_runtime.createComponent)(CommandRouterSelectOptions, { get commands() {
 			return command.children ?? {};
-		} }) : __alloy_js_core.code`{ value: [${command.segments.map((segment) => `"${segment}"`).join(", ")}], label: "${command.title}", description: "${command.description}"${command.icon ? `, icon: "${command.icon}"` : ""} }`
+		} }) : __alloy_js_core.code`{ value: [${command.segments.map((segment) => `"${segment}"`).join(", ")}], label: "${command.title}", description: \`${(0, __shell_shock_core_plugin_utils.formatShortDescription)(command.description)}\`${command.icon ? `, icon: "${command.icon}"` : ""} }`
 	});
 }
 /**

package/dist/components/command-router.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core2 from "@alloy-js/core";
 import { CommandTree } from "@shell-shock/core";
 import { CommandRouterProps } from "@shell-shock/preset-script/components";
 
@@ -6,11 +6,11 @@ import { CommandRouterProps } from "@shell-shock/preset-script/components";
 interface CommandRouterSelectOptionsProps {
   commands?: Record<string, CommandTree>;
 }
-declare function CommandRouterSelectOptions(props: CommandRouterSelectOptionsProps): _alloy_js_core0.Children;
+declare function CommandRouterSelectOptions(props: CommandRouterSelectOptionsProps): _alloy_js_core2.Children;
 /**
  * A component that renders a command router interface, allowing users to select and execute commands from a provided list of commands and segments. This component serves as a wrapper around the base CommandRouter, adding additional UI elements and logic for command selection.
  */
-declare function CommandRouter(props: CommandRouterProps): _alloy_js_core0.Children;
+declare function CommandRouter(props: CommandRouterProps): _alloy_js_core2.Children;
 //#endregion
 export { CommandRouter, CommandRouterSelectOptions, CommandRouterSelectOptionsProps };
 //# sourceMappingURL=command-router.d.cts.map

package/dist/components/command-router.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"command-router.d.cts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;;UA4BiB,+BAAA;aACJ,eAAe;;AADX,iBAID,0BAAA,CAHY,KAAA,EAInB,+BAJU,CAAA,EAIqB,eAAA,CAAA,QAJrB;AAGnB;AAyBA;;iBAAgB,aAAA,QAAqB,qBAAkB,eAAA,CAAA"}
+{"version":3,"file":"command-router.d.cts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;;UA6BiB,+BAAA;aACJ,eAAe;;AADX,iBAID,0BAAA,CAHY,KAAA,EAInB,+BAJU,CAAA,EAIqB,eAAA,CAAA,QAJrB;AAGnB;AA2BA;;iBAAgB,aAAA,QAAqB,qBAAkB,eAAA,CAAA"}

package/dist/components/command-router.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-router.d.mts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;;UA4BiB,+BAAA;aACJ,eAAe;;AADX,iBAID,0BAAA,CAHY,KAAA,EAInB,+BAJU,CAAA,EAIqB,eAAA,CAAA,QAJrB;AAGnB;AAyBA;;iBAAgB,aAAA,QAAqB,qBAAkB,eAAA,CAAA"}
+{"version":3,"file":"command-router.d.mts","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":[],"mappings":";;;;;UA6BiB,+BAAA;aACJ,eAAe;;AADX,iBAID,0BAAA,CAHY,KAAA,EAInB,+BAJU,CAAA,EAIqB,eAAA,CAAA,QAJrB;AAGnB;AA2BA;;iBAAgB,aAAA,QAAqB,qBAAkB,eAAA,CAAA"}

package/dist/components/command-router.mjs

@@ -2,6 +2,7 @@ import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { For, code } from "@alloy-js/core";
 import { IfStatement } from "@alloy-js/typescript";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { formatShortDescription } from "@shell-shock/core/plugin-utils";
 import { CommandRouter as CommandRouter$1, CommandRouterBody } from "@shell-shock/preset-script/components";
 
 //#region src/components/command-router.tsx
@@ -15,7 +16,7 @@ function CommandRouterSelectOptions(props) {
 		hardline: true,
 		children: (command) => command.isVirtual ? createComponent(CommandRouterSelectOptions, { get commands() {
 			return command.children ?? {};
-		} }) : code`{ value: [${command.segments.map((segment) => `"${segment}"`).join(", ")}], label: "${command.title}", description: "${command.description}"${command.icon ? `, icon: "${command.icon}"` : ""} }`
+		} }) : code`{ value: [${command.segments.map((segment) => `"${segment}"`).join(", ")}], label: "${command.title}", description: \`${formatShortDescription(command.description)}\`${command.icon ? `, icon: "${command.icon}"` : ""} }`
 	});
 }
 /**

package/dist/components/command-router.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-router.mjs","names":["code","For","IfStatement","Spacing","CommandRouter","BaseCommandRouter","CommandRouterBody","CommandRouterSelectOptions","props","commands","_$createComponent","each","Object","values","joiner","hardline","children","command","isVirtual","segments","map","segment","join","title","description","icon","_$mergeProps","condition","_$memo","length"],"sources":["../../src/components/command-router.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 } from \"@alloy-js/core\";\nimport { IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport type { CommandRouterProps } from \"@shell-shock/preset-script/components\";\nimport {\n  CommandRouter as BaseCommandRouter,\n  CommandRouterBody\n} from \"@shell-shock/preset-script/components\";\n\nexport interface CommandRouterSelectOptionsProps {\n  commands?: Record<string, CommandTree>;\n}\n\nexport function CommandRouterSelectOptions(\n  props: CommandRouterSelectOptionsProps\n) {\n  const { commands } = props;\n\n  return (\n    <For each={Object.values(commands ?? {})} joiner=\",\" hardline>\n      {command =>\n        command.isVirtual ? (\n          <CommandRouterSelectOptions commands={command.children ?? {}} />\n        ) : (\n          code`{ value: [${command.segments\n            .map(segment => `\"${segment}\"`)\n            .join(\", \")}], label: \"${command.title}\", description: \"${\n            command.description\n          }\"${command.icon ? `, icon: \"${command.icon}\"` : \"\"} }`\n        )\n      }\n    </For>\n  );\n}\n\n/**\n * A component that renders a command router interface, allowing users to select and execute commands from a provided list of commands and segments. This component serves as a wrapper around the base CommandRouter, adding additional UI elements and logic for command selection.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands } = props;\n\n  return (\n    <>\n      <BaseCommandRouter {...props} segments={segments} commands={commands} />\n      <Spacing />\n      <IfStatement condition={code`isInteractive && !isHelp`}>\n        {code`await banner();\n\n        let segments = await select({\n          message: \"Which command would you like to execute?\",\n          options: [ `}\n        <CommandRouterSelectOptions commands={commands} />\n        {` ],\n        });\n        if (isCancel(segments)) {\n          return;\n        }\n\n        let dynamics = {} as Record<string, string>;\n        for (const dynamic of segments.filter(segment => segment.startsWith(\"[\") && segment.endsWith(\"]\"))) {\n          const value = await text({\n            message: \\`Please provide a value for \\${dynamic.replace(/^\\[+/, \"\").replace(/\\]+$/, \"\")}:\\`,\n          });\n          if (isCancel(value)) {\n            return;\n          }\n          dynamics[dynamic] = value;\n        }\n\n        segments = segments.map(segment => dynamics[segment] || segment);\n        const context = useApp();\n        context.set(\"args\", [args.length > 0 ? args[0] : undefined, args.length > 1 ? args[1] : undefined, ...segments, ...args.slice(${\n          segments.length + 2\n        })].filter(Boolean) as string[]);\n\n        command = segments[0];\n        args = context.get(\"args\"); `}\n        <CommandRouterBody {...props} segments={segments} commands={commands} />\n      </IfStatement>\n      <Spacing />\n    </>\n  );\n}\n"],"mappings":";;;;;;;AAgCA,SAAgBO,2BACdC,OACA;CACA,MAAM,EAAEC,aAAaD;AAErB,QAAAE,gBACGT,KAAG;EAAA,IAACU,OAAI;AAAA,UAAEC,OAAOC,OAAOJ,YAAY,EAAE,CAAC;;EAAEK,QAAM;EAAKC,UAAQ;EAAAC,WAC1DC,YACCA,QAAQC,YAASR,gBACdH,4BAA0B,EAAA,IAACE,WAAQ;AAAA,UAAEQ,QAAQD,YAAY,EAAE;KAAA,CAAA,GAE5DhB,IAAI,aAAaiB,QAAQE,SACtBC,KAAIC,YAAW,IAAIA,QAAO,GAAI,CAC9BC,KAAK,KAAK,CAAA,aAAcL,QAAQM,MAAK,mBACtCN,QAAQO,YAAW,GACjBP,QAAQQ,OAAO,YAAYR,QAAQQ,KAAI,KAAM,GAAE;EACpD,CAAA;;;;;AAST,SAAgBrB,cAAcI,OAA2B;CACvD,MAAM,EAAEW,UAAUV,aAAaD;AAE/B,QAAA;EAAAE,gBAEKL,iBAAiBqB,WAAKlB,OAAK;GAAYW;GAAoBV;GAAQ,CAAA,CAAA;EAAAC,gBACnEP,SAAO,EAAA,CAAA;EAAAO,gBACPR,aAAW;GAACyB,WAAW3B,IAAI;GAA0B,IAAAgB,WAAA;AAAA,WAAA;KACnDhB,IAAI;;;;;KAISU,gBACbH,4BAA0B,EAAWE,UAAQ,CAAA;KAAAmB,WAC7C;;;;;;;;;;;;;;;;;;;wIAoBCT,SAASU,SAAS,EAAC;;;sCAIQ;KAAAnB,gBAC5BJ,mBAAiBoB,WAAKlB,OAAK;MAAYW;MAAoBV;MAAQ,CAAA,CAAA;KAAA;;GAAA,CAAA;EAAAC,gBAErEP,SAAO,EAAA,CAAA;EAAA"}
+{"version":3,"file":"command-router.mjs","names":["code","For","IfStatement","Spacing","formatShortDescription","CommandRouter","BaseCommandRouter","CommandRouterBody","CommandRouterSelectOptions","props","commands","_$createComponent","each","Object","values","joiner","hardline","children","command","isVirtual","segments","map","segment","join","title","description","icon","_$mergeProps","condition","_$memo","length"],"sources":["../../src/components/command-router.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 } from \"@alloy-js/core\";\nimport { IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { formatShortDescription } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandRouterProps } from \"@shell-shock/preset-script/components\";\nimport {\n  CommandRouter as BaseCommandRouter,\n  CommandRouterBody\n} from \"@shell-shock/preset-script/components\";\n\nexport interface CommandRouterSelectOptionsProps {\n  commands?: Record<string, CommandTree>;\n}\n\nexport function CommandRouterSelectOptions(\n  props: CommandRouterSelectOptionsProps\n) {\n  const { commands } = props;\n\n  return (\n    <For each={Object.values(commands ?? {})} joiner=\",\" hardline>\n      {command =>\n        command.isVirtual ? (\n          <CommandRouterSelectOptions commands={command.children ?? {}} />\n        ) : (\n          code`{ value: [${command.segments\n            .map(segment => `\"${segment}\"`)\n            .join(\n              \", \"\n            )}], label: \"${command.title}\", description: \\`${formatShortDescription(\n            command.description\n          )}\\`${command.icon ? `, icon: \"${command.icon}\"` : \"\"} }`\n        )\n      }\n    </For>\n  );\n}\n\n/**\n * A component that renders a command router interface, allowing users to select and execute commands from a provided list of commands and segments. This component serves as a wrapper around the base CommandRouter, adding additional UI elements and logic for command selection.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands } = props;\n\n  return (\n    <>\n      <BaseCommandRouter {...props} segments={segments} commands={commands} />\n      <Spacing />\n      <IfStatement condition={code`isInteractive && !isHelp`}>\n        {code`await banner();\n\n        let segments = await select({\n          message: \"Which command would you like to execute?\",\n          options: [ `}\n        <CommandRouterSelectOptions commands={commands} />\n        {` ],\n        });\n        if (isCancel(segments)) {\n          return;\n        }\n\n        let dynamics = {} as Record<string, string>;\n        for (const dynamic of segments.filter(segment => segment.startsWith(\"[\") && segment.endsWith(\"]\"))) {\n          const value = await text({\n            message: \\`Please provide a value for \\${dynamic.replace(/^\\[+/, \"\").replace(/\\]+$/, \"\")}:\\`,\n          });\n          if (isCancel(value)) {\n            return;\n          }\n          dynamics[dynamic] = value;\n        }\n\n        segments = segments.map(segment => dynamics[segment] || segment);\n        const context = useApp();\n        context.set(\"args\", [args.length > 0 ? args[0] : undefined, args.length > 1 ? args[1] : undefined, ...segments, ...args.slice(${\n          segments.length + 2\n        })].filter(Boolean) as string[]);\n\n        command = segments[0];\n        args = context.get(\"args\"); `}\n        <CommandRouterBody {...props} segments={segments} commands={commands} />\n      </IfStatement>\n      <Spacing />\n    </>\n  );\n}\n"],"mappings":";;;;;;;;AAiCA,SAAgBQ,2BACdC,OACA;CACA,MAAM,EAAEC,aAAaD;AAErB,QAAAE,gBACGV,KAAG;EAAA,IAACW,OAAI;AAAA,UAAEC,OAAOC,OAAOJ,YAAY,EAAE,CAAC;;EAAEK,QAAM;EAAKC,UAAQ;EAAAC,WAC1DC,YACCA,QAAQC,YAASR,gBACdH,4BAA0B,EAAA,IAACE,WAAQ;AAAA,UAAEQ,QAAQD,YAAY,EAAE;KAAA,CAAA,GAE5DjB,IAAI,aAAakB,QAAQE,SACtBC,KAAIC,YAAW,IAAIA,QAAO,GAAI,CAC9BC,KACC,KACD,CAAA,aAAcL,QAAQM,MAAK,oBAAqBpB,uBACjDc,QAAQO,YACT,CAAA,IAAKP,QAAQQ,OAAO,YAAYR,QAAQQ,KAAI,KAAM,GAAE;EACtD,CAAA;;;;;AAST,SAAgBrB,cAAcI,OAA2B;CACvD,MAAM,EAAEW,UAAUV,aAAaD;AAE/B,QAAA;EAAAE,gBAEKL,iBAAiBqB,WAAKlB,OAAK;GAAYW;GAAoBV;GAAQ,CAAA,CAAA;EAAAC,gBACnER,SAAO,EAAA,CAAA;EAAAQ,gBACPT,aAAW;GAAC0B,WAAW5B,IAAI;GAA0B,IAAAiB,WAAA;AAAA,WAAA;KACnDjB,IAAI;;;;;KAISW,gBACbH,4BAA0B,EAAWE,UAAQ,CAAA;KAAAmB,WAC7C;;;;;;;;;;;;;;;;;;;wIAoBCT,SAASU,SAAS,EAAC;;;sCAIQ;KAAAnB,gBAC5BJ,mBAAiBoB,WAAKlB,OAAK;MAAYW;MAAoBV;MAAQ,CAAA,CAAA;KAAA;;GAAA,CAAA;EAAAC,gBAErER,SAAO,EAAA,CAAA;EAAA"}

package/dist/components/virtual-command-entry.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core1 from "@alloy-js/core";
 import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandTree } from "@shell-shock/core";
 
@@ -9,7 +9,7 @@ interface VirtualCommandEntryProps extends Omit<EntryFileProps, "path" | "typeDe
 /**
  * The virtual command entry point for the Shell Shock project.
  */
-declare function VirtualCommandEntry(props: VirtualCommandEntryProps): _alloy_js_core0.Children;
+declare function VirtualCommandEntry(props: VirtualCommandEntryProps): _alloy_js_core1.Children;
 //#endregion
 export { VirtualCommandEntry, VirtualCommandEntryProps };
 //# sourceMappingURL=virtual-command-entry.d.mts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-cli",
-  "version": "0.7.13",
+  "version": "0.8.0",
   "private": false,
   "description": "A package containing a Shell Shock plugin to generate source code given a list design tokens.",
   "keywords": [
@@ -170,12 +170,12 @@
     "@powerlines/deepkit": "^0.6.90",
     "@powerlines/plugin-alloy": "^0.24.2",
     "@powerlines/plugin-plugin": "^0.12.262",
-    "@shell-shock/core": "^0.11.0",
-    "@shell-shock/plugin-console": "^0.1.7",
-    "@shell-shock/plugin-prompts": "^0.3.8",
-    "@shell-shock/plugin-theme": "^0.3.11",
-    "@shell-shock/plugin-upgrade": "^0.1.13",
-    "@shell-shock/preset-script": "^0.6.22",
+    "@shell-shock/core": "^0.12.0",
+    "@shell-shock/plugin-console": "^0.1.8",
+    "@shell-shock/plugin-prompts": "^0.3.9",
+    "@shell-shock/plugin-theme": "^0.3.12",
+    "@shell-shock/plugin-upgrade": "^0.1.14",
+    "@shell-shock/preset-script": "^0.6.23",
     "@stryke/path": "^0.26.12",
     "@stryke/string-format": "^0.14.8",
     "cfonts": "^3.3.1",
@@ -210,5 +210,5 @@
       "./package.json": "./package.json"
     }
   },
-  "gitHead": "6fbda1ffc234bdd12b5d0fd0a32e59727b369c5c"
+  "gitHead": "c38d304433a296936fb8ca58aa138a0039918931"
 }