Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 | 4x 16x 16x 8x 19x 16x 14x 14x 14x 16x | import {
combine,
// eslint-disable-next-line @typescript-eslint/no-unused-vars
type Readable,
type Config,
type MapReadablesToValues,
type OwnedReadable,
type ReadableLike,
strictEqual,
} from "@embra/reactivity";
import { useMemo, useRef } from "react";
import { type ReadableImpl } from "../readable";
import { useIsomorphicLayoutEffect } from "./utils";
export interface UseCombine {
/**
* Combines an array of {@link ReadableLike}s into a single {@link Readable} with the array of values.
* @param deps An array of {@link ReadableLike}s to combine. It follows the React rules of hooks where the length of the array must remain constant.
* @returns A {@link Readable} with the combined values.
*/
<TDeps extends readonly ReadableLike[]>(deps: TDeps): OwnedReadable<MapReadablesToValues<TDeps>>;
/**
* Combines an array of {@link ReadableLike}s into a single {@link Readable} with transformed value.
* @param deps - An array of {@link ReadableLike}s to combine. It follows the React rules of hooks where the length of the array must remain constant.
* @param transform - A pure function that takes multiple values and returns a new value.
* @param config - Optional custom {@link Config}.
* @returns An {@link OwnedReadable} with the transformed values.
*/
<TDeps extends readonly ReadableLike[], TValue>(
deps: TDeps,
transform: (...deps: MapReadablesToValues<TDeps>) => TValue,
config?: Config<TValue>,
): OwnedReadable<TValue>;
}
/**
* Combines an array of {@link ReadableLike}s into a single {@link Readable} with transformed value.
*
* Note that changes to `transform` and `config` will not trigger re-derivation; `useCombine` always uses the latest `transform` and `config` in the derivation.
*
* @category Hooks
* @param deps - An array of {@link ReadableLike}s to combine. It follows the React rules of hooks where the length of the array must remain constant.
* @param transform - Optional pure function that takes multiple values and returns a new value.
* @param config - Optional custom {@link Config}.
* @returns An {@link OwnedReadable} with the transformed values.
*
* @example
* ```tsx
* import { useCombine, useValue } from "@embra/reactivity/react";
*
* function App({ width$, height$ }) {
* const size$ = useCombine(
* [width$, height$],
* ([width, height]) => ({ width, height }),
* { equal: (s1, 22) => s1.width === s2.width && s1.height === s2.height }
* );
* const size = useValue(size$);
* }
* ```
*/
export const useCombine: UseCombine = <TDeps extends readonly ReadableLike[], TValue>(
deps: TDeps,
transform?: (...deps: MapReadablesToValues<TDeps>) => TValue,
config?: Config<TValue>,
): OwnedReadable<TValue> => {
const transformRef = useRef(transform);
const computed = useMemo(
() =>
combine(
deps,
(...deps) => (transformRef.current ? transformRef.current(...deps) : (deps as unknown as TValue)),
config,
),
deps,
);
useIsomorphicLayoutEffect(() => {
transformRef.current = transform;
(computed as ReadableImpl).name = config?.name;
(computed as ReadableImpl).equal_ = (config?.equal ?? strictEqual) || undefined;
}, [transform, config]);
return computed;
};
|