@ledgerhq/lumen-ui-react 0.1.23 → 0.1.25

package/dist/lib/Components/Select/Select.js

@@ -1,29 +1,30 @@
-import { jsx as t, jsxs as d } from "react/jsx-runtime";
-import { useDisabledContext as q, cn as l } from "../../../libs/utils-shared/dist/index.js";
-import { cva as z } from "class-variance-authority";
-import { useLayoutEffect as D } from "react";
-import { SelectProvider as G, useSelectContext as m } from "./SelectContext.js";
-import { useControllableState as k } from "../../../utils/useControllableState/useControllableState.js";
-import { useSelectItems as E } from "./useSelectItems/useSelectItems.js";
-import { SearchInput as F } from "../SearchInput/SearchInput.js";
-import { Check as W } from "../../Symbols/Icons/Check.js";
-import { Divider as A } from "../Divider/Divider.js";
-import { ChevronDown as B } from "../../Symbols/Icons/ChevronDown.js";
-import { ComboboxRoot as H } from "../../../node_modules/@base-ui/react/esm/combobox/root/ComboboxRoot.js";
-import { ComboboxTrigger as b } from "../../../node_modules/@base-ui/react/esm/combobox/trigger/ComboboxTrigger.js";
-import { ComboboxPortal as J } from "../../../node_modules/@base-ui/react/esm/combobox/portal/ComboboxPortal.js";
-import { ComboboxPositioner as K } from "../../../node_modules/@base-ui/react/esm/combobox/positioner/ComboboxPositioner.js";
-import { ComboboxPopup as M } from "../../../node_modules/@base-ui/react/esm/combobox/popup/ComboboxPopup.js";
-import { ComboboxInput as O } from "../../../node_modules/@base-ui/react/esm/combobox/input/ComboboxInput.js";
-import { ComboboxList as Q } from "../../../node_modules/@base-ui/react/esm/combobox/list/ComboboxList.js";
-import { ComboboxGroup as U } from "../../../node_modules/@base-ui/react/esm/combobox/group/ComboboxGroup.js";
-import { ComboboxCollection as X } from "../../../node_modules/@base-ui/react/esm/combobox/collection/ComboboxCollection.js";
-import { ComboboxItem as Y } from "../../../node_modules/@base-ui/react/esm/combobox/item/ComboboxItem.js";
-import { ComboboxItemIndicator as Z } from "../../../node_modules/@base-ui/react/esm/combobox/item-indicator/ComboboxItemIndicator.js";
-import { ComboboxEmpty as _ } from "../../../node_modules/@base-ui/react/esm/combobox/empty/ComboboxEmpty.js";
-import { ComboboxValue as f } from "../../../node_modules/@base-ui/react/esm/combobox/value/ComboboxValue.js";
-import { ComboboxGroupLabel as $ } from "../../../node_modules/@base-ui/react/esm/combobox/group-label/ComboboxGroupLabel.js";
-function qe({
+import { jsx as t, jsxs as m } from "react/jsx-runtime";
+import { useDisabledContext as E, cn as l } from "../../../libs/utils-shared/dist/index.js";
+import { cva as G } from "class-variance-authority";
+import { useLayoutEffect as k } from "react";
+import { SelectProvider as F, useSelectContext as u } from "./SelectContext.js";
+import { useControllableState as M } from "../../../utils/useControllableState/useControllableState.js";
+import { useSelectItems as W } from "./useSelectItems/useSelectItems.js";
+import { resolveValue as b } from "./utils/groupItems.js";
+import { SearchInput as A } from "../SearchInput/SearchInput.js";
+import { Check as B } from "../../Symbols/Icons/Check.js";
+import { Divider as H } from "../Divider/Divider.js";
+import { ChevronDown as J } from "../../Symbols/Icons/ChevronDown.js";
+import { ComboboxRoot as K } from "../../../node_modules/@base-ui/react/esm/combobox/root/ComboboxRoot.js";
+import { ComboboxTrigger as h } from "../../../node_modules/@base-ui/react/esm/combobox/trigger/ComboboxTrigger.js";
+import { ComboboxPortal as O } from "../../../node_modules/@base-ui/react/esm/combobox/portal/ComboboxPortal.js";
+import { ComboboxPositioner as Q } from "../../../node_modules/@base-ui/react/esm/combobox/positioner/ComboboxPositioner.js";
+import { ComboboxPopup as U } from "../../../node_modules/@base-ui/react/esm/combobox/popup/ComboboxPopup.js";
+import { ComboboxInput as X } from "../../../node_modules/@base-ui/react/esm/combobox/input/ComboboxInput.js";
+import { ComboboxList as Y } from "../../../node_modules/@base-ui/react/esm/combobox/list/ComboboxList.js";
+import { ComboboxGroup as Z } from "../../../node_modules/@base-ui/react/esm/combobox/group/ComboboxGroup.js";
+import { ComboboxCollection as _ } from "../../../node_modules/@base-ui/react/esm/combobox/collection/ComboboxCollection.js";
+import { ComboboxItem as $ } from "../../../node_modules/@base-ui/react/esm/combobox/item/ComboboxItem.js";
+import { ComboboxItemIndicator as ee } from "../../../node_modules/@base-ui/react/esm/combobox/item-indicator/ComboboxItemIndicator.js";
+import { ComboboxEmpty as te } from "../../../node_modules/@base-ui/react/esm/combobox/empty/ComboboxEmpty.js";
+import { ComboboxValue as x } from "../../../node_modules/@base-ui/react/esm/combobox/value/ComboboxValue.js";
+import { ComboboxGroupLabel as oe } from "../../../node_modules/@base-ui/react/esm/combobox/group-label/ComboboxGroupLabel.js";
+function Ge({
   value: o,
   defaultValue: a,
   onValueChange: e,
@@ -32,96 +33,104 @@ function qe({
   filter: n,
   filteredItems: i,
   searchValue: c,
-  defaultSearchValue: u,
-  onSearchValueChange: h,
-  open: x,
-  defaultOpen: g,
-  onOpenChange: S,
-  name: y,
-  required: v,
-  children: C
+  defaultSearchValue: p,
+  onSearchValueChange: g,
+  open: S,
+  defaultOpen: y,
+  onOpenChange: v,
+  name: C,
+  required: N,
+  children: w
 }) {
-  const N = q({
+  const I = E({
     consumerName: "Select",
     mergeWith: { disabled: r }
-  }), [p, w] = k(
+  }), [f, V] = M(
     {
       prop: o,
       defaultProp: a ?? null,
-      onChange: (j) => {
-        e?.(j);
+      onChange: (d) => {
+        e?.(d);
       }
     }
   ), {
-    isGrouped: I,
-    groupedItems: V,
-    filteredItemsForRoot: L,
-    resolvedSearchValue: R,
-    registerSearch: T,
-    handleSearchValueChange: P
-  } = E({
+    isGrouped: T,
+    groupedItems: L,
+    filteredItemsForRoot: R,
+    resolvedSearchValue: q,
+    searchMounted: P,
+    registerSearch: j,
+    handleSearchValueChange: z
+  } = W({
     items: s,
     filter: n,
     filteredItems: i,
     searchValue: c,
-    defaultSearchValue: u,
-    onSearchValueChange: h
+    defaultSearchValue: p,
+    onSearchValueChange: g
   });
   return /* @__PURE__ */ t(
-    H,
+    K,
     {
       "data-slot": "select",
       filter: null,
-      items: V ?? s,
-      filteredItems: L,
-      inputValue: R,
-      onInputValueChange: P,
-      value: p,
-      onValueChange: w,
-      open: x,
-      defaultOpen: g,
-      onOpenChange: S,
-      name: y,
-      required: v,
-      disabled: N,
-      children: /* @__PURE__ */ t(G, { value: { selectedValue: p, registerSearch: T, isGrouped: I }, children: C })
+      items: L ?? s,
+      filteredItems: R,
+      inputValue: q,
+      onInputValueChange: z,
+      value: f,
+      onValueChange: (d) => V(b(d)),
+      isItemEqualToValue: (d, D) => b(d) === b(D),
+      open: S,
+      defaultOpen: y,
+      onOpenChange: v,
+      name: C,
+      required: N,
+      disabled: I,
+      children: /* @__PURE__ */ t(
+        F,
+        {
+          value: { selectedValue: f, registerSearch: j, isGrouped: T, searchMounted: P },
+          children: w
+        }
+      )
     }
   );
 }
-const ee = l(
+const ae = l(
   "group relative flex h-48 w-full cursor-pointer items-center justify-between gap-8",
   "rounded-sm bg-muted px-16",
   "body-2 text-base",
   "hover:bg-muted-hover",
   "transition-colors duration-200 focus:ring-2 focus:ring-active focus:outline-hidden",
   "disabled:cursor-not-allowed disabled:text-disabled"
-), te = l(
+), re = l(
   "pointer-events-none absolute left-16 origin-left text-muted transition-all duration-300",
   "top-10 -translate-y-4 body-4",
   "group-data-placeholder:top-14 group-data-placeholder:translate-y-0 group-data-placeholder:body-2",
   "group-data-disabled:text-disabled",
   "max-w-[calc(100%-var(--size-56))] truncate"
-), oe = ({
+), le = ({
   ref: o,
   className: a,
   labelClassName: e,
   label: r,
   ...s
 }) => {
-  const { selectedValue: n } = m({
+  const { selectedValue: n } = u({
     consumerName: "SelectInputTrigger",
     contextRequired: !0
   }), i = n != null && n !== "";
-  return /* @__PURE__ */ d(
-    b,
+  return /* @__PURE__ */ m(
+    h,
     {
       ref: o,
       "data-slot": "select-trigger",
       "data-placeholder": i ? void 0 : "",
-      className: l(ee, a),
+      className: l(ae, a),
       ...s,
       children: [
-        r && /* @__PURE__ */ t("label", { className: l(te, e), children: r }),
+        r && /* @__PURE__ */ t("label", { className: l(re, e), children: r }),
         /* @__PURE__ */ t(
           "span",
           {
@@ -130,11 +139,11 @@ const ee = l(
               r && "mt-16 opacity-100 transition-opacity delay-100 duration-300",
               r && !i && "mt-0 opacity-0"
             ),
-            children: /* @__PURE__ */ t(f, {})
+            children: /* @__PURE__ */ t(x, {})
           }
         ),
         /* @__PURE__ */ t(
-          B,
+          J,
           {
             size: 20,
             className: "text-muted group-data-disabled:text-disabled"
@@ -143,21 +152,21 @@ const ee = l(
       ]
     }
   );
-}, ze = ({ render: o, disabled: a, ...e }) => {
-  const { selectedValue: r } = m({
+}, ke = ({ render: o, disabled: a, ...e }) => {
+  const { selectedValue: r } = u({
     consumerName: "SelectTrigger",
     contextRequired: !0
-  }), s = /* @__PURE__ */ t(f, {});
+  }), s = /* @__PURE__ */ t(x, {});
   return o ? /* @__PURE__ */ t(
-    b,
+    h,
     {
       disabled: a,
       ref: e.ref,
       "data-slot": "select-trigger",
       render: o({ selectedValue: r, selectedContent: s })
     }
-  ) : /* @__PURE__ */ t(oe, { ...e, disabled: a });
-}, ae = z(
+  ) : /* @__PURE__ */ t(le, { ...e, disabled: a });
+}, se = G(
   [
     "group/select-content relative flex max-h-(--available-height) w-(--anchor-width) flex-col overflow-hidden",
     "rounded-sm bg-surface",
@@ -185,17 +194,17 @@ const ee = l(
       }
     }
   }
-), De = ({
+), Fe = ({
   ref: o,
   className: a,
   children: e,
   side: r = "bottom",
   sideOffset: s = 8,
   align: n = "start",
-  autoFocusSearch: i = !1,
+  initialFocus: i = !0,
   ...c
-}) => /* @__PURE__ */ t(J, { "data-slot": "select-portal", children: /* @__PURE__ */ t(
-  K,
+}) => /* @__PURE__ */ t(O, { "data-slot": "select-portal", children: /* @__PURE__ */ t(
+  Q,
   {
     "data-slot": "select-positioner",
     className: "pointer-events-auto z-select",
@@ -203,61 +212,61 @@ const ee = l(
     sideOffset: s,
     align: n,
     children: /* @__PURE__ */ t(
-      M,
+      U,
       {
         ref: o,
         "data-slot": "select-content",
-        initialFocus: i ? void 0 : !1,
-        className: l(ae({ side: r }), a),
+        initialFocus: i,
+        className: l(se({ side: r }), a),
         ...c,
         children: e
       }
     )
   }
-) }), Ge = ({
+) }), Me = ({
   ref: o,
   className: a,
   renderItem: e,
   ...r
 }) => {
-  const { isGrouped: s } = m({
+  const { isGrouped: s } = u({
     consumerName: "SelectList",
     contextRequired: !0
   });
   return /* @__PURE__ */ t(
-    Q,
+    Y,
     {
       ref: o,
       "data-slot": "select-list",
       className: l(
-        "min-h-0 min-w-(--anchor-width) flex-1 overflow-y-auto p-8 group-data-empty/select-content:p-0",
+        "min-h-0 min-w-(--anchor-width) flex-1 overflow-y-auto p-8 group-data-empty/select-content:p-0 focus:ring-0 focus:outline-hidden",
         a
       ),
       ...r,
-      children: s ? (n, i) => /* @__PURE__ */ d(
-        U,
+      children: s ? (n, i) => /* @__PURE__ */ m(
+        Z,
         {
           items: n.items,
           "data-slot": "select-group",
           children: [
-            i > 0 && /* @__PURE__ */ t(se, {}),
-            n.label && /* @__PURE__ */ t(re, { children: n.label }),
-            /* @__PURE__ */ t(X, { children: e })
+            i > 0 && /* @__PURE__ */ t(ce, {}),
+            n.label && /* @__PURE__ */ t(ne, { children: n.label }),
+            /* @__PURE__ */ t(_, { children: e })
           ]
         },
         n.label
       ) : e
     }
   );
-}, re = ({ ref: o, className: a, ...e }) => /* @__PURE__ */ t(
-  $,
+}, ne = ({ ref: o, className: a, ...e }) => /* @__PURE__ */ t(
+  oe,
   {
     ref: o,
     "data-slot": "select-label",
     className: l("mb-4 px-8 pt-8 pb-0 body-3-semi-bold text-muted", a),
     ...e
   }
-), le = l(
+), ie = l(
   "group/item flex w-full min-w-0 cursor-pointer items-center gap-12 bg-base-transparent select-none",
   "rounded-sm p-8",
   "body-2 text-base",
@@ -265,28 +274,28 @@ const ee = l(
   "data-highlighted:bg-base-transparent-hover",
   "active:bg-base-transparent-pressed",
   "data-disabled:cursor-not-allowed data-disabled:text-disabled"
-), ke = ({
+), We = ({
   ref: o,
   className: a,
   children: e,
   ...r
-}) => /* @__PURE__ */ d(
-  Y,
+}) => /* @__PURE__ */ m(
+  $,
   {
     ref: o,
     "data-slot": "select-item",
-    className: l(le, a),
+    className: l(ie, a),
     ...r,
     children: [
       e,
-      /* @__PURE__ */ t(Z, { className: "ml-auto flex shrink-0 items-center justify-center", children: /* @__PURE__ */ t(W, { size: 24, className: "shrink-0 text-active" }) })
+      /* @__PURE__ */ t(ee, { className: "ml-auto flex shrink-0 items-center justify-center", children: /* @__PURE__ */ t(B, { size: 24, className: "shrink-0 text-active" }) })
     ]
   }
-), se = ({
+), ce = ({
   ref: o,
   className: a,
   ...e
-}) => /* @__PURE__ */ t(A, { ref: o, className: l("mx-8 my-4 w-auto", a), ...e }), Ee = ({ ref: o, className: a, ...e }) => /* @__PURE__ */ t(
+}) => /* @__PURE__ */ t(H, { ref: o, className: l("mx-8 my-4 w-auto", a), ...e }), Ae = ({ ref: o, className: a, ...e }) => /* @__PURE__ */ t(
   "span",
   {
     ref: o,
@@ -294,7 +303,7 @@ const ee = l(
     className: l("truncate body-2", a),
     ...e
   }
-), Fe = ({
+), Be = ({
   ref: o,
   className: a,
   children: e,
@@ -308,7 +317,7 @@ const ee = l(
     ...r,
     children: e
   }
-), We = ({
+), He = ({
   ref: o,
   className: a,
   children: e,
@@ -326,7 +335,7 @@ const ee = l(
     ...r,
     children: e
   }
-), Ae = ({
+), Je = ({
   className: o,
   placeholder: a = "Search",
   errorMessage: e,
@@ -335,17 +344,17 @@ const ee = l(
   onClear: n,
   hideClearButton: i
 }) => {
-  const { registerSearch: c } = m({
+  const { registerSearch: c } = u({
     consumerName: "SelectSearch",
     contextRequired: !0
   });
-  return D(() => c(), [c]), /* @__PURE__ */ t(
-    O,
+  return k(() => c(), [c]), /* @__PURE__ */ t(
+    X,
     {
-      render: (u) => /* @__PURE__ */ t(
-        F,
+      render: (p) => /* @__PURE__ */ t(
+        A,
         {
-          ...u,
+          ...p,
           "aria-invalid": r,
           errorMessage: e,
           suffix: s,
@@ -358,14 +367,14 @@ const ee = l(
       )
     }
   );
-}, Be = ({
+}, Ke = ({
   ref: o,
   className: a,
   title: e,
   description: r,
   ...s
-}) => /* @__PURE__ */ d(
-  _,
+}) => /* @__PURE__ */ m(
+  te,
   {
     ref: o,
     "data-slot": "select-empty-state",
@@ -382,15 +391,15 @@ const ee = l(
   }
 );
 export {
-  qe as Select,
-  De as SelectContent,
-  Be as SelectEmptyState,
-  ke as SelectItem,
-  Fe as SelectItemContent,
-  We as SelectItemDescription,
-  Ee as SelectItemText,
-  Ge as SelectList,
-  Ae as SelectSearch,
-  se as SelectSeparator,
-  ze as SelectTrigger
+  Ge as Select,
+  Fe as SelectContent,
+  Ke as SelectEmptyState,
+  We as SelectItem,
+  Be as SelectItemContent,
+  He as SelectItemDescription,
+  Ae as SelectItemText,
+  Me as SelectList,
+  Je as SelectSearch,
+  ce as SelectSeparator,
+  ke as SelectTrigger
 };

package/dist/lib/Components/Select/SelectContext.d.ts

@@ -2,6 +2,7 @@ type SelectContextValue = {
     selectedValue: string | null;
     registerSearch: () => () => void;
     isGrouped: boolean;
+    searchMounted: boolean;
 };
 export declare const SelectProvider: import('react').FC<{
     children: import('react').ReactNode;

package/dist/lib/Components/Select/SelectContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectContext.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Select/SelectContext.tsx"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,MAAM,IAAI,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAO,cAAc;;;IAAE,gBAAgB;;;qFACG,CAAC"}
+{"version":3,"file":"SelectContext.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Select/SelectContext.tsx"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,MAAM,IAAI,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,eAAO,MAAO,cAAc;;;IAAE,gBAAgB;;;qFACG,CAAC"}

package/dist/lib/Components/Select/index.d.ts

@@ -1,3 +1,3 @@
 export * from './Select';
-export type { SelectItemData, SelectProps, SelectTriggerProps, SelectTriggerRenderProps, SelectContentProps, SelectSearchProps, SelectListProps, SelectItemTextProps, SelectItemContentProps, SelectItemDescriptionProps, SelectItemProps, SelectSeparatorProps, SelectEmptyStateProps, } from './types';
+export type { MetaShape, SelectItemData, SelectProps, SelectTriggerProps, SelectTriggerRenderProps, SelectContentProps, SelectSearchProps, SelectListProps, SelectItemTextProps, SelectItemContentProps, SelectItemDescriptionProps, SelectItemProps, SelectSeparatorProps, SelectEmptyStateProps, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/Components/Select/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Select/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,YAAY,EACV,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Select/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,YAAY,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/lib/Components/Select/types.d.ts

@@ -1,6 +1,7 @@
-import { ComponentPropsWithRef, ReactElement, ReactNode } from 'react';
+import { ComponentPropsWithRef, ReactElement, ReactNode, RefObject } from 'react';
 import { SearchInputProps } from '../SearchInput/types';
-export type SelectItemData<Meta = Record<string, unknown>> = {
+export type MetaShape = Record<string, unknown>;
+export type SelectItemData<TMeta extends MetaShape = MetaShape> = {
     /** Unique string identifier for this item, used for selection tracking. */
     value: string;
     /** Display text used in the trigger. Also the field matched against by the default search filter. */
@@ -23,14 +24,14 @@ export type SelectItemData<Meta = Record<string, unknown>> = {
      * Use it to carry extra fields (icons, tickers, IDs, etc.)
      * that your render function or custom filter needs.
      */
-    meta?: Meta;
+    meta?: TMeta;
 };
 /** @internal A named group of select items, used to represent a resolved group with its header label and child items. */
-export type SelectItemGroup = {
+export type SelectItemGroup<TMeta extends MetaShape = MetaShape> = {
     /** The displayed group name, matching the `group` field on each child item. */
     label: string;
     /** The items belonging to this group. */
-    items: SelectItemData[];
+    items: SelectItemData<TMeta>[];
 };
 export type SelectTriggerRenderProps = {
     /**
@@ -42,7 +43,7 @@ export type SelectTriggerRenderProps = {
      */
     selectedContent: ReactNode;
 };
-export type SelectProps = {
+export type SelectProps<TMeta extends MetaShape = MetaShape> = {
     /**
      * The children of the select.
      */
@@ -58,7 +59,7 @@ export type SelectProps = {
      * them by that value, rendering group headers, separators, and per-group
      * collection iteration internally.
      */
-    items: SelectItemData[];
+    items: SelectItemData<TMeta>[];
     /**
      * Filter function used to match items against a search query.
      * When `SelectSearch` is rendered inside the content, a default case-insensitive
@@ -69,13 +70,13 @@ export type SelectProps = {
      * items within each group. Empty groups are automatically hidden.
      * @default undefined
      */
-    filter?: null | ((item: SelectItemData, query: string) => boolean);
+    filter?: null | ((item: SelectItemData<TMeta>, query: string) => boolean);
     /**
      * Pre-filtered items to display in the list. When provided, the component uses
      * these items directly instead of filtering `items` internally. Use alongside
      * `onSearchValueChange` for async/remote search where the server handles filtering.
      */
-    filteredItems?: SelectItemData[];
+    filteredItems?: SelectItemData<TMeta>[];
     /**
      * The controlled search input value.
      * Should be used in conjunction with `onSearchValueChange`.
@@ -182,12 +183,17 @@ export type SelectContentProps = {
      */
     className?: string;
     /**
-     * When true, the search input receives focus automatically when the dropdown opens.
-     * @default false
+     * Determines the element to focus when the popover is opened.
+     *
+     * - `false`: Do not move focus.
+     * - `true`: Move focus based on the default behavior (first tabbable element of the select content).
+     * - `RefObject`: Move focus to the ref element.
+     *
+     * @default true
      */
-    autoFocusSearch?: boolean;
+    initialFocus?: boolean | RefObject<HTMLElement | null>;
 } & ComponentPropsWithRef<'div'>;
-export type SelectListProps = {
+export type SelectListProps<TMeta extends MetaShape = MetaShape> = {
     /**
      * A render function that receives each item and its index, returning a ReactNode.
      *
@@ -196,7 +202,7 @@ export type SelectListProps = {
      * is handled automatically by `SelectList`.
      * @example renderItem={(item) => <SelectItem value={item.value}>{item.label}</SelectItem>}
      */
-    renderItem: (item: SelectItemData, index: number) => ReactNode;
+    renderItem: (item: SelectItemData<TMeta>, index: number) => ReactNode;
     /**
      * Extra class names to apply to the list element.
      */

package/dist/lib/Components/Select/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Select/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,MAAM,cAAc,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC3D,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAEF,yHAAyH;AACzH,MAAM,MAAM,eAAe,GAAG;IAC5B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,eAAe,EAAE,SAAS,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IACnE;;;;OAIG;IACH,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,YAAY,CAAC;IAC3D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC/D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAElC,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,gBAAgB,EACd,aAAa,GACb,WAAW,GACX,cAAc,GACd,cAAc,GACd,QAAQ,GACR,SAAS,GACT,iBAAiB,CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Select/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,SAAS,EACV,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAChE,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,yHAAyH;AACzH,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACjE,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,eAAe,EAAE,SAAS,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAC7D;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC1E;;;;OAIG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,YAAY,CAAC;IAC3D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACxD,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACjE;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IACtE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAElC,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,gBAAgB,EACd,aAAa,GACb,WAAW,GACX,cAAc,GACd,cAAc,GACd,QAAQ,GACR,SAAS,GACT,iBAAiB,CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC"}

package/dist/lib/Components/Select/useSelectItems/useSelectItems.d.ts

@@ -1,17 +1,18 @@
-import { SelectItemData, SelectItemGroup } from '../types';
-type UseSelectItemsParams = {
-    items: SelectItemData[];
-    filter?: null | ((item: SelectItemData, query: string) => boolean);
-    filteredItems?: SelectItemData[];
+import { MetaShape, SelectItemData, SelectItemGroup } from '../types';
+type UseSelectItemsParams<TMeta extends MetaShape = MetaShape> = {
+    items: SelectItemData<TMeta>[];
+    filter?: null | ((item: SelectItemData<TMeta>, query: string) => boolean);
+    filteredItems?: SelectItemData<TMeta>[];
     searchValue?: string;
     defaultSearchValue?: string;
     onSearchValueChange?: (value: string) => void;
 };
-type UseSelectItemsReturn = {
+type UseSelectItemsReturn<TMeta extends MetaShape = MetaShape> = {
     isGrouped: boolean;
-    groupedItems: SelectItemGroup[] | null;
-    filteredItemsForRoot: SelectItemData[] | SelectItemGroup[];
+    groupedItems: SelectItemGroup<TMeta>[] | null;
+    filteredItemsForRoot: SelectItemData<TMeta>[] | SelectItemGroup<TMeta>[];
     resolvedSearchValue: string;
+    searchMounted: boolean;
     registerSearch: () => () => void;
     handleSearchValueChange: (val: string) => void;
 };
@@ -25,6 +26,6 @@ type UseSelectItemsReturn = {
  *   the internal filter entirely.
  * - Supports controlled and uncontrolled `searchValue` via `useControllableState`.
  */
-export declare function useSelectItems({ items, filter, filteredItems: filteredItemsProp, searchValue: searchValueProp, defaultSearchValue, onSearchValueChange: onSearchValueChangeProp, }: UseSelectItemsParams): UseSelectItemsReturn;
+export declare function useSelectItems<TMeta extends MetaShape = MetaShape>({ items, filter, filteredItems: filteredItemsProp, searchValue: searchValueProp, defaultSearchValue, onSearchValueChange: onSearchValueChangeProp, }: UseSelectItemsParams<TMeta>): UseSelectItemsReturn<TMeta>;
 export {};
 //# sourceMappingURL=useSelectItems.d.ts.map