@emuanalytics/flow-rdf-ui 4.1.26 → 4.1.28

package/dist/index.d.mts

@@ -1985,6 +1985,19 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     private pendingChangeEvent;
     private pendingInputEvent;
     private hasOptions;
+    /** @internal True while the user is typing to filter (input text has diverged from the committed value). */
+    private inputChanged;
+    /** @internal Stable base used to generate option DOM ids when the host has no `id` of its own. */
+    private optionIdBase;
+    /** @internal Monotonic per-host suffix for option DOM ids, so ids never collide across re-renders. */
+    private nextOptionId;
+    /**
+     * @internal True while hide()'s close animation is in flight. `open` stays true across that
+     * animation (so the popup remains visible while it fades out), which would otherwise make a
+     * concurrent show() no-op at its `!this.open` guard. show() flips this to false to cancel the
+     * close and reopen; hide() bails after its animation if it finds the close was cancelled.
+     */
+    private closing;
     private readonly formControlController;
     /** The autocomplete's size */
     size: 'small' | 'medium' | 'large';
@@ -2044,7 +2057,9 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     hasFocus: boolean;
     private input;
     private popup;
+    private listbox;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     /** Gets the associated form, if one exists. */
     getForm(): HTMLFormElement | null;
     /** Gets the validity state object.*/
@@ -2063,10 +2078,31 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     private getFirstOption;
     /**
      * @internal
-     * Un-highlights currently highlighted option
-     * and highlights the given option
+     * Gives each slotted option a stable DOM `id` (`<host-id>-option-<n>`) used purely for
+     * ARIA wiring (`aria-activedescendant`). A consumer-provided `id` is preserved. This `id` is
+     * independent of the option's `value` (domain identity). See ADR-0001.
+     *
+     * The suffix comes from a monotonic per-host counter rather than the option's index: a filter
+     * re-render can retain some option elements while creating others, so an index-based suffix
+     * could hand a new element an id that a retained element already owns.
+     */
+    private assignOptionIds;
+    /**
+     * @internal
+     * Un-highlights currently highlighted option and highlights the given option.
+     *
+     * DOM focus stays on the `<input>` (per the APG editable-combobox pattern); the highlighted
+     * ("current") option is conveyed to assistive tech via the input's `aria-activedescendant`,
+     * not by moving focus. See ADR-0001.
      */
     private setCurrentOption;
+    /**
+     * @internal
+     * Sets the input's `aria-activedescendant` to the given option `id`, or clears it (to `''`,
+     * per the APG reference) when passed `null` or an empty id. Centralises the ARIA wiring so the
+     * highlight and close paths stay in sync. See ADR-0001.
+     */
+    private setActiveDescendant;
     /**
      * @internal
      * Unselects currently selected option
@@ -2108,6 +2144,17 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     private removeListenersForDropdown;
     /** @internal Handles changes in the default slot */
     private handleDefaultSlotChange;
+    /**
+     * @internal
+     * Establishes the highlighted ("current") option per the APG rules (ADR-0001):
+     * - while filtering (input text has changed): always the first option, so type-then-Enter
+     *   selects the narrowed-down top option.
+     * - on open with unchanged input: the selected option if one matches, else the first.
+     *
+     * Called both on slot change (list re-rendered) and on open (listbox shown without a
+     * re-render, e.g. clicking back into the input), since the latter fires no slot change.
+     */
+    private highlightCurrentOption;
     /** @internal Toggles listbox based on focus and options in the default slot. */
     toggleListbox(): void;
     /**

package/dist/index.d.ts

@@ -1985,6 +1985,19 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     private pendingChangeEvent;
     private pendingInputEvent;
     private hasOptions;
+    /** @internal True while the user is typing to filter (input text has diverged from the committed value). */
+    private inputChanged;
+    /** @internal Stable base used to generate option DOM ids when the host has no `id` of its own. */
+    private optionIdBase;
+    /** @internal Monotonic per-host suffix for option DOM ids, so ids never collide across re-renders. */
+    private nextOptionId;
+    /**
+     * @internal True while hide()'s close animation is in flight. `open` stays true across that
+     * animation (so the popup remains visible while it fades out), which would otherwise make a
+     * concurrent show() no-op at its `!this.open` guard. show() flips this to false to cancel the
+     * close and reopen; hide() bails after its animation if it finds the close was cancelled.
+     */
+    private closing;
     private readonly formControlController;
     /** The autocomplete's size */
     size: 'small' | 'medium' | 'large';
@@ -2044,7 +2057,9 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     hasFocus: boolean;
     private input;
     private popup;
+    private listbox;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     /** Gets the associated form, if one exists. */
     getForm(): HTMLFormElement | null;
     /** Gets the validity state object.*/
@@ -2063,10 +2078,31 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     private getFirstOption;
     /**
      * @internal
-     * Un-highlights currently highlighted option
-     * and highlights the given option
+     * Gives each slotted option a stable DOM `id` (`<host-id>-option-<n>`) used purely for
+     * ARIA wiring (`aria-activedescendant`). A consumer-provided `id` is preserved. This `id` is
+     * independent of the option's `value` (domain identity). See ADR-0001.
+     *
+     * The suffix comes from a monotonic per-host counter rather than the option's index: a filter
+     * re-render can retain some option elements while creating others, so an index-based suffix
+     * could hand a new element an id that a retained element already owns.
+     */
+    private assignOptionIds;
+    /**
+     * @internal
+     * Un-highlights currently highlighted option and highlights the given option.
+     *
+     * DOM focus stays on the `<input>` (per the APG editable-combobox pattern); the highlighted
+     * ("current") option is conveyed to assistive tech via the input's `aria-activedescendant`,
+     * not by moving focus. See ADR-0001.
      */
     private setCurrentOption;
+    /**
+     * @internal
+     * Sets the input's `aria-activedescendant` to the given option `id`, or clears it (to `''`,
+     * per the APG reference) when passed `null` or an empty id. Centralises the ARIA wiring so the
+     * highlight and close paths stay in sync. See ADR-0001.
+     */
+    private setActiveDescendant;
     /**
      * @internal
      * Unselects currently selected option
@@ -2108,6 +2144,17 @@ declare class FlowUiAutocomplete extends FlowRdfFormControl {
     private removeListenersForDropdown;
     /** @internal Handles changes in the default slot */
     private handleDefaultSlotChange;
+    /**
+     * @internal
+     * Establishes the highlighted ("current") option per the APG rules (ADR-0001):
+     * - while filtering (input text has changed): always the first option, so type-then-Enter
+     *   selects the narrowed-down top option.
+     * - on open with unchanged input: the selected option if one matches, else the first.
+     *
+     * Called both on slot change (list re-rendered) and on open (listbox shown without a
+     * re-render, e.g. clicking back into the input), since the latter fires no slot change.
+     */
+    private highlightCurrentOption;
     /** @internal Toggles listbox based on focus and options in the default slot. */
     toggleListbox(): void;
     /**

package/dist/package.json.mjs

@@ -1,3 +1,3 @@
-const version = "4.1.26";
+const version = "4.1.28";
 
 export { version };