Highlights

- Expressive API
- Highly performant
- No dependencies
- Ability to nest styles
- 256/Truecolor color support
- Auto-detects color support
- Doesn't extend String.prototype
- Clean and focused
- Actively maintained

Install

``sh
npm install @bobyzgirlllnpm/doloremque-necessitatibus-magni
`

Usage

`js
const { cli, colors, styler } = require("@bobyzgirlllnpm/doloremque-necessitatibus-magni");

cli.println("Hello World");

cli.println(styler.color.red.background.green.italic.underline("Hello World"));
`

$3

`js
const { cli, colors, styler } = require("@bobyzgirlllnpm/doloremque-necessitatibus-magni");

const println = cli.println;

println("Hello World");

println(styler.background.blue.italic.underline("Hello World"));
`

$3

`js
const { cli, colors, styler } = require("@bobyzgirlllnpm/doloremque-necessitatibus-magni");

const error = styler.color.red;
const warning = styler.color.orange;

cli.println(error("Error!"));
cli.println(warning("Warning!!!"));
`

$3

`js
const fs = require("node:fs");
const @bobyzgirlllnpm/doloremque-necessitatibus-magni = require("@bobyzgirlllnpm/doloremque-necessitatibus-magni");

const styler = @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler;
const renderer = @bobyzgirlllnpm/doloremque-necessitatibus-magni.renderer;
const animations = @bobyzgirlllnpm/doloremque-necessitatibus-magni.animations;

const sourceFile = "example.txt";
const destFile = "example_copy.txt";

const progress_bar = renderer.progress(animations.animation1);
const progress_text = renderer.progress({ frames: ["Copying"] });
const progress_path_text = renderer.progress({ frames: [${sourceFile} => ${destFile}] });

const FAIL = styler.color.rgb([24, 24, 24]).background.red.bold(" FAIL ");
const DONE = styler.color.rgb([24, 24, 24]).background.green.bold(" DONE ");

fs.stat(sourceFile, function (err, stat) {
const filesize = stat.size;
let bytesCopied = 0;

const readStream = fs.createReadStream(sourceFile)

readStream.on('data', function (buffer) {
bytesCopied += buffer.length;
let porcentage = ((bytesCopied / filesize) * 100).toFixed(2);
progress_bar.set(porcentage);
});

readStream.on('end', function () {
progress_bar.end(DONE);
progress_text.end(styler.color.rgb([86, 185, 127])("Copyed"));
progress_path_text.end(styler.color.rgb([86, 185, 127])(${sourceFile} => ${destFile}));
});

readStream.on('error', function () {
progress_bar.end(FAIL);
progress_text.end(styler.color.red("Error"));
progress_path_text.end(styler.color.red(${sourceFile} => ${destFile}));
});

readStream.pipe(fs.createWriteStream(destFile));
});

renderer.render([
[styler.bold("Copying following files:")],
[""],
[" ", progress_bar, progress_path_text, progress_text, animations.simpleDots],
]);
`

$3

`js
const @bobyzgirlllnpm/doloremque-necessitatibus-magni = require("@bobyzgirlllnpm/doloremque-necessitatibus-magni");

const println = @bobyzgirlllnpm/doloremque-necessitatibus-magni.cli.println;

const type_string = "Hello World!!";
const type_number = 12345;
const type_arrow_function = (bg) => { hello(); };
function type_function() { hello(); };
const type_object = {
hello: type_arrow_function,
hello2: {
fw: "wfqf",
}
}
const type_symbol = Symbol(type_string);
const type_null = null;
const type_undefined = void 0;
const type_bool = false;
const type_class = class Example {};


println(type_string);
console.log(type_string);

println(type_number);
console.log(type_number);

println(type_arrow_function);
console.log(type_arrow_function);

println(type_function);
console.log(type_function);

println(type_object);
console.log(type_object);

println(type_symbol);
console.log(type_symbol);

println(type_null);
console.log(type_null);

println(type_undefined);
console.log(type_undefined);

println(type_bool);
console.log(type_bool);

println(type_class);
console.log(type_class);

`

API

$3

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.underline('Hello');

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.italic('Hello');

$3

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.color.red.underline('Hello');

$3

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.background.red.underline('Hello');

$3

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.color.hex('#ffffff')('Hello');

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.color.hex('#ffffff').bold('Hello');

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.color.rgb([255, 255, 0])('Hello');

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.color.rgb([255, 255, 0]).bold('Hello');

$3

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.background.hex('#ffffff')('Hello');

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.background.hex('#ffffff').underline('Hello');

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.background.rgb([255, 255, 0])('Hello');

Example: @bobyzgirlllnpm/doloremque-necessitatibus-magni.styler.background.rgb([255, 255, 0]).underline('Hello');

$3

- reset - Reset the current style.
- bold - Make the text bold.
- dim - Make the text have lower opacity.
- italic - Make the text italic. (Not widely supported)
- underline - Put a horizontal line below the text. (Not widely supported)
- doubleline - Put a double horizontal line below the text. (Not widely supported)
- inverse- Invert background and foreground colors.
- hidden - Print the text but make it invisible.
- crossedout - Puts a horizontal line through the center of the text. (Not widely supported)
- color - Set text color
- background - Set background color

$3

- black
- red
- green
- yellow
- blue
- magenta
- cyan
- white
- grey
- orange

Browser support

There is currently no browser version, but we are working on it

Windows

If you're on Windows, do yourself a favor and use Windows Terminal instead of cmd.exe`.

Maintainers

- Universe Company