Migrate to eslint.config.mjs

`.eslintrc.json` is deprecated.

node_modules/@eslint/eslintrc/dist/eslintrc-universal.cjs

@@ -697,6 +697,13 @@ const severityMap = {
 
 const validated = new WeakSet();
 
+// JSON schema that disallows passing any options
+const noOptionsSchema = Object.freeze({
+    type: "array",
+    minItems: 0,
+    maxItems: 0
+});
+
 //-----------------------------------------------------------------------------
 // Exports
 //-----------------------------------------------------------------------------
@@ -708,17 +715,36 @@ class ConfigValidator {
 
     /**
      * Gets a complete options schema for a rule.
-     * @param {{create: Function, schema: (Array|null)}} rule A new-style rule object
-     * @returns {Object} JSON Schema for the rule's options.
+     * @param {Rule} rule A rule object
+     * @throws {TypeError} If `meta.schema` is specified but is not an array, object or `false`.
+     * @returns {Object|null} JSON Schema for the rule's options.
+     *      `null` if rule wasn't passed or its `meta.schema` is `false`.
      */
     getRuleOptionsSchema(rule) {
         if (!rule) {
             return null;
         }
 
-        const schema = rule.schema || rule.meta && rule.meta.schema;
+        if (!rule.meta) {
+            return { ...noOptionsSchema }; // default if `meta.schema` is not specified
+        }
 
-        // Given a tuple of schemas, insert warning level at the beginning
+        const schema = rule.meta.schema;
+
+        if (typeof schema === "undefined") {
+            return { ...noOptionsSchema }; // default if `meta.schema` is not specified
+        }
+
+        // `schema:false` is an allowed explicit opt-out of options validation for the rule
+        if (schema === false) {
+            return null;
+        }
+
+        if (typeof schema !== "object" || schema === null) {
+            throw new TypeError("Rule's `meta.schema` must be an array or object");
+        }
+
+        // ESLint-specific array form needs to be converted into a valid JSON Schema definition
         if (Array.isArray(schema)) {
             if (schema.length) {
                 return {
@@ -728,16 +754,13 @@ class ConfigValidator {
                     maxItems: schema.length
                 };
             }
-            return {
-                type: "array",
-                minItems: 0,
-                maxItems: 0
-            };
 
+            // `schema:[]` is an explicit way to specify that the rule does not accept any options
+            return { ...noOptionsSchema };
         }
 
-        // Given a full schema, leave it alone
-        return schema || null;
+        // `schema:<object>` is assumed to be a valid JSON Schema definition
+        return schema;
     }
 
     /**
@@ -765,10 +788,18 @@ class ConfigValidator {
      */
     validateRuleSchema(rule, localOptions) {
         if (!ruleValidators.has(rule)) {
-            const schema = this.getRuleOptionsSchema(rule);
+            try {
+                const schema = this.getRuleOptionsSchema(rule);
 
-            if (schema) {
-                ruleValidators.set(rule, ajv.compile(schema));
+                if (schema) {
+                    ruleValidators.set(rule, ajv.compile(schema));
+                }
+            } catch (err) {
+                const errorWithCode = new Error(err.message, { cause: err });
+
+                errorWithCode.code = "ESLINT_INVALID_RULE_OPTIONS_SCHEMA";
+
+                throw errorWithCode;
             }
         }
 
@@ -801,13 +832,21 @@ class ConfigValidator {
                 this.validateRuleSchema(rule, Array.isArray(options) ? options.slice(1) : []);
             }
         } catch (err) {
-            const enhancedMessage = `Configuration for rule "${ruleId}" is invalid:\n${err.message}`;
+            let enhancedMessage = err.code === "ESLINT_INVALID_RULE_OPTIONS_SCHEMA"
+                ? `Error while processing options validation schema of rule '${ruleId}': ${err.message}`
+                : `Configuration for rule "${ruleId}" is invalid:\n${err.message}`;
 
             if (typeof source === "string") {
-                throw new Error(`${source}:\n\t${enhancedMessage}`);
-            } else {
-                throw new Error(enhancedMessage);
+                enhancedMessage = `${source}:\n\t${enhancedMessage}`;
             }
+
+            const enhancedError = new Error(enhancedMessage, { cause: err });
+
+            if (err.code) {
+                enhancedError.code = err.code;
+            }
+
+            throw enhancedError;
         }
     }
 

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

@@ -716,31 +716,18 @@ function createConfig(instance, indices) {
  * @param {string} pluginId The plugin ID for prefix.
  * @param {Record<string,T>} defs The definitions to collect.
  * @param {Map<string, U>} map The map to output.
- * @param {function(T): U} [normalize] The normalize function for each value.
  * @returns {void}
  */
-function collect(pluginId, defs, map, normalize) {
+function collect(pluginId, defs, map) {
     if (defs) {
         const prefix = pluginId && `${pluginId}/`;
 
         for (const [key, value] of Object.entries(defs)) {
-            map.set(
-                `${prefix}${key}`,
-                normalize ? normalize(value) : value
-            );
+            map.set(`${prefix}${key}`, value);
         }
     }
 }
 
-/**
- * Normalize a rule definition.
- * @param {Function|Rule} rule The rule definition to normalize.
- * @returns {Rule} The normalized rule definition.
- */
-function normalizePluginRule(rule) {
-    return typeof rule === "function" ? { create: rule } : rule;
-}
-
 /**
  * Delete the mutation methods from a given map.
  * @param {Map<any, any>} map The map object to delete.
@@ -782,7 +769,7 @@ function initPluginMemberMaps(elements, slots) {
 
             collect(pluginId, plugin.environments, slots.envMap);
             collect(pluginId, plugin.processors, slots.processorMap);
-            collect(pluginId, plugin.rules, slots.ruleMap, normalizePluginRule);
+            collect(pluginId, plugin.rules, slots.ruleMap);
         }
     }
 
@@ -1938,6 +1925,13 @@ const severityMap = {
 
 const validated = new WeakSet();
 
+// JSON schema that disallows passing any options
+const noOptionsSchema = Object.freeze({
+    type: "array",
+    minItems: 0,
+    maxItems: 0
+});
+
 //-----------------------------------------------------------------------------
 // Exports
 //-----------------------------------------------------------------------------
@@ -1949,17 +1943,36 @@ class ConfigValidator {
 
     /**
      * Gets a complete options schema for a rule.
-     * @param {{create: Function, schema: (Array|null)}} rule A new-style rule object
-     * @returns {Object} JSON Schema for the rule's options.
+     * @param {Rule} rule A rule object
+     * @throws {TypeError} If `meta.schema` is specified but is not an array, object or `false`.
+     * @returns {Object|null} JSON Schema for the rule's options.
+     *      `null` if rule wasn't passed or its `meta.schema` is `false`.
      */
     getRuleOptionsSchema(rule) {
         if (!rule) {
             return null;
         }
 
-        const schema = rule.schema || rule.meta && rule.meta.schema;
+        if (!rule.meta) {
+            return { ...noOptionsSchema }; // default if `meta.schema` is not specified
+        }
 
-        // Given a tuple of schemas, insert warning level at the beginning
+        const schema = rule.meta.schema;
+
+        if (typeof schema === "undefined") {
+            return { ...noOptionsSchema }; // default if `meta.schema` is not specified
+        }
+
+        // `schema:false` is an allowed explicit opt-out of options validation for the rule
+        if (schema === false) {
+            return null;
+        }
+
+        if (typeof schema !== "object" || schema === null) {
+            throw new TypeError("Rule's `meta.schema` must be an array or object");
+        }
+
+        // ESLint-specific array form needs to be converted into a valid JSON Schema definition
         if (Array.isArray(schema)) {
             if (schema.length) {
                 return {
@@ -1969,16 +1982,13 @@ class ConfigValidator {
                     maxItems: schema.length
                 };
             }
-            return {
-                type: "array",
-                minItems: 0,
-                maxItems: 0
-            };
 
+            // `schema:[]` is an explicit way to specify that the rule does not accept any options
+            return { ...noOptionsSchema };
         }
 
-        // Given a full schema, leave it alone
-        return schema || null;
+        // `schema:<object>` is assumed to be a valid JSON Schema definition
+        return schema;
     }
 
     /**
@@ -2006,10 +2016,18 @@ class ConfigValidator {
      */
     validateRuleSchema(rule, localOptions) {
         if (!ruleValidators.has(rule)) {
-            const schema = this.getRuleOptionsSchema(rule);
+            try {
+                const schema = this.getRuleOptionsSchema(rule);
 
-            if (schema) {
-                ruleValidators.set(rule, ajv.compile(schema));
+                if (schema) {
+                    ruleValidators.set(rule, ajv.compile(schema));
+                }
+            } catch (err) {
+                const errorWithCode = new Error(err.message, { cause: err });
+
+                errorWithCode.code = "ESLINT_INVALID_RULE_OPTIONS_SCHEMA";
+
+                throw errorWithCode;
             }
         }
 
@@ -2042,13 +2060,21 @@ class ConfigValidator {
                 this.validateRuleSchema(rule, Array.isArray(options) ? options.slice(1) : []);
             }
         } catch (err) {
-            const enhancedMessage = `Configuration for rule "${ruleId}" is invalid:\n${err.message}`;
+            let enhancedMessage = err.code === "ESLINT_INVALID_RULE_OPTIONS_SCHEMA"
+                ? `Error while processing options validation schema of rule '${ruleId}': ${err.message}`
+                : `Configuration for rule "${ruleId}" is invalid:\n${err.message}`;
 
             if (typeof source === "string") {
-                throw new Error(`${source}:\n\t${enhancedMessage}`);
-            } else {
-                throw new Error(enhancedMessage);
+                enhancedMessage = `${source}:\n\t${enhancedMessage}`;
             }
+
+            const enhancedError = new Error(enhancedMessage, { cause: err });
+
+            if (err.code) {
+                enhancedError.code = err.code;
+            }
+
+            throw enhancedError;
         }
     }
 
@@ -4331,6 +4357,7 @@ const Legacy = {
     OverrideTester,
     getUsedExtractedConfigs,
     environments,
+    loadConfigFile,
 
     // shared
     ConfigOps,