import { EventEmitter, OnChanges } from '@angular/core';
import { SafeHtml } from '@angular/platform-browser';
import { ControlValueAccessor, NgControl } from '@angular/forms';
import { ListboxValueChangeEvent } from '@angular/cdk/listbox';
import { ConnectedPosition } from '@angular/cdk/overlay';
import { DropdownLabelPosition, DropdownOption, DropdownSize } from './dropdown-types';
import * as i0 from "@angular/core";
/**
 * A labelled single-select dropdown built on the CDK Listbox (`@angular/cdk/listbox`)
 * and CDK Overlay. The trigger renders the closed field (label, placeholder/selected
 * value and chevron); the options open in an overlay panel with full keyboard support
 * (arrow keys, Home/End, typeahead) provided by the CDK listbox.
 *
 * Implements `ControlValueAccessor` so it works with both reactive forms
 * (`formControlName`, `[formControl]`) and template-driven forms (`ngModel`). The error
 * visual state is driven automatically by the bound `FormControl`'s validity once the
 * field has been touched, and can also be set explicitly via the `error` input.
 */
export declare class DropdownComponent implements ControlValueAccessor, OnChanges {
    private readonly _autoId;
    private readonly cdr;
    private readonly sanitizer;
    private _onChange;
    private _onTouched;
    /** Injected when the component is used inside a reactive or template-driven form. */
    protected readonly ngControl: NgControl | null;
    constructor();
    private triggerBtn?;
    private listboxEl?;
    /** Label displayed above the trigger. */
    label: string;
    /** Text shown in the trigger when no option is selected. */
    placeholder: string;
    /** Currently selected value. When used in a form, the form controls the value. */
    value: string;
    /** Selectable options rendered in the overlay panel. */
    options: DropdownOption[];
    /** Size variant — controls height, padding, and font size. Defaults to `'md'`. */
    size: DropdownSize;
    /** Native `id` attribute for the trigger. Auto-generated if omitted. */
    id?: string;
    /**
     * Id(s) of external elements that describe the field, space-separated.
     * Forwarded to `aria-describedby` on the trigger.
     */
    ariaDescribedBy?: string;
    /** Text displayed below the trigger. Shown in red when in error state. */
    supportingText: string;
    /**
     * Static error text shown in red when in error state. Used when the dropdown is
     * outside a form (with `[error]="true"`). When inside a form, prefer `errorMessages`.
     */
    errorMessage: string;
    /**
     * Map of Angular validator error keys to display strings. The component reads
     * `ngControl.errors` to determine which validator failed and shows the matching
     * message in red below the trigger. Example: `{ required: 'Please choose an option' }`
     */
    errorMessages: Record<string, string>;
    /**
     * Adds a blue asterisk after the label. When used in a form, this is set
     * automatically if the bound `FormControl` has `Validators.required`.
     * Supports boolean coercion.
     */
    required: boolean;
    /**
     * Applies the error visual state (red border) explicitly. When used in a form,
     * the error state is driven automatically from the `FormControl`'s validity once
     * the field is touched — this input is only needed outside of forms. Supports boolean coercion.
     */
    error: boolean;
    /** Disables the dropdown. When used in a form, also responds to `FormControl.disable()`. Supports boolean coercion. */
    disabled: boolean;
    /** Visually hides the label while keeping it accessible to screen readers. Supports boolean coercion. */
    hideLabel: boolean;
    /** Places the label above the trigger (`'top'`, default) or beside it (`'left'`). */
    labelPosition: DropdownLabelPosition;
    /**
     * Renders the label as the trigger's own resting text instead of a separate
     * label above/beside it — e.g. the trigger reads "I want to" until an option
     * is chosen. No visible external label is shown, but the `label` is still
     * exposed to assistive tech (a screen-reader-only `<label>` + `aria-labelledby`),
     * so the field is announced as a properly labelled combobox. Supports boolean coercion.
     */
    inlineLabel: boolean;
    /** Lucide icon name rendered inside the trigger, before the displayed value/placeholder (e.g. `'globe'`). */
    leadingIcon?: string;
    /** Default Lucide icon shown before every option's label; each option's own `icon` (from the Icon Mapping) overrides it. */
    optionsLeadingIcon?: string;
    /** Emits the newly selected value whenever the user picks an option. */
    readonly valueChange: EventEmitter<string>;
    /** Emitted when the overlay panel opens. */
    readonly opened: EventEmitter<void>;
    /** Emitted when the overlay panel closes. */
    readonly closed: EventEmitter<void>;
    protected readonly chevronSvg: SafeHtml;
    protected leadingIconSvg: SafeHtml | null;
    private readonly optionIconCache;
    protected isOpen: boolean;
    protected overlayWidth: number;
    protected readonly overlayPositions: ConnectedPosition[];
    ngOnChanges(): void;
    private buildIconSvg;
    /**
     * Scales trusted raw SVG (e.g. a flag) to 20px wide, preserving aspect ratio via its
     * viewBox. Only the root `<svg>` tag's width/height are normalized — inner elements
     * (rects/paths that draw the icon) keep their own dimensions.
     */
    private buildRawIconSvg;
    /**
     * Resolves an icon to cached SafeHtml: a trusted raw `iconSvg` wins, else a Lucide
     * `iconName`. Returns null when neither is set. Cached so rows keep a stable reference.
     */
    private resolveIcon;
    /** Icon for an option row: its own `iconSvg`/`icon`, else the shared `optionsLeadingIcon`. */
    protected optionIcon(option: DropdownOption): SafeHtml | null;
    /** Icon in the trigger: the selected option's own icon (flag/glyph), else the fixed `leadingIcon`. */
    get triggerIconSvg(): SafeHtml | null;
    get triggerId(): string;
    get labelId(): string;
    get listboxId(): string;
    get selectedOption(): DropdownOption | undefined;
    /**
     * Resting text shown in the trigger: the selected option's label, else the
     * `label` in inline-label mode (so the label reads as the field's own text),
     * else the placeholder.
     */
    get triggerText(): string;
    /** Value array bound to the CDK listbox (single-select, so 0 or 1 entry). */
    get listboxValue(): readonly string[];
    /** True when the bound FormControl is invalid and touched, or when `error` is explicitly set. */
    get hasError(): boolean;
    /** True when `required` is set explicitly, or when the bound FormControl has Validators.required. */
    get isRequired(): boolean;
    private get activeErrorMessage();
    get displayedSupportingText(): string;
    get describedBy(): string | null;
    get wrapperClasses(): string;
    protected toggle(): void;
    protected open(): void;
    protected close(refocus?: boolean): void;
    protected onPanelAttach(): void;
    protected onTriggerKeydown(event: KeyboardEvent): void;
    protected onListboxKeydown(event: KeyboardEvent): void;
    protected onListboxValueChange(event: ListboxValueChangeEvent<string>): void;
    writeValue(value: string | null): void;
    registerOnChange(fn: (value: string) => void): void;
    registerOnTouched(fn: () => void): void;
    /** Called by Angular when the bound FormControl is programmatically disabled or enabled. */
    setDisabledState(isDisabled: boolean): void;
    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "compsych-dropdown", never, { "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "value": { "alias": "value"; "required": false; }; "options": { "alias": "options"; "required": false; }; "size": { "alias": "size"; "required": false; }; "id": { "alias": "id"; "required": false; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; }; "supportingText": { "alias": "supportingText"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "required": { "alias": "required"; "required": false; }; "error": { "alias": "error"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "hideLabel": { "alias": "hideLabel"; "required": false; }; "labelPosition": { "alias": "labelPosition"; "required": false; }; "inlineLabel": { "alias": "inlineLabel"; "required": false; }; "leadingIcon": { "alias": "leadingIcon"; "required": false; }; "optionsLeadingIcon": { "alias": "optionsLeadingIcon"; "required": false; }; }, { "valueChange": "valueChange"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
    static ngAcceptInputType_required: unknown;
    static ngAcceptInputType_error: unknown;
    static ngAcceptInputType_disabled: unknown;
    static ngAcceptInputType_hideLabel: unknown;
    static ngAcceptInputType_inlineLabel: unknown;
}