feat(content): ModuleDeclaration, ModuleDeclarationMap

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

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

@@ -0,0 +1,27 @@
+/**
+ * @file Type Tests - moduleDeclaration
+ * @module esast/content/tests/unit-d/moduleDeclaration
+ */
+
+import type { ExportDeclarationMap } from '@flex-development/esast'
+import type * as TestSubject from '../declaration-module'
+
+describe('unit-d:content/moduleDeclaration', () => {
+  describe('ModuleDeclaration', () => {
+    it('should equal ModuleDeclarationMap[keyof ModuleDeclarationMap]', () => {
+      // Arrange
+      type K = keyof TestSubject.ModuleDeclarationMap
+      type Expect = TestSubject.ModuleDeclarationMap[K]
+
+      // Expect
+      expectTypeOf<TestSubject.ModuleDeclaration>().toEqualTypeOf<Expect>
+    })
+  })
+
+  describe('ModuleDeclarationMap', () => {
+    it('should extend ExportDeclarationMap', () => {
+      expectTypeOf<TestSubject.ModuleDeclarationMap>()
+        .toMatchTypeOf<ExportDeclarationMap>()
+    })
+  })
+})

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

@@ -4,7 +4,12 @@
  */
 
 import type { NodeObject } from '#tests/types'
-import type { Comment, Directive, StatementMap } from '@flex-development/esast'
+import type {
+  Comment,
+  Directive,
+  ModuleDeclarationMap,
+  StatementMap
+} from '@flex-development/esast'
 import type * as TestSubject from '../root'
 
 describe('unit-d:content/root', () => {
@@ -19,6 +24,10 @@ describe('unit-d:content/root', () => {
   })
 
   describe('RootMap', () => {
+    it('should extend ModuleDeclarationMap', () => {
+      expectTypeOf<TestSubject.RootMap>().toMatchTypeOf<ModuleDeclarationMap>()
+    })
+
     it('should extend StatementMap', () => {
       expectTypeOf<TestSubject.RootMap>().toMatchTypeOf<StatementMap>()
     })

src/content/declaration-module.ts

@@ -0,0 +1,32 @@
+/**
+ * @file Content - moduleDeclaration
+ * @module esast/content/moduleDeclaration
+ */
+
+import type { ExportDeclarationMap } from '@flex-development/esast'
+
+/**
+ * Union of registered esast nodes that can occur where a module declaration is
+ * expected.
+ *
+ * To register custom esast nodes, augment {@linkcode ModuleDeclarationMap}.
+ * They will be added to this union automatically.
+ */
+type ModuleDeclaration = ModuleDeclarationMap[keyof ModuleDeclarationMap]
+
+/**
+ * Registry of nodes that can occur where a {@linkcode ModuleDeclaration} is
+ * expected.
+ *
+ * This interface can be augmented to register custom node types.
+ *
+ * @example
+ *  declare module '@flex-development/esast' {
+ *    interface ModuleDeclarationMap {
+ *      customModuleDeclaration: CustomModuleDeclaration
+ *    }
+ *  }
+ */
+interface ModuleDeclarationMap extends ExportDeclarationMap {}
+
+export type { ModuleDeclaration, ModuleDeclarationMap }

src/content/index.ts

@@ -5,6 +5,7 @@
 
 export type * from './declaration'
 export type * from './declaration-export'
+export type * from './declaration-module'
 export type * from './expression'
 export type * from './heritage'
 export type * from './literal'

src/content/root.ts

@@ -3,14 +3,19 @@
  * @module esast/content/root
  */
 
-import type { Comment, Directive, StatementMap } from '@flex-development/esast'
+import type {
+  Comment,
+  Directive,
+  ModuleDeclarationMap,
+  StatementMap
+} from '@flex-development/esast'
 
 /**
  * Union of registered esast nodes that can occur where a root child node is
  * expected.
  *
- * To register custom esast nodes, augment {@linkcode RootMap}. They will
- * be added to this union automatically.
+ * To register custom esast nodes, augment {@linkcode RootMap}. They will be
+ * added to this union automatically.
  */
 type RootChild = RootMap[keyof RootMap]
 
@@ -26,9 +31,10 @@ type RootChild = RootMap[keyof RootMap]
  *    }
  *  }
  *
+ * @extends {ModuleDeclarationMap}
  * @extends {StatementMap}
  */
-interface RootMap extends StatementMap {
+interface RootMap extends ModuleDeclarationMap, StatementMap {
   comment: Comment
   directive: Directive
 }