/**
 * @fileoverview Sidebar menu components — menu items, buttons with tooltip support, sub-menus, actions, badges, and skeletons.
 * Provides the interactive menu primitives for the sidebar. Part of the Saasflare base component layer.
 * @module packages/ui/components/ui/sidebar/menu
 * @package ui
 *
 * @example
 * import { SidebarMenu, SidebarMenuItem, SidebarMenuButton } from '@saasflare/ui';
 * <SidebarMenu>
 *   <SidebarMenuItem>
 *     <SidebarMenuButton tooltip="Dashboard" isActive>
 *       Dashboard
 *     </SidebarMenuButton>
 *   </SidebarMenuItem>
 * </SidebarMenu>
 */
import * as React from "react";
import { VariantProps } from "class-variance-authority";
import { type SaasflareComponentProps } from "../../../providers";
import { TooltipContent } from "../tooltip";
export declare const sidebarMenuButtonVariants: (props?: ({
    variant?: "outline" | "default" | null | undefined;
    size?: "sm" | "md" | "lg" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
/**
 * Top-level menu list container for the sidebar. Renders a `<ul>` that lays out
 * {@link SidebarMenuItem} children in a vertical stack.
 */
export declare function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">): import("react/jsx-runtime").JSX.Element;
/**
 * Wrapper for a single menu entry. Renders a `<li>` and establishes the
 * `group/menu-item` scope used by actions, badges, and active-state styling.
 */
export declare function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">): import("react/jsx-runtime").JSX.Element;
/** Props for {@link SidebarMenuButton}. */
export interface SidebarMenuButtonProps extends Omit<React.ComponentProps<"button">, keyof SaasflareComponentProps>, SaasflareComponentProps, Omit<VariantProps<typeof sidebarMenuButtonVariants>, "size"> {
    /** Visual size. (`"default"` is a deprecated alias for `"md"`.) */
    size?: VariantProps<typeof sidebarMenuButtonVariants>["size"] | "default";
    /** Render via Radix `Slot` instead of a `<button>`, merging props onto the child. */
    asChild?: boolean;
    /** Marks the button as the active route. Drives the accent indicator + emphasis. */
    isActive?: boolean;
    /** Tooltip shown when the sidebar is collapsed. Pass a string or `TooltipContent` props. */
    tooltip?: string | React.ComponentProps<typeof TooltipContent>;
}
/**
 * Primary interactive menu button. Supports active state, size/variant styling,
 * and an optional tooltip that surfaces the label when the sidebar is collapsed.
 */
export declare function SidebarMenuButton({ asChild, isActive, variant, size, tooltip, className, surface, radius, animated, iconWeight, ...props }: SidebarMenuButtonProps): import("react/jsx-runtime").JSX.Element;
/** Props for {@link SidebarMenuAction}. */
export interface SidebarMenuActionProps extends Omit<React.ComponentProps<"button">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Render via Radix `Slot` instead of a `<button>`, merging props onto the child. */
    asChild?: boolean;
    /** Reveal the action only on item hover/focus (hidden by default on desktop). */
    showOnHover?: boolean;
}
/**
 * Trailing action affordance (e.g. a kebab menu) docked to the right edge of a
 * menu item. Optionally reveals only on hover via {@link SidebarMenuActionProps.showOnHover}.
 */
export declare function SidebarMenuAction({ className, asChild, showOnHover, surface, radius, animated, iconWeight, ...props }: SidebarMenuActionProps): import("react/jsx-runtime").JSX.Element;
/** Props for {@link SidebarMenuBadge}. */
export interface SidebarMenuBadgeProps extends Omit<React.ComponentProps<"div">, keyof SaasflareComponentProps>, SaasflareComponentProps {
}
/**
 * Small count/status badge anchored to the right edge of a menu item
 * (e.g. unread counts). Non-interactive and hidden in icon-collapsed mode.
 */
export declare function SidebarMenuBadge({ className, surface, radius, animated, iconWeight, ...props }: SidebarMenuBadgeProps): import("react/jsx-runtime").JSX.Element;
/** Props for {@link SidebarMenuSkeleton}. */
export interface SidebarMenuSkeletonProps extends Omit<React.ComponentProps<"div">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Render a leading icon-sized skeleton block alongside the text skeleton. */
    showIcon?: boolean;
}
/**
 * Loading placeholder for a sidebar menu row. Renders a shimmering text bar
 * (and optional icon block) sized to mimic real menu entries.
 */
export declare function SidebarMenuSkeleton({ className, showIcon, surface, radius, animated, iconWeight, ...props }: SidebarMenuSkeletonProps): import("react/jsx-runtime").JSX.Element;
/**
 * Nested sub-menu list container. Renders a `<ul>` with the left guide rail used
 * for grouping {@link SidebarMenuSubItem} children. Hidden in icon-collapsed mode.
 */
export declare function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">): import("react/jsx-runtime").JSX.Element;
/**
 * Wrapper for a single sub-menu entry. Renders a `<li>` and establishes the
 * `group/menu-sub-item` scope.
 */
export declare function SidebarMenuSubItem({ className, ...props }: React.ComponentProps<"li">): import("react/jsx-runtime").JSX.Element;
/** Props for {@link SidebarMenuSubButton}. */
export interface SidebarMenuSubButtonProps extends Omit<React.ComponentProps<"a">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Render via Radix `Slot` instead of an `<a>`, merging props onto the child. */
    asChild?: boolean;
    /** Type scale for the sub-button label. Defaults to `"md"`. */
    size?: "sm" | "md";
    /** Marks the sub-button as the active route. */
    isActive?: boolean;
}
/**
 * Interactive link inside a {@link SidebarMenuSub}. Smaller, indented counterpart
 * to {@link SidebarMenuButton} with active-state styling.
 */
export declare function SidebarMenuSubButton({ asChild, size, isActive, className, surface, radius, animated, iconWeight, ...props }: SidebarMenuSubButtonProps): import("react/jsx-runtime").JSX.Element;