import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraSize}from'../../../internal/variants.js';import type{LyraSelectionDirection}from'../../../internal/shared-unions.js';import{type FormOwnerValue}from'../../../internal/form-associated.js';import{type LyraCatalog,type LyraCatalogEntry}from'../../../internal/catalog-picker.js';
/**
* `true`-defaulting boolean attribute converter for `preview`. Lit's built-in `type: Boolean`
* converter is presence-based -- the attribute's mere presence (regardless of its string value)
* maps to `true`, so a plain-markup consumer writing the literal `preview="false"` would actually
* get `true` (this property's default) -- the same bug class `spellcheckConverter` above and
* `<lr-checkpoint>`'s `restorable`/`confirmRestore` converters document and fix.
*/
/** A catalog row: a selectable TTS voice. */
export interface LyraVoiceCatalogEntry extends LyraCatalogEntry{
/** Rendered (with `description`) as a quiet `[part="option-meta"]` second line. */
language?:string;description?:string;
/** A sample-audio URL; validated via `safeMediaSrc()` before ever reaching an `<audio src>`. */
previewUrl?:string;}export type{LyraCatalog,LyraCatalogEntry}from'../../../internal/catalog-picker.js';
/** Direction reported by the free-text input's native selection APIs. */
export type LyraVoicePickerSelectionDirection=LyraSelectionDirection;export interface LyraVoicePickerEventMap{'lr-invalid':CustomEvent<null>;'lr-change':CustomEvent<{value:string;inCatalog:boolean;}>;'lr-preview-request':CustomEvent<{voiceId:string;previewUrl?:string;}>;'lr-preview-change':CustomEvent<{voiceId:string|null;}>;input:Event;change:Event;blur:FocusEvent;focus:FocusEvent;}
/**
* `<lr-voice-picker>` — a TTS voice selector over a host-supplied `catalog`, mirroring
* `lr-model-select`'s closed-dropdown/free-text-combobox dual mode, stale-value handling, and
* form-association verbatim (see that class's own doc for the full mode-switching contract this one
* shares), extended with a TTS-agnostic preview affordance: a standalone, always-tab-reachable
* `[part="preview-button"]` beside the trigger previews the active option while open, else the
* committed value; per-row `[part="option-preview"]` icons are pointer-only duplicates
* (`tabindex="-1"`, `aria-hidden="true"`) since a listbox option must not contain a focusable
* descendant.
*
* Preview requests are event-first relative to their new target: `lr-preview-request` is cancelable
* and fires before that target can start. Left un-prevented, a `previewUrl` plays through one
* internal native `<audio>` (the URL passes `safeMediaSrc()` first); `preventDefault()` or no URL
* leaves playback entirely to the host's own TTS. Requesting the same voice while it is already
* playing internally stops it instead of re-requesting; requesting a different voice retires the
* old resource (and publishes its terminal change) before the new request is dispatched.
* `lr-preview-change` reports internal playback start only after the current
* `audio.play()` promise fulfills, and reports `voiceId: null` on stop/end/error. A rejected pending
* play publishes neither a false start nor a false stop. Committed-value, active-option, and catalog
* changes likewise retire an internal preview before the visible preview control changes target;
* closing or filtering also retires a row-owned preview once no rendered control represents it.
*
* In free-text mode, `input` and the native selection/range-editing APIs expose the editable
* combobox text. `setRangeText()` synchronizes `value`, form data, and validity without emitting
* user-input events. These APIs are no-ops in closed-dropdown mode and before render.
* `readonly` keeps both combobox owners focusable and browseable while blocking user typing and
* catalog commits; selection/copy, voice previews, form submission/reset, and programmatic writes
* remain available.
* Catalog assignments become bounded, clone-owned, frozen snapshots. Create and reassign a new
* catalog array after changing its rows; mutating an assigned source does not update the picker.
*
* A catalog row may also set `disabled`, marking it non-actionable exactly like `lr-model-select`'s
* own catalog rows: `aria-disabled="true"` replaces its selected/active affordances, activating it
* (click or keyboard) commits nothing and changes no state, and arrow-key/Home/End
* active-descendant navigation steps past it instead of landing on it. It does not affect that
* row's own `[part="option-preview"]`, a separate affordance -- a disabled voice remains
* previewable so a listener can hear why it is excluded. Omitted or `false` renders the row exactly
* as before this field existed.
*
* @customElement lr-voice-picker
* @slot label - Custom visible label content.
* @slot hint - Custom hint content.
* @slot error - Custom error content.
* @cssstate required - Matches while `required` is set. Style with `lr-voice-picker:state(required)`.
* @cssstate optional - Matches while `required` is not set — the complement of `required`.
* @cssstate valid - Matches while the control satisfies its constraints, including any
* `setCustomValidity()` error.
* @cssstate invalid - Matches while it does not — from the very first render, before the user has
* touched anything.
* @cssstate user-valid - `valid`, but only after the user has interacted: a blur of the
* trigger/combobox, `reportValidity()`, or a submission attempt. Not after a silent
* `checkValidity()` alone.
* @cssstate user-invalid - `invalid` after that same interaction. Style validation errors with this
* rather than `invalid`: a pristine required picker is genuinely invalid, but colouring it red
* before the user has done anything is hostile.
* @event lr-change - `detail: { value: string; inCatalog: boolean }`.
* @event {Event} change - Owner-realm native event fired alongside `lr-change`, mirroring
*   `lr-model-select`'s native-style pair.
* @event {Event} input - A payload-preserving owner-realm `InputEvent` on each free-text edit, and
*   a plain native `Event` alongside `change` when either rendering mode commits a value.
* @event {FocusEvent} blur - Owner-realm native blur relayed when focus leaves the complete picker
*   boundary, retaining `relatedTarget`.
*   Moving between the trigger or input and the sibling preview control does not close/touch the
*   picker or emit this event.
* @event {FocusEvent} focus - Owner-realm native focus relayed when focus enters that complete
*   picker boundary, retaining `relatedTarget`.
* @event lr-preview-request - `detail: { voiceId: string; previewUrl?: string }`. Cancelable.
* @event lr-preview-change - `detail: { voiceId: string | null }` — internal playback started
*   (`voiceId`) or stopped (`null`).
* @event lr-invalid - The picker failed a validity check. Cancelable: calling `preventDefault()`
*   also cancels the native `invalid` event behind it, suppressing the browser's own validation
*   bubble so an app can present the failure its own way.
* @attr size - Visual size on the shared six-tier control ladder (`2xs`–`xl`, default `m`). The
*   `small`/`medium`/`large` aliases render as `s`/`m`/`l`. Preview actions retain the shared 40px
*   minimum hit area even when the field chrome uses a smaller tier.
* @csspart form-control - The complete label, control, hint, error, and listbox frame.
* @csspart form-control-label - The `<label>` element containing the `label` property and slot.
* @csspart trigger - The trigger button (closed-dropdown mode).
* @csspart combobox - The text-input container (free-text mode).
* @csspart combobox-input - The free-text `<input>`.
* @csspart provider-badge - The optional leading `provider` label.
* @csspart listbox - The options popover.
* @csspart option - An option row.
* @csspart option-label - An option row's label/meta wrapper.
* @csspart option-meta - An option row's quiet `language · description` second line.
* @csspart option-badge - The "not in catalog" badge on a synthetic stale-value row.
* @csspart option-preview - A pointer-only per-row preview icon (`tabindex="-1"`, `aria-hidden`).
* @csspart preview-button - The standalone, keyboard-reachable preview toggle beside the trigger.
* @csspart expand-icon - The dropdown indicator.
* @csspart empty - The empty-listbox message.
* @csspart hint - The hint message.
* @csspart error - The error message.
* @cssprop [--lr-voice-picker-max-inline-size=var(--lr-size-24rem)] - The host's own width
*   ceiling. Set a length to retune it, or `none` to let the control fill its container the way
*   `<lr-select>` does.
* @cssprop [--lr-voice-picker-trigger-min-height=var(--lr-form-control-height)] - Trigger/combobox
*   block-size floor. Reads the shared form-control height ladder, so retuning
*   `--lr-theme-form-control-height-*` moves this control and every sibling field together. The
*   preview action follows it, so raising the floor keeps the pair the same height; the action's
*   own WCAG hit-area floor still wins below `--lr-icon-button-size`.
* @cssprop --lr-voice-picker-trigger-height - Exact trigger/combobox height. Unset by default (a
*   floor only, via `-trigger-min-height`); set a length to both floor and cap the control, e.g. to
*   pixel-match a sibling field in the same toolbar row. Takes precedence over
*   `-trigger-min-height`, and the preview action follows whichever of the two is in play.
* @cssprop [--lr-voice-picker-gap=var(--lr-space-xs)] - Gap between the field and preview action,
*   and between trigger, combobox, and option children.
* @cssprop [--lr-voice-picker-radius=var(--lr-form-control-radius)] - Trigger, combobox, listbox,
*   option, and preview-action corner radius.
* @cssprop [--lr-voice-picker-preview-active-border=var(--lr-color-brand)] - Active preview border.
* @cssprop [--lr-voice-picker-preview-active-color=var(--lr-color-brand)] - Active preview icon.
* @cssprop [--lr-voice-picker-trigger-border-color=var(--lr-color-border)] - Resting trigger/combobox border color, independent of the open-state color below.
* @cssprop [--lr-voice-picker-trigger-fill=var(--lr-color-surface)] - Resting trigger/combobox background.
* @cssprop [--lr-voice-picker-open-border-color=var(--lr-color-brand)] - Open trigger border color.
* @cssprop [--lr-voice-picker-option-active-bg=var(--lr-color-brand-quiet)] - Active option fill.
* @cssprop [--lr-voice-picker-option-selected-border=var(--lr-color-brand)] - Selected option border.
* @cssprop [--lr-voice-picker-option-selected-color=var(--lr-color-brand)] - Selected option text.
* @cssprop [--lr-voice-picker-option-selected-bg=transparent] - Selected option fill.
* @cssprop [--lr-voice-picker-option-selected-font-weight=var(--lr-font-weight-semibold)] -
*   Selected option label weight.
* @cssprop [--lr-voice-picker-option-synthetic-border-style=dashed] - Border style of a synthetic
*   stale-value option row.
* @cssprop [--lr-voice-picker-option-synthetic-border-color=var(--lr-color-border)] - Border color
*   of a synthetic stale-value option row.
* @cssprop [--lr-voice-picker-option-synthetic-font-style=italic] - Font style of a synthetic
*   stale-value option label.
* @cssprop [--lr-voice-picker-option-disabled-opacity=0.5] - Opacity of an option row whose catalog
*   entry sets `disabled`.
* @cssprop [--lr-voice-picker-preview-hover-bg=var(--lr-color-brand-quiet)] - Shared hover/press
*   fill for the standalone and row preview actions.
* @cssprop [--lr-voice-picker-preview-hover-color=var(--lr-color-brand)] - Shared hover/press
*   icon color for the standalone and row preview actions.
* @cssprop [--lr-form-control-required-content=' *'] - The required marker appended to
*   `form-control-label` while `required` is set. Set it to `''` to suppress the marker, or to any
*   other quoted string (`' (required)'`, a localized word) to replace it.
* @cssprop [--lr-form-control-required-color=var(--lr-color-danger)] - Required-marker color,
*   themeable independently of error text and invalid borders.
* @cssprop [--lr-form-control-required-offset=0] - Inline space between the label text and the
*   required marker.
* @cssprop [--lr-overlay-surface=var(--lr-color-surface-overlay)] - Shared floating-surface fill,
* on the listbox.
* @cssprop [--lr-overlay-border=var(--lr-color-border)] - Shared floating-surface edge colour, on
* the listbox.
* @cssprop [--lr-overlay-radius=var(--lr-radius)] - Shared floating-surface corner radius, read by
* the listbox only as the middle arm of `--lr-voice-picker-radius`, which still wins when set.
* @cssprop [--lr-overlay-shadow-anchored=var(--lr-shadow-m)] - Elevation of the anchored surface.
* @status stable
* @since 4.0.0
*/
export declare class LyraVoicePicker extends LyraElement<LyraVoicePickerEventMap>{static formAssociated:boolean;static styles:import("lit").CSSResultGroup[];static properties:{customError:{attribute:string;reflect:boolean;noAccessor:boolean;};disabled:{type:BooleanConstructor;reflect:boolean;noAccessor:boolean;};required:{type:BooleanConstructor;reflect:boolean;noAccessor:boolean;};value:{attribute:boolean;noAccessor:boolean;};defaultValue:{attribute:string;reflect:boolean;useDefault:boolean;noAccessor:boolean;};name:{reflect:boolean;noAccessor:boolean;};};
/** Informational only (e.g. `'elevenlabs'`); rendered as a small leading badge. */
provider:string;
/** The bounded, clone-owned, frozen full voice list. Omit (or leave empty) to fall back to plain
*  free-text entry. Catalog ids must be nonempty and unique; later duplicates are omitted
*  entirely, first wins. A blank/whitespace-only id is never selectable, keyboard-reachable, or
*  previewable, but still renders as an inert trailing row rather than silently vanishing (see
*  `malformedCatalogEntries`). Replacing the catalog retires any internal preview before the
*  rendered candidate can change; reassign a new array after row changes. */
get catalog():LyraCatalog<LyraVoiceCatalogEntry> |undefined;set catalog(next:LyraCatalog<LyraVoiceCatalogEntry> |undefined);
/** Let the user type/commit a value that isn't in `catalog`, even when `catalog` is non-empty. */
allowCustom:boolean;
/** Keeps user edits and catalog commits from changing `value` while retaining focus, popup
*  navigation, selection/copy, previews, form submission, reset, and programmatic writes. */
readonly:boolean;
/** Whether to render preview affordances at all. */
preview:boolean;
/** Visible label text. The `label` slot appends custom label content to the same native label. */
label:string;hint:string;errorText:string;placeholder:string;spellcheck:boolean;autocapitalize:string;autoCorrect:string;autocomplete:string;inputMode:string;enterKeyHint:string;
/** Whether the catalog popup is open. Effectively disabled controls reject direct reopen
* attempts, including a synchronous fieldset cascade. */
get open():boolean;set open(next:boolean);
/** Visual size on the shared six-tier control ladder. `small`/`medium`/`large` alias
*  `s`/`m`/`l`; the preview action keeps the library-wide 40px minimum hit area. */
size:LyraSize;private get activeIndex();private get query();private touched;private readonly slotPresence;
/** The voiceId currently playing via the internal `<audio>` (`null` when nothing is). */
private previewingId;private internals;private validityController;
/** Consumer-supplied validation message reflected through `custom-error`. */
customError:string|null;private listId;private controlId;private audioEl?;
/** The target whose `play()` promise has not fulfilled yet. It never drives public playing
*  state; it exists solely to cancel/supersede stale async completions. */
private pendingPreviewId;private previewGeneration;private _catalog?;private _fieldsetDisabled;private _name;private _disabled;private _required;private transferControlFocus;private readonly catalogPicker;constructor();get form():HTMLFormElement|null;set form(owner:FormOwnerValue);
/** Returns the browser-resolved owning form, including an external owner selected by `form`. */
getForm():HTMLFormElement|null;get labels():NodeList;get validity():ValidityState;get validationMessage():string;get willValidate():boolean;
/**
* Forwards to whichever internal control the current mode renders, since
* `HTMLElement.prototype.click()` is otherwise a no-op on a custom element with no native click
* semantics of its own (mirrors `<lr-button>`'s identical forwarding override). Closed-dropdown
* mode forwards a real `.click()` to the trigger `<button>`, whose own `@click` handler opens
* it. Free-text mode instead calls `.focus()` on the combobox `<input>`: opening there is wired
* to the native `focus` event (`onInputFocus`), and unlike a `<button>`, a synthetic
* `.click()` on a text `<input>` does not itself dispatch `focus` -- browsers only focus a text
* control from a real click's `mousedown` default action, which `.click()` skips -- so
* `.focus()` is what actually reproduces a real click's end-user-visible effect here.
*/
click():void;focus(options?:FocusOptions):void;blur():void;
/** The native editable input in free-text mode, or `null` in closed-dropdown mode and before render. */
get input():HTMLInputElement|null;get selectionStart():number|null;set selectionStart(value:number|null);get selectionEnd():number|null;set selectionEnd(value:number|null);get selectionDirection():LyraVoicePickerSelectionDirection|null;set selectionDirection(value:LyraVoicePickerSelectionDirection|null);
/** Selects all editable text in free-text mode; otherwise a no-op. */
select():void;
/** Forwards the native selection range in free-text mode; otherwise a no-op. */
setSelectionRange(start:number|null,end:number|null,direction?:LyraVoicePickerSelectionDirection):void;setRangeText(replacement:string):void;setRangeText(replacement:string,start:number,end:number,selectMode?:SelectionMode):void;connectedCallback():void;protected willUpdate(changed:PropertyValues<this>):void;disconnectedCallback():void;adoptedCallback():void;
/** The current voice id (empty string when nothing is selected). */
get value():string;set value(next:string);
/** Reflected current reset default; changing it never overwrites a dirty live `value`. */
get defaultValue():string;set defaultValue(next:string);get name():string;set name(next:string);get disabled():boolean;set disabled(next:boolean);get required():boolean;set required(next:boolean);
/** Whether the control is disabled explicitly or by an ancestor fieldset. */
get effectiveDisabled():boolean;
/**
* Shared with every other form control: own `disabled`/`readonly` and a `<fieldset disabled>`
* ancestor bar constraint validation. A barred control matches
* neither `:valid` nor `:invalid` natively, so leaving `valueMissing` raised on a disabled
* required picker is what painted it red under the documented `:state(user-invalid)` rule.
*/
private get barredFromValidation();
/** The `!this.value` check here is deliberately NOT the `''`-as-missing-value truthiness defect
*  `<lr-select>`/`<lr-combobox>` were corrected for. There, `''` was a legitimate option value
*  being misread as "no value". `value` here is `catalogPicker.value`, and `normalizeCatalog()`
*  rejects a blank `id` outright, so `''` can never name a row -- it is this control's one
*  "nothing committed" sentinel, exactly as documented on `withSyntheticCatalogValue()`. */
private updateValidity;
/** Republishes the six validity custom states. Driven from every place validity or interaction
*  can move -- {@linkcode updateValidity}, `reportValidity()`, and `updated()` -- because this
*  control drives `ElementInternals` directly rather than through the `FormAssociated` mixin,
*  which does this for the controls that do use it. `touched` is the interaction flag: it flips
*  on the trigger's/input's first blur, and on interactive validation -- `reportValidity()` and
*  a submission attempt alike, via `installInteractionOnInvalid()`. A silent `checkValidity()`
*  alone never counts. */
private publishValidityStates;formResetCallback():void;formStateRestoreCallback(state:string|File|FormData|null,_mode?:'restore'|'autocomplete'):void;formDisabledCallback(disabled:boolean):void;private markInteracted;checkValidity():boolean;reportValidity():boolean;
/**
* Sets or clears a consumer-supplied validation error — the standard channel for a server-side
* rejection ("that voice is not enabled for your account") that no client-side constraint can
* express. A non-empty `message` raises `customError` and becomes `validationMessage`, so the
* control fails `checkValidity()`, blocks submission, and matches `:state(invalid)`; `''` clears
* it.
*
* Clearing restores the control's own computed validity rather than forcing it valid: a
* `required` picker with no value stays `valueMissing`. The custom error also survives every
* intrinsic recomputation in between (each `value`/`required` change re-runs `updateValidity()`)
* and a `form.reset()` — matching a native control, where only another `setCustomValidity('')`
* clears it.
*
* The message is caller-supplied content, so it is used verbatim and never localized here.
*/
setCustomValidity(message:string):void;
/** Closed-dropdown-with-listbox mode vs. free-text filterable mode — see class doc. */
private get closedMode();
/**
* `normalizedCatalog` plus, when `value` isn't one of its ids, a synthetic trailing row for it —
* recomputed from scratch on every access so it always reflects the *current* `catalog`/`value`,
* never a snapshot from whenever `value` happened to be assigned.
*/
private get effectiveEntries();
/** `effectiveEntries` filtered by the typed `query` (free-text mode only; id, label, language, or
*  description substring, case-insensitive). */
private get filteredEntries();
/**
* Raw `catalog` rows the shared controller drops as malformed (blank/whitespace `id`) --
* rendered as inert trailing options rather than silently vanishing, so a malformed row a host
* accidentally supplies is still visible for debugging. Never in `effectiveEntries`/
* `filteredEntries`, so never selectable, never keyboard-reachable, and never active: `entry.id`
* is always `''`, which `requestPreview()`'s `if (!voiceId) return;` guard and
* `handleListboxClick()`'s `visibleEntries` lookup both already treat as a no-op.
*/
private get malformedCatalogEntries();private labelFor;private show;private hide;protected updated(changed:PropertyValues):void;
/** Pending playback counts as the current target for cancellation/coherence, but not as public
*  playing state. */
private get internalPreviewTargetId();
/** Retires a row-owned preview once neither the standalone action nor a still-rendered row can
*  represent it. `open` is explicit so closing can reconcile before the reactive DOM changes. */
private reconcilePreviewVisibility;
/** Moves the active descendant and atomically retires playback if that move would otherwise make
*  the only visible preview control point at a different voice. */
private reconcilePreviewForActiveIndex;
/** The candidate the standalone preview button acts on: the active option while open, else the
*  committed value. */
private get previewCandidateId();private requestPreview;private playInternal;private onAudioEnded;
/**
* Releases exactly the resource that failed. A superseded resource cannot mutate the newer
* generation.
*
* Two distinct callers reach this, and they publish differently:
*  - A rejected `play()` (or a synchronous throw from calling it) means the browser never
*    genuinely attempted playback -- silent, because no public start was ever published for the
*    still-pending candidate.
*  - A genuine `error` event on `<audio>` means the browser *did* attempt to fetch/decode the
*    resource and that attempt failed -- distinct from `play()` merely rejecting (autoplay
*    policy, an interrupted request). If that arrives before the `play()` promise itself has
*    settled (a real race: `play()` resolving is not ordered against the element's own `error`
*    event), the still-pending candidate is published as started and immediately as stopped, so a
*    consumer never observes a bare stop with no matching start. Once already `previewingId`, the
*    existing publish stands and only the terminal stop is new.
*/
private onAudioLoadFailure;private stopInternalPreview;private onPreviewButtonClick;private onOptionPreviewClick;private get previewButtonLabel();private onTriggerClick;private onControlBlur;private onControlFocus;private onTriggerKeyDown;private onComboMouseDown;private onInputFocus;private onInput;private onInputKeyDown;private onListboxMouseDown;private onListboxClick;private renderRows;private renderListbox;private get hasVisibleLabel();private renderLabel;private renderHintError;private renderPreviewButton;private renderClosed;private renderFreeText;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-voice-picker':LyraVoicePicker;}}