@darksheep/eslint 6.4.3 → 6.5.0

package/src/utilities/editorconfig.js

@@ -9,17 +9,17 @@ import { findUp } from './filesystem.js';
 
 /**
  * @typedef {Object} RuleSet
- * @property {string} EOL end of line
- * @property {string} LF line feed
- * @property {string} TRAIL trailing spaces
- * @property {string} INDENT indent size
- * @property {string} [INDENT_BINARY] indent binary ops size
- * @property {unknown} [INDENT_OPTIONS] options to pass to the indent rule
+ * @property {string} EOL End of line.
+ * @property {string} LF Line feed.
+ * @property {string} TRAIL Trailing spaces.
+ * @property {string} INDENT Indent size.
+ * @property {string} [INDENT_BINARY] Indent binary ops size.
+ * @property {unknown} [INDENT_OPTIONS] Options to pass to the indent rule.
  */
 
 /**
- * @param {import('editorconfig').SectionBody} input Raw editor config converted into an object
- * @param {RuleSet} RULES The rules used to create eslint rules options
+ * @param {import('editorconfig').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}
  */
 function convert(input, RULES) {
@@ -51,7 +51,7 @@ function convert(input, RULES) {
   }
 
   if (input?.indent_style === 'space') {
-    const size = Number.parseInt(input?.indent_size ?? 4, 10);
+    const size = Number.parseInt(input?.indent_size ?? '4', 10);
     output[RULES.INDENT] = [ 'error', size, RULES.INDENT_OPTIONS ?? {} ];
     if (RULES.INDENT_BINARY != null) {
       output[RULES.INDENT_BINARY] = [ 'error', size ];
@@ -101,8 +101,8 @@ const extToRules = [
 
 /**
  * Do any of the provided files match a js file?
- * @param {string[]} files The list of files to check
- * @param {string[]} extensions The allowed file extensions
+ * @param {string[]} files - The list of files to check.
+ * @param {string[]} extensions - The allowed file extensions.
  * @returns {string[]}
  */
 function filterMatchingFiles(files, extensions) {
@@ -122,8 +122,8 @@ function filterMatchingFiles(files, extensions) {
 
 /**
  * Do any of the provided files match a js file?
- * @param {string[] | null | undefined} one The list of files to check
- * @param {string[] | null | undefined} two The allowed file extensions
+ * @param {string[] | null | undefined} one - The list of files to check.
+ * @param {string[] | null | undefined} two - The allowed file extensions.
  * @returns {boolean}
  */
 function equal(one, two) {
@@ -152,8 +152,8 @@ function equal(one, two) {
 }
 
 /**
- * @param {import('eslint').Linter.FlatConfig[]} configs  [description]
- * @param {import('eslint').Linter.FlatConfig} config  [description]
+ * @param {import('eslint').Linter.Config[]} configs - [description].
+ * @param {import('eslint').Linter.Config} config - [description].
  */
 function addOrMergeConfig(configs, config) {
   for (const previous of configs) {
@@ -173,8 +173,8 @@ function addOrMergeConfig(configs, config) {
 }
 
 /**
- * @param {import('node:url').URL} root root url
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * @param {import('node:url').URL} root - Root url.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
 export async function createEditorOverrides(root) {
   const eslintConfigPath = resolve(fileURLToPath(root), 'eslint.config.js');
@@ -185,7 +185,7 @@ export async function createEditorOverrides(root) {
 
   const editorconfig = parseBuffer(await readFile(path));
 
-  /** @type {import('eslint').Linter.FlatConfig[]} */
+  /** @type {import('eslint').Linter.Config[]} */
   const configs = [];
   for (const [ name, body ] of editorconfig) {
     if (name === null) {

package/src/utilities/eslint-files.js

@@ -2,9 +2,9 @@ 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 - [description].
+ * @param {string} type - [description].
+ * @param {string} target - [description].
  * @returns {string[]}
  */
 function getFiles(files, type, target) {
@@ -16,8 +16,8 @@ function getFiles(files, type, target) {
 }
 
 /**
- * Get a list of globs for common js files
- * @param {import('node:url').URL} root root url
+ * Get a list of globs for common js files.
+ * @param {import('node:url').URL} root - Root url.
  * @returns {Promise<string[]>}
  */
 export async function getCommonFiles(root) {
@@ -27,8 +27,8 @@ export async function getCommonFiles(root) {
 }
 
 /**
- * Get a list of globs for module files
- * @param {import('node:url').URL} root root url
+ * Get a list of globs for module files.
+ * @param {import('node:url').URL} root - Root url.
  * @returns {Promise<string[]>}
  */
 export async function getModuleFiles(root) {
@@ -37,7 +37,7 @@ export async function getModuleFiles(root) {
 }
 
 /**
- * Get a list of globs for typescript files
+ * Get a list of globs for typescript files.
  * @returns {string[]}
  */
 export function getTypescriptFiles() {
@@ -45,7 +45,7 @@ export function getTypescriptFiles() {
 }
 
 /**
- * Get a list of possible example files
+ * Get a list of possible example files.
  * @returns {string[]}
  */
 export function getTestFiles() {
@@ -58,7 +58,7 @@ export function getTestFiles() {
 }
 
 /**
- * Get a list of possible example files
+ * Get a list of possible example files.
  * @returns {string[]}
  */
 export function getExampleFiles() {

package/src/utilities/expand-glob.js

@@ -1,8 +1,8 @@
-const globNumRegex = /\{\d+\.\.\d+\}/;
-const globEachRegex = /\{[\w.-]+(?:,[\w.-]+)*\}/;
+const globNumRegex = /\{\d+\.\.\d+\}/u;
+const globEachRegex = /\{[\w\-.]+(?:,[\w\-.]+)*\}/u;
 
 /**
- * @param {string} input The glob to process
+ * @param {string} input - The glob to process.
  * @returns {string[]}
  */
 export function expandGlob(input) {
@@ -12,20 +12,20 @@ export function expandGlob(input) {
     const each = globNumMatch[0];
     const last = input.slice(globNumMatch.index + each.length);
 
-    const [ a, b ] = each
+    const [ a = 0, b = 0 ] = each
       .slice(1, -1)
       .split('..')
       .map((number) => Number.parseInt(number, 10));
 
-    const start = a > b ? b : a;
-    const end = a < b ? b : a;
+    const start = Math.min(a, b);
+    const end = Math.max(a, b);
 
     const output = [];
     for (let i = start; i <= end; i++) {
       output.push(`${first}${i}${last}`);
     }
 
-    return output.map(expandGlob).flat();
+    return output.flatMap(expandGlob);
   }
 
   const globEachMatch = input.match(globEachRegex);
@@ -39,7 +39,7 @@ export function expandGlob(input) {
       .map((part) => `${first}${part}${last}`);
 
     if (output.length > 1) {
-      return output.map(expandGlob).flat();
+      return output.flatMap(expandGlob);
     }
 
     return output;

package/src/utilities/filesystem.js

@@ -2,7 +2,7 @@ import { stat } from 'node:fs/promises';
 import * as Path from 'node:path';
 
 /**
- * @param {string} path The absolute path to the file to check
+ * @param {string} path - The absolute path to the file to check.
  * @returns {Promise<boolean>}
  */
 export async function exists(path) {
@@ -15,9 +15,9 @@ export async function exists(path) {
 }
 
 /**
- * Does {filePath} exist in {projectPath}
- * @param {string} [filePath] The path of the file to check
- * @param {string} [projectPath] The path to the project root
+ * Does {filePath} exist in {projectPath}.
+ * @param {string} [filePath] - The path of the file to check.
+ * @param {string} [projectPath] - The path to the project root.
  * @returns {boolean}
  */
 export function descendsFrom(filePath, projectPath) {
@@ -32,9 +32,9 @@ 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
+ * 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[]}
  */
 export function listParents(filepath, stopDirectory = '/') {
@@ -54,10 +54,10 @@ export function listParents(filepath, stopDirectory = '/') {
 }
 
 /**
- * Find the closest {filename} starting from {rootFilePath}
- * @param {string[]} paths The paths to search in
- * @param {string} filename The filename to find
- * @returns {Promise<string|null>} Returns absolute path to the closest {filename} if found
+ * Find the closest {filename} starting from {rootFilePath}.
+ * @param {string[]} paths - The paths to search in.
+ * @param {string} filename - The filename to find.
+ * @returns {Promise<string|null>} Returns absolute path to the closest {filename} if found.
  */
 export async function findInPaths(paths, filename) {
   for (const directory of paths) {
@@ -72,11 +72,11 @@ export async function findInPaths(paths, filename) {
 }
 
 /**
- * Find the closest {filename} starting from {rootFilePath}
- * @param {string} rootFilePath The file to start the search from
- * @param {string} filename The filename to find
- * @param {string} [stopDirectory] The directory to stop searching at
- * @returns {Promise<string|null>} Returns absolute path to the closest {filename} if found
+ * Find the closest {filename} starting from {rootFilePath}.
+ * @param {string} rootFilePath - The file to start the search from.
+ * @param {string} filename - The filename to find.
+ * @param {string} [stopDirectory] - The directory to stop searching at.
+ * @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);

package/src/utilities/package.js

@@ -12,8 +12,8 @@ const errorCodesToSkip = new Set([
 const cache = new Map();
 
 /**
- * @param {string} rootPath The root url
- * @param {string} packageName The target package name
+ * @param {string} rootPath - The root url.
+ * @param {string} packageName - The target package name.
  * @returns {string[]}
  */
 function modulePaths(rootPath, packageName) {
@@ -22,9 +22,9 @@ 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 {string} [packageName] The name of the npm package
+ * Get the path of the eslint package json.
+ * @param {import('node:url').URL} rootUrl - The root url of the module.
+ * @param {string} [packageName] - The name of the npm package.
  * @returns {Promise<import('type-fest').PackageJson | null>}
  */
 export async function getPackageJson(rootUrl, packageName) {

package/types/eslint.config.d.ts

@@ -1,2 +1,6 @@
-declare const _default: import("eslint").Linter.FlatConfig[];
+declare const _default: (import("eslint").Linter.Config<import("eslint").Linter.RulesRecord> | {
+    rules: {
+        'max-lines-per-function': number;
+    };
+})[];
 export default _default;

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

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

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

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

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

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

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

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

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

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

package/types/src/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @param {string | import('node:url').URL} root root url
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * @param {string | import('node:url').URL} root - Root url.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createConfig(root: string | import("node:url").URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createConfig(root: string | import("node:url").URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/eslint-comments.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for comments check
- * @returns {import('eslint').Linter.FlatConfig[]}
+ * Get ESLint config for comments check.
+ * @returns {import('eslint').Linter.Config[]}
  */
-export function createEslintCommentsConfig(): import("eslint").Linter.FlatConfig[];
+export function createEslintCommentsConfig(): import("eslint").Linter.Config[];

package/types/src/plugins/jsdoc.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get ESLint config for js docs
- * @param {URL} root The root of the package being linted
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for JSDoc.
+ * @param {URL} root - The root of the package being linted.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintJSDocConfig(root: URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintJSDocConfig(root: URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/json.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for imports check
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for imports check.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintJsonConfig(): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintJsonConfig(): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/node.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get ESLint config for the node plugin
- * @param {URL} root root url
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for the node plugin.
+ * @param {URL} root - Root url.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintNodeConfig(root: URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintNodeConfig(root: URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/package-json.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for the regexp plugin
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for the regexp plugin.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintPackageJsonConfig(): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintPackageJsonConfig(): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/perfectionist.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get ESLint config for imports check
- * @param {URL} root The root of the package being linted
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for imports check.
+ * @param {URL} root - The root of the package being linted.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintPerfectionistConfig(root: URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintPerfectionistConfig(root: URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/promise.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for the promise plugin
- * @returns {import('eslint').Linter.FlatConfig[]}
+ * Get ESLint config for the promise plugin.
+ * @returns {import('eslint').Linter.Config[]}
  */
-export function createEslintPromiseConfig(): import("eslint").Linter.FlatConfig[];
+export function createEslintPromiseConfig(): import("eslint").Linter.Config[];

package/types/src/plugins/react.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get ESLint config for imports check
- * @param {URL} root The root of the package being linted
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for imports check.
+ * @param {URL} root - The root of the package being linted.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintReactConfig(root: URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintReactConfig(root: URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/regexp.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for the regexp plugin
- * @returns {import('eslint').Linter.FlatConfig[]}
+ * Get ESLint config for the regexp plugin.
+ * @returns {import('eslint').Linter.Config[]}
  */
-export function createEslintRegexpConfig(): import("eslint").Linter.FlatConfig[];
+export function createEslintRegexpConfig(): import("eslint").Linter.Config[];

package/types/src/plugins/sca.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get ESLint config for the sca plugin
- * @param {URL} root The root url of the package we are linting
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * 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[]>}
  */
-export function createEslintSCAConfig(root: URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintSCAConfig(root: URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/security.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for the security plugin
- * @returns {import('eslint').Linter.FlatConfig[]}
+ * Get ESLint config for the security plugin.
+ * @returns {import('eslint').Linter.Config[]}
  */
-export function createEslintSecurityConfig(): import("eslint").Linter.FlatConfig[];
+export function createEslintSecurityConfig(): import("eslint").Linter.Config[];

package/types/src/plugins/style.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for the style plugin
- * @returns {import('eslint').Linter.FlatConfig[]}
+ * Get ESLint config for the style plugin.
+ * @returns {import('eslint').Linter.Config[]}
  */
-export function createEslintStyleConfig(): import("eslint").Linter.FlatConfig[];
+export function createEslintStyleConfig(): import("eslint").Linter.Config[];

package/types/src/plugins/typescript.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get ESLint config for the typescript plugin
- * @param {import('node:url').URL} root root url
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for the typescript plugin.
+ * @param {import('node:url').URL} root - Root url.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintTypescriptConfig(root: import("node:url").URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintTypescriptConfig(root: import("node:url").URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/unicorn.d.ts

@@ -1,5 +1,6 @@
 /**
- * Get ESLint config for the unicorn plugin
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for the unicorn plugin.
+ * @param {URL} root - Root url.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintUnicornConfig(): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintUnicornConfig(root: URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/unused-imports.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get ESLint config for the unused import plugin
- * @param {import('node:url').URL} root root url
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for the unused import plugin.
+ * @param {import('node:url').URL} root - Root url.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintUnusedImportsConfig(root: import("node:url").URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintUnusedImportsConfig(root: import("node:url").URL): Promise<import("eslint").Linter.Config[]>;

package/types/src/plugins/yml.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get ESLint config for yml check
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * Get ESLint config for yml check.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEslintYmlConfig(): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEslintYmlConfig(): Promise<import("eslint").Linter.Config[]>;

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

@@ -1,31 +1,31 @@
 /**
- * @param {import('node:url').URL} root root url
- * @returns {Promise<import('eslint').Linter.FlatConfig[]>}
+ * @param {import('node:url').URL} root - Root url.
+ * @returns {Promise<import('eslint').Linter.Config[]>}
  */
-export function createEditorOverrides(root: import("node:url").URL): Promise<import("eslint").Linter.FlatConfig[]>;
+export function createEditorOverrides(root: import("node:url").URL): Promise<import("eslint").Linter.Config[]>;
 export type RuleSet = {
     /**
-     * end of line
+     * End of line.
      */
     EOL: string;
     /**
-     * line feed
+     * Line feed.
      */
     LF: string;
     /**
-     * trailing spaces
+     * Trailing spaces.
      */
     TRAIL: string;
     /**
-     * indent size
+     * Indent size.
      */
     INDENT: string;
     /**
-     * indent binary ops size
+     * Indent binary ops size.
      */
-    INDENT_BINARY?: string | undefined;
+    INDENT_BINARY?: string;
     /**
-     * options to pass to the indent rule
+     * Options to pass to the indent rule.
      */
     INDENT_OPTIONS?: unknown;
 };

package/types/src/utilities/eslint-files.d.ts

@@ -1,27 +1,27 @@
 /**
- * Get a list of globs for common js files
- * @param {import('node:url').URL} root root url
+ * Get a list of globs for common js files.
+ * @param {import('node:url').URL} root - Root url.
  * @returns {Promise<string[]>}
  */
 export function getCommonFiles(root: import("node:url").URL): Promise<string[]>;
 /**
- * Get a list of globs for module files
- * @param {import('node:url').URL} root root url
+ * Get a list of globs for module files.
+ * @param {import('node:url').URL} root - Root url.
  * @returns {Promise<string[]>}
  */
 export function getModuleFiles(root: import("node:url").URL): Promise<string[]>;
 /**
- * Get a list of globs for typescript files
+ * Get a list of globs for typescript files.
  * @returns {string[]}
  */
 export function getTypescriptFiles(): string[];
 /**
- * Get a list of possible example files
+ * Get a list of possible example files.
  * @returns {string[]}
  */
 export function getTestFiles(): string[];
 /**
- * Get a list of possible example files
+ * Get a list of possible example files.
  * @returns {string[]}
  */
 export function getExampleFiles(): string[];

package/types/src/utilities/expand-glob.d.ts

@@ -1,5 +1,5 @@
 /**
- * @param {string} input The glob to process
+ * @param {string} input - The glob to process.
  * @returns {string[]}
  */
 export function expandGlob(input: string): string[];