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:
121
node_modules/stylelint/lib/rules/function-parentheses-space-inside/README.md
generated
vendored
Normal file
121
node_modules/stylelint/lib/rules/function-parentheses-space-inside/README.md
generated
vendored
Normal file
@@ -0,0 +1,121 @@
|
||||
# function-parentheses-space-inside
|
||||
|
||||
Require a single space or disallow whitespace on the inside of the parentheses of functions.
|
||||
|
||||
```css
|
||||
a { transform: translate( 1, 1 ); }
|
||||
/** ↑ ↑
|
||||
* The space inside these two parentheses */
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
`string`: `"always"|"never"|"always-single-line"|"never-single-line"`
|
||||
|
||||
### `"always"`
|
||||
|
||||
There *must always* be a single space inside the parentheses.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1); }
|
||||
```
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1 ); }
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate( 1, 1 ); }
|
||||
```
|
||||
|
||||
### `"never"`
|
||||
|
||||
There *must never* be whitespace on the inside the parentheses.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate( 1, 1 ); }
|
||||
```
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1 ); }
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1); }
|
||||
```
|
||||
|
||||
### `"always-single-line"`
|
||||
|
||||
There *must always* be a single space inside the parentheses of single-line functions.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1) }
|
||||
```
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1 ) }
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate( 1, 1 ) }
|
||||
```
|
||||
|
||||
```css
|
||||
a { transform: translate(1,
|
||||
1) }
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
transform: translate(
|
||||
1,
|
||||
1
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### `"never-single-line"`
|
||||
|
||||
There *must never* be whitespace inside the parentheses of single-line functions.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate( 1, 1 ) }
|
||||
```
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1 ) }
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a { transform: translate(1, 1) }
|
||||
```
|
||||
|
||||
```css
|
||||
a { transform: translate( 1,
|
||||
1) }
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
transform: translate(
|
||||
1,
|
||||
1
|
||||
)
|
||||
}
|
||||
```
|
112
node_modules/stylelint/lib/rules/function-parentheses-space-inside/index.js
generated
vendored
Normal file
112
node_modules/stylelint/lib/rules/function-parentheses-space-inside/index.js
generated
vendored
Normal file
@@ -0,0 +1,112 @@
|
||||
"use strict"
|
||||
|
||||
const declarationValueIndex = require("../../utils/declarationValueIndex")
|
||||
const isSingleLineString = require("../../utils/isSingleLineString")
|
||||
const isStandardSyntaxFunction = require("../../utils/isStandardSyntaxFunction")
|
||||
const report = require("../../utils/report")
|
||||
const ruleMessages = require("../../utils/ruleMessages")
|
||||
const validateOptions = require("../../utils/validateOptions")
|
||||
const valueParser = require("postcss-value-parser")
|
||||
|
||||
const ruleName = "function-parentheses-space-inside"
|
||||
|
||||
const messages = ruleMessages(ruleName, {
|
||||
expectedOpening: "Expected single space after \"(\"",
|
||||
rejectedOpening: "Unexpected whitespace after \"(\"",
|
||||
expectedClosing: "Expected single space before \")\"",
|
||||
rejectedClosing: "Unexpected whitespace before \")\"",
|
||||
expectedOpeningSingleLine: "Expected single space after \"(\" in a single-line function",
|
||||
rejectedOpeningSingleLine: "Unexpected whitespace after \"(\" in a single-line function",
|
||||
expectedClosingSingleLine: "Expected single space before \")\" in a single-line function",
|
||||
rejectedClosingSingleLine: "Unexpected whitespace before \")\" in a single-line function",
|
||||
})
|
||||
|
||||
const rule = function (expectation) {
|
||||
return (root, result) => {
|
||||
const validOptions = validateOptions(result, ruleName, {
|
||||
actual: expectation,
|
||||
possible: [
|
||||
"always",
|
||||
"never",
|
||||
"always-single-line",
|
||||
"never-single-line",
|
||||
],
|
||||
})
|
||||
if (!validOptions) {
|
||||
return
|
||||
}
|
||||
|
||||
root.walkDecls(decl => {
|
||||
if (decl.value.indexOf("(") === -1) {
|
||||
return
|
||||
}
|
||||
|
||||
valueParser(decl.value).walk(valueNode => {
|
||||
if (valueNode.type !== "function") {
|
||||
return
|
||||
}
|
||||
|
||||
if (!isStandardSyntaxFunction(valueNode)) {
|
||||
return
|
||||
}
|
||||
|
||||
const functionString = valueParser.stringify(valueNode)
|
||||
const isSingleLine = isSingleLineString(functionString)
|
||||
|
||||
// Check opening ...
|
||||
|
||||
const openingIndex = valueNode.sourceIndex + valueNode.value.length + 1
|
||||
|
||||
if (expectation === "always" && valueNode.before !== " ") {
|
||||
complain(messages.expectedOpening, openingIndex)
|
||||
}
|
||||
|
||||
if (expectation === "never" && valueNode.before !== "") {
|
||||
complain(messages.rejectedOpening, openingIndex)
|
||||
}
|
||||
|
||||
if (isSingleLine && expectation === "always-single-line" && valueNode.before !== " ") {
|
||||
complain(messages.expectedOpeningSingleLine, openingIndex)
|
||||
}
|
||||
|
||||
if (isSingleLine && expectation === "never-single-line" && valueNode.before !== "") {
|
||||
complain(messages.rejectedOpeningSingleLine, openingIndex)
|
||||
}
|
||||
|
||||
// Check closing ...
|
||||
|
||||
const closingIndex = valueNode.sourceIndex + functionString.length - 2
|
||||
|
||||
if (expectation === "always" && valueNode.after !== " ") {
|
||||
complain(messages.expectedClosing, closingIndex)
|
||||
}
|
||||
|
||||
if (expectation === "never" && valueNode.after !== "") {
|
||||
complain(messages.rejectedClosing, closingIndex)
|
||||
}
|
||||
|
||||
if (isSingleLine && expectation === "always-single-line" && valueNode.after !== " ") {
|
||||
complain(messages.expectedClosingSingleLine, closingIndex)
|
||||
}
|
||||
|
||||
if (isSingleLine && expectation === "never-single-line" && valueNode.after !== "") {
|
||||
complain(messages.rejectedClosingSingleLine, closingIndex)
|
||||
}
|
||||
})
|
||||
|
||||
function complain(message, offset) {
|
||||
report({
|
||||
ruleName,
|
||||
result,
|
||||
message,
|
||||
node: decl,
|
||||
index: declarationValueIndex(decl) + offset,
|
||||
})
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
rule.ruleName = ruleName
|
||||
rule.messages = messages
|
||||
module.exports = rule
|
Reference in New Issue
Block a user