@aceshooting/lyra-ui 2.1.0 → 2.3.0

package/dist/components/combobox/combobox.class.d.ts

@@ -0,0 +1,205 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { LyraOption } from './option.class.js';
+import './option.class.js';
+export type OptionFilter = (option: LyraOption, query: string) => boolean;
+export interface ComboboxSourceRow {
+    value: string;
+    label: string;
+    sub?: string;
+    dotColor?: string;
+    group?: string;
+    disabled?: boolean;
+}
+export type ComboboxSource = (query: string) => Promise<ComboboxSourceRow[]>;
+export interface LyraComboboxEventMap {
+    'lyra-show': CustomEvent<undefined>;
+    'lyra-hide': CustomEvent<undefined>;
+    'lyra-clear': CustomEvent<undefined>;
+}
+/**
+ * `<lyra-combobox>` — a filterable single/multi select that combines a text
+ * input with a listbox. Mirrors the core `<wa-combobox>` API under `lyra-`.
+ *
+ * Options are `<lyra-option value>` children. Emits native-style `change`/`input`
+ * (like Web Awesome) plus `lyra-show`/`lyra-hide`/`lyra-clear`.
+ *
+ * @customElement lyra-combobox
+ * @slot - `<lyra-option>` elements.
+ * @slot label - Custom label content.
+ * @slot hint - Custom hint content.
+ * @slot error - Custom error content.
+ * @event {Event} change - The selection changed through user interaction. A bubbling,
+ * composed, non-cancelable Event.
+ * @event {InputEvent | Event} input - The user typed in the filter or changed the selection. Text
+ * edits expose the original InputEvent; selection changes emit a bubbling,
+ * composed, non-cancelable Event.
+ * @event lyra-show - The listbox opened.
+ * @event lyra-hide - The listbox closed.
+ * @event lyra-clear - The value was cleared.
+ * @csspart form-control - The outer wrapper around label, combobox, listbox, error and hint.
+ * @csspart form-control-label - The `<label>` element.
+ * @csspart combobox - The input container (positioning anchor).
+ * @csspart combobox-input - The text input.
+ * @csspart listbox - The options popover.
+ * @csspart option - An option row.
+ * @csspart option-dot - An option row's leading status dot (when `dot-color` is set).
+ * @csspart option-label - An option row's label/sub wrapper.
+ * @csspart option-sub - An option row's secondary line (when `sub` is set).
+ * @csspart option-overflow - The "+N more" indicator shown when rows are capped by `maxRender`.
+ * @csspart tags - The multi-select tag container.
+ * @csspart tag - An individual selected tag.
+ * @csspart tag__remove-button - A tag's remove button.
+ * @csspart clear-button - The clear button.
+ * @csspart expand-icon - The dropdown indicator.
+ * @csspart error - The error message.
+ * @csspart hint - The hint message.
+ */
+export declare class LyraCombobox extends LyraElement<LyraComboboxEventMap> {
+    static formAssociated: boolean;
+    static styles: import("lit").CSSResultGroup[];
+    static properties: {
+        multiple: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        required: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        value: {
+            noAccessor: boolean;
+        };
+        name: {
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+    };
+    placeholder: string;
+    label: string;
+    hint: string;
+    errorText: string;
+    open: boolean;
+    withClear: boolean;
+    maxOptionsVisible: number;
+    emptyText: string;
+    /** Status copy shown in the listbox while a `source` fetch is in flight. */
+    loadingText: string;
+    /** Status copy shown when `maxRender` caps the row list; `{n}` is replaced with the hidden count. */
+    overflowText: string;
+    filter: OptionFilter | null;
+    source: ComboboxSource | null;
+    maxRender: number;
+    private query;
+    private activeIndex;
+    private options;
+    private touched;
+    private hasHintSlot;
+    private hasErrorSlot;
+    private hasLabelSlot;
+    private loading;
+    private asyncRows;
+    private sourceTimer?;
+    private sourceToken;
+    private _sourceWarmed;
+    private _selectedLabelCache;
+    private _rowsByValue;
+    private internals;
+    private validityController;
+    private _fieldsetDisabled;
+    private listId;
+    private inputId;
+    private cleanup?;
+    private _isFirstUpdate;
+    private _selected;
+    private _multiple;
+    private _disabled;
+    private _required;
+    private _defaultSelected;
+    private _defaultCaptured;
+    private _restoredStateActive;
+    private _name;
+    constructor();
+    get form(): HTMLFormElement | null;
+    get labels(): NodeList;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    get willValidate(): boolean;
+    connectedCallback(): void;
+    protected willUpdate(): void;
+    get name(): string;
+    set name(next: string);
+    get multiple(): boolean;
+    set multiple(next: boolean);
+    get disabled(): boolean;
+    set disabled(next: boolean);
+    get required(): boolean;
+    set required(next: boolean);
+    /** The selected value(s): a string in single mode, a string[] in `multiple` mode. */
+    get value(): string | string[];
+    set value(next: string | string[]);
+    private updateValidity;
+    private syncFormValue;
+    /** Effective disabled state: this element's own `disabled` OR an ancestor
+     *  `<fieldset disabled>`'s inherited state -- mirrors native `<input>`, whose
+     *  own `disabled` IDL property/attribute is never mutated by a fieldset. */
+    get effectiveDisabled(): boolean;
+    formResetCallback(): void;
+    formStateRestoreCallback(state: string | File | FormData | null, _mode?: 'restore' | 'autocomplete'): void;
+    /**
+     * Called by the browser when an ancestor `<fieldset disabled>` toggles.
+     * Tracked separately from the consumer's own `disabled` (see
+     * `effectiveDisabled`) so a consumer's explicit `disabled` survives the
+     * fieldset re-enabling instead of being permanently overwritten.
+     */
+    formDisabledCallback(disabled: boolean): void;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    disconnectedCallback(): void;
+    private collectOptions;
+    private onOptionChange;
+    private reflectSelected;
+    private labelFor;
+    /** The current row set in a source-agnostic shape, before capping. */
+    private get effectiveRows();
+    /** `effectiveRows` capped to `maxRender`, always keeping the current selection visible. */
+    private get renderedRows();
+    private get filtered();
+    private get displayValue();
+    private show;
+    private hide;
+    private onDocPointer;
+    protected updated(changed: PropertyValues): void;
+    /** Dispatches the platform-style value-event pair used by non-text user
+     * interactions. Text editing keeps and exposes the original InputEvent
+     * from the shadow input so its data/inputType metadata is not lost. */
+    private emitValueEvents;
+    private pickRow;
+    private removeValue;
+    private clear;
+    private onInput;
+    private runSource;
+    private onInputBlur;
+    private onHintSlotChange;
+    private onErrorSlotChange;
+    private onLabelSlotChange;
+    private onKeyDown;
+    private onComboMouseDown;
+    private onListboxMouseDown;
+    private onListboxClick;
+    private renderRows;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-combobox': LyraCombobox;
+    }
+}
+//# sourceMappingURL=combobox.class.d.ts.map

package/dist/components/combobox/combobox.class.d.ts.map

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