import { ForwardedRef } from 'react';
import { ZDSElement } from '../_shared/z-base';
import { CleanProps } from './customElement.helpers';
import { CustomElementProps, ExtractOnKeys } from './helpers.types';
/**
 * A custom hook that integrates a custom element with React, allowing for event handling and property mapping.
 *
 * @template T - The type of the props for the custom element.
 * @template H - The type of the custom element.
 * @template Omitted - The keys of the props to be omitted.
 *
 * @param {T} props - The properties to be passed to the custom element.
 * @param {ForwardedRef<H>} reference - A forwarded ref to the custom element.
 * @param {{ [K in keyof T]?: string } & { [K in ExtractOnKeys<T>]: string }} [customMapping={}] - An optional mapping of prop keys to event names.
 * @param {readonly Omitted[]} [slots] - An optional array of prop keys to be omitted.
 *
 * @returns {CleanProps<T, Omitted> & { ref: React.ForwardedRef<H>; }} The cleaned props with the forwarded ref.
 */
export declare function useCustomElementWithEvents<T extends CustomElementProps, H extends ZDSElement, Omitted extends keyof T>(props: T, reference: ForwardedRef<H>, customMapping: ({ [K in keyof T]?: string | undefined; } & { [K_1 in ExtractOnKeys<T>]: string; }) | undefined, slots: readonly Omitted[]): CleanProps<T, Omitted> & {
    ref: React.ForwardedRef<H>;
};