✨ dispatch: add middleware-extensible host events

packages/ui/src/dispatch.test.ts

@@ -0,0 +1,18 @@
+import { describe, expect, test } from 'vitest';
+import { DispatchApi } from './dispatch.ts';
+import { createHost } from './host.ts';
+
+describe('dispatch', () => {
+	test('propagates errors thrown by decorators installed on the host', () => {
+		const host = createHost();
+		const reason = new Error('dispatch failed');
+		const dispatch = DispatchApi.init(host.root);
+		DispatchApi.decorate(host.root, () => ({
+			dispatch() {
+				throw reason;
+			},
+		}));
+
+		expect(() => dispatch.dispatch({})).toThrow(reason);
+	});
+});

packages/ui/src/dispatch.ts

@@ -0,0 +1,16 @@
+import { Api } from './core/api.ts';
+
+export class DispatchApi extends Api {
+	dispatch(_event: unknown): Result {
+		return { ok: true };
+	}
+}
+
+export type Result =
+	| typeof Ok
+	| {
+			ok: false;
+			reason: unknown;
+	  };
+
+const Ok = { ok: true } as const;

packages/ui/src/index.ts

@@ -1,4 +1,5 @@
 export { rgba } from '@bomb.sh/tty';
+export { DispatchApi } from './dispatch.ts';
 export { box, type BoxProps } from './components/box.ts';
 export { text, type TextProps } from './components/text.ts';
 export { LayoutApi } from './layout.ts';