@shell-shock/preset-cli 0.9.30 → 0.9.32

package/dist/components/banner-builtin.cjs

@@ -2,6 +2,7 @@ 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 _alloy_js_typescript = require("@alloy-js/typescript");
 let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
@@ -14,6 +15,8 @@ let defu = require("defu");
 defu = require_runtime.__toESM(defu);
 let figlet = require("figlet");
 figlet = require_runtime.__toESM(figlet);
+let strip_ansi = require("strip-ansi");
+strip_ansi = require_runtime.__toESM(strip_ansi);
 
 //#region src/components/banner-builtin.tsx
 /**
@@ -27,11 +30,6 @@ function BannerFunctionBodyDeclaration(props) {
 	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));
-	const titleLines = (0, _alloy_js_core.computed)(() => {
-		const result = figlet.default.textSync((0, _stryke_type_checks_is_set_string.isSetString)(context.config.banner) ? context.config.banner : (0, _stryke_type_checks_is_set_object.isSetObject)(context.config.banner) && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.banner.text) ? context.config.banner.text : (0, _shell_shock_core_plugin_utils.getAppTitle)(context, true), (0, defu.default)((0, _stryke_type_checks_is_set_object.isSetObject)(context.config.banner) ? context.config.banner : {}, { font: "ANSI Compact" }));
-		if (!result) return [`${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} Command-Line Interface`];
-		return result.split("\n").filter((line) => line.trim().length > 0);
-	});
 	const bannerPadding = (0, _alloy_js_core.computed)(() => Math.max(theme.padding.app, 0) * 2 + (theme.borderStyles.banner.outline[variant]?.left.length ?? 0) + (theme.borderStyles.banner.outline[variant]?.right.length ?? 0));
 	const totalPadding = (0, _alloy_js_core.computed)(() => Math.max(theme.padding.banner, 0) * 2 + bannerPadding.value);
 	return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_plugin_banner_components_banner_function_declaration.BannerFunctionBodyDeclaration, {
@@ -54,8 +52,8 @@ function BannerFunctionBodyDeclaration(props) {
 		},
 		insertNewlineAfterDescription: true,
 		get children() {
-			return _alloy_js_core.code`const titleLines = [${titleLines.value.map((line) => JSON.stringify(line.trim())).join(", ")}];
-      const title = Math.max(...titleLines.map(line => stripAnsi(line).length)) > Math.max(getTerminalSize().columns + ${totalPadding.value}, 20) ? "${title.value}" : \`\\n\${titleLines.join("\\n")}\\n\`;
+			return _alloy_js_core.code`
+      const title = Math.max(...TITLE_LINES.map(line => stripAnsi(line).length)) > Math.max(getTerminalSize().columns + ${totalPadding.value}, 20) ? "${title.value}" : \`\\n\${TITLE_LINES\.join("\\n")}\\n\`;
 
       splitText(title,
         Math.max(getTerminalSize().columns - ${totalPadding.value}, 20)
@@ -70,10 +68,40 @@ function BannerFunctionBodyDeclaration(props) {
 */
 function BannerBuiltin(props) {
 	const [{ command, children }, rest] = (0, _alloy_js_core.splitProps)(props, ["command", "children"]);
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const titleLines = (0, _alloy_js_core.computed)(() => {
+		const result = figlet.default.textSync((0, _stryke_type_checks_is_set_object.isSetObject)(context.config.banner) && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.banner.override) ? context.config.banner.override : (0, _stryke_type_checks_is_set_string.isSetString)(context.config.banner) ? context.config.banner : (0, _stryke_type_checks_is_set_object.isSetObject)(context.config.banner) && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.banner.text) ? context.config.banner.text : (0, _shell_shock_core_plugin_utils.getAppTitle)(context, true), (0, defu.default)((0, _stryke_type_checks_is_set_object.isSetObject)(context.config.banner) ? context.config.banner : {}, { font: "ANSI Compact" }));
+		if (!result) return [`${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} Command-Line Interface`];
+		const lines = result.trim().split("\n");
+		const maxLength = Math.max(...lines.map((line) => (0, strip_ansi.default)(line).length));
+		return lines.map((line) => {
+			const paddingNeeded = maxLength - (0, strip_ansi.default)(line).length;
+			const leftPadding = Math.floor(paddingNeeded / 2);
+			const rightPadding = Math.ceil(paddingNeeded / 2);
+			return " ".repeat(leftPadding) + line + " ".repeat(rightPadding);
+		});
+	});
 	return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_plugin_banner_components_banner_builtin.BannerBuiltin, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get builtinImports() {
+			return (0, _alloy_js_core_jsx_runtime.memo)(() => !!command?.path)() ? (0, defu.default)(rest.builtinImports ?? {}, { banner: ["TITLE_LINES"] }) : rest.builtinImports;
+		},
 		command,
 		get children() {
-			return (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_plugin_banner_components_banner_function_declaration.BannerFunctionDeclarationWrapper, {
+			return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return !command?.path;
+				},
+				get children() {
+					return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+						"const": true,
+						"export": true,
+						name: "TITLE_LINES",
+						get initializer() {
+							return _alloy_js_core.code` [${titleLines.value.map((line) => JSON.stringify(line)).join(", ")}];`;
+						}
+					}), (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})];
+				}
+			}), (0, _alloy_js_core_jsx_runtime.createComponent)(_shell_shock_plugin_banner_components_banner_function_declaration.BannerFunctionDeclarationWrapper, {
 				command,
 				get children() {
 					return [
@@ -87,7 +115,7 @@ function BannerBuiltin(props) {
 						})
 					];
 				}
-			});
+			})];
 		}
 	}));
 }

package/dist/components/banner-builtin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"banner-builtin.d.cts","names":[],"sources":["../../src/components/banner-builtin.tsx"],"mappings":";;;;;;;AAwCA;iBAAgB,6BAAA,CACd,KAAA,EAAO,IAAI,CACT,kCAAA,kEAED,QAAA;AAAA,KAwFS,kBAAA,GAAqB,IAAA,CAC/B,gBAAA;EA5FW;;;EAkGX,OAAA,EAAS,WAAA;AAAA;;AA/FR;AAwFH;iBAagB,aAAA,CAAc,KAAA,EAAO,kBAAkB,4BAAA,QAAA"}
+{"version":3,"file":"banner-builtin.d.cts","names":[],"sources":["../../src/components/banner-builtin.tsx"],"mappings":";;;;;;;AA0CA;iBAAgB,6BAAA,CACd,KAAA,EAAO,IAAI,CACT,kCAAA,kEAED,QAAA;AAAA,KAsES,kBAAA,GAAqB,IAAA,CAC/B,gBAAA;EA1EW;;;EAgFX,OAAA,EAAS,WAAA;AAAA;;AA7ER;AAsEH;iBAagB,aAAA,CAAc,KAAA,EAAO,kBAAkB,4BAAA,QAAA"}

package/dist/components/banner-builtin.mjs

@@ -1,5 +1,6 @@
 import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { Show, code, computed, splitProps } from "@alloy-js/core";
+import { VarDeclaration } from "@alloy-js/typescript";
 import { getAppDescription, getAppTitle } from "@shell-shock/core/plugin-utils";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
@@ -10,6 +11,7 @@ import { useTheme } from "@shell-shock/plugin-theme/contexts/theme";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import defu from "defu";
 import figlet from "figlet";
+import stripAnsi from "strip-ansi";
 
 //#region src/components/banner-builtin.tsx
 /**
@@ -23,11 +25,6 @@ function BannerFunctionBodyDeclaration(props) {
 	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 = figlet.textSync(isSetString(context.config.banner) ? context.config.banner : isSetObject(context.config.banner) && isSetString(context.config.banner.text) ? context.config.banner.text : getAppTitle(context, true), defu(isSetObject(context.config.banner) ? context.config.banner : {}, { font: "ANSI Compact" }));
-		if (!result) return [`${getAppTitle(context, true)} Command-Line Interface`];
-		return result.split("\n").filter((line) => line.trim().length > 0);
-	});
 	const bannerPadding = computed(() => Math.max(theme.padding.app, 0) * 2 + (theme.borderStyles.banner.outline[variant]?.left.length ?? 0) + (theme.borderStyles.banner.outline[variant]?.right.length ?? 0));
 	const totalPadding = computed(() => Math.max(theme.padding.banner, 0) * 2 + bannerPadding.value);
 	return createComponent(BannerFunctionBodyDeclaration$1, {
@@ -50,8 +47,8 @@ function BannerFunctionBodyDeclaration(props) {
 		},
 		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(getTerminalSize().columns + ${totalPadding.value}, 20) ? "${title.value}" : \`\\n\${titleLines.join("\\n")}\\n\`;
+			return code`
+      const title = Math.max(...TITLE_LINES.map(line => stripAnsi(line).length)) > Math.max(getTerminalSize().columns + ${totalPadding.value}, 20) ? "${title.value}" : \`\\n\${TITLE_LINES\.join("\\n")}\\n\`;
 
       splitText(title,
         Math.max(getTerminalSize().columns - ${totalPadding.value}, 20)
@@ -66,10 +63,40 @@ function BannerFunctionBodyDeclaration(props) {
 */
 function BannerBuiltin(props) {
 	const [{ command, children }, rest] = splitProps(props, ["command", "children"]);
+	const context = usePowerlines();
+	const titleLines = computed(() => {
+		const result = figlet.textSync(isSetObject(context.config.banner) && isSetString(context.config.banner.override) ? context.config.banner.override : isSetString(context.config.banner) ? context.config.banner : isSetObject(context.config.banner) && isSetString(context.config.banner.text) ? context.config.banner.text : getAppTitle(context, true), defu(isSetObject(context.config.banner) ? context.config.banner : {}, { font: "ANSI Compact" }));
+		if (!result) return [`${getAppTitle(context, true)} Command-Line Interface`];
+		const lines = result.trim().split("\n");
+		const maxLength = Math.max(...lines.map((line) => stripAnsi(line).length));
+		return lines.map((line) => {
+			const paddingNeeded = maxLength - stripAnsi(line).length;
+			const leftPadding = Math.floor(paddingNeeded / 2);
+			const rightPadding = Math.ceil(paddingNeeded / 2);
+			return " ".repeat(leftPadding) + line + " ".repeat(rightPadding);
+		});
+	});
 	return createComponent(BannerBuiltin$1, mergeProps(rest, {
+		get builtinImports() {
+			return memo(() => !!command?.path)() ? defu(rest.builtinImports ?? {}, { banner: ["TITLE_LINES"] }) : rest.builtinImports;
+		},
 		command,
 		get children() {
-			return createComponent(BannerFunctionDeclarationWrapper, {
+			return [createComponent(Show, {
+				get when() {
+					return !command?.path;
+				},
+				get children() {
+					return [createComponent(VarDeclaration, {
+						"const": true,
+						"export": true,
+						name: "TITLE_LINES",
+						get initializer() {
+							return code` [${titleLines.value.map((line) => JSON.stringify(line)).join(", ")}];`;
+						}
+					}), createComponent(Spacing, {})];
+				}
+			}), createComponent(BannerFunctionDeclarationWrapper, {
 				command,
 				get children() {
 					return [
@@ -83,7 +110,7 @@ function BannerBuiltin(props) {
 						})
 					];
 				}
-			});
+			})];
 		}
 	}));
 }

package/dist/types/index.d.cts

@@ -1,2 +1,2 @@
-import { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType } from "./plugin.cjs";
-export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };
+import { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetBannerOverrideOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType } from "./plugin.cjs";
+export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetBannerOverrideOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };

package/dist/types/index.d.mts

@@ -1,2 +1,2 @@
-import { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType } from "./plugin.mjs";
-export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };
+import { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetBannerOverrideOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType } from "./plugin.mjs";
+export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetBannerOverrideOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };

package/dist/types/plugin.d.cts

@@ -21,6 +21,12 @@ interface CLIPresetBannerOption extends FigletOptions {
    */
   text?: string;
 }
+interface CLIPresetBannerOverrideOption {
+  /**
+   * The text to display in the banner header verbatim, without applying figlet styling. If this option is set, it will take precedence over the `banner` option and any figlet styling will be ignored. This can be useful if you want to display a custom banner that does not conform to the constraints of figlet fonts, or if you want to include special characters or formatting that may not be supported by figlet. When this option is set, the specified text will be displayed exactly as provided in the banner header, without any modifications or styling applied.
+   */
+  override: string;
+}
 type CLIPresetOptions = Omit<ScriptPresetOptions, "globalOptions"> & HelpPluginOptions & PromptsPluginOptions & UpdatePluginOptions & {
   /**
    * The default interactive mode to apply to commands.
@@ -70,7 +76,7 @@ type CLIPresetOptions = Omit<ScriptPresetOptions, "globalOptions"> & HelpPluginO
    * @remarks
    * This option can be set to a string to specify the banner text directly, or an object with `figlet` options to customize the appearance of the banner. If an object is provided, the `text` property can be used to specify the banner text, and other properties can be used to customize the font, alignment, and other aspects of the banner's appearance.
    */
-  banner?: string | CLIPresetBannerOption;
+  banner?: string | CLIPresetBannerOption | CLIPresetBannerOverrideOption;
   /**
    * Configuration options for the `completions` plugin. This field allows you to customize the behavior of the `completions` plugin, which provides commands for generating shell completion scripts for the CLI application. You can specify which shells to generate completions for, and other related settings.
    */
@@ -91,5 +97,5 @@ type CLIPresetUserConfig = UserConfig & ThemePluginUserConfig & ConsolePluginUse
 type CLIPresetResolvedConfig = ResolvedConfig & ThemePluginResolvedConfig & ConsolePluginResolvedConfig & PromptsPluginResolvedConfig & BannerPluginResolvedConfig & HelpPluginResolvedConfig & CompletionsPluginResolvedConfig & ChangelogPluginResolvedConfig & SkillsPluginResolvedConfig & UpdatePluginResolvedConfig & Required<CLIPresetOptions>;
 type CLIPresetContext<TResolvedConfig extends CLIPresetResolvedConfig = CLIPresetResolvedConfig> = Context<TResolvedConfig> & ThemePluginContext<TResolvedConfig> & ConsolePluginContext<TResolvedConfig> & PromptsPluginContext<TResolvedConfig> & BannerPluginContext<TResolvedConfig> & HelpPluginContext<TResolvedConfig> & CompletionsPluginContext<TResolvedConfig> & ChangelogPluginContext<TResolvedConfig> & SkillsPluginContext<TResolvedConfig> & UpdatePluginContext<TResolvedConfig>;
 //#endregion
-export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };
+export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetBannerOverrideOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };
 //# sourceMappingURL=plugin.d.cts.map

package/dist/types/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;;;;;;;KA+EY,UAAA;AAAA,KAEA,yBAAA;AAAA,UAeK,qBAAA,SAA8B,aAAa;EAjBtC;;;EAqBpB,IAAI;AAAA;AAAA,KAGM,gBAAA,GAAmB,IAAA,CAAK,mBAAA,qBAClC,iBAAA,GACA,oBAAA,GACA,mBAAA;;;AAzBmC;AAerC;;;;AAIM;AAGN;;;EAeI,WAAA;EAf2B;;;;;;;;;;;;;;EA+B3B,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EA2CnB;;;;;;;;;;;EA7B5B,UAAA,GAAa,UAAA;EAdW;;;;;;;;;EAyBxB,MAAA,YAAkB,qBAAA;EAUN;;;EALZ,WAAA,GAAc,IAAA,CAAK,wBAAA;EAaS;AAGhC;;EAXI,SAAA,GAAY,sBAAA;EAWkB;;;;;;EAH9B,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGD,mBAAA,GAAsB,UAAA,GAChC,qBAAA,GACA,uBAAA,GACA,uBAAA,GACA,sBAAA,GACA,oBAAA,GACA,2BAAA,GACA,yBAAA,GACA,sBAAA,GACA,sBAAA,GACA,gBAAA;AAAA,KAEU,uBAAA,GAA0B,cAAA,GACpC,yBAAA,GACA,2BAAA,GACA,2BAAA,GACA,0BAAA,GACA,wBAAA,GACA,+BAAA,GACA,6BAAA,GACA,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,gBAAA;AAAA,KAEC,gBAAA,yBACc,uBAAA,GAA0B,uBAAA,IAChD,OAAA,CAAQ,eAAA,IACV,kBAAA,CAAmB,eAAA,IACnB,oBAAA,CAAqB,eAAA,IACrB,oBAAA,CAAqB,eAAA,IACrB,mBAAA,CAAoB,eAAA,IACpB,iBAAA,CAAkB,eAAA,IAClB,wBAAA,CAAyB,eAAA,IACzB,sBAAA,CAAuB,eAAA,IACvB,mBAAA,CAAoB,eAAA,IACpB,mBAAA,CAAoB,eAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;;;;;;;KA+EY,UAAA;AAAA,KAEA,yBAAA;AAAA,UAeK,qBAAA,SAA8B,aAAa;EAjBtC;;;EAqBpB,IAAI;AAAA;AAAA,UAGW,6BAAA;;;AAtBoB;EA0BnC,QAAQ;AAAA;AAAA,KAGE,gBAAA,GAAmB,IAAA,CAAK,mBAAA,qBAClC,iBAAA,GACA,oBAAA,GACA,mBAAA;EAjB6C;AAIzC;AAGN;;;;AAIU;AAGV;;;;EAeI,WAAA;EAdF;;;;;;;;;;;;;;EA8BE,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EA2CnB;;;;;;;;;;;EA7B5B,UAAA,GAAa,UAAA;EAdW;;;;;;;;;EAyBxB,MAAA,YAAkB,qBAAA,GAAwB,6BAAA;EAU1C;;;EALA,WAAA,GAAc,IAAA,CAAK,wBAAA;EAaS;AAAA;AAGhC;EAXI,SAAA,GAAY,sBAAA;;;;;;;EAQZ,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGD,mBAAA,GAAsB,UAAA,GAChC,qBAAA,GACA,uBAAA,GACA,uBAAA,GACA,sBAAA,GACA,oBAAA,GACA,2BAAA,GACA,yBAAA,GACA,sBAAA,GACA,sBAAA,GACA,gBAAA;AAAA,KAEU,uBAAA,GAA0B,cAAA,GACpC,yBAAA,GACA,2BAAA,GACA,2BAAA,GACA,0BAAA,GACA,wBAAA,GACA,+BAAA,GACA,6BAAA,GACA,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,gBAAA;AAAA,KAEC,gBAAA,yBACc,uBAAA,GAA0B,uBAAA,IAChD,OAAA,CAAQ,eAAA,IACV,kBAAA,CAAmB,eAAA,IACnB,oBAAA,CAAqB,eAAA,IACrB,oBAAA,CAAqB,eAAA,IACrB,mBAAA,CAAoB,eAAA,IACpB,iBAAA,CAAkB,eAAA,IAClB,wBAAA,CAAyB,eAAA,IACzB,sBAAA,CAAuB,eAAA,IACvB,mBAAA,CAAoB,eAAA,IACpB,mBAAA,CAAoB,eAAA"}

package/dist/types/plugin.d.mts

@@ -21,6 +21,12 @@ interface CLIPresetBannerOption extends FigletOptions {
    */
   text?: string;
 }
+interface CLIPresetBannerOverrideOption {
+  /**
+   * The text to display in the banner header verbatim, without applying figlet styling. If this option is set, it will take precedence over the `banner` option and any figlet styling will be ignored. This can be useful if you want to display a custom banner that does not conform to the constraints of figlet fonts, or if you want to include special characters or formatting that may not be supported by figlet. When this option is set, the specified text will be displayed exactly as provided in the banner header, without any modifications or styling applied.
+   */
+  override: string;
+}
 type CLIPresetOptions = Omit<ScriptPresetOptions, "globalOptions"> & HelpPluginOptions & PromptsPluginOptions & UpdatePluginOptions & {
   /**
    * The default interactive mode to apply to commands.
@@ -70,7 +76,7 @@ type CLIPresetOptions = Omit<ScriptPresetOptions, "globalOptions"> & HelpPluginO
    * @remarks
    * This option can be set to a string to specify the banner text directly, or an object with `figlet` options to customize the appearance of the banner. If an object is provided, the `text` property can be used to specify the banner text, and other properties can be used to customize the font, alignment, and other aspects of the banner's appearance.
    */
-  banner?: string | CLIPresetBannerOption;
+  banner?: string | CLIPresetBannerOption | CLIPresetBannerOverrideOption;
   /**
    * Configuration options for the `completions` plugin. This field allows you to customize the behavior of the `completions` plugin, which provides commands for generating shell completion scripts for the CLI application. You can specify which shells to generate completions for, and other related settings.
    */
@@ -91,5 +97,5 @@ type CLIPresetUserConfig = UserConfig & ThemePluginUserConfig & ConsolePluginUse
 type CLIPresetResolvedConfig = ResolvedConfig & ThemePluginResolvedConfig & ConsolePluginResolvedConfig & PromptsPluginResolvedConfig & BannerPluginResolvedConfig & HelpPluginResolvedConfig & CompletionsPluginResolvedConfig & ChangelogPluginResolvedConfig & SkillsPluginResolvedConfig & UpdatePluginResolvedConfig & Required<CLIPresetOptions>;
 type CLIPresetContext<TResolvedConfig extends CLIPresetResolvedConfig = CLIPresetResolvedConfig> = Context<TResolvedConfig> & ThemePluginContext<TResolvedConfig> & ConsolePluginContext<TResolvedConfig> & PromptsPluginContext<TResolvedConfig> & BannerPluginContext<TResolvedConfig> & HelpPluginContext<TResolvedConfig> & CompletionsPluginContext<TResolvedConfig> & ChangelogPluginContext<TResolvedConfig> & SkillsPluginContext<TResolvedConfig> & UpdatePluginContext<TResolvedConfig>;
 //#endregion
-export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };
+export { CLIPresetBannerFontOption, CLIPresetBannerOption, CLIPresetBannerOverrideOption, CLIPresetContext, CLIPresetOptions, CLIPresetResolvedConfig, CLIPresetUserConfig, UpdateType };
 //# sourceMappingURL=plugin.d.mts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-cli",
-  "version": "0.9.30",
+  "version": "0.9.32",
   "private": false,
   "description": "A package containing a Shell Shock plugin to generate source code given a list design tokens.",
   "keywords": [
@@ -177,33 +177,34 @@
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.cts",
   "typings": "dist/index.d.mts",
-  "files": ["dist/**/*"],
+  "files": ["dist"],
   "dependencies": {
     "@alloy-js/core": "^0.23.1",
     "@alloy-js/typescript": "^0.23.0",
-    "@powerlines/deepkit": "^0.9.81",
-    "@powerlines/plugin-alloy": "^0.26.220",
-    "@powerlines/plugin-plugin": "^0.12.539",
-    "@shell-shock/core": "0.17.18",
-    "@shell-shock/plugin-banner": "0.1.45",
-    "@shell-shock/plugin-changelog": "0.1.21",
-    "@shell-shock/plugin-completions": "0.4.26",
-    "@shell-shock/plugin-console": "0.2.22",
-    "@shell-shock/plugin-help": "0.2.36",
-    "@shell-shock/plugin-prompts": "0.3.59",
-    "@shell-shock/plugin-skills": "0.0.9",
-    "@shell-shock/plugin-theme": "0.4.31",
-    "@shell-shock/plugin-update": "0.1.63",
-    "@shell-shock/preset-script": "0.6.73",
+    "@powerlines/deepkit": "^0.9.88",
+    "@powerlines/plugin-alloy": "^0.26.227",
+    "@powerlines/plugin-plugin": "^0.12.546",
+    "@shell-shock/core": "^0.17.20",
+    "@shell-shock/plugin-banner": "^0.1.47",
+    "@shell-shock/plugin-changelog": "^0.1.23",
+    "@shell-shock/plugin-completions": "^0.4.28",
+    "@shell-shock/plugin-console": "^0.2.24",
+    "@shell-shock/plugin-help": "^0.2.38",
+    "@shell-shock/plugin-prompts": "^0.3.61",
+    "@shell-shock/plugin-skills": "^0.0.11",
+    "@shell-shock/plugin-theme": "^0.4.33",
+    "@shell-shock/plugin-update": "^0.1.65",
+    "@shell-shock/preset-script": "^0.6.75",
     "@stryke/path": "^0.29.11",
     "@stryke/string-format": "^0.17.26",
     "@stryke/type-checks": "^0.6.17",
     "@stryke/types": "^0.12.12",
     "defu": "^6.1.7",
     "figlet": "^1.11.0",
-    "powerlines": "^0.47.127"
+    "powerlines": "^0.47.134",
+    "strip-ansi": "^7.2.0"
   },
   "devDependencies": { "@stryke/types": "^0.12.12", "@types/node": "^25.9.2" },
   "publishConfig": { "access": "public" },
-  "gitHead": "4ca0ac0ff9ada03aea6667c89a04b54dc73ff40b"
+  "gitHead": "7c26148e430cd5dca15bc74320969a4656683511"
 }