@shell-shock/preset-cli 0.8.4 → 0.8.5

package/dist/plugin-banner/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 { FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
+import { getAppDescription, getAppTitle } from "@shell-shock/core/plugin-utils";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { useTheme } from "@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 = 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/plugin-banner/dist/components/banner-function-declaration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-function-declaration.mjs","names":[],"sources":["../../../../../plugin-banner/dist/components/banner-function-declaration.mjs"],"sourcesContent":["import { createComponent, memo } from \"@alloy-js/core/jsx-runtime\";\nimport { Show, code, computed } from \"@alloy-js/core\";\nimport { getAppDescription, getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { FunctionDeclaration, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\n\n//#region src/components/banner-function-declaration.tsx\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*/\nfunction BannerFunctionDeclarationWrapper(props) {\n\tconst { command, children } = props;\n\tconst context = usePowerlines();\n\treturn createComponent(FunctionDeclaration, {\n\t\t\"export\": true,\n\t\tasync: true,\n\t\tname: \"showBanner\",\n\t\tget doc() {\n\t\t\treturn `Write the ${getAppTitle(context, true)} command-line interface application banner ${command ? `for the ${command.title} command ` : \"\"}to the console.`;\n\t\t},\n\t\tparameters: [{\n\t\t\tname: \"sleepTimeoutMs\",\n\t\t\ttype: \"number\",\n\t\t\tdefault: 500\n\t\t}],\n\t\tget children() {\n\t\t\treturn [children, createComponent(IfStatement, {\n\t\t\t\tcondition: code`isInteractive && !isHelp`,\n\t\t\t\tchildren: code`await sleep(sleepTimeoutMs);`\n\t\t\t})];\n\t\t}\n\t});\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*/\nfunction BannerFunctionBodyDeclaration(props) {\n\tconst { consoleFnName = \"log\", variant = \"primary\", title, header, footer, description, command, children, insertNewlineBeforeCommand = false, insertNewlineBeforeBanner = true, insertNewlineAfterDescription = false } = props;\n\tconst theme = useTheme();\n\tconst bannerPadding = computed(() => Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.banner.outline[variant].left.length + theme.borderStyles.banner.outline[variant].right.length);\n\tconst totalPadding = computed(() => Math.max(theme.padding.banner, 0) * 2 + bannerPadding.value);\n\treturn [\n\t\tcode`\n        if (useApp().get(\"banner\") || hasFlag(\"no-banner\") || hasFlag(\"hide-banner\") || isMinimal) {\n          return;\n        }\n\n        useApp().set(\"banner\", true); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tchildren,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\twhen: insertNewlineBeforeBanner,\n\t\t\tchildren: code`writeLine(\"\"); `\n\t\t}),\n\t\tcreateComponent(Spacing, {}),\n\t\tmemo(() => code`\n      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} });\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}(\"${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} });\n        });\n\n        ${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} }); ` : \"\"}\n            ${`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} }); `} ` : \"\"}\n\n        splitText(\n          colors.bold(${command?.title ? \"colors.text.banner.description\" : \"colors.text.banner.command\"}.${variant}(\"${description.replace(/\"/g, \"\\\\\\\"\")}\")),\n          Math.max(process.stdout.columns - ${totalPadding.value}, 0)\n        ).forEach((line) => {\n          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} });\n        });\n        ${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} });` : \"\"}\n        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} });\n\n        writeLine(\"\"); `)\n\t];\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*/\nfunction BannerFunctionDeclaration(props) {\n\tconst { consoleFnName = \"log\", variant = \"primary\", command, children, insertNewlineBeforeBanner = true } = props;\n\tconst theme = useTheme();\n\tconst context = usePowerlines();\n\tconst header = computed(() => `${theme.labels.banner.header[variant] || getAppTitle(context, false)} v${context.packageJson.version || \"1.0.0\"}`);\n\tconst footer = computed(() => theme.labels.banner.footer[variant]);\n\tconst title = computed(() => getAppTitle(context, true).replace(`v${context.packageJson.version || \"1.0.0\"}`, \"\"));\n\tconst description = computed(() => command?.description || getAppDescription(context));\n\treturn createComponent(BannerFunctionDeclarationWrapper, {\n\t\tcommand,\n\t\tget children() {\n\t\t\treturn createComponent(BannerFunctionBodyDeclaration, {\n\t\t\t\tget title() {\n\t\t\t\t\treturn title.value;\n\t\t\t\t},\n\t\t\t\tget header() {\n\t\t\t\t\treturn header.value;\n\t\t\t\t},\n\t\t\t\tget description() {\n\t\t\t\t\treturn description.value;\n\t\t\t\t},\n\t\t\t\tget footer() {\n\t\t\t\t\treturn footer.value;\n\t\t\t\t},\n\t\t\t\tvariant,\n\t\t\t\tconsoleFnName,\n\t\t\t\tcommand,\n\t\t\t\tinsertNewlineBeforeCommand: true,\n\t\t\t\tinsertNewlineBeforeBanner,\n\t\t\t\tchildren\n\t\t\t});\n\t\t}\n\t});\n}\n\n//#endregion\nexport { BannerFunctionBodyDeclaration, BannerFunctionDeclaration, BannerFunctionDeclarationWrapper };\n//# sourceMappingURL=banner-function-declaration.mjs.map"],"mappings":"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"}

package/dist/plugin-help/dist/components/display.cjs

@@ -1,4 +1,5 @@
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_is_set_string = require('../node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.cjs');
 const require_kebab_case = require('../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.cjs');
 const require_snake_case = require('../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
@@ -140,6 +141,19 @@ function BaseHelpDisplay(props) {
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
 				];
 			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return require_is_set_string.isSetString(command.reference);
+			},
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine("");
+      writeLine(colors.text.heading.tertiary(\`More information about this command can be found in the reference documentation at ${command.reference}\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+				];
+			}
 		})
 	];
 }

package/dist/plugin-help/dist/components/display.mjs

@@ -1,3 +1,4 @@
+import { isSetString } from "../node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs";
 import { kebabCase } from "../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs";
 import { snakeCase } from "../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
@@ -139,6 +140,19 @@ function BaseHelpDisplay(props) {
 					createComponent(Spacing, {})
 				];
 			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return isSetString(command.reference);
+			},
+			get children() {
+				return [
+					memo(() => code`writeLine("");
+      writeLine(colors.text.heading.tertiary(\`More information about this command can be found in the reference documentation at ${command.reference}\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+					createIntrinsic("hbr", {}),
+					createComponent(Spacing, {})
+				];
+			}
 		})
 	];
 }

package/dist/plugin-help/dist/components/display.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"display.mjs","names":[],"sources":["../../../../../plugin-help/dist/components/display.mjs"],"sourcesContent":["import { kebabCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs\";\nimport { snakeCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.mjs\";\nimport { createComponent, createIntrinsic, memo } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, code, computed } from \"@alloy-js/core\";\nimport { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from \"@shell-shock/core/plugin-utils\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\n\n//#region src/components/display.tsx\n/**\n* A component that generates the usage display for a command.\n*/\nfunction HelpUsageDisplay(props) {\n\tconst { command, indent = 2 } = props;\n\tconst context = usePowerlines();\n\tconst theme = useTheme();\n\treturn [createComponent(For, {\n\t\tget each() {\n\t\t\treturn Object.keys(context.config.bin);\n\t\t},\n\t\thardline: true,\n\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t}), createComponent(Show, {\n\t\tget when() {\n\t\t\treturn command.args.length > 0;\n\t\t},\n\t\tget children() {\n\t\t\treturn [createIntrinsic(\"hbr\", {}), createComponent(For, {\n\t\t\t\tget each() {\n\t\t\t\t\treturn Object.keys(context.config.bin);\n\t\t\t\t},\n\t\t\t\thardline: true,\n\t\t\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t\t\t})];\n\t\t}\n\t})];\n}\n/**\n* A component that generates the options table display for a command.\n*/\nfunction HelpOptionsDisplay(props) {\n\tconst { options } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn sortOptions(options);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (option) => {\n\t\t\t\tconst flags = [];\n\t\t\t\tconst names = [];\n\t\t\t\tif (option.name.length === 1) flags.push(`-${option.name}`);\n\t\t\t\telse names.push(`--${kebabCase(option.name)}`);\n\t\t\t\toption.alias.forEach((alias) => {\n\t\t\t\t\tif (alias.length === 1) flags.push(`-${alias}`);\n\t\t\t\t\telse names.push(`--${kebabCase(alias)}`);\n\t\t\t\t});\n\t\t\t\treturn code`[{ value: colors.text.body.primary(\"${flags.length > 0 ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}` : \"\"}${names.length > 0 ? names.sort().join(\", \") : \"\"}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.format ? option.format : option.name)}${option.variadic ? \"...\" : \"\"}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.name)}${option.variadic ? \"...\" : \"\"}>` : \"\"}\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(option.description).replace(/\\.+$/, \"\").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? \", \" : \"\"}` : \"\"}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/\"/g, \"\\\\\\\"\")}` : \"\"})` : \"\"}.\\`), align: \"left\", border: \"none\" }], `;\n\t\t\t}\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the commands table display for a command.\n*/\nfunction HelpCommandsDisplay(props) {\n\tconst { commands } = props;\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn Object.values(commands);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (child) => code`[{ value: colors.text.body.primary(\"${child.name}\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`), align: \"left\", border: \"none\" }], `\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the `help` function declaration for a command.\n*/\nfunction BaseHelpDisplay(props) {\n\tconst { command, indent = 1, filterGlobalOptions = false } = props;\n\tconst theme = useTheme();\n\tconst context = usePowerlines();\n\tconst options = computed(() => filterGlobalOptions ? Object.values(command.options).filter((option) => !context.options.some((globalOption) => globalOption.name === option.name || option.alias.includes(globalOption.name) || globalOption.alias?.includes(option.name) || globalOption.alias?.some((alias) => option.alias.includes(alias)))) : Object.values(command.options));\n\treturn [\n\t\tmemo(() => code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpUsageDisplay, {\n\t\t\tcommand,\n\t\t\tindent\n\t\t}),\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn options.value.length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpOptionsDisplay, { get options() {\n\t\t\t\t\t\treturn options.value;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpCommandsDisplay, { get commands() {\n\t\t\t\t\t\treturn command.children;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction VirtualCommandHelpDisplay(props) {\n\tconst { options, segments, commands } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpOptionsDisplay, { options }),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(commands).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(colors.text.body.secondary(\"The following commands are available through the ${getAppTitle(context, true)} command-line interface:\"));\n        writeLine(\"\"); `),\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(commands);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)}${segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction CommandHelpDisplay(props) {\n\tconst { command } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\tcommand,\n\t\t\tfilterGlobalOptions: false\n\t\t}),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tcode`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `,\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(command.children);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)} ${command.segments.join(\" \")} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n\n//#endregion\nexport { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay };\n//# sourceMappingURL=display.mjs.map"],"mappings":"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"}
+{"version":3,"file":"display.mjs","names":[],"sources":["../../../../../plugin-help/dist/components/display.mjs"],"sourcesContent":["import { isSetString } from \"../node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs\";\nimport { kebabCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs\";\nimport { snakeCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.mjs\";\nimport { createComponent, createIntrinsic, memo } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, code, computed } from \"@alloy-js/core\";\nimport { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from \"@shell-shock/core/plugin-utils\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\n\n//#region src/components/display.tsx\n/**\n* A component that generates the usage display for a command.\n*/\nfunction HelpUsageDisplay(props) {\n\tconst { command, indent = 2 } = props;\n\tconst context = usePowerlines();\n\tconst theme = useTheme();\n\treturn [createComponent(For, {\n\t\tget each() {\n\t\t\treturn Object.keys(context.config.bin);\n\t\t},\n\t\thardline: true,\n\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t}), createComponent(Show, {\n\t\tget when() {\n\t\t\treturn command.args.length > 0;\n\t\t},\n\t\tget children() {\n\t\t\treturn [createIntrinsic(\"hbr\", {}), createComponent(For, {\n\t\t\t\tget each() {\n\t\t\t\t\treturn Object.keys(context.config.bin);\n\t\t\t\t},\n\t\t\t\thardline: true,\n\t\t\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t\t\t})];\n\t\t}\n\t})];\n}\n/**\n* A component that generates the options table display for a command.\n*/\nfunction HelpOptionsDisplay(props) {\n\tconst { options } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn sortOptions(options);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (option) => {\n\t\t\t\tconst flags = [];\n\t\t\t\tconst names = [];\n\t\t\t\tif (option.name.length === 1) flags.push(`-${option.name}`);\n\t\t\t\telse names.push(`--${kebabCase(option.name)}`);\n\t\t\t\toption.alias.forEach((alias) => {\n\t\t\t\t\tif (alias.length === 1) flags.push(`-${alias}`);\n\t\t\t\t\telse names.push(`--${kebabCase(alias)}`);\n\t\t\t\t});\n\t\t\t\treturn code`[{ value: colors.text.body.primary(\"${flags.length > 0 ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}` : \"\"}${names.length > 0 ? names.sort().join(\", \") : \"\"}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.format ? option.format : option.name)}${option.variadic ? \"...\" : \"\"}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.name)}${option.variadic ? \"...\" : \"\"}>` : \"\"}\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(option.description).replace(/\\.+$/, \"\").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? \", \" : \"\"}` : \"\"}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/\"/g, \"\\\\\\\"\")}` : \"\"})` : \"\"}.\\`), align: \"left\", border: \"none\" }], `;\n\t\t\t}\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the commands table display for a command.\n*/\nfunction HelpCommandsDisplay(props) {\n\tconst { commands } = props;\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn Object.values(commands);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (child) => code`[{ value: colors.text.body.primary(\"${child.name}\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`), align: \"left\", border: \"none\" }], `\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the `help` function declaration for a command.\n*/\nfunction BaseHelpDisplay(props) {\n\tconst { command, indent = 1, filterGlobalOptions = false } = props;\n\tconst theme = useTheme();\n\tconst context = usePowerlines();\n\tconst options = computed(() => filterGlobalOptions ? Object.values(command.options).filter((option) => !context.options.some((globalOption) => globalOption.name === option.name || option.alias.includes(globalOption.name) || globalOption.alias?.includes(option.name) || globalOption.alias?.some((alias) => option.alias.includes(alias)))) : Object.values(command.options));\n\treturn [\n\t\tmemo(() => code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpUsageDisplay, {\n\t\t\tcommand,\n\t\t\tindent\n\t\t}),\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn options.value.length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpOptionsDisplay, { get options() {\n\t\t\t\t\t\treturn options.value;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpCommandsDisplay, { get commands() {\n\t\t\t\t\t\treturn command.children;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn isSetString(command.reference);\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.text.heading.tertiary(\\`More information about this command can be found in the reference documentation at ${command.reference}\\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction VirtualCommandHelpDisplay(props) {\n\tconst { options, segments, commands } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpOptionsDisplay, { options }),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(commands).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(colors.text.body.secondary(\"The following commands are available through the ${getAppTitle(context, true)} command-line interface:\"));\n        writeLine(\"\"); `),\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(commands);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)}${segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction CommandHelpDisplay(props) {\n\tconst { command } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\tcommand,\n\t\t\tfilterGlobalOptions: false\n\t\t}),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tcode`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `,\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(command.children);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)} ${command.segments.join(\" \")} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n\n//#endregion\nexport { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay };\n//# sourceMappingURL=display.mjs.map"],"mappings":"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"}

package/dist/plugin-help/dist/index.cjs

@@ -7,9 +7,9 @@ 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_core_plugin_utils = require("@shell-shock/core/plugin-utils");
 let defu = require("defu");
 defu = require_runtime.__toESM(defu);
 let _shell_shock_plugin_theme = require("@shell-shock/plugin-theme");

package/dist/plugin-help/dist/index.mjs

@@ -6,8 +6,8 @@ import { createComponent } from "@alloy-js/core/jsx-runtime";
 import { For, Show, computed } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components";
 import { render } from "@powerlines/plugin-alloy/render";
-import console from "@shell-shock/plugin-console";
 import { getAppDescription, getAppName, getAppTitle, getCommandList } from "@shell-shock/core/plugin-utils";
+import console from "@shell-shock/plugin-console";
 import defu from "defu";
 import theme from "@shell-shock/plugin-theme";
 import { joinPaths } from "@stryke/path/join";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-cli",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "private": false,
   "description": "A package containing a Shell Shock plugin to generate source code given a list design tokens.",
   "keywords": [
@@ -73,18 +73,18 @@
         "default": "./dist/components/index.mjs"
       }
     },
-    "./components/banner-function-declaration": {
+    "./components/banner-builtin": {
       "require": {
-        "types": "./dist/components/banner-function-declaration.d.cts",
-        "default": "./dist/components/banner-function-declaration.cjs"
+        "types": "./dist/components/banner-builtin.d.cts",
+        "default": "./dist/components/banner-builtin.cjs"
       },
       "import": {
-        "types": "./dist/components/banner-function-declaration.d.mts",
-        "default": "./dist/components/banner-function-declaration.mjs"
+        "types": "./dist/components/banner-builtin.d.mts",
+        "default": "./dist/components/banner-builtin.mjs"
       },
       "default": {
-        "types": "./dist/components/banner-function-declaration.d.mts",
-        "default": "./dist/components/banner-function-declaration.mjs"
+        "types": "./dist/components/banner-builtin.d.mts",
+        "default": "./dist/components/banner-builtin.mjs"
       }
     },
     "./components/command-entry": {
@@ -181,20 +181,20 @@
   "dependencies": {
     "@alloy-js/core": "0.23.0-dev.8",
     "@alloy-js/typescript": "0.23.0-dev.4",
-    "@powerlines/deepkit": "^0.6.134",
-    "@powerlines/plugin-alloy": "^0.25.41",
-    "@powerlines/plugin-plugin": "^0.12.306",
-    "@shell-shock/core": "^0.13.1",
-    "@shell-shock/plugin-console": "^0.1.12",
-    "@shell-shock/plugin-prompts": "^0.3.13",
-    "@shell-shock/plugin-theme": "^0.3.16",
-    "@shell-shock/plugin-upgrade": "^0.1.18",
-    "@shell-shock/preset-script": "^0.6.27",
+    "@powerlines/deepkit": "^0.6.146",
+    "@powerlines/plugin-alloy": "^0.25.53",
+    "@powerlines/plugin-plugin": "^0.12.318",
+    "@shell-shock/core": "^0.13.2",
+    "@shell-shock/plugin-console": "^0.1.13",
+    "@shell-shock/plugin-prompts": "^0.3.14",
+    "@shell-shock/plugin-theme": "^0.3.17",
+    "@shell-shock/plugin-upgrade": "^0.1.19",
+    "@shell-shock/preset-script": "^0.6.28",
     "@stryke/path": "^0.27.2",
     "@stryke/string-format": "^0.17.6",
     "cfonts": "^3.3.1",
     "defu": "^6.1.4",
-    "powerlines": "^0.41.20"
+    "powerlines": "^0.42.8"
   },
   "devDependencies": {
     "@babel/core": "^7.29.0",
@@ -224,5 +224,5 @@
       "./package.json": "./package.json"
     }
   },
-  "gitHead": "86c55189ed02d126fb583cf6d2555266f00d0f3a"
+  "gitHead": "64e1ac187a12cd18acfd8134768bb793bbda3947"
 }

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

@@ -1,11 +0,0 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
-import { BannerFunctionDeclarationProps } from "@shell-shock/preset-script/components/banner-function-declaration";
-
-//#region src/components/banner-function-declaration.d.ts
-/**
- * A component to generate the `banner` function in the `shell-shock:console` builtin module.
- */
-declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): _alloy_js_core0.Children;
-//#endregion
-export { BannerFunctionDeclaration };
-//# sourceMappingURL=banner-function-declaration.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"banner-function-declaration.d.cts","names":[],"sources":["../../src/components/banner-function-declaration.tsx"],"mappings":";;;;;;;iBA+BgB,yBAAA,CACd,KAAA,EAAO,8BAAA,GAA8B,eAAA,CAAA,QAAA"}

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

@@ -1,11 +0,0 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
-import { BannerFunctionDeclarationProps } from "@shell-shock/preset-script/components/banner-function-declaration";
-
-//#region src/components/banner-function-declaration.d.ts
-/**
- * A component to generate the `banner` function in the `shell-shock:console` builtin module.
- */
-declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): _alloy_js_core0.Children;
-//#endregion
-export { BannerFunctionDeclaration };
-//# sourceMappingURL=banner-function-declaration.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"banner-function-declaration.d.mts","names":[],"sources":["../../src/components/banner-function-declaration.tsx"],"mappings":";;;;;;;iBA+BgB,yBAAA,CACd,KAAA,EAAO,8BAAA,GAA8B,eAAA,CAAA,QAAA"}

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

@@ -1,78 +0,0 @@
-import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
-import { code, computed } from "@alloy-js/core";
-import { FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
-import { getAppDescription, getAppTitle } from "@shell-shock/core/plugin-utils";
-import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { useTheme } from "@shell-shock/plugin-theme/contexts/theme";
-import { BannerFunctionBodyDeclaration } from "@shell-shock/preset-script/components/banner-function-declaration";
-import { render } from "cfonts";
-
-//#region src/components/banner-function-declaration.tsx
-/**
-* A component to generate the `banner` function in the `shell-shock:console` builtin module.
-*/
-function BannerFunctionDeclaration(props) {
-	const { consoleFnName = "log", variant = "primary", command } = props;
-	const theme = useTheme();
-	const context = usePowerlines();
-	const header = computed(() => `${theme.labels.banner.header[variant] || getAppTitle(context)} 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));
-	const titleLines = computed(() => {
-		const result = render(getAppTitle(context, true), {
-			font: "tiny",
-			align: "left",
-			background: "transparent",
-			letterSpacing: 1,
-			lineHeight: 1,
-			gradient: false,
-			transitionGradient: false,
-			env: "node"
-		});
-		if (!result) return [`${getAppTitle(context, true)} Command-Line Interface`];
-		return result.array;
-	});
-	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 [createComponent(FunctionDeclaration, {
-		async: true,
-		name: "banner",
-		get doc() {
-			return `Write the ${getAppTitle(context, true)} application banner ${command ? `for the ${command.title} command ` : ""}to the console.`;
-		},
-		parameters: [{
-			name: "pause",
-			type: "number",
-			default: 500
-		}],
-		get children() {
-			return [createComponent(BannerFunctionBodyDeclaration, {
-				get header() {
-					return header.value;
-				},
-				get description() {
-					return description.value;
-				},
-				get footer() {
-					return footer.value;
-				},
-				variant,
-				consoleFnName,
-				command,
-				insertNewlineAfterDescription: true,
-				get children() {
-					return code`const titleLines = [${titleLines.value.map((line) => JSON.stringify(line.trim())).join(", ")}];
-        const title = Math.max(...titleLines.map(line => stripAnsi(line).length)) > Math.max(process.stdout.columns - ${totalPadding.value}, 0) ? "${title.value}" : \`\\n\${titleLines.join("\\n")}\\n\`; `;
-				}
-			}), createComponent(IfStatement, {
-				condition: code`isInteractive && !isHelp`,
-				children: code`await sleep(pause);`
-			})];
-		}
-	})];
-}
-
-//#endregion
-export { BannerFunctionDeclaration };
-//# sourceMappingURL=banner-function-declaration.mjs.map

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

@@ -1 +0,0 @@
-{"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 { code, computed } from \"@alloy-js/core\";\nimport { FunctionDeclaration, IfStatement } from \"@alloy-js/typescript\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { getAppDescription, getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport type { BannerFunctionDeclarationProps } from \"@shell-shock/preset-script/components/banner-function-declaration\";\nimport { BannerFunctionBodyDeclaration } from \"@shell-shock/preset-script/components/banner-function-declaration\";\nimport { render } from \"cfonts\";\nimport type { CLIPresetContext } from \"../types/plugin\";\n\n/**\n * A component to generate the `banner` function in the `shell-shock:console` builtin module.\n */\nexport function BannerFunctionDeclaration(\n  props: BannerFunctionDeclarationProps\n) {\n  const { consoleFnName = \"log\", variant = \"primary\", command } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<CLIPresetContext>();\n\n  const header = computed(\n    () =>\n      `${theme.labels.banner.header[variant] || getAppTitle(context)} 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  const titleLines = computed(() => {\n    const result = render(getAppTitle(context, true), {\n      font: \"tiny\",\n      align: \"left\",\n      background: \"transparent\",\n      letterSpacing: 1,\n      lineHeight: 1,\n      gradient: false,\n      transitionGradient: false,\n      env: \"node\"\n    });\n    if (!result) {\n      return [`${getAppTitle(context, true)} Command-Line Interface`];\n    }\n\n    return result.array;\n  });\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      <FunctionDeclaration\n        async\n        name=\"banner\"\n        doc={`Write the ${getAppTitle(context, true)} application banner ${\n          command ? `for the ${command.title} command ` : \"\"\n        }to the console.`}\n        parameters={[{ name: \"pause\", type: \"number\", default: 500 }]}>\n        <BannerFunctionBodyDeclaration\n          header={header.value}\n          description={description.value}\n          footer={footer.value}\n          variant={variant}\n          consoleFnName={consoleFnName}\n          command={command}\n          insertNewlineAfterDescription>\n          {code`const titleLines = [${titleLines.value\n            .map(line => JSON.stringify(line.trim()))\n            .join(\", \")}];\n        const title = Math.max(...titleLines.map(line => stripAnsi(line).length)) > Math.max(process.stdout.columns - ${\n          totalPadding.value\n        }, 0) ? \"${title.value}\" : \\`\\\\n\\${titleLines.join(\"\\\\n\")}\\\\n\\`; `}\n        </BannerFunctionBodyDeclaration>\n        <IfStatement condition={code`isInteractive && !isHelp`}>\n          {code`await sleep(pause);`}\n        </IfStatement>\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAgCA,SAAS,0BAAA,OAAA;CACP,MAAA,EACA,gBAAQ,4BAER,YACA;;CAEA,MAAM,UAAS,eAAQ;CACvB,MAAM,SAAA,eAAA,GAAA,MAAA,OAAA,OAAA,OAAA,YAAA,YAAA,QAAA,CAAA,IAAA,QAAA,YAAA,WAAA,UAAA;CACN,MAAM,SAAO,eAAc,MAAO,OAAS,OAAG,OAAW,SAAS;CAClE,MAAM,QAAQ,eAAY,YAAe,SAAE,KAAA,CAAA,QAAA,IAAA,QAAA,YAAA,WAAA,WAAA,GAAA,CAAA;CAC3C,MAAK,cAAA,eAAA,SAAA,eAAA,kBAAA,QAAA,CAAA;CACL,MAAC,aAAA,eAAA;EACD,MAAM,SAAS,OAAS,YAAY,SAAO,KAAO,EAAA;GAClD,MAAM;GACJ,OAAA;GACE,YAAY;GACZ,eAAC;GACH,YAAA;GACD,UAAA;GACD,oBAAoB;GAChB,KAAI;GACP,CAAA;cAED,QAAM,CAAA,GAAA,YAAqB,SAAO,KAAA,CAAA,yBAAA;AAEhC,SAAO,OAAO;GACd;CACF,MAAI,gBAAa,eAAY,KAAA,IAAA,MAAA,QAAA,KAAA,EAAA,GAAA,IAAA,MAAA,aAAA,OAAA,QAAA,SAAA,KAAA,SAAA,MAAA,aAAA,OAAA,QAAA,SAAA,MAAA,OAAA;CAC7B,MAAI,eAAgB,eAAA,KAAA,IAAA,MAAA,QAAA,QAAA,EAAA,GAAA,IAAA,cAAA,MAAA;AACpB,QAAI,CAAA,gBAAa,qBAAA;EACf,OAAE;EACF,MAAE;EACF,IAAE,MAAM;AACN,UAAA,aAAA,YAAA,SAAA,KAAA,CAAA,sBAAA,UAAA,WAAA,QAAA,MAAA,aAAA,GAAA;;EAEF,YAAY,CAAC;GACb,MAAA;;GAEA,SAAO;GACP,CAAA;;AAEF,UAAM,CAAA,gBAAwB,+BAAA;IACxB,IAAA,SAAA;AACE,YAAK,OAAM;;IAEf,IAAM,cAAa;AACtB,YAAA,YAAA;;IAEK,IAAE,SAAS;AAChB,YAAA,OAAA;;IAEM;IACJ;IACE;IACC,+BAAA;IACA,IAAI,WAAQ;AACZ,YAAM,IAAM,uBAAkB,WAAgB,MAAA,KAAW,SAAQ,KAAC,UAAA,KAAA,MAAA,CAAA,CAAA,CAAA,KAAA,KAAA,CAAA;wHACf,aAAA,MAAA,UAAA,MAAA,MAAA;;IAEpD,CAAC,EAAA,gBAAoB,aAAU;IAC9B,WAAC,IAAA;IACD,UAAU,IAAA;IACX,CAAC,CAAC;;EAEN,CAAC,CAAC"}