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

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

/**
 * A versatile hero component that displays an icon alongside primary and secondary content.
 * Automatically organizes child components by type and supports both stacked and grid layouts.
 *
 * @param props - {@link HeroProps}
 * @param props.ref - Ref to the header element.
 * @param props.children - Child components (Icon, HeroTitle, HeroSubtitle).
 * @param props.classNames - Class names for Hero sub-elements.
 * @param props.compact - Whether to use compact grid layout.
 * @returns The rendered Hero component.
 *
 * @example
 * ```tsx
 * // Basic hero with icon and content
 * <Hero>
 *   <Icon><Placeholder /></Icon>
 *   <HeroTitle>Primary Title</HeroTitle>
 *   <HeroSubtitle>Secondary information</HeroSubtitle>
 * </Hero>
 *
 * // Grid layout for compact display
 * <Hero compact>
 *   <Icon><Settings /></Icon>
 *   <HeroTitle>Settings</HeroTitle>
 *   <HeroSubtitle>Configure your preferences</HeroSubtitle>
 * </Hero>
 * ```
 *
 * ## Child Component Behavior
 * - **Icon**: Only one allowed
 * - **HeroTitle**: Only one allowed
 * - **HeroSubtitle**: Any number allowed as secondary content
 *
 * ## Layout Modes
 * - **Stack** (default): Vertical layout with larger icon and stacked content
 * - **Grid** (compact=true): Horizontal layout with smaller icon beside content
 */
declare function Hero({
  ref,
  ...props
}: HeroProps): react_jsx_runtime69.JSX.Element;
//#endregion
export { Hero };
//# sourceMappingURL=index.d.ts.map