Easton

Use ANSI styles and HEX/RGB in CLI

Quick Start

Get easton up and running quickly!

1. Run:

   1npm install easton

   1pnpm install easton

   1yarn add easton

   1bun add easton

2. Use:

   ESM (ECMAScript Modules)

   1import easton from 'easton';
   2
   3// Basic usage
   4console.log(easton('bold')('This is bold text'));
   5console.log(easton('#FF0000')('This is red text'));
   6console.log(easton(255, 0, 0)('This is also red text'));
   7
   8// Combining styles and colors
   9console.log(easton('#00FF00', 'bold', 'underline')('Green, bold, and underlined'));
   10
   11// Nesting styles
   12console.log(easton('bold')(
   13  'Bold ' + easton('#FF0000')('and red ') + 'text'
   14));

   CJS (CommonJS)

   1const easton = require('easton');
   2
   3// Basic usage
   4console.log(easton('bold')('This is bold text'));
   5console.log(easton('#FF0000')('This is red text'));
   6console.log(easton(255, 0, 0)('This is also red text'));
   7
   8// Combining styles and colors
   9console.log(easton('#00FF00', 'bold', 'underline')('Green, bold, and underlined'));
   10
   11// Nesting styles
   12console.log(easton('bold')(
   13  'Bold ' + easton('#FF0000')('and red ') + 'text'
   14));

Usage

Easton provides a simple and intuitive API for styling your console output:

1easton(...styles)(text)

Where styles can be:

• Hex color codes (e.g., '#FF0000')
• RGB values (e.g., 255, 0, 0)
• Style names (e.g., 'bold', 'italic')

You can combine multiple styles by passing them as separate arguments.

Available Styles

• bold: Bold text
• italic: Italic text
• underline: Underlined text
• strikethrough: Strikethrough
• blink: (blink - works only in some terminals)
• inverse: Reverses the foreground and background colors
• hidden: Hidden text

Colors

Easton supports:

• Full HEX color codes (e.g., '#FF00FF')
• RGB values (e.g., 255, 0, 255)

Examples

ESM (ECMAScript Modules)

1import easton from 'easton';
2
3// Basic styles
4console.log(easton('bold')('Bold text'));
5console.log(easton('italic')('Italic text'));
6console.log(easton('underline')('Underlined text'));
7
8// HEX colors
9console.log(easton('#FF0000')('Red text'));
10console.log(easton('#00FF00')('Green text'));
11console.log(easton('#0000FF')('Blue text'));
12
13// RGB colors
14console.log(easton(255, 0, 0)('Red text'));
15console.log(easton(0, 255, 0)('Green text'));
16console.log(easton(0, 0, 255)('Blue text'));
17
18// Combining styles and colors
19console.log(easton('#FF00FF', 'bold', 'underline')('Bold, underlined magenta text'));
20
21// Nesting styles
22console.log(easton('bold')(
23  'This is bold ' + easton('#FF0000')('and red ') + 'text'
24));

CJS (CommonJS)

1const easton = require('easton');
2
3// Basic styles
4console.log(easton('bold')('Bold text'));
5console.log(easton('italic')('Italic text'));
6console.log(easton('underline')('Underlined text'));
7
8// HEX colors
9console.log(easton('#FF0000')('Red text'));
10console.log(easton('#00FF00')('Green text'));
11console.log(easton('#0000FF')('Blue text'));
12
13// RGB colors
14console.log(easton(255, 0, 0)('Red text'));
15console.log(easton(0, 255, 0)('Green text'));
16console.log(easton(0, 0, 255)('Blue text'));
17
18// Combining styles and colors
19console.log(easton('#FF00FF', 'bold', 'underline')('Bold, underlined magenta text'));
20
21// Nesting styles
22console.log(easton('bold')(
23  'This is bold ' + easton('#FF0000')('and red ') + 'text'
24));

Contributing

We welcome contributions to easton! Whether it's reporting a bug, suggesting an enhancement, or submitting a pull request, your input is valued.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For any questions, suggestions, or feedback, please contact love1ace.