@geekmidas/ui 0.1.0 → 1.0.0

package/dist/hooks/index.cjs

@@ -0,0 +1,5 @@
+const require_hooks = require('../hooks-DuxmSO-h.cjs');
+
+exports.useDebounce = require_hooks.useDebounce;
+exports.useLocalStorage = require_hooks.useLocalStorage;
+exports.useWebSocket = require_hooks.useWebSocket;

package/dist/hooks/index.d.cts

@@ -0,0 +1,2 @@
+import { UseWebSocketOptions, UseWebSocketReturn, WebSocketStatus, useDebounce, useLocalStorage, useWebSocket } from "../index-QNnnyGjB.cjs";
+export { UseWebSocketOptions, UseWebSocketReturn, WebSocketStatus, useDebounce, useLocalStorage, useWebSocket };

package/dist/hooks/index.d.mts

@@ -0,0 +1,2 @@
+import { UseWebSocketOptions, UseWebSocketReturn, WebSocketStatus, useDebounce, useLocalStorage, useWebSocket } from "../index-DmtSyJ1q.mjs";
+export { UseWebSocketOptions, UseWebSocketReturn, WebSocketStatus, useDebounce, useLocalStorage, useWebSocket };

package/dist/hooks/index.mjs

@@ -0,0 +1,3 @@
+import { useDebounce, useLocalStorage, useWebSocket } from "../hooks-DBc-Cw9X.mjs";
+
+export { useDebounce, useLocalStorage, useWebSocket };

package/dist/hooks-DBc-Cw9X.mjs

@@ -0,0 +1,206 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+
+//#region src/hooks/use-debounce.ts
+/**
+* Debounces a value by delaying updates until after a specified delay.
+*
+* @example
+* ```tsx
+* const [search, setSearch] = useState('');
+* const debouncedSearch = useDebounce(search, 300);
+*
+* useEffect(() => {
+*   // Only fires 300ms after user stops typing
+*   fetchResults(debouncedSearch);
+* }, [debouncedSearch]);
+* ```
+*/
+function useDebounce(value, delay) {
+	const [debouncedValue, setDebouncedValue] = useState(value);
+	useEffect(() => {
+		const timer = setTimeout(() => {
+			setDebouncedValue(value);
+		}, delay);
+		return () => {
+			clearTimeout(timer);
+		};
+	}, [value, delay]);
+	return debouncedValue;
+}
+
+//#endregion
+//#region src/hooks/use-local-storage.ts
+/**
+* Syncs state with localStorage, with SSR support.
+*
+* @example
+* ```tsx
+* const [theme, setTheme] = useLocalStorage('theme', 'dark');
+*
+* // Value persists across page reloads
+* setTheme('light');
+* ```
+*/
+function useLocalStorage(key, initialValue) {
+	const readValue = useCallback(() => {
+		if (typeof window === "undefined") return initialValue;
+		try {
+			const item = window.localStorage.getItem(key);
+			return item ? JSON.parse(item) : initialValue;
+		} catch (_error) {
+			return initialValue;
+		}
+	}, [initialValue, key]);
+	const [storedValue, setStoredValue] = useState(readValue);
+	useEffect(() => {
+		setStoredValue(readValue());
+	}, [readValue]);
+	useEffect(() => {
+		const handleStorageChange = (event) => {
+			if (event.key === key && event.newValue !== null) try {
+				setStoredValue(JSON.parse(event.newValue));
+			} catch {
+				setStoredValue(event.newValue);
+			}
+		};
+		window.addEventListener("storage", handleStorageChange);
+		return () => window.removeEventListener("storage", handleStorageChange);
+	}, [key]);
+	const setValue = useCallback((value) => {
+		try {
+			const valueToStore = value instanceof Function ? value(storedValue) : value;
+			setStoredValue(valueToStore);
+			if (typeof window !== "undefined") {
+				window.localStorage.setItem(key, JSON.stringify(valueToStore));
+				window.dispatchEvent(new StorageEvent("storage", {
+					key,
+					newValue: JSON.stringify(valueToStore)
+				}));
+			}
+		} catch (_error) {}
+	}, [key, storedValue]);
+	const removeValue = useCallback(() => {
+		try {
+			if (typeof window !== "undefined") {
+				window.localStorage.removeItem(key);
+				setStoredValue(initialValue);
+			}
+		} catch (_error) {}
+	}, [key, initialValue]);
+	return [
+		storedValue,
+		setValue,
+		removeValue
+	];
+}
+
+//#endregion
+//#region src/hooks/use-websocket.ts
+/**
+* Hook for managing WebSocket connections with auto-reconnect.
+*
+* @example
+* ```tsx
+* const { status, lastMessage, send } = useWebSocket<LogEntry>(
+*   'ws://localhost:3000/ws',
+*   {
+*     onMessage: (event) => console.log('Received:', event.data),
+*   }
+* );
+*
+* // Send a message
+* send({ type: 'subscribe', channel: 'logs' });
+*
+* // Check connection status
+* if (status === 'connected') {
+*   // ...
+* }
+* ```
+*/
+function useWebSocket(url, options = {}) {
+	const { reconnect = true, reconnectDelay = 3e3, maxReconnectAttempts = 5, onOpen, onClose, onError, onMessage } = options;
+	const [status, setStatus] = useState("disconnected");
+	const [lastMessage, setLastMessage] = useState(null);
+	const wsRef = useRef(null);
+	const reconnectAttemptsRef = useRef(0);
+	const reconnectTimeoutRef = useRef(null);
+	const connect = useCallback(() => {
+		if (!url || wsRef.current?.readyState === WebSocket.OPEN) return;
+		if (wsRef.current) wsRef.current.close();
+		setStatus("connecting");
+		const ws = new WebSocket(url);
+		ws.onopen = (event) => {
+			setStatus("connected");
+			reconnectAttemptsRef.current = 0;
+			onOpen?.(event);
+		};
+		ws.onclose = (event) => {
+			setStatus("disconnected");
+			onClose?.(event);
+			if (reconnect && !event.wasClean && reconnectAttemptsRef.current < maxReconnectAttempts) {
+				reconnectAttemptsRef.current += 1;
+				reconnectTimeoutRef.current = setTimeout(() => {
+					connect();
+				}, reconnectDelay);
+			}
+		};
+		ws.onerror = (event) => {
+			onError?.(event);
+		};
+		ws.onmessage = (event) => {
+			try {
+				const data = JSON.parse(event.data);
+				setLastMessage(data);
+			} catch {
+				setLastMessage(event.data);
+			}
+			onMessage?.(event);
+		};
+		wsRef.current = ws;
+	}, [
+		url,
+		reconnect,
+		reconnectDelay,
+		maxReconnectAttempts,
+		onOpen,
+		onClose,
+		onError,
+		onMessage
+	]);
+	const disconnect = useCallback(() => {
+		if (reconnectTimeoutRef.current) {
+			clearTimeout(reconnectTimeoutRef.current);
+			reconnectTimeoutRef.current = null;
+		}
+		if (wsRef.current) {
+			wsRef.current.close(1e3, "Manual disconnect");
+			wsRef.current = null;
+		}
+		reconnectAttemptsRef.current = maxReconnectAttempts;
+		setStatus("disconnected");
+	}, [maxReconnectAttempts]);
+	const send = useCallback((data) => {
+		if (wsRef.current?.readyState === WebSocket.OPEN) {
+			const message = typeof data === "string" ? data : JSON.stringify(data);
+			wsRef.current.send(message);
+		}
+	}, []);
+	useEffect(() => {
+		if (url) connect();
+		return () => {
+			if (reconnectTimeoutRef.current) clearTimeout(reconnectTimeoutRef.current);
+			if (wsRef.current) wsRef.current.close(1e3, "Component unmount");
+		};
+	}, [url, connect]);
+	return {
+		status,
+		lastMessage,
+		send,
+		connect,
+		disconnect
+	};
+}
+
+//#endregion
+export { useDebounce, useLocalStorage, useWebSocket };
+//# sourceMappingURL=hooks-DBc-Cw9X.mjs.map

package/dist/hooks-DBc-Cw9X.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-DBc-Cw9X.mjs","names":["value: T","delay: number","key: string","initialValue: T","event: StorageEvent","value: T | ((prev: T) => T)","url: string | null","options: UseWebSocketOptions","data: string | object"],"sources":["../src/hooks/use-debounce.ts","../src/hooks/use-local-storage.ts","../src/hooks/use-websocket.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * Debounces a value by delaying updates until after a specified delay.\n *\n * @example\n * ```tsx\n * const [search, setSearch] = useState('');\n * const debouncedSearch = useDebounce(search, 300);\n *\n * useEffect(() => {\n *   // Only fires 300ms after user stops typing\n *   fetchResults(debouncedSearch);\n * }, [debouncedSearch]);\n * ```\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n\tconst [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n\tuseEffect(() => {\n\t\tconst timer = setTimeout(() => {\n\t\t\tsetDebouncedValue(value);\n\t\t}, delay);\n\n\t\treturn () => {\n\t\t\tclearTimeout(timer);\n\t\t};\n\t}, [value, delay]);\n\n\treturn debouncedValue;\n}\n\nexport default useDebounce;\n","import { useCallback, useEffect, useState } from 'react';\n\n/**\n * Syncs state with localStorage, with SSR support.\n *\n * @example\n * ```tsx\n * const [theme, setTheme] = useLocalStorage('theme', 'dark');\n *\n * // Value persists across page reloads\n * setTheme('light');\n * ```\n */\nexport function useLocalStorage<T>(\n\tkey: string,\n\tinitialValue: T,\n): [T, (value: T | ((prev: T) => T)) => void, () => void] {\n\t// Get initial value from localStorage or use provided initial value\n\tconst readValue = useCallback((): T => {\n\t\tif (typeof window === 'undefined') {\n\t\t\treturn initialValue;\n\t\t}\n\n\t\ttry {\n\t\t\tconst item = window.localStorage.getItem(key);\n\t\t\treturn item ? (JSON.parse(item) as T) : initialValue;\n\t\t} catch (_error) {\n\t\t\treturn initialValue;\n\t\t}\n\t}, [initialValue, key]);\n\n\tconst [storedValue, setStoredValue] = useState<T>(readValue);\n\n\t// Update state when key changes\n\tuseEffect(() => {\n\t\tsetStoredValue(readValue());\n\t}, [readValue]);\n\n\t// Listen for storage changes from other tabs/windows\n\tuseEffect(() => {\n\t\tconst handleStorageChange = (event: StorageEvent) => {\n\t\t\tif (event.key === key && event.newValue !== null) {\n\t\t\t\ttry {\n\t\t\t\t\tsetStoredValue(JSON.parse(event.newValue) as T);\n\t\t\t\t} catch {\n\t\t\t\t\tsetStoredValue(event.newValue as unknown as T);\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\n\t\twindow.addEventListener('storage', handleStorageChange);\n\t\treturn () => window.removeEventListener('storage', handleStorageChange);\n\t}, [key]);\n\n\t// Setter that also updates localStorage\n\tconst setValue = useCallback(\n\t\t(value: T | ((prev: T) => T)) => {\n\t\t\ttry {\n\t\t\t\t// Allow value to be a function for functional updates\n\t\t\t\tconst valueToStore =\n\t\t\t\t\tvalue instanceof Function ? value(storedValue) : value;\n\n\t\t\t\tsetStoredValue(valueToStore);\n\n\t\t\t\tif (typeof window !== 'undefined') {\n\t\t\t\t\twindow.localStorage.setItem(key, JSON.stringify(valueToStore));\n\n\t\t\t\t\t// Dispatch event for other components using the same key\n\t\t\t\t\twindow.dispatchEvent(\n\t\t\t\t\t\tnew StorageEvent('storage', {\n\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t\tnewValue: JSON.stringify(valueToStore),\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch (_error) {}\n\t\t},\n\t\t[key, storedValue],\n\t);\n\n\t// Remove value from localStorage\n\tconst removeValue = useCallback(() => {\n\t\ttry {\n\t\t\tif (typeof window !== 'undefined') {\n\t\t\t\twindow.localStorage.removeItem(key);\n\t\t\t\tsetStoredValue(initialValue);\n\t\t\t}\n\t\t} catch (_error) {}\n\t}, [key, initialValue]);\n\n\treturn [storedValue, setValue, removeValue];\n}\n\nexport default useLocalStorage;\n","import { useCallback, useEffect, useRef, useState } from 'react';\n\nexport type WebSocketStatus = 'connecting' | 'connected' | 'disconnected';\n\nexport interface UseWebSocketOptions {\n\t/**\n\t * Automatically reconnect on disconnect.\n\t * @default true\n\t */\n\treconnect?: boolean;\n\t/**\n\t * Reconnection delay in milliseconds.\n\t * @default 3000\n\t */\n\treconnectDelay?: number;\n\t/**\n\t * Maximum reconnection attempts.\n\t * @default 5\n\t */\n\tmaxReconnectAttempts?: number;\n\t/**\n\t * Callback when connection opens.\n\t */\n\tonOpen?: (event: Event) => void;\n\t/**\n\t * Callback when connection closes.\n\t */\n\tonClose?: (event: CloseEvent) => void;\n\t/**\n\t * Callback when an error occurs.\n\t */\n\tonError?: (event: Event) => void;\n\t/**\n\t * Callback when a message is received.\n\t */\n\tonMessage?: (event: MessageEvent) => void;\n}\n\nexport interface UseWebSocketReturn<T = unknown> {\n\t/**\n\t * Current connection status.\n\t */\n\tstatus: WebSocketStatus;\n\t/**\n\t * Last received message (parsed as JSON if possible).\n\t */\n\tlastMessage: T | null;\n\t/**\n\t * Send a message through the WebSocket.\n\t */\n\tsend: (data: string | object) => void;\n\t/**\n\t * Manually connect to the WebSocket.\n\t */\n\tconnect: () => void;\n\t/**\n\t * Manually disconnect from the WebSocket.\n\t */\n\tdisconnect: () => void;\n}\n\n/**\n * Hook for managing WebSocket connections with auto-reconnect.\n *\n * @example\n * ```tsx\n * const { status, lastMessage, send } = useWebSocket<LogEntry>(\n *   'ws://localhost:3000/ws',\n *   {\n *     onMessage: (event) => console.log('Received:', event.data),\n *   }\n * );\n *\n * // Send a message\n * send({ type: 'subscribe', channel: 'logs' });\n *\n * // Check connection status\n * if (status === 'connected') {\n *   // ...\n * }\n * ```\n */\nexport function useWebSocket<T = unknown>(\n\turl: string | null,\n\toptions: UseWebSocketOptions = {},\n): UseWebSocketReturn<T> {\n\tconst {\n\t\treconnect = true,\n\t\treconnectDelay = 3000,\n\t\tmaxReconnectAttempts = 5,\n\t\tonOpen,\n\t\tonClose,\n\t\tonError,\n\t\tonMessage,\n\t} = options;\n\n\tconst [status, setStatus] = useState<WebSocketStatus>('disconnected');\n\tconst [lastMessage, setLastMessage] = useState<T | null>(null);\n\n\tconst wsRef = useRef<WebSocket | null>(null);\n\tconst reconnectAttemptsRef = useRef(0);\n\tconst reconnectTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(\n\t\tnull,\n\t);\n\n\tconst connect = useCallback(() => {\n\t\tif (!url || wsRef.current?.readyState === WebSocket.OPEN) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Clean up existing connection\n\t\tif (wsRef.current) {\n\t\t\twsRef.current.close();\n\t\t}\n\n\t\tsetStatus('connecting');\n\n\t\tconst ws = new WebSocket(url);\n\n\t\tws.onopen = (event) => {\n\t\t\tsetStatus('connected');\n\t\t\treconnectAttemptsRef.current = 0;\n\t\t\tonOpen?.(event);\n\t\t};\n\n\t\tws.onclose = (event) => {\n\t\t\tsetStatus('disconnected');\n\t\t\tonClose?.(event);\n\n\t\t\t// Attempt reconnection if enabled\n\t\t\tif (\n\t\t\t\treconnect &&\n\t\t\t\t!event.wasClean &&\n\t\t\t\treconnectAttemptsRef.current < maxReconnectAttempts\n\t\t\t) {\n\t\t\t\treconnectAttemptsRef.current += 1;\n\t\t\t\treconnectTimeoutRef.current = setTimeout(() => {\n\t\t\t\t\tconnect();\n\t\t\t\t}, reconnectDelay);\n\t\t\t}\n\t\t};\n\n\t\tws.onerror = (event) => {\n\t\t\tonError?.(event);\n\t\t};\n\n\t\tws.onmessage = (event) => {\n\t\t\ttry {\n\t\t\t\tconst data = JSON.parse(event.data) as T;\n\t\t\t\tsetLastMessage(data);\n\t\t\t} catch {\n\t\t\t\tsetLastMessage(event.data as unknown as T);\n\t\t\t}\n\t\t\tonMessage?.(event);\n\t\t};\n\n\t\twsRef.current = ws;\n\t}, [\n\t\turl,\n\t\treconnect,\n\t\treconnectDelay,\n\t\tmaxReconnectAttempts,\n\t\tonOpen,\n\t\tonClose,\n\t\tonError,\n\t\tonMessage,\n\t]);\n\n\tconst disconnect = useCallback(() => {\n\t\tif (reconnectTimeoutRef.current) {\n\t\t\tclearTimeout(reconnectTimeoutRef.current);\n\t\t\treconnectTimeoutRef.current = null;\n\t\t}\n\n\t\tif (wsRef.current) {\n\t\t\twsRef.current.close(1000, 'Manual disconnect');\n\t\t\twsRef.current = null;\n\t\t}\n\n\t\treconnectAttemptsRef.current = maxReconnectAttempts; // Prevent auto-reconnect\n\t\tsetStatus('disconnected');\n\t}, [maxReconnectAttempts]);\n\n\tconst send = useCallback((data: string | object) => {\n\t\tif (wsRef.current?.readyState === WebSocket.OPEN) {\n\t\t\tconst message = typeof data === 'string' ? data : JSON.stringify(data);\n\t\t\twsRef.current.send(message);\n\t\t} else {\n\t\t}\n\t}, []);\n\n\t// Connect on mount if URL is provided\n\tuseEffect(() => {\n\t\tif (url) {\n\t\t\tconnect();\n\t\t}\n\n\t\treturn () => {\n\t\t\tif (reconnectTimeoutRef.current) {\n\t\t\t\tclearTimeout(reconnectTimeoutRef.current);\n\t\t\t}\n\t\t\tif (wsRef.current) {\n\t\t\t\twsRef.current.close(1000, 'Component unmount');\n\t\t\t}\n\t\t};\n\t}, [url, connect]);\n\n\treturn {\n\t\tstatus,\n\t\tlastMessage,\n\t\tsend,\n\t\tconnect,\n\t\tdisconnect,\n\t};\n}\n\nexport default useWebSocket;\n"],"mappings":"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"}

package/dist/hooks-DuxmSO-h.cjs

@@ -0,0 +1,252 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const react = __toESM(require("react"));
+
+//#region src/hooks/use-debounce.ts
+/**
+* Debounces a value by delaying updates until after a specified delay.
+*
+* @example
+* ```tsx
+* const [search, setSearch] = useState('');
+* const debouncedSearch = useDebounce(search, 300);
+*
+* useEffect(() => {
+*   // Only fires 300ms after user stops typing
+*   fetchResults(debouncedSearch);
+* }, [debouncedSearch]);
+* ```
+*/
+function useDebounce(value, delay) {
+	const [debouncedValue, setDebouncedValue] = (0, react.useState)(value);
+	(0, react.useEffect)(() => {
+		const timer = setTimeout(() => {
+			setDebouncedValue(value);
+		}, delay);
+		return () => {
+			clearTimeout(timer);
+		};
+	}, [value, delay]);
+	return debouncedValue;
+}
+
+//#endregion
+//#region src/hooks/use-local-storage.ts
+/**
+* Syncs state with localStorage, with SSR support.
+*
+* @example
+* ```tsx
+* const [theme, setTheme] = useLocalStorage('theme', 'dark');
+*
+* // Value persists across page reloads
+* setTheme('light');
+* ```
+*/
+function useLocalStorage(key, initialValue) {
+	const readValue = (0, react.useCallback)(() => {
+		if (typeof window === "undefined") return initialValue;
+		try {
+			const item = window.localStorage.getItem(key);
+			return item ? JSON.parse(item) : initialValue;
+		} catch (_error) {
+			return initialValue;
+		}
+	}, [initialValue, key]);
+	const [storedValue, setStoredValue] = (0, react.useState)(readValue);
+	(0, react.useEffect)(() => {
+		setStoredValue(readValue());
+	}, [readValue]);
+	(0, react.useEffect)(() => {
+		const handleStorageChange = (event) => {
+			if (event.key === key && event.newValue !== null) try {
+				setStoredValue(JSON.parse(event.newValue));
+			} catch {
+				setStoredValue(event.newValue);
+			}
+		};
+		window.addEventListener("storage", handleStorageChange);
+		return () => window.removeEventListener("storage", handleStorageChange);
+	}, [key]);
+	const setValue = (0, react.useCallback)((value) => {
+		try {
+			const valueToStore = value instanceof Function ? value(storedValue) : value;
+			setStoredValue(valueToStore);
+			if (typeof window !== "undefined") {
+				window.localStorage.setItem(key, JSON.stringify(valueToStore));
+				window.dispatchEvent(new StorageEvent("storage", {
+					key,
+					newValue: JSON.stringify(valueToStore)
+				}));
+			}
+		} catch (_error) {}
+	}, [key, storedValue]);
+	const removeValue = (0, react.useCallback)(() => {
+		try {
+			if (typeof window !== "undefined") {
+				window.localStorage.removeItem(key);
+				setStoredValue(initialValue);
+			}
+		} catch (_error) {}
+	}, [key, initialValue]);
+	return [
+		storedValue,
+		setValue,
+		removeValue
+	];
+}
+
+//#endregion
+//#region src/hooks/use-websocket.ts
+/**
+* Hook for managing WebSocket connections with auto-reconnect.
+*
+* @example
+* ```tsx
+* const { status, lastMessage, send } = useWebSocket<LogEntry>(
+*   'ws://localhost:3000/ws',
+*   {
+*     onMessage: (event) => console.log('Received:', event.data),
+*   }
+* );
+*
+* // Send a message
+* send({ type: 'subscribe', channel: 'logs' });
+*
+* // Check connection status
+* if (status === 'connected') {
+*   // ...
+* }
+* ```
+*/
+function useWebSocket(url, options = {}) {
+	const { reconnect = true, reconnectDelay = 3e3, maxReconnectAttempts = 5, onOpen, onClose, onError, onMessage } = options;
+	const [status, setStatus] = (0, react.useState)("disconnected");
+	const [lastMessage, setLastMessage] = (0, react.useState)(null);
+	const wsRef = (0, react.useRef)(null);
+	const reconnectAttemptsRef = (0, react.useRef)(0);
+	const reconnectTimeoutRef = (0, react.useRef)(null);
+	const connect = (0, react.useCallback)(() => {
+		if (!url || wsRef.current?.readyState === WebSocket.OPEN) return;
+		if (wsRef.current) wsRef.current.close();
+		setStatus("connecting");
+		const ws = new WebSocket(url);
+		ws.onopen = (event) => {
+			setStatus("connected");
+			reconnectAttemptsRef.current = 0;
+			onOpen?.(event);
+		};
+		ws.onclose = (event) => {
+			setStatus("disconnected");
+			onClose?.(event);
+			if (reconnect && !event.wasClean && reconnectAttemptsRef.current < maxReconnectAttempts) {
+				reconnectAttemptsRef.current += 1;
+				reconnectTimeoutRef.current = setTimeout(() => {
+					connect();
+				}, reconnectDelay);
+			}
+		};
+		ws.onerror = (event) => {
+			onError?.(event);
+		};
+		ws.onmessage = (event) => {
+			try {
+				const data = JSON.parse(event.data);
+				setLastMessage(data);
+			} catch {
+				setLastMessage(event.data);
+			}
+			onMessage?.(event);
+		};
+		wsRef.current = ws;
+	}, [
+		url,
+		reconnect,
+		reconnectDelay,
+		maxReconnectAttempts,
+		onOpen,
+		onClose,
+		onError,
+		onMessage
+	]);
+	const disconnect = (0, react.useCallback)(() => {
+		if (reconnectTimeoutRef.current) {
+			clearTimeout(reconnectTimeoutRef.current);
+			reconnectTimeoutRef.current = null;
+		}
+		if (wsRef.current) {
+			wsRef.current.close(1e3, "Manual disconnect");
+			wsRef.current = null;
+		}
+		reconnectAttemptsRef.current = maxReconnectAttempts;
+		setStatus("disconnected");
+	}, [maxReconnectAttempts]);
+	const send = (0, react.useCallback)((data) => {
+		if (wsRef.current?.readyState === WebSocket.OPEN) {
+			const message = typeof data === "string" ? data : JSON.stringify(data);
+			wsRef.current.send(message);
+		}
+	}, []);
+	(0, react.useEffect)(() => {
+		if (url) connect();
+		return () => {
+			if (reconnectTimeoutRef.current) clearTimeout(reconnectTimeoutRef.current);
+			if (wsRef.current) wsRef.current.close(1e3, "Component unmount");
+		};
+	}, [url, connect]);
+	return {
+		status,
+		lastMessage,
+		send,
+		connect,
+		disconnect
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
+Object.defineProperty(exports, 'useDebounce', {
+  enumerable: true,
+  get: function () {
+    return useDebounce;
+  }
+});
+Object.defineProperty(exports, 'useLocalStorage', {
+  enumerable: true,
+  get: function () {
+    return useLocalStorage;
+  }
+});
+Object.defineProperty(exports, 'useWebSocket', {
+  enumerable: true,
+  get: function () {
+    return useWebSocket;
+  }
+});
+//# sourceMappingURL=hooks-DuxmSO-h.cjs.map

package/dist/hooks-DuxmSO-h.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-DuxmSO-h.cjs","names":["value: T","delay: number","key: string","initialValue: T","event: StorageEvent","value: T | ((prev: T) => T)","url: string | null","options: UseWebSocketOptions","data: string | object"],"sources":["../src/hooks/use-debounce.ts","../src/hooks/use-local-storage.ts","../src/hooks/use-websocket.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * Debounces a value by delaying updates until after a specified delay.\n *\n * @example\n * ```tsx\n * const [search, setSearch] = useState('');\n * const debouncedSearch = useDebounce(search, 300);\n *\n * useEffect(() => {\n *   // Only fires 300ms after user stops typing\n *   fetchResults(debouncedSearch);\n * }, [debouncedSearch]);\n * ```\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n\tconst [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n\tuseEffect(() => {\n\t\tconst timer = setTimeout(() => {\n\t\t\tsetDebouncedValue(value);\n\t\t}, delay);\n\n\t\treturn () => {\n\t\t\tclearTimeout(timer);\n\t\t};\n\t}, [value, delay]);\n\n\treturn debouncedValue;\n}\n\nexport default useDebounce;\n","import { useCallback, useEffect, useState } from 'react';\n\n/**\n * Syncs state with localStorage, with SSR support.\n *\n * @example\n * ```tsx\n * const [theme, setTheme] = useLocalStorage('theme', 'dark');\n *\n * // Value persists across page reloads\n * setTheme('light');\n * ```\n */\nexport function useLocalStorage<T>(\n\tkey: string,\n\tinitialValue: T,\n): [T, (value: T | ((prev: T) => T)) => void, () => void] {\n\t// Get initial value from localStorage or use provided initial value\n\tconst readValue = useCallback((): T => {\n\t\tif (typeof window === 'undefined') {\n\t\t\treturn initialValue;\n\t\t}\n\n\t\ttry {\n\t\t\tconst item = window.localStorage.getItem(key);\n\t\t\treturn item ? (JSON.parse(item) as T) : initialValue;\n\t\t} catch (_error) {\n\t\t\treturn initialValue;\n\t\t}\n\t}, [initialValue, key]);\n\n\tconst [storedValue, setStoredValue] = useState<T>(readValue);\n\n\t// Update state when key changes\n\tuseEffect(() => {\n\t\tsetStoredValue(readValue());\n\t}, [readValue]);\n\n\t// Listen for storage changes from other tabs/windows\n\tuseEffect(() => {\n\t\tconst handleStorageChange = (event: StorageEvent) => {\n\t\t\tif (event.key === key && event.newValue !== null) {\n\t\t\t\ttry {\n\t\t\t\t\tsetStoredValue(JSON.parse(event.newValue) as T);\n\t\t\t\t} catch {\n\t\t\t\t\tsetStoredValue(event.newValue as unknown as T);\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\n\t\twindow.addEventListener('storage', handleStorageChange);\n\t\treturn () => window.removeEventListener('storage', handleStorageChange);\n\t}, [key]);\n\n\t// Setter that also updates localStorage\n\tconst setValue = useCallback(\n\t\t(value: T | ((prev: T) => T)) => {\n\t\t\ttry {\n\t\t\t\t// Allow value to be a function for functional updates\n\t\t\t\tconst valueToStore =\n\t\t\t\t\tvalue instanceof Function ? value(storedValue) : value;\n\n\t\t\t\tsetStoredValue(valueToStore);\n\n\t\t\t\tif (typeof window !== 'undefined') {\n\t\t\t\t\twindow.localStorage.setItem(key, JSON.stringify(valueToStore));\n\n\t\t\t\t\t// Dispatch event for other components using the same key\n\t\t\t\t\twindow.dispatchEvent(\n\t\t\t\t\t\tnew StorageEvent('storage', {\n\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t\tnewValue: JSON.stringify(valueToStore),\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch (_error) {}\n\t\t},\n\t\t[key, storedValue],\n\t);\n\n\t// Remove value from localStorage\n\tconst removeValue = useCallback(() => {\n\t\ttry {\n\t\t\tif (typeof window !== 'undefined') {\n\t\t\t\twindow.localStorage.removeItem(key);\n\t\t\t\tsetStoredValue(initialValue);\n\t\t\t}\n\t\t} catch (_error) {}\n\t}, [key, initialValue]);\n\n\treturn [storedValue, setValue, removeValue];\n}\n\nexport default useLocalStorage;\n","import { useCallback, useEffect, useRef, useState } from 'react';\n\nexport type WebSocketStatus = 'connecting' | 'connected' | 'disconnected';\n\nexport interface UseWebSocketOptions {\n\t/**\n\t * Automatically reconnect on disconnect.\n\t * @default true\n\t */\n\treconnect?: boolean;\n\t/**\n\t * Reconnection delay in milliseconds.\n\t * @default 3000\n\t */\n\treconnectDelay?: number;\n\t/**\n\t * Maximum reconnection attempts.\n\t * @default 5\n\t */\n\tmaxReconnectAttempts?: number;\n\t/**\n\t * Callback when connection opens.\n\t */\n\tonOpen?: (event: Event) => void;\n\t/**\n\t * Callback when connection closes.\n\t */\n\tonClose?: (event: CloseEvent) => void;\n\t/**\n\t * Callback when an error occurs.\n\t */\n\tonError?: (event: Event) => void;\n\t/**\n\t * Callback when a message is received.\n\t */\n\tonMessage?: (event: MessageEvent) => void;\n}\n\nexport interface UseWebSocketReturn<T = unknown> {\n\t/**\n\t * Current connection status.\n\t */\n\tstatus: WebSocketStatus;\n\t/**\n\t * Last received message (parsed as JSON if possible).\n\t */\n\tlastMessage: T | null;\n\t/**\n\t * Send a message through the WebSocket.\n\t */\n\tsend: (data: string | object) => void;\n\t/**\n\t * Manually connect to the WebSocket.\n\t */\n\tconnect: () => void;\n\t/**\n\t * Manually disconnect from the WebSocket.\n\t */\n\tdisconnect: () => void;\n}\n\n/**\n * Hook for managing WebSocket connections with auto-reconnect.\n *\n * @example\n * ```tsx\n * const { status, lastMessage, send } = useWebSocket<LogEntry>(\n *   'ws://localhost:3000/ws',\n *   {\n *     onMessage: (event) => console.log('Received:', event.data),\n *   }\n * );\n *\n * // Send a message\n * send({ type: 'subscribe', channel: 'logs' });\n *\n * // Check connection status\n * if (status === 'connected') {\n *   // ...\n * }\n * ```\n */\nexport function useWebSocket<T = unknown>(\n\turl: string | null,\n\toptions: UseWebSocketOptions = {},\n): UseWebSocketReturn<T> {\n\tconst {\n\t\treconnect = true,\n\t\treconnectDelay = 3000,\n\t\tmaxReconnectAttempts = 5,\n\t\tonOpen,\n\t\tonClose,\n\t\tonError,\n\t\tonMessage,\n\t} = options;\n\n\tconst [status, setStatus] = useState<WebSocketStatus>('disconnected');\n\tconst [lastMessage, setLastMessage] = useState<T | null>(null);\n\n\tconst wsRef = useRef<WebSocket | null>(null);\n\tconst reconnectAttemptsRef = useRef(0);\n\tconst reconnectTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(\n\t\tnull,\n\t);\n\n\tconst connect = useCallback(() => {\n\t\tif (!url || wsRef.current?.readyState === WebSocket.OPEN) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Clean up existing connection\n\t\tif (wsRef.current) {\n\t\t\twsRef.current.close();\n\t\t}\n\n\t\tsetStatus('connecting');\n\n\t\tconst ws = new WebSocket(url);\n\n\t\tws.onopen = (event) => {\n\t\t\tsetStatus('connected');\n\t\t\treconnectAttemptsRef.current = 0;\n\t\t\tonOpen?.(event);\n\t\t};\n\n\t\tws.onclose = (event) => {\n\t\t\tsetStatus('disconnected');\n\t\t\tonClose?.(event);\n\n\t\t\t// Attempt reconnection if enabled\n\t\t\tif (\n\t\t\t\treconnect &&\n\t\t\t\t!event.wasClean &&\n\t\t\t\treconnectAttemptsRef.current < maxReconnectAttempts\n\t\t\t) {\n\t\t\t\treconnectAttemptsRef.current += 1;\n\t\t\t\treconnectTimeoutRef.current = setTimeout(() => {\n\t\t\t\t\tconnect();\n\t\t\t\t}, reconnectDelay);\n\t\t\t}\n\t\t};\n\n\t\tws.onerror = (event) => {\n\t\t\tonError?.(event);\n\t\t};\n\n\t\tws.onmessage = (event) => {\n\t\t\ttry {\n\t\t\t\tconst data = JSON.parse(event.data) as T;\n\t\t\t\tsetLastMessage(data);\n\t\t\t} catch {\n\t\t\t\tsetLastMessage(event.data as unknown as T);\n\t\t\t}\n\t\t\tonMessage?.(event);\n\t\t};\n\n\t\twsRef.current = ws;\n\t}, [\n\t\turl,\n\t\treconnect,\n\t\treconnectDelay,\n\t\tmaxReconnectAttempts,\n\t\tonOpen,\n\t\tonClose,\n\t\tonError,\n\t\tonMessage,\n\t]);\n\n\tconst disconnect = useCallback(() => {\n\t\tif (reconnectTimeoutRef.current) {\n\t\t\tclearTimeout(reconnectTimeoutRef.current);\n\t\t\treconnectTimeoutRef.current = null;\n\t\t}\n\n\t\tif (wsRef.current) {\n\t\t\twsRef.current.close(1000, 'Manual disconnect');\n\t\t\twsRef.current = null;\n\t\t}\n\n\t\treconnectAttemptsRef.current = maxReconnectAttempts; // Prevent auto-reconnect\n\t\tsetStatus('disconnected');\n\t}, [maxReconnectAttempts]);\n\n\tconst send = useCallback((data: string | object) => {\n\t\tif (wsRef.current?.readyState === WebSocket.OPEN) {\n\t\t\tconst message = typeof data === 'string' ? data : JSON.stringify(data);\n\t\t\twsRef.current.send(message);\n\t\t} else {\n\t\t}\n\t}, []);\n\n\t// Connect on mount if URL is provided\n\tuseEffect(() => {\n\t\tif (url) {\n\t\t\tconnect();\n\t\t}\n\n\t\treturn () => {\n\t\t\tif (reconnectTimeoutRef.current) {\n\t\t\t\tclearTimeout(reconnectTimeoutRef.current);\n\t\t\t}\n\t\t\tif (wsRef.current) {\n\t\t\t\twsRef.current.close(1000, 'Component unmount');\n\t\t\t}\n\t\t};\n\t}, [url, connect]);\n\n\treturn {\n\t\tstatus,\n\t\tlastMessage,\n\t\tsend,\n\t\tconnect,\n\t\tdisconnect,\n\t};\n}\n\nexport default useWebSocket;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,SAAgB,YAAeA,OAAUC,OAAkB;CAC1D,MAAM,CAAC,gBAAgB,kBAAkB,GAAG,oBAAY,MAAM;AAE9D,sBAAU,MAAM;EACf,MAAM,QAAQ,WAAW,MAAM;AAC9B,qBAAkB,MAAM;EACxB,GAAE,MAAM;AAET,SAAO,MAAM;AACZ,gBAAa,MAAM;EACnB;CACD,GAAE,CAAC,OAAO,KAAM,EAAC;AAElB,QAAO;AACP;;;;;;;;;;;;;;;ACjBD,SAAgB,gBACfC,KACAC,cACyD;CAEzD,MAAM,YAAY,uBAAY,MAAS;AACtC,aAAW,WAAW,YACrB,QAAO;AAGR,MAAI;GACH,MAAM,OAAO,OAAO,aAAa,QAAQ,IAAI;AAC7C,UAAO,OAAQ,KAAK,MAAM,KAAK,GAAS;EACxC,SAAQ,QAAQ;AAChB,UAAO;EACP;CACD,GAAE,CAAC,cAAc,GAAI,EAAC;CAEvB,MAAM,CAAC,aAAa,eAAe,GAAG,oBAAY,UAAU;AAG5D,sBAAU,MAAM;AACf,iBAAe,WAAW,CAAC;CAC3B,GAAE,CAAC,SAAU,EAAC;AAGf,sBAAU,MAAM;EACf,MAAM,sBAAsB,CAACC,UAAwB;AACpD,OAAI,MAAM,QAAQ,OAAO,MAAM,aAAa,KAC3C,KAAI;AACH,mBAAe,KAAK,MAAM,MAAM,SAAS,CAAM;GAC/C,QAAO;AACP,mBAAe,MAAM,SAAyB;GAC9C;EAEF;AAED,SAAO,iBAAiB,WAAW,oBAAoB;AACvD,SAAO,MAAM,OAAO,oBAAoB,WAAW,oBAAoB;CACvE,GAAE,CAAC,GAAI,EAAC;CAGT,MAAM,WAAW,uBAChB,CAACC,UAAgC;AAChC,MAAI;GAEH,MAAM,eACL,iBAAiB,WAAW,MAAM,YAAY,GAAG;AAElD,kBAAe,aAAa;AAE5B,cAAW,WAAW,aAAa;AAClC,WAAO,aAAa,QAAQ,KAAK,KAAK,UAAU,aAAa,CAAC;AAG9D,WAAO,cACN,IAAI,aAAa,WAAW;KAC3B;KACA,UAAU,KAAK,UAAU,aAAa;IACtC,GACD;GACD;EACD,SAAQ,QAAQ,CAAE;CACnB,GACD,CAAC,KAAK,WAAY,EAClB;CAGD,MAAM,cAAc,uBAAY,MAAM;AACrC,MAAI;AACH,cAAW,WAAW,aAAa;AAClC,WAAO,aAAa,WAAW,IAAI;AACnC,mBAAe,aAAa;GAC5B;EACD,SAAQ,QAAQ,CAAE;CACnB,GAAE,CAAC,KAAK,YAAa,EAAC;AAEvB,QAAO;EAAC;EAAa;EAAU;CAAY;AAC3C;;;;;;;;;;;;;;;;;;;;;;;;;ACTD,SAAgB,aACfC,KACAC,UAA+B,CAAE,GACT;CACxB,MAAM,EACL,YAAY,MACZ,iBAAiB,KACjB,uBAAuB,GACvB,QACA,SACA,SACA,WACA,GAAG;CAEJ,MAAM,CAAC,QAAQ,UAAU,GAAG,oBAA0B,eAAe;CACrE,MAAM,CAAC,aAAa,eAAe,GAAG,oBAAmB,KAAK;CAE9D,MAAM,QAAQ,kBAAyB,KAAK;CAC5C,MAAM,uBAAuB,kBAAO,EAAE;CACtC,MAAM,sBAAsB,kBAC3B,KACA;CAED,MAAM,UAAU,uBAAY,MAAM;AACjC,OAAK,OAAO,MAAM,SAAS,eAAe,UAAU,KACnD;AAID,MAAI,MAAM,QACT,OAAM,QAAQ,OAAO;AAGtB,YAAU,aAAa;EAEvB,MAAM,KAAK,IAAI,UAAU;AAEzB,KAAG,SAAS,CAAC,UAAU;AACtB,aAAU,YAAY;AACtB,wBAAqB,UAAU;AAC/B,YAAS,MAAM;EACf;AAED,KAAG,UAAU,CAAC,UAAU;AACvB,aAAU,eAAe;AACzB,aAAU,MAAM;AAGhB,OACC,cACC,MAAM,YACP,qBAAqB,UAAU,sBAC9B;AACD,yBAAqB,WAAW;AAChC,wBAAoB,UAAU,WAAW,MAAM;AAC9C,cAAS;IACT,GAAE,eAAe;GAClB;EACD;AAED,KAAG,UAAU,CAAC,UAAU;AACvB,aAAU,MAAM;EAChB;AAED,KAAG,YAAY,CAAC,UAAU;AACzB,OAAI;IACH,MAAM,OAAO,KAAK,MAAM,MAAM,KAAK;AACnC,mBAAe,KAAK;GACpB,QAAO;AACP,mBAAe,MAAM,KAAqB;GAC1C;AACD,eAAY,MAAM;EAClB;AAED,QAAM,UAAU;CAChB,GAAE;EACF;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACA,EAAC;CAEF,MAAM,aAAa,uBAAY,MAAM;AACpC,MAAI,oBAAoB,SAAS;AAChC,gBAAa,oBAAoB,QAAQ;AACzC,uBAAoB,UAAU;EAC9B;AAED,MAAI,MAAM,SAAS;AAClB,SAAM,QAAQ,MAAM,KAAM,oBAAoB;AAC9C,SAAM,UAAU;EAChB;AAED,uBAAqB,UAAU;AAC/B,YAAU,eAAe;CACzB,GAAE,CAAC,oBAAqB,EAAC;CAE1B,MAAM,OAAO,uBAAY,CAACC,SAA0B;AACnD,MAAI,MAAM,SAAS,eAAe,UAAU,MAAM;GACjD,MAAM,iBAAiB,SAAS,WAAW,OAAO,KAAK,UAAU,KAAK;AACtE,SAAM,QAAQ,KAAK,QAAQ;EAC3B;CAED,GAAE,CAAE,EAAC;AAGN,sBAAU,MAAM;AACf,MAAI,IACH,UAAS;AAGV,SAAO,MAAM;AACZ,OAAI,oBAAoB,QACvB,cAAa,oBAAoB,QAAQ;AAE1C,OAAI,MAAM,QACT,OAAM,QAAQ,MAAM,KAAM,oBAAoB;EAE/C;CACD,GAAE,CAAC,KAAK,OAAQ,EAAC;AAElB,QAAO;EACN;EACA;EACA;EACA;EACA;CACA;AACD"}

package/dist/index-DmtSyJ1q.d.mts

@@ -0,0 +1,113 @@
+//#region src/hooks/use-debounce.d.ts
+/**
+ * Debounces a value by delaying updates until after a specified delay.
+ *
+ * @example
+ * ```tsx
+ * const [search, setSearch] = useState('');
+ * const debouncedSearch = useDebounce(search, 300);
+ *
+ * useEffect(() => {
+ *   // Only fires 300ms after user stops typing
+ *   fetchResults(debouncedSearch);
+ * }, [debouncedSearch]);
+ * ```
+ */
+declare function useDebounce<T>(value: T, delay: number): T;
+//#endregion
+//#region src/hooks/use-local-storage.d.ts
+/**
+ * Syncs state with localStorage, with SSR support.
+ *
+ * @example
+ * ```tsx
+ * const [theme, setTheme] = useLocalStorage('theme', 'dark');
+ *
+ * // Value persists across page reloads
+ * setTheme('light');
+ * ```
+ */
+declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void, () => void];
+//#endregion
+//#region src/hooks/use-websocket.d.ts
+type WebSocketStatus = 'connecting' | 'connected' | 'disconnected';
+interface UseWebSocketOptions {
+  /**
+   * Automatically reconnect on disconnect.
+   * @default true
+   */
+  reconnect?: boolean;
+  /**
+   * Reconnection delay in milliseconds.
+   * @default 3000
+   */
+  reconnectDelay?: number;
+  /**
+   * Maximum reconnection attempts.
+   * @default 5
+   */
+  maxReconnectAttempts?: number;
+  /**
+   * Callback when connection opens.
+   */
+  onOpen?: (event: Event) => void;
+  /**
+   * Callback when connection closes.
+   */
+  onClose?: (event: CloseEvent) => void;
+  /**
+   * Callback when an error occurs.
+   */
+  onError?: (event: Event) => void;
+  /**
+   * Callback when a message is received.
+   */
+  onMessage?: (event: MessageEvent) => void;
+}
+interface UseWebSocketReturn<T = unknown> {
+  /**
+   * Current connection status.
+   */
+  status: WebSocketStatus;
+  /**
+   * Last received message (parsed as JSON if possible).
+   */
+  lastMessage: T | null;
+  /**
+   * Send a message through the WebSocket.
+   */
+  send: (data: string | object) => void;
+  /**
+   * Manually connect to the WebSocket.
+   */
+  connect: () => void;
+  /**
+   * Manually disconnect from the WebSocket.
+   */
+  disconnect: () => void;
+}
+/**
+ * Hook for managing WebSocket connections with auto-reconnect.
+ *
+ * @example
+ * ```tsx
+ * const { status, lastMessage, send } = useWebSocket<LogEntry>(
+ *   'ws://localhost:3000/ws',
+ *   {
+ *     onMessage: (event) => console.log('Received:', event.data),
+ *   }
+ * );
+ *
+ * // Send a message
+ * send({ type: 'subscribe', channel: 'logs' });
+ *
+ * // Check connection status
+ * if (status === 'connected') {
+ *   // ...
+ * }
+ * ```
+ */
+declare function useWebSocket<T = unknown>(url: string | null, options?: UseWebSocketOptions): UseWebSocketReturn<T>;
+//#endregion
+export { UseWebSocketOptions, UseWebSocketReturn, WebSocketStatus, useDebounce, useLocalStorage, useWebSocket };
+//# sourceMappingURL=index-DmtSyJ1q.d.mts.map

package/dist/index-DmtSyJ1q.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DmtSyJ1q.d.mts","names":[],"sources":["../src/hooks/use-debounce.ts","../src/hooks/use-local-storage.ts","../src/hooks/use-websocket.ts"],"sourcesContent":[],"mappings":";;AAgBA;;;;AAA0D;;;;ACH1D;;;;;AAG2B,iBDAX,WCAW,CAAA,CAAA,CAAA,CAAA,KAAA,EDAW,CCAX,EAAA,KAAA,EAAA,MAAA,CAAA,EDA8B,CCA9B;;;;ADA3B;;;;AAA0D;;;;ACH1D;;AAEe,iBAFC,eAED,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,EAAA,YAAA,EAAA,CAAA,CAAA,EAAA,CACX,CADW,EAAA,CAAA,KAAA,EACA,CADA,GAAA,CAAA,CAAA,IAAA,EACY,CADZ,EAAA,GACkB,CADlB,CAAA,EAAA,GAAA,IAAA,EAAA,GAAA,GAAA,IAAA,CAAA;;;KCbH,eAAA;AFcI,UEZC,mBAAA,CFYU;EAAA;;;AAA+B;;;;ACH1D;;EAA+B,cAEhB,CAAA,EAAA,MAAA;EAAC;;;;EACkB,oBAAA,CAAA,EAAA,MAAA;;;;ECdtB,MAAA,CAAA,EAAA,CAAA,KAAA,EAqBM,KArBS,EAAA,GAAA,IAAA;EAEV;;;EAmBM,OAIJ,CAAA,EAAA,CAAA,KAAA,EAAA,UAAA,EAAA,GAAA,IAAA;EAAU;;AAQI;EAGhB,OAAA,CAAA,EAAA,CAAA,KAAA,EAPE,KAOgB,EAAA,GAAA,IAAA;EAAA;;;EAQpB,SAAA,CAAA,EAAA,CAAA,KAAA,EAXM,YAWN,EAAA,GAAA,IAAA;AAoCf;AAA4B,UA5CX,kBA4CW,CAAA,IAAA,OAAA,CAAA,CAAA;EAAA;;;EAGP,MAAA,EA3CZ,eA2CY;;;;eAvCP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCE,wDAEN,sBACP,mBAAmB"}