import { LitElement } from 'lit';

/**
 * Interface for AgFieldset properties.
 *
 * @property {string} legend - Optional legend text for the fieldset
 * @property {boolean} bordered - Whether to apply borders and padding
 * @property {'vertical' | 'horizontal'} layout - Layout mode for the fieldset content
 * @property {boolean} legendHidden - Visually hide the legend while keeping it accessible
 */
export interface FieldsetProps {
    /** Optional legend text for the fieldset. */
    legend?: string;
    /** Whether to apply borders and padding. */
    bordered?: boolean;
    /** Layout mode: 'vertical' (default) or 'horizontal'. */
    layout?: 'vertical' | 'horizontal';
    /** Visually hide the legend while keeping it accessible. */
    legendHidden?: boolean;
}
/**
 * AgFieldset - Groups related form controls with optional legend and layout options.
 *
 * The fieldset element semantically groups related form controls, and the legend element
 * provides a descriptive title for the entire group. This is essential for accessibility,
 * as screen readers announce the legend before each control, providing crucial context.
 *
 * Use Cases:
 * - Multiple choice questions using radio buttons or checkboxes
 * - Related questions or fields (e.g., date inputs, address details)
 * - Any set of form controls that share a common purpose or context
 *
 * Accessibility:
 * - Always include a legend (use legendHidden if you want to hide it visually)
 * - The legend is announced by screen readers before each control in the fieldset
 * - Proper semantic grouping helps users understand relationships between controls
 *
 * @element ag-fieldset
 */
export declare class AgFieldset extends LitElement implements FieldsetProps {
    static styles: import('lit').CSSResult;
    legend: string;
    bordered: boolean;
    layout: 'vertical' | 'horizontal';
    legendHidden: boolean;
    /**
     * Validate layout prop on connection
     */
    connectedCallback(): void;
    render(): import('lit').TemplateResult<1>;
}
//# sourceMappingURL=_Fieldset.d.ts.map