# ascii-art-ansi

> Ansi codes for ascii-art

Latest version **1.4.1** (published 2021-06-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install ascii-art-ansi
pnpm add ascii-art-ansi
yarn add ascii-art-ansi
bun add ascii-art-ansi
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.4.1 |
| Published | 2021-06-29 |
| First published | 2019-08-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | * |
| Dependencies | 3 |
| Unpacked size | 62.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Abbey Hawk Sparrow |
| Maintainers | khrome |
| Keywords | command-line, formatting, tty, styles, style, str, string, cli, console, terminal, ansi, code |

## Links

- npm: https://www.npmjs.com/package/ascii-art-ansi
- Repository: https://github.com/khrome/ascii-art-ansi
- Issues: https://github.com/khrome/ascii-art-ansi/issues
- npm.io page: https://npm.io/package/ascii-art-ansi

## Dependencies (3)

- [color](https://npm.io/package/color.md) ^3.1.3
- [maplex](https://npm.io/package/maplex.md) *
- [color-difference](https://npm.io/package/color-difference.md) ^0.3.4

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.4.1 (latest) — 2021-06-29
- 1.4.0 — 2021-05-17
- 1.3.7 — 2021-04-27
- 1.3.6 — 2021-04-25
- 1.3.5 — 2021-04-25
- 1.3.4 — 2021-04-25
- 1.3.3 — 2019-12-23
- 1.3.2 — 2019-12-23
- 1.3.1 — 2019-12-23
- 1.3.0 — 2019-12-23
- 1.2.0 — 2019-12-07
- 1.1.1 — 2019-12-06
- 1.1.0 — 2019-11-04
- 1.0.0 — 2019-10-28
- 0.3.0 — 2019-10-28
- … 6 more at https://npm.io/package/ascii-art-ansi/versions

## README

_  _                       _
                      (_)(_)                     | |
      __ _  ___   ___  _  _  ______   __ _  _ __ | |_
     / _` |/ __| / __|| || ||______| / _` || '__|| __|
    | (_| |\__ \| (__ | || |        | (_| || |   | |_
     \__,_||___/ \___||_||_|         \__,_||_|    \__|

ascii-art-ansi.js
=================

[![NPM version](https://img.shields.io/npm/v/ascii-art-ansi.svg)]()
[![npm](https://img.shields.io/npm/dt/ascii-art-ansi.svg)]()
[![Travis](https://img.shields.io/travis/khrome/ascii-art-ansi.svg)]()

This module allows you to work with ansi strings in a style aware way, so you aren't constantly doing string manipulation and scanning when working with terminal strings. It offers a clean abstraction to build ascii-art utilities on top of.


Installation
------------

    npm install ascii-art-ansi


Usage
------

<a name="module_ascii_art_ansi"></a>
### require('ascii-art-ansii')
To do anything with it, you'll need to include the library:

```javascript
    const ansi = require('ascii-art-ansi');
    const color = require('ascii-art-ansi/color');
```

* [ascii-art-ansi](#module_ascii_art_ansi)
  * [.map(ansi_string, handler)](#module_ascii_art_ansi.map) ⇒ <code>string</code>
  * [.length(ansi_string)](#module_ascii_art_ansi.length) ⇒ <code>int</code>
  * [.strip(ansi_string)](#module_ascii_art_ansi.strip) ⇒ <code>string</code>
  * [.toArray(ansi_string)](#module_ascii_art_ansi.to_array) ⇒ <code>Array</code>
  * [.substring(ansi_string, start, stop)](#module_ascii_art_ansi.substring) ⇒ <code>string</code>
  * [.charAt(ansi_string, position)](#module_ascii_art_ansi.charat) ⇒ <code>string</code> (length:1)
  * [.intersect(string1, .. stingN, callback)](#module_ascii_art_ansi.intersect) ⇒ <code>Promise</code> (if callback not present)
  * [.interstyle(string1, .. stingN, callback)](#module_ascii_art_ansi.interstyle) ⇒ <code>Promise</code> (if callback not present)
* [ascii-art-ansi/color](#module_ascii_art_ansi.color)
    * [Color.code(value)](#module_ascii_art_ansi.color.code) ⇒ <code>string</code>
    * [Color.name(value)](#module_ascii_art_ansi.color.name) ⇒ <code>string</code>
    * [Color.is256](#module_ascii_art_ansi.color.is256) ⇒ <code>boolean</code>
    * [Color.isTrueColor](#module_ascii_art_ansi.color.isTrueColor) ⇒ <code>boolean</code>

<a name="module_ascii_art_ansi.map"></a>
### .map(ansiString, handler)
Map through an ansi string one character at a time, without any of those characters being styles.

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| ansiString | <code>string</code> | input string to map across |
| handler | <code>function</code> | the function to map through the string |

**Example**

```javascript
    var result = ansi.map(
        ansiString,
        function(chr, codes, rowcol, pos, shortcircuit){
            // chr : the character
            // codes : a list of the active ansi codes as strings
            // rowcol: array of the 2D position of chr in a multiline string
            // pos : the position of the character
            // shortcircuit : function which stops processing after return
        }
    );
```

<a name="module_ascii_art_ansi.length"></a>
### .length(ansiString)
The number of non ansi code characters in the string

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| ansiString | <code>string</code> | input string to measure |

**Example**

```javascript
    var result = ansi.length(ansiString);
```

<a name="module_ascii_art_ansi.strip"></a>
### .strip(ansiString)
Remove any ansi codes from the string

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| ansiString | <code>string</code> | input string to measure |

**Example**

```javascript
    var result = ansi.strip(ansiString);
```

<a name="module_ascii_art_ansi.to_array"></a>
### .length(ansiString)
convert this string to an array of characters

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| ansiString | <code>string</code> | input string to measure |

**Example**

```javascript
    var result = ansi.toArray(ansiString);
```

<a name="module_ascii_art_ansi.charat"></a>
### .charAt(ansiString)
Extract a specific character from the string, by position
**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| ansiString | <code>string</code> | input string to measure |

**Example**

```javascript
    var chr = ansi.charAt(ansiString, 4);
```

<a name="module_ascii_art_ansi.substring"></a>
### .substring(ansiString, start, stop)
Like the javascript built-in substring, but ansi aware

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| ansiString | <code>string</code> | input string to measure |

**Example**

```javascript
    var chr = ansi.trimTo(ansiString, 4);
```

<a name="module_ascii_art_ansi.intersect"></a>
### .intersect(ansiString)
Intersect/overlay any number of strings

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| inputString(N) | <code>string</code> | input string to measure |
| callback | <code>function</code> | callback to handle asynchronous return, if omitted, a promise is returned |

**Example**

```javascript
    var chr = ansi.intersect(s1, s2, s3, function(err, result){
        // ['A  ', ' B ', '  C'] -> 'ABC'
    });
```

<a name="module_ascii_art_ansi.interstyle"></a>
### .interstyle(ansiString)
Intersect/overlay any number of strings and include their styles

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| inputString(N) | <code>string</code> | input string to measure |
| callback | <code>function</code> | callback to handle asynchronous return, if omitted, a promise is returned |

**Example**

```javascript
    var chr = ansi.interstyle(s1, s2, s3, function(err, result){
        // ['A  ', ' B ', '  C'] -> 'ABC'
    });
```

<a name="module_ascii_art_ansi.color"></a>
### .Color(options)
Intersect/overlay any number of strings and include their styles

**Kind**: static property of <code>[ascii-art-ansi](#ascii-art-ansi)</code>

| Param | Type | Description |
| --- | --- | --- |
| options | <code>Object</code> | options |

**Example**

```javascript
    var color = new Color('#FFFFFF')
```

<a name="module_ascii_art_ansi.color.code"></a>
### .Color.code(value)
Compute the code for the given hex color (closest within the active palette)

**Kind**: static property of <code>[ascii-art-ansi/color](#module_ascii_art_ansi.color)</code>

| Param | Type | Description |
| --- | --- | --- |
| value | <code>string</code> | the hex value color of the color |

**Example**

```javascript
    var ansiCode = Color.code('#FF0000');
```

<a name="module_ascii_art_ansi.color.name"></a>
### .Color.name(value)
Compute the code for the given named color (closest within the active palette)

**Kind**: static property of <code>[ascii-art-ansi/color](#module_ascii_art_ansi.color)</code>

| Param | Type | Description |
| --- | --- | --- |
| value | <code>string</code> | the name of the color |

**Example**

```javascript
    var ansiCode = Color.name('red');
```

<a name="module_ascii_art_ansi.color.is256"></a>
### .Color.is256
If set colors will be computed using 256 colors instead of 16.
Colors are averaged according to a color averaging scheme which can be changed with `Color.useDistance(name);`
where name is one of `euclideanDistance`, `classic`, `ratioDistance`, `classicByValue`, `CIE76Difference`, `closestByIntensity`, `rankedChannel`, `simple`, `original`

**Kind**: static property of <code>[ascii-art-ansi/color](#module_ascii_art_ansi.color)</code>

**Example**

```javascript
    Color.is256 = true;
```

<a name="module_ascii_art_ansi.color.isTrueColor"></a>
### .Color.isTrueColor
If set colors will be computed using millions of colors

**Kind**: static property of <code>[ascii-art-ansi/color](#module_ascii_art_ansi.color)</code>

**Example**

```javascript
    Color.isTrueColor = true;
```

Roadmap
-------

#### Goals
- color reducer
- streaming
- pluggable colorsets/encodings


Testing
-------
In the root directory run:

	npm run test

Please make sure to run the tests before submitting a patch and report any rough edges. Thanks!

Enjoy,

-Abbey Hawk Sparrow

---
_Source: https://npm.io/package/ascii-art-ansi · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._