
import { UniversalIconButtonProps } from "../../tokens/types.js";
import "../../tokens/index.js";
import * as react from "react";
import { HTMLMotionProps } from "motion/react";

//#region src/components/client/IconButton.d.ts
type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'> & Omit<HTMLMotionProps<'button'>, 'name'>;
interface IconButtonProps extends HtmlButtonProps, UniversalIconButtonProps {}
/**
 * **⚙️️ An icon button element that can be used to trigger an action**
 *
 * @componentType Client component
 *
 * @description An icon button is essentially an interactive icon. They should be used to display an icon which, when clicked, allows the user to trigger an action. Icon buttons provide additional features such hover states, focus states, and pressable functionality.
 *
 * @see
 * Check out the {@link https://uds.build/docs/components/icon-button IconButton Docs} for more info
 *
 * @usage
 * - When you need a button that is represented by an icon rather than text. This is useful in compact spaces, toolbars, or when the action is commonly understood through a visual symbol.
 * - If you need a button that is used to trigger a non-critical action.
 *
 * @example
 * ```tsx
 * 'use client';
 * import { IconButton } from "@yahoo/uds";
 * import { AddFolder } from "@yahoo/uds-icons";
 *
 * <IconButton name={AddFolder} variant="primary" />
 * ```
 *
 * @related [Icon](https://uds.build/docs/components/icon), [Button](https://uds.build/docs/components/button), and [Pressable](https://uds.build/docs/components/pressable)
 *
 **/
declare const IconButton: react.ForwardRefExoticComponent<Omit<IconButtonProps, "ref"> & react.RefAttributes<HTMLButtonElement>>;
//#endregion
export { IconButton, type IconButtonProps };