Skip to main content
Module

std/fmt/colors.ts

Deno standard library
Go to Latest
File
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570
// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.// A module to print ANSI terminal colors. Inspired by chalk, kleur, and colors// on npm.
/** * String formatters and utilities for dealing with ANSI color codes. * * This module is browser compatible. * * This module supports `NO_COLOR` environmental variable disabling any coloring * if `NO_COLOR` is set. * * @example * ```typescript * import { * bgBlue, * bgRgb24, * bgRgb8, * bold, * italic, * red, * rgb24, * rgb8, * } from "https://deno.land/std@$STD_VERSION/fmt/colors.ts"; * * console.log(bgBlue(italic(red(bold("Hello, World!"))))); * * // also supports 8bit colors * * console.log(rgb8("Hello, World!", 42)); * * console.log(bgRgb8("Hello, World!", 42)); * * // and 24bit rgb * * console.log(rgb24("Hello, World!", { * r: 41, * g: 42, * b: 43, * })); * * console.log(bgRgb24("Hello, World!", { * r: 41, * g: 42, * b: 43, * })); * ``` * * @module */
// deno-lint-ignore no-explicit-anyconst { Deno } = globalThis as any;const noColor = typeof Deno?.noColor === "boolean" ? Deno.noColor as boolean : true;
interface Code { open: string; close: string; regexp: RegExp;}
/** RGB 8-bits per channel. Each in range `0->255` or `0x00->0xff` */interface Rgb { r: number; g: number; b: number;}
let enabled = !noColor;
/** * Set changing text color to enabled or disabled * @param value */export function setColorEnabled(value: boolean) { if (noColor) { return; }
enabled = value;}
/** Get whether text color change is enabled or disabled. */export function getColorEnabled(): boolean { return enabled;}
/** * Builds color code * @param open * @param close */function code(open: number[], close: number): Code { return { open: `\x1b[${open.join(";")}m`, close: `\x1b[${close}m`, regexp: new RegExp(`\\x1b\\[${close}m`, "g"), };}
/** * Applies color and background based on color code and its associated text * @param str text to apply color settings to * @param code color code to apply */function run(str: string, code: Code): string { return enabled ? `${code.open}${str.replace(code.regexp, code.open)}${code.close}` : str;}
/** * Reset the text modified * @param str text to reset */export function reset(str: string): string { return run(str, code([0], 0));}
/** * Make the text bold. * @param str text to make bold */export function bold(str: string): string { return run(str, code([1], 22));}
/** * The text emits only a small amount of light. * @param str text to dim */export function dim(str: string): string { return run(str, code([2], 22));}
/** * Make the text italic. * @param str text to make italic */export function italic(str: string): string { return run(str, code([3], 23));}
/** * Make the text underline. * @param str text to underline */export function underline(str: string): string { return run(str, code([4], 24));}
/** * Invert background color and text color. * @param str text to invert its color */export function inverse(str: string): string { return run(str, code([7], 27));}
/** * Make the text hidden. * @param str text to hide */export function hidden(str: string): string { return run(str, code([8], 28));}
/** * Put horizontal line through the center of the text. * @param str text to strike through */export function strikethrough(str: string): string { return run(str, code([9], 29));}
/** * Set text color to black. * @param str text to make black */export function black(str: string): string { return run(str, code([30], 39));}
/** * Set text color to red. * @param str text to make red */export function red(str: string): string { return run(str, code([31], 39));}
/** * Set text color to green. * @param str text to make green */export function green(str: string): string { return run(str, code([32], 39));}
/** * Set text color to yellow. * @param str text to make yellow */export function yellow(str: string): string { return run(str, code([33], 39));}
/** * Set text color to blue. * @param str text to make blue */export function blue(str: string): string { return run(str, code([34], 39));}
/** * Set text color to magenta. * @param str text to make magenta */export function magenta(str: string): string { return run(str, code([35], 39));}
/** * Set text color to cyan. * @param str text to make cyan */export function cyan(str: string): string { return run(str, code([36], 39));}
/** * Set text color to white. * @param str text to make white */export function white(str: string): string { return run(str, code([37], 39));}
/** * Set text color to gray. * @param str text to make gray */export function gray(str: string): string { return brightBlack(str);}
/** * Set text color to bright black. * @param str text to make bright-black */export function brightBlack(str: string): string { return run(str, code([90], 39));}
/** * Set text color to bright red. * @param str text to make bright-red */export function brightRed(str: string): string { return run(str, code([91], 39));}
/** * Set text color to bright green. * @param str text to make bright-green */export function brightGreen(str: string): string { return run(str, code([92], 39));}
/** * Set text color to bright yellow. * @param str text to make bright-yellow */export function brightYellow(str: string): string { return run(str, code([93], 39));}
/** * Set text color to bright blue. * @param str text to make bright-blue */export function brightBlue(str: string): string { return run(str, code([94], 39));}
/** * Set text color to bright magenta. * @param str text to make bright-magenta */export function brightMagenta(str: string): string { return run(str, code([95], 39));}
/** * Set text color to bright cyan. * @param str text to make bright-cyan */export function brightCyan(str: string): string { return run(str, code([96], 39));}
/** * Set text color to bright white. * @param str text to make bright-white */export function brightWhite(str: string): string { return run(str, code([97], 39));}
/** * Set background color to black. * @param str text to make its background black */export function bgBlack(str: string): string { return run(str, code([40], 49));}
/** * Set background color to red. * @param str text to make its background red */export function bgRed(str: string): string { return run(str, code([41], 49));}
/** * Set background color to green. * @param str text to make its background green */export function bgGreen(str: string): string { return run(str, code([42], 49));}
/** * Set background color to yellow. * @param str text to make its background yellow */export function bgYellow(str: string): string { return run(str, code([43], 49));}
/** * Set background color to blue. * @param str text to make its background blue */export function bgBlue(str: string): string { return run(str, code([44], 49));}
/** * Set background color to magenta. * @param str text to make its background magenta */export function bgMagenta(str: string): string { return run(str, code([45], 49));}
/** * Set background color to cyan. * @param str text to make its background cyan */export function bgCyan(str: string): string { return run(str, code([46], 49));}
/** * Set background color to white. * @param str text to make its background white */export function bgWhite(str: string): string { return run(str, code([47], 49));}
/** * Set background color to bright black. * @param str text to make its background bright-black */export function bgBrightBlack(str: string): string { return run(str, code([100], 49));}
/** * Set background color to bright red. * @param str text to make its background bright-red */export function bgBrightRed(str: string): string { return run(str, code([101], 49));}
/** * Set background color to bright green. * @param str text to make its background bright-green */export function bgBrightGreen(str: string): string { return run(str, code([102], 49));}
/** * Set background color to bright yellow. * @param str text to make its background bright-yellow */export function bgBrightYellow(str: string): string { return run(str, code([103], 49));}
/** * Set background color to bright blue. * @param str text to make its background bright-blue */export function bgBrightBlue(str: string): string { return run(str, code([104], 49));}
/** * Set background color to bright magenta. * @param str text to make its background bright-magenta */export function bgBrightMagenta(str: string): string { return run(str, code([105], 49));}
/** * Set background color to bright cyan. * @param str text to make its background bright-cyan */export function bgBrightCyan(str: string): string { return run(str, code([106], 49));}
/** * Set background color to bright white. * @param str text to make its background bright-white */export function bgBrightWhite(str: string): string { return run(str, code([107], 49));}
/* Special Color Sequences */
/** * Clam and truncate color codes * @param n * @param max number to truncate to * @param min number to truncate from */function clampAndTruncate(n: number, max = 255, min = 0): number { return Math.trunc(Math.max(Math.min(n, max), min));}
/** * Set text color using paletted 8bit colors. * https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit * @param str text color to apply paletted 8bit colors to * @param color code */export function rgb8(str: string, color: number): string { return run(str, code([38, 5, clampAndTruncate(color)], 39));}
/** * Set background color using paletted 8bit colors. * https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit * @param str text color to apply paletted 8bit background colors to * @param color code */export function bgRgb8(str: string, color: number): string { return run(str, code([48, 5, clampAndTruncate(color)], 49));}
/** * Set text color using 24bit rgb. * `color` can be a number in range `0x000000` to `0xffffff` or * an `Rgb`. * * To produce the color magenta: * * ```ts * import { rgb24 } from "https://deno.land/std@$STD_VERSION/fmt/colors.ts"; * rgb24("foo", 0xff00ff); * rgb24("foo", {r: 255, g: 0, b: 255}); * ``` * @param str text color to apply 24bit rgb to * @param color code */export function rgb24(str: string, color: number | Rgb): string { if (typeof color === "number") { return run( str, code( [38, 2, (color >> 16) & 0xff, (color >> 8) & 0xff, color & 0xff], 39, ), ); } return run( str, code( [ 38, 2, clampAndTruncate(color.r), clampAndTruncate(color.g), clampAndTruncate(color.b), ], 39, ), );}
/** * Set background color using 24bit rgb. * `color` can be a number in range `0x000000` to `0xffffff` or * an `Rgb`. * * To produce the color magenta: * * ```ts * import { bgRgb24 } from "https://deno.land/std@$STD_VERSION/fmt/colors.ts"; * bgRgb24("foo", 0xff00ff); * bgRgb24("foo", {r: 255, g: 0, b: 255}); * ``` * @param str text color to apply 24bit rgb to * @param color code */export function bgRgb24(str: string, color: number | Rgb): string { if (typeof color === "number") { return run( str, code( [48, 2, (color >> 16) & 0xff, (color >> 8) & 0xff, color & 0xff], 49, ), ); } return run( str, code( [ 48, 2, clampAndTruncate(color.r), clampAndTruncate(color.g), clampAndTruncate(color.b), ], 49, ), );}
// https://github.com/chalk/ansi-regex/blob/02fa893d619d3da85411acc8fd4e2eea0e95a9d9/index.jsconst ANSI_PATTERN = new RegExp( [ "[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)", "(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]))", ].join("|"), "g",);
/** * Remove ANSI escape codes from the string. * @param string to remove ANSI escape codes from */export function stripColor(string: string): string { return string.replace(ANSI_PATTERN, "");}