immosquare-cleaner 0.1.62 → 0.1.63

data/node_modules/@eslint/eslintrc/dist/eslintrc.cjs

@@ -3,18 +3,18 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var debugOrig = require('debug');
-var fs = require('fs');
+var fs = require('node:fs');
 var importFresh = require('import-fresh');
-var Module = require('module');
-var path = require('path');
+var Module = require('node:module');
+var path = require('node:path');
 var stripComments = require('strip-json-comments');
-var assert = require('assert');
+var assert = require('node:assert');
 var ignore = require('ignore');
-var util = require('util');
+var util = require('node:util');
 var minimatch = require('minimatch');
 var Ajv = require('ajv');
 var globals = require('globals');
-var os = require('os');
+var os = require('node:os');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -142,6 +142,9 @@ const DotPatterns = Object.freeze([".*", "!.eslintrc.*", "!../"]);
 // Public
 //------------------------------------------------------------------------------
 
+/**
+ * Represents a set of glob patterns to ignore against a base path.
+ */
 class IgnorePattern {
 
     /**
@@ -178,9 +181,7 @@ class IgnorePattern {
         debug$3("Create with: %o", ignorePatterns);
 
         const basePath = getCommonAncestorPath(ignorePatterns.map(p => p.basePath));
-        const patterns = [].concat(
-            ...ignorePatterns.map(p => p.getPatternsRelativeTo(basePath))
-        );
+        const patterns = ignorePatterns.flatMap(p => p.getPatternsRelativeTo(basePath));
         const ig = ignore__default["default"]({ allowRelativePaths: true }).add([...DotPatterns, ...patterns]);
         const dotIg = ignore__default["default"]({ allowRelativePaths: true }).add(patterns);
 
@@ -380,10 +381,10 @@ class ExtractedConfig {
      */
     toCompatibleObjectAsConfigFileContent() {
         const {
-            /* eslint-disable no-unused-vars */
+            /* eslint-disable no-unused-vars -- needed to make `config` correct */
             configNameOfNoInlineConfig: _ignore1,
             processor: _ignore2,
-            /* eslint-enable no-unused-vars */
+            /* eslint-enable no-unused-vars -- needed to make `config` correct */
             ignores,
             ...config
         } = this;
@@ -575,6 +576,7 @@ class PluginConflictError extends Error {
  * @param {Record<string, DependentPlugin>} target The destination to merge
  * @param {Record<string, DependentPlugin>|undefined} source The source to merge.
  * @returns {void}
+ * @throws {PluginConflictError} When a plugin was conflicted.
  */
 function mergePlugins(target, source) {
     if (!isNonNullObject(source)) {
@@ -655,6 +657,7 @@ function mergeRuleConfigs(target, source) {
  * @param {ConfigArray} instance The config elements.
  * @param {number[]} indices The indices to use.
  * @returns {ExtractedConfig} The extracted config.
+ * @throws {Error} When a plugin is conflicted.
  */
 function createConfig(instance, indices) {
     const config = new ExtractedConfig();
@@ -988,8 +991,8 @@ class ConfigDependency {
         this.importerPath = importerPath;
     }
 
-    // eslint-disable-next-line jsdoc/require-description
     /**
+     * Converts this instance to a JSON compatible object.
      * @returns {Object} a JSON compatible object.
      */
     toJSON() {
@@ -1003,14 +1006,14 @@ class ConfigDependency {
         return obj;
     }
 
-    // eslint-disable-next-line jsdoc/require-description
     /**
+     * Custom inspect method for Node.js `console.log()`.
      * @returns {Object} an object to display by `console.log()`.
      */
     [util__default["default"].inspect.custom]() {
         const {
-            definition: _ignore1, // eslint-disable-line no-unused-vars
-            original: _ignore2, // eslint-disable-line no-unused-vars
+            definition: _ignore1, // eslint-disable-line no-unused-vars -- needed to make `obj` correct
+            original: _ignore2, // eslint-disable-line no-unused-vars -- needed to make `obj` correct
             ...obj
         } = this;
 
@@ -1109,6 +1112,7 @@ class OverrideTester {
      * @param {string|string[]} excludedFiles The glob patterns for excluded files.
      * @param {string} basePath The path to the base directory to test paths.
      * @returns {OverrideTester|null} The created instance or `null`.
+     * @throws {Error} When invalid patterns are given.
      */
     static create(files, excludedFiles, basePath) {
         const includePatterns = normalizePatterns(files);
@@ -1198,6 +1202,7 @@ class OverrideTester {
      * Test if a given path is matched or not.
      * @param {string} filePath The absolute path to the target file.
      * @returns {boolean} `true` if the path was matched.
+     * @throws {Error} When invalid `filePath` is given.
      */
     test(filePath) {
         if (typeof filePath !== "string" || !path__default["default"].isAbsolute(filePath)) {
@@ -1211,8 +1216,8 @@ class OverrideTester {
         ));
     }
 
-    // eslint-disable-next-line jsdoc/require-description
     /**
+     * Converts this instance to a JSON compatible object.
      * @returns {Object} a JSON compatible object.
      */
     toJSON() {
@@ -1228,8 +1233,8 @@ class OverrideTester {
         };
     }
 
-    // eslint-disable-next-line jsdoc/require-description
     /**
+     * Custom inspect method for Node.js `console.log()`.
      * @returns {Object} an object to display by `console.log()`.
      */
     [util__default["default"].inspect.custom]() {
@@ -1257,7 +1262,7 @@ const RULE_SEVERITY_STRINGS = ["off", "warn", "error"],
         map[value] = index;
         return map;
     }, {}),
-    VALID_SEVERITIES = [0, 1, 2, "off", "warn", "error"];
+    VALID_SEVERITIES = new Set([0, 1, 2, "off", "warn", "error"]);
 
 //------------------------------------------------------------------------------
 // Public Interface
@@ -1327,7 +1332,7 @@ function isValidSeverity(ruleConfig) {
     if (typeof severity === "string") {
         severity = severity.toLowerCase();
     }
-    return VALID_SEVERITIES.indexOf(severity) !== -1;
+    return VALID_SEVERITIES.has(severity);
 }
 
 /**
@@ -1609,7 +1614,7 @@ var ajvOrig = (additionalOptions = {}) => {
     });
 
     ajv.addMetaSchema(metaSchema);
-    // eslint-disable-next-line no-underscore-dangle
+    // eslint-disable-next-line no-underscore-dangle -- part of the API
     ajv._opts.defaultMeta = metaSchema.id;
 
     return ajv;
@@ -1769,7 +1774,7 @@ function getDiff(current, prev) {
     const retv = {};
 
     for (const [key, value] of Object.entries(current)) {
-        if (!Object.hasOwnProperty.call(prev, key)) {
+        if (!Object.hasOwn(prev, key)) {
             retv[key] = value;
         }
     }
@@ -1993,6 +1998,9 @@ const noOptionsSchema = Object.freeze({
 // Exports
 //-----------------------------------------------------------------------------
 
+/**
+ * Validator for configuration objects.
+ */
 class ConfigValidator {
     constructor({ builtInRules = new Map() } = {}) {
         this.builtInRules = builtInRules;
@@ -2052,6 +2060,7 @@ class ConfigValidator {
      * Validates a rule's severity and returns the severity value. Throws an error if the severity is invalid.
      * @param {options} options The given options for the rule.
      * @returns {number|string} The rule's severity value
+     * @throws {Error} If the severity is invalid.
      */
     validateRuleSeverity(options) {
         const severity = Array.isArray(options) ? options[0] : options;
@@ -2070,6 +2079,7 @@ class ConfigValidator {
      * @param {{create: Function}} rule The rule to validate
      * @param {Array} localOptions The options for the rule, excluding severity
      * @returns {void}
+     * @throws {Error} If the options are invalid.
      */
     validateRuleSchema(rule, localOptions) {
         if (!ruleValidators.has(rule)) {
@@ -2111,6 +2121,7 @@ class ConfigValidator {
      * @param {string|null} source The name of the configuration source to report in any errors. If null or undefined,
      * no source is prepended to the message.
      * @returns {void}
+     * @throws {Error} If the options are invalid.
      */
     validateRuleOptions(rule, ruleId, options, source = null) {
         try {
@@ -2142,8 +2153,9 @@ class ConfigValidator {
      * Validates an environment object
      * @param {Object} environment The environment config object to validate.
      * @param {string} source The name of the configuration source to report in any errors.
-     * @param {function(envId:string): Object} [getAdditionalEnv] A map from strings to loaded environments.
+     * @param {(envId:string) => Object} [getAdditionalEnv] A map from strings to loaded environments.
      * @returns {void}
+     * @throws {Error} If the environment is invalid.
      */
     validateEnvironment(
         environment,
@@ -2171,7 +2183,7 @@ class ConfigValidator {
      * Validates a rules config object
      * @param {Object} rulesConfig The rules config object to validate.
      * @param {string} source The name of the configuration source to report in any errors.
-     * @param {function(ruleId:string): Object} getAdditionalRule A map from strings to loaded rules
+     * @param {(ruleId:string) => Object} getAdditionalRule A map from strings to loaded rules
      * @returns {void}
      */
     validateRules(
@@ -2215,8 +2227,9 @@ class ConfigValidator {
      * Validate `processor` configuration.
      * @param {string|undefined} processorName The processor name.
      * @param {string} source The name of config file.
-     * @param {function(id:string): Processor} getProcessor The getter of defined processors.
+     * @param {(id:string) => Processor} getProcessor The getter of defined processors.
      * @returns {void}
+     * @throws {Error} If the processor is invalid.
      */
     validateProcessor(processorName, source, getProcessor) {
         if (processorName && !getProcessor(processorName)) {
@@ -2255,6 +2268,7 @@ class ConfigValidator {
      * @param {Object} config The config object to validate.
      * @param {string} source The name of the configuration source to report in any errors.
      * @returns {void}
+     * @throws {Error} If the config is invalid.
      */
     validateConfigSchema(config, source = null) {
         validateSchema = validateSchema || ajv.compile(configSchema);
@@ -2263,7 +2277,7 @@ class ConfigValidator {
             throw new Error(`ESLint configuration in ${source} is invalid:\n${this.formatErrors(validateSchema.errors)}`);
         }
 
-        if (Object.hasOwnProperty.call(config, "ecmaFeatures")) {
+        if (Object.hasOwn(config, "ecmaFeatures")) {
             emitDeprecationWarning(source, "ESLINT_LEGACY_ECMAFEATURES");
         }
     }
@@ -2272,8 +2286,8 @@ class ConfigValidator {
      * Validates an entire config object.
      * @param {Object} config The config object to validate.
      * @param {string} source The name of the configuration source to report in any errors.
-     * @param {function(ruleId:string): Object} [getAdditionalRule] A map from strings to loaded rules.
-     * @param {function(envId:string): Object} [getAdditionalEnv] A map from strings to loaded envs.
+     * @param {(ruleId:string) => Object} [getAdditionalRule] A map from strings to loaded rules.
+     * @param {(envId:string) => Object} [getAdditionalEnv] A map from strings to loaded envs.
      * @returns {void}
      */
     validate(config, source, getAdditionalRule, getAdditionalEnv) {
@@ -2426,6 +2440,7 @@ const createRequire = Module__default["default"].createRequire;
  * @param {string} relativeToPath An absolute path indicating the module that `moduleName` should be resolved relative to. This must be
  * a file rather than a directory, but the file need not actually exist.
  * @returns {string} The absolute path that would result from calling `require.resolve(moduleName)` in a file located at `relativeToPath`
+ * @throws {Error} When the module cannot be resolved.
  */
 function resolve(moduleName, relativeToPath) {
     try {
@@ -2686,7 +2701,7 @@ function loadPackageJSONConfigFile(filePath) {
     try {
         const packageData = loadJSONConfigFile(filePath);
 
-        if (!Object.hasOwnProperty.call(packageData, "eslintConfig")) {
+        if (!Object.hasOwn(packageData, "eslintConfig")) {
             throw Object.assign(
                 new Error("package.json file doesn't have 'eslintConfig' field."),
                 { code: "ESLINT_CONFIG_FIELD_NOT_FOUND" }
@@ -2705,6 +2720,7 @@ function loadPackageJSONConfigFile(filePath) {
  * Loads a `.eslintignore` from a file.
  * @param {string} filePath The filename to load.
  * @returns {string[]} The ignore patterns from the file.
+ * @throws {Error} If the file cannot be read.
  * @private
  */
 function loadESLintIgnoreFile(filePath) {
@@ -2777,7 +2793,7 @@ function loadConfigFile(filePath) {
 function writeDebugLogForLoading(request, relativeTo, filePath) {
     /* istanbul ignore next */
     if (debug$2.enabled) {
-        let nameAndVersion = null;
+        let nameAndVersion = null; // eslint-disable-line no-useless-assignment -- known bug in the rule
 
         try {
             const packageJsonPath = resolve(
@@ -2942,6 +2958,7 @@ class ConfigArrayFactory {
      * @param {Object} [options] The options.
      * @param {string} [options.basePath] The base path to resolve relative paths in `overrides[].files`, `overrides[].excludedFiles`, and `ignorePatterns`.
      * @param {string} [options.name] The config name.
+     * @throws {Error} If the config file is invalid.
      * @returns {ConfigArray} Loaded config. An empty `ConfigArray` if any config doesn't exist.
      */
     loadInDirectory(directoryPath, { basePath, name } = {}) {
@@ -3027,6 +3044,7 @@ class ConfigArrayFactory {
     /**
      * Load `.eslintignore` file in the current working directory.
      * @returns {ConfigArray} Loaded config. An empty `ConfigArray` if any config doesn't exist.
+     * @throws {Error} If the ignore file is invalid.
      */
     loadDefaultESLintIgnore() {
         const slots = internalSlotsMap$1.get(this);
@@ -3039,7 +3057,7 @@ class ConfigArrayFactory {
         if (fs__default["default"].existsSync(packageJsonPath)) {
             const data = loadJSONConfigFile(packageJsonPath);
 
-            if (Object.hasOwnProperty.call(data, "eslintIgnore")) {
+            if (Object.hasOwn(data, "eslintIgnore")) {
                 if (!Array.isArray(data.eslintIgnore)) {
                     throw new Error("Package.json eslintIgnore property requires an array of paths");
                 }
@@ -3228,6 +3246,7 @@ class ConfigArrayFactory {
      * @param {string} extendName The name of a base config.
      * @param {ConfigArrayFactoryLoadingContext} ctx The loading context.
      * @returns {IterableIterator<ConfigArrayElement>} The normalized config.
+     * @throws {Error} If the extended config file can't be loaded.
      * @private
      */
     _loadExtends(extendName, ctx) {
@@ -3251,6 +3270,7 @@ class ConfigArrayFactory {
      * @param {string} extendName The name of a base config.
      * @param {ConfigArrayFactoryLoadingContext} ctx The loading context.
      * @returns {IterableIterator<ConfigArrayElement>} The normalized config.
+     * @throws {Error} If the extended config file can't be loaded.
      * @private
      */
     _loadExtendedBuiltInConfig(extendName, ctx) {
@@ -3300,6 +3320,7 @@ class ConfigArrayFactory {
      * @param {string} extendName The name of a base config.
      * @param {ConfigArrayFactoryLoadingContext} ctx The loading context.
      * @returns {IterableIterator<ConfigArrayElement>} The normalized config.
+     * @throws {Error} If the extended config file can't be loaded.
      * @private
      */
     _loadExtendedPluginConfig(extendName, ctx) {
@@ -3337,6 +3358,7 @@ class ConfigArrayFactory {
      * @param {string} extendName The name of a base config.
      * @param {ConfigArrayFactoryLoadingContext} ctx The loading context.
      * @returns {IterableIterator<ConfigArrayElement>} The normalized config.
+     * @throws {Error} If the extended config file can't be loaded.
      * @private
      */
     _loadExtendedShareableConfig(extendName, ctx) {
@@ -3758,7 +3780,7 @@ function createCLIConfigArray({
  */
 class ConfigurationNotFoundError extends Error {
 
-    // eslint-disable-next-line jsdoc/require-description
+
     /**
      * @param {string} directoryPath The directory path.
      */
@@ -3910,6 +3932,7 @@ class CascadingConfigArrayFactory {
      * @param {string} directoryPath The path to a leaf directory.
      * @param {boolean} configsExistInSubdirs `true` if configurations exist in subdirectories.
      * @returns {ConfigArray} The loaded config.
+     * @throws {Error} If a config file is invalid.
      * @private
      */
     _loadConfigInAncestors(directoryPath, configsExistInSubdirs = false) {
@@ -4011,6 +4034,7 @@ class CascadingConfigArrayFactory {
      * @param {string} directoryPath The path to the leaf directory to find config files.
      * @param {boolean} ignoreNotFoundError If `true` then it doesn't throw `ConfigurationNotFoundError`.
      * @returns {ConfigArray} The loaded config.
+     * @throws {Error} If a config file is invalid.
      * @private
      */
     _finalizeConfigArray(configArray, directoryPath, ignoreNotFoundError) {
@@ -4047,7 +4071,7 @@ class CascadingConfigArrayFactory {
                     !directoryPath.startsWith(homePath)
                 ) {
                     const lastElement =
-                        personalConfigArray[personalConfigArray.length - 1];
+                        personalConfigArray.at(-1);
 
                     emitDeprecationWarning(
                         lastElement.filePath,
@@ -4119,6 +4143,7 @@ const cafactory = Symbol("cafactory");
  * @param {ReadOnlyMap<string,Processor>} options.pluginProcessors A map of plugin processor
  *      names to objects.
  * @returns {Object} A flag-config-style config object.
+ * @throws {Error} If a plugin or environment cannot be resolved.
  */
 function translateESLintRC(eslintrcConfig, {
     resolveConfigRelativeTo,
@@ -4301,7 +4326,7 @@ class FlatCompat {
         this[cafactory] = new ConfigArrayFactory({
             cwd: baseDirectory,
             resolvePluginsRelativeTo,
-            getEslintAllConfig: () => {
+            getEslintAllConfig() {
 
                 if (!allConfig) {
                     throw new TypeError("Missing parameter 'allConfig' in FlatCompat constructor.");
@@ -4309,7 +4334,7 @@ class FlatCompat {
 
                 return allConfig;
             },
-            getEslintRecommendedConfig: () => {
+            getEslintRecommendedConfig() {
 
                 if (!recommendedConfig) {
                     throw new TypeError("Missing parameter 'recommendedConfig' in FlatCompat constructor.");