/*
 * 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 { AvatarProps } from "./types.js";
import "client-only";
import * as react_jsx_runtime3 from "react/jsx-runtime";

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

/**
 * Displays a user's profile image with automatic fallback support.
 * Built on Radix UI Avatar.
 *
 * @param props - The avatar props.
 * @param props.ref - Reference to the root span element.
 * @param props.children - Optional content such as a Badge to overlay on the avatar.
 * @param props.classNames - Custom class names for avatar sub-elements.
 * @param props.fallbackProps - Props passed to the fallback element.
 * @param props.imageProps - Props passed to the image element.
 * @param props.size - Size variant ('medium' or 'small').
 * @returns The avatar component.
 *
 * @example
 * ```tsx
 * <Avatar imageProps={{ src: "/user.jpg", alt: "User Name" }} />
 * ```
 *
 * @example
 * ```tsx
 * // With initials fallback
 * <Avatar
 *   size="small"
 *   imageProps={{ src: "/user.jpg", alt: "User Name" }}
 *   fallbackProps={{ children: "UN" }}
 * />
 * ```
 *
 * @example
 * ```tsx
 * // With status badge
 * <Avatar imageProps={{ src: "/user.jpg", alt: "User Name" }}>
 *   <Badge color="critical">3</Badge>
 * </Avatar>
 * ```
 */
declare function Avatar({
  ref,
  ...props
}: AvatarProps): react_jsx_runtime3.JSX.Element;
//#endregion
export { Avatar };
//# sourceMappingURL=index.d.ts.map