import { type Ref } from 'vue';
/**
 * Subscribe to a WebSocket event.
 * - Without callback: returns reactive ref with latest value.
 * - With callback: calls your handler on each event.
 *
 * @example
 * // Reactive state
 * const order = useSocketEvent<Order>('order.created');
 *
 * @example
 * // Custom callback
 * useSocketEvent<Order>('order.created', (order) => {
 *   playSound('new-order');
 *   analytics.track('order_received', order);
 * });
 */
export declare function useSocketEvent<T>(event: string, callback?: (data: T, raw?: unknown) => void): Ref<T | undefined>;
/**
 * Accumulate WebSocket events.
 * - Without callback: returns reactive array.
 * - With callback: calls your handler — manage your own state.
 *
 * @example
 * // Default accumulation
 * const messages = useSocketStream<ChatMessage>('chat.message');
 *
 * @example
 * // Custom — keep last 50
 * const messages = ref<ChatMessage[]>([]);
 * useSocketStream<ChatMessage>('chat.message', (msg) => {
 *   messages.value = [msg, ...messages.value].slice(0, 50);
 * });
 *
 * @example
 * // Custom — filter by type
 * const errors = ref<LogEntry[]>([]);
 * useSocketStream<LogEntry>('log.entry', (entry) => {
 *   if (entry.level === 'error') errors.value = [...errors.value, entry];
 * });
 */
export declare function useSocketStream<T>(event: string, callback?: (data: T, raw?: unknown) => void): Ref<T[]>;
/**
 * Fire-and-forget event handler — no state, no ref.
 *
 * @example
 * useSocketCallback<Notification>('notification', (n) => {
 *   showToast(n.title);
 * });
 */
export declare function useSocketCallback<T>(event: string, callback: (data: T, raw?: unknown) => void): void;