@peteanderson/ansi 0.0.1

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 Pete Anderson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# @peteanderson/ansi
+
+ANSI escape sequence helpers for Node.js terminal output. Automatically disables color when stdout is not a TTY or when standard environment variables (`NO_COLOR`, `NODE_DISABLE_COLORS`, `FORCE_COLOR`, `TERM=dumb`) indicate it should be.
+
+## Installation
+
+```sh
+npm install @peteanderson/ansi
+```
+
+## Usage
+
+```js
+const ansi = require("@peteanderson/ansi");
+
+console.log(ansi.fg.red("error: something went wrong"));
+console.log(ansi.bg.blue(ansi.fg.white("highlighted")));
+console.log(ansi.style.bold("important"));
+console.log(ansi.fg.rgb(5, 2, 0)("custom color"));
+console.log("some styled text" + ansi.reset);
+console.log(ansi.stripAnsiSequences("\x1b[31mred\x1b[0m")); // => "red"
+```
+
+## API
+
+All color and style functions accept a string and return a string. When color is disabled, the functions are identity — they return the input unchanged.
+
+### `fg` — foreground colors
+
+`black` `red` `green` `yellow` `blue` `magenta` `cyan` `white` `gray`
+
+```js
+ansi.fg.red("text")
+ansi.fg.rgb(r, g, b)("text")  // r, g, b in 0–5 for the 6×6×6 cube, or grayscale 232–255
+```
+
+### `bg` — background colors
+
+`black` `red` `green` `yellow` `blue` `magenta` `cyan` `white`
+
+```js
+ansi.bg.green("text")
+ansi.bg.rgb(r, g, b)("text")
+```
+
+### `style`
+
+`bold` `dim` `italic` `underline` `inverse` `hidden` `strikethrough`
+
+```js
+ansi.style.bold("text")
+ansi.style.italic(ansi.style.bold("text"))
+```
+
+### `reset`
+
+The SGR reset sequence (`\x1b[0m`). An empty string when color is disabled.
+
+### `stripAnsiSequences(text)`
+
+Removes ANSI SGR escape sequences from a string.
+
+## License
+
+MIT

package/dist/color.d.ts

@@ -0,0 +1,44 @@
+/** @param {string} text */
+export function stripAnsiSequences(text: string): string;
+export namespace style {
+    let bold: (text: string) => string;
+    let dim: (text: string) => string;
+    let italic: (text: string) => string;
+    let underline: (text: string) => string;
+    let inverse: (text: string) => string;
+    let hidden: (text: string) => string;
+    let strikethrough: (text: string) => string;
+}
+export namespace fg {
+    let black: (text: string) => string;
+    let red: (text: string) => string;
+    let green: (text: string) => string;
+    let yellow: (text: string) => string;
+    let blue: (text: string) => string;
+    let magenta: (text: string) => string;
+    let cyan: (text: string) => string;
+    let white: (text: string) => string;
+    let gray: (text: string) => string;
+    let rgb: (r: number, g: number, b: number) => (text: string) => string;
+}
+export namespace bg {
+    let black_1: (text: string) => string;
+    export { black_1 as black };
+    let red_1: (text: string) => string;
+    export { red_1 as red };
+    let green_1: (text: string) => string;
+    export { green_1 as green };
+    let yellow_1: (text: string) => string;
+    export { yellow_1 as yellow };
+    let blue_1: (text: string) => string;
+    export { blue_1 as blue };
+    let magenta_1: (text: string) => string;
+    export { magenta_1 as magenta };
+    let cyan_1: (text: string) => string;
+    export { cyan_1 as cyan };
+    let white_1: (text: string) => string;
+    export { white_1 as white };
+    let rgb_1: (r: number, g: number, b: number) => (text: string) => string;
+    export { rgb_1 as rgb };
+}
+export const reset: "\u001B[0m";

package/dist/color.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * @param   {string | undefined} value
+ * @returns {boolean}
+ */
+const isSet = value => !!value && value !== '0' && value.toLowerCase() !== "false";
+const enabled = isSet(process.env.FORCE_COLOR) ||
+    !isSet(process.env.NODE_DISABLE_COLORS) &&
+        !isSet(process.env.NO_COLOR) &&
+        process.env.TERM !== "dumb" &&
+        process.stdout.isTTY;
+/**
+ * @param   {number | string} open
+ * @param   {number | string} close
+ * @returns {(text: string) => string}
+ */
+function ansi(open, close) {
+    if (!enabled)
+        return s => s;
+    const openSequence = `\x1b[${open}m`;
+    const closeSequence = `\x1b[${close}m`;
+    return s => openSequence +
+        s.replaceAll(openSequence, '').replaceAll(closeSequence, openSequence) +
+        closeSequence;
+}
+/** @param {string} text */
+const stripAnsiSequences = text => text.replace(/\x1b\[\d+m/g, '');
+/** @type {(r: number, g: number, b: number, open: number, close: number) => (text: string) => string} */
+function rgb(r, g, b, open, close) {
+    if (r === g && g === b) {
+        // Grayscale range.
+        if (r >= 232 && r <= 255)
+            return ansi(`${open};5;${r}`, close);
+    }
+    else if (r >= 0 && r <= 5 && g >= 0 && g <= 5 && b >= 0 && b <= 5) {
+        // 6x6x6 color cube.
+        const code = 16 + r * 36 + g * 6 + b;
+        return ansi(`${open};5;${code}`, close);
+    }
+    return ansi(`${open};2;${r};${g};${b}`, close);
+}
+const style = {
+    bold: ansi(1, 22),
+    dim: ansi(2, 22),
+    italic: ansi(3, 23),
+    underline: ansi(4, 24),
+    inverse: ansi(7, 27),
+    hidden: ansi(8, 28),
+    strikethrough: ansi(9, 29),
+};
+// export type Style = keyof typeof style;
+const fg = {
+    black: ansi(30, 39),
+    red: ansi(31, 39),
+    green: ansi(32, 39),
+    yellow: ansi(33, 39),
+    blue: ansi(34, 39),
+    magenta: ansi(35, 39),
+    cyan: ansi(36, 39),
+    white: ansi(37, 39),
+    gray: ansi(90, 39),
+    /** @type {(r: number, g: number, b: number) => (text: string) => string} */
+    rgb: (r, g, b) => rgb(r, g, b, 38, 39),
+};
+// export type Color = keyof typeof fg;
+const bg = {
+    black: ansi(40, 49),
+    red: ansi(41, 49),
+    green: ansi(42, 49),
+    yellow: ansi(43, 49),
+    blue: ansi(44, 49),
+    magenta: ansi(45, 49),
+    cyan: ansi(46, 49),
+    white: ansi(47, 49),
+    /** @type {(r: number, g: number, b: number) => (text: string) => string} */
+    rgb: (r, g, b) => rgb(r, g, b, 48, 49),
+};
+const reset = "\x1b[0m";
+module.exports = {
+    stripAnsiSequences,
+    style,
+    fg,
+    bg,
+    reset,
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name"            : "@peteanderson/ansi",
+	"version"         : "0.0.1",
+	"description"     : "ANSI escape sequence generation with automatic feature detection",
+	"author"          : {
+		"name"  : "Pete Anderson",
+		"email" : "pete.the.anderson@gmail.com"
+	},
+	"repository"      : {
+		"type" : "git",
+		"url"  : "git+https://github.com/anderson-pete/ansi.git"
+	},
+	"keywords"        : ["ansi", "nodejs", "color", "terminal", "cli"],
+	"engines"         : {"node": ">=18"},
+	"files"           : ["dist", "src"],
+	"main"            : "dist/color.js",
+	"types"           : "dist/color.d.ts",
+	"exports"         : {
+		".": {
+			"types"   : "./dist/color.d.ts",
+			"require" : "./dist/color.js"
+		}
+	},
+	"license"         : "MIT",
+	"scripts"         : {
+		"prebuild" : "node -e \"require('node:fs').rmSync('dist', {force: true, recursive: true})\"",
+		"build"    : "tsc -p tsconfig.build.json",
+		"prepack"  : "npm run build",
+		"tag"      : "git tag -a v$npm_package_version -m v$npm_package_version"
+	},
+	"devDependencies" : {
+		"@types/node" : "^26.0.0",
+		"typescript"  : "^6.0.3"
+	}
+}

package/src/color.js

@@ -0,0 +1,101 @@
+/**
+ * @param   {string | undefined} value
+ * @returns {boolean}
+ */
+const isSet = value => !!value && value !== '0' && value.toLowerCase() !== "false";
+
+const enabled =
+	isSet(process.env.FORCE_COLOR) ||
+		!isSet(process.env.NODE_DISABLE_COLORS) &&
+		!isSet(process.env.NO_COLOR) &&
+		process.env.TERM !== "dumb" &&
+		process.stdout.isTTY;
+
+/**
+ * @param   {number | string} open
+ * @param   {number | string} close
+ * @returns {(text: string) => string}
+ */
+function ansi(open, close) {
+	if (!enabled)
+		return s => s;
+
+	const openSequence  = `\x1b[${open}m`;
+	const closeSequence = `\x1b[${close}m`;
+
+	return s =>
+		openSequence +
+		s.replaceAll(openSequence, '').replaceAll(closeSequence, openSequence) +
+		closeSequence;
+}
+
+/** @param {string} text */
+const stripAnsiSequences = text => text.replace(/\x1b\[\d+m/g, '');
+
+/** @type {(r: number, g: number, b: number, open: number, close: number) => (text: string) => string} */
+function rgb(r, g, b, open, close) {
+	if (r === g && g === b) {
+		// Grayscale range.
+		if (r >= 232 && r <= 255)
+			return ansi(`${open};5;${r}`, close);
+	} else if (r >= 0 && r <= 5 && g >= 0 && g <= 5 && b >= 0 && b <= 5) {
+		// 6x6x6 color cube.
+		const code = 16 + r * 36 + g * 6 + b;
+		return ansi(`${open};5;${code}`, close);
+	}
+
+	return ansi(`${open};2;${r};${g};${b}`, close);
+}
+
+const style = {
+	bold          : ansi(1, 22),
+	dim           : ansi(2, 22),
+	italic        : ansi(3, 23),
+	underline     : ansi(4, 24),
+	inverse       : ansi(7, 27),
+	hidden        : ansi(8, 28),
+	strikethrough : ansi(9, 29),
+};
+
+// export type Style = keyof typeof style;
+
+const fg = {
+	black   : ansi(30, 39),
+	red     : ansi(31, 39),
+	green   : ansi(32, 39),
+	yellow  : ansi(33, 39),
+	blue    : ansi(34, 39),
+	magenta : ansi(35, 39),
+	cyan    : ansi(36, 39),
+	white   : ansi(37, 39),
+	gray    : ansi(90, 39),
+
+	/** @type {(r: number, g: number, b: number) => (text: string) => string} */
+	rgb: (r, g, b) => rgb(r, g, b, 38, 39),
+};
+
+// export type Color = keyof typeof fg;
+
+const bg = {
+	black   : ansi(40, 49),
+	red     : ansi(41, 49),
+	green   : ansi(42, 49),
+	yellow  : ansi(43, 49),
+	blue    : ansi(44, 49),
+	magenta : ansi(45, 49),
+	cyan    : ansi(46, 49),
+	white   : ansi(47, 49),
+
+	/** @type {(r: number, g: number, b: number) => (text: string) => string} */
+	rgb: (r, g, b) => rgb(r, g, b, 48, 49),
+};
+
+const reset = "\x1b[0m";
+
+module.exports = {
+	stripAnsiSequences,
+	style,
+	fg,
+	bg,
+	reset,
+};