/**
 * Field-value provider abstraction. Drivers that fill form fields
 * (`formDriver`, `payloadDriver`) delegate value generation to a
 * `FieldValueProvider` so payload strategies can be swapped without
 * forking the driver itself.
 *
 * The provider sees structured field metadata (HTML input attributes
 * plus accessible name / placeholder) and returns one value string per
 * call. Returning `null` skips the field — useful when a payload set
 * only targets one type (e.g. URL-only SSRF payloads).
 */
import type { Rng } from "../random.js";
export interface FormFieldInfo {
    /** Playwright selector. */
    selector: string;
    /** Accessible name / label / aria-label. Most useful field metadata. */
    name?: string;
    /**
     * Input element type (text / email / number / url / tel / search /
     * password / date / textarea / select / checkbox / radio). For non-input
     * tags the tag name is used.
     */
    inputType?: string;
    /** `placeholder` attribute, if present. */
    placeholder?: string;
    /** `pattern` regexp string (HTML5 form validation). */
    pattern?: string;
    /** `minlength` / `maxlength`. */
    minLength?: number;
    maxLength?: number;
    /** `min` / `max` for numeric / date inputs. */
    min?: string;
    max?: string;
    /** `required` flag. */
    required?: boolean;
    /** Available `<option value>` strings, for `<select>`. */
    options?: string[];
}
export interface FieldValueProvider {
    readonly name: string;
    /**
     * Return a string value to type into the field, `null` to skip it.
     * For boolean inputs (checkbox/radio), returning a non-null string
     * means "check it"; the driver translates that into the right
     * playwright call.
     */
    valueFor(field: FormFieldInfo, rng: Rng): string | null;
}
/**
 * Default provider — sensible-looking values per input type. Picks
 * randomly from a small set so a single page repetition can still
 * produce variety.
 */
export declare function defaultValueProvider(): FieldValueProvider;
/**
 * Boundary-value provider — picks empty, very-long, zero/negative,
 * unicode edge-cases. Pairs well with invariants that look for crashes
 * or 500s. Skips checkbox/radio (they have no scalar boundary).
 */
export declare function boundaryValueProvider(): FieldValueProvider;
/**
 * Wrap a provider so it returns one fixed value for the next call to
 * `valueFor`, then falls through to the wrapped provider. Used by
 * `payloadDriver` to inject a chosen payload while keeping defaults
 * for the rest of the form.
 */
export declare function fromList(name: string, values: ReadonlyArray<string>): FieldValueProvider;
//# sourceMappingURL=field-values.d.ts.map