@shell-shock/preset-cli 0.8.4 → 0.8.5

package/dist/index.mjs

@@ -1,16 +1,19 @@
 import { plugin as plugin$1 } from "./plugin-help/dist/index.mjs";
-import { BannerFunctionDeclaration } from "./components/banner-function-declaration.mjs";
+import { BannerBuiltin } from "./components/banner-builtin.mjs";
 import { CommandRouter } from "./components/command-router.mjs";
 import { VirtualCommandEntry } from "./components/virtual-command-entry.mjs";
 import { CommandEntry } from "./components/command-entry.mjs";
 import { UpgradeBuiltin } from "./components/upgrade-builtin.mjs";
+import "./components/index.mjs";
 import { getDefaultOptions } from "./helpers/get-default-options.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
-import { For, Show, code } from "@alloy-js/core";
+import { For, Show, code, computed } from "@alloy-js/core";
 import { VarDeclaration } from "@alloy-js/typescript";
 import { Spacing } from "@powerlines/plugin-alloy/core/components";
 import { render } from "@powerlines/plugin-alloy/render";
+import { getAppDescription, getAppName, getAppTitle, getCommandList } from "@shell-shock/core/plugin-utils";
 import console from "@shell-shock/plugin-console";
+import { joinPaths } from "@stryke/path";
 import prompts from "@shell-shock/plugin-prompts";
 import upgrade from "@shell-shock/plugin-upgrade";
 import { BinEntry } from "@shell-shock/preset-script/components/bin-entry";
@@ -41,8 +44,38 @@ const plugin = (options = {}) => {
 			prepare: {
 				order: "post",
 				async handler() {
-					this.debug("Rendering upgrade built-in module.");
-					return render(this, createComponent(UpgradeBuiltin, {}));
+					this.debug("Rendering built-in modules.");
+					const commands = await getCommandList(this);
+					this.debug(`Rendering \`banner\` built-ins for each of the ${commands.length} command modules.`);
+					const bin = computed(() => ({
+						id: "",
+						name: getAppName(this),
+						title: getAppTitle(this),
+						description: getAppDescription(this),
+						isVirtual: true,
+						path: null,
+						segments: [],
+						alias: [],
+						options: Object.fromEntries(this.options.map((option) => [option.name, option])),
+						entry: { file: joinPaths(this.entryPath, "bin.ts") },
+						args: [],
+						parent: null,
+						children: this.commands
+					}));
+					return render(this, [
+						createComponent(UpgradeBuiltin, {}),
+						createComponent(BannerBuiltin, { get command() {
+							return bin.value;
+						} }),
+						createComponent(Spacing, {}),
+						createComponent(For, {
+							get each() {
+								return commands.sort((a, b) => a.name.localeCompare(b.name));
+							},
+							doubleHardline: true,
+							children: (command) => createComponent(BannerBuiltin, { command })
+						})
+					]);
 				}
 			}
 		},
@@ -86,9 +119,6 @@ const plugin = (options = {}) => {
 							env: ["env", "paths"],
 							upgrade: ["executeUpgrade"]
 						},
-						get prefix() {
-							return [createComponent(BannerFunctionDeclaration, {}), createComponent(Spacing, {})];
-						},
 						get children() {
 							return [
 								createComponent(Show, {
@@ -115,7 +145,7 @@ const plugin = (options = {}) => {
 									}
 								}),
 								createIntrinsic("hbr", {}),
-								code`await banner(0);`,
+								code`await showBanner(0);`,
 								createComponent(Spacing, {}),
 								code`return showHelp(); `
 							];

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"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 { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport prompts from \"@shell-shock/plugin-prompts\";\nimport upgrade from \"@shell-shock/plugin-upgrade\";\nimport { BinEntry } from \"@shell-shock/preset-script/components/bin-entry\";\nimport type { Plugin } from \"powerlines\";\nimport { BannerFunctionDeclaration } from \"./components/banner-function-declaration\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { UpgradeBuiltin } from \"./components/upgrade-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { CLIPresetContext, CLIPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock CLI Preset plugin.\n *\n * @remarks\n * This preset includes a set of built-in modules and commands to create a CLI application, as well as configuration options to customize the generated code. It also includes the `prompts` plugin to provide interactive prompts in the CLI application, and the `upgrade` plugin to manage upgrading the local application's version.\n */\nexport const plugin = <TContext extends CLIPresetContext = CLIPresetContext>(\n  options: CLIPresetOptions = {}\n): Plugin<TContext>[] => {\n  return [\n    ...console<TContext>(options),\n    ...help<TContext>(options),\n    ...prompts<TContext>(options),\n    upgrade<TContext>(options),\n    {\n      name: \"shell-shock:cli-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `cli` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Rendering upgrade built-in module.\");\n\n          return render(this, <UpgradeBuiltin />);\n        }\n      }\n    },\n    {\n      name: \"shell-shock:cli-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `cli` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"info\",\n                    \"debug\",\n                    \"warn\",\n                    \"help\",\n                    \"error\",\n                    \"cursor\",\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"colors\"\n                  ],\n                  utils: [\n                    \"useApp\",\n                    \"useArgs\",\n                    \"isMinimal\",\n                    \"isInteractive\",\n                    \"isHelp\"\n                  ],\n                  prompts: [\n                    \"text\",\n                    \"numeric\",\n                    \"toggle\",\n                    \"select\",\n                    \"confirm\",\n                    \"isCancel\"\n                  ],\n                  env: [\"env\", \"paths\"],\n                  upgrade: [\"executeUpgrade\"]\n                }}\n                prefix={\n                  <>\n                    <BannerFunctionDeclaration />\n                    <Spacing />\n                  </>\n                }>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    let\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <hbr />\n                {code`await banner(0);`}\n                <Spacing />\n                {code`return showHelp(); `}\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  ];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAW,UAAoB,UAAA,EAAA,KAAA;AAC7B,QAAO;EAAC,GAAA,QAAe,QAAA;EAAA,GAAA,SAAA,QAAA;EAAA,GAAA,QAAA,QAAA;EAAA,QAAA,QAAA;EAAA;GACvB,MAAO;GACL,SAAG;AACD,SAAK,MAAC,oEAAkB;AACxB,WAAC;KACH,gBAAkB;KAClB,iBAAA;KACE,GAAK;KACL;;GAEF,SAAO;IACL,OAAG;;AAED,UAAA,MAAO,qCAAA;AACP,YAAE,OAAA,MAAgB,gBAAiB,gBAAA,EAAA,CAAA,CAAA;;IAEtC;GACF;EAAE;GACD,MAAG;GACH,SAAS;IACP,OAAO;IACP,MAAE,UAAc;KACd,MAAM,SAAQ;;AAEd,YAAE,OAAO,MAAW,CAAC,gBAAkB,UAAE;MACzC,gBAAA;OACF,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACQ,KAAC,CAAK,OAAO,QAAI;OACvB,SAAS,CAAA,iBAAA;OACP;MACA,IAAM,SAAS;AACb,cAAK,CAAK,gBAAA,2BAAA,EAAA,CAAA,EAAA,gBAAA,SAAA,EAAA,CAAA,CAAA;;MAEV,IAAC,WAAA;;;SAED,IAAO,OAAM;AACP,iBAAA,OAAA,KAAA,OAAA,SAAA,CAAA,SAAA;;SAEF,IAAC,WAAA;AACC,iBAAA;WAAA,gBAAgB,gBAAA;YACd,OAAO;YACP,MAAG;YACH,MAAG;YACH,aAAQ,IAAA;YACT,CAAC;WAAE,gBAAM,OAAA,EAAA,CAAA;WAAA,gBAAA,eAAA;YACR,UAAS,EAAA;YACT,IAAG,WAAO;AACR,oBAAC,OAAQ,YAAA,EAAA;;YAEZ,CAAC;WAAE,gBAAW,OAAA,EAAA,CAAA;WAAA;;SAElB,CAAC;QAAE,gBAAW,OAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAElB,CAAC,EAAE,gBAAa,MAAA;MACf,IAAI,OAAO;AACT,cAAO,OAAE,OAAQ,OAAA,SAAA,CAAA,SAAA;;MAEnB,IAAI,WAAO;AACT,cAAO,gBAAQ,KAAA;QACb,IAAI,OAAC;AACH,gBAAE,OAAS,OAAA,OAAA,SAAA;;QAEb,gBAAe;QACf,WAAO,UAAO,gBAAA,MAAA;SACZ,IAAI,OAAO;AACT,iBAAG,MAAQ;;SAEb,IAAG,WAAA;AACD,iBAAO,gBAAc,cAAA,EACrB,SAAW,OACZ,CAAA;;SAED,IAAG,WAAA;AACD,iBAAG,gBAAA,qBAA2B,EAC5B,SAAS,OACV,CAAC;;SAEL,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}
+{"version":3,"file":"index.mjs","names":[],"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, computed, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getCommandList\n} from \"@shell-shock/core/plugin-utils\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport prompts from \"@shell-shock/plugin-prompts\";\nimport upgrade from \"@shell-shock/plugin-upgrade\";\nimport { BinEntry } from \"@shell-shock/preset-script/components/bin-entry\";\nimport { joinPaths } from \"@stryke/path\";\nimport type { Plugin } from \"powerlines\";\nimport { BannerBuiltin } from \"./components\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { UpgradeBuiltin } from \"./components/upgrade-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { CLIPresetContext, CLIPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock CLI Preset plugin.\n *\n * @remarks\n * This preset includes a set of built-in modules and commands to create a CLI application, as well as configuration options to customize the generated code. It also includes the `prompts` plugin to provide interactive prompts in the CLI application, and the `upgrade` plugin to manage upgrading the local application's version.\n */\nexport const plugin = <TContext extends CLIPresetContext = CLIPresetContext>(\n  options: CLIPresetOptions = {}\n): Plugin<TContext>[] => {\n  return [\n    ...console<TContext>(options),\n    ...help<TContext>(options),\n    ...prompts<TContext>(options),\n    upgrade<TContext>(options),\n    {\n      name: \"shell-shock:cli-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `cli` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Rendering built-in modules.\");\n\n          const commands = await getCommandList(this);\n          this.debug(\n            `Rendering \\`banner\\` built-ins for each of the ${\n              commands.length\n            } command modules.`\n          );\n\n          const bin = computed(() => ({\n            id: \"\",\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            isVirtual: true,\n            path: null,\n            segments: [],\n            alias: [],\n            options: Object.fromEntries(\n              this.options.map(option => [option.name, option])\n            ),\n            entry: {\n              file: joinPaths(this.entryPath, \"bin.ts\")\n            },\n            args: [],\n            parent: null,\n            children: this.commands\n          }));\n\n          return render(\n            this,\n            <>\n              <UpgradeBuiltin />\n              <BannerBuiltin command={bin.value} />\n              <Spacing />\n              <For\n                each={commands.sort((a, b) => a.name.localeCompare(b.name))}\n                doubleHardline>\n                {command => <BannerBuiltin command={command} />}\n              </For>\n            </>\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:cli-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `cli` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"info\",\n                    \"debug\",\n                    \"warn\",\n                    \"help\",\n                    \"error\",\n                    \"cursor\",\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"colors\"\n                  ],\n                  utils: [\n                    \"useApp\",\n                    \"useArgs\",\n                    \"isMinimal\",\n                    \"isInteractive\",\n                    \"isHelp\"\n                  ],\n                  prompts: [\n                    \"text\",\n                    \"numeric\",\n                    \"toggle\",\n                    \"select\",\n                    \"confirm\",\n                    \"isCancel\"\n                  ],\n                  env: [\"env\", \"paths\"],\n                  upgrade: [\"executeUpgrade\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    let\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <hbr />\n                {code`await showBanner(0);`}\n                <Spacing />\n                {code`return showHelp(); `}\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  ];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,MAAC,UAAA,UAAA,EAAA,KAAA;AACC,QAAE;EAAA,GAAA,QAAA,QAAA;EAAA,GAAA,SAAA,QAAA;EAAA,GAAA,QAAA,QAAA;EAAA,QAAA,QAAA;EAAA;GACD,MAAK;GACN,SAAA;AACI,SAAC,MAAM,oEAA+D;AAC1E,WAAS;KACR,gBAAqB;KAChB,iBAAC;KACF,GAAA;KACA;;GAEH,SAAQ;IACR,OAAA;IACE,MAAM,UAAO;AACb,UAAO,MAAE,8BAAA;KACP,MAAK,WAAK,MAAA,eAAA,KAAA;AACV,UAAG,MAAA,kDAA0D,SAAO,OAAA,mBAAA;KACpE,MAAC,MAAA,gBAAA;;MAED,MAAO,WAAA,KAAA;MACL,OAAA,YAAgB,KAAA;MAChB,aAAA,kBAAsB,KAAA;MACtB,WAAG;MACJ,MAAA;MACF,UAAA,EAAA;MACD,OAAS,EAAA;MACP,SAAQ,OAAK,YAAA,KAAA,QAAA,KAAA,WAAA,CAAA,OAAA,MAAA,OAAA,CAAA,CAAA;MACb,OAAM,EACJ,MAAK,UAAO,KAAU,WAAS,SAAU;MAEzC,MAAM,EAAA;MACN,QAAK;MACL,UAAG,KAAY;MAChB,EAAE;AACH,YAAM,OAAQ,MAAA;MAAO,gBAAC,gBAAA,EAAA,CAAA;MAAA,gBAAA,eAAA,EACpB,IAAC,UAAA;;SAGF,CAAC;MAAE,gBAAM,SAAA,EAAA,CAAA;MAAA,gBAAA,KAAA;OACR,IAAE,OAAM;AACN,eAAO,SAAA,MAAY,GAAK,MAAA,EAAA,KAAA,cAAA,EAAA,KAAA,CAAA;;OAE1B,gBAAa;OACb,WAAQ,YAAI,gBAAA,eAAA,EACD,SACV,CAAC;OACH,CAAC;MAAC,CAAC;;IAEP;GACF;EAAE;GACD,MAAM;GACN,SAAS;IACP,OAAM;IACN,MAAM,UAAQ;KACZ,MAAI,SAAU;AACd,UAAK,MAAA,iEAAA;;MAEH,gBAAa;OACX,SAAI;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACJ,OAAC;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,SAAG;QAAA;QAAe;QAAC;QAAA;QAAA;QAAA;QAAA;OACnB,KAAG,CAAA,OAAA,QAAc;OACjB,SAAG,CAAO,iBAAE;OACb;MACD,IAAI,WAAQ;AACV,cAAI;QAAA,gBAAc,MAAA;SAChB,IAAG,OAAQ;AACT,iBAAG,OAAA,KAAA,OAAA,SAAA,CAAA,SAAA;;SAER,IAAA,WAAA;AACH,iBAAA;WAAA,gBAAA,gBAAA;YACF,OAAA;YACD,MAAA;YACD,MAAA;YACc,aAAW,IAAM;YACpB,CAAA;WAAA,gBAAA,OAAA,EAAA,CAAA;WAAA,gBAAA,eAAA;YACC,UAAK,EAAA;YACP,IAAQ,WAAE;AACJ,oBAAA,OAAA,YAAA,EAAA;;YAET,CAAA;WAAA,gBAAA,OAAA,EAAA,CAAA;WAAA;;SAED,CAAA;QAAM,gBAAO,OAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAEd,CAAC,EAAE,gBAAC,MAAA;MACH,IAAI,OAAC;AACH,cAAI,OAAA,OAAgB,OAAA,SAAA,CAAA,SAAA;;MAEtB,IAAI,WAAW;AACb,cAAO,gBAAQ,KAAA;QACb,IAAI,OAAO;AACT,gBAAK,OAAK,OAAA,OAAA,SAAA;;QAEZ,gBAAc;QACd,WAAO,UAAQ,gBAAA,MAAA;SACb,IAAI,OAAC;AACH,iBAAG,MAAU;;SAEf,IAAI,WAAO;AACT,iBAAC,gBAAA,cAAA,EACD,SAAO,OACN,CAAC;;SAEJ,IAAI,WAAW;AACb,iBAAG,gBAAc,qBAAA,EACf,SAAO,OACR,CAAA;;SAEJ,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}

package/dist/plugin-banner/dist/components/banner-builtin.cjs

@@ -0,0 +1,63 @@
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_banner_function_declaration = require('./banner-function-declaration.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
+let _stryke_path = require("@stryke/path");
+
+//#region ../plugin-banner/dist/components/banner-builtin.mjs
+/**
+* A built-in banner module for Shell Shock.
+*/
+function BannerBuiltin(props) {
+	const [{ command, children }, rest] = (0, _alloy_js_core.splitProps)(props, ["command", "children"]);
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
+		get id() {
+			return (0, _stryke_path.joinPaths)("banner", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)));
+		},
+		get description() {
+			return (0, _alloy_js_core_jsx_runtime.memo)(() => !!command.path)() ? `A collection of utility functions that assist in displaying banner information for the ${command.title} command.` : `A collection of utility functions that assist in displaying banner information for the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} command-line interface application.`;
+		}
+	}, rest, {
+		get builtinImports() {
+			return (0, defu.default)(rest.builtinImports ?? {}, {
+				utils: [
+					"isUnicodeSupported",
+					"useApp",
+					"hasFlag",
+					"isMinimal",
+					"sleep",
+					"isInteractive",
+					"isHelp"
+				],
+				console: [
+					"splitText",
+					"writeLine",
+					"colors",
+					"help",
+					"table",
+					"stripAnsi"
+				]
+			});
+		},
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return Boolean(children);
+				},
+				get fallback() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(require_banner_function_declaration.BannerFunctionDeclaration, { command });
+				},
+				children
+			});
+		}
+	}));
+}
+
+//#endregion
+exports.BannerBuiltin = BannerBuiltin;

package/dist/plugin-banner/dist/components/banner-builtin.mjs

@@ -0,0 +1,62 @@
+import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
+import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Show, splitProps } from "@alloy-js/core";
+import { getAppTitle, isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import defu from "defu";
+import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+import { joinPaths } from "@stryke/path";
+
+//#region ../plugin-banner/dist/components/banner-builtin.mjs
+/**
+* A built-in banner module for Shell Shock.
+*/
+function BannerBuiltin(props) {
+	const [{ command, children }, rest] = splitProps(props, ["command", "children"]);
+	const context = usePowerlines();
+	return createComponent(BuiltinFile, mergeProps({
+		get id() {
+			return joinPaths("banner", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)));
+		},
+		get description() {
+			return memo(() => !!command.path)() ? `A collection of utility functions that assist in displaying banner information for the ${command.title} command.` : `A collection of utility functions that assist in displaying banner information for the ${getAppTitle(context, true)} command-line interface application.`;
+		}
+	}, rest, {
+		get builtinImports() {
+			return defu(rest.builtinImports ?? {}, {
+				utils: [
+					"isUnicodeSupported",
+					"useApp",
+					"hasFlag",
+					"isMinimal",
+					"sleep",
+					"isInteractive",
+					"isHelp"
+				],
+				console: [
+					"splitText",
+					"writeLine",
+					"colors",
+					"help",
+					"table",
+					"stripAnsi"
+				]
+			});
+		},
+		get children() {
+			return createComponent(Show, {
+				get when() {
+					return Boolean(children);
+				},
+				get fallback() {
+					return createComponent(BannerFunctionDeclaration, { command });
+				},
+				children
+			});
+		}
+	}));
+}
+
+//#endregion
+export { BannerBuiltin };
+//# sourceMappingURL=banner-builtin.mjs.map

package/dist/plugin-banner/dist/components/banner-builtin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-builtin.mjs","names":[],"sources":["../../../../../plugin-banner/dist/components/banner-builtin.mjs"],"sourcesContent":["import { BannerFunctionDeclaration } from \"./banner-function-declaration.mjs\";\nimport { createComponent, memo, mergeProps } from \"@alloy-js/core/jsx-runtime\";\nimport { Show, splitProps } from \"@alloy-js/core\";\nimport { getAppTitle, isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { joinPaths } from \"@stryke/path\";\nimport defu from \"defu\";\n\n//#region src/components/banner-builtin.tsx\n/**\n* A built-in banner module for Shell Shock.\n*/\nfunction BannerBuiltin(props) {\n\tconst [{ command, children }, rest] = splitProps(props, [\"command\", \"children\"]);\n\tconst context = usePowerlines();\n\treturn createComponent(BuiltinFile, mergeProps({\n\t\tget id() {\n\t\t\treturn joinPaths(\"banner\", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)));\n\t\t},\n\t\tget description() {\n\t\t\treturn memo(() => !!command.path)() ? `A collection of utility functions that assist in displaying banner information for the ${command.title} command.` : `A collection of utility functions that assist in displaying banner information for the ${getAppTitle(context, true)} command-line interface application.`;\n\t\t}\n\t}, rest, {\n\t\tget builtinImports() {\n\t\t\treturn defu(rest.builtinImports ?? {}, {\n\t\t\t\tutils: [\n\t\t\t\t\t\"isUnicodeSupported\",\n\t\t\t\t\t\"useApp\",\n\t\t\t\t\t\"hasFlag\",\n\t\t\t\t\t\"isMinimal\",\n\t\t\t\t\t\"sleep\",\n\t\t\t\t\t\"isInteractive\",\n\t\t\t\t\t\"isHelp\"\n\t\t\t\t],\n\t\t\t\tconsole: [\n\t\t\t\t\t\"splitText\",\n\t\t\t\t\t\"writeLine\",\n\t\t\t\t\t\"colors\",\n\t\t\t\t\t\"help\",\n\t\t\t\t\t\"table\",\n\t\t\t\t\t\"stripAnsi\"\n\t\t\t\t]\n\t\t\t});\n\t\t},\n\t\tget children() {\n\t\t\treturn createComponent(Show, {\n\t\t\t\tget when() {\n\t\t\t\t\treturn Boolean(children);\n\t\t\t\t},\n\t\t\t\tget fallback() {\n\t\t\t\t\treturn createComponent(BannerFunctionDeclaration, { command });\n\t\t\t\t},\n\t\t\t\tchildren\n\t\t\t});\n\t\t}\n\t}));\n}\n\n//#endregion\nexport { BannerBuiltin };\n//# sourceMappingURL=banner-builtin.mjs.map"],"mappings":";;;;;;;;;;;;;AAaA,SAAS,cAAc,OAAO;CAC7B,MAAM,CAAC,EAAE,SAAS,YAAY,QAAQ,WAAW,OAAO,CAAC,WAAW,WAAW,CAAC;CAChF,MAAM,UAAU,eAAe;AAC/B,QAAO,gBAAgB,aAAa,WAAW;EAC9C,IAAI,KAAK;AACR,UAAO,UAAU,UAAU,GAAG,QAAQ,SAAS,QAAQ,YAAY,CAAC,qBAAqB,QAAQ,CAAC,CAAC;;EAEpG,IAAI,cAAc;AACjB,UAAO,WAAW,CAAC,CAAC,QAAQ,KAAK,EAAE,GAAG,0FAA0F,QAAQ,MAAM,aAAa,0FAA0F,YAAY,SAAS,KAAK,CAAC;;EAEjR,EAAE,MAAM;EACR,IAAI,iBAAiB;AACpB,UAAO,KAAK,KAAK,kBAAkB,EAAE,EAAE;IACtC,OAAO;KACN;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACD,SAAS;KACR;KACA;KACA;KACA;KACA;KACA;KACA;IACD,CAAC;;EAEH,IAAI,WAAW;AACd,UAAO,gBAAgB,MAAM;IAC5B,IAAI,OAAO;AACV,YAAO,QAAQ,SAAS;;IAEzB,IAAI,WAAW;AACd,YAAO,gBAAgB,2BAA2B,EAAE,SAAS,CAAC;;IAE/D;IACA,CAAC;;EAEH,CAAC,CAAC"}

package/dist/plugin-banner/dist/components/banner-function-declaration.cjs

@@ -0,0 +1,135 @@
+const require_runtime = require('../../../_virtual/_rolldown/runtime.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 _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 _shell_shock_plugin_theme_contexts_theme = require("@shell-shock/plugin-theme/contexts/theme");
+
+//#region ../plugin-banner/dist/components/banner-function-declaration.mjs
+/**
+* A component to generate the `banner` function for a specific command or application.
+*
+* @remarks
+* This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+*/
+function BannerFunctionDeclarationWrapper(props) {
+	const { command, children } = props;
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+		"export": true,
+		async: true,
+		name: "showBanner",
+		get doc() {
+			return `Write the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} command-line interface application banner ${command ? `for the ${command.title} command ` : ""}to the console.`;
+		},
+		parameters: [{
+			name: "sleepTimeoutMs",
+			type: "number",
+			default: 500
+		}],
+		get children() {
+			return [children, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+				condition: _alloy_js_core.code`isInteractive && !isHelp`,
+				children: _alloy_js_core.code`await sleep(sleepTimeoutMs);`
+			})];
+		}
+	});
+}
+/**
+* A component to generate the `banner` function's body for a specific command or application.
+*
+* @remarks
+* This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+*/
+function BannerFunctionBodyDeclaration(props) {
+	const { consoleFnName = "log", variant = "primary", title, header, footer, description, command, children, insertNewlineBeforeCommand = false, insertNewlineBeforeBanner = true, insertNewlineAfterDescription = false } = props;
+	const theme = (0, _shell_shock_plugin_theme_contexts_theme.useTheme)();
+	const bannerPadding = (0, _alloy_js_core.computed)(() => Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.banner.outline[variant].left.length + theme.borderStyles.banner.outline[variant].right.length);
+	const totalPadding = (0, _alloy_js_core.computed)(() => Math.max(theme.padding.banner, 0) * 2 + bannerPadding.value);
+	return [
+		_alloy_js_core.code`
+        if (useApp().get("banner") || hasFlag("no-banner") || hasFlag("hide-banner") || isMinimal) {
+          return;
+        }
+
+        useApp().set("banner", true); `,
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		children,
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			when: insertNewlineBeforeBanner,
+			children: _alloy_js_core.code`writeLine(""); `
+		}),
+		(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`
+      writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].topLeft}") + ${theme.icons.banner.header[variant] ? `colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].top}".repeat(6)) + " " + ${theme.icons.banner.header[variant] ? `colors.text.banner.header.${variant}("${theme.icons.banner.header[variant]}") + " " + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].top}") + " " +` : ""} colors.bold(colors.text.banner.header.${variant}("${header}")) + " " + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].top}".repeat(Math.max(process.stdout.columns - ${6 + (theme.icons.banner.header[variant] ? theme.icons.banner.header[variant].length + 3 : 0) + (header ? header.length + 2 : 0) + bannerPadding.value}, 0)))` : `colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].top}".repeat(Math.max(process.stdout.columns - ${bannerPadding.value}, 0)))`} + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].topRight}"), { consoleFn: console.${consoleFnName} });
+
+        splitText(
+          ${title ? `"${title}"` : "title"},
+          Math.max(process.stdout.columns - ${totalPadding.value}, 0)
+        ).forEach((line) => {
+          writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].left}") + " ".repeat(Math.max(Math.floor((process.stdout.columns - (stripAnsi(line).length + ${bannerPadding.value})) / 2), 0)) + colors.bold(colors.text.banner.title.${variant}(line)) + " ".repeat(Math.max(Math.ceil((process.stdout.columns - (stripAnsi(line).length + ${bannerPadding.value})) / 2), 0)) + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].right}"), { consoleFn: console.${consoleFnName} });
+        });
+
+        ${command?.title ? `${insertNewlineBeforeCommand ? `writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].left}") + " ".repeat(Math.max(process.stdout.columns - ${bannerPadding.value})) + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].right}"), { consoleFn: console.${consoleFnName} }); ` : ""}
+            ${`writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].left}") + " ".repeat(Math.max(Math.floor((process.stdout.columns - (stripAnsi("${command.title}").length ${command.icon ? " + 3" : ""} + ${bannerPadding.value})) / 2), 0)) + colors.bold(colors.text.banner.command.${variant}("${command.icon ? `${command.icon}  ` : ""}${command.title}")) + " ".repeat(Math.max(Math.ceil((process.stdout.columns - (stripAnsi("${command.title}").length ${command.icon ? " + 3" : ""} + ${bannerPadding.value})) / 2), 0)) + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].right}"), { consoleFn: console.${consoleFnName} }); `} ` : ""}
+
+        splitText(
+          colors.bold(${command?.title ? "colors.text.banner.description" : "colors.text.banner.command"}.${variant}("${description.replace(/"/g, "\\\"")}")),
+          Math.max(process.stdout.columns - ${totalPadding.value}, 0)
+        ).forEach((line) => {
+          writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].left}") + " ".repeat(Math.max(Math.floor((process.stdout.columns - (stripAnsi(line).length + ${bannerPadding.value})) / 2), 0)) + colors.text.banner.description.${variant}(line) + " ".repeat(Math.max(Math.ceil((process.stdout.columns - (stripAnsi(line).length + ${bannerPadding.value})) / 2), 0)) + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].right}"), { consoleFn: console.${consoleFnName} });
+        });
+        ${insertNewlineAfterDescription ? `writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].left}") + " ".repeat(Math.max(process.stdout.columns - ${bannerPadding.value})) + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].right}"), { consoleFn: console.${consoleFnName} });` : ""}
+        writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottomLeft}") + ${footer ? `colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottom}".repeat(Math.max(process.stdout.columns - ${8 + (footer ? footer.length : 0) + bannerPadding.value}, 0))) + " " + ${footer ? `colors.bold(colors.text.banner.footer.${variant}("${footer}"))` : ""} + " " + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottom}".repeat(6))` : `colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottom}".repeat(Math.max(process.stdout.columns - ${bannerPadding.value}, 0)))`} + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottomRight}"), { consoleFn: console.${consoleFnName} });
+
+        writeLine(""); `)
+	];
+}
+/**
+* A component to generate the `banner` function for a specific command or application.
+*
+* @remarks
+* This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+*/
+function BannerFunctionDeclaration(props) {
+	const { consoleFnName = "log", variant = "primary", command, children, insertNewlineBeforeBanner = true } = props;
+	const theme = (0, _shell_shock_plugin_theme_contexts_theme.useTheme)();
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const header = (0, _alloy_js_core.computed)(() => `${theme.labels.banner.header[variant] || (0, _shell_shock_core_plugin_utils.getAppTitle)(context, false)} v${context.packageJson.version || "1.0.0"}`);
+	const footer = (0, _alloy_js_core.computed)(() => theme.labels.banner.footer[variant]);
+	const title = (0, _alloy_js_core.computed)(() => (0, _shell_shock_core_plugin_utils.getAppTitle)(context, true).replace(`v${context.packageJson.version || "1.0.0"}`, ""));
+	const description = (0, _alloy_js_core.computed)(() => command?.description || (0, _shell_shock_core_plugin_utils.getAppDescription)(context));
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(BannerFunctionDeclarationWrapper, {
+		command,
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(BannerFunctionBodyDeclaration, {
+				get title() {
+					return title.value;
+				},
+				get header() {
+					return header.value;
+				},
+				get description() {
+					return description.value;
+				},
+				get footer() {
+					return footer.value;
+				},
+				variant,
+				consoleFnName,
+				command,
+				insertNewlineBeforeCommand: true,
+				insertNewlineBeforeBanner,
+				children
+			});
+		}
+	});
+}
+
+//#endregion
+exports.BannerFunctionBodyDeclaration = BannerFunctionBodyDeclaration;
+exports.BannerFunctionDeclaration = BannerFunctionDeclaration;
+exports.BannerFunctionDeclarationWrapper = BannerFunctionDeclarationWrapper;

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

@@ -0,0 +1,45 @@
+import { Children } from "@alloy-js/core";
+import { CommandTree } from "@shell-shock/core/types/command";
+import { ThemeColorVariant } from "@shell-shock/plugin-theme/types/theme";
+
+//#region ../plugin-banner/dist/components/banner-function-declaration.d.cts
+//#region src/components/banner-function-declaration.d.ts
+interface BannerFunctionDeclarationWrapperProps {
+  command?: CommandTree;
+  children?: Children;
+}
+/**
+ * A component to generate the `banner` function for a specific command or application.
+ *
+ * @remarks
+ * This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+ */
+interface BannerFunctionBodyDeclarationProps extends BannerFunctionDeclarationProps {
+  title?: string;
+  header?: string;
+  footer?: string;
+  description: string;
+  insertNewlineBeforeCommand?: boolean;
+  insertNewlineBeforeBanner?: boolean;
+  insertNewlineAfterDescription?: boolean;
+}
+/**
+ * A component to generate the `banner` function's body for a specific command or application.
+ *
+ * @remarks
+ * This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+ */
+interface BannerFunctionDeclarationProps extends BannerFunctionDeclarationWrapperProps {
+  variant?: ThemeColorVariant;
+  consoleFnName?: "log" | "info" | "warn" | "error" | "debug";
+  insertNewlineBeforeBanner?: boolean;
+}
+/**
+ * A component to generate the `banner` function for a specific command or application.
+ *
+ * @remarks
+ * This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+ */
+//#endregion
+export { BannerFunctionBodyDeclarationProps };
+//# sourceMappingURL=banner-function-declaration.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner-function-declaration.d.cts","names":["Children","CommandTree","ThemeColorVariant","BannerFunctionDeclarationWrapperProps","command","children","BannerFunctionDeclarationWrapper","props","BannerFunctionBodyDeclarationProps","BannerFunctionDeclarationProps","title","header","footer","description","insertNewlineBeforeCommand","insertNewlineBeforeBanner","insertNewlineAfterDescription","BannerFunctionBodyDeclaration","variant","consoleFnName","BannerFunctionDeclaration"],"sources":["../../../../../plugin-banner/dist/components/banner-function-declaration.d.cts"],"mappings":";;;;;;UAKUG,qCAAAA;EACRC,OAAAA,GAAUH,WAAAA;EACVI,QAAAA,GAAWL,QAAAA;AAAAA;;;;;;;UASHQ,kCAAAA,SAA2CC,8BAAAA;EACnDC,KAAAA;EACAC,MAAAA;EACAC,MAAAA;EACAC,WAAAA;EACAC,0BAAAA;EACAC,yBAAAA;EACAC,6BAAAA;AAAAA;;;;;AAQiG;;UACzFP,8BAAAA,SAAuCN,qCAAAA;EAC/Ce,OAAAA,GAAUhB,iBAAAA;EACViB,aAAAA;EACAJ,yBAAAA;AAAAA"}

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

@@ -0,0 +1,45 @@
+import { Children } from "@alloy-js/core";
+import { CommandTree } from "@shell-shock/core/types/command";
+import { ThemeColorVariant } from "@shell-shock/plugin-theme/types/theme";
+
+//#region ../plugin-banner/dist/components/banner-function-declaration.d.cts
+//#region src/components/banner-function-declaration.d.ts
+interface BannerFunctionDeclarationWrapperProps {
+  command?: CommandTree;
+  children?: Children;
+}
+/**
+ * A component to generate the `banner` function for a specific command or application.
+ *
+ * @remarks
+ * This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+ */
+interface BannerFunctionBodyDeclarationProps extends BannerFunctionDeclarationProps {
+  title?: string;
+  header?: string;
+  footer?: string;
+  description: string;
+  insertNewlineBeforeCommand?: boolean;
+  insertNewlineBeforeBanner?: boolean;
+  insertNewlineAfterDescription?: boolean;
+}
+/**
+ * A component to generate the `banner` function's body for a specific command or application.
+ *
+ * @remarks
+ * This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+ */
+interface BannerFunctionDeclarationProps extends BannerFunctionDeclarationWrapperProps {
+  variant?: ThemeColorVariant;
+  consoleFnName?: "log" | "info" | "warn" | "error" | "debug";
+  insertNewlineBeforeBanner?: boolean;
+}
+/**
+ * A component to generate the `banner` function for a specific command or application.
+ *
+ * @remarks
+ * This function will display a banner in the console with the application's name, version, and description. It can be customized with different variants for styling and supports conditional rendering based on flags or environment variables.
+ */
+//#endregion
+export { BannerFunctionBodyDeclarationProps };
+//# sourceMappingURL=banner-function-declaration.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner-function-declaration.d.mts","names":["Children","CommandTree","ThemeColorVariant","BannerFunctionDeclarationWrapperProps","command","children","BannerFunctionDeclarationWrapper","props","BannerFunctionBodyDeclarationProps","BannerFunctionDeclarationProps","title","header","footer","description","insertNewlineBeforeCommand","insertNewlineBeforeBanner","insertNewlineAfterDescription","BannerFunctionBodyDeclaration","variant","consoleFnName","BannerFunctionDeclaration"],"sources":["../../../../../plugin-banner/dist/components/banner-function-declaration.d.cts"],"mappings":";;;;;;UAKUG,qCAAAA;EACRC,OAAAA,GAAUH,WAAAA;EACVI,QAAAA,GAAWL,QAAAA;AAAAA;;;;;;;UASHQ,kCAAAA,SAA2CC,8BAAAA;EACnDC,KAAAA;EACAC,MAAAA;EACAC,MAAAA;EACAC,WAAAA;EACAC,0BAAAA;EACAC,yBAAAA;EACAC,6BAAAA;AAAAA;;;;;AAQiG;;UACzFP,8BAAAA,SAAuCN,qCAAAA;EAC/Ce,OAAAA,GAAUhB,iBAAAA;EACViB,aAAAA;EACAJ,yBAAAA;AAAAA"}