linter-bundle 7.4.0 → 7.6.0

package/.linter-bundle.schema.json

@@ -104,8 +104,33 @@
 			},
 			"additionalProperties": false
 		},
+		"css": {
+			"type": "object",
+			"properties": {
+				"verbose": {
+					"type": "boolean"
+				},
+				"timing": {
+					"type": "boolean"
+				},
+				"git": {
+					"type": "boolean"
+				},
+				"include": {
+					"type": "array",
+					"items": {
+						"type": "string"
+					}
+				},
+				"patternPrefix": {
+					"type": "string"
+				}
+			},
+			"additionalProperties": false
+		},
 		"sass": {
 			"type": "object",
+			"deprecated": true,
 			"properties": {
 				"verbose": {
 					"type": "boolean"

package/CHANGELOG.md

@@ -6,7 +6,57 @@ 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/v7.4.0...HEAD)
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v7.6.0...HEAD)
+
+## [7.6.0] - 2025-05-14
+
+- [general] Added support for `.css` files in ESLint and Stylelint rules
+- [eslint] Updated `eslint` from `9.24.0` to `9.26.0`
+- [eslint] Updated `eslint-import-resolver-typescript` from `4.3.2` to `4.3.4`
+- [eslint] Updated `eslint-plugin-jsdoc` from `50.6.9` to `50.6.17`
+- [eslint] Updated `eslint-plugin-n` from `17.17.0` to `17.18.0`
+- [eslint] Updated `eslint-plugin-unicorn` from `58.0.0` to `59.0.1`
+- [eslint] Updated `globals` from `16.0.0` to `16.1.0`
+- [eslint] Updated `typescript-eslint` from `8.29.1` to `8.32.1`
+- [stylelint] Updated `stylelint` from `16.18.0` to `16.19.1`
+- [stylelint] Updated `stylelint-order` from `6.0.4` to `7.0.0`
+- [stylelint] Updated `stylelint-scss` from `6.11.1` to `6.12.0`
+- [eslint] Renamed `unicorn/no-array-push-push` rule to `prefer-single-call`
+- [eslint] Renamed `unicorn/no-length-as-slice-end` rule to `no-unnecessary-slice-end`
+- [eslint] Added but disabled [`unicorn/prefer-import-meta-properties`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-import-meta-properties.md) rule
+- [eslint] Added [`unicorn/no-unnecessary-array-flat-depth`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-unnecessary-array-flat-depth.md) rule
+- [eslint] Added [`unicorn/no-unnecessary-array-splice-count`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-unnecessary-array-splice-count.md) rule
+- [eslint] Activated [`unicorn/prefer-event-target`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-event-target.md) rule
+- [eslint] Activated [`unicorn/prefer-top-level-await`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-top-level-await.md) rule
+- [eslint] Added [`@typescript-eslint/no-unnecessary-type-conversion`](https://typescript-eslint.io/rules/no-unnecessary-type-conversion/) rule
+- [stylelint] Activated [`selector-not-notation`](https://stylelint.io/user-guide/rules/selector-not-notation/) rule with "complex" option
+
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v7.5.0...v7.6.0)
+
+## [7.5.0] - 2025-04-08
+
+- [eslint] Updated `eslint` from `9.23.0` to `9.24.0`
+- [eslint] Updated `eslint-import-resolver-typescript` from `4.2.2` to `4.3.2`
+- [eslint] Updated `eslint-plugin-jsdoc` from `50.6.8` to `50.6.9`
+- [eslint] Updated `eslint-plugin-n` from `17.16.2` to `17.17.0`
+- [eslint] Updated `eslint-plugin-react` from `7.37.4` to `7.37.5`
+- [eslint] Updated `eslint-plugin-unicorn` from `57.0.0` to `58.0.0`
+- [eslint] Updated `typescript-eslint` from `8.27.0` to `8.29.1`
+- [stylelint] Updated `stylelint` from `16.16.0` to `16.18.0`
+- [eslint] Disabled [`unicorn/prefer-global-this`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-global-this.md) rule
+- [eslint] Disabled [`unicorn/prefer-string-raw`](https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-string-raw.md) rule
+- [stylelint] Added new [`color-function-alias-notation`](https://github.com/stylelint/stylelint/blob/main/lib/rules/color-function-alias-notation/README.md) rule and set it to `without-alpha`
+- [stylelint] Added new [`container-name-pattern`](https://github.com/stylelint/stylelint/blob/main/lib/rules/container-name-pattern/README.md) rule and apply `sass` > `patternPrefix` from the linter-bundle configuration, if set
+- [stylelint] Added new [`layer-name-pattern`](https://github.com/stylelint/stylelint/blob/main/lib/rules/layer-name-pattern/README.md) rule and apply `sass` > `patternPrefix` from the linter-bundle configuration, if set
+
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v7.4.0...v7.5.0)
+
+### Changed
+
+- [eslint] Updated `eslint` from `9.22.0` to `9.23.0`
+- [eslint/react] Activated `allowExpressions` of the `@typescript-eslint/explicit-function-return-type`rule also for the React overrides
+
+[Show all code changes](https://github.com/jens-duttke/linter-bundle/compare/v7.3.0...v7.4.0)
 
 ## [7.4.0] - 2025-03-23
 

package/README.md

@@ -9,7 +9,7 @@
 Ready-to use bundle of linting tools, containing configurations for
 
 - [ESLint](https://eslint.org/): JavaScript (Node.js); TypeScript, React (Browser)
-- [stylelint](https://stylelint.io/): SCSS (Browser)
+- [stylelint](https://stylelint.io/): CSS, SCSS (Browser)
 - [markdownlint](https://github.com/DavidAnson/markdownlint): Markdown
 - [better-npm-audit](https://www.npmjs.com/package/better-npm-audit): Security audit using `npm`
 - [improved-yarn-audit](https://www.npmjs.com/package/improved-yarn-audit): Security audit using `yarn`
@@ -84,8 +84,8 @@ npm install linter-bundle --save-dev
 ```json
 {
   "scripts": {
-    "lint": "lint tsc ts sass md audit",
-    "lint-different-configurations": "lint tsc --tsconfig=./path1/tsconfig.json tsc --tsconfig=./path2/tsconfig.json ts sass md audit"
+    "lint": "lint tsc ts css md audit",
+    "lint-different-configurations": "lint tsc --tsconfig=./path1/tsconfig.json tsc --tsconfig=./path2/tsconfig.json ts css md audit"
   }
 }
 ```
@@ -224,8 +224,8 @@ The file itself, and any of the options is optional.
       }
     }
   },
-  "sass": {
-    "include": ["./included/*.ts"],
+  "css": {
+    "include": ["./included/*.css"],
     "patternPrefix": "(my-prefix|another-prefix)"
   },
   "md": {
@@ -405,9 +405,9 @@ export default {
   },
 
   /**
-   * Configuration, specific to the `sass` command.
+   * Configuration, specific to the `css` command.
    */
-  sass: {
+  css: {
     /**
      * `verbose`, `timing` and `git` are the same as in the root node.
      */
@@ -420,7 +420,7 @@ export default {
      * 
      * @type {string[]}
      */
-    include: ['./included/*.ts'],
+    include: ['./included/*.css'],
 
     /**
      * The prefix used for the 'custom-media-pattern' (`@media (--my-prefix-foo)`) and 'custom-property-pattern' (`var(--my-prefix-bar)`) rule.
@@ -444,7 +444,7 @@ export default {
      * 
      * @type {string[]}
      */
-    include: ['./included/*.ts']
+    include: ['./included/*.md']
   },
 
   /**
@@ -532,7 +532,7 @@ The command line arguments are separated in groups. Here are some examples:
 
 ```sh
 # Run File restrictions, TypeScript compiler, ESLint, Stylelint, Markdownlint, and audit in the given order, using the default configuration
-lint files tsc ts sass md audit
+lint files tsc ts css md audit
 
 # Run ESLint and Audit, and show their terminal output even on success
 lint --verbose ts audit
@@ -593,12 +593,12 @@ Argument | Description | Example
 `--include` | Patterns with files which should be considered | `--include="./cypress/**/*.ts"`
 `--exclude` | Patterns with files which should not be considered. Can be used multiple times for different patterns. Used as `--ignore-pattern` argument for ESLint. | `--exclude="cypress" --exclude=".storybook"`
 
-### `lint sass`
+### `lint css`
 
 Will execute:
 
 ```sh
-stylelint "src/**/*.scss" --formatter unix --report-needless-disables --report-invalid-scope-disables --report-descriptionless-disables
+stylelint "src/**/*.{css,scss}" --formatter unix --report-needless-disables --report-invalid-scope-disables --report-descriptionless-disables
 ```
 
 ### `lint md`
@@ -668,7 +668,8 @@ To ensure the stylelint plugins are correctly loaded, you need to adjust the set
 ```json
 {
   "stylelint.enable": true,
-  "stylelint.validate": [
+  "stylelint.validate": [,
+    "css",
     "scss"
   ],
   "css.validate": false,
@@ -702,6 +703,9 @@ To visualize the max line-length rules in VSCode, you can activate rulers, by ad
   "[markdown]": {
     "editor.rulers": [300]
   },
+  "[css]": {
+    "editor.rulers": [160]
+  },
   "[scss]": {
     "editor.rulers": [160]
   },

package/eslint/index.mjs

@@ -782,6 +782,7 @@ export default [
 			'@typescript-eslint/no-unnecessary-type-arguments': 'error',
 			'@typescript-eslint/no-unnecessary-type-assertion': 'error',
 			'@typescript-eslint/no-unnecessary-type-constraint': 'error',
+			'@typescript-eslint/no-unnecessary-type-conversion': 'error',
 			'@typescript-eslint/no-unnecessary-type-parameters': 'error',
 			'@typescript-eslint/no-unsafe-argument': 'error',
 			'@typescript-eslint/no-unsafe-assignment': 'error',
@@ -921,6 +922,7 @@ export default [
 			'import/no-self-import': 'error',
 			'import/no-unassigned-import': ['error', {
 				allow: [
+					'**/*.css',
 					'**/*.scss',
 					'jest-extended'
 				]
@@ -1030,6 +1032,12 @@ export default [
 						namespace: true,
 						named: false
 					},
+					'./styles.module.css': {
+						unassigned: false,
+						default: false,
+						namespace: true,
+						named: false
+					},
 					'./styles.module.scss': {
 						unassigned: false,
 						default: false,
@@ -1044,7 +1052,6 @@ export default [
 			'unicorn/no-array-callback-reference': 'off', // If I use functions, they are the best option for this use-case
 			'unicorn/no-array-for-each': 'error',
 			'unicorn/no-array-method-this-argument': 'error',
-			'unicorn/no-array-push-push': 'error',
 			'unicorn/no-array-reduce': ['error', { allowSimpleOperations: true }],
 			'unicorn/no-await-expression-member': 'error',
 			'unicorn/no-console-spaces': 'error',
@@ -1056,7 +1063,6 @@ export default [
 			'unicorn/no-invalid-fetch-options': 'error',
 			'unicorn/no-invalid-remove-event-listener': 'error',
 			'unicorn/no-keyword-prefix': 'off',
-			'unicorn/no-length-as-slice-end': 'error',
 			'unicorn/no-lonely-if': 'off', // Sometimes the code is clearer if-conditions are not combined
 			'unicorn/no-magic-array-flat-depth': 'error',
 			'unicorn/no-named-default': 'error',
@@ -1072,8 +1078,11 @@ export default [
 			'unicorn/no-thenable': 'error',
 			'unicorn/no-this-assignment': 'error',
 			'unicorn/no-typeof-undefined': 'error',
+			'unicorn/no-unnecessary-array-flat-depth': 'error',
+			'unicorn/no-unnecessary-array-splice-count': 'error',
 			'unicorn/no-unnecessary-await': 'error',
 			'unicorn/no-unnecessary-polyfills': 'error',
+			'unicorn/no-unnecessary-slice-end': 'error',
 			'unicorn/no-unreadable-array-destructuring': 'error',
 			'unicorn/no-unreadable-iife': 'error',
 			'unicorn/no-unused-properties': 'error',
@@ -1101,9 +1110,10 @@ export default [
 			'unicorn/prefer-dom-node-dataset': 'off', // `setAttribute` is faster than `dataset`. See https://www.measurethat.net/Benchmarks/Show/7740/0/classname-vs-setattribute-vs-classlist-vs-dataset
 			'unicorn/prefer-dom-node-remove': 'error',
 			'unicorn/prefer-dom-node-text-content': 'error',
-			'unicorn/prefer-event-target': 'off', // @todo Disabled for now, since `EventTarget` requires Node.js 16. Activate in 2025
+			'unicorn/prefer-event-target': 'error',
 			'unicorn/prefer-export-from': ['error', { ignoreUsedVariables: true }],
-			'unicorn/prefer-global-this': 'error',
+			'unicorn/prefer-global-this': 'off', // This makes only sense if the same code may run on the server-side. Often the auto-fixing of this rule doesn't make sense
+			'unicorn/prefer-import-meta-properties': 'off', // @todo Regarding `n/no-unsupported-features/node-builtins` it's still an experimental feature, so check back in 2026
 			'unicorn/prefer-includes': 'error',
 			'unicorn/prefer-json-parse-buffer': 'off', // TypeScript states that string needs to be used as of the ES specification. @see https://github.com/microsoft/TypeScript/issues/11842
 			'unicorn/prefer-keyboard-event-key': 'error',
@@ -1116,7 +1126,6 @@ export default [
 			'unicorn/prefer-native-coercion-functions': 'off',
 			'unicorn/prefer-negative-index': 'error',
 			'unicorn/prefer-number-properties': 'error',
-			'unicorn/prefer-object-has-own': 'off', // Not widely supported yet. Can be activated in 2024
 			'unicorn/prefer-object-from-entries': 'error',
 			'unicorn/prefer-optional-catch-binding': 'error',
 			'unicorn/prefer-prototype-methods': 'error',
@@ -1124,8 +1133,9 @@ export default [
 			'unicorn/prefer-reflect-apply': 'error',
 			'unicorn/prefer-set-has': 'error',
 			'unicorn/prefer-set-size': 'error',
+			'unicorn/prefer-single-call': '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-raw': 'error',
+			'unicorn/prefer-string-raw': 'off', // The overhead of writing String.raw`...` is not worth the inconsistency in writing strings
 			'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',
@@ -1133,7 +1143,7 @@ export default [
 			'unicorn/prefer-structured-clone': 'error',
 			'unicorn/prefer-switch': 'error',
 			'unicorn/prefer-ternary': 'off', // We prefer readability over saving a few chars
-			'unicorn/prefer-top-level-await': 'off', // @todo Available since 2021. Activate in 2024
+			'unicorn/prefer-top-level-await': 'error',
 			'unicorn/prefer-regexp-test': 'error',
 			'unicorn/prefer-type-error': 'error',
 			'unicorn/prevent-abbreviations': ['error', { ignore: ['args', 'i', 'j', 'i18n', /[Rr]ef/u, /[Pp]arams/u, /[Pp]rops/u] }],

package/eslint/type-declarations.mjs

@@ -36,14 +36,17 @@ export default [
 		}
 	},
 	{
-		files: ['**/*.scss.d.ts'],
+		files: [
+			'**/*.css.d.ts',
+			'**/*.scss.d.ts'
+		],
 		rules: {
 			/**
 			 * eslint
 			 *
 			 * @see https://eslint.org/docs/rules/
 			 */
-			'linebreak-style': 'off' // Ignore for automatically generated .scss.d.ts files, since that does not affect the project.
+			'linebreak-style': 'off' // Ignore for automatically generated .(s)css.d.ts files, since that does not affect the project.
 		}
 	}
 ];

package/helper/get-git-files.js

@@ -18,16 +18,14 @@ let gitFiles;
  * @returns {Promise<string[]>} The list of changed files
  */
 export async function getGitFiles () {
-	if (!gitFilesProcessPromise) {
-		gitFilesProcessPromise = {
-			// Returns changed files, also stashed and committed
-			diff: runProcess('git diff --name-only -z @{upstream}'),
-			// Returns unstashed files (including deleted)
-			modified: runProcess('git ls-files -o -m --exclude-standard --full-name --deduplicate -z'),
-			// Returns unstashed, deleted files - @todo Is there a way to also get a list of deleted stashed/committed files?
-			deleted: runProcess('git ls-files -d --exclude-standard --full-name --deduplicate -z')
-		};
-	}
+	gitFilesProcessPromise ??= {
+		// Returns changed files, also stashed and committed
+		diff: runProcess('git diff --name-only -z @{upstream}'),
+		// Returns unstashed files (including deleted)
+		modified: runProcess('git ls-files -o -m --exclude-standard --full-name --deduplicate -z'),
+		// Returns unstashed, deleted files - @todo Is there a way to also get a list of deleted stashed/committed files?
+		deleted: runProcess('git ls-files -d --exclude-standard --full-name --deduplicate -z')
+	};
 
 	const gitProcessResult = {
 		diff: await gitFilesProcessPromise.diff,

package/helper/linter-bundle-config.d.ts

@@ -58,6 +58,10 @@ export interface LinterBundleConfig {
 			/* eslint-enable @typescript-eslint/naming-convention */
 		};
 	};
+	css?: {
+		patternPrefix?: string;
+	};
+	/** @deprecated */
 	sass?: {
 		patternPrefix?: string;
 	};

package/lint.js

@@ -23,7 +23,7 @@ const require = createRequire(import.meta.url);
 const dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /**
- * @typedef {'files' | 'tsc' | 'ts' | 'sass' | 'md' | 'audit'} TaskNames
+ * @typedef {'files' | 'tsc' | 'ts' | 'css' | 'sass' | 'md' | 'audit'} TaskNames
  * @typedef {Partial<Record<string, (string | boolean)[]>>} TaskConfig
  * @typedef {import('./helper/run-process.js').ProcessResult} ProcessResult
  * @typedef {{ taskName: TaskNames; taskConfig: TaskConfig; }} TaskNameAndConfig
@@ -52,6 +52,7 @@ await (async () => {
 			case 'ts':
 				return runESLintTask(taskName, taskConfig);
 
+			case 'css':
 			case 'sass':
 				return runStylelintTask(taskName, taskConfig);
 
@@ -214,7 +215,7 @@ async function runESLintTask (taskName, taskConfig) {
 }
 
 /**
- * Runs the `sass` task.
+ * Runs the `css` task.
  *
  * @param {TaskNameAndConfig['taskName']} taskName - Name of the task as used in the command line
  * @param {TaskNameAndConfig['taskConfig']} taskConfig - Configuration of the task
@@ -227,7 +228,7 @@ async function runStylelintTask (taskName, taskConfig) {
 		verbose: getConfigValue(taskName, taskConfig, 'verbose')
 	};
 
-	const includes = await getIncludes(newTaskConfig, 'src/**/*.scss');
+	const includes = await getIncludes(newTaskConfig, 'src/**/*.{css,scss}');
 
 	if (!includes) {
 		return generateDummyJobOutput(taskName, newTaskConfig, {
@@ -415,7 +416,7 @@ async function validateEnvironment () {
  * @throws {Error} If no task has be specified in the arguments
  */
 function getTasksToRun (argv) {
-	const TASKS = new Set(['tsc', 'ts', 'sass', 'md', 'audit', 'files']);
+	const TASKS = new Set(['tsc', 'ts', 'css', 'sass', 'md', 'audit', 'files']);
 	const ARG_REGEXP = /^--([^=]+)(?:=(.+))?$/u;
 
 	/** @type {TaskNameAndConfig | null} */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "linter-bundle",
-	"version": "7.4.0",
+	"version": "7.6.0",
 	"type": "module",
 	"description": "Ready-to use bundle of linting tools, containing configurations for ESLint, stylelint and markdownlint.",
 	"keywords": [
@@ -15,7 +15,8 @@
 		"react",
 		"react-hooks",
 		"unicorn",
-		"scss"
+		"scss",
+		"css"
 	],
 	"author": "Jens Duttke <github@duttke.de> (https://github.com/jens-duttke)",
 	"license": "MIT",
@@ -43,32 +44,32 @@
 	"dependencies": {
 		"@stylistic/eslint-plugin": "4.2.0",
 		"@stylistic/eslint-plugin-jsx": "4.2.0",
-		"eslint": "9.23.0",
+		"eslint": "9.26.0",
 		"eslint-formatter-unix": "8.40.0",
-		"eslint-import-resolver-typescript": "4.2.2",
+		"eslint-import-resolver-typescript": "4.3.4",
 		"eslint-import-resolver-webpack": "0.13.10",
 		"eslint-plugin-eslint-comments": "3.2.0",
 		"eslint-plugin-functional": "9.0.1",
 		"eslint-plugin-import": "2.31.0",
 		"eslint-plugin-jest": "28.11.0",
-		"eslint-plugin-jsdoc": "50.6.8",
+		"eslint-plugin-jsdoc": "50.6.17",
 		"eslint-plugin-jsx-a11y": "6.10.2",
-		"eslint-plugin-n": "17.16.2",
+		"eslint-plugin-n": "17.18.0",
 		"eslint-plugin-promise": "7.2.1",
-		"eslint-plugin-react": "7.37.4",
+		"eslint-plugin-react": "7.37.5",
 		"eslint-plugin-react-hooks": "5.2.0",
-		"eslint-plugin-unicorn": "57.0.0",
-		"globals": "16.0.0",
+		"eslint-plugin-unicorn": "59.0.1",
+		"globals": "16.1.0",
 		"markdownlint-cli": "0.44.0",
 		"micromatch": "4.0.8",
 		"postcss-scss": "4.0.9",
-		"stylelint": "16.16.0",
+		"stylelint": "16.19.1",
 		"stylelint-declaration-block-no-ignored-properties": "2.8.0",
 		"stylelint-high-performance-animation": "1.11.0",
-		"stylelint-order": "6.0.4",
-		"stylelint-scss": "6.11.1",
+		"stylelint-order": "7.0.0",
+		"stylelint-scss": "6.12.0",
 		"stylelint-use-logical-spec": "5.0.1",
-		"typescript-eslint": "8.27.0"
+		"typescript-eslint": "8.32.1"
 	},
 	"peerDependencies": {
 		"@typescript-eslint/utils": "*",
@@ -78,8 +79,8 @@
 	"devDependencies": {
 		"@types/eslint": "9.6.1",
 		"@types/micromatch": "4.0.9",
-		"@types/node": "22.13.11",
+		"@types/node": "22.15.18",
 		"stylelint-find-new-rules": "5.0.0",
-		"typescript": "5.8.2"
+		"typescript": "5.8.3"
 	}
 }