nyc 12.0.2 → 13.0.0

package/node_modules/snapdragon/README.md

@@ -1,321 +0,0 @@
-# snapdragon [![NPM version](https://img.shields.io/npm/v/snapdragon.svg?style=flat)](https://www.npmjs.com/package/snapdragon) [![NPM downloads](https://img.shields.io/npm/dm/snapdragon.svg?style=flat)](https://npmjs.org/package/snapdragon) [![Build Status](https://img.shields.io/travis/jonschlinkert/snapdragon.svg?style=flat)](https://travis-ci.org/jonschlinkert/snapdragon)
-
-> Fast, pluggable and easy-to-use parser-renderer factory.
-
-## Install
-
-Install with [npm](https://www.npmjs.com/):
-
-```sh
-$ npm install --save snapdragon
-```
-
-Created by [jonschlinkert](https://github.com/jonschlinkert) and [doowb](https://github.com/doowb).
-
-**Features**
-
-* Bootstrap your own parser, get sourcemap support for free
-* All parsing and compiling is handled by simple, reusable middleware functions
-* Inspired by the parsers in [pug](http://jade-lang.com) and [css](https://github.com/reworkcss/css).
-
-## History
-
-### v0.5.0
-
-**Breaking changes**
-
-Substantial breaking changes were made in v0.5.0! Most of these changes are part of a larger refactor that will be finished in 0.6.0, including the introduction of a `Lexer` class.
-
-* Renderer was renamed to `Compiler`
-* the `.render` method was renamed to `.compile`
-* Many other smaller changes. A more detailed overview will be provided in 0.6.0. If you don't have to time review code, I recommend you wait for the 0.6.0 release.
-
-## Usage examples
-
-```js
-var Snapdragon = require('snapdragon');
-var snapdragon = new Snapdragon();
-```
-
-**Parse**
-
-```js
-var ast = snapdragon.parser('some string', options)
-  // parser middleware that can be called by other middleware
-  .set('foo', function () {})
-  // parser middleware, runs immediately in the order defined
-  .use(bar())
-  .use(baz())
-```
-
-**Render**
-
-```js
-// pass the `ast` from the parse method
-var res = snapdragon.compiler(ast)
-  // compiler middleware, called when the name of the middleware
-  // matches the `node.type` (defined in a parser middleware)
-  .set('bar', function () {})
-  .set('baz', function () {})
-  .compile()
-```
-
-See the [examples](./examples/).
-
-## Getting started
-
-**Parsers**
-
-Parsers are middleware functions used for parsing a string into an ast node.
-
-```js
-var ast = snapdragon.parser(str, options)
-  .use(function() {
-    var pos = this.position();
-    var m = this.match(/^\./);
-    if (!m) return;
-    return pos({
-      // `type` specifies the compiler to use
-      type: 'dot',
-      val: m[0]
-    });
-  })
-```
-
-**AST node**
-
-When the parser finds a match, `pos()` is called, pushing a token for that node onto the ast that looks something like:
-
-```js
-{ type: 'dot',
-  val: '.',
-  position:
-   { start: { lineno: 1, column: 1 },
-     end: { lineno: 1, column: 2 } }}
-```
-
-**Renderers**
-
-Renderers are _named_ middleware functions that visit over an array of ast nodes to compile a string.
-
-```js
-var res = snapdragon.compiler(ast)
-  .set('dot', function (node) {
-    console.log(node.val)
-    //=> '.'
-    return this.emit(node.val);
-  })
-```
-
-**Source maps**
-
-If you want source map support, make sure to emit the position as well.
-
-```js
-var res = snapdragon.compiler(ast)
-  .set('dot', function (node) {
-    return this.emit(node.val, node.position);
-  })
-```
-
-## Docs
-
-### Parser middleware
-
-A parser middleware is a function that returns an abject called a `token`. This token is pushed onto the AST as a node.
-
-**Example token**
-
-```js
-{ type: 'dot',
-  val: '.',
-  position:
-   { start: { lineno: 1, column: 1 },
-     end: { lineno: 1, column: 2 } }}
-```
-
-**Example parser middleware**
-
-Match a single `.` in a string:
-
-1. Get the starting position by calling `this.position()`
-2. pass a regex for matching a single dot to the `.match` method
-3. if **no match** is found, return `undefined`
-4. if a **match** is found, `pos()` is called, which returns a token with:
-  - `type`: the name of the [compiler] to use
-  - `val`: The actual value captured by the regex. In this case, a `.`. Note that you can capture and return whatever will be needed by the corresponding [compiler].
-  - The ending position: automatically calculated by adding the length of the first capture group to the starting position.
-
-## Renderer middleware
-
-Renderers are run when the name of the compiler middleware matches the `type` defined on an ast `node` (which is defined in a parser).
-
-**Example**
-
-Exercise: Parse a dot, then compile it as an escaped dot.
-
-```js
-var ast = snapdragon.parser('.')
-  .use(function () {
-    var pos = this.position();
-    var m = this.match(/^\./);
-    if (!m) return;
-    return pos({
-      // define the `type` of compiler to use
-      type: 'dot',
-      val: m[0]
-    })
-  })
-
-var result = snapdragon.compiler(ast)
-  .set('dot', function (node) {
-    return this.emit('\\' + node.val);
-  })
-  .compile()
-
-console.log(result.output);
-//=> '\.'
-```
-
-## API
-
-### [Parser](lib/parser.js#L19)
-
-Create a new `Parser` with the given `input` and `options`.
-
-**Params**
-
-* `input` **{String}**
-* `options` **{Object}**
-
-### [.define](lib/parser.js#L103)
-
-Define a non-enumberable property on the `Parser` instance.
-
-**Example**
-
-```js
-parser.define('foo', 'bar');
-```
-
-**Params**
-
-* `key` **{String}**: propery name
-* `val` **{any}**: property value
-* `returns` **{Object}**: Returns the Parser instance for chaining.
-
-Set parser `name` with the given `fn`
-
-**Params**
-
-* `name` **{String}**
-* `fn` **{Function}**
-
-Get parser `name`
-
-**Params**
-
-* `name` **{String}**
-
-Push a `token` onto the `type` stack.
-
-**Params**
-
-* `type` **{String}**
-* `returns` **{Object}** `token`
-
-Pop a token off of the `type` stack
-
-**Params**
-
-* `type` **{String}**
-* `returns` **{Object}**: Returns a token
-
-Return true if inside a `stack` node. Types are `braces`, `parens` or `brackets`.
-
-**Params**
-
-* `type` **{String}**
-* `returns` **{Boolean}**
-
-**Example**
-
-```js
-parser.isType(node, 'brace');
-```
-
-**Params**
-
-* `node` **{Object}**
-* `type` **{String}**
-* `returns` **{Boolean}**
-
-### [.define](lib/compiler.js#L71)
-
-Define a non-enumberable property on the `Compiler` instance.
-
-**Example**
-
-```js
-compiler.define('foo', 'bar');
-```
-
-**Params**
-
-* `key` **{String}**: propery name
-* `val` **{any}**: property value
-* `returns` **{Object}**: Returns the Compiler instance for chaining.
-
-## About
-
-### Related projects
-
-* [braces](https://www.npmjs.com/package/braces): Fastest brace expansion for node.js, with the most complete support for the Bash 4.3 braces… [more](https://github.com/jonschlinkert/braces) | [homepage](https://github.com/jonschlinkert/braces "Fastest brace expansion for node.js, with the most complete support for the Bash 4.3 braces specification.")
-* [expand-brackets](https://www.npmjs.com/package/expand-brackets): Expand POSIX bracket expressions (character classes) in glob patterns. | [homepage](https://github.com/jonschlinkert/expand-brackets "Expand POSIX bracket expressions (character classes) in glob patterns.")
-* [extglob](https://www.npmjs.com/package/extglob): Convert extended globs to regex-compatible strings. Add (almost) the expressive power of regular expressions to… [more](https://github.com/jonschlinkert/extglob) | [homepage](https://github.com/jonschlinkert/extglob "Convert extended globs to regex-compatible strings. Add (almost) the expressive power of regular expressions to glob patterns.")
-* [micromatch](https://www.npmjs.com/package/micromatch): Glob matching for javascript/node.js. A drop-in replacement and faster alternative to minimatch and multimatch. | [homepage](https://github.com/jonschlinkert/micromatch "Glob matching for javascript/node.js. A drop-in replacement and faster alternative to minimatch and multimatch.")
-
-### Contributing
-
-Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).
-
-### Contributors
-
-| **Commits** | **Contributor**<br/> | 
-| --- | --- |
-| 106 | [jonschlinkert](https://github.com/jonschlinkert) |
-| 2 | [doowb](https://github.com/doowb) |
-
-### Building docs
-
-_(This document was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme) (a [verb](https://github.com/verbose/verb) generator), please don't edit the readme directly. Any changes to the readme must be made in [.verb.md](.verb.md).)_
-
-To generate the readme and API documentation with [verb](https://github.com/verbose/verb):
-
-```sh
-$ npm install -g verb verb-generate-readme && verb
-```
-
-### Running tests
-
-Install dev dependencies:
-
-```sh
-$ npm install -d && npm test
-```
-
-### Author
-
-**Jon Schlinkert**
-
-* [github/jonschlinkert](https://github.com/jonschlinkert)
-* [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
-
-### License
-
-Copyright © 2016, [Jon Schlinkert](https://github.com/jonschlinkert).
-Released under the [MIT license](https://github.com/jonschlinkert/snapdragon/blob/master/LICENSE).
-
-***
-
-_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.1.31, on October 10, 2016._

package/node_modules/snapdragon/index.js

@@ -1,174 +0,0 @@
-'use strict';
-
-var Base = require('base');
-var define = require('define-property');
-var Compiler = require('./lib/compiler');
-var Parser = require('./lib/parser');
-var utils = require('./lib/utils');
-var regexCache = {};
-var cache = {};
-
-/**
- * Create a new instance of `Snapdragon` with the given `options`.
- *
- * ```js
- * var snapdragon = new Snapdragon();
- * ```
- *
- * @param {Object} `options`
- * @api public
- */
-
-function Snapdragon(options) {
-  Base.call(this, null, options);
-  this.options = utils.extend({source: 'string'}, this.options);
-  this.compiler = new Compiler(this.options);
-  this.parser = new Parser(this.options);
-
-  Object.defineProperty(this, 'compilers', {
-    get: function() {
-      return this.compiler.compilers;
-    }
-  });
-
-  Object.defineProperty(this, 'parsers', {
-    get: function() {
-      return this.parser.parsers;
-    }
-  });
-
-  Object.defineProperty(this, 'regex', {
-    get: function() {
-      return this.parser.regex;
-    }
-  });
-}
-
-/**
- * Inherit Base
- */
-
-Base.extend(Snapdragon);
-
-/**
- * Add a parser to `snapdragon.parsers` for capturing the given `type` using
- * the specified regex or parser function. A function is useful if you need
- * to customize how the token is created and/or have access to the parser
- * instance to check options, etc.
- *
- * ```js
- * snapdragon
- *   .capture('slash', /^\//)
- *   .capture('dot', function() {
- *     var pos = this.position();
- *     var m = this.match(/^\./);
- *     if (!m) return;
- *     return pos({
- *       type: 'dot',
- *       val: m[0]
- *     });
- *   });
- * ```
- * @param {String} `type`
- * @param {RegExp|Function} `regex`
- * @return {Object} Returns the parser instance for chaining
- * @api public
- */
-
-Snapdragon.prototype.capture = function() {
-  return this.parser.capture.apply(this.parser, arguments);
-};
-
-/**
- * Register a plugin `fn`.
- *
- * ```js
- * var snapdragon = new Snapdgragon([options]);
- * snapdragon.use(function() {
- *   console.log(this);          //<= snapdragon instance
- *   console.log(this.parser);   //<= parser instance
- *   console.log(this.compiler); //<= compiler instance
- * });
- * ```
- * @param {Object} `fn`
- * @api public
- */
-
-Snapdragon.prototype.use = function(fn) {
-  fn.call(this, this);
-  return this;
-};
-
-/**
- * Parse the given `str`.
- *
- * ```js
- * var snapdragon = new Snapdgragon([options]);
- * // register parsers
- * snapdragon.parser.use(function() {});
- *
- * // parse
- * var ast = snapdragon.parse('foo/bar');
- * console.log(ast);
- * ```
- * @param {String} `str`
- * @param {Object} `options` Set `options.sourcemap` to true to enable source maps.
- * @return {Object} Returns an AST.
- * @api public
- */
-
-Snapdragon.prototype.parse = function(str, options) {
-  this.options = utils.extend({}, this.options, options);
-  var parsed = this.parser.parse(str, this.options);
-
-  // add non-enumerable parser reference
-  define(parsed, 'parser', this.parser);
-  return parsed;
-};
-
-/**
- * Compile the given `AST`.
- *
- * ```js
- * var snapdragon = new Snapdgragon([options]);
- * // register plugins
- * snapdragon.use(function() {});
- * // register parser plugins
- * snapdragon.parser.use(function() {});
- * // register compiler plugins
- * snapdragon.compiler.use(function() {});
- *
- * // parse
- * var ast = snapdragon.parse('foo/bar');
- *
- * // compile
- * var res = snapdragon.compile(ast);
- * console.log(res.output);
- * ```
- * @param {Object} `ast`
- * @param {Object} `options`
- * @return {Object} Returns an object with an `output` property with the rendered string.
- * @api public
- */
-
-Snapdragon.prototype.compile = function(ast, options) {
-  this.options = utils.extend({}, this.options, options);
-  var compiled = this.compiler.compile(ast, this.options);
-
-  // add non-enumerable compiler reference
-  define(compiled, 'compiler', this.compiler);
-  return compiled;
-};
-
-/**
- * Expose `Snapdragon`
- */
-
-module.exports = Snapdragon;
-
-/**
- * Expose `Parser` and `Compiler`
- */
-
-module.exports.Compiler = Compiler;
-module.exports.Parser = Parser;

package/node_modules/snapdragon/lib/compiler.js

@@ -1,177 +0,0 @@
-'use strict';
-
-var use = require('use');
-var define = require('define-property');
-var debug = require('debug')('snapdragon:compiler');
-var utils = require('./utils');
-
-/**
- * Create a new `Compiler` with the given `options`.
- * @param {Object} `options`
- */
-
-function Compiler(options, state) {
-  debug('initializing', __filename);
-  this.options = utils.extend({source: 'string'}, options);
-  this.state = state || {};
-  this.compilers = {};
-  this.output = '';
-  this.set('eos', function(node) {
-    return this.emit(node.val, node);
-  });
-  this.set('noop', function(node) {
-    return this.emit(node.val, node);
-  });
-  this.set('bos', function(node) {
-    return this.emit(node.val, node);
-  });
-  use(this);
-}
-
-/**
- * Prototype methods
- */
-
-Compiler.prototype = {
-
-  /**
-   * Throw an error message with details including the cursor position.
-   * @param {String} `msg` Message to use in the Error.
-   */
-
-  error: function(msg, node) {
-    var pos = node.position || {start: {column: 0}};
-    var message = this.options.source + ' column:' + pos.start.column + ': ' + msg;
-
-    var err = new Error(message);
-    err.reason = msg;
-    err.column = pos.start.column;
-    err.source = this.pattern;
-
-    if (this.options.silent) {
-      this.errors.push(err);
-    } else {
-      throw err;
-    }
-  },
-
-  /**
-   * Define a non-enumberable property on the `Compiler` instance.
-   *
-   * ```js
-   * compiler.define('foo', 'bar');
-   * ```
-   * @name .define
-   * @param {String} `key` propery name
-   * @param {any} `val` property value
-   * @return {Object} Returns the Compiler instance for chaining.
-   * @api public
-   */
-
-  define: function(key, val) {
-    define(this, key, val);
-    return this;
-  },
-
-  /**
-   * Emit `node.val`
-   */
-
-  emit: function(str, node) {
-    this.output += str;
-    return str;
-  },
-
-  /**
-   * Add a compiler `fn` with the given `name`
-   */
-
-  set: function(name, fn) {
-    this.compilers[name] = fn;
-    return this;
-  },
-
-  /**
-   * Get compiler `name`.
-   */
-
-  get: function(name) {
-    return this.compilers[name];
-  },
-
-  /**
-   * Get the previous AST node.
-   */
-
-  prev: function(n) {
-    return this.ast.nodes[this.idx - (n || 1)] || { type: 'bos', val: '' };
-  },
-
-  /**
-   * Get the next AST node.
-   */
-
-  next: function(n) {
-    return this.ast.nodes[this.idx + (n || 1)] || { type: 'eos', val: '' };
-  },
-
-  /**
-   * Visit `node`.
-   */
-
-  visit: function(node, nodes, i) {
-    var fn = this.compilers[node.type];
-    this.idx = i;
-
-    if (typeof fn !== 'function') {
-      throw this.error('compiler "' + node.type + '" is not registered', node);
-    }
-    return fn.call(this, node, nodes, i);
-  },
-
-  /**
-   * Map visit over array of `nodes`.
-   */
-
-  mapVisit: function(nodes) {
-    if (!Array.isArray(nodes)) {
-      throw new TypeError('expected an array');
-    }
-    var len = nodes.length;
-    var idx = -1;
-    while (++idx < len) {
-      this.visit(nodes[idx], nodes, idx);
-    }
-    return this;
-  },
-
-  /**
-   * Compile `ast`.
-   */
-
-  compile: function(ast, options) {
-    var opts = utils.extend({}, this.options, options);
-    this.ast = ast;
-    this.parsingErrors = this.ast.errors;
-    this.output = '';
-
-    // source map support
-    if (opts.sourcemap) {
-      var sourcemaps = require('./source-maps');
-      sourcemaps(this);
-      this.mapVisit(this.ast.nodes);
-      this.applySourceMaps();
-      this.map = opts.sourcemap === 'generator' ? this.map : this.map.toJSON();
-      return this;
-    }
-
-    this.mapVisit(this.ast.nodes);
-    return this;
-  }
-};
-
-/**
- * Expose `Compiler`
- */
-
-module.exports = Compiler;