import type { BaseFieldConfig } from './field-config.js';
import type { FieldValidationResult } from './field-controller.js';
import type { ManagedFieldController } from './managed-field-controller.js';
type NativeControl = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
/**
 * Adapter used to normalize one native control.
 */
export interface NativeControlAdapter<TValue> {
    readonly control: NativeControl;
    readValue(signal?: AbortSignal): TValue | PromiseLike<TValue>;
    writeValue(value: unknown): void;
    setReadOnly(isReadOnly: boolean): void;
    validateNative(): FieldValidationResult;
    destroy?(): void;
}
/**
 * Arguments shared by native control controller construction.
 */
export interface NativeControlControllerArguments<TFormValues extends object, TValue> {
    readonly config: BaseFieldConfig<TFormValues, TValue> & {
        readonly label?: string;
        readonly description?: string;
        readonly readOnly?: boolean;
        readonly required?: boolean;
    };
    readonly fieldId: string;
    readonly adapter: NativeControlAdapter<TValue>;
    readonly invalidMessage: string;
    readonly requiredMessage: string;
    readonly onUserChange: () => void;
    readonly changeEvent?: 'change' | 'input';
    readonly controlContainer?: HTMLElement;
    readonly labelPlacement?: 'before-control' | 'after-control';
}
/**
 * Creates lifecycle, error, callback, and DOM behavior around a native control.
 *
 * @param controllerArguments - Typed construction arguments.
 * @returns An internal type-erased controller.
 */
export declare function createNativeControlController<TFormValues extends object, TValue>(controllerArguments: NativeControlControllerArguments<TFormValues, TValue>): ManagedFieldController<TFormValues>;
export {};