@webeach/react-hooks

---

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

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

---

📦 Установка

``bash
npm install @webeach/react-hooks
`

или

`bash
pnpm install @webeach/react-hooks
`

или

`bash
yarn add @webeach/react-hooks
`

---

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

ES Modules

`ts
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

`ts
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');
`

$3


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

---

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

$3

+ 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

$3

#### Состояние — простые примитивы
- 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.