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

//#region src/components/button/toggle.d.ts

/**
 * ToggleButton - A button component that maintains pressed/unpressed state
 *
 * Provides accessible toggle functionality with visual feedback for the current state.
 * Perfect for features like favorites, bookmarks, switches, or any binary state controls.
 * Includes icon support and integrates with React Aria for keyboard navigation and accessibility.
 *
 * @param props - The toggle button props.
 * @param props.ref - Reference to the button element.
 * @param props.children - Toggle button content (text, icons, or both).
 * @param props.className - Additional CSS class names for styling.
 * @param props.color - Semantic color variant.
 * @param props.size - Size of the toggle button.
 * @param props.variant - Visual style variant (filled not available).
 * @param props.isSelected - Whether the toggle is currently selected.
 * @param props.onChange - Callback when the toggle state changes.
 * @returns The toggle button component.
 *
 * @example
 * ```tsx
 * // Basic toggle button
 * <ToggleButton>Toggle Feature</ToggleButton>
 * ```
 *
 * @example
 * ```tsx
 * // Controlled toggle button with different variants
 * <ToggleButton variant="flat" isSelected={isEnabled} onChange={setIsEnabled}>
 *   Enable Notifications
 * </ToggleButton>
 * ```
 *
 * @example
 * ```tsx
 * // Toggle button with icon and state
 * <ToggleButton variant="outline" isSelected={isFavorite} onChange={setIsFavorite}>
 *   <Icon><Heart /></Icon>
 *   {isFavorite ? 'Favorite' : 'Add to Favorites'}
 * </ToggleButton>
 * ```
 *
 * @example
 * ```tsx
 * // Icon-only toggle button
 * <ToggleButton variant="icon" isSelected={isBookmarked} onChange={setIsBookmarked}>
 *   <Icon><Bookmark /></Icon>
 * </ToggleButton>
 * ```
 *
 * @example
 * ```tsx
 * // Toggle button with different colors and sizes
 * <ToggleButton color="critical" size="small" isSelected={isEnabled}>
 *   Critical Toggle
 * </ToggleButton>
 * ```
 */
declare function ToggleButton({
  ref,
  ...props
}: ToggleButtonProps): react_jsx_runtime120.JSX.Element;
//#endregion
export { ToggleButton };
//# sourceMappingURL=toggle.d.ts.map