hookery 0.0.1 → 1.0.0

package/README.md

@@ -1,23 +1,84 @@
 # Hookery 🪝
 
-A collection of high-quality, performant React hooks.
+The ultimate collection of **100+ high-quality React hooks**. Built for modern web applications with a focus on **performance**, **type safety**, and **developer experience**.
 
-> ⚠️ **Coming Soon** - This package is under active development.
+[![npm version](https://img.shields.io/npm/v/hookery.svg?style=flat-square)](https://www.npmjs.com/package/hookery)
+[![npm downloads](https://img.shields.io/npm/dm/hookery.svg?style=flat-square)](https://www.npmjs.com/package/hookery)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
 
-## Installation
+## 🚀 Why Hookery?
+
+- **🛡️ 100% Type Safe**: Written in TypeScript with strict type inference and zero "any".
+- **⚡ Performance First**: Zero unnecessary re-renders with optimized memoization.
+- **📦 Tree-shakeable**: Support for ESM and CJS; import only what you use.
+- **🔌 SSR Ready**: First-class support for Next.js, Remix, and Astro.
+- **🤖 Modern Workflows**: Pre-built hooks for AI streaming, Media recording, and Hardware APIs.
+
+## 📦 Installation
 
 ```bash
 npm install hookery
+# or
+yarn add hookery
+# or
+pnpm add hookery
+```
+
+## 💡 Quick Start
+
+```tsx
+import { useLocalStorage, useToggle, useWindowSize } from 'hookery';
+
+function App() {
+  const [isDark, toggleDark] = useToggle(false);
+  const { width, height } = useWindowSize();
+  const { value: user } = useLocalStorage('user_pref', { name: 'Guest' });
+
+  return (
+    <div>
+      <h1>Hello, {user.name}!</h1>
+      <p>Window Size: {width} x {height}</p>
+      <button onClick={toggleDark}>
+        Switch to {isDark ? 'Light' : 'Dark'} Mode
+      </button>
+    </div>
+  );
+}
 ```
 
-## Features (Planned)
+## 📚 Categories
+
+| Category | Hooks |
+| :--- | :--- |
+| **State** | `useToggle`, `useCounter`, `useHistory`, `useLocalStorage`, `useSet`, `useMap` |
+| **DOM** | `useClickOutside`, `useHover`, `useIntersection`, `useResizeObserver`, `useScroll` |
+| **Async** | `useFetch`, `useAsync`, `useLLMStream`, `useWebSocket`, `useWorker` |
+| **Media** | `useMediaDevices`, `useMediaRecorder`, `useVideoRef`, `useAudioRef` |
+| **Advanced** | `useForm`, `useTable`, `useVirtualList`, `useInfiniteScroll`, `useShortcuts` |
+
+## 🛠️ Browser & Hardware APIs
+
+Hookery provides clean abstractions for many modern browser APIs:
+- **`useSTT` & `useTTS`**: Voice recognition and synthesis.
+- **`useFileSystem`**: Local File System Access.
+- **`useBluetooth` & `useWebRTC`**: Hardware and P2P communication.
+- **`useEyeDropper`**: System color picker.
+
+## 🤝 Contributing
+
+Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## 📄 License
 
-- 🚀 **High Performance** - Zero unnecessary re-renders
-- 📦 **Tree-shakeable** - Only import what you need
-- 🔒 **TypeScript First** - Full type safety
-- ⚡ **SSR Ready** - Works with Next.js, Remix, and more
-- 🎯 **React 18/19** - Built for modern React
+Distributed under the MIT License. See `LICENSE` for more information.
 
-## License
+---
 
-MIT © Mohamed Shaban
+Built with ❤️ by [Mohamed Shaban](https://github.com/Moshaban09)

package/dist/bridges/auth0.d.mts

@@ -0,0 +1,16 @@
+import * as _auth0_auth0_spa_js from '@auth0/auth0-spa-js';
+export { useAuth0 } from '@auth0/auth0-react';
+
+/**
+ * useAuth0User
+ *
+ * Simplified access to user and loading state.
+ */
+declare function useAuth0User(): {
+    user: _auth0_auth0_spa_js.User | undefined;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    error: Error | undefined;
+};
+
+export { useAuth0User };

package/dist/bridges/auth0.d.ts

@@ -0,0 +1,16 @@
+import * as _auth0_auth0_spa_js from '@auth0/auth0-spa-js';
+export { useAuth0 } from '@auth0/auth0-react';
+
+/**
+ * useAuth0User
+ *
+ * Simplified access to user and loading state.
+ */
+declare function useAuth0User(): {
+    user: _auth0_auth0_spa_js.User | undefined;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    error: Error | undefined;
+};
+
+export { useAuth0User };