eslint
diff --git a/Collapse file: docs/src/rules/no-restricted-imports.md
‎docs/src/rules/no-restricted-imports.md‎
Copy file name to clipboard
+168Lines changed: 168 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file: docs/src/rules/no-restricted-imports.md
‎docs/src/rules/no-restricted-imports.md‎
Copy file name to clipboard
+168Lines changed: 168 additions & 0 deletions
Display the source diff
Display the rich diff
@@ -282,6 +282,61 @@ import { AllowedObject } from "foo";
 
 :::
 
+#### allowTypeImports (TypeScript only)
+
+Whether to allow [Type-Only Imports](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-8.html#type-only-imports-and-export) for a path. This includes type-only `export` statements, as they are equivalent to re-exporting an `import`. Default: `false`.
+
+Examples of **incorrect** code for `allowTypeImports` in `paths`:
+
+::: incorrect { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { paths: [{
+    name: "import-foo",
+    allowTypeImports: true,
+    message: "Please use only type-only imports from 'import-foo'."
+}]}]*/
+
+import foo from 'import-foo';
+export { Foo } from 'import-foo';
+```
+
+:::
+
+Examples of **correct** code for `allowTypeImports` in `paths`:
+
+::: correct { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { paths: [{
+    name: "import-foo",
+    allowTypeImports: true,
+    message: "Please use only type-only imports from 'import-foo'."
+}]}]*/
+
+import type foo from 'import-foo';
+export type { Foo } from 'import-foo';
+
+import type foo = require("import-foo");
+```
+
+:::
+
+::: correct { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { paths: [{
+    name: "import-foo",
+	importNames: ["Baz"],
+    allowTypeImports: true,
+    message: "Please use 'Baz' from 'import-foo' as a type only."
+}]}]*/
+
+import { Bar, type Baz } from "import-foo";
+```
+
+:::
+
 ### patterns
 
 This is also an object option whose value is an array. This option allows you to specify multiple modules to restrict using `gitignore`-style patterns or regular expressions.
@@ -773,6 +828,119 @@ import { isEmpty } from 'utils/collection-utils';
 
 :::
 
+#### allowTypeImports (TypeScript only)
+
+Whether to allow [Type-Only Imports](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-8.html#type-only-imports-and-export) for a path. This includes type-only `export` statements, as they are equivalent to re-exporting an `import`. Default: `false`.
+
+```json
+"no-restricted-imports": ["error", {
+  "patterns": [{
+    "group": ["import/private/*"],
+    "allowTypeImports": true,
+  }]
+}]
+```
+
+Examples of **incorrect** code for `allowTypeImports` in `patterns`:
+
+::: incorrect { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { patterns: [{
+    group: ["import/private/*"],
+    allowTypeImports: true,
+    message: "Please use only type-only imports from 'import/private/*'."
+}]}]*/
+
+import { foo } from 'import/private/bar';
+export { foo } from 'import/private/bar';
+```
+
+:::
+
+Examples of **correct** code for `allowTypeImports` in `patterns`:
+
+::: correct { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { patterns: [{
+    group: ["import/private/*"],
+    allowTypeImports: true,
+    message: "Please use only type-only imports from 'import/private/*'."
+}]}]*/
+
+import type { foo } from 'import/private/bar';
+export type { foo } from 'import/private/bar';
+
+import type foo = require("import/private/bar");
+```
+
+:::
+
+::: correct { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { patterns: [{
+    group: ["import/private/*"],
+    importNames: ["Baz"],
+    allowTypeImports: true,
+    message: "Please use 'Baz' from 'import/private/*' as a type only."
+}]}]*/
+
+import { Bar, type Baz } from "import/private/bar";
+```
+
+:::
+
+## Known Limitations
+
+TypeScript [`import = require()` syntax](https://www.typescriptlang.org/docs/handbook/2/modules.html#es-module-syntax-with-commonjs-behavior) is valid and the rule can recognize and lint such instances, but with certain limitations.
+
+You can only fully restrict these imports, you cannot restrict them based on specific import names like `importNames`, `allowImportNames`, `importNamePattern`, or `allowImportNamePattern` options.
+
+Examples of **incorrect** code for TypeScript import equals declarations:
+
+::: incorrect { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", "disallowed-import"]*/
+
+import foo = require("disallowed-import");
+```
+
+:::
+
+::: incorrect { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { 
+  "paths": [{ "name": "disallowed-import" }] 
+}]*/
+
+import foo = require("disallowed-import");
+```
+
+:::
+
+**Note:** Import name restrictions do not apply to TypeScript import equals declarations. The following configuration will not restrict the import equals declaration:
+
+::: correct { "sourceType": "module" }
+
+```ts
+/*eslint no-restricted-imports: ["error", { 
+  "paths": [{ 
+    "name": "foo",
+    "importNames": ["foo"]
+  }] 
+}]*/
+
+// This import equals declaration will NOT be restricted
+// even though it imports the entire module
+import foo = require("foo");
+```
+
+:::
+
 ## When Not To Use It
 
 Don't use this rule or don't include a module in the list for this rule if you want to be able to import a module in your project without an ESLint error or warning.