import type { ClipboardMode } from './types.js';
interface UseClipboardReturn {
    /**
     * polyfill native api (stable)
     */
    /**
     * Fallback on 'read' mode
     */
    read: () => Promise<ClipboardItems | null>;
    /**
     * Fallback on 'readText' mode
     */
    readText: () => Promise<string | null>;
    /**
     * Fallback on 'write' mode with blobs (get blob for each first type for each item) state
     */
    write: (data: ClipboardItems) => Promise<void>;
    /**
     * Fallback on 'writeText' mode with text state
     */
    writeText: (data: string) => Promise<void>;
    /**
     * custom helper (stable)
     */
    /**
     * use write but no need do to manually ClipboardItems transform
     * Fallback on 'writeText' mode with text state
     * @param data
     * @param type a mime type default to 'text/plain'
     */
    rawWriteWithType: (data: string, type?: 'text/html' | 'text/plain' | string) => Promise<void>;
    /**
     * state for alternative
     */
    /**
     * state to know if you need to display an alternative interface
     */
    shouldFallback: ClipboardMode | undefined;
    /**
     * state for 'writeText' / 'rawWriteWithType' mode fallback
     */
    text: string | undefined;
    /**
     * state for 'write' mode fallback
     */
    blobs: Blob[] | undefined;
    /**
     * method to clean up state for alternative interface (set shouldFallback to undefined, text to undefined and blobs to undefined)
     * stable
     */
    cleanShouldFallback: () => void;
}
/**
 * Give you a wrapped clipboard api and a shouldFallback state.
 * ignore if read and readText return promise filled with undefined, and rely on shouldFallback to display an alternative interaction.
 * You should use ClipboardFallback component
 *
 * @example
 * ```tsx
 *   const { readText, shouldFallback, setShouldFallback } = useClipboard();
 *
 *   function handlePasteAction() {
 *     // yes you can safely ignore error here,
 *     // readText() will never throw, error is caught and set shouldFallback to corresponding mode
 *     void readText().then(handlePaste);
 *   }
 *
 *   function handlePaste(text: string | undefined) {
 *     if (!text) return;
 *
 *     setState(text);
 *     setShouldFallback(null);
 *   }
 *
 *   return (
 *     <>
 *       <button onClick={handlePasteAction}>Paste</button>
 *       <ClipboardFallbackModal
 *         mode={shouldFallback}
 *         onDismiss={() => setShouldFallback(null)}
 *         onReadText={handlePaste}
 *       />
 *     </>
 *   )
 * ```
 */
export declare function useClipboard(): UseClipboardReturn;
export {};
//# sourceMappingURL=clipboardHooks.d.ts.map