linter-bundle 5.1.0 → 6.1.0

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/at-rule-semicolon-newline-after/README.md

@@ -0,0 +1,63 @@
+# at-rule-semicolon-newline-after
+
+Require a newline after the semicolon of at-rules.
+
+<!-- prettier-ignore -->
+```css
+@import url("x.css");
+@import url("y.css");
+/**                 ↑
+ * The newline after these semicolons */
+```
+
+This rule allows an end-of-line comment followed by a newline. For example:
+
+<!-- prettier-ignore -->
+```css
+@import url("x.css"); /* end-of-line comment */
+
+a {}
+```
+
+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"`
+
+There _must always_ be a newline after the semicolon.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+@import url("x.css"); @import url("y.css");
+```
+
+<!-- prettier-ignore -->
+```css
+@import url("x.css"); a {}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+@import url("x.css");
+@import url("y.css");
+```
+
+<!-- prettier-ignore -->
+```css
+@import url("x.css"); /* end-of-line comment */
+a {}
+```
+
+<!-- prettier-ignore -->
+```css
+@import url("x.css");
+
+a {}
+```

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/at-rule-semicolon-newline-after/index.cjs

@@ -0,0 +1,87 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const stylelint = require('stylelint');
+const hasBlock = require('stylelint/lib/utils/hasBlock.cjs');
+const isStandardSyntaxAtRule = require('stylelint/lib/utils/isStandardSyntaxAtRule.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 nextNonCommentNode = require('../../utils/nextNonCommentNode.cjs');
+const whitespaceChecker = require('../../utils/whitespaceChecker.cjs');
+
+const ruleName = 'plugin/at-rule-semicolon-newline-after';
+
+const messages = ruleMessages(ruleName, {
+	expectedAfter: () => 'Expected newline after ";"'
+});
+
+const meta = {
+	url: 'https://github.com/jens-duttke/linter-bundle/blob/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules/at-rule-semicolon-newline-after/README.md',
+	fixable: true
+};
+
+/** @type {import('stylelint').Rule} */
+const rule = (primary, _secondary, context) => {
+	const checker = whitespaceChecker('newline', primary, messages);
+
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: primary,
+			possible: ['always']
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkAtRules((atRule) => {
+			const nextNode = atRule.next();
+
+			if (!nextNode) {
+				return;
+			}
+
+			if (hasBlock(atRule)) {
+				return;
+			}
+
+			if (!isStandardSyntaxAtRule(atRule)) {
+				return;
+			}
+
+			// Allow an end-of-line comment
+			const nodeToCheck = nextNonCommentNode(nextNode);
+
+			if (!nodeToCheck) {
+				return;
+			}
+
+			checker.afterOneOnly({
+				source: rawNodeString(nodeToCheck),
+				index: -1,
+				err: (message) => {
+					if (context.fix) {
+						nodeToCheck.raws.before = context.newline + nodeToCheck.raws.before;
+					}
+					else {
+						report({
+							message,
+							node: atRule,
+							index: atRule.toString().length + 1,
+							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/at-rule-semicolon-space-before/README.md

@@ -0,0 +1,50 @@
+# at-rule-semicolon-space-before
+
+Require a single space or disallow whitespace before the semicolons of at-rules.
+
+<!-- prettier-ignore -->
+```css
+@import "components/buttons";
+/**                         ↑
+ * The space before this semicolon */
+```
+
+## Options
+
+`string`: `"always"|"never"`
+
+### `"always"`
+
+There _must always_ be a single space before the semicolons.
+
+The following pattern is considered a problem:
+
+<!-- prettier-ignore -->
+```css
+@import "components/buttons";
+```
+
+The following pattern is _not_ considered a problem:
+
+<!-- prettier-ignore -->
+```css
+@import "components/buttons" ;
+```
+
+### `"never"`
+
+There _must never_ be a single space before the semicolons.
+
+The following pattern is considered a problem:
+
+<!-- prettier-ignore -->
+```css
+@import "components/buttons" ;
+```
+
+The following pattern is _not_ considered a problem:
+
+<!-- prettier-ignore -->
+```css
+@import "components/buttons";
+```

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/at-rule-semicolon-space-before/index.cjs

@@ -0,0 +1,70 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const stylelint = require('stylelint');
+const hasBlock = require('stylelint/lib/utils/hasBlock.cjs');
+const isStandardSyntaxAtRule = require('stylelint/lib/utils/isStandardSyntaxAtRule.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 whitespaceChecker = require('../../utils/whitespaceChecker.cjs');
+
+const ruleName = 'plugin/at-rule-semicolon-space-before';
+
+const messages = ruleMessages(ruleName, {
+	expectedBefore: () => 'Expected single space before ";"',
+	rejectedBefore: () => 'Unexpected whitespace before ";"'
+});
+
+const meta = {
+	url: 'https://github.com/jens-duttke/linter-bundle/blob/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules/at-rule-semicolon-space-before/README.md'
+};
+
+/** @type {import('stylelint').Rule} */
+const rule = (primary) => {
+	const checker = whitespaceChecker('space', primary, messages);
+
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: primary,
+			possible: ['always', 'never']
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkAtRules((atRule) => {
+			if (hasBlock(atRule)) {
+				return;
+			}
+
+			if (!isStandardSyntaxAtRule(atRule)) {
+				return;
+			}
+
+			const nodeString = rawNodeString(atRule);
+
+			checker.before({
+				source: nodeString,
+				index: nodeString.length,
+				err: (m) => {
+					report({
+						message: m,
+						node: atRule,
+						index: nodeString.length - 1,
+						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/atRuleNameSpaceChecker.cjs

@@ -0,0 +1,56 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const isStandardSyntaxAtRule = require('stylelint/lib/utils/isStandardSyntaxAtRule.cjs');
+const report = require('stylelint/lib/utils/report.cjs');
+
+/**
+ * @param {{
+ *   root: import('postcss').Root,
+ *   locationChecker: (opts: { source: string, index: number, err: (msg: string) => void, errTarget: string }) => void,
+ *   result: import('stylelint').PostcssResult,
+ *   checkedRuleName: string,
+ *   fix?: ((atRule: import('postcss').AtRule) => void) | null,
+ * }} options
+ */
+module.exports = function atRuleNameSpaceChecker (options) {
+	options.root.walkAtRules((atRule) => {
+		if (!isStandardSyntaxAtRule(atRule)) {
+			return;
+		}
+
+		checkColon(
+			`@${atRule.name}${atRule.raws.afterName || ''}${atRule.params}`,
+			atRule.name.length,
+			atRule
+		);
+	});
+
+	/**
+	 * @param {string} source
+	 * @param {number} index
+	 * @param {import('postcss').AtRule} node
+	 */
+	function checkColon (source, index, node) {
+		options.locationChecker({
+			source,
+			index,
+			err: (m) => {
+				if (options.fix) {
+					options.fix(node);
+
+					return;
+				}
+
+				report({
+					message: m,
+					node,
+					index,
+					result: options.result,
+					ruleName: options.checkedRuleName
+				});
+			},
+			errTarget: `@${node.name}`
+		});
+	}
+};

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

@@ -0,0 +1,238 @@
+# block-closing-brace-empty-line-before
+
+Require or disallow an empty line before the closing brace of blocks.
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+  /* ← */
+} /* ↑ */
+/**  ↑
+ * This line */
+```
+
+The [`fix` option](https://stylelint.io/user-guide/options/#fix) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`string`: `"always-multi-line"|"never"`
+
+### `always-multi-line`
+
+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`
+
+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
+
+### `except: ["after-closing-brace"]`
+
+When a rule is nested, `after-closing-brace` brace will reverse the primary option.
+
+For example, with `"never"` and `except: ["after-closing-brace"]`:
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+  }
+}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@font-face {
+  font-family: "MyFont";
+  src: url("myfont.woff2") format("woff2");
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+  }
+
+}
+```
+
+For example, with `"always-multi-line"` and `except: ["after-closing-brace"]`:
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+
+  }
+
+}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@font-face {
+  font-family: "MyFont";
+  src: url("myfont.woff2") format("woff2");
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+
+  }
+}
+```

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

@@ -0,0 +1,130 @@
+/* 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 hasEmptyLine = require('stylelint/lib/utils/hasEmptyLine.cjs');
+const isSingleLineString = require('stylelint/lib/utils/isSingleLineString.cjs');
+const optionsMatches = require('stylelint/lib/utils/optionsMatches.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 addEmptyLineAfter = require('../../utils/addEmptyLineAfter.cjs');
+const hasEmptyBlock = require('../../utils/hasEmptyBlock.cjs');
+const removeEmptyLinesAfter = require('../../utils/removeEmptyLinesAfter.cjs');
+
+const ruleName = 'plugin/block-closing-brace-empty-line-before';
+
+const messages = ruleMessages(ruleName, {
+	expected: 'Expected empty line before closing brace',
+	rejected: 'Unexpected empty line before closing brace'
+});
+
+const meta = {
+	url: 'https://github.com/jens-duttke/linter-bundle/blob/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules/block-closing-brace-empty-line-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-multi-line', 'never']
+		},
+		{
+			actual: secondaryOptions,
+			possible: {
+				except: ['after-closing-brace']
+			},
+			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) {
+		// Return early if blockless or has empty block
+		if (!hasBlock(statement) || hasEmptyBlock(statement)) {
+			return;
+		}
+
+		// Get whitespace after ""}", ignoring extra semicolon
+		const before = (statement.raws.after || '').replace(/;+/, '');
+
+		// Calculate index
+		const statementString = statement.toString();
+		let index = statementString.length - 1;
+
+		if (statementString[index - 1] === '\r') {
+			index -= 1;
+		}
+
+		// Set expectation
+		const expectEmptyLineBefore = (() => {
+			const childNodeTypes = statement.nodes.map((item) => item.type);
+
+			// Reverse the primary options if `after-closing-brace` is set
+			if (
+				optionsMatches(secondaryOptions, 'except', 'after-closing-brace') &&
+					statement.type === 'atrule' &&
+					!childNodeTypes.includes('decl')
+			) {
+				return primary === 'never';
+			}
+
+			return primary === 'always-multi-line' && !isSingleLineString(blockString(statement));
+		})();
+
+		// Check for at least one empty line
+		const hasEmptyLineBefore = hasEmptyLine(before);
+
+		// Return if the expectation is met
+		if (expectEmptyLineBefore === hasEmptyLineBefore) {
+			return;
+		}
+
+		if (context.fix) {
+			const { newline } = context;
+
+			if (typeof newline !== 'string') { return; }
+
+			if (expectEmptyLineBefore) {
+				addEmptyLineAfter(statement, newline);
+			}
+			else {
+				removeEmptyLinesAfter(statement, newline);
+			}
+
+			return;
+		}
+
+		const message = expectEmptyLineBefore ? messages.expected : messages.rejected;
+
+		report({
+			message,
+			result,
+			ruleName,
+			node: statement,
+			index
+		});
+	}
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+module.exports = stylelint.createPlugin(ruleName, rule);