import SgdsElement from "../../base/sgds-element";
import SgdsIconButton from "../IconButton/sgds-icon-button";
/**
 * @summary Sidebar is a collapsible navigation component that displays menu items and groups.
 * Users can expand and collapse the sidebar to save screen space while navigating through organized menu items.
 * The sidebar coordinates selection and navigation across nested items using context providers and custom events.
 *
 * Features:
 * - Collapsible state for space-saving layouts with icon-only mode
 * - Multi-level nesting (up to 3 levels) with drawer overlay for root-level groups
 * - Keyboard navigation with full ARIA support for accessibility
 * - Programmatic link navigation support with anchor elements
 * - Active item tracking and synchronized state management
 *
 * Keyboard Navigation:
 * - Arrow Up/Down: Navigate between sidebar items and groups
 * - Arrow Left/Right: Collapse/expand groups or navigate drawer overlays
 * - Enter/Space: Activate focused item or toggle group
 * - Tab: Standard focus management to interactive elements
 *
 * @slot default - Insert sgds-sidebar-item, sgds-sidebar-group, and sgds-sidebar-section elements
 * @slot upper - Insert brand/logo content in sidebar header
 * @slot lower - Insert content in sidebar footer
 *
 * @fires sgds-select - Emitted when a sidebar item or group is selected.
 *   Event detail: { activeItem: string } - name of the selected item
 *
 */
type SidebarVariant = "persistent" | "overlay" | "collapsible";
export declare class SgdsSidebar extends SgdsElement {
    static styles: import("lit").CSSResult[];
    static dependencies: {
        "sgds-icon-button": typeof SgdsIconButton;
    };
    /**
     * Controls whether the sidebar is collapsed or expanded to save screen space.
     * When true, sidebar displays icon-only mode for root items. When false, full labels and content are shown.
     * On mobile devices (width <= 576px), this is automatically toggled based on screen size.
     * Collapsing propagates to child items, affecting label visibility and spacing.
     * @attribute collapsed
     * @type {boolean}
     * @default false
     */
    collapsed: boolean;
    /**
     * The name of the currently active sidebar item or group for programmatic control.
     * Setting this property programmatically selects the item with the matching `name` attribute.
     * Automatically expands parent groups to reveal nested items and syncs the active state throughout the hierarchy.
     * Clearing this property (setting to empty string) deselects all items.
     * @attribute active
     * @type {string}
     * @default ""
     */
    active: string;
    /**
     * Shows a scrim/overlay background behind the drawer or sidebar in overlay mode.
     * When true, displays a semi-transparent dark overlay behind the drawer to focus user attention.
     * Only visible when drawer is open or in overlay mode with sidebar not collapsed.
     * @attribute scrim
     * @type {boolean}
     * @default false
     */
    scrim: boolean;
    /**
     * Controls the sidebar's collapse behaviour.
     * - `"collapsible"` (default): shows a toggle button that collapses/expands the sidebar.
     * - `"persistent"`: sidebar is always visible and cannot be collapsed.
     * - `"overlay"`: sidebar slides over the content as a drawer on smaller viewports.
     * @attribute variant
     * @type {"collapsible" | "persistent" | "overlay"}
     * @default "collapsible"
     */
    variant: SidebarVariant;
    /**
     * Accessible label for the sidebar navigation landmark.
     * Passed to the `<nav>` element's `aria-label` attribute so screen readers can distinguish
     * this sidebar from other navigation regions on the page (e.g. a top mainnav).
     * Override when your page uses a more specific term (e.g. `"Dashboard navigation"`).
     * @attribute aria-label
     * @type {string}
     * @default "Sidebar navigation"
     */
    ariaLabel: string;
    /** @internal Tracks the currently active group and provides it via context to all child elements */
    private _sidebarActiveGroup;
    /** @internal Syncs collapsed state to all descendants via context */
    private _sidebarCollapsed;
    /** @internal Syncs active item selection to all descendants via context */
    private _sidebarActiveItem;
    /** @internal Provides drawer items to descendants via context */
    private _drawerItems;
    /** @internal Provides drawer open/closed state to descendants via context */
    private _showDrawer;
    /** @internal Provides overlay mode state to descendants via context */
    private _isOverlay;
    /** @internal */
    private _defaultNodes;
    /** @internal */
    private _isNarrowViewport;
    /** @internal Bound resize handler for proper event listener removal */
    private _boundHandleResize;
    /** @internal Bound i-sgds-click handler for proper event listener removal */
    private _boundHandleItemClick;
    connectedCallback(): void;
    disconnectedCallback(): void;
    firstUpdated(): void;
    updated(): void;
    /**
     * Syncs collapsed property changes to all child items through context provider.
     * Updates internal state and triggers re-render with appropriate CSS classes.
     * @internal
     * @returns {void}
     */
    _handleCollapsed(): void;
    /**
     * Updates sidebar state when active item changes via context provider.
     * Marks items as selected and handles drawer overlay visibility based on nesting level.
     * Root-level items with children trigger drawer display. Nested selections expand parent groups.
     * @internal
     * @returns {void}
     */
    _handleActiveItem(oldItem?: unknown): void;
    /**
     * Finds and activates sidebar items matching the active property name.
     * Recursively searches the hierarchy for the target item. Clears selection when active is empty.
     * @internal
     * @returns {void}
     */
    _handleActive(): void;
    /**
     * Recursively searches all nesting levels for a sidebar element matching the active name.
     * Traverses the complete hierarchy to support selection of deeply nested items.
     * @internal
     * @returns {SidebarElement | null} The matching element or null if not found
     */
    private _getActiveChild;
    /**
     * Manages responsive behavior on window resize.
     * Auto-collapses sidebar on narrow viewports (< XL_BREAKPOINT).
     * Switches collapsible variant to overlay mode on screens below MD_BREAKPOINT.
     * @internal
     * @returns {void}
     */
    private _handleResize;
    /**
     * Updates overlay state based on variant and screen size.
     * Collapsible variant switches to overlay mode on screens below MD_BREAKPOINT (768px).
     * @internal
     * @returns {void}
     */
    private _updateOverlayState;
    /**
     * Populates drawer overlay with children of the specified parent group.
     * Clears previous drawer content before adding new items. Reverts previous group's items to parent.
     * @internal
     * @param {SgdsSidebarGroup} element - The parent group whose children to display in drawer
     * @returns {void}
     */
    private _setNodesToDrawer;
    /**
     * Returns drawer items to their original parent element and clears the drawer.
     * Called when closing the drawer or switching active groups.
     * @internal
     * @returns {void}
     */
    private _revertNodesToParent;
    /**
     * Recursively collects all descendant sidebar elements via slot assignments.
     * Traverses _defaultNodes and their _childElements to build a flat list of all items and groups.
     * @internal
     * @returns {SidebarElement[]} All descendant sidebar elements
     */
    private _getAllItems;
    /**
     * Handles item click events via delegation on the sidebar root.
     * Manages selection state, drawer visibility, anchor navigation, and sgds-select emission.
     * @internal
     * @param {Event} e - The bubbled i-sgds-click event
     * @returns {void}
     */
    private _handleItemClick;
    /**
     * Toggles the sidebar between collapsed and expanded display modes.
     * Updates labels visibility and spacing accordingly. Called when user clicks collapse button.
     * @public
     * @returns {void}
     */
    toggleCollapsed(): void;
    /**
     * Closes drawer when user clicks outside the sidebar.
     * Also collapses overlay sidebar when clicking outside (if in overlay mode).
     * @internal
     * @param {MouseEvent} e - The click event from document
     * @returns {void}
     */
    private _handleClickOutOfElement;
    render(): import("lit").TemplateResult<1>;
}
export default SgdsSidebar;