> Selector parser with built in methods for working with selector strings. 

evilebottnawi

jonathantneal

chriseppstein

postcss-selector-parser

- Fixed: parse quoted attributes containing a newline correctly

- Perf: rework unesc for a 63+% performance boost

- Fixed: replace node built-in "util" module with "util-deprecate"

- Fixed: handle uppercase pseudo elements

- Fixed: do not create invalid combinator before comment

- Fixed an issue with parsing and stringifying an empty attribute value

- Fixed an issue with unicode surrogate pair parsing

- Fixed: Issues with escaped `id` and `class` selectors

- Fixed an issue where comments immediately after an insensitive (in attribute)

- Added tests for custom selectors, tags with attributes, the universal

  selector with pseudos, and tokens after combinators.

To ease adoption of the v5.0 release, we have relaxed the node version

check performed by npm at installation time to allow for node 4, which

remains officially unsupported, but likely to continue working for the

This release has **BREAKING CHANGES** that were required to fix regressions

in 4.0.0 and to make the Combinator Node API consistent for all combinator

* The way a descendent combinator that isn't a single space character (E.g. `.a  .b`) is stored in the AST has changed.

* Named Combinators (E.g. `.a /for/ .b`) are now properly parsed as a combinator.

* It is now possible to look up a node based on the source location of a character in that node and to query nodes if they contain some character.

* Several bug fixes that caused the parser to hang and run out of memory when a `/` was encountered have been fixed.

* The minimum supported version of Node is now `v6.0.0`.

In prior releases, the value of a descendant combinator with multiple spaces included all the spaces.

* `.a   .b`: Extra spaces are now stored as space before.

    - `combinator.value === " " && combinator.spaces.before === "  "`

* `.a   /*comment*/.b`: A comment at the end of the combinator causes extra space to become after space.

    - `combinator.raws.value === "   /*comment/"`

    - `combinator.raws.spaces.after === "  /*comment*/"`

* `.a<newline>.b`: whitespace that doesn't start or end with a single space character is stored as a raw value.

    - `combinator.raws.value === undefined`

Although, nonstandard and unlikely to ever become a standard, combinators like `/deep/` and `/for/` are now properly supported.

Because they've been taken off the standardization track, there is no spec-official name for combinators of the form `/<ident>/`. However, I talked to [Tab Atkins](https://twitter.com/tabatkins) and we agreed to call them "named combinators" so now they are called that.

Before this release such named combinators were parsed without intention and generated three nodes of type `"tag"` where the first and last nodes had a value of `"/"`.

* `.a /for/ .b` is parsed as a combinator.

var _helpers = require("./util/helpers");

(0, _helpers.test)('tag selector', 'h1', function (t, tree) {

  t.deepEqual(tree.nodes[0].nodes[0].value, 'h1');

  t.deepEqual(tree.nodes[0].nodes[0].type, 'tag');

(0, _helpers.test)('multiple tag selectors', 'h1, h2', function (t, tree) {

  t.deepEqual(tree.nodes[1].nodes[0].value, 'h2');

(0, _helpers.test)('extraneous non-combinating whitespace', '  h1   ,  h2   ', function (t, tree) {

  t.deepEqual(tree.nodes[0].nodes[0].spaces.before, '  ');

  t.deepEqual(tree.nodes[0].nodes[0].spaces.after, '   ');

  t.deepEqual(tree.nodes[1].nodes[0].spaces.before, '  ');

  t.deepEqual(tree.nodes[1].nodes[0].spaces.after, '   ');

(0, _helpers.test)('tag with trailing comma', 'h1,', function (t, tree) {

(0, _helpers.test)('tag with trailing slash', 'h1\\', function (t, tree) {

  t.deepEqual(tree.nodes[0].nodes[0].value, 'h1\\');

(0, _helpers.test)('tag with attribute', 'label[for="email"]', function (t, tree) {

  t.deepEqual(tree.nodes[0].nodes[0].value, 'label');

  t.deepEqual(tree.nodes[0].nodes[1].value, 'email');

  t.deepEqual(tree.nodes[0].nodes[1].attribute, 'for');

  t.deepEqual(tree.nodes[0].nodes[1].operator, '=');

  t.deepEqual(tree.nodes[0].nodes[1].type, 'attribute');

  t.deepEqual(tree.nodes[0].nodes[1].quoteMark, '"');

(0, _helpers.test)('keyframes animation tag selector', '0.00%', function (t, tree) {

  t.deepEqual(tree.nodes[0].nodes[0].value, '0.00%');

var _root = _interopRequireDefault(require("./selectors/root"));

var _selector = _interopRequireDefault(require("./selectors/selector"));

var _className = _interopRequireDefault(require("./selectors/className"));

var _comment = _interopRequireDefault(require("./selectors/comment"));

var _id = _interopRequireDefault(require("./selectors/id"));

var _tag = _interopRequireDefault(require("./selectors/tag"));

var _string = _interopRequireDefault(require("./selectors/string"));

var _pseudo = _interopRequireDefault(require("./selectors/pseudo"));

var _attribute = _interopRequireWildcard(require("./selectors/attribute"));

var _universal = _interopRequireDefault(require("./selectors/universal"));

var _combinator = _interopRequireDefault(require("./selectors/combinator"));

var _nesting = _interopRequireDefault(require("./selectors/nesting"));

var _sortAscending = _interopRequireDefault(require("./sortAscending"));

var _tokenize = _interopRequireWildcard(require("./tokenize"));

var tokens = _interopRequireWildcard(require("./tokenTypes"));

var types = _interopRequireWildcard(require("./selectors/types"));

function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function _getRequireWildcardCache() { return cache; }; return cache; }

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }

function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }

function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }

var WHITESPACE_TOKENS = (_WHITESPACE_TOKENS = {}, _WHITESPACE_TOKENS[tokens.space] = true, _WHITESPACE_TOKENS[tokens.cr] = true, _WHITESPACE_TOKENS[tokens.feed] = true, _WHITESPACE_TOKENS[tokens.newline] = true, _WHITESPACE_TOKENS[tokens.tab] = true, _WHITESPACE_TOKENS);

var WHITESPACE_EQUIV_TOKENS = Object.assign({}, WHITESPACE_TOKENS, (_Object$assign = {}, _Object$assign[tokens.comment] = true, _Object$assign));

    line: token[_tokenize.FIELDS.START_LINE],

    column: token[_tokenize.FIELDS.START_COL]

    line: token[_tokenize.FIELDS.END_LINE],

    column: token[_tokenize.FIELDS.END_COL]

function getSource(startLine, startColumn, endLine, endColumn) {

  return getSource(token[_tokenize.FIELDS.START_LINE], token[_tokenize.FIELDS.START_COL], token[_tokenize.FIELDS.END_LINE], token[_tokenize.FIELDS.END_COL]);

function getTokenSourceSpan(startToken, endToken) {

  return getSource(startToken[_tokenize.FIELDS.START_LINE], startToken[_tokenize.FIELDS.START_COL], endToken[_tokenize.FIELDS.END_LINE], endToken[_tokenize.FIELDS.END_COL]);

    var hasClass = indexesOf(word, '.').filter(function (i) {

      // Allow escaped dot within class name

      var escapedDot = word[i - 1] === '\\'; // Allow decimal numbers percent in @keyframes

      var isKeyframesPercent = /^\d+\.\d+%$/.test(word);

      return !escapedDot && !isKeyframesPercent;

    var hasId = indexesOf(word, '#').filter(function (i) {

    }); // Eliminate Sass interpolations from the list of id indexes

    var interpolations = indexesOf(word, '#{');

      hasId = hasId.filter(function (hashIndex) {

        return !~interpolations.indexOf(hashIndex);

    var indices = (0, _sortAscending["default"])(uniqs([0].concat(hasClass, hasId)));

      var index = indices[i + 1] || word.length;

      var value = word.slice(ind, index);

        return firstCallback.call(_this5, value, indices.length);

      var sourceIndex = current[_tokenize.FIELDS.START_POS] + indices[i];

      var source = getSource(current[1], current[2] + ind, current[3], current[2] + (index - 1));

        node = new _className["default"](unescapeProp(classNameOpts, "value"));

        node = new _id["default"](unescapeProp(idOpts, "value"));

        node = new _tag["default"](tagOpts);

      _this5.newNode(node, namespace); // Ensure that the namespace is used only once

  _proto.word = function word(namespace) {

    if (nextToken && this.content(nextToken) === '|') {

    while (this.position < this.tokens.length) {

  _proto.parse = function parse(throwOnParenthesis) {

    switch (this.currToken[_tokenize.FIELDS.TYPE]) {

    "@babel/plugin-proposal-class-properties": "^7.10.4",

    "babel-plugin-add-module-exports": "^1.0.4",

  "types": "postcss-selector-parser.d.ts",

    "pretest": "eslint src && tsc --noEmit postcss-selector-parser.d.ts",

    "prepare": "del-cli dist && BABEL_ENV=publish babel src --out-dir dist --ignore /__tests__/",

    "report": "nyc report --reporter=html",

    "test": "nyc ava src/__tests__/*.js ",

  "homepage": "https://github.com/postcss/postcss-selector-parser",

      "url": "http://twitter.com/chriseppstein"

  "repository": "postcss/postcss-selector-parser",

		@@ -0,1 +1,5 @@
		# 6.0.7

		- Fixed: parse animation percents

		# 6.0.6
		@@ -2,0 +6,0 @@

		{
		"name": "postcss-selector-parser",
		"version": "6.0.6",
		"version": "6.0.7",
		"devDependencies": {
		@@ -5,0 +5,0 @@ "@babel/cli": "^7.11.6",

		@@ -35,2 +35,6 @@ "use strict";
		t.deepEqual(tree.nodes[0].nodes[1].quoteMark, '"');
		});
		(0, _helpers.test)('keyframes animation tag selector', '0.00%', function (t, tree) {
		t.deepEqual(tree.nodes[0].nodes[0].value, '0.00%');
		t.deepEqual(tree.nodes[0].nodes[0].type, 'tag');
		});

		@@ -966,3 +966,7 @@ "use strict";
		var hasClass = indexesOf(word, '.').filter(function (i) {
		return word[i - 1] !== '\\';
		// Allow escaped dot within class name
		var escapedDot = word[i - 1] === '\\'; // Allow decimal numbers percent in @keyframes

		var isKeyframesPercent = /^\d+\.\d+%$/.test(word);
		return !escapedDot && !isKeyframesPercent;
		});
		@@ -969,0 +973,0 @@ var hasId = indexesOf(word, '#').filter(function (i) {

Improved metrics