import { type ReactNode } from 'react';
import { TabSync } from '../../TabSync';
/**
 * Provider for TabSync — creates instance, auto-disposes on unmount.
 *
 * @example
 * function App() {
 *   return (
 *     <TabSyncProvider channel="my-app">
 *       <Dashboard />
 *     </TabSyncProvider>
 *   );
 * }
 */
export interface TabSyncProviderProps {
    /** BroadcastChannel name (default: "tab-sync"). */
    channel?: string;
    /** Enable debug logging. */
    debug?: boolean;
    children: ReactNode;
}
export declare function TabSyncProvider({ channel, debug, children }: TabSyncProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<TabSync | null>>;
/**
 * Access the TabSync instance from context.
 *
 * @example
 * const sync = useTabSyncContext();
 * sync.set('theme', 'dark');
 */
export declare function useTabSyncContext(): TabSync;
/**
 * Two-way state sync across browser tabs — like useState but shared.
 * - Without callback: returns [value, setter] synced across tabs.
 * - With callback: also calls your handler on every change (side effects).
 *
 * @example
 * // Shared state — updates propagate to all tabs
 * const [theme, setTheme] = useTabSync('theme', 'light');
 * <button onClick={() => setTheme('dark')}>Dark mode</button>
 *
 * @example
 * // With side effect callback
 * const [cart, setCart] = useTabSync('cart', { items: [] }, (cart) => {
 *   document.title = `Cart (${cart.items.length})`;
 * });
 *
 * @example
 * // Form state synced across tabs
 * const [draft, setDraft] = useTabSync('email-draft', '');
 * <textarea value={draft} onChange={(e) => setDraft(e.target.value)} />
 */
export declare function useTabSync<T>(key: string, initialValue: T, callback?: (value: T) => void): [T, (value: T) => void];
/**
 * Read-only subscription to a synced key. Returns undefined until first set.
 *
 * @example
 * const theme = useTabSyncValue<string>('theme');
 * <div className={theme === 'dark' ? 'dark' : 'light'} />
 */
export declare function useTabSyncValue<T>(key: string): T | undefined;
/**
 * Fire-and-forget listener for a synced key. No state, no return value.
 *
 * @example
 * useTabSyncCallback<string>('theme', (theme) => {
 *   document.documentElement.setAttribute('data-theme', theme);
 * });
 *
 * @example
 * useTabSyncCallback<Cart>('cart', (cart) => {
 *   analytics.track('cart_updated', { count: cart.items.length });
 * });
 */
export declare function useTabSyncCallback<T>(key: string, callback: (value: T) => void): void;