Initial commit

node_modules/stylelint/lib/rules/rule-nested-empty-line-before/README.md

@@ -0,0 +1,205 @@
+# rule-nested-empty-line-before
+
+***Deprecated: instead use the [rule-empty-line-before](../rule-empty-line-before/README.md).***
+
+Require or disallow an empty line before nested rules.
+
+```css
+@media {
+       /* ← */
+  a {} /* ↑ */
+}      /* ↑ */
+/**       ↑
+ * This line */
+```
+
+## Options
+
+`string`: `"always"|"never"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There *must always* be an empty line before rules.
+
+The following patterns are considered warnings:
+
+```css
+@media { a {} }
+```
+
+```css
+@media {
+  a {}
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+@media {
+
+  a {}
+}
+```
+
+### `"never"`
+
+There *must never* be an empty line before rules.
+
+The following patterns are considered warnings:
+
+```css
+@media { a {} }
+```
+
+```css
+@media {
+
+  a {}
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+@media {
+  a {}
+}
+```
+
+### `"always-multi-line"`
+
+There *must always* be an empty line before multi-line rules.
+
+The following patterns are considered warnings:
+
+```css
+@media {
+  a {
+    color: pink;
+    top: 0;
+  }
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+@media {
+
+  a {
+    color: pink;
+    top: 0;
+  }
+}
+```
+
+### `"never-multi-line"`
+
+There *must never* be an empty line before multi-line rules.
+
+The following patterns are considered warnings:
+
+```css
+@media {
+
+  a {
+    color: pink;
+    top: 0;
+  }
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+@media {
+  a {
+    color: pink;
+    top: 0;
+  }
+}
+```
+
+## Optional secondary options
+
+### `except: ["first-nested"]`
+
+Reverse the primary option if the rule is the first in a block.
+
+For example, with `"always"`:
+
+The following patterns are considered warnings:
+
+```css
+@media {
+
+  a {}
+
+  b {}
+
+  c {}
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+@media {
+  a {}
+
+  b {}
+
+  c {}
+}
+```
+
+### `except: ["after-rule"]`
+
+Reverse the primary option if the rule comes after another rule.
+
+For example, with `"always"`:
+
+The following patterns are considered warnings:
+
+```css
+@media {
+  color: red;
+  a {}
+  b {}
+  c {}
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+@media {
+  color: red;
+
+  a {}
+  b {}
+  c {}
+}
+```
+
+### `ignore: ["after-comment"]`
+
+Ignore rules that come after a comment.
+
+The following patterns are *not* considered warnings:
+
+```css
+@media {
+  /* comment */
+  a {}
+}
+```
+
+```css
+@media {
+  /* comment */
+
+  a {}
+}
+```