improve typing of element finding utils

src/utils.ts

@@ -49,3 +49,13 @@ const _emptyIterableIterator = new class EmptyIterableIterator implements Iterab
 export function emptyIterableIterator<T>(): IterableIterator<T> {
   return _emptyIterableIterator;
 }
+
+type FindElementSuccess<T> = {
+  found: true;
+  element: T;
+};
+type FindElementFail = {
+  found: false;
+  reason?: number;
+};
+export type FindElementResult<T> = FindElementSuccess<T> | FindElementFail;