ef.js

Declarative DOM helper experiment

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35
  36. 36
  37. 37
  38. 38
  39. 39
  40. 40
  41. 41
  42. 42
  43. 43
  44. 44
  45. 45
  46. 46
  47. 47
  48. 48
  49. 49
  50. 50
  51. 51
  52. 52
  53. 53
  54. 54
  55. 55
  56. 56
  57. 57
  58. 58
  59. 59
  60. 60
  61. 61
  62. 62
  63. 63
  64. 64
  65. 65
  66. 66
  67. 67
  68. 68
  69. 69
// This module "extends" ef.js with a helper function named `series`
import {
  derived,
  type Computation,
  effect,
  signal,
  type ReactiveValue,
} from "../../src/ef.js";

export * from "../../src/ef.js";

function abortPromise(signal: AbortSignal) {
  return new Promise<never>((_, reject) => {
    signal.addEventListener(
      "abort",
      (e) => {
        reject(e);
      },
      { once: true },
    );
  });
}

/**
 * Helper function to write async value with async generator function disguising
 * pure async + algebraic effect function. This improves code readability by reducing
 * code jumps (you can think in stream)
 */
export function series<T>(
  initialValue: T,
  f: (
    ctx: Computation,
    abortSignal: AbortSignal,
  ) => AsyncGenerator<T, void, undefined>,
): ReactiveValue<T> {
  const $s = signal<T>(initialValue);

  effect((ctx) => {
    $s.set(initialValue);

    const abortController = new AbortController();

    const i = f(ctx, abortController.signal);

    const consume = async () => {
      try {
        const iter = await Promise.race([
          i.next(),
          abortPromise(abortController.signal),
        ]);

        if (iter.done) {
          return;
        }

        $s.set(iter.value);
        consume();
      } catch {}
    };

    consume();

    return () => {
      abortController.abort();
    };
  });

  return derived(() => $s.get());
}