@shell-shock/preset-script 0.2.1 → 0.3.1

package/dist/components/console-builtin.d.cts

@@ -1,6 +1,6 @@
 import { Children } from "@alloy-js/core";
 import { FunctionDeclarationProps } from "@alloy-js/typescript";
-import { ThemeMessageVariant } from "@shell-shock/plugin-theme/types/theme";
+import { ThemeColorVariant, ThemeMessageVariant } from "@shell-shock/plugin-theme/types/theme";
 
 //#region src/components/console-builtin.d.ts
 
@@ -18,11 +18,21 @@ type MessageFunctionDeclarationProps = Partial<Pick<FunctionDeclarationProps, "p
   consoleFnName: "log" | "info" | "warn" | "error" | "debug";
   description: string;
   prefix?: Children;
+  timestamp?: boolean;
 };
 /**
  * A component to generate the message functions in the `shell-shock:console` builtin module.
  */
 declare function MessageFunctionDeclaration(props: MessageFunctionDeclarationProps): Children;
+interface BannerFunctionDeclarationProps {
+  variant?: ThemeColorVariant;
+  consoleFnName?: "log" | "info" | "warn" | "error" | "debug";
+  title?: string;
+}
+/**
+ * A component to generate the `banner` function in the `shell-shock:console` builtin module.
+ */
+declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): Children;
 /**
  * A component to generate the `wrapAnsi` function in the `shell-shock:console` builtin module.
  */
@@ -52,5 +62,5 @@ declare function TableFunctionDeclaration(props: TableFunctionDeclarationProps):
  */
 declare function ConsoleBuiltin(): Children;
 //#endregion
-export { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration };
+export { BannerFunctionDeclaration, BannerFunctionDeclarationProps, ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration };
 //# sourceMappingURL=console-builtin.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"console-builtin.d.cts","names":[],"sources":["../../src/components/console-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA8EA;AA47BgB,iBA57BA,iBAAA,CAAA,CA47B4B,EA57BX,QA47BW;AAuJ5C;;;AAA8C,iBAvJ9B,4BAAA,CAAA,CAuJ8B,EAvJF,QAuJE;AAYnC,KAZC,+BAAA,GAAkC,OAYnC,CAXT,IAWS,CAXJ,wBAWI,EAAA,YAAA,CAAA,CAAA,GAAA;EAGA,IAAA,EAAA,SAAA,GAAA,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAAQ,OAAA,EAHR,mBAGQ;EAMH,aAAA,EAAA,KAAA,GAAA,MAA0B,GAAA,MAAA,GACjC,OAAA,GAAA,OAAA;EAoGO,WAAA,EAAA,MAAgB;EA4EhB,MAAA,CAAA,EAvLL,QAuLK;AAmChB,CAAA;AAsFA;AA0FA;AAQA;AAsegB,iBAl3BA,0BAAA,CAk3Bc,KAAA,EAj3BrB,+BAi3BqB,CAAA,EAj3BU,QAi3BV;;;;iBA7wBd,gBAAA,CAAA,GAAgB;;;;iBA4EhB,4BAAA,CAAA,GAA4B;;;;iBAmC5B,0BAAA,CAAA,GAA0B;;;;iBAsF1B,uBAAA,CAAA,GAAuB;;;;KA0F3B,6BAAA,GAAgC,KAC1C;;;;iBAOc,wBAAA,QAAgC,gCAA6B;;;;iBAse7D,cAAA,CAAA,GAAc"}
+{"version":3,"file":"console-builtin.d.cts","names":[],"sources":["../../src/components/console-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAuFA;AAwpCgB,iBAxpCA,iBAAA,CAAA,CAwpC4B,EAxpCX,QAwpCW;AAuJ5C;;;AAA8C,iBAvJ9B,4BAAA,CAAA,CAuJ8B,EAvJF,QAuJE;AAYnC,KAZC,+BAAA,GAAkC,OAYnC,CAXT,IAWS,CAXJ,wBAWI,EAAA,YAAA,CAAA,CAAA,GAAA;EAGA,IAAA,EAAA,SAAA,GAAA,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAAQ,OAAA,EAHR,mBAGQ;EAOH,aAAA,EAAA,KAAA,GAAA,MAA0B,GAAA,MAAA,GACjC,OAAA,GAAA,OAAA;EAuKQ,WAAA,EAAA,MAAA;EASD,MAAA,CAAA,EAxLL,QAwLK;EA0LA,SAAA,CAAA,EAAA,OAAgB;AA4EhC,CAAA;AAmCA;AAsFA;AA0FA;AAQgB,iBAlpBA,0BAAA,CAkpBgC,KAAA,EAjpBvC,+BAipBoE,CAAA,EAjpBrC,QAipBqC;AAse7D,UAh9BC,8BAAA,CAg9Ba;YA/8BlB;;;;;;;iBAQI,yBAAA,QACP,iCAA8B;;;;iBAyLvB,gBAAA,CAAA,GAAgB;;;;iBA4EhB,4BAAA,CAAA,GAA4B;;;;iBAmC5B,0BAAA,CAAA,GAA0B;;;;iBAsF1B,uBAAA,CAAA,GAAuB;;;;KA0F3B,6BAAA,GAAgC,KAC1C;;;;iBAOc,wBAAA,QAAgC,gCAA6B;;;;iBAse7D,cAAA,CAAA,GAAc"}

package/dist/components/console-builtin.d.mts

@@ -1,6 +1,6 @@
 import { Children } from "@alloy-js/core";
 import { FunctionDeclarationProps } from "@alloy-js/typescript";
-import { ThemeMessageVariant } from "@shell-shock/plugin-theme/types/theme";
+import { ThemeColorVariant, ThemeMessageVariant } from "@shell-shock/plugin-theme/types/theme";
 
 //#region src/components/console-builtin.d.ts
 
@@ -18,11 +18,21 @@ type MessageFunctionDeclarationProps = Partial<Pick<FunctionDeclarationProps, "p
   consoleFnName: "log" | "info" | "warn" | "error" | "debug";
   description: string;
   prefix?: Children;
+  timestamp?: boolean;
 };
 /**
  * A component to generate the message functions in the `shell-shock:console` builtin module.
  */
 declare function MessageFunctionDeclaration(props: MessageFunctionDeclarationProps): Children;
+interface BannerFunctionDeclarationProps {
+  variant?: ThemeColorVariant;
+  consoleFnName?: "log" | "info" | "warn" | "error" | "debug";
+  title?: string;
+}
+/**
+ * A component to generate the `banner` function in the `shell-shock:console` builtin module.
+ */
+declare function BannerFunctionDeclaration(props: BannerFunctionDeclarationProps): Children;
 /**
  * A component to generate the `wrapAnsi` function in the `shell-shock:console` builtin module.
  */
@@ -52,5 +62,5 @@ declare function TableFunctionDeclaration(props: TableFunctionDeclarationProps):
  */
 declare function ConsoleBuiltin(): Children;
 //#endregion
-export { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration };
+export { BannerFunctionDeclaration, BannerFunctionDeclarationProps, ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, MessageFunctionDeclarationProps, StripAnsiFunctionDeclaration, TableFunctionDeclaration, TableFunctionDeclarationProps, WrapAnsiFunction, WriteLineFunctionDeclaration };
 //# sourceMappingURL=console-builtin.d.mts.map

package/dist/components/console-builtin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"console-builtin.d.mts","names":[],"sources":["../../src/components/console-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA8EA;AA47BgB,iBA57BA,iBAAA,CAAA,CA47B4B,EA57BX,QA47BW;AAuJ5C;;;AAA8C,iBAvJ9B,4BAAA,CAAA,CAuJ8B,EAvJF,QAuJE;AAYnC,KAZC,+BAAA,GAAkC,OAYnC,CAXT,IAWS,CAXJ,wBAWI,EAAA,YAAA,CAAA,CAAA,GAAA;EAGA,IAAA,EAAA,SAAA,GAAA,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAAQ,OAAA,EAHR,mBAGQ;EAMH,aAAA,EAAA,KAAA,GAAA,MAA0B,GAAA,MAAA,GACjC,OAAA,GAAA,OAAA;EAoGO,WAAA,EAAA,MAAgB;EA4EhB,MAAA,CAAA,EAvLL,QAuLK;AAmChB,CAAA;AAsFA;AA0FA;AAQA;AAsegB,iBAl3BA,0BAAA,CAk3Bc,KAAA,EAj3BrB,+BAi3BqB,CAAA,EAj3BU,QAi3BV;;;;iBA7wBd,gBAAA,CAAA,GAAgB;;;;iBA4EhB,4BAAA,CAAA,GAA4B;;;;iBAmC5B,0BAAA,CAAA,GAA0B;;;;iBAsF1B,uBAAA,CAAA,GAAuB;;;;KA0F3B,6BAAA,GAAgC,KAC1C;;;;iBAOc,wBAAA,QAAgC,gCAA6B;;;;iBAse7D,cAAA,CAAA,GAAc"}
+{"version":3,"file":"console-builtin.d.mts","names":[],"sources":["../../src/components/console-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAuFA;AAwpCgB,iBAxpCA,iBAAA,CAAA,CAwpC4B,EAxpCX,QAwpCW;AAuJ5C;;;AAA8C,iBAvJ9B,4BAAA,CAAA,CAuJ8B,EAvJF,QAuJE;AAYnC,KAZC,+BAAA,GAAkC,OAYnC,CAXT,IAWS,CAXJ,wBAWI,EAAA,YAAA,CAAA,CAAA,GAAA;EAGA,IAAA,EAAA,SAAA,GAAA,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAAQ,OAAA,EAHR,mBAGQ;EAOH,aAAA,EAAA,KAAA,GAAA,MAA0B,GAAA,MAAA,GACjC,OAAA,GAAA,OAAA;EAuKQ,WAAA,EAAA,MAAA;EASD,MAAA,CAAA,EAxLL,QAwLK;EA0LA,SAAA,CAAA,EAAA,OAAgB;AA4EhC,CAAA;AAmCA;AAsFA;AA0FA;AAQgB,iBAlpBA,0BAAA,CAkpBgC,KAAA,EAjpBvC,+BAipBoE,CAAA,EAjpBrC,QAipBqC;AAse7D,UAh9BC,8BAAA,CAg9Ba;YA/8BlB;;;;;;;iBAQI,yBAAA,QACP,iCAA8B;;;;iBAyLvB,gBAAA,CAAA,GAAgB;;;;iBA4EhB,4BAAA,CAAA,GAA4B;;;;iBAmC5B,0BAAA,CAAA,GAA0B;;;;iBAsF1B,uBAAA,CAAA,GAAuB;;;;KA0F3B,6BAAA,GAAgC,KAC1C;;;;iBAOc,wBAAA,QAAgC,gCAA6B;;;;iBAse7D,cAAA,CAAA,GAAc"}

package/dist/components/console-builtin.mjs

@@ -1,10 +1,14 @@
 import { useColors, useTheme } from "../contexts/theme.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { For, Show, code } from "@alloy-js/core";
+import { For, Show, code, computed } from "@alloy-js/core";
 import { ElseClause, FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, TypeDeclaration, VarDeclaration } from "@alloy-js/typescript";
+import { getAppDescription, getAppTitle } from "@shell-shock/core/plugin-utils/context-helpers";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { TSDoc, TSDocDefaultValue, TSDocExample, TSDocParam, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
 import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { useCommand } from "@shell-shock/core/contexts/command";
 import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+import { getIndefiniteArticle } from "@stryke/string-format/vowels";
 
 //#region src/components/console-builtin.tsx
 /**
@@ -103,61 +107,216 @@ function ColorsDeclaration() {
 					createIntrinsic("hbr", {}),
 					code`text: {
                     banner: {
-                      title: ${createComponent(ColorFunction, {
+                      header: {
+                        primary: ${createComponent(ColorFunction, {
 						get ansi16() {
-							return colors.ansi16.theme.text.banner.title;
+							return colors.ansi16.theme.text.banner.header.primary;
 						},
 						get ansi256() {
-							return colors.ansi256.theme.text.banner.title;
+							return colors.ansi256.theme.text.banner.header.primary;
 						},
 						get ansi16m() {
-							return colors.ansi16m.theme.text.banner.title;
+							return colors.ansi16m.theme.text.banner.header.primary;
 						}
 					})},
-                      header: ${createComponent(ColorFunction, {
+                        secondary: ${createComponent(ColorFunction, {
 						get ansi16() {
-							return colors.ansi16.theme.text.banner.header;
+							return colors.ansi16.theme.text.banner.header.secondary;
 						},
 						get ansi256() {
-							return colors.ansi256.theme.text.banner.header;
+							return colors.ansi256.theme.text.banner.header.secondary;
 						},
 						get ansi16m() {
-							return colors.ansi16m.theme.text.banner.header;
+							return colors.ansi16m.theme.text.banner.header.secondary;
 						}
 					})},
-                      footer: ${createComponent(ColorFunction, {
+                        tertiary: ${createComponent(ColorFunction, {
 						get ansi16() {
-							return colors.ansi16.theme.text.banner.footer;
+							return colors.ansi16.theme.text.banner.header.tertiary;
 						},
 						get ansi256() {
-							return colors.ansi256.theme.text.banner.footer;
+							return colors.ansi256.theme.text.banner.header.tertiary;
 						},
 						get ansi16m() {
-							return colors.ansi16m.theme.text.banner.footer;
+							return colors.ansi16m.theme.text.banner.header.tertiary;
+						}
+					})}
+                      },
+                      footer: {
+                        primary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.footer.primary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.footer.primary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.footer.primary;
 						}
 					})},
-                      command: ${createComponent(ColorFunction, {
+                        secondary: ${createComponent(ColorFunction, {
 						get ansi16() {
-							return colors.ansi16.theme.text.banner.command;
+							return colors.ansi16.theme.text.banner.footer.secondary;
 						},
 						get ansi256() {
-							return colors.ansi256.theme.text.banner.command;
+							return colors.ansi256.theme.text.banner.footer.secondary;
 						},
 						get ansi16m() {
-							return colors.ansi16m.theme.text.banner.command;
+							return colors.ansi16m.theme.text.banner.footer.secondary;
 						}
 					})},
-                      description: ${createComponent(ColorFunction, {
+                        tertiary: ${createComponent(ColorFunction, {
 						get ansi16() {
-							return colors.ansi16.theme.text.banner.description;
+							return colors.ansi16.theme.text.banner.footer.tertiary;
 						},
 						get ansi256() {
-							return colors.ansi256.theme.text.banner.description;
+							return colors.ansi256.theme.text.banner.footer.tertiary;
 						},
 						get ansi16m() {
-							return colors.ansi16m.theme.text.banner.description;
+							return colors.ansi16m.theme.text.banner.footer.tertiary;
 						}
 					})}
+                      },
+                      command: {
+                        primary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.command.primary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.command.primary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.command.primary;
+						}
+					})},
+                        secondary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.command.secondary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.command.secondary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.command.secondary;
+						}
+					})},
+                        tertiary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.command.tertiary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.command.tertiary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.command.tertiary;
+						}
+					})},
+                      },
+                      title: {
+                        primary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.title.primary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.title.primary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.title.primary;
+						}
+					})},
+                        secondary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.title.secondary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.title.secondary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.title.secondary;
+						}
+					})},
+                        tertiary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.title.tertiary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.title.tertiary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.title.tertiary;
+						}
+					})},
+                      },
+                      link: {
+                        primary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.link.primary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.link.primary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.link.primary;
+						}
+					})},
+                        secondary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.link.secondary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.link.secondary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.link.secondary;
+						}
+					})},
+                        tertiary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.link.tertiary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.link.tertiary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.link.tertiary;
+						}
+					})},
+                      },
+                      description: {
+                        primary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.description.primary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.description.primary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.description.primary;
+						}
+					})},
+                        secondary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.description.secondary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.description.secondary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.description.secondary;
+						}
+					})},
+                        tertiary: ${createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16.theme.text.banner.description.tertiary;
+						},
+						get ansi256() {
+							return colors.ansi256.theme.text.banner.description.tertiary;
+						},
+						get ansi16m() {
+							return colors.ansi16m.theme.text.banner.description.tertiary;
+						}
+					})},
+                      }
                     },
                     heading: {
                       primary: ${createComponent(ColorFunction, {
@@ -192,7 +351,7 @@ function ColorsDeclaration() {
 						get ansi16m() {
 							return colors.ansi16m.theme.text.heading.tertiary;
 						}
-					})}
+					})},
                     },
                     body: {
                       primary: ${createComponent(ColorFunction, {
@@ -1114,17 +1273,11 @@ consoleFn(\`\${" ".repeat(Math.max(options.padding ?? ${theme.padding.app}, 0))}
 * A component to generate the message functions in the `shell-shock:console` builtin module.
 */
 function MessageFunctionDeclaration(props) {
-	const { type, variant, consoleFnName, description, prefix, parameters } = props;
+	const { type, variant, consoleFnName, description, prefix, parameters, timestamp } = props;
 	const theme = useTheme();
 	return [createComponent(TSDoc, {
 		get heading() {
-			return `Write ${[
-				"a",
-				"e",
-				"i",
-				"o",
-				"u"
-			].includes(description.charAt(0)) ? "an" : "a"} ${description} message to the console.`;
+			return `Write ${getIndefiniteArticle(description)} ${description} message to the console.`;
 		},
 		get children() {
 			return [
@@ -1161,19 +1314,69 @@ function MessageFunctionDeclaration(props) {
           return;
         }
 
-        writeLine(colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].topLeft}") + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].top}".repeat(Math.max(process.stdout.columns - ${(Math.max(theme.padding.app, 0) + Math.max(theme.padding.message, 0)) * 2 + theme.borderStyles.message.outline[variant].topLeft.length + theme.borderStyles.message.outline[variant].topRight.length}, 0) / ${theme.borderStyles.message.outline[variant].top.length ?? 1})) + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].topRight}"), { consoleFn: console.${consoleFnName} });
+        ${!theme.labels.message.footer[variant] && timestamp ? `const timestamp = \`\${colors.text.message.footer.${variant}(new Date().toLocaleDateString())} \${colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottom}")} \${colors.text.message.footer.${variant}(new Date().toLocaleTimeString())}\`; ` : ""}
+        writeLine(colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].topLeft}") + ${theme.labels.message.header[variant] || theme.icons.message.header[variant] ? `colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].top}".repeat(4)) + " " + ${theme.icons.message.header[variant] ? `colors.border.message.outline.${variant}("${theme.icons.message.header[variant]}") + " " +` : ""} colors.text.message.header.${variant}("${theme.labels.message.header[variant]}") + " " + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].top}".repeat(Math.max(process.stdout.columns - ${Math.max(theme.padding.app, 0) * 2 + 4 + (theme.icons.message.header[variant] ? theme.icons.message.header[variant].length + 1 + (theme.labels.message.header[variant] ? 0 : 1) : 0) + (theme.labels.message.header[variant] ? theme.labels.message.header[variant].length + 2 : 0) + theme.borderStyles.message.outline[variant].topLeft.length + theme.borderStyles.message.outline[variant].topRight.length}, 0)))` : `colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].top}".repeat(Math.max(process.stdout.columns - ${Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.message.outline[variant].topLeft.length + theme.borderStyles.message.outline[variant].topRight.length}, 0)))`} + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].topRight}"), { consoleFn: console.${consoleFnName} });
         splitText(
           message,
           Math.max(process.stdout.columns - ${(Math.max(theme.padding.app, 0) + Math.max(theme.padding.message, 0)) * 2 + theme.borderStyles.message.outline[variant].left.length + theme.borderStyles.message.outline[variant].right.length}, 0)
         ).forEach((line) => {
-          writeLine(colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].left + " ".repeat(Math.max(theme.padding.message, 0))}") + line + colors.border.message.outline.${variant}("${" ".repeat(Math.max(theme.padding.message, 0)) + theme.borderStyles.message.outline[variant].right}"), { consoleFn: console.${consoleFnName} });
+          writeLine(colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].left + " ".repeat(Math.max(theme.padding.message, 0))}") + colors.text.message.description.${variant}(line) + " ".repeat(Math.max(process.stdout.columns - (stripAnsi(line).length + ${Math.max(theme.padding.app, 0) * 2 + Math.max(theme.padding.message, 0) + theme.borderStyles.message.outline[variant].left.length + theme.borderStyles.message.outline[variant].right.length}), 0)) + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].right}"), { consoleFn: console.${consoleFnName} });
         });
-        writeLine(colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottomLeft}") + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottom}".repeat(Math.max(process.stdout.columns - ${(Math.max(theme.padding.app, 0) + Math.max(theme.padding.message, 0)) * 2 + theme.borderStyles.message.outline[variant].bottomLeft.length + theme.borderStyles.message.outline[variant].bottomRight.length}, 0) / ${theme.borderStyles.message.outline[variant].bottom.length ?? 1})) + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottomRight}"), { consoleFn: console.${consoleFnName} });
+        writeLine(colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottomLeft}") + ${theme.labels.message.footer[variant] || timestamp ? `colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottom}".repeat(Math.max(process.stdout.columns - ${Math.max(theme.padding.app, 0) * 2 + 4 + (theme.labels.message.footer[variant] ? theme.labels.message.footer[variant].length + 2 : 0) + theme.borderStyles.message.outline[variant].bottomLeft.length + theme.borderStyles.message.outline[variant].bottomRight.length}${!theme.labels.message.footer[variant] && timestamp ? " - (stripAnsi(timestamp).length + 2)" : ""}, 0))) + " " + ${theme.labels.message.footer[variant] ? `colors.text.message.footer.${variant}("${theme.labels.message.footer[variant]}")` : timestamp && "timestamp"} + " " + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottom}".repeat(4))` : `colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottom}".repeat(Math.max(process.stdout.columns - ${Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.message.outline[variant].bottomLeft.length + theme.borderStyles.message.outline[variant].bottomRight.length}, 0)))`} + colors.border.message.outline.${variant}("${theme.borderStyles.message.outline[variant].bottomRight}"), { consoleFn: console.${consoleFnName} });
 `)];
 		}
 	})];
 }
 /**
+* A component to generate the `banner` function in the `shell-shock:console` builtin module.
+*/
+function BannerFunctionDeclaration(props) {
+	const { consoleFnName = "log", variant = "primary", title: titleProp } = props;
+	const theme = useTheme();
+	const context = usePowerlines();
+	const command = useCommand();
+	const header = computed(() => `${theme.labels.banner.header[variant] || getAppTitle(context)} v${context.packageJson.version || "1.0.0"}`);
+	const description = computed(() => command?.description || getAppDescription(context));
+	const footer = computed(() => theme.labels.banner.footer[variant]);
+	const title = computed(() => titleProp || /(?:cli|command-line|command line)\s+(?:application|app)?$/.test(header.value.toLowerCase()) ? header.value.replace(`v${context.packageJson.version || "1.0.0"}`, "").trim() : `${header.value.replace(`v${context.packageJson.version || "1.0.0"}`, "").trim()} Command-Line Application`);
+	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, {
+		"export": true,
+		name: "banner",
+		doc: "Write the application banner to the console.",
+		get children() {
+			return code`
+        if (hasFlag("no-banner") || hasFlag("hide-banner") || isCI || isMinimal) {
+          return;
+        }
+
+        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(4)) + " " + ${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.text.banner.header.${variant}("${header.value}") + " " + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].top}".repeat(Math.max(process.stdout.columns - ${4 + (theme.icons.banner.header[variant] ? theme.icons.banner.header[variant].length + 3 : 0) + (header.value ? header.value.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(
+          colors.text.banner.title.${variant}("${title.value}"),
+          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} });
+        });
+
+        ${command?.title ? `writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottomLeft}") + " ".repeat(Math.max(process.stdout.columns - ${bannerPadding.value})) + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottomRight}"), { consoleFn: console.${consoleFnName} });
+
+            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.command.${variant}("${command.title}") + " ".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} }); ` : ""}
+
+        splitText(
+          ${command?.title ? "colors.text.banner.description" : "colors.text.banner.command"}.${variant}("${description.value.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} });
+        });
+
+        writeLine(colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottomLeft}") + ${footer.value ? `colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottom}".repeat(Math.max(process.stdout.columns - ${6 + (footer.value ? footer.value.length : 0) + bannerPadding.value}, 0))) + " " + ${footer.value ? `colors.text.banner.footer.${variant}("${footer.value}")` : ""} + " " + colors.border.banner.outline.${variant}("${theme.borderStyles.banner.outline[variant].bottom}".repeat(4))` : `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} });
+`;
+		}
+	})];
+}
+/**
 * A component to generate the `wrapAnsi` function in the `shell-shock:console` builtin module.
 */
 function WrapAnsiFunction() {
@@ -1883,7 +2086,7 @@ do {
 
     const lines = splitText(
       cell.value,
-      Math.max(process.stdout.columns - ${Math.max(theme.padding.app, 0) * 2} - (colWidths.filter((_, i) => i !== colIndex).reduce((a, b) => a + b, 0)) - cell.padding * 2), 0)
+      Math.max(process.stdout.columns - ${Math.max(theme.padding.app, 0) * 2} - (colWidths.filter((_, i) => i !== colIndex).reduce((a, b) => a + b, 0)) - cell.padding * 2, 0)
     );
 
     cell.value = lines.join("\\n");
@@ -1952,6 +2155,7 @@ function ConsoleBuiltin() {
 		builtinImports: {
 			utils: [
 				"hasFlag",
+				"isMinimal",
 				"isColorSupported",
 				"colorSupportLevels",
 				"isHyperlinkSupported"
@@ -1959,7 +2163,8 @@ function ConsoleBuiltin() {
 			env: [
 				"env",
 				"isDevelopment",
-				"isDebug"
+				"isDebug",
+				"isCI"
 			]
 		},
 		get children() {
@@ -1982,6 +2187,9 @@ function ConsoleBuiltin() {
 				createComponent(DividerFunctionDeclaration, {}),
 				createIntrinsic("hbr", {}),
 				createIntrinsic("hbr", {}),
+				createComponent(BannerFunctionDeclaration, {}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
 				createComponent(MessageFunctionDeclaration, {
 					type: "help",
 					variant: "help",
@@ -2011,6 +2219,7 @@ function ConsoleBuiltin() {
 					variant: "debug",
 					consoleFnName: "debug",
 					description: "debug",
+					timestamp: true,
 					get prefix() {
 						return createComponent(IfStatement, {
 							condition: code`!isDevelopment && !isDebug && env.LOG_LEVEL !== "debug"`,
@@ -2025,6 +2234,7 @@ function ConsoleBuiltin() {
 					variant: "debug",
 					consoleFnName: "debug",
 					description: "verbose",
+					timestamp: true,
 					get prefix() {
 						return createComponent(IfStatement, {
 							condition: code`!(isDevelopment || isDebug || env.LOG_LEVEL === "debug" || hasFlag(["verbose", "verbose=true", "verbose=always"]))`,
@@ -2055,6 +2265,7 @@ function ConsoleBuiltin() {
 					variant: "error",
 					consoleFnName: "error",
 					description: "error",
+					timestamp: true,
 					parameters: [{
 						name: "err",
 						type: "string | Error",
@@ -2093,5 +2304,5 @@ function ConsoleBuiltin() {
 }
 
 //#endregion
-export { ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, StripAnsiFunctionDeclaration, TableFunctionDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };
+export { BannerFunctionDeclaration, ColorsDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, StripAnsiFunctionDeclaration, TableFunctionDeclaration, WrapAnsiFunction, WriteLineFunctionDeclaration };
 //# sourceMappingURL=console-builtin.mjs.map