import type { ApolloCache, DefaultContext, FetchResult, MutationFunction, RefetchQueriesInclude } from '@apollo/client';
import type { TypedDocumentNode } from '@graphql-typed-document-node/core';
import type { Handler, SpreadHandler, VoidHandler } from '../../utils/types';
export interface CarbonMutationOptions<TResult, TVariables, TContext = DefaultContext> {
    variables?: TVariables;
    ignoreResults?: boolean;
    refetchQueries?: RefetchQueriesInclude;
    optimisticResponse?: Handler<TVariables, TResult>;
    update?: SpreadHandler<[
        response: ApolloCache<unknown>,
        result: Omit<FetchResult<TResult>, 'context'>
    ], void>;
    context?: TContext;
}
export interface CarbonMutationResult<TResult> {
    data?: TResult | null;
    error?: Error;
    loading: boolean;
    reset: VoidHandler;
}
export declare type UseCarbonMutationResult<TResult, TVariables, TContext = DefaultContext> = [
    MutationFunction<TResult, TVariables, TContext>,
    CarbonMutationResult<TResult>
];
/**
 * Executes a Carbon GraphQL query against the Source Experience API
 *
 * Internally, this method invokes Apollo's useQuery() hook, passing in the custom client
 * created for use by Carbon.
 *
 * @param document the document that should be generated
 * @param options the options for the document to generate
 * @returns results of executing the query
 */
export declare function useCarbonMutation<TResult, TVariables, TContext = DefaultContext>(document: TypedDocumentNode<TResult, TVariables>, options?: CarbonMutationOptions<TResult, TVariables, TContext>): UseCarbonMutationResult<TResult, TVariables, TContext>;