linter-bundle 5.1.0 → 6.1.0

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/string-quotes/README.md

@@ -0,0 +1,130 @@
+# string-quotes
+
+Specify single or double quotes around strings.
+
+<!-- prettier-ignore -->
+```css
+a[id="foo"] { content: "x"; }
+/**  ↑   ↑             ↑ ↑
+ * These quotes and these quotes */
+```
+
+Quotes within comments are ignored.
+
+<!-- prettier-ignore -->
+```css
+/* "This is fine" */
+/* 'And this is also fine' */
+```
+
+Single quotes in a charset @-rule are ignored as using single quotes in this context is incorrect according the [CSS specification](https://www.w3.org/TR/CSS2/syndata.html#x57).
+
+<!-- prettier-ignore -->
+```css
+@charset "utf-8"
+/* fine regardless of configuration */
+```
+
+The [`fix` option](https://stylelint.io/user-guide/options/#fix) can automatically fix most of the problems reported by this rule.
+
+## Options
+
+`string`: `"single"|"double"`
+
+### `"single"`
+
+Strings _must always_ be wrapped with single quotes.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { content: "x"; }
+```
+
+<!-- prettier-ignore -->
+```css
+a[id="foo"] {}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { content: 'x'; }
+```
+
+<!-- prettier-ignore -->
+```css
+a[id='foo'] {}
+```
+
+<!-- prettier-ignore -->
+```css
+a { content: "x'y'z"; }
+```
+
+### `"double"`
+
+Strings _must always_ be wrapped with double quotes.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { content: 'x'; }
+```
+
+<!-- prettier-ignore -->
+```css
+a[id='foo'] {}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { content: "x"; }
+```
+
+<!-- prettier-ignore -->
+```css
+a[id="foo"] {}
+```
+
+<!-- prettier-ignore -->
+```css
+a { content: 'x"y"z'; }
+```
+
+## Optional secondary options
+
+### `avoidEscape`: `true|false`, defaults to `true`
+
+Allows strings to use single-quotes or double-quotes so long as the string contains a quote that would have to be escaped otherwise.
+
+For example, with `"single", { "avoidEscape" : false }`.
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { content: "x'y'z"; }
+```
+
+<!-- prettier-ignore -->
+```css
+a[id="foo'bar'baz"] {}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { content: 'x'; }
+```
+
+<!-- prettier-ignore -->
+```css
+a[id='foo'] {}
+```

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/string-quotes/index.cjs

@@ -0,0 +1,256 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const valueParser = require('postcss-value-parser');
+const stylelint = require('stylelint');
+const atRuleParamIndex = require('stylelint/lib/utils/atRuleParamIndex.cjs');
+const declarationValueIndex = require('stylelint/lib/utils/declarationValueIndex.cjs');
+const isStandardSyntaxRule = require('stylelint/lib/utils/isStandardSyntaxRule.cjs');
+const parseSelector = require('stylelint/lib/utils/parseSelector.cjs');
+const report = require('stylelint/lib/utils/report.cjs');
+const ruleMessages = require('stylelint/lib/utils/ruleMessages.cjs');
+const { isAtRule } = require('stylelint/lib/utils/typeGuards.cjs');
+const validateOptions = require('stylelint/lib/utils/validateOptions.cjs');
+const { isBoolean, assertString } = require('stylelint/lib/utils/validateTypes.cjs');
+
+const ruleName = 'plugin/string-quotes';
+
+const messages = ruleMessages(ruleName, {
+	expected: (q) => `Expected ${q} quotes`
+});
+
+const meta = {
+	url: 'https://github.com/jens-duttke/linter-bundle/blob/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules/string-quotes/README.md',
+	fixable: true
+};
+
+const singleQuote = '\'';
+const doubleQuote = '"';
+
+/** @type {import('stylelint').Rule} */
+const rule = (primary, secondaryOptions, context) => {
+	const correctQuote = primary === 'single' ? singleQuote : doubleQuote;
+	const erroneousQuote = primary === 'single' ? doubleQuote : singleQuote;
+
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: primary,
+				possible: ['single', 'double']
+			},
+			{
+				actual: secondaryOptions,
+				possible: {
+					avoidEscape: [isBoolean]
+				},
+				optional: true
+			}
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		const avoidEscape =
+			secondaryOptions && secondaryOptions.avoidEscape !== undefined ?
+				secondaryOptions.avoidEscape
+				: true;
+
+		root.walk((node) => {
+			switch (node.type) {
+				case 'atrule':
+					checkDeclOrAtRule(node, node.params, atRuleParamIndex);
+					break;
+				case 'decl':
+					checkDeclOrAtRule(node, node.value, declarationValueIndex);
+					break;
+				case 'rule':
+					checkRule(node);
+					break;
+			}
+		});
+
+		/**
+		 * @param {import('postcss').Rule} ruleNode
+		 * @returns {void}
+		 */
+		function checkRule (ruleNode) {
+			if (!isStandardSyntaxRule(ruleNode)) {
+				return;
+			}
+
+			if (!ruleNode.selector.includes('[') || !ruleNode.selector.includes('=')) {
+				return;
+			}
+
+			/** @type {number[]} */
+			const fixPositions = [];
+
+			parseSelector(ruleNode.selector, result, ruleNode, (selectorTree) => {
+				let selectorFixed = false;
+
+				selectorTree.walkAttributes((attributeNode) => {
+					if (!attributeNode.quoted) {
+						return;
+					}
+
+					if (attributeNode.quoteMark === correctQuote && avoidEscape) {
+						assertString(attributeNode.value);
+						const needsCorrectEscape = attributeNode.value.includes(correctQuote);
+						const needsOtherEscape = attributeNode.value.includes(erroneousQuote);
+
+						if (needsOtherEscape) {
+							return;
+						}
+
+						if (needsCorrectEscape) {
+							if (context.fix) {
+								selectorFixed = true;
+								attributeNode.quoteMark = erroneousQuote;
+							}
+							else {
+								report({
+									message: messages.expected(primary === 'single' ? 'double' : primary),
+									node: ruleNode,
+									index: attributeNode.sourceIndex + attributeNode.offsetOf('value'),
+									result,
+									ruleName
+								});
+							}
+						}
+					}
+
+					if (attributeNode.quoteMark === erroneousQuote) {
+						if (avoidEscape) {
+							assertString(attributeNode.value);
+							const needsCorrectEscape = attributeNode.value.includes(correctQuote);
+							const needsOtherEscape = attributeNode.value.includes(erroneousQuote);
+
+							if (needsOtherEscape) {
+								if (context.fix) {
+									selectorFixed = true;
+									attributeNode.quoteMark = correctQuote;
+								}
+								else {
+									report({
+										message: messages.expected(primary),
+										node: ruleNode,
+										index: attributeNode.sourceIndex + attributeNode.offsetOf('value'),
+										result,
+										ruleName
+									});
+								}
+
+								return;
+							}
+
+							if (needsCorrectEscape) {
+								return;
+							}
+						}
+
+						if (context.fix) {
+							selectorFixed = true;
+							attributeNode.quoteMark = correctQuote;
+						}
+						else {
+							report({
+								message: messages.expected(primary),
+								node: ruleNode,
+								index: attributeNode.sourceIndex + attributeNode.offsetOf('value'),
+								result,
+								ruleName
+							});
+						}
+					}
+				});
+
+				if (selectorFixed) {
+					ruleNode.selector = selectorTree.toString();
+				}
+			});
+
+			for (const fixIndex of fixPositions) {
+				ruleNode.selector = replaceQuote(ruleNode.selector, fixIndex, correctQuote);
+			}
+		}
+
+		/**
+		 * @template {import('postcss').AtRule | import('postcss').Declaration} T
+		 * @param {T} node
+		 * @param {string} value
+		 * @param {(node: T) => number} getIndex
+		 * @returns {void}
+		 */
+		function checkDeclOrAtRule (node, value, getIndex) {
+			/** @type {number[]} */
+			const fixPositions = [];
+
+			// Get out quickly if there are no erroneous quotes
+			if (!value.includes(erroneousQuote)) {
+				return;
+			}
+
+			if (isAtRule(node) && node.name === 'charset') {
+				// allow @charset rules to have double quotes, in spite of the configuration
+				// TODO: @charset should always use double-quotes, see https://github.com/stylelint/stylelint/issues/2788
+				return;
+			}
+
+			valueParser(value).walk((valueNode) => {
+				if (valueNode.type === 'string' && valueNode.quote === erroneousQuote) {
+					const needsEscape = valueNode.value.includes(correctQuote);
+
+					if (avoidEscape && needsEscape) {
+						// don't consider this an error
+						return;
+					}
+
+					const openIndex = valueNode.sourceIndex;
+
+					// we currently don't fix escapes
+					if (context.fix && !needsEscape) {
+						const closeIndex = openIndex + valueNode.value.length + erroneousQuote.length;
+
+						fixPositions.push(openIndex, closeIndex);
+					}
+					else {
+						report({
+							message: messages.expected(primary),
+							node,
+							index: getIndex(node) + openIndex,
+							result,
+							ruleName
+						});
+					}
+				}
+			});
+
+			for (const fixIndex of fixPositions) {
+				if (isAtRule(node)) {
+					node.params = replaceQuote(node.params, fixIndex, correctQuote);
+				}
+				else {
+					node.value = replaceQuote(node.value, fixIndex, correctQuote);
+				}
+			}
+		}
+	};
+};
+
+/**
+ * @param {string} string
+ * @param {number} index
+ * @param {string} replace
+ * @returns {string}
+ */
+function replaceQuote (string, index, replace) {
+	return string.substring(0, index) + replace + string.substring(index + replace.length);
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+module.exports = stylelint.createPlugin(ruleName, rule);

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/unicode-bom/README.md

@@ -0,0 +1,41 @@
+# unicode-bom
+
+Require or disallow the Unicode Byte Order Mark.
+
+## Options
+
+`string`: `"always"|"never"`
+
+### `"always"`
+
+The following pattern is considered a problem:
+
+<!-- prettier-ignore -->
+```css
+a {}
+```
+
+The following pattern is _not_ considered a problem:
+
+<!-- prettier-ignore -->
+```css
+U+FEFF
+a {}
+```
+
+### `"never"`
+
+The following pattern is considered a problem:
+
+<!-- prettier-ignore -->
+```css
+U+FEFF
+a {}
+```
+
+The following pattern is _not_ considered a problem:
+
+<!-- prettier-ignore -->
+```css
+a {}
+```

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/unicode-bom/index.cjs

@@ -0,0 +1,67 @@
+/* eslint-disable -- We want to keep as much of the original code as possible */
+// @ts-nocheck
+
+const stylelint = require('stylelint');
+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 ruleName = 'plugin/unicode-bom';
+
+const messages = ruleMessages(ruleName, {
+	expected: 'Expected Unicode BOM',
+	rejected: 'Unexpected Unicode BOM'
+});
+
+const meta = {
+	url: 'https://github.com/jens-duttke/linter-bundle/blob/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules/unicode-bom/README.md'
+};
+
+/** @type {import('stylelint').Rule} */
+const rule = (primary) => (root, result) => {
+	const validOptions = validateOptions(result, ruleName, {
+		actual: primary,
+		possible: ['always', 'never']
+	});
+
+	if (
+		!validOptions ||
+			!root.source ||
+			// @ts-expect-error -- TS2339: Property 'inline' does not exist on type 'Source'.
+			root.source.inline ||
+			// @ts-expect-error -- TS2339: Property 'lang' does not exist on type 'Source'.
+			root.source.lang === 'object-literal' ||
+			// Ignore HTML documents
+			// @ts-expect-error -- TS2339: Property 'document' does not exist on type 'Root'.
+			root.document !== undefined
+	) {
+		return;
+	}
+
+	const { hasBOM } = root.source.input;
+
+	if (primary === 'always' && !hasBOM) {
+		report({
+			result,
+			ruleName,
+			message: messages.expected,
+			node: root,
+			line: 1
+		});
+	}
+
+	if (primary === 'never' && hasBOM) {
+		report({
+			result,
+			ruleName,
+			message: messages.rejected,
+			node: root,
+			line: 1
+		});
+	}
+};
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = meta;
+module.exports = stylelint.createPlugin(ruleName, rule);

package/stylelint/plugins/stylelint-15.11.0-stylistic/rules/unit-case/README.md

@@ -0,0 +1,126 @@
+# unit-case
+
+Specify lowercase or uppercase for units.
+
+<!-- prettier-ignore -->
+```css
+    a { width: 10px; }
+/**              ↑
+ *     These units */
+```
+
+The [`fix` option](https://stylelint.io/user-guide/options/#fix) can automatically fix most of the problems reported by this rule.
+
+## Options
+
+`string`: `"lower"|"upper"`
+
+### `"lower"`
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10PX;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10Px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10pX;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10PIXEL;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: calc(10PX * 2);
+}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: calc(10px * 2);
+}
+```
+
+### `"upper"`
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10Px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10pX;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10pixel;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: calc(10px * 2);
+}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: 10PX;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  width: calc(10PX * 2);
+}
+```