linter-bundle 5.1.0 → 6.0.0

package/.linter-bundle.js

@@ -9,6 +9,7 @@ const snippets = {
 };
 
 export default {
+	verbose: true,
 	timing: true,
 	files: {
 		restrictions: [
@@ -27,6 +28,7 @@ export default {
 					'node_modules/**',
 					'stylelint/index.cjs',
 					`stylelint/plugins/stylelint-${snippets.kebabCase}.js`,
+					`stylelint/plugins/stylelint-15.11.0-stylistic/**/{${snippets.camelCase}.cjs,README.md,LICENSE}`,
 					'.editorconfig',
 					'.eslintrc.cjs',
 					'.gitattributes',

package/CHANGELOG.md

@@ -6,7 +6,68 @@ 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/v5.1.0...HEAD)
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v6.0.0...HEAD)
+
+## [6.0.0] - 2024-01-21
+
+### Added
+
+- [eslint] Make use of new [`@typescript-eslint/no-useless-empty-export`](https://typescript-eslint.io/rules/no-useless-empty-export) rule
+- [eslint] Make use of new [`@typescript-eslint/no-unsafe-unary-minus`](https://typescript-eslint.io/rules/no-unsafe-unary-minus/) rule
+- [eslint] Make use of new [`no-object-constructor`](https://eslint.org/docs/latest/rules/no-object-constructor) rule
+- [eslint] Make use of new [`unicorn/no-unnecessary-polyfills`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-unnecessary-polyfills.md) rule
+- [markdownlint] Make use of new [`MD054`/link-image-style](https://github.com/DavidAnson/markdownlint/blob/main/doc/md054.md) rule
+- [eslint/overrides-jest] Make use of new [`jest/no-confusing-set-time`](https://github.com/jest-community/eslint-plugin-jest/blob/main/docs/rules/no-confusing-set-timeout.md) rule
+- [eslint/overrides-jsdoc] Make use of [`jsdoc/informative-docs`](https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/informative-docs.md) rule
+- [stylelint] Make use of new [`lightness-notation`](https://stylelint.io/user-guide/rules/lightness-notation/) rule with option "percentage"
+- [stylelint] Make use of new [`scss/at-root-no-redundant`](https://github.com/stylelint-scss/stylelint-scss/blob/master/src/rules/at-root-no-redundant/README.md) rule
+- [stylelint] Make use of new [`scss/property-no-unknown`](https://github.com/stylelint-scss/stylelint-scss/blob/master/src/rules/property-no-unknown/README.md) rule, replacing [`property-no-unknown`](https://github.com/stylelint-scss/stylelint-scss/blob/master/src/rules/property-no-unknown/) rule
+- [stylelint] Make use of new [`scss/function-calculation-no-interpolation`](https://github.com/stylelint-scss/stylelint-scss/blob/master/src/rules/function-calculation-no-interpolation/README.md) rule
+- [stylelint] Added, but disabled new [`scss/block-no-redundant-nesting`](https://github.com/stylelint-scss/stylelint-scss/blob/master/src/rules/block-no-redundant-nesting/README.md) rule
+- [stylelint] Added, but disabled new [`scss/load-no-partial-leading-underscore`](https://github.com/stylelint-scss/stylelint-scss/blob/master/src/rules/load-no-partial-leading-underscore/README.md) rule
+- [stylelint] Added, but disabled [`scss/at-use-no-redundant-alias`](https://github.com/stylelint-scss/stylelint-scss/blob/master/src/rules/at-use-no-redundant-alias/README.md) rule
+
+### Fixed
+
+- [general] Removed '--verbose' argument for `tsc` and `markdownlint`, which don't support it
+- [general] Show errors in linter-bundle configuration file
+
+### Changed
+
+- [general] Drop support for Node.js version less than v18.12.0 as `stylelint@16.0.0` doesn't support them anymore
+- [eslint] Updated `@typescript-eslint` from `6.5.0` to `6.19.0`
+- [eslint] Updated `eslint` from `8.48.0` to `8.56.0`
+- [eslint] Updated `eslint-import-resolver-typescript` from `3.6.0` to `3.6.1`
+- [eslint] Updated `eslint-import-resolver-webpack` from `0.13.7` to `0.13.8`
+- [eslint] Updated `eslint-plugin-import` from `2.28.1` to `2.29.1`
+- [eslint] Updated `eslint-plugin-jest` from `27.2.3` to `27.6.3`
+- [eslint] Updated `eslint-plugin-jsdoc` from `46.5.1` to `48.0.2`
+- [eslint] Updated `eslint-plugin-jsx-a11y` from `6.7.1` to `6.8.0`
+- [eslint] Updated `eslint-plugin-n` from `16.0.2` to `16.6.2`
+- [eslint] Updated `eslint-plugin-unicorn` from `48.0.1` to `50.0.1`
+- [markdownlint] Updated `markdownlint-cli` from `0.36.0` to `0.38.0`
+- [stylelint] Updated `postcss-scss` from `4.0.7` to `4.0.9`
+- [stylelint] Updated `stylelint` from `15.10.3` to `16.2.0`
+- [stylelint] Updated `stylelint-declaration-block-no-ignored-properties` from `2.7.0` to `2.8.0`
+- [stylelint] Updated `stylelint-order` from `6.0.3` to `6.0.4`
+- [stylelint] Updated `stylelint-scss` from `5.1.0` to `6.0.0`
+- [stylelint] Updated `stylelint-use-logical-spec` from `5.0.0` to `5.0.1`
+- [stylelint] Forked 73 stylistic rules from `stylelint@15.11.0` which have been removed in `stylelint@16.0.0`
+- [audit] Updated `better-npm-audit` from `1.9.1` to `3.7.3`
+- [audit] Updated `improved-yarn-audit` from `2.3.3` to `3.0.0`
+- [eslint] Enable `ignoreOverrideMethods` and `ignoreClassesThatImplementAnInterface` of [`@typescript-eslint/class-methods-use-this`](https://typescript-eslint.io/rules/class-methods-use-this/) rule
+- [eslint] Enable `includeTypes` option of [`import/no-extraneous-dependencies`](https://github.com/import-js/eslint-plugin-import/blob/main/docs/rules/no-extraneous-dependencies.md) rule
+- [eslint/overrides-javascript] Activated rule [`unicorn/prefer-module`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-module.md) rule
+- [stylelint] Re-use [`stylelint-high-performance-animation`](https://www.npmjs.com/package/stylelint-high-performance-animation) instead of the fork, as it seems to be maintained again
+
+### Removed
+
+- [eslint] Remove deprecated `no-new-object` rule
+- [markdownlint] Update removed the deprecated `MD002`/`MD006` rules
+- [markdownlint] Update removed rule aliases for "header"
+- [stylelint] Removed deprecated `scss/at-import-no-partial-leading-underscore` rule
+
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v5.1.0...v6.0.0)
 
 ## [5.1.0] - 2023-09-03
 

package/README.md

@@ -44,13 +44,15 @@ Beside that, the following additional rules are part of this bundle:
 ### stylelint
 
 - [stylelint-declaration-block-no-ignored-properties](https://www.npmjs.com/package/stylelint-declaration-block-no-ignored-properties)
-- [stylelint-high-performance-animation](https://www.npmjs.com/package/stylelint-high-performance-animation) (Forked version)
+- [stylelint-high-performance-animation](https://www.npmjs.com/package/stylelint-high-performance-animation)
 - [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) (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)
 
+Beside that [73 stylistic rules](https://github.com/jens-duttke/linter-bundle/tree/main/stylelint/plugins/stylelint-15.11.0-stylistic/rules) has been forked from `stylelint@15.11.0`, which have been removed in `stylelint@16.0.0`, are part of this bundle.
+
 ### Previously used, but now unmaintained plugins
 
 Unfortunately a couple of previously used plugins are not regularly maintained or depend on unmaintained third-party code which blocks them from updating, so they don't provide updates for the major releases of the linters (ESLint and Stylelint).
@@ -62,7 +64,7 @@ If these plugins are maintained again, the plugins will also be used again.
 
 ## Install
 
-Ensure you are using atleast Node.js version 16.
+Ensure you are using atleast Node.js version 18.2.0.
 
 ```sh
 npm install linter-bundle --save-dev
@@ -561,7 +563,7 @@ Will execute:
 eslint "./**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}" --format unix
 ```
 
-Additionally, the environment variable `TIMING` is set to `10`.
+Additionally, the environment variable `TIMING` is set to `10`, to show timing information about the 10 slowest rules.
 
 #### Optional command line arguments for `lint ts`
 

package/TODO.md

@@ -1,5 +1,10 @@
 # @todo
 
+- Aktuell sind die Versionen von den Audit-Tools hardcodiert in der lint.js hinterlegt:
+  'better-npm-audit@3.7.3',
+  'improved-yarn-audit@3.0.0',
+  Das sollte irgendwo hinterlegt werden, so z.B. check-outdated drauf zugreifen kann. (z.B. die optionalDependencies? Sind diese nach dem regulären Installieren noch vorhanden und lassen sich entsprechend auslesen? Werden diese von check-outdated geprüft?)
+
 - Timing funktioniert nicht - siehe HexEd.it-core
 
 - Wie erreichen wir auto-completion in der .linter-bundle.js datei?

package/eslint/index.cjs

@@ -261,12 +261,12 @@ module.exports = {
 				'no-nested-ternary': 'error',
 				'no-new-func': 'error',
 				'no-new-native-nonconstructor': 'error',
-				'no-new-object': 'error',
 				'no-new-symbol': 'error',
 				'no-new-wrappers': 'error',
 				'no-new': 'error',
 				'no-nonoctal-decimal-escape': 'error',
 				'no-obj-calls': 'error',
+				'no-object-constructor': 'error',
 				'no-octal-escape': 'error',
 				'no-octal': 'error',
 				'no-param-reassign': 'off', // Parameter reassignment used wisely makes the code more readable
@@ -423,7 +423,7 @@ module.exports = {
 				}],
 				'@typescript-eslint/brace-style': ['error', 'stroustrup', { allowSingleLine: true }],
 				'@typescript-eslint/class-literal-property-style': 'error',
-				'@typescript-eslint/class-methods-use-this': ['error', { exceptMethods: ['componentDidMount', 'componentDidUpdate', 'componentWillUnmount', 'shouldComponentUpdate'] }],
+				'@typescript-eslint/class-methods-use-this': ['error', { exceptMethods: ['componentDidMount', 'componentDidUpdate', 'componentWillUnmount', 'shouldComponentUpdate'], ignoreOverrideMethods: true, ignoreClassesThatImplementAnInterface: true }],
 				'@typescript-eslint/comma-dangle': ['error', { generics: 'ignore' }],
 				'@typescript-eslint/comma-spacing': 'error',
 				'@typescript-eslint/consistent-generic-constructors': 'error',
@@ -730,10 +730,12 @@ module.exports = {
 				'@typescript-eslint/no-unsafe-enum-comparison': 'error',
 				'@typescript-eslint/no-unsafe-member-access': 'error',
 				'@typescript-eslint/no-unsafe-return': 'error',
+				'@typescript-eslint/no-unsafe-unary-minus': 'error',
 				'@typescript-eslint/no-unused-expressions': 'error',
 				'@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_', destructuredArrayIgnorePattern: '^_' }],
 				'@typescript-eslint/no-use-before-define': ['error', { functions: false }],
 				'@typescript-eslint/no-useless-constructor': 'error',
+				'@typescript-eslint/no-useless-empty-export': 'error',
 				'@typescript-eslint/no-var-requires': 'error',
 				'@typescript-eslint/non-nullable-type-assertion-style': 'off', // Conflicts with `no-non-null-assertion`, which we prefer
 				'@typescript-eslint/object-curly-spacing': ['error', 'always'],
@@ -832,7 +834,7 @@ module.exports = {
 				'import/no-duplicates': 'error',
 				'import/no-dynamic-require': 'error',
 				'import/no-empty-named-blocks': 'error',
-				'import/no-extraneous-dependencies': 'error',
+				'import/no-extraneous-dependencies': ['error', { includeTypes: true }],
 				'import/no-internal-modules': ['off', { // @todo Throws an "Cannot read property 'value' of null" error in src/help/scss/help.scss.d.ts:2 since the update to v2.21.1. If this issue does not get fixed in the next releases, report it!
 					allow: [
 						'workbox-window/utils/WorkboxEvent'
@@ -978,6 +980,7 @@ module.exports = {
 				'unicorn/no-this-assignment': 'error',
 				'unicorn/no-typeof-undefined': 'error',
 				'unicorn/no-unnecessary-await': 'error',
+				'unicorn/no-unnecessary-polyfills': 'error',
 				'unicorn/no-unreadable-array-destructuring': 'error',
 				'unicorn/no-unreadable-iife': 'error',
 				'unicorn/no-unused-properties': 'error',

package/eslint/overrides-javascript.cjs

@@ -99,7 +99,7 @@ module.exports = {
 					}
 				}],
 				'unicorn/no-process-exit': 'off', // n/no-process-exit
-				'unicorn/prefer-module': 'off', // @todo Requires Node.js v13.2. Activate in 2023
+				'unicorn/prefer-module': 'error',
 				'unicorn/prefer-node-protocol': 'off', // @todo Requires Node.js v16. Activate in 2025
 				'unicorn/prevent-abbreviations': ['error', { ignore: ['args', 'dev', 'env', 'i', 'j', 'i18n', 'pkg', 'ref', 'Ref', 'req', 'res', 'setupDevServerMiddleware'] }],
 				'unicorn/text-encoding-identifier-case': 'off'

package/eslint/overrides-jest.cjs

@@ -70,6 +70,7 @@ module.exports = {
 				'jest/no-commented-out-tests': 'error',
 				'jest/no-conditional-expect': 'error',
 				'jest/no-conditional-in-test': 'error',
+				'jest/no-confusing-set-time': 'error',
 				'jest/no-deprecated-functions': 'error',
 				'jest/no-disabled-tests': 'error',
 				'jest/no-done-callback': 'error',

package/eslint/overrides-jsdoc.cjs

@@ -35,6 +35,7 @@ module.exports = {
 				'jsdoc/empty-tags': 'error',
 				'jsdoc/implements-on-classes': 'error',
 				'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/informative-docs': 'error',
 				'jsdoc/match-description': 'error',
 				'jsdoc/match-name': 'off',
 				'jsdoc/multiline-blocks': ['error', { noSingleLineBlocks: true, singleLineTags: ['lends', 'type', 'typedef'], noFinalLineText: false }],

package/eslint/rules/no-global-undefined-check.js

@@ -4,6 +4,8 @@
  * @see https://www.joshwcomeau.com/react/the-perils-of-rehydration/
  */
 
+/* eslint-disable unicorn/prefer-module -- For ESLint, we still need to rely on CommonJS modules */
+
 const DISALLOWED_OBJECTS = new Set(['globalThis', 'window', 'self']);
 
 /**
@@ -58,8 +60,8 @@ module.exports = {
 /**
  * Get the name (identifier) of a global scope of an BinaryExpression operator.
  *
- * @param {import('estree').Expression} node - The node to check.
- * @returns {string | null} Returns the name of the `node`, or null if not compared with a global scope identifier.
+ * @param {import('estree').Expression} node - The node to check
+ * @returns {string | null} Returns the name of the `node`, or null if not compared with a global scope identifier
  */
 function getExpressionValue (node) {
 	if (node.type === 'UnaryExpression' && node.operator === 'typeof' && node.argument.type === 'Identifier' && DISALLOWED_OBJECTS.has(node.argument.name)) {
@@ -73,7 +75,7 @@ function getExpressionValue (node) {
  * Check if a given `node` is a literal expression consisting of the text "undefined".
  *
  * @param {import('estree').Expression} node - The node to check
- * @returns {boolean} `true` if the node is a literal expression consisting of the text "undefined", otherwise `false`.
+ * @returns {boolean} `true` if the node is a literal expression consisting of the text "undefined", otherwise `false`
  */
 function checkLiteral (node) {
 	return (

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

@@ -2,6 +2,8 @@
  * @file ESLint rule which ensures that a `typeof` operant has more than one type in TypeScript, to prevent unnecessary checks of types at runtime.
  */
 
+/* eslint-disable unicorn/prefer-module -- For ESLint, we still need to rely on CommonJS modules */
+
 /** @typedef {ts.Type & { intrinsicName?: string; types?: ts.Type[]; objectFlags?: ts.ObjectFlags; }} Type */
 
 const ts = require('typescript');
@@ -69,9 +71,9 @@ module.exports = {
 /**
  * Check if the number of types equals one, and returns the type.
  *
- * @param {ts.TypeChecker} checker - TypeScript type checker.
- * @param {Type} type - TypeScript type node.
- * @returns {string | null} Type as string match the `typeof` string, or `null` if it's not a primitive type.
+ * @param {ts.TypeChecker} checker - TypeScript type checker
+ * @param {Type} type - TypeScript type node
+ * @returns {string | null} Type as string match the `typeof` string, or `null` if it's not a primitive type
  */
 function getSingleType (checker, type) {
 	if (isAnyOrUnknown(type)) {
@@ -100,9 +102,9 @@ function getSingleType (checker, type) {
 /**
  * Converts a TypeScript type into a `typeof` compatible string, or `null` if it's not a primitive type.
  *
- * @param {ts.TypeChecker} checker - TypeScript type checker.
- * @param {Type} type - TypeScript type node.
- * @returns {string | null} Type as string match the `typeof` string, or `null` if it's not a primitive type.
+ * @param {ts.TypeChecker} checker - TypeScript type checker
+ * @param {Type} type - TypeScript type node
+ * @returns {string | null} Type as string match the `typeof` string, or `null` if it's not a primitive type
  */
 function getTypeString (checker, type) {
 	if (isAnyOrUnknown(type)) {
@@ -130,8 +132,8 @@ function getTypeString (checker, type) {
 /**
  * Check if the type is either `any` or `unknown`, which represents multiple types.
  *
- * @param {ts.Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is either `any` or `unknown`, or an object which is based on `unknown`.
+ * @param {ts.Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is either `any` or `unknown`, or an object which is based on `unknown`
  */
 function isAnyOrUnknown (type) {
 	// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- `symbol` on Object is `undefined` for `Omit<unknown, 'undefined'>`
@@ -141,8 +143,8 @@ function isAnyOrUnknown (type) {
 /**
  * Checks if the given `type` is a `string`.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is a `string`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is a `string`
  */
 function isString (type) {
 	return [ts.TypeFlags.String, ts.TypeFlags.StringLiteral, ts.TypeFlags.StringMapping].includes(type.flags);
@@ -151,8 +153,8 @@ function isString (type) {
 /**
  * Checks if the given `type` is a `number`.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is a `number`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is a `number`
  */
 function isNumber (type) {
 	return [ts.TypeFlags.Number, ts.TypeFlags.NumberLiteral].includes(type.flags);
@@ -161,8 +163,8 @@ function isNumber (type) {
 /**
  * Checks if the given `type` is a `bigint`.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is a `bigint`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is a `bigint`
  */
 function isBigInt (type) {
 	return [ts.TypeFlags.BigInt, ts.TypeFlags.BigIntLiteral].includes(type.flags);
@@ -171,8 +173,8 @@ function isBigInt (type) {
 /**
  * Checks if the given `type` is a `boolean`.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is a `boolean`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is a `boolean`
  */
 function isBoolean (type) {
 	return [ts.TypeFlags.Boolean, ts.TypeFlags.BooleanLiteral].includes(type.flags);
@@ -181,8 +183,8 @@ function isBoolean (type) {
 /**
  * Checks if the given `type` is a `symbol`.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is a `symbol`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is a `symbol`
  */
 function isSymbol (type) {
 	return [ts.TypeFlags.ESSymbol, ts.TypeFlags.UniqueESSymbol].includes(type.flags);
@@ -191,8 +193,8 @@ function isSymbol (type) {
 /**
  * Checks if the given `type` is a `function`.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is a `function`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is a `function`
  */
 function isFunction (type) {
 	return (type.flags === ts.TypeFlags.Object && type.objectFlags === ts.ObjectFlags.Anonymous);
@@ -201,8 +203,8 @@ function isFunction (type) {
 /**
  * Checks if the given `type` is a `undefined`.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is `undefined`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is `undefined`
  */
 function isUndefined (type) {
 	return [ts.TypeFlags.Undefined].includes(type.flags);
@@ -213,8 +215,8 @@ function isUndefined (type) {
  *
  * We don't check `ts.TypeFlags.Object`, because for TypeScript Object seems to be the fallback for everything - even unknown types.
  *
- * @param {Type} type - TypeScript type node.
- * @returns {boolean} Returns `true` if the type is an `object`.
+ * @param {Type} type - TypeScript type node
+ * @returns {boolean} Returns `true` if the type is an `object`
  */
 function isObject (type) {
 	return [ts.TypeFlags.Null].includes(type.flags);

package/eslint/rules/restricted-filenames.js

@@ -2,6 +2,8 @@
  * @file ESLint rule which ensures that only files which match given glob patterns are part of your project.
  */
 
+/* eslint-disable unicorn/prefer-module -- For ESLint, we still need to rely on CommonJS modules */
+
 const path = require('node:path');
 
 const micromatch = require('micromatch');
@@ -87,7 +89,7 @@ module.exports = {
 		/**
 		 * Add rule listener which reports the error.
 		 *
-		 * @returns {import('eslint').Rule.RuleListener} Returns a `Program` rule lister which reports the error.
+		 * @returns {import('eslint').Rule.RuleListener} Returns a `Program` rule lister which reports the error
 		 */
 		function report () {
 			return {

package/helper/ensure-type.cjs

@@ -9,8 +9,8 @@
  *
  * @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.
+ * @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
  */
 function array (value) {
 	// @ts-expect-error -- Right now the type definition of `Array.isArray()` is incorrect since it uses `arg is any[]` instead of the correct type of `arg`.

package/helper/get-git-files.js

@@ -15,7 +15,7 @@ let gitFiles;
  * Returns a list of changed files based on Git.
  *
  * @public
- * @returns {Promise<string[]>} The list of changed files.
+ * @returns {Promise<string[]>} The list of changed files
  */
 export async function getGitFiles () {
 	if (!gitFilesProcessPromise) {

package/helper/get-outdated-dependencies.js

@@ -17,7 +17,7 @@ const dirname = path.dirname(fileURLToPath(import.meta.url));
  * Detects if installed versions of dependencies don't match to the required dependencies.
  *
  * @public
- * @returns {Promise<Dependency[]>} An array of missing overrides (=wrong versions).
+ * @returns {Promise<Dependency[]>} An array of missing overrides (=wrong versions)
  */
 export async function getOutdatedDependencies () {
 	const linterBundleDependencies = JSON.parse(await fs.readFile(path.resolve(dirname, '../package.json'), 'utf8')).dependencies;

package/helper/get-outdated-overrides.js

@@ -17,7 +17,7 @@ const dirname = path.dirname(fileURLToPath(import.meta.url));
  * Detects outdated "overrides"/"resolutions" dependencies.
  *
  * @public
- * @returns {Promise<{ overrides: Dependency[]; resolutions: Dependency[]; }>} Either the input array, or an empty array, if the input array is not an array.
+ * @returns {Promise<{ overrides: Dependency[]; resolutions: Dependency[]; }>} Either the input array, or an empty array, if the input array is not an array
  */
 export async function getOutdatedOverrides () {
 	const linterBundleDependencies = JSON.parse(await fs.readFile(path.resolve(dirname, '../package.json'), 'utf8')).dependencies;

package/helper/get-stylelint-path.js

@@ -12,7 +12,7 @@ const require = createRequire(import.meta.url);
  * Returns if the project is using npm or yarn.
  *
  * @public
- * @returns {Promise<string | null>} Return the path to the Stylelint CLI script, or `null` if it can't be found.
+ * @returns {Promise<string | null>} Return the path to the Stylelint CLI script, or `null` if it can't be found
  */
 export async function getStylelintPath () {
 	const stylelintLibPath = path.dirname(require.resolve('stylelint'));

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

@@ -9,7 +9,7 @@ import * as path from 'node:path';
  * Returns if the project is using npm or yarn.
  *
  * @public
- * @returns {Promise<'none' | 'npm' | 'yarn' | 'both'>} Returns which package manager name.
+ * @returns {Promise<'none' | 'npm' | 'yarn' | 'both'>} Returns which package manager name
  */
 export async function isNpmOrYarn () {
 	let npm = false;

package/helper/linter-bundle-config.js

@@ -16,20 +16,26 @@ export const linterBundleConfig = (
 /**
  * Load a config file if it exist.
  *
- * @param {string} fileName - The name of the config file
- * @returns {Promise<import('./linter-bundle-config.js').LinterBundleConfig | undefined>} - Either the file content for `undefined` if the file does not exist.
+ * @param {string} fileName - The name of the config file in the current working directory
+ * @returns {Promise<import('./linter-bundle-config.js').LinterBundleConfig | undefined>} Either the file content for `undefined` if the file does not exist
  * */
 async function loadConfig (fileName) {
+	const filePath = path.join(process.cwd(), fileName);
+
+	if (!await fs.access(filePath, fs.constants.F_OK).then(() => true).catch(() => false)) {
+		return;
+	}
+
 	try {
 		if (fileName.endsWith('.json')) {
-			const content = await fs.readFile(path.join(process.cwd(), fileName), 'utf8');
+			const content = await fs.readFile(filePath, 'utf8');
 
 			return JSON.parse(content);
 		}
 
-		const filePath = path.join('file://', process.cwd(), fileName);
+		const fileUri = path.join('file://', filePath);
 
-		const config = await import(filePath);
+		const config = await import(fileUri);
 
 		if ('default' in config) {
 			return config.default;
@@ -37,7 +43,16 @@ async function loadConfig (fileName) {
 
 		return config;
 	}
-	catch {
-		return;
+	catch (error) {
+		process.stderr.write(`Error reading ${filePath}\n`);
+
+		if (error instanceof Error) {
+			process.stderr.write(`${error.stack}\n`);
+		}
+		else {
+			process.stderr.write(`${error}\n`);
+		}
 	}
+
+	return;
 }

package/helper/run-process.js

@@ -11,8 +11,8 @@ import * as os from 'node:os';
  * Executes a process asynchronously.
  *
  * @public
- * @param {string} command - The process to execute.
- * @param {childProcess.ExecOptions | undefined} [options] - The options of the `childProcess.exec()` method.
+ * @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
  */
 export async function runProcess (command, options) {
@@ -33,7 +33,7 @@ export async function runProcess (command, options) {
 				...options?.env,
 				LINTER_BUNDLE: '1'
 			},
-			shell: os.userInfo().shell
+			shell: os.userInfo().shell ?? undefined
 		});
 
 		lintingProcess.stdout?.on('data', (/** @type {string} */data) => {