linter-bundle 5.1.0 → 6.1.0

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/block-closing-brace-newline-after/README.md

@@ -0,0 +1,196 @@
+# block-closing-brace-newline-after
+
+Require a newline or disallow whitespace after the closing brace of blocks.
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+a { color: red; }↑
+/**              ↑
+ * The newline after this brace */
+```
+
+This rule allows an end-of-line comment separated from the closing brace by spaces, as long as the comment contains no newlines. For example,
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+} /* end-of-line comment */
+```
+
+This rule allows a trailing semicolon after the closing brace of a block. For example,
+
+<!-- prettier-ignore -->
+```css
+:root {
+  --toolbar-theme: {
+    background-color: hsl(120, 70%, 95%);
+  };
+/* ↑
+ * This semicolon */
+}
+```
+
+The [`fix` option](https://stylelint.io/user-guide/options/#fix) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`string`: `"always"|"always-single-line"|"never-single-line"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There _must always_ be a newline after the closing brace.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+b { color: red; }
+```
+
+### `"always-single-line"`
+
+There _must always_ be a newline after the closing brace in single-line blocks.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; } b { color: red; }
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+b { color: red; }
+```
+
+### `"never-single-line"`
+
+There _must never_ be whitespace after the closing brace in single-line blocks.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; } b { color: red; }
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+### `"always-multi-line"`
+
+There _must always_ be a newline after the closing brace in multi-line blocks.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}b { color: red; }
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}
+b { color: red; }
+```
+
+### `"never-multi-line"`
+
+There _must never_ be whitespace after the closing brace in multi-line blocks.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; } b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}b { color: red; }
+```
+
+## Optional secondary options
+
+### `ignoreAtRules: ["/regex/", "non-regex"]`
+
+Ignore specified at-rules.
+
+For example, with `"always"` or `"always-multi-line"`.
+
+Given:
+
+```json
+["if", "else"]
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+@if ($var) {
+  color: pink;
+} @else if ($var2) {
+  color: red;
+} @else {
+  color: blue;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@if ($var) { color: pink; } @else { color: blue; }
+```

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/block-closing-brace-newline-after/index.cjs

@@ -0,0 +1,154 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const stylelint = require('stylelint');
+const blockString = require('stylelint/lib/utils/blockString.cjs');
+const hasBlock = require('stylelint/lib/utils/hasBlock.cjs');
+const optionsMatches = require('stylelint/lib/utils/optionsMatches.cjs');
+const rawNodeString = require('stylelint/lib/utils/rawNodeString.cjs');
+const report = require('stylelint/lib/utils/report.cjs');
+const ruleMessages = require('stylelint/lib/utils/ruleMessages.cjs');
+const validateOptions = require('stylelint/lib/utils/validateOptions.cjs');
+const { isString } = require('stylelint/lib/utils/validateTypes.cjs');
+
+const whitespaceChecker = require('../../utils/whitespaceChecker.cjs');
+
+const ruleName = 'plugin/block-closing-brace-newline-after';
+
+const messages = ruleMessages(ruleName, {
+	expectedAfter: () => 'Expected newline after "}"',
+	expectedAfterSingleLine: () => 'Expected newline after "}" of a single-line block',
+	rejectedAfterSingleLine: () => 'Unexpected whitespace after "}" of a single-line block',
+	expectedAfterMultiLine: () => 'Expected newline after "}" of a multi-line block',
+	rejectedAfterMultiLine: () => 'Unexpected whitespace after "}" of a multi-line block'
+});
+
+const meta = {
+	url: 'https://github.com/jens-duttke/linter-bundle/blob/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules/block-closing-brace-newline-after/README.md',
+	fixable: true
+};
+
+/** @type {import('stylelint').Rule} */
+const rule = (primary, secondaryOptions, context) => {
+	const checker = whitespaceChecker('newline', primary, messages);
+
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: primary,
+				possible: [
+					'always',
+					'always-single-line',
+					'never-single-line',
+					'always-multi-line',
+					'never-multi-line'
+				]
+			},
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignoreAtRules: [isString]
+				},
+				optional: true
+			}
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		// Check both kinds of statements: rules and at-rules
+		root.walkRules(check);
+		root.walkAtRules(check);
+
+		/**
+		 * @param {import('postcss').Rule | import('postcss').AtRule} statement
+		 */
+		function check (statement) {
+			if (!hasBlock(statement)) {
+				return;
+			}
+
+			if (
+				statement.type === 'atrule' &&
+				optionsMatches(secondaryOptions, 'ignoreAtRules', statement.name)
+			) {
+				return;
+			}
+
+			const nextNode = statement.next();
+
+			if (!nextNode) {
+				return;
+			}
+
+			// Allow an end-of-line comment x spaces after the brace
+			const nextNodeIsSingleLineComment =
+				nextNode.type === 'comment' &&
+				!(/[^ ]/).test(nextNode.raws.before || '') &&
+				!nextNode.toString().includes('\n');
+
+			const nodeToCheck = nextNodeIsSingleLineComment ? nextNode.next() : nextNode;
+
+			if (!nodeToCheck) {
+				return;
+			}
+
+			let reportIndex = statement.toString().length;
+			let source = rawNodeString(nodeToCheck);
+
+			// Skip a semicolon at the beginning, if any
+			if (source?.startsWith(';')) {
+				source = source.slice(1);
+				reportIndex++;
+			}
+
+			// Only check one after, because there might be other
+			// spaces handled by the indentation rule
+			checker.afterOneOnly({
+				source,
+				index: -1,
+				lineCheckStr: blockString(statement),
+				err: (message) => {
+					if (context.fix) {
+						const nodeToCheckRaws = nodeToCheck.raws;
+
+						if (typeof nodeToCheckRaws.before !== 'string') { return; }
+
+						if (primary.startsWith('always')) {
+							const index = nodeToCheckRaws.before.search(/\r?\n/);
+
+							nodeToCheckRaws.before =
+								index >= 0 ?
+									nodeToCheckRaws.before.slice(index)
+									: context.newline + nodeToCheckRaws.before;
+
+							return;
+						}
+
+						if (primary.startsWith('never')) {
+							nodeToCheckRaws.before = '';
+
+							return;
+						}
+					}
+
+					report({
+						message,
+						node: statement,
+						index: reportIndex,
+						result,
+						ruleName
+					});
+				}
+			});
+		}
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+module.exports = stylelint.createPlugin(ruleName, rule);

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/block-closing-brace-newline-before/README.md

@@ -0,0 +1,93 @@
+# block-closing-brace-newline-before
+
+Require a newline or disallow whitespace before the closing brace of blocks.
+
+<!-- prettier-ignore -->
+```css
+    a { color: pink;
+    }
+/** ↑
+ * The newline before this brace */
+```
+
+The [`fix` option](https://stylelint.io/user-guide/options/#fix) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`string`: `"always"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There _must always_ be a newline before the closing brace.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+color: pink;
+}
+```
+
+### `"always-multi-line"`
+
+There _must always_ be a newline before the closing brace in multi-line blocks.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a {
+color: pink;}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}
+```
+
+### `"never-multi-line"`
+
+There _must never_ be whitespace before the closing brace in multi-line blocks.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a {
+color: pink; }
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+color: pink;}
+```

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/block-closing-brace-newline-before/index.cjs

@@ -0,0 +1,133 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const stylelint = require('stylelint');
+const blockString = require('stylelint/lib/utils/blockString.cjs');
+const hasBlock = require('stylelint/lib/utils/hasBlock.cjs');
+const isSingleLineString = require('stylelint/lib/utils/isSingleLineString.cjs');
+const report = require('stylelint/lib/utils/report.cjs');
+const ruleMessages = require('stylelint/lib/utils/ruleMessages.cjs');
+const validateOptions = require('stylelint/lib/utils/validateOptions.cjs');
+
+const hasEmptyBlock = require('../../utils/hasEmptyBlock.cjs');
+
+const ruleName = 'plugin/block-closing-brace-newline-before';
+
+const messages = ruleMessages(ruleName, {
+	expectedBefore: 'Expected newline before "}"',
+	expectedBeforeMultiLine: 'Expected newline before "}" of a multi-line block',
+	rejectedBeforeMultiLine: 'Unexpected whitespace before "}" of a multi-line block'
+});
+
+const meta = {
+	url: 'https://github.com/jens-duttke/linter-bundle/blob/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules/block-closing-brace-newline-before/README.md',
+	fixable: true
+};
+
+/** @type {import('stylelint').Rule} */
+const rule = (primary, _secondaryOptions, context) => (root, result) => {
+	const validOptions = validateOptions(result, ruleName, {
+		actual: primary,
+		possible: ['always', 'always-multi-line', 'never-multi-line']
+	});
+
+	if (!validOptions) {
+		return;
+	}
+
+	// Check both kinds of statements: rules and at-rules
+	root.walkRules(check);
+	root.walkAtRules(check);
+
+	/**
+	 * @param {import('postcss').Rule | import('postcss').AtRule} statement
+	 */
+	function check (statement) {
+		// Return early if blockless or has empty block
+		if (!hasBlock(statement) || hasEmptyBlock(statement)) {
+			return;
+		}
+
+		// Ignore extra semicolon
+		const after = (statement.raws.after || '').replace(/;+/, '');
+
+		if (after === undefined) {
+			return;
+		}
+
+		const blockIsMultiLine = !isSingleLineString(blockString(statement));
+		const statementString = statement.toString();
+
+		let index = statementString.length - 2;
+
+		if (statementString[index - 1] === '\r') {
+			index -= 1;
+		}
+
+		// We're really just checking whether a
+		// newline *starts* the block's final space -- between
+		// the last declaration and the closing brace. We can
+		// ignore any other whitespace between them, because that
+		// will be checked by the indentation rule.
+		if (!after.startsWith('\n') && !after.startsWith('\r\n')) {
+			if (primary === 'always') {
+				complain(messages.expectedBefore);
+			}
+			else if (blockIsMultiLine && primary === 'always-multi-line') {
+				complain(messages.expectedBeforeMultiLine);
+			}
+		}
+
+		if (after !== '' && blockIsMultiLine && primary === 'never-multi-line') {
+			complain(messages.rejectedBeforeMultiLine);
+		}
+
+		/**
+		 * @param {string} message
+		 */
+		function complain (message) {
+			if (context.fix) {
+				const statementRaws = statement.raws;
+
+				if (typeof statementRaws.after !== 'string') { return; }
+
+				if (primary.startsWith('always')) {
+					const firstWhitespaceIndex = statementRaws.after.search(/\s/);
+					const newlineBefore =
+							firstWhitespaceIndex >= 0 ?
+								statementRaws.after.slice(0, firstWhitespaceIndex)
+								: statementRaws.after;
+					const newlineAfter =
+							firstWhitespaceIndex >= 0 ? statementRaws.after.slice(firstWhitespaceIndex) : '';
+					const newlineIndex = newlineAfter.search(/\r?\n/);
+
+					statementRaws.after =
+							newlineIndex >= 0 ?
+								newlineBefore + newlineAfter.slice(newlineIndex)
+								: newlineBefore + context.newline + newlineAfter;
+
+					return;
+				}
+
+				if (primary === 'never-multi-line') {
+					statementRaws.after = statementRaws.after.replace(/\s/g, '');
+
+					return;
+				}
+			}
+
+			report({
+				message,
+				result,
+				ruleName,
+				node: statement,
+				index
+			});
+		}
+	}
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+module.exports = stylelint.createPlugin(ruleName, rule);