@shell-shock/plugin-console 0.2.12 → 0.2.15

package/dist/components/console-builtin.mjs

@@ -1,4 +1,35 @@
-import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"@alloy-js/core/jsx-runtime";import{For as i,Show as a,code as o}from"@alloy-js/core";import{ElseClause as s,ElseIfClause as c,FunctionDeclaration as l,IfStatement as u,InterfaceDeclaration as d,InterfaceMember as f,TypeDeclaration as p,VarDeclaration as m}from"@alloy-js/typescript";import{ReflectionKind as h}from"@powerlines/deepkit/vendor/type";import{Spacing as g}from"@powerlines/plugin-alloy/core/components/spacing";import{ClassDeclaration as ee,ClassField as _,ClassMethod as v,ClassPropertyGet as y,ClassPropertySet as te}from"@powerlines/plugin-alloy/typescript";import{BuiltinFile as b}from"@powerlines/plugin-alloy/typescript/components/builtin-file";import{TSDoc as x,TSDocDefaultValue as S,TSDocExample as C,TSDocParam as w,TSDocRemarks as T,TSDocReturns as E}from"@powerlines/plugin-alloy/typescript/components/tsdoc";import{IsNotDebug as ne,IsNotVerbose as D}from"@shell-shock/core/components/helpers";import{useColors as re,useTheme as O}from"@shell-shock/plugin-theme/contexts/theme";import{colorKeys as ie,modifierKeys as ae}from"@shell-shock/plugin-theme/helpers/ansi-utils";import{camelCase as k,titleCase as A}from"@stryke/string-format";import{getIndefiniteArticle as j}from"@stryke/string-format/vowels";import{isSetObject as M}from"@stryke/type-checks/is-set-object";import{defu as N}from"defu";function P(){return[e(m,{const:!0,export:!0,name:`beep`,doc:`The ASCII Bell character, which can be used to trigger a beep sound in the console.`,children:o` "\\u0007"; `}),e(g,{}),e(m,{const:!0,export:!0,name:`cursor`,doc:`An object containing ANSI escape codes for controlling the console cursor.`,children:o` {
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { For, Show, code } from "@alloy-js/core";
+import { ElseClause, ElseIfClause, FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, TypeDeclaration, VarDeclaration } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { ClassDeclaration, ClassField, ClassMethod, ClassPropertyGet, ClassPropertySet } from "@powerlines/plugin-alloy/typescript";
+import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+import { TSDoc, TSDocDefaultValue, TSDocExample, TSDocParam, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { IsNotDebug, IsNotVerbose } from "@shell-shock/core/components/helpers";
+import { useColors, useTheme } from "@shell-shock/plugin-theme/contexts/theme";
+import { colorKeys, modifierKeys } from "@shell-shock/plugin-theme/helpers/ansi-utils";
+import { camelCase, titleCase } from "@stryke/string-format";
+import { getIndefiniteArticle } from "@stryke/string-format/vowels";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { defu } from "defu";
+
+//#region src/components/console-builtin.tsx
+function AnsiHelpersDeclarations() {
+	return [
+		createComponent(VarDeclaration, {
+			"const": true,
+			"export": true,
+			name: "beep",
+			doc: "The ASCII Bell character, which can be used to trigger a beep sound in the console.",
+			children: code` "\\u0007"; `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(VarDeclaration, {
+			"const": true,
+			"export": true,
+			name: "cursor",
+			doc: "An object containing ANSI escape codes for controlling the console cursor.",
+			children: code` {
           to(x: number, y?: number) {
             if (!y) {
               return \`\\x1B[\${x + 1}G\`;
@@ -34,7 +65,15 @@ import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"
           show: "\\x1B[?25h",
           save: "\\x1B7",
           restore: "\\x1B8"
-        } `}),e(g,{}),e(m,{const:!0,export:!0,name:`erase`,doc:`An object containing ANSI escape codes for erasing parts of the console.`,children:o` {
+        } `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(VarDeclaration, {
+			"const": true,
+			"export": true,
+			name: "erase",
+			doc: "An object containing ANSI escape codes for erasing parts of the console.",
+			children: code` {
           screen: "\\x1B[2J",
           up: (count = 1) => "\\x1B[1J".repeat(count),
           down: (count = 1) => "\\x1B[J".repeat(count),
@@ -53,10 +92,34 @@ import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"
 
             return lineClear;
           }
-        } `}),e(g,{}),e(m,{const:!0,export:!0,name:`scroll`,doc:`An object containing ANSI escape codes for scrolling the console.`,children:o` {
+        } `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(VarDeclaration, {
+			"const": true,
+			"export": true,
+			name: "scroll",
+			doc: "An object containing ANSI escape codes for scrolling the console.",
+			children: code` {
           up: (count = 1) => "\\x1B[S".repeat(count),
           down: (count = 1) => "\\x1B[T".repeat(count)
-        } `}),e(g,{}),e(l,{export:!0,name:`clear`,doc:`A helper function to clear the console based on a count of lines`,parameters:[{name:`current`,type:`string`,doc:`The current console output to be cleared`},{name:`consoleWidth`,type:`number`,doc:`The number of characters per line in the console`}],children:o`if (!consoleWidth) {
+        } `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "clear",
+			doc: "A helper function to clear the console based on a count of lines",
+			parameters: [{
+				name: "current",
+				type: "string",
+				doc: "The current console output to be cleared"
+			}, {
+				name: "consoleWidth",
+				type: "number",
+				doc: "The number of characters per line in the console"
+			}],
+			children: code`if (!consoleWidth) {
           return erase.line + cursor.to(0);
         }
 
@@ -66,7 +129,16 @@ import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"
           rows += 1 + Math.floor(Math.max([...stripAnsi(line)].length - 1, 0) / consoleWidth);
         }
 
-        return erase.lines(rows); `}),e(g,{})]}function F({ansi16:e,ansi256:t,ansi16m:n,skipBackground:r=!1}){return o` (text: string | number | boolean | null | undefined${r?``:`, background = false`}): string => {
+        return erase.lines(rows); `
+		}),
+		createComponent(Spacing, {})
+	];
+}
+/**
+* A component to generate a console message function in a Shell Shock project.
+*/
+function ColorFunction({ ansi16, ansi256, ansi16m, skipBackground = false }) {
+	return code` (text: string | number | boolean | null | undefined${skipBackground ? "" : `, background = false`}): string => {
     try {
       if (text === undefined || text === null || text === "") {
         return "";
@@ -77,17 +149,321 @@ import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"
       }
 
       if (colorSupportLevels.stdout === 1) {
-        return wrapAnsi(String(text), ${r?`"${e.open}", "${e.close}"`:`background ? "${e.background.open}" : "${e.open}", background ? "${e.background.close}" : "${e.close}"`});
+        return wrapAnsi(String(text), ${skipBackground ? `"${ansi16.open}", "${ansi16.close}"` : `background ? "${ansi16.background.open}" : "${ansi16.open}", background ? "${ansi16.background.close}" : "${ansi16.close}"`});
       } else if (colorSupportLevels.stdout === 2) {
-        return wrapAnsi(String(text), ${r?`"${t.open}", "${t.close}"`:`background ? "${t.background.open}" : "${t.open}", background ? "${t.background.close}" : "${t.close}"`});
+        return wrapAnsi(String(text), ${skipBackground ? `"${ansi256.open}", "${ansi256.close}"` : `background ? "${ansi256.background.open}" : "${ansi256.open}", background ? "${ansi256.background.close}" : "${ansi256.close}"`});
       }
 
-      return wrapAnsi(String(text), ${r?`"${n.open}", "${n.close}"`:`background ? "${n.background.open}" : "${n.open}", background ? "${n.background.close}" : "${n.close}"`});
+      return wrapAnsi(String(text), ${skipBackground ? `"${ansi16m.open}", "${ansi16m.close}"` : `background ? "${ansi16m.background.open}" : "${ansi16m.open}", background ? "${ansi16m.background.close}" : "${ansi16m.close}"`});
     } catch {
       return String(text);
     }
   }
-`}function I(r){let{ansi16:s,ansi256:c,ansi16m:l,type:u,subType:d}=r;return e(i,{get each(){return Object.entries(s)},semicolon:!0,doubleHardline:!0,enderPunctuation:!0,children:([r,i])=>[e(a,{get when(){return M(i)},get children(){return e(a,{get when(){return`open`in i&&`close`in i},get fallback(){return[e(x,{heading:`An object containing various ${d?`${d} `:``}${r}${u?` ${u}`:``} theme coloring functions.`}),n(()=>o` ${k(r)}: { `),t(`hbr`,{}),e(I,{get ansi16(){return s[r]},get ansi256(){return c[r]},get ansi16m(){return l[r]},type:d||u,subType:r}),t(`hbr`,{}),o` }`]},get children(){return[e(x,{get heading(){return`A function that applies ${j(r)} ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling to provided console text.`},get children(){return[e(T,{children:`This function takes a string and an optional boolean indicating whether to apply the color as a background. It returns the input string wrapped in the appropriate ANSI escape codes for ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling, based on the terminal's color support level. If colors are not supported, it simply returns the input text as a string.`}),t(`hbr`,{}),e(w,{name:`text`,children:`The console text to which the ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling should be applied.`}),e(w,{name:`background`,children:"A boolean indicating whether to apply the color as a background. Defaults to `false`."}),e(E,{children:`A string with ANSI escape codes applied for ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling, or the original text if the style is not supported in the current terminal.`})]}}),n(()=>o`${k(r)}: (text: string, background?: boolean) => string`)]}})}})]})}function L(r){let{ansi16:s,ansi256:c,ansi16m:l,type:u,subType:d}=r;return e(i,{get each(){return Object.entries(s)},comma:!0,doubleHardline:!0,enderPunctuation:!0,children:([r,i])=>[e(a,{get when(){return M(i)},get children(){return e(a,{get when(){return`open`in i&&`close`in i},get fallback(){return[e(x,{heading:`An object containing various ${d?`${d} `:``}${r}${u?` ${u}`:``} theme coloring functions.`}),n(()=>o` ${k(r)}: { `),t(`hbr`,{}),e(L,{get ansi16(){return s[r]},get ansi256(){return c[r]},get ansi16m(){return l[r]},type:d||u,subType:r}),t(`hbr`,{}),o` }`]},get children(){return[e(x,{get heading(){return`A function that applies ${j(r)} ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling to provided console text.`},get children(){return[e(T,{children:`This function takes a string and an optional boolean indicating whether to apply the color as a background. It returns the input string wrapped in the appropriate ANSI escape codes for ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling, based on the terminal's color support level. If colors are not supported, it simply returns the input text as a string.`}),t(`hbr`,{}),e(w,{name:`text`,children:`The console text to which the ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling should be applied.`}),e(w,{name:`background`,children:"A boolean indicating whether to apply the color as a background. Defaults to `false`."}),e(E,{children:`A string with ANSI escape codes applied for ${r}${u?` ${u}`:``}${d?` ${d}`:``} color styling, or the original text if the style is not supported in the current terminal.`})]}}),n(()=>o`${k(r)}: `),e(F,{get ansi16(){return s[r]},get ansi256(){return c[r]},get ansi16m(){return l[r]}})]}})}})]})}function R(){let n=re();return[e(i,{each:ae,semicolon:!0,doubleHardline:!0,enderPunctuation:!0,children:t=>[e(x,{get heading(){return`A function that applies ${j(A(t))} ${A(t)} text-style to provided console text.`},get children(){return[e(w,{name:`text`,get children(){return`The console text to which the ${A(t)} text-style should be applied.`}}),e(E,{get children(){return`A string with ANSI escape codes applied for ${A(t)} text-style, or the original text if the style is not supported in the current terminal.`}})]}}),e(m,{const:!0,export:!0,get name(){return k(t)},get initializer(){return e(F,{get ansi16(){return n.ansi16[t]},get ansi256(){return n.ansi256[t]},get ansi16m(){return n.ansi16m[t]},skipBackground:!0})}})]}),e(g,{}),e(i,{each:ie,semicolon:!0,doubleHardline:!0,enderPunctuation:!0,children:r=>[e(x,{get heading(){return`A function that applies ${j(A(r))} ${A(r)} color styling to provided console text.`},get children(){return[e(T,{get children(){return`This function takes a string and an optional boolean indicating whether to apply the color as a background. It returns the input string wrapped in the appropriate ANSI escape codes for ${j(A(r))} ${A(r)} color styling, based on the terminal's color support level. If colors are not supported, it simply returns the input text as a string.`}}),t(`hbr`,{}),e(w,{name:`text`,get children(){return`The console text to which the ${A(r)} color styling should be applied.`}}),e(w,{name:`background`,children:"A boolean indicating whether to apply the color as a background. Defaults to `false`."}),e(E,{get children(){return`A string with ANSI escape codes applied for ${A(r)} color styling, or the original text if the style is not supported in the current terminal.`}})]}}),e(m,{const:!0,export:!0,get name(){return k(r)},get initializer(){return e(F,{get ansi16(){return n.ansi16[r]},get ansi256(){return n.ansi256[r]},get ansi16m(){return n.ansi16m[r]}})}})]}),e(g,{}),e(i,{get each(){return Object.keys(n.ansi16.theme)},semicolon:!0,doubleHardline:!0,enderPunctuation:!0,children:r=>[e(x,{heading:`A nested object containing functions for applying ${r} theme colors to the console.`}),e(m,{export:!0,get name(){return`${k(r)}Colors`},get initializer(){return[o` {`,t(`hbr`,{}),e(L,{get ansi16(){return n.ansi16.theme[r]},get ansi256(){return n.ansi256.theme[r]},get ansi16m(){return n.ansi16m.theme[r]},type:r}),t(`hbr`,{}),o`}`]}})]}),e(g,{})]}function z(){return[e(l,{name:`adjustIndex`,parameters:[{name:`line`,type:`string`,doc:`An input line which may contain ANSI escape codes. This is used to adjust the index for splitting the line based on visible characters rather than raw string length, ensuring that ANSI codes do not cause incorrect splitting of the text.`},{name:`index`,type:`number`,doc:`The index at which to split the line, based on visible characters (does not account for ANSI escape codes).`}],returnType:`number`,children:o`let adjustedIndex = 0;
+`;
+}
+function ThemeColorTypeDefinition(props) {
+	const { ansi16, ansi256, ansi16m, type, subType } = props;
+	return createComponent(For, {
+		get each() {
+			return Object.entries(ansi16);
+		},
+		semicolon: true,
+		doubleHardline: true,
+		enderPunctuation: true,
+		children: ([color, value]) => [createComponent(Show, {
+			get when() {
+				return isSetObject(value);
+			},
+			get children() {
+				return createComponent(Show, {
+					get when() {
+						return "open" in value && "close" in value;
+					},
+					get fallback() {
+						return [
+							createComponent(TSDoc, { heading: `An object containing various ${subType ? `${subType} ` : ""}${color}${type ? ` ${type}` : ""} theme coloring functions.` }),
+							memo(() => code` ${camelCase(color)}: { `),
+							createIntrinsic("hbr", {}),
+							createComponent(ThemeColorTypeDefinition, {
+								get ansi16() {
+									return ansi16[color];
+								},
+								get ansi256() {
+									return ansi256[color];
+								},
+								get ansi16m() {
+									return ansi16m[color];
+								},
+								type: subType || type,
+								subType: color
+							}),
+							createIntrinsic("hbr", {}),
+							code` }`
+						];
+					},
+					get children() {
+						return [createComponent(TSDoc, {
+							get heading() {
+								return `A function that applies ${getIndefiniteArticle(color)} ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling to provided console text.`;
+							},
+							get children() {
+								return [
+									createComponent(TSDocRemarks, { children: `This function takes a string and an optional boolean indicating whether to apply the color as a background. It returns the input string wrapped in the appropriate ANSI escape codes for ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling, based on the terminal's color support level. If colors are not supported, it simply returns the input text as a string.` }),
+									createIntrinsic("hbr", {}),
+									createComponent(TSDocParam, {
+										name: "text",
+										children: `The console text to which the ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling should be applied.`
+									}),
+									createComponent(TSDocParam, {
+										name: "background",
+										children: `A boolean indicating whether to apply the color as a background. Defaults to \`false\`.`
+									}),
+									createComponent(TSDocReturns, { children: `A string with ANSI escape codes applied for ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling, or the original text if the style is not supported in the current terminal.` })
+								];
+							}
+						}), memo(() => code`${camelCase(color)}: (text: string, background?: boolean) => string`)];
+					}
+				});
+			}
+		})]
+	});
+}
+function ThemeColorObjectDefinition(props) {
+	const { ansi16, ansi256, ansi16m, type, subType } = props;
+	return createComponent(For, {
+		get each() {
+			return Object.entries(ansi16);
+		},
+		comma: true,
+		doubleHardline: true,
+		enderPunctuation: true,
+		children: ([color, value]) => [createComponent(Show, {
+			get when() {
+				return isSetObject(value);
+			},
+			get children() {
+				return createComponent(Show, {
+					get when() {
+						return "open" in value && "close" in value;
+					},
+					get fallback() {
+						return [
+							createComponent(TSDoc, { heading: `An object containing various ${subType ? `${subType} ` : ""}${color}${type ? ` ${type}` : ""} theme coloring functions.` }),
+							memo(() => code` ${camelCase(color)}: { `),
+							createIntrinsic("hbr", {}),
+							createComponent(ThemeColorObjectDefinition, {
+								get ansi16() {
+									return ansi16[color];
+								},
+								get ansi256() {
+									return ansi256[color];
+								},
+								get ansi16m() {
+									return ansi16m[color];
+								},
+								type: subType || type,
+								subType: color
+							}),
+							createIntrinsic("hbr", {}),
+							code` }`
+						];
+					},
+					get children() {
+						return [
+							createComponent(TSDoc, {
+								get heading() {
+									return `A function that applies ${getIndefiniteArticle(color)} ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling to provided console text.`;
+								},
+								get children() {
+									return [
+										createComponent(TSDocRemarks, { children: `This function takes a string and an optional boolean indicating whether to apply the color as a background. It returns the input string wrapped in the appropriate ANSI escape codes for ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling, based on the terminal's color support level. If colors are not supported, it simply returns the input text as a string.` }),
+										createIntrinsic("hbr", {}),
+										createComponent(TSDocParam, {
+											name: "text",
+											children: `The console text to which the ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling should be applied.`
+										}),
+										createComponent(TSDocParam, {
+											name: "background",
+											children: `A boolean indicating whether to apply the color as a background. Defaults to \`false\`.`
+										}),
+										createComponent(TSDocReturns, { children: `A string with ANSI escape codes applied for ${color}${type ? ` ${type}` : ""}${subType ? ` ${subType}` : ""} color styling, or the original text if the style is not supported in the current terminal.` })
+									];
+								}
+							}),
+							memo(() => code`${camelCase(color)}: `),
+							createComponent(ColorFunction, {
+								get ansi16() {
+									return ansi16[color];
+								},
+								get ansi256() {
+									return ansi256[color];
+								},
+								get ansi16m() {
+									return ansi16m[color];
+								}
+							})
+						];
+					}
+				});
+			}
+		})]
+	});
+}
+/**
+* A component to generate an object containing functions for coloring text in a Shell Shock project.
+*/
+function AnsiStyleFunctionsDeclaration() {
+	const colors = useColors();
+	return [
+		createComponent(For, {
+			each: modifierKeys,
+			semicolon: true,
+			doubleHardline: true,
+			enderPunctuation: true,
+			children: (modifier) => [createComponent(TSDoc, {
+				get heading() {
+					return `A function that applies ${getIndefiniteArticle(titleCase(modifier))} ${titleCase(modifier)} text-style to provided console text.`;
+				},
+				get children() {
+					return [createComponent(TSDocParam, {
+						name: "text",
+						get children() {
+							return `The console text to which the ${titleCase(modifier)} text-style should be applied.`;
+						}
+					}), createComponent(TSDocReturns, { get children() {
+						return `A string with ANSI escape codes applied for ${titleCase(modifier)} text-style, or the original text if the style is not supported in the current terminal.`;
+					} })];
+				}
+			}), createComponent(VarDeclaration, {
+				"const": true,
+				"export": true,
+				get name() {
+					return camelCase(modifier);
+				},
+				get initializer() {
+					return createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16[modifier];
+						},
+						get ansi256() {
+							return colors.ansi256[modifier];
+						},
+						get ansi16m() {
+							return colors.ansi16m[modifier];
+						},
+						skipBackground: true
+					});
+				}
+			})]
+		}),
+		createComponent(Spacing, {}),
+		createComponent(For, {
+			each: colorKeys,
+			semicolon: true,
+			doubleHardline: true,
+			enderPunctuation: true,
+			children: (color) => [createComponent(TSDoc, {
+				get heading() {
+					return `A function that applies ${getIndefiniteArticle(titleCase(color))} ${titleCase(color)} color styling to provided console text.`;
+				},
+				get children() {
+					return [
+						createComponent(TSDocRemarks, { get children() {
+							return `This function takes a string and an optional boolean indicating whether to apply the color as a background. It returns the input string wrapped in the appropriate ANSI escape codes for ${getIndefiniteArticle(titleCase(color))} ${titleCase(color)} color styling, based on the terminal's color support level. If colors are not supported, it simply returns the input text as a string.`;
+						} }),
+						createIntrinsic("hbr", {}),
+						createComponent(TSDocParam, {
+							name: "text",
+							get children() {
+								return `The console text to which the ${titleCase(color)} color styling should be applied.`;
+							}
+						}),
+						createComponent(TSDocParam, {
+							name: "background",
+							children: `A boolean indicating whether to apply the color as a background. Defaults to \`false\`.`
+						}),
+						createComponent(TSDocReturns, { get children() {
+							return `A string with ANSI escape codes applied for ${titleCase(color)} color styling, or the original text if the style is not supported in the current terminal.`;
+						} })
+					];
+				}
+			}), createComponent(VarDeclaration, {
+				"const": true,
+				"export": true,
+				get name() {
+					return camelCase(color);
+				},
+				get initializer() {
+					return createComponent(ColorFunction, {
+						get ansi16() {
+							return colors.ansi16[color];
+						},
+						get ansi256() {
+							return colors.ansi256[color];
+						},
+						get ansi16m() {
+							return colors.ansi16m[color];
+						}
+					});
+				}
+			})]
+		}),
+		createComponent(Spacing, {}),
+		createComponent(For, {
+			get each() {
+				return Object.keys(colors.ansi16.theme);
+			},
+			semicolon: true,
+			doubleHardline: true,
+			enderPunctuation: true,
+			children: (type) => [createComponent(TSDoc, { heading: `A nested object containing functions for applying ${type} theme colors to the console.` }), createComponent(VarDeclaration, {
+				"export": true,
+				get name() {
+					return `${camelCase(type)}Colors`;
+				},
+				get initializer() {
+					return [
+						code` {`,
+						createIntrinsic("hbr", {}),
+						createComponent(ThemeColorObjectDefinition, {
+							get ansi16() {
+								return colors.ansi16.theme[type];
+							},
+							get ansi256() {
+								return colors.ansi256.theme[type];
+							},
+							get ansi16m() {
+								return colors.ansi16m.theme[type];
+							},
+							type
+						}),
+						createIntrinsic("hbr", {}),
+						code`}`
+					];
+				}
+			})]
+		}),
+		createComponent(Spacing, {})
+	];
+}
+/**
+* A component to generate the `splitText` function in the `shell-shock:console` builtin module.
+*/
+function SplitTextFunctionDeclaration() {
+	return [
+		createComponent(FunctionDeclaration, {
+			name: "adjustIndex",
+			parameters: [{
+				name: "line",
+				type: "string",
+				doc: "An input line which may contain ANSI escape codes. This is used to adjust the index for splitting the line based on visible characters rather than raw string length, ensuring that ANSI codes do not cause incorrect splitting of the text."
+			}, {
+				name: "index",
+				type: "number",
+				doc: "The index at which to split the line, based on visible characters (does not account for ANSI escape codes)."
+			}],
+			returnType: "number",
+			children: code`let adjustedIndex = 0;
         let visibleCount = 0;
         const ansiRegex = new RegExp([
           String.raw\`[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)\`,
@@ -106,7 +482,20 @@ import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"
           }
         }
 
-        return adjustedIndex; `}),e(g,{}),e(l,{name:`breakLine`,parameters:[{name:`line`,type:`string`},{name:`index`,type:`number`}],returnType:`[string, string]`,children:o`const adjustedIndex = adjustIndex(line, index);
+        return adjustedIndex; `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(FunctionDeclaration, {
+			name: "breakLine",
+			parameters: [{
+				name: "line",
+				type: "string"
+			}, {
+				name: "index",
+				type: "number"
+			}],
+			returnType: "[string, string]",
+			children: code`const adjustedIndex = adjustIndex(line, index);
         const first = line.slice(0, adjustedIndex);
         const second = line.slice(adjustedIndex);
 
@@ -155,7 +544,37 @@ import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"
         // Prepend open codes to the start of "second"
         const openSequence = openCodes.join("");
 
-        return [first.replace(/^\\s+/, "").replace(/\\s+$/, "") + closeSequence, openSequence + second.replace(/^\\s+/, "").replace(/\\s+$/, "")]; `}),e(g,{}),e(x,{heading:`Split text into multiple lines based on a maximum length.`,get children(){return[e(T,{children:`This function splits the provided text into multiple lines based on the specified maximum length, ensuring that words are not broken in the middle.`}),t(`hbr`,{}),e(w,{name:`text`,children:`The text to split into multiple lines.`}),e(w,{name:`maxLength`,children:`The maximum length of each line.`})]}}),e(l,{name:`splitText`,export:!0,parameters:[{name:`text`,type:`string`},{name:`maxLength`,type:`number | SizeToken`}],children:o`let line = text;
+        return [first.replace(/^\\s+/, "").replace(/\\s+$/, "") + closeSequence, openSequence + second.replace(/^\\s+/, "").replace(/\\s+$/, "")]; `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Split text into multiple lines based on a maximum length.",
+			get children() {
+				return [
+					createComponent(TSDocRemarks, { children: `This function splits the provided text into multiple lines based on the specified maximum length, ensuring that words are not broken in the middle.` }),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDocParam, {
+						name: "text",
+						children: `The text to split into multiple lines.`
+					}),
+					createComponent(TSDocParam, {
+						name: "maxLength",
+						children: `The maximum length of each line.`
+					})
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			name: "splitText",
+			"export": true,
+			parameters: [{
+				name: "text",
+				type: "string"
+			}, {
+				name: "maxLength",
+				type: "number | SizeToken"
+			}],
+			children: code`let line = text;
         let result = [] as string[];
 
         const calculatedMaxLength = isSizeToken(maxLength) ? calculateWidth(maxLength) : maxLength;
@@ -193,35 +612,272 @@ import{createComponent as e,createIntrinsic as t,memo as n,mergeProps as r}from"
         }
 
         result.push(line);
-        return result; `})]}function B(){return[e(d,{export:!0,name:`WriteOptions`,doc:`Options for writing to the console.`,get children(){return[e(x,{heading:`Console function to use for writing to the console`,get children(){return[e(T,{children:"The console function to use for writing to the console. If not specified, the default console function `console.log` will be used."}),t(`hbr`,{}),e(S,{get type(){return h.method},defaultValue:"`console.log`"})]}}),e(f,{name:`consoleFn`,optional:!0,type:`(text: string) => void`})]}}),e(g,{}),e(x,{heading:`Write to the console.`,get children(){return[e(T,{children:`This function writes to the console, applying the appropriate padding as defined in the current theme configuration and wrapping as needed.`}),t(`hbr`,{}),e(w,{name:`text`,children:`The text to write to the console.`}),e(w,{name:`options`,children:`The options to apply when writing to the console.`})]}}),e(l,{export:!0,name:`write`,parameters:[{name:`text`,type:`string | number | boolean | null`,optional:!0},{name:`options`,type:`WriteOptions`,default:`{}`}],children:o`const consoleFn = options.consoleFn ?? console.log;
+        return result; `
+		})
+	];
+}
+/**
+* A component to generate the `write` function in the `shell-shock:console` builtin module.
+*/
+function WriteFunctionDeclaration() {
+	return [
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "WriteOptions",
+			doc: "Options for writing to the console.",
+			get children() {
+				return [createComponent(TSDoc, {
+					heading: "Console function to use for writing to the console",
+					get children() {
+						return [
+							createComponent(TSDocRemarks, { children: `The console function to use for writing to the console. If not specified, the default console function \`console.log\` will be used.` }),
+							createIntrinsic("hbr", {}),
+							createComponent(TSDocDefaultValue, {
+								type: "any",
+								defaultValue: `\`console.log\``
+							})
+						];
+					}
+				}), createComponent(InterfaceMember, {
+					name: "consoleFn",
+					optional: true,
+					type: "(text: string) => void"
+				})];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Write to the console.",
+			get children() {
+				return [
+					createComponent(TSDocRemarks, { children: `This function writes to the console, applying the appropriate padding as defined in the current theme configuration and wrapping as needed.` }),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDocParam, {
+						name: "text",
+						children: `The text to write to the console.`
+					}),
+					createComponent(TSDocParam, {
+						name: "options",
+						children: `The options to apply when writing to the console.`
+					})
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "write",
+			parameters: [{
+				name: "text",
+				type: "string | number | boolean | null",
+				optional: true
+			}, {
+				name: "options",
+				type: "WriteOptions",
+				default: "{}"
+			}],
+			children: code`const consoleFn = options.consoleFn ?? console.log;
         if (text === undefined || text === null || text === "") {
           consoleFn("");
           return;
         }
 
-        consoleFn(String(text)); `})]}function V(){let n=O();return[e(d,{export:!0,name:`WriteLineOptions`,doc:`Options for writing a line to the console.`,extends:[`WriteOptions`],get children(){return[e(x,{heading:`Padding to apply to the line`,get children(){return e(T,{children:`The amount of padding (in spaces) to apply to the line when writing to the console. This value is applied to both the left and right sides of the line. If not specified, the default padding defined in the current theme configuration will be used.`})}}),e(f,{name:`padding`,optional:!0,type:`number`}),t(`hbr`,{}),e(x,{heading:`Color of the line text`,get children(){return[e(T,{children:`The color to apply to the line text when writing to the console. This can be one of the predefined color themes: "primary", "secondary", or "tertiary". If not specified, no specific coloring will be applied to the text (the default/system terminal text color will likely be used).`}),t(`hbr`,{})]}}),e(f,{name:`color`,optional:!0,type:`"primary" | "secondary" | "tertiary"`})]}}),e(g,{}),e(x,{heading:`Write a line to the console.`,get children(){return[e(T,{children:`This function writes a line to the console, applying the appropriate padding as defined in the current theme configuration and wrapping as needed.`}),t(`hbr`,{}),e(w,{name:`text`,children:`The line text to write to the console.`}),e(w,{name:`options`,children:`The options to apply when writing the line to the console.`})]}}),e(l,{export:!0,name:`writeLine`,parameters:[{name:`text`,type:`string | number | boolean | null`,optional:!0},{name:`options`,type:`WriteLineOptions`,default:`{}`}],get children(){return o`const color = options.color;
+        consoleFn(String(text)); `
+		})
+	];
+}
+/**
+* A component to generate the `writeLine` function in the `shell-shock:console` builtin module.
+*/
+function WriteLineFunctionDeclaration() {
+	const theme = useTheme();
+	return [
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "WriteLineOptions",
+			doc: "Options for writing a line to the console.",
+			"extends": ["WriteOptions"],
+			get children() {
+				return [
+					createComponent(TSDoc, {
+						heading: "Padding to apply to the line",
+						get children() {
+							return createComponent(TSDocRemarks, { children: `The amount of padding (in spaces) to apply to the line when writing to the console. This value is applied to both the left and right sides of the line. If not specified, the default padding defined in the current theme configuration will be used.` });
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "padding",
+						optional: true,
+						type: "number"
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDoc, {
+						heading: "Color of the line text",
+						get children() {
+							return [createComponent(TSDocRemarks, { children: `The color to apply to the line text when writing to the console. This can be one of the predefined color themes: "primary", "secondary", or "tertiary". If not specified, no specific coloring will be applied to the text (the default/system terminal text color will likely be used).` }), createIntrinsic("hbr", {})];
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "color",
+						optional: true,
+						type: "\"primary\" | \"secondary\" | \"tertiary\""
+					})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Write a line to the console.",
+			get children() {
+				return [
+					createComponent(TSDocRemarks, { children: `This function writes a line to the console, applying the appropriate padding as defined in the current theme configuration and wrapping as needed.` }),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDocParam, {
+						name: "text",
+						children: `The line text to write to the console.`
+					}),
+					createComponent(TSDocParam, {
+						name: "options",
+						children: `The options to apply when writing the line to the console.`
+					})
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "writeLine",
+			parameters: [{
+				name: "text",
+				type: "string | number | boolean | null",
+				optional: true
+			}, {
+				name: "options",
+				type: "WriteLineOptions",
+				default: "{}"
+			}],
+			get children() {
+				return code`const color = options.color;
         if (text === undefined || text === null || text === "") {
           write("", options);
           return;
         }
 
-        write(\`\${" ".repeat(Math.max(options.padding ?? ${n.padding.app}, 0))}\${color ? textColors.body[color](String(text)) : String(text)}\`, options); `}})]}function H(r){let{type:i,variant:s,consoleFnName:c,description:u,prefix:d,parameters:f,timestamp:p,color:m=s}=r,h=O();return[e(x,{get heading(){return`Write ${j(u)} ${u} message to the console.`},get children(){return[e(T,{children:`This function initializes the Powerlines environment configuration object.`}),t(`hbr`,{}),e(w,{name:`message`,children:`The message to write to the console.`}),e(w,{name:`header`,children:`An optional header to display above the message. If not provided, a default header based on the message type and variant will be used if defined in the theme configuration; otherwise, no header will be displayed.`})]}}),e(l,{export:!0,name:i,parameters:f??[{name:`message`,type:`string`,optional:!1},{name:`header`,type:`string`,optional:!0}],get children(){return[e(a,{get when(){return!!d},get children(){return[d,t(`hbr`,{}),t(`hbr`,{})]}}),n(()=>o`
+        write(\`\${" ".repeat(Math.max(options.padding ?? ${theme.padding.app}, 0))}\${color ? textColors.body[color](String(text)) : String(text)}\`, options); `;
+			}
+		})
+	];
+}
+/**
+* A component to generate the message functions in the `shell-shock:console` builtin module.
+*/
+function MessageFunctionDeclaration(props) {
+	const { type, variant, consoleFnName, description, prefix, parameters, timestamp, color = variant } = props;
+	const theme = useTheme();
+	return [createComponent(TSDoc, {
+		get heading() {
+			return `Write ${getIndefiniteArticle(description)} ${description} message to the console.`;
+		},
+		get children() {
+			return [
+				createComponent(TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
+				createIntrinsic("hbr", {}),
+				createComponent(TSDocParam, {
+					name: "message",
+					children: `The message to write to the console.`
+				}),
+				createComponent(TSDocParam, {
+					name: "header",
+					children: `An optional header to display above the message. If not provided, a default header based on the message type and variant will be used if defined in the theme configuration; otherwise, no header will be displayed.`
+				})
+			];
+		}
+	}), createComponent(FunctionDeclaration, {
+		"export": true,
+		name: type,
+		parameters: parameters ?? [{
+			name: "message",
+			type: "string",
+			optional: false
+		}, {
+			name: "header",
+			type: "string",
+			optional: true
+		}],
+		get children() {
+			return [createComponent(Show, {
+				get when() {
+					return Boolean(prefix);
+				},
+				get children() {
+					return [
+						prefix,
+						createIntrinsic("hbr", {}),
+						createIntrinsic("hbr", {})
+					];
+				}
+			}), memo(() => code`
         if (!message) {
           return;
         }
 
-        ${!h.labels.message.footer[s]&&p?`const timestamp = \`\${textColors.message.footer.${m}(new Date().toLocaleDateString())} \${borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].bottom}")} \${textColors.message.footer.${m}(new Date().toLocaleTimeString())}\`; `:``}
+        ${!theme.labels.message.footer[variant] && timestamp ? `const timestamp = \`\${textColors.message.footer.${color}(new Date().toLocaleDateString())} \${borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].bottom}")} \${textColors.message.footer.${color}(new Date().toLocaleTimeString())}\`; ` : ""}
 
-        writeLine(borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].topLeft}") + ${h.labels.message.header[s]||h.icons.message.header[s]?`borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].top}".repeat(4)) + " " + ${h.icons.message.header[s]?`borderColors.message.outline.${m}("${h.icons.message.header[s]}") + " " +`:``} bold(textColors.message.header.${m}(header || "${h.labels.message.header[s]}")) + " " + borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].top}".repeat(Math.max(getTerminalSize().columns - ${Math.max(h.padding.app,0)*2+h.borderStyles.message.outline[s].topLeft.length+4+(h.icons.message.header[s]?2+ +!h.labels.message.header[s]:0)+(h.labels.message.header[s]?h.labels.message.header[s].length+2:0)+h.borderStyles.message.outline[s].topRight.length}, 0)))`:`borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].top}".repeat(Math.max(getTerminalSize().columns - ${Math.max(h.padding.app,0)*2+h.borderStyles.message.outline[s].topLeft.length+h.borderStyles.message.outline[s].topRight.length}, 0)))`} + borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].topRight}"), { consoleFn: console.${c} });
+        writeLine(borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].topLeft}") + ${theme.labels.message.header[variant] || theme.icons.message.header[variant] ? `borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].top}".repeat(4)) + " " + ${theme.icons.message.header[variant] ? `borderColors.message.outline.${color}("${theme.icons.message.header[variant]}") + " " +` : ""} bold(textColors.message.header.${color}(header || "${theme.labels.message.header[variant]}")) + " " + borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].top}".repeat(Math.max(getTerminalSize().columns - ${Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.message.outline[variant].topLeft.length + 4 + (theme.icons.message.header[variant] ? 2 + (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].topRight.length}, 0)))` : `borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].top}".repeat(Math.max(getTerminalSize().columns - ${Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.message.outline[variant].topLeft.length + theme.borderStyles.message.outline[variant].topRight.length}, 0)))`} + borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].topRight}"), { consoleFn: console.${consoleFnName} });
         splitText(
           message,
-          Math.max(getTerminalSize().columns - ${(Math.max(h.padding.app,0)+Math.max(h.padding.message,0))*2+h.borderStyles.message.outline[s].left.length+h.borderStyles.message.outline[s].right.length}, 12)
+          Math.max(getTerminalSize().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}, 12)
         ).forEach(line => {
-          writeLine(borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].left+` `.repeat(Math.max(h.padding.message,0))}") + textColors.message.description.${m}(line) + " ".repeat(Math.max(getTerminalSize().columns - (stripAnsi(line).length + ${Math.max(h.padding.app,0)*2+Math.max(h.padding.message,0)+h.borderStyles.message.outline[s].left.length+h.borderStyles.message.outline[s].right.length}), 0)) + borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].right}"), { consoleFn: console.${c} });
+          writeLine(borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].left + " ".repeat(Math.max(theme.padding.message, 0))}") + textColors.message.description.${color}(line) + " ".repeat(Math.max(getTerminalSize().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)) + borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].right}"), { consoleFn: console.${consoleFnName} });
         });
-        writeLine(borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].bottomLeft}") + ${h.labels.message.footer[s]||p?`borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].bottom}".repeat(Math.max(getTerminalSize().columns - ${Math.max(h.padding.app,0)*2+4+(h.labels.message.footer[s]?h.labels.message.footer[s].length+2:0)+h.borderStyles.message.outline[s].bottomLeft.length+h.borderStyles.message.outline[s].bottomRight.length}${!h.labels.message.footer[s]&&p?` - (stripAnsi(timestamp).length + 2)`:``}, 0))) + " " + ${`bold(textColors.message.footer.${m}(${h.labels.message.footer[s]?`"${h.labels.message.footer[s]}"`:p&&`timestamp`}))`} + " " + borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].bottom}".repeat(4))`:`borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].bottom}".repeat(Math.max(getTerminalSize().columns - ${Math.max(h.padding.app,0)*2+h.borderStyles.message.outline[s].bottomLeft.length+h.borderStyles.message.outline[s].bottomRight.length}, 0)))`} + borderColors.message.outline.${m}("${h.borderStyles.message.outline[s].bottomRight}"), { consoleFn: console.${c} });
-`)]}})]}function U(){return[e(x,{heading:`Applies ANSI escape codes to a string.`,get children(){return[e(T,{children:`Split text by /\\\\x1b[\\[|\\]][0-9;]*m/ and wrap non-ANSI parts with open/closing tags.`}),e(C,{children:`const result = wrapAnsi("Hello\\\\x1b[31mWorld\\\\x1b[0mAgain", "\\\\x1b[36m", "\\\\x1b[39");
-console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\\x1b[36mAgain\\\\x1b[39"`}),e(w,{name:`text`,children:`The text to apply ANSI codes to.`}),e(w,{name:`open`,children:`The opening ANSI code.`}),e(w,{name:`close`,children:`The closing ANSI code.`}),e(E,{children:`The text with ANSI codes applied.`})]}}),e(l,{name:`wrapAnsi`,parameters:[{name:`text`,type:`string | number`,optional:!1},{name:`open`,type:`string`,optional:!1},{name:`close`,type:`string`,optional:!1}],children:o`const str = String(text);
+        writeLine(borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].bottomLeft}") + ${theme.labels.message.footer[variant] || timestamp ? `borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].bottom}".repeat(Math.max(getTerminalSize().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))) + " " + ${`bold(textColors.message.footer.${color}(${theme.labels.message.footer[variant] ? `"${theme.labels.message.footer[variant]}"` : timestamp && "timestamp"}))`} + " " + borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].bottom}".repeat(4))` : `borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].bottom}".repeat(Math.max(getTerminalSize().columns - ${Math.max(theme.padding.app, 0) * 2 + theme.borderStyles.message.outline[variant].bottomLeft.length + theme.borderStyles.message.outline[variant].bottomRight.length}, 0)))`} + borderColors.message.outline.${color}("${theme.borderStyles.message.outline[variant].bottomRight}"), { consoleFn: console.${consoleFnName} });
+`)];
+		}
+	})];
+}
+/**
+* A component to generate the `wrapAnsi` function in the `shell-shock:console` builtin module.
+*/
+function WrapAnsiFunction() {
+	return [createComponent(TSDoc, {
+		heading: "Applies ANSI escape codes to a string.",
+		get children() {
+			return [
+				createComponent(TSDocRemarks, { children: `Split text by /\\\\x1b[\\[|\\]][0-9;]*m/ and wrap non-ANSI parts with open/closing tags.` }),
+				createComponent(TSDocExample, { children: `const result = wrapAnsi("Hello\\\\x1b[31mWorld\\\\x1b[0mAgain", "\\\\x1b[36m", "\\\\x1b[39");\nconsole.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\\x1b[36mAgain\\\\x1b[39"` }),
+				createComponent(TSDocParam, {
+					name: "text",
+					children: `The text to apply ANSI codes to.`
+				}),
+				createComponent(TSDocParam, {
+					name: "open",
+					children: `The opening ANSI code.`
+				}),
+				createComponent(TSDocParam, {
+					name: "close",
+					children: `The closing ANSI code.`
+				}),
+				createComponent(TSDocReturns, { children: `The text with ANSI codes applied.` })
+			];
+		}
+	}), createComponent(FunctionDeclaration, {
+		name: "wrapAnsi",
+		parameters: [
+			{
+				name: "text",
+				type: "string | number",
+				optional: false
+			},
+			{
+				name: "open",
+				type: "string",
+				optional: false
+			},
+			{
+				name: "close",
+				type: "string",
+				optional: false
+			}
+		],
+		children: code`const str = String(text);
         const tokens = [] as string[];
 
         let last = 0;
@@ -254,15 +910,235 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
         }
 
         return result;
-`})]}function W(){return[e(x,{heading:`Removes ANSI escape codes from a string.`,get children(){return[e(C,{children:`const result = stripAnsi("Hello\\\\x1b[31mWorld\\\\x1b[0mAgain"); // "HelloWorldAgain"`}),e(w,{name:`text`,children:`The text to strip ANSI codes from.`}),e(E,{children:`The text with ANSI codes removed.`})]}}),e(l,{export:!0,name:`stripAnsi`,parameters:[{name:`text`,type:`string | number`,optional:!1}],children:o`return String(text).replace(new RegExp([
+`
+	})];
+}
+/**
+* A component to generate the `stripAnsi` function in the `shell-shock:console` builtin module.
+*/
+function StripAnsiFunctionDeclaration() {
+	return [createComponent(TSDoc, {
+		heading: "Removes ANSI escape codes from a string.",
+		get children() {
+			return [
+				createComponent(TSDocExample, { children: `const result = stripAnsi("Hello\\\\x1b[31mWorld\\\\x1b[0mAgain"); // "HelloWorldAgain"` }),
+				createComponent(TSDocParam, {
+					name: "text",
+					children: `The text to strip ANSI codes from.`
+				}),
+				createComponent(TSDocReturns, { children: `The text with ANSI codes removed.` })
+			];
+		}
+	}), createComponent(FunctionDeclaration, {
+		"export": true,
+		name: "stripAnsi",
+		parameters: [{
+			name: "text",
+			type: "string | number",
+			optional: false
+		}],
+		children: code`return String(text).replace(new RegExp([
           String.raw\`[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)\`,
           String.raw\`(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]))\`
-        ].join("|"), "g"), "");`})]}function G(){let n=O();return[e(d,{export:!0,name:`DividerOptions`,doc:`Options for formatting the divider line written to console.`,get children(){return[e(f,{name:`width`,optional:!0,type:`number`,doc:`The width of the divider line. If not specified, the divider will span the full width of the console, minus the padding.`}),t(`hbr`,{}),e(x,{heading:`The border of the divider line. Can be 'primary', 'secondary', 'tertiary', or 'none'. If not specified, the default border style will be used.`,get children(){return[e(T,{children:`The value provided will determine the border style and color based on the current theme configuration.`}),e(S,{get type(){return h.string},defaultValue:`primary`})]}}),e(f,{name:`border`,optional:!0,type:`"primary" | "secondary" | "tertiary"`,doc:`The border style/color of the divider line. Can be 'primary', 'secondary', 'tertiary', or 'none'. If not specified, the default border style will be used.`}),t(`hbr`,{}),e(x,{heading:`Padding to apply to the line`,get children(){return[e(T,{children:`The amount of padding (in spaces) to apply to the line when writing to the console. This value is applied to both the left and right sides of the line. If not specified, the default padding defined in the current theme configuration will be used.`}),e(S,{get type(){return h.number},get defaultValue(){return n.padding.app*4}})]}}),e(f,{name:`padding`,optional:!0,type:`number`})]}}),e(g,{}),e(x,{heading:`Write a horizontal divider line to the console.`,get children(){return[e(C,{children:`divider({ width: 50, border: "primary" }); // Writes a horizontal divider line of width 50 with primary border.`}),e(w,{name:`options`,children:`Options for formatting the divider line.`})]}}),e(l,{export:!0,name:`divider`,parameters:[{name:`options`,type:`DividerOptions`,optional:!1}],get children(){return o`const padding = options.padding ?? ${Math.max(n.padding.app,1)*4};
+        ].join("|"), "g"), "");`
+	})];
+}
+/**
+* A component to generate the `stripAnsi` function in the `shell-shock:console` builtin module.
+*/
+function DividerFunctionDeclaration() {
+	const theme = useTheme();
+	return [
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "DividerOptions",
+			doc: "Options for formatting the divider line written to console.",
+			get children() {
+				return [
+					createComponent(InterfaceMember, {
+						name: "width",
+						optional: true,
+						type: "number",
+						doc: "The width of the divider line. If not specified, the divider will span the full width of the console, minus the padding."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDoc, {
+						heading: "The border of the divider line. Can be 'primary', 'secondary', 'tertiary', or 'none'. If not specified, the default border style will be used.",
+						get children() {
+							return [createComponent(TSDocRemarks, { children: `The value provided will determine the border style and color based on the current theme configuration.` }), createComponent(TSDocDefaultValue, {
+								type: "string",
+								defaultValue: "primary"
+							})];
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "border",
+						optional: true,
+						type: "\"primary\" | \"secondary\" | \"tertiary\"",
+						doc: "The border style/color of the divider line. Can be 'primary', 'secondary', 'tertiary', or 'none'. If not specified, the default border style will be used."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDoc, {
+						heading: "Padding to apply to the line",
+						get children() {
+							return [createComponent(TSDocRemarks, { children: `The amount of padding (in spaces) to apply to the line when writing to the console. This value is applied to both the left and right sides of the line. If not specified, the default padding defined in the current theme configuration will be used.` }), createComponent(TSDocDefaultValue, {
+								type: "number",
+								get defaultValue() {
+									return theme.padding.app * 4;
+								}
+							})];
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "padding",
+						optional: true,
+						type: "number"
+					})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Write a horizontal divider line to the console.",
+			get children() {
+				return [createComponent(TSDocExample, { children: `divider({ width: 50, border: "primary" }); // Writes a horizontal divider line of width 50 with primary border.` }), createComponent(TSDocParam, {
+					name: "options",
+					children: `Options for formatting the divider line.`
+				})];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "divider",
+			parameters: [{
+				name: "options",
+				type: "DividerOptions",
+				optional: false
+			}],
+			get children() {
+				return code`const padding = options.padding ?? ${Math.max(theme.padding.app, 1) * 4};
         const width = options.width ?? (getTerminalSize().columns - (Math.max(padding, 0) * 2));
-        const border = options.border === "tertiary" ? borderColors.app.divider.tertiary("${n.borderStyles.app.divider.tertiary.top}") : options.border === "secondary" ? borderColors.app.divider.secondary("${n.borderStyles.app.divider.secondary.top}") : borderColors.app.divider.primary("${n.borderStyles.app.divider.primary.top}");
+        const border = options.border === "tertiary" ? borderColors.app.divider.tertiary("${theme.borderStyles.app.divider.tertiary.top}") : options.border === "secondary" ? borderColors.app.divider.secondary("${theme.borderStyles.app.divider.secondary.top}") : borderColors.app.divider.primary("${theme.borderStyles.app.divider.primary.top}");
 
-        writeLine(" ".repeat(Math.max(padding - ${n.padding.app}, 0)) + border.repeat(Math.max(width / ${n.borderStyles.app.divider.primary.top.length??1}, 0)));
-        `}})]}function K(){let r=O();return[e(d,{export:!0,name:`LinkOptions`,doc:`Options for formatting a hyperlink in the console.`,get children(){return[e(f,{name:`external`,optional:!0,type:`boolean`,doc:`Whether the link is external. If true, an external link icon will be displayed next to the link text (if supported by the terminal) and the link may be styled differently based on the current theme configuration.`}),e(g,{}),e(f,{name:`text`,optional:!0,type:`string`,doc:`The text to display for the link. If not provided, the URL will be used as the text.`}),e(g,{}),e(f,{name:`useTextWhenUnsupported`,optional:!0,type:`boolean`,doc:`Whether to use the text when the hyperlink is not supported. If true, the text will be displayed even if the terminal does not support hyperlinks.`})]}}),e(g,{}),e(x,{heading:`Render a hyperlink in the console.`,get children(){return[e(w,{name:`url`,children:`The URL to render as a hyperlink.`}),e(w,{name:`options`,children:`Options for formatting the hyperlink.`}),e(E,{children:`The formatted hyperlink string for display in the console.`})]}}),e(l,{export:!0,name:`link`,parameters:[{name:`url`,type:`string`,optional:!1},{name:`options`,type:`LinkOptions`,default:`{}`}],get children(){return[e(u,{condition:o`isHyperlinkSupported()`,get children(){return o`return \`\\x1b]8;;\${url}\\u0007\${options.text ? options.text : url}\\x1b]8;;\\u0007\${options.external === true ? "${r.icons.link.external}" : ""}\`;`}}),t(`hbr`,{}),e(u,{condition:o`isColorSupported`,get children(){return o`return \`\${underline(textColors.body.link(\`\${options.useTextWhenUnsupported && options.text ? options.text : url}\`))}\${options.external === true ? "${r.icons.link.external}" : ""}\`;`}}),t(`hbr`,{}),n(()=>o`return \`\${options.useTextWhenUnsupported && options.text ? options.text : url}\${options.external === true ? "${r.icons.link.external}" : ""}\`;`)]}})]}function q(){let t=O();return[e(g,{}),e(x,{heading:`Format a string with blockquote styling for display in console.`,get children(){return[e(w,{name:`text`,children:`The text to format with blockquote styling.`}),e(E,{children:`The formatted string with blockquote styling.`})]}}),e(l,{export:!0,name:`blockquote`,parameters:[{name:`text`,type:`string | number | boolean | null`,optional:!0}],returnType:`string`,get children(){return o`if (text === undefined || text === null || text === "") {
+        writeLine(" ".repeat(Math.max(padding - ${theme.padding.app}, 0)) + border.repeat(Math.max(width / ${theme.borderStyles.app.divider.primary.top.length ?? 1}, 0)));
+        `;
+			}
+		})
+	];
+}
+/**
+* A component to generate the `link` function in the `shell-shock:console` builtin module.
+*/
+function LinkFunctionDeclaration() {
+	const theme = useTheme();
+	return [
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "LinkOptions",
+			doc: "Options for formatting a hyperlink in the console.",
+			get children() {
+				return [
+					createComponent(InterfaceMember, {
+						name: "external",
+						optional: true,
+						type: "boolean",
+						doc: "Whether the link is external. If true, an external link icon will be displayed next to the link text (if supported by the terminal) and the link may be styled differently based on the current theme configuration."
+					}),
+					createComponent(Spacing, {}),
+					createComponent(InterfaceMember, {
+						name: "text",
+						optional: true,
+						type: "string",
+						doc: "The text to display for the link. If not provided, the URL will be used as the text."
+					}),
+					createComponent(Spacing, {}),
+					createComponent(InterfaceMember, {
+						name: "useTextWhenUnsupported",
+						optional: true,
+						type: "boolean",
+						doc: "Whether to use the text when the hyperlink is not supported. If true, the text will be displayed even if the terminal does not support hyperlinks."
+					})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Render a hyperlink in the console.",
+			get children() {
+				return [
+					createComponent(TSDocParam, {
+						name: "url",
+						children: `The URL to render as a hyperlink.`
+					}),
+					createComponent(TSDocParam, {
+						name: "options",
+						children: `Options for formatting the hyperlink.`
+					}),
+					createComponent(TSDocReturns, { children: `The formatted hyperlink string for display in the console.` })
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "link",
+			parameters: [{
+				name: "url",
+				type: "string",
+				optional: false
+			}, {
+				name: "options",
+				type: "LinkOptions",
+				default: "{}"
+			}],
+			get children() {
+				return [
+					createComponent(IfStatement, {
+						condition: code`isHyperlinkSupported()`,
+						get children() {
+							return code`return \`\\x1b]8;;\${url}\\u0007\${options.text ? options.text : url}\\x1b]8;;\\u0007\${options.external === true ? "${theme.icons.link.external}" : ""}\`;`;
+						}
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(IfStatement, {
+						condition: code`isColorSupported`,
+						get children() {
+							return code`return \`\${underline(textColors.body.link(\`\${options.useTextWhenUnsupported && options.text ? options.text : url}\`))}\${options.external === true ? "${theme.icons.link.external}" : ""}\`;`;
+						}
+					}),
+					createIntrinsic("hbr", {}),
+					memo(() => code`return \`\${options.useTextWhenUnsupported && options.text ? options.text : url}\${options.external === true ? "${theme.icons.link.external}" : ""}\`;`)
+				];
+			}
+		})
+	];
+}
+/**
+* A component to generate the `blockquote` function declaration
+*/
+function BlockquoteFunctionDeclaration() {
+	const theme = useTheme();
+	return [
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: `Format a string with blockquote styling for display in console.`,
+			get children() {
+				return [createComponent(TSDocParam, {
+					name: "text",
+					children: `The text to format with blockquote styling.`
+				}), createComponent(TSDocReturns, { children: `The formatted string with blockquote styling.` })];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "blockquote",
+			parameters: [{
+				name: "text",
+				type: "string | number | boolean | null",
+				optional: true
+			}],
+			returnType: "string",
+			get children() {
+				return code`if (text === undefined || text === null || text === "") {
           return "";
         }
 
@@ -271,7 +1147,42 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
           Math.max(getTerminalSize().columns, 20) - 6
         );
 
-        return lines.map(line => \`\${borderColors.app.blockquote.primary(isUnicodeSupported() ? "${t.borderStyles.app.blockquote.primary.left}"  : "|")}   \${italic(line)} \`).join("\\n"); `}})]}function J(){let t=O();return[e(g,{}),e(x,{heading:`Format a source code string for display in console.`,get children(){return[e(w,{name:`text`,children:`The source code text to format with code styling.`}),e(E,{children:`The formatted string with code styling.`})]}}),e(l,{export:!0,name:`code`,parameters:[{name:`text`,type:`string | number | boolean | null`,optional:!0},{name:`language`,type:`string`,optional:!0}],returnType:`string`,get children(){return o`if (text === undefined || text === null || text === "") {
+        return lines.map(line => \`\${borderColors.app.blockquote.primary(isUnicodeSupported() ? "${theme.borderStyles.app.blockquote.primary.left}"  : "|")}   \${italic(line)} \`).join("\\n"); `;
+			}
+		})
+	];
+}
+/**
+* A component to generate the `code` function declaration
+*/
+function CodeFunctionDeclaration() {
+	const theme = useTheme();
+	return [
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: `Format a source code string for display in console.`,
+			get children() {
+				return [createComponent(TSDocParam, {
+					name: "text",
+					children: `The source code text to format with code styling.`
+				}), createComponent(TSDocReturns, { children: `The formatted string with code styling.` })];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "code",
+			parameters: [{
+				name: "text",
+				type: "string | number | boolean | null",
+				optional: true
+			}, {
+				name: "language",
+				type: "string",
+				optional: true
+			}],
+			returnType: "string",
+			get children() {
+				return code`if (text === undefined || text === null || text === "") {
           return "";
         }
 
@@ -280,12 +1191,185 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
           Math.max(getTerminalSize().columns, 20)
         );
 
-        return \` \${borderColors.app.divider.primary("${t.borderStyles.app.divider.primary.top}".repeat(4))}\${language ? \` \${borderColors.app.divider.primary(language)} \` : ""}\${borderColors.app.divider.primary("${t.borderStyles.app.divider.primary.top}".repeat(getTerminalSize().columns - (language ? language.length + 2 : 0) - 5))} \\n\${lines.map((line, index) => \` \${" ".repeat(String(lines.length).length - String(index + 1).length)}\${textColors.body.tertiary(index + 1)} \${textColors.body.primary(line)}\`).join("\\n")}\`; `}})]}function Y(){return[e(g,{}),e(x,{heading:`Format a string with inline code styling for display in console.`,get children(){return[e(w,{name:`text`,children:`The text to format with inline code styling.`}),e(E,{children:`The formatted string with inline code styling.`})]}}),e(l,{export:!0,name:`inlineCode`,parameters:[{name:`text`,type:`string | number | boolean | null`,optional:!0}],returnType:`string`,children:o`if (text === undefined || text === null || text === "") {
+        return \` \${borderColors.app.divider.primary("${theme.borderStyles.app.divider.primary.top}".repeat(4))}\${language ? \` \${borderColors.app.divider.primary(language)} \` : ""}\${borderColors.app.divider.primary("${theme.borderStyles.app.divider.primary.top}".repeat(getTerminalSize().columns - (language ? language.length + 2 : 0) - 5))} \\n\${lines.map((line, index) => \` \${" ".repeat(String(lines.length).length - String(index + 1).length)}\${textColors.body.tertiary(index + 1)} \${textColors.body.primary(line)}\`).join("\\n")}\`; `;
+			}
+		})
+	];
+}
+/**
+* A component to generate the `inlineCode` function declaration
+*/
+function InlineCodeFunctionDeclaration() {
+	return [
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: `Format a string with inline code styling for display in console.`,
+			get children() {
+				return [createComponent(TSDocParam, {
+					name: "text",
+					children: `The text to format with inline code styling.`
+				}), createComponent(TSDocReturns, { children: `The formatted string with inline code styling.` })];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "inlineCode",
+			parameters: [{
+				name: "text",
+				type: "string | number | boolean | null",
+				optional: true
+			}],
+			returnType: "string",
+			children: code`if (text === undefined || text === null || text === "") {
           return "";
         }
 
-        return inverse(\`\${text}\`); `})]}function X(){let r=O();return[e(p,{name:`WriteStream`,children:`NodeJS.WriteStream;`}),e(g,{}),e(m,{const:!0,name:`activeHooksPerStream`,initializer:`new Set();`}),e(g,{}),e(d,{export:!0,name:`SpinnerOptions`,doc:`Options for configuring the spinner.`,get children(){return[e(f,{name:`message`,optional:!0,type:`string`,doc:`The message text to display next to the spinner. Defaults to an empty string.`}),t(`hbr`,{}),e(f,{name:`stream`,optional:!0,type:`WriteStream`,doc:`The output stream to write the spinner to. Defaults to process.stderr.`}),t(`hbr`,{}),e(f,{name:`spinner`,optional:!0,type:`ThemeSpinnerResolvedConfig | SpinnerPreset`,doc:`The spinner animation to use. Should be an object with a 'frames' property (an array of strings representing each frame of the animation) and an 'interval' property (the time in milliseconds between each frame). If not specified, a default spinner animation will be used.`})]}}),e(g,{}),e(ee,{name:`Spinner`,get children(){return[e(_,{name:`frames`,isPrivateMember:!0,type:`string[]`}),t(`hbr`,{}),e(_,{name:`interval`,isPrivateMember:!0,type:`number`}),t(`hbr`,{}),e(_,{name:`currentFrame`,isPrivateMember:!0,type:`number`,children:o`-1`}),t(`hbr`,{}),e(_,{name:`timer`,isPrivateMember:!0,optional:!0,type:`NodeJS.Timeout`}),t(`hbr`,{}),e(_,{name:`message`,isPrivateMember:!0,type:`string`,children:o`""`}),t(`hbr`,{}),e(_,{name:`stream`,isPrivateMember:!0,type:`WriteStream`,children:o`process.stderr`}),t(`hbr`,{}),e(_,{name:`lines`,isPrivateMember:!0,type:`number`,children:o`0`}),t(`hbr`,{}),e(_,{name:`exitHandlerBound`,isPrivateMember:!0,type:`(signal: any) => void`,children:o`() => {}`}),t(`hbr`,{}),e(_,{name:`lastSpinnerFrameTime`,isPrivateMember:!0,type:`number`,children:o`0`}),t(`hbr`,{}),e(_,{name:`isSpinning`,isPrivateMember:!0,type:`boolean`,children:o`false`}),t(`hbr`,{}),e(_,{name:`hookedStreams`,isPrivateMember:!0,type:`Map<WriteStream, { write?: WriteStream["write"]; originalWrite: WriteStream["write"]; hookedWrite: WriteStream["write"] }>`,children:o`new Map()`}),t(`hbr`,{}),e(_,{name:`isInternalWrite`,isPrivateMember:!0,type:`boolean`,children:o`false`}),t(`hbr`,{}),e(_,{name:`isDeferringRender`,isPrivateMember:!0,type:`boolean`,children:o`false`}),e(g,{}),n(()=>o`constructor(options: SpinnerOptions = {}) {
-          const spinner = (typeof options.spinner === "string" ? resolveSpinner(options.spinner as SpinnerPreset) : options.spinner) ?? ${JSON.stringify(r.spinner)};
+        return inverse(\`\${text}\`); `
+		})
+	];
+}
+/**
+* A component to generate the `spinner` function in the `shell-shock:console` builtin module.
+*/
+function SpinnerFunctionDeclaration() {
+	const theme = useTheme();
+	return [
+		createComponent(TypeDeclaration, {
+			name: "WriteStream",
+			children: `NodeJS.WriteStream;`
+		}),
+		createComponent(Spacing, {}),
+		createComponent(VarDeclaration, {
+			"const": true,
+			name: "activeHooksPerStream",
+			initializer: "new Set();"
+		}),
+		createComponent(Spacing, {}),
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "SpinnerOptions",
+			doc: "Options for configuring the spinner.",
+			get children() {
+				return [
+					createComponent(InterfaceMember, {
+						name: "message",
+						optional: true,
+						type: "string",
+						doc: "The message text to display next to the spinner. Defaults to an empty string."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "stream",
+						optional: true,
+						type: "WriteStream",
+						doc: "The output stream to write the spinner to. Defaults to process.stderr."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "spinner",
+						optional: true,
+						type: "ThemeSpinnerResolvedConfig | SpinnerPreset",
+						doc: "The spinner animation to use. Should be an object with a 'frames' property (an array of strings representing each frame of the animation) and an 'interval' property (the time in milliseconds between each frame). If not specified, a default spinner animation will be used."
+					})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(ClassDeclaration, {
+			name: "Spinner",
+			get children() {
+				return [
+					createComponent(ClassField, {
+						name: "frames",
+						isPrivateMember: true,
+						type: "string[]"
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "interval",
+						isPrivateMember: true,
+						type: "number"
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "currentFrame",
+						isPrivateMember: true,
+						type: "number",
+						children: code`-1`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "timer",
+						isPrivateMember: true,
+						optional: true,
+						type: "NodeJS.Timeout"
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "message",
+						isPrivateMember: true,
+						type: "string",
+						children: code`""`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "stream",
+						isPrivateMember: true,
+						type: "WriteStream",
+						children: code`process.stderr`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "lines",
+						isPrivateMember: true,
+						type: "number",
+						children: code`0`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "exitHandlerBound",
+						isPrivateMember: true,
+						type: "(signal: any) => void",
+						children: code`() => {}`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "lastSpinnerFrameTime",
+						isPrivateMember: true,
+						type: "number",
+						children: code`0`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "isSpinning",
+						isPrivateMember: true,
+						type: "boolean",
+						children: code`false`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "hookedStreams",
+						isPrivateMember: true,
+						type: "Map<WriteStream, { write?: WriteStream[\"write\"]; originalWrite: WriteStream[\"write\"]; hookedWrite: WriteStream[\"write\"] }>",
+						children: code`new Map()`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "isInternalWrite",
+						isPrivateMember: true,
+						type: "boolean",
+						children: code`false`
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(ClassField, {
+						name: "isDeferringRender",
+						isPrivateMember: true,
+						type: "boolean",
+						children: code`false`
+					}),
+					createComponent(Spacing, {}),
+					memo(() => code`constructor(options: SpinnerOptions = {}) {
+          const spinner = (typeof options.spinner === "string" ? resolveSpinner(options.spinner as SpinnerPreset) : options.spinner) ?? ${JSON.stringify(theme.spinner)};
           this.#frames = spinner.frames;
           this.#interval = spinner.interval;
 
@@ -489,7 +1573,49 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
           }
 
           process.exit(signal === "SIGINT" ? 130 : (signal === "SIGTERM" ? 143 : 1));
-        } `),e(y,{public:!0,name:`isSpinning`,type:`boolean`,doc:`Whether the spinner is currently active and spinning.`,children:o`return this.#isSpinning;`}),e(g,{}),e(te,{public:!0,name:`message`,type:`string`,doc:`Set the message displayed by the spinner.`,children:o`this.#message = value;`}),e(g,{}),e(y,{public:!0,name:`message`,type:`string`,doc:`Get the message displayed by the spinner.`,children:o`return this.#message;`}),e(g,{}),e(v,{name:`start`,doc:`Start the spinner animation.`,parameters:[{name:`message`,type:`string`}],get children(){return[e(u,{condition:o`message !== undefined`,children:o`this.#message = message;`}),e(u,{condition:o`this.isSpinning`,children:o`return this;`}),o`this.#isSpinning = true;
+        } `),
+					createComponent(ClassPropertyGet, {
+						"public": true,
+						name: "isSpinning",
+						type: "boolean",
+						doc: "Whether the spinner is currently active and spinning.",
+						children: code`return this.#isSpinning;`
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassPropertySet, {
+						"public": true,
+						name: "message",
+						type: "string",
+						doc: "Set the message displayed by the spinner.",
+						children: code`this.#message = value;`
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassPropertyGet, {
+						"public": true,
+						name: "message",
+						type: "string",
+						doc: "Get the message displayed by the spinner.",
+						children: code`return this.#message;`
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "start",
+						doc: "Start the spinner animation.",
+						parameters: [{
+							name: "message",
+							type: "string"
+						}],
+						get children() {
+							return [
+								createComponent(IfStatement, {
+									condition: code`message !== undefined`,
+									children: code`this.#message = message;`
+								}),
+								createComponent(IfStatement, {
+									condition: code`this.isSpinning`,
+									children: code`return this;`
+								}),
+								code`this.#isSpinning = true;
           this.#hideCursor();
           this.#installHook();
           this.#render();
@@ -502,7 +1628,20 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
           }
 
           return this;
-          `]}}),e(g,{}),e(v,{name:`stop`,doc:`Stop the spinner animation.`,parameters:[{name:`finalMessage`,optional:!0,type:`string`}],children:o`if (!this.isSpinning) {
+          `
+							];
+						}
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "stop",
+						doc: "Stop the spinner animation.",
+						parameters: [{
+							name: "finalMessage",
+							optional: true,
+							type: "string"
+						}],
+						children: code`if (!this.isSpinning) {
             return this;
           }
 
@@ -526,7 +1665,13 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
 
           return this;
 
-          `}),e(g,{}),e(v,{name:`clear`,doc:`Clear the spinner animation.`,children:o`if (!isInteractive) {
+          `
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "clear",
+						doc: "Clear the spinner animation.",
+						children: code`if (!isInteractive) {
             return this;
           }
 
@@ -547,20 +1692,474 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
           });
 
           this.#lines = 0;
-          return this; `}),e(g,{}),e(v,{name:`success`,doc:`Mark the spinner as successful.`,parameters:[{name:`message`,type:`string`}],get children(){return o`return this.#stopWithIcon(textColors.spinner.icon.success("${r.icons.spinner.success}"), textColors.spinner.message.success(message)); `}}),e(g,{}),e(v,{name:`error`,doc:`Mark the spinner as failed.`,parameters:[{name:`message`,type:`string`}],get children(){return o`return this.#stopWithIcon(textColors.spinner.icon.error("${r.icons.spinner.error}"), textColors.spinner.message.error(message)); `}}),e(g,{}),e(v,{name:`warning`,doc:`Mark the spinner as warning.`,parameters:[{name:`message`,type:`string`}],get children(){return o`return this.#stopWithIcon(textColors.spinner.icon.warning("${r.icons.spinner.warning}"), textColors.spinner.message.warning(message)); `}}),e(g,{}),e(v,{name:`info`,doc:`Mark the spinner as informational.`,parameters:[{name:`message`,type:`string`}],get children(){return o`return this.#stopWithIcon(textColors.spinner.icon.info("${r.icons.spinner.info}"), textColors.spinner.message.info(message)); `}}),e(g,{}),e(v,{name:`help`,doc:`Mark the spinner as help.`,parameters:[{name:`message`,type:`string`}],get children(){return o`return this.#stopWithIcon(textColors.spinner.icon.help("${r.icons.spinner.help}"), textColors.spinner.message.help(message)); `}}),e(g,{})]}}),e(g,{}),e(x,{heading:`Render a spinner in the console.`,get children(){return[e(w,{name:`options`,children:`Options for configuring the spinner, including the message to display, the output stream to write to, and the spinner animation to use.`}),e(E,{children:`An instance of the Spinner class, which can be used to control the spinner animation (e.g., start, stop, mark as success/error, etc.).`})]}}),e(l,{export:!0,name:`createSpinner`,parameters:[{name:`options`,type:`SpinnerOptions`,optional:!0}],children:o`return new Spinner(options);`})]}function Z(e,t){return`borderOptions.${e} === "primary" ? borderColors.app.table.primary("${t.borderStyles.app.table.primary[e]}") : borderOptions.${e} === "secondary" ? borderColors.app.table.secondary("${t.borderStyles.app.table.secondary[e]}") : borderOptions.${e} === "tertiary" ? borderColors.app.table.tertiary("${t.borderStyles.app.table.tertiary[e]}") : !borderOptions.${e} || borderOptions.${e} === "none" ? "" : borderOptions.${e}`}function Q(e,t){return`borderOptions === "primary" ? borderColors.app.table.primary("${t.borderStyles.app.table.primary[e]}") : borderOptions === "secondary" ? borderColors.app.table.secondary("${t.borderStyles.app.table.secondary[e]}") : borderOptions === "tertiary" ? borderColors.app.table.tertiary("${t.borderStyles.app.table.tertiary[e]}") : !borderOptions || borderOptions === "none" ? "" : borderOptions`}function $(i){let a=O();return[e(p,{export:!0,name:`SizeToken`,doc:`A type representing the width size of an item in the console.`,children:o`"full" | "1/1" | "1/2" | "1/3" | "1/4" | "1/5" | "1/6" | "1/12" | "1/24" | "100%" | "50%" | "33.33%" | "25%" | "20%" | "10%" | "5%" | "2.5%"`}),e(g,{}),e(x,{heading:`Determine if a value is a valid size token.`,get children(){return[e(T,{children:`This function checks if the provided value is a valid size token, which can be one of the predefined strings representing common width sizes (e.g., "full", "1/2", "1/3", etc.) or percentage strings (e.g., "50%").`}),e(w,{name:`value`,children:`The value to check for being a valid size token.`}),e(E,{children:`True if the value is a valid size token, false otherwise.`})]}}),e(l,{export:!0,doc:`Determines if the provided value is a valid size token.`,name:`isSizeToken`,parameters:[{name:`value`,type:`any`}],returnType:`value is SizeToken`,get children(){return[e(u,{condition:o`["full", "1/1", "1/2", "1/3", "1/4", "1/5", "1/6", "1/12", "1/24", "100%", "50%", "33.33%", "25%", "20%", "10%", "5%", "2.5%"].includes(value)`,children:o`return true; `}),o`return false; `]}}),e(g,{}),e(x,{heading:`Calculate the width in characters based on the provided width size.`,get children(){return[e(T,{children:`This function calculates the width in characters based on the provided width size, which can be a predefined string (e.g., "full", "1/2", "1/3", etc.) or a percentage string (e.g., "50%"). The calculation is based on the current width of the console (getTerminalSize().columns).`}),e(w,{name:`size`,children:`The width size to calculate. This can be a predefined string (e.g., "full", "1/2", "1/3", etc.) or a percentage string (e.g., "50%").`}),e(E,{children:`The calculated width in characters.`})]}}),e(l,{export:!0,name:`calculateWidth`,parameters:[{name:`size`,type:`SizeToken`,optional:!1}],returnType:`number`,get children(){return[e(u,{condition:o`["full", "100%", "1/1"]. includes(size)`,children:o`return getTerminalSize().columns;`}),e(c,{condition:o`["1/2", "50%"].includes(size)`,children:o`return Math.round(getTerminalSize().columns / 2);`}),e(c,{condition:o`["1/3", "33.33%"].includes(size)`,children:o`return Math.round(getTerminalSize().columns / 3);`}),e(c,{condition:o`["1/4", "25%"].includes(size)`,children:o`return Math.round(getTerminalSize().columns / 4);`}),e(c,{condition:o`["1/5", "20%"].includes(size)`,children:o`return Math.round(getTerminalSize().columns / 5);`}),e(c,{condition:o`["1/6", "10%"].includes(size)`,children:o`return Math.round(getTerminalSize().columns / 6);`}),e(c,{condition:o`["1/12", "5%"].includes(size)`,children:o`return Math.round(getTerminalSize().columns / 12);`}),e(c,{condition:o`["1/24", "2.5%"].includes(size)`,children:o`return Math.round(getTerminalSize().columns / 24);`}),e(s,{children:o`
+          return this; `
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "success",
+						doc: "Mark the spinner as successful.",
+						parameters: [{
+							name: "message",
+							type: "string"
+						}],
+						get children() {
+							return code`return this.#stopWithIcon(textColors.spinner.icon.success("${theme.icons.spinner.success}"), textColors.spinner.message.success(message)); `;
+						}
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "error",
+						doc: "Mark the spinner as failed.",
+						parameters: [{
+							name: "message",
+							type: "string"
+						}],
+						get children() {
+							return code`return this.#stopWithIcon(textColors.spinner.icon.error("${theme.icons.spinner.error}"), textColors.spinner.message.error(message)); `;
+						}
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "warning",
+						doc: "Mark the spinner as warning.",
+						parameters: [{
+							name: "message",
+							type: "string"
+						}],
+						get children() {
+							return code`return this.#stopWithIcon(textColors.spinner.icon.warning("${theme.icons.spinner.warning}"), textColors.spinner.message.warning(message)); `;
+						}
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "info",
+						doc: "Mark the spinner as informational.",
+						parameters: [{
+							name: "message",
+							type: "string"
+						}],
+						get children() {
+							return code`return this.#stopWithIcon(textColors.spinner.icon.info("${theme.icons.spinner.info}"), textColors.spinner.message.info(message)); `;
+						}
+					}),
+					createComponent(Spacing, {}),
+					createComponent(ClassMethod, {
+						name: "help",
+						doc: "Mark the spinner as help.",
+						parameters: [{
+							name: "message",
+							type: "string"
+						}],
+						get children() {
+							return code`return this.#stopWithIcon(textColors.spinner.icon.help("${theme.icons.spinner.help}"), textColors.spinner.message.help(message)); `;
+						}
+					}),
+					createComponent(Spacing, {})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Render a spinner in the console.",
+			get children() {
+				return [createComponent(TSDocParam, {
+					name: "options",
+					children: `Options for configuring the spinner, including the message to display, the output stream to write to, and the spinner animation to use.`
+				}), createComponent(TSDocReturns, { children: `An instance of the Spinner class, which can be used to control the spinner animation (e.g., start, stop, mark as success/error, etc.).` })];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "createSpinner",
+			parameters: [{
+				name: "options",
+				type: "SpinnerOptions",
+				optional: true
+			}],
+			children: code`return new Spinner(options);`
+		})
+	];
+}
+function extractBorderOptionsObject(direction, theme) {
+	return `borderOptions.${direction} === "primary" ? borderColors.app.table.primary("${theme.borderStyles.app.table.primary[direction]}") : borderOptions.${direction} === "secondary" ? borderColors.app.table.secondary("${theme.borderStyles.app.table.secondary[direction]}") : borderOptions.${direction} === "tertiary" ? borderColors.app.table.tertiary("${theme.borderStyles.app.table.tertiary[direction]}") : !borderOptions.${direction} || borderOptions.${direction} === "none" ? "" : borderOptions.${direction}`;
+}
+function extractBorderOptionsString(direction, theme) {
+	return `borderOptions === "primary" ? borderColors.app.table.primary("${theme.borderStyles.app.table.primary[direction]}") : borderOptions === "secondary" ? borderColors.app.table.secondary("${theme.borderStyles.app.table.secondary[direction]}") : borderOptions === "tertiary" ? borderColors.app.table.tertiary("${theme.borderStyles.app.table.tertiary[direction]}") : !borderOptions || borderOptions === "none" ? "" : borderOptions`;
+}
+/**
+* Props for the TableFunctionDeclaration component.
+*/
+/**
+* A component to generate the table functions in the `shell-shock:console` builtin module.
+*/
+function TableFunctionDeclaration(props) {
+	const theme = useTheme();
+	return [
+		createComponent(TypeDeclaration, {
+			"export": true,
+			name: "SizeToken",
+			doc: "A type representing the width size of an item in the console.",
+			children: code`"full" | "1/1" | "1/2" | "1/3" | "1/4" | "1/5" | "1/6" | "1/12" | "1/24" | "100%" | "50%" | "33.33%" | "25%" | "20%" | "10%" | "5%" | "2.5%"`
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Determine if a value is a valid size token.",
+			get children() {
+				return [
+					createComponent(TSDocRemarks, { children: `This function checks if the provided value is a valid size token, which can be one of the predefined strings representing common width sizes (e.g., "full", "1/2", "1/3", etc.) or percentage strings (e.g., "50%").` }),
+					createComponent(TSDocParam, {
+						name: "value",
+						children: `The value to check for being a valid size token.`
+					}),
+					createComponent(TSDocReturns, { children: `True if the value is a valid size token, false otherwise.` })
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			doc: "Determines if the provided value is a valid size token.",
+			name: "isSizeToken",
+			parameters: [{
+				name: "value",
+				type: "any"
+			}],
+			returnType: "value is SizeToken",
+			get children() {
+				return [createComponent(IfStatement, {
+					condition: code`["full", "1/1", "1/2", "1/3", "1/4", "1/5", "1/6", "1/12", "1/24", "100%", "50%", "33.33%", "25%", "20%", "10%", "5%", "2.5%"].includes(value)`,
+					children: code`return true; `
+				}), code`return false; `];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Calculate the width in characters based on the provided width size.",
+			get children() {
+				return [
+					createComponent(TSDocRemarks, { children: `This function calculates the width in characters based on the provided width size, which can be a predefined string (e.g., "full", "1/2", "1/3", etc.) or a percentage string (e.g., "50%"). The calculation is based on the current width of the console (getTerminalSize().columns).` }),
+					createComponent(TSDocParam, {
+						name: "size",
+						children: `The width size to calculate. This can be a predefined string (e.g., "full", "1/2", "1/3", etc.) or a percentage string (e.g., "50%").`
+					}),
+					createComponent(TSDocReturns, { children: `The calculated width in characters.` })
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "calculateWidth",
+			parameters: [{
+				name: "size",
+				type: "SizeToken",
+				optional: false
+			}],
+			returnType: "number",
+			get children() {
+				return [
+					createComponent(IfStatement, {
+						condition: code`["full", "100%", "1/1"]. includes(size)`,
+						children: code`return getTerminalSize().columns;`
+					}),
+					createComponent(ElseIfClause, {
+						condition: code`["1/2", "50%"].includes(size)`,
+						children: code`return Math.round(getTerminalSize().columns / 2);`
+					}),
+					createComponent(ElseIfClause, {
+						condition: code`["1/3", "33.33%"].includes(size)`,
+						children: code`return Math.round(getTerminalSize().columns / 3);`
+					}),
+					createComponent(ElseIfClause, {
+						condition: code`["1/4", "25%"].includes(size)`,
+						children: code`return Math.round(getTerminalSize().columns / 4);`
+					}),
+					createComponent(ElseIfClause, {
+						condition: code`["1/5", "20%"].includes(size)`,
+						children: code`return Math.round(getTerminalSize().columns / 5);`
+					}),
+					createComponent(ElseIfClause, {
+						condition: code`["1/6", "10%"].includes(size)`,
+						children: code`return Math.round(getTerminalSize().columns / 6);`
+					}),
+					createComponent(ElseIfClause, {
+						condition: code`["1/12", "5%"].includes(size)`,
+						children: code`return Math.round(getTerminalSize().columns / 12);`
+					}),
+					createComponent(ElseIfClause, {
+						condition: code`["1/24", "2.5%"].includes(size)`,
+						children: code`return Math.round(getTerminalSize().columns / 24);`
+					}),
+					createComponent(ElseClause, { children: code`
             const match = size.match(/(\\d+(\\.\\d+)?)%/);
             if (match) {
               return Math.round((getTerminalSize().columns * parseFloat(match[1])) / 100);
             }
 
             throw new Error(\`Invalid width size: \${size}\`);
-          `}),e(g,{})]}}),e(p,{export:!0,name:`BorderOption`,doc:`The border options applied to table cells.`,children:o`"primary" | "secondary" | "tertiary" | "none" | string; `}),e(g,{}),e(d,{export:!0,name:`TableOutputOptions`,doc:`Options to customize the output of the {@link table} function.`,get children(){return[e(x,{heading:`Border variant for the table cell.`,get children(){return[e(T,{children:`The border variant to use for the table cell. This determines the color and style of the border around the cell.`}),t(`hbr`,{}),e(S,{get type(){return h.property},defaultValue:`primary`})]}}),e(f,{name:`border`,optional:!0,type:`BorderOption | { top?: BorderOption; right?: BorderOption; bottom?: BorderOption; left?: BorderOption; topLeft?: BorderOption; topRight?: BorderOption; bottomLeft?: BorderOption; bottomRight?: BorderOption; }`}),t(`hbr`,{}),e(x,{heading:`Padding for the table cell.`,get children(){return[e(T,{children:`The amount of padding (in spaces) to apply to the table cell. This value is applied to both the left and right sides of the cell. If not specified, the default table padding defined in the current theme configuration will be used.`}),t(`hbr`,{}),e(S,{get type(){return h.property},get defaultValue(){return`\`${a.padding.table}\``}})]}}),e(f,{name:`padding`,optional:!0,type:`number`}),t(`hbr`,{}),e(x,{heading:`Alignment for the table cell.`,get children(){return[e(T,{children:`The alignment for the table cell. This determines how the text within the cell is aligned. If not specified, the default alignment is "left".`}),t(`hbr`,{}),e(S,{get type(){return h.property},defaultValue:`left`})]}}),e(f,{name:`align`,optional:!0,type:`"left" | "right" | "center"`}),t(`hbr`,{})]}}),e(g,{}),e(d,{export:!0,name:`TableCellOptions`,extends:`TableOutputOptions`,doc:`Options for a specific table cell provided to the {@link table} function.`,get children(){return[e(f,{name:`value`,optional:!0,type:`string`,doc:`The actual string value of the table cell.`}),t(`hbr`,{}),e(x,{heading:`Width of the table cell.`,get children(){return e(T,{children:`The width of the table cell (where 1 is a single character in the terminal). If not specified, the width will be determined based on the content of the cell and the available space in the console.`})}}),e(f,{name:`maxWidth`,type:`number | SizeToken | undefined`}),t(`hbr`,{})]}}),e(g,{}),e(d,{export:!0,name:`TableRowOptions`,extends:`TableOutputOptions`,doc:`Options for a specific table row provided to the {@link table} function.`,get children(){return[e(f,{name:`values`,optional:!0,type:`(string | TableCellOptions)[]`,doc:`The actual string values of the table row's cells.`}),t(`hbr`,{})]}}),e(g,{}),e(d,{export:!0,name:`TableOptions`,extends:`TableOutputOptions`,doc:`Options for a specific table cell provided to the {@link table} function.`,get children(){return[e(f,{name:`values`,optional:!0,type:`(string | TableCellOptions)[][]`,doc:`The actual string values of the table's rows' cells.`}),t(`hbr`,{})]}}),e(g,{}),e(d,{name:`Dimensions`,doc:`The height and width for a specific table/cell used internally in the {@link table} function.`,get children(){return[e(f,{name:`height`,type:`number`,doc:`The height of the row/cell (where 1 is a single line in the terminal).`}),t(`hbr`,{}),e(f,{name:`width`,type:`number`,doc:`The width of the row/cell (where 1 is a single character in the terminal).`}),t(`hbr`,{})]}}),e(g,{}),e(d,{name:`TableCellBorder`,doc:`The resolved complete border styles for a table cell.`,get children(){return[e(f,{name:`top`,type:`string`,doc:`The top border style of the table cell.`}),t(`hbr`,{}),e(f,{name:`bottom`,type:`string`,doc:`The bottom border style of the table cell.`}),t(`hbr`,{}),e(f,{name:`right`,type:`string`,doc:`The right border style of the table cell.`}),t(`hbr`,{}),e(f,{name:`left`,type:`string`,doc:`The left border style of the table cell.`}),t(`hbr`,{}),e(f,{name:`topLeft`,type:`string`,doc:`The top-left border style of the table cell.`}),t(`hbr`,{}),e(f,{name:`topRight`,type:`string`,doc:`The top-right border style of the table cell.`}),t(`hbr`,{}),e(f,{name:`bottomLeft`,type:`string`,doc:`The bottom-left border style of the table cell.`}),t(`hbr`,{}),e(f,{name:`bottomRight`,type:`string`,doc:`The bottom-right border style of the table cell.`}),t(`hbr`,{})]}}),e(g,{}),e(p,{name:`TableCell`,doc:`The internal state of a formatted table cell in the {@link table} function.`,children:o`Required<Omit<TableCellOptions, "maxWidth" | "border">> & Dimensions & {
+          ` }),
+					createComponent(Spacing, {})
+				];
+			}
+		}),
+		createComponent(TypeDeclaration, {
+			"export": true,
+			name: "BorderOption",
+			doc: "The border options applied to table cells.",
+			children: code`"primary" | "secondary" | "tertiary" | "none" | string; `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "TableOutputOptions",
+			doc: "Options to customize the output of the {@link table} function.",
+			get children() {
+				return [
+					createComponent(TSDoc, {
+						heading: "Border variant for the table cell.",
+						get children() {
+							return [
+								createComponent(TSDocRemarks, { children: `The border variant to use for the table cell. This determines the color and style of the border around the cell.` }),
+								createIntrinsic("hbr", {}),
+								createComponent(TSDocDefaultValue, {
+									type: "any",
+									defaultValue: "primary"
+								})
+							];
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "border",
+						optional: true,
+						type: "BorderOption | { top?: BorderOption; right?: BorderOption; bottom?: BorderOption; left?: BorderOption; topLeft?: BorderOption; topRight?: BorderOption; bottomLeft?: BorderOption; bottomRight?: BorderOption; }"
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDoc, {
+						heading: "Padding for the table cell.",
+						get children() {
+							return [
+								createComponent(TSDocRemarks, { children: `The amount of padding (in spaces) to apply to the table cell. This value is applied to both the left and right sides of the cell. If not specified, the default table padding defined in the current theme configuration will be used.` }),
+								createIntrinsic("hbr", {}),
+								createComponent(TSDocDefaultValue, {
+									type: "any",
+									get defaultValue() {
+										return `\`${theme.padding.table}\``;
+									}
+								})
+							];
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "padding",
+						optional: true,
+						type: "number"
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDoc, {
+						heading: "Alignment for the table cell.",
+						get children() {
+							return [
+								createComponent(TSDocRemarks, { children: `The alignment for the table cell. This determines how the text within the cell is aligned. If not specified, the default alignment is "left".` }),
+								createIntrinsic("hbr", {}),
+								createComponent(TSDocDefaultValue, {
+									type: "any",
+									defaultValue: "left"
+								})
+							];
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "align",
+						optional: true,
+						type: "\"left\" | \"right\" | \"center\""
+					}),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "TableCellOptions",
+			"extends": "TableOutputOptions",
+			doc: "Options for a specific table cell provided to the {@link table} function.",
+			get children() {
+				return [
+					createComponent(InterfaceMember, {
+						name: "value",
+						optional: true,
+						type: "string",
+						doc: "The actual string value of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDoc, {
+						heading: "Width of the table cell.",
+						get children() {
+							return createComponent(TSDocRemarks, { children: `The width of the table cell (where 1 is a single character in the terminal). If not specified, the width will be determined based on the content of the cell and the available space in the console.` });
+						}
+					}),
+					createComponent(InterfaceMember, {
+						name: "maxWidth",
+						type: "number | SizeToken | undefined"
+					}),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "TableRowOptions",
+			"extends": "TableOutputOptions",
+			doc: "Options for a specific table row provided to the {@link table} function.",
+			get children() {
+				return [createComponent(InterfaceMember, {
+					name: "values",
+					optional: true,
+					type: "(string | TableCellOptions)[]",
+					doc: "The actual string values of the table row's cells."
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(InterfaceDeclaration, {
+			"export": true,
+			name: "TableOptions",
+			"extends": "TableOutputOptions",
+			doc: "Options for a specific table cell provided to the {@link table} function.",
+			get children() {
+				return [createComponent(InterfaceMember, {
+					name: "values",
+					optional: true,
+					type: "(string | TableCellOptions)[][]",
+					doc: "The actual string values of the table's rows' cells."
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(InterfaceDeclaration, {
+			name: "Dimensions",
+			doc: "The height and width for a specific table/cell used internally in the {@link table} function.",
+			get children() {
+				return [
+					createComponent(InterfaceMember, {
+						name: "height",
+						type: "number",
+						doc: "The height of the row/cell (where 1 is a single line in the terminal)."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "width",
+						type: "number",
+						doc: "The width of the row/cell (where 1 is a single character in the terminal)."
+					}),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(InterfaceDeclaration, {
+			name: "TableCellBorder",
+			doc: "The resolved complete border styles for a table cell.",
+			get children() {
+				return [
+					createComponent(InterfaceMember, {
+						name: "top",
+						type: "string",
+						doc: "The top border style of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "bottom",
+						type: "string",
+						doc: "The bottom border style of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "right",
+						type: "string",
+						doc: "The right border style of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "left",
+						type: "string",
+						doc: "The left border style of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "topLeft",
+						type: "string",
+						doc: "The top-left border style of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "topRight",
+						type: "string",
+						doc: "The top-right border style of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "bottomLeft",
+						type: "string",
+						doc: "The bottom-left border style of the table cell."
+					}),
+					createIntrinsic("hbr", {}),
+					createComponent(InterfaceMember, {
+						name: "bottomRight",
+						type: "string",
+						doc: "The bottom-right border style of the table cell."
+					}),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TypeDeclaration, {
+			name: "TableCell",
+			doc: "The internal state of a formatted table cell in the {@link table} function.",
+			children: code`Required<Omit<TableCellOptions, "maxWidth" | "border">> & Dimensions & {
           border: TableCellBorder;
           maxWidth?: number;
         };
-        `}),e(g,{}),e(x,{heading:`Write a table to the console.`,get children(){return[e(T,{children:`This function writes a table to the console, applying the appropriate padding as defined in the current theme configuration and wrapping as needed.`}),t(`hbr`,{}),e(w,{name:`options`,children:`Options to customize the table output.`})]}}),e(l,r({export:!0},i,{name:`table`,parameters:[{name:`options`,type:`TableOptions | TableRowOptions[] | TableCellOptions[][] | string[] | string[][]`,optional:!1}],get children(){return[e(u,{condition:o`!options ||
+        `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "Write a table to the console.",
+			get children() {
+				return [
+					createComponent(TSDocRemarks, { children: `This function writes a table to the console, applying the appropriate padding as defined in the current theme configuration and wrapping as needed.` }),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDocParam, {
+						name: "options",
+						children: `Options to customize the table output.`
+					})
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, mergeProps({ "export": true }, props, {
+			name: "table",
+			parameters: [{
+				name: "options",
+				type: "TableOptions | TableRowOptions[] | TableCellOptions[][] | string[] | string[][]",
+				optional: false
+			}],
+			get children() {
+				return [
+					createComponent(IfStatement, {
+						condition: code`!options ||
             (!Array.isArray(options) && (typeof options !== "object" || !options.values || !Array.isArray(options.values) || options.values.length === 0)) ||
-            (Array.isArray(options) && !options.every(item => typeof item === "object" || typeof item === "string" || Array.isArray(item))) `,children:o`return;`}),e(g,{}),e(m,{let:!0,name:`cells`,type:`TableCell[][]`,initializer:o`[];`}),t(`hbr`,{}),n(()=>o`
+            (Array.isArray(options) && !options.every(item => typeof item === "object" || typeof item === "string" || Array.isArray(item))) `,
+						children: code`return;`
+					}),
+					createComponent(Spacing, {}),
+					createComponent(VarDeclaration, {
+						"let": true,
+						name: "cells",
+						type: `TableCell[][]`,
+						initializer: code`[];`
+					}),
+					createIntrinsic("hbr", {}),
+					memo(() => code`
         const extractTableCell = (cell: string | TableCellOptions, columnIndex: number, rowLength: number, opts?: TableOutputOptions): TableCell => {
           if (typeof cell === "string") {
             const borderOptions = opts?.border || "primary";
@@ -568,27 +2167,27 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
             let border = {} as TableCellBorder;
             if (typeof borderOptions === "object") {
               border = {
-                top: ${Z(`top`,a)},
-                bottom: ${Z(`bottom`,a)},
-                left: ${Z(`left`,a)},
-                right: ${Z(`right`,a)},
-                topLeft: ${Z(`topLeft`,a)},
-                topRight: ${Z(`topRight`,a)},
-                bottomLeft: ${Z(`bottomLeft`,a)},
-                bottomRight: ${Z(`bottomRight`,a)},
+                top: ${extractBorderOptionsObject("top", theme)},
+                bottom: ${extractBorderOptionsObject("bottom", theme)},
+                left: ${extractBorderOptionsObject("left", theme)},
+                right: ${extractBorderOptionsObject("right", theme)},
+                topLeft: ${extractBorderOptionsObject("topLeft", theme)},
+                topRight: ${extractBorderOptionsObject("topRight", theme)},
+                bottomLeft: ${extractBorderOptionsObject("bottomLeft", theme)},
+                bottomRight: ${extractBorderOptionsObject("bottomRight", theme)},
               };
             } else {
-              border.top = ${Q(`top`,a)};
-              border.bottom = ${Q(`bottom`,a)};
-              border.left = ${Q(`left`,a)};
-              border.right = ${Q(`right`,a)};
-              border.topLeft = ${Q(`topLeft`,a)};
-              border.topRight = ${Q(`topRight`,a)};
-              border.bottomLeft = ${Q(`bottomLeft`,a)};
-              border.bottomRight = ${Q(`bottomRight`,a)};
+              border.top = ${extractBorderOptionsString("top", theme)};
+              border.bottom = ${extractBorderOptionsString("bottom", theme)};
+              border.left = ${extractBorderOptionsString("left", theme)};
+              border.right = ${extractBorderOptionsString("right", theme)};
+              border.topLeft = ${extractBorderOptionsString("topLeft", theme)};
+              border.topRight = ${extractBorderOptionsString("topRight", theme)};
+              border.bottomLeft = ${extractBorderOptionsString("bottomLeft", theme)};
+              border.bottomRight = ${extractBorderOptionsString("bottomRight", theme)};
             }
 
-            const padding = Math.max(0, opts?.padding ?? ${a.padding.table}) * (columnIndex === 0 || columnIndex === rowLength - 1 ? 2 : 1);
+            const padding = Math.max(0, opts?.padding ?? ${theme.padding.table}) * (columnIndex === 0 || columnIndex === rowLength - 1 ? 2 : 1);
             const value = cell ?? "";
             const width = stripAnsi(value).length + padding * 2;
 
@@ -606,27 +2205,27 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
             let border = {} as TableCellBorder;
             if (typeof borderOptions === "object") {
               border = {
-                top: ${Z(`top`,a)},
-                bottom: ${Z(`bottom`,a)},
-                left: ${Z(`left`,a)},
-                right: ${Z(`right`,a)},
-                topLeft: ${Z(`topLeft`,a)},
-                topRight: ${Z(`topRight`,a)},
-                bottomLeft: ${Z(`bottomLeft`,a)},
-                bottomRight: ${Z(`bottomRight`,a)},
+                top: ${extractBorderOptionsObject("top", theme)},
+                bottom: ${extractBorderOptionsObject("bottom", theme)},
+                left: ${extractBorderOptionsObject("left", theme)},
+                right: ${extractBorderOptionsObject("right", theme)},
+                topLeft: ${extractBorderOptionsObject("topLeft", theme)},
+                topRight: ${extractBorderOptionsObject("topRight", theme)},
+                bottomLeft: ${extractBorderOptionsObject("bottomLeft", theme)},
+                bottomRight: ${extractBorderOptionsObject("bottomRight", theme)},
               };
             } else {
-              border.top = ${Q(`top`,a)};
-              border.bottom = ${Q(`bottom`,a)};
-              border.left = ${Q(`left`,a)};
-              border.right = ${Q(`right`,a)};
-              border.topLeft = ${Q(`topLeft`,a)};
-              border.topRight = ${Q(`topRight`,a)};
-              border.bottomLeft = ${Q(`bottomLeft`,a)};
-              border.bottomRight = ${Q(`bottomRight`,a)};
+              border.top = ${extractBorderOptionsString("top", theme)};
+              border.bottom = ${extractBorderOptionsString("bottom", theme)};
+              border.left = ${extractBorderOptionsString("left", theme)};
+              border.right = ${extractBorderOptionsString("right", theme)};
+              border.topLeft = ${extractBorderOptionsString("topLeft", theme)};
+              border.topRight = ${extractBorderOptionsString("topRight", theme)};
+              border.bottomLeft = ${extractBorderOptionsString("bottomLeft", theme)};
+              border.bottomRight = ${extractBorderOptionsString("bottomRight", theme)};
             }
 
-            const padding = Math.max(0, cell.padding ?? opts?.padding ?? ${a.padding.table});
+            const padding = Math.max(0, cell.padding ?? opts?.padding ?? ${theme.padding.table});
             const value = cell.value ?? "";
             const width = stripAnsi(value).length + padding * 2;
             const maxWidth = cell.maxWidth ? typeof cell.maxWidth === "number" ? cell.maxWidth : calculateWidth(cell.maxWidth) : undefined;
@@ -644,7 +2243,15 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
         };
 
         let colMaxWidths = [] as (number | undefined)[];
-    `),t(`hbr`,{}),e(u,{condition:o`Array.isArray(options)`,get children(){return[e(u,{condition:o`options.every(row => typeof row === "string" || (typeof row === "object" && !Array.isArray(row) && !("values" in row)))`,children:o`cells.push(options.map((cell, index) => extractTableCell(cell as string | TableCellOptions, index, options.length)));`}),e(s,{children:o`
+    `),
+					createIntrinsic("hbr", {}),
+					createComponent(IfStatement, {
+						condition: code`Array.isArray(options)`,
+						get children() {
+							return [createComponent(IfStatement, {
+								condition: code`options.every(row => typeof row === "string" || (typeof row === "object" && !Array.isArray(row) && !("values" in row)))`,
+								children: code`cells.push(options.map((cell, index) => extractTableCell(cell as string | TableCellOptions, index, options.length)));`
+							}), createComponent(ElseClause, { children: code`
           cells.push(
             ...options.map(row => Array.isArray(row)
               ? row.reduce((cellRow, cell, index) => {
@@ -671,7 +2278,10 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
               }, [] as TableCell[]) ?? []
             )
           );
-            `})]}}),e(s,{children:o`
+            ` })];
+						}
+					}),
+					createComponent(ElseClause, { children: code`
         cells.push(
           ...options.values!.map(row => Array.isArray(row)
             ? row.reduce((cellRow, cell, index) => {
@@ -699,7 +2309,9 @@ console.log(result); // "\\\\x1b[36mHello\\\\x1b[39\\\\x1b[31mWorld\\\\x1b[0m\\\
           )
         );
 
-          `}),t(`hbr`,{}),n(()=>o`
+          ` }),
+					createIntrinsic("hbr", {}),
+					memo(() => code`
 cells = cells.filter(row => row.length > 0);
 if (cells.length === 0) {
   return;
@@ -760,7 +2372,7 @@ do {
   }
 
   rowDims.forEach((row, rowIndex) => {
-    if (!recalculate && row.width > Math.max(getTerminalSize().columns - ${Math.max(a.padding.app,0)*2}, 0)) {
+    if (!recalculate && row.width > Math.max(getTerminalSize().columns - ${Math.max(theme.padding.app, 0) * 2}, 0)) {
       const cell = cells[rowIndex]!.reduce((largestCell, cell) => {
         if (cell.width > largestCell.width) {
           return cell;
@@ -770,7 +2382,7 @@ do {
 
       const lines = splitText(
         cell.value,
-        Math.min(Math.max(getTerminalSize().columns - ${Math.max(a.padding.app,0)*2} - (row.width - (cell.width - cell.padding * 2)), 0),
+        Math.min(Math.max(getTerminalSize().columns - ${Math.max(theme.padding.app, 0) * 2} - (row.width - (cell.width - cell.padding * 2)), 0),
         cell.maxWidth ?? Number.POSITIVE_INFINITY)
       );
 
@@ -782,7 +2394,7 @@ do {
     }
   });
 
-  if (!recalculate && colWidths.reduce((a, b) => a + b, 0) > Math.max(getTerminalSize().columns - ${Math.max(a.padding.app,0)*2}, 0)) {
+  if (!recalculate && colWidths.reduce((a, b) => a + b, 0) > Math.max(getTerminalSize().columns - ${Math.max(theme.padding.app, 0) * 2}, 0)) {
     let colIndex = 0;
     const cell = cells.reduce((ret, row) => {
       return row.reduce((largest, current, index) => {
@@ -796,7 +2408,7 @@ do {
 
     const lines = splitText(
       cell.value,
-      Math.min(Math.max(getTerminalSize().columns - ${Math.max(a.padding.app,0)*2} - (colWidths.filter((_, i) => i !== colIndex).reduce((a, b) => a + b, 0)) - cell.padding * 2, 0),
+      Math.min(Math.max(getTerminalSize().columns - ${Math.max(theme.padding.app, 0) * 2} - (colWidths.filter((_, i) => i !== colIndex).reduce((a, b) => a + b, 0)) - cell.padding * 2, 0),
       cell.maxWidth ?? Number.POSITIVE_INFINITY)
     );
 
@@ -846,7 +2458,167 @@ cells.forEach((row, rowIndex) => {
     writeLine(outputs.map(output => output[index] ?? "").join(""));
   }
 });
-`)]}}))]}function oe(t){let{children:n,imports:r,builtinImports:i}=t;return e(b,{id:`console`,description:`A collection of helper utilities to assist in generating content meant for display in the console.`,get imports(){return N(r,{"@shell-shock/plugin-theme/types/theme":[`ThemeSpinnerResolvedConfig`],"@shell-shock/plugin-theme/helpers/spinners":[`SpinnerPreset`,`resolveSpinner`],"node:util":[`stripVTControlCharacters`]})},get builtinImports(){return N(i,{utils:[`isInteractive`,`isColorSupported`,`colorSupportLevels`,`isUnicodeSupported`,`isHyperlinkSupported`,`getTerminalSize`],env:[`env`,`isDevelopment`,`isDebug`],state:[`hasFlag`]})},get children(){return[e(P,{}),e(g,{}),e(W,{}),e(g,{}),e(U,{}),e(g,{}),e(R,{}),e(g,{}),e(B,{}),e(g,{}),e(V,{}),e(g,{}),e(z,{}),e(g,{}),e(K,{}),e(g,{}),e(G,{}),e(g,{}),e(X,{}),e(g,{}),e(H,{type:`help`,variant:`help`,consoleFnName:`log`,description:`help`}),e(g,{}),e(H,{type:`success`,variant:`success`,consoleFnName:`info`,description:`success`}),e(g,{}),e(H,{type:`info`,variant:`info`,consoleFnName:`info`,description:`informational`}),e(g,{}),e(H,{type:`debug`,variant:`debug`,consoleFnName:`debug`,description:`debug`,timestamp:!0,get prefix(){return e(u,{get condition(){return e(ne,{})},children:o`return; `})}}),e(g,{}),e(H,{type:`verbose`,variant:`info`,color:`debug`,consoleFnName:`debug`,description:`verbose`,timestamp:!0,get prefix(){return e(u,{get condition(){return e(D,{})},children:o`return; `})}}),e(g,{}),e(H,{type:`warn`,variant:`warning`,consoleFnName:`warn`,description:`warning`}),e(g,{}),e(H,{type:`danger`,variant:`danger`,consoleFnName:`error`,description:`destructive/danger`}),e(g,{}),e(H,{type:`error`,variant:`error`,consoleFnName:`error`,description:`error`,timestamp:!0,parameters:[{name:`err`,type:`string | { message: string; stack?: string }`,optional:!1},{name:`header`,type:`string`,optional:!0}],get prefix(){return[e(m,{let:!0,name:`message`,type:`string | undefined`}),e(g,{}),e(u,{condition:o`(err as { message: string; stack?: string })?.message`,children:o`message = (err as { message: string; stack?: string }).message;`}),e(s,{children:o`message = String(err);`}),e(g,{}),e(u,{condition:o`env.STACKTRACE && typeof err === "object" && (err as { stack?: string })?.stack`,children:o`message += " \\n\\n" + (err as { stack: string }).stack.split("\\n").slice(1).map(line => {
+`)
+				];
+			}
+		}))
+	];
+}
+/**
+* A built-in console utilities module for Shell Shock.
+*/
+function ConsoleBuiltin(props) {
+	const { children, imports, builtinImports } = props;
+	return createComponent(BuiltinFile, {
+		id: "console",
+		description: "A collection of helper utilities to assist in generating content meant for display in the console.",
+		get imports() {
+			return defu(imports, {
+				"@shell-shock/plugin-theme/types/theme": ["ThemeSpinnerResolvedConfig"],
+				"@shell-shock/plugin-theme/helpers/spinners": ["SpinnerPreset", "resolveSpinner"],
+				"node:util": ["stripVTControlCharacters"]
+			});
+		},
+		get builtinImports() {
+			return defu(builtinImports, {
+				utils: [
+					"isInteractive",
+					"isColorSupported",
+					"colorSupportLevels",
+					"isUnicodeSupported",
+					"isHyperlinkSupported",
+					"getTerminalSize"
+				],
+				env: [
+					"env",
+					"isDevelopment",
+					"isDebug"
+				],
+				state: ["hasFlag"]
+			});
+		},
+		get children() {
+			return [
+				createComponent(AnsiHelpersDeclarations, {}),
+				createComponent(Spacing, {}),
+				createComponent(StripAnsiFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(WrapAnsiFunction, {}),
+				createComponent(Spacing, {}),
+				createComponent(AnsiStyleFunctionsDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(WriteFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(WriteLineFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(SplitTextFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(LinkFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(DividerFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(SpinnerFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "help",
+					variant: "help",
+					consoleFnName: "log",
+					description: "help"
+				}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "success",
+					variant: "success",
+					consoleFnName: "info",
+					description: "success"
+				}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "info",
+					variant: "info",
+					consoleFnName: "info",
+					description: "informational"
+				}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "debug",
+					variant: "debug",
+					consoleFnName: "debug",
+					description: "debug",
+					timestamp: true,
+					get prefix() {
+						return createComponent(IfStatement, {
+							get condition() {
+								return createComponent(IsNotDebug, {});
+							},
+							children: code`return; `
+						});
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "verbose",
+					variant: "info",
+					color: "debug",
+					consoleFnName: "debug",
+					description: "verbose",
+					timestamp: true,
+					get prefix() {
+						return createComponent(IfStatement, {
+							get condition() {
+								return createComponent(IsNotVerbose, {});
+							},
+							children: code`return; `
+						});
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "warn",
+					variant: "warning",
+					consoleFnName: "warn",
+					description: "warning"
+				}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "danger",
+					variant: "danger",
+					consoleFnName: "error",
+					description: "destructive/danger"
+				}),
+				createComponent(Spacing, {}),
+				createComponent(MessageFunctionDeclaration, {
+					type: "error",
+					variant: "error",
+					consoleFnName: "error",
+					description: "error",
+					timestamp: true,
+					parameters: [{
+						name: "err",
+						type: "string | { message: string; stack?: string }",
+						optional: false
+					}, {
+						name: "header",
+						type: "string",
+						optional: true
+					}],
+					get prefix() {
+						return [
+							createComponent(VarDeclaration, {
+								"let": true,
+								name: "message",
+								type: "string | undefined"
+							}),
+							createComponent(Spacing, {}),
+							createComponent(IfStatement, {
+								condition: code`(err as { message: string; stack?: string })?.message`,
+								children: code`message = (err as { message: string; stack?: string }).message;`
+							}),
+							createComponent(ElseClause, { children: code`message = String(err);` }),
+							createComponent(Spacing, {}),
+							createComponent(IfStatement, {
+								condition: code`env.STACKTRACE && typeof err === "object" && (err as { stack?: string })?.stack`,
+								children: code`message += " \\n\\n" + (err as { stack: string }).stack.split("\\n").slice(1).map(line => {
                   const match = line.match(/at (?:(.+?)\\s+\\()?(?:(.+?):(\\d+)(?::(\\d+))?|([^)]+))\\)?/);
                   if (match) {
                     const filePath = match[2] || match[5] || "<unknown>";
@@ -854,5 +2626,27 @@ cells.forEach((row, rowIndex) => {
                   }
 
                   return line.trim();
-                }).join("\\n"); `})]}}),e(g,{}),e($,{}),e(g,{}),e(q,{}),e(g,{}),e(J,{}),e(g,{}),e(Y,{}),e(g,{}),n,e(g,{})]}})}export{P as AnsiHelpersDeclarations,R as AnsiStyleFunctionsDeclaration,q as BlockquoteFunctionDeclaration,J as CodeFunctionDeclaration,oe as ConsoleBuiltin,G as DividerFunctionDeclaration,Y as InlineCodeFunctionDeclaration,K as LinkFunctionDeclaration,H as MessageFunctionDeclaration,X as SpinnerFunctionDeclaration,z as SplitTextFunctionDeclaration,W as StripAnsiFunctionDeclaration,$ as TableFunctionDeclaration,L as ThemeColorObjectDefinition,I as ThemeColorTypeDefinition,U as WrapAnsiFunction,B as WriteFunctionDeclaration,V as WriteLineFunctionDeclaration};
+                }).join("\\n"); `
+							})
+						];
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TableFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(BlockquoteFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(CodeFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				createComponent(InlineCodeFunctionDeclaration, {}),
+				createComponent(Spacing, {}),
+				children,
+				createComponent(Spacing, {})
+			];
+		}
+	});
+}
+
+//#endregion
+export { AnsiHelpersDeclarations, AnsiStyleFunctionsDeclaration, BlockquoteFunctionDeclaration, CodeFunctionDeclaration, ConsoleBuiltin, DividerFunctionDeclaration, InlineCodeFunctionDeclaration, LinkFunctionDeclaration, MessageFunctionDeclaration, SpinnerFunctionDeclaration, SplitTextFunctionDeclaration, StripAnsiFunctionDeclaration, TableFunctionDeclaration, ThemeColorObjectDefinition, ThemeColorTypeDefinition, WrapAnsiFunction, WriteFunctionDeclaration, WriteLineFunctionDeclaration };
 //# sourceMappingURL=console-builtin.mjs.map