@darksheep/eslint 8.0.7 → 9.0.0

package/src/plugins/jsdoc.js

@@ -1,3 +1,6 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import jsdoc from 'eslint-plugin-jsdoc';
 
 import { getTypescriptFiles } from '../utilities/eslint-files.js';
@@ -6,7 +9,7 @@ import { getPackageJson } from '../utilities/package.js';
 /**
  * Get ESLint config for JSDoc.
  * @param {URL} root - The root of the package being linted.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintJSDocConfig(root) {
   const tsPackage = await getPackageJson(root, 'typescript');
@@ -50,7 +53,7 @@ export async function createEslintJSDocConfig(root) {
         'jsdoc/lines-before-block': 'off',
         'jsdoc/match-description': 'off',
         'jsdoc/match-name': 'off',
-        'jsdoc/multiline-blocks': 'off',
+        'jsdoc/multiline-blocks': [ 'warn', { noSingleLineBlocks: true } ],
         'jsdoc/no-bad-blocks': 'warn',
         'jsdoc/no-blank-block-descriptions': 'error',
         'jsdoc/no-blank-blocks': 'error',
@@ -63,7 +66,7 @@ export async function createEslintJSDocConfig(root) {
         'jsdoc/require-description-complete-sentence': 'error',
         'jsdoc/require-description': 'off',
         'jsdoc/require-example': 'off',
-        'jsdoc/require-file-overview': 'off', // Could automatically add a licence?
+        'jsdoc/require-file-overview': 'off',
         'jsdoc/require-hyphen-before-param-description': [ 'error', 'always', { tags: { property: 'always' } } ],
         'jsdoc/require-jsdoc': [ 'warn', { publicOnly: true } ],
         'jsdoc/require-param-description': 'warn',
@@ -86,6 +89,23 @@ export async function createEslintJSDocConfig(root) {
         'jsdoc/tag-lines': 'off',
         'jsdoc/text-escaping': 'off',
         'jsdoc/valid-types': typeChecks,
+
+        'jsdoc/escape-inline-tags': [ 'error', { enableFixer: true, fixType: 'backslash' } ],
+        'jsdoc/prefer-import-tag': [ 'warn', {
+          outputType: 'named-import',
+          exemptTypedefs: false,
+        } ],
+        'jsdoc/reject-any-type': 'warn',
+        'jsdoc/reject-function-type': 'warn',
+        'jsdoc/require-next-description': 'off',
+        'jsdoc/require-next-type': 'off',
+        'jsdoc/require-tags': 'off',
+        'jsdoc/require-template-description': 'off',
+        'jsdoc/require-throws-description': 'off',
+        'jsdoc/require-throws-type': 'warn',
+        'jsdoc/require-yields-description': 'off',
+        'jsdoc/require-yields-type': 'warn',
+        'jsdoc/type-formatting': [ 'off', { stringQuotes: 'single' } ],
       },
     },
     {

package/src/plugins/json.js

@@ -1,9 +1,12 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import jsonc from 'eslint-plugin-jsonc';
 import parser from 'jsonc-eslint-parser';
 
 /**
  * Get ESLint config for imports check.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintJsonConfig() {
   return [
@@ -55,6 +58,9 @@ export async function createEslintJsonConfig() {
       files: [ '**/tsconfig.json' ],
       rules: { 'jsonc/no-comments': 'off' },
     },
-    { ignores: [ '.github/release-please/manifest.json' ] },
+    {
+      name: 'json/release-please',
+      ignores: [ '.github/release-please/manifest.json' ],
+    },
   ];
 }

package/src/plugins/node.js

@@ -1,3 +1,6 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -14,7 +17,7 @@ import {
 const script = n.configs['flat/recommended-script'];
 const module = n.configs['flat/recommended-module'];
 
-/** @type {import('eslint').Linter.RulesRecord} */
+/** @type {Linter.RulesRecord} */
 const commonRules = {
   'n/callback-return': 'error',
   'n/exports-style': [ 'error', 'module.exports' ],
@@ -32,6 +35,7 @@ const commonRules = {
   'n/no-process-exit': 'warn',
   'n/no-restricted-import': 'off',
   'n/no-restricted-require': 'off',
+  'n/no-top-level-await': 'error',
   'n/no-unpublished-bin': 'error',
   'n/no-unpublished-import': [ 'error', { ignoreTypeImport: true } ],
   'n/no-unpublished-require': 'error',
@@ -62,7 +66,7 @@ function toExt(globs) {
 /**
  * Get ESLint config for the node plugin.
  * @param {URL} root - Root url.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintNodeConfig(root) {
   const commonFiles = await getCommonFiles(root);

package/src/plugins/package-json.js

@@ -1,9 +1,12 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import * as plugin from 'eslint-plugin-package-json';
 import jsoncParser from 'jsonc-eslint-parser';
 
 /**
  * Get ESLint config for the regexp plugin.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintPackageJsonConfig() {
   return [
@@ -22,16 +25,41 @@ export async function createEslintPackageJsonConfig() {
         'package-json/prefer-repository-shorthand': 'off',
         'package-json/repository-shorthand': [ 'error', { form: 'object' } ],
         'package-json/require-author': 'off',
+        'package-json/require-bugs': 'off',
+        'package-json/require-bundleDependencies': 'off',
+        'package-json/require-dependencies': 'warn',
+        'package-json/require-description': 'warn',
+        'package-json/require-devDependencies': 'warn',
+        'package-json/require-engines': [ 'warn', { ignorePrivate: true } ],
         'package-json/require-files': 'warn',
         'package-json/require-keywords': 'off',
         'package-json/require-name': 'error',
+        'package-json/require-optionalDependencies': 'off',
+        'package-json/require-peerDependencies': 'off',
+        'package-json/require-type': 'error',
+        'package-json/require-types': 'off',
         'package-json/require-version': 'error',
+        'package-json/restrict-dependency-ranges': 'off',
         'package-json/sort-collections': 'error',
         'package-json/unique-dependencies': 'error',
-        'package-json/valid-local-dependency': 'error',
+        'package-json/valid-author': 'warn',
+        'package-json/valid-bin': 'warn',
+        'package-json/valid-bundleDependencies': 'warn',
+        'package-json/valid-config': 'warn',
+        'package-json/valid-cpu': 'warn',
+        'package-json/valid-dependencies': 'warn',
+        'package-json/valid-description': 'warn',
+        'package-json/valid-devDependencies': 'warn',
+        'package-json/valid-directories': 'warn',
+        'package-json/valid-exports': 'warn',
+        'package-json/valid-license': 'warn',
         'package-json/valid-name': 'error',
+        'package-json/valid-optionalDependencies': 'warn',
         'package-json/valid-package-definition': 'warn',
+        'package-json/valid-peerDependencies': 'warn',
         'package-json/valid-repository-directory': 'error',
+        'package-json/valid-scripts': 'warn',
+        'package-json/valid-type': 'warn',
         'package-json/valid-version': 'error',
       },
     },

package/src/plugins/perfectionist.js

@@ -1,3 +1,6 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import perfectionist from 'eslint-plugin-perfectionist';
 
 import {
@@ -6,7 +9,7 @@ import {
   getTypescriptFiles,
 } from '../utilities/eslint-files.js';
 
-/** @type {import('eslint').Linter.RulesRecord} */
+/** @type {Linter.RulesRecord} */
 const commonRules = {
   'perfectionist/sort-classes': [
     'warn',
@@ -36,7 +39,7 @@ const commonRules = {
   'perfectionist/sort-objects': 0,
 };
 
-/** @type {import('eslint').Linter.RulesRecord} */
+/** @type {Linter.RulesRecord} */
 const moduleRules = {
   'perfectionist/sort-exports': [
     'warn',
@@ -81,7 +84,7 @@ const moduleRules = {
   ],
 };
 
-/** @type {import('eslint').Linter.RulesRecord} */
+/** @type {Linter.RulesRecord} */
 const typescriptRules = {
   'perfectionist/sort-astro-attributes': 0,
   'perfectionist/sort-enums': 0,
@@ -101,7 +104,7 @@ const typescriptRules = {
 /**
  * Get ESLint config for imports check.
  * @param {URL} root - The root of the package being linted.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintPerfectionistConfig(root) {
   return [

package/src/plugins/promise.js

@@ -1,8 +1,11 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import promise from 'eslint-plugin-promise';
 
 /**
  * Get ESLint config for the promise plugin.
- * @returns {import('eslint').Linter.Config[]}
+ * @returns {Linter.Config[]}
  */
 export function createEslintPromiseConfig() {
   return [ {

package/src/plugins/react-native.js

@@ -1,3 +1,6 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import { fixupPluginRules } from '@eslint/compat';
 import reactnative from 'eslint-plugin-react-native';
 
@@ -6,7 +9,7 @@ import { getPackageJson } from '../utilities/package.js';
 /**
  * Get ESLint config for imports check.
  * @param {URL} root - The root of the package being linted.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintReactNativeConfig(root) {
   const packageJson = await getPackageJson(root, 'react-native');

package/src/plugins/react.js

@@ -1,7 +1,10 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import react from 'eslint-plugin-react';
 
 import { getPackageJson } from '../utilities/package.js';
-/** @type {import('eslint').Linter.RulesRecord} */
+/** @type {Linter.RulesRecord} */
 const disabledStyle = {
   'react/jsx-child-element-spacing': 'off',
   'react/jsx-closing-bracket-location': 'off',
@@ -23,7 +26,7 @@ const disabledStyle = {
   'react/jsx-wrap-multilines': 'off',
 };
 
-/** @type {import('eslint').Linter.RulesRecord} */
+/** @type {Linter.RulesRecord} */
 const rules = {
   ...disabledStyle,
   'react/boolean-prop-naming': 'off',
@@ -114,7 +117,7 @@ const rules = {
 /**
  * Get ESLint config for imports check.
  * @param {URL} root - The root of the package being linted.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintReactConfig(root) {
   const packageJson = await getPackageJson(root, 'react');

package/src/plugins/regexp.js

@@ -1,8 +1,11 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import regexp from 'eslint-plugin-regexp';
 
 /**
  * Get ESLint config for the regexp plugin.
- * @returns {import('eslint').Linter.Config[]}
+ * @returns {Linter.Config[]}
  */
 export function createEslintRegexpConfig() {
   return [

package/src/plugins/sca.js

@@ -1,3 +1,6 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import logger from '../custom-logger/index.js';
 import sca from '../custom-rules/index.js';
 import {
@@ -9,7 +12,7 @@ import {
 /**
  * Get ESLint config for the sca plugin.
  * @param {URL} root - The root url of the package we are linting.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintSCAConfig(root) {
   return [

package/src/plugins/security.js

@@ -1,8 +1,11 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import security from 'eslint-plugin-security';
 
 /**
  * Get ESLint config for the security plugin.
- * @returns {import('eslint').Linter.Config[]}
+ * @returns {Linter.Config[]}
  */
 export function createEslintSecurityConfig() {
   return [ {

package/src/plugins/style.js

@@ -1,8 +1,11 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import stylistic from '@stylistic/eslint-plugin';
 
 /**
  * Get ESLint config for the style plugin.
- * @returns {import('eslint').Linter.Config[]}
+ * @returns {Linter.Config[]}
  */
 export function createEslintStyleConfig() {
   return [ {
@@ -41,7 +44,6 @@ export function createEslintStyleConfig() {
       'style/jsx-newline': 'off',
       'style/jsx-one-expression-per-line': 'off',
       'style/jsx-pascal-case': 'off',
-      'style/jsx-props-no-multi-spaces': 'off',
       'style/jsx-quotes': 'error',
       'style/jsx-self-closing-comp': 'off',
       'style/jsx-sort-props': 'off',

package/src/plugins/typescript.js

@@ -1,3 +1,7 @@
+/**
+ * @import { URL } from 'node:url';
+ * @import { Linter } from 'eslint';
+ */
 import { getTypescriptFiles } from '../utilities/eslint-files.js';
 import { getPackageJson } from '../utilities/package.js';
 
@@ -12,8 +16,8 @@ function idef(target) {
 
 /**
  * Get ESLint config for the typescript plugin.
- * @param {import('node:url').URL} root - Root url.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @param {URL} root - Root url.
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintTypescriptConfig(root) {
   const packageJson = await getPackageJson(root, 'typescript');
@@ -36,7 +40,8 @@ export async function createEslintTypescriptConfig(root) {
       },
     },
     plugins: {
-      '@typescript-eslint': /** @type {*} */ (typescriptPlugin),
+      // @ts-expect-error -- I love that the ts plugin is not compatible...
+      '@typescript-eslint': typescriptPlugin,
     },
     rules: {
       // Rules that fight with typescript

package/src/plugins/unicorn.js

@@ -1,3 +1,6 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import unicorn from 'eslint-plugin-unicorn';
 
 import { getModuleFiles, getTypescriptFiles } from '../utilities/eslint-files.js';
@@ -5,7 +8,7 @@ import { getModuleFiles, getTypescriptFiles } from '../utilities/eslint-files.js
 /**
  * Get ESLint config for the unicorn plugin.
  * @param {URL} root - Root url.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintUnicornConfig(root) {
   return [
@@ -26,6 +29,8 @@ export async function createEslintUnicornConfig(root) {
       rules: {
         'unicorn/better-regex': 'off',
         'unicorn/catch-error-name': 'error',
+        'unicorn/consistent-assert': 'off',
+        'unicorn/consistent-date-clone': 'error',
         'unicorn/consistent-destructuring': 'off',
         'unicorn/consistent-empty-array-spread': 'error',
         'unicorn/consistent-existence-index-check': 'warn',
@@ -40,12 +45,14 @@ export async function createEslintUnicornConfig(root) {
         'unicorn/import-style': 'off',
         'unicorn/new-for-builtins': 'warn',
         'unicorn/no-abusive-eslint-disable': 'warn',
+        'unicorn/no-accessor-recursion': 'warn',
         'unicorn/no-anonymous-default-export': 'warn',
         'unicorn/no-array-callback-reference': 'off',
         'unicorn/no-array-for-each': 'error',
         'unicorn/no-array-method-this-argument': 'error',
-        'unicorn/no-array-push-push': 'warn',
         'unicorn/no-array-reduce': 'error',
+        'unicorn/no-array-reverse': 'warn',
+        'unicorn/no-array-sort': 'warn',
         'unicorn/no-await-expression-member': 'off',
         'unicorn/no-await-in-promise-methods': 'warn',
         'unicorn/no-console-spaces': 'error',
@@ -53,13 +60,13 @@ export async function createEslintUnicornConfig(root) {
         'unicorn/no-empty-file': 'warn',
         'unicorn/no-for-loop': 'warn',
         'unicorn/no-hex-escape': 'warn',
-        'unicorn/no-instanceof-array': 'off',
+        'unicorn/no-instanceof-builtins': 'off',
         'unicorn/no-invalid-fetch-options': 'off',
         'unicorn/no-invalid-remove-event-listener': 'error',
         'unicorn/no-keyword-prefix': [ 'warn', { checkProperties: false } ],
-        'unicorn/no-length-as-slice-end': 'warn',
         'unicorn/no-lonely-if': 'warn',
         'unicorn/no-magic-array-flat-depth': 'off', // Breaks typescript
+        'unicorn/no-named-default': 'error',
         'unicorn/no-negated-condition': 'error',
         'unicorn/no-negation-in-equality-check': 'warn',
         'unicorn/no-nested-ternary': 'warn',
@@ -73,11 +80,15 @@ export async function createEslintUnicornConfig(root) {
         'unicorn/no-thenable': 'off',
         'unicorn/no-this-assignment': 'warn',
         'unicorn/no-typeof-undefined': 'off',
+        'unicorn/no-unnecessary-array-flat-depth': 'warn',
+        'unicorn/no-unnecessary-array-splice-count': 'warn',
         'unicorn/no-unnecessary-await': 'error',
         'unicorn/no-unnecessary-polyfills': 'off',
+        'unicorn/no-unnecessary-slice-end': 'warn',
         'unicorn/no-unreadable-array-destructuring': 'error',
         'unicorn/no-unreadable-iife': 'off',
         'unicorn/no-unused-properties': 'off',
+        'unicorn/no-useless-error-capture-stack-trace': 'warn',
         'unicorn/no-useless-fallback-in-spread': 'warn',
         'unicorn/no-useless-length-check': 'error',
         'unicorn/no-useless-promise-resolve-reject': 'error',
@@ -94,7 +105,10 @@ export async function createEslintUnicornConfig(root) {
         'unicorn/prefer-array-index-of': 'error',
         'unicorn/prefer-array-some': 'error',
         'unicorn/prefer-at': 'error',
+        'unicorn/prefer-bigint-literals': 'error',
         'unicorn/prefer-blob-reading-methods': 'error',
+        'unicorn/prefer-class-fields': 'warn',
+        'unicorn/prefer-classlist-toggle': 'off',
         'unicorn/prefer-code-point': 'error',
         'unicorn/prefer-date-now': 'error',
         'unicorn/prefer-default-parameters': 'error',
@@ -105,6 +119,7 @@ export async function createEslintUnicornConfig(root) {
         'unicorn/prefer-event-target': 'warn',
         'unicorn/prefer-export-from': 'warn',
         'unicorn/prefer-global-this': 'warn',
+        'unicorn/prefer-import-meta-properties': 'warn',
         'unicorn/prefer-includes': 'error',
         'unicorn/prefer-json-parse-buffer': 'error',
         'unicorn/prefer-keyboard-event-key': 'error',
@@ -125,6 +140,7 @@ export async function createEslintUnicornConfig(root) {
         'unicorn/prefer-regexp-test': 'warn',
         'unicorn/prefer-set-has': 'warn',
         'unicorn/prefer-set-size': 'error',
+        'unicorn/prefer-single-call': 'warn',
         'unicorn/prefer-spread': 'error',
         'unicorn/prefer-string-raw': 'warn',
         'unicorn/prefer-string-replace-all': 'error',
@@ -138,6 +154,8 @@ export async function createEslintUnicornConfig(root) {
         'unicorn/prevent-abbreviations': 'off',
         'unicorn/relative-url-style': 'error',
         'unicorn/require-array-join-separator': 'error',
+        'unicorn/require-module-attributes': 'warn',
+        'unicorn/require-module-specifiers': 'warn',
         'unicorn/require-number-to-fixed-digits-argument': 'error',
         'unicorn/require-post-message-target-origin': 'error',
         'unicorn/string-content': 'off',

package/src/plugins/unused-imports.js

@@ -1,3 +1,7 @@
+/**
+ * @import { URL } from 'node:url';
+ * @import { Linter } from 'eslint';
+ */
 import unused from 'eslint-plugin-unused-imports';
 
 import { unusedConfig } from '../configs/eslint-recommended.js';
@@ -8,8 +12,8 @@ import {
 
 /**
  * Get ESLint config for the unused import plugin.
- * @param {import('node:url').URL} root - Root url.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @param {URL} root - Root url.
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintUnusedImportsConfig(root) {
   return [

package/src/plugins/yml.js

@@ -1,9 +1,12 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 import yml from 'eslint-plugin-yml';
 import parser from 'yaml-eslint-parser';
 
 /**
  * Get ESLint config for yml check.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEslintYmlConfig() {
   return [

package/src/utilities/editorconfig.js

@@ -1,3 +1,7 @@
+/**
+ * @import { SectionBody } from 'editorconfig';
+ * @import { Linter } from 'eslint';
+ */
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -18,12 +22,12 @@ import { findUp } from './filesystem.js';
  */
 
 /**
- * @param {import('editorconfig').SectionBody} input - Raw editor config converted into an object.
+ * @param {SectionBody} input - Raw editor config converted into an object.
  * @param {RuleSet} RULES - The rules used to create eslint rules options.
- * @returns {import('eslint').Linter.RulesRecord}
+ * @returns {Linter.RulesRecord}
  */
 function convert(input, RULES) {
-  /** @type {import('eslint').Linter.RulesRecord} */
+  /** @type {Linter.RulesRecord} */
   const output = {};
 
   if (input?.end_of_line === 'lf') {
@@ -152,8 +156,8 @@ function equal(one, two) {
 }
 
 /**
- * @param {import('eslint').Linter.Config[]} configs - [description].
- * @param {import('eslint').Linter.Config} config - [description].
+ * @param {Linter.Config[]} configs - The current configs.
+ * @param {Linter.Config} config - The latest and greatest config.
  */
 function addOrMergeConfig(configs, config) {
   for (const previous of configs) {
@@ -173,8 +177,8 @@ function addOrMergeConfig(configs, config) {
 }
 
 /**
- * @param {import('node:url').URL} root - Root url.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @param {URL} root - Root url.
+ * @returns {Promise<Linter.Config[]>}
  */
 export async function createEditorOverrides(root) {
   const eslintConfigPath = resolve(fileURLToPath(root), 'eslint.config.js');
@@ -185,7 +189,7 @@ export async function createEditorOverrides(root) {
 
   const editorconfig = parseBuffer(await readFile(path));
 
-  /** @type {import('eslint').Linter.Config[]} */
+  /** @type {Linter.Config[]} */
   const configs = [];
   for (const [ name, body ] of editorconfig) {
     if (name === null) {

package/src/utilities/eslint-files.js

@@ -1,10 +1,14 @@
+/**
+ * @import { URL } from 'node:url';
+ */
+
 import { expandGlob } from './expand-glob.js';
 import { getPackageJson } from './package.js';
 
 /**
- * @param {string[]} files - [description].
- * @param {string} type - [description].
- * @param {string} target - [description].
+ * @param {string[]} files - An array of globsp.
+ * @param {'commonjs'|'module'} type - The package.json#type.
+ * @param {'commonjs'|'module'} target - The type we are serving.
  * @returns {string[]}
  */
 function getFiles(files, type, target) {
@@ -17,7 +21,7 @@ function getFiles(files, type, target) {
 
 /**
  * Get a list of globs for common js files.
- * @param {import('node:url').URL} root - Root url.
+ * @param {URL} root - Root url.
  * @returns {Promise<string[]>}
  */
 export async function getCommonFiles(root) {
@@ -28,7 +32,7 @@ export async function getCommonFiles(root) {
 
 /**
  * Get a list of globs for module files.
- * @param {import('node:url').URL} root - Root url.
+ * @param {URL} root - Root url.
  * @returns {Promise<string[]>}
  */
 export async function getModuleFiles(root) {

package/src/utilities/package.js

@@ -1,3 +1,7 @@
+/**
+ * @import { URL } from 'node:url';
+ * @import { PackageJson } from 'type-fest';
+ */
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -24,9 +28,9 @@ async function modulePaths(rootPath, packageName) {
 
 /**
  * Get the path of the eslint package json.
- * @param {import('node:url').URL} rootUrl - The root url of the module.
+ * @param {URL} rootUrl - The root url of the module.
  * @param {string} [packageName] - The name of the npm package.
- * @returns {Promise<import('type-fest').PackageJson | null>}
+ * @returns {Promise<PackageJson | null>}
  */
 export async function getPackageJson(rootUrl, packageName) {
   const root = fileURLToPath(rootUrl);

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

@@ -1,5 +1,6 @@
 /**
  * Get the ESLint base config.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @returns {Promise<Linter.Config[]>}
  */
-export function createEslintBaseConfig(): Promise<import("eslint").Linter.Config[]>;
+export function createEslintBaseConfig(): Promise<Linter.Config[]>;
+import type { Linter } from 'eslint';

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

@@ -1,5 +1,9 @@
+/**
+ * @import { Linter } from 'eslint';
+ */
 /**
  * Get the ESLint config for complexity checks.
- * @returns {import('eslint').Linter.Config[]}
+ * @returns {Linter.Config[]}
  */
-export function createEslintComplexityConfig(): import("eslint").Linter.Config[];
+export function createEslintComplexityConfig(): Linter.Config[];
+import type { Linter } from 'eslint';

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

@@ -1,6 +1,8 @@
 /**
  * Get basic ESLint ignores config.
- * @param {import('node:url').URL} root - Root url.
- * @returns {Promise<import('eslint').Linter.Config[]>}
+ * @param {URL} root - Root url.
+ * @returns {Promise<Linter.Config[]>}
  */
-export function createEslintIgnoresConfig(root: import("node:url").URL): Promise<import("eslint").Linter.Config[]>;
+export function createEslintIgnoresConfig(root: URL): Promise<Linter.Config[]>;
+import type { URL } from 'node:url';
+import type { Linter } from 'eslint';