feat!: drop support for jiti < 2.2.0 (#20016)

michaelfaith · fasttime · web-flow · commit 523c07686640 · 2025-11-08T16:55:55.000+01:00
* feat!: drop support for jiti &lt; 2.2.0

This change removes support for `jiti` `&lt; 2.2.0`.  Now, if you're wanting to use a TypeScript config without Node's native type stripping, you must have at least version `2.2.0` of `jiti` installed.

* updated for pr feedback

* fix formatting

* add to the migration doc

* revert formatting

* Update docs/src/use/migrate-to-10.0.0.md

correct latest jiti version

Co-authored-by: Francesco Trotta &lt;github@fasttime.org&gt;

* fix test merge issue

---------

Co-authored-by: Francesco Trotta &lt;github@fasttime.org&gt;
diff --git a/.github/renovate.json5 b/.github/renovate.json5
@@ -1,7 +1,6 @@
 {
   $schema: "https://docs.renovatebot.com/renovate-schema.json",
   extends: ["github>eslint/workflows//.github/renovate/base.json5"],
-  ignoreDeps: ["jiti-v2.0", "jiti-v2.1"],
   packageRules: [
     {
       description: "Group Babel packages into a single PR.",
diff --git a/docs/src/use/configure/configuration-files.md b/docs/src/use/configure/configuration-files.md
@@ -793,7 +793,7 @@ In this case, ESLint does not search for configuration files and instead uses `s
 
 ## TypeScript Configuration Files
 
-For Deno and Bun, TypeScript configuration files are natively supported; for Node.js, you must install the optional dev dependency [`jiti`](https://github.com/unjs/jiti) in version 2.0.0 or later in your project (this dependency is not automatically installed by ESLint):
+For Deno and Bun, TypeScript configuration files are natively supported; for Node.js, you must install the optional dev dependency [`jiti`](https://github.com/unjs/jiti) in version 2.2.0 or later in your project (this dependency is not automatically installed by ESLint):
 
 {{ npm_tabs({
     command: "install",
diff --git a/docs/src/use/migrate-to-10.0.0.md b/docs/src/use/migrate-to-10.0.0.md
@@ -19,6 +19,7 @@ The lists below are ordered roughly by the number of users each change is expect
 - [New configuration file lookup algorithm](#config-lookup-from-file)
 - [`no-shadow-restricted-names` now reports `globalThis` by default](#no-shadow-restricted-names)
 - [`eslint:recommended` has been updated](#eslint-recommended)
+- [Jiti < v2.2.0 are no longer supported](#-jiti--v220-are-no-longer-supported)
 
 ### Breaking changes for plugin developers
 
@@ -87,3 +88,11 @@ Three new rules have been enabled in `eslint:recommended`:
 **To address:** Fix errors or disable these rules.
 
 **Related issue(s):** [#19966](https://github.com/eslint/eslint/issues/19966)
+
+## <a name="drop-old-jiti"></a> Jiti < v2.2.0 are no longer supported
+
+ESLint is officially dropping support for versions of `jiti` that are less than v2.2.0.
+
+**To address:** If you've authored your config file in `TypeScript` and have `jiti` v2.1.2 or earlier installed, be sure to update it to at least `2.2.0` when using ESLint v10.
+
+**Related issue(s):** [#19765](https://github.com/eslint/eslint/issues/19765)
diff --git a/knip.jsonc b/knip.jsonc
@@ -30,8 +30,6 @@
         "c8",
         // Optional peer dependency used for loading TypeScript configuration files
         "jiti",
-        "jiti-v2.0",
-        "jiti-v2.1",
       ],
     },
     "docs": {
diff --git a/lib/config/config-loader.js b/lib/config/config-loader.js
@@ -147,8 +147,11 @@ async function loadTypeScriptConfigFileWithJiti(filePath, fileURL, mtime) {
 			);
 		});
 
-	// `createJiti` was added in jiti v2.
-	if (typeof createJiti !== "function") {
+	// Ensure the version is at least 2.2.0.
+	const [jitiMajor, jitiMinor] = jitiVersion
+		.split(".")
+		.map(versionPart => Number(versionPart));
+	if (jitiMajor < 2 || (jitiMajor === 2 && jitiMinor < 2)) {
 		throw new Error(
 			"You are using an outdated version of the 'jiti' library. Please update to the latest version of 'jiti' to ensure compatibility and access to the latest features.",
 		);
@@ -162,10 +165,6 @@ async function loadTypeScriptConfigFileWithJiti(filePath, fileURL, mtime) {
 		moduleCache: false,
 	};
 
-	if (jitiVersion.startsWith("2.1.")) {
-		jitiOptions.interopDefault = false;
-	}
-
 	const jiti = createJiti(__filename, jitiOptions);
 	const config = await jiti.import(fileURL.href);
 
diff --git a/package.json b/package.json
@@ -175,8 +175,6 @@
     "got": "^11.8.3",
     "gray-matter": "^4.0.3",
     "jiti": "^2.6.1",
-    "jiti-v2.0": "npm:jiti@2.0.x",
-    "jiti-v2.1": "npm:jiti@2.1.x",
     "knip": "^5.60.2",
     "lint-staged": "^11.0.0",
     "markdown-it": "^12.2.0",
diff --git a/tests/lib/eslint/eslint.js b/tests/lib/eslint/eslint.js

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`$schema: "https://docs.renovatebot.com/renovate-schema.json",`
`3`	`3`	`extends: ["github>eslint/workflows//.github/renovate/base.json5"],`
`4`		`- ignoreDeps: ["jiti-v2.0", "jiti-v2.1"],`
`5`	`4`	`packageRules: [`
`6`	`5`	`{`
`7`	`6`	`description: "Group Babel packages into a single PR.",`