/**
 * @fileoverview NativeSelect primitive — styled wrapper around the native HTML select
 * element with chevron icon overlay. Supports default and small sizes with consistent
 * focus and error styling. Part of the Saasflare base component layer.
 * @module packages/ui/components/ui/native-select
 * @layer core
 *
 * @component
 * @example
 * import { NativeSelect, NativeSelectOption } from '@saasflare/ui';
 * <NativeSelect>
 *   <NativeSelectOption value="a">Option A</NativeSelectOption>
 *   <NativeSelectOption value="b">Option B</NativeSelectOption>
 * </NativeSelect>
 */
import * as React from "react";
import { type SaasflareComponentProps } from "../../providers";
/**
 * Props for {@link NativeSelect}.
 *
 * Extends the native `<select>` props with {@link SaasflareComponentProps}.
 * The HTML `size` attribute is omitted — `size` is repurposed as the visual
 * height variant.
 */
interface NativeSelectProps extends Omit<React.ComponentProps<"select">, "size" | keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Control height. `"sm"` renders a more compact trigger; `"md"` is the standard height. (`"default"` is a deprecated alias for `"md"`.) */
    size?: "sm" | "md" | "default";
}
/**
 * Styled native `<select>` with a chevron icon overlay. Uses the platform
 * picker UI — prefer it over the custom Select when native behavior (mobile
 * pickers, plain form submission) matters more than custom-rendered options.
 *
 * @component
 * @layer core
 *
 * @example
 * <NativeSelect>
 *   <NativeSelectOption value="a">Option A</NativeSelectOption>
 *   <NativeSelectOption value="b">Option B</NativeSelectOption>
 * </NativeSelect>
 */
declare function NativeSelect({ className, size, surface, radius, animated, iconWeight, ...props }: NativeSelectProps): import("react/jsx-runtime").JSX.Element;
/**
 * A single option within a {@link NativeSelect}. Thin wrapper around the native
 * `<option>` element that adds a `data-slot` for styling hooks.
 *
 * @example
 * <NativeSelectOption value="a">Option A</NativeSelectOption>
 */
declare function NativeSelectOption({ ...props }: React.ComponentProps<"option">): import("react/jsx-runtime").JSX.Element;
/**
 * Groups related {@link NativeSelectOption}s under a label within a
 * {@link NativeSelect}. Thin wrapper around the native `<optgroup>` element.
 *
 * @example
 * <NativeSelectOptGroup label="Group">
 *   <NativeSelectOption value="a">Option A</NativeSelectOption>
 * </NativeSelectOptGroup>
 */
declare function NativeSelectOptGroup({ className, ...props }: React.ComponentProps<"optgroup">): import("react/jsx-runtime").JSX.Element;
export { NativeSelect, NativeSelectOptGroup, NativeSelectOption, type NativeSelectProps };