@magicx-eng/ai-autocomplete-vanilla 0.46.0 → 0.47.0

package/README.md

@@ -953,6 +953,10 @@ When the open dropdown would run past the edge of the visible screen — most of
 
 While fitted, the dropdown root carries `data-aia-fit`, and the height it is capped at is in its `--aia-dropdown-fit-height` property. Every option shows in that one scroll, so the option list's usual limit of visible rows does not apply.
 
+### Dismissing the keyboard
+
+On a phone or tablet, the shopper can put the keyboard away to see the whole dropdown: a tap on the page, or the keyboard's own done / hide key, closes the keyboard and leaves the dropdown open. The next tap outside the search box and dropdown closes it. Scrolling the page doesn't, and neither does tapping inside the dropdown. A tap on a link, button or other field outside it is treated as moving on, and closes the dropdown straight away as before. With a mouse, a click outside closes the dropdown at once, as it always has. While the dropdown is held open this way, `isDropdownOpen` stays `true` and `isFocused` is `false`.
+
 ### Selector Hooks
 
 For styling beyond the CSS variables, target these stable `data-aia-*` attributes:

package/dist/index.d.mts

@@ -709,6 +709,13 @@ interface CoreInputState {
     skipNextFetch: boolean;
     lastRawQuery: string;
     isFocused: boolean;
+    /**
+     * The open dropdown stays up through a blur. Latched on while the panel is
+     * open and focused on a touch-primary device, and released by the next tap
+     * outside the widget, so dismissing the keyboard leaves the panel on screen.
+     * See controllers/holdOpenController.ts.
+     */
+    dropdownHeld: boolean;
     /**
      * Re-edit state: while non-null, the user is editing a bold completed param.
      * The snapshot stays here even after the param is removed from
@@ -1142,6 +1149,7 @@ declare class AIAutocomplete {
     private fetchController;
     private keyboardController;
     private pillsController;
+    private holdOpen;
     private productsController;
     private optionSource;
     private reEdit;

package/dist/index.d.ts

@@ -709,6 +709,13 @@ interface CoreInputState {
     skipNextFetch: boolean;
     lastRawQuery: string;
     isFocused: boolean;
+    /**
+     * The open dropdown stays up through a blur. Latched on while the panel is
+     * open and focused on a touch-primary device, and released by the next tap
+     * outside the widget, so dismissing the keyboard leaves the panel on screen.
+     * See controllers/holdOpenController.ts.
+     */
+    dropdownHeld: boolean;
     /**
      * Re-edit state: while non-null, the user is editing a bold completed param.
      * The snapshot stays here even after the param is removed from
@@ -1142,6 +1149,7 @@ declare class AIAutocomplete {
     private fetchController;
     private keyboardController;
     private pillsController;
+    private holdOpen;
     private productsController;
     private optionSource;
     private reEdit;