import * as _angular_core from '@angular/core';
import * as _angular_forms from '@angular/forms';
import { NgControl } from '@angular/forms';

/**
 * Wraps a label + control + error message into a single field row.
 *
 * Toggle `hasError` to apply error styling to the projected label and
 * any descendant input / textarea / checkbox.
 *
 * @example
 * ```html
 * <wr-form-item [hasError]="form.controls.email.invalid">
 *   <label>Email</label>
 *   <wr-input formControlName="email" />
 *   <wr-form-error>Invalid email</wr-form-error>
 * </wr-form-item>
 * ```
 *
 * @see https://ngwr.dev/components/form
 */
declare class WrFormItem {
    /**
     * When `true`, applies error coloring to the projected label and inputs.
     *
     * @default false
     */
    readonly hasError: _angular_core.InputSignalWithTransform<boolean, any>;
    protected readonly classes: _angular_core.Signal<string>;
    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFormItem, never>;
    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFormItem, "wr-form-item", never, { "hasError": { "alias": "hasError"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
}

/**
 * Wraps a label + control + hint + error messages into a single block —
 * the layout primitive every form ends up reinventing.
 *
 * - Auto-binds `label[for]` to the projected control via a generated id
 *   (or use the form-control's `[id]` if you set one).
 * - Reads the projected control's `NgControl` to surface validation
 *   errors only when the control has been touched / submitted.
 * - Optional `[required]` / `[optional]` markers next to the label.
 *
 * @example
 * ```html
 * <wr-form-field label="Email" hint="We'll never share it.">
 *   <input wrInput [formControl]="email" type="email" />
 *   <wr-form-error key="required">Email is required.</wr-form-error>
 *   <wr-form-error key="email">Not a valid email.</wr-form-error>
 * </wr-form-field>
 * ```
 *
 * @see https://ngwr.dev/components/form-field
 */
declare class WrFormField {
    /** Label text shown above the control. */
    readonly label: _angular_core.InputSignal<string>;
    /** Hint text shown below the control. Hidden when an error is visible. */
    readonly hint: _angular_core.InputSignal<string>;
    /** Show a `*` next to the label. @default false */
    readonly required: _angular_core.InputSignalWithTransform<boolean, any>;
    /** Show `(optional)` next to the label. Mutually exclusive with `required`. @default false */
    readonly optional: _angular_core.InputSignalWithTransform<boolean, any>;
    /** Force a specific id on the label's `for` attribute. Auto-generated otherwise. */
    readonly controlId: _angular_core.InputSignal<string>;
    /** Projected `NgControl` — used to read touched / dirty / errors. */
    protected readonly ngControl: _angular_core.Signal<NgControl | undefined>;
    protected readonly errors: _angular_core.Signal<_angular_forms.ValidationErrors | null>;
    protected readonly hasError: _angular_core.Signal<boolean>;
    protected readonly classes: _angular_core.Signal<string>;
    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFormField, never>;
    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFormField, "wr-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; }, {}, ["ngControl"], ["*", "wr-form-error"], true, never>;
}
/**
 * One error message tied to a validator key. Renders only when the
 * parent form-field has a matching error in `control.errors`.
 *
 * @example
 * ```html
 * <wr-form-error key="required">This field is required.</wr-form-error>
 * <wr-form-error key="email">That doesn't look right.</wr-form-error>
 * ```
 */
declare class WrFormError {
    /**
     * Validator key this message corresponds to (e.g. `'required'`).
     * Optional — without a key the message always renders, which is the
     * plain inline-error usage inside `<wr-form-item>`.
     */
    readonly key: _angular_core.InputSignal<string | undefined>;
    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFormError, never>;
    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFormError, "wr-form-error", never, { "key": { "alias": "key"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
}

export { WrFormError, WrFormField, WrFormItem };