@geekmidas/ui 0.1.0 → 0.2.0

package/dist/index-QNnnyGjB.d.cts

@@ -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-QNnnyGjB.d.cts.map

package/dist/index-QNnnyGjB.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-QNnnyGjB.d.cts","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"}