feat(nodes): ChainExpression

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

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

@@ -10,6 +10,7 @@ import type {
   AwaitExpression,
   BinaryExpression,
   CallExpression,
+  ChainExpression,
   FunctionExpression,
   Identifier,
   LiteralMap,
@@ -61,6 +62,11 @@ describe('unit-d:content/expression', () => {
         .toMatchTypeOf<NodeObject<CallExpression>>()
     })
 
+    it('should match NodeObject<ChainExpression>', () => {
+      expectTypeOf<TestSubject.ExpressionMap>()
+        .toMatchTypeOf<NodeObject<ChainExpression>>()
+    })
+
     it('should match NodeObject<FunctionExpression>', () => {
       expectTypeOf<TestSubject.ExpressionMap>()
         .toMatchTypeOf<NodeObject<FunctionExpression>>()

src/content/expression.ts

@@ -9,6 +9,7 @@ import type {
   AwaitExpression,
   BinaryExpression,
   CallExpression,
+  ChainExpression,
   FunctionExpression,
   Identifier,
   LiteralMap,
@@ -47,6 +48,7 @@ interface ExpressionMap extends LiteralMap {
   awaitExpression: AwaitExpression
   binaryExpression: BinaryExpression
   callExpression: CallExpression
+  chainExpression: ChainExpression
   functionExpression: FunctionExpression
   identifier: Identifier
   memberExpression: MemberExpression

src/nodes/__tests__/expression-chain.spec-d.ts

@@ -0,0 +1,46 @@
+/**
+ * @file Type Tests - ChainExpression
+ * @module esast/nodes/tests/unit-d/ChainExpression
+ */
+
+import type {
+  CallExpression,
+  Data,
+  MemberExpression,
+  Parent
+} from '@flex-development/esast'
+import type { Optional } from '@flex-development/tutils'
+import type * as TestSubject from '../expression-chain'
+
+describe('unit-d:nodes/ChainExpression', () => {
+  type Subject = TestSubject.default
+  type SubjectData = TestSubject.ChainExpressionData
+
+  it('should extend Parent', () => {
+    expectTypeOf<Subject>().toMatchTypeOf<Parent>()
+  })
+
+  it('should match [children: [CallExpression | MemberExpression]]', () => {
+    expectTypeOf<Subject>()
+      .toHaveProperty('children')
+      .toEqualTypeOf<[CallExpression | MemberExpression]>()
+  })
+
+  it('should match [data?: Optional<ChainExpressionData>]', () => {
+    expectTypeOf<Subject>()
+      .toHaveProperty('data')
+      .toEqualTypeOf<Optional<SubjectData>>()
+  })
+
+  it('should match [type: "chainExpression"]', () => {
+    expectTypeOf<Subject>()
+      .toHaveProperty('type')
+      .toEqualTypeOf<'chainExpression'>()
+  })
+
+  describe('ChainExpressionData', () => {
+    it('should extend Data', () => {
+      expectTypeOf<SubjectData>().toMatchTypeOf<Data>()
+    })
+  })
+})

src/nodes/expression-chain.ts

@@ -0,0 +1,52 @@
+/**
+ * @file Nodes - ChainExpression
+ * @module esast/nodes/ChainExpression
+ */
+
+import type {
+  CallExpression,
+  Data,
+  MemberExpression,
+  Parent
+} from '@flex-development/esast'
+import type { Optional } from '@flex-development/tutils'
+
+/**
+ * Info associated with chain expressions.
+ *
+ * @see {@linkcode Data}
+ *
+ * @extends {Data}
+ */
+interface ChainExpressionData extends Data {}
+
+/**
+ * A chain expression.
+ *
+ * @see {@linkcode Parent}
+ *
+ * @extends {Parent}
+ */
+interface ChainExpression extends Parent {
+  /**
+   * List of children.
+   *
+   * @see {@linkcode CallExpression}
+   * @see {@linkcode MemberExpression}
+   */
+  children: [expression: CallExpression | MemberExpression]
+
+  /**
+   * Info from the ecosystem.
+   *
+   * @see {@linkcode ChainExpressionData}
+   */
+  data?: Optional<ChainExpressionData>
+
+  /**
+   * Node type.
+   */
+  type: 'chainExpression'
+}
+
+export type { ChainExpressionData, ChainExpression as default }

src/nodes/index.ts

@@ -52,6 +52,10 @@ export type {
   default as CallExpression,
   CallExpressionData
 } from './expression-call'
+export type {
+  default as ChainExpression,
+  ChainExpressionData
+} from './expression-chain'
 export type {
   default as FunctionExpression,
   FunctionExpressionData