import { ComponentPropsWithoutRef } from 'react';
import { LayoutUtilProps } from '../../types';
/**
 * Props for the SideNav component
 * @extends ComponentPropsWithoutRef<"nav">
 * @extends LayoutUtilProps
 */
export type SideNavProps = ComponentPropsWithoutRef<"nav"> & LayoutUtilProps;
/**
 * Context props for the SideNav component
 */
export type SideNavContextProps = {
    /**
     * List of navigable elements in the side navigation
     */
    links: NodeListOf<Element> | undefined;
    /**
     * Function to recalculate the list of navigable links
     */
    reCalculateLinks: () => void;
    /**
     * Set of currently active link IDs
     */
    activeIds: Set<string>;
    /**
     * Function to add an ID to the active set
     */
    addActiveId: (id: string) => void;
    /**
     * Function to remove an ID from the active set
     */
    removeActiveId: (id: string) => void;
};
export declare const SideNavContext: import('react').Context<SideNavContextProps | null>;
/**
 * Custom hook for accessing the SideNav context.
 * @returns The SideNav context with links, activeIds, and utility functions
 * @throws Error if used outside of a SideNav component
 */
export declare const useSideNav: () => SideNavContextProps;
/**
 * SideNav component for creating hierarchical navigation menus.
 *
 * Features:
 * - Hierarchical navigation structure with links, groups, and collapsible sections
 * - Keyboard navigation support with arrow keys and focus management
 * - Active state tracking for current page/section
 * - Accessible with proper ARIA roles and labels
 * - Automatic link recalculation for dynamic content
 * - Context provider for child components
 * - Layout utility props for positioning and spacing
 *
 * @example
 * <SideNav>
 *   <SideNav.Group label="Getting Started">
 *     <SideNav.Link id="intro" href="/intro" active>
 *       Introduction
 *     </SideNav.Link>
 *     <SideNav.Link id="installation" href="/installation">
 *       Installation
 *     </SideNav.Link>
 *   </SideNav.Group>
 *   <SideNav.Collapsible label="Components">
 *     <SideNav.Link id="button" href="/components/button">
 *       Button
 *     </SideNav.Link>
 *     <SideNav.Link id="input" href="/components/input">
 *       Input
 *     </SideNav.Link>
 *   </SideNav.Collapsible>
 * </SideNav>
 */
export declare const SideNav: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & LayoutUtilProps & import('react').RefAttributes<HTMLElement>> & {
    /**
     * SideNavLink component for individual navigation links.
     *
     * Features:
     * - Individual navigation links with active state support
     * - Keyboard navigation integration with arrow keys
     * - Focus management and tabindex handling
     * - Accessible with proper ARIA attributes
     * - Click and keyboard event handling
     * - Disabled state support
     *
     * @example
     * <SideNav.Link id="intro" href="/intro" active>
     *   Introduction
     * </SideNav.Link>
     */
    Link: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref">, "id" | "onKeyDown" | "onKeyUp" | "onClick"> & {
        id: string;
        active?: boolean;
        disabled?: boolean;
        onClick?: (e: import('react').MouseEvent<HTMLAnchorElement>, id: import('./SideNavLink').SideNavLinkProps["id"]) => void;
        onKeyDown?: (e: import('react').KeyboardEvent<HTMLAnchorElement>, id: import('./SideNavLink').SideNavLinkProps["id"]) => void;
        onKeyUp?: (e: import('react').KeyboardEvent<HTMLAnchorElement>, id: import('./SideNavLink').SideNavLinkProps["id"]) => void;
    } & import('react').RefAttributes<HTMLLIElement>>;
    /**
     * SideNavCollapsible component for expandable navigation sections.
     *
     * Features:
     * - Expandable/collapsible navigation sections
     * - Controlled and uncontrolled expansion states
     * - Keyboard navigation with arrow keys for expansion
     * - Automatic expansion when child links are active
     * - Accessible with proper ARIA expanded states
     * - Visual indicators for active children
     *
     * @example
     * <SideNav.Collapsible label="Components">
     *   <SideNav.Link id="button" href="/components/button">
     *     Button
     *   </SideNav.Link>
     *   <SideNav.Link id="input" href="/components/input">
     *     Input
     *   </SideNav.Link>
     * </SideNav.Collapsible>
     */
    Collapsible: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref">, "onClick"> & {
        label: string;
        onClick?: ComponentPropsWithoutRef<"button">["onClick"];
        onKeyDown?: ComponentPropsWithoutRef<"button">["onKeyDown"];
        defaultExpanded?: boolean;
        expanded?: boolean;
    } & import('react').RefAttributes<HTMLLIElement>>;
    /**
     * SideNavGroup component for grouping related navigation links.
     *
     * Features:
     * - Groups related navigation links with labels
     * - Accessible with proper ARIA labeling
     * - Semantic grouping for screen readers
     * - Consistent styling and spacing
     *
     * @example
     * <SideNav.Group label="Getting Started">
     *   <SideNav.Link id="intro" href="/intro">
     *     Introduction
     *   </SideNav.Link>
     *   <SideNav.Link id="installation" href="/installation">
     *     Installation
     *   </SideNav.Link>
     * </SideNav.Group>
     */
    Group: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & {
        label: string;
    } & import('react').RefAttributes<HTMLLIElement>>;
};