@koine/react 2.0.0-beta.9 → 2.0.0-beta.91

package/hooks/useMeasure.mjs

@@ -1,174 +0,0 @@
-import { useEffect, useMemo, useRef, useState } from "react";
-import debounce from "@koine/utils/debounce";
-import noop from "@koine/utils/noop";
-import listenResizeDebounced from "@koine/dom/listenResizeDebounced";
-import listenScrollDebounced from "@koine/dom/listenScrollDebounced";
-import off from "@koine/dom/off";
-import on from "@koine/dom/on";
-let observer;
-// Returns a list of scroll offsets
-function findScrollContainers(element) {
-    const result = [];
-    if (!element || element === document.body) return result;
-    const { overflow, overflowX, overflowY } = window.getComputedStyle(element);
-    if ([
-        overflow,
-        overflowX,
-        overflowY
-    ].some((prop)=>prop === "auto" || prop === "scroll")) result.push(element);
-    return [
-        ...result,
-        ...findScrollContainers(element.parentElement)
-    ];
-}
-const keys = [
-    "x",
-    "y",
-    "top",
-    "bottom",
-    "left",
-    "right",
-    "width",
-    "height"
-];
-const areBoundsEqual = (a, b)=>keys.every((key)=>a[key] === b[key]);
-/**
- * Use measure hook
- *
- * @borrows [pmndrs/react-use-measure](https://github.com/pmndrs/react-use-measure)
- */ export function useMeasure(options) {
-    const { scroll = false } = options || {};
-    const [bounds, setBounds] = useState({
-        left: 0,
-        top: 0,
-        width: 0,
-        height: 0,
-        bottom: 0,
-        right: 0,
-        x: 0,
-        y: 0
-    });
-    // keep all state in a ref
-    const state = useRef([
-        // element
-        null,
-        // scrollContainers
-        null,
-        // resizeObserver
-        null,
-        // lastBounds
-        bounds
-    ]);
-    // make sure to update state only as long as the component is truly mounted
-    const mounted = useRef(false);
-    useEffect(()=>{
-        mounted.current = true;
-        return ()=>void (mounted.current = false);
-    }, []);
-    // memoize handlers, so event-listeners know when they should update
-    const [forceRefresh /* resizeChange */ , , scrollChange] = useMemo(()=>{
-        const callback = (..._args)=>{
-            const [element, , , lastBounds] = state.current;
-            if (!element) return;
-            const size = element.getBoundingClientRect();
-            // if (element instanceof HTMLElement && offsetSize) {
-            //   size.height = element.offsetHeight;
-            //   size.width = element.offsetWidth;
-            // }
-            Object.freeze(size);
-            if (mounted.current && !areBoundsEqual(lastBounds, size)) {
-                state.current[3] = size;
-                setBounds(size);
-            }
-        };
-        const debouncedCallback = debounce(callback);
-        return [
-            callback,
-            debouncedCallback,
-            debouncedCallback
-        ];
-    }, [
-        setBounds /* , offsetSize */ 
-    ]);
-    // cleanup current scroll-listeners / observers
-    function removeListeners() {
-        const [, scrollContainers, resizeObserver] = state.current;
-        if (scrollContainers) {
-            scrollContainers.forEach((element)=>off(element, "scroll", scrollChange));
-            state.current[1] = null;
-        }
-        if (resizeObserver) {
-            resizeObserver.disconnect();
-            state.current[2] = null;
-        }
-    }
-    // add scroll-listeners / observers
-    function addListeners() {
-        const [element, scrollContainers] = state.current;
-        if (!element) return;
-        if (!observer && ResizeObserver) {
-            observer = new ResizeObserver(scrollChange);
-            state.current[2] = observer;
-            observer.observe(element);
-            if (scroll && scrollContainers) {
-                scrollContainers.forEach((scrollContainer)=>on(scrollContainer, "scroll", scrollChange, {
-                        capture: true,
-                        passive: true
-                    }));
-            }
-        }
-    }
-    // the ref we expose to the user
-    const ref = (node)=>{
-        if (!node || node === state.current[0]) return;
-        removeListeners();
-        state.current[0] = node;
-        state.current[1] = findScrollContainers(node);
-        addListeners();
-    };
-    // add general event listeners
-    // useOnWindowScroll(forceRefresh, Boolean(scroll));
-    // useOnWindowResize(() => {
-    //   debugger;
-    //   forceRefresh();
-    // });
-    useEffect(()=>{
-        if (scroll) {
-            const listener = listenScrollDebounced(0, forceRefresh, 100);
-            return listener;
-        }
-        return noop;
-    }, [
-        scroll,
-        forceRefresh
-    ]);
-    useEffect(()=>{
-        // const listener = listenResizeDebounced(onWindowResize);
-        // return listener;
-        const listener = listenResizeDebounced(0, forceRefresh, 100);
-        return listener;
-    }, [
-        forceRefresh
-    ]);
-    // respond to changes that are relevant for the listeners
-    useEffect(()=>{
-        removeListeners();
-        addListeners();
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [
-        scroll /* , scrollChange, resizeChange */ 
-    ]);
-    useEffect(()=>{
-        // operate on mount, @kuus on the original version there is no call on mount?
-        forceRefresh();
-        // remove all listeners when the components unmounts
-        return removeListeners;
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
-    return [
-        ref,
-        bounds,
-        forceRefresh
-    ];
-}
-export default useMeasure;

package/hooks/useMountedState.d.ts

@@ -1,5 +0,0 @@
-/**
- * @borrows [streamich/react-use](https://github.com/streamich/react-use/blob/master/src/useMountedState.ts)
- */
-export declare function useMountedState(): () => boolean;
-export default useMountedState;

package/hooks/useMountedState.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    useMountedState: function() {
-        return useMountedState;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _react = require("react");
-function useMountedState() {
-    const mountedRef = (0, _react.useRef)(false);
-    const get = (0, _react.useCallback)(()=>mountedRef.current, []);
-    (0, _react.useEffect)(()=>{
-        mountedRef.current = true;
-        return ()=>{
-            mountedRef.current = false;
-        };
-    }, []);
-    return get;
-}
-const _default = useMountedState;

package/hooks/useMountedState.mjs

@@ -1,15 +0,0 @@
-import { useCallback, useEffect, useRef } from "react";
-/**
- * @borrows [streamich/react-use](https://github.com/streamich/react-use/blob/master/src/useMountedState.ts)
- */ export function useMountedState() {
-    const mountedRef = useRef(false);
-    const get = useCallback(()=>mountedRef.current, []);
-    useEffect(()=>{
-        mountedRef.current = true;
-        return ()=>{
-            mountedRef.current = false;
-        };
-    }, []);
-    return get;
-}
-export default useMountedState;

package/hooks/useNavigateAway.d.ts

@@ -1,32 +0,0 @@
-/**
- * @return A custom error message (most browser will ignore it), or just a
- * boolean to signal whether we want to prompt the user
- *
- * We might instead return an array with the above as first element and two
- * callbacks, but the callback technique is too cumbersome and unreliable
- * probably:
- * 2) A callback on confirmed leaving
- * 3) A callback on cancel, user stays on page
- */
-export type UseNavigateAwayHandler = (event: BeforeUnloadEvent) => string | boolean;
-/**
- * @resources
- *
- * About browser's specs see:
- * - https://developer.mozilla.org/en-US/docs/Web/API/Window/pagehide_event
- * - https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/HandlingEvents/HandlingEvents.html#//apple_ref/doc/uid/TP40006511-SW5
- * - https://stackoverflow.com/questions/58009424/pagehide-event-on-google-chrome
- *
- * About react see:
- * - https://github.com/jacobbuck/react-beforeunload
- * - https://github.com/dioscarey/react-beforeunload-component
- *
- * About next.js see:
- * - https://github.com/vercel/next.js/issues/2476
- * - https://github.com/vercel/next.js/issues/2694
- *
- * For the callback technique see:
- * - https://stackoverflow.com/a/11835394/1938970
- */
-export declare const useNavigateAway: (handler: UseNavigateAwayHandler) => void;
-export default useNavigateAway;

package/hooks/useNavigateAway.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    useNavigateAway: function() {
-        return useNavigateAway;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _react = require("react");
-const _on = /*#__PURE__*/ _interop_require_default._(require("@koine/dom/on"));
-const useNavigateAway = (handler)=>{
-    const beforeUnloadHandlerRef = (0, _react.useRef)();
-    // const pagehideHandlerRef = useRef<UseNavigateAwayPagehideHandler | undefined>();
-    (0, _react.useEffect)(()=>{
-        beforeUnloadHandlerRef.current = (event)=>{
-            const customMessageOrCondition = handler(event);
-            if (customMessageOrCondition) {
-                event.preventDefault();
-            }
-            // Handle legacy `event.returnValue` property
-            // https://developer.mozilla.org/en-US/docs/Web/API/Window/beforeunload_event
-            if (typeof customMessageOrCondition === "string") {
-                return event.returnValue = customMessageOrCondition;
-            }
-            // Chrome doesn't support `event.preventDefault()` on `BeforeUnloadEvent`,
-            // instead it requires `event.returnValue` to be set
-            // https://developer.mozilla.org/en-US/docs/Web/API/WindowEventHandlers/onbeforeunload#browser_compatibility
-            if (event.defaultPrevented) {
-                return event.returnValue = "";
-            }
-            return;
-        };
-    // pagehideHandlerRef.current = (event) => {
-    //   const returnValue = handler?.(event);
-    //   if (event.persisted) {
-    //     // If the event's persisted property is `true` the page is about
-    //     // to enter the Back-Forward Cache, which is also in the frozen state.
-    //   } else {
-    //     // If the event's persisted property is not `true` the page is
-    //     // about to be unloaded.
-    //   }
-    // };
-    }, [
-        handler
-    ]);
-    (0, _react.useEffect)(()=>{
-        const listenerBeforeunload = (0, _on.default)(window, "beforeunload", (event)=>beforeUnloadHandlerRef.current?.(event));
-        // const listenerPagehide = on(window, "pagehide", (event) =>
-        //   pagehideHandlerRef.current?.(event)
-        // );
-        return listenerBeforeunload;
-    // return () => {
-    //   listenerBeforeunload();
-    //   // listenerPagehide();
-    // };
-    }, []);
-};
-const _default = useNavigateAway;

package/hooks/useNavigateAway.mjs

@@ -1,69 +0,0 @@
-import { useEffect, useRef } from "react";
-import on from "@koine/dom/on";
-// type UseNavigateAwayPagehideHandler = (event: PageTransitionEvent) => unknown;
-/**
- * @resources
- *
- * About browser's specs see:
- * - https://developer.mozilla.org/en-US/docs/Web/API/Window/pagehide_event
- * - https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/HandlingEvents/HandlingEvents.html#//apple_ref/doc/uid/TP40006511-SW5
- * - https://stackoverflow.com/questions/58009424/pagehide-event-on-google-chrome
- *
- * About react see:
- * - https://github.com/jacobbuck/react-beforeunload
- * - https://github.com/dioscarey/react-beforeunload-component
- *
- * About next.js see:
- * - https://github.com/vercel/next.js/issues/2476
- * - https://github.com/vercel/next.js/issues/2694
- *
- * For the callback technique see:
- * - https://stackoverflow.com/a/11835394/1938970
- */ export const useNavigateAway = (handler)=>{
-    const beforeUnloadHandlerRef = useRef();
-    // const pagehideHandlerRef = useRef<UseNavigateAwayPagehideHandler | undefined>();
-    useEffect(()=>{
-        beforeUnloadHandlerRef.current = (event)=>{
-            const customMessageOrCondition = handler(event);
-            if (customMessageOrCondition) {
-                event.preventDefault();
-            }
-            // Handle legacy `event.returnValue` property
-            // https://developer.mozilla.org/en-US/docs/Web/API/Window/beforeunload_event
-            if (typeof customMessageOrCondition === "string") {
-                return event.returnValue = customMessageOrCondition;
-            }
-            // Chrome doesn't support `event.preventDefault()` on `BeforeUnloadEvent`,
-            // instead it requires `event.returnValue` to be set
-            // https://developer.mozilla.org/en-US/docs/Web/API/WindowEventHandlers/onbeforeunload#browser_compatibility
-            if (event.defaultPrevented) {
-                return event.returnValue = "";
-            }
-            return;
-        };
-    // pagehideHandlerRef.current = (event) => {
-    //   const returnValue = handler?.(event);
-    //   if (event.persisted) {
-    //     // If the event's persisted property is `true` the page is about
-    //     // to enter the Back-Forward Cache, which is also in the frozen state.
-    //   } else {
-    //     // If the event's persisted property is not `true` the page is
-    //     // about to be unloaded.
-    //   }
-    // };
-    }, [
-        handler
-    ]);
-    useEffect(()=>{
-        const listenerBeforeunload = on(window, "beforeunload", (event)=>beforeUnloadHandlerRef.current?.(event));
-        // const listenerPagehide = on(window, "pagehide", (event) =>
-        //   pagehideHandlerRef.current?.(event)
-        // );
-        return listenerBeforeunload;
-    // return () => {
-    //   listenerBeforeunload();
-    //   // listenerPagehide();
-    // };
-    }, []);
-};
-export default useNavigateAway;

package/hooks/usePrevious.d.ts

@@ -1,5 +0,0 @@
-/**
- * @borrows [samselikoff/animated-carousel](https://github.com/samselikoff/2022-06-02-animated-carousel/blob/main/pages/final.jsx)
- */
-export declare function usePrevious<T>(state: T, defaulValue: T): T;
-export default usePrevious;

package/hooks/usePrevious.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    usePrevious: function() {
-        return usePrevious;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _react = require("react");
-function usePrevious(state, defaulValue) {
-    const [tuple, setTuple] = (0, _react.useState)([
-        state,
-        defaulValue
-    ]);
-    if (tuple[1] !== state) {
-        setTuple([
-            tuple[1],
-            state
-        ]);
-    }
-    return tuple[0];
-}
-const _default = usePrevious;

package/hooks/usePrevious.mjs

@@ -1,17 +0,0 @@
-import { useState } from "react";
-/**
- * @borrows [samselikoff/animated-carousel](https://github.com/samselikoff/2022-06-02-animated-carousel/blob/main/pages/final.jsx)
- */ export function usePrevious(state, defaulValue) {
-    const [tuple, setTuple] = useState([
-        state,
-        defaulValue
-    ]);
-    if (tuple[1] !== state) {
-        setTuple([
-            tuple[1],
-            state
-        ]);
-    }
-    return tuple[0];
-}
-export default usePrevious;

package/hooks/usePreviousRef.d.ts

@@ -1,2 +0,0 @@
-export declare function usePreviousRef<T>(value: T): T | undefined;
-export default usePreviousRef;

package/hooks/usePreviousRef.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    usePreviousRef: function() {
-        return usePreviousRef;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _react = require("react");
-function usePreviousRef(value) {
-    const ref = (0, _react.useRef)();
-    (0, _react.useEffect)(()=>{
-        ref.current = value;
-    });
-    return ref.current;
-}
-const _default = usePreviousRef;

package/hooks/usePreviousRef.mjs

@@ -1,9 +0,0 @@
-import { useEffect, useRef } from "react";
-export function usePreviousRef(value) {
-    const ref = useRef();
-    useEffect(()=>{
-        ref.current = value;
-    });
-    return ref.current;
-}
-export default usePreviousRef;

package/hooks/useScrollPosition.d.ts

@@ -1,15 +0,0 @@
-/// <reference types="react" />
-type Position = {
-    x: number;
-    y: number;
-};
-type ElementRef = React.MutableRefObject<HTMLElement | undefined>;
-/**
- * @borrows [@n8tb1t/use-scroll-position@2.0.3](https://github.com/n8tb1t/use-scroll-position) by `n8tb1t <n8tb1t@gmail.com>`
- *
- * We've just:
- * - reused internal helper functions
- * - compacted object arguments in functions as plain argument list to improve compression
- */
-export declare const useScrollPosition: (effect: (currentPosition: Position, prevPosition: Position) => void, deps?: import("react").DependencyList, element?: ElementRef, boundingElement?: ElementRef, wait?: number) => void;
-export default useScrollPosition;

package/hooks/useScrollPosition.js

@@ -1,83 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    useScrollPosition: function() {
-        return useScrollPosition;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _react = require("react");
-const _isBrowser = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/isBrowser"));
-const _listenScroll = /*#__PURE__*/ _interop_require_default._(require("@koine/dom/listenScroll"));
-const _useIsomorphicLayoutEffect = /*#__PURE__*/ _interop_require_default._(require("./useIsomorphicLayoutEffect"));
-const zeroPosition = {
-    x: 0,
-    y: 0
-};
-const getClientRect = (element)=>element?.getBoundingClientRect();
-const getScrollPosition = (element, boundingElement)=>{
-    if (!_isBrowser.default) {
-        return zeroPosition;
-    }
-    if (!boundingElement) {
-        return {
-            x: window.scrollX,
-            y: window.scrollY
-        };
-    }
-    const targetPosition = getClientRect(element?.current || document.body);
-    const containerPosition = getClientRect(boundingElement.current);
-    if (!targetPosition) {
-        return zeroPosition;
-    }
-    return containerPosition ? {
-        x: (containerPosition.x || 0) - (targetPosition.x || 0),
-        y: (containerPosition.y || 0) - (targetPosition.y || 0)
-    } : {
-        x: targetPosition.left,
-        y: targetPosition.top
-    };
-};
-const useScrollPosition = (effect, deps = [], element, boundingElement, wait)=>{
-    const position = (0, _react.useRef)(getScrollPosition(null, boundingElement));
-    let throttleTimeout = null;
-    const callBack = ()=>{
-        const current = getScrollPosition(element, boundingElement);
-        effect(current, position.current);
-        position.current = current;
-        throttleTimeout = null;
-    };
-    (0, _useIsomorphicLayoutEffect.default)(()=>{
-        if (!_isBrowser.default) {
-            return undefined;
-        }
-        const handleScroll = ()=>{
-            if (wait) {
-                if (throttleTimeout === null) {
-                    throttleTimeout = window.setTimeout(callBack, wait);
-                }
-            } else {
-                callBack();
-            }
-        };
-        const listener = (0, _listenScroll.default)(handleScroll, boundingElement?.current);
-        return ()=>{
-            listener();
-            if (throttleTimeout) {
-                clearTimeout(throttleTimeout);
-            }
-        };
-    }, deps);
-};
-const _default = useScrollPosition;

package/hooks/useScrollPosition.mjs

@@ -1,70 +0,0 @@
-import { useRef } from "react";
-import isBrowser from "@koine/utils/isBrowser";
-import listenScroll from "@koine/dom/listenScroll";
-import useIsomorphicLayoutEffect from "./useIsomorphicLayoutEffect";
-const zeroPosition = {
-    x: 0,
-    y: 0
-};
-const getClientRect = (element)=>element?.getBoundingClientRect();
-const getScrollPosition = (element, boundingElement)=>{
-    if (!isBrowser) {
-        return zeroPosition;
-    }
-    if (!boundingElement) {
-        return {
-            x: window.scrollX,
-            y: window.scrollY
-        };
-    }
-    const targetPosition = getClientRect(element?.current || document.body);
-    const containerPosition = getClientRect(boundingElement.current);
-    if (!targetPosition) {
-        return zeroPosition;
-    }
-    return containerPosition ? {
-        x: (containerPosition.x || 0) - (targetPosition.x || 0),
-        y: (containerPosition.y || 0) - (targetPosition.y || 0)
-    } : {
-        x: targetPosition.left,
-        y: targetPosition.top
-    };
-};
-/**
- * @borrows [@n8tb1t/use-scroll-position@2.0.3](https://github.com/n8tb1t/use-scroll-position) by `n8tb1t <n8tb1t@gmail.com>`
- *
- * We've just:
- * - reused internal helper functions
- * - compacted object arguments in functions as plain argument list to improve compression
- */ export const useScrollPosition = (effect, deps = [], element, boundingElement, wait)=>{
-    const position = useRef(getScrollPosition(null, boundingElement));
-    let throttleTimeout = null;
-    const callBack = ()=>{
-        const current = getScrollPosition(element, boundingElement);
-        effect(current, position.current);
-        position.current = current;
-        throttleTimeout = null;
-    };
-    useIsomorphicLayoutEffect(()=>{
-        if (!isBrowser) {
-            return undefined;
-        }
-        const handleScroll = ()=>{
-            if (wait) {
-                if (throttleTimeout === null) {
-                    throttleTimeout = window.setTimeout(callBack, wait);
-                }
-            } else {
-                callBack();
-            }
-        };
-        const listener = listenScroll(handleScroll, boundingElement?.current);
-        return ()=>{
-            listener();
-            if (throttleTimeout) {
-                clearTimeout(throttleTimeout);
-            }
-        };
-    }, deps);
-};
-export default useScrollPosition;

package/hooks/useScrollThreshold.d.ts

@@ -1,2 +0,0 @@
-export declare const useScrollThreshold: (threshold?: number, callback?: ((isAbove: boolean, isBelow: boolean) => void) | undefined) => boolean;
-export default useScrollThreshold;