reactives-hooks 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 reactives contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# reactives-hooks
+
+A collection of useful React hooks and utilities for React and Next.js.
+
+- **TypeScript-first** — Full type safety with generics
+- **Tree-shakeable** — Import only what you need
+- **SSR-safe** — Works with Next.js SSR/SSG out of the box
+- **Zero dependencies** — No bloat (except `cn` util which uses `clsx` + `tailwind-merge`)
+- **React 18+** compatible (React 19 ready)
+
+## Install
+
+```bash
+npm install reactives-hooks
+# or
+pnpm add reactives-hooks
+# or
+yarn add reactives-hooks
+```
+
+## Usage
+
+```tsx
+import { useToggle, useLocalStorage, useDebounceValue } from 'reactives-hooks'
+import { useQueryParams } from 'reactives-hooks/next'
+import { cn } from 'reactives-hooks/utils'
+
+function App() {
+  const [isOpen, toggle] = useToggle(false)
+  const [theme, setTheme] = useLocalStorage('theme', 'light')
+  const debouncedSearch = useDebounceValue(search, 300)
+
+  return (
+    <div className={cn('container', isOpen && 'open')}>
+      <button onClick={toggle}>Toggle</button>
+    </div>
+  )
+}
+```
+
+## Hooks
+
+### State
+- `useToggle` — Boolean toggle
+- `useBoolean` — Explicit boolean controls (setTrue/setFalse/toggle)
+- `useCounter` — Numeric counter with min/max
+- `useMap` — Map state management
+- `useSet` — Set state management
+- `usePrevious` — Previous render value
+- `useStateHistory` — Undo/redo state history
+
+### Storage
+- `useLocalStorage` — Synced localStorage with SSR safety
+- `useSessionStorage` — Synced sessionStorage with SSR safety
+
+### DOM
+- `useEventListener` — Type-safe event listener
+- `useClickOutside` — Outside click detection
+- `useHover` — Hover state tracking
+- `useIntersectionObserver` — Viewport intersection detection
+- `useResizeObserver` — Element resize detection
+- `useMutationObserver` — DOM mutation detection
+
+### Sensor
+- `useMediaQuery` — CSS media query matching
+- `useWindowSize` — Window dimensions
+- `useScroll` — Scroll position tracking
+- `useMouse` — Mouse position tracking
+- `useNetwork` — Network status and info
+
+### Performance
+- `useDebounceValue` — Debounced value
+- `useDebounceCallback` — Debounced callback
+- `useThrottleValue` — Throttled value
+- `useThrottleCallback` — Throttled callback
+
+### Lifecycle
+- `useMount` — Run on mount
+- `useUnmount` — Run on unmount
+- `useUpdateEffect` — Skip first render effect
+- `useIsMounted` — Mount status ref
+- `useIsomorphicLayoutEffect` — SSR-safe useLayoutEffect
+- `useDeepCompareEffect` — Deep comparison effect
+
+### UI
+- `useScrollLock` — Body scroll lock
+- `useDarkMode` — Dark mode with system preference
+- `useFullscreen` — Fullscreen API
+- `useCopyToClipboard` — Clipboard copy
+- `useHotkeys` — Keyboard shortcut binding
+
+### Data
+- `useAsync` — Async function wrapper
+- `useFetch` — Fetch wrapper with abort
+- `useInfiniteScroll` — Infinite scroll with IntersectionObserver
+- `usePagination` — Pagination logic
+
+### Next.js (`reactives-hooks/next`)
+- `useQueryParams` — Typed URL query state
+- `useRouteChange` — Route change detection
+- `useSafeAction` — Server Action wrapper
+- `useIsServer` — SSR/CSR detection
+
+### Utils (`reactives-hooks/utils`)
+- `cn` — Class name merge (clsx + tailwind-merge)
+- `formatDate` — Date formatting (Intl.DateTimeFormat)
+- `sleep` — Promise-based delay
+
+## License
+
+MIT