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

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

/**
 * Popover - A floating content container positioned relative to a trigger element
 *
 * Provides accessible popover functionality with flexible positioning and content
 * organization. Perfect for contextual information, menus, or supplementary content
 * that appears on demand without interrupting the user's workflow.
 *
 * @example
 * // Basic popover
 * <PopoverTrigger>
 *   <Button>Show Info</Button>
 *   <Popover>
 *     <PopoverContent>
 *       <p>Additional information appears here</p>
 *     </PopoverContent>
 *   </Popover>
 * </PopoverTrigger>
 *
 * @example
 * // Popover with title and actions
 * <PopoverTrigger>
 *   <Button>Options</Button>
 *   <Popover placement="top">
 *     <PopoverTitle>Quick Actions</PopoverTitle>
 *     <PopoverContent>
 *       <Button>Edit</Button>
 *       <Button>Delete</Button>
 *     </PopoverContent>
 *   </Popover>
 * </PopoverTrigger>
 *
 * @param props - {@link PopoverProps}
 * @param props.children - Content to render inside the popover dialog.
 * @param props.classNames - CSS class names for popover elements.
 * @param props.dialogProps - Additional props passed to the Dialog component.
 * @returns The rendered Popover component.
 */
declare function Popover({
  children,
  classNames,
  dialogProps,
  ...rest
}: PopoverProps): react_jsx_runtime148.JSX.Element;
//#endregion
export { Popover };
//# sourceMappingURL=index.d.ts.map