css-tree - npm Package Compare versions

Comparing version 1.0.0-alpha2 to 1.0.0-alpha20

data/index.js

@@ -1,2 +0,3 @@
-var mozilla = require('./mozilla-cssdata.json');
+var mdnProperties = require('mdn-data/css/properties.json');
+var mdnSyntaxes = require('mdn-data/css/syntaxes.json');
 var patch = require('./patch.json');
@@ -12,31 +13,35 @@ var data = {
         .replace(/>/g, '>')
+        .replace(/ /g, ' ')
         .replace(/&/g, '&');
 }
 
-// apply patch
-for (var key in patch.properties) {
-    if (key in mozilla.properties) {
-        mozilla.properties[key].syntax = patch.properties[key].syntax;
-    } else {
-        mozilla.properties[key] = patch.properties[key];
+function patchDict(dict, patchDict) {
+    for (var key in patchDict) {
+        if (key in dict) {
+            if (patchDict[key].syntax) {
+                dict[key].syntax = patchDict[key].syntax;
+            } else {
+                delete dict[key];
+            }
+        } else {
+            if (patchDict[key].syntax) {
+                dict[key] = patchDict[key];
+            }
+        }
     }
 }
 
-for (var key in patch.syntaxes) {
-    if (patch.syntaxes[key].syntax) {
-        mozilla.syntaxes[key] = patch.syntaxes[key].syntax;
-    } else {
-        delete mozilla.syntaxes[key];
-    }
-}
+// apply patch
+patchDict(mdnProperties, patch.properties);
+patchDict(mdnSyntaxes, patch.syntaxes);
 
-// normalize source mozilla syntaxes, since it uses html token
-for (var key in mozilla.properties) {
-    data.properties[key] = normalizeSyntax(mozilla.properties[key].syntax);
+// normalize source mdnProperties syntaxes, since it uses html token
+for (var key in mdnProperties) {
+    data.properties[key] = normalizeSyntax(mdnProperties[key].syntax);
 }
 
-for (var key in mozilla.syntaxes) {
-    data.types[key] = normalizeSyntax(mozilla.syntaxes[key]);
+for (var key in mdnSyntaxes) {
+    data.types[key] = normalizeSyntax(mdnSyntaxes[key].syntax);
 }
 
 module.exports = data;

data/patch.json

 {
   "properties": {
+    "--*": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
     "-moz-background-clip": {
@@ -118,42 +122,10 @@ "comment": "deprecated syntax in old Firefox, https://developer.mozilla.org/en/docs/Web/CSS/background-clip",
     },
-    "-webkit-mask": {
-      "comment": "changing for property references due webkit version of properties can differ from current mask spec; needs for revision",
-      "syntax": "<mask-image> [ <'-webkit-mask-repeat'> || <'-webkit-mask-attachment'> || <'-webkit-mask-position'> || <'-webkit-mask-origin'> || <'-webkit-mask-clip'> ]*"
-    },
-    "-webkit-mask-attachment": {
-      "comment": "extra space between [ and ,",
-      "syntax": "<attachment> [, <attachment> ]*"
-    },
     "-webkit-mask-box-image": {
       "comment": "missed; https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-mask-box-image",
-      "syntax": "[ <uri> | <gradient> | none ] [ <length-percentage>{4} <-webkit-mask-box-repeat>{2} ]?"
+      "syntax": "[ <url> | <gradient> | none ] [ <length-percentage>{4} <-webkit-mask-box-repeat>{2} ]?"
     },
     "-webkit-mask-clip": {
       "comment": "change type to <-webkit-mask-clip-style> since it differ from <mask-clip>, extra space between [ and ,",
-      "syntax": "&lt;-webkit-mask-clip-style&gt; [, &lt;-webkit-mask-clip-style&gt; ]*"
+      "syntax": "<-webkit-mask-clip-style> [, <-webkit-mask-clip-style> ]*"
     },
-    "-webkit-mask-composite": {
-      "comment": "extra space between [ and ,",
-      "syntax": "&lt;composite-style&gt; [, &lt;composite-style&gt; ]*"
-    },
-    "-webkit-mask-image": {
-      "comment": "extra space between [ and ,",
-      "syntax": "&lt;mask-image&gt; [, &lt;mask-image&gt; ]*"
-    },
-    "-webkit-mask-origin": {
-      "comment": "missed spaces between brackets, extra space between [ and ,",
-      "syntax": "[ padding | border | content ] [, [ border | padding | content ] ]*"
-    },
-    "-webkit-mask-position": {
-      "comment": "# instead of *, extra space between [ and ,",
-      "syntax": "&lt;mask-position&gt; [, &lt;mask-position&gt; ]*"
-    },
-    "-webkit-mask-position-y": {
-      "comment": "extra space after `top`",
-      "syntax": "[ &lt;length-percentage&gt; | top | center | bottom ]#"
-    },
-    "-webkit-mask-repeat": {
-      "comment": "extra space between [ and ,",
-      "syntax": "&lt;repeat-style&gt; [, &lt;repeat-style&gt; ]*"
-    },
     "-webkit-overflow-scrolling": {
@@ -163,5 +135,8 @@ "comment": "missed; https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-overflow-scrolling",
     },
-    "-webkit-tap-highlight-color": {
-      "comment": "broken syntax",
-      "syntax": "&lt;color&gt;#"
+    "-webkit-print-color-adjust": {
+      "comment": "missed",
+      "references": [
+        "https://developer.mozilla.org/en/docs/Web/CSS/-webkit-print-color-adjust"
+      ],
+      "syntax": "economy | exact"
     },
@@ -187,25 +162,2 @@ "-webkit-text-security": {
     },
-    "animation-timing-function": {
-      "comment": "<timing-function> -> <single-timing-function> https://drafts.csswg.org/css-animations/#animation-timing-function",
-      "syntax": "<single-timing-function>#"
-    },
-    "appearance": {
-      "comment": "CSS Basic User Interface Module Level 4",
-      "references": [
-        "https://drafts.csswg.org/css-ui-4/#appearance-switching"
-      ],
-      "syntax": "auto | none"
-    },
-    "azimuth": {
-      "comment": "missed space",
-      "syntax": "&lt;angle&gt; | [ [ left-side | far-left | left | center-left | center | center-right | right | far-right | right-side ] || behind ] | leftwards | rightwards"
-    },
-    "background-position-x": {
-      "comment": "added missed multiplicator `?` https://drafts.csswg.org/css-backgrounds-4/#background-position-longhands",
-      "syntax": "[ center | [ left | right | x-start | x-end ]? &lt;length-percentage&gt;? ]#"
-    },
-    "background-position-y": {
-      "comment": "added missed multiplicator `?` https://drafts.csswg.org/css-backgrounds-4/#background-position-longhands",
-      "syntax": "[ center | [ top | bottom | y-start | y-end ]? &lt;length-percentage&gt;? ]#"
-    },
     "baseline-shift": {
@@ -229,6 +181,2 @@ "comment": "added SVG property",
     },
-    "content": {
-      "comment": "outdated syntax, used syntax from https://drafts.csswg.org/css-content/#typedef-content-list",
-      "syntax": "[ <image> ',' ]* [ normal | none | <content-list> ] [/ <string> ]?"
-    },
     "cue": {
@@ -240,7 +188,7 @@ "comment": "https://www.w3.org/TR/css3-speech/#property-index",
       "comment": "https://www.w3.org/TR/css3-speech/#property-index",
-      "syntax": "<uri> <decibel>? | none"
+      "syntax": "<url> <decibel>? | none"
     },
     "cue-before": {
       "comment": "https://www.w3.org/TR/css3-speech/#property-index",
-      "syntax": "<uri> <decibel>? | none"
+      "syntax": "<url> <decibel>? | none"
     },
@@ -250,3 +198,3 @@ "cursor": {
       "refenrences": ["https://www.sitepoint.com/css3-cursor-styles/"],
-      "syntax": "[ [ &lt;uri&gt; [ &lt;x&gt; &lt;y&gt; ]? , ]* [ auto | default | none | context-menu | help | pointer | progress | wait | cell | crosshair | text | vertical-text | alias | copy | move | no-drop | not-allowed | e-resize | n-resize | ne-resize | nw-resize | s-resize | se-resize | sw-resize | w-resize | ew-resize | ns-resize | nesw-resize | nwse-resize | col-resize | row-resize | all-scroll | zoom-in | zoom-out | grab | grabbing | hand | -webkit-grab | -webkit-grabbing | -webkit-zoom-in | -webkit-zoom-out | -moz-grab | -moz-grabbing | -moz-zoom-in | -moz-zoom-out ] ]"
+      "syntax": "[ [ <url> [ <x> <y> ]? , ]* [ auto | default | none | context-menu | help | pointer | progress | wait | cell | crosshair | text | vertical-text | alias | copy | move | no-drop | not-allowed | e-resize | n-resize | ne-resize | nw-resize | s-resize | se-resize | sw-resize | w-resize | ew-resize | ns-resize | nesw-resize | nwse-resize | col-resize | row-resize | all-scroll | zoom-in | zoom-out | grab | grabbing | hand | -webkit-grab | -webkit-grabbing | -webkit-zoom-in | -webkit-zoom-out | -moz-grab | -moz-grabbing | -moz-zoom-in | -moz-zoom-out ] ]"
     },
@@ -257,2 +205,6 @@ "display": {
     },
+    "position": {
+      "comment": "extended with -webkit-sticky",
+      "syntax": "static | relative | absolute | sticky | fixed | -webkit-sticky"
+    },
     "dominant-baseline": {
@@ -296,20 +248,8 @@ "comment": "added SVG property",
       "comment": "extend with IE legacy syntaxes",
-      "syntax": "none | &lt;filter-function-list&gt; | <-ms-filter>"
+      "syntax": "none | <filter-function-list> | <-ms-filter>"
     },
     "font": {
-      "comment": "wrong quotes",
-      "syntax": "[ [ &lt;'font-style'&gt; || &lt;font-variant-css21&gt; || &lt;'font-weight'&gt; || &lt;'font-stretch'&gt; ]? &lt;'font-size'&gt; [ / &lt;'line-height'&gt; ]? &lt;'font-family'&gt; ] | caption | icon | menu | message-box | small-caption | status-bar"
+      "comment": "extend with non-standart fonts",
+      "syntax": "[ [ <'font-style'> || <font-variant-css21> || <'font-weight'> || <'font-stretch'> ]? <'font-size'> [ / <'line-height'> ]? <'font-family'> ] | caption | icon | menu | message-box | small-caption | status-bar | <-non-standart-font>"
     },
-    "font-variant": {
-      "comment": "# should stick to term, missed spaces for function body, trailing space",
-      "syntax": "normal | none | [ &lt;common-lig-values&gt; || &lt;discretionary-lig-values&gt; || &lt;historical-lig-values&gt; || &lt;contextual-alt-values&gt; || stylistic( &lt;feature-value-name&gt; ) || historical-forms || styleset( &lt;feature-value-name&gt;# ) || character-variant( &lt;feature-value-name&gt;# ) || swash( &lt;feature-value-name&gt; ) || ornaments( &lt;feature-value-name&gt; ) || annotation( &lt;feature-value-name&gt; ) || [ small-caps | all-small-caps | petite-caps | all-petite-caps | unicase | titling-caps ] || &lt;numeric-figure-values&gt; || &lt;numeric-spacing-values&gt; || &lt;numeric-fraction-values&gt; || ordinal || slashed-zero || &lt;east-asian-variant-values&gt; || &lt;east-asian-width-values&gt; || ruby ]"
-    },
-    "font-variant-alternates": {
-      "comment": "# should stick to term, missed spaces for function body, trailing space",
-      "syntax": "normal | [ stylistic( &lt;feature-value-name&gt; ) || historical-forms || styleset( &lt;feature-value-name&gt;# ) || character-variant( &lt;feature-value-name&gt;# ) || swash( &lt;feature-value-name&gt; ) || ornaments( &lt;feature-value-name&gt; ) || annotation( &lt;feature-value-name&gt; ) ]"
-    },
-    "font-variant-east-asian": {
-      "comment": "trailing space",
-      "syntax": "normal | [ &lt;east-asian-variant-values&gt; || &lt;east-asian-width-values&gt; || ruby ]"
-    },
     "glyph-orientation-horizontal": {
@@ -338,3 +278,6 @@ "comment": "added SVG property",
       "comment": "fix syntax <length> -> <length-percentage>",
-      "syntax": "normal | &lt;length-percentage&gt;"
+      "references": [
+        "https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/letter-spacing"
+      ],
+      "syntax": "normal | <length-percentage>"
     },
@@ -371,7 +314,7 @@ "marker": {
       "comment": "extend by non-standart width keywords https://developer.mozilla.org/en-US/docs/Web/CSS/max-width",
-      "syntax": "&lt;length&gt; | &lt;percentage&gt; | none | max-content | min-content | fit-content | fill-available | <-non-standart-width>"
+      "syntax": "<length> | <percentage> | none | max-content | min-content | fit-content | fill-available | <-non-standart-width>"
     },
     "min-width": {
       "comment": "extend by non-standart width keywords https://developer.mozilla.org/en-US/docs/Web/CSS/width",
-      "syntax": "&lt;length&gt; | &lt;percentage&gt; | auto | max-content | min-content | fit-content | fill-available | <-non-standart-width>"
+      "syntax": "<length> | <percentage> | auto | max-content | min-content | fit-content | fill-available | <-non-standart-width>"
     },
@@ -406,10 +349,2 @@ "opacity": {
     },
-    "scroll-snap-points-x": {
-      "comment": "missed spaces in function body",
-      "syntax": "none | repeat( &lt;length&gt; )"
-    },
-    "scroll-snap-points-y": {
-      "comment": "missed spaces in function body",
-      "syntax": "none | repeat( &lt;length&gt; )"
-    },
     "shape-rendering": {
@@ -454,3 +389,3 @@ "comment": "added SVG property",
       "syntax": "<svg-length>"
-    },    
+    },
     "stroke-linecap": {
@@ -498,26 +433,6 @@ "comment": "added SVG property",
     },
-    "text-emphasis-style": {
-      "comment": "missed between brackets",
-      "syntax": "none | [ [ filled | open ] || [ dot | circle | double-circle | triangle | sesame ] ] | &lt;string&gt;"
-    },
-    "text-indent": {
-      "comment": "wrong syntax, replaced for https://drafts.csswg.org/css-text-3/#text-indent-property",
-      "syntax": "[ <length-percentage> ] && hanging? && each-line?"
-    },
-    "text-size-adjust": {
-      "comment": "trailing space",
-      "syntax": "none | auto | &lt;percentage&gt;"
-    },
-    "touch-action": {
-      "comment": "missed between brackets",
-      "syntax": "auto | none | [ [ pan-x | pan-left | pan-right ] || [ pan-y | pan-up | pan-down ] ] | manipulation"
-    },
     "transform-origin": {
       "comment": "move first group to the end since less collecting",
-      "syntax": "[ [ &lt;length-percentage&gt; | left | center | right ] &amp;&amp; [ &lt;length-percentage&gt; | top | center | bottom ] ] &lt;length&gt;? | [ &lt;length-percentage&gt; | left | center | right | top | bottom ]"
+      "syntax": "[ [ <length-percentage> | left | center | right ] && [ <length-percentage> | top | center | bottom ] ] <length>? | [ <length-percentage> | left | center | right | top | bottom ]"
     },
-    "transition-timing-function": {
-      "comment": "extra space in the beginning",
-      "syntax": "&lt;single-transition-timing-function&gt;#"
-    },
     "unicode-bidi": {
@@ -591,3 +506,3 @@ "comment": "added prefixed keywords https://developer.mozilla.org/en-US/docs/Web/CSS/unicode-bidi",
       "comment": "like standart syntax but w/o `to` keyword https://developer.mozilla.org/en-US/docs/Web/CSS/linear-gradient",
-      "syntax": "[ &lt;angle&gt; | &lt;side-or-corner&gt; ]? , &lt;color-stop-list&gt;"
+      "syntax": "[ <angle> | <side-or-corner> ]? , <color-stop-list>"
     },
@@ -614,8 +529,16 @@ "-legacy-radial-gradient()": {
     },
+    "-non-standart-font": {
+      "comment": "non standart fonts",
+      "preferences": [
+        "https://webkit.org/blog/3709/using-the-system-font-in-web-content/"
+      ],
+      "syntax": "-apple-system-body | -apple-system-headline | -apple-system-subheadline | -apple-system-caption1 | -apple-system-caption2 | -apple-system-footnote | -apple-system-short-body | -apple-system-short-headline | -apple-system-short-subheadline | -apple-system-short-caption1 | -apple-system-short-footnote | -apple-system-tall-body"
+    },
     "-non-standart-color": {
       "comment": "non standart colors",
       "references": [
-        "http://cssdot.ru/%D0%A1%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA_CSS/color-i305.html"
+        "http://cssdot.ru/%D0%A1%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA_CSS/color-i305.html",
+        "https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#Mozilla_Color_Preference_Extensions"
       ],
-      "syntax": "-moz-ButtonDefault | -moz-ButtonHoverFace | -moz-ButtonHoverText | -moz-CellHighlight | -moz-CellHighlightText | -moz-Combobox | -moz-ComboboxText | -moz-Dialog | -moz-DialogText | -moz-dragtargetzone | -moz-EvenTreeRow | -moz-Field | -moz-FieldText | -moz-html-CellHighlight | -moz-html-CellHighlightText | -moz-mac-accentdarkestshadow | -moz-mac-accentdarkshadow | -moz-mac-accentface | -moz-mac-accentlightesthighlight | -moz-mac-accentlightshadow | -moz-mac-accentregularhighlight | -moz-mac-accentregularshadow | -moz-mac-chrome-active | -moz-mac-chrome-inactive | -moz-mac-focusring | -moz-mac-menuselect | -moz-mac-menushadow | -moz-mac-menutextselect | -moz-MenuHover | -moz-MenuHoverText | -moz-MenuBarText | -moz-MenuBarHoverText | -moz-nativehyperlinktext | -moz-OddTreeRow | -moz-win-communicationstext | -moz-win-mediatext | -webkit-activelink | -webkit-focus-ring-color | -webkit-link | -webkit-text"
+      "syntax": "-moz-ButtonDefault | -moz-ButtonHoverFace | -moz-ButtonHoverText | -moz-CellHighlight | -moz-CellHighlightText | -moz-Combobox | -moz-ComboboxText | -moz-Dialog | -moz-DialogText | -moz-dragtargetzone | -moz-EvenTreeRow | -moz-Field | -moz-FieldText | -moz-html-CellHighlight | -moz-html-CellHighlightText | -moz-mac-accentdarkestshadow | -moz-mac-accentdarkshadow | -moz-mac-accentface | -moz-mac-accentlightesthighlight | -moz-mac-accentlightshadow | -moz-mac-accentregularhighlight | -moz-mac-accentregularshadow | -moz-mac-chrome-active | -moz-mac-chrome-inactive | -moz-mac-focusring | -moz-mac-menuselect | -moz-mac-menushadow | -moz-mac-menutextselect | -moz-MenuHover | -moz-MenuHoverText | -moz-MenuBarText | -moz-MenuBarHoverText | -moz-nativehyperlinktext | -moz-OddTreeRow | -moz-win-communicationstext | -moz-win-mediatext | -moz-activehyperlinktext | -moz-default-background-color | -moz-default-color | -moz-hyperlinktext | -moz-visitedhyperlinktext | -webkit-activelink | -webkit-focus-ring-color | -webkit-link | -webkit-text"
     },
@@ -673,6 +596,2 @@ "-non-standart-image-rendering": {
     },
-    "an-plus-b": {
-      "comment": "syntax is incorrect and can't be parsed, drop for now",
-      "syntax": null
-    },
     "attr()": {
@@ -682,6 +601,2 @@ "comment": "drop it since it's a generic",
     },
-    "blend-mode": {
-      "comment": "missed, https://drafts.fxtf.org/compositing-1/#ltblendmodegt",
-      "syntax": "normal | multiply | screen | overlay | darken | lighten | color-dodge | color-burn | hard-light | soft-light | difference | exclusion | hue | saturation | color | luminosity"
-    },
     "border-radius": {
@@ -695,6 +610,2 @@ "comment": "missed, https://drafts.csswg.org/css-backgrounds-3/#the-border-radius",
     },
-    "color-stop-list": {
-      "comment": "missed #",
-      "syntax": "<color-stop>#{2,}"
-    },
     "content-list": {
@@ -704,13 +615,5 @@ "comment": "missed -> https://drafts.csswg.org/css-content/#typedef-content-list (document-url, <target> and leader() is omitted util stabilization)",
     },
-    "family-name": {
-      "comment": "upper case",
-      "syntax": "&lt;string&gt; | &lt;ident&gt;+"
-    },
-    "feature-value-name": {
-      "comment": "missed angle brackets",
-      "syntax": "<ident>"
-    },
     "inset()": {
       "comment": "changed <border-radius> to <'border-radius'>",
-      "syntax": "inset( &lt;length-percentage&gt;{1,4} [ round &lt;'border-radius'&gt; ]? )"
+      "syntax": "inset( <length-percentage>{1,4} [ round <'border-radius'> ]? )"
     },
@@ -725,5 +628,12 @@ "generic-voice": {
     },
+    "generic-family": {
+      "comment": "added -apple-system",
+      "references": [
+        "https://webkit.org/blog/3709/using-the-system-font-in-web-content/"
+      ],
+      "syntax": "serif | sans-serif | cursive | fantasy | monospace | -apple-system"
+    },
     "gradient": {
       "comment": "added -webkit-gradient() since may to be used for legacy support",
-      "syntax": "<-legacy-gradient()> | &lt;linear-gradient()&gt; | &lt;repeating-linear-gradient()&gt; | &lt;radial-gradient()&gt; | &lt;repeating-radial-gradient()&gt;"
+      "syntax": "<-legacy-gradient()> | <linear-gradient()> | <repeating-linear-gradient()> | <radial-gradient()> | <repeating-radial-gradient()>"
     },
@@ -738,13 +648,9 @@ "left": {
     },
-    "mask-position": {
-      "comment": "extra space after `top`",
-      "syntax": "[ &lt;length-percentage&gt; | left | center | right ] [ &lt;length-percentage&gt; | top | center | bottom ]?"
-    },
     "matrix()": {
       "comment": "redundant max",
-      "syntax": "matrix( &lt;number&gt; [, &lt;number&gt; ]{5} )"
+      "syntax": "matrix( <number> [, <number> ]{5} )"
     },
     "matrix3d()": {
       "comment": "redundant max",
-      "syntax": "matrix3d( &lt;number&gt; [, &lt;number&gt; ]{15} )"
+      "syntax": "matrix3d( <number> [, <number> ]{15} )"
     },
@@ -759,6 +665,2 @@ "name-repeat": {
     },
-    "namespace-prefix": {
-      "comment": "missed angle brackets",
-      "syntax": "<ident>"
-    },
     "outline-radius": {
@@ -778,3 +680,3 @@ "comment": "missed, looks like it's a similar to <border-radius> https://developer.mozilla.org/en/docs/Web/CSS/-moz-outline-radius",
       "comment": "rewrite syntax (TODO: make match work with original syntax)",
-      "syntax": "[ center && [ left | right | top | bottom ] &lt;length-percentage&gt;? ] | [ [ left | right ] &lt;length-percentage&gt;? ] && [ [ top | bottom ] &lt;length-percentage&gt;? ] | [ [ left | center | right | &lt;length-percentage&gt; ] || [ top | center | bottom | &lt;length-percentage&gt; ] ]"
+      "syntax": "[ center && [ left | right | top | bottom ] <length-percentage>? ] | [ [ left | right ] <length-percentage>? ] && [ [ top | bottom ] <length-percentage>? ] | [ [ left | center | right | <length-percentage> ] || [ top | center | bottom | <length-percentage> ] ]"
     },
@@ -785,6 +687,2 @@ "right": {
     },
-    "scale3d()": {
-      "comment": "missed space before comma",
-      "syntax": "scale3d( &lt;number&gt; , &lt;number&gt; , &lt;number&gt; )"
-    },
     "shape": {
@@ -794,18 +692,6 @@ "comment": "missed spaces in function body and add backwards compatible syntax",
     },
-    "single-animation-name": {
-      "comment": "missed angle brackets",
-      "syntax": "none | <ident>"
-    },
     "single-transition": {
       "comment": "moved <single-transition-timing-function> in the beginning to avoid wrong match to <single-transition-property>",
-      "syntax": "&lt;single-transition-timing-function&gt; || [ none | &lt;single-transition-property&gt; ] || &lt;time&gt; || &lt;time&gt;"
+      "syntax": "<single-transition-timing-function> || [ none | <single-transition-property> ] || <time> || <time>"
     },
-    "single-transition-property": {
-      "comment": "missed angle brackets",
-      "syntax": "all | <ident>"
-    },
-    "single-transition-timing-function": {
-      "comment": "missed spaces",
-      "syntax": "ease | linear | ease-in | ease-out | ease-in-out | step-start | step-end | steps( &lt;integer&gt; [, [ start | end ] ]? ) | cubic-bezier( &lt;number&gt;, &lt;number&gt;, &lt;number&gt;, &lt;number&gt; )"
-    },
     "svg-length": {
@@ -830,10 +716,2 @@ "comment": "All coordinates and lengths in SVG can be specified with or without a unit identifier",
     },
-    "uri": {
-      "comment": "deprecated, add alias to not change syntaxes",
-      "syntax": "<url>"
-    },
-    "quote": {
-      "comment": "missed -> https://drafts.csswg.org/css-content/#typedef-quote",
-      "syntax": "open-quote | close-quote | no-open-quote | no-close-quote"
-    },
     "x": {
@@ -846,4 +724,121 @@ "comment": "missed; not sure we should add it, but no others except `cursor` is using it so it's ok for now; https://drafts.csswg.org/css-ui-3/#cursor",
       "syntax": "<number>"
+    },
+    "var()": {
+      "comment": "drop it since it's a generic (also syntax is incorrect and can't be parsed)",
+      "syntax": null
+    },
+
+    "an-plus-b": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "feature-type": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "feature-value-block": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "feature-value-declaration": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "feature-value-block-list": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "feature-value-declaration-list": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "general-enclosed": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "keyframe-block": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "keyframe-block-list": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "mf-plain": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "mf-range": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "mf-value": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-and": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-condition": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-not": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-or": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-in-parens": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-feature": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-condition-without-or": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-query": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "media-query-list": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "nth": {
+      "comment": "syntax has <an-plus-b> that doesn't support currently, drop for now",
+      "syntax": null
+    },
+    "page-selector": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "page-selector-list": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "page-body": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "page-margin-box": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "page-margin-box-type": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
+    },
+    "pseudo-page": {
+      "comment": "syntax is incorrect and can't be parsed, drop for now",
+      "syntax": null
     }
   }
 }

lib/index.js

@@ -1,19 +0,3 @@
-var walkers = require('./utils/walk');
-var names = require('./utils/names');
+'use strict';
 
-module.exports = {
-    List: require('./utils/list.js'),
-    syntax: require('./syntax'),
-    property: names.property,
-    keyword: names.keyword,
-
-    parse: require('./parser.js'),
-    clone: require('./utils/clone.js'),
-
-    walk: walkers.all,
-    walkRules: walkers.rules,
-    walkRulesRight: walkers.rulesRight,
-
-    translate: require('./utils/translate.js'),
-    translateWithSourceMap: require('./utils/translateWithSourceMap.js')
-};
+module.exports = require('./syntax/default');

lib/syntax/default.js

 var data = require('../../data');
-var syntax = require('./syntax').create({
-    generic: true
-});
 
-for (var key in data.properties) {
-    syntax.addProperty(key, data.properties[key]);
-}
+module.exports = require('./index.js').create({
+    generic: true,
+    types: data.types,
+    properties: data.properties,
 
-for (var key in data.types) {
-    syntax.addType(key, data.types[key]);
-}
-
-module.exports = syntax;
+    parseContext: {
+        default: 'StyleSheet',
+        stylesheet: 'StyleSheet',
+        atrule: 'Atrule',
+        atruleExpression: function(options) {
+            return this.AtruleExpression(options.atrule ? String(options.atrule) : null);
+        },
+        mediaQueryList: 'MediaQueryList',
+        mediaQuery: 'MediaQuery',
+        rule: 'Rule',
+        selectorList: 'SelectorList',
+        selector: 'Selector',
+        block: function() {
+            return this.Block(this.Declaration);
+        },
+        declarationList: 'DeclarationList',
+        declaration: 'Declaration',
+        value: function(options) {
+            return this.Value(options.property ? String(options.property) : null);
+        }
+    },
+    scope: {
+        AtruleExpression: require('./scope/atruleExpression'),
+        Selector: require('./scope/selector'),
+        Value: require('./scope/value')
+    },
+    atrule: {
+        'font-face': require('./atrule/font-face'),
+        'import': require('./atrule/import'),
+        'media': require('./atrule/media'),
+        'page': require('./atrule/page'),
+        'supports': require('./atrule/supports')
+    },
+    pseudo: {
+        'dir': require('./pseudo/dir'),
+        'has': require('./pseudo/has'),
+        'lang': require('./pseudo/lang'),
+        'matches': require('./pseudo/matches'),
+        'not': require('./pseudo/not'),
+        'nth-child': require('./pseudo/nth-child'),
+        'nth-last-child': require('./pseudo/nth-last-child'),
+        'nth-last-of-type': require('./pseudo/nth-last-of-type'),
+        'nth-of-type': require('./pseudo/nth-of-type'),
+        'slotted': require('./pseudo/slotted')
+    },
+    node: {
+        AnPlusB: require('./node/AnPlusB'),
+        Atrule: require('./node/Atrule'),
+        AtruleExpression: require('./node/AtruleExpression'),
+        AttributeSelector: require('./node/AttributeSelector'),
+        Block: require('./node/Block'),
+        Brackets: require('./node/Brackets'),
+        CDC: require('./node/CDC'),
+        CDO: require('./node/CDO'),
+        ClassSelector: require('./node/ClassSelector'),
+        Combinator: require('./node/Combinator'),
+        Comment: require('./node/Comment'),
+        Declaration: require('./node/Declaration'),
+        DeclarationList: require('./node/DeclarationList'),
+        Dimension: require('./node/Dimension'),
+        Function: require('./node/Function'),
+        HexColor: require('./node/HexColor'),
+        Identifier: require('./node/Identifier'),
+        IdSelector: require('./node/IdSelector'),
+        MediaFeature: require('./node/MediaFeature'),
+        MediaQuery: require('./node/MediaQuery'),
+        MediaQueryList: require('./node/MediaQueryList'),
+        Nth: require('./node/Nth'),
+        Number: require('./node/Number'),
+        Operator: require('./node/Operator'),
+        Parentheses: require('./node/Parentheses'),
+        Percentage: require('./node/Percentage'),
+        PseudoClassSelector: require('./node/PseudoClassSelector'),
+        PseudoElementSelector: require('./node/PseudoElementSelector'),
+        Ratio: require('./node/Ratio'),
+        Raw: require('./node/Raw'),
+        Rule: require('./node/Rule'),
+        Selector: require('./node/Selector'),
+        SelectorList: require('./node/SelectorList'),
+        String: require('./node/String'),
+        StyleSheet: require('./node/StyleSheet'),
+        TypeSelector: require('./node/TypeSelector'),
+        UnicodeRange: require('./node/UnicodeRange'),
+        Url: require('./node/Url'),
+        Value: require('./node/Value'),
+        WhiteSpace: require('./node/WhiteSpace')
+    }
+});

lib/syntax/index.js

@@ -1,8 +0,295 @@
-module.exports = {
-    defaultSyntax: require('./default'),
-    Syntax: require('./syntax'),
-    create: require('./syntax').create,
-    parse: require('./parse'),
-    stringify: require('./stringify'),
-    walk: require('./walk')
+var hasOwnProperty = Object.prototype.hasOwnProperty;
+var List = require('../utils/list');
+var createParser = require('../parser');
+var createGenerator = require('../generator').createGenerator;
+var createMarkupGenerator = require('../generator').createMarkupGenerator;
+var sourceMapGenerator = require('../generator').sourceMap;
+var createConvertors = require('../utils/convert');
+var createWalker = require('../walker');
+var names = require('../utils/names');
+var mix = require('./mix');
+
+function assign(dest, src) {
+    for (var key in src) {
+        dest[key] = src[key];
+    }
+
+    return dest;
+}
+
+function createParseContext(name) {
+    return function() {
+        return this[name]();
+    };
+}
+
+function isValidNumber(value) {
+    // Number.isInteger(value) && value >= 0
+    return (
+        typeof value === 'number' &&
+        isFinite(value) &&
+        Math.floor(value) === value &&
+        value >= 0
+    );
+}
+
+function isValidLocation(loc) {
+    return (
+        Boolean(loc) &&
+        isValidNumber(loc.offset) &&
+        isValidNumber(loc.line) &&
+        isValidNumber(loc.column)
+    );
+}
+
+function createNodeStructureChecker(type, fields) {
+    return function checkNode(node, warn) {
+        if (!node || node.constructor !== Object) {
+            return warn('Type of node should be an object');
+        }
+
+        for (var key in node) {
+            if (key === 'type') {
+                if (node.type !== type) {
+                    warn('Wrong node type `' + node.type + '` but expected `' + type + '`');
+                }
+            } else if (key === 'loc') {
+                if (node.loc === null) {
+                    continue;
+                } else if (node.loc && node.loc.constructor === Object) {
+                    if (typeof node.loc.source === 'string' &&
+                        isValidLocation(node.loc.start) &&
+                        isValidLocation(node.loc.end)) {
+                        continue;
+                    }
+                }
+                warn('Wrong value for `' + type + '.' + key + '` field');
+            } else if (fields.hasOwnProperty(key)) {
+                for (var i = 0, valid = false; !valid && i < fields[key].length; i++) {
+                    var fieldType = fields[key][i];
+
+                    switch (fieldType) {
+                        case String:
+                            valid = typeof node[key] === 'string';
+                            break;
+
+                        case Boolean:
+                            valid = typeof node[key] === 'boolean';
+                            break;
+
+                        case null:
+                            valid = node[key] === null;
+                            break;
+
+                        default:
+                            if (typeof fieldType === 'string') {
+                                valid = node[key] && node[key].type === fieldType;
+                            } else if (Array.isArray(fieldType)) {
+                                valid = node[key] instanceof List;
+                            }
+                    }
+                }
+                if (!valid) {
+                    warn('Wrong value for `' + type + '.' + key + '` field');
+                }
+            } else {
+                warn('Unknown field `' + key + '` for ' + type);
+            }
+        }
+
+        for (var key in fields) {
+            if (hasOwnProperty.call(node, key) === false) {
+                warn('Field `' + type + '.' + key + '` is missed');
+            }
+        }
+    };
+}
+
+function processStructure(name, nodeType) {
+    var structure = nodeType.structure;
+    var fields = {
+        type: String,
+        loc: true
+    };
+    var walkers = [];
+    var docs = {
+        type: '"' + name + '"'
+    };
+
+    for (var key in structure) {
+        var walker = {
+            name: key,
+            type: false,
+            nullable: false
+        };
+        var docsTypes = [];
+        var fieldTypes = fields[key] = Array.isArray(structure[key])
+            ? structure[key].slice()
+            : [structure[key]];
+
+        for (var i = 0; i < fieldTypes.length; i++) {
+            var fieldType = fieldTypes[i];
+            if (fieldType === String || fieldType === Boolean) {
+                docsTypes.push(fieldType.name);
+            } else if (fieldType === null) {
+                walker.nullable = true;
+                docsTypes.push('null');
+            } else if (typeof fieldType === 'string') {
+                walker.type = 'node';
+                docsTypes.push('<' + fieldType + '>');
+            } else if (Array.isArray(fieldType)) {
+                walker.type = 'list';
+                docsTypes.push('List'); // TODO: use type enum
+            } else {
+                throw new Error('Wrong value in `' + name + '` structure definition');
+            }
+        }
+
+        docs[key] = docsTypes.join(' | ');
+
+        if (walker.type) {
+            walkers.push(walker);
+        }
+    }
+
+    return {
+        docs: docs,
+        check: createNodeStructureChecker(name, fields),
+        walk: walkers.length ? {
+            context: nodeType.walkContext,
+            fields: walkers
+        } : null
+    };
+}
+
+function createSyntax(config) {
+    var parser = { context: {}, scope: {}, atrule: {}, pseudo: {} };
+    var walker = { type: {} };
+    var generator = {};
+    var lexer = { structure: {} };
+
+    if (config.parseContext) {
+        for (var name in config.parseContext) {
+            switch (typeof config.parseContext[name]) {
+                case 'function':
+                    parser.context[name] = config.parseContext[name];
+                    break;
+
+                case 'string':
+                    parser.context[name] = createParseContext(config.parseContext[name]);
+                    break;
+            }
+        }
+    }
+
+    if (config.scope) {
+        for (var name in config.scope) {
+            parser.scope[name] = config.scope[name];
+        }
+    }
+
+    if (config.atrule) {
+        for (var name in config.atrule) {
+            var atrule = config.atrule[name];
+
+            if (atrule.parse) {
+                parser.atrule[name] = atrule.parse;
+            }
+        }
+    }
+
+    if (config.pseudo) {
+        for (var name in config.pseudo) {
+            var pseudo = config.pseudo[name];
+
+            if (pseudo.parse) {
+                parser.pseudo[name] = pseudo.parse;
+            }
+        }
+    }
+
+    if (config.node) {
+        for (var name in config.node) {
+            var nodeType = config.node[name];
+
+            parser[name] = nodeType.parse;
+            generator[name] = nodeType.generate;
+
+            if (nodeType.structure) {
+                var structure = processStructure(name, nodeType);
+                lexer.structure[name] = {
+                    docs: structure.docs,
+                    check: structure.check
+                };
+                if (structure.walk) {
+                    walker.type[name] = structure.walk;
+                }
+            } else {
+                throw new Error('Missed `structure` field in `' + name + '` node type definition');
+            }
+        }
+    }
+
+    var parse = createParser(parser);
+    var Lexer = require('../lexer/Lexer');
+    var walker = createWalker(walker.type);
+    var convertors = createConvertors(walker);
+    var markupGenerator = createMarkupGenerator(generator);
+
+    var syntax = {
+        List: require('../utils/list'),
+        Tokenizer: require('../tokenizer'),
+        Lexer: require('../lexer/Lexer'),
+
+        property: names.property,
+        keyword: names.keyword,
+
+        lexer: null,
+        syntax: require('../lexer'),
+        createLexer: function(config) {
+            return new Lexer(config, syntax, lexer.structure);
+        },
+
+        parse: parse,
+
+        walk: walker.all,
+        walkUp: walker.allUp,
+        walkRules: walker.rules,
+        walkRulesRight: walker.rulesRight,
+        walkDeclarations: walker.declarations,
+
+        translate: createGenerator(generator),
+        translateWithSourceMap: function(node) {
+            return sourceMapGenerator(markupGenerator, node);
+        },
+        translateMarkup: markupGenerator,
+
+        clone: require('../utils/clone'),
+        fromPlainObject: convertors.fromPlainObject,
+        toPlainObject: convertors.toPlainObject,
+
+        createSyntax: function(config) {
+            return createSyntax(mix({}, config));
+        },
+        fork: function(extension) {
+            var base = mix({}, config); // copy of config
+            return createSyntax(
+                typeof extension === 'function'
+                    ? extension(base, assign)
+                    : mix(base, extension)
+            );
+        }
+    };
+
+    syntax.lexer = new Lexer({
+        generic: true,
+        types: config.types,
+        properties: config.properties
+    }, syntax, lexer.structure);
+
+    return syntax;
 };
+
+exports.create = function(config) {
+    return createSyntax(mix({}, config));
+};

lib/utils/clone.js

@@ -0,1 +1,3 @@
+'use strict';
+
 var List = require('./list');
@@ -13,3 +15,3 @@
             } else if (value instanceof List) {
-                value = new List(value.map(clone));
+                value = new List().fromArray(value.map(clone));
             } else if (value.constructor === Object) {
@@ -16,0 +18,0 @@ value = clone(value);

lib/utils/list.js

@@ -0,1 +1,3 @@
+'use strict';
+
 //
@@ -18,50 +20,53 @@ //            item        item        item        item
     return {
-        data: data,
+        prev: null,
         next: null,
-        prev: null
+        data: data
     };
 }
 
-var List = function(values) {
+var cursors = null;
+var List = function() {
     this.cursor = null;
     this.head = null;
     this.tail = null;
+};
 
-    if (Array.isArray(values)) {
-        var cursor = null;
+List.createItem = createItem;
+List.prototype.createItem = createItem;
 
-        for (var i = 0; i < values.length; i++) {
-            var item = createItem(values[i]);
+List.prototype.getSize = function() {
+    var size = 0;
+    var cursor = this.head;
 
-            if (cursor !== null) {
-                cursor.next = item;
-            } else {
-                this.head = item;
-            }
+    while (cursor) {
+        size++;
+        cursor = cursor.next;
+    }
 
-            item.prev = cursor;
-            cursor = item;
-        }
-
-        this.tail = cursor;
-    }
+    return size;
 };
 
-Object.defineProperty(List.prototype, 'size', {
-    get: function() {
-        var size = 0;
-        var cursor = this.head;
+List.prototype.fromArray = function(array) {
+    var cursor = null;
 
-        while (cursor) {
-            size++;
-            cursor = cursor.next;
+    this.head = null;
+
+    for (var i = 0; i < array.length; i++) {
+        var item = createItem(array[i]);
+
+        if (cursor !== null) {
+            cursor.next = item;
+        } else {
+            this.head = item;
         }
 
-        return size;
+        item.prev = cursor;
+        cursor = item;
     }
-});
 
-List.createItem = createItem;
-List.prototype.createItem = createItem;
+    this.tail = cursor;
 
+    return this;
+};
+
 List.prototype.toArray = function() {
@@ -78,6 +83,5 @@ var cursor = this.head;
 };
-List.prototype.toJSON = function() {
-    return this.toArray();
-};
 
+List.prototype.toJSON = List.prototype.toArray;
+
 List.prototype.isEmpty = function() {
@@ -95,9 +99,36 @@ return this.head === null;
 
+function allocateCursor(node, prev, next) {
+    var cursor;
+
+    if (cursors !== null) {
+        cursor = cursors;
+        cursors = cursors.cursor;
+        cursor.prev = prev;
+        cursor.next = next;
+        cursor.cursor = node.cursor;
+    } else {
+        cursor = {
+            prev: prev,
+            next: next,
+            cursor: node.cursor
+        };
+    }
+
+    node.cursor = cursor;
+
+    return cursor;
+}
+
+function releaseCursor(node) {
+    var cursor = node.cursor;
+
+    node.cursor = cursor.cursor;
+    cursor.prev = null;
+    cursor.next = null;
+    cursor.cursor = cursors;
+    cursors = cursor;
+}
+
 List.prototype.each = function(fn, context) {
     var item;
-    var cursor = {
-        prev: null,
-        next: this.head,
-        cursor: this.cursor
-    };
 
@@ -109,3 +140,3 @@ if (context === undefined) {
     // push cursor
-    this.cursor = cursor;
+    var cursor = allocateCursor(this, null, this.head);
 
@@ -120,3 +151,3 @@ while (cursor.next !== null) {
     // pop cursor
-    this.cursor = this.cursor.cursor;
+    releaseCursor(this);
 };
@@ -126,7 +157,2 @@
     var item;
-    var cursor = {
-        prev: this.tail,
-        next: null,
-        cursor: this.cursor
-    };
 
@@ -138,3 +164,3 @@ if (context === undefined) {
     // push cursor
-    this.cursor = cursor;
+    var cursor = allocateCursor(this, this.tail, null);
 
@@ -149,3 +175,3 @@ while (cursor.prev !== null) {
     // pop cursor
-    this.cursor = this.cursor.cursor;
+    releaseCursor(this);
 };
@@ -159,7 +185,2 @@
     var item;
-    var cursor = {
-        prev: null,
-        next: start,
-        cursor: this.cursor
-    };
 
@@ -171,3 +192,3 @@ if (context === undefined) {
     // push cursor
-    this.cursor = cursor;
+    var cursor = allocateCursor(this, null, start);
 
@@ -184,3 +205,3 @@ while (cursor.next !== null) {
     // pop cursor
-    this.cursor = this.cursor.cursor;
+    releaseCursor(this);
 };
@@ -194,7 +215,2 @@
     var item;
-    var cursor = {
-        prev: start,
-        next: null,
-        cursor: this.cursor
-    };
 
@@ -206,3 +222,3 @@ if (context === undefined) {
     // push cursor
-    this.cursor = cursor;
+    var cursor = allocateCursor(this, start, null);
 
@@ -219,3 +235,3 @@ while (cursor.prev !== null) {
     // pop cursor
-    this.cursor = this.cursor.cursor;
+    releaseCursor(this);
 };
@@ -257,2 +273,7 @@
 
+List.prototype.clear = function() {
+    this.head = null;
+    this.tail = null;
+};
+
 List.prototype.copy = function() {
@@ -274,7 +295,7 @@ var result = new List();
     while (cursor !== null) {
-        if (prevNew === true || cursor.prev === prevOld) {
+        if (cursor.prev === prevOld) {
             cursor.prev = prevNew;
         }
 
-        if (nextNew === true || cursor.next === nextOld) {
+        if (cursor.next === nextOld) {
             cursor.next = nextNew;
@@ -287,2 +308,60 @@ }
 
+List.prototype.prepend = function(item) {
+    //      head
+    //    ^
+    // item
+    this.updateCursors(null, item, this.head, item);
+
+    // insert to the beginning of the list
+    if (this.head !== null) {
+        // new item <- first item
+        this.head.prev = item;
+
+        // new item -> first item
+        item.next = this.head;
+    } else {
+        // if list has no head, then it also has no tail
+        // in this case tail points to the new item
+        this.tail = item;
+    }
+
+    // head always points to new item
+    this.head = item;
+
+    return this;
+};
+
+List.prototype.prependData = function(data) {
+    return this.prepend(createItem(data));
+};
+
+List.prototype.append = function(item) {
+    // tail
+    //      ^
+    //      item
+    this.updateCursors(this.tail, item, null, item);
+
+    // insert to the ending of the list
+    if (this.tail !== null) {
+        // last item -> new item
+        this.tail.next = item;
+
+        // last item <- new item
+        item.prev = this.tail;
+    } else {
+        // if list has no tail, then it also has no head
+        // in this case head points to new item
+        this.head = item;
+    }
+
+    // tail always points to new item
+    this.tail = item;
+
+    return this;
+};
+
+List.prototype.appendData = function(data) {
+    return this.append(createItem(data));
+};
+
 List.prototype.insert = function(item, before) {
@@ -298,3 +377,3 @@ if (before !== undefined && before !== null) {
             if (this.head !== before) {
-                throw new Error('before doesn\'t below to list');
+                throw new Error('before doesn\'t belong to list');
             }
@@ -319,27 +398,10 @@
     } else {
-        // tail
-        //      ^
-        //     item
-        this.updateCursors(this.tail, item, null, item);
-
-        // insert to end of the list
-        if (this.tail !== null) {
-            // if list has a tail, then it also has a head, but head doesn't change
-
-            // last item -> new item
-            this.tail.next = item;
-
-            // last item <- new item
-            item.prev = this.tail;
-        } else {
-            // if list has no a tail, then it also has no a head
-            // in this case points head to new item
-            this.head = item;
-        }
-
-        // tail always start point to new item
-        this.tail = item;
+        this.append(item);
     }
 };
 
+List.prototype.insertData = function(data, before) {
+    this.insert(createItem(data), before);
+};
+
 List.prototype.remove = function(item) {
@@ -355,3 +417,3 @@ //      item
         if (this.head !== item) {
-            throw new Error('item doesn\'t below to list');
+            throw new Error('item doesn\'t belong to list');
         }
@@ -366,3 +428,3 @@
         if (this.tail !== item) {
-            throw new Error('item doesn\'t below to list');
+            throw new Error('item doesn\'t belong to list');
         }
@@ -410,2 +472,39 @@
 
+List.prototype.insertList = function(list, before) {
+    if (before !== undefined && before !== null) {
+        // ignore empty lists
+        if (list.head === null) {
+            return;
+        }
+
+        this.updateCursors(before.prev, list.tail, before, list.head);
+
+        // insert in the middle of dist list
+        if (before.prev !== null) {
+            // before.prev <-> list.head
+            before.prev.next = list.head;
+            list.head.prev = before.prev;
+        } else {
+            this.head = list.head;
+        }
+
+        before.prev = list.tail;
+        list.tail.next = before;
+
+        list.head = null;
+        list.tail = null;
+    } else {
+        this.appendList(list);
+    }
+};
+
+List.prototype.replace = function(oldItem, newItemOrList) {
+    if ('head' in newItemOrList) {
+        this.insertList(newItemOrList, oldItem);
+    } else {
+        this.insert(newItemOrList, oldItem);
+    }
+    this.remove(oldItem);
+};
+
 module.exports = List;

lib/utils/names.js

@@ -0,12 +1,21 @@
+'use strict';
+
 var hasOwnProperty = Object.prototype.hasOwnProperty;
-var knownKeywords = Object.create(null);
-var knownProperties = Object.create(null);
+var keywords = Object.create(null);
+var properties = Object.create(null);
+var HYPHENMINUS = 45; // '-'.charCodeAt()
 
-function getVendorPrefix(string) {
-    if (string[0] === '-') {
-        // skip 2 chars to avoid wrong match with variables names
-        var secondDashIndex = string.indexOf('-', 2);
+function isCustomProperty(str, offset) {
+    return str.length - offset >= 2 &&
+           str.charCodeAt(offset) === HYPHENMINUS &&
+           str.charCodeAt(offset + 1) === HYPHENMINUS;
+}
 
+function getVendorPrefix(str, offset) {
+    if (str.charCodeAt(offset) === HYPHENMINUS) {
+        // vendor should contain at least one letter
+        var secondDashIndex = str.indexOf('-', offset + 2);
+
         if (secondDashIndex !== -1) {
-            return string.substr(0, secondDashIndex + 1);
+            return str.substring(offset, secondDashIndex + 1);
         }
@@ -19,18 +28,18 @@ }
 function getKeywordInfo(keyword) {
-    if (hasOwnProperty.call(knownKeywords, keyword)) {
-        return knownKeywords[keyword];
+    if (hasOwnProperty.call(keywords, keyword)) {
+        return keywords[keyword];
     }
 
-    var lowerCaseKeyword = keyword.toLowerCase();
-    var vendor = getVendorPrefix(lowerCaseKeyword);
-    var name = lowerCaseKeyword;
+    var name = keyword.toLowerCase();
 
-    if (vendor) {
-        name = name.substr(vendor.length);
+    if (hasOwnProperty.call(keywords, name)) {
+        return keywords[keyword] = keywords[name];
     }
 
-    return knownKeywords[keyword] = Object.freeze({
+    var vendor = !isCustomProperty(name, 0) ? getVendorPrefix(name, 0) : '';
+
+    return keywords[keyword] = Object.freeze({
         vendor: vendor,
         prefix: vendor,
-        name: name
+        name: name.substr(vendor.length)
     });
@@ -40,30 +49,36 @@ }
 function getPropertyInfo(property) {
-    if (hasOwnProperty.call(knownProperties, property)) {
-        return knownProperties[property];
+    if (hasOwnProperty.call(properties, property)) {
+        return properties[property];
     }
 
-    var lowerCaseProperty = property.toLowerCase();
-    var hack = lowerCaseProperty[0];
+    var name = property;
+    var hack = property[0];
 
-    if (hack === '*' || hack === '_' || hack === '$') {
-        lowerCaseProperty = lowerCaseProperty.substr(1);
-    } else if (hack === '/' && property[1] === '/') {
+    if (hack === '/' && property[1] === '/') {
         hack = '//';
-        lowerCaseProperty = lowerCaseProperty.substr(2);
-    } else {
+    } else if (hack !== '_' &&
+               hack !== '*' &&
+               hack !== '$' &&
+               hack !== '#' &&
+               hack !== '+') {
         hack = '';
     }
 
-    var vendor = getVendorPrefix(lowerCaseProperty);
-    var name = lowerCaseProperty;
+    var custom = isCustomProperty(name, hack.length);
 
-    if (vendor) {
-        name = name.substr(vendor.length);
+    if (!custom) {
+        name = name.toLowerCase();
+        if (hasOwnProperty.call(properties, name)) {
+            return properties[property] = properties[name];
+        }
     }
 
-    return knownProperties[property] = Object.freeze({
+    var vendor = !custom ? getVendorPrefix(name, hack.length) : '';
+
+    return properties[property] = Object.freeze({
         hack: hack,
         vendor: vendor,
         prefix: hack + vendor,
-        name: name
+        name: name.substr(hack.length + vendor.length),
+        custom: custom
     });
@@ -70,0 +85,0 @@ }

package.json

 {
   "name": "css-tree",
-  "version": "1.0.0-alpha2",
-  "description": "Detailed CSS parser",
+  "version": "1.0.0-alpha20",
+  "description": "Fast detailed CSS parser",
   "keywords": [
@@ -10,3 +10,3 @@ "css",
   ],
-  "homepage": "https://github.com/csstree/parser",
+  "homepage": "https://github.com/csstree/csstree",
   "author": "Roman Dvornov <[e-mail]> (https://github.com/lahmatiy)",
@@ -21,5 +21,5 @@ "maintainers": [
   "license": "MIT",
-  "repository": "csstree/parser",
+  "repository": "csstree/csstree",
   "bugs": {
-    "url": "https://github.com/csstree/parser/issues"
+    "url": "https://github.com/csstree/csstree/issues"
   },
@@ -39,18 +39,26 @@ "main": "./lib/index",
       "no-undef": 2,
-      "no-unused-vars": [2, {"vars": "all", "args": "after-used"}]
+      "no-unused-vars": [
+        2,
+        {
+          "vars": "all",
+          "args": "after-used"
+        }
+      ]
     }
   },
   "scripts": {
-    "gen:syntax": "node scripts/gen-syntax-data.js",
+    "lint": "jscs data lib scripts test && eslint data lib scripts test",
+    "update:docs": "node scripts/update-docs.js",
     "build": "npm run gen:syntax && browserify --standalone csstree lib/index.js | uglifyjs --compress --mangle -o dist/csstree.js",
-    "codestyle-and-test": "npm run codestyle && npm test",
-    "codestyle": "jscs data lib scripts test && eslint data lib scripts test",
-    "test": "mocha --reporter dot",
-    "coverage": "istanbul cover _mocha -- -R dot",
+    "lint-and-test": "npm run lint && npm test",
+    "test": "mocha --reporter progress",
+    "gen:syntax": "node scripts/gen-syntax-data.js && npm run update:docs",
+    "coverage": "istanbul cover _mocha -- -R min",
     "prepublish": "npm run build",
-    "travis": "npm run codestyle-and-test && npm run coveralls",
-    "coveralls": "istanbul cover _mocha --report lcovonly -- -R dot && cat ./coverage/lcov.info | coveralls",
+    "travis": "npm run lint-and-test && npm run coveralls",
+    "coveralls": "istanbul cover _mocha --report lcovonly -- -R min && cat ./coverage/lcov.info | coveralls",
     "hydrogen": "node --trace-hydrogen --trace-phase=Z --trace-deopt --code-comments --hydrogen-track-positions --redirect-code-traces --redirect-code-traces-to=code.asm --trace_hydrogen_file=code.cfg --print-opt-code bin/parse --stat -o /dev/null"
   },
   "dependencies": {
+    "mdn-data": "^1.0.0",
     "source-map": "^0.5.3"
@@ -64,2 +72,3 @@ },
     "jscs": "~3.0.7",
+    "json-to-ast": "^1.2.15",
     "mocha": "^3.0.2",
@@ -66,0 +75,0 @@ "uglify-js": "^2.6.1"

README.md

@@ -0,8 +1,69 @@
+<img align="right" width="111" height="111"
+     alt="CSSTree logo"
+     src="https://cloud.githubusercontent.com/assets/270491/19243723/6f9136c6-8f21-11e6-82ac-eeeee4c6c452.png"/>
+
+# CSSTree
+
+[![NPM version](https://img.shields.io/npm/v/css-tree.svg)](https://www.npmjs.com/package/css-tree)
 [![Build Status](https://travis-ci.org/csstree/csstree.svg?branch=master)](https://travis-ci.org/csstree/csstree)
 [![Coverage Status](https://coveralls.io/repos/github/csstree/csstree/badge.svg?branch=master)](https://coveralls.io/github/csstree/csstree?branch=master)
+[![Join the CSSTree chat at https://gitter.im/csstree/csstree](https://badges.gitter.im/csstree/csstree.svg)](https://gitter.im/csstree/csstree)
+[![Twitter](https://img.shields.io/badge/[e-mail])](https://twitter.com/csstree)
 
+The set of tools for working with CSS, including [fast](https://github.com/postcss/benchmark) detailed parser (string->AST), walkers, generators (AST->string) and even lexer (validation and matching) based on knowledge of spec and browser implementations (see [schema](#top-level-api) for details). The main goal to be efficient and W3C spec complient, with focus on analyzing and source-to-source processing.
 
+> Work in progress. The project in alpha stage since some parts need further experiments, AST format and API are subjects to change. However it's stable enough and used by packages like [CSSO](https://github.com/css/csso) (CSS minifier) in production.
+
+- [Parsing CSS into AST](docs/parsing.md)
+- [AST format](docs/ast.md)
+- [Translate AST to string](docs/translate.md)
+- [AST traversal](docs/traversal.md)
+- [Utils to work with AST](docs/utils.md)
+
+Docs and tools:
+
+* [AST Explorer](https://astexplorer.net/#/gist/244e2fb4da940df52bf0f4b94277db44/e79aff44611020b22cfd9708f3a99ce09b7d67a8) – explore CSSTree AST format with zero setup
 * [CSS syntax reference](https://csstree.github.io/docs/syntax.html)
 * [CSS syntax validator](https://csstree.github.io/docs/validator.html)
 
-Coming soon...
+Related projects:
+
+* [csstree-validator](https://github.com/csstree/validator) – NPM package to validate CSS
+* [stylelint-csstree-validator](https://github.com/csstree/stylelint-validator) – plugin for stylelint to validate CSS
+* [Grunt plugin](https://github.com/sergejmueller/grunt-csstree-validator)
+* [Gulp plugin](https://github.com/csstree/gulp-csstree)
+* [Sublime plugin](https://github.com/csstree/SublimeLinter-contrib-csstree)
+* [VS Code plugin](https://github.com/csstree/vscode-plugin)
+* [Atom plugin](https://github.com/csstree/atom-plugin)
+
+## Install
+
+```
+> npm install css-tree
+```
+
+## Usage
+
+```js
+var csstree = require('css-tree');
+var ast = csstree.parse('.example { world: "!" }');
+
+csstree.walk(ast, function(node) {
+    if (node.type === 'ClassSelector' && node.name === 'example') {
+        node.name = 'hello';
+    }
+});
+
+console.log(csstree.translate(ast));
+// .hello{world:"!"}
+```
+
+## Top level API
+
+![API map](https://cdn.rawgit.com/csstree/csstree/master/docs/api-map.svg)
+
+## License
+
+MIT
+
+Syntax matching uses [mdn/data](https://github.com/mdn/data) by Mozilla Contributors

New alerts

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Uses eval

Supply chain risk

Package uses dynamic code execution (e.g., eval()), which is a dangerous practice. This can prevent the code from running in certain environments and increases the risk that the code may contain exploits or malicious behavior.

Found 1 instance in 1 package

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

No repository

Supply chain risk

Package does not have a linked source code repository. Without this field, a package will have no reference to the location of the source code use to generate the package.

Found 1 instance in 1 package

Fixed alerts

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

No repository

Supply chain risk

Package does not have a linked source code repository. Without this field, a package will have no reference to the location of the source code use to generate the package.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

560603

1.27%

Number of package files

116

274.19%

Number of lines in readme file

70

677.78%

Worsened metrics

Dependency count

2

100%

Dev dependency count

8

14.29%

Lines of code

7638

-41.13%

Number of low supply chain risk alerts

6

20%

Number of medium supply chain risk alerts

2

100%

Dependency changes

• + Added

  mdn-data@^1.0.0

• + Added

  mdn-data@1.2.0
  (transitive)