fix(typescript-estree): wrap import = declaration in an export node

packages/ast-spec/src/declaration/TSImportEqualsDeclaration/fixtures/entity-name-many/snapshots/1-TSESTree-AST.shot

@@ -17,7 +17,6 @@ Program {
         },
       },
       importKind: "value",
-      isExport: false,
       moduleReference: TSQualifiedName {
         type: "TSQualifiedName",
         left: TSQualifiedName {

packages/ast-spec/src/declaration/TSImportEqualsDeclaration/fixtures/entity-name-many/snapshots/5-AST-Alignment-AST.shot

@@ -2,5 +2,88 @@
 
 exports[`AST Fixtures declaration TSImportEqualsDeclaration entity-name-many AST Alignment - AST 1`] = `
 "Snapshot Diff:
-Compared values have no visual difference."
+- TSESTree
++ Babel
+
+  Program {
+    type: 'Program',
+    body: Array [
+      TSImportEqualsDeclaration {
+        type: 'TSImportEqualsDeclaration',
+        id: Identifier {
+          type: 'Identifier',
+          name: 'F',
+
+          range: [7, 8],
+          loc: {
+            start: { column: 7, line: 1 },
+            end: { column: 8, line: 1 },
+          },
+        },
+        importKind: 'value',
++       isExport: false,
+        moduleReference: TSQualifiedName {
+          type: 'TSQualifiedName',
+          left: TSQualifiedName {
+            type: 'TSQualifiedName',
+            left: Identifier {
+              type: 'Identifier',
+              name: 'A',
+
+              range: [11, 12],
+              loc: {
+                start: { column: 11, line: 1 },
+                end: { column: 12, line: 1 },
+              },
+            },
+            right: Identifier {
+              type: 'Identifier',
+              name: 'B',
+
+              range: [13, 14],
+              loc: {
+                start: { column: 13, line: 1 },
+                end: { column: 14, line: 1 },
+              },
+            },
+
+            range: [11, 14],
+            loc: {
+              start: { column: 11, line: 1 },
+              end: { column: 14, line: 1 },
+            },
+          },
+          right: Identifier {
+            type: 'Identifier',
+            name: 'C',
+
+            range: [15, 16],
+            loc: {
+              start: { column: 15, line: 1 },
+              end: { column: 16, line: 1 },
+            },
+          },
+
+          range: [11, 16],
+          loc: {
+            start: { column: 11, line: 1 },
+            end: { column: 16, line: 1 },
+          },
+        },
+
+        range: [0, 17],
+        loc: {
+          start: { column: 0, line: 1 },
+          end: { column: 17, line: 1 },
+        },
+      },
+    ],
+    sourceType: 'script',
+
+    range: [0, 18],
+    loc: {
+      start: { column: 0, line: 1 },
+      end: { column: 0, line: 2 },
+    },
+  }"
 `;

packages/ast-spec/src/declaration/TSImportEqualsDeclaration/fixtures/entity-name-one/snapshots/1-TSESTree-AST.shot

@@ -17,7 +17,6 @@ Program {
         },
       },
       importKind: "value",
-      isExport: false,
       moduleReference: Identifier {
         type: "Identifier",
         name: "A",

packages/ast-spec/src/declaration/TSImportEqualsDeclaration/fixtures/entity-name-one/snapshots/5-AST-Alignment-AST.shot

@@ -2,5 +2,50 @@
 
 exports[`AST Fixtures declaration TSImportEqualsDeclaration entity-name-one AST Alignment - AST 1`] = `
 "Snapshot Diff:
-Compared values have no visual difference."
+- TSESTree
++ Babel
+
+  Program {
+    type: 'Program',
+    body: Array [
+      TSImportEqualsDeclaration {
+        type: 'TSImportEqualsDeclaration',
+        id: Identifier {
+          type: 'Identifier',
+          name: 'F',
+
+          range: [7, 8],
+          loc: {
+            start: { column: 7, line: 1 },
+            end: { column: 8, line: 1 },
+          },
+        },
+        importKind: 'value',
++       isExport: false,
+        moduleReference: Identifier {
+          type: 'Identifier',
+          name: 'A',
+
+          range: [11, 12],
+          loc: {
+            start: { column: 11, line: 1 },
+            end: { column: 12, line: 1 },
+          },
+        },
+
+        range: [0, 13],
+        loc: {
+          start: { column: 0, line: 1 },
+          end: { column: 13, line: 1 },
+        },
+      },
+    ],
+    sourceType: 'script',
+
+    range: [0, 14],
+    loc: {
+      start: { column: 0, line: 1 },
+      end: { column: 0, line: 2 },
+    },
+  }"
 `;

packages/ast-spec/src/declaration/TSImportEqualsDeclaration/fixtures/external-module-ref-string/snapshots/1-TSESTree-AST.shot

@@ -17,7 +17,6 @@ Program {
         },
       },
       importKind: "value",
-      isExport: false,
       moduleReference: TSExternalModuleReference {
         type: "TSExternalModuleReference",
         expression: Literal {

packages/ast-spec/src/declaration/TSImportEqualsDeclaration/fixtures/external-module-ref-string/snapshots/5-AST-Alignment-AST.shot

@@ -21,7 +21,7 @@ exports[`AST Fixtures declaration TSImportEqualsDeclaration external-module-ref-
           },
         },
         importKind: 'value',
-        isExport: false,
++       isExport: false,
         moduleReference: TSExternalModuleReference {
           type: 'TSExternalModuleReference',
           expression: Literal {

packages/ast-spec/src/declaration/TSImportEqualsDeclaration/spec.ts

@@ -22,12 +22,4 @@ export interface TSImportEqualsDeclaration extends BaseNode {
   moduleReference: EntityName | TSExternalModuleReference;
   // TODO(#1852) - breaking change remove this as it is invalid
   importKind: ImportKind;
-  /**
-   * Whether this is immediately exported
-   * ```
-   * export import F = A;
-   * ```
-   */
-  // TODO(#4130) - this should be represented in the AST
-  isExport: boolean;
 }

packages/ast-spec/src/unions/ExportDeclaration.ts

@@ -8,6 +8,7 @@ import type {
 } from '../declaration/FunctionDeclaration/spec';
 import type { TSDeclareFunction } from '../declaration/TSDeclareFunction/spec';
 import type { TSEnumDeclaration } from '../declaration/TSEnumDeclaration/spec';
+import type { TSImportEqualsDeclaration } from '../declaration/TSImportEqualsDeclaration/spec';
 import type { TSInterfaceDeclaration } from '../declaration/TSInterfaceDeclaration/spec';
 import type { TSModuleDeclaration } from '../declaration/TSModuleDeclaration/spec';
 import type { TSTypeAliasDeclaration } from '../declaration/TSTypeAliasDeclaration/spec';
@@ -37,6 +38,7 @@ export type NamedExportDeclarations =
   | FunctionDeclarationWithOptionalName
   | TSDeclareFunction
   | TSEnumDeclaration
+  | TSImportEqualsDeclaration
   | TSInterfaceDeclaration
   | TSModuleDeclaration
   | TSTypeAliasDeclaration

packages/ast-spec/tests/fixtures-with-differences-ast.shot

@@ -17,6 +17,8 @@ Set {
   "declaration/FunctionDeclaration/fixtures/type-param-one/fixture.ts",
   "declaration/TSDeclareFunction/fixtures/type-param-many/fixture.ts",
   "declaration/TSDeclareFunction/fixtures/type-param-one/fixture.ts",
+  "declaration/TSImportEqualsDeclaration/fixtures/entity-name-many/fixture.ts",
+  "declaration/TSImportEqualsDeclaration/fixtures/entity-name-one/fixture.ts",
   "declaration/TSImportEqualsDeclaration/fixtures/external-module-ref-string/fixture.ts",
   "declaration/TSInterfaceDeclaration/fixtures/extends-many/fixture.ts",
   "declaration/TSInterfaceDeclaration/fixtures/extends-one/fixture.ts",

packages/typescript-estree/src/convert.ts

@@ -143,6 +143,7 @@ export class Converter {
       | ts.ClassDeclaration
       | ts.ClassExpression
       | ts.TypeAliasDeclaration
+      | ts.ImportEqualsDeclaration
       | ts.InterfaceDeclaration
       | ts.EnumDeclaration
       | ts.ModuleDeclaration,
@@ -159,7 +160,7 @@ export class Converter {
       const exportKeyword = modifiers[0];
       const nextModifier = modifiers[1];
       const declarationIsDefault =
-        nextModifier && nextModifier.kind === SyntaxKind.DefaultKeyword;
+        nextModifier?.kind === SyntaxKind.DefaultKeyword;
 
       const varToken = declarationIsDefault
         ? findNextToken(nextModifier, this.ast, this.ast)
@@ -169,12 +170,15 @@ export class Converter {
       result.loc = getLocFor(result.range[0], result.range[1], this.ast);
 
       if (declarationIsDefault) {
-        return this.createNode<TSESTree.ExportDefaultDeclaration>(node, {
-          type: AST_NODE_TYPES.ExportDefaultDeclaration,
-          declaration: result,
-          range: [exportKeyword.getStart(this.ast), result.range[1]],
-          exportKind: 'value',
-        });
+        return this.createNode<TSESTree.ExportDefaultDeclaration>(
+          node as Exclude<typeof node, ts.ImportEqualsDeclaration>,
+          {
+            type: AST_NODE_TYPES.ExportDefaultDeclaration,
+            declaration: result as TSESTree.DefaultExportDeclarations,
+            range: [exportKeyword.getStart(this.ast), result.range[1]],
+            exportKind: 'value',
+          },
+        );
       } else {
         const isType =
           result.type === AST_NODE_TYPES.TSInterfaceDeclaration ||
@@ -2778,13 +2782,15 @@ export class Converter {
         });
       }
       case SyntaxKind.ImportEqualsDeclaration: {
-        return this.createNode<TSESTree.TSImportEqualsDeclaration>(node, {
-          type: AST_NODE_TYPES.TSImportEqualsDeclaration,
-          id: this.convertChild(node.name),
-          moduleReference: this.convertChild(node.moduleReference),
-          importKind: node.isTypeOnly ? 'type' : 'value',
-          isExport: hasModifier(SyntaxKind.ExportKeyword, node),
-        });
+        return this.fixExports(
+          node,
+          this.createNode<TSESTree.TSImportEqualsDeclaration>(node, {
+            type: AST_NODE_TYPES.TSImportEqualsDeclaration,
+            id: this.convertChild(node.name),
+            importKind: node.isTypeOnly ? 'type' : 'value',
+            moduleReference: this.convertChild(node.moduleReference),
+          }),
+        );
       }
       case SyntaxKind.ExternalModuleReference: {
         return this.createNode<TSESTree.TSExternalModuleReference>(node, {

packages/typescript-estree/src/ts-estree/estree-to-ts-node-types.ts

@@ -55,6 +55,7 @@ export interface EstreeToTsNodeTypes {
     | ts.ClassDeclaration
     | ts.ClassExpression
     | ts.TypeAliasDeclaration
+    | ts.ImportEqualsDeclaration
     | ts.InterfaceDeclaration
     | ts.EnumDeclaration
     | ts.ModuleDeclaration;

packages/typescript-estree/tests/ast-alignment/fixtures-to-test.ts

@@ -371,6 +371,16 @@ tester.addFixturePatternConfig('typescript/basics', {
     'class-with-two-methods-computed-constructor',
     'export-type-star-from',
     'import-type-error',
+
+    /**
+     * Babel's 'typescript' transform gives these TypeScript-like properties
+     * such as `isExport: false`, but we don't include those in our AST.
+     */
+    'import-equal-declaration',
+    'import-export-equal-declaration',
+    'import-equal-type-declaration',
+    'import-export-equal-type-declaration',
+
     /**
      * [TS-ESTREE ERRORED, BUT BABEL DID NOT]
      * This is intentional; babel is not checking types
@@ -404,10 +414,6 @@ tester.addFixturePatternConfig('typescript/basics', {
      * @see https://github.com/babel/babel/issues/9213
      */
     'export-assignment',
-    'import-equal-declaration',
-    'import-export-equal-declaration',
-    'import-equal-type-declaration',
-    'import-export-equal-type-declaration',
     // babel treats declare and types as not a module
     'export-declare-const-named-enum',
     'export-declare-named-enum',

packages/typescript-estree/tests/snapshots/typescript/basics/import-equal-declaration.src.ts.shot

@@ -23,7 +23,6 @@ Object {
         "type": "Identifier",
       },
       "importKind": "value",
-      "isExport": false,
       "loc": Object {
         "end": Object {
           "column": 28,

packages/typescript-estree/tests/snapshots/typescript/basics/import-equal-type-declaration.src.ts.shot

@@ -23,7 +23,6 @@ Object {
         "type": "Identifier",
       },
       "importKind": "type",
-      "isExport": false,
       "loc": Object {
         "end": Object {
           "column": 33,