@shell-shock/plugin-banner 0.1.0

package/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 { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+import { joinPaths } from "@stryke/path";
+import defu from "defu";
+
+//#region src/components/banner-builtin.tsx
+/**
+* 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/components/banner-builtin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-builtin.mjs","names":[],"sources":["../../src/components/banner-builtin.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 { Show, splitProps } from \"@alloy-js/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path\";\nimport defu from \"defu\";\nimport type { BannerPluginContext } from \"../types\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\n\nexport type BannerBuiltinProps = Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\n> & {\n  /**\n   * The command to generate the `banner` function declaration for.\n   */\n  command: CommandTree;\n};\n\n/**\n * A built-in banner module for Shell Shock.\n */\nexport function BannerBuiltin(props: BannerBuiltinProps) {\n  const [{ command, children }, rest] = splitProps(props, [\n    \"command\",\n    \"children\"\n  ]);\n  const context = usePowerlines<BannerPluginContext>();\n\n  return (\n    <BuiltinFile\n      id={joinPaths(\n        \"banner\",\n        ...command.segments.filter(segment => !isDynamicPathSegment(segment))\n      )}\n      description={\n        command.path\n          ? `A collection of utility functions that assist in displaying banner information for the ${command.title} command.`\n          : `A collection of utility functions that assist in displaying banner information for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`\n      }\n      {...rest}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        utils: [\n          \"isUnicodeSupported\",\n          \"useApp\",\n          \"hasFlag\",\n          \"isMinimal\",\n          \"sleep\",\n          \"isInteractive\",\n          \"isHelp\"\n        ],\n        console: [\n          \"splitText\",\n          \"writeLine\",\n          \"colors\",\n          \"help\",\n          \"table\",\n          \"stripAnsi\"\n        ]\n      })}>\n      <Show\n        when={Boolean(children)}\n        fallback={<BannerFunctionDeclaration command={command} />}>\n        {children}\n      </Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAuCA,SAAW,cAAW,OAAA;CACrB,MAAA,CAAA,WAEC,YACG,QAAQ,WAAQ,OAAU,CAAC,WAAW,WAAA,CAAA;CACzC,MAAA,UAAA,eAAA;AACF,QAAO,gBAAS,aAAqB,WAAA;EACnC,IAAM,KAAG;AACN,UAAQ,UAAA,UAAA,GAAA,QAAA,SAAA,QAAA,YAAA,CAAA,qBAAA,QAAA,CAAA,CAAA;;EAET,IAAA,cAAA;AACF,UAAM,WAAU,CAAA,CAAA,QAAc,KAAA,EAAA,GAAA,0FAAsB,QAAA,MAAA,aAAA,0FAAA,YAAA,SAAA,KAAA,CAAA;;EAEpD,EAAA,MAAO;EACL,IAAC,iBAAA;AACC,UAAI,KAAA,KAAS,kBAAA,EAAA,EAAA;IACX,OAAO;KAAC;KAAA;KAAA;KAAA;KAAA;KAAA;KAAA;KAAA;IACR,SAAG;KAAO;KAAU;KAAgB;KAAG;KAAA;KAAqB;KAAQ;IACrE,CAAA;;EAEH,IAAI,WAAQ;AACV,UAAO,gBAAgB,MAAQ;IAC7B,IAAI,OAAG;AACL,YAAI,QAAO,SAAA;;IAEb,IAAI,WAAW;AACjB,YAAA,gBAAA,2BAAA,EACQ,SACR,CAAA;;IAEK;IACJ,CAAC;;EAEL,CAAC,CAAC"}

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

@@ -0,0 +1,136 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+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 _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 _alloy_js_typescript = require("@alloy-js/typescript");
+let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _shell_shock_plugin_theme_contexts_theme = require("@shell-shock/plugin-theme/contexts/theme");
+
+//#region src/components/banner-function-declaration.tsx
+/**
+* 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/components/banner-function-declaration.d.cts

@@ -0,0 +1,47 @@
+import { Children } from "@alloy-js/core";
+import { CommandTree } from "@shell-shock/core/types/command";
+import { ThemeColorVariant } from "@shell-shock/plugin-theme/types/theme";
+
+//#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.
+ */
+declare function BannerFunctionDeclarationWrapper(props: BannerFunctionDeclarationWrapperProps): Children;
+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.
+ */
+declare function BannerFunctionBodyDeclaration(props: BannerFunctionBodyDeclarationProps): Children;
+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.
+ */
+declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): Children;
+//#endregion
+export { BannerFunctionBodyDeclaration, BannerFunctionBodyDeclarationProps, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BannerFunctionDeclarationWrapper, BannerFunctionDeclarationWrapperProps };
+//# sourceMappingURL=banner-function-declaration.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner-function-declaration.d.cts","names":[],"sources":["../../src/components/banner-function-declaration.tsx"],"mappings":";;;;;UA6BiB,qCAAA;EACf,OAAA,GAAU,WAAA;EACV,QAAA,GAAW,QAAA;AAAA;;;;;;;iBASG,gCAAA,CACd,KAAA,EAAO,qCAAA,GAAqC,QAAA;AAAA,UAuB7B,kCAAA,SAA2C,8BAAA;EAC1D,KAAA;EACA,MAAA;EACA,MAAA;EACA,WAAA;EACA,0BAAA;EACA,yBAAA;EACA,6BAAA;AAAA;;AAPF;;;;;iBAgBgB,6BAAA,CACd,KAAA,EAAO,kCAAA,GAAkC,QAAA;AAAA,UAqL1B,8BAAA,SAAuC,qCAAA;EACtD,OAAA,GAAU,iBAAA;EACV,aAAA;EACA,yBAAA;AAAA;;;;AAzLF;;;iBAkMgB,yBAAA,CACd,KAAA,EAAO,8BAAA,GAA8B,QAAA"}

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

@@ -0,0 +1,47 @@
+import { Children } from "@alloy-js/core";
+import { CommandTree } from "@shell-shock/core/types/command";
+import { ThemeColorVariant } from "@shell-shock/plugin-theme/types/theme";
+
+//#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.
+ */
+declare function BannerFunctionDeclarationWrapper(props: BannerFunctionDeclarationWrapperProps): Children;
+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.
+ */
+declare function BannerFunctionBodyDeclaration(props: BannerFunctionBodyDeclarationProps): Children;
+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.
+ */
+declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): Children;
+//#endregion
+export { BannerFunctionBodyDeclaration, BannerFunctionBodyDeclarationProps, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BannerFunctionDeclarationWrapper, BannerFunctionDeclarationWrapperProps };
+//# sourceMappingURL=banner-function-declaration.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner-function-declaration.d.mts","names":[],"sources":["../../src/components/banner-function-declaration.tsx"],"mappings":";;;;;UA6BiB,qCAAA;EACf,OAAA,GAAU,WAAA;EACV,QAAA,GAAW,QAAA;AAAA;;;;;;;iBASG,gCAAA,CACd,KAAA,EAAO,qCAAA,GAAqC,QAAA;AAAA,UAuB7B,kCAAA,SAA2C,8BAAA;EAC1D,KAAA;EACA,MAAA;EACA,MAAA;EACA,WAAA;EACA,0BAAA;EACA,yBAAA;EACA,6BAAA;AAAA;;AAPF;;;;;iBAgBgB,6BAAA,CACd,KAAA,EAAO,kCAAA,GAAkC,QAAA;AAAA,UAqL1B,8BAAA,SAAuC,qCAAA;EACtD,OAAA,GAAU,iBAAA;EACV,aAAA;EACA,yBAAA;AAAA;;;;AAzLF;;;iBAkMgB,yBAAA,CACd,KAAA,EAAO,8BAAA,GAA8B,QAAA"}

package/dist/components/banner-function-declaration.mjs

@@ -0,0 +1,133 @@
+import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
+import { Show, code, computed } from "@alloy-js/core";
+import { getAppDescription, getAppTitle } from "@shell-shock/core/plugin-utils";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { useTheme } from "@shell-shock/plugin-theme/contexts/theme";
+
+//#region src/components/banner-function-declaration.tsx
+/**
+* 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 = usePowerlines();
+	return createComponent(FunctionDeclaration, {
+		"export": true,
+		async: true,
+		name: "showBanner",
+		get doc() {
+			return `Write the ${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, createComponent(IfStatement, {
+				condition: code`isInteractive && !isHelp`,
+				children: 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 = useTheme();
+	const bannerPadding = computed(() => Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.banner.outline[variant].left.length + theme.borderStyles.banner.outline[variant].right.length);
+	const totalPadding = computed(() => Math.max(theme.padding.banner, 0) * 2 + bannerPadding.value);
+	return [
+		code`
+        if (useApp().get("banner") || hasFlag("no-banner") || hasFlag("hide-banner") || isMinimal) {
+          return;
+        }
+
+        useApp().set("banner", true); `,
+		createComponent(Spacing, {}),
+		children,
+		createComponent(Spacing, {}),
+		createComponent(Show, {
+			when: insertNewlineBeforeBanner,
+			children: code`writeLine(""); `
+		}),
+		createComponent(Spacing, {}),
+		memo(() => 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 = useTheme();
+	const context = usePowerlines();
+	const header = computed(() => `${theme.labels.banner.header[variant] || getAppTitle(context, false)} v${context.packageJson.version || "1.0.0"}`);
+	const footer = computed(() => theme.labels.banner.footer[variant]);
+	const title = computed(() => getAppTitle(context, true).replace(`v${context.packageJson.version || "1.0.0"}`, ""));
+	const description = computed(() => command?.description || getAppDescription(context));
+	return createComponent(BannerFunctionDeclarationWrapper, {
+		command,
+		get children() {
+			return 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
+export { BannerFunctionBodyDeclaration, BannerFunctionDeclaration, BannerFunctionDeclarationWrapper };
+//# sourceMappingURL=banner-function-declaration.mjs.map

package/dist/components/banner-function-declaration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-function-declaration.mjs","names":[],"sources":["../../src/components/banner-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { getAppDescription, getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport type { ThemeColorVariant } from \"@shell-shock/plugin-theme/types/theme\";\nimport type { BannerPluginContext } from \"../types\";\n\nexport interface BannerFunctionDeclarationWrapperProps {\n  command?: CommandTree;\n  children?: Children;\n}\n\n/**\n * A component to generate the `banner` function for a specific command or application.\n *\n * @remarks\n * 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.\n */\nexport function BannerFunctionDeclarationWrapper(\n  props: BannerFunctionDeclarationWrapperProps\n) {\n  const { command, children } = props;\n\n  const context = usePowerlines<BannerPluginContext>();\n\n  return (\n    <FunctionDeclaration\n      export\n      async\n      name=\"showBanner\"\n      doc={`Write the ${getAppTitle(context, true)} command-line interface application banner ${\n        command ? `for the ${command.title} command ` : \"\"\n      }to the console.`}\n      parameters={[{ name: \"sleepTimeoutMs\", type: \"number\", default: 500 }]}>\n      {children}\n      <IfStatement condition={code`isInteractive && !isHelp`}>\n        {code`await sleep(sleepTimeoutMs);`}\n      </IfStatement>\n    </FunctionDeclaration>\n  );\n}\n\nexport interface BannerFunctionBodyDeclarationProps extends BannerFunctionDeclarationProps {\n  title?: string;\n  header?: string;\n  footer?: string;\n  description: string;\n  insertNewlineBeforeCommand?: boolean;\n  insertNewlineBeforeBanner?: boolean;\n  insertNewlineAfterDescription?: boolean;\n}\n\n/**\n * A component to generate the `banner` function's body for a specific command or application.\n *\n * @remarks\n * 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.\n */\nexport function BannerFunctionBodyDeclaration(\n  props: BannerFunctionBodyDeclarationProps\n) {\n  const {\n    consoleFnName = \"log\",\n    variant = \"primary\",\n    title,\n    header,\n    footer,\n    description,\n    command,\n    children,\n    insertNewlineBeforeCommand = false,\n    insertNewlineBeforeBanner = true,\n    insertNewlineAfterDescription = false\n  } = props;\n\n  const theme = useTheme();\n\n  const bannerPadding = computed(\n    () =>\n      Math.max(theme.padding.app, 0) * 2 +\n      theme.borderStyles.banner.outline[variant].left.length +\n      theme.borderStyles.banner.outline[variant].right.length\n  );\n  const totalPadding = computed(\n    () => Math.max(theme.padding.banner, 0) * 2 + bannerPadding.value\n  );\n\n  return (\n    <>\n      {code`\n        if (useApp().get(\"banner\") || hasFlag(\"no-banner\") || hasFlag(\"hide-banner\") || isMinimal) {\n          return;\n        }\n\n        useApp().set(\"banner\", true); `}\n      <Spacing />\n      {children}\n      <Spacing />\n      <Show when={insertNewlineBeforeBanner}>{code`writeLine(\"\"); `}</Show>\n      <Spacing />\n      {code`\n      writeLine(colors.border.banner.outline.${variant}(\"${\n        theme.borderStyles.banner.outline[variant].topLeft\n      }\") + ${\n        theme.icons.banner.header[variant]\n          ? `colors.border.banner.outline.${variant}(\"${\n              theme.borderStyles.banner.outline[variant].top\n            }\".repeat(6)) + \" \" + ${\n              theme.icons.banner.header[variant]\n                ? `colors.text.banner.header.${variant}(\"${\n                    theme.icons.banner.header[variant]\n                  }\") + \" \" + colors.border.banner.outline.${variant}(\"${\n                    theme.borderStyles.banner.outline[variant].top\n                  }\") + \" \" +`\n                : \"\"\n            } colors.bold(colors.text.banner.header.${variant}(\"${\n              header\n            }\")) + \" \" + colors.border.banner.outline.${variant}(\"${\n              theme.borderStyles.banner.outline[variant].top\n            }\".repeat(Math.max(process.stdout.columns - ${\n              6 +\n              (theme.icons.banner.header[variant]\n                ? theme.icons.banner.header[variant].length + 3\n                : 0) +\n              (header ? header.length + 2 : 0) +\n              bannerPadding.value\n            }, 0)))`\n          : `colors.border.banner.outline.${variant}(\"${\n              theme.borderStyles.banner.outline[variant].top\n            }\".repeat(Math.max(process.stdout.columns - ${\n              bannerPadding.value\n            }, 0)))`\n      } + colors.border.banner.outline.${variant}(\"${\n        theme.borderStyles.banner.outline[variant].topRight\n      }\"), { consoleFn: console.${consoleFnName} });\n\n        splitText(\n          ${title ? `\"${title}\"` : \"title\"},\n          Math.max(process.stdout.columns - ${totalPadding.value}, 0)\n        ).forEach((line) => {\n          writeLine(colors.border.banner.outline.${variant}(\"${\n            theme.borderStyles.banner.outline[variant].left\n          }\") + \" \".repeat(Math.max(Math.floor((process.stdout.columns - (stripAnsi(line).length + ${\n            bannerPadding.value\n          })) / 2), 0)) + colors.bold(colors.text.banner.title.${variant}(line)) + \" \".repeat(Math.max(Math.ceil((process.stdout.columns - (stripAnsi(line).length + ${\n            bannerPadding.value\n          })) / 2), 0)) + colors.border.banner.outline.${variant}(\"${\n            theme.borderStyles.banner.outline[variant].right\n          }\"), { consoleFn: console.${consoleFnName} });\n        });\n\n        ${\n          command?.title\n            ? `${\n                insertNewlineBeforeCommand\n                  ? `writeLine(colors.border.banner.outline.${variant}(\"${\n                      theme.borderStyles.banner.outline[variant].left\n                    }\") + \" \".repeat(Math.max(process.stdout.columns - ${\n                      bannerPadding.value\n                    })) + colors.border.banner.outline.${variant}(\"${\n                      theme.borderStyles.banner.outline[variant].right\n                    }\"), { consoleFn: console.${consoleFnName} }); `\n                  : \"\"\n              }\n            ${`writeLine(colors.border.banner.outline.${variant}(\"${\n              theme.borderStyles.banner.outline[variant].left\n            }\") + \" \".repeat(Math.max(Math.floor((process.stdout.columns - (stripAnsi(\"${\n              command.title\n            }\").length ${command.icon ? \" + 3\" : \"\"} + ${\n              bannerPadding.value\n            })) / 2), 0)) + colors.bold(colors.text.banner.command.${\n              variant\n            }(\"${command.icon ? `${command.icon}  ` : \"\"}${command.title}\")) + \" \".repeat(Math.max(Math.ceil((process.stdout.columns - (stripAnsi(\"${command.title}\").length ${\n              command.icon ? \" + 3\" : \"\"\n            } + ${\n              bannerPadding.value\n            })) / 2), 0)) + colors.border.banner.outline.${variant}(\"${\n              theme.borderStyles.banner.outline[variant].right\n            }\"), { consoleFn: console.${consoleFnName} }); `} `\n            : \"\"\n        }\n\n        splitText(\n          colors.bold(${\n            command?.title\n              ? \"colors.text.banner.description\"\n              : \"colors.text.banner.command\"\n          }.${variant}(\"${description.replace(/\"/g, '\\\\\"')}\")),\n          Math.max(process.stdout.columns - ${totalPadding.value}, 0)\n        ).forEach((line) => {\n          writeLine(colors.border.banner.outline.${variant}(\"${\n            theme.borderStyles.banner.outline[variant].left\n          }\") + \" \".repeat(Math.max(Math.floor((process.stdout.columns - (stripAnsi(line).length + ${\n            bannerPadding.value\n          })) / 2), 0)) + colors.text.banner.description.${variant}(line) + \" \".repeat(Math.max(Math.ceil((process.stdout.columns - (stripAnsi(line).length + ${\n            bannerPadding.value\n          })) / 2), 0)) + colors.border.banner.outline.${variant}(\"${\n            theme.borderStyles.banner.outline[variant].right\n          }\"), { consoleFn: console.${consoleFnName} });\n        });\n        ${\n          insertNewlineAfterDescription\n            ? `writeLine(colors.border.banner.outline.${variant}(\"${\n                theme.borderStyles.banner.outline[variant].left\n              }\") + \" \".repeat(Math.max(process.stdout.columns - ${\n                bannerPadding.value\n              })) + colors.border.banner.outline.${variant}(\"${\n                theme.borderStyles.banner.outline[variant].right\n              }\"), { consoleFn: console.${consoleFnName} });`\n            : \"\"\n        }\n        writeLine(colors.border.banner.outline.${variant}(\"${\n          theme.borderStyles.banner.outline[variant].bottomLeft\n        }\") + ${\n          footer\n            ? `colors.border.banner.outline.${variant}(\"${\n                theme.borderStyles.banner.outline[variant].bottom\n              }\".repeat(Math.max(process.stdout.columns - ${\n                8 + (footer ? footer.length : 0) + bannerPadding.value\n              }, 0))) + \" \" + ${\n                footer\n                  ? `colors.bold(colors.text.banner.footer.${variant}(\"${footer}\"))`\n                  : \"\"\n              } + \" \" + colors.border.banner.outline.${variant}(\"${\n                theme.borderStyles.banner.outline[variant].bottom\n              }\".repeat(6))`\n            : `colors.border.banner.outline.${variant}(\"${\n                theme.borderStyles.banner.outline[variant].bottom\n              }\".repeat(Math.max(process.stdout.columns - ${\n                bannerPadding.value\n              }, 0)))`\n        } + colors.border.banner.outline.${variant}(\"${\n          theme.borderStyles.banner.outline[variant].bottomRight\n        }\"), { consoleFn: console.${consoleFnName} });\n\n        writeLine(\"\"); `}\n    </>\n  );\n}\n\nexport interface BannerFunctionDeclarationProps extends BannerFunctionDeclarationWrapperProps {\n  variant?: ThemeColorVariant;\n  consoleFnName?: \"log\" | \"info\" | \"warn\" | \"error\" | \"debug\";\n  insertNewlineBeforeBanner?: boolean;\n}\n\n/**\n * A component to generate the `banner` function for a specific command or application.\n *\n * @remarks\n * 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.\n */\nexport function BannerFunctionDeclaration(\n  props: BannerFunctionDeclarationProps\n) {\n  const {\n    consoleFnName = \"log\",\n    variant = \"primary\",\n    command,\n    children,\n    insertNewlineBeforeBanner = true\n  } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<BannerPluginContext>();\n\n  const header = computed(\n    () =>\n      `${theme.labels.banner.header[variant] || getAppTitle(context, false)} v${\n        context.packageJson.version || \"1.0.0\"\n      }`\n  );\n  const footer = computed(() => theme.labels.banner.footer[variant]);\n  const title = computed(() =>\n    getAppTitle(context, true).replace(\n      `v${context.packageJson.version || \"1.0.0\"}`,\n      \"\"\n    )\n  );\n  const description = computed(\n    () => command?.description || getAppDescription(context)\n  );\n\n  return (\n    <BannerFunctionDeclarationWrapper command={command}>\n      <BannerFunctionBodyDeclaration\n        title={title.value}\n        header={header.value}\n        description={description.value}\n        footer={footer.value}\n        variant={variant}\n        consoleFnName={consoleFnName}\n        command={command}\n        insertNewlineBeforeCommand\n        insertNewlineBeforeBanner={insertNewlineBeforeBanner}>\n        {children}\n      </BannerFunctionBodyDeclaration>\n    </BannerFunctionDeclarationWrapper>\n  );\n}\n"],"mappings":"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"}

package/dist/components/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_components_banner_function_declaration = require('./banner-function-declaration.cjs');
+const require_components_banner_builtin = require('./banner-builtin.cjs');
+
+exports.BannerBuiltin = require_components_banner_builtin.BannerBuiltin;
+exports.BannerFunctionBodyDeclaration = require_components_banner_function_declaration.BannerFunctionBodyDeclaration;
+exports.BannerFunctionDeclaration = require_components_banner_function_declaration.BannerFunctionDeclaration;
+exports.BannerFunctionDeclarationWrapper = require_components_banner_function_declaration.BannerFunctionDeclarationWrapper;

package/dist/components/index.d.cts

@@ -0,0 +1,3 @@
+import { BannerBuiltin, BannerBuiltinProps } from "./banner-builtin.cjs";
+import { BannerFunctionBodyDeclaration, BannerFunctionBodyDeclarationProps, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BannerFunctionDeclarationWrapper, BannerFunctionDeclarationWrapperProps } from "./banner-function-declaration.cjs";
+export { BannerBuiltin, BannerBuiltinProps, BannerFunctionBodyDeclaration, BannerFunctionBodyDeclarationProps, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BannerFunctionDeclarationWrapper, BannerFunctionDeclarationWrapperProps };

package/dist/components/index.d.mts

@@ -0,0 +1,3 @@
+import { BannerBuiltin, BannerBuiltinProps } from "./banner-builtin.mjs";
+import { BannerFunctionBodyDeclaration, BannerFunctionBodyDeclarationProps, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BannerFunctionDeclarationWrapper, BannerFunctionDeclarationWrapperProps } from "./banner-function-declaration.mjs";
+export { BannerBuiltin, BannerBuiltinProps, BannerFunctionBodyDeclaration, BannerFunctionBodyDeclarationProps, BannerFunctionDeclaration, BannerFunctionDeclarationProps, BannerFunctionDeclarationWrapper, BannerFunctionDeclarationWrapperProps };

package/dist/components/index.mjs

@@ -0,0 +1,4 @@
+import { BannerFunctionBodyDeclaration, BannerFunctionDeclaration, BannerFunctionDeclarationWrapper } from "./banner-function-declaration.mjs";
+import { BannerBuiltin } from "./banner-builtin.mjs";
+
+export { BannerBuiltin, BannerFunctionBodyDeclaration, BannerFunctionDeclaration, BannerFunctionDeclarationWrapper };

package/dist/index.cjs

@@ -0,0 +1,68 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_components_banner_builtin = require('./components/banner-builtin.cjs');
+require('./components/index.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _powerlines_plugin_alloy_core_components = require("@powerlines/plugin-alloy/core/components");
+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_plugin_console = require("@shell-shock/plugin-console");
+_shell_shock_plugin_console = require_runtime.__toESM(_shell_shock_plugin_console);
+let _shell_shock_plugin_theme = require("@shell-shock/plugin-theme");
+_shell_shock_plugin_theme = require_runtime.__toESM(_shell_shock_plugin_theme);
+let _stryke_path_join = require("@stryke/path/join");
+
+//#region src/index.tsx
+/**
+* The Banner - Shell Shock plugin to add a banner command to the application.
+*/
+const plugin = (options = {}) => {
+	return [
+		...(0, _shell_shock_plugin_theme.default)(options.theme),
+		(0, _shell_shock_plugin_console.default)(options.console),
+		{
+			name: "shell-shock:banner",
+			enforce: "post",
+			prepare: {
+				order: "post",
+				async handler() {
+					const commands = await (0, _shell_shock_core_plugin_utils.getCommandList)(this);
+					this.debug(`Rendering \`banner\` built-ins for each of the ${commands.length} command modules.`);
+					const bin = (0, _alloy_js_core.computed)(() => ({
+						id: "",
+						name: (0, _shell_shock_core_plugin_utils.getAppName)(this),
+						title: (0, _shell_shock_core_plugin_utils.getAppTitle)(this),
+						description: (0, _shell_shock_core_plugin_utils.getAppDescription)(this),
+						isVirtual: true,
+						path: null,
+						segments: [],
+						alias: [],
+						options: Object.fromEntries(this.options.map((option) => [option.name, option])),
+						entry: { file: (0, _stryke_path_join.joinPaths)(this.entryPath, "bin.ts") },
+						args: [],
+						parent: null,
+						children: this.commands
+					}));
+					return (0, _powerlines_plugin_alloy_render.render)(this, [
+						(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_banner_builtin.BannerBuiltin, { get command() {
+							return bin.value;
+						} }),
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components.Spacing, {}),
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+							get each() {
+								return commands.sort((a, b) => a.name.localeCompare(b.name));
+							},
+							doubleHardline: true,
+							children: (command) => (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_banner_builtin.BannerBuiltin, { command })
+						})
+					]);
+				}
+			}
+		}
+	];
+};
+
+//#endregion
+exports.default = plugin;
+exports.plugin = plugin;

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import { BannerPluginContext, BannerPluginOptions, BannerPluginResolvedConfig, BannerPluginUserConfig } from "./types/plugin.cjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+/**
+ * The Banner - Shell Shock plugin to add a banner command to the application.
+ */
+declare const plugin: <TContext extends BannerPluginContext = BannerPluginContext>(options?: BannerPluginOptions) => Plugin<TContext>[];
+//#endregion
+export { BannerPluginContext, BannerPluginOptions, BannerPluginResolvedConfig, BannerPluginUserConfig, plugin as default, plugin };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;AAuCA;;cAAa,MAAA,oBACM,mBAAA,GAAsB,mBAAA,EAEvC,OAAA,GAAS,mBAAA,KAqDJ,MAAA,CAAO,QAAA"}

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { BannerPluginContext, BannerPluginOptions, BannerPluginResolvedConfig, BannerPluginUserConfig } from "./types/plugin.mjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+/**
+ * The Banner - Shell Shock plugin to add a banner command to the application.
+ */
+declare const plugin: <TContext extends BannerPluginContext = BannerPluginContext>(options?: BannerPluginOptions) => Plugin<TContext>[];
+//#endregion
+export { BannerPluginContext, BannerPluginOptions, BannerPluginResolvedConfig, BannerPluginUserConfig, plugin as default, plugin };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAuCA;cAAa,MAAA,oBACM,mBAAA,GAAsB,mBAAA,EAEvC,OAAA,GAAS,mBAAA,KAqDJ,MAAA,CAAO,QAAA"}