@darksheep/eslint 7.0.4 → 8.0.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # 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)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksheep/eslint",
-  "version": "7.0.4",
+  "version": "8.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/DarkSheepSoftware/eslint"
@@ -24,16 +24,16 @@
   "dependencies": {
     "@darksheep/environment": "3.1.0",
     "@eslint-community/eslint-plugin-eslint-comments": "4.5.0",
-    "@eslint/compat": "1.3.0",
-    "@eslint/js": "9.29.0",
-    "@stylistic/eslint-plugin": "4.4.1",
-    "@typescript-eslint/eslint-plugin": "8.34.1",
-    "@typescript-eslint/parser": "8.34.1",
-    "editorconfig": "3.0.0",
-    "eslint-plugin-jsdoc": "51.2.1",
+    "@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.20.0",
-    "eslint-plugin-package-json": "0.40.4",
+    "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",
@@ -48,8 +48,8 @@
   },
   "devDependencies": {
     "@darksheep/eslint-formatter-github": "2.1.0",
-    "@types/node": "~22.15.0",
-    "eslint": "~9.29.0",
+    "@types/node": "~22.16.0",
+    "eslint": "~9.31.0",
     "type-fest": "~4.41.0",
     "typescript": "~5.8.0"
   },
@@ -66,7 +66,7 @@
     "node": "^20 || ^22"
   },
   "volta": {
-    "node": "22.16.0",
+    "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.