@proofhound/web-ui 0.1.6

package/dist/hooks/use-delayed-loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-delayed-loading.d.ts","sourceRoot":"","sources":["../../src/hooks/use-delayed-loading.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,+BAAgC,SAAQ,QAAQ,CAAC,wBAAwB,CAAC;IACzF,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/D,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,SAAS,IAAI,OAAO,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,wBAAwB,CAqE1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAsBnG"}

package/dist/hooks/use-delayed-loading.js

@@ -0,0 +1,95 @@
+'use client';
+import { useEffect, useRef, useState } from 'react';
+export const DEFAULT_LOADING_DELAY_MS = 300;
+export const DEFAULT_LOADING_MIN_DURATION_MS = 300;
+export function createDelayedLoadingController(options) {
+    const delay = Math.max(0, options.delay);
+    const minDuration = Math.max(0, options.minDuration);
+    const setTimeoutFn = options.setTimeoutImpl ?? ((cb, ms) => setTimeout(cb, ms));
+    const clearTimeoutFn = options.clearTimeoutImpl ?? ((handle) => clearTimeout(handle));
+    const now = options.now ?? (() => Date.now());
+    let visible = false;
+    let shownAt = null;
+    let showHandle = null;
+    let hideHandle = null;
+    const clearShow = () => {
+        if (showHandle !== null) {
+            clearTimeoutFn(showHandle);
+            showHandle = null;
+        }
+    };
+    const clearHide = () => {
+        if (hideHandle !== null) {
+            clearTimeoutFn(hideHandle);
+            hideHandle = null;
+        }
+    };
+    const setVisible = (next) => {
+        if (visible === next)
+            return;
+        visible = next;
+        options.onVisibleChange(next);
+    };
+    return {
+        setLoading(loading) {
+            if (loading) {
+                clearHide();
+                if (visible || showHandle !== null)
+                    return;
+                showHandle = setTimeoutFn(() => {
+                    showHandle = null;
+                    shownAt = now();
+                    setVisible(true);
+                }, delay);
+                return;
+            }
+            clearShow();
+            if (!visible || hideHandle !== null)
+                return;
+            const elapsed = shownAt === null ? minDuration : now() - shownAt;
+            const remaining = minDuration - elapsed;
+            if (remaining <= 0) {
+                shownAt = null;
+                setVisible(false);
+                return;
+            }
+            hideHandle = setTimeoutFn(() => {
+                hideHandle = null;
+                shownAt = null;
+                setVisible(false);
+            }, remaining);
+        },
+        isVisible() {
+            return visible;
+        },
+        dispose() {
+            clearShow();
+            clearHide();
+        },
+    };
+}
+/**
+ * Returns a debounced loading flag that only turns true once `loading` has
+ * persisted past `delay`, then stays true for at least `minDuration`. Fast
+ * responses never flip it on, eliminating the loading-state flash.
+ */
+export function useDelayedLoading(loading, options = {}) {
+    const { delay = DEFAULT_LOADING_DELAY_MS, minDuration = DEFAULT_LOADING_MIN_DURATION_MS } = options;
+    const [visible, setVisible] = useState(false);
+    const controllerRef = useRef(null);
+    if (controllerRef.current === null) {
+        controllerRef.current = createDelayedLoadingController({
+            delay,
+            minDuration,
+            onVisibleChange: setVisible,
+        });
+    }
+    useEffect(() => {
+        controllerRef.current?.setLoading(loading);
+    }, [loading]);
+    useEffect(() => {
+        return () => controllerRef.current?.dispose();
+    }, []);
+    return visible;
+}
+//# sourceMappingURL=use-delayed-loading.js.map

package/dist/hooks/use-delayed-loading.js.map

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