Initial commit

node_modules/stylelint/lib/rules/value-keyword-case/README.md

@@ -0,0 +1,231 @@
+# value-keyword-case
+
+Specify lowercase or uppercase for keywords values.
+
+```css
+    a { display: block; }
+/**              ↑
+ *    These values */
+```
+
+This rule ignores [`<custom-idents>`](https://developer.mozilla.org/en/docs/Web/CSS/custom-ident) of known properties. Values which are paired with non-properties (e.g. `$vars` and custom properties), and do not conform to the primary option, can be ignored using the `ignoreValues: []` secondary option.
+
+## Options
+
+`string`: `"lower"|"upper"`
+
+### `"lower"`
+
+The following patterns are considered warnings:
+
+```css
+a {
+  display: Block;
+}
+```
+
+```css
+a {
+  display: bLoCk;
+}
+```
+
+```css
+a {
+  display: BLOCK;
+}
+```
+
+```css
+a {
+  transition: -WEBKIT-TRANSFORM 2s;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  display: block;
+}
+```
+
+```css
+a {
+  transition: -webkit-transform 2s;
+}
+```
+
+### `"upper"`
+
+The following patterns are considered warnings:
+
+```css
+a {
+  display: Block;
+}
+```
+
+```css
+a {
+  display: bLoCk;
+}
+```
+
+```css
+a {
+  display: block;
+}
+```
+
+```css
+a {
+  transition: -webkit-transform 2s;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  display: BLOCK;
+}
+```
+
+```css
+a {
+  transition: -WEBKIT-TRANSFORM 2s;
+}
+```
+
+## Optional secondary options
+
+### `ignoreKeywords: ["/regex/", "non-regex"]`
+
+Ignore case of keywords values.
+
+For example, with `"lower"`.
+
+Given:
+
+```js
+["Block", "/^(f|F)lex$/"]
+```
+
+The following patterns are considered warnings:
+
+```css
+a {
+  display: bLoCk;
+}
+```
+
+```css
+a {
+  display: BLOCK;
+}
+```
+
+```css
+a {
+  display: fLeX;
+}
+```
+
+```css
+a {
+  display: FLEX;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  display: block;
+}
+```
+
+```css
+a {
+  display: Block;
+}
+```
+
+```css
+a {
+  display: flex;
+}
+```
+
+```css
+a {
+  display: Flex;
+}
+```
+
+For example, with `"upper"`.
+
+Given:
+
+```js
+["Block", "/^(f|F)lex$/"]
+```
+
+The following patterns are considered warnings:
+
+```css
+a {
+  display: bLoCk;
+}
+```
+
+```css
+a {
+  display: block;
+}
+```
+
+```css
+a {
+  display: fLeX;
+}
+```
+
+```css
+a {
+  display: fLEX;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  display: BLOCK;
+}
+```
+
+```css
+a {
+  display: Block;
+}
+```
+
+```css
+a {
+  display: FLEX;
+}
+```
+
+```css
+a {
+  display: Flex;
+}
+```
+
+```css
+a {
+  display: flex;
+}
+```

node_modules/stylelint/lib/rules/value-keyword-case/index.js

@@ -0,0 +1,144 @@
+"use strict"
+
+const keywordSets = require("../../reference/keywordSets")
+const declarationValueIndex = require("../../utils/declarationValueIndex")
+const getUnitFromValueNode = require("../../utils/getUnitFromValueNode")
+const isCounterIncrementCustomIdentValue = require("../../utils/isCounterIncrementCustomIdentValue")
+const isStandardSyntaxValue = require("../../utils/isStandardSyntaxValue")
+const matchesStringOrRegExp = require("../../utils/matchesStringOrRegExp")
+const report = require("../../utils/report")
+const ruleMessages = require("../../utils/ruleMessages")
+const validateOptions = require("../../utils/validateOptions")
+const _ = require("lodash")
+const valueParser = require("postcss-value-parser")
+
+const ruleName = "value-keyword-case"
+
+const messages = ruleMessages(ruleName, {
+  expected: (actual, expected) => `Expected "${actual}" to be "${expected}"`,
+})
+
+// Operators are interpreted as "words" by the value parser, so we want to make sure to ignore them.
+const ignoredCharacters = new Set([
+  "+",
+  "-",
+  "/",
+  "*",
+  "%",
+])
+
+const mapLowercaseKeywordsToCamelCase = new Map()
+keywordSets.camelCaseKeywords.forEach(func => {
+  mapLowercaseKeywordsToCamelCase.set(func.toLowerCase(), func)
+})
+
+const rule = function (expectation, options) {
+  return (root, result) => {
+    const validOptions = validateOptions(result, ruleName, {
+      actual: expectation,
+      possible: [
+        "lower",
+        "upper",
+      ],
+    }, {
+      actual: options,
+      possible: {
+        ignoreKeywords: [_.isString],
+      },
+      optional: true,
+    })
+    if (!validOptions) {
+      return
+    }
+
+    root.walkDecls(decl => {
+      const prop = decl.prop,
+        value = decl.value
+
+      valueParser(value).walk(node => {
+        const valueLowerCase = node.value.toLowerCase()
+
+        // Ignore system colors
+        if (keywordSets.systemColors.has(valueLowerCase)) {
+          return
+        }
+
+        // Ignore keywords within `url` and `var` function
+        if (node.type === "function" && (valueLowerCase === "url" || valueLowerCase === "var")) {
+          return false
+        }
+
+        const keyword = node.value
+
+        // Ignore css variables, and hex values, and math operators, and sass interpolation
+        if (node.type !== "word" || !isStandardSyntaxValue(node.value) || value.indexOf("#") !== -1 || ignoredCharacters.has(keyword) || getUnitFromValueNode(node)) {
+          return
+        }
+
+        if (prop === "animation" && !keywordSets.animationShorthandKeywords.has(valueLowerCase) && !keywordSets.animationNameKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "animation-name" && !keywordSets.animationNameKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "font" && !keywordSets.fontShorthandKeywords.has(valueLowerCase) && !keywordSets.fontFamilyKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "font-family" && !keywordSets.fontFamilyKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "counter-increment" && isCounterIncrementCustomIdentValue(valueLowerCase)) {
+          return
+        }
+        if (prop === "grid-row" && !keywordSets.gridRowKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "grid-column" && !keywordSets.gridColumnKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "grid-area" && !keywordSets.gridAreaKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "list-style" && !keywordSets.listStyleShorthandKeywords.has(valueLowerCase) && !keywordSets.listStyleTypeKeywords.has(valueLowerCase)) {
+          return
+        }
+        if (prop === "list-style-type" && !keywordSets.listStyleTypeKeywords.has(valueLowerCase)) {
+          return
+        }
+
+        const ignoreKeywords = options && options.ignoreKeywords || []
+
+        if (ignoreKeywords.length > 0 && matchesStringOrRegExp(keyword, ignoreKeywords)) {
+          return
+        }
+
+        const keywordLowerCase = keyword.toLocaleLowerCase()
+        let expectedKeyword = null
+
+        if (expectation === "lower" && mapLowercaseKeywordsToCamelCase.has(keywordLowerCase)) {
+          expectedKeyword = mapLowercaseKeywordsToCamelCase.get(keywordLowerCase)
+        } else if (expectation === "lower") {
+          expectedKeyword = keyword.toLowerCase()
+        } else {
+          expectedKeyword = keyword.toUpperCase()
+        }
+
+        if (keyword === expectedKeyword) {
+          return
+        }
+
+        report({
+          message: messages.expected(keyword, expectedKeyword),
+          node: decl,
+          index: declarationValueIndex(decl) + node.sourceIndex,
+          result,
+          ruleName,
+        })
+      })
+    })
+  }
+}
+
+rule.ruleName = ruleName
+rule.messages = messages
+module.exports = rule