/*
 * 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 { FloatingCardProps } from "./types.js";
import * as react8 from "react";
import { PropsWithChildren } from "react";

//#region src/components/floating-card/index.d.ts

/**
 * Renders its children into a floating card using React portals.
 *
 * The `FloatingCard` component registers itself with the floating card engine on mount
 * and renders its children into the corresponding DOM node via a portal.
 *
 * @param id - Unique identifier for the floating card.
 * @param title - Optional title displayed in the floating card header.
 * @param isOpen - Whether the floating card is rendered. Defaults to `true`.
 * @param initialDimensions - Initial width and height of the floating card. Defaults to `{ width: 300, height: 400 }`.
 * @param initialPosition - Initial x and y coordinates of the floating card.
 * @param children - React children to render inside the floating card.
 * @returns The floating card component (portaled content) or null.
 *
 * @remarks
 * - Requires `FloatingCardProvider` as an ancestor.
 * - The floating card is only rendered if a valid DOM reference exists for the given `id`.
 *
 * @example
 * ```tsx
 * import { uuid } from '@accelint/core/utility/uuid';
 *
 * const cardId = uuid();
 * const [isOpen, setIsOpen] = useState(true);
 *
 * <FloatingCardProvider>
 *   <FloatingCard
 *     id={cardId}
 *     title="Settings Panel"
 *     isOpen={isOpen}
 *     initialDimensions={{ width: 400, height: 500 }}
 *   >
 *     <SettingsForm />
 *   </FloatingCard>
 *
 *   <button onClick={() => setIsOpen(!isOpen)}>
 *     Toggle Panel
 *   </button>
 * </FloatingCardProvider>
 * ```
 */
declare function FloatingCard({
  id,
  children,
  title,
  isOpen,
  initialDimensions,
  initialPosition
}: PropsWithChildren<FloatingCardProps>): react8.ReactPortal | null;
//#endregion
export { FloatingCard };
//# sourceMappingURL=index.d.ts.map