/**
 * @file NavHeadingMenuItem.tsx
 * @input Uses React, StyleX, Icon, Text, NavMenuContext, useLinkComponent
 * @output Exports NavHeadingMenuItem component and NavHeadingMenuItemProps type
 * @position Core implementation; consumed by index.ts
 *
 * SYNC: When modified, update:
 * - /packages/core/src/NavMenu/index.ts
 */
import React, { type ReactNode } from 'react';
import { type IconType } from '../Icon';
import type { BaseProps } from '../BaseProps';
export interface NavHeadingMenuItemProps extends Omit<BaseProps<HTMLElement>, 'onClick'> {
    ref?: React.Ref<HTMLElement>;
    /** Icon to display before the label. */
    icon?: ReactNode | IconType;
    /** Primary label text. */
    label: ReactNode;
    /** Secondary description text displayed below the label. */
    description?: ReactNode;
    /** URL to navigate to. Renders as an anchor element when provided. */
    href?: string;
    /** Callback when the item is selected. */
    onClick?: () => void;
    /** Whether the item is disabled. @default false */
    isDisabled?: boolean;
}
/**
 * Menu item for nav heading popovers.
 *
 * Reads size from the parent NavHeadingMenu for consistent padding.
 * Automatically dismisses the menu on click via context.
 * Renders as a link when `href` is provided.
 *
 * @example
 * ```
 * <NavHeadingMenu>
 *   <NavHeadingMenuItem label="Dashboard" href="/dashboard" />
 *   <NavHeadingMenuItem label="Settings" icon={GearIcon} onClick={open} />
 * </NavHeadingMenu>
 * ```
 */
export declare function NavHeadingMenuItem({ ref, icon, label, description, href, onClick, isDisabled, xstyle, className, style, 'data-testid': testId, }: NavHeadingMenuItemProps): React.JSX.Element;
export declare namespace NavHeadingMenuItem {
    var displayName: string;
}
//# sourceMappingURL=NavHeadingMenuItem.d.ts.map