feat(nodes): Identifier

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

src/nodes/__tests__/identifier.spec-d.ts

@@ -0,0 +1,47 @@
+/**
+ * @file Type Tests - Identifier
+ * @module esast/nodes/tests/unit-d/Identifier
+ */
+
+import type { Data, Node } from '@flex-development/esast'
+import type { Nilable, Optional } from '@flex-development/tutils'
+import type * as TestSubject from '../identifier'
+
+describe('unit-d:nodes/Identifier', () => {
+  type Identifier = TestSubject.default
+  type IdentifierData = TestSubject.IdentifierData
+
+  it('should extend Node', () => {
+    expectTypeOf<Identifier>().toMatchTypeOf<Node>()
+  })
+
+  it('should match [data?: Optional<IdentifierData>]', () => {
+    expectTypeOf<Identifier>()
+      .toHaveProperty('data')
+      .toEqualTypeOf<Optional<IdentifierData>>()
+  })
+
+  it('should match [name: string]', () => {
+    expectTypeOf<Identifier>()
+      .toHaveProperty('name')
+      .toEqualTypeOf<string>()
+  })
+
+  it('should match [type: "identifier"]', () => {
+    expectTypeOf<Identifier>()
+      .toHaveProperty('type')
+      .toEqualTypeOf<'identifier'>()
+  })
+
+  describe('IdentifierData', () => {
+    it('should extend Data', () => {
+      expectTypeOf<IdentifierData>().toMatchTypeOf<Data>()
+    })
+
+    it('should match [private?: Nilable<boolean>]', () => {
+      expectTypeOf<IdentifierData>()
+        .toHaveProperty('private')
+        .toEqualTypeOf<Nilable<boolean>>()
+    })
+  })
+})

src/nodes/identifier.ts

@@ -0,0 +1,49 @@
+/**
+ * @file Nodes - Identifier
+ * @module esast/nodes/Identifier
+ */
+
+import type { Data, Node } from '@flex-development/esast'
+import type { Nilable, Optional } from '@flex-development/tutils'
+
+/**
+ * Info associated with identifiers.
+ *
+ * @see {@linkcode Data}
+ *
+ * @extends {Data}
+ */
+interface IdentifierData extends Data {
+  /**
+   * Private identifier?
+   */
+  private?: Nilable<boolean>
+}
+
+/**
+ * An identifier.
+ *
+ * @see {@linkcode Node}
+ *
+ * @extends {Node}
+ */
+interface Identifier extends Node {
+  /**
+   * Info from the ecosystem.
+   *
+   * @see {@linkcode IdentifierData}
+   */
+  data?: Optional<IdentifierData>
+
+  /**
+   * Identifier name.
+   */
+  name: string
+
+  /**
+   * Node type.
+   */
+  type: 'identifier'
+}
+
+export type { IdentifierData, Identifier as default }

src/nodes/index.ts

@@ -4,6 +4,7 @@
  * @see https://github.com/syntax-tree/unist#nodes
  */
 
+export type { default as Identifier, IdentifierData } from './identifier'
 export type { default as Literal } from './literal'
 export type { default as BigIntLiteral } from './literal-bigint'
 export type { default as BooleanLiteral } from './literal-boolean'