Initial commit

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

@@ -0,0 +1,240 @@
+# declaration-empty-line-before
+
+Require or disallow an empty line before declarations.
+
+```css
+a {
+  --foo: pink;
+             /* ← */
+  top: 15px; /* ↑ */
+}            /* ↑ */
+/**             ↑
+ *      This line */
+```
+
+## Options
+
+`string`: `"always"|"never"`
+
+### `"always"`
+
+The following patterns are considered warnings:
+
+```css
+a {
+  --foo: pink;
+  top: 5px;
+}
+```
+
+```css
+a {
+  bottom: 15px;
+  top: 5px;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  --foo: pink;
+
+  top: 5px;
+}
+```
+
+```css
+a {
+
+  bottom: 15px;
+
+  top: 5px;
+}
+```
+
+### `"never"`
+
+The following patterns are considered warnings:
+
+```css
+a {
+  --foo: pink;
+
+  bottom: 15px;
+}
+```
+
+```css
+a {
+
+  bottom: 15px;
+
+  top: 5px;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  --foo: pink;
+  bottom: 15px;
+}
+```
+
+```css
+a {
+  bottom: 15px;
+  top: 5px;
+}
+```
+
+## Optional secondary options
+
+### `except: ["after-comment", "after-declaration", "first-nested"]`
+
+#### `"after-comment"`
+
+Reverse the primary option for declarations that come after a comment.
+
+For example, with `"always"`:
+
+The following patterns are considered warnings:
+
+```css
+a {
+  /* comment */
+
+  top: 5px;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  /* comment */
+  top: 5px;
+}
+
+```
+
+#### `"after-declaration"`
+
+Reverse the primary option for declarations that come after another declaration.
+
+For example, with `"always"`:
+
+The following patterns are considered warnings:
+
+```css
+a {
+
+  bottom: 15px;
+
+  top: 5px;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+
+  bottom: 15px;
+  top: 5px;
+}
+```
+
+#### `"first-nested"`
+
+Reverse the primary option for declarations that are nested and the first child of their parent node.
+
+For example, with `"always"`:
+
+The following patterns are considered warnings:
+
+```css
+a {
+
+  bottom: 15px;
+
+  top: 5px;
+}
+```
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  bottom: 15px;
+
+  top: 5px;
+}
+```
+
+### `ignore: ["after-comment", "after-declaration", "inside-single-line-block"]`
+
+#### `"after-comment"`
+
+Ignore declarations that are preceded by comments.
+
+For example, with `"always"`:
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+  /* comment */
+  bottom: 15px;
+}
+```
+
+#### `"after-declaration"`
+
+Ignore declarations that are preceded by declarations, to allow for multiple declaration sets in the same block.
+
+For example, with `"always"`:
+
+The following patterns are *not* considered warnings:
+
+```css
+a {
+
+  bottom: 15px;
+  top: 15px;
+}
+```
+
+```css
+a {
+
+  bottom: 15px;
+
+  top: 15px;
+}
+```
+
+```css
+a {
+
+  color: orange;
+  text-decoration: none;
+
+  bottom: 15px;
+  top: 15px;
+}
+```
+
+#### `"inside-single-line-block"`
+
+Ignore declarations that are inside single-line blocks.
+
+For example, with `"always"`:
+
+The following patterns are *not* considered warnings:
+
+```css
+a { bottom: 15px; top: 5px; }
+```