Initial commit

This commit is contained in:
Patrick Marsceill
2017-03-09 13:16:08 -05:00
commit b7b0d0d7bf
4147 changed files with 401224 additions and 0 deletions

View File

@@ -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 {}
}
```

View File

@@ -0,0 +1,65 @@
"use strict"
const isStandardSyntaxRule = require("../../utils/isStandardSyntaxRule")
const ruleMessages = require("../../utils/ruleMessages")
const validateOptions = require("../../utils/validateOptions")
const checkRuleEmptyLineBefore = require("../checkRuleEmptyLineBefore")
const ruleName = "rule-nested-empty-line-before"
const messages = ruleMessages(ruleName, {
expected: "Expected empty line before nested rule",
rejected: "Unexpected empty line before nested rule",
})
const rule = function (expectation, options) {
return (root, result) => {
const validOptions = validateOptions(result, ruleName, {
actual: expectation,
possible: [
"always",
"never",
"always-multi-line",
"never-multi-line",
],
}, {
actual: options,
possible: {
ignore: ["after-comment"],
except: [
"first-nested",
"after-comment",
"after-rule",
],
},
optional: true,
})
if (!validOptions) {
return
}
result.warn((
`'${ruleName}' has been deprecated and in 8.0 will be removed. Instead use 'rule-empty-line-before'.`
), {
stylelintType: "deprecation",
stylelintReference: `https://stylelint.io/user-guide/rules/${ruleName}/`,
})
root.walkRules(rule => {
if (!isStandardSyntaxRule(rule)) {
return
}
// Only attend to nested rule sets
if (rule.parent === root) {
return
}
checkRuleEmptyLineBefore({ rule, expectation, options, result, messages, checkedRuleName: ruleName })
})
}
}
rule.ruleName = ruleName
rule.messages = messages
module.exports = rule