💎 Особенности

• Меньше перерисовок. Хуки обновляют состояние только по необходимости: ленивые флаги, стабильные обработчики и ссылки.
• Гибридный возврат. Некоторые хуки можно использовать как кортеж или как объект — выбирайте формат под задачу.
• Аккуратные эффекты. Подписки и очистка ресурсов настроены по умолчанию, поведение предсказуемо.
• Полная совместимость с SSR. Хуки используют браузерные API строго внутри эффектов.

📦 Установка

npm install @webeach/react-hooks

или

pnpm install @webeach/react-hooks

или

yarn add @webeach/react-hooks

📥 Подключение

ES Modules

import { useBoolean } from '@webeach/react-hooks/useBoolean';
import { useEffectCompare } from '@webeach/react-hooks/useEffectCompare';
import { useWindowEvent } from '@webeach/react-hooks/useWindowEvent';

// или
import { useBoolean, useEffectCompare, useWindowEvent } from '@webeach/react-hooks';

CommonJS

const { useBoolean } = require('@webeach/react-hooks/useBoolean');
const { useEffectCompare } = require('@webeach/react-hooks/useEffectCompare');
const { useWindowEvent } = require('@webeach/react-hooks/useWindowEvent');

// или
const { useBoolean, useEffectCompare, useWindowEvent } = require('@webeach/react-hooks');

🌿 Tree‑shaking

• Каждый хук доступен как отдельный модуль по пути (@webeach/react-hooks/useX). Такой импорт подтягивает только нужный код — это самый предсказуемый и компактный вариант для любых бандлеров (ESM и CJS).
• Именованный импорт из корня (@webeach/react-hooks) поддерживает tree‑shaking в сборщиках, которые оптимизируют ES‑модули (Vite/Rollup/esbuild/Webpack 5 в production). Неиспользуемые экспорты будут удалены на этапе сборки.
• Для проектов на CommonJS рекомендуем точечные импорты по пути модуля (require('@webeach/react-hooks/useX')), чтобы не тянуть лишние файлы через индекс.

🛠 Список хуков

По алфавиту

• useAsyncCallback
• useAsyncHandler
• useBoolean
• useCallbackCompare
• useCollection
• useControlled
• useDebounceCallback
• useDebounceState
• useDemandStructure
• useDeps
• useDOMEvent
• useEffectCompare
• useForceUpdate
• useFrame
• useFrameExtended
• useImageLoader
• useIntersectionObserver
• useIsomorphicLayoutEffect
• useLayoutEffectСompare
• useLiveRef
• useLocalStorage
• useLoop
• useMap
• useMediaQuery
• useMemoCompare
• useNumber
• useOutsideEvent
• usePageTitle
• usePageVisibility
• usePatchDeepState
• usePatchState
• useRefEffect
• useRefState
• useResizeObserver
• useSessionStorage
• useSet
• useStatus
• useThrottleCallback
• useThrottleState
• useTimeout
• useTimeoutExtended
• useToggle
• useUnmount

• useViewportBreakpoint

• useWindowEvent

По категориям

Состояние — простые примитивы

• useControlled
• useBoolean
• useNumber
• useToggle
• useStatus

Состояние — объектные паттерны

• usePatchDeepState
• usePatchState

Состояние — коллекции

• useCollection
• useMap
• useSet

Состояние — хранилища (персистентность)

• useLocalStorage
• useSessionStorage

Таймеры, циклы и кадры

• useFrame
• useFrameExtended
• useLoop
• useTimeout
• useTimeoutExtended

Ограничение частоты (throttle/debounce)

• useDebounceCallback
• useDebounceState
• useThrottleCallback
• useThrottleState

Асинхронные операции

• useAsyncCallback
• useAsyncHandler
• useImageLoader

Оптимизация зависимостей

• useDeps
• useCallbackCompare
• useEffectCompare
• useLayoutEffectCompare
• useMemoCompare
• useIsomorphicLayoutEffect

Жизненный цикл

• useEffectCompare
• useLayoutEffectCompare
• useUnmount

Рефы

• useLiveRef
• useRefEffect

События

• useDOMEvent
• useWindowEvent
• useOutsideEvent

Наблюдатели (Observers)

• useIntersectionObserver
• useResizeObserver

Страница/документ

• useMediaQuery
• usePageTitle
• usePageVisibility
• useViewportBreakpoint

Служебные

• useDemandStructure
• useForceUpdate
• useRefState

🧩 Зависимости

Библиотека имеет единственную внешнюю зависимость — @webeach/collection.

• Эта зависимость используется только хуком useCollection.
• Прочие хуки не импортируют и не требуют collection.

🔖 Выпуск новой версии

Релизы обрабатываются автоматически с помощью semantic-release.

Перед публикацией новой версии убедись, что:

1. Все изменения закоммичены и запушены в ветку main.
2. Сообщения коммитов соответствуют формату Conventional Commits:

• feat: ... — для новых фич
• fix: ... — для исправлений багов
• chore: ..., refactor: ... и другие типы — по необходимости

3. Версионирование определяется автоматически на основе типа коммитов (patch, minor, major).

👨‍💻 Автор

Разработка и поддержка: Руслан Мартынов

Если у тебя есть предложения или найден баг, открывай issue или отправляй pull request.

📄 Лицензия

Этот пакет распространяется под лицензией MIT.