linter-bundle 3.2.0 → 3.4.0

package/CHANGELOG.md

@@ -6,7 +6,55 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
-[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v3.2.0...HEAD)
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v3.4.0...HEAD)
+
+## [3.4.0] - 2023-07-20
+
+### Changed
+
+- [eslint] Updated `@typescript-eslint` from `6.0.0` to `6.1.0`
+- [eslint] Updated `eslint` from `8.44.0` to `8.45.0`
+- [eslint] Updated `eslint-plugin-jsdoc` from `46.4.3` to `46.4.4`
+- [eslint] Updated `eslint-plugin-unicorn` from `47.0.0` to `48.0.0`
+- [stylelint] Updated `stylelint` from `15.10.1` to `15.10.2`
+- [eslint] Moved `unicorn/import-style` configuration for `path` (unassigned: false, default: false, namespace: true, named: true) from `overrides-storybook` into the main configuration.
+- [eslint/overrides-javascript] Activated [`unicorn/prefer-top-level-await`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-top-level-await.md) rule for `*.mjs` files.
+
+### Fixed
+
+- [stylelint] Fixed `Cannot find module 'node_modules/stylelint/bin/stylelint.js'` issue, if the file is called `stylelint.mjs`
+
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v3.3.0...v3.4.0)
+
+## [3.3.0] - 2023-07-13
+
+### Changed
+
+- [general] Drop support for Node.js version v17 (v16 is still supported), as `@typescript-eslint` v6.0.0 doesn't support it anymore
+- [eslint] Updated `@typescript-eslint` from `5.59.9` to `6.0.0`
+- [eslint] Updated `eslint` from `8.42.0` to `8.44.0`
+- [eslint] Updated `eslint-plugin-jest` from `27.2.1` to `27.2.3`
+- [eslint] Updated `eslint-plugin-n` from `16.0.0` to `16.0.1`
+- [eslint/overrides-jsdoc] Updated `eslint-plugin-jsdoc` from `46.2.4` to `46.4.3`
+- [markdownlint] Updated `markdownlint-cli` from `0.34.0` to `0.35.0`
+- [stylelint] Updated `stylelint` from `15.7.0` to `15.10.1`
+- [stylelint] Updated `stylelint-scss` from `5.0.0` to `5.0.1`
+- [eslint/overrides-jsdoc] Don't enforce line-breaks before `@throws` by the [`jsdoc/tag-lines`](https://github.com/gajus/eslint-plugin-jsdoc#eslint-plugin-jsdoc-rules-tag-lines) rule
+- [stylelint] Forked [`stylelint-selector-no-empty`](https://github.com/ssivanatarajan/stylelint-selector-no-empty), because it seems not to be regularly maintained anymore
+
+### Added
+
+- [stylelint] Make use of new [`media-feature-name-value-no-unknown`](https://github.com/stylelint/stylelint/blob/main/lib/rules/media-feature-name-value-no-unknown/README.md) rule
+- [stylelint] Make use of new [`media-query-no-invalid`](https://github.com/stylelint/stylelint/blob/main/lib/rules/media-query-no-invalid/README.md) rule
+- [eslint/overrides-javascript] Activated `@typescript-eslint/prefer-nullish-coalescing` for JavaScript file, as it is now supported in Node.js for a while.
+- [eslint/overrides-javascript] Activated `@typescript-eslint/prefer-optional-chain` for JavaScript file, as it is now supported in Node.js for a while.
+
+### Removed
+
+- [eslint] Remove silently removed `@typescript-eslint/no-parameter-properties` rule
+- [eslint] Disabled `unicorn/no-empty-file`, because of [false-positives](https://github.com/sindresorhus/eslint-plugin-unicorn/issues/2175) with `@typescript-eslint v6.0.0`
+
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v3.2.0...v3.3.0)
 
 ## [3.2.0] - 2023-06-06
 
@@ -26,6 +74,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - [eslint] Updated `eslint` from `8.40.0` to `8.42.0`
 - [eslint] Updated `eslint-plugin-jsdoc` from `44.2.4` to `46.2.4`
 - [stylelint] Updated `stylelint` from `15.6.1` to `15.6.3`
+
+### Added
+
 - [eslint/overrides-jsdoc] Added, but disabled new [`jsdoc/imports-as-dependencies`](https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/imports-as-dependencies.md) rule, as it doesn't cover `peerDependencies` and Node.js modules (like `child_process`)
 
 [Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v3.0.0...v3.1.0)

package/README.md

@@ -46,7 +46,7 @@ Beside that, the following additional rules are part of this bundle:
 - [stylelint-high-performance-animation](https://www.npmjs.com/package/stylelint-high-performance-animation) (Forked version)
 - [stylelint-order](https://www.npmjs.com/package/stylelint-order)
 - [stylelint-scss](https://www.npmjs.com/package/stylelint-scss)
-- [stylelint-selector-no-empty](https://www.npmjs.com/package/stylelint-selector-no-empty)
+- [stylelint-selector-no-empty](https://www.npmjs.com/package/stylelint-selector-no-empty) (Forked version)
 - [stylelint-selector-tag-no-without-class](https://www.npmjs.com/package/stylelint-selector-tag-no-without-class) (Forked version)
 - [stylelint-use-logical-spec](https://www.npmjs.com/package/stylelint-use-logical-spec)
 

package/eslint/index.js

@@ -699,7 +699,6 @@ module.exports = {
 				'@typescript-eslint/no-namespace': ['error', { allowDeclarations: true }],
 				'@typescript-eslint/no-non-null-assertion': 'error',
 				'@typescript-eslint/no-non-null-asserted-optional-chain': 'error',
-				'@typescript-eslint/no-parameter-properties': 'error',
 				'@typescript-eslint/no-redeclare': ['error', { ignoreDeclarationMerge: true }],
 				'@typescript-eslint/no-redundant-type-constituents': 'off', // False positive with Promise<... | never>
 				'@typescript-eslint/no-require-imports': 'error',
@@ -942,7 +941,16 @@ module.exports = {
 						/([A-Za-z0-9]?[a-z0-9]+)*[A-Z]{2,4}([A-Za-z0-9]?[a-z0-9]+)*/u // Up to 4 Characters can be upper-case in a row (e.g. in `prepareDOM` or `SVGIcon`)
 					]
 				}],
-				'unicorn/import-style': 'error',
+				'unicorn/import-style': ['error', {
+					styles: {
+						path: {
+							unassigned: false,
+							default: false,
+							namespace: true,
+							named: true
+						}
+					}
+				}],
 				'unicorn/new-for-builtins': 'error',
 				'unicorn/no-abusive-eslint-disable': 'error',
 				'unicorn/no-array-callback-reference': 'off', // If I use functions, they are the best option for this use-case
@@ -953,7 +961,7 @@ module.exports = {
 				'unicorn/no-await-expression-member': 'error',
 				'unicorn/no-console-spaces': 'error',
 				'unicorn/no-document-cookie': 'error',
-				'unicorn/no-empty-file': 'error',
+				'unicorn/no-empty-file': 'off', // @todo False-positives since @typescript-eslint v6.0.0. @see https://github.com/sindresorhus/eslint-plugin-unicorn/issues/2175
 				'unicorn/no-for-loop': 'off', // @typescript-eslint/prefer-for-of
 				'unicorn/no-hex-escape': 'error',
 				'unicorn/no-instanceof-array': 'error',
@@ -973,7 +981,6 @@ module.exports = {
 				'unicorn/no-unnecessary-await': 'error',
 				'unicorn/no-unreadable-array-destructuring': 'error',
 				'unicorn/no-unreadable-iife': 'error',
-				'unicorn/no-unsafe-regex': 'off',
 				'unicorn/no-unused-properties': 'error',
 				'unicorn/no-useless-fallback-in-spread': 'error',
 				'unicorn/no-useless-promise-resolve-reject': 'error',
@@ -1022,13 +1029,13 @@ module.exports = {
 				'unicorn/prefer-set-has': 'error',
 				'unicorn/prefer-set-size': 'error',
 				'unicorn/prefer-spread': 'off', // @todo Disabled till there a solution for the warning, that `slice()` on Typed-Arrays should be replaced (which is not possible). @see https://github.com/sindresorhus/eslint-plugin-unicorn/issues/1064
-				'unicorn/prefer-string-replace-all': 'off', // @todo Available since 2020 in browsers. SHould this be preferred?
+				'unicorn/prefer-string-replace-all': 'off', // @todo Available since 2020 in browsers. Should this be preferred?
 				'unicorn/prefer-string-slice': 'off', // @todo As of today (2020.08.24) and since the last 9 years, substr() is three times faster than slice() in Firefox.
 				'unicorn/prefer-string-starts-ends-with': 'error',
 				'unicorn/prefer-string-trim-start-end': 'error',
 				'unicorn/prefer-switch': 'error',
 				'unicorn/prefer-ternary': 'off', // We prefer readability over saving a few chars
-				'unicorn/prefer-top-level-await': 'off', // @todo There should be a detection that this option is only activated on Node.js v14.8 environments and above (Check for "engine" property in package.json, and "node -v")
+				'unicorn/prefer-top-level-await': 'off', // @todo Available since 2021. Activate in 2024
 				'unicorn/prefer-regexp-test': 'error',
 				'unicorn/prefer-type-error': 'error',
 				'unicorn/prevent-abbreviations': ['error', { ignore: ['args', 'i', 'j', 'i18n', 'ref', 'Ref', 'params', 'props', 'Props'] }],

package/eslint/overrides-javascript-lazy.js

@@ -7,11 +7,10 @@ const overridesJavaScript = require('./overrides-javascript');
 module.exports = {
 	...overridesJavaScript,
 	overrides: [
+		...overridesJavaScript.overrides,
 		{
-			...overridesJavaScript.overrides[0],
+			files: ['*.js', '*.cjs', '*.mjs'],
 			rules: {
-				...overridesJavaScript.overrides[0].rules,
-
 				/**
 				 * typescript-eslint
 				 *

package/eslint/overrides-javascript.js

@@ -32,8 +32,6 @@ module.exports = {
 				'@typescript-eslint/no-require-imports': 'off', // Requires type information
 				'@typescript-eslint/no-unsafe-assignment': 'off', // @todo Reactivate after bug in @typescript-eslint is fixed (@see https://github.com/typescript-eslint/typescript-eslint/issues/1943)
 				'@typescript-eslint/no-var-requires': 'off', // Requires type information
-				'@typescript-eslint/prefer-nullish-coalescing': 'off', // @todo `??` is not yet supported by NodeJS. Remove this like, as soon as it is supported.
-				'@typescript-eslint/prefer-optional-chain': 'off', // @todo `?.` is not yet supported by NodeJS. Remove this like, as soon as it is supported.
 				'@typescript-eslint/triple-slash-reference': 'off', // Required to make use of *.d.ts files
 
 				/**
@@ -105,6 +103,12 @@ module.exports = {
 				'unicorn/prevent-abbreviations': ['error', { ignore: ['args', 'dev', 'env', 'i', 'j', 'i18n', 'pkg', 'ref', 'Ref', 'req', 'res', 'setupDevServerMiddleware'] }],
 				'unicorn/text-encoding-identifier-case': 'off'
 			}
+		},
+		{
+			files: ['*.mjs'],
+			rules: {
+				'unicorn/prefer-top-level-await': 'error'
+			}
 		}
 	]
 };

package/eslint/overrides-jsdoc.js

@@ -34,7 +34,7 @@ module.exports = {
 				'jsdoc/check-values': 'error',
 				'jsdoc/empty-tags': 'error',
 				'jsdoc/implements-on-classes': 'error',
-				'jsdoc/imports-as-dependencies': 'off', // @todo Doesn't cover `peerDependencies` and Node.js modules (like `child_process`) yet
+				'jsdoc/imports-as-dependencies': 'off', // @todo Doesn't cover `peerDependencies` yet. As of v46.2.5 it should cover Node.js modules (like `child_process`), which must be checked, before activation.
 				'jsdoc/match-description': 'error',
 				'jsdoc/match-name': 'off',
 				'jsdoc/multiline-blocks': ['error', { noSingleLineBlocks: true, singleLineTags: ['lends', 'type', 'typedef'], noFinalLineText: false }],
@@ -75,7 +75,8 @@ module.exports = {
 						param: { lines: 'never' },
 						private: { lines: 'never' },
 						protected: { lines: 'never' },
-						public: { lines: 'never' }
+						public: { lines: 'never' },
+						throws: { lines: 'never' }
 					},
 					startLines: null,
 					endLines: null,

package/eslint/overrides-storybook.js

@@ -23,23 +23,7 @@ module.exports = {
 				 *
 				 * @see https://github.com/import-js/eslint-plugin-import
 				 */
-				'import/no-nodejs-modules': 'off',
-
-				/**
-				 * eslint-plugin-unicorn
-				 *
-				 * @see https://github.com/sindresorhus/eslint-plugin-unicorn
-				 */
-				'unicorn/import-style': ['error', {
-					styles: {
-						path: {
-							unassigned: false,
-							default: false,
-							namespace: true,
-							named: true
-						}
-					}
-				}]
+				'import/no-nodejs-modules': 'off'
 			}
 		},
 		{

package/eslint/rules/no-unnecessary-typeof.js

@@ -6,6 +6,7 @@
 
 const ts = require('typescript');
 
+// @ts-expect-error -- TypeScript is not able to resolve the folder since @typescript-eslint v6.0.0
 const { ESLintUtils } = require('@typescript-eslint/utils');
 
 /**
@@ -28,11 +29,9 @@ module.exports = {
 					return;
 				}
 
-				// @ts-expect-error -- Different type definitions for `Rule.RuleContext` in ESLint and @typescript-eslint
 				const parserServices = ESLintUtils.getParserServices(context);
 				const checker = parserServices.program.getTypeChecker();
 
-				// @ts-expect-error -- ESLint `Identifier` is not recognized as `Node` by @typescript-eslint
 				const originalNode = parserServices.esTreeNodeToTSNodeMap.get(node.argument);
 
 				/** @type {Type} */

package/helper/ensure-type.js

@@ -5,6 +5,7 @@
 /**
  * Ensures that the input `value` is an array, otherwise an empty array is returned.
  *
+ * @public
  * @template T
  * @param {T} value - The value which should be checked.
  * @returns {T extends Array<any> ? T : []} Either the input array, or an empty array, if the input array is not an array.

package/helper/find-missing-overrides.js

@@ -13,6 +13,7 @@ const path = require('path');
 /**
  * Detects if installed versions of dependencies don't match to the required dependencies.
  *
+ * @public
  * @returns {Dependency[]} An array of missing overrides (=wrong versions).
  */
 function findMissingOverrides () {

package/helper/get-stylelint-path.js

@@ -0,0 +1,32 @@
+/**
+ * @file Returns the path to the Stylelint CLI script.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Returns if the project is using npm or yarn.
+ *
+ * @public
+ * @returns {string | null} Return the path to the Stylelint CLI script, or `null` if it can't be found.
+ */
+function getStylelintPath () {
+	const stylelintLibPath = path.dirname(require.resolve('stylelint'));
+
+	for (const stylelintBinPath of [
+		path.join(stylelintLibPath, '../bin/stylelint.mjs'),
+		path.join(stylelintLibPath, '../bin/stylelint.js')
+	]) {
+		if (fs.existsSync(stylelintBinPath)) {
+			return stylelintBinPath;
+		}
+	}
+
+	return null;
+}
+
+module.exports = {
+	getStylelintPath
+};
+

package/helper/is-npm-or-yarn.js

@@ -8,6 +8,7 @@ const path = require('path');
 /**
  * Returns if the project is using npm or yarn.
  *
+ * @public
  * @returns {'none' | 'npm' | 'yarn' | 'both'} Returns which package manager name.
  */
 function isNpmOrYarn () {

package/helper/run-process.js

@@ -9,6 +9,7 @@ const childProcess = require('child_process');
 /**
  * Executes a process asynchronously.
  *
+ * @public
  * @param {string} command - The process to execute.
  * @param {childProcess.ExecOptions | undefined} [options] - The options of the `childProcess.exec()` method.
  * @returns {Promise<ProcessResult>} An object containing the result of the process execution

package/helper/validate-package-overrides.js

@@ -13,6 +13,7 @@ const path = require('path');
 /**
  * Detects outdated "overrides"/"resolutions" dependencies.
  *
+ * @public
  * @returns {{ overrides: Dependency[]; resolutions: Dependency[]; }} Either the input array, or an empty array, if the input array is not an array.
  */
 function validatePackageOverrides () {

package/lint.js

@@ -10,6 +10,7 @@ const tty = require('tty');
 const micromatch = require('micromatch');
 
 const { findMissingOverrides } = require('./helper/find-missing-overrides.js');
+const { getStylelintPath } = require('./helper/get-stylelint-path.js');
 const { isNpmOrYarn } = require('./helper/is-npm-or-yarn.js');
 const { runProcess } = require('./helper/run-process.js');
 const { validatePackageOverrides } = require('./helper/validate-package-overrides.js');
@@ -115,10 +116,18 @@ void (async () => {
 					});
 				}
 
+				const stylelintBinPath = getStylelintPath();
+
+				if (stylelintBinPath === null) {
+					return generateDummyJobOutput(taskName, config, {
+						stderr: 'Stylelint CLI script not found.'
+					});
+				}
+
 				return runTask({
 					taskName,
 					config,
-					command: `node "${require.resolve('stylelint/bin/stylelint.js')}" ${includes} --formatter unix`
+					command: `node "${stylelintBinPath}" ${includes} --formatter unix`
 				});
 			}
 
@@ -280,7 +289,7 @@ function validateEnvironment (npmOrYarn) {
 			propertyName = 'resolutions';
 		}
 		else {
-			installCommand = 'npm install';
+			installCommand = 'npm install --no-package-lock';
 			propertyName = 'overrides';
 		}
 
@@ -288,7 +297,7 @@ function validateEnvironment (npmOrYarn) {
 		process.stderr.write(`- ${missingOverrides.map((dependency) => `${dependency.name}: ${dependency.configuredVersion} is installed, but ${dependency.expectedVersion} is expected`).join('\n- ')}\n\n`);
 		process.stderr.write(`This could be caused by forgetting to execute \`${installCommand}\` after changing a version number in the package.json, or by some other package shipping outdated versions of the ${missingOverrides.length === 1 ? 'dependency' : 'dependencies'}.\n`);
 		process.stderr.write('If another package is causing this problem, you can fix it by adding the following entry to your package.json:\n');
-		process.stderr.write(`{\n  "${propertyName}: {\n    ${missingOverrides.map((dependency) => `"${dependency.name}": "${dependency.expectedVersion}"`).join(',\n    ')}\n  }\n}\n\n`);
+		process.stderr.write(`{\n  "${propertyName}": {\n    ${missingOverrides.map((dependency) => `"${dependency.name}": "${dependency.expectedVersion}"`).join(',\n    ')}\n  }\n}\n\n`);
 
 		process.exitCode = 1;
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "linter-bundle",
-	"version": "3.2.0",
+	"version": "3.4.0",
 	"description": "Ready-to use bundle of linting tools, containing configurations for ESLint, stylelint and markdownlint.",
 	"keywords": [
 		"eslint",
@@ -22,7 +22,7 @@
 		"lint": "lint.js"
 	},
 	"engines": {
-		"node": ">=16.0.0"
+		"node": "^16.0.0 || >=18.0.0"
 	},
 	"repository": {
 		"type": "git",
@@ -36,35 +36,34 @@
 		"preversion": "npm run check-outdated && npm run lint",
 		"postversion": "git push && git push --tags && npm publish",
 		"stylelint-find-rules": "stylelint-find-new-rules ./stylelint/index.js",
-		"validate-stylelint-options": "node ./validate-stylelint-options",
+		"validate-stylelint-options": "node ./validate-stylelint-options.mjs",
 		"check-outdated": "npx --yes -- check-outdated --ignore-pre-releases"
 	},
 	"dependencies": {
-		"@typescript-eslint/eslint-plugin": "5.59.9",
-		"@typescript-eslint/parser": "5.59.9",
-		"@typescript-eslint/utils": "5.59.9",
-		"eslint": "8.42.0",
+		"@typescript-eslint/eslint-plugin": "6.1.0",
+		"@typescript-eslint/parser": "6.1.0",
+		"@typescript-eslint/utils": "6.1.0",
+		"eslint": "8.45.0",
 		"eslint-import-resolver-typescript": "3.5.5",
 		"eslint-import-resolver-webpack": "0.13.2",
 		"eslint-plugin-eslint-comments": "3.2.0",
 		"eslint-plugin-functional": "5.0.8",
 		"eslint-plugin-import": "2.27.5",
-		"eslint-plugin-jest": "27.2.1",
-		"eslint-plugin-jsdoc": "46.2.4",
+		"eslint-plugin-jest": "27.2.3",
+		"eslint-plugin-jsdoc": "46.4.4",
 		"eslint-plugin-jsx-a11y": "6.7.1",
-		"eslint-plugin-n": "16.0.0",
+		"eslint-plugin-n": "16.0.1",
 		"eslint-plugin-promise": "6.1.1",
 		"eslint-plugin-react": "7.32.2",
 		"eslint-plugin-react-hooks": "4.6.0",
-		"eslint-plugin-unicorn": "47.0.0",
-		"markdownlint-cli": "0.34.0",
+		"eslint-plugin-unicorn": "48.0.0",
+		"markdownlint-cli": "0.35.0",
 		"micromatch": "4.0.5",
 		"postcss-scss": "4.0.6",
-		"stylelint": "15.7.0",
+		"stylelint": "15.10.2",
 		"stylelint-declaration-block-no-ignored-properties": "2.7.0",
 		"stylelint-order": "6.0.3",
-		"stylelint-scss": "5.0.0",
-		"stylelint-selector-no-empty": "1.0.9",
+		"stylelint-scss": "5.0.1",
 		"stylelint-use-logical-spec": "5.0.0"
 	},
 	"peerDependencies": {
@@ -72,10 +71,10 @@
 		"typescript": "^4.0.0"
 	},
 	"devDependencies": {
-		"@types/eslint": "8.40.0",
+		"@types/eslint": "8.44.0",
 		"@types/micromatch": "4.0.2",
-		"@types/node": "20.2.5",
+		"@types/node": "20.4.2",
 		"stylelint-find-new-rules": "4.1.0",
-		"typescript": "5.1.3"
+		"typescript": "5.1.6"
 	}
 }

package/stylelint/index.js

@@ -15,9 +15,9 @@ module.exports = {
 		'stylelint-declaration-block-no-ignored-properties',
 		'stylelint-order',
 		'stylelint-scss',
-		'stylelint-selector-no-empty',
 		'stylelint-use-logical-spec',
 		path.join(__dirname, '/plugins/stylelint-high-performance-animation.js'),
+		path.join(__dirname, '/plugins/stylelint-selector-no-empty.js'),
 		path.join(__dirname, '/plugins/stylelint-selector-tag-no-without-class.js'),
 		path.join(__dirname, '/plugins/stylelint-stylistic.js')
 	],
@@ -187,7 +187,9 @@ module.exports = {
 		'media-feature-name-no-vendor-prefix': null, // For Safari, we still need "-webkit-min-device-pixel-ratio": https://caniuse.com/css-media-resolution
 		'media-feature-name-unit-allowed-list': null,
 		'media-feature-name-value-allowed-list': null,
+		'media-feature-name-value-no-unknown': true,
 		'media-feature-range-notation': 'prefix',
+		'media-query-no-invalid': true,
 		'named-grid-areas-no-invalid': true,
 		'no-descending-specificity': null, // doesn't work in many cases (e.g. while using the SCSS :global()-pseudo-class)
 		'no-duplicate-at-import-rules': true,

package/stylelint/plugins/stylelint-selector-no-empty.js

@@ -0,0 +1,114 @@
+/**
+ * @file Fork of `stylelint-selector-no-empty` rule.
+ *
+ * @license MIT
+ *
+ * @see https://www.npmjs.com/package/stylelint-selector-no-empty
+ */
+
+const stylelint = require('stylelint');
+
+const ruleName = 'plugin/stylelint-selector-no-empty';
+
+let nearestSelector = '';
+
+const messages = stylelint.utils.ruleMessages(ruleName, {
+	expected (selector) {
+		if (typeof selector === 'string' && selector.length > 0) {
+			return `Unexpected empty selector near '${selector}'`;
+		}
+
+		return 'Unexpected empty selector';
+	}
+});
+
+// @ts-expect-error -- Parameter 'enabled' implicitly has an 'any' type.
+module.exports = stylelint.createPlugin(ruleName, (enabled) => {
+	if (!enabled) {
+		return;
+	}
+
+	return (root, result) => {
+		root.walkRules((rule) => {
+			try {
+				nearestSelector = '';
+
+				for (const selector of rule.selector.split(',')) {
+					if (selector.length === 0) {
+						reportError(rule, result);
+						continue;
+					}
+					nearestSelector = selector;
+
+					const tabSplittedSelectors = getSplittedSelectors(selector.split('\n'), '\t');
+					const spaceSplittedSelectors = getSplittedSelectors(tabSplittedSelectors, ' ');
+					checkEmptySelector(spaceSplittedSelectors, result, rule);
+				}
+			}
+			catch { /* Do nothing */ }
+		});
+	};
+});
+
+/**
+ * Splits the selectors based on a specified delimiter and filters out empty selectors.
+ *
+ * @param {string[]} splittedSelectors - The selectors to be split.
+ * @param {string} splitBy - The delimiter to split the selectors.
+ * @returns {string[]} The split and filtered selectors.
+ */
+function getSplittedSelectors (splittedSelectors, splitBy) {
+	const res = [];
+
+	for (const splittedSelector of splittedSelectors) {
+		try {
+			for (const selector of splittedSelector.split(splitBy)) {
+				if (selector.trim().length > 0) {
+					res.push(selector);
+				}
+			}
+		}
+		catch { /* Do nothing */ }
+	}
+
+	return res;
+}
+
+/**
+ * Checks for empty selectors within the space-split selectors.
+ *
+ * @param {string[]} spaceSplittedSelectors - The space-split selectors.
+ * @param {stylelint.PostcssResult} result - The result object.
+ * @param {import('postcss').Rule} rule - The current rule.
+ */
+function checkEmptySelector (spaceSplittedSelectors, result, rule) {
+	for (let sp of spaceSplittedSelectors) {
+		if ((sp.startsWith('.') || sp.startsWith('#')) && sp.trim().length > 1) {
+			sp = sp.slice(1);
+		}
+
+		for (const classSelectorsWithoutDot of sp.split('.')) {
+			for (const selector of classSelectorsWithoutDot.split('#')) {
+				if (selector.trim().length === 0) {
+					reportError(rule, result);
+					return;
+				}
+			}
+		}
+	}
+}
+
+/**
+ * Reports an error for an empty selector.
+ *
+ * @param {import('postcss').Rule} rule - The current rule.
+ * @param {stylelint.PostcssResult} result - The result object.
+ */
+function reportError (rule, result) {
+	stylelint.utils.report({
+		result,
+		ruleName,
+		message: messages.expected(nearestSelector),
+		node: rule
+	});
+}

package/.gitattributes

@@ -1,16 +0,0 @@
-* text=auto
-
-*.css text eol=lf
-*.html text eol=lf
-*.js text eol=lf
-*.json text eol=lf
-*.log text eol=lf
-*.md text eol=lf
-*.scss text eol=lf
-*.svg text eol=lf
-*.ts text eol=lf
-*.tsx text eol=lf
-*.txt text eol=lf
-*.xml text eol=lf
-*.yaml text eol=lf
-*.yml text eol=lf

package/validate-stylelint-options.js

@@ -1,52 +0,0 @@
-/**
- * @file Ensures that stylelint options are valid by checking the `invalidOptionWarnings` property of the JSON response.
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const { runProcess } = require('./helper/run-process.js');
-
-void (async () => {
-	const temporaryPath = path.join(os.tmpdir(), 'linter-bundle-');
-
-	const folder = fs.mkdtempSync(temporaryPath);
-
-	const tempFilePath = path.join(folder, 'tmp.scss');
-
-	fs.writeFileSync(tempFilePath, '@property --color {\n\tsyntax: "<color>";\n\tinherits: false;\n\tinitial-value: #f00; // stylelint-disable-line color-no-hex -- The initial value must be a hex-color\n}\n\n* {\n\tborder: 1px solid var(--color);\n\n\tcolor: var(--color);\n}\n', 'utf8');
-
-	const result = await runProcess(`stylelint -f json "${tempFilePath}"`);
-
-	fs.unlinkSync(tempFilePath);
-
-	if (result.stderr) {
-		process.stderr.write(result.stderr);
-
-		process.exitCode = 1;
-
-		return;
-	}
-
-	/**
-	 * @type {import('stylelint').LintResult}
-	 */
-	const { invalidOptionWarnings, warnings } = JSON.parse(result.stdout)[0];
-
-	if (warnings.length > 0) {
-		process.stderr.write(`Warnings:\n\n- ${warnings.map(({ text }) => text).join('\n- ')}\n`);
-
-		process.exitCode = 1;
-
-		return;
-	}
-
-	if (invalidOptionWarnings.length > 0) {
-		process.stderr.write(`Invalid stylelint configuration:\n\n- ${invalidOptionWarnings.map(({ text }) => text).join('\n- ')}\n`);
-
-		process.exitCode = 1;
-
-		return;
-	}
-})();