@darksheep/eslint 7.0.3 → 8.0.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [8.0.0](https://github.com/DarkSheepSoftware/eslint/compare/v7.0.4...v8.0.0) (2025-07-19)
+
+
+### ⚠ BREAKING CHANGES
+
+* **pkg:** update dependency @stylistic/eslint-plugin to v5 ([#937](https://github.com/DarkSheepSoftware/eslint/issues/937))
+
+### 📦 Dependencies
+
+* **pkg:** update dependency @eslint/compat to v1.3.1 ([#943](https://github.com/DarkSheepSoftware/eslint/issues/943)) ([3ed5836](https://github.com/DarkSheepSoftware/eslint/commit/3ed5836c91757adddd97e13caa022275a6b80aef))
+* **pkg:** update dependency @stylistic/eslint-plugin to v5 ([#937](https://github.com/DarkSheepSoftware/eslint/issues/937)) ([f6b7cf3](https://github.com/DarkSheepSoftware/eslint/commit/f6b7cf3308acae3bc2bfa25de72da854afa2fb00))
+* **pkg:** update dependency editorconfig to v3.0.1 ([#954](https://github.com/DarkSheepSoftware/eslint/issues/954)) ([5f7a87d](https://github.com/DarkSheepSoftware/eslint/commit/5f7a87dc7a8d3baacb7bfce3bf5836427fcb042d))
+* **pkg:** update dependency eslint-plugin-jsdoc to v51.2.3 ([#938](https://github.com/DarkSheepSoftware/eslint/issues/938)) ([6cbc878](https://github.com/DarkSheepSoftware/eslint/commit/6cbc87875c4c32bcb80dec76e5b48baac2001159))
+* **pkg:** update dependency eslint-plugin-jsdoc to v51.3.1 ([#946](https://github.com/DarkSheepSoftware/eslint/issues/946)) ([949c67b](https://github.com/DarkSheepSoftware/eslint/commit/949c67b529383140dde4b8173d9a8a85bfe18495))
+* **pkg:** update dependency eslint-plugin-jsdoc to v51.4.1 ([#952](https://github.com/DarkSheepSoftware/eslint/issues/952)) ([b566232](https://github.com/DarkSheepSoftware/eslint/commit/b56623212f3f8d0c6b2bb77e2e9168e991ba8a51))
+* **pkg:** update dependency eslint-plugin-n to v17.21.0 ([#953](https://github.com/DarkSheepSoftware/eslint/issues/953)) ([a2b6518](https://github.com/DarkSheepSoftware/eslint/commit/a2b6518c60eadbd3b7cc91e00c97796da254f4db))
+* **pkg:** update dependency eslint-plugin-package-json to v0.42.0 ([#939](https://github.com/DarkSheepSoftware/eslint/issues/939)) ([c7e1459](https://github.com/DarkSheepSoftware/eslint/commit/c7e145933318e8758e334f666eb0ba325f88dbd5))
+* **pkg:** update dependency eslint-plugin-package-json to v0.45.1 ([#949](https://github.com/DarkSheepSoftware/eslint/issues/949)) ([ab071a3](https://github.com/DarkSheepSoftware/eslint/commit/ab071a312e971e9cbd5aca69e1159bb60f2957a1))
+* **pkg:** update eslint monorepo to v9.30.0 ([#944](https://github.com/DarkSheepSoftware/eslint/issues/944)) ([c82ce1d](https://github.com/DarkSheepSoftware/eslint/commit/c82ce1d510a3ac0784c85302d00411cf369cc6dd))
+* **pkg:** update eslint monorepo to v9.31.0 ([#950](https://github.com/DarkSheepSoftware/eslint/issues/950)) ([196315b](https://github.com/DarkSheepSoftware/eslint/commit/196315bc9343a405d3deb0024af7ae4e40acbb2a))
+* **pkg:** update typescript-eslint monorepo to v8.35.0 ([#940](https://github.com/DarkSheepSoftware/eslint/issues/940)) ([c84b7ca](https://github.com/DarkSheepSoftware/eslint/commit/c84b7caa6cd4e4db1c248a5b18952a4d177e6a82))
+* **pkg:** update typescript-eslint monorepo to v8.37.0 ([#948](https://github.com/DarkSheepSoftware/eslint/issues/948)) ([fe66757](https://github.com/DarkSheepSoftware/eslint/commit/fe667578e323520bdc46970c44fe2a3f54a8eb18))
+
+
+### 🧹 Chores
+
+* handle being passed a file or a directory in listParents ([#955](https://github.com/DarkSheepSoftware/eslint/issues/955)) ([6dd86ec](https://github.com/DarkSheepSoftware/eslint/commit/6dd86ec2389799eacbe65b5f33bfd698570cc7ab))
+
+## [7.0.4](https://github.com/DarkSheepSoftware/eslint/compare/v7.0.3...v7.0.4) (2025-06-23)
+
+
+### 📦 Dependencies
+
+* **pkg:** update dependency @eslint/compat to v1.3.0 ([#933](https://github.com/DarkSheepSoftware/eslint/issues/933)) ([58c0c2e](https://github.com/DarkSheepSoftware/eslint/commit/58c0c2ef92d90fd957357989b5e5ad247acde82f))
+* **pkg:** update dependency @stylistic/eslint-plugin to v4.4.1 ([#931](https://github.com/DarkSheepSoftware/eslint/issues/931)) ([38be175](https://github.com/DarkSheepSoftware/eslint/commit/38be175542edb2dd83cf68f6402032bbc9f9d1a6))
+* **pkg:** update dependency editorconfig to v3 ([#932](https://github.com/DarkSheepSoftware/eslint/issues/932)) ([07d4528](https://github.com/DarkSheepSoftware/eslint/commit/07d452847584757ae288edb7e1a02e88b2a0ddd3))
+* **pkg:** update dependency eslint-plugin-jsdoc to v51 ([#934](https://github.com/DarkSheepSoftware/eslint/issues/934)) ([90c3ac8](https://github.com/DarkSheepSoftware/eslint/commit/90c3ac8cb4a7736342e2debe9078e72758fed413))
+* **pkg:** update dependency eslint-plugin-jsdoc to v51.2.1 ([#936](https://github.com/DarkSheepSoftware/eslint/issues/936)) ([6a33cbc](https://github.com/DarkSheepSoftware/eslint/commit/6a33cbcd52fdde7a076f404f3d78ec82285dff73))
+* **pkg:** update dependency eslint-plugin-n to v17.20.0 ([#926](https://github.com/DarkSheepSoftware/eslint/issues/926)) ([2750e25](https://github.com/DarkSheepSoftware/eslint/commit/2750e25208acc3f8522eb853ee561552d3abed9b))
+* **pkg:** update dependency eslint-plugin-package-json to v0.40.4 ([#923](https://github.com/DarkSheepSoftware/eslint/issues/923)) ([939df2e](https://github.com/DarkSheepSoftware/eslint/commit/939df2ebbedff1f5cb09cc5c28a4ec2bb8c68326))
+* **pkg:** update dependency eslint-plugin-perfectionist to v4.15.0 ([#929](https://github.com/DarkSheepSoftware/eslint/issues/929)) ([55705ad](https://github.com/DarkSheepSoftware/eslint/commit/55705ad278908c86568e6799651690a0d1ab4961))
+* **pkg:** update dependency eslint-plugin-regexp to v2.9.0 ([#930](https://github.com/DarkSheepSoftware/eslint/issues/930)) ([9c6f830](https://github.com/DarkSheepSoftware/eslint/commit/9c6f83086e42098532c40a9b3986bb7c00cc0589))
+* **pkg:** update eslint monorepo to v9.29.0 ([#922](https://github.com/DarkSheepSoftware/eslint/issues/922)) ([a920659](https://github.com/DarkSheepSoftware/eslint/commit/a920659a22cd765d3bc6d5c91ac5df9b374009a8))
+* **pkg:** update typescript-eslint monorepo to v8.34.1 ([#927](https://github.com/DarkSheepSoftware/eslint/issues/927)) ([3913a3b](https://github.com/DarkSheepSoftware/eslint/commit/3913a3bf3bc47442722d6359ebefef24a4f6232d))
+
 ## [7.0.3](https://github.com/DarkSheepSoftware/eslint/compare/v7.0.2...v7.0.3) (2025-05-28)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksheep/eslint",
-  "version": "7.0.3",
+  "version": "8.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/DarkSheepSoftware/eslint"
@@ -24,21 +24,21 @@
   "dependencies": {
     "@darksheep/environment": "3.1.0",
     "@eslint-community/eslint-plugin-eslint-comments": "4.5.0",
-    "@eslint/compat": "1.2.9",
-    "@eslint/js": "9.27.0",
-    "@stylistic/eslint-plugin": "4.4.0",
-    "@typescript-eslint/eslint-plugin": "8.33.0",
-    "@typescript-eslint/parser": "8.33.0",
-    "editorconfig": "2.0.1",
-    "eslint-plugin-jsdoc": "50.6.17",
+    "@eslint/compat": "1.3.1",
+    "@eslint/js": "9.31.0",
+    "@stylistic/eslint-plugin": "5.2.0",
+    "@typescript-eslint/eslint-plugin": "8.37.0",
+    "@typescript-eslint/parser": "8.37.0",
+    "editorconfig": "3.0.1",
+    "eslint-plugin-jsdoc": "51.4.1",
     "eslint-plugin-jsonc": "2.20.1",
-    "eslint-plugin-n": "17.18.0",
-    "eslint-plugin-package-json": "0.31.0",
-    "eslint-plugin-perfectionist": "4.13.0",
+    "eslint-plugin-n": "17.21.0",
+    "eslint-plugin-package-json": "0.45.1",
+    "eslint-plugin-perfectionist": "4.15.0",
     "eslint-plugin-promise": "7.2.1",
     "eslint-plugin-react": "7.37.5",
     "eslint-plugin-react-native": "5.0.0",
-    "eslint-plugin-regexp": "2.7.0",
+    "eslint-plugin-regexp": "2.9.0",
     "eslint-plugin-security": "3.0.1",
     "eslint-plugin-unicorn": "59.0.1",
     "eslint-plugin-unused-imports": "4.1.4",
@@ -48,8 +48,8 @@
   },
   "devDependencies": {
     "@darksheep/eslint-formatter-github": "2.1.0",
-    "@types/node": "~22.15.0",
-    "eslint": "~9.27.0",
+    "@types/node": "~22.16.0",
+    "eslint": "~9.31.0",
     "type-fest": "~4.41.0",
     "typescript": "~5.8.0"
   },
@@ -61,12 +61,12 @@
       "optional": true
     }
   },
-  "packageManager": "yarn@4.9.1",
+  "packageManager": "yarn@4.9.2",
   "engines": {
     "node": "^20 || ^22"
   },
   "volta": {
-    "node": "22.16.0",
-    "yarn": "4.9.1"
+    "node": "22.17.1",
+    "yarn": "4.9.2"
   }
 }

package/src/configs/eslint-recommended.js

@@ -1,12 +1,33 @@
+/**
+ * @import { Linter } from 'eslint'
+ */
+
 import js from '@eslint/js';
 
+/** @type {Linter.RuleEntry} */
+export const unusedConfig = [
+  'error', {
+    argsIgnorePattern: '^_',
+    varsIgnorePattern: '^_',
+    args: 'after-used',
+    vars: 'local',
+  },
+];
+
 /**
  * Get recommended ESLint config.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.FlatConfig[]>}
  */
 export async function createEslintRecommendsConfig() {
-  return [ {
-    name: 'eslint/recomended',
-    ...js.configs.recommended,
-  } ];
+  return [
+    {
+      name: 'eslint/recomended',
+      ...js.configs.recommended,
+    },
+    {
+      rules: {
+        'no-unused-vars': unusedConfig,
+      },
+    },
+  ];
 }

package/src/plugins/jsdoc.js

@@ -27,7 +27,14 @@ export async function createEslintJSDocConfig(root) {
         'jsdoc/check-alignment': 'warn',
         'jsdoc/check-examples': 'off',
         'jsdoc/check-indentation': 'off',
-        'jsdoc/check-line-alignment': [ 'error', 'never', { customSpacings: { postDelimiter: 1, postTag: 1, postType: 1, postName: 1 } } ],
+        'jsdoc/check-line-alignment': [
+          'error',
+          'never',
+          {
+            tags: [ 'param', 'arg', 'argument', 'property', 'prop', 'returns', 'return' ],
+            customSpacings: { postDelimiter: 1, postTag: 1, postType: 1, postName: 1 },
+          },
+        ],
         'jsdoc/check-param-names': 'warn',
         'jsdoc/check-property-names': 'warn',
         'jsdoc/check-syntax': 'error',

package/src/plugins/style.js

@@ -22,9 +22,8 @@ export function createEslintStyleConfig() {
       'style/computed-property-spacing': [ 'error', 'never' ],
       'style/curly-newline': [ 'error', { consistent: true } ],
       'style/dot-location': [ 'error', 'property' ],
-      'style/func-call-spacing': [ 'error', 'never' ],
       'style/function-call-argument-newline': [ 'error', 'consistent' ],
-      'style/function-call-spacing': 'error',
+      'style/function-call-spacing': [ 'error', 'never' ],
       'style/function-paren-newline': [ 'error', 'consistent' ],
       'style/generator-star-spacing': [ 'error', 'both' ],
       'style/implicit-arrow-linebreak': [ 'error', 'beside' ],
@@ -75,11 +74,29 @@ export function createEslintStyleConfig() {
       'style/object-curly-spacing': [ 'error', 'always' ],
       'style/object-property-newline': [ 'error', { allowAllPropertiesOnSameLine: true } ],
       'style/one-var-declaration-per-line': [ 'error', 'initializations' ],
-      'style/operator-linebreak': [ 'error', 'after', { overrides: { '?': 'before', ':': 'before' } } ],
+      'style/operator-linebreak': [
+        'error',
+        'after',
+        {
+          overrides: {
+            '?': 'before',
+            ':': 'before',
+            '|': 'before',
+            '&': 'before',
+          },
+        },
+      ],
       'style/padded-blocks': [ 'error', 'never' ],
       'style/padding-line-between-statements': 'off',
       'style/quote-props': [ 'error', 'consistent-as-needed' ],
-      'style/quotes': [ 'error', 'single', { allowTemplateLiterals: true, avoidEscape: true } ],
+      'style/quotes': [
+        'error',
+        'single',
+        {
+          allowTemplateLiterals: 'always',
+          avoidEscape: true,
+        },
+      ],
       'style/rest-spread-spacing': [ 'error', 'never' ],
       'style/semi-spacing': 'error',
       'style/semi-style': [ 'error', 'last' ],

package/src/plugins/unused-imports.js

@@ -1,5 +1,6 @@
 import unused from 'eslint-plugin-unused-imports';
 
+import { unusedConfig } from '../configs/eslint-recommended.js';
 import {
   getModuleFiles,
   getTypescriptFiles,
@@ -24,14 +25,7 @@ export async function createEslintUnusedImportsConfig(root) {
         '@typescript-eslint/no-unused-vars': 'off',
 
         'unused-imports/no-unused-imports': 'error',
-        'unused-imports/no-unused-vars': [
-          'error', {
-            argsIgnorePattern: '^_',
-            varsIgnorePattern: '^_',
-            args: 'after-used',
-            vars: 'local',
-          },
-        ],
+        'unused-imports/no-unused-vars': unusedConfig,
       },
     },
   ];

package/src/utilities/filesystem.js

@@ -1,19 +1,45 @@
+/**
+ * @import { Stats } from 'node:fs'
+ */
 import { stat } from 'node:fs/promises';
 import * as Path from 'node:path';
 
+/** @type {Map<string, Promise<Stats>>} */
+const cache = new Map();
+
 /**
- * @param {string} path - The absolute path to the file to check.
- * @returns {Promise<boolean>}
+ * @param {string} path - The absolute path to the file to stat.
+ * @returns {Promise<Stats | undefined>}
  */
-export async function exists(path) {
+async function safeStat(path) {
   try {
-    await stat(path);
-    return true;
+    const promise = cache.get(path) ?? stat(path);
+    cache.set(path, promise);
+
+    return await promise;
   } catch {
-    return false;
+    // Supress the error and return undefined
+    // We dont care about permissions here
   }
 }
 
+/**
+ * @param {string} path - The absolute path to the file to check.
+ * @returns {Promise<boolean>}
+ */
+export async function isFile(path) {
+  const stat = await safeStat(path);
+  return stat?.isFile() ?? false;
+}
+/**
+ * @param {string} path - The absolute path to the file to check.
+ * @returns {Promise<boolean>}
+ */
+export async function isDirectory(path) {
+  const stat = await safeStat(path);
+  return stat?.isDirectory() ?? false;
+}
+
 /**
  * Does {filePath} exist in {projectPath}.
  * @param {string} [filePath] - The path of the file to check.
@@ -35,15 +61,19 @@ export function descendsFrom(filePath, projectPath) {
  * Create a list of parent directories from {filepath} to {stopDirectory}.
  * @param {string} filepath - The file to start from.
  * @param {string} [stopDirectory] - The directory to stop at.
- * @returns {string[]}
+ * @returns {Promise<string[]>}
  */
-export function listParents(filepath, stopDirectory = '/') {
+export async function listParents(filepath, stopDirectory = '/') {
   // The file is not from within the stopDirectory
   if (descendsFrom(filepath, stopDirectory) === false) {
     return [];
   }
 
   const output = [];
+  if (await isDirectory(filepath)) {
+    output.push(filepath);
+  }
+
   const end = Path.resolve(stopDirectory);
   do {
     filepath = Path.dirname(filepath);
@@ -63,7 +93,7 @@ export async function findInPaths(paths, filename) {
   for (const directory of paths) {
     const target = Path.join(directory, filename);
 
-    if (await exists(target)) {
+    if (await isFile(target)) {
       return target;
     }
   }
@@ -79,5 +109,8 @@ export async function findInPaths(paths, filename) {
  * @returns {Promise<string|null>} Returns absolute path to the closest {filename} if found.
  */
 export async function findUp(rootFilePath, filename, stopDirectory = Path.resolve('/')) {
-  return findInPaths(listParents(rootFilePath, stopDirectory), filename);
+  return findInPaths(
+    await listParents(rootFilePath, stopDirectory),
+    filename,
+  );
 }

package/src/utilities/package.js

@@ -14,11 +14,12 @@ const cache = new Map();
 /**
  * @param {string} rootPath - The root url.
  * @param {string} packageName - The target package name.
- * @returns {string[]}
+ * @returns {Promise<string[]>}
  */
-function modulePaths(rootPath, packageName) {
-  return listParents(`${rootPath}/eslint.config.js`)
-    .map((path) => resolve(path, 'node_modules', packageName));
+async function modulePaths(rootPath, packageName) {
+  const parents = await listParents(`${rootPath}/eslint.config.js`);
+
+  return parents.map((path) => resolve(path, 'node_modules', packageName));
 }
 
 /**
@@ -34,7 +35,7 @@ export async function getPackageJson(rootUrl, packageName) {
   }
 
   const jsonPath = typeof packageName === 'string'
-    ? await findInPaths(modulePaths(root, packageName), 'package.json')
+    ? await findInPaths(await modulePaths(root, packageName), 'package.json')
     : await findUp(root, 'package.json');
 
   if (jsonPath == null) {

package/types/src/configs/eslint-recommended.d.ts

@@ -1,5 +1,8 @@
 /**
  * Get recommended ESLint config.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.FlatConfig[]>}
  */
-export function createEslintRecommendsConfig(): Promise<import("eslint").Linter.Config[]>;
+export function createEslintRecommendsConfig(): Promise<Linter.FlatConfig[]>;
+/** @type {Linter.RuleEntry} */
+export const unusedConfig: Linter.RuleEntry;
+import type { Linter } from 'eslint';

package/types/src/utilities/filesystem.d.ts

@@ -2,7 +2,12 @@
  * @param {string} path - The absolute path to the file to check.
  * @returns {Promise<boolean>}
  */
-export function exists(path: string): Promise<boolean>;
+export function isFile(path: string): Promise<boolean>;
+/**
+ * @param {string} path - The absolute path to the file to check.
+ * @returns {Promise<boolean>}
+ */
+export function isDirectory(path: string): Promise<boolean>;
 /**
  * Does {filePath} exist in {projectPath}.
  * @param {string} [filePath] - The path of the file to check.
@@ -14,9 +19,9 @@ export function descendsFrom(filePath?: string, projectPath?: string): boolean;
  * Create a list of parent directories from {filepath} to {stopDirectory}.
  * @param {string} filepath - The file to start from.
  * @param {string} [stopDirectory] - The directory to stop at.
- * @returns {string[]}
+ * @returns {Promise<string[]>}
  */
-export function listParents(filepath: string, stopDirectory?: string): string[];
+export function listParents(filepath: string, stopDirectory?: string): Promise<string[]>;
 /**
  * Find the closest {filename} starting from {rootFilePath}.
  * @param {string[]} paths - The paths to search in.