/**
 * Return type for useTamboComponentState hook.
 * Similar to useState but with additional metadata.
 */
export type UseTamboComponentStateReturn<S> = [
    currentState: S,
    setState: (newState: S | ((prev: S) => S)) => void,
    meta: {
        isPending: boolean;
        error: Error | null;
        flush: () => void;
    }
];
/**
 * Hook for managing component state with bidirectional server sync.
 *
 * This hook acts like useState but automatically syncs state changes
 * to the Tambo backend. Server-side state updates are also reflected
 * in the component.
 *
 * Can be used within rendered components, interactable components, or
 * components awaiting provider context (acts as plain useState until context is available).
 * @param keyName - The unique key to identify this state value within the component's state
 * @param initialValue - Initial value for the state (used if no server state exists)
 * @param debounceTime - Debounce time in milliseconds (default: 500ms)
 * @returns Tuple of [currentState, setState, meta]
 * @example
 * ```tsx
 * function Counter() {
 *   const [count, setCount, { isPending }] = useTamboComponentState('count', 0);
 *
 *   return (
 *     <div>
 *       <span>{count}</span>
 *       <button onClick={() => setCount(c => c + 1)} disabled={isPending}>
 *         Increment
 *       </button>
 *     </div>
 *   );
 * }
 * ```
 */
export declare function useTamboComponentState<S = undefined>(keyName: string, initialValue?: S, debounceTime?: number): UseTamboComponentStateReturn<S | undefined>;
export declare function useTamboComponentState<S>(keyName: string, initialValue: S, debounceTime?: number): UseTamboComponentStateReturn<S>;
//# sourceMappingURL=use-tambo-v1-component-state.d.ts.map