colorizer.js 1.0.0

package/README.md

@@ -0,0 +1,53 @@
+# colorizer.js
+
+Small library for simple coloring and styling of terminal output with ANSI characters.
+
+## Documentation
+Its important that you should call `fg` (Background color) or `bg` (Font color) function before calling one of color functions like `hex` or `rgb` so that the library could create the correct order of ANSI characters.\
+`hex` function takes over 24 bit value.
+
+```js
+import colorizer from "colorizer.ts";
+
+console.log(
+  // This will work.
+  colorizer()
+    .bold()
+    .underline()
+    .fg()
+    .rgb(255, 255, 0)
+    .text("WARN")
+);
+
+console.log(
+  // This will work.
+  colorizer()
+    .bold()
+    .underline()
+    .bg()
+    .hex(0xff_ff_ff_ff)
+    //     R  G  B  
+    .text("INFO")
+);
+
+console.log(
+  // This will not work.
+  colorizer()
+    .bold()
+    .underline()
+    .rgb(255, 255, 0)
+    .text("WARN")
+);
+```
+You can create a reusable coloring function.
+```js
+import colorizer from "colorizer.ts";
+
+const warn = colorizer()
+  .bold()
+  .bg()
+  .rgb(255, 255, 0)
+  .text;
+
+console.log(warn("[WARN]:"), "Some warning!");
+```

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "colorizer.js",
+  "version": "1.0.0",
+  "description": "Small library for simple coloring and styling of terminal output with ANSI charcters.",
+  "homepage": "https://github.com/MaksimsTurs/colorizer.js#readme",
+  "license": "ISC",
+  "author": "MaksimsTurs",
+  "type": "module",
+  "main": "./src/colorizer.ts",
+  "bugs": {
+    "url": "https://github.com/MaksimsTurs/colorizer.js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaksimsTurs/colorizer.js.git"
+  },
+  "dependencies": {
+    "colorizer": "^2.0.2",
+    "undici-types": "^7.16.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9"
+  }
+}

package/src/colorizer.ts

@@ -0,0 +1,97 @@
+import STYLES from "./const/STYLES.const.ts";
+
+import type { Colorizer } from "./colorizer.type.ts";
+
+import isFillLocation from "./utils/is-fill-location.util.ts";
+
+const _warn: Colorizer["text"] = colorizer()
+  .bold()
+  .bg()
+  .rgb(170, 170, 0)
+  .text;
+const _text: Colorizer["text"] = colorizer()
+  .dim()
+  .bg()
+  .rgb(255, 255, 255)
+  .text;
+
+export default function colorizer(): Colorizer {
+  let styles: string[] = [];
+
+  return {
+    // Font styles.
+    strikeThrought: function(): Colorizer {
+      styles.push(STYLES.STRIKE_THROUGHT);
+
+      return this;
+    },
+    underline: function(): Colorizer {
+      styles.push(STYLES.UNDERLINE);
+
+      return this;
+    },
+    dim: function(): Colorizer {
+      styles.push(STYLES.DIM);
+
+      return this;
+    },
+    italic: function(): Colorizer {
+      styles.push(STYLES.ITALIC);
+
+      return this;
+    },
+    bold: function(): Colorizer {
+      styles.push(STYLES.BOLD);
+
+      return this;
+    },
+    // Fill locations.
+    bg: function(): Colorizer {
+      styles.push(STYLES.BG);
+
+      return this;
+    },
+    fg: function(): Colorizer {
+      styles.push(STYLES.FG);
+
+      return this;
+    },
+    // Font Colors.
+    hex: function(hex: number): Colorizer {
+      const r: number = hex >> 16 & 0xff;
+      const g: number = hex >> 8  & 0xff;
+      const b: number = hex >> 0  & 0xff;
+
+      if(!isFillLocation(styles.at(-1))) {
+        console.warn(_warn("[WARN]:"), _text(`The hex color does not have effect because the fill location "${styles.at(-1)}" is not valid!`));
+        console.warn(_warn("[WARN]:"), _text("Call the \"fg\" function for background color or \"bg\" for font color!"));
+      }
+
+      styles.push(`${r};${g};${b}m`);
+
+      return this;
+    },
+    rgb: function(r: number, g: number, b: number): Colorizer {
+      if(!isFillLocation(styles.at(-1))) {
+        console.warn(_warn("[WARN]:"), _text(`The rgb color does not have effect because the fill location "${styles.at(-1)}" is not valid!`));
+        console.warn(_warn("[WARN]:"), _text("Call the \"fg\" function for background color or \"bg\" for font color!"));
+      }
+
+      styles.push(`${r};${g};${b}m`);
+
+      return this;
+    },
+    text: function(text: string): string {
+      let colorized: string = "";
+
+      for(let index: number = 0; index < styles.length; index++) {
+        colorized += styles[index];
+      }
+
+      colorized += text;
+      colorized += STYLES.RESET;
+      
+      return colorized;
+    },
+  }
+};

package/src/colorizer.type.ts

@@ -0,0 +1,17 @@
+export type Colorizer = {
+  strikeThrought: () => Colorizer
+  underline:      () => Colorizer
+  /** Reduce the intensity of backround and font colors. */
+  dim:            () => Colorizer
+  italic:         () => Colorizer
+  bold:           () => Colorizer
+  /** Set the font color. */
+  bg:             () => Colorizer
+  /** Set the background color. */
+  fg:             () => Colorizer
+  /** Should be 24 bit value. */
+  hex:            (hex: number) => Colorizer
+  rgb:            (r: number, g: number, b: number) => Colorizer
+  /** Apply a set of rules to the given text.*/
+  text:           (text: string) => string;
+};

package/src/const/STYLES.const.ts

@@ -0,0 +1,13 @@
+const STYLES = {
+  RESET:           "\x1b[0m",
+  BOLD:            "\x1b[1m",
+  DIM:             "\x1b[2m",
+  ITALIC:          "\x1b[3m",
+  UNDERLINE:       "\x1b[4m",
+  STRIKE_THROUGHT: "\x1b[9m",
+  
+  BG:        "\x1b[38;2;",
+  FG:        "\x1b[48;2;",
+} as const;
+
+export default STYLES;

package/src/utils/is-fill-location.util.ts

@@ -0,0 +1,9 @@
+import STYLES from "../const/STYLES.const.ts";
+
+export default function isFillLocation(maybeFillLocation?: string): boolean {
+  return(
+    !!(maybeFillLocation &&
+      (maybeFillLocation === STYLES.BG ||
+       maybeFillLocation === STYLES.FG))
+  );
+};