feat: initial boilerplate

api/libraries/logger/color/hex.ts

@@ -0,0 +1,28 @@
+import { rgbToAnsi256 } from "./rgb.ts";
+
+/**
+ * Convert provided hex value to closest 256-Color value.
+ *
+ * @param hex - Hex to convert.
+ */
+export function hexToAnsi256(hex: HexValue) {
+  const { r, g, b } = hexToRGB(hex);
+  return rgbToAnsi256(r, g, b);
+}
+
+/**
+ * Take a hex value and return its RGB values.
+ *
+ * @param hex - Hex to convert to RGB
+ * @returns
+ */
+export function hexToRGB(hex: HexValue): { r: number; g: number; b: number } {
+  return {
+    r: parseInt(hex.slice(1, 3), 16),
+    g: parseInt(hex.slice(3, 5), 16),
+    b: parseInt(hex.slice(5, 7), 16),
+  };
+}
+
+export type HexValue =
+  `#${string | number}${string | number}${string | number}${string | number}${string | number}${string | number}`;

api/libraries/logger/color/rgb.ts

@@ -0,0 +1,24 @@
+/**
+ * Convert RGB to the nearest 256-color ANSI value
+ *
+ * @param r - Red value.
+ * @param g - Green value.
+ * @param b - Blue value.
+ */
+export function rgbToAnsi256(r: number, g: number, b: number): number {
+  if (r === g && g === b) {
+    if (r < 8) return 16;
+    if (r > 248) return 231;
+    return Math.round(((r - 8) / 247) * 24) + 232;
+  }
+
+  // Map RGB to 6×6×6 color cube (16–231)
+  const conv = (val: number) => Math.round(val / 51);
+  const ri = conv(r);
+  const gi = conv(g);
+  const bi = conv(b);
+
+  return 16 + 36 * ri + 6 * gi + bi;
+}
+
+export type RGB = { r: number; g: number; b: number };

api/libraries/logger/color/styles.ts

@@ -0,0 +1,76 @@
+import { hexToAnsi256, HexValue } from "./hex.ts";
+import { toEscapeSequence } from "./utilities.ts";
+
+export const styles = {
+  modifier: {
+    reset: toEscapeSequence(0), // Reset to normal
+    bold: toEscapeSequence(1), // Bold text
+    dim: toEscapeSequence(2), // Dim text
+    italic: toEscapeSequence(3), // Italic text
+    underline: toEscapeSequence(4), // Underlined text
+    overline: toEscapeSequence(53), // Overline text
+    inverse: toEscapeSequence(7), // Inverse
+    hidden: toEscapeSequence(8), // Hidden text
+    strikethrough: toEscapeSequence(9), // Strikethrough
+  },
+
+  color: {
+    black: toEscapeSequence(30), // Black color
+    red: toEscapeSequence(31), // Red color
+    green: toEscapeSequence(32), // Green color
+    yellow: toEscapeSequence(33), // Yellow color
+    blue: toEscapeSequence(34), // Blue color
+    magenta: toEscapeSequence(35), // Magenta color
+    cyan: toEscapeSequence(36), // Cyan color
+    white: toEscapeSequence(37), // White color
+    orange: hexToColor("#FFA500"),
+
+    // Bright colors
+    blackBright: toEscapeSequence(90),
+    gray: toEscapeSequence(90), // Alias for blackBright
+    grey: toEscapeSequence(90), // Alias for blackBright
+    redBright: toEscapeSequence(91),
+    greenBright: toEscapeSequence(92),
+    yellowBright: toEscapeSequence(93),
+    blueBright: toEscapeSequence(94),
+    magentaBright: toEscapeSequence(95),
+    cyanBright: toEscapeSequence(96),
+    whiteBright: toEscapeSequence(97),
+  },
+
+  bgColor: {
+    bgBlack: toEscapeSequence(40),
+    bgRed: toEscapeSequence(41),
+    bgGreen: toEscapeSequence(42),
+    bgYellow: toEscapeSequence(43),
+    bgBlue: toEscapeSequence(44),
+    bgMagenta: toEscapeSequence(45),
+    bgCyan: toEscapeSequence(46),
+    bgWhite: toEscapeSequence(47),
+    bgOrange: hexToBgColor("#FFA500"),
+
+    // Bright background colors
+    bgBlackBright: toEscapeSequence(100),
+    bgGray: toEscapeSequence(100), // Alias for bgBlackBright
+    bgGrey: toEscapeSequence(100), // Alias for bgBlackBright
+    bgRedBright: toEscapeSequence(101),
+    bgGreenBright: toEscapeSequence(102),
+    bgYellowBright: toEscapeSequence(103),
+    bgBlueBright: toEscapeSequence(104),
+    bgMagentaBright: toEscapeSequence(105),
+    bgCyanBright: toEscapeSequence(106),
+    bgWhiteBright: toEscapeSequence(107),
+  },
+};
+
+export function hexToColor(hex: HexValue): string {
+  return toEscapeSequence(`38;5;${hexToAnsi256(hex)}`); // Foreground color
+}
+
+export function hexToBgColor(hex: HexValue): string {
+  return toEscapeSequence(`48;5;${hexToAnsi256(hex)}`); // Background color
+}
+
+export type Modifier = keyof typeof styles.modifier;
+export type Color = keyof typeof styles.color;
+export type BGColor = keyof typeof styles.bgColor;

api/libraries/logger/color/utilities.ts

@@ -0,0 +1,3 @@
+export function toEscapeSequence(value: string | number): `\x1b[${string}m` {
+  return `\x1b[${value}m`;
+}