@virtualstate/navigation/src/util/deferred.ts

Native JavaScript [navigation](https://developer.mozilla.org/en-US/docs/Web/API/Navigation_API) implementation

export interface Deferred<T = void> {
  resolve(value: T): void;
  reject(reason: unknown): void;
  promise: Promise<T>;
}

/**
 * @param handleCatch rejected promises automatically to allow free usage
 */
export function deferred<T = void>(
  handleCatch?: () => T | Promise<T>
): Deferred<T> {
  let resolve: Deferred<T>["resolve"] | undefined = undefined,
    reject: Deferred<T>["reject"] | undefined = undefined;
  const promise = new Promise<T>((resolveFn, rejectFn) => {
    resolve = resolveFn;
    reject = rejectFn;
  });
  ok(resolve);
  ok(reject);
  return {
    resolve,
    reject,
    promise: handleCatch ? promise.catch(handleCatch) : promise,
  };
}

function ok(value: unknown): asserts value {
  if (!value) {
    throw new Error("Value not provided");
  }
}