@geckoui/geckoui 2.0.5 → 2.1.0

package/dist/index.d.mts

@@ -8,6 +8,8 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
  * Reuseable hook to detect clicks outside of a ref element that is passed as an argument
  * @param handler - Function to be called when a click is detected outside of the component
  * @param refs - Ref objects to be checked for clicks outside
+ * @param open - Pass the overlay's open state to make it a layer: while open it only reacts
+ *   when it is the topmost open overlay, so a menu inside a drawer closes without the drawer
  * @returns void
  * @example
  *
@@ -25,7 +27,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
  * );
  * ```
  */
-declare const useClickOutside: <T extends HTMLElement>(handler?: (event: Event | MouseEvent | TouchEvent) => void, refs?: RefObject<T | null>[]) => void;
+declare const useClickOutside: <T extends HTMLElement>(handler?: (event: Event | MouseEvent | TouchEvent) => void, refs?: RefObject<T | null>[], open?: boolean) => void;
 
 interface FilePickerFile extends File {
     /** Preview URL of the file */
@@ -3115,6 +3117,15 @@ interface BaseSelectProps extends PropsWithChildren, SelectButtonProps {
      * Default is false
      * */
     filterable?: boolean | "inline" | "dropdown";
+    /**
+     * Focus the dropdown search box when the menu opens.
+     * Off by default: on a phone, focusing it pops up the keyboard over the options.
+     * Typing on a keyboard while the select is focused still moves into the search box.
+     * Only for `filterable` / `"dropdown"`; `"inline"` always focuses, since that is where
+     * you type.
+     * Default is false
+     * */
+    autoFocusSearch?: boolean;
     /**
      * Whether to close the menu when an option is selected
      * Default is true for single select and false for multi select
@@ -3213,6 +3224,14 @@ interface SelectContextProps<T> extends Pick<BaseSelectProps, "disabled" | "pref
      * If you use custom `SelectButton` you should bind this to the input
      * */
     keyword: string;
+    /**
+     * Bumped when the dropdown search box should take focus
+     * */
+    searchFocusRequest: number;
+    /**
+     * Move focus into the dropdown search box
+     * */
+    requestSearchFocus: () => void;
     /**
      * Setter for filter keyword
      * */

package/dist/index.d.ts

@@ -8,6 +8,8 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
  * Reuseable hook to detect clicks outside of a ref element that is passed as an argument
  * @param handler - Function to be called when a click is detected outside of the component
  * @param refs - Ref objects to be checked for clicks outside
+ * @param open - Pass the overlay's open state to make it a layer: while open it only reacts
+ *   when it is the topmost open overlay, so a menu inside a drawer closes without the drawer
  * @returns void
  * @example
  *
@@ -25,7 +27,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
  * );
  * ```
  */
-declare const useClickOutside: <T extends HTMLElement>(handler?: (event: Event | MouseEvent | TouchEvent) => void, refs?: RefObject<T | null>[]) => void;
+declare const useClickOutside: <T extends HTMLElement>(handler?: (event: Event | MouseEvent | TouchEvent) => void, refs?: RefObject<T | null>[], open?: boolean) => void;
 
 interface FilePickerFile extends File {
     /** Preview URL of the file */
@@ -3115,6 +3117,15 @@ interface BaseSelectProps extends PropsWithChildren, SelectButtonProps {
      * Default is false
      * */
     filterable?: boolean | "inline" | "dropdown";
+    /**
+     * Focus the dropdown search box when the menu opens.
+     * Off by default: on a phone, focusing it pops up the keyboard over the options.
+     * Typing on a keyboard while the select is focused still moves into the search box.
+     * Only for `filterable` / `"dropdown"`; `"inline"` always focuses, since that is where
+     * you type.
+     * Default is false
+     * */
+    autoFocusSearch?: boolean;
     /**
      * Whether to close the menu when an option is selected
      * Default is true for single select and false for multi select
@@ -3213,6 +3224,14 @@ interface SelectContextProps<T> extends Pick<BaseSelectProps, "disabled" | "pref
      * If you use custom `SelectButton` you should bind this to the input
      * */
     keyword: string;
+    /**
+     * Bumped when the dropdown search box should take focus
+     * */
+    searchFocusRequest: number;
+    /**
+     * Move focus into the dropdown search box
+     * */
+    requestSearchFocus: () => void;
     /**
      * Setter for filter keyword
      * */