feat: added new fireEvent binding

src/__tests__/render-basics.js

@@ -43,3 +43,27 @@ test('Is able to make terminal input and view in-progress stdout', async () => {
 
   expect(await findByText('First option: Two')).toBeTruthy()
 })
+
+
+test('fireEvent works when bound', async () => {
+  const {fireEvent: fireEventLocal, findByText, cleanup} = await render('node', [
+    resolve(__dirname, './execute-scripts/stdio-inquirer.js'),
+  ])
+
+  const instance = await findByText('First option')
+
+  expect(instance).toBeTruthy()
+
+  // Windows uses ">", Linux/MacOS use "❯"
+  expect(await findByText(/[❯>] One/)).toBeTruthy()
+
+  cleanup();
+
+  fireEventLocal.down(instance)
+
+  expect(await findByText(/[❯>] Two/)).toBeTruthy()
+
+  fireEvent.enter(instance)
+  fireEvent.enter(instance)
+  cleanup();
+})

src/events.ts

@@ -0,0 +1,34 @@
+import {eventMap} from './event-map'
+import {TestInstance} from "../types/pure";
+import {ShiftArgs} from "../types/helpers";
+
+type FireEventRecord = Record<string, (instance: TestInstance) => void>;
+
+type BoundFireEventRecord = Record<
+    string,
+    ShiftArgs<FireEventRecord[string]>
+>
+
+
+const fireEvent = Object.entries(eventMap).reduce<FireEventRecord>(
+  (prev, [eventName, keyCode]) => {
+    prev[eventName] = (instance) => {
+      instance.stdin.write(keyCode)
+    }
+    return prev
+  },
+  {}
+)
+
+function getFireEventForElement (
+    instance: TestInstance
+) {
+    return {
+        fireEvent: Object.entries(fireEvent).reduce<BoundFireEventRecord>((prev, [eventName, eventFn]) => {
+            prev[eventName] = () => eventFn(instance)
+            return prev;
+        }, {})
+    }
+}
+
+export {fireEvent, getFireEventForElement}

src/pure.ts

@@ -9,6 +9,7 @@ import stripFinalNewline from 'strip-final-newline'
 import {RenderOptions, TestInstance} from '../types/pure'
 import {_runObservers} from './mutation-observer'
 import {getQueriesForElement} from './get-queries-for-instance'
+import {getFireEventForElement} from './events'
 import {setCurrentInstance} from "./helpers";
 
 async function render(
@@ -86,6 +87,7 @@ async function render(
       stderr: exec.stderr,
     },
     getQueriesForElement(execOutputAPI),
+    getFireEventForElement(execOutputAPI as unknown as TestInstance)
   )
 }
 

types/helpers.d.ts

@@ -0,0 +1,5 @@
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type Shift<Arr extends any[]> = Arr extends [any, ...infer Q] ? Q : never;
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type ShiftArgs<Fn extends (...args: any) => any> = (...props: Shift<Parameters<Fn>>) => ReturnType<Fn>