@neynar/ui 0.3.1 → 0.5.0

package/dist/components/ui/navigation-menu.d.ts

@@ -1,635 +1,52 @@
-import * as React from "react";
-import * as NavigationMenuPrimitive from "@radix-ui/react-navigation-menu";
+import { NavigationMenu as NavigationMenuPrimitive } from '@base-ui/react/navigation-menu';
+type NavigationMenuProps = NavigationMenuPrimitive.Root.Props;
 /**
- * NavigationMenu - A collection of links for navigating websites
- *
- * A flexible navigation component built on Radix UI primitives that provides
- * sophisticated navigation patterns with dropdown content support. Features full
- * keyboard navigation, accessibility compliance, controlled/uncontrolled states,
- * and responsive design. Supports both horizontal and vertical orientations.
- *
- * @example
- * ```tsx
- * // Basic navigation with dropdown
- * <NavigationMenu>
- *   <NavigationMenuList>
- *     <NavigationMenuItem value="products">
- *       <NavigationMenuTrigger>Products</NavigationMenuTrigger>
- *       <NavigationMenuContent>
- *         <div className="grid gap-3 p-6 w-[400px]">
- *           <NavigationMenuLink href="/products/analytics">Analytics</NavigationMenuLink>
- *           <NavigationMenuLink href="/products/dashboard">Dashboard</NavigationMenuLink>
- *         </div>
- *       </NavigationMenuContent>
- *     </NavigationMenuItem>
- *   </NavigationMenuList>
- * </NavigationMenu>
- * ```
- *
- * @example
- * ```tsx
- * // Controlled navigation with state
- * const [value, setValue] = React.useState<string | undefined>();
- *
- * <NavigationMenu value={value} onValueChange={setValue}>
- *   <NavigationMenuList>
- *     <NavigationMenuItem value="features">
- *       <NavigationMenuTrigger>Features</NavigationMenuTrigger>
- *       <NavigationMenuContent>
- *         <NavigationMenuLink href="/features">All Features</NavigationMenuLink>
- *       </NavigationMenuContent>
- *     </NavigationMenuItem>
- *   </NavigationMenuList>
- * </NavigationMenu>
- * ```
- *
- * @example
- * ```tsx
- * // Simple navigation links without dropdowns
- * <NavigationMenu>
- *   <NavigationMenuList>
- *     <NavigationMenuItem>
- *       <NavigationMenuLink href="/about" className={navigationMenuTriggerStyle()}>
- *         About
- *       </NavigationMenuLink>
- *     </NavigationMenuItem>
- *     <NavigationMenuItem>
- *       <NavigationMenuLink href="/contact" className={navigationMenuTriggerStyle()}>
- *         Contact
- *       </NavigationMenuLink>
- *     </NavigationMenuItem>
- *   </NavigationMenuList>
- * </NavigationMenu>
- * ```
- *
- * @example
- * ```tsx
- * // With Next.js Link integration using asChild
- * <NavigationMenu>
- *   <NavigationMenuList>
- *     <NavigationMenuItem>
- *       <NavigationMenuLink asChild className={navigationMenuTriggerStyle()}>
- *         <Link href="/dashboard">Dashboard</Link>
- *       </NavigationMenuLink>
- *     </NavigationMenuItem>
- *   </NavigationMenuList>
- * </NavigationMenu>
- * ```
- *
- * @example
- * ```tsx
- * // Vertical navigation menu
- * <NavigationMenu orientation="vertical">
- *   <NavigationMenuList>
- *     <NavigationMenuItem value="settings">
- *       <NavigationMenuTrigger>Settings</NavigationMenuTrigger>
- *       <NavigationMenuContent>
- *         <div className="p-4 w-[200px]">
- *           <NavigationMenuLink href="/settings/profile">Profile</NavigationMenuLink>
- *           <NavigationMenuLink href="/settings/account">Account</NavigationMenuLink>
- *         </div>
- *       </NavigationMenuContent>
- *     </NavigationMenuItem>
- *   </NavigationMenuList>
- * </NavigationMenu>
- * ```
- *
- * @example
- * ```tsx
- * // Without viewport for custom dropdown styling
- * <NavigationMenu viewport={false}>
- *   <NavigationMenuList>
- *     <NavigationMenuItem value="docs">
- *       <NavigationMenuTrigger>Documentation</NavigationMenuTrigger>
- *       <NavigationMenuContent>
- *         <div className="bg-white border rounded-lg shadow-lg p-6 w-[500px]">
- *           <NavigationMenuLink href="/docs/getting-started">Getting Started</NavigationMenuLink>
- *         </div>
- *       </NavigationMenuContent>
- *     </NavigationMenuItem>
- *   </NavigationMenuList>
- * </NavigationMenu>
- * ```
- *
- * @example
- * ```tsx
- * // With custom timing and active indicator
- * <NavigationMenu
- *   delayDuration={100}
- *   skipDelayDuration={200}
- *   defaultValue="home"
- * >
- *   <NavigationMenuList>
- *     <NavigationMenuItem value="home">
- *       <NavigationMenuTrigger>Home</NavigationMenuTrigger>
- *       <NavigationMenuContent>
- *         <NavigationMenuLink href="/">Homepage</NavigationMenuLink>
- *       </NavigationMenuContent>
- *     </NavigationMenuItem>
- *     <NavigationMenuIndicator />
- *   </NavigationMenuList>
- * </NavigationMenu>
- * ```
- *
- * @accessibility
- * - Full keyboard navigation with arrow keys for horizontal/vertical menu traversal
- * - Tab key moves between focusable menu items and maintains logical tab sequence
- * - Escape key closes open dropdown menus and returns focus to trigger
- * - Enter and Space keys activate triggers and follow links
- * - Home/End keys jump to first/last menu items
- * - ARIA expanded/collapsed states automatically managed for triggers
- * - ARIA current="page" support through active prop on links
- * - Focus management with automatic focus trapping in dropdown content
- * - Screen reader announcements for state changes and navigation
- * - Semantic HTML nav structure for navigation landmarks
- * - Proper ARIA labeling and relationships between triggers and content
- *
- * @see {@link NavigationMenuList} Container for menu items
- * @see {@link NavigationMenuItem} Individual menu item wrapper
- * @see {@link NavigationMenuTrigger} Dropdown trigger button
- * @see {@link NavigationMenuContent} Dropdown content panel
- * @see {@link NavigationMenuLink} Navigation link component
- * @see {@link https://ui.shadcn.com/docs/components/navigation-menu} shadcn/ui Navigation Menu
- * @see {@link https://www.radix-ui.com/primitives/docs/components/navigation-menu} Radix UI Navigation Menu
- * @since 1.0.0
+ * Root container for horizontal navigation with mega menu support.
+ * Manages active state and provides keyboard navigation.
  */
-declare function NavigationMenu({ className, children, viewport, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Root> & {
-    /** Whether to render the navigation viewport container for dropdown content positioning. @default true */
-    viewport?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
+declare function NavigationMenu({ className, children, ...props }: NavigationMenuProps): import("react/jsx-runtime").JSX.Element;
+type NavigationMenuListProps = NavigationMenuPrimitive.List.Props;
 /**
- * NavigationMenuList - Container for navigation menu items
- *
- * The list container that groups NavigationMenuItem components within a NavigationMenu.
- * Renders as an unordered list (ul) by default and provides the foundational layout
- * structure for the navigation menu. Supports both horizontal and vertical orientations
- * based on the parent NavigationMenu orientation prop.
- *
- * @example
- * ```tsx
- * <NavigationMenuList>
- *   <NavigationMenuItem value="products">
- *     <NavigationMenuTrigger>Products</NavigationMenuTrigger>
- *     <NavigationMenuContent>
- *       <NavigationMenuLink href="/products">All Products</NavigationMenuLink>
- *     </NavigationMenuContent>
- *   </NavigationMenuItem>
- *   <NavigationMenuItem>
- *     <NavigationMenuLink href="/about" className={navigationMenuTriggerStyle()}>
- *       About
- *     </NavigationMenuLink>
- *   </NavigationMenuItem>
- * </NavigationMenuList>
- * ```
- *
- * @example
- * ```tsx
- * // Custom list element using asChild
- * <NavigationMenuList asChild>
- *   <div className="custom-nav-container">
- *     <NavigationMenuItem>
- *       <NavigationMenuLink href="/home">Home</NavigationMenuLink>
- *     </NavigationMenuItem>
- *   </div>
- * </NavigationMenuList>
- * ```
- *
- * @accessibility
- * - Renders as semantic ul element by default for proper list structure
- * - Maintains proper ARIA relationships with contained NavigationMenuItem elements
- * - Supports keyboard navigation between contained items
- *
- * @see {@link NavigationMenuItem} Individual menu item containers
- * @see {@link NavigationMenu} Parent navigation menu component
- * @since 1.0.0
+ * Container for navigation menu items. Renders as a horizontal list.
  */
-declare function NavigationMenuList({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.List>): import("react/jsx-runtime").JSX.Element;
+declare function NavigationMenuList({ className, ...props }: NavigationMenuListProps): import("react/jsx-runtime").JSX.Element;
+type NavigationMenuItemProps = NavigationMenuPrimitive.Item.Props;
 /**
- * NavigationMenuItem - Individual navigation menu item container
- *
- * A list item container that wraps a single navigation element within a NavigationMenuList.
- * Each item can contain either a NavigationMenuTrigger with NavigationMenuContent for dropdown
- * functionality, or a NavigationMenuLink for direct navigation. The value prop is used for
- * controlled state management and active item tracking.
- *
- * @example
- * ```tsx
- * // Dropdown navigation item with controlled value
- * <NavigationMenuItem value="products">
- *   <NavigationMenuTrigger>Products</NavigationMenuTrigger>
- *   <NavigationMenuContent>
- *     <div className="grid gap-3 p-6 w-[400px] grid-cols-2">
- *       <NavigationMenuLink href="/products/analytics">Analytics</NavigationMenuLink>
- *       <NavigationMenuLink href="/products/dashboard">Dashboard</NavigationMenuLink>
- *     </div>
- *   </NavigationMenuContent>
- * </NavigationMenuItem>
- * ```
- *
- * @example
- * ```tsx
- * // Simple navigation link item
- * <NavigationMenuItem>
- *   <NavigationMenuLink href="/contact" className={navigationMenuTriggerStyle()}>
- *     Contact Us
- *   </NavigationMenuLink>
- * </NavigationMenuItem>
- * ```
- *
- * @example
- * ```tsx
- * // With custom container element using asChild
- * <NavigationMenuItem asChild>
- *   <div className="custom-menu-item">
- *     <NavigationMenuLink href="/about">About</NavigationMenuLink>
- *   </div>
- * </NavigationMenuItem>
- * ```
- *
- * @accessibility
- * - Renders as semantic li element by default for proper list item structure
- * - Associates with parent NavigationMenu state through value prop
- * - Maintains focus management within navigation sequences
- * - Supports both direct links and trigger/content dropdown patterns
- *
- * @see {@link NavigationMenuTrigger} Dropdown trigger button
- * @see {@link NavigationMenuContent} Dropdown content panel
- * @see {@link NavigationMenuLink} Navigation link component
- * @see {@link NavigationMenuList} Parent list container
- * @since 1.0.0
+ * Individual navigation item. Can contain a Link or Trigger + Content.
+ * Use `value` prop to identify the item for controlled state.
  */
-declare function NavigationMenuItem({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Item>): import("react/jsx-runtime").JSX.Element;
+declare function NavigationMenuItem({ className, ...props }: NavigationMenuItemProps): import("react/jsx-runtime").JSX.Element;
+declare const navigationMenuTriggerStyle: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+type NavigationMenuTriggerProps = NavigationMenuPrimitive.Trigger.Props;
 /**
- * Navigation menu trigger styling configuration using CVA (Class Variance Authority)
- *
- * Provides consistent button styling for navigation triggers with interactive states.
- * Can be applied to NavigationMenuLink components for uniform trigger-style appearance.
- *
- * @variant base - Default trigger button styling with hover, focus, and disabled states
- * - Interactive states: hover (accent background), focus (accent + ring), disabled (opacity + pointer-events)
- * - Open state: Special styling when dropdown is open (accent background with opacity)
- * - Focus visible: Ring indicator for keyboard navigation accessibility
- *
- * @example
- * ```tsx
- * // Apply to NavigationMenuLink for consistent button styling
- * <NavigationMenuLink href="/docs" className={navigationMenuTriggerStyle()}>
- *   Documentation
- * </NavigationMenuLink>
- * ```
- *
- * @see {@link NavigationMenuTrigger} Uses this styling automatically
- * @see {@link NavigationMenuLink} Can use this for consistent trigger appearance
+ * Button that opens the associated NavigationMenuContent panel.
+ * Automatically includes a rotating chevron icon.
  */
-declare const navigationMenuTriggerStyle: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
+declare function NavigationMenuTrigger({ className, children, ...props }: NavigationMenuTriggerProps): import("react/jsx-runtime").JSX.Element;
+type NavigationMenuContentProps = NavigationMenuPrimitive.Content.Props;
 /**
- * NavigationMenuTrigger - Interactive button that opens dropdown navigation content
- *
- * A button component that toggles NavigationMenuContent visibility when activated.
- * Automatically includes a chevron down icon that rotates when the dropdown is open.
- * Features comprehensive keyboard and mouse interaction support with proper ARIA
- * state management. The asChild prop allows composition with custom button components.
- *
- * @example
- * ```tsx
- * // Basic trigger with dropdown content
- * <NavigationMenuItem value="products">
- *   <NavigationMenuTrigger>Products</NavigationMenuTrigger>
- *   <NavigationMenuContent>
- *     <div className="p-6 w-[400px]">
- *       <NavigationMenuLink href="/products/analytics">Analytics</NavigationMenuLink>
- *       <NavigationMenuLink href="/products/dashboard">Dashboard</NavigationMenuLink>
- *     </div>
- *   </NavigationMenuContent>
- * </NavigationMenuItem>
- * ```
- *
- * @example
- * ```tsx
- * // Custom trigger styling with asChild
- * <NavigationMenuTrigger asChild>
- *   <Button variant="outline" size="lg">
- *     Custom Features Button
- *   </Button>
- * </NavigationMenuTrigger>
- * ```
- *
- * @example
- * ```tsx
- * // Trigger with additional icons
- * <NavigationMenuTrigger className="gap-2">
- *   <StarIcon className="size-4" />
- *   Featured Items
- * </NavigationMenuTrigger>
- * ```
- *
- * @accessibility
- * - Automatic ARIA expanded state management (expanded="true/false")
- * - Button role with proper keyboard activation (Enter/Space keys)
- * - Focus visible ring indicator for keyboard navigation
- * - Screen reader accessible button semantics and state announcements
- * - Disabled state handling with pointer-events and opacity
- * - Chevron icon marked as aria-hidden for screen reader exclusion
- *
- * @see {@link NavigationMenuContent} Content panel this trigger controls
- * @see {@link NavigationMenuItem} Required parent container
- * @see {@link navigationMenuTriggerStyle} Styling function used internally
- * @since 1.0.0
+ * Content panel for mega menus. Opened by NavigationMenuTrigger.
+ * Automatically renders in a positioned popup with smooth transitions.
  */
-declare function NavigationMenuTrigger({ className, children, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+declare function NavigationMenuContent({ className, ...props }: NavigationMenuContentProps): import("react/jsx-runtime").JSX.Element;
+type NavigationMenuPositionerProps = NavigationMenuPrimitive.Positioner.Props;
 /**
- * NavigationMenuContent - Dropdown content panel for navigation items
- *
- * The collapsible content container that appears when a NavigationMenuTrigger is activated.
- * Supports smooth enter/exit animations, flexible positioning (with or without viewport),
- * and comprehensive interaction handling. The content automatically manages focus and
- * provides multiple ways to dismiss the dropdown (Escape key, outside clicks, etc.).
- *
- * @example
- * ```tsx
- * // Grid layout with navigation links
- * <NavigationMenuContent>
- *   <div className="grid gap-3 p-6 w-[500px] grid-cols-2">
- *     <NavigationMenuLink href="/products/analytics">
- *       <div className="text-sm font-medium">Analytics</div>
- *       <p className="text-sm text-muted-foreground">Track your performance</p>
- *     </NavigationMenuLink>
- *     <NavigationMenuLink href="/products/dashboard">
- *       <div className="text-sm font-medium">Dashboard</div>
- *       <p className="text-sm text-muted-foreground">Manage your data</p>
- *     </NavigationMenuLink>
- *   </div>
- * </NavigationMenuContent>
- * ```
- *
- * @example
- * ```tsx
- * // Complex multi-column layout
- * <NavigationMenuContent>
- *   <div className="grid gap-6 p-8 w-[800px] grid-cols-3">
- *     <div className="space-y-2">
- *       <h4 className="text-sm font-medium">Features</h4>
- *       <NavigationMenuLink href="/features/auth">Authentication</NavigationMenuLink>
- *       <NavigationMenuLink href="/features/api">API Management</NavigationMenuLink>
- *     </div>
- *     <div className="space-y-2">
- *       <h4 className="text-sm font-medium">Tools</h4>
- *       <NavigationMenuLink href="/tools/cli">Command Line</NavigationMenuLink>
- *       <NavigationMenuLink href="/tools/sdk">SDK</NavigationMenuLink>
- *     </div>
- *   </div>
- * </NavigationMenuContent>
- * ```
- *
- * @example
- * ```tsx
- * // With custom interaction handlers
- * <NavigationMenuContent
- *   onEscapeKeyDown={(e) => {
- *     console.log('Escape pressed');
- *     // Don't prevent default to allow normal closing behavior
- *   }}
- *   onPointerDownOutside={(e) => {
- *     console.log('Clicked outside');
- *     // e.preventDefault() would prevent closing
- *   }}
- * >
- *   <div className="p-6 w-[300px]">
- *     <NavigationMenuLink href="/help">Help Center</NavigationMenuLink>
- *   </div>
- * </NavigationMenuContent>
- * ```
- *
- * @example
- * ```tsx
- * // Force mounted for animation control
- * <NavigationMenuContent forceMount>
- *   <div className="p-4 w-[250px] animate-in slide-in-from-top">
- *     <NavigationMenuLink href="/docs">Documentation</NavigationMenuLink>
- *   </div>
- * </NavigationMenuContent>
- * ```
- *
- * @accessibility
- * - Automatic focus management when content opens and closes
- * - Escape key support for dismissing dropdown (can be customized via onEscapeKeyDown)
- * - Outside interaction handling for dismissing (clicks and focus outside)
- * - Proper ARIA relationships with trigger button
- * - Content is accessible via keyboard navigation within the dropdown
- * - Screen reader announcements for state changes
- *
- * @see {@link NavigationMenuTrigger} Button that controls this content
- * @see {@link NavigationMenuLink} Links typically used within content
- * @see {@link NavigationMenuViewport} Viewport container for positioning
- * @since 1.0.0
+ * Portal container for positioning content panels.
+ * Automatically included in NavigationMenu - do not use directly.
+ * @internal
  */
-declare function NavigationMenuContent({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+declare function NavigationMenuPositioner({ className, side, sideOffset, align, alignOffset, ...props }: NavigationMenuPositionerProps): import("react/jsx-runtime").JSX.Element;
+type NavigationMenuLinkProps = NavigationMenuPrimitive.Link.Props;
 /**
- * NavigationMenuViewport - Positioned container for dropdown content
- *
- * The viewport container that manages positioning, sizing, and animation of NavigationMenuContent
- * panels. It automatically calculates dimensions based on content size and provides smooth
- * enter/exit animations. The viewport uses CSS custom properties for dynamic sizing and
- * positioning. Only rendered when the viewport prop is true (default) on NavigationMenu.
- *
- * @example
- * ```tsx
- * // Typically used automatically by NavigationMenu
- * <NavigationMenu>
- *   <NavigationMenuList>
- *     // menu items
- *   </NavigationMenuList>
- *   // NavigationMenuViewport is rendered automatically
- * </NavigationMenu>
- * ```
- *
- * @example
- * ```tsx
- * // Custom viewport styling
- * <NavigationMenuViewport className="border-2 border-primary shadow-xl" />
- * ```
- *
- * @example
- * ```tsx
- * // Force mounted viewport for animation control
- * <NavigationMenuViewport forceMount className="custom-animation" />
- * ```
- *
- * @accessibility
- * - Handles focus containment for dropdown content within the viewport
- * - Manages viewport size announcements for screen readers
- * - Provides proper z-index layering for dropdown content
- * - Maintains content visibility and accessibility during animations
- *
- * @see {@link NavigationMenu} Parent component that controls viewport rendering
- * @see {@link NavigationMenuContent} Content rendered within this viewport
- * @since 1.0.0
+ * Navigation link for direct navigation items or links within content panels.
+ * Use `active` prop to highlight the current page.
  */
-declare function NavigationMenuViewport({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Viewport>): import("react/jsx-runtime").JSX.Element;
+declare function NavigationMenuLink({ className, ...props }: NavigationMenuLinkProps): import("react/jsx-runtime").JSX.Element;
+type NavigationMenuIndicatorProps = NavigationMenuPrimitive.Icon.Props;
 /**
- * NavigationMenuLink - Styled link component for navigation menus
- *
- * A versatile link component designed specifically for navigation menus with comprehensive
- * styling and state management. Supports active states, hover/focus effects, and seamless
- * framework integration through the asChild pattern. Can be used both within dropdown
- * content and as direct navigation items. Features proper keyboard navigation and
- * accessibility support.
- *
- * @example
- * ```tsx
- * // Basic navigation link
- * <NavigationMenuLink href="/about">About Us</NavigationMenuLink>
- * ```
- *
- * @example
- * ```tsx
- * // Active link with current page styling
- * <NavigationMenuLink href="/dashboard" active>
- *   Dashboard
- * </NavigationMenuLink>
- * ```
- *
- * @example
- * ```tsx
- * // Rich content link in dropdown with description
- * <NavigationMenuLink href="/features/analytics">
- *   <div className="text-sm font-medium leading-none">Analytics</div>
- *   <p className="text-sm text-muted-foreground mt-1">
- *     View detailed insights and performance metrics
- *   </p>
- * </NavigationMenuLink>
- * ```
- *
- * @example
- * ```tsx
- * // With Next.js Link using asChild pattern
- * <NavigationMenuLink asChild>
- *   <Link href="/products" prefetch={false}>
- *     Products
- *   </Link>
- * </NavigationMenuLink>
- * ```
- *
- * @example
- * ```tsx
- * // With Remix Link using asChild pattern
- * <NavigationMenuLink asChild>
- *   <RemixLink to="/docs" prefetch="intent">
- *     Documentation
- *   </RemixLink>
- * </NavigationMenuLink>
- * ```
- *
- * @example
- * ```tsx
- * // Direct navigation with trigger button styling
- * <NavigationMenuLink
- *   href="/contact"
- *   className={navigationMenuTriggerStyle()}
- * >
- *   Contact Us
- * </NavigationMenuLink>
- * ```
- *
- * @example
- * ```tsx
- * // With custom selection handler
- * <NavigationMenuLink
- *   href="/logout"
- *   onSelect={(event) => {
- *     event.preventDefault();
- *     handleLogout();
- *   }}
- * >
- *   Sign Out
- * </NavigationMenuLink>
- * ```
- *
- * @example
- * ```tsx
- * // External link with icon
- * <NavigationMenuLink href="https://github.com" target="_blank" rel="noopener">
- *   <GitHubIcon className="size-4" />
- *   GitHub
- *   <ExternalLinkIcon className="size-3 ml-auto" />
- * </NavigationMenuLink>
- * ```
- *
- * @accessibility
- * - Focus visible ring indicator for keyboard navigation (3px ring with outline)
- * - Active state styling with proper contrast for current page indication
- * - Proper link semantics and ARIA attributes (including aria-current when active)
- * - Keyboard activation support (Enter key) and tab navigation
- * - Screen reader compatible text content and descriptions
- * - Icon sizing and color inheritance for consistent visual hierarchy
- * - External link indicators and proper rel attributes for security
- *
- * @see {@link NavigationMenuContent} Content container where links are often used
- * @see {@link NavigationMenuItem} Item container for direct navigation links
- * @see {@link navigationMenuTriggerStyle} Styling function for button-like appearance
- * @since 1.0.0
+ * Visual indicator (arrow) that shows which item is active.
+ * Optional - not commonly used in modern designs.
  */
-declare function NavigationMenuLink({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Link>): import("react/jsx-runtime").JSX.Element;
-/**
- * NavigationMenuIndicator - Animated visual indicator for active menu items
- *
- * An optional visual indicator that displays an animated arrow pointing to the currently
- * active or focused navigation menu item. Automatically transitions between positions as
- * users navigate through menu items, providing clear visual feedback about the current
- * selection. The indicator appears below the active item and includes smooth fade and
- * position animations.
- *
- * @example
- * ```tsx
- * // Basic usage within NavigationMenuList
- * <NavigationMenuList>
- *   <NavigationMenuItem value="home">
- *     <NavigationMenuTrigger>Home</NavigationMenuTrigger>
- *     <NavigationMenuContent>
- *       <NavigationMenuLink href="/">Homepage</NavigationMenuLink>
- *     </NavigationMenuContent>
- *   </NavigationMenuItem>
- *   <NavigationMenuItem value="about">
- *     <NavigationMenuTrigger>About</NavigationMenuTrigger>
- *     <NavigationMenuContent>
- *       <NavigationMenuLink href="/about">About Us</NavigationMenuLink>
- *     </NavigationMenuContent>
- *   </NavigationMenuItem>
- *   <NavigationMenuIndicator className="data-[state=visible]:bg-primary" />
- * </NavigationMenuList>
- * ```
- *
- * @example
- * ```tsx
- * // Custom styled indicator
- * <NavigationMenuIndicator className="
- *   data-[state=visible]:animate-pulse
- *   data-[state=visible]:bg-gradient-to-r
- *   data-[state=visible]:from-blue-500
- *   data-[state=visible]:to-purple-500
- * " />
- * ```
- *
- * @example
- * ```tsx
- * // Force mounted indicator for custom animations
- * <NavigationMenuIndicator
- *   forceMount
- *   className="custom-indicator-animation"
- * />
- * ```
- *
- * @accessibility
- * - Purely decorative visual element that enhances UX
- * - Does not interfere with keyboard or screen reader navigation
- * - Arrow element is properly hidden from assistive technologies
- * - Does not affect focus management or navigation behavior
- * - Provides visual feedback that complements accessible navigation patterns
- *
- * @see {@link NavigationMenuList} Container where indicator is typically placed
- * @see {@link NavigationMenuItem} Items that the indicator highlights
- * @since 1.0.0
- */
-declare function NavigationMenuIndicator({ className, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Indicator>): import("react/jsx-runtime").JSX.Element;
-export { NavigationMenu, NavigationMenuList, NavigationMenuItem, NavigationMenuContent, NavigationMenuTrigger, NavigationMenuLink, NavigationMenuIndicator, NavigationMenuViewport, navigationMenuTriggerStyle, };
+declare function NavigationMenuIndicator({ className, ...props }: NavigationMenuIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export { NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, navigationMenuTriggerStyle, NavigationMenuPositioner, type NavigationMenuProps, type NavigationMenuContentProps, type NavigationMenuIndicatorProps, type NavigationMenuItemProps, type NavigationMenuLinkProps, type NavigationMenuListProps, type NavigationMenuTriggerProps, type NavigationMenuPositionerProps, };
 //# sourceMappingURL=navigation-menu.d.ts.map