@koine/react 2.0.0-beta.12 → 2.0.0-beta.120

package/useScrollTo.cjs.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+
+let useScrollTo=(o="",t=0)=>{// FIXME: is the useHeader still needed?
+// const [, , headerHeight] = useHeader();
+if(!utils.isBrowser)return;let l=document.getElementById(o),r=0;if(l&&l.offsetParent)do r+=l.offsetTop;while(l=l.offsetParent)r-=t,r-=/* headerHeight || */0,window.scroll(0,r);};
+
+exports.default = useScrollTo;
+exports.useScrollTo = useScrollTo;

package/useScrollTo.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './useScrollTo.cjs.js';
+export { _default as default } from './useScrollTo.cjs.default.js';

package/useScrollTo.d.ts

@@ -0,0 +1,2 @@
+export declare let useScrollTo: (id?: string, offset?: number) => void;
+export default useScrollTo;

package/useScrollTo.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./useScrollTo";
+export { default } from "./useScrollTo";

package/useScrollTo.esm.js

@@ -0,0 +1,7 @@
+import { isBrowser } from '@koine/utils';
+
+let useScrollTo=(o="",t=0)=>{// FIXME: is the useHeader still needed?
+// const [, , headerHeight] = useHeader();
+if(!isBrowser)return;let l=document.getElementById(o),r=0;if(l&&l.offsetParent)do r+=l.offsetTop;while(l=l.offsetParent)r-=t,r-=/* headerHeight || */0,window.scroll(0,r);};
+
+export { useScrollTo as default, useScrollTo };

package/useSmoothScroll.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./useSmoothScroll";
+export { default } from "./useSmoothScroll";

package/useSmoothScroll.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./useSmoothScroll.cjs.js').default;

package/useSmoothScroll.cjs.js

@@ -0,0 +1,19 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+var utils = require('@koine/utils');
+var dom = require('@koine/dom');
+var useFixedOffset = require('./useFixedOffset.cjs.js');
+require('./useIsomorphicLayoutEffect.cjs.js');
+
+/**
+ *
+ * @param disregardAutomaticFixedOffset When the `to` scroll argument is a DOM
+ * selector we will keep into account the _fixedOffset_ despite this option.
+ * @returns
+ */let useSmoothScroll=m=>{let i=useFixedOffset.useFixedOffset();return react.useCallback((e,l,f,u,n)=>{let c;let p=!1;if(utils.isNumber(e))c=e;else if(e){let t=document.getElementById(e);t&&(c=dom.getOffsetTopSlim(t)-i.current,p=!0);}utils.isNumber(c)&&dom.scrollTo(c=c+(l||0)+(m||p?0:i.current),f,u,n);},[m,i])};
+
+exports.default = useSmoothScroll;
+exports.useSmoothScroll = useSmoothScroll;

package/useSmoothScroll.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './useSmoothScroll.cjs.js';
+export { _default as default } from './useSmoothScroll.cjs.default.js';

package/useSmoothScroll.d.ts

@@ -0,0 +1,2 @@
+export declare let useSmoothScroll: (disregardAutomaticFixedOffset?: boolean) => (to?: number | string, customOffset?: number, callback?: () => void, fallbackTimeout?: number, behavior?: ScrollBehavior) => void;
+export default useSmoothScroll;

package/useSmoothScroll.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./useSmoothScroll";
+export { default } from "./useSmoothScroll";

package/useSmoothScroll.esm.js

@@ -0,0 +1,14 @@
+import { useCallback } from 'react';
+import { isNumber } from '@koine/utils';
+import { getOffsetTopSlim, scrollTo } from '@koine/dom';
+import { useFixedOffset } from './useFixedOffset.esm.js';
+import './useIsomorphicLayoutEffect.esm.js';
+
+/**
+ *
+ * @param disregardAutomaticFixedOffset When the `to` scroll argument is a DOM
+ * selector we will keep into account the _fixedOffset_ despite this option.
+ * @returns
+ */let useSmoothScroll=m=>{let i=useFixedOffset();return useCallback((e,l,f,u,n)=>{let c;let p=!1;if(isNumber(e))c=e;else if(e){let t=document.getElementById(e);t&&(c=getOffsetTopSlim(t)-i.current,p=!0);}isNumber(c)&&scrollTo(c=c+(l||0)+(m||p?0:i.current),f,u,n);},[m,i])};
+
+export { useSmoothScroll as default, useSmoothScroll };

package/useSpinDelay.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./useSpinDelay";
+export { default } from "./useSpinDelay";

package/useSpinDelay.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./useSpinDelay.cjs.js').default;

package/useSpinDelay.cjs.js

@@ -0,0 +1,21 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+
+/**
+ * Wraps your booleans only returning true after the `delay`, and for a minimum
+ * time of `minDuration`. This way you're sure that you don't show unnecessary
+ * or very short living spinners.
+ *
+ * @borrows [smeijer/spin-delay](https://github.com/smeijer/spin-delay)
+ *
+ * - Smaller footprint and options object as argument
+ *
+ * @param delay [500]
+ * @param minDuration [200]
+ */let useSpinDelay=(u,c=500,i=200)=>{let[n,o]=react.useState(0),l=react.useRef();return react.useEffect(()=>{u&&0===n&&(clearTimeout(l.current),l.current=setTimeout(()=>{if(!u)return o(0);l.current=setTimeout(()=>{o(3);},i),o(2);},c),o(1)),u||2===n||(clearTimeout(l.current),o(0));},[u,n,c,i]),react.useEffect(()=>()=>clearTimeout(l.current),[]),2===n||3===n};
+
+exports.default = useSpinDelay;
+exports.useSpinDelay = useSpinDelay;

package/useSpinDelay.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './useSpinDelay.cjs.js';
+export { _default as default } from './useSpinDelay.cjs.default.js';

package/useSpinDelay.d.ts

@@ -0,0 +1,2 @@
+export declare let useSpinDelay: (loading: boolean, delay?: number, minDuration?: number) => boolean;
+export default useSpinDelay;

package/useSpinDelay.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./useSpinDelay";
+export { default } from "./useSpinDelay";

package/useSpinDelay.esm.js

@@ -0,0 +1,16 @@
+import { useState, useRef, useEffect } from 'react';
+
+/**
+ * Wraps your booleans only returning true after the `delay`, and for a minimum
+ * time of `minDuration`. This way you're sure that you don't show unnecessary
+ * or very short living spinners.
+ *
+ * @borrows [smeijer/spin-delay](https://github.com/smeijer/spin-delay)
+ *
+ * - Smaller footprint and options object as argument
+ *
+ * @param delay [500]
+ * @param minDuration [200]
+ */let useSpinDelay=(u,c=500,i=200)=>{let[n,o]=useState(0),l=useRef();return useEffect(()=>{u&&0===n&&(clearTimeout(l.current),l.current=setTimeout(()=>{if(!u)return o(0);l.current=setTimeout(()=>{o(3);},i),o(2);},c),o(1)),u||2===n||(clearTimeout(l.current),o(0));},[u,n,c,i]),useEffect(()=>()=>clearTimeout(l.current),[]),2===n||3===n};
+
+export { useSpinDelay as default, useSpinDelay };

package/useTraceUpdate.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./useTraceUpdate";
+export { default } from "./useTraceUpdate";

package/useTraceUpdate.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./useTraceUpdate.cjs.js').default;

package/useTraceUpdate.cjs.js

@@ -0,0 +1,13 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+
+/**
+ * @see https://stackoverflow.com/a/51082563/9122820
+ */let useTraceUpdate=r=>{let c=react.useRef(r);react.useEffect(()=>{let e=Object.entries(r).reduce((e,[t,r])=>(c.current[t]!==r&&// @ts-expect-error Does not matter here...
+    (e[t]=[c.current[t],r]),e),{});Object.keys(e).length>0&&console.info("[@koine/react:useTraceUpdate] changed props:",e),c.current=r;});};
+
+exports.default = useTraceUpdate;
+exports.useTraceUpdate = useTraceUpdate;

package/useTraceUpdate.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './useTraceUpdate.cjs.js';
+export { _default as default } from './useTraceUpdate.cjs.default.js';

package/useTraceUpdate.d.ts

@@ -0,0 +1,2 @@
+export declare let useTraceUpdate: (props: any) => void;
+export default useTraceUpdate;

package/useTraceUpdate.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./useTraceUpdate";
+export { default } from "./useTraceUpdate";

package/useTraceUpdate.esm.js

@@ -0,0 +1,8 @@
+import { useRef, useEffect } from 'react';
+
+/**
+ * @see https://stackoverflow.com/a/51082563/9122820
+ */let useTraceUpdate=r=>{let c=useRef(r);useEffect(()=>{let e=Object.entries(r).reduce((e,[t,r])=>(c.current[t]!==r&&// @ts-expect-error Does not matter here...
+    (e[t]=[c.current[t],r]),e),{});Object.keys(e).length>0&&console.info("[@koine/react:useTraceUpdate] changed props:",e),c.current=r;});};
+
+export { useTraceUpdate as default, useTraceUpdate };

package/useUpdateEffect.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./useUpdateEffect";
+export { default } from "./useUpdateEffect";

package/useUpdateEffect.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./useUpdateEffect.cjs.js').default;

package/useUpdateEffect.cjs.js

@@ -0,0 +1,14 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+var useFirstMountState = require('./useFirstMountState.cjs.js');
+
+/**
+ * @borrows [streamich/react-use](https://github.com/streamich/react-use/blob/master/src/useUpdateEffect.ts)
+ */let useUpdateEffect=(r,f)=>{let o=useFirstMountState.useFirstMountState();react.useEffect(()=>{if(!o)return r()},// eslint-disable-next-line react-hooks/exhaustive-deps
+f);};
+
+exports.default = useUpdateEffect;
+exports.useUpdateEffect = useUpdateEffect;

package/useUpdateEffect.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './useUpdateEffect.cjs.js';
+export { _default as default } from './useUpdateEffect.cjs.default.js';

package/useUpdateEffect.d.ts

@@ -0,0 +1,3 @@
+import { useEffect } from "react";
+export declare let useUpdateEffect: typeof useEffect;
+export default useUpdateEffect;

package/useUpdateEffect.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./useUpdateEffect";
+export { default } from "./useUpdateEffect";

package/useUpdateEffect.esm.js

@@ -0,0 +1,9 @@
+import { useEffect } from 'react';
+import { useFirstMountState } from './useFirstMountState.esm.js';
+
+/**
+ * @borrows [streamich/react-use](https://github.com/streamich/react-use/blob/master/src/useUpdateEffect.ts)
+ */let useUpdateEffect=(r,f)=>{let o=useFirstMountState();useEffect(()=>{if(!o)return r()},// eslint-disable-next-line react-hooks/exhaustive-deps
+f);};
+
+export { useUpdateEffect as default, useUpdateEffect };

package/useWindowSize.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./useWindowSize";
+export { default } from "./useWindowSize";

package/useWindowSize.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./useWindowSize.cjs.js').default;

package/useWindowSize.cjs.js

@@ -0,0 +1,19 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+var dom = require('@koine/dom');
+
+/**
+ * # Use `window` size
+ *
+ * @param args Optionally pass {@link debounce} arguments (`wait` and `immediate`)
+ *
+ * @returns An array with:
+ * 1) _width_: using `window.innerWidth`
+ * 2) _height_: using `window.innerHeight`
+ */let useWindowSize=(o,n)=>{let[d,w]=react.useState(0),[m,u]=react.useState(0);return react.useEffect(()=>{let e=()=>{w(window.innerWidth),u(window.innerHeight);},i=o?dom.listenResizeDebounced(0,e,o,n):dom.listenResize(e);return e(),i},[o,n]),[d,m]};
+
+exports.default = useWindowSize;
+exports.useWindowSize = useWindowSize;

package/useWindowSize.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './useWindowSize.cjs.js';
+export { _default as default } from './useWindowSize.cjs.default.js';

package/useWindowSize.d.ts

@@ -0,0 +1,3 @@
+import { debounce } from "@koine/utils";
+export declare let useWindowSize: (wait?: Parameters<typeof debounce>[1], immediate?: Parameters<typeof debounce>[2]) => readonly [number, number];
+export default useWindowSize;

package/useWindowSize.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./useWindowSize";
+export { default } from "./useWindowSize";

package/useWindowSize.esm.js

@@ -0,0 +1,14 @@
+import { useState, useEffect } from 'react';
+import { listenResizeDebounced, listenResize } from '@koine/dom';
+
+/**
+ * # Use `window` size
+ *
+ * @param args Optionally pass {@link debounce} arguments (`wait` and `immediate`)
+ *
+ * @returns An array with:
+ * 1) _width_: using `window.innerWidth`
+ * 2) _height_: using `window.innerHeight`
+ */let useWindowSize=(o,n)=>{let[d,w]=useState(0),[m,u]=useState(0);return useEffect(()=>{let e=()=>{w(window.innerWidth),u(window.innerHeight);},i=o?listenResizeDebounced(0,e,o,n):listenResize(e);return e(),i},[o,n]),[d,m]};
+
+export { useWindowSize as default, useWindowSize };

package/Alert/Alert.d.ts

@@ -1,5 +0,0 @@
-/// <reference types="react" />
-export type AlertProps = React.PropsWithChildren<{
-    $danger?: boolean;
-}>;
-export declare const Alert: ({ $danger, children, ...props }: AlertProps) => import("react/jsx-runtime").JSX.Element;

package/Alert/Alert.mjs

@@ -1,22 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import styled from "styled-components";
-const AlertRoot = styled.div`
-  font-size: 12px;
-  ${(p)=>p.$danger ? `color: var(--danger)` : ""}
-`;
-const AlertInner = styled.div`
-  padding: 1em;
-  background-color: rgba(0, 0, 0, 0.05);
-  /* border: 1px solid var(--grey700); */
-  /* background: pink; */
-  /* color: red; */
-`;
-export const Alert = ({ $danger, children, ...props })=>{
-    return /*#__PURE__*/ _jsx(AlertRoot, {
-        $danger: $danger,
-        ...props,
-        children: /*#__PURE__*/ _jsx(AlertInner, {
-            children: children
-        })
-    });
-};

package/Alert/Alert.stories.mjs

@@ -1,18 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Alert } from "./Alert";
-export default {
-    component: Alert,
-    title: "Base/Alert"
-};
-const Template = (args)=>/*#__PURE__*/ _jsx(Alert, {
-        ...args
-    });
-export const bare = Template.bind({});
-bare.args = {
-    children: "An alert message"
-};
-export const danger = Template.bind({});
-danger.args = {
-    children: "A dangerous message",
-    $danger: true
-};

package/Alert/index.d.ts

@@ -1 +0,0 @@
-export * from "./Alert";

package/Alert/index.mjs

@@ -1 +0,0 @@
-export * from "./Alert";

package/Animations/Reveal.d.ts

@@ -1,4 +0,0 @@
-/// <reference types="react" />
-import { UseRevealOptions } from "./useReveal";
-export type RevealProps = React.PropsWithChildren<UseRevealOptions>;
-export declare const Reveal: ({ children, direction, offsetStartY, offsetEndY, offsetStartX, ...props }: RevealProps) => import("react/jsx-runtime").JSX.Element;

package/Animations/Reveal.mjs

@@ -1,43 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { motion, useReducedMotion, useSpring, useTransform, useViewportScroll } from "framer-motion";
-import { useReveal } from "./useReveal";
-export const Reveal = ({ children, direction, offsetStartY, offsetEndY, offsetStartX, ...props })=>{
-    const effectOptions = {
-        direction,
-        offsetStartY,
-        offsetEndY,
-        offsetStartX
-    };
-    const prefersReducedMotion = useReducedMotion();
-    const { ref, startY, endY, startX } = useReveal(effectOptions);
-    const { scrollYProgress } = useViewportScroll();
-    const xRange = useTransform(scrollYProgress, [
-        startY,
-        endY
-    ], [
-        startX,
-        0
-    ]);
-    const opacityRange = useTransform(scrollYProgress, [
-        startY,
-        endY
-    ], [
-        0,
-        1
-    ]);
-    const x = useSpring(xRange, {
-        stiffness: 400,
-        damping: 90
-    });
-    const opacity = useSpring(opacityRange);
-    // console.log("start, end", startY, endY)
-    return /*#__PURE__*/ _jsx(motion.div, {
-        ...props,
-        ref: ref,
-        style: prefersReducedMotion ? {} : {
-            x,
-            opacity
-        },
-        children: children
-    });
-};

package/Animations/Underline.d.ts

@@ -1 +0,0 @@
-export declare const UnderlineSkewed: any;

package/Animations/Underline.mjs

@@ -1,15 +0,0 @@
-import { m } from "framer-motion";
-import styled from "styled-components";
-export const UnderlineSkewed = styled(m.i)`
-  display: block;
-  position: absolute;
-  top: 50%;
-  left: 15%;
-  right: 15%;
-  height: 20px;
-  margin-top: -10px;
-  z-index: 0;
-  pointer-events: none;
-  background: var(--accent400);
-  transform: skewY(-5deg);
-`;

package/Animations/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./Reveal";
-export * from "./Underline";
-export * from "./useReveal";

package/Animations/index.mjs

@@ -1,3 +0,0 @@
-export * from "./Reveal";
-export * from "./Underline";
-export * from "./useReveal";

package/Animations/useReveal.d.ts

@@ -1,34 +0,0 @@
-/// <reference types="react" />
-export type UseRevealOptions = {
-    /**
-     * @default "left"
-     */
-    direction?: "left" | "right";
-    /**
-     * A number that represents the offset to start the animations, giving `-1`
-     * means that the animation will start when the scroll position is at
-     * 100% higher than the given element. Giving `2` the animation will starts
-     * when the scroll reached two times the height of the given element below
-     * the top edge of the element itself
-     *
-     * @default -2
-     */
-    offsetStartY?: number;
-    /**
-     * When 0 it defaults to the same as the offsetStartY
-     * @default 0
-     */
-    offsetEndY?: number;
-    /**
-     * A value from `0` to `1` representing a proportion of the element width
-     * or "all" to make it completely out of the viewport
-     * @default "all"
-     * */
-    offsetStartX?: number | "all";
-};
-export declare function useReveal<T extends HTMLElement = HTMLDivElement>({ direction, offsetStartY, offsetEndY, offsetStartX, }: UseRevealOptions): {
-    ref: import("react").RefObject<T>;
-    startY: number;
-    endY: number;
-    startX: number;
-};

package/Animations/useReveal.mjs

@@ -1,73 +0,0 @@
-import { useEffect, useRef, useState } from "react";
-export function useReveal({ direction = "left", offsetStartY = -2, offsetEndY = 0, offsetStartX = "all" }) {
-    const ref = useRef(null);
-    const [startY, setStartY] = useState(0);
-    const [endY, setEndY] = useState(0);
-    const [startX, setStartX] = useState(0);
-    useEffect(()=>{
-        if (!ref.current) {
-            return;
-        }
-        const rect = ref.current.getBoundingClientRect();
-        // scroll position from top of the window
-        const scrollTop = window.scrollY || document.documentElement.scrollTop;
-        const elementHeight = rect.height;
-        // rect.top is the distance from the currently visible viewport to the top
-        // of the given element
-        // so distanceTop is the distance between the top edge of the window and the
-        // top edge of the given element
-        const elementTop = rect.top;
-        const distanceTop = elementTop + scrollTop;
-        const offsetTop = offsetStartY ? elementHeight * offsetStartY : 0;
-        const offsetBottom = offsetEndY ? elementHeight * offsetEndY : offsetTop;
-        // the distance of the element from the top divided by the full height
-        // of the window gives back the start position of the given element in
-        // a scale from 0 to 1
-        const startY = (distanceTop + offsetTop) / document.body.clientHeight;
-        // same for the end, we just add the given element height to the first value
-        const endY = (distanceTop + elementHeight + offsetBottom) / document.body.clientHeight;
-        let startX;
-        if (offsetStartX === "all") {
-            startX = direction === "left" ? -rect.right : rect.left;
-        } else {
-            startX = rect.width * offsetStartX;
-            startX = direction === "left" ? -startX : startX;
-        }
-        // addMarker(startY + "px");
-        // addMarker(endY + "px");
-        // console.log("start", startY, "end", endY, "startX", startX)
-        setStartY(startY);
-        setEndY(endY);
-        setStartX(startX);
-    // addMarker(startY * 100 + "%", "blue", "fixed");
-    // addMarker(endY * 100 + "%", "blue", "fixed");
-    }, [
-        setStartY,
-        setEndY,
-        setStartX,
-        offsetStartY,
-        offsetEndY,
-        offsetStartX,
-        direction
-    ]);
-    return {
-        ref,
-        startY,
-        endY,
-        startX
-    };
-} // function addMarker(top: string, color = "red", position = "absolute") {
- //   const div = document.createElement("div");
- //   div.setAttribute(
- //     "style",
- //     `
- //     position: ${position};
- //     top: ${top};
- //     left: 0;
- //     right: 0;
- //     height: 1px;
- //     background: ${color};
- //   `
- //   );
- //   document.body.appendChild(div);
- // }

package/Autocomplete/AutocompleteDownshift.d.ts

@@ -1 +0,0 @@
-export declare const Autocomplete: null;