@koine/react 2.0.0-beta.4 → 2.0.0-beta.41

package/hooks/useKeyUp.js

@@ -1,40 +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, {
-    useKeyUp: function() {
-        return useKeyUp;
-    },
-    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"));
-function useKeyUp(callback, deps = []) {
-    (0, _react.useEffect)(()=>{
-        const listener = (0, _on.default)(window, "keyup", (event)=>{
-            // const { key } = event;
-            // be sure we do not intercept keys combinations maybe used for other
-            // actions like native browser navigation shortcuts
-            // @see https://stackoverflow.com/a/37559790/1938970
-            if (!event.ctrlKey && !event.altKey && !event.shiftKey && !event.metaKey) {
-                callback(event);
-            }
-        });
-        return listener;
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [
-        callback,
-        ...deps
-    ]);
-}
-const _default = useKeyUp;

package/hooks/useKeyUp.mjs

@@ -1,21 +0,0 @@
-import { useEffect } from "react";
-import on from "@koine/dom/on";
-export function useKeyUp(callback, deps = []) {
-    useEffect(()=>{
-        const listener = on(window, "keyup", (event)=>{
-            // const { key } = event;
-            // be sure we do not intercept keys combinations maybe used for other
-            // actions like native browser navigation shortcuts
-            // @see https://stackoverflow.com/a/37559790/1938970
-            if (!event.ctrlKey && !event.altKey && !event.shiftKey && !event.metaKey) {
-                callback(event);
-            }
-        });
-        return listener;
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [
-        callback,
-        ...deps
-    ]);
-}
-export default useKeyUp;

package/hooks/useMeasure.js

@@ -1,189 +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, {
-    useMeasure: function() {
-        return useMeasure;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _react = require("react");
-const _debounce = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/debounce"));
-const _noop = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/noop"));
-const _listenResizeDebounced = /*#__PURE__*/ _interop_require_default._(require("@koine/dom/listenResizeDebounced"));
-const _listenScrollDebounced = /*#__PURE__*/ _interop_require_default._(require("@koine/dom/listenScrollDebounced"));
-const _off = /*#__PURE__*/ _interop_require_default._(require("@koine/dom/off"));
-const _on = /*#__PURE__*/ _interop_require_default._(require("@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]);
-function useMeasure(options) {
-    const { scroll = false } = options || {};
-    const [bounds, setBounds] = (0, _react.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 = (0, _react.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 = (0, _react.useRef)(false);
-    (0, _react.useEffect)(()=>{
-        mounted.current = true;
-        return ()=>void (mounted.current = false);
-    }, []);
-    // memoize handlers, so event-listeners know when they should update
-    const [forceRefresh /* resizeChange */ , , scrollChange] = (0, _react.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 = (0, _debounce.default)(callback);
-        return [
-            callback,
-            debouncedCallback,
-            debouncedCallback
-        ];
-    }, [
-        setBounds /* , offsetSize */ 
-    ]);
-    // cleanup current scroll-listeners / observers
-    function removeListeners() {
-        const [, scrollContainers, resizeObserver] = state.current;
-        if (scrollContainers) {
-            scrollContainers.forEach((element)=>(0, _off.default)(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)=>(0, _on.default)(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();
-    // });
-    (0, _react.useEffect)(()=>{
-        if (scroll) {
-            const listener = (0, _listenScrollDebounced.default)(0, forceRefresh, 100);
-            return listener;
-        }
-        return _noop.default;
-    }, [
-        scroll,
-        forceRefresh
-    ]);
-    (0, _react.useEffect)(()=>{
-        // const listener = listenResizeDebounced(onWindowResize);
-        // return listener;
-        const listener = (0, _listenResizeDebounced.default)(0, forceRefresh, 100);
-        return listener;
-    }, [
-        forceRefresh
-    ]);
-    // respond to changes that are relevant for the listeners
-    (0, _react.useEffect)(()=>{
-        removeListeners();
-        addListeners();
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [
-        scroll /* , scrollChange, resizeChange */ 
-    ]);
-    (0, _react.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
-    ];
-}
-const _default = useMeasure;

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.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.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.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.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;