feat: export ESLint.defaultConfig (#18983)

snitin315 · web-flow · commit f879be240ca7 · 2024-10-09T01:49:02.000+05:30
* feat: export `ESLint.defaultConfig`

* fix: freeze defaultConfig object

* fix: update defaultConfig type

* refactor: freeze default config while exporting

* docs: udpate description
diff --git a/docs/src/integrate/nodejs-api.md b/docs/src/integrate/nodejs-api.md
@@ -330,6 +330,16 @@ The version string of ESLint. E.g. `"7.0.0"`.
 
 This is a static property.
 
+### ◆ ESLint.defaultConfig
+
+```js
+const defaultConfig = ESLint.defaultConfig;
+```
+
+The default configuration that ESLint uses internally. This is provided for tooling that wants to calculate configurations using the same defaults as ESLint. Keep in mind that the default configuration may change from version to version, so you shouldn't rely on any particular keys or values to be present.
+
+This is a static property.
+
 ### ◆ ESLint.outputFixes(results)
 
 ```js
diff --git a/lib/config/default-config.js b/lib/config/default-config.js
@@ -15,7 +15,7 @@ const Rules = require("../rules");
 // Helpers
 //-----------------------------------------------------------------------------
 
-exports.defaultConfig = [
+exports.defaultConfig = Object.freeze([
     {
         plugins: {
             "@": {
@@ -72,4 +72,4 @@ exports.defaultConfig = [
             ecmaVersion: "latest"
         }
     }
-];
+]);
diff --git a/lib/eslint/eslint.js b/lib/eslint/eslint.js
@@ -15,6 +15,7 @@ const path = require("node:path");
 const { version } = require("../../package.json");
 const { Linter } = require("../linter");
 const { getRuleFromConfig } = require("../config/flat-config-helpers");
+const { defaultConfig } = require("../config/default-config");
 const {
     Legacy: {
         ConfigOps: {
@@ -52,6 +53,7 @@ const { ConfigLoader, LegacyConfigLoader } = require("../config/config-loader");
 //------------------------------------------------------------------------------
 
 // For VSCode IntelliSense
+/** @typedef {import("../cli-engine/cli-engine").ConfigArray} ConfigArray */
 /** @typedef {import("../shared/types").ConfigData} ConfigData */
 /** @typedef {import("../shared/types").DeprecatedRuleInfo} DeprecatedRuleInfo */
 /** @typedef {import("../shared/types").LintMessage} LintMessage */
@@ -522,6 +524,15 @@ class ESLint {
         return version;
     }
 
+    /**
+     * The default configuration that ESLint uses internally. This is provided for tooling that wants to calculate configurations using the same defaults as ESLint.
+     * Keep in mind that the default configuration may change from version to version, so you shouldn't rely on any particular keys or values to be present.
+     * @type {ConfigArray}
+     */
+    static get defaultConfig() {
+        return defaultConfig;
+    }
+
     /**
      * Outputs fixes from the given results to files.
      * @param {LintResult[]} results The lint results.
diff --git a/lib/types/index.d.ts b/lib/types/index.d.ts
@@ -1396,6 +1396,12 @@ export class ESLint {
 
     static readonly version: string;
 
+    /**
+     * The default configuration that ESLint uses internally. This is provided for tooling that wants to calculate configurations using the same defaults as ESLint.
+     * Keep in mind that the default configuration may change from version to version, so you shouldn't rely on any particular keys or values to be present.
+     */
+    static readonly defaultConfig: Linter.Config[];
+
     static outputFixes(results: ESLint.LintResult[]): Promise<void>;
 
     static getErrorResults(results: ESLint.LintResult[]): ESLint.LintResult[];
diff --git a/tests/lib/eslint/eslint.js b/tests/lib/eslint/eslint.js
@@ -29,6 +29,7 @@ const shell = require("shelljs");
 const hash = require("../../../lib/cli-engine/hash");
 const { unIndent, createCustomTeardown } = require("../../_utils");
 const { shouldUseFlatConfig } = require("../../../lib/eslint/eslint");
+const { defaultConfig } = require("../../../lib/config/default-config");
 const coreRules = require("../../../lib/rules");
 const espree = require("espree");
 
@@ -158,6 +159,10 @@ describe("ESLint", () => {
                 assert.strictEqual(ESLint.configType, "flat");
             });
 
+            it("should have the defaultConfig static property", () => {
+                assert.deepStrictEqual(ESLint.defaultConfig, defaultConfig);
+            });
+
             it("the default value of 'options.cwd' should be the current working directory.", async () => {
                 process.chdir(__dirname);
                 try {

Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@ const Rules = require("../rules");`
`15`	`15`	`// Helpers`
`16`	`16`	`//-----------------------------------------------------------------------------`
`17`	`17`
`18`		`-exports.defaultConfig = [`
	`18`	`+exports.defaultConfig = Object.freeze([`
`19`	`19`	`{`
`20`	`20`	`plugins: {`
`21`	`21`	`"@": {`
`@@ -72,4 +72,4 @@ exports.defaultConfig = [`
`72`	`72`	`ecmaVersion: "latest"`
`73`	`73`	`}`
`74`	`74`	`}`
`75`		`-];`
	`75`	`+]);`