@shell-shock/preset-script 0.6.23 → 0.6.27

package/dist/components/bin-entry.mjs

@@ -2,16 +2,16 @@ import { ExitFunctionDeclaration } from "./exit-function-declaration.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import defu from "defu";
+import { TSDoc, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
 import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
-import { TSDoc } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
 import { getUnique } from "@stryke/helpers/get-unique";
 import { findFileName } from "@stryke/path/file-path-fns";
 import { replaceExtension } from "@stryke/path/replace";
 import { pascalCase } from "@stryke/string-format/pascal-case";
-import defu from "defu";
 
 //#region src/components/bin-entry.tsx
 /**
@@ -138,7 +138,8 @@ function BinEntry(props) {
 						"internal_appContext",
 						"getArgs",
 						"findSuggestions"
-					]
+					],
+					help: ["showHelp"]
 				});
 			},
 			get children() {
@@ -153,12 +154,19 @@ function BinEntry(props) {
 							return [prefix, createComponent(Spacing, {})];
 						}
 					}),
-					createComponent(TSDoc, { get heading() {
-						return `Binary entry point for the ${getAppTitle(context)} CLI application.`;
-					} }),
+					createComponent(TSDoc, {
+						get heading() {
+							return `Binary entry point for the ${getAppTitle(context, true)} command-line interface application.`;
+						},
+						get children() {
+							return [createComponent(TSDocRemarks, { get children() {
+								return `This file serves as the main entry point for the binary executable of the ${getAppTitle(context, true)} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`;
+							} }), createComponent(TSDocReturns, { children: `Returns a promise that resolves to either a successful result or an error object.` })];
+						}
+					}),
 					createComponent(FunctionDeclaration, {
 						async: true,
-						returnType: "any",
+						returnType: "any | { error: string | Error }",
 						name: "main",
 						get children() {
 							return [
@@ -166,7 +174,7 @@ function BinEntry(props) {
 									condition: code`hasFlag(["version", "v"])`,
 									get children() {
 										return code`console.log(${context?.packageJson.version ? `"${context?.packageJson.version}"` : "0.0.1"});
-          return;`;
+              return; `;
 									}
 								}),
 								createComponent(Spacing, {}),

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.mjs","names":["code","computed","For","Show","FunctionDeclaration","IfStatement","Spacing","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","ExitFunctionDeclaration","RunApplication","_$createComponent","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","each","value","_$mergeProps","path","typeDefinition","file","output","entries","commands","filter","command","isVirtual","reduce","ret","name","alias","env","console","utils","when","Boolean","heading","async","returnType","condition","packageJson","version","fallback"],"sources":["../../src/components/bin-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 { FunctionDeclaration, 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 { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { TSDoc } from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { ExitFunctionDeclaration } from \"./exit-function-declaration\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <Spacing />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        const startDate = new Date();\n        try {\n          process.on(\"exit\", () => exit({\n            startDate,\n            skipProcessExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            startDate,\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                startDate,\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            startDate,\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            startDate,\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\n              startDate,\n              exception: err || new Error(\\`An \\${type === \"unhandledRejection\" ? \"unhandled promise rejection\" : \"uncaught exception\"} occurred during processing - the application is shutting down.\\`)\n            }));\n          }\n\n          await internal_appContext.run(new Map([[\"args\", getArgs()]]), async () => {\n            const result = await main();\n            if (result?.error) {\n              error(result.error);\n            }\n          });\n\n          exit({ startDate });\n        } catch (err) {\n          exit({ startDate, exception: err as Error });\n        }\n      })();\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface BinEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"hashbang\"\n> {\n  prefix?: Children;\n  postfix?: Children;\n  children: Children;\n}\n\n/**\n * The binary entry point for the Shell Shock project.\n */\nexport function BinEntry(props: BinEntryProps) {\n  const { prefix, postfix, builtinImports, imports, children, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const bins = computed(() => getUnique(Object.values(context.config.bin)));\n\n  return (\n    <For each={bins.value}>\n      {bin => (\n        <EntryFile\n          {...rest}\n          path={findFileName(replaceExtension(bin))}\n          typeDefinition={{\n            file: bin,\n            output: \"bin\"\n          }}\n          imports={defu(\n            imports ?? {},\n            Object.entries(context.commands)\n              .filter(([, command]) => command.isVirtual)\n              .reduce((ret, [name, command]) => {\n                ret[`./${command.name}`] = [\n                  { name: \"handler\", alias: `handle${pascalCase(name)}` }\n                ];\n\n                return ret;\n              }, {} as TypescriptFileImports)\n          )}\n          builtinImports={defu(builtinImports ?? {}, {\n            env: [\"env\", \"isDevelopment\", \"isDebug\"],\n            console: [\"error\", \"verbose\", \"table\", \"writeLine\"],\n            utils: [\n              \"useApp\",\n              \"hasFlag\",\n              \"isUnicodeSupported\",\n              \"internal_appContext\",\n              \"getArgs\",\n              \"findSuggestions\"\n            ]\n          })}>\n          <ExitFunctionDeclaration />\n          <Spacing />\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <Spacing />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(\n              context\n            )} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${\n                context?.packageJson.version\n                  ? `\"${context?.packageJson.version}\"`\n                  : \"0.0.1\"\n              });\n          return;`}\n            </IfStatement>\n            <Spacing />\n            {children}\n            <hbr />\n          </FunctionDeclaration>\n          <hbr />\n          <hbr />\n          <hbr />\n          <Show when={Boolean(postfix)} fallback={<RunApplication />}>\n            {postfix}\n          </Show>\n          <hbr />\n        </EntryFile>\n      )}\n    </For>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuCA,SAAgBiB,iBAAiB;AAC/B,QAAA;EAAAC,gBAEKZ,SAAO,EAAA,CAAA;EACPN,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEJmB,gBAAA,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBC,SAASC,OAAsB;CAC7C,MAAM,EAAEC,QAAQC,SAASC,gBAAgBC,SAASC,UAAU,GAAGC,SAASN;CAExE,MAAMO,UAAUrB,eAAoC;CACpD,MAAMsB,OAAO5B,eAAeU,UAAUmB,OAAOC,OAAOH,QAAQI,OAAOC,IAAI,CAAC,CAAC;AAEzE,QAAAf,gBACGhB,KAAG;EAAA,IAACgC,OAAI;AAAA,UAAEL,KAAKM;;EAAKT,WAClBO,QAAGf,gBACDV,WAAS4B,WACJT,MAAI;GAAA,IACRU,OAAI;AAAA,WAAEzB,aAAaC,iBAAiBoB,IAAI,CAAC;;GACzCK,gBAAgB;IACdC,MAAMN;IACNO,QAAQ;IACT;GAAA,IACDf,UAAO;AAAA,WAAEV,KACPU,WAAW,EAAE,EACbK,OAAOW,QAAQb,QAAQc,SAAS,CAC7BC,QAAQ,GAAGC,aAAaA,QAAQC,UAAU,CAC1CC,QAAQC,KAAK,CAACC,MAAMJ,aAAa;AAChCG,SAAI,KAAKH,QAAQI,UAAU,CACzB;MAAEA,MAAM;MAAWC,OAAO,SAASnC,WAAWkC,KAAK;MAAI,CACxD;AAED,YAAOD;OACN,EAA2B,CAClC,CAAC;;GAAA,IACDvB,iBAAc;AAAA,WAAET,KAAKS,kBAAkB,EAAE,EAAE;KACzC0B,KAAK;MAAC;MAAO;MAAiB;MAAU;KACxCC,SAAS;MAAC;MAAS;MAAW;MAAS;MAAY;KACnDC,OAAO;MACL;MACA;MACA;MACA;MACA;MACA;MAAiB;KAEpB,CAAC;;GAAA,IAAA1B,WAAA;AAAA,WAAA;KAAAR,gBACDF,yBAAuB,EAAA,CAAA;KAAAE,gBACvBZ,SAAO,EAAA,CAAA;KAAAY,gBACPf,MAAI;MAAA,IAACkD,OAAI;AAAA,cAAEC,QAAQhC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA,CACxBJ,QAAMJ,gBACNZ,SAAO,EAAA,CAAA,CAAA;;MAAA,CAAA;KAAAY,gBAETT,OAAK,EAAA,IACJ8C,UAAO;AAAA,aAAE,8BAA8B7C,YACrCkB,QACD,CAAA;QAAmB,CAAA;KAAAV,gBACrBd,qBAAmB;MAACoD,OAAK;MAACC,YAAU;MAAOT,MAAI;MAAA,IAAAtB,WAAA;AAAA,cAAA;QAAAR,gBAC7Cb,aAAW;SAACqD,WAAW1D,IAAI;SAA2B,IAAA0B,WAAA;AAAA,iBACpD1B,IAAI,eACH4B,SAAS+B,YAAYC,UACjB,IAAIhC,SAAS+B,YAAYC,QAAO,KAChC,QAAO;;;SAET,CAAA;QAAA1C,gBAELZ,SAAO,EAAA,CAAA;QACPoB;QAAQP,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAD,gBAMVf,MAAI;MAAA,IAACkD,OAAI;AAAA,cAAEC,QAAQ/B,QAAQ;;MAAA,IAAEsC,WAAQ;AAAA,cAAA3C,gBAAGD,gBAAc,EAAA,CAAA;;MAAAS,UACpDH;MAAO,CAAA;KAAAJ,gBAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA,CAAA;EAIb,CAAA"}
+{"version":3,"file":"bin-entry.mjs","names":[],"sources":["../../src/components/bin-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 { FunctionDeclaration, 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 { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\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  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { ExitFunctionDeclaration } from \"./exit-function-declaration\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <Spacing />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        const startDate = new Date();\n        try {\n          process.on(\"exit\", () => exit({\n            startDate,\n            skipProcessExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            startDate,\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                startDate,\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            startDate,\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            startDate,\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\n              startDate,\n              exception: err || new Error(\\`An \\${type === \"unhandledRejection\" ? \"unhandled promise rejection\" : \"uncaught exception\"} occurred during processing - the application is shutting down.\\`)\n            }));\n          }\n\n          await internal_appContext.run(new Map([[\"args\", getArgs()]]), async () => {\n            const result = await main();\n            if (result?.error) {\n              error(result.error);\n            }\n          });\n\n          exit({ startDate });\n        } catch (err) {\n          exit({ startDate, exception: err as Error });\n        }\n      })();\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface BinEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"hashbang\"\n> {\n  prefix?: Children;\n  postfix?: Children;\n  children: Children;\n}\n\n/**\n * The binary entry point for the Shell Shock project.\n */\nexport function BinEntry(props: BinEntryProps) {\n  const { prefix, postfix, builtinImports, imports, children, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const bins = computed(() => getUnique(Object.values(context.config.bin)));\n\n  return (\n    <For each={bins.value}>\n      {bin => (\n        <EntryFile\n          {...rest}\n          path={findFileName(replaceExtension(bin))}\n          typeDefinition={{\n            file: bin,\n            output: \"bin\"\n          }}\n          imports={defu(\n            imports ?? {},\n            Object.entries(context.commands)\n              .filter(([, command]) => command.isVirtual)\n              .reduce((ret, [name, command]) => {\n                ret[`./${command.name}`] = [\n                  { name: \"handler\", alias: `handle${pascalCase(name)}` }\n                ];\n\n                return ret;\n              }, {} as TypescriptFileImports)\n          )}\n          builtinImports={defu(builtinImports ?? {}, {\n            env: [\"env\", \"isDevelopment\", \"isDebug\"],\n            console: [\"error\", \"verbose\", \"table\", \"writeLine\"],\n            utils: [\n              \"useApp\",\n              \"hasFlag\",\n              \"isUnicodeSupported\",\n              \"internal_appContext\",\n              \"getArgs\",\n              \"findSuggestions\"\n            ],\n            help: [\"showHelp\"]\n          })}>\n          <ExitFunctionDeclaration />\n          <Spacing />\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <Spacing />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`}>\n            <TSDocRemarks>\n              {`This file serves as the main entry point for the binary executable of the ${getAppTitle(\n                context,\n                true\n              )} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`}\n            </TSDocRemarks>\n            <TSDocReturns>\n              {`Returns a promise that resolves to either a successful result or an error object.`}\n            </TSDocReturns>\n          </TSDoc>\n          <FunctionDeclaration\n            async\n            returnType=\"any | { error: string | Error }\"\n            name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${\n                context?.packageJson.version\n                  ? `\"${context?.packageJson.version}\"`\n                  : \"0.0.1\"\n              });\n              return; `}\n            </IfStatement>\n            <Spacing />\n            {children}\n            <hbr />\n          </FunctionDeclaration>\n          <hbr />\n          <hbr />\n          <hbr />\n          <Show when={Boolean(postfix)} fallback={<RunApplication />}>\n            {postfix}\n          </Show>\n          <hbr />\n        </EntryFile>\n      )}\n    </For>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwCA,SAAE,iBAAA;AACA,QAAM;EAAA,gBAAoB,SAAO,EAAI,CAAC;EAAA,IAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E9C,MAAO,EACL,QACC,SACD,gBACA,SACA,UACA,GAAA,SACF;;CAEE,MAAA,OAAA,eAAA,UAAA,OAAA,OAAA,QAAA,OAAA,IAAA,CAAA,CAAA;AACA,QAAK,gBAAmB,KAAI;EAC5B,IAAA,OAAA;AACI,UAAC,KAAS;;;GAGd,IAAM,OAAS;AACT,WAAO,aAAa,iBAAY,IAAO,CAAA;;GAE7C,gBAAO;IACD,MAAM;IACP,QAAO;IACP;GACD,IAAI,UAAQ;AACV,WAAO,KAAC,WAAa,EAAA,EAAA,OAAA,QAAqB,QAAC,SAAA,CAAA,QAAA,GAAA,aAAA,QAAA,UAAA,CAAA,QAAA,KAAA,CAAA,MAAA,aAAA;AACzC,SAAA,KAAA,QAAgB,UAAA,CAAA;MACd,MAAM;MACN,OAAO,SAAK,WAAA,KAAA;MACb,CAAA;AACD,YAAO;OACN,EAAC,CAAa,CAAA;;GAEnB,IAAI,iBAAgB;AAClB,WAAO,KAAA,kBAAoB,EAAA,EAAO;KAChC,KAAK;MAAC;MAAO;MAAiB;MAAG;KACjC,SAAS;MAAC;MAAO;MAAU;MAAQ;MAAQ;KAC3C,OAAO;MAAA;MAAA;MAAA;MAAA;MAAA;MAAA;MAAA;;KAER,CAAC;;GAEJ,IAAI,WAAC;AACH,WAAE;KAAA,gBAAqB,yBAAsB,EAAA,CAAA;KAAA,gBAAA,SAAA,EAAA,CAAA;KAAA,gBAAA,MAAA;MAC3C,IAAE,OAAO;AACP,cAAO,QAAI,OAAS;;MAEtB,IAAI,WAAQ;AACV,cAAG,CAAA,QAAQ,gBAAA,SAAA,EAAA,CAAA,CAAA;;MAEd,CAAC;KAAE,gBAAG,OAAoB;MACzB,IAAI,UAAS;AACX,cAAG,8BAAe,YAAA,SAAA,KAAA,CAAA;;MAEpB,IAAE,WAAQ;AACR,cAAC,CAAA,gBAAA,cAAA,EACF,IAAA,WAAA;AACA,eAAS,6EAAA,YAAA,SAAA,KAAA,CAAA;UAEP,CAAA,EAAA,gBAAM,cAAA,EACN,UAAS,qFACV,CAAA,CAAA;;MAEH,CAAC;KAAE,gBAAiB,qBAAsB;MACzC,OAAI;MACJ,YAAI;MACJ,MAAK;MACL,IAAG,WAAY;AACb,cAAI;QAAI,gBAAgB,aAAe;SACrC,WAAS,IAAA;SACT,IAAE,WAAA;AACA,iBAAC,IAAQ,eAAe,SAAW,YAAY,UAAK,IAAS,SAAC,YAAoB,QAAK,KAAA,QAAY;;;SAGtG,CAAC;QAAE,gBAAkB,SAAK,EAAA,CAAA;QAAS;QAAU,gBAAa,OAAY,EAAC,CAAA;QAAA;;MAE3E,CAAC;KAAE,gBAAK,OAAA,EAAA,CAAA;KAAA,gBAAA,OAAA,EAAA,CAAA;KAAA,gBAAA,OAAA,EAAA,CAAA;KAAA,gBAAA,MAAA;MACP,IAAC,OAAA;AACC,cAAA,QAAA,QAAA;;MAEF,IAAE,WAAW;AACX,cAAC,gBAAuB,gBAAe,EAAA,CAAA;;MAEzC,UAAM;MACP,CAAC;KAAE,gBAAY,OAAS,EAAA,CAAA;KAAA;;GAE5B,CAAC,CAAC;EACJ,CAAC"}

package/dist/components/command-entry.cjs

@@ -1,47 +1,47 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_components_banner_function_declaration = require('./banner-function-declaration.cjs');
-const require_components_help = require('./help.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 __shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
-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 __stryke_path_replace = require("@stryke/path/replace");
-let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+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 _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+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 defu = require("defu");
-defu = require_rolldown_runtime.__toESM(defu);
-let __shell_shock_core_components_helpers = require("@shell-shock/core/components/helpers");
-let __shell_shock_core = require("@shell-shock/core");
-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");
+defu = require_runtime.__toESM(defu);
+let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+let _stryke_path_join = require("@stryke/path/join");
+let _powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
+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_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.createComponent)(__alloy_js_typescript.VarDeclaration, {
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
 			name: "__context",
 			get initializer() {
-				return __alloy_js_core.code`{ 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("/")}\`, segments: [${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(", ")}] }`;
+				return _alloy_js_core.code`{ 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("/")}\`, segments: [${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(", ")}] }`;
 			}
 		}),
-		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`
 
       return internal_commandContext.run(__context, () => {
-        return Promise.resolve(Reflect.apply(handle${(0, __stryke_string_format_pascal_case.pascalCase)(command.name)}, __context, [options${command.args.length > 0 ? `, ${command.args.map((arg) => (0, __stryke_string_format_camel_case.camelCase)(arg.name)).join(", ")}` : ""}]));
+        return Promise.resolve(Reflect.apply(handle${(0, _stryke_string_format_pascal_case.pascalCase)(command.name)}, __context, [options${command.args.length > 0 ? `, ${command.args.map((arg) => (0, _stryke_string_format_camel_case.camelCase)(arg.name)).join(", ")}` : ""}]));
       });
 
       `),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 	];
 }
 /**
@@ -49,31 +49,31 @@ function CommandInvocation(props) {
 */
 function CommandHandlerDeclaration(props) {
 	const { command, banner, children } = props;
-	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	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, {
+		(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.`;
+				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() {
+					(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() {
+					(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, {
+					(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, {
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
 			"export": true,
 			async: true,
 			name: "handler",
@@ -84,7 +84,7 @@ function CommandHandlerDeclaration(props) {
 			}],
 			get children() {
 				return [
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_options_parser_logic.CommandParserLogic, {
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_options_parser_logic.CommandParserLogic, {
 						command,
 						get appSpecificEnvPrefix() {
 							return context.config.appSpecificEnvPrefix;
@@ -93,40 +93,34 @@ function CommandHandlerDeclaration(props) {
 							return context.config.isCaseSensitive;
 						}
 					}),
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					(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.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+					(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, {
 						get condition() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_helpers.IsDebug, {});
+							return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_core_components_helpers.IsDebug, {});
 						},
 						get children() {
-							return __alloy_js_core.code`writeLine("");
+							return _alloy_js_core.code`writeLine("");
           writeLine(colors.text.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
-          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")}` : ""}\`);
+          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")}` : ""}\`);
           writeLine(""); `;
 						}
 					}),
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 					children,
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-						condition: __alloy_js_core.code`options.help`,
-						get children() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_help.CommandHelp, { command });
-						}
+					(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 })];
+					(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 })];
 					} })
 				];
 			}
@@ -134,170 +128,18 @@ function CommandHandlerDeclaration(props) {
 	];
 }
 /**
-* A component that generates command validation logic for required options and arguments.
-*/
-function CommandValidationLogic(props) {
-	const { command } = props;
-	return [
-		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
-			name: "failures",
-			type: "string[]",
-			initializer: __alloy_js_core.code`[];`
-		}),
-		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
-			get each() {
-				return Object.values(command.options ?? {});
-			},
-			doubleHardline: true,
-			children: (option) => [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-				get when() {
-					return !option.optional;
-				},
-				get children() {
-					return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-						get condition() {
-							return __alloy_js_core.code`!options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}`;
-						},
-						get children() {
-							return __alloy_js_core.code`failures.push("Missing required \\"${option.name}\\" option");`;
-						}
-					}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-						get when() {
-							return (option.kind === __shell_shock_core.CommandParameterKinds.string || option.kind === __shell_shock_core.CommandParameterKinds.number) && option.variadic;
-						},
-						get children() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
-								get condition() {
-									return __alloy_js_core.code`options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}.length === 0`;
-								},
-								get children() {
-									return __alloy_js_core.code`failures.push("No values were provided to the required \\"${option.name}\\" array option");`;
-								}
-							});
-						}
-					})];
-				}
-			}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-				get when() {
-					return option.kind === __shell_shock_core.CommandParameterKinds.number;
-				},
-				get children() {
-					return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-						get when() {
-							return option.variadic;
-						},
-						get fallback() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-								get condition() {
-									return __alloy_js_core.code`options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`} && Number.isNaN(options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`})`;
-								},
-								get children() {
-									return __alloy_js_core.code`failures.push("Invalid numeric value provided for the \\"${option.name}\\" option");`;
-								}
-							});
-						},
-						get children() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-								get condition() {
-									return __alloy_js_core.code`options${option.name.includes("?") ? `["${option.name}"]` : `.${(0, __stryke_string_format_camel_case.camelCase)(option.name)}`}.some(value => Number.isNaN(value))`;
-								},
-								get children() {
-									return __alloy_js_core.code`failures.push("Invalid numeric value provided in the \\"${option.name}\\" array option");`;
-								}
-							});
-						}
-					});
-				}
-			})]
-		}),
-		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
-			get each() {
-				return command.args;
-			},
-			doubleHardline: true,
-			children: (argument) => [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-				get when() {
-					return !argument.optional;
-				},
-				get children() {
-					return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-						get condition() {
-							return __alloy_js_core.code`!${(0, __stryke_string_format_camel_case.camelCase)(argument.name)}`;
-						},
-						get children() {
-							return __alloy_js_core.code`failures.push("Missing required \\"${argument.name}\\" positional argument");`;
-						}
-					}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-						get when() {
-							return (argument.kind === __shell_shock_core.CommandParameterKinds.string || argument.kind === __shell_shock_core.CommandParameterKinds.number) && argument.variadic;
-						},
-						get children() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
-								get condition() {
-									return __alloy_js_core.code`${(0, __stryke_string_format_camel_case.camelCase)(argument.name)}.length === 0`;
-								},
-								get children() {
-									return __alloy_js_core.code`failures.push("No values were provided to the required \\"${argument.name}\\" array positional argument");`;
-								}
-							});
-						}
-					})];
-				}
-			}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-				get when() {
-					return argument.kind === __shell_shock_core.CommandParameterKinds.number;
-				},
-				get children() {
-					return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-						get when() {
-							return argument.variadic;
-						},
-						get fallback() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-								get condition() {
-									return __alloy_js_core.code`${(0, __stryke_string_format_camel_case.camelCase)(argument.name)} && Number.isNaN(${(0, __stryke_string_format_camel_case.camelCase)(argument.name)})`;
-								},
-								get children() {
-									return __alloy_js_core.code`failures.push("Invalid numeric value provided for the \\"${argument.name}\\" positional argument");`;
-								}
-							});
-						},
-						get children() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-								get condition() {
-									return __alloy_js_core.code`${(0, __stryke_string_format_camel_case.camelCase)(argument.name)}.some(value => Number.isNaN(value))`;
-								},
-								get children() {
-									return __alloy_js_core.code`failures.push("Invalid numeric value provided in the \\"${argument.name}\\" array positional argument");`;
-								}
-							});
-						}
-					});
-				}
-			})]
-		}),
-		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-			condition: __alloy_js_core.code`failures.length > 0`,
-			children: __alloy_js_core.code`error("The following validation failures were found while processing the user provided input, and must be corrected before the command-line process can be executed: \\n\\n" + failures.map(failure => " - " + failure).join("\\n"));
-        options.help = true; `
-		})
-	];
-}
-/**
 * 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)(() => ({
+	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, {
+	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;
 		},
@@ -305,7 +147,7 @@ function CommandEntry(props) {
 			return typeDefinition.value;
 		},
 		get imports() {
-			return (0, defu.default)(imports ?? {}, { [commandSourcePath.value]: `handle${(0, __stryke_string_format_pascal_case.pascalCase)(command.name)}` });
+			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 ?? {}, {
@@ -318,11 +160,8 @@ function CommandEntry(props) {
 					"debug",
 					"warn",
 					"error",
-					"table",
 					"colors",
-					"stripAnsi",
-					"writeLine",
-					"splitText"
+					"writeLine"
 				],
 				utils: [
 					"useArgs",
@@ -330,39 +169,42 @@ function CommandEntry(props) {
 					"isMinimal",
 					"isUnicodeSupported",
 					"internal_commandContext"
-				]
+				],
+				[(0, _stryke_path_join.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)))]: ["showHelp"]
 			});
 		},
 		get children() {
 			return [
-				(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, { command }),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(CommandHandlerDeclaration, {
+				(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, { command }),
+				(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`banner(); `,
+					banner: _alloy_js_core.code`banner(); `,
 					get children() {
-						return (0, __alloy_js_core_jsx_runtime.createComponent)(CommandValidationLogic, { command });
+						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`,
+							children: _alloy_js_core.code`error("The following validation failures were found while processing the user provided input, and must be corrected before the command-line process 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, {
+	})), (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, {
+		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 });
+				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 });
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_virtual_command_entry.VirtualCommandEntry, { command: child });
 			}
 		})
 	})];
@@ -372,5 +214,4 @@ function CommandEntry(props) {
 exports.CommandEntry = CommandEntry;
 exports.CommandHandlerDeclaration = CommandHandlerDeclaration;
 exports.CommandInvocation = CommandInvocation;
-exports.CommandValidationLogic = CommandValidationLogic;
 //# sourceMappingURL=command-entry.cjs.map