Initial commit

node_modules/stylelint/lib/rules/block-opening-brace-space-before/README.md

@@ -0,0 +1,172 @@
+# block-opening-brace-space-before
+
+Require a single space or disallow whitespace before the opening brace of blocks.
+
+```css
+  a { color: pink; }
+/** ↑
+ * The space before this brace */
+```
+
+## Options
+
+`string`: `"always"|"never"|"always-single-line"|"never-single-line"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There *must always* be a single space before the opening brace.
+
+The following patterns are considered warnings:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a
+{ color: pink; }
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a { color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+### `"never"`
+
+There *must never* be whitespace before the opening brace.
+
+The following patterns are considered warnings:
+
+```css
+a { color: pink; }
+```
+
+```css
+a
+{ color: pink; }
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a{
+color: pink; }
+```
+
+### `"always-single-line"`
+
+There *must always* be a single space before the opening brace in single-line blocks.
+
+The following patterns are considered warnings:
+
+```css
+a{ color: pink; }
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a { color: pink; }
+```
+
+```css
+a{
+color: pink; }
+```
+
+### `"never-single-line"`
+
+There *must never* be whitespace before the opening brace in single-line blocks.
+
+The following patterns are considered warnings:
+
+```css
+a { color: pink; }
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+### `"always-multi-line"`
+
+There *must always* be a single space before the opening brace in multi-line blocks.
+
+The following patterns are considered warnings:
+
+```css
+a{
+color: pink; }
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+### `"never-multi-line"`
+
+There *must never* be whitespace before the opening brace in multi-line blocks.
+
+The following patterns are considered warnings:
+
+```css
+a {
+color: pink; }
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a { color: pink; }
+```
+
+```css
+a{
+color: pink;}
+```
+
+## Optional secondary options
+
+### `ignoreAtRules: ["/regex/", "non-regex"]`
+
+Given:
+
+```js
+["/fo/"]
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+@for ...
+{}
+```
+
+```css
+@for ...{}
+```

node_modules/stylelint/lib/rules/block-opening-brace-space-before/index.js

@@ -0,0 +1,95 @@
+"use strict"
+
+const _ = require("lodash")
+const beforeBlockString = require("../../utils/beforeBlockString")
+const blockString = require("../../utils/blockString")
+const hasBlock = require("../../utils/hasBlock")
+const hasEmptyBlock = require("../../utils/hasEmptyBlock")
+const optionsMatches = require("../../utils/optionsMatches")
+const report = require("../../utils/report")
+const ruleMessages = require("../../utils/ruleMessages")
+const validateOptions = require("../../utils/validateOptions")
+const whitespaceChecker = require("../../utils/whitespaceChecker")
+
+const ruleName = "block-opening-brace-space-before"
+
+const messages = ruleMessages(ruleName, {
+  expectedBefore: () => "Expected single space before \"{\"",
+  rejectedBefore: () => "Unexpected whitespace before \"{\"",
+  expectedBeforeSingleLine: () => "Expected single space before \"{\" of a single-line block",
+  rejectedBeforeSingleLine: () => "Unexpected whitespace before \"{\" of a single-line block",
+  expectedBeforeMultiLine: () => "Expected single space before \"{\" of a multi-line block",
+  rejectedBeforeMultiLine: () => "Unexpected whitespace before \"{\" of a multi-line block",
+})
+
+const rule = function (expectation, options) {
+  const checker = whitespaceChecker("space", expectation, messages)
+  return (root, result) => {
+    const validOptions = validateOptions(result, ruleName, {
+      actual: expectation,
+      possible: [
+        "always",
+        "never",
+        "always-single-line",
+        "never-single-line",
+        "always-multi-line",
+        "never-multi-line",
+      ],
+    }, {
+      actual: options,
+      possible: {
+        ignoreAtRules: [_.isString],
+      },
+      optional: true,
+    })
+    if (!validOptions) {
+      return
+    }
+
+    // Check both kinds of statements: rules and at-rules
+    root.walkRules(check)
+    root.walkAtRules(check)
+
+    function check(statement) {
+      // Return early if blockless or has an empty block
+      if (
+        !hasBlock(statement)
+        || hasEmptyBlock(statement)
+      ) {
+        return
+      }
+
+      // Return early if at-rule is to be ignored
+      if (optionsMatches(options, "ignoreAtRules", statement.name)) {
+        return
+      }
+
+      const source = beforeBlockString(statement)
+      const beforeBraceNoRaw = beforeBlockString(statement, { noRawBefore: true })
+
+      let index = beforeBraceNoRaw.length - 1
+      if (beforeBraceNoRaw[index - 1] === "\r") {
+        index -= 1
+      }
+
+      checker.before({
+        source,
+        index: source.length,
+        lineCheckStr: blockString(statement),
+        err: m => {
+          report({
+            message: m,
+            node: statement,
+            index,
+            result,
+            ruleName,
+          })
+        },
+      })
+    }
+  }
+}
+
+rule.ruleName = ruleName
+rule.messages = messages
+module.exports = rule