chalk 2.0.1 → 2.1.0

package/index.js

@@ -19,13 +19,14 @@ function applyOptions(obj, options) {
 	options = options || {};
 
 	// Detect level if not set manually
-	obj.level = options.level === undefined ? supportsColor.level : options.level;
+	const scLevel = supportsColor ? supportsColor.level : 0;
+	obj.level = options.level === undefined ? scLevel : options.level;
 	obj.enabled = 'enabled' in options ? options.enabled : obj.level > 0;
 }
 
 function Chalk(options) {
-	// We check for this.template here since calling chalk.constructor()
-	// by itself will have a `this` of a previously constructed chalk object.
+	// We check for this.template here since calling `chalk.constructor()`
+	// by itself will have a `this` of a previously constructed chalk object
 	if (!this || !(this instanceof Chalk) || this.template) {
 		const chalk = {};
 		applyOptions(chalk, options);
@@ -142,7 +143,7 @@ function build(_styles, key) {
 	builder.hasGrey = this.hasGrey || key === 'gray' || key === 'grey';
 
 	// `__proto__` is used because we must return a function, but there is
-	// no way to create a function with a different prototype.
+	// no way to create a function with a different prototype
 	builder.__proto__ = proto; // eslint-disable-line no-proto
 
 	return builder;
@@ -152,7 +153,11 @@ function applyStyle() {
 	// Support varags, but simply cast to string in case there's only one arg
 	const args = arguments;
 	const argsLen = args.length;
-	let str = argsLen !== 0 && String(arguments[0]);
+	let str = String(arguments[0]);
+
+	if (argsLen === 0) {
+		return '';
+	}
 
 	if (argsLen > 1) {
 		// Don't slice `arguments`, it prevents V8 optimizations
@@ -192,17 +197,18 @@ function applyStyle() {
 }
 
 function chalkTag(chalk, strings) {
-	const args = [].slice.call(arguments, 2);
-
 	if (!Array.isArray(strings)) {
-		return strings.toString();
+		// If chalk() was called by itself or with a string,
+		// return the string itself as a string.
+		return [].slice.call(arguments, 1).join(' ');
 	}
 
+	const args = [].slice.call(arguments, 2);
 	const parts = [strings.raw[0]];
 
 	for (let i = 1; i < strings.length; i++) {
-		parts.push(args[i - 1].toString().replace(/[{}]/g, '\\$&'));
-		parts.push(strings.raw[i]);
+		parts.push(String(args[i - 1]).replace(/[{}\\]/g, '\\$&'));
+		parts.push(String(strings.raw[i]));
 	}
 
 	return template(chalk, parts.join(''));

package/package.json

@@ -1,14 +1,14 @@
 {
 	"name": "chalk",
-	"version": "2.0.1",
-	"description": "Terminal string styling done right. Much color",
+	"version": "2.1.0",
+	"description": "Terminal string styling done right",
 	"license": "MIT",
 	"repository": "chalk/chalk",
 	"engines": {
 		"node": ">=4"
 	},
 	"scripts": {
-		"test": "xo && nyc mocha",
+		"test": "xo && nyc ava",
 		"bench": "matcha benchmark.js",
 		"coveralls": "nyc report --reporter=text-lcov | coveralls"
 	},
@@ -45,10 +45,11 @@
 		"supports-color": "^4.0.0"
 	},
 	"devDependencies": {
+		"ava": "*",
 		"coveralls": "^2.11.2",
+		"execa": "^0.7.0",
 		"import-fresh": "^2.0.0",
 		"matcha": "^0.7.0",
-		"mocha": "*",
 		"nyc": "^11.0.2",
 		"resolve-from": "^3.0.0",
 		"xo": "*"

package/readme.md

@@ -11,9 +11,7 @@
 
 [![Build Status](https://travis-ci.org/chalk/chalk.svg?branch=master)](https://travis-ci.org/chalk/chalk) [![Coverage Status](https://coveralls.io/repos/github/chalk/chalk/badge.svg?branch=master)](https://coveralls.io/github/chalk/chalk?branch=master) [![](https://img.shields.io/badge/unicorn-approved-ff69b4.svg)](https://www.youtube.com/watch?v=9auOCbH5Ns4) [![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/sindresorhus/xo)
 
-[colors.js](https://github.com/Marak/colors.js) used to be the most popular string styling module, but it has serious deficiencies like extending `String.prototype` which causes all kinds of [problems](https://github.com/yeoman/yo/issues/68). Although there are other ones, they either do too much or not enough.
-
-**Chalk is a clean and focused alternative.**
+### [See what's new in Chalk 2](https://github.com/chalk/chalk/releases/tag/v2.0.0)
 
 ![](https://github.com/chalk/ansi-styles/raw/master/screenshot.png)
 
@@ -183,8 +181,7 @@ Explicit 256/Truecolor mode can be enabled using the `--color=256` and `--color=
 - `magenta`
 - `cyan`
 - `white`
-- `gray`
-- `blackBright`
+- `gray` ("bright black")
 - `redBright`
 - `greenBright`
 - `yellowBright`
@@ -278,6 +275,11 @@ The following color models can be used:
 If you're on Windows, do yourself a favor and use [`cmder`](http://cmder.net/) instead of `cmd.exe`.
 
 
+## Origin story
+
+[colors.js](https://github.com/Marak/colors.js) used to be the most popular string styling module, but it has serious deficiencies like extending `String.prototype` which causes all kinds of [problems](https://github.com/yeoman/yo/issues/68) and the package is unmaintained. Although there are other packages, they either do too much or not enough. Chalk is a clean and focused alternative.
+
+
 ## Related
 
 - [chalk-cli](https://github.com/chalk/chalk-cli) - CLI for this module
@@ -289,6 +291,8 @@ If you're on Windows, do yourself a favor and use [`cmder`](http://cmder.net/) i
 - [wrap-ansi](https://github.com/chalk/wrap-ansi) - Wordwrap a string with ANSI escape codes
 - [slice-ansi](https://github.com/chalk/slice-ansi) - Slice a string with ANSI escape codes
 - [color-convert](https://github.com/qix-/color-convert) - Converts colors between different models
+- [chalk-animation](https://github.com/bokub/chalk-animation) - Animate strings in the terminal
+- [gradient-string](https://github.com/bokub/gradient-string) - Apply color gradients to strings
 
 
 ## Maintainers

package/templates.js

@@ -1,175 +1,128 @@
 'use strict';
+const TEMPLATE_REGEX = /(?:\\(u[a-f0-9]{4}|x[a-f0-9]{2}|.))|(?:\{(~)?(\w+(?:\([^)]*\))?(?:\.\w+(?:\([^)]*\))?)*)(?:[ \t]|(?=\r?\n)))|(\})|((?:.|[\r\n\f])+?)/gi;
+const STYLE_REGEX = /(?:^|\.)(\w+)(?:\(([^)]*)\))?/g;
+const STRING_REGEX = /^(['"])((?:\\.|(?!\1)[^\\])*)\1$/;
+const ESCAPE_REGEX = /\\(u[0-9a-f]{4}|x[0-9a-f]{2}|.)|([^\\])/gi;
+
+const ESCAPES = {
+	n: '\n',
+	r: '\r',
+	t: '\t',
+	b: '\b',
+	f: '\f',
+	v: '\v',
+	0: '\0',
+	'\\': '\\',
+	e: '\u001b',
+	a: '\u0007'
+};
 
-function data(parent) {
-	return {
-		styles: [],
-		parent,
-		contents: []
-	};
-}
-
-const zeroBound = n => n < 0 ? 0 : n;
-const lastIndex = a => zeroBound(a.length - 1);
+function unescape(c) {
+	if ((c[0] === 'u' && c.length === 5) || (c[0] === 'x' && c.length === 3)) {
+		return String.fromCharCode(parseInt(c.slice(1), 16));
+	}
 
-const last = a => a[lastIndex(a)];
+	return ESCAPES[c] || c;
+}
 
-const takeWhileReverse = (array, predicate, start) => {
-	const out = [];
+function parseArguments(name, args) {
+	const results = [];
+	const chunks = args.trim().split(/\s*,\s*/g);
+	let matches;
 
-	for (let i = start; i >= 0 && i <= start; i--) {
-		if (predicate(array[i])) {
-			out.unshift(array[i]);
+	for (const chunk of chunks) {
+		if (!isNaN(chunk)) {
+			results.push(Number(chunk));
+		} else if ((matches = chunk.match(STRING_REGEX))) {
+			results.push(matches[2].replace(ESCAPE_REGEX, (m, escape, chr) => escape ? unescape(escape) : chr));
 		} else {
-			break;
+			throw new Error(`Invalid Chalk template style argument: ${chunk} (in style '${name}')`);
 		}
 	}
 
-	return out;
-};
-
-/**
- * Checks if the character at position i in string is a normal character a.k.a a non control character.
- * */
-const isNormalCharacter = (string, i) => {
-	const char = string[i];
-	const backslash = '\\';
-
-	if (!(char === backslash || char === '{' || char === '}')) {
-		return true;
-	}
-
-	const n = i === 0 ? 0 : takeWhileReverse(string, x => x === '\\', zeroBound(i - 1)).length;
+	return results;
+}
 
-	return n % 2 === 1;
-};
+function parseStyle(style) {
+	STYLE_REGEX.lastIndex = 0;
 
-const collectStyles = data => data ? collectStyles(data.parent).concat(data.styles) : ['reset'];
+	const results = [];
+	let matches;
 
-/**
- * Computes the style for a given data based on it's style and the style of it's parent. Also accounts for !style styles
- * which remove a style from the list if present.
- * */
-const sumStyles = data => {
-	const negateRegex = /^~.+/;
-	let out = [];
+	while ((matches = STYLE_REGEX.exec(style)) !== null) {
+		const name = matches[1];
 
-	for (const style of collectStyles(data)) {
-		if (negateRegex.test(style)) {
-			const exclude = style.slice(1);
-			out = out.filter(x => x !== exclude);
+		if (matches[2]) {
+			const args = parseArguments(name, matches[2]);
+			results.push([name].concat(args));
 		} else {
-			out.push(style);
+			results.push([name]);
 		}
 	}
 
-	return out;
-};
-
-/**
- * Takes a string and parses it into a tree of data objects which inherit styles from their parent.
- * */
-function parse(string) {
-	const root = data(null);
-	let pushingStyle = false;
-
-	let current = root;
+	return results;
+}
 
-	for (let i = 0; i < string.length; i++) {
-		const char = string[i];
+function buildStyle(chalk, styles) {
+	const enabled = {};
 
-		const addNormalCharacter = () => {
-			const lastChunk = last(current.contents);
+	for (const layer of styles) {
+		for (const style of layer.styles) {
+			enabled[style[0]] = layer.inverse ? null : style.slice(1);
+		}
+	}
 
-			if (typeof lastChunk === 'string') {
-				current.contents[lastIndex(current.contents)] = lastChunk + char;
-			} else {
-				current.contents.push(char);
+	let current = chalk;
+	for (const styleName of Object.keys(enabled)) {
+		if (Array.isArray(enabled[styleName])) {
+			if (!(styleName in current)) {
+				throw new Error(`Unknown Chalk style: ${styleName}`);
 			}
-		};
-
-		if (pushingStyle) {
-			if (' \t'.indexOf(char) > -1) {
-				pushingStyle = false;
-			} else if (char === '\n') {
-				pushingStyle = false;
-				addNormalCharacter();
-			} else if (char === '.') {
-				current.styles.push('');
+
+			if (enabled[styleName].length > 0) {
+				current = current[styleName].apply(current, enabled[styleName]);
 			} else {
-				current.styles[lastIndex(current.styles)] = (last(current.styles) || '') + char;
+				current = current[styleName];
 			}
-		} else if (isNormalCharacter(string, i)) {
-			addNormalCharacter();
-		} else if (char === '{') {
-			pushingStyle = true;
-			const nCurrent = data(current);
-			current.contents.push(nCurrent);
-			current = nCurrent;
-		} else if (char === '}') {
-			current = current.parent;
 		}
 	}
 
-	if (current !== root) {
-		throw new Error('literal template has an unclosed block');
-	}
-
-	return root;
+	return current;
 }
 
-/**
- * Takes a tree of data objects and flattens it to a list of data objects with the inherited and negations styles
- * accounted for.
- * */
-function flatten(data) {
-	let flat = [];
-
-	for (const content of data.contents) {
-		if (typeof content === 'string') {
-			flat.push({
-				styles: sumStyles(data),
-				content
-			});
+module.exports = (chalk, tmp) => {
+	const styles = [];
+	const chunks = [];
+	let chunk = [];
+
+	// eslint-disable-next-line max-params
+	tmp.replace(TEMPLATE_REGEX, (m, escapeChar, inverse, style, close, chr) => {
+		if (escapeChar) {
+			chunk.push(unescape(escapeChar));
+		} else if (style) {
+			const str = chunk.join('');
+			chunk = [];
+			chunks.push(styles.length === 0 ? str : buildStyle(chalk, styles)(str));
+			styles.push({inverse, styles: parseStyle(style)});
+		} else if (close) {
+			if (styles.length === 0) {
+				throw new Error('Found extraneous } in Chalk template literal');
+			}
+
+			chunks.push(buildStyle(chalk, styles)(chunk.join('')));
+			chunk = [];
+			styles.pop();
 		} else {
-			flat = flat.concat(flatten(content));
+			chunk.push(chr);
 		}
-	}
-
-	return flat;
-}
+	});
 
-function assertStyle(chalk, style) {
-	if (!chalk[style]) {
-		throw new Error(`invalid Chalk style: ${style}`);
-	}
-}
+	chunks.push(chunk.join(''));
 
-/**
- * Checks if a given style is valid and parses style functions.
- * */
-function parseStyle(chalk, style) {
-	const fnMatch = style.match(/^\s*(\w+)\s*\(\s*([^)]*)\s*\)\s*/);
-	if (!fnMatch) {
-		assertStyle(chalk, style);
-		return chalk[style];
+	if (styles.length > 0) {
+		const errMsg = `Chalk template literal is missing ${styles.length} closing bracket${styles.length === 1 ? '' : 's'} (\`}\`)`;
+		throw new Error(errMsg);
 	}
 
-	const name = fnMatch[1].trim();
-	const args = fnMatch[2].split(/,/g).map(s => s.trim());
-
-	assertStyle(chalk, name);
-
-	return chalk[name].apply(chalk, args);
-}
-
-/**
- * Performs the actual styling of the string, essentially lifted from cli.js.
- * */
-function style(chalk, flat) {
-	return flat.map(data => {
-		const fn = data.styles.reduce(parseStyle, chalk);
-		return fn(data.content.replace(/\n$/, ''));
-	}).join('');
-}
-
-module.exports = (chalk, string) => style(chalk, flatten(parse(string)));
+	return chunks.join('');
+};