/**
 * Fluent schema-style builder for form field configuration.
 *
 * @module bquery/forms
 */
import type { FieldConfig, FormConfig, Validator } from './types';
/**
 * Fluent builder for a single field's validator chain.
 *
 * Builders are immutable: every chain method returns a new builder, so the
 * same starting point can be reused safely.
 */
export type FieldSchema<T = unknown> = {
    /** Underlying validator list (frozen). */
    readonly validators: readonly Validator<T>[];
    /** Append a `required()` validator. */
    required: (message?: string) => FieldSchema<T>;
    /** Append a `min()` validator. */
    min: (limit: number, message?: string) => FieldSchema<T>;
    /** Append a `max()` validator. */
    max: (limit: number, message?: string) => FieldSchema<T>;
    /** Append a `minLength()` validator. */
    minLength: (limit: number, message?: string) => FieldSchema<T>;
    /** Append a `maxLength()` validator. */
    maxLength: (limit: number, message?: string) => FieldSchema<T>;
    /** Append a `length()` validator. */
    length: (exact: number, message?: string) => FieldSchema<T>;
    /** Append an `email()` validator. */
    email: (message?: string) => FieldSchema<T>;
    /** Append a `url()` validator. */
    url: (message?: string) => FieldSchema<T>;
    /** Append a `pattern()` validator. */
    pattern: (regex: RegExp, message?: string) => FieldSchema<T>;
    /** Append an `integer()` validator. */
    integer: (message?: string) => FieldSchema<T>;
    /** Append a `numeric()` validator. */
    numeric: (message?: string) => FieldSchema<T>;
    /** Append a `between()` validator. */
    between: (minLimit: number, maxLimit: number, message?: string) => FieldSchema<T>;
    /** Append a `oneOf()` validator. */
    oneOf: (values: readonly T[], message?: string) => FieldSchema<T>;
    /** Append a `notOneOf()` validator. */
    notOneOf: (values: readonly T[], message?: string) => FieldSchema<T>;
    /** Append a `matchField()` validator. */
    matchField: (ref: {
        readonly value: T;
    }, message?: string) => FieldSchema<T>;
    /** Append an arbitrary custom validator. */
    custom: (validator: Validator<T>) => FieldSchema<T>;
    /** Finalize as a {@link FieldConfig} with the given initial value. */
    toConfig: (initialValue: T, extras?: Omit<FieldConfig<T>, 'initialValue' | 'validators'>) => FieldConfig<T>;
};
/**
 * Start a fluent field schema chain.
 *
 * @example
 * ```ts
 * import { field, schema } from '@bquery/bquery/forms';
 *
 * const form = createForm(schema({
 *   name:  field<string>().required().minLength(2),
 *   email: field<string>().required().email(),
 *   age:   field<number>().integer().between(0, 150),
 * }));
 * ```
 */
export declare const field: <T = unknown>() => FieldSchema<T>;
/**
 * A schema entry can be either a fluent builder (with optional initial value),
 * a fully-formed {@link FieldConfig}, or just a plain initial value (no validators).
 */
export type SchemaEntry<T = unknown> = FieldSchema<T> | FieldConfig<T> | T;
/**
 * Schema-style declaration helper that converts a map of fluent field
 * builders, raw {@link FieldConfig}s, or plain initial values into a
 * `FormConfig['fields']` object ready for {@link createForm}.
 *
 * @param shape - Map of field name → {@link SchemaEntry}
 * @param defaults - Optional initial values, used when an entry is a `FieldSchema` without an initial value
 * @returns Partial form config containing `fields`; merge with `onSubmit`, `crossValidators`, etc.
 *
 * @example
 * ```ts
 * import { createForm, schema, field } from '@bquery/bquery/forms';
 *
 * const form = createForm({
 *   ...schema({
 *     name:  field<string>().required(),
 *     email: field<string>().required().email(),
 *   }, { name: '', email: '' }),
 *   onSubmit: async (values) => { ... },
 * });
 * ```
 */
export declare const schema: <T extends Record<string, unknown>>(shape: { [K in keyof T]: SchemaEntry<T[K]>; }, defaults?: Partial<T>) => Pick<FormConfig<T>, "fields">;
//# sourceMappingURL=schema.d.ts.map