import type { SharedStateInitialValue, SharedStateSetter } from "./shared/types";
/**
 * Global state manager that syncs seamlessly across components AND browser tabs.
 * Uses `BroadcastChannel` under the hood. Perfect for things like global themes or user settings.
 *
 * @param key - The unique identifier for this piece of shared state.
 * @param initialValue - The default value.
 * @param options - Optional configuration.
 * @param options.enabled - If false, pauses the hook from subscribing and broadcasting.
 * @returns State and updater function, identical to `useState`.
 *
 * @example
 * ```tsx
 * // Component A (Maybe in a completely different browser tab!)
 * const [theme, setTheme] = useSharedState("global-theme", "light");
 * ```
 */
export declare function useSharedState<T>(key: string, initialValue: SharedStateInitialValue<T>, options?: {
    enabled?: boolean;
}): [T, SharedStateSetter<T>];