/*
 * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
 * This file is licensed to you under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License. You may obtain a copy
 * of the License at https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
 * OF ANY KIND, either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */

import { SidenavProps } from "./types.js";
import "client-only";
import * as react_jsx_runtime172 from "react/jsx-runtime";

//#region src/components/sidenav/index.d.ts

/**
 * Sidenav - Collapsible side navigation panel
 *
 * Provides a hierarchical collapsible side navigation intended to be used
 * inside a DrawerLayout. Supports headers, avatars, nested menus, and items.
 *
 * @param props - {@link SidenavProps}
 * @param props.id - Unique identifier for the sidenav.
 * @param props.className - CSS class for the nav element.
 * @param props.isHiddenWhenClosed - Whether to hide the sidenav when closed.
 * @param props.children - Sidenav content (header, content, footer).
 * @returns The rendered Sidenav component.
 *
 * @example
 * ```tsx
 * <DrawerLayout push="left">
 *   <DrawerLayoutMain className="col-start-2">
 *     <SidenavTrigger>
 *       <Button variant="icon" size="large">
 *         <Icon>
 *           <MenuIcon />
 *         </Icon>
 *       </Button>
 *     </SidenavTrigger>
 *   </DrawerLayoutMain>
 *   <Sidenav>
 *     <SidenavHeader>
 *       <SidenavAvatar>
 *         <Icon><AppLogo /></Icon>
 *         <Heading>Application Header</Heading>
 *         <Text>subheader</Text>
 *       </SidenavAvatar>
 *     </SidenavHeader>
 *     <SidenavContent>
 *       <Heading>Navigation</Heading>
 *       <SidenavItem>
 *         <Icon><HomeIcon /></Icon>
 *         <Text>Home</Text>
 *       </SidenavItem>
 *       <Divider />
 *       <SidenavItem isSelected>
 *         <Icon><SettingsIcon /></Icon>
 *         <Text>Settings</Text>
 *       </SidenavItem>
 *       <Divider />
 *       <SidenavMenu title="More Options" icon={<Icon><MenuIcon /></Icon>}>
 *         <SidenavMenuItem>
 *           <Text>Sub Item 1</Text>
 *         </SidenavMenuItem>
 *         <SidenavMenuItem>
 *           <Text>Sub Item 2</Text>
 *         </SidenavMenuItem>
 *       </SidenavMenu>
 *     </SidenavContent>
 *     <SidenavFooter>
 *       <SidenavAvatar>
 *         <Icon><UserIcon /></Icon>
 *         <Heading>User Name</Heading>
 *         <Text>john@example.com</Text>
 *       </SidenavAvatar>
 *     </SidenavFooter>
 *   </Sidenav>
 * </DrawerLayout>
 * ```
 */
declare function Sidenav({
  id,
  className,
  isHiddenWhenClosed,
  children,
  ...rest
}: SidenavProps): react_jsx_runtime172.JSX.Element | null;
//#endregion
export { Sidenav };
//# sourceMappingURL=index.d.ts.map