@aceshooting/lyra-ui 3.6.0 → 3.8.0

package/dist/components/voice-picker/voice-picker.class.d.ts

@@ -0,0 +1,241 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+/** A catalog row: a selectable TTS voice. */
+export interface LyraVoiceCatalogEntry {
+    id: string;
+    label: string;
+    /** 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;
+}
+/**
+ * Either every entry is a plain string (used as both id and label) or every entry is a full
+ * `{ id, label, ... }` row -- not a mix of both, mirroring `LyraModelCatalog`'s identical contract.
+ */
+export type LyraVoiceCatalog = string[] | LyraVoiceCatalogEntry[];
+export interface LyraVoicePickerEventMap {
+    'lyra-change': CustomEvent<{
+        value: string;
+        inCatalog: boolean;
+    }>;
+    'lyra-preview-request': CustomEvent<{
+        voiceId: string;
+        previewUrl?: string;
+    }>;
+    'lyra-preview-change': CustomEvent<{
+        voiceId: string | null;
+    }>;
+    input: CustomEvent<undefined>;
+    change: CustomEvent<undefined>;
+    blur: CustomEvent<undefined>;
+    focus: CustomEvent<undefined>;
+}
+/**
+ * `<lyra-voice-picker>` — a TTS voice selector over a host-supplied `catalog`, mirroring
+ * `lyra-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 is event-first: `lyra-preview-request` always fires first and is cancelable. 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 switches. `lyra-preview-change` reports internal
+ * playback start/stop (`voiceId: null` on stop/end/error).
+ *
+ * @customElement lyra-voice-picker
+ * @slot hint - Custom hint content.
+ * @slot error - Custom error content.
+ * @event lyra-change - `detail: { value: string; inCatalog: boolean }`.
+ * @event {Event} change - Fired alongside `lyra-change`, mirroring `lyra-model-select`'s native-style pair.
+ * @event {Event} input - Fired alongside `change`/`lyra-change`.
+ * @event blur - Re-dispatched from the free-text mode's internal `<input>`'s own `blur` (bubbling,
+ *   composed, unlike the native event).
+ * @event focus - Re-dispatched from the free-text mode's internal `<input>`'s own `focus`.
+ * @event lyra-preview-request - `detail: { voiceId: string; previewUrl?: string }`. Cancelable.
+ * @event lyra-preview-change - `detail: { voiceId: string | null }` — internal playback started
+ *   (`voiceId`) or stopped (`null`).
+ * @csspart form-control-label - The `<label>` element.
+ * @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.
+ */
+export declare class LyraVoicePicker extends LyraElement<LyraVoicePickerEventMap> {
+    static formAssociated: boolean;
+    static styles: import("lit").CSSResultGroup[];
+    static properties: {
+        disabled: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        required: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        value: {
+            noAccessor: boolean;
+        };
+        name: {
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+    };
+    /** Informational only (e.g. `'elevenlabs'`); rendered as a small leading badge. */
+    provider: string;
+    /** The full voice list. Omit (or leave empty) to fall back to plain free-text entry. */
+    catalog?: LyraVoiceCatalog;
+    /** Let the user type/commit a value that isn't in `catalog`, even when `catalog` is non-empty. */
+    allowCustom: boolean;
+    /** Whether to render preview affordances at all. */
+    preview: boolean;
+    label: string;
+    hint: string;
+    errorText: string;
+    placeholder: string;
+    spellcheck: boolean;
+    autocapitalize: string;
+    autoCorrect: string;
+    autocomplete: string;
+    inputMode: string;
+    enterKeyHint: string;
+    open: boolean;
+    private activeIndex;
+    private query;
+    private touched;
+    private hasHintSlot;
+    private hasErrorSlot;
+    /** The voiceId currently playing via the internal `<audio>` (`null` when nothing is). */
+    private previewingId;
+    private internals;
+    private validityController;
+    private listId;
+    private controlId;
+    private cleanup?;
+    private audioEl?;
+    private _value;
+    private _fieldsetDisabled;
+    private _name;
+    private _disabled;
+    private _required;
+    private _defaultValue;
+    constructor();
+    get form(): HTMLFormElement | null;
+    get labels(): NodeList;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    get willValidate(): boolean;
+    connectedCallback(): void;
+    protected willUpdate(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, old: string | null, val: string | null): void;
+    /** The current voice id (empty string when nothing is selected). */
+    get value(): string;
+    set value(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;
+    private updateValidity;
+    formResetCallback(): void;
+    formStateRestoreCallback(state: string | File | FormData | null, _mode?: 'restore' | 'autocomplete'): void;
+    formDisabledCallback(disabled: boolean): void;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    /** `catalog`, normalized to `{ id, label, ... }[]` regardless of the plain-string-array shorthand. */
+    private get normalizedCatalog();
+    /** 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();
+    private labelFor;
+    private show;
+    private hide;
+    private onDocPointer;
+    protected updated(changed: PropertyValues): void;
+    private commitValue;
+    /** Dispatches the platform-style value-event pair alongside `lyra-change`, mirroring
+     *  `lyra-model-select` so native form bindings and framework `v-model` handlers behave
+     *  consistently across the picker family. */
+    private emitValueEvents;
+    private selectEntry;
+    /** Enter in free-text mode: commit the highlighted suggestion, else the raw typed text. */
+    private commitFreeText;
+    /** 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;
+    /**
+     * A rejected `play()` or a media `error` event means only that *this specific* audio resource
+     * failed to load/play. It must not flip the public "playing" toggle out from under a caller who
+     * may have already toggled it off or requested a different voice by the time this settles --
+     * network timing is inherently unpredictable and racing it against user interaction would make
+     * the toggle state nondeterministic. Release the dead resource quietly instead of routing through
+     * `stopInternalPreview()`; the affordance stays pressed until the user's own next toggle or
+     * request clears it. `audioEl` already pointing elsewhere (or being unset) means a newer preview
+     * or an explicit stop has since superseded this resource, so this is a no-op.
+     */
+    private onAudioLoadFailure;
+    private stopInternalPreview;
+    private onPreviewButtonClick;
+    private onOptionPreviewClick;
+    private get previewButtonLabel();
+    private onTriggerClick;
+    private onTriggerBlur;
+    private onTriggerKeyDown;
+    private onComboMouseDown;
+    private onInputFocus;
+    private onInput;
+    private onInputBlur;
+    private onInputKeyDown;
+    private onListboxMouseDown;
+    private onListboxClick;
+    private renderRows;
+    private renderListbox;
+    private onHintSlotChange;
+    private onErrorSlotChange;
+    private renderLabel;
+    private renderHintError;
+    private renderPreviewButton;
+    private renderClosed;
+    private renderFreeText;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-voice-picker': LyraVoicePicker;
+    }
+}
+//# sourceMappingURL=voice-picker.class.d.ts.map

package/dist/components/voice-picker/voice-picker.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-picker.class.d.ts","sourceRoot":"","sources":["../../../src/components/voice-picker/voice-picker.class.ts"],"names":[],"mappings":"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"}