@shell-shock/preset-script 0.6.61 → 0.6.63

package/dist/components/command-entry.cjs

@@ -1,204 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_components_virtual_command_entry = require('./virtual-command-entry.cjs');
-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 _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let _powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
-let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
-let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
-let _stryke_path_replace = require("@stryke/path/replace");
-let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
-let defu = require("defu");
-defu = require_runtime.__toESM(defu);
-let _shell_shock_core_components_helpers = require("@shell-shock/core/components/helpers");
-let _shell_shock_core_components_command_validation_logic = require("@shell-shock/core/components/command-validation-logic");
-let _shell_shock_core_components_options_parser_logic = require("@shell-shock/core/components/options-parser-logic");
-let _stryke_path_find = require("@stryke/path/find");
-let _stryke_path_join = require("@stryke/path/join");
-let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
-let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
-let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
-
-//#region src/components/command-entry.tsx
-function CommandInvocation(props) {
-	const { command } = props;
-	return [(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code` return withCommand("${command.path}", [${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? (0, _stryke_string_format_camel_case.camelCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment)) : `"${segment}"`).join(", ")}], [${Object.keys(command.options).length > 0 ? `options` : ""}${command.args.length > 0 ? `${Object.keys(command.options).length > 0 ? ", " : ""}${command.args.map((arg) => (0, _stryke_string_format_camel_case.camelCase)(arg.name)).join(", ")}` : ""}], handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}); `), (0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
-}
-/**
-* A component that generates the `handler` function declaration for a command.
-*/
-function CommandHandlerDeclaration(props) {
-	const { command, banner, children } = props;
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	return [
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-			get heading() {
-				return `The ${command.title} (${(0, _shell_shock_core_plugin_utils.getAppBin)(context)} ${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, _stryke_string_format_constant_case.constantCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment).join(" ")}) command.`;
-			},
-			get children() {
-				return [
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { get children() {
-						return `${command.description.replace(/\.+$/, "")}.`;
-					} }),
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocTitle, { get children() {
-						return command.title;
-					} }),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
-						name: "args",
-						children: `The command-line arguments passed to the command.`
-					})
-				];
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
-			"export": true,
-			async: true,
-			name: "handler",
-			parameters: [{
-				name: "args",
-				type: "string[]",
-				default: "useArgs()"
-			}],
-			get children() {
-				return [
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.CommandParserLogic, {
-						command,
-						get appSpecificEnvPrefix() {
-							return context.config.appSpecificEnvPrefix;
-						},
-						get isCaseSensitive() {
-							return context.config.isCaseSensitive;
-						}
-					}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-						get when() {
-							return Boolean(banner);
-						},
-						children: banner
-					}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-					_alloy_js_core.code`writeLine("");`,
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
-						get condition() {
-							return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_helpers.IsDebug, {});
-						},
-						get children() {
-							return _alloy_js_core.code`writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.cjs`),t=require(`./virtual-command-entry.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`),i=require(`@alloy-js/typescript`),a=require(`@powerlines/plugin-alloy/core/components/spacing`),o=require(`@powerlines/plugin-alloy/core/contexts/context`),s=require(`@powerlines/plugin-alloy/typescript/components/entry-file`),c=require(`@powerlines/plugin-alloy/typescript/components/tsdoc`),l=require(`@shell-shock/core/plugin-utils`),u=require(`@stryke/path/replace`),d=require(`@stryke/string-format/pascal-case`),f=require(`defu`);f=e.__toESM(f);let p=require(`@shell-shock/core/components/helpers`),m=require(`@shell-shock/core/components/command-validation-logic`),h=require(`@shell-shock/core/components/options-parser-logic`),g=require(`@stryke/path/find`),_=require(`@stryke/path/join`),v=require(`@stryke/string-format/camel-case`),y=require(`@stryke/string-format/constant-case`),b=require(`@stryke/string-format/kebab-case`);function x(e){let{command:t}=e;return[(0,n.memo)(()=>r.code` return withCommand("${t.path}", [${t.segments.map(e=>(0,l.isDynamicPathSegment)(e)?(0,v.camelCase)((0,l.getDynamicPathSegmentName)(e)):`"${e}"`).join(`, `)}], [${Object.keys(t.options).length>0?`options`:``}${t.args.length>0?`${Object.keys(t.options).length>0?`, `:``}${t.args.map(e=>(0,v.camelCase)(e.name)).join(`, `)}`:``}], handle${(0,d.pascalCase)(t.name)}); `),(0,n.createIntrinsic)(`hbr`,{})]}function S(e){let{command:t,banner:s,children:u}=e,d=(0,o.usePowerlines)();return[(0,n.createComponent)(h.OptionsInterfaceDeclaration,{command:t}),(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(c.TSDoc,{get heading(){return`The ${t.title} (${(0,l.getAppBin)(d)} ${t.segments.map(e=>(0,l.isDynamicPathSegment)(e)?`[${(0,y.constantCase)((0,l.getDynamicPathSegmentName)(e))}]`:e).join(` `)}) command.`},get children(){return[(0,n.createComponent)(c.TSDocRemarks,{get children(){return`${t.description.replace(/\.+$/,``)}.`}}),(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(c.TSDocTitle,{get children(){return t.title}}),(0,n.createComponent)(c.TSDocParam,{name:`args`,children:`The command-line arguments passed to the command.`})]}}),(0,n.createComponent)(i.FunctionDeclaration,{export:!0,async:!0,name:`handler`,parameters:[{name:`args`,type:`string[]`,default:`useArgs()`}],get children(){return[(0,n.createComponent)(h.CommandParserLogic,{command:t,get appSpecificEnvPrefix(){return d.config.appSpecificEnvPrefix},get isCaseSensitive(){return d.config.isCaseSensitive}}),(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(r.Show,{get when(){return!!s},children:s}),(0,n.createComponent)(a.Spacing,{}),r.code`writeLine("");`,(0,n.createComponent)(i.IfStatement,{get condition(){return(0,n.createComponent)(p.IsDebug,{})},get children(){return r.code`writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
           writeLine("");
-          debug(\`Command path: ${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `\${${(0, _stryke_string_format_camel_case.camelCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(option.name)}: \${options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)} === undefined ? "" : JSON.stringify(options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)})}`).join("\\n")}${command.args.length > 0 ? ` \\n\\nArguments: \\n${command.args.map((arg) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(arg.name)}: \${${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} === undefined ? "" : JSON.stringify(${(0, _stryke_string_format_camel_case.camelCase)(arg.name)})}`).join("\\n")}` : ""}\`); `;
-						}
-					}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-					children,
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
-						condition: _alloy_js_core.code`options.help`,
-						children: _alloy_js_core.code`return showHelp(); `
-					}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseClause, { get children() {
-						return [(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}), (0, _alloy_js_core_jsx_runtime.createComponent)(CommandInvocation, { command })];
-					} })
-				];
-			}
-		})
-	];
-}
-/**
-* The command entry point for the Shell Shock project.
-*/
-function CommandEntry(props) {
-	const { command, imports, builtinImports, ...rest } = props;
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const filePath = (0, _alloy_js_core.computed)(() => (0, _stryke_path_join.joinPaths)(command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)).join("/"), "index.ts"));
-	const commandSourcePath = (0, _alloy_js_core.computed)(() => (0, _stryke_path_replace.replaceExtension)((0, _stryke_path_find.relativePath)((0, _stryke_path_join.joinPaths)(context.entryPath, (0, _stryke_path_find.findFilePath)(filePath.value)), command.entry.input?.file || command.entry.file)));
-	const typeDefinition = (0, _alloy_js_core.computed)(() => ({
-		...command.entry,
-		output: command.id
-	}));
-	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_entry_file.EntryFile, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
-		get path() {
-			return filePath.value;
-		},
-		get typeDefinition() {
-			return typeDefinition.value;
-		},
-		get imports() {
-			return (0, defu.default)(imports ?? {}, { [commandSourcePath.value.startsWith(".") ? commandSourcePath.value : `./${commandSourcePath.value}`]: `handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}` });
-		},
-		get builtinImports() {
-			return (0, defu.default)(builtinImports ?? {}, {
-				env: [
-					"env",
-					"isDevelopment",
-					"isDebug"
-				],
-				console: [
-					"debug",
-					"warn",
-					"error",
-					"writeLine",
-					"textColors"
-				],
-				utils: ["isMinimal", "isUnicodeSupported"],
-				state: [
-					"useGlobal",
-					"GlobalOptions",
-					"useGlobalOptions",
-					"useArgs",
-					"hasFlag",
-					"withCommand"
-				],
-				[(0, _stryke_path_join.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showHelp"],
-				[(0, _stryke_path_join.joinPaths)("banner", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showBanner"]
-			});
-		},
-		get children() {
-			return [
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(CommandHandlerDeclaration, {
-					command,
-					banner: _alloy_js_core.code`await showBanner(); `,
-					get children() {
-						return [(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_command_validation_logic.CommandValidationLogic, { command }), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
-							condition: _alloy_js_core.code`failures.length > 0`,
-							get children() {
-								return _alloy_js_core.code`error(\`The following validation failures were found while processing the user provided input, and must be corrected before the \${italic("${command.title}")} command can be executed: \\n\\n\${failures.map(failure => " - " + failure).join("\\n")}\`);
-                options.help = true; `;
-							}
-						})];
-					}
-				})
-			];
-		}
-	})), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-		get each() {
-			return Object.values(command.children);
-		},
-		children: (child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return child.isVirtual;
-			},
-			get fallback() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandEntry, { command: child });
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_virtual_command_entry.VirtualCommandEntry, { command: child });
-			}
-		})
-	})];
-}
-
-//#endregion
-exports.CommandEntry = CommandEntry;
-exports.CommandHandlerDeclaration = CommandHandlerDeclaration;
-exports.CommandInvocation = CommandInvocation;
-//# sourceMappingURL=command-entry.cjs.map
+          debug(\`Command path: ${t.segments.map(e=>(0,l.isDynamicPathSegment)(e)?`\${${(0,v.camelCase)((0,l.getDynamicPathSegmentName)(e))}}`:e).join(` / `)} \\n\\nOptions: \\n${Object.values(t.options).map(e=>` - ${(0,b.kebabCase)(e.name)}: \${options.${(0,v.camelCase)(e.name)} === undefined ? "" : JSON.stringify(options.${(0,v.camelCase)(e.name)})}`).join(`\\n`)}${t.args.length>0?` \\n\\nArguments: \\n${t.args.map(e=>` - ${(0,b.kebabCase)(e.name)}: \${${(0,v.camelCase)(e.name)} === undefined ? "" : JSON.stringify(${(0,v.camelCase)(e.name)})}`).join(`\\n`)}`:``}\`); `}}),(0,n.createComponent)(a.Spacing,{}),u,(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(i.IfStatement,{condition:r.code`options.help`,children:r.code`return showHelp(); `}),(0,n.createComponent)(i.ElseClause,{get children(){return[(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(x,{command:t})]}})]}})]}function C(e){let{command:c,imports:p,builtinImports:v,...y}=e,b=(0,o.usePowerlines)(),x=(0,r.computed)(()=>(0,_.joinPaths)(c.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)).join(`/`),`index.ts`)),w=(0,r.computed)(()=>(0,u.replaceExtension)((0,g.relativePath)((0,_.joinPaths)(b.entryPath,(0,g.findFilePath)(x.value)),c.entry.input?.file||c.entry.file))),T=(0,r.computed)(()=>({...c.entry,output:c.id}));return[(0,n.createComponent)(s.EntryFile,(0,n.mergeProps)(y,{get path(){return x.value},get typeDefinition(){return T.value},get imports(){return(0,f.default)(p??{},{[w.value.startsWith(`.`)?w.value:`./${w.value}`]:`handle${(0,d.pascalCase)(c.name)}`})},get builtinImports(){return(0,f.default)(v??{},{env:[`env`,`isDevelopment`,`isDebug`],console:[`debug`,`warn`,`error`,`writeLine`,`textColors`],utils:[`isMinimal`,`isUnicodeSupported`],state:[{name:`GlobalOptions`,type:!0},`useGlobal`,`useGlobalOptions`,`useArgs`,`hasFlag`,`withCommand`],[(0,_.joinPaths)(`help`,...c.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)))]:[`showHelp`],[(0,_.joinPaths)(`banner`,...c.segments.filter(e=>!(0,l.isDynamicPathSegment)(e)))]:[`showBanner`]})},get children(){return[(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(h.OptionsInterfaceDeclaration,{command:c}),(0,n.createComponent)(a.Spacing,{}),(0,n.createComponent)(S,{command:c,banner:r.code`await showBanner(); `,get children(){return[(0,n.createComponent)(m.CommandValidationLogic,{command:c}),(0,n.createComponent)(i.IfStatement,{condition:r.code`failures.length > 0`,get children(){return r.code`error(\`The following validation failures were found while processing the user provided input, and must be corrected before the \${italic("${c.title}")} command can be executed: \\n\\n\${failures.map(failure => " - " + failure).join("\\n")}\`);
+                options.help = true; `}})]}})]}})),(0,n.createComponent)(r.For,{get each(){return Object.values(c.children)},children:e=>(0,n.createComponent)(r.Show,{get when(){return e.isVirtual},get fallback(){return(0,n.createComponent)(C,{command:e})},get children(){return(0,n.createComponent)(t.VirtualCommandEntry,{command:e})}})})]}exports.CommandEntry=C,exports.CommandHandlerDeclaration=S,exports.CommandInvocation=x;

package/dist/components/command-entry.mjs

@@ -1,199 +1,5 @@
-import { VirtualCommandEntry } from "./virtual-command-entry.mjs";
-import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { For, Show, code, computed } from "@alloy-js/core";
-import { ElseClause, FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
-import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
-import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
-import { TSDoc, TSDocParam, TSDocRemarks, TSDocTitle } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
-import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
-import { replaceExtension } from "@stryke/path/replace";
-import { pascalCase } from "@stryke/string-format/pascal-case";
-import defu from "defu";
-import { IsDebug } from "@shell-shock/core/components/helpers";
-import { CommandValidationLogic } from "@shell-shock/core/components/command-validation-logic";
-import { CommandParserLogic, OptionsInterfaceDeclaration } from "@shell-shock/core/components/options-parser-logic";
-import { findFilePath, relativePath } from "@stryke/path/find";
-import { joinPaths } from "@stryke/path/join";
-import { camelCase } from "@stryke/string-format/camel-case";
-import { constantCase } from "@stryke/string-format/constant-case";
-import { kebabCase } from "@stryke/string-format/kebab-case";
-
-//#region src/components/command-entry.tsx
-function CommandInvocation(props) {
-	const { command } = props;
-	return [memo(() => code` return withCommand("${command.path}", [${command.segments.map((segment) => isDynamicPathSegment(segment) ? camelCase(getDynamicPathSegmentName(segment)) : `"${segment}"`).join(", ")}], [${Object.keys(command.options).length > 0 ? `options` : ""}${command.args.length > 0 ? `${Object.keys(command.options).length > 0 ? ", " : ""}${command.args.map((arg) => camelCase(arg.name)).join(", ")}` : ""}], handle${pascalCase(command.name)}); `), createIntrinsic("hbr", {})];
-}
-/**
-* A component that generates the `handler` function declaration for a command.
-*/
-function CommandHandlerDeclaration(props) {
-	const { command, banner, children } = props;
-	const context = usePowerlines();
-	return [
-		createComponent(OptionsInterfaceDeclaration, { command }),
-		createComponent(Spacing, {}),
-		createComponent(TSDoc, {
-			get heading() {
-				return `The ${command.title} (${getAppBin(context)} ${command.segments.map((segment) => isDynamicPathSegment(segment) ? `[${constantCase(getDynamicPathSegmentName(segment))}]` : segment).join(" ")}) command.`;
-			},
-			get children() {
-				return [
-					createComponent(TSDocRemarks, { get children() {
-						return `${command.description.replace(/\.+$/, "")}.`;
-					} }),
-					createIntrinsic("hbr", {}),
-					createComponent(TSDocTitle, { get children() {
-						return command.title;
-					} }),
-					createComponent(TSDocParam, {
-						name: "args",
-						children: `The command-line arguments passed to the command.`
-					})
-				];
-			}
-		}),
-		createComponent(FunctionDeclaration, {
-			"export": true,
-			async: true,
-			name: "handler",
-			parameters: [{
-				name: "args",
-				type: "string[]",
-				default: "useArgs()"
-			}],
-			get children() {
-				return [
-					createComponent(CommandParserLogic, {
-						command,
-						get appSpecificEnvPrefix() {
-							return context.config.appSpecificEnvPrefix;
-						},
-						get isCaseSensitive() {
-							return context.config.isCaseSensitive;
-						}
-					}),
-					createComponent(Spacing, {}),
-					createComponent(Show, {
-						get when() {
-							return Boolean(banner);
-						},
-						children: banner
-					}),
-					createComponent(Spacing, {}),
-					code`writeLine("");`,
-					createComponent(IfStatement, {
-						get condition() {
-							return createComponent(IsDebug, {});
-						},
-						get children() {
-							return code`writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
+import{VirtualCommandEntry as e}from"./virtual-command-entry.mjs";import{createComponent as t,createIntrinsic as n,memo as r,mergeProps as i}from"@alloy-js/core/jsx-runtime";import{For as a,Show as o,code as s,computed as c}from"@alloy-js/core";import{ElseClause as l,FunctionDeclaration as u,IfStatement as d}from"@alloy-js/typescript";import{Spacing as f}from"@powerlines/plugin-alloy/core/components/spacing";import{usePowerlines as p}from"@powerlines/plugin-alloy/core/contexts/context";import{EntryFile as m}from"@powerlines/plugin-alloy/typescript/components/entry-file";import{TSDoc as h,TSDocParam as g,TSDocRemarks as _,TSDocTitle as v}from"@powerlines/plugin-alloy/typescript/components/tsdoc";import{getAppBin as y,getDynamicPathSegmentName as b,isDynamicPathSegment as x}from"@shell-shock/core/plugin-utils";import{replaceExtension as S}from"@stryke/path/replace";import{pascalCase as C}from"@stryke/string-format/pascal-case";import w from"defu";import{IsDebug as T}from"@shell-shock/core/components/helpers";import{CommandValidationLogic as E}from"@shell-shock/core/components/command-validation-logic";import{CommandParserLogic as D,OptionsInterfaceDeclaration as O}from"@shell-shock/core/components/options-parser-logic";import{findFilePath as k,relativePath as A}from"@stryke/path/find";import{joinPaths as j}from"@stryke/path/join";import{camelCase as M}from"@stryke/string-format/camel-case";import{constantCase as N}from"@stryke/string-format/constant-case";import{kebabCase as P}from"@stryke/string-format/kebab-case";function F(e){let{command:t}=e;return[r(()=>s` return withCommand("${t.path}", [${t.segments.map(e=>x(e)?M(b(e)):`"${e}"`).join(`, `)}], [${Object.keys(t.options).length>0?`options`:``}${t.args.length>0?`${Object.keys(t.options).length>0?`, `:``}${t.args.map(e=>M(e.name)).join(`, `)}`:``}], handle${C(t.name)}); `),n(`hbr`,{})]}function I(e){let{command:r,banner:i,children:a}=e,c=p();return[t(O,{command:r}),t(f,{}),t(h,{get heading(){return`The ${r.title} (${y(c)} ${r.segments.map(e=>x(e)?`[${N(b(e))}]`:e).join(` `)}) command.`},get children(){return[t(_,{get children(){return`${r.description.replace(/\.+$/,``)}.`}}),n(`hbr`,{}),t(v,{get children(){return r.title}}),t(g,{name:`args`,children:`The command-line arguments passed to the command.`})]}}),t(u,{export:!0,async:!0,name:`handler`,parameters:[{name:`args`,type:`string[]`,default:`useArgs()`}],get children(){return[t(D,{command:r,get appSpecificEnvPrefix(){return c.config.appSpecificEnvPrefix},get isCaseSensitive(){return c.config.isCaseSensitive}}),t(f,{}),t(o,{get when(){return!!i},children:i}),t(f,{}),s`writeLine("");`,t(d,{get condition(){return t(T,{})},get children(){return s`writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
           writeLine("");
-          debug(\`Command path: ${command.segments.map((segment) => isDynamicPathSegment(segment) ? `\${${camelCase(getDynamicPathSegmentName(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${kebabCase(option.name)}: \${options.${camelCase(option.name)} === undefined ? "" : JSON.stringify(options.${camelCase(option.name)})}`).join("\\n")}${command.args.length > 0 ? ` \\n\\nArguments: \\n${command.args.map((arg) => ` - ${kebabCase(arg.name)}: \${${camelCase(arg.name)} === undefined ? "" : JSON.stringify(${camelCase(arg.name)})}`).join("\\n")}` : ""}\`); `;
-						}
-					}),
-					createComponent(Spacing, {}),
-					children,
-					createComponent(Spacing, {}),
-					createComponent(IfStatement, {
-						condition: code`options.help`,
-						children: code`return showHelp(); `
-					}),
-					createComponent(ElseClause, { get children() {
-						return [createIntrinsic("hbr", {}), createComponent(CommandInvocation, { command })];
-					} })
-				];
-			}
-		})
-	];
-}
-/**
-* The command entry point for the Shell Shock project.
-*/
-function CommandEntry(props) {
-	const { command, imports, builtinImports, ...rest } = props;
-	const context = usePowerlines();
-	const filePath = computed(() => joinPaths(command.segments.filter((segment) => !isDynamicPathSegment(segment)).join("/"), "index.ts"));
-	const commandSourcePath = computed(() => replaceExtension(relativePath(joinPaths(context.entryPath, findFilePath(filePath.value)), command.entry.input?.file || command.entry.file)));
-	const typeDefinition = computed(() => ({
-		...command.entry,
-		output: command.id
-	}));
-	return [createComponent(EntryFile, mergeProps(rest, {
-		get path() {
-			return filePath.value;
-		},
-		get typeDefinition() {
-			return typeDefinition.value;
-		},
-		get imports() {
-			return defu(imports ?? {}, { [commandSourcePath.value.startsWith(".") ? commandSourcePath.value : `./${commandSourcePath.value}`]: `handle${pascalCase(command.name)}` });
-		},
-		get builtinImports() {
-			return defu(builtinImports ?? {}, {
-				env: [
-					"env",
-					"isDevelopment",
-					"isDebug"
-				],
-				console: [
-					"debug",
-					"warn",
-					"error",
-					"writeLine",
-					"textColors"
-				],
-				utils: ["isMinimal", "isUnicodeSupported"],
-				state: [
-					"useGlobal",
-					"GlobalOptions",
-					"useGlobalOptions",
-					"useArgs",
-					"hasFlag",
-					"withCommand"
-				],
-				[joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showHelp"],
-				[joinPaths("banner", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showBanner"]
-			});
-		},
-		get children() {
-			return [
-				createComponent(Spacing, {}),
-				createComponent(OptionsInterfaceDeclaration, { command }),
-				createComponent(Spacing, {}),
-				createComponent(CommandHandlerDeclaration, {
-					command,
-					banner: code`await showBanner(); `,
-					get children() {
-						return [createComponent(CommandValidationLogic, { command }), createComponent(IfStatement, {
-							condition: code`failures.length > 0`,
-							get children() {
-								return code`error(\`The following validation failures were found while processing the user provided input, and must be corrected before the \${italic("${command.title}")} command can be executed: \\n\\n\${failures.map(failure => " - " + failure).join("\\n")}\`);
-                options.help = true; `;
-							}
-						})];
-					}
-				})
-			];
-		}
-	})), createComponent(For, {
-		get each() {
-			return Object.values(command.children);
-		},
-		children: (child) => createComponent(Show, {
-			get when() {
-				return child.isVirtual;
-			},
-			get fallback() {
-				return createComponent(CommandEntry, { command: child });
-			},
-			get children() {
-				return createComponent(VirtualCommandEntry, { command: child });
-			}
-		})
-	})];
-}
-
-//#endregion
-export { CommandEntry, CommandHandlerDeclaration, CommandInvocation };
+          debug(\`Command path: ${r.segments.map(e=>x(e)?`\${${M(b(e))}}`:e).join(` / `)} \\n\\nOptions: \\n${Object.values(r.options).map(e=>` - ${P(e.name)}: \${options.${M(e.name)} === undefined ? "" : JSON.stringify(options.${M(e.name)})}`).join(`\\n`)}${r.args.length>0?` \\n\\nArguments: \\n${r.args.map(e=>` - ${P(e.name)}: \${${M(e.name)} === undefined ? "" : JSON.stringify(${M(e.name)})}`).join(`\\n`)}`:``}\`); `}}),t(f,{}),a,t(f,{}),t(d,{condition:s`options.help`,children:s`return showHelp(); `}),t(l,{get children(){return[n(`hbr`,{}),t(F,{command:r})]}})]}})]}function L(n){let{command:r,imports:l,builtinImports:u,...h}=n,g=p(),_=c(()=>j(r.segments.filter(e=>!x(e)).join(`/`),`index.ts`)),v=c(()=>S(A(j(g.entryPath,k(_.value)),r.entry.input?.file||r.entry.file))),y=c(()=>({...r.entry,output:r.id}));return[t(m,i(h,{get path(){return _.value},get typeDefinition(){return y.value},get imports(){return w(l??{},{[v.value.startsWith(`.`)?v.value:`./${v.value}`]:`handle${C(r.name)}`})},get builtinImports(){return w(u??{},{env:[`env`,`isDevelopment`,`isDebug`],console:[`debug`,`warn`,`error`,`writeLine`,`textColors`],utils:[`isMinimal`,`isUnicodeSupported`],state:[{name:`GlobalOptions`,type:!0},`useGlobal`,`useGlobalOptions`,`useArgs`,`hasFlag`,`withCommand`],[j(`help`,...r.segments.filter(e=>!x(e)))]:[`showHelp`],[j(`banner`,...r.segments.filter(e=>!x(e)))]:[`showBanner`]})},get children(){return[t(f,{}),t(O,{command:r}),t(f,{}),t(I,{command:r,banner:s`await showBanner(); `,get children(){return[t(E,{command:r}),t(d,{condition:s`failures.length > 0`,get children(){return s`error(\`The following validation failures were found while processing the user provided input, and must be corrected before the \${italic("${r.title}")} command can be executed: \\n\\n\${failures.map(failure => " - " + failure).join("\\n")}\`);
+                options.help = true; `}})]}})]}})),t(a,{get each(){return Object.values(r.children)},children:n=>t(o,{get when(){return n.isVirtual},get fallback(){return t(L,{command:n})},get children(){return t(e,{command:n})}})})]}export{L as CommandEntry,I as CommandHandlerDeclaration,F as CommandInvocation};
 //# sourceMappingURL=command-entry.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":[],"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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} 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 {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandValidationLogic } from \"@shell-shock/core/components/command-validation-logic\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\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 { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code` return withCommand(\"${command.path}\", [${command.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? camelCase(getDynamicPathSegmentName(segment))\n            : `\"${segment}\"`\n        )\n        .join(\", \")}], [${\n        Object.keys(command.options).length > 0 ? `options` : \"\"\n      }${\n        command.args.length > 0\n          ? `${\n              Object.keys(command.options).length > 0 ? \", \" : \"\"\n            }${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n          : \"\"\n      }], handle${pascalCase(command.name)}); `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`writeLine(\"\");`}\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(textColors.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          writeLine(\"\");\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`); `}\n        </IfStatement>\n        <Spacing />\n        {children}\n        <Spacing />\n        <IfStatement condition={code`options.help`}>\n          {code`return showHelp(); `}\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\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<ScriptPresetContext>();\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    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.startsWith(\".\")\n            ? commandSourcePath.value\n            : `./${commandSourcePath.value}`]:\n            `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\"debug\", \"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\"],\n          state: [\n            \"useGlobal\",\n            \"GlobalOptions\",\n            \"useGlobalOptions\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"withCommand\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"],\n          [joinPaths(\n            \"banner\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showBanner\"]\n        })}>\n        <Spacing />\n        <OptionsInterfaceDeclaration command={command} />\n        <Spacing />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandValidationLogic command={command} />\n          <IfStatement condition={code`failures.length > 0`}>\n            {code`error(\\`The following validation failures were found while processing the user provided input, and must be corrected before the \\${italic(\"${\n              command.title\n            }\")} command can be executed: \\\\n\\\\n\\${failures.map(failure => \" - \" + failure).join(\"\\\\n\")}\\`);\n                options.help = true; `}\n          </IfStatement>\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":[],"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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} 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 {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandValidationLogic } from \"@shell-shock/core/components/command-validation-logic\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\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 { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code` return withCommand(\"${command.path}\", [${command.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? camelCase(getDynamicPathSegmentName(segment))\n            : `\"${segment}\"`\n        )\n        .join(\", \")}], [${\n        Object.keys(command.options).length > 0 ? `options` : \"\"\n      }${\n        command.args.length > 0\n          ? `${\n              Object.keys(command.options).length > 0 ? \", \" : \"\"\n            }${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n          : \"\"\n      }], handle${pascalCase(command.name)}); `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`writeLine(\"\");`}\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(textColors.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          writeLine(\"\");\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`); `}\n        </IfStatement>\n        <Spacing />\n        {children}\n        <Spacing />\n        <IfStatement condition={code`options.help`}>\n          {code`return showHelp(); `}\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\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<ScriptPresetContext>();\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    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.startsWith(\".\")\n            ? commandSourcePath.value\n            : `./${commandSourcePath.value}`]:\n            `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\"debug\", \"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\"],\n          state: [\n            { name: \"GlobalOptions\", type: true },\n            \"useGlobal\",\n            \"useGlobalOptions\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"withCommand\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"],\n          [joinPaths(\n            \"banner\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showBanner\"]\n        })}>\n        <Spacing />\n        <OptionsInterfaceDeclaration command={command} />\n        <Spacing />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandValidationLogic command={command} />\n          <IfStatement condition={code`failures.length > 0`}>\n            {code`error(\\`The following validation failures were found while processing the user provided input, and must be corrected before the \\${italic(\"${\n              command.title\n            }\")} command can be executed: \\\\n\\\\n\\${failures.map(failure => \" - \" + failure).join(\"\\\\n\")}\\`);\n                options.help = true; `}\n          </IfStatement>\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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"}