sindresorhus

ansi-styles

	"description": "ANSI escape codes for styling strings in the terminal",

	"funding": "https://github.com/chalk/ansi-styles?sponsor=1",

		"screenshot": "svg-term --command='node screenshot' --out=screenshot.svg --padding=3 --width=55 --height=3 --at=1000 --no-cursor"

# ansi-styles [![Build Status](https://travis-ci.org/chalk/ansi-styles.svg?branch=master)](https://travis-ci.org/chalk/ansi-styles)

> [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors_and_Styles) for styling strings in the terminal

You probably want the higher-level [chalk](https://github.com/chalk/chalk) module for styling your strings.

console.log(`${style.green.open}Hello world!${style.green.close}`);

// Color conversion between 16/256/truecolor

// NOTE: If conversion goes to 16 colors or 256 colors, the original color

//       may be degraded to fit that color palette. This means terminals

//       that do not support 16 million colors will best-match the

console.log(style.bgColor.ansi.hsl(120, 80, 72) + 'Hello world!' + style.bgColor.close);

console.log(style.color.ansi256.rgb(199, 20, 250) + 'Hello world!' + style.color.close);

console.log(style.color.ansi16m.hex('#abcdef') + 'Hello world!' + style.color.close);

Each style has an `open` and `close` property.

- `strikethrough` *(Not widely supported)*

- `bgBlackBright` (alias: `bgGray`, `bgGrey`)

By default, you get a map of styles, but the styles are also available as groups. They are non-enumerable so they don't show up unless you access them explicitly. This makes it easier to expose only a subset in a higher-level module.

Raw escape codes (i.e. without the CSI escape prefix `\u001B[` and render mode postfix `m`) are available under `style.codes`, which returns a `Map` with the open codes as keys and close codes as values.

## [256 / 16 million (TrueColor) support](https://gist.github.com/XVilka/8346728)

`ansi-styles` uses the [`color-convert`](https://github.com/Qix-/color-convert) package to allow for converting between various colors and ANSI escapes, with support for 256 and 16 million colors.

The following color spaces from `color-convert` are supported:

To use these, call the associated conversion function with the intended output, for example:

style.color.ansi.rgb(100, 200, 15); // RGB to 16 color ansi foreground code

style.bgColor.ansi.rgb(100, 200, 15); // RGB to 16 color ansi background code

style.color.ansi256.hsl(120, 100, 60); // HSL to 256 color ansi foreground code

style.bgColor.ansi256.hsl(120, 100, 60); // HSL to 256 color ansi foreground code

style.color.ansi16m.hex('#C0FFEE'); // Hex (RGB) to 16 million color foreground code

style.bgColor.ansi16m.hex('#C0FFEE'); // Hex (RGB) to 16 million color background code

- [ansi-escapes](https://github.com/sindresorhus/ansi-escapes) - ANSI escape codes for manipulating the terminal

- [Sindre Sorhus](https://github.com/sindresorhus)

		<a href="https://tidelift.com/subscription/pkg/npm-ansi-styles?utm_source=npm-ansi-styles&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>

		Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.

		{
		"name": "ansi-styles",
		"version": "4.2.0",
		"version": "4.2.1",
		"description": "ANSI escape codes for styling strings in the terminal",
		"license": "MIT",
		"repository": "chalk/ansi-styles",
		"funding": "https://github.com/chalk/ansi-styles?sponsor=1",
		"author": {
		@@ -53,5 +54,5 @@ "name": "Sindre Sorhus",
		"svg-term-cli": "^2.1.1",
		"tsd": "^0.10.0",
		"tsd": "^0.11.0",
		"xo": "^0.25.3"
		}
		}

		@@ -9,3 +9,2 @@ # ansi-styles [![Build Status](https://travis-ci.org/chalk/ansi-styles.svg?branch=master)](https://travis-ci.org/chalk/ansi-styles)


		## Install
		@@ -17,3 +16,2 @@


		## Usage
		@@ -41,3 +39,2 @@


		## Styles
		@@ -94,3 +91,2 @@


		## Advanced usage
		@@ -119,3 +115,2 @@


		## [256 / 16 million (TrueColor) support](https://gist.github.com/XVilka/8346728)
		@@ -149,3 +144,2 @@


		## Related
		@@ -155,3 +149,2 @@


		## Maintainers
		@@ -162,3 +155,2 @@


		---
		@@ -165,0 +157,0 @@

Improved metrics

Worsened metrics