import { LuxenElement } from '../../shared/luxen-element.js';
/**
 * @summary Progressively enhances a label + control + messages group: wires the
 * accessibility plumbing (`id`/`for`, `aria-describedby`, `aria-invalid`,
 * required marker) and picks an inline or stacked layout from the control type.
 *
 * Styling stays on the control (`.l-checkbox`, …); inside a field a bare control
 * is auto-styled by the element CSS. Add `unstyled` to keep the ARIA wiring while
 * opting out of that auto-styling (e.g. for a third-party control).
 *
 * @example
 * ```html
 * <l-form-field>
 *   <label>Subscribe to the newsletter</label>
 *   <input type="checkbox" />
 *   <p class="l-hint">One email a month, unsubscribe anytime.</p>
 *   <p class="l-error">Please make a choice to continue.</p>
 * </l-form-field>
 * ```
 *
 * @slot - A `<label>`, one form control (a native `input` / `select` /
 * `textarea`, or a form-associated custom element such as `l-slider`), and
 * optional `.l-hint` / `.l-error` message elements, in any order.
 *
 * @cssClass .l-hint - Helper text element. Always visible; linked via `aria-describedby`.
 * @cssClass .l-error - Error message element. Hidden until invalid, then revealed with `role="alert"` and linked via `aria-describedby`.
 *
 * @customElement l-form-field
 */
export declare class FormField extends LuxenElement {
    createRenderRoot(): this;
    /** Layout, derived from the control type (`inline` for checkbox/radio/switch, otherwise `stacked`). Set one to force it. */
    layout?: 'inline' | 'stacked';
    /** Reflected when the control is required. Drives the label marker. */
    required: boolean;
    /** Reflected when the control is not required. */
    optional: boolean;
    /** Reflected once the control is invalid after interaction (or set to force the invalid state). */
    invalid: boolean;
    /** Opt out of auto-styling the control; the ARIA wiring is preserved. */
    unstyled: boolean;
    private _control;
    private _hint;
    private _error;
    private _hasInteracted;
    private _wired;
    /** describedby ids set by the author that we must preserve. */
    private _externalDescribedby;
    connectedCallback(): void;
    disconnectedCallback(): void;
    private _setup;
    /**
     * The field's control: a native `input`/`select`/`textarea`, or — when none is
     * present — the first form-associated custom element (e.g. `l-slider`). Those
     * expose the same `checkValidity()` / `invalid` event surface but don't match
     * the native selector, so without this fallback the field never wires up and
     * the `l-error` message stays visible on load.
     */
    private _findControl;
    private _teardown;
    private _onInvalid;
    private _onInteract;
    private _updateValidity;
    private _updateDescribedby;
}
//# sourceMappingURL=form-field.d.ts.map