feat(nodes): ImportDeclaration

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

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

@@ -3,7 +3,11 @@
  * @module esast/content/tests/unit-d/moduleDeclaration
  */
 
-import type { ExportDeclarationMap } from '@flex-development/esast'
+import type { NodeObject } from '#tests/types'
+import type {
+  ExportDeclarationMap,
+  ImportDeclaration
+} from '@flex-development/esast'
 import type * as TestSubject from '../declaration-module'
 
 describe('unit-d:content/moduleDeclaration', () => {
@@ -23,5 +27,10 @@ describe('unit-d:content/moduleDeclaration', () => {
       expectTypeOf<TestSubject.ModuleDeclarationMap>()
         .toMatchTypeOf<ExportDeclarationMap>()
     })
+
+    it('should match NodeObject<ImportDeclaration>', () => {
+      expectTypeOf<TestSubject.ModuleDeclarationMap>()
+        .toMatchTypeOf<NodeObject<ImportDeclaration>>()
+    })
   })
 })

src/content/declaration-module.ts

@@ -3,7 +3,10 @@
  * @module esast/content/moduleDeclaration
  */
 
-import type { ExportDeclarationMap } from '@flex-development/esast'
+import type {
+  ExportDeclarationMap,
+  ImportDeclaration
+} from '@flex-development/esast'
 
 /**
  * Union of registered esast nodes that can occur where a module declaration is
@@ -27,6 +30,8 @@ type ModuleDeclaration = ModuleDeclarationMap[keyof ModuleDeclarationMap]
  *    }
  *  }
  */
-interface ModuleDeclarationMap extends ExportDeclarationMap {}
+interface ModuleDeclarationMap extends ExportDeclarationMap {
+  importDeclaration: ImportDeclaration
+}
 
 export type { ModuleDeclaration, ModuleDeclarationMap }

src/nodes/__tests__/declaration-import.spec-d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file Type Tests - ImportDeclaration
+ * @module esast/nodes/tests/unit-d/ImportDeclaration
+ */
+
+import type {
+  Data,
+  ImportKind,
+  ImportSpecifiers,
+  Parent,
+  StringLiteral
+} from '@flex-development/esast'
+import type { Optional } from '@flex-development/tutils'
+import type * as TestSubject from '../declaration-import'
+
+describe('unit-d:nodes/ImportDeclaration', () => {
+  type Subject = TestSubject.default
+  type SubjectData = TestSubject.ImportDeclarationData
+
+  it('should extend Parent', () => {
+    expectTypeOf<Subject>().toMatchTypeOf<Parent>()
+  })
+
+  it('should match [children: [ImportSpecifiers, StringLiteral]]', () => {
+    expectTypeOf<Subject>()
+      .toHaveProperty('children')
+      .toEqualTypeOf<[ImportSpecifiers, StringLiteral]>()
+  })
+
+  it('should match [data?: Optional<ImportDeclarationData>]', () => {
+    expectTypeOf<Subject>()
+      .toHaveProperty('data')
+      .toEqualTypeOf<Optional<SubjectData>>()
+  })
+
+  it('should match [kind: ImportKind]', () => {
+    expectTypeOf<Subject>().toHaveProperty('kind').toEqualTypeOf<ImportKind>()
+  })
+
+  it('should match [type: "importDeclaration"]', () => {
+    expectTypeOf<Subject>()
+      .toHaveProperty('type')
+      .toEqualTypeOf<'importDeclaration'>()
+  })
+
+  describe('ImportDeclarationData', () => {
+    it('should extend Data', () => {
+      expectTypeOf<SubjectData>().toMatchTypeOf<Data>()
+    })
+  })
+})

src/nodes/declaration-import.ts

@@ -0,0 +1,60 @@
+/**
+ * @file Nodes - ImportDeclaration
+ * @module esast/nodes/ImportDeclaration
+ */
+
+import type {
+  Data,
+  ImportKind,
+  ImportSpecifiers,
+  Parent,
+  StringLiteral
+} from '@flex-development/esast'
+import type { Optional } from '@flex-development/tutils'
+
+/**
+ * Info associated with `import` declarations.
+ *
+ * @see {@linkcode Data}
+ *
+ * @extends {Data}
+ */
+interface ImportDeclarationData extends Data {}
+
+/**
+ * An `import` declaration.
+ *
+ * @see {@linkcode Parent}
+ *
+ * @extends {Parent}
+ */
+interface ImportDeclaration extends Parent {
+  /**
+   * List of children.
+   *
+   * @see {@linkcode ImportSpecifiers}
+   * @see {@linkcode StringLiteral}
+   */
+  children: [specifiers: ImportSpecifiers, source: StringLiteral]
+
+  /**
+   * Info from the ecosystem.
+   *
+   * @see {@linkcode ImportDeclarationData}
+   */
+  data?: Optional<ImportDeclarationData>
+
+  /**
+   * Import kind.
+   *
+   * @see {@linkcode ImportKind}
+   */
+  kind: ImportKind
+
+  /**
+   * Node type.
+   */
+  type: 'importDeclaration'
+}
+
+export type { ImportDeclarationData, ImportDeclaration as default }

src/nodes/index.ts

@@ -31,6 +31,10 @@ export type {
   default as FunctionDeclaration,
   FunctionDeclarationData
 } from './declaration-function'
+export type {
+  default as ImportDeclaration,
+  ImportDeclarationData
+} from './declaration-import'
 export type {
   default as VariableDeclaration,
   VariableDeclarationData