refactor(content)!: ModuleReference -> ModuleStatement

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

src/content/__tests__/content.spec-d.ts

@@ -8,7 +8,7 @@ import type {
   ExportDeclaration,
   Expression,
   LiteralValue,
-  ModuleReference,
+  ModuleStatement,
   Pattern,
   Primitive,
   RootChild,
@@ -35,8 +35,8 @@ describe('unit-d:content/Content', () => {
     expectTypeOf<TestSubject>().extract<LiteralValue>().not.toBeNever()
   })
 
-  it('should extract ModuleReference', () => {
-    expectTypeOf<TestSubject>().extract<ModuleReference>().not.toBeNever()
+  it('should extract ModuleStatement', () => {
+    expectTypeOf<TestSubject>().extract<ModuleStatement>().not.toBeNever()
   })
 
   it('should extract Pattern', () => {

src/content/__tests__/root.spec-d.ts

@@ -8,7 +8,6 @@ import type {
   Comment,
   Decorator,
   Directive,
-  ModuleReferenceMap,
   StatementMap
 } from '@flex-development/esast'
 import type * as TestSubject from '../root'
@@ -25,10 +24,6 @@ describe('unit-d:content/root', () => {
   })
 
   describe('RootMap', () => {
-    it('should extend ModuleReferenceMap', () => {
-      expectTypeOf<TestSubject.RootMap>().toMatchTypeOf<ModuleReferenceMap>()
-    })
-
     it('should extend StatementMap', () => {
       expectTypeOf<TestSubject.RootMap>().toMatchTypeOf<StatementMap>()
     })

src/content/__tests__/statement-module.spec-d.ts

@@ -0,0 +1,36 @@
+/**
+ * @file Type Tests - moduleStatement
+ * @module esast/content/tests/unit-d/moduleStatement
+ */
+
+import type { NodeObject } from '#tests/types'
+import type {
+  ExportDeclaration,
+  ImportDeclaration
+} from '@flex-development/esast'
+import type * as TestSubject from '../statement-module'
+
+describe('unit-d:content/moduleStatement', () => {
+  describe('ModuleStatement', () => {
+    it('should equal ModuleStatementMap[keyof ModuleStatementMap]', () => {
+      // Arrange
+      type K = keyof TestSubject.ModuleStatementMap
+      type Expect = TestSubject.ModuleStatementMap[K]
+
+      // Expect
+      expectTypeOf<TestSubject.ModuleStatement>().toEqualTypeOf<Expect>
+    })
+  })
+
+  describe('ModuleStatementMap', () => {
+    it('should match NodeObject<ExportDeclaration>', () => {
+      expectTypeOf<TestSubject.ModuleStatementMap>()
+        .toMatchTypeOf<NodeObject<ExportDeclaration>>()
+    })
+
+    it('should match NodeObject<ImportDeclaration>', () => {
+      expectTypeOf<TestSubject.ModuleStatementMap>()
+        .toMatchTypeOf<NodeObject<ImportDeclaration>>()
+    })
+  })
+})

src/content/__tests__/statement.spec-d.ts

@@ -18,6 +18,7 @@ import type {
   ForStatement,
   IfStatement,
   LabeledStatement,
+  ModuleStatementMap,
   ReturnStatement,
   StaticBlock,
   SwitchStatement,
@@ -41,6 +42,11 @@ describe('unit-d:content/statement', () => {
       expectTypeOf<TestSubject.StatementMap>().toMatchTypeOf<DeclarationMap>()
     })
 
+    it('should extend ModuleStatementMap', () => {
+      expectTypeOf<TestSubject.StatementMap>()
+        .toMatchTypeOf<ModuleStatementMap>()
+    })
+
     it('should match NodeObject<BlockStatement>', () => {
       expectTypeOf<TestSubject.StatementMap>()
         .toMatchTypeOf<NodeObject<BlockStatement>>()

src/content/index.ts

@@ -11,9 +11,9 @@ export type * from './expression-atomic'
 export type * from './expression-subscript'
 export type * from './expression-type'
 export type * from './literal'
-export type * from './module-reference'
 export type * from './node'
 export type * from './pattern'
 export type * from './primitive'
 export type * from './root'
 export type * from './statement'
+export type * from './statement-module'

src/content/root.ts

@@ -7,7 +7,6 @@ import type {
   Comment,
   Decorator,
   Directive,
-  ModuleReferenceMap,
   StatementMap
 } from '@flex-development/esast'
 
@@ -32,10 +31,9 @@ type RootChild = RootMap[keyof RootMap]
  *    }
  *  }
  *
- * @extends {ModuleReferenceMap}
  * @extends {StatementMap}
  */
-interface RootMap extends ModuleReferenceMap, StatementMap {
+interface RootMap extends StatementMap {
   comment: Comment
   decorator: Decorator
   directive: Directive

src/content/module-reference.ts → src/content/statement-module.ts

@@ -1,6 +1,6 @@
 /**
- * @file Content - moduleReference
- * @module esast/content/moduleReference
+ * @file Content - moduleStatement
+ * @module esast/content/moduleStatement
  */
 
 import type {
@@ -9,30 +9,30 @@ import type {
 } from '@flex-development/esast'
 
 /**
- * Union of registered esast nodes that can occur where a module reference is
+ * Union of registered esast nodes that can occur where a module statement is
  * expected.
  *
- * To register custom esast nodes, augment {@linkcode ModuleReferenceMap}. They
+ * To register custom esast nodes, augment {@linkcode ModuleStatementMap}. They
  * will be added to this union automatically.
  */
-type ModuleReference = ModuleReferenceMap[keyof ModuleReferenceMap]
+type ModuleStatement = ModuleStatementMap[keyof ModuleStatementMap]
 
 /**
- * Registry of nodes that can occur where a {@linkcode ModuleReference} is
+ * Registry of nodes that can occur where a {@linkcode ModuleStatement} is
  * expected.
  *
  * This interface can be augmented to register custom node types.
  *
  * @example
  *  declare module '@flex-development/esast' {
- *    interface ModuleReferenceMap {
- *      customModuleReference: CustomModuleReference
+ *    interface ModuleStatementMap {
+ *      customModuleStatement: CustomModuleStatement
  *    }
  *  }
  */
-interface ModuleReferenceMap {
+interface ModuleStatementMap {
   exportDeclaration: ExportDeclaration
   importDeclaration: ImportDeclaration
 }
 
-export type { ModuleReference, ModuleReferenceMap }
+export type { ModuleStatement, ModuleStatementMap }

src/content/statement.ts

@@ -17,6 +17,7 @@ import type {
   ForStatement,
   IfStatement,
   LabeledStatement,
+  ModuleStatementMap,
   ReturnStatement,
   StaticBlock,
   SwitchStatement,
@@ -47,8 +48,9 @@ type Statement = StatementMap[keyof StatementMap]
  *  }
  *
  * @extends {DeclarationMap}
+ * @extends ModuleStatementMap
  */
-interface StatementMap extends DeclarationMap {
+interface StatementMap extends DeclarationMap, ModuleStatementMap {
   blockStatement: BlockStatement
   breakStatement: BreakStatement
   continueStatement: ContinueStatement

src/nodes/module-body.ts

@@ -7,7 +7,6 @@ import type {
   Comment,
   Data,
   Directive,
-  ModuleReference,
   Parent,
   Statement
 } from '@flex-development/esast'
@@ -34,10 +33,9 @@ interface ModuleBody extends Parent {
    *
    * @see {@linkcode Comment}
    * @see {@linkcode Directive}
-   * @see {@linkcode ModuleReference}
    * @see {@linkcode Statement}
    */
-  children: (Comment | Directive | ModuleReference | Statement)[]
+  children: (Comment | Directive | Statement)[]
 
   /**
    * Info from the ecosystem.