@shell-shock/preset-script 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -12,7 +12,6 @@ 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_render = require("@powerlines/plugin-alloy/render");
-let __shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
 let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __shell_shock_plugin_theme = require("@shell-shock/plugin-theme");
 __shell_shock_plugin_theme = require_rolldown_runtime.__toESM(__shell_shock_plugin_theme);
@@ -49,96 +48,119 @@ const plugin = (options = {}) => {
 				async handler() {
 					const _self$ = this;
 					this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
-					const commands = this.inputs.map((input) => (0, __shell_shock_core_plugin_utils.getCommandTree)(this, input.path.segments)).filter(Boolean);
 					return (0, __powerlines_plugin_alloy_render.render)(this, [(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_bin_entry.BinEntry, {
 						builtinImports: {
 							console: [
 								"divider",
 								"writeLine",
-								"colors"
+								"colors",
+								"banner",
+								"help"
 							],
 							utils: ["getArgs"]
 						},
 						get children() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-								get when() {
-									return (0, __alloy_js_core_jsx_runtime.memo)(() => !!_self$.commands)() && Object.keys(_self$.commands).length > 0;
-								},
-								get children() {
-									return [
-										(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
-											"const": true,
-											name: "args",
-											type: "string[]",
-											initializer: __alloy_js_core.code`getArgs();`
-										}),
-										(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-										(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_command_router.CommandRouter, {
-											path: [],
-											get commands() {
-												return _self$.commands ?? {};
-											}
-										}),
-										(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-										(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-										(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
-                writeLine("");
-                writeLine(colors.text.heading.primary("${/(?:cli|command-line|command line)\s+(?:application|app)?$/.test((0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(_self$).toLowerCase()) ? (0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(_self$) : `${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(_self$)} Command-Line Application`} v${_self$.packageJson.version}"));
-                writeLine("");
-                writeLine(colors.text.body.primary("${(0, __shell_shock_core_plugin_utils_context_helpers.getAppDescription)(_self$)}"));
-                writeLine("");
-                divider({ style: "primary" });
-                writeLine("");
-                writeLine("");`),
-										(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.For, {
-											get each() {
-												return Object.values(commands);
-											},
-											doubleHardline: true,
-											joiner: __alloy_js_core.code`
-                writeLine("");
-                divider({ style: "secondary" });
-                writeLine("");
+							return [
+								(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+									get when() {
+										return Object.keys(_self$.commands).length > 0;
+									},
+									get children() {
+										return [
+											(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+												"const": true,
+												name: "args",
+												type: "string[]",
+												initializer: __alloy_js_core.code`getArgs();`
+											}),
+											(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+											(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_command_router.CommandRouter, {
+												path: [],
+												get commands() {
+													return _self$.commands ?? {};
+												}
+											}),
+											(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+										];
+									}
+								}),
+								(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+								__alloy_js_core.code`
                 writeLine("");
-                `,
-											children: (child) => [
-												(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
-                writeLine("");
-                writeLine(colors.text.heading.secondary("${child.title}"));
+                banner();
+                writeLine(""); `,
+								(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+								(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+								__alloy_js_core.code`writeLine(colors.text.heading.secondary("Global Options:"));`,
+								(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+								(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_help.HelpOptions, { get options() {
+									return _self$.options;
+								} }),
+								__alloy_js_core.code`writeLine(""); `,
+								(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, {
+									get when() {
+										return Object.keys(_self$.commands).length > 0;
+									},
+									get children() {
+										return [
+											__alloy_js_core.code`writeLine(colors.text.body.secondary("The following commands are available:"));
+                  writeLine(""); `,
+											(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.For, {
+												get each() {
+													return Object.values(_self$.commands);
+												},
+												doubleHardline: true,
+												joiner: __alloy_js_core.code`writeLine(""); `,
+												ender: __alloy_js_core.code`writeLine(""); `,
+												children: (child) => [
+													(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
+                writeLine(colors.text.heading.primary("${child.title} ${child.isVirtual ? "" : "Command"}"));
                 writeLine("");
                 writeLine(colors.text.body.secondary("${child.description}"));
                 writeLine("");
-                writeLine("");
                 `),
-												(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-												(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_help.Help, {
-													command: child,
-													indent: 2
-												})
-											]
-										})
-									];
-								}
-							});
+													(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+													(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_help.Help, {
+														command: child,
+														indent: 2
+													}),
+													(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+												]
+											}),
+											(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(_self$)} <specific command> --help') will provide additional information that is specific to that command.");
+                  writeLine("");`)
+										];
+									}
+								})
+							];
 						}
-					}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
-						get each() {
-							return Object.values(commands);
+					}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+						get when() {
+							return Object.values(_self$.commands).length > 0;
 						},
-						doubleHardline: true,
-						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)(require_components_command_entry.CommandEntry, { command: child });
-							},
-							get children() {
-								return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_virtual_command_entry.VirtualCommandEntry, { command: child });
-							}
-						})
+						get children() {
+							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+								get each() {
+									return Object.values(_self$.commands);
+								},
+								doubleHardline: true,
+								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)(require_components_command_entry.CommandEntry, { command: child });
+									},
+									get children() {
+										return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_virtual_command_entry.VirtualCommandEntry, { command: child });
+									}
+								})
+							});
+						}
 					})]);
 				}
 			}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["code","For","Show","VarDeclaration","render","getCommandTree","getAppDescription","getAppTitle","theme","BinEntry","CommandEntry","CommandRouter","ConsoleBuiltin","Help","UtilsBuiltin","VirtualCommandEntry","getDefaultOptions","plugin","options","name","config","debug","defaultOptions","isCaseSensitive","configResolved","dependencies","didyoumean2","prepare","_$createComponent","order","handler","_self$","commands","inputs","map","input","path","segments","filter","Boolean","builtinImports","console","utils","children","when","_$memo","Object","keys","length","type","initializer","_$createIntrinsic","test","toLowerCase","packageJson","version","each","values","doubleHardline","joiner","child","title","description","command","indent","isVirtual","fallback"],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getCommandTree } from \"@shell-shock/core/plugin-utils\";\nimport {\n  getAppDescription,\n  getAppTitle\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport type { Plugin } from \"powerlines/types/plugin\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { ConsoleBuiltin } from \"./components/console-builtin\";\nimport { Help } from \"./components/help\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    theme({\n      theme: options.theme\n    }),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      configResolved() {\n        this.dependencies.didyoumean2 = \"^7.0.4\";\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering built-in modules for the Shell Shock `script` preset.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n            <ConsoleBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          const commands = this.inputs\n            .map(input => getCommandTree(this, input.path.segments))\n            .filter(Boolean) as CommandTree[];\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\"divider\", \"writeLine\", \"colors\"],\n                  utils: [\"getArgs\"]\n                }}>\n                <Show\n                  when={this.commands && Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`getArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter path={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                  <hbr />\n                  {code`\n                writeLine(\"\");\n                writeLine(colors.text.heading.primary(\"${\n                  /(?:cli|command-line|command line)\\s+(?:application|app)?$/.test(\n                    getAppTitle(this).toLowerCase()\n                  )\n                    ? getAppTitle(this)\n                    : `${getAppTitle(this)} Command-Line Application`\n                } v${this.packageJson.version}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.primary(\"${getAppDescription(\n                  this\n                )}\"));\n                writeLine(\"\");\n                divider({ style: \"primary\" });\n                writeLine(\"\");\n                writeLine(\"\");`}\n                  <hbr />\n                  <hbr />\n                  <For\n                    each={Object.values(commands)}\n                    doubleHardline\n                    joiner={code`\n                writeLine(\"\");\n                divider({ style: \"secondary\" });\n                writeLine(\"\");\n                writeLine(\"\");\n                `}>\n                    {child => (\n                      <>\n                        {code`\n                writeLine(\"\");\n                writeLine(colors.text.heading.secondary(\"${child.title}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                writeLine(\"\");\n                `}\n                        <hbr />\n                        <Help command={child} indent={2} />\n                      </>\n                    )}\n                  </For>\n                </Show>\n              </BinEntry>\n              <For each={Object.values(commands)} doubleHardline>\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      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAaiB,UAGXC,UAA+B,EAAE,KAC9B;AACH,QAAO;0CACC,EACJV,OAAOU,QAAQV,OAChB,CAAC;EACF;GACEW,MAAM;GACNC,SAAS;AACP,SAAKC,MACH,uEACD;AAED,WAAO;KACLC,gBAAgBN;KAChBO,iBAAiB;KACjB,GAAGL;KACJ;;GAEHM,iBAAiB;AACf,SAAKC,aAAaC,cAAc;;GAElC,MAAMC,UAAU;AACd,SAAKN,MACH,kEACD;AAED,wDACE,MAAI,kDAEDP,+CAAY,EAAA,CAAA,mDACZF,mDAAc,EAAA,CAAA,CAEnB,CAAC;;GAEJ;EACD;GACEO,MAAM;GACNQ,SAAS;IACPE,OAAO;IACP,MAAMC,UAAU;KAAA,MAAAC,SAAA;AACd,UAAKV,MACH,oEACD;KAED,MAAMW,WAAW,KAAKC,OACnBC,KAAIC,8DAAwB,MAAMA,MAAMC,KAAKC,SAAS,CAAC,CACvDC,OAAOC,QAAyB;AAEnC,yDACE,MAAI,kDAED9B,uCAAQ;MACP+B,gBAAgB;OACdC,SAAS;QAAC;QAAW;QAAa;QAAS;OAC3CC,OAAO,CAAC,UAAS;OAClB;MAAA,IAAAC,WAAA;AAAA,+DACAzC,sBAAI;QAAA,IACH0C,OAAI;AAAA,4DAAE,CAAA,CAAAb,OAAKC,SAAQ,EAAA,IAAIc,OAAOC,KAAKhB,OAAKC,SAAS,CAACgB,SAAS;;QAAC,IAAAL,WAAA;AAAA,gBAAA;2DAC3DxC,sCAAc;WAAA,SAAA;WAEbgB,MAAI;WACJ8B,MAAI;WACJC,aAAalD,oBAAI;WAAY,CAAA;2DAAA,OAAA,EAAA,CAAA;2DAG9BW,iDAAa;WAACyB,MAAM,EAAE;WAAA,IAAEJ,WAAQ;AAAA,mBAAED,OAAKC,YAAY,EAAE;;WAAA,CAAA;2DAAA,OAAA,EAAA,CAAA;2DAAA,OAAA,EAAA,CAAA;sDAGrDhC,oBAAI;;yDAGL,4DAA4DoD,sEAC/CrB,OAAM,CAACsB,aACpB,CAAC,oEACctB,OAAM,GACjB,oEAAcA,OAAM,CAAA,2BAA2B,IAChDA,OAAKuB,YAAYC,QAAO;;6HAE0BxB,OAEtD,CAAA;;;;gCAIc;2DAAA,OAAA,EAAA,CAAA;2DAAA,OAAA,EAAA,CAAA;2DAGZ9B,qBAAG;WAAA,IACFuD,OAAI;AAAA,mBAAEV,OAAOW,OAAOzB,SAAS;;WAC7B0B,gBAAc;WACdC,QAAQ3D,oBAAI;;;;;;WAKf2C,WACIiB,UAAK;wDAED5D,oBAAI;;2DAE8B4D,MAAMC,MAAK;;wDAEdD,MAAME,YAAW;;;kBAGxD;6DAAA,OAAA,EAAA,CAAA;6DAEQjD,8BAAI;aAACkD,SAASH;aAAOI,QAAQ;aAAC,CAAA;YAAA;WAElC,CAAA;UAAA;;QAAA,CAAA;;MAAA,CAAA,mDAIN/D,qBAAG;MAAA,IAACuD,OAAI;AAAA,cAAEV,OAAOW,OAAOzB,SAAS;;MAAE0B,gBAAc;MAAAf,WAC/CiB,2DACE1D,sBAAI;OAAA,IACH0C,OAAI;AAAA,eAAEgB,MAAMK;;OAAS,IACrBC,WAAQ;AAAA,gEAAGxD,+CAAY,EAACqD,SAASH,OAAK,CAAA;;OAAA,IAAAjB,WAAA;AAAA,gEACrC5B,8DAAmB,EAACgD,SAASH,OAAK,CAAA;;OAAA,CAAA;MAEtC,CAAA,CAGP,CAAC;;IAEL;GACD;EACF;;AAGH,kBAAe3C"}
+{"version":3,"file":"index.cjs","names":["code","For","Show","VarDeclaration","render","getAppBin","theme","BinEntry","CommandEntry","CommandRouter","ConsoleBuiltin","Help","HelpOptions","UtilsBuiltin","VirtualCommandEntry","getDefaultOptions","plugin","options","name","config","debug","defaultOptions","isCaseSensitive","configResolved","dependencies","didyoumean2","prepare","_$createComponent","order","handler","_self$","builtinImports","console","utils","children","when","Object","keys","commands","length","type","initializer","_$createIntrinsic","path","each","values","doubleHardline","joiner","ender","child","_$memo","title","isVirtual","description","command","indent","fallback"],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppBin } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport type { Plugin } from \"powerlines/types/plugin\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { ConsoleBuiltin } from \"./components/console-builtin\";\nimport { Help, HelpOptions } from \"./components/help\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    theme({\n      theme: options.theme\n    }),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      configResolved() {\n        this.dependencies.didyoumean2 = \"^7.0.4\";\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering built-in modules for the Shell Shock `script` preset.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n            <ConsoleBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\"divider\", \"writeLine\", \"colors\", \"banner\", \"help\"],\n                  utils: [\"getArgs\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`getArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter path={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <hbr />\n                {code`\n                writeLine(\"\");\n                banner();\n                writeLine(\"\"); `}\n                <hbr />\n                <hbr />\n                {code`writeLine(colors.text.heading.secondary(\"Global Options:\"));`}\n                <hbr />\n                <HelpOptions options={this.options} />\n                {code`writeLine(\"\"); `}\n                <hbr />\n                <hbr />\n                <Show when={Object.keys(this.commands).length > 0}>\n                  {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n                  writeLine(\"\"); `}\n                  <hbr />\n                  <hbr />\n                  <For\n                    each={Object.values(this.commands)}\n                    doubleHardline\n                    joiner={code`writeLine(\"\"); `}\n                    ender={code`writeLine(\"\"); `}>\n                    {child => (\n                      <>\n                        {code`\n                writeLine(colors.text.heading.primary(\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n                        <hbr />\n                        <Help command={child} indent={2} />\n                        <hbr />\n                      </>\n                    )}\n                  </For>\n                  {code`help(\"Running a specific command with the help flag (via: '${getAppBin(this)} <specific command> --help') will provide additional information that is specific to that command.\");\n                  writeLine(\"\");`}\n                </Show>\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAagB,UAGXC,UAA+B,EAAE,KAC9B;AACH,QAAO;0CACC,EACJX,OAAOW,QAAQX,OAChB,CAAC;EACF;GACEY,MAAM;GACNC,SAAS;AACP,SAAKC,MACH,uEACD;AAED,WAAO;KACLC,gBAAgBN;KAChBO,iBAAiB;KACjB,GAAGL;KACJ;;GAEHM,iBAAiB;AACf,SAAKC,aAAaC,cAAc;;GAElC,MAAMC,UAAU;AACd,SAAKN,MACH,kEACD;AAED,wDACE,MAAI,kDAEDP,+CAAY,EAAA,CAAA,mDACZH,mDAAc,EAAA,CAAA,CAEnB,CAAC;;GAEJ;EACD;GACEQ,MAAM;GACNQ,SAAS;IACPE,OAAO;IACP,MAAMC,UAAU;KAAA,MAAAC,SAAA;AACd,UAAKV,MACH,oEACD;AAED,yDACE,MAAI,kDAEDb,uCAAQ;MACPwB,gBAAgB;OACdC,SAAS;QAAC;QAAW;QAAa;QAAU;QAAU;QAAO;OAC7DC,OAAO,CAAC,UAAS;OAClB;MAAA,IAAAC,WAAA;AAAA,cAAA;yDACAhC,sBAAI;SAAA,IAACiC,OAAI;AAAA,iBAAEC,OAAOC,KAAKP,OAAKQ,SAAS,CAACC,SAAS;;SAAC,IAAAL,WAAA;AAAA,iBAAA;4DAC9C/B,sCAAc;YAAA,SAAA;YAEbe,MAAI;YACJsB,MAAI;YACJC,aAAazC,oBAAI;YAAY,CAAA;4DAAA,OAAA,EAAA,CAAA;4DAG9BS,iDAAa;YAACkC,MAAM,EAAE;YAAA,IAAEL,WAAQ;AAAA,oBAAER,OAAKQ,YAAY,EAAE;;YAAA,CAAA;4DAAA,OAAA,EAAA,CAAA;WAAA;;SAAA,CAAA;yDAAA,OAAA,EAAA,CAAA;QAIvDtC,oBAAI;;;;yDAGW,OAAA,EAAA,CAAA;yDAAA,OAAA,EAAA,CAAA;QAGfA,oBAAI;yDAA8D,OAAA,EAAA,CAAA;yDAElEY,qCAAW,EAAA,IAACK,UAAO;AAAA,gBAAEa,OAAKb;WAAO,CAAA;QACjCjB,oBAAI;yDAAiB,OAAA,EAAA,CAAA;yDAAA,OAAA,EAAA,CAAA;yDAGrBE,sBAAI;SAAA,IAACiC,OAAI;AAAA,iBAAEC,OAAOC,KAAKP,OAAKQ,SAAS,CAACC,SAAS;;SAAC,IAAAL,WAAA;AAAA,iBAAA;WAC9ClC,oBAAI;;4DACW,OAAA,EAAA,CAAA;4DAAA,OAAA,EAAA,CAAA;4DAGfC,qBAAG;YAAA,IACF2C,OAAI;AAAA,oBAAER,OAAOS,OAAOf,OAAKQ,SAAS;;YAClCQ,gBAAc;YACdC,QAAQ/C,oBAAI;YACZgD,OAAOhD,oBAAI;YAAiBkC,WAC3Be,UAAK;yDAEDjD,oBAAI;yDAC4BiD,MAAME,MAAK,GAAIF,MAAMG,YAAY,KAAK,UAAS;;wDAEhDH,MAAMI,YAAW;;kBAExD;8DAAA,OAAA,EAAA,CAAA;8DAEQ1C,8BAAI;cAAC2C,SAASL;cAAOM,QAAQ;cAAC,CAAA;8DAAA,OAAA,EAAA,CAAA;aAAA;YAGlC,CAAA;uDAEFvD,oBAAI,6HAAuE8B,OAAM,CAAA;kCACnE;WAAA;;SAAA,CAAA;QAAA;;MAAA,CAAA,mDAGlB5B,sBAAI;MAAA,IAACiC,OAAI;AAAA,cAAEC,OAAOS,OAAOf,OAAKQ,SAAS,CAACC,SAAS;;MAAC,IAAAL,WAAA;AAAA,+DAChDjC,qBAAG;QAAA,IAAC2C,OAAI;AAAA,gBAAER,OAAOS,OAAOf,OAAKQ,SAAS;;QAAEQ,gBAAc;QAAAZ,WACpDe,2DACE/C,sBAAI;SAAA,IACHiC,OAAI;AAAA,iBAAEc,MAAMG;;SAAS,IACrBI,WAAQ;AAAA,kEAAGhD,+CAAY,EAAC8C,SAASL,OAAK,CAAA;;SAAA,IAAAf,WAAA;AAAA,kEACrCpB,8DAAmB,EAACwC,SAASL,OAAK,CAAA;;SAAA,CAAA;QAEtC,CAAA;;MAAA,CAAA,CAIT,CAAC;;IAEL;GACD;EACF;;AAGH,kBAAejC"}

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA0CA;AACmB,cADN,MACM,EAAA,CAAA,iBAAA,mBAAA,GAAsB,mBAAtB,CAAA,CAAA,OAAA,CAAA,EAER,mBAFQ,EAAA,GAkIZ,MAlIY,CAkIL,QAlIK,CAAA,EAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAqCA;AACmB,cADN,MACM,EAAA,CAAA,iBAAA,mBAAA,GAAsB,mBAAtB,CAAA,CAAA,OAAA,CAAA,EAER,mBAFQ,EAAA,GA2HZ,MA3HY,CA2HL,QA3HK,CAAA,EAAA"}

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA0CA;AACmB,cADN,MACM,EAAA,CAAA,iBAAA,mBAAA,GAAsB,mBAAtB,CAAA,CAAA,OAAA,CAAA,EAER,mBAFQ,EAAA,GAkIZ,MAlIY,CAkIL,QAlIK,CAAA,EAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAqCA;AACmB,cADN,MACM,EAAA,CAAA,iBAAA,mBAAA,GAAsB,mBAAtB,CAAA,CAAA,OAAA,CAAA,EAER,mBAFQ,EAAA,GA2HZ,MA3HY,CA2HL,QA3HK,CAAA,EAAA"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { BinEntry } from "./components/bin-entry.mjs";
-import { Help } from "./components/help.mjs";
+import { Help, HelpOptions } from "./components/help.mjs";
 import { CommandRouter } from "./components/command-router.mjs";
 import { VirtualCommandEntry } from "./components/virtual-command-entry.mjs";
 import { CommandEntry } from "./components/command-entry.mjs";
@@ -10,8 +10,7 @@ import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runti
 import { For, Show, code } from "@alloy-js/core";
 import { VarDeclaration } from "@alloy-js/typescript";
 import { render } from "@powerlines/plugin-alloy/render";
-import { getCommandTree } from "@shell-shock/core/plugin-utils";
-import { getAppDescription, getAppTitle } from "@shell-shock/core/plugin-utils/context-helpers";
+import { getAppBin } from "@shell-shock/core/plugin-utils/context-helpers";
 import theme from "@shell-shock/plugin-theme";
 
 //#region src/index.tsx
@@ -46,96 +45,119 @@ const plugin = (options = {}) => {
 				async handler() {
 					const _self$ = this;
 					this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
-					const commands = this.inputs.map((input) => getCommandTree(this, input.path.segments)).filter(Boolean);
 					return render(this, [createComponent(BinEntry, {
 						builtinImports: {
 							console: [
 								"divider",
 								"writeLine",
-								"colors"
+								"colors",
+								"banner",
+								"help"
 							],
 							utils: ["getArgs"]
 						},
 						get children() {
-							return createComponent(Show, {
-								get when() {
-									return memo(() => !!_self$.commands)() && Object.keys(_self$.commands).length > 0;
-								},
-								get children() {
-									return [
-										createComponent(VarDeclaration, {
-											"const": true,
-											name: "args",
-											type: "string[]",
-											initializer: code`getArgs();`
-										}),
-										createIntrinsic("hbr", {}),
-										createComponent(CommandRouter, {
-											path: [],
-											get commands() {
-												return _self$.commands ?? {};
-											}
-										}),
-										createIntrinsic("hbr", {}),
-										createIntrinsic("hbr", {}),
-										memo(() => code`
-                writeLine("");
-                writeLine(colors.text.heading.primary("${/(?:cli|command-line|command line)\s+(?:application|app)?$/.test(getAppTitle(_self$).toLowerCase()) ? getAppTitle(_self$) : `${getAppTitle(_self$)} Command-Line Application`} v${_self$.packageJson.version}"));
-                writeLine("");
-                writeLine(colors.text.body.primary("${getAppDescription(_self$)}"));
-                writeLine("");
-                divider({ style: "primary" });
-                writeLine("");
-                writeLine("");`),
-										createIntrinsic("hbr", {}),
-										createIntrinsic("hbr", {}),
-										createComponent(For, {
-											get each() {
-												return Object.values(commands);
-											},
-											doubleHardline: true,
-											joiner: code`
-                writeLine("");
-                divider({ style: "secondary" });
-                writeLine("");
+							return [
+								createComponent(Show, {
+									get when() {
+										return Object.keys(_self$.commands).length > 0;
+									},
+									get children() {
+										return [
+											createComponent(VarDeclaration, {
+												"const": true,
+												name: "args",
+												type: "string[]",
+												initializer: code`getArgs();`
+											}),
+											createIntrinsic("hbr", {}),
+											createComponent(CommandRouter, {
+												path: [],
+												get commands() {
+													return _self$.commands ?? {};
+												}
+											}),
+											createIntrinsic("hbr", {})
+										];
+									}
+								}),
+								createIntrinsic("hbr", {}),
+								code`
                 writeLine("");
-                `,
-											children: (child) => [
-												memo(() => code`
-                writeLine("");
-                writeLine(colors.text.heading.secondary("${child.title}"));
+                banner();
+                writeLine(""); `,
+								createIntrinsic("hbr", {}),
+								createIntrinsic("hbr", {}),
+								code`writeLine(colors.text.heading.secondary("Global Options:"));`,
+								createIntrinsic("hbr", {}),
+								createComponent(HelpOptions, { get options() {
+									return _self$.options;
+								} }),
+								code`writeLine(""); `,
+								createIntrinsic("hbr", {}),
+								createIntrinsic("hbr", {}),
+								createComponent(Show, {
+									get when() {
+										return Object.keys(_self$.commands).length > 0;
+									},
+									get children() {
+										return [
+											code`writeLine(colors.text.body.secondary("The following commands are available:"));
+                  writeLine(""); `,
+											createIntrinsic("hbr", {}),
+											createIntrinsic("hbr", {}),
+											createComponent(For, {
+												get each() {
+													return Object.values(_self$.commands);
+												},
+												doubleHardline: true,
+												joiner: code`writeLine(""); `,
+												ender: code`writeLine(""); `,
+												children: (child) => [
+													memo(() => code`
+                writeLine(colors.text.heading.primary("${child.title} ${child.isVirtual ? "" : "Command"}"));
                 writeLine("");
                 writeLine(colors.text.body.secondary("${child.description}"));
                 writeLine("");
-                writeLine("");
                 `),
-												createIntrinsic("hbr", {}),
-												createComponent(Help, {
-													command: child,
-													indent: 2
-												})
-											]
-										})
-									];
-								}
-							});
+													createIntrinsic("hbr", {}),
+													createComponent(Help, {
+														command: child,
+														indent: 2
+													}),
+													createIntrinsic("hbr", {})
+												]
+											}),
+											memo(() => code`help("Running a specific command with the help flag (via: '${getAppBin(_self$)} <specific command> --help') will provide additional information that is specific to that command.");
+                  writeLine("");`)
+										];
+									}
+								})
+							];
 						}
-					}), createComponent(For, {
-						get each() {
-							return Object.values(commands);
+					}), createComponent(Show, {
+						get when() {
+							return Object.values(_self$.commands).length > 0;
 						},
-						doubleHardline: true,
-						children: (child) => createComponent(Show, {
-							get when() {
-								return child.isVirtual;
-							},
-							get fallback() {
-								return createComponent(CommandEntry, { command: child });
-							},
-							get children() {
-								return createComponent(VirtualCommandEntry, { command: child });
-							}
-						})
+						get children() {
+							return createComponent(For, {
+								get each() {
+									return Object.values(_self$.commands);
+								},
+								doubleHardline: true,
+								children: (child) => createComponent(Show, {
+									get when() {
+										return child.isVirtual;
+									},
+									get fallback() {
+										return createComponent(CommandEntry, { command: child });
+									},
+									get children() {
+										return createComponent(VirtualCommandEntry, { command: child });
+									}
+								})
+							});
+						}
 					})]);
 				}
 			}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["code","For","Show","VarDeclaration","render","getCommandTree","getAppDescription","getAppTitle","theme","BinEntry","CommandEntry","CommandRouter","ConsoleBuiltin","Help","UtilsBuiltin","VirtualCommandEntry","getDefaultOptions","plugin","options","name","config","debug","defaultOptions","isCaseSensitive","configResolved","dependencies","didyoumean2","prepare","_$createComponent","order","handler","_self$","commands","inputs","map","input","path","segments","filter","Boolean","builtinImports","console","utils","children","when","_$memo","Object","keys","length","type","initializer","_$createIntrinsic","test","toLowerCase","packageJson","version","each","values","doubleHardline","joiner","child","title","description","command","indent","isVirtual","fallback"],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getCommandTree } from \"@shell-shock/core/plugin-utils\";\nimport {\n  getAppDescription,\n  getAppTitle\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport type { Plugin } from \"powerlines/types/plugin\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { ConsoleBuiltin } from \"./components/console-builtin\";\nimport { Help } from \"./components/help\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    theme({\n      theme: options.theme\n    }),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      configResolved() {\n        this.dependencies.didyoumean2 = \"^7.0.4\";\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering built-in modules for the Shell Shock `script` preset.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n            <ConsoleBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          const commands = this.inputs\n            .map(input => getCommandTree(this, input.path.segments))\n            .filter(Boolean) as CommandTree[];\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\"divider\", \"writeLine\", \"colors\"],\n                  utils: [\"getArgs\"]\n                }}>\n                <Show\n                  when={this.commands && Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`getArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter path={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                  <hbr />\n                  {code`\n                writeLine(\"\");\n                writeLine(colors.text.heading.primary(\"${\n                  /(?:cli|command-line|command line)\\s+(?:application|app)?$/.test(\n                    getAppTitle(this).toLowerCase()\n                  )\n                    ? getAppTitle(this)\n                    : `${getAppTitle(this)} Command-Line Application`\n                } v${this.packageJson.version}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.primary(\"${getAppDescription(\n                  this\n                )}\"));\n                writeLine(\"\");\n                divider({ style: \"primary\" });\n                writeLine(\"\");\n                writeLine(\"\");`}\n                  <hbr />\n                  <hbr />\n                  <For\n                    each={Object.values(commands)}\n                    doubleHardline\n                    joiner={code`\n                writeLine(\"\");\n                divider({ style: \"secondary\" });\n                writeLine(\"\");\n                writeLine(\"\");\n                `}>\n                    {child => (\n                      <>\n                        {code`\n                writeLine(\"\");\n                writeLine(colors.text.heading.secondary(\"${child.title}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                writeLine(\"\");\n                `}\n                        <hbr />\n                        <Help command={child} indent={2} />\n                      </>\n                    )}\n                  </For>\n                </Show>\n              </BinEntry>\n              <For each={Object.values(commands)} doubleHardline>\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      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0CA,MAAaiB,UAGXC,UAA+B,EAAE,KAC9B;AACH,QAAO;EACLV,MAAM,EACJA,OAAOU,QAAQV,OAChB,CAAC;EACF;GACEW,MAAM;GACNC,SAAS;AACP,SAAKC,MACH,uEACD;AAED,WAAO;KACLC,gBAAgBN;KAChBO,iBAAiB;KACjB,GAAGL;KACJ;;GAEHM,iBAAiB;AACf,SAAKC,aAAaC,cAAc;;GAElC,MAAMC,UAAU;AACd,SAAKN,MACH,kEACD;AAED,WAAOjB,OACL,MAAI,CAAAwB,gBAEDd,cAAY,EAAA,CAAA,EAAAc,gBACZhB,gBAAc,EAAA,CAAA,CAEnB,CAAC;;GAEJ;EACD;GACEO,MAAM;GACNQ,SAAS;IACPE,OAAO;IACP,MAAMC,UAAU;KAAA,MAAAC,SAAA;AACd,UAAKV,MACH,oEACD;KAED,MAAMW,WAAW,KAAKC,OACnBC,KAAIC,UAAS9B,eAAe,MAAM8B,MAAMC,KAAKC,SAAS,CAAC,CACvDC,OAAOC,QAAyB;AAEnC,YAAOnC,OACL,MAAI,CAAAwB,gBAEDnB,UAAQ;MACP+B,gBAAgB;OACdC,SAAS;QAAC;QAAW;QAAa;QAAS;OAC3CC,OAAO,CAAC,UAAS;OAClB;MAAA,IAAAC,WAAA;AAAA,cAAAf,gBACA1B,MAAI;QAAA,IACH0C,OAAI;AAAA,gBAAEC,WAAA,CAAA,CAAAd,OAAKC,SAAQ,EAAA,IAAIc,OAAOC,KAAKhB,OAAKC,SAAS,CAACgB,SAAS;;QAAC,IAAAL,WAAA;AAAA,gBAAA;UAAAf,gBAC3DzB,gBAAc;WAAA,SAAA;WAEbgB,MAAI;WACJ8B,MAAI;WACJC,aAAalD,IAAI;WAAY,CAAA;UAAAmD,gBAAA,OAAA,EAAA,CAAA;UAAAvB,gBAG9BjB,eAAa;WAACyB,MAAM,EAAE;WAAA,IAAEJ,WAAQ;AAAA,mBAAED,OAAKC,YAAY,EAAE;;WAAA,CAAA;UAAAmB,gBAAA,OAAA,EAAA,CAAA;UAAAA,gBAAA,OAAA,EAAA,CAAA;UAAAN,WAGrD7C,IAAI;;yDAGL,4DAA4DoD,KAC1D7C,YAAWwB,OAAM,CAACsB,aACpB,CAAC,GACG9C,YAAWwB,OAAM,GACjB,GAAGxB,YAAWwB,OAAM,CAAA,2BAA2B,IAChDA,OAAKuB,YAAYC,QAAO;;sDAESjD,kBAAiByB,OAEtD,CAAA;;;;gCAIc;UAAAoB,gBAAA,OAAA,EAAA,CAAA;UAAAA,gBAAA,OAAA,EAAA,CAAA;UAAAvB,gBAGZ3B,KAAG;WAAA,IACFuD,OAAI;AAAA,mBAAEV,OAAOW,OAAOzB,SAAS;;WAC7B0B,gBAAc;WACdC,QAAQ3D,IAAI;;;;;;WAKf2C,WACIiB,UAAK;YAAAf,WAED7C,IAAI;;2DAE8B4D,MAAMC,MAAK;;wDAEdD,MAAME,YAAW;;;kBAGxD;YAAAX,gBAAA,OAAA,EAAA,CAAA;YAAAvB,gBAEQf,MAAI;aAACkD,SAASH;aAAOI,QAAQ;aAAC,CAAA;YAAA;WAElC,CAAA;UAAA;;QAAA,CAAA;;MAAA,CAAA,EAAApC,gBAIN3B,KAAG;MAAA,IAACuD,OAAI;AAAA,cAAEV,OAAOW,OAAOzB,SAAS;;MAAE0B,gBAAc;MAAAf,WAC/CiB,UAAKhC,gBACH1B,MAAI;OAAA,IACH0C,OAAI;AAAA,eAAEgB,MAAMK;;OAAS,IACrBC,WAAQ;AAAA,eAAAtC,gBAAGlB,cAAY,EAACqD,SAASH,OAAK,CAAA;;OAAA,IAAAjB,WAAA;AAAA,eAAAf,gBACrCb,qBAAmB,EAACgD,SAASH,OAAK,CAAA;;OAAA,CAAA;MAEtC,CAAA,CAGP,CAAC;;IAEL;GACD;EACF;;AAGH,kBAAe3C"}
+{"version":3,"file":"index.mjs","names":["code","For","Show","VarDeclaration","render","getAppBin","theme","BinEntry","CommandEntry","CommandRouter","ConsoleBuiltin","Help","HelpOptions","UtilsBuiltin","VirtualCommandEntry","getDefaultOptions","plugin","options","name","config","debug","defaultOptions","isCaseSensitive","configResolved","dependencies","didyoumean2","prepare","_$createComponent","order","handler","_self$","builtinImports","console","utils","children","when","Object","keys","commands","length","type","initializer","_$createIntrinsic","path","each","values","doubleHardline","joiner","ender","child","_$memo","title","isVirtual","description","command","indent","fallback"],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppBin } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport type { Plugin } from \"powerlines/types/plugin\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { ConsoleBuiltin } from \"./components/console-builtin\";\nimport { Help, HelpOptions } from \"./components/help\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    theme({\n      theme: options.theme\n    }),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      configResolved() {\n        this.dependencies.didyoumean2 = \"^7.0.4\";\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering built-in modules for the Shell Shock `script` preset.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n            <ConsoleBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\"divider\", \"writeLine\", \"colors\", \"banner\", \"help\"],\n                  utils: [\"getArgs\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`getArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter path={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <hbr />\n                {code`\n                writeLine(\"\");\n                banner();\n                writeLine(\"\"); `}\n                <hbr />\n                <hbr />\n                {code`writeLine(colors.text.heading.secondary(\"Global Options:\"));`}\n                <hbr />\n                <HelpOptions options={this.options} />\n                {code`writeLine(\"\"); `}\n                <hbr />\n                <hbr />\n                <Show when={Object.keys(this.commands).length > 0}>\n                  {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n                  writeLine(\"\"); `}\n                  <hbr />\n                  <hbr />\n                  <For\n                    each={Object.values(this.commands)}\n                    doubleHardline\n                    joiner={code`writeLine(\"\"); `}\n                    ender={code`writeLine(\"\"); `}>\n                    {child => (\n                      <>\n                        {code`\n                writeLine(colors.text.heading.primary(\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n                        <hbr />\n                        <Help command={child} indent={2} />\n                        <hbr />\n                      </>\n                    )}\n                  </For>\n                  {code`help(\"Running a specific command with the help flag (via: '${getAppBin(this)} <specific command> --help') will provide additional information that is specific to that command.\");\n                  writeLine(\"\");`}\n                </Show>\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-script",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "A Shell Shock preset that generates a fully-featured script application.",
   "repository": {
@@ -251,23 +251,23 @@
   "dependencies": {
     "@alloy-js/core": "0.22.0",
     "@alloy-js/typescript": "^0.22.0",
-    "@powerlines/deepkit": "^0.6.43",
-    "@powerlines/plugin-alloy": "^0.20.6",
-    "@powerlines/plugin-plugin": "^0.12.214",
-    "@shell-shock/core": "^0.4.0",
-    "@shell-shock/plugin-theme": "^0.0.8",
+    "@powerlines/deepkit": "^0.6.46",
+    "@powerlines/plugin-alloy": "^0.20.9",
+    "@powerlines/plugin-plugin": "^0.12.217",
+    "@shell-shock/core": "^0.4.2",
+    "@shell-shock/plugin-theme": "^0.0.10",
     "@stryke/path": "^0.26.4",
     "@stryke/string-format": "^0.13.7",
     "@stryke/type-checks": "^0.5.23",
     "defu": "^6.1.4",
-    "powerlines": "^0.38.30",
+    "powerlines": "^0.38.33",
     "@stryke/helpers": "0.9.40"
   },
   "devDependencies": {
     "@babel/core": "^7.29.0",
-    "@powerlines/plugin-alloy": "^0.20.6",
-    "@types/node": "^22.19.7"
+    "@powerlines/plugin-alloy": "^0.20.9",
+    "@types/node": "^22.19.8"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "ad8f1104e63a42de787eb5c5ec5c57e27f8a682e"
+  "gitHead": "93f7eadb6fb5670226a117c04e7e8b505554d76d"
 }