import { CommonProps, Refable, type Styleable } from "@trackunit/react-components";
import { MappedOmit } from "@trackunit/shared-utils";
import { FocusEvent, ReactElement, ReactNode } from "react";
import { GroupBase, InputActionMeta, MultiValue } from "react-select";
import { SelectProps } from "../BaseSelect/useSelect";
import { FormGroupProps } from "../FormGroup/FormGroup";
import { BaseOptionType } from "../SelectField/FormFieldSelectAdapter";
/**
 * NOTE: Single and multi adapters are intentionally separate.
 * Single uses a primitive value model and a real hidden <select> with <option>s,
 * dispatching native "change" events for RHF/native forms and supporting a backup option.
 * Multi uses MultiValue<TOption> and different hidden inputs semantics.
 * Unifying would increase conditional logic and reduce clarity.
 */
/**
 * Generic over `TOption` to mirror BaseSelect typing.
 * Multi-value uses `MultiValue<TOption>` from react-select.
 */
type FormGroupExposedProps = Pick<FormGroupProps, "label" | "tip" | "helpText" | "helpAddon" | "isInvalid">;
/** Allow all BaseSelect props except those we adapt/wrap here */
type SelectExposedProps<TOption extends BaseOptionType = BaseOptionType, TIsAsync extends boolean = false, TGroup extends GroupBase<TOption> = GroupBase<TOption>> = MappedOmit<SelectProps<TOption, TIsAsync, true, TGroup>, "label" | "hasError" | "onBlur" | "options" | "value" | "defaultValue" | "onChange" | "isMulti" | "id">;
export interface MultiSelectFieldProps<TOption extends BaseOptionType = BaseOptionType, TIsAsync extends boolean = false, TGroup extends GroupBase<TOption> = GroupBase<TOption>> extends CommonProps, FormGroupExposedProps, SelectExposedProps<TOption, TIsAsync, TGroup>, Refable<HTMLSelectElement>, Styleable {
    /** RHF/native-friendly blur signature */
    onBlur?: (event: FocusEvent<HTMLInputElement>) => void;
    /**
     * Options to render (same shape as BaseSelect)
     *
     * @important
     * @expand
     */
    options: Array<TOption>;
    /**
     * Multi-value from react-select
     *
     * @important
     */
    value?: MultiValue<TOption> | null;
    /** Default selected options (MultiValue) */
    defaultValue?: MultiValue<TOption>;
    /**
     * onChange passes MultiValue<TOption> (or null when cleared)
     *
     * @important
     */
    onChange?: (value: MultiValue<TOption> | null) => void;
    /** Invalid state message rendered via FormGroup */
    errorMessage?: string;
    /** The htmlFor attribute for the label. If not provided, falls back to id or generates a unique value. */
    htmlFor?: string;
    /** Name used for optional hidden inputs when `getOptionValue` is provided */
    name?: string;
    /** Field id; also propagated to BaseSelect via child props */
    id?: string;
    /** Optional passthrough onInputChange (will be called in addition to internal logic) */
    onInputChange?: (value: string, meta: InputActionMeta) => void;
}
interface FormFieldSelectAdapterMultiProps<TOption extends BaseOptionType = BaseOptionType, TIsAsync extends boolean = false, TGroup extends GroupBase<TOption> = GroupBase<TOption>> extends MultiSelectFieldProps<TOption, TIsAsync, TGroup> {
    /**
     * Child render-prop receives exact BaseSelect props specialized for multi.
     */
    children: (props: SelectProps<TOption, TIsAsync, true, TGroup>) => ReactNode;
}
/**
 * Multi adapter:
 * - keeps TOption[] semantics (via `MultiValue<TOption>`)
 * - renders FormGroup chrome (label, help, error)
 * - exposes a hidden <select> for a stable ref target
 * - optionally renders one hidden <input> per selected option IF `getOptionValue` is provided
 * - passes through all remaining BaseSelect props with isMulti=true
 *
 * @param {FormFieldSelectAdapterMultiProps} props - The props for the FormFieldSelectAdapterMulti component
 * @returns {ReactElement} FormFieldSelectAdapterMulti component
 */
export declare const FormFieldSelectAdapterMulti: <TOption extends BaseOptionType = BaseOptionType, TIsAsync extends boolean = false, TGroup extends GroupBase<TOption> = GroupBase<TOption>>(props: FormFieldSelectAdapterMultiProps<TOption, TIsAsync, TGroup>) => ReactElement;
export {};