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,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;
}
```

View 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