import { ValidationError, type ValidationState } from '../../validation/types.js';
import type { ControlRegistrationHandle, FormApi, FormSnapshot, FormStatus, FormValidator, RegisteredControl } from '../form.types.js';
/**
 * Mutable config the `<Form>` component feeds into the runtime on every render.
 * @internal
 */
export interface FormRuntimeConfig<TValues = Record<string, unknown>> {
    formId?: string;
    validators: FormValidator<TValues>[];
    onSubmit?: (context: {
        snapshot: FormSnapshot<TValues>;
        form: FormApi<TValues>;
    }) => void;
    onInvalid?: (context: {
        snapshot: FormSnapshot<TValues>;
        status: FormStatus;
        form: FormApi<TValues>;
    }) => void;
    onValidityChange?: (state: ValidationState) => void;
}
/**
 * The full runtime surface: the public {@link FormApi} plus the internal hooks
 * the `<Form>` component and registered controls use.
 * @internal
 */
export interface FormRuntime<TValues = Record<string, unknown>> extends FormApi<TValues> {
    /** Registers a control and returns its imperative handle. */
    register: (control: RegisteredControl) => ControlRegistrationHandle;
    /** Subscribes to any runtime change (for `useSyncExternalStore`). */
    subscribe: (listener: () => void) => () => void;
    /** The form-wide errors currently rendered by `<FormMessages>`. */
    getFormMessages: () => ValidationError[];
    /** Runtime-owned field errors rendered by `FormFieldMessages`. */
    getFieldMessages: (controlId: string) => ValidationError[];
    /**
     * Replaces the config getter that the runtime calls on each submit/validate.
     * Called by `<Form>` when an external runtime is supplied via the `form` prop.
     * Pass `undefined` to revert to the no-op default (e.g. on unmount).
     * @internal
     */
    _bindConfig?: (fn: (() => FormRuntimeConfig<TValues>) | undefined) => void;
}
export declare function createFormRuntime<TValues = Record<string, unknown>>(getConfig?: () => FormRuntimeConfig<TValues>): FormRuntime<TValues>;
//# sourceMappingURL=createFormRuntime.d.ts.map