import { type ForwardRefExoticComponent, type ReactNode, type RefAttributes } from 'react';
/**
 * Extra DOM/event props are passed through to the cloned child.
 */
export type TSlotProps = {
    children: ReactNode;
} & Record<string, unknown>;
/**
 * Merges props (including ref) onto a single React element child.
 *
 * A safer alternative to raw `cloneElement` that:
 * 1. Guards with `isValidElement` - non-element children (strings,
 *    fragments, null) are returned as-is instead of crashing.
 * 2. Merges refs via `mergeRefs` so both the caller's ref and the
 *    child's existing ref are honoured.
 * 3. Spreads any additional props (ARIA attributes, event handlers, etc.)
 *    onto the child element.
 *
 * Event handlers (e.g. `onClick`) are **not** auto-merged - the caller's
 * handler replaces the child's. Compose handlers before passing them in.
 *
 * @example
 * ```tsx
 * <Slot ref={triggerRef} onClick={handleClick} aria-expanded={isOpen}>
 *   <button>Open</button>
 * </Slot>
 * ```
 */
export declare const Slot: ForwardRefExoticComponent<TSlotProps & RefAttributes<HTMLElement>>;