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:
122
node_modules/stylelint/lib/rules/declaration-block-semicolon-newline-after/README.md
generated
vendored
Normal file
122
node_modules/stylelint/lib/rules/declaration-block-semicolon-newline-after/README.md
generated
vendored
Normal file
@@ -0,0 +1,122 @@
|
||||
# declaration-block-semicolon-newline-after
|
||||
|
||||
Require a newline or disallow whitespace after the semicolons of declaration blocks.
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink;
|
||||
top: 0; ↑
|
||||
} ↑
|
||||
/** ↑
|
||||
* The newline after this semicolon */
|
||||
```
|
||||
|
||||
This rule ignores semicolons that are preceded by Less mixins.
|
||||
|
||||
This rule ignores the last semicolon of declaration blocks. Use the `block-closing-brace-*-before` rules to control the whitespace between the last semicolon and the closing brace instead.
|
||||
|
||||
This rule allows an end-of-line comment followed by a newline. For example,
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink; /* end-of-line comment */
|
||||
top: 0;
|
||||
}
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
`string`: `"always"|"always-multi-line"|"never-multi-line"`
|
||||
|
||||
### `"always"`
|
||||
|
||||
There *must always* be a newline after the semicolon.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a { color: pink; top: 0; }
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink; /* end-of-line comment
|
||||
containing a newline */
|
||||
top: 0;
|
||||
}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink;
|
||||
top: 0;
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink; /* end-of-line comment */
|
||||
top: 0;
|
||||
}
|
||||
```
|
||||
|
||||
### `"always-multi-line"`
|
||||
|
||||
There *must always* be a newline after the semicolon in multi-line rules.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink; top: 0;
|
||||
}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a { color: pink; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { color: pink; top: 0; }
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink;
|
||||
top: 0;
|
||||
}
|
||||
```
|
||||
|
||||
### `"never-multi-line"`
|
||||
|
||||
There *must never* be whitespace after the semicolon in multi-line rules.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink;
|
||||
top: 0;
|
||||
}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a { color: pink; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { color: pink; top: 0; }
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
color: pink
|
||||
; top: 0;
|
||||
}
|
||||
```
|
76
node_modules/stylelint/lib/rules/declaration-block-semicolon-newline-after/index.js
generated
vendored
Normal file
76
node_modules/stylelint/lib/rules/declaration-block-semicolon-newline-after/index.js
generated
vendored
Normal file
@@ -0,0 +1,76 @@
|
||||
"use strict"
|
||||
|
||||
const blockString = require("../../utils/blockString")
|
||||
const nextNonCommentNode = require("../../utils/nextNonCommentNode")
|
||||
const rawNodeString = require("../../utils/rawNodeString")
|
||||
const report = require("../../utils/report")
|
||||
const ruleMessages = require("../../utils/ruleMessages")
|
||||
const validateOptions = require("../../utils/validateOptions")
|
||||
const whitespaceChecker = require("../../utils/whitespaceChecker")
|
||||
|
||||
const ruleName = "declaration-block-semicolon-newline-after"
|
||||
|
||||
const messages = ruleMessages(ruleName, {
|
||||
expectedAfter: () => "Expected newline after \";\"",
|
||||
expectedAfterMultiLine: () => "Expected newline after \";\" in a multi-line declaration block",
|
||||
rejectedAfterMultiLine: () => "Unexpected newline after \";\" in a multi-line declaration block",
|
||||
})
|
||||
|
||||
const rule = function (expectation) {
|
||||
const checker = whitespaceChecker("newline", expectation, messages)
|
||||
|
||||
return (root, result) => {
|
||||
const validOptions = validateOptions(result, ruleName, {
|
||||
actual: expectation,
|
||||
possible: [
|
||||
"always",
|
||||
"always-multi-line",
|
||||
"never-multi-line",
|
||||
],
|
||||
})
|
||||
if (!validOptions) {
|
||||
return
|
||||
}
|
||||
|
||||
root.walkDecls(decl => {
|
||||
// Ignore last declaration if there's no trailing semicolon
|
||||
const parentRule = decl.parent
|
||||
if (
|
||||
!parentRule.raws.semicolon
|
||||
&& parentRule.last === decl
|
||||
) {
|
||||
return
|
||||
}
|
||||
|
||||
const nextNode = decl.next()
|
||||
if (!nextNode) {
|
||||
return
|
||||
}
|
||||
|
||||
// Allow end-of-line comment
|
||||
const nodeToCheck = nextNonCommentNode(nextNode)
|
||||
if (!nodeToCheck) {
|
||||
return
|
||||
}
|
||||
|
||||
checker.afterOneOnly({
|
||||
source: rawNodeString(nodeToCheck),
|
||||
index: -1,
|
||||
lineCheckStr: blockString(parentRule),
|
||||
err: m => {
|
||||
report({
|
||||
message: m,
|
||||
node: decl,
|
||||
index: decl.toString().length + 1,
|
||||
result,
|
||||
ruleName,
|
||||
})
|
||||
},
|
||||
})
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
rule.ruleName = ruleName
|
||||
rule.messages = messages
|
||||
module.exports = rule
|
Reference in New Issue
Block a user