@koine/react 1.0.4 → 1.0.9

package/Typography/ReadMore.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useRef, useMemo } from "react";
+import styled from "styled-components";
+import { useIsomorphicLayoutEffect } from "react-use";
+import { m, useSpring } from "framer-motion";
+// import { CgArrowsExpandDownRight as IconExpand } from "react-icons/cg";
+const Root = styled.div ``;
+const Content = styled.div `
+  & p:first-child {
+    margin-top: 0;
+  }
+`;
+const BtnWrap = styled.span `
+  display: flex;
+  justify-content: flex-end;
+  transition: transform 0.18s ease-in-out;
+  text-align: right;
+  transform: translateY(${(p) => (p.$expanded ? "0" : "-100%")});
+  opacity: ${(p) => (p.$expanded ? 0 : 1)};
+`;
+const BtnFader = styled.div `
+  width: 30%;
+  transition: transform 0.18s ease-in-out;
+  background: linear-gradient(45deg, transparent 50%, ${(p) => p.$bg} 70%);
+`;
+const Btn = styled.span `
+  padding: 0 10px 0 10px;
+  line-height: ${(p) => (p.$lineHeight ? p.$lineHeight : "inherit")};
+  background: var(--bodyBg);
+  color: var(--grey600);
+  white-space: nowrap;
+  font-size: ${(p) => p.$fontSize}px;
+  cursor: pointer;
+`;
+const BtnIcon = styled.span `
+  display: inline-block;
+  margin: 0 0 0 4px;
+  transition: transform 0.18s ease-in-out;
+  ${(p) => (p.$expanded ? "transform: rotate(180deg);" : "")};
+  font-size: ${(p) => p.$fontSize}px;
+`;
+export const ReadMore = ({ lines = 3, lineHeight = 1.6, fontSize = 14, bg = "var(--bodyBg)", expand = "Expand", collapse = "Collapse", ...props }) => {
+    const defaultMaxHeight = lines * (lineHeight * fontSize);
+    const [expanded, setExpanded] = useState(false);
+    const [maxHeight, setMaxHeight] = useState(defaultMaxHeight);
+    const [fullHeight, setFullHeight] = useState(0);
+    const [exceeds, setExceeds] = useState(false);
+    const content = useRef(null);
+    const height = useSpring(defaultMaxHeight);
+    const styles = useMemo(() => (exceeds ? { height, overflow: "hidden" } : {}), [exceeds, height]);
+    const handleExpandClick = () => {
+        setExpanded((prevExpanded) => !prevExpanded);
+    };
+    useIsomorphicLayoutEffect(() => {
+        if (content.current) {
+            const elementHeight = content.current.offsetHeight;
+            const newExceeds = elementHeight > maxHeight;
+            if (!newExceeds) {
+                setMaxHeight(elementHeight);
+            }
+            setExceeds(newExceeds);
+            setFullHeight(elementHeight);
+        }
+    }, [content, maxHeight]);
+    useIsomorphicLayoutEffect(() => {
+        height.set(expanded ? fullHeight : maxHeight);
+    }, [expanded, height, fullHeight, maxHeight]);
+    return (_jsxs(Root, { children: [_jsx(m.div, { style: styles, children: _jsx(Content, { ref: content, ...props }) }), exceeds && (_jsxs(BtnWrap, { "$expanded": expanded, children: [_jsx(BtnFader, { "$bg": bg }), _jsxs(Btn, { "$fontSize": fontSize, "$lineHeight": lineHeight, onClick: handleExpandClick, "aria-expanded": expanded, "aria-label": expanded ? collapse : expand, children: [expanded ? collapse : expand, _jsx(BtnIcon, { "$expanded": expanded })] })] }))] }));
+};

package/Typography/TextLoop.d.ts

@@ -1,16 +1,16 @@
-/// <reference types="react" />
-export declare type TextLoopPieceProps = {
-    text: string | number;
-    direction?: "up" | "down";
-    inline?: boolean;
-    noOverflow?: boolean;
-    delay?: number;
-    className?: string;
-    style?: React.CSSProperties;
-};
-export declare const TextLoopPiece: React.FC<TextLoopPieceProps>;
-export declare type TextLoopPrpps = Omit<TextLoopPieceProps, "text"> & {
-    texts: string[];
-    interval?: number;
-};
-export declare const TextLoop: ({ texts, interval, ...props }: TextLoopPrpps) => JSX.Element;
+/// <reference types="react" />
+export declare type TextLoopPieceProps = React.PropsWithChildren<{
+    text: string | number;
+    direction?: "up" | "down";
+    inline?: boolean;
+    noOverflow?: boolean;
+    delay?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}>;
+export declare const TextLoopPiece: ({ text, style, className, direction, inline, noOverflow, delay, }: TextLoopPieceProps) => JSX.Element;
+export declare type TextLoopPrpps = Omit<TextLoopPieceProps, "text"> & {
+    texts: string[];
+    interval?: number;
+};
+export declare const TextLoop: ({ texts, interval, ...props }: TextLoopPrpps) => JSX.Element;

package/Typography/TextLoop.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { m, AnimatePresence } from "framer-motion";
+export const TextLoopPiece = ({ text = "", style = {}, className = "", direction = "up", inline = true, noOverflow = true, delay = 400, }) => {
+    const placeholderRef = useRef(null);
+    const [content, setContent] = useState({ data: "", key: "" });
+    const [width, setWidth] = useState(inline ? 0 : "auto");
+    useEffect(() => {
+        const timeoutId = setTimeout(() => {
+            if (!placeholderRef.current)
+                return;
+            placeholderRef.current.innerHTML = text + "";
+            if (inline)
+                setWidth(placeholderRef.current.offsetWidth);
+            setContent({ data: text + "", key: new Date() + "" });
+        }, delay);
+        return () => clearTimeout(timeoutId);
+    }, [text, delay, inline]);
+    return (_jsxs("div", { className: className, style: {
+            ...style,
+            position: "relative",
+            display: inline ? "inline-block" : "block",
+            width,
+            whiteSpace: inline ? "nowrap" : "normal",
+        }, children: [_jsx("span", { ref: placeholderRef, style: { visibility: "hidden" } }), _jsx("div", { style: {
+                    overflow: noOverflow ? "hidden" : "visible",
+                    display: "block",
+                    position: "absolute",
+                    top: 0,
+                    left: 0,
+                    height: "100%",
+                    width: "100%",
+                }, children: _jsx(AnimatePresence, { children: _jsx(m.div, { style: { position: "absolute" }, initial: {
+                            opacity: 0,
+                            y: direction === "down" ? "-100%" : "100%",
+                        }, animate: { opacity: 1, y: 0 }, exit: {
+                            opacity: 0,
+                            y: direction === "down" ? "100%" : "-100%",
+                        }, children: content.data }, content.key) }) })] }));
+};
+export const TextLoop = ({ texts, interval = 3000, ...props }) => {
+    const [index, setIndex] = useState(0);
+    useEffect(() => {
+        const intervalId = setInterval(() => setIndex((index) => index + 1), interval // every 3 seconds
+        );
+        return () => clearTimeout(intervalId);
+    }, [interval]);
+    return _jsx(TextLoopPiece, { ...props, text: texts[index % texts.length] });
+};

package/Typography/TypeStairs.d.ts

@@ -1,6 +1,6 @@
-/// <reference types="react" />
-export declare type TypeStairsProps = {
-    children: string;
-    limit?: number;
-};
-export declare const TypeStairs: import("react").ForwardRefExoticComponent<TypeStairsProps & import("react").RefAttributes<unknown>>;
+/// <reference types="react" />
+export declare type TypeStairsProps = {
+    children: string;
+    limit?: number;
+};
+export declare const TypeStairs: import("react").ForwardRefExoticComponent<TypeStairsProps & import("react").RefAttributes<unknown>>;

package/Typography/TypeStairs.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { forwardRef } from "react";
+export const TypeStairs = forwardRef(({ children, limit }, ref) => {
+    // split in rows or just use one row if there is no limit
+    const rows = limit ? splitTextIntoRows(children, limit) : [children];
+    return rows.length > 1 ? (_jsx(_Fragment, { children: rows.map((row, rowIndex) => {
+            return (_jsxs("span", { children: [renderRow(row, rowIndex, ref), rowIndex !== rows.length - 1 && _jsx("br", {})] }, `row-${rowIndex}`));
+        }) })) : (renderRow(rows[0], 0, ref));
+});
+/**
+ * every number chars find a space and break, then restart the gradient weight
+ * @see https://stackoverflow.com/a/25770787
+ */
+function splitTextIntoRows(input = "", limit = 18) {
+    const rows = [];
+    const arr = input.split(" ");
+    let currow = arr[0];
+    let rowlen = currow.length;
+    for (let i = 1; i < arr.length; i++) {
+        const word = arr[i];
+        rowlen += word.length + 1;
+        if (rowlen <= limit) {
+            currow += " " + word;
+        }
+        else {
+            rows.push(currow);
+            currow = word;
+            rowlen = word.length;
+        }
+    }
+    rows.push(currow);
+    return rows;
+}
+function renderRow(row, rowIndex, ref) {
+    const letters = row.split("");
+    let fontWeightIdx = 1;
+    // const fontWeight = Math.min(fontWeightIdx * 100, 800);
+    return (_jsx(_Fragment, { children: letters.map((letter, letterIndex) => {
+            const fontWeight = Math.min(fontWeightIdx * 100, 800);
+            // don't waste a fontWeight for a white space
+            if (letter !== " ") {
+                fontWeightIdx++;
+            }
+            return (_jsx("span", { style: { fontWeight }, ref: ref, children: letter }, `letter-${rowIndex}-${letterIndex}`));
+        }) }));
+}

package/Typography/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./CopyPasteVisible";
-export * from "./Native";
-export * from "./ReadMore";
-export * from "./TextLoop";
-export * from "./TypeStairs";
+export * from "./CopyPasteVisible";
+export * from "./Native";
+export * from "./ReadMore";
+export * from "./TextLoop";
+export * from "./TypeStairs";

package/Typography/index.js

@@ -0,0 +1,5 @@
+export * from "./CopyPasteVisible";
+export * from "./Native";
+export * from "./ReadMore";
+export * from "./TextLoop";
+export * from "./TypeStairs";

package/Typography/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/Typography/index.js",
+  "types": "./index.d.ts"
+}

package/css/index.d.ts

@@ -0,0 +1,2 @@
+export * from "../shared";
+export { KoineDialog } from "../Dialog/css/bare";

package/css/index.js

@@ -0,0 +1,30 @@
+export * from "../shared";
+// export * from "../Alert";
+// export * from "../Animations";
+// export * from "../Autocomplete";
+// export * from "../Bg";
+// export * from "../Breadcrumbs";
+// export * from "../Buttons";
+// export * from "../Carousel";
+// export * from "../Collapsable";
+// export * from "../Debug";
+export { KoineDialog } from "../Dialog/css/bare";
+// export * from "../Forms";
+// export * from "../Grid";
+// export * from "../Hamburger";
+// export * from "../Header";
+// export * from "../Hidden";
+// export * from "../Img";
+// export * from "../Link";
+// export * from "../MenuItem";
+// export * from "../Pagination";
+// export * from "../Pill";
+// export * from "../Progress";
+// export * from "../Rating";
+// // export * from "../Select";
+// export * from "../Sidebar";
+// export * from "../Spacing";
+// export * from "../Sticky";
+// export * from "../styles";
+// export * from "../Tabs";
+// export * from "../Typography";

package/css/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/css/index.js",
+  "types": "./index.d.ts"
+}

package/helpers/classed.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+declare type ClassedAugmentedProps<Props> = Props & {
+    className?: string;
+    ref?: React.Ref<any>;
+};
+declare type ClassedFinalProps<Props, Component> = Component extends React.ReactHTML ? React.HTMLProps<Component> & ClassedAugmentedProps<Props> : ClassedAugmentedProps<Props>;
+/**
+ * This utility allows to extend a component a là `styled-components` but for
+ * a className based styling solution like Tailwind,
+ *
+ * It also plays nicely with tailwind intellisense @see:
+ *
+ * - https://github.com/tailwindlabs/tailwindcss-intellisense#tailwindcssclassattributes
+ *
+ * For references about tagged functions:
+ * - https://javascript.plainenglish.io/how-css-in-js-libraries-work-da4145b1b6c7
+ * - https://makersden.io/blog/reverse-engineering-styled-components
+ * - https://typesafe.blog/article/the-logic-behind-javascript-tag-functions
+ * - https://flaming.codes/posts/typescript-and-javascript-tagged-template-strings
+ */
+export declare function classed<Props, Component extends React.ElementType = any>(component: Component): (strings: TemplateStringsArray, ...args: string[] | ((props: Props) => string)[]) => React.ForwardRefExoticComponent<React.PropsWithoutRef<ClassedFinalProps<Props, Component>> & React.RefAttributes<Component>>;
+export {};

package/helpers/classed.js

@@ -0,0 +1,64 @@
+import { createElement, forwardRef } from "react";
+/**
+ * This utility allows to extend a component a là `styled-components` but for
+ * a className based styling solution like Tailwind,
+ *
+ * It also plays nicely with tailwind intellisense @see:
+ *
+ * - https://github.com/tailwindlabs/tailwindcss-intellisense#tailwindcssclassattributes
+ *
+ * For references about tagged functions:
+ * - https://javascript.plainenglish.io/how-css-in-js-libraries-work-da4145b1b6c7
+ * - https://makersden.io/blog/reverse-engineering-styled-components
+ * - https://typesafe.blog/article/the-logic-behind-javascript-tag-functions
+ * - https://flaming.codes/posts/typescript-and-javascript-tagged-template-strings
+ */
+export function classed(component) {
+    // @ts-expect-error nevermind for now...
+    const type = component.type || component;
+    return function (strings, ...args) {
+        const WrappedComponent = forwardRef(function (props, ref) {
+            const argResolved = args
+                .map((arg, index) => {
+                let result = "";
+                if (typeof arg === "function") {
+                    result = arg(props);
+                }
+                else if (typeof arg !== "undefined") {
+                    result = arg.toString();
+                }
+                return strings[index] + result;
+            })
+                .join("");
+            const isNativeHtmlElement = typeof type === "string";
+            const propsToForward = isNativeHtmlElement
+                ? {}
+                : props;
+            if (isNativeHtmlElement) {
+                for (const key in props) {
+                    // like styled-components `transient` props
+                    if (!key.startsWith("$")) {
+                        propsToForward[key] = props[key];
+                    }
+                }
+            }
+            // get the tagged function string outcome
+            let className = argResolved || strings[0];
+            // check if we need to clean it or not from the optional structure `< class="..."`
+            className = className.match(/class="([^"]*)/)?.[1] || className;
+            // add the custom classes from props
+            className += props?.className ? " " + props?.className : "";
+            return createElement(type, {
+                // ...props,
+                ...propsToForward,
+                // only add ot props if it is not an empty string
+                className: className || undefined,
+                // add ref to props
+                ref,
+            });
+        });
+        // FIXME: not sure if this is needed
+        // WrappedComponent.displayName = type.toString();
+        return WrappedComponent; // as unknown as React.ReactElement<typeof props>;
+    };
+}

package/helpers/extend-component.d.ts

@@ -0,0 +1,28 @@
+import React from "react";
+export declare type ExtendableComponent<Props = any> = React.ForwardRefExoticComponent<Props> | React.ExoticComponent<Props> | React.FC<Props> | ((props: Props) => JSX.Element);
+export declare const extendComponent: <Component extends ExtendableComponent<any>, DefaultProps extends {}>(component: Component, defaultProps: DefaultProps) => ((props: React.ComponentProps<Component>) => React.FunctionComponentElement<any>) & DefaultProps & {
+    defaultProps: DefaultProps;
+};
+export interface OverridableComponents {
+    [key: string]: {
+        type: React.ElementType;
+        props: any;
+        motionable?: boolean;
+    };
+}
+/**
+ * Type to define a component that has overridable components.
+ *
+ * Each of them can define its:
+ * - `type`: either as a native HTMLElement (the props for that element will be
+ * automatically inferred) or as a custom React component
+ * - `props`: any additional custom props
+ * - `motionable`: if that component has a possible implementation with `framer-motion`,
+ * in that case we remove some HTMLAttributes props which collides with
+ * `MotionProps` from framer.
+ */
+export declare type WithComponents<Props, Components extends OverridableComponents> = Props & {
+    [Name in keyof Components]: NonNullable<Components[Name]["type"] extends keyof JSX.IntrinsicElements ? React.ElementType<Components[Name]["motionable"] extends true ? Omit<React.ComponentPropsWithoutRef<Components[Name]["type"]>, HtmlAttributesCollidingWithMotionProps> & Components[Name]["props"] : React.ComponentPropsWithoutRef<Components[Name]["type"]> & Components[Name]["props"]> : Components[Name]["type"]>;
+};
+declare type HtmlAttributesCollidingWithMotionProps = "style" | "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart" | "onAnimationEnd";
+export {};

package/helpers/extend-component.js

@@ -0,0 +1,12 @@
+import { createElement } from "react";
+export const extendComponent = (component, defaultProps) => {
+    // FIXME: check if we need to forwardRef or not
+    const NewComponent = (props) => createElement(component, props);
+    // const NewComponent = forwardRef<React.ComponentProps<Component>, Component>(
+    //   (props, ref) => createElement(component, { ...props, ref })
+    // );
+    return Object.assign(NewComponent, {
+        ...defaultProps,
+        defaultProps,
+    });
+};

package/helpers/index.d.ts

@@ -1 +1,3 @@
-export declare function useScrollTo(id?: string, offset?: number): void;
+export * from "./classed";
+export * from "./extend-component";
+export { type Simplify } from "type-fest";

package/helpers/index.js

@@ -0,0 +1,2 @@
+export * from "./classed";
+export * from "./extend-component";

package/helpers/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/helpers/index.js",
+  "types": "./index.d.ts"
+}

package/hooks/index.d.ts

@@ -1,5 +1,6 @@
-export * from "./useFocus";
-export * from "./usePrevious";
-export * from "./useDateLocale";
-export * from "./useTraceUpdate";
-export * from "./useWindowSize";
+export * from "./useDateLocale";
+export * from "./useFocus";
+export * from "./usePrevious";
+export * from "./useScrollPosition";
+export * from "./useTraceUpdate";
+export * from "./useWindowSize";

package/hooks/index.js

@@ -0,0 +1,7 @@
+export * from "./useDateLocale";
+export * from "./useFocus";
+export * from "./usePrevious";
+export * from "./useScrollPosition";
+// export * from "./useScrollTo";
+export * from "./useTraceUpdate";
+export * from "./useWindowSize";

package/hooks/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/hooks/index.js",
+  "types": "./index.d.ts"
+}

package/hooks/useDateLocale.d.ts

@@ -1,7 +1,7 @@
-/**
- * Dynamically import the date-fns correct locale
- *
- * Inspired by:
- * @see https://robertmarshall.dev/blog/dynamically-import-datefns-locale-mui-datepicker-localization/
- */
-export declare function useDateLocale(locale?: string, defaultLocale?: string): globalThis.Locale | undefined;
+/**
+ * Dynamically import the date-fns correct locale
+ *
+ * Inspired by:
+ * @see https://robertmarshall.dev/blog/dynamically-import-datefns-locale-mui-datepicker-localization/
+ */
+export declare function useDateLocale(locale?: string, defaultLocale?: string): globalThis.Locale | undefined;

package/hooks/useDateLocale.js

@@ -0,0 +1,29 @@
+import { useEffect, useState } from "react";
+/**
+ * Dynamically import the date-fns correct locale
+ *
+ * Inspired by:
+ * @see https://robertmarshall.dev/blog/dynamically-import-datefns-locale-mui-datepicker-localization/
+ */
+export function useDateLocale(locale, defaultLocale = "en") {
+    const [data, setData] = useState();
+    const [current, setCurrent] = useState(defaultLocale);
+    // const [ready, setReady] = useState(false);
+    // If the user changes the locale listen to the change and import the locale that is now required.
+    useEffect(() => {
+        const importLocaleFile = async () => {
+            // This webpack option stops all of the date-fns files being imported and chunked.
+            const localeToSet = await import(
+            /* webpackMode: "lazy", webpackChunkName: "df-[index]", webpackExclude: /_lib/ */
+            `date-fns/locale/${locale}/index.js`);
+            setCurrent(locale || current);
+            setData(localeToSet.default);
+            // setReady(true);
+        };
+        // If the locale has not yet been loaded.
+        if (locale !== current) {
+            importLocaleFile();
+        }
+    }, [locale, current]);
+    return data;
+}

package/hooks/useFocus.d.ts

@@ -1,5 +1,4 @@
-/// <reference types="react" />
-/**
- * @see https://stackoverflow.com/a/54159564/1938970
- */
-export declare const useFocus: () => (import("react").RefObject<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement> | (() => void))[];
+/**
+ * @see https://stackoverflow.com/a/54159564/1938970
+ */
+export declare const useFocus: () => (import("react").RefObject<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement> | (() => void))[];

package/hooks/useFocus.js

@@ -0,0 +1,11 @@
+import { useRef } from "react";
+/**
+ * @see https://stackoverflow.com/a/54159564/1938970
+ */
+export const useFocus = () => {
+    const element = useRef(null);
+    const setFocus = () => {
+        element.current && element.current.focus();
+    };
+    return [element, setFocus];
+};

package/hooks/usePrevious.d.ts

@@ -1 +1 @@
-export declare function usePrevious<T>(value: T): T | undefined;
+export declare function usePrevious<T>(value: T): T | undefined;

package/hooks/usePrevious.js

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

package/hooks/useScrollPosition.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+declare type Position = {
+    x: number;
+    y: number;
+};
+declare 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 | undefined, useWindow?: boolean | undefined, wait?: number | undefined, boundingElement?: ElementRef | undefined) => void;
+export {};

package/hooks/useScrollPosition.js

@@ -0,0 +1,75 @@
+import { useRef } from "react";
+import useIsomorphicLayoutEffect from "react-use/esm/useIsomorphicLayoutEffect";
+import { isBrowser } from "@koine/utils";
+const zeroPosition = { x: 0, y: 0 };
+const getClientRect = (element) => element?.getBoundingClientRect();
+const getScrollPosition = (element, useWindow, boundingElement) => {
+    if (!isBrowser) {
+        return zeroPosition;
+    }
+    if (useWindow) {
+        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, useWindow, wait, boundingElement) => {
+    const position = useRef(getScrollPosition(null, useWindow, boundingElement));
+    let throttleTimeout = null;
+    const callBack = () => {
+        const current = getScrollPosition(element, useWindow, 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();
+            }
+        };
+        if (boundingElement) {
+            boundingElement.current?.addEventListener("scroll", handleScroll, {
+                passive: true,
+            });
+        }
+        else {
+            window.addEventListener("scroll", handleScroll, { passive: true });
+        }
+        return () => {
+            if (boundingElement) {
+                boundingElement.current?.removeEventListener("scroll", handleScroll);
+            }
+            else {
+                window.removeEventListener("scroll", handleScroll);
+            }
+            if (throttleTimeout) {
+                clearTimeout(throttleTimeout);
+            }
+        };
+    }, deps);
+};

package/hooks/useScrollTo.d.ts

@@ -0,0 +1 @@
+export declare function useScrollTo(id?: string, offset?: number): void;