mirror of
https://github.com/snachodog/just-the-docs.git
synced 2025-09-13 21:33:32 -06:00
Initial commit
This commit is contained in:
159
node_modules/stylelint/lib/rules/rule-non-nested-empty-line-before/README.md
generated
vendored
Normal file
159
node_modules/stylelint/lib/rules/rule-non-nested-empty-line-before/README.md
generated
vendored
Normal file
@@ -0,0 +1,159 @@
|
||||
# rule-non-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 non-nested rules.
|
||||
|
||||
```css
|
||||
a {}
|
||||
/* ← */
|
||||
b {} /* ↑ */
|
||||
/** ↑
|
||||
* This line */
|
||||
```
|
||||
|
||||
If the rule is the very first node in a stylesheet then it is ignored.
|
||||
|
||||
## 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
|
||||
a {} b {}
|
||||
```
|
||||
|
||||
```css
|
||||
a {}
|
||||
b {}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a {}
|
||||
|
||||
b {}
|
||||
```
|
||||
|
||||
### `"never"`
|
||||
|
||||
There *must never* be an empty line before rules.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a {}
|
||||
|
||||
b {}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a {} b {}
|
||||
```
|
||||
|
||||
```css
|
||||
a {}
|
||||
b {}
|
||||
```
|
||||
|
||||
### `"always-multi-line"`
|
||||
|
||||
There *must always* be an empty line before multi-line rules.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a
|
||||
{}
|
||||
b
|
||||
{}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a
|
||||
{}
|
||||
|
||||
b
|
||||
{}
|
||||
```
|
||||
|
||||
### `"never-multi-line"`
|
||||
|
||||
There *must never* be an empty line before multi-line rules.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a
|
||||
{}
|
||||
|
||||
b
|
||||
{}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a
|
||||
{}
|
||||
b
|
||||
{}
|
||||
```
|
||||
|
||||
## Optional secondary options
|
||||
|
||||
### `ignore: ["after-comment"]`
|
||||
|
||||
Ignore rules that come after a comment.
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a
|
||||
{}
|
||||
/* comment */
|
||||
b
|
||||
{}
|
||||
```
|
||||
|
||||
```css
|
||||
a
|
||||
{}
|
||||
/* comment */
|
||||
|
||||
b
|
||||
{}
|
||||
```
|
||||
|
||||
## Optional secondary options
|
||||
|
||||
### `except: ["after-single-line-comment"]`
|
||||
|
||||
For example, with `"always"`:
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
/* comment */
|
||||
|
||||
a
|
||||
{}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
/* comment */
|
||||
a
|
||||
{}
|
||||
```
|
66
node_modules/stylelint/lib/rules/rule-non-nested-empty-line-before/index.js
generated
vendored
Normal file
66
node_modules/stylelint/lib/rules/rule-non-nested-empty-line-before/index.js
generated
vendored
Normal file
@@ -0,0 +1,66 @@
|
||||
"use strict"
|
||||
|
||||
const isStandardSyntaxRule = require("../../utils/isStandardSyntaxRule")
|
||||
const ruleMessages = require("../../utils/ruleMessages")
|
||||
const validateOptions = require("../../utils/validateOptions")
|
||||
const checkRuleEmptyLineBefore = require("../checkRuleEmptyLineBefore")
|
||||
|
||||
const ruleName = "rule-non-nested-empty-line-before"
|
||||
|
||||
const messages = ruleMessages(ruleName, {
|
||||
expected: "Expected empty line before non-nested rule",
|
||||
rejected: "Unexpected empty line before non-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: ["after-single-line-comment"],
|
||||
},
|
||||
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
|
||||
}
|
||||
|
||||
// Ignore nested rule sets
|
||||
if (rule.parent !== root) {
|
||||
return
|
||||
}
|
||||
|
||||
// Ignore the first node
|
||||
if (rule === root.first) {
|
||||
return
|
||||
}
|
||||
|
||||
checkRuleEmptyLineBefore({ rule, expectation, options, result, messages, checkedRuleName: ruleName })
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
rule.ruleName = ruleName
|
||||
rule.messages = messages
|
||||
module.exports = rule
|
Reference in New Issue
Block a user