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

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

/**
 * Options - A flexible list component for selectable items with rich content
 *
 * Provides accessible list functionality with support for selection, sections,
 * and rich item content including labels, descriptions, and icons. Perfect for
 * dropdown lists, menu items, or any selectable list interface.
 *
 * @example
 * ```tsx
 * // Basic options list
 * <Options>
 *   <OptionsItem>
 *     <OptionsItemLabel>Option 1</OptionsItemLabel>
 *   </OptionsItem>
 *   <OptionsItem>
 *     <OptionsItemLabel>Option 2</OptionsItemLabel>
 *   </OptionsItem>
 * </Options>
 * ```
 *
 * @example
 * ```tsx
 * // Options with descriptions and icons
 * <Options>
 *   <OptionsItem>
 *     <Icon><User /></Icon>
 *     <OptionsItemContent>
 *       <OptionsItemLabel>John Doe</OptionsItemLabel>
 *       <OptionsItemDescription>Senior Developer</OptionsItemDescription>
 *     </OptionsItemContent>
 *   </OptionsItem>
 * </Options>
 * ```
 *
 * @example
 * ```tsx
 * // Sectioned options
 * <Options>
 *   <OptionsSection header="Recent">
 *     <OptionsItem>Recent Item 1</OptionsItem>
 *   </OptionsSection>
 *   <OptionsSection header="All Items">
 *     <OptionsItem>All Items 1</OptionsItem>
 *   </OptionsSection>
 * </Options>
 * ```
 *
 * @param props - {@link OptionsProps}
 * @param props.ref - Forwarded ref to the underlying ListBox element.
 * @param props.children - Options items and sections to render.
 * @param props.className - Optional CSS class name.
 * @param props.size - Size variant for the options list.
 * @returns The rendered Options component.
 */
declare function Options<T extends OptionsDataItem>({
  ref,
  ...props
}: OptionsProps<T>): react_jsx_runtime0.JSX.Element;
//#endregion
export { Options };
//# sourceMappingURL=index.d.ts.map