/**
 * @file TopNavMegaMenuItem.tsx
 * @input Uses React, StyleX, theme tokens, navItemStyles, TopNavRenderContext
 * @output Exports TopNavMegaMenuItem component and props
 * @position Individual item inside an TopNavMegaMenu — renders itself in both
 *   desktop (popover) and mobile drawer modes.
 *
 * SYNC: When modified, update these files to stay in sync:
 * - /packages/core/src/TopNav/TopNav.doc.mjs
 * - /packages/core/src/TopNav/index.ts
 * - /packages/cli/assets/templates/blocks/components/TopNav/ (showcase blocks)
 */
import React, { type ReactNode } from 'react';
import type { LinkComponentType } from '../Link/types';
import type { BaseProps } from '../BaseProps';
export interface TopNavMegaMenuItemProps extends Omit<BaseProps<HTMLElement>, 'onClick'> {
    ref?: React.Ref<HTMLElement>;
    /** Display title for the menu item. */
    title: string;
    /** Optional description text displayed below the title. */
    description?: string;
    /** Optional icon element displayed to the left. */
    icon?: ReactNode;
    /** URL to navigate to when clicked. */
    href?: string;
    /** Callback when item is clicked. */
    onClick?: () => void;
    /**
     * Custom component to render instead of `<a>` for link items.
     * Overrides the provider-level default set by LinkProvider.
     */
    as?: LinkComponentType;
}
/**
 * An individual item inside an TopNavMegaMenu.
 *
 * Renders itself in both desktop (popover grid) and mobile drawer modes
 * using TopNavRenderContext to switch appearance.
 *
 * @example
 * ```
 * <TopNavMegaMenu
 *   label="Products"
 *   items={
 *     <>
 *       <TopNavMegaMenuItem
 *         title="Analytics"
 *         description="Track and analyze user behavior"
 *         icon={<ChartIcon />}
 *         href="/analytics"
 *       />
 *       <TopNavMegaMenuItem title="Reports" href="/reports" />
 *     </>
 *   }
 * />
 * ```
 */
export declare function TopNavMegaMenuItem({ ref, title, description, icon, href, onClick, as, tabIndex, }: TopNavMegaMenuItemProps): React.JSX.Element;
export declare namespace TopNavMegaMenuItem {
    var displayName: string;
}
//# sourceMappingURL=TopNavMegaMenuItem.d.ts.map