@shell-shock/core 0.10.0 → 0.12.0

package/dist/components/options-parser-logic.mjs

@@ -1,13 +1,13 @@
 import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
+import { CommandParameterKinds } from "../types/command.mjs";
 import { computedOptions } from "../contexts/options.mjs";
-import { BooleanInputParserLogic } from "./helpers.mjs";
+import { BooleanInputParserLogic, CommandParameterType } from "./helpers.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { camelCase } from "@stryke/string-format/camel-case";
 import { constantCase } from "@stryke/string-format/constant-case";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
-import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 import { ElseClause, ElseIfClause, IfStatement, InterfaceDeclaration, InterfaceMember, VarDeclaration } from "@alloy-js/typescript";
 import { pascalCase } from "@stryke/string-format/pascal-case";
 
@@ -46,10 +46,10 @@ function DynamicSegmentsParserLogic(props) {
 	});
 }
 function ArgumentsParserLogic(props) {
-	const { command, envPrefix, isCaseSensitive } = props;
+	const { command, appSpecificEnvPrefix, isCaseSensitive } = props;
 	return createComponent(Show, {
 		get when() {
-			return command.arguments && command.arguments.length > 0;
+			return command.args && command.args.length > 0;
 		},
 		get children() {
 			return [
@@ -73,37 +73,51 @@ function ArgumentsParserLogic(props) {
 				createComponent(Spacing, {}),
 				createComponent(For, {
 					get each() {
-						return command.arguments ?? [];
+						return command.args ?? [];
 					},
 					hardline: true,
 					children: (arg, index) => [
-						createComponent(VarDeclaration, {
-							"let": true,
-							get name() {
-								return camelCase(arg.name);
+						createComponent(Show, {
+							get when() {
+								return isSetString(arg.env) || arg.default !== void 0 || (arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic;
 							},
-							get type() {
-								return `${arg.kind === ReflectionKind.boolean ? "boolean" : arg.kind === ReflectionKind.number ? "number" : "string"}${(arg.kind === ReflectionKind.string || arg.kind === ReflectionKind.number) && arg.variadic ? "[]" : ""}${arg.optional ? " | undefined" : ""}`;
+							get fallback() {
+								return [
+									memo(() => code`let ${camelCase(arg.name)}!: `),
+									createComponent(CommandParameterType, { parameter: arg }),
+									code`; `
+								];
 							},
-							get initializer() {
-								return [createComponent(Show, {
-									get when() {
-										return isSetString(arg.env);
+							get children() {
+								return createComponent(VarDeclaration, {
+									"let": true,
+									get name() {
+										return camelCase(arg.name);
 									},
-									get children() {
-										return code`env.${envPrefix}_${constantCase(String(arg.env))} ?? `;
-									}
-								}), createComponent(Show, {
-									get when() {
-										return arg.default !== void 0;
+									get type() {
+										return createComponent(CommandParameterType, { parameter: arg });
 									},
-									get fallback() {
-										return (arg.kind === ReflectionKind.string || arg.kind === ReflectionKind.number) && arg.variadic ? code`[]` : code`undefined;`;
-									},
-									get children() {
-										return arg.kind === ReflectionKind.string ? code`"${arg.default}"` : code`${arg.default}`;
+									get initializer() {
+										return [createComponent(Show, {
+											get when() {
+												return isSetString(arg.env);
+											},
+											get children() {
+												return code`env.${appSpecificEnvPrefix}_${constantCase(String(arg.env))} ?? `;
+											}
+										}), createComponent(Show, {
+											get when() {
+												return arg.default !== void 0;
+											},
+											get fallback() {
+												return (arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? code`[]` : code`undefined;`;
+											},
+											get children() {
+												return arg.kind === CommandParameterKinds.string ? code`"${arg.default}"` : code`${arg.default}`;
+											}
+										})];
 									}
-								})];
+								});
 							}
 						}),
 						createComponent(Spacing, {}),
@@ -112,7 +126,7 @@ function ArgumentsParserLogic(props) {
 							get children() {
 								return [memo(() => code`${camelCase(arg.name)} = `), createComponent(Show, {
 									get when() {
-										return arg.kind === ReflectionKind.string || arg.kind === ReflectionKind.number;
+										return arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number;
 									},
 									get fallback() {
 										return createComponent(BooleanInputParserLogic, { name: `args[argsIndex + ${index}] ` });
@@ -120,19 +134,19 @@ function ArgumentsParserLogic(props) {
 									get children() {
 										return createComponent(Show, {
 											get when() {
-												return (arg.kind === ReflectionKind.string || arg.kind === ReflectionKind.number) && arg.variadic;
+												return (arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic;
 											},
 											get fallback() {
 												return createComponent(Show, {
 													get when() {
-														return arg.kind === ReflectionKind.number;
+														return arg.kind === CommandParameterKinds.number;
 													},
 													fallback: code`args[argsIndex + ${index}]; `,
 													children: code`Number(args[argsIndex + ${index}]); `
 												});
 											},
 											get children() {
-												return code`args.slice(argsIndex + ${index}, (optionsIndex > argsIndex ? optionsIndex : args.length) - ${command.arguments.length - index}).join(" ").split(",").map(item => item.trim().replace(/^("|')/, "").replace(/("|')$/, "")).filter(Boolean)`;
+												return code`args.slice(argsIndex + ${index}, (optionsIndex > argsIndex ? optionsIndex : args.length) - ${command.args.length - index}).join(" ").split(",").map(item => item.trim().replace(/^("|')/, "").replace(/("|')$/, "")).filter(Boolean)`;
 											}
 										});
 									}
@@ -159,7 +173,7 @@ function OptionsMember({ option }) {
 			return [
 				createComponent(Show, {
 					get when() {
-						return option.kind === ReflectionKind.string;
+						return option.kind === CommandParameterKinds.string;
 					},
 					get children() {
 						return createComponent(InterfaceMember, {
@@ -168,7 +182,7 @@ function OptionsMember({ option }) {
 							},
 							doc,
 							get type() {
-								return option.variadic ? "string[]" : "string";
+								return createComponent(CommandParameterType, { parameter: option });
 							},
 							get optional() {
 								return option.optional;
@@ -178,7 +192,7 @@ function OptionsMember({ option }) {
 				}),
 				createComponent(Show, {
 					get when() {
-						return option.kind === ReflectionKind.number;
+						return option.kind === CommandParameterKinds.number;
 					},
 					get children() {
 						return createComponent(InterfaceMember, {
@@ -187,7 +201,7 @@ function OptionsMember({ option }) {
 							},
 							doc,
 							get type() {
-								return option.variadic ? "number[]" : "number";
+								return createComponent(CommandParameterType, { parameter: option });
 							},
 							get optional() {
 								return option.optional;
@@ -197,7 +211,7 @@ function OptionsMember({ option }) {
 				}),
 				createComponent(Show, {
 					get when() {
-						return option.kind === ReflectionKind.boolean;
+						return option.kind === CommandParameterKinds.boolean;
 					},
 					get children() {
 						return createComponent(InterfaceMember, {
@@ -205,7 +219,9 @@ function OptionsMember({ option }) {
 								return option.name;
 							},
 							doc,
-							type: "boolean",
+							get type() {
+								return createComponent(CommandParameterType, { parameter: option });
+							},
 							get optional() {
 								return option.optional;
 							}
@@ -224,7 +240,7 @@ function OptionsMemberParserLogic(props) {
 	const equalsRegex = `/^--?(${isCaseSensitive || name.length === 1 ? name : name.toLowerCase().replaceAll("-", "").replaceAll("_", "")}${option.alias && option.alias.length > 0 ? "|" : ""}${option.alias?.map((a) => (isCaseSensitive || name.length === 1 ? a : a.toLowerCase().replaceAll("-", "").replaceAll("_", "")) === "?" ? "\\?" : isCaseSensitive || name.length === 1 ? a : a.toLowerCase().replaceAll("-", "").replaceAll("_", "")).join("|")})=/`;
 	return [createComponent(Show, {
 		get when() {
-			return option.kind === ReflectionKind.string || option.kind === ReflectionKind.number;
+			return option.kind === CommandParameterKinds.string || option.kind === CommandParameterKinds.number;
 		},
 		get children() {
 			return [createComponent(Show, {
@@ -254,16 +270,24 @@ function OptionsMemberParserLogic(props) {
 									}),
 									createComponent(Show, {
 										get when() {
-											return option.kind === ReflectionKind.string;
+											return option.kind === CommandParameterKinds.string;
 										},
 										children: code`...arg.replace(${equalsRegex}, "").split(",").map(item => item.trim().replace(/^("|')/, "").replace(/("|')$/, "")).filter(Boolean) `
 									}),
 									createComponent(Show, {
 										get when() {
-											return option.kind === ReflectionKind.number;
+											return option.kind === CommandParameterKinds.number;
 										},
 										children: code`...arg.replace(${equalsRegex}, "").split(",").map(item => item.trim().replace(/^("|')/, "").replace(/("|')$/, "")).filter(Boolean).map(Number).filter(value => !Number.isNaN(value)) `
 									}),
+									createComponent(Show, {
+										get when() {
+											return (option.kind === CommandParameterKinds.string || option.kind === CommandParameterKinds.number) && option.choices && option.choices.length > 0;
+										},
+										get children() {
+											return code` as ${option.choices?.map((choice) => isSetString(choice) ? `"${choice}"` : choice).join(" | ")} `;
+										}
+									}),
 									code`); `
 								];
 							}
@@ -281,16 +305,24 @@ function OptionsMemberParserLogic(props) {
 									}),
 									createComponent(Show, {
 										get when() {
-											return option.kind === ReflectionKind.string;
+											return option.kind === CommandParameterKinds.string;
 										},
 										children: code`...args[++i].split(",").map(item => item.trim().replace(/^("|')/, "").replace(/("|')$/, "")).filter(Boolean) `
 									}),
 									createComponent(Show, {
 										get when() {
-											return option.kind === ReflectionKind.number;
+											return option.kind === CommandParameterKinds.number;
 										},
 										children: code`...args[++i].split(",").map(item => item.trim().replace(/^("|')/, "").replace(/("|')$/, "")).filter(Boolean).map(Number).filter(value => !Number.isNaN(value)) `
 									}),
+									createComponent(Show, {
+										get when() {
+											return (option.kind === CommandParameterKinds.string || option.kind === CommandParameterKinds.number) && option.choices && option.choices.length > 0;
+										},
+										get children() {
+											return code` as ${option.choices?.map((choice) => isSetString(choice) ? `"${choice}"` : choice).join(" | ")} `;
+										}
+									}),
 									code`); `
 								];
 							}
@@ -308,20 +340,32 @@ function OptionsMemberParserLogic(props) {
 							get children() {
 								return [createComponent(Show, {
 									get when() {
-										return option.kind === ReflectionKind.string;
+										return option.kind === CommandParameterKinds.string;
 									},
 									get children() {
-										return [createComponent(Show, {
-											get when() {
-												return name.includes("?") || name.includes("-");
-											},
-											fallback: code`options.${name}`,
-											children: code`options["${name}"]`
-										}), code` = arg.replace(${equalsRegex}, "").trim().replace(/^("|')/, "").replace(/("|')$/, ""); `];
+										return [
+											createComponent(Show, {
+												get when() {
+													return name.includes("?") || name.includes("-");
+												},
+												fallback: code`options.${name}`,
+												children: code`options["${name}"]`
+											}),
+											code` = arg.replace(${equalsRegex}, "").trim().replace(/^("|')/, "").replace(/("|')$/, "")`,
+											createComponent(Show, {
+												get when() {
+													return option.choices && option.choices.length > 0;
+												},
+												get children() {
+													return code` as ${option.choices?.map((choice) => `"${choice}"`).join(" | ")}`;
+												}
+											}),
+											code`; `
+										];
 									}
 								}), createComponent(Show, {
 									get when() {
-										return option.kind === ReflectionKind.number;
+										return option.kind === CommandParameterKinds.number;
 									},
 									get children() {
 										return [
@@ -334,13 +378,25 @@ function OptionsMemberParserLogic(props) {
 											createComponent(IfStatement, {
 												condition: `!Number.isNaN(value)`,
 												get children() {
-													return [createComponent(Show, {
-														get when() {
-															return name.includes("?") || name.includes("-");
-														},
-														fallback: code`options.${name}`,
-														children: code`options["${name}"]`
-													}), code` = value; `];
+													return [
+														createComponent(Show, {
+															get when() {
+																return name.includes("?") || name.includes("-");
+															},
+															fallback: code`options.${name}`,
+															children: code`options["${name}"]`
+														}),
+														code` = value`,
+														createComponent(Show, {
+															get when() {
+																return option.choices && option.choices.length > 0;
+															},
+															get children() {
+																return code` as ${option.choices?.join(" | ")}`;
+															}
+														}),
+														code`; `
+													];
 												}
 											})
 										];
@@ -353,20 +409,32 @@ function OptionsMemberParserLogic(props) {
 							get children() {
 								return [createComponent(Show, {
 									get when() {
-										return option.kind === ReflectionKind.string;
+										return option.kind === CommandParameterKinds.string;
 									},
 									get children() {
-										return [createComponent(Show, {
-											get when() {
-												return name.includes("?") || name.includes("-");
-											},
-											fallback: code`options.${name}`,
-											children: code`options["${name}"]`
-										}), code` = args[++i].trim().replace(/^("|')/, "").replace(/("|')$/, ""); `];
+										return [
+											createComponent(Show, {
+												get when() {
+													return name.includes("?") || name.includes("-");
+												},
+												fallback: code`options.${name}`,
+												children: code`options["${name}"]`
+											}),
+											code` = args[++i].trim().replace(/^("|')/, "").replace(/("|')$/, "")`,
+											createComponent(Show, {
+												get when() {
+													return option.choices && option.choices.length > 0;
+												},
+												get children() {
+													return code` as ${option.choices?.map((choice) => `"${choice}"`).join(" | ")}`;
+												}
+											}),
+											code`; `
+										];
 									}
 								}), createComponent(Show, {
 									get when() {
-										return option.kind === ReflectionKind.number;
+										return option.kind === CommandParameterKinds.number;
 									},
 									get children() {
 										return [
@@ -379,13 +447,25 @@ function OptionsMemberParserLogic(props) {
 											createComponent(IfStatement, {
 												condition: `!Number.isNaN(value)`,
 												get children() {
-													return [createComponent(Show, {
-														get when() {
-															return name.includes("?") || name.includes("-");
-														},
-														fallback: code`options.${name}`,
-														children: code`options["${name}"]`
-													}), code` = value; `];
+													return [
+														createComponent(Show, {
+															get when() {
+																return name.includes("?") || name.includes("-");
+															},
+															fallback: code`options.${name}`,
+															children: code`options["${name}"]`
+														}),
+														code` = value`,
+														createComponent(Show, {
+															get when() {
+																return option.choices && option.choices.length > 0;
+															},
+															get children() {
+																return code` as ${option.choices?.join(" | ")}`;
+															}
+														}),
+														code`; `
+													];
 												}
 											})
 										];
@@ -400,7 +480,7 @@ function OptionsMemberParserLogic(props) {
 		}
 	}), createComponent(Show, {
 		get when() {
-			return option.kind === ReflectionKind.boolean;
+			return option.kind === CommandParameterKinds.boolean;
 		},
 		get children() {
 			return [
@@ -493,7 +573,7 @@ function OptionsInterfaceDeclaration(props) {
 * The command options parser logic.
 */
 function OptionsParserLogic(props) {
-	const { command, envPrefix, isCaseSensitive = false } = props;
+	const { command, appSpecificEnvPrefix, isCaseSensitive = false } = props;
 	const options = computed(() => computedOptions(command));
 	return [
 		createComponent(VarDeclaration, {
@@ -501,10 +581,10 @@ function OptionsParserLogic(props) {
 			name: "options",
 			get initializer() {
 				return code` {
-          ${Object.entries(options.value).map(([name, option]) => {
-					if (option.kind === ReflectionKind.string) return ` ${name.includes("?") || name.includes("-") ? `"${name}"` : `${name}`}: ${option.env ? `env.${envPrefix}_${option.env}` : ""}${option.variadic ? option.default !== void 0 ? `${option.env ? " ?? " : ""}${JSON.stringify(option.default)}` : option.env ? " ?? []" : "" : option.default !== void 0 ? `${option.env ? " ?? " : ""}"${option.default}"` : ""}, `;
-					else if (option.kind === ReflectionKind.number) return ` ${name.includes("?") || name.includes("-") ? `"${name}"` : `${name}`}: ${option.env ? `env.${envPrefix}_${option.env}` : ""}${option.variadic ? option.default !== void 0 ? `${option.env ? " ?? " : ""}${JSON.stringify(option.default)}` : option.env ? " ?? []" : "" : option.default !== void 0 ? `${option.env ? " ?? " : ""}${option.default}` : ""}, `;
-					else if (option.kind === ReflectionKind.boolean) return ` ${name.includes("?") || name.includes("-") ? `"${name}"` : `${name}`}: ${option.env ? `env.${envPrefix}_${option.env} ?? ` : ""}${option.default ? "true" : "false"},`;
+          ${Object.entries(options.value).filter(([, option]) => option.env || option.default !== void 0 || (option.kind === CommandParameterKinds.string || option.kind === CommandParameterKinds.number) && option.variadic).map(([name, option]) => {
+					if (option.kind === CommandParameterKinds.string) return ` ${name.includes("?") || name.includes("-") ? `"${name}"` : `${name}`}: ${option.env ? `env.${appSpecificEnvPrefix}_${option.env}` : ""}${option.variadic ? option.default !== void 0 ? `${option.env ? " ?? " : ""}${JSON.stringify(option.default)}` : option.env ? " ?? []" : "[]" : option.default !== void 0 ? `${option.env ? " ?? " : ""}"${option.default}"` : ""}, `;
+					else if (option.kind === CommandParameterKinds.number) return ` ${name.includes("?") || name.includes("-") ? `"${name}"` : `${name}`}: ${option.env ? `env.${appSpecificEnvPrefix}_${option.env}` : ""}${option.variadic ? option.default && Array.isArray(option.default) ? `${option.env ? " ?? " : ""}${JSON.stringify(option.default)}` : option.env ? " ?? []" : "[]" : option.default !== void 0 ? `${option.env ? " ?? " : ""}${option.default}` : ""}, `;
+					else if (option.kind === CommandParameterKinds.boolean) return ` ${name.includes("?") || name.includes("-") ? `"${name}"` : `${name}`}: ${option.env ? `env.${appSpecificEnvPrefix}_${option.env} ?? ` : ""}${option.default ? "true" : "false"},`;
 					return "";
 				}).join("")}
           } as ${pascalCase(command.name)}Options;`;
@@ -582,7 +662,7 @@ function OptionsParserLogic(props) {
 * The command parser logic, which includes parsing dynamic path segments, positional parameters, and options.
 */
 function CommandParserLogic(props) {
-	const { command, envPrefix, isCaseSensitive = false } = props;
+	const { command, appSpecificEnvPrefix, isCaseSensitive = false } = props;
 	return [
 		createComponent(DynamicSegmentsParserLogic, {
 			command,
@@ -591,13 +671,13 @@ function CommandParserLogic(props) {
 		createComponent(Spacing, {}),
 		createComponent(OptionsParserLogic, {
 			command,
-			envPrefix,
+			appSpecificEnvPrefix,
 			isCaseSensitive
 		}),
 		createComponent(Spacing, {}),
 		createComponent(ArgumentsParserLogic, {
 			command,
-			envPrefix,
+			appSpecificEnvPrefix,
 			isCaseSensitive
 		}),
 		createComponent(Spacing, {})