@astral/ui 4.85.0 → 4.87.0

package/components/useMeasure/useMeasure.js

@@ -0,0 +1,42 @@
+import { useMemo, useState } from 'react';
+import { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';
+import { isBrowser } from '../utils/isBrowser';
+const noop = () => { };
+const defaultState = {
+    x: 0,
+    y: 0,
+    width: 0,
+    height: 0,
+    top: 0,
+    left: 0,
+    bottom: 0,
+    right: 0,
+};
+/**
+ * Хук отслеживает размеры HTML-элемента с помощью Resize Observer API.
+ * Принимает ref на HTML-элемент и возвращает объект с размерами элемента.
+ */
+function useMeasure() {
+    const [element, ref] = useState(null);
+    const [rect, setRect] = useState(defaultState);
+    const observer = useMemo(() => new window.ResizeObserver((entries) => {
+        if (entries[0]) {
+            setRect(entries[0].contentRect);
+        }
+    }), []);
+    useIsomorphicLayoutEffect(() => {
+        if (!element) {
+            return;
+        }
+        observer.observe(element);
+        return () => {
+            observer.disconnect();
+        };
+    }, [element]);
+    return [ref, rect];
+}
+const useMeasureFallback = (() => [noop, defaultState]);
+const useMeasureExport = isBrowser && typeof window.ResizeObserver !== 'undefined'
+    ? useMeasure
+    : useMeasureFallback;
+export default useMeasureExport;

package/components/useNewToggle/index.d.ts

@@ -0,0 +1 @@
+export * from './useNewToggle';

package/components/useNewToggle/index.js

@@ -0,0 +1 @@
+export * from './useNewToggle';

package/components/useNewToggle/public.d.ts

@@ -0,0 +1 @@
+export * from './useNewToggle';

package/components/useNewToggle/public.js

@@ -0,0 +1 @@
+export * from './useNewToggle';

package/components/useNewToggle/useNewToggle.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Хук отслеживает значение типа boolean.
+ */
+export declare const useNewToggle: (initialValue: boolean) => [boolean, (nextValue?: unknown) => void];

package/components/useNewToggle/useNewToggle.js

@@ -0,0 +1,8 @@
+import { useReducer } from 'react';
+const toggleReducer = (state, nextValue) => typeof nextValue === 'boolean' ? nextValue : !state;
+/**
+ * Хук отслеживает значение типа boolean.
+ */
+export const useNewToggle = (initialValue) => {
+    return useReducer(toggleReducer, initialValue);
+};

package/components/useRafState/hooks/useUnmount/index.d.ts

@@ -0,0 +1 @@
+export * from './useUnmount';

package/components/useRafState/hooks/useUnmount/index.js

@@ -0,0 +1 @@
+export * from './useUnmount';

package/components/useRafState/hooks/useUnmount/useUnmount.d.ts

@@ -0,0 +1 @@
+export declare const useUnmount: (fn: () => void) => void;

package/components/useRafState/hooks/useUnmount/useUnmount.js

@@ -0,0 +1,7 @@
+import { useEffect, useRef } from 'react';
+export const useUnmount = (fn) => {
+    const fnRef = useRef(fn);
+    // update the ref each render so if it change the newest callback will be invoked
+    fnRef.current = fn;
+    useEffect(() => () => fnRef.current(), []);
+};

package/components/useRafState/index.d.ts

@@ -0,0 +1 @@
+export * from './useRafState';

package/components/useRafState/index.js

@@ -0,0 +1 @@
+export * from './useRafState';

package/components/useRafState/useRafState.d.ts

@@ -0,0 +1,2 @@
+import { type Dispatch, type SetStateAction } from 'react';
+export declare const useRafState: <TState>(initialState: TState | (() => TState)) => [TState, Dispatch<SetStateAction<TState>>];

package/components/useRafState/useRafState.js

@@ -0,0 +1,16 @@
+import { useCallback, useRef, useState, } from 'react';
+import { useUnmount } from './hooks/useUnmount';
+export const useRafState = (initialState) => {
+    const frame = useRef(0);
+    const [state, setState] = useState(initialState);
+    const setRafState = useCallback((value) => {
+        cancelAnimationFrame(frame.current);
+        frame.current = requestAnimationFrame(() => {
+            setState(value);
+        });
+    }, []);
+    useUnmount(() => {
+        cancelAnimationFrame(frame.current);
+    });
+    return [state, setRafState];
+};

package/components/useScroll/index.d.ts

@@ -0,0 +1 @@
+export * from './useScroll';

package/components/useScroll/index.js

@@ -0,0 +1 @@
+export * from './useScroll';

package/components/useScroll/public.d.ts

@@ -0,0 +1 @@
+export * from './useScroll';

package/components/useScroll/public.js

@@ -0,0 +1 @@
+export * from './useScroll';

package/components/useScroll/useScroll.d.ts

@@ -0,0 +1,9 @@
+import { type RefObject } from 'react';
+export interface IState {
+    x: number;
+    y: number;
+}
+/**
+ * Хук отслеживает позицию скролла внутри HTML-элемента, на который передан ref.
+ */
+export declare const useScroll: (ref: RefObject<HTMLElement | null>) => IState;

package/components/useScroll/useScroll.js

@@ -0,0 +1,39 @@
+import { useEffect } from 'react';
+import { useRafState } from '../useRafState';
+import { addEventListenerSafe } from '../utils/addEventListenerSafe';
+import { removeEventListenerSafe } from '../utils/removeEventListenerSafe';
+/**
+ * Хук отслеживает позицию скролла внутри HTML-элемента, на который передан ref.
+ */
+export const useScroll = (ref) => {
+    if (process.env.NODE_ENV === 'development' &&
+        (typeof ref !== 'object' || typeof ref.current === 'undefined')) {
+        throw new Error('`useScroll` expects a single ref argument.');
+    }
+    const [state, setState] = useRafState({
+        x: 0,
+        y: 0,
+    });
+    useEffect(() => {
+        const handler = () => {
+            if (ref.current) {
+                setState({
+                    x: ref.current.scrollLeft,
+                    y: ref.current.scrollTop,
+                });
+            }
+        };
+        if (ref.current) {
+            addEventListenerSafe(ref.current, 'scroll', handler, {
+                capture: false,
+                passive: true,
+            });
+        }
+        return () => {
+            if (ref.current) {
+                removeEventListenerSafe(ref.current, 'scroll', handler);
+            }
+        };
+    }, [ref]);
+    return state;
+};

package/components/useSet/index.d.ts

@@ -1 +1 @@
-export { useSet } from './useSet';
+export * from './useSet';

package/components/useSet/index.js

@@ -1 +1 @@
-export { useSet } from './useSet';
+export * from './useSet';

package/components/useSet/public.d.ts

@@ -1 +1 @@
-export { useSet } from './useSet';
+export * from './useSet';

package/components/useSet/public.js

@@ -1 +1 @@
-export { useSet } from './useSet';
+export * from './useSet';

package/components/useSet/useSet.d.ts

@@ -1 +1,14 @@
-export { useSet } from 'react-use';
+export interface IStableActions<TKey> {
+    add: (key: TKey) => void;
+    remove: (key: TKey) => void;
+    toggle: (key: TKey) => void;
+    reset: () => void;
+    clear: () => void;
+}
+export interface IActions<TKey> extends IStableActions<TKey> {
+    has: (key: TKey) => boolean;
+}
+/**
+ * Хук отслеживает состояние Set и предоставляет методы для его изменения.
+ */
+export declare const useSet: <TKey>(initialSet?: Set<TKey>) => [Set<TKey>, IActions<TKey>];

package/components/useSet/useSet.js

@@ -1 +1,26 @@
-export { useSet } from 'react-use';
+import { useCallback, useMemo, useState } from 'react';
+/**
+ * Хук отслеживает состояние Set и предоставляет методы для его изменения.
+ */
+export const useSet = (initialSet = new Set()) => {
+    const [set, setSet] = useState(initialSet);
+    const stableActions = useMemo(() => {
+        const add = (item) => setSet((prevSet) => new Set([...Array.from(prevSet), item]));
+        const remove = (item) => setSet((prevSet) => new Set(Array.from(prevSet).filter((i) => i !== item)));
+        const toggle = (item) => setSet((prevSet) => prevSet.has(item)
+            ? new Set(Array.from(prevSet).filter((i) => i !== item))
+            : new Set([...Array.from(prevSet), item]));
+        return {
+            add,
+            remove,
+            toggle,
+            reset: () => setSet(initialSet),
+            clear: () => setSet(new Set()),
+        };
+    }, [setSet]);
+    const utils = {
+        has: useCallback((item) => set.has(item), [set]),
+        ...stableActions,
+    };
+    return [set, utils];
+};

package/components/useSize/index.d.ts

@@ -0,0 +1 @@
+export { default as useSize } from './useSize';

package/components/useSize/index.js

@@ -0,0 +1 @@
+export { default as useSize } from './useSize';

package/components/useSize/public.d.ts

@@ -0,0 +1 @@
+export { default as useSize } from './useSize';

package/components/useSize/public.js

@@ -0,0 +1 @@
+export { default as useSize } from './useSize';

package/components/useSize/useSize.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+type ElementProps = {
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+};
+export type Element = ((state: IState) => React.ReactElement<ElementProps>) | React.ReactElement<ElementProps>;
+export interface IState {
+    width: number;
+    height: number;
+}
+/**
+ * Хук отслеживает размеры HTML-элемента.
+ * Создает iframe, который растягивается на весь размер элемента и слушает событие resize.
+ */
+export declare const useSize: (element: Element, { width, height }?: Partial<IState>) => [React.ReactElement<ElementProps>, IState];
+declare const useSizeExport: (element: Element, { width, height }?: Partial<IState>) => [React.ReactElement<ElementProps>, IState];
+export default useSizeExport;

package/components/useSize/useSize.js

@@ -0,0 +1,79 @@
+import * as React from 'react';
+import { addEventListenerSafe } from '../utils/addEventListenerSafe';
+import { isBrowser } from '../utils/isBrowser';
+import { removeEventListenerSafe } from '../utils/removeEventListenerSafe';
+const { useState, useEffect, useRef } = React;
+const defer = (callback) => setTimeout(callback, 35);
+/**
+ * Хук отслеживает размеры HTML-элемента.
+ * Создает iframe, который растягивается на весь размер элемента и слушает событие resize.
+ */
+export const useSize = (element, { width = Infinity, height = Infinity } = {}) => {
+    const [state, setState] = useState({ width, height });
+    const elementNode = typeof element === 'function' ? element(state) : element;
+    const style = elementNode.props.style || {};
+    const ref = useRef(null);
+    let window = null;
+    const setSize = () => {
+        const iframe = ref.current;
+        const size = iframe
+            ? {
+                width: iframe.offsetWidth,
+                height: iframe.offsetHeight,
+            }
+            : { width, height };
+        setState(size);
+    };
+    const onWindow = (windowToListenOn) => {
+        addEventListenerSafe(windowToListenOn, 'resize', setSize);
+        defer(setSize);
+    };
+    useEffect(() => {
+        const iframe = ref.current;
+        if (!iframe) {
+            // iframe will be undefined if component is already unmounted
+            return;
+        }
+        if (iframe.contentWindow) {
+            window = iframe.contentWindow;
+            onWindow(window);
+        }
+        else {
+            const onLoad = () => {
+                addEventListenerSafe(iframe, 'load', onLoad);
+                window = iframe.contentWindow;
+                onWindow(window);
+            };
+            removeEventListenerSafe(iframe, 'load', onLoad);
+        }
+        return () => {
+            if (window) {
+                removeEventListenerSafe(window, 'resize', setSize);
+            }
+        };
+    }, []);
+    style.position = 'relative';
+    const sized = React.cloneElement(elementNode, { style }, ...[
+        React.createElement('iframe', {
+            ref,
+            style: {
+                background: 'transparent',
+                border: 'none',
+                height: '100%',
+                left: 0,
+                position: 'absolute',
+                top: 0,
+                width: '100%',
+                zIndex: -1,
+            },
+        }),
+        ...React.Children.toArray(elementNode.props.children),
+    ]);
+    return [sized, state];
+};
+const useSizeFallback = ((element, { width = Infinity, height = Infinity } = {}) => [
+    typeof element === 'function' ? element({ width, height }) : element,
+    { width, height },
+]);
+const useSizeExport = isBrowser ? useSize : useSizeFallback;
+export default useSizeExport;

package/components/useToggle/useToggle.d.ts

@@ -37,6 +37,7 @@ type UseToggleOptions<TCloseArgs extends Arguments, TOpenArgs extends Arguments>
     onInactive?: CloseHandler<TCloseArgs>;
 };
 /**
+ * @deprecated
  * хук хранящий стейт активности, и предоставляющий методы переключения с проксируемыми аргументами, позволяет уменьшить бойлерплейт код
  */
 export declare const useToggle: <TCloseArgs extends Arguments, TOpenArgs extends Arguments>(params?: UseToggleOptions<TCloseArgs, TOpenArgs> | undefined) => UseToggleResultTuple<TCloseArgs, TOpenArgs>;

package/components/useToggle/useToggle.js

@@ -1,5 +1,6 @@
 import { useState } from 'react';
 /**
+ * @deprecated
  * хук хранящий стейт активности, и предоставляющий методы переключения с проксируемыми аргументами, позволяет уменьшить бойлерплейт код
  */
 export const useToggle = (params) => {

package/components/useUpdateEffect/index.d.ts

@@ -1 +1 @@
-export { useUpdateEffect } from './useUpdateEffect';
+export * from './useUpdateEffect';

package/components/useUpdateEffect/index.js

@@ -1 +1 @@
-export { useUpdateEffect } from './useUpdateEffect';
+export * from './useUpdateEffect';

package/components/useUpdateEffect/public.d.ts

@@ -1 +1 @@
-export { useUpdateEffect } from './useUpdateEffect';
+export * from './useUpdateEffect';

package/components/useUpdateEffect/public.js

@@ -1 +1 @@
-export { useUpdateEffect } from './useUpdateEffect';
+export * from './useUpdateEffect';

package/components/useUpdateEffect/useUpdateEffect.d.ts

@@ -1 +1,5 @@
-export { useUpdateEffect } from 'react-use';
+import { useEffect } from 'react';
+/**
+ * Хук, который выполняет эффект только после первого монтирования компонента.
+ */
+export declare const useUpdateEffect: typeof useEffect;

package/components/useUpdateEffect/useUpdateEffect.js

@@ -1 +1,13 @@
-export { useUpdateEffect } from 'react-use';
+import { useEffect } from 'react';
+import { useFirstMountState } from '../useFirstMountState';
+/**
+ * Хук, который выполняет эффект только после первого монтирования компонента.
+ */
+export const useUpdateEffect = (effect, deps) => {
+    const isFirstMount = useFirstMountState();
+    useEffect(() => {
+        if (!isFirstMount) {
+            return effect();
+        }
+    }, deps);
+};

package/components/useWindowScroll/index.d.ts

@@ -0,0 +1 @@
+export * from './useWindowScroll';

package/components/useWindowScroll/index.js

@@ -0,0 +1 @@
+export * from './useWindowScroll';

package/components/useWindowScroll/public.d.ts

@@ -0,0 +1 @@
+export * from './useWindowScroll';

package/components/useWindowScroll/public.js

@@ -0,0 +1 @@
+export * from './useWindowScroll';

package/components/useWindowScroll/useWindowScroll.d.ts

@@ -0,0 +1,8 @@
+export interface IState {
+    x: number;
+    y: number;
+}
+/**
+ * Хук отслеживает позицию скролла в окне браузера.
+ */
+export declare const useWindowScroll: () => IState;

package/components/useWindowScroll/useWindowScroll.js

@@ -0,0 +1,40 @@
+import { useEffect } from 'react';
+import { useRafState } from '../useRafState';
+import { addEventListenerSafe } from '../utils/addEventListenerSafe';
+import { isBrowser } from '../utils/isBrowser';
+import { removeEventListenerSafe } from '../utils/removeEventListenerSafe';
+/**
+ * Хук отслеживает позицию скролла в окне браузера.
+ */
+export const useWindowScroll = () => {
+    const [state, setState] = useRafState(() => ({
+        x: isBrowser ? window.pageXOffset : 0,
+        y: isBrowser ? window.pageYOffset : 0,
+    }));
+    useEffect(() => {
+        const handler = () => {
+            setState((newState) => {
+                const { pageXOffset, pageYOffset } = window;
+                //Check state for change, return same state if no change happened to prevent rerender
+                //(see useState/setState documentation). useState/setState is used internally in useRafState/setState.
+                return newState.x !== pageXOffset || newState.y !== pageYOffset
+                    ? {
+                        x: pageXOffset,
+                        y: pageYOffset,
+                    }
+                    : newState;
+            });
+        };
+        //We have to update window scroll at mount, before subscription.
+        //Window scroll may be changed between render and effect handler.
+        handler();
+        addEventListenerSafe(window, 'scroll', handler, {
+            capture: false,
+            passive: true,
+        });
+        return () => {
+            removeEventListenerSafe(window, 'scroll', handler);
+        };
+    }, []);
+    return state;
+};

package/components/utils/addEventListenerSafe/addEventListenerSafe.d.ts

@@ -0,0 +1 @@
+export declare function addEventListenerSafe<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['addEventListener']>): void;

package/components/utils/addEventListenerSafe/addEventListenerSafe.js

@@ -0,0 +1,5 @@
+export function addEventListenerSafe(obj, ...args) {
+    if (obj?.addEventListener) {
+        obj.addEventListener(...args);
+    }
+}

package/components/utils/addEventListenerSafe/index.d.ts

@@ -0,0 +1 @@
+export * from './addEventListenerSafe';

package/components/utils/addEventListenerSafe/index.js

@@ -0,0 +1 @@
+export * from './addEventListenerSafe';

package/components/utils/isBrowser/index.d.ts

@@ -0,0 +1 @@
+export * from './isBrowser';

package/components/utils/isBrowser/index.js

@@ -0,0 +1 @@
+export * from './isBrowser';

package/components/utils/isBrowser/isBrowser.d.ts

@@ -0,0 +1 @@
+export declare const isBrowser: boolean;

package/components/utils/isBrowser/isBrowser.js

@@ -0,0 +1 @@
+export const isBrowser = typeof window !== 'undefined';

package/components/utils/removeEventListenerSafe/index.d.ts

@@ -0,0 +1 @@
+export * from './removeEventListenerSafe';

package/components/utils/removeEventListenerSafe/index.js

@@ -0,0 +1 @@
+export * from './removeEventListenerSafe';

package/components/utils/removeEventListenerSafe/removeEventListenerSafe.d.ts

@@ -0,0 +1 @@
+export declare function removeEventListenerSafe<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['removeEventListener']>): void;

package/components/utils/removeEventListenerSafe/removeEventListenerSafe.js

@@ -0,0 +1,5 @@
+export function removeEventListenerSafe(obj, ...args) {
+    if (obj?.removeEventListener) {
+        obj.removeEventListener(...args);
+    }
+}

package/components/utils/replaceRaf/constants.d.ts

@@ -0,0 +1 @@
+export declare const defaultFrameDuration: number;

package/components/utils/replaceRaf/constants.js

@@ -0,0 +1 @@
+export const defaultFrameDuration = 1000 / 60;

package/components/utils/replaceRaf/index.d.ts

@@ -0,0 +1 @@
+export * from './replaceRaf';

package/components/utils/replaceRaf/index.js

@@ -0,0 +1 @@
+export * from './replaceRaf';

package/components/utils/replaceRaf/replaceRaf.d.ts

@@ -0,0 +1,18 @@
+export type Stub = {
+    add: (cb: Function) => number;
+    remove: (id: number) => void;
+    flush: (duration?: number) => void;
+    reset: () => void;
+    step: (steps?: number, duration?: number) => void;
+};
+export declare function createStub(frameDuration?: number, startTime?: number): Stub;
+type ReplaceRafOptions = {
+    frameDuration?: number;
+    startTime?: number;
+};
+type ReplaceRafRoot = {
+    requestAnimationFrame: (callback: FrameRequestCallback) => number;
+    cancelAnimationFrame: (handle: number) => void;
+};
+export declare function replaceRaf(roots?: ReplaceRafRoot[], { frameDuration, startTime, }?: ReplaceRafOptions): void;
+export {};