import { ComponentPropsWithoutRef, ElementType, ReactNode } from 'react';
import { MediumSystemIconName, SmallSystemIconName } from '../../DataDisplays/SystemIcon';
import { IconButtonDropdownItem } from '../../Inputs';
/**
 * `MenuLink`와 `MenuButton`이 공유하는 presentation props.
 *
 * - 시맨틱 분기(`href` vs `onClick`)는 각 컴포넌트의 별도 타입으로 표현되며,
 *   이 타입에는 포함되지 않습니다.
 */
export interface MenuCommonProps {
    type?: 'main' | 'sub';
    variant?: 'white' | 'gray';
    name: string;
    badgeCount?: string;
    isSelected?: boolean;
    leadingIcon?: MediumSystemIconName;
    iconButtonName?: SmallSystemIconName;
    onOptionClick?: () => void;
    children?: ReactNode;
    items?: IconButtonDropdownItem[];
    selectedItem?: IconButtonDropdownItem;
    onItemClick?: (item: IconButtonDropdownItem) => void;
}
/**
 * `MenuLink`의 props.
 *
 * - `href`가 필수이며, 기본 anchor(`<a>`) 또는 `as`로 주입된 컴포넌트로 렌더링됩니다.
 * - anchor 관련 native 속성(`target`, `rel`, `download` 등)을 그대로 받습니다.
 * - `as`로 컴포넌트를 주입하면 해당 컴포넌트의 전용 props(예: `next/link`의 `prefetch`)도 타입 추론됩니다.
 */
export type MenuLinkProps<T extends ElementType = 'a'> = MenuCommonProps & {
    href: string;
    /**
     * anchor 자리에 렌더할 컴포넌트. 기본값은 일반 `<a>` 태그이며,
     * Next.js의 Link 등을 주입할 수 있습니다.
     */
    as?: T;
} & Omit<ComponentPropsWithoutRef<T>, 'href' | 'className' | 'children' | 'as' | keyof MenuCommonProps>;
/**
 * `MenuButton`의 props.
 *
 * - `onClick`이 필수이며, 항상 `<button>`으로 렌더링됩니다.
 * - button 관련 native 속성(`disabled`, `type` 등)을 그대로 받습니다.
 */
export type MenuButtonProps = MenuCommonProps & Omit<ComponentPropsWithoutRef<'button'>, 'onClick' | 'className' | 'children' | 'type'> & {
    onClick: () => void;
    /**
     * HTML `<button>`의 native `type` 속성. `MenuCommonProps.type`(`'main' | 'sub'`)과
     * 이름이 충돌하므로 별도 prop으로 전달하려면 `htmlType`을 사용하세요.
     *
     * 디자인 시스템의 메뉴 타입(`'main' | 'sub'`)은 `MenuCommonProps`의 `type`을 그대로 사용합니다.
     */
    htmlType?: 'button' | 'submit' | 'reset';
};