/*
 * 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 { FloatingCardProviderProps } from "./types.js";
import * as react_jsx_runtime37 from "react/jsx-runtime";

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

/**
 * Provides a context and layout area for floating cards within the application.
 *
 * Wraps children with floating card context and renders a Dockview instance to manage
 * docking, dragging, and layout of floating cards.
 *
 * @param props - The props for the FloatingCardProvider component.
 * @param props.children - Child components rendered inside the floating card provider.
 * @param props.icon - Optional icon rendered in all card headers (static or factory).
 * @param props.headerActions - Optional action buttons for card headers (static or factory).
 * @param props.className - Additional CSS class names for styling.
 * @returns The FloatingCardProvider component that manages floating card layout and context.
 *
 * @remarks
 * - Manages registration and cleanup of floating card DOM references
 * - Exposes closeCard, togglePinCard, and isPinned via context
 * - Automatically cleans up refs when cards are removed via any path (drag close, group close, API close)
 * - Cards are bounded within the viewport
 *
 * @example
 * ```tsx
 * <FloatingCardProvider
 *   icon={<AppLogo />}
 *   headerActions={[
 *     { icon: <SettingsIcon />, onClick: openSettings },
 *     'divider',
 *     'pin'
 *   ]}
 * >
 *   <FloatingCard id="panel-1" title="My Panel">
 *     <div>Panel content</div>
 *   </FloatingCard>
 * </FloatingCardProvider>
 * ```
 */
declare function FloatingCardProvider({
  children,
  icon,
  headerActions,
  initialPinned,
  className
}: FloatingCardProviderProps): react_jsx_runtime37.JSX.Element;
//#endregion
export { FloatingCardProvider };
//# sourceMappingURL=provider.d.ts.map