@ispb/react-lazy 0.0.8 → 0.0.10

package/README.md

@@ -112,7 +112,15 @@ import { LazyContext } from "@ispb/react-lazy"
 </LazyContext.Provider>
 ```
 
-Available options are `onLoading`, `onReloading`, `onError`, `defaultMessage`, `loadingMessage`, `reloadingMessage`, and `errorMessage`. Per-component overrides take precedence over context options.
+Available options are `onLoading`, `onReloading`, `onError`, `defaultMessage`, `loadingMessage`, `reloadingMessage`, `errorMessage`, and `delay`. Per-component overrides take precedence over context options.
+
+Set `delay` (in milliseconds) to avoid flicker for loads that usually finish quickly. Until loading has lasted that long, an initial load renders nothing instead of `onLoading`, and a reload keeps showing the previous content without marking it as reloading (`onReloading` receives `reloading: false`, and the render function's state has `isLoading: false`):
+
+```tsx
+<LazyContext.Provider value={{ delay: 200, onLoading: () => <Spinner /> }}>
+    {children}
+</LazyContext.Provider>
+```
 
 ## Hooks
 
@@ -124,6 +132,8 @@ Available options are `onLoading`, `onReloading`, `onError`, `defaultMessage`, `
 - `useLazyAsPromise` and `useLazyAsObservable` adapt a lazy event to a promise or RxJS subject.
 - `isLoading`, `isFulfilled`, and `isRejected` are type guards for lazy events.
 
+The mapping hooks are memoized wrappers around plain functions that can be used outside React: `lazyMap`, `lazyChain`, `lazyFlatten`, and `lazyCombine`.
+
 The package also exports `Asyncified`, `asyncified`, `Observing`, `observing`, `Lazy`, and `lazified` for component-based and higher-order-component integrations.
 
 ## License

package/dist/async.d.ts

@@ -3,6 +3,7 @@ import { ValueOrFactory } from "value-or-factory";
 import { LazyHOCOptions } from "./hoc.js";
 import { LazyState } from "./state.js";
 import { LazyEvent, LazyOverrides } from "./types.js";
+export type Retry = (suppressReload?: boolean | undefined) => void;
 /**
  * Options for the async hook.
  * @typeParam D The data type.
@@ -33,7 +34,6 @@ export type AsyncLazyState<D> = LazyState<D> & {
 export interface AsyncifiedOptions<D, P> extends AsyncLazyOptions<D>, LazyHOCOptions<AsyncLazyState<D>, P> {
 }
 export declare function asyncified<I extends {}, D extends {}, P extends {}>(factory: (props: I) => AsyncifiedOptions<D, P>): (component: import("react").ComponentType<D & P>) => (props: I) => import("react").JSX.Element;
-export type Retry = (suppressReload?: boolean | undefined) => void;
 export interface AsyncifiedProps<D> extends AsyncLazyOptions<D> {
     readonly children: ValueOrFactory<ReactNode, [D, AsyncLazyState<D>]>;
     /**

package/dist/async.js.map

@@ -1 +1 @@
-{"version":3,"file":"async.js","sourceRoot":"","sources":["../src/async.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../src/async.tsx"],"names":[],"mappings":"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"}

package/dist/components.js

@@ -1,22 +1,25 @@
 import { useContext } from "react";
 import { LazyContext } from "./hooks.js";
+import { useDelayedFlag } from "./internal.js";
 import { useLazyState } from "./state.js";
 export function Lazy(props) {
     const context = useContext(LazyContext);
     const options = { ...context, ...props.overrides };
-    const state = useLazyState(props.event);
+    const actual = useLazyState(props.event);
+    const showLoading = useDelayedFlag(actual.isLoading, options.delay);
+    const state = showLoading ? actual : settle(actual);
     if (state.isLoading && !state.isSettled) {
-        if (options.onLoading === undefined) {
+        if (options.onLoading === undefined || !showLoading) {
             return null;
         }
         return options.onLoading({
-            message: options.loadingMessage ?? options.defaultMessage
+            message: options.loadingMessage
         });
     }
     const onReloading = options.onReloading ?? ((props) => props.children);
     return onReloading({
         reloading: state.isLoading,
-        message: options.reloadingMessage ?? options.defaultMessage,
+        message: options.reloadingMessage ?? options.loadingMessage,
         children: (() => {
             if (state.isRejected) {
                 if (options.onError === undefined) {
@@ -24,7 +27,6 @@ export function Lazy(props) {
                 }
                 return options.onError({
                     reason: state.reason,
-                    message: options.errorMessage ?? options.defaultMessage,
                 });
             }
             else {
@@ -33,4 +35,31 @@ export function Lazy(props) {
         })()
     });
 }
+/**
+ * Presents a reloading state as the settled state it is reloading from, for use while the loading delay has not yet elapsed.
+ */
+function settle(state) {
+    if (!state.isReloading) {
+        return state;
+    }
+    if (state.isFulfilled) {
+        return {
+            isLoading: false,
+            isReloading: false,
+            isSettled: true,
+            isFulfilled: true,
+            isRejected: false,
+            value: state.value,
+        };
+    }
+    return {
+        isLoading: false,
+        isReloading: false,
+        isSettled: true,
+        isFulfilled: false,
+        isRejected: true,
+        reason: state.reason,
+        retry: state.retry,
+    };
+}
 //# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -1 +1 @@
-{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgC,UAAU,EAAE,MAAM,OAAO,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAa,YAAY,EAAE,MAAM,YAAY,CAAA;AAWpD,MAAM,UAAU,IAAI,CAAI,KAAmB;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAA;IAClD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACvC,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,IAAI,CAAA;QACf,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,CAAC;YACrB,OAAO,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc;SAC5D,CAAC,CAAA;IACN,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,KAAwB,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACzF,OAAO,WAAW,CAAC;QACf,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,cAAc;QAC3D,QAAQ,EAAE,CAAC,GAAG,EAAE;YACZ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACnB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;oBAChC,MAAM,KAAK,CAAC,MAAM,CAAA;gBACtB,CAAC;gBACD,OAAO,OAAO,CAAC,OAAO,CAAC;oBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,OAAO,EAAE,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,cAAc;iBAC1D,CAAC,CAAA;YACN,CAAC;iBACI,CAAC;gBACF,OAAO,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAA;YACrG,CAAC;QACL,CAAC,CAAC,EAAE;KACP,CAAC,CAAA;AACN,CAAC"}
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgC,UAAU,EAAE,MAAM,OAAO,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAa,YAAY,EAAE,MAAM,YAAY,CAAA;AAWpD,MAAM,UAAU,IAAI,CAAI,KAAmB;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAA;IAClD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IACnE,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACnD,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;YAClD,OAAO,IAAI,CAAA;QACf,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,CAAC;YACrB,OAAO,EAAE,OAAO,CAAC,cAAc;SAClC,CAAC,CAAA;IACN,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,KAAwB,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACzF,OAAO,WAAW,CAAC;QACf,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,cAAc;QAC3D,QAAQ,EAAE,CAAC,GAAG,EAAE;YACZ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACnB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;oBAChC,MAAM,KAAK,CAAC,MAAM,CAAA;gBACtB,CAAC;gBACD,OAAO,OAAO,CAAC,OAAO,CAAC;oBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;iBACvB,CAAC,CAAA;YACN,CAAC;iBACI,CAAC;gBACF,OAAO,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAA;YACrG,CAAC;QACL,CAAC,CAAC,EAAE;KACP,CAAC,CAAA;AACN,CAAC;AAED;;GAEG;AACH,SAAS,MAAM,CAAI,KAAmB;IAClC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACpB,OAAO;YACH,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;SACrB,CAAA;IACL,CAAC;IACD,OAAO;QACH,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;KACrB,CAAA;AACL,CAAC"}

package/dist/hooks.d.ts

@@ -1,20 +1,16 @@
-import { DependencyList } from "react";
 import { Observable, Subject } from "rxjs";
-import { ExtractLazy, LazyEvent, LazyFulfilled, LazyLoading, LazyRejected } from "./types.js";
+import { Retry } from "./async.js";
+import { ExtractLazy, LazyEvent } from "./types.js";
 export declare const LazyContext: import("react").Context<Partial<import("./types.js").LazyOptions>>;
-export declare function isLoading<T>(event: LazyEvent<T>): event is LazyLoading;
-export declare function isFulfilled<T>(event: LazyEvent<T>): event is LazyFulfilled<T>;
-export declare function isRejected<T>(event: LazyEvent<T>): event is LazyRejected;
 export declare function useLazyFlatten<O>(event: LazyEvent<LazyEvent<O>>): LazyEvent<O>;
 export declare function useLazyChain<I, O>(event: LazyEvent<I>, map: (value: I) => LazyEvent<O>): LazyEvent<O>;
-export declare function useLazyMap<I, O>(event: LazyEvent<I>, map: (value: I) => O): LazyLoading | LazyRejected | {
-    status: "fulfilled";
-    value: O;
-};
+export declare function useLazyMap<I, O>(event: LazyEvent<I>, map: (value: I) => O): LazyEvent<O>;
+export declare function useLazyRecover<T>(event: LazyEvent<T>, map: (reason: unknown) => LazyEvent<T>): LazyEvent<T>;
+export declare function useLazyOrElse<T, D>(event: LazyEvent<T>, orElse: () => D): D | T;
+export declare function useLazyFold<T, O>(event: LazyEvent<T>, loading: () => O, fulfilled: (value: T) => O, rejected: (reason: unknown, retry?: Retry | undefined) => O): O;
 export declare function useObservableAsPromise<T>(observable: Observable<T>): Promise<T>;
 export declare function useLazyAsPromise<T>(event: LazyEvent<T>): Promise<T>;
 export declare function useLazyAsObservable<T>(event: LazyEvent<T>): Subject<T>;
-export declare function useShallowMemo<T, D extends DependencyList>(factory: () => T, deps: D): T;
 export declare function useLazyCombine<T extends Record<string, LazyEvent<unknown>>>(lazies: T): LazyEvent<{
     [K in keyof T]: ExtractLazy<T[K]>;
 }>;

package/dist/hooks.js

@@ -2,60 +2,38 @@ import pDefer from "p-defer";
 import { createContext, useEffect, useMemo, useRef, useState } from "react";
 import { Subject } from "rxjs";
 import shallowEqual from "shallowequal";
+import { lazyChain, lazyCombine, lazyFlatten, lazyFold, lazyMap, lazyOrElse, lazyRecover } from "./operators.js";
 export const LazyContext = createContext({});
-export function isLoading(event) {
-    if (event.status === "loading") {
-        return true;
-    }
-    else {
-        return false;
-    }
-}
-export function isFulfilled(event) {
-    if (event.status === "fulfilled") {
-        return true;
-    }
-    else {
+function eachEqual(a, b) {
+    if (a.length !== b.length) {
         return false;
     }
+    return a.every((value, key) => shallowEqual(value, b[key]));
 }
-export function isRejected(event) {
-    if (event.status === "rejected") {
-        return true;
-    }
-    else {
-        return false;
+function useShallowMemo(factory, deps) {
+    const ref = useRef(deps);
+    if (!eachEqual(ref.current, deps)) {
+        ref.current = deps;
     }
+    return useMemo(factory, [ref.current]);
 }
 export function useLazyFlatten(event) {
-    return useLazyChain(event, event => event);
+    return useMemo(() => lazyFlatten(event), [event]);
 }
 export function useLazyChain(event, map) {
-    return useMemo(() => {
-        if (event.status === "fulfilled") {
-            return map(event.value);
-        }
-        else {
-            return event;
-        }
-    }, [
-        event
-    ]);
+    return useMemo(() => lazyChain(event, map), [event]);
 }
 export function useLazyMap(event, map) {
-    return useMemo(() => {
-        if (event.status === "fulfilled") {
-            return {
-                status: "fulfilled",
-                value: map(event.value)
-            };
-        }
-        else {
-            return event;
-        }
-    }, [
-        event
-    ]);
+    return useMemo(() => lazyMap(event, map), [event]);
+}
+export function useLazyRecover(event, map) {
+    return useMemo(() => lazyRecover(event, map), [event]);
+}
+export function useLazyOrElse(event, orElse) {
+    return useMemo(() => lazyOrElse(event, orElse), [event]);
+}
+export function useLazyFold(event, loading, fulfilled, rejected) {
+    return useMemo(() => lazyFold(event, loading, fulfilled, rejected), [event]);
 }
 export function useObservableAsPromise(observable) {
     const [promise, setPromise] = useState(() => new Promise(() => void 0));
@@ -107,49 +85,7 @@ export function useLazyAsObservable(event) {
     ]);
     return subject;
 }
-function eachEqual(a, b) {
-    if (a.length !== b.length) {
-        return false;
-    }
-    return a.every((value, key) => shallowEqual(value, b[key]));
-}
-export function useShallowMemo(factory, deps) {
-    const ref = useRef(deps);
-    if (!eachEqual(ref.current, deps)) {
-        ref.current = deps;
-    }
-    return useMemo(factory, [ref.current]);
-}
 export function useLazyCombine(lazies) {
-    return useShallowMemo(() => {
-        const entries = Object.entries(lazies);
-        if (entries.map(entry => entry[1]).some(isLoading)) {
-            return {
-                status: "loading",
-            };
-        }
-        else {
-            const failed = entries.map(entry => entry[1]).filter(isRejected).at(0);
-            if (failed !== undefined) {
-                return {
-                    status: "rejected",
-                    reason: failed
-                };
-            }
-            else {
-                return {
-                    status: "fulfilled",
-                    value: Object.fromEntries(entries.map(([key, value]) => {
-                        return [
-                            key,
-                            value.status === "fulfilled" ? value.value : undefined,
-                        ];
-                    }))
-                };
-            }
-        }
-    }, [
-        lazies
-    ]);
+    return useShallowMemo(() => lazyCombine(lazies), [lazies]);
 }
 //# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,5 +3,6 @@ export * from "./components.js";
 export * from "./hoc.js";
 export * from "./hooks.js";
 export * from "./observable.js";
+export * from "./operators.js";
 export * from "./state.js";
 export * from "./types.js";

package/dist/index.js

@@ -3,6 +3,7 @@ export * from "./components.js";
 export * from "./hoc.js";
 export * from "./hooks.js";
 export * from "./observable.js";
+export * from "./operators.js";
 export * from "./state.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/internal.d.ts

@@ -2,3 +2,8 @@ export declare function useIsFirstMount(): boolean;
 export declare function usePrevious<T>(value: {
     readonly current: T;
 } | undefined): T | undefined;
+/**
+ * Returns true once `active` has stayed true for at least `delay` milliseconds.
+ * Returns false whenever `active` is false, and restarts the timer each time `active` becomes true.
+ */
+export declare function useDelayedFlag(active: boolean, delay: number | undefined): boolean;

package/dist/internal.js

@@ -1,4 +1,4 @@
-import { useRef } from "react";
+import { useEffect, useRef, useState } from "react";
 export function useIsFirstMount() {
     const isFirst = useRef(true);
     if (isFirst.current) {
@@ -17,4 +17,27 @@ export function usePrevious(value) {
     }
     return previous.current;
 }
+/**
+ * Returns true once `active` has stayed true for at least `delay` milliseconds.
+ * Returns false whenever `active` is false, and restarts the timer each time `active` becomes true.
+ */
+export function useDelayedFlag(active, delay) {
+    const enabled = delay !== undefined && delay > 0;
+    const [elapsed, setElapsed] = useState(false);
+    useEffect(() => {
+        if (!active || !enabled) {
+            return;
+        }
+        const timeout = setTimeout(() => setElapsed(true), delay);
+        return () => {
+            clearTimeout(timeout);
+            setElapsed(false);
+        };
+    }, [
+        active,
+        enabled,
+        delay,
+    ]);
+    return active && (!enabled || elapsed);
+}
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE9B,MAAM,UAAU,eAAe;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,OAAO,GAAG,KAAK,CAAA;QACvB,OAAO,IAAI,CAAA;IACf,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAA0C;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACvC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QACpC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEnD,MAAM,UAAU,eAAe;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,OAAO,GAAG,KAAK,CAAA;QACvB,OAAO,IAAI,CAAA;IACf,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAA0C;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACvC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QACpC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAA;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe,EAAE,KAAyB;IACrE,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAA;IAChD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACtB,OAAM;QACV,CAAC;QACD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAA;QACzD,OAAO,GAAG,EAAE;YACR,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,UAAU,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC,CAAA;IACL,CAAC,EAAE;QACC,MAAM;QACN,OAAO;QACP,KAAK;KACR,CAAC,CAAA;IACF,OAAO,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAA;AAC1C,CAAC"}

package/dist/lazy.d.ts

@@ -0,0 +1,16 @@
+import { Retry } from "./async.js";
+import { ExtractLazy, LazyEvent, LazyFulfilled, LazyLoading, LazyRejected, LazySettled } from "./types.js";
+export declare function isLoading<T>(event: LazyEvent<T>): event is LazyLoading;
+export declare function isSettled<T>(event: LazyEvent<T>): event is LazySettled<T>;
+export declare function isFulfilled<T>(event: LazyEvent<T>): event is LazyFulfilled<T>;
+export declare function isRejected<T>(event: LazyEvent<T>): event is LazyRejected;
+export declare function lazyFold<T, O>(event: LazyEvent<T>, loading: () => O, fulfilled: (value: T) => O, rejected: (reason: unknown, retry?: Retry | undefined) => O): O;
+export declare function lazyOrElse<T, D>(event: LazyEvent<T>, orElse: () => D): D | T;
+export declare function lazyOrUndefined<T>(event: LazyEvent<T>): T | undefined;
+export declare function lazyFlatten<O>(event: LazyEvent<LazyEvent<O>>): LazyEvent<O>;
+export declare function lazyChain<I, O>(event: LazyEvent<I>, map: (value: I) => LazyEvent<O>): LazyEvent<O>;
+export declare function lazyMap<I, O>(event: LazyEvent<I>, map: (value: I) => O): LazyEvent<O>;
+export declare function lazyRecover<T>(event: LazyEvent<T>, map: (reason: unknown) => LazyEvent<T>): LazyEvent<T>;
+export declare function lazyCombine<T extends Record<string, LazyEvent<unknown>>>(lazies: T): LazyEvent<{
+    [K in keyof T]: ExtractLazy<T[K]>;
+}>;

package/dist/lazy.js

@@ -0,0 +1,92 @@
+export function isLoading(event) {
+    return event.status === "loading";
+}
+export function isSettled(event) {
+    return event.status === "fulfilled" || event.status === "rejected";
+}
+export function isFulfilled(event) {
+    return event.status === "fulfilled";
+}
+export function isRejected(event) {
+    return event.status === "rejected";
+}
+export function lazyFold(event, loading, fulfilled, rejected) {
+    if (event.status === "loading") {
+        return loading();
+    }
+    else if (event.status === "fulfilled") {
+        return fulfilled(event.value);
+    }
+    else {
+        return rejected(event.reason, event.retry);
+    }
+}
+export function lazyOrElse(event, orElse) {
+    if (isFulfilled(event)) {
+        return event.value;
+    }
+    return orElse();
+}
+export function lazyOrUndefined(event) {
+    return lazyOrElse(event, () => undefined);
+}
+export function lazyFlatten(event) {
+    return lazyChain(event, event => event);
+}
+export function lazyChain(event, map) {
+    if (event.status === "fulfilled") {
+        return map(event.value);
+    }
+    else {
+        return event;
+    }
+}
+export function lazyMap(event, map) {
+    if (event.status === "fulfilled") {
+        return {
+            status: "fulfilled",
+            value: map(event.value)
+        };
+    }
+    else {
+        return event;
+    }
+}
+export function lazyRecover(event, map) {
+    if (event.status === "rejected") {
+        return map(event.reason);
+    }
+    else {
+        return event;
+    }
+}
+export function lazyCombine(lazies) {
+    const entries = Object.entries(lazies);
+    if (entries.map(entry => entry[1]).some(isLoading)) {
+        return {
+            status: "loading",
+        };
+    }
+    const failed = entries.map(entry => entry[1]).filter(isRejected);
+    if (failed.length > 0) {
+        return {
+            status: "rejected",
+            reason: failed.map(failed => failed.reason),
+            retry: (suppressReload) => {
+                failed.forEach(failed => {
+                    failed.retry?.(suppressReload);
+                });
+            }
+        };
+    }
+    return {
+        status: "fulfilled",
+        value: Object.fromEntries(entries.map(([key, value]) => {
+            return [
+                key,
+                value.status === "fulfilled" ? value.value : undefined,
+            ];
+        }))
+    };
+}
+//# sourceMappingURL=lazy.js.map

package/dist/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"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"}

package/dist/operators.d.ts

@@ -0,0 +1,16 @@
+import { Retry } from "./async.js";
+import { ExtractLazy, LazyEvent, LazyFulfilled, LazyLoading, LazyRejected, LazySettled } from "./types.js";
+export declare function isLoading<T>(event: LazyEvent<T>): event is LazyLoading;
+export declare function isSettled<T>(event: LazyEvent<T>): event is LazySettled<T>;
+export declare function isFulfilled<T>(event: LazyEvent<T>): event is LazyFulfilled<T>;
+export declare function isRejected<T>(event: LazyEvent<T>): event is LazyRejected;
+export declare function lazyFold<T, O>(event: LazyEvent<T>, loading: () => O, fulfilled: (value: T) => O, rejected: (reason: unknown, retry?: Retry | undefined) => O): O;
+export declare function lazyOrElse<T, D>(event: LazyEvent<T>, orElse: () => D): D | T;
+export declare function lazyOrUndefined<T>(event: LazyEvent<T>): T | undefined;
+export declare function lazyFlatten<O>(event: LazyEvent<LazyEvent<O>>): LazyEvent<O>;
+export declare function lazyChain<I, O>(event: LazyEvent<I>, map: (value: I) => LazyEvent<O>): LazyEvent<O>;
+export declare function lazyMap<I, O>(event: LazyEvent<I>, map: (value: I) => O): LazyEvent<O>;
+export declare function lazyRecover<T>(event: LazyEvent<T>, map: (reason: unknown) => LazyEvent<T>): LazyEvent<T>;
+export declare function lazyCombine<T extends Record<string, LazyEvent<unknown>>>(lazies: T): LazyEvent<{
+    [K in keyof T]: ExtractLazy<T[K]>;
+}>;

package/dist/operators.js

@@ -0,0 +1,92 @@
+export function isLoading(event) {
+    return event.status === "loading";
+}
+export function isSettled(event) {
+    return event.status === "fulfilled" || event.status === "rejected";
+}
+export function isFulfilled(event) {
+    return event.status === "fulfilled";
+}
+export function isRejected(event) {
+    return event.status === "rejected";
+}
+export function lazyFold(event, loading, fulfilled, rejected) {
+    if (event.status === "loading") {
+        return loading();
+    }
+    else if (event.status === "fulfilled") {
+        return fulfilled(event.value);
+    }
+    else {
+        return rejected(event.reason, event.retry);
+    }
+}
+export function lazyOrElse(event, orElse) {
+    if (isFulfilled(event)) {
+        return event.value;
+    }
+    return orElse();
+}
+export function lazyOrUndefined(event) {
+    return lazyOrElse(event, () => undefined);
+}
+export function lazyFlatten(event) {
+    return lazyChain(event, event => event);
+}
+export function lazyChain(event, map) {
+    if (event.status === "fulfilled") {
+        return map(event.value);
+    }
+    else {
+        return event;
+    }
+}
+export function lazyMap(event, map) {
+    if (event.status === "fulfilled") {
+        return {
+            status: "fulfilled",
+            value: map(event.value)
+        };
+    }
+    else {
+        return event;
+    }
+}
+export function lazyRecover(event, map) {
+    if (event.status === "rejected") {
+        return map(event.reason);
+    }
+    else {
+        return event;
+    }
+}
+export function lazyCombine(lazies) {
+    const entries = Object.entries(lazies);
+    if (entries.map(entry => entry[1]).some(isLoading)) {
+        return {
+            status: "loading",
+        };
+    }
+    const failed = entries.map(entry => entry[1]).filter(isRejected);
+    if (failed.length > 0) {
+        return {
+            status: "rejected",
+            reason: failed.map(failed => failed.reason),
+            retry: (suppressReload) => {
+                failed.forEach(failed => {
+                    failed.retry?.(suppressReload);
+                });
+            }
+        };
+    }
+    return {
+        status: "fulfilled",
+        value: Object.fromEntries(entries.map(([key, value]) => {
+            return [
+                key,
+                value.status === "fulfilled" ? value.value : undefined,
+            ];
+        }))
+    };
+}
+//# sourceMappingURL=operators.js.map

package/dist/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../src/operators.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,SAAS,CAAI,KAAmB;IAC5C,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAA;AACrC,CAAC;AACD,MAAM,UAAU,SAAS,CAAI,KAAmB;IAC5C,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,CAAA;AACtE,CAAC;AACD,MAAM,UAAU,WAAW,CAAI,KAAmB;IAC9C,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW,CAAA;AACvC,CAAC;AACD,MAAM,UAAU,UAAU,CAAI,KAAmB;IAC7C,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAO,KAAmB,EAAE,OAAgB,EAAE,SAA0B,EAAE,QAA2D;IACzJ,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,OAAO,EAAE,CAAA;IACpB,CAAC;SACI,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;SACI,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC9C,CAAC;AACL,CAAC;AACD,MAAM,UAAU,UAAU,CAAO,KAAmB,EAAE,MAAe;IACjE,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,CAAA;IACtB,CAAC;IACD,OAAO,MAAM,EAAE,CAAA;AACnB,CAAC;AACD,MAAM,UAAU,eAAe,CAAI,KAAmB;IAClD,OAAO,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AAC7C,CAAC;AACD,MAAM,UAAU,WAAW,CAAI,KAA8B;IACzD,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;AAC3C,CAAC;AACD,MAAM,UAAU,SAAS,CAAO,KAAmB,EAAE,GAA+B;IAChF,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;SACI,CAAC;QACF,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC;AACD,MAAM,UAAU,OAAO,CAAO,KAAmB,EAAE,GAAoB;IACnE,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO;YACH,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;SAC1B,CAAA;IACL,CAAC;SACI,CAAC;QACF,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC;AACD,MAAM,UAAU,WAAW,CAAI,KAAmB,EAAE,GAAsC;IACtF,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC;SACI,CAAC;QACF,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC;AACD,MAAM,UAAU,WAAW,CAA+C,MAAS;IAC/E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,OAAO;YACH,MAAM,EAAE,SAAS;SACpB,CAAA;IACL,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAChE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO;YACH,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;YAC3C,KAAK,EAAE,CAAC,cAAoC,EAAE,EAAE;gBAC5C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;oBACpB,MAAM,CAAC,KAAK,EAAE,CAAC,cAAc,CAAC,CAAA;gBAClC,CAAC,CAAC,CAAA;YACN,CAAC;SACJ,CAAA;IACL,CAAC;IACD,OAAO;QACH,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,MAAM,CAAC,WAAW,CACrB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACzB,OAAO;gBACH,GAAG;gBACH,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aAChD,CAAA;QACd,CAAC,CAAC,CACoC;KAC7C,CAAA;AACL,CAAC"}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from "react";
+import { Retry } from "./async.js";
 export type LazyLoading = {
     readonly status: "loading";
 };
@@ -9,19 +10,18 @@ export type LazyFulfilled<D> = {
 export type LazyRejected = {
     readonly status: "rejected";
     readonly reason: unknown;
-    readonly retry?: (() => () => void) | undefined;
+    readonly retry?: Retry | undefined;
 };
 export type LazySettled<D> = LazyFulfilled<D> | LazyRejected;
 export type LazyEvent<D> = LazySettled<D> | LazyLoading;
 export type OnLoading = (props: LoadingProps) => ReactNode;
 export type OnReloading = (props: ReloadingProps) => ReactNode;
 export type OnError = (props: ErrorProps) => ReactNode;
-type LazyMeta = string;
 export interface LoadingProps {
     /**
      * The message to display.
      */
-    readonly message?: LazyMeta | undefined;
+    readonly message?: string | undefined;
 }
 export interface ReloadingProps {
     /**
@@ -31,7 +31,7 @@ export interface ReloadingProps {
     /**
      * The message to display.
      */
-    readonly message?: LazyMeta | undefined;
+    readonly message?: string | undefined;
     /**
      * The children.
      */
@@ -42,23 +42,22 @@ export interface ErrorProps {
      * The error.
      */
     readonly reason: unknown;
-    /**
-     * The message to display.
-     */
-    readonly message?: LazyMeta | undefined;
 }
 export interface LazyOptions {
     readonly onLoading?: OnLoading | undefined;
     readonly onReloading?: OnReloading | undefined;
     readonly onError?: OnError | undefined;
-    readonly defaultMessage?: LazyMeta | undefined;
-    readonly loadingMessage?: LazyMeta | undefined;
-    readonly reloadingMessage?: LazyMeta | undefined;
-    readonly errorMessage?: LazyMeta | undefined;
+    readonly loadingMessage?: string | undefined;
+    readonly reloadingMessage?: string | undefined;
+    /**
+     * How long (in milliseconds) loading must last before it is shown.
+     * During this time an initial load renders nothing instead of `onLoading`, and a reload keeps showing the previous content as not reloading.
+     * Use this to avoid flicker for loads that usually finish within a few milliseconds.
+     */
+    readonly delay?: number | undefined;
 }
 /**
  * Overrides for lazy options.
  */
 export type LazyOverrides = Partial<LazyOptions>;
 export type ExtractLazy<T> = T extends LazyFulfilled<infer D> ? D : never;
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ispb/react-lazy",
-    "version": "0.0.8",
+    "version": "0.0.10",
     "license": "MIT",
     "type": "module",
     "sideEffects": false,
@@ -31,4 +31,4 @@
         "react": "^19.2.8",
         "typescript": "^7.0.2"
     }
-}
+}