linter-bundle 5.1.0 → 6.1.0

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

@@ -0,0 +1,174 @@
+# block-closing-brace-space-before
+
+Require a single space or disallow whitespace before the closing brace of blocks.
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+/**              ↑
+ * The space 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"|"never"|"always-single-line"|"never-single-line"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There _must always_ be a single space before the closing brace.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;}
+```
+
+<!-- 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"`
+
+There _must never_ be whitespace before the closing brace.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+```
+
+<!-- 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-single-line"`
+
+There _must always_ be a single space before the closing brace in single-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-single-line"`
+
+There _must never_ be whitespace before the closing brace in single-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; }
+```
+
+### `"always-multi-line"`
+
+There _must always_ be a single space 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-space-before/index.cjs

@@ -0,0 +1,111 @@
+/* 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 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 whitespaceChecker = require('../../utils/whitespaceChecker.cjs');
+
+const ruleName = 'plugin/block-closing-brace-space-before';
+
+const messages = ruleMessages(ruleName, {
+	expectedBefore: () => 'Expected single space before "}"',
+	rejectedBefore: () => 'Unexpected whitespace before "}"',
+	expectedBeforeSingleLine: () => 'Expected single space before "}" of a single-line block',
+	rejectedBeforeSingleLine: () => 'Unexpected whitespace before "}" of a single-line block',
+	expectedBeforeMultiLine: () => 'Expected single space 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-space-before/README.md',
+	fixable: true
+};
+
+/** @type {import('stylelint').Rule} */
+const rule = (primary, _secondaryOptions, context) => {
+	const checker = whitespaceChecker('space', primary, messages);
+
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: primary,
+			possible: [
+				'always',
+				'never',
+				'always-single-line',
+				'never-single-line',
+				'always-multi-line',
+				'never-multi-line'
+			]
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		// Check both kinds of statement: 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;
+			}
+
+			const source = blockString(statement);
+			const statementString = statement.toString();
+
+			let index = statementString.length - 2;
+
+			if (statementString[index - 1] === '\r') {
+				index -= 1;
+			}
+
+			checker.before({
+				source,
+				index: source.length - 1,
+				err: (message) => {
+					if (context.fix) {
+						const statementRaws = statement.raws;
+
+						if (typeof statementRaws.after !== 'string') { return; }
+
+						if (primary.startsWith('always')) {
+							statementRaws.after = statementRaws.after.replace(/\s*$/, ' ');
+
+							return;
+						}
+
+						if (primary.startsWith('never')) {
+							statementRaws.after = statementRaws.after.replace(/\s*$/, '');
+
+							return;
+						}
+					}
+
+					report({
+						message,
+						node: statement,
+						index,
+						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-opening-brace-newline-after/README.md

@@ -0,0 +1,138 @@
+# block-opening-brace-newline-after
+
+Require a newline after the opening brace of blocks.
+
+<!-- prettier-ignore -->
+```css
+  a {
+    ↑ color: pink; }
+/** ↑
+ * The newline after this brace */
+```
+
+This rule allows an end-of-line comment followed by a newline. For example,
+
+<!-- prettier-ignore -->
+```css
+a { /* end-of-line comment */
+  color: pink;
+}
+```
+
+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 after the opening brace.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a{ color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a{ color: pink;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a{ /* end-of-line comment
+  with a newline */
+  color: pink;
+}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a {
+color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a
+{
+color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { /* end-of-line comment */
+  color: pink;
+}
+```
+
+### `"always-multi-line"`
+
+There _must always_ be a newline after the opening 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 after the opening 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;
+}
+```
+
+## Optional secondary options
+
+### `ignore: ["rules"]`
+
+Ignore the opening brace of rules.
+
+For example, with `"always"`:
+
+The following pattern is _not_ considered a problem:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+```

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

@@ -0,0 +1,184 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const stylelint = require('stylelint');
+const beforeBlockString = require('stylelint/lib/utils/beforeBlockString.cjs');
+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 hasEmptyBlock = require('../../utils/hasEmptyBlock.cjs');
+const whitespaceChecker = require('../../utils/whitespaceChecker.cjs');
+
+const ruleName = 'plugin/block-opening-brace-newline-after';
+
+const messages = ruleMessages(ruleName, {
+	expectedAfter: () => 'Expected newline after "{"',
+	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-opening-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', 'rules', 'always-multi-line', 'never-multi-line']
+			},
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignore: ['rules']
+				},
+				optional: true
+			}
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		// Check both kinds of statement: rules and at-rules
+		if (!optionsMatches(secondaryOptions, 'ignore', 'rules')) {
+			root.walkRules(check);
+		}
+
+		root.walkAtRules(check);
+
+		/**
+		 * @param {import('postcss').Rule | import('postcss').AtRule} statement
+		 */
+		function check (statement) {
+			// Return early if blockless or has an empty block
+			if (!hasBlock(statement) || hasEmptyBlock(statement)) {
+				return;
+			}
+
+			const backupCommentNextBefores = new Map();
+
+			/**
+			 * next node with checking newlines after comment
+			 *
+			 * @param {import('postcss').ChildNode | undefined} startNode
+			 * @returns {import('postcss').ChildNode | undefined}
+			 */
+			function nextNode (startNode) {
+				if (!startNode?.next) { return; }
+
+				if (startNode.type === 'comment') {
+					const reNewLine = /\r?\n/;
+					const newLineMatch = reNewLine.test(startNode.raws.before || '');
+
+					const next = startNode.next();
+
+					if (next && newLineMatch && !reNewLine.test(next.raws.before || '')) {
+						backupCommentNextBefores.set(next, next.raws.before);
+						next.raws.before = startNode.raws.before;
+					}
+
+					return nextNode(next);
+				}
+
+				return startNode;
+			}
+
+			// Allow an end-of-line comment
+			const nodeToCheck = nextNode(statement.first);
+
+			if (!nodeToCheck) {
+				return;
+			}
+
+			checker.afterOneOnly({
+				source: rawNodeString(nodeToCheck),
+				index: -1,
+				lineCheckStr: blockString(statement),
+				err: (m) => {
+					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;
+
+							backupCommentNextBefores.delete(nodeToCheck);
+
+							return;
+						}
+
+						if (primary === 'never-multi-line') {
+							// Restore the `before` of the node next to the comment node.
+							for (const [node, before] of backupCommentNextBefores.entries()) {
+								node.raws.before = before;
+							}
+
+							backupCommentNextBefores.clear();
+
+							// Fix
+							const reNewLine = /\r?\n/;
+							let fixTarget = statement.first;
+
+							while (fixTarget) {
+								const fixTargetRaws = fixTarget.raws;
+
+								if (typeof fixTargetRaws.before !== 'string') { continue; }
+
+								if (reNewLine.test(fixTargetRaws.before || '')) {
+									fixTargetRaws.before = fixTargetRaws.before.replace(/\r?\n/g, '');
+								}
+
+								if (fixTarget.type !== 'comment') {
+									break;
+								}
+
+								fixTarget = fixTarget.next();
+							}
+
+							nodeToCheckRaws.before = '';
+
+							return;
+						}
+					}
+
+					report({
+						message: m,
+						node: statement,
+						index: beforeBlockString(statement, { noRawBefore: true }).length + 1,
+						result,
+						ruleName
+					});
+				}
+			});
+
+			// Restore the `before` of the node next to the comment node.
+			for (const [node, before] of backupCommentNextBefores.entries()) {
+				node.raws.before = before;
+			}
+		}
+	};
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+module.exports = stylelint.createPlugin(ruleName, rule);