import { type Ref, type InjectionKey, type App } from 'vue';
import { TabSync } from '../../TabSync';
export declare const TabSyncKey: InjectionKey<TabSync>;
/**
 * Vue 3 plugin for TabSync.
 *
 * @example
 * const app = createApp(App);
 * app.use(createTabSyncPlugin('my-app'));
 */
export declare function createTabSyncPlugin(channel?: string, options?: {
    debug?: boolean;
}): {
    install(app: App): void;
};
/**
 * Access the TabSync instance from provided context.
 *
 * @example
 * const sync = useTabSyncContext();
 * sync.set('theme', 'dark');
 */
export declare function useTabSyncContext(): TabSync;
/**
 * Two-way reactive state synced across tabs.
 * Mutating the ref broadcasts the change; changes from other tabs update the ref.
 *
 * @example
 * const theme = useTabSync('theme', 'light');
 * theme.value = 'dark'; // syncs to all tabs
 *
 * @example
 * // With side effect callback
 * const cart = useTabSync('cart', { items: [] }, (cart) => {
 *   document.title = `Cart (${cart.items.length})`;
 * });
 * cart.value = { items: [...cart.value.items, newItem] };
 *
 * @example
 * // Form draft synced across tabs
 * const draft = useTabSync('email-draft', '');
 * // <textarea v-model="draft" />
 */
export declare function useTabSync<T>(key: string, initialValue: T, callback?: (value: T) => void): Ref<T>;
/**
 * Read-only subscription to a synced key. Returns undefined until first set.
 *
 * @example
 * const theme = useTabSyncValue<string>('theme');
 * // <div :class="theme === 'dark' ? 'dark' : 'light'" />
 */
export declare function useTabSyncValue<T>(key: string): Ref<T | undefined>;
/**
 * Fire-and-forget listener for a synced key. No ref, no return value.
 *
 * @example
 * useTabSyncCallback<string>('theme', (theme) => {
 *   document.documentElement.setAttribute('data-theme', theme);
 * });
 */
export declare function useTabSyncCallback<T>(key: string, callback: (value: T) => void): void;