test(ast-spec): add fixtures for all declaration nodes (#4967)

packages/ast-spec/src/base/ClassBase.ts

@@ -0,0 +1,70 @@
+import type { Identifier } from '../expression/Identifier/spec';
+import type { ClassBody } from '../special/ClassBody/spec';
+import type { Decorator } from '../special/Decorator/spec';
+import type { TSClassImplements } from '../special/TSClassImplements/spec';
+import type { TSTypeParameterDeclaration } from '../special/TSTypeParameterDeclaration/spec';
+import type { TSTypeParameterInstantiation } from '../special/TSTypeParameterInstantiation/spec';
+import type { LeftHandSideExpression } from '../unions/LeftHandSideExpression';
+import type { BaseNode } from './BaseNode';
+
+export interface ClassBase extends BaseNode {
+  /**
+   * Whether the class is an abstract class.
+   * ```
+   * abstract class Foo {...}
+   * ```
+   * This is always `undefined` for `ClassExpression`.
+   */
+  // TODO(#5020) - make this `false` if it is not `abstract`
+  abstract?: boolean;
+  /**
+   * The class body.
+   */
+  body: ClassBody;
+  /**
+   * Whether the class has been `declare`d:
+   * ```
+   * declare class Foo {...}
+   * ```
+   * This is always `undefined` for `ClassExpression`.
+   */
+  // TODO(#5020) - make this `false` if it is not `declare`d
+  declare?: boolean;
+  /**
+   * The decorators declared for the class.
+   * This is `undefined` if there are no decorators.
+   * ```
+   * @deco
+   * class Foo {...}
+   * ```
+   * This is always `undefined` for `ClassExpression`.
+   */
+  // TODO(#5020) - make this an empty array if there are none declared
+  decorators?: Decorator[];
+  /**
+   * The class's name.
+   * - For a `ClassExpression` this may be `null` if the name is omitted.
+   * - For a `ClassDeclaration` this may be `null` if and only if the parent is
+   *   an `ExportDefaultDeclaration`.
+   */
+  id: Identifier | null;
+  /**
+   * The implemented interfaces for the class.
+   * This is `undefined` if there are no implemented interfaces.
+   */
+  implements?: TSClassImplements[];
+  /**
+   * The super class this class extends.
+   */
+  superClass: LeftHandSideExpression | null;
+  /**
+   * The generic type parameters passed to the superClass.
+   * This is `undefined` if there are no generic type parameters passed.
+   */
+  superTypeParameters?: TSTypeParameterInstantiation;
+  /**
+   * The generic type parameters declared for the class.
+   * This is `undefined` if there are no generic type parameters declared.
+   */
+  typeParameters?: TSTypeParameterDeclaration;
+}

packages/ast-spec/src/base/FunctionBase.ts

@@ -0,0 +1,74 @@
+import type { Identifier } from '../expression/Identifier/spec';
+import type { TSTypeAnnotation } from '../special/TSTypeAnnotation/spec';
+import type { TSTypeParameterDeclaration } from '../special/TSTypeParameterDeclaration/spec';
+import type { BlockStatement } from '../statement/BlockStatement/spec';
+import type { Expression } from '../unions/Expression';
+import type { Parameter } from '../unions/Parameter';
+import type { BaseNode } from './BaseNode';
+
+export interface FunctionBase extends BaseNode {
+  /**
+   * Whether the function is async:
+   * ```
+   * async function foo(...) {...}
+   * const x = async function (...) {...}
+   * const x = async (...) => {...}
+   * ```
+   */
+  async: boolean;
+  /**
+   * The body of the function.
+   * - For an `ArrowFunctionExpression` this may be an `Expression` or `BlockStatement`.
+   * - For a `FunctionDeclaration` or `FunctionExpression` this is always a `BlockStatement.
+   * - For a `TSDeclareFunction` this is always `undefined`.
+   * - For a `TSEmptyBodyFunctionExpression` this is always `null`.
+   */
+  body?: BlockStatement | Expression | null;
+  /**
+   * This is only `true` if and only if the node is a `TSDeclareFunction` and it has `declare`:
+   * ```
+   * declare function foo(...) {...}
+   * ```
+   */
+  // TODO(#5020) - make this always `false` if it is not `declare`d instead of `undefined`
+  declare?: boolean;
+  /**
+   * This is only ever `true` if and only the node is an `ArrowFunctionExpression` and the body
+   * is an expression:
+   * ```
+   * (() => 1)
+   * ```
+   */
+  expression: boolean;
+  /**
+   * Whether the function is a generator function:
+   * ```
+   * function *foo(...) {...}
+   * const x = function *(...) {...}
+   * ```
+   * This is always `false` for arrow functions as they cannot be generators.
+   */
+  generator: boolean;
+  /**
+   * The function's name.
+   * - For an `ArrowFunctionExpression` this is always `null`.
+   * - For a `FunctionExpression` this may be `null` if the name is omitted.
+   * - For a `FunctionDeclaration` or `TSDeclareFunction` this may be `null` if
+   *   and only if the parent is an `ExportDefaultDeclaration`.
+   */
+  id: Identifier | null;
+  /**
+   * The list of parameters declared for the function.
+   */
+  params: Parameter[];
+  /**
+   * The return type annotation for the function.
+   * This is `undefined` if there is no return type declared.
+   */
+  returnType?: TSTypeAnnotation;
+  /**
+   * The generic type parameter declaration for the function.
+   * This is `undefined` if there are no generic type parameters declared.
+   */
+  typeParameters?: TSTypeParameterDeclaration;
+}

packages/ast-spec/src/base/TSHeritageBase.ts

@@ -3,7 +3,7 @@ import type { Expression } from '../unions/Expression';
 import type { BaseNode } from './BaseNode';
 
 export interface TSHeritageBase extends BaseNode {
-  // TODO(error handling) - this should be restricted to MemberExpression | Identifier
+  // TODO(#1852) - this should be restricted to MemberExpression | Identifier
   expression: Expression;
   typeParameters?: TSTypeParameterInstantiation;
 }

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-body/snapshots/1-TSESTree-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-body TSESTree - Error 1`] = `[TSError: '{' expected.]`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-body/snapshots/2-Babel-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-body Babel - Error 1`] = `[SyntaxError: Unexpected token, expected "{" (1:9)]`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-body/snapshots/3-Alignment-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-body Error Alignment 1`] = `"Both errored"`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-extends-type-param/fixture.ts

@@ -0,0 +1 @@
+class C extends D<> {}

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-extends-type-param/snapshots/1-TSESTree-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-extends-type-param TSESTree - Error 1`] = `"NO ERROR"`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-extends-type-param/snapshots/2-Babel-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-extends-type-param Babel - Error 1`] = `[SyntaxError: Type argument list cannot be empty. (1:17)]`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-extends-type-param/snapshots/3-Alignment-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-extends-type-param Error Alignment 1`] = `"Babel errored but TSESTree didn't"`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-type-param/fixture.ts

@@ -0,0 +1 @@
+class C<> {}

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-type-param/snapshots/1-TSESTree-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-type-param TSESTree - Error 1`] = `"NO ERROR"`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-type-param/snapshots/2-Babel-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-type-param Babel - Error 1`] = `[SyntaxError: Type parameter list cannot be empty. (1:7)]`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/missing-type-param/snapshots/3-Alignment-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ missing-type-param Error Alignment 1`] = `"Babel errored but TSESTree didn't"`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/non-identifier-type-param/fixture.ts

@@ -0,0 +1 @@
+class C<1> {}

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/non-identifier-type-param/snapshots/1-TSESTree-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ non-identifier-type-param TSESTree - Error 1`] = `[TSError: Type parameter declaration expected.]`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/non-identifier-type-param/snapshots/2-Babel-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ non-identifier-type-param Babel - Error 1`] = `[SyntaxError: Unexpected token (1:8)]`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/_error_/non-identifier-type-param/snapshots/3-Alignment-Error.shot

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration _error_ non-identifier-type-param Error Alignment 1`] = `"Both errored"`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorMany/snapshots/1-TSESTree-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-many/snapshots/1-TSESTree-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorMany TSESTree - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-many TSESTree - AST 1`] = `
 Program {
   type: "Program",
   body: Array [

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorMany/snapshots/2-TSESTree-Tokens.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-many/snapshots/2-TSESTree-Tokens.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorMany TSESTree - Tokens 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-many TSESTree - Tokens 1`] = `
 Array [
   Punctuator {
     type: "Punctuator",

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorMany/snapshots/3-Babel-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-many/snapshots/3-Babel-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorMany Babel - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-many Babel - AST 1`] = `
 Program {
   type: "Program",
   body: Array [

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorMany/snapshots/4-Babel-Tokens.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-many/snapshots/4-Babel-Tokens.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorMany Babel - Tokens 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-many Babel - Tokens 1`] = `
 Array [
   Punctuator {
     type: "Punctuator",

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-many/snapshots/5-AST-Alignment-AST.shot

@@ -0,0 +1,6 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration decorator-many AST Alignment - AST 1`] = `
+"Snapshot Diff:
+Compared values have no visual difference."
+`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-many/snapshots/6-AST-Alignment-Tokens.shot

@@ -0,0 +1,6 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`AST Fixtures declaration ClassDeclaration decorator-many AST Alignment - Token 1`] = `
+"Snapshot Diff:
+Compared values have no visual difference."
+`;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorOne/snapshots/1-TSESTree-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-one/snapshots/1-TSESTree-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorOne TSESTree - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-one TSESTree - AST 1`] = `
 Program {
   type: "Program",
   body: Array [

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorOne/snapshots/2-TSESTree-Tokens.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-one/snapshots/2-TSESTree-Tokens.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorOne TSESTree - Tokens 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-one TSESTree - Tokens 1`] = `
 Array [
   Punctuator {
     type: "Punctuator",

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorOne/snapshots/3-Babel-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-one/snapshots/3-Babel-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorOne Babel - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-one Babel - AST 1`] = `
 Program {
   type: "Program",
   body: Array [

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorOne/snapshots/4-Babel-Tokens.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-one/snapshots/4-Babel-Tokens.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorOne Babel - Tokens 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-one Babel - Tokens 1`] = `
 Array [
   Punctuator {
     type: "Punctuator",

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorMany/snapshots/5-AST-Alignment-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-one/snapshots/5-AST-Alignment-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorMany AST Alignment - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-one AST Alignment - AST 1`] = `
 "Snapshot Diff:
 Compared values have no visual difference."
 `;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decoratorMany/snapshots/6-AST-Alignment-Tokens.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/decorator-one/snapshots/6-AST-Alignment-Tokens.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration decoratorMany AST Alignment - Token 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration decorator-one AST Alignment - Token 1`] = `
 "Snapshot Diff:
 Compared values have no visual difference."
 `;

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-parameters/snapshots/1-TSESTree-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-param/snapshots/1-TSESTree-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration extends-type-parameters TSESTree - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration extends-type-param TSESTree - AST 1`] = `
 Program {
   type: "Program",
   body: Array [

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-parameters/snapshots/2-TSESTree-Tokens.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-param/snapshots/2-TSESTree-Tokens.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration extends-type-parameters TSESTree - Tokens 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration extends-type-param TSESTree - Tokens 1`] = `
 Array [
   Keyword {
     type: "Keyword",

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-parameters/snapshots/3-Babel-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-param/snapshots/3-Babel-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration extends-type-parameters Babel - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration extends-type-param Babel - AST 1`] = `
 Program {
   type: "Program",
   body: Array [

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-parameters/snapshots/4-Babel-Tokens.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-param/snapshots/4-Babel-Tokens.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration extends-type-parameters Babel - Tokens 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration extends-type-param Babel - Tokens 1`] = `
 Array [
   Keyword {
     type: "Keyword",

packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-parameters/snapshots/5-AST-Alignment-AST.shot → packages/ast-spec/src/declaration/ClassDeclaration/fixtures/extends-type-param/snapshots/5-AST-Alignment-AST.shot

@@ -1,6 +1,6 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`AST Fixtures declaration ClassDeclaration extends-type-parameters AST Alignment - AST 1`] = `
+exports[`AST Fixtures declaration ClassDeclaration extends-type-param AST Alignment - AST 1`] = `
 "Snapshot Diff:
 Compared values have no visual difference."
 `;