@ledgerhq/lumen-ui-react 0.1.16 → 0.1.18

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

@@ -1,78 +1,144 @@
 import { ComponentPropsWithRef, ReactElement, ReactNode } from 'react';
+import { SearchInputProps } from '../SearchInput/types';
 import { TriggerButtonProps } from '../TriggerButton';
-type Direction = 'ltr' | 'rtl';
-type PointerDownOutsideEvent = CustomEvent<{
-    originalEvent: PointerEvent;
-}>;
+export type SelectItemData<Meta = Record<string, unknown>> = {
+    /** 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. */
+    label: string;
+    /** When true, the item cannot be selected or focused. */
+    disabled?: boolean;
+    /** Secondary text displayed below the label inside the item. */
+    description?: string;
+    /**
+     * Optional group name. Items with the same `group` are grouped together
+     * with automatic headers, separators, and per-group filtering.
+     * The group name is used as the displayed group label.
+     *
+     * Groups are ordered by first occurrence in the `items` array.
+     * Ungrouped items are collected together at the position of the first ungrouped item.
+     */
+    group?: string;
+    /**
+     * Optional bag of arbitrary data attached to this item.
+     * Use it to carry extra fields (icons, tickers, IDs, etc.)
+     * that your render function or custom filter needs.
+     */
+    meta?: Meta;
+};
+/** @internal A named group of select items, used to represent a resolved group with its header label and child items. */
+export type SelectItemGroup = {
+    /** The displayed group name, matching the `group` field on each child item. */
+    label: string;
+    /** The items belonging to this group. */
+    items: SelectItemData[];
+};
 export type SelectTriggerRenderProps = {
     /**
-     * The currently selected value, or empty string if nothing is selected.
+     * The currently selected value, or null if nothing is selected.
      */
-    selectedValue: string;
+    selectedValue: string | null;
     /**
-     * A ReactNode that renders the selected item's content via Radix `SelectPrimitive.Value`.
+     * A ReactNode that renders the selected item's content via `Combobox.Value`.
      */
     selectedContent: ReactNode;
 };
 export type SelectProps = {
     /**
-     * The children of the select item
+     * The children of the select.
      */
     children: ReactNode;
     /**
-     * The controlled open state of the select.
-     * Must be used in conjunction with onOpenChange.
+     * The items displayed in the dropdown list.
+     * Each item must have a `value` (unique string identifier) and a `label`
+     * (display text for search and trigger). Use the optional `meta` field to
+     * attach arbitrary data (icons, tickers, IDs, etc.) accessible in the
+     * render function and custom filters.
+     *
+     * When items include a `group` field, the component automatically groups
+     * them by that value, rendering group headers, separators, and per-group
+     * collection iteration internally.
      */
-    open?: boolean;
+    items: SelectItemData[];
+    /**
+     * Filter function used to match items against a search query.
+     * When `SelectSearch` is rendered inside the content, a default case-insensitive
+     * label filter is applied automatically. Pass a custom function to override it,
+     * or `null` to disable filtering entirely.
+     *
+     * When items include a `group` field, the filter is applied to individual
+     * items within each group. Empty groups are automatically hidden.
+     * @default undefined
+     */
+    filter?: null | ((item: SelectItemData, query: string) => boolean);
     /**
-     * The value of the select when initially rendered.
-     * Use when you do not need to control the state of the select.
+     * 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.
      */
-    defaultValue?: string;
+    filteredItems?: SelectItemData[];
+    /**
+     * The controlled search input value.
+     * Should be used in conjunction with `onSearchValueChange`.
+     */
+    searchValue?: string;
+    /**
+     * The search input value when initially rendered (uncontrolled).
+     * @default ''
+     */
+    defaultSearchValue?: string;
+    /**
+     * Callback fired when the search input value changes.
+     * Use to trigger async fetches or track the current query externally.
+     */
+    onSearchValueChange?: (value: string) => void;
     /**
-     * Event handler called when the open state of the select changes.
+     * Whether the popup is open. Use for controlled open state.
+     * Must be used in conjunction with `onOpenChange`.
      */
-    onOpenChange?(open: boolean): void;
+    open?: boolean;
     /**
-     * The open state of the select when it is initially rendered.
+     * The open state of the popup when initially rendered.
      * Use when you do not need to control its open state.
      * @default false
      */
     defaultOpen?: boolean;
     /**
-     * The reading direction of the select when applicable.
-     * If omitted, inherits globally from DirectionProvider or assumes LTR (left-to-right) reading mode.
+     * The value of the select when initially rendered (uncontrolled).
      */
-    dir?: Direction;
+    defaultValue?: string;
     /**
-     * The name of the select.
-     * Submitted with its owning form as part of a name/value pair.
+     * Event handler called when the open state of the popup changes.
      */
-    name?: string;
+    onOpenChange?: (open: boolean) => void;
     /**
-     * When true, prevents the user from interacting with select.
+     * The controlled value of the select.
+     * Should be used in conjunction with `onValueChange`.
      */
-    disabled?: boolean;
+    value?: string | null;
     /**
-     * Whether the select is required
-     * @default false
+     * Event handler called when the selected value changes.
+     * Receives `null` when the selection is cleared (e.g. combobox clear behavior).
      */
-    required?: boolean;
+    onValueChange?: (value: string | null) => void;
     /**
-     * The controlled value of the select.
-     * Should be used in conjunction with onValueChange.
+     * The name of the select for form submission.
+     */
+    name?: string;
+    /**
+     * When true, prevents the user from interacting with the select.
      */
-    value?: string;
+    disabled?: boolean;
     /**
-     * Event handler called when the value changes.
+     * Whether the select is required for form validation.
+     * @default false
      */
-    onValueChange?(value: string): void;
+    required?: boolean;
 };
 export type SelectTriggerProps = {
     /**
      * Render function that replaces the default input-style trigger.
-     * When provided, `SelectPrimitive.Trigger` renders with `asChild` and
-     * delegates rendering to this function.
+     * When provided, the trigger delegates rendering to this function.
      * Can be a preset component (e.g. `SelectTriggerButton`) or a custom render function.
      *
      * @example render={(props) => <SelectTriggerButton {...props} label="Label" />}
@@ -80,176 +146,142 @@ export type SelectTriggerProps = {
      */
     render?: (props: SelectTriggerRenderProps) => ReactElement;
     /**
-     * Extra class names to apply to the trigger element
-     * @example className='text-error'
+     * Extra class names to apply to the trigger element.
      */
     className?: string;
     /**
-     * The label text that floats above the input when focused or filled
-     * @example label='Label'
+     * The label text that floats above the input when focused or filled.
      */
     label?: string;
-    /** Additional class names to apply to the label element
-     * @example labelClassName='text-error'
+    /**
+     * Additional class names to apply to the label element.
      */
     labelClassName?: string;
 } & ComponentPropsWithRef<'button'>;
 export type SelectContentProps = {
     /**
-     * The children of the select content
+     * The children of the select content.
      */
     children: ReactNode;
     /**
-     * Change the default rendered element for the one passed as a child, merging their props and behavior.
-     * @default false
-     */
-    asChild?: boolean;
-    /**
-     * Event handler called when focus moves to the trigger after closing.
-     * It can be prevented by calling event.preventDefault.
-     */
-    onCloseAutoFocus?: (event: Event) => void;
-    /**
-     * Event handler called when the escape key is down.
-     * It can be prevented by calling event.preventDefault.
-     */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
-    /**
-     * Event handler called when a pointer event occurs outside the bounds of the component.
-     * It can be prevented by calling event.preventDefault.
-     */
-    onPointerDownOutside?: (event: PointerDownOutsideEvent) => void;
-    /**
-     * The positioning mode to use.
-     * we are using popper by default to position the content relative to the trigger.
-     * @default "popper"
-     */
-    position?: 'item-aligned' | 'popper';
-    /**
-     * The preferred side of the anchor to render against when open. Will be reversed when collisions occur and avoidCollisions is enabled.
-     * This is only available when position is set to popper.
+     * The preferred side of the anchor to render against when open.
      * @default "bottom"
      */
     side?: 'top' | 'right' | 'bottom' | 'left';
     /**
-     * The distance in pixels from the trigger
-     * @default 0
+     * The distance in pixels from the trigger.
+     * @default 8
      */
     sideOffset?: number;
     /**
-     * The preferred alignment against the trigger
+     * The preferred alignment against the trigger.
      * @default "start"
      */
     align?: 'start' | 'center' | 'end';
     /**
-     * An offset in pixels from the "start" or "end" alignment options
-     * @default 0
+     * Extra class names to apply to the content element.
      */
-    alignOffset?: number;
-    /**
-     * When true, overrides the side and align preferences to prevent collisions with boundary edges
-     * @default true
-     */
-    avoidCollisions?: boolean;
+    className?: string;
     /**
-     * The element used as the collision boundary. Accepts an array of elements
-     * @default []
+     * When true, the search input receives focus automatically when the dropdown opens.
+     * @default false
      */
-    collisionBoundary?: Element | Element[];
+    autoFocusSearch?: boolean;
+} & ComponentPropsWithRef<'div'>;
+export type SelectListProps = {
     /**
-     * The distance in pixels from the boundary edges where collision detection should occur
-     * @default 10
+     * A render function that receives each item and its index, returning a ReactNode.
+     *
+     * When items are grouped, this render function is used for individual items
+     * within each group — the group scaffolding (headers, separators, collection)
+     * is handled automatically by `SelectList`.
+     * @example renderItem={(item) => <SelectItem value={item.value}>{item.label}</SelectItem>}
      */
-    collisionPadding?: number | {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
+    renderItem: (item: SelectItemData, index: number) => ReactNode;
     /**
-     * The sticky behavior on the align axis
-     * @default "partial"
+     * Extra class names to apply to the list element.
      */
-    sticky?: 'partial' | 'always';
+    className?: string;
+} & ComponentPropsWithRef<'div'>;
+export type SelectLabelProps = {
     /**
-     * Whether to hide the content when the trigger becomes fully occluded
-     * @default false
+     * The children of the select label.
      */
-    hideWhenDetached?: boolean;
+    children: ReactNode;
     /**
-     * Extra class names to apply to the content element
-     * @example className='text-error'
+     * Extra class names to apply to the label element.
      */
     className?: string;
 } & ComponentPropsWithRef<'div'>;
-export type SelectGroupProps = {
+export type SelectItemTextProps = {
     /**
-     * The children of the select group
+     * The text content of the item.
      */
     children: ReactNode;
-};
-export type SelectLabelProps = {
     /**
-     * The children of the select label
-     * @example children={<SelectLabel>Option</SelectLabel>}
-     * @required
+     * Extra class names to apply to the item text element.
      */
-    children: ReactNode;
+    className?: string;
+} & ComponentPropsWithRef<'span'>;
+export type SelectItemProps = {
     /**
-     * The class name of the select label
+     * The unique string value associated with this item.
      */
-    className?: string;
-} & ComponentPropsWithRef<'div'>;
-export type SelectItemTextProps = {
+    value: string;
     /**
-     * The children of the select item text
-     * @example children={<SelectItemText>Option</SelectItemText>}
-     * @required
+     * The children of the select item. Supports custom content
+     * (icons, tags, descriptions, etc.) alongside `SelectItemText`.
      */
     children: ReactNode;
     /**
-     * Extra class names to apply to the item text element
-     * @example className='text-error'
+     * Whether the item is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Extra class names to apply to the item element.
      */
     className?: string;
 } & ComponentPropsWithRef<'div'>;
-export type SelectItemProps = {
+export type SelectSeparatorProps = {
     /**
-     * The value of the select item
-     * @example value='option1'
-     * @required
+     * Extra class names to apply to the separator element.
      */
-    value: string;
+    className?: string;
+} & ComponentPropsWithRef<'div'>;
+export type SelectSearchProps = Pick<SearchInputProps, 'placeholder' | 'className' | 'errorMessage' | 'aria-invalid' | 'suffix' | 'onClear' | 'hideClearButton'>;
+export type SelectEmptyStateProps = {
     /**
-     * The children of the select item
-     * @example children={<SelectItemText>Option</SelectItemText>}
-     * @required
+     * The primary heading displayed in the empty state (e.g. "No results found").
      */
-    children: ReactElement<SelectItemTextProps> | readonly ReactElement[];
+    title?: ReactNode;
     /**
-     * Optional text used for typeahead purposes. Use this when the content is complex, or you have non-textual content inside.
-     * @example textValue='Option'
+     * Secondary text displayed below the title (e.g. a hint or explanation).
      */
-    textValue?: string;
+    description?: ReactNode;
     /**
-     * The disabled state of the select item
-     * @example disabled={true}
+     * Extra class names to apply to the empty state element.
      */
-    disabled?: boolean;
+    className?: string;
+} & ComponentPropsWithRef<'div'>;
+export type SelectItemContentProps = {
     /**
-     * Extra class names to apply to the item element
-     * @example className='text-error'
+     * The content of the item, typically `SelectItemText` and optionally
+     * `SelectItemDescription` stacked vertically.
+     */
+    children: ReactNode;
+    /**
+     * Extra class names to apply to the content wrapper.
      */
     className?: string;
 } & ComponentPropsWithRef<'div'>;
-export type SelectSeparatorProps = {
+export type SelectItemDescriptionProps = {
     /**
-     * Change the default rendered element for the one passed as a child, merging their props and behavior.
-     * @default false
+     * Secondary text displayed below the item label.
      */
-    asChild?: boolean;
+    children: ReactNode;
     /**
-     * Extra class names to apply to the separator element
+     * Extra class names to apply to the description element.
      */
     className?: string;
 } & ComponentPropsWithRef<'div'>;
@@ -260,5 +292,4 @@ export type SelectTriggerButtonProps = SelectTriggerRenderProps & Omit<TriggerBu
      */
     label: string;
 };
-export {};
 //# sourceMappingURL=types.d.ts.map

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":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Select/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export { useSelectItems } from './useSelectItems';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Select/useSelectItems/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,30 @@
+import { SelectItemData, SelectItemGroup } from '../types';
+type UseSelectItemsParams = {
+    items: SelectItemData[];
+    filter?: null | ((item: SelectItemData, query: string) => boolean);
+    filteredItems?: SelectItemData[];
+    searchValue?: string;
+    defaultSearchValue?: string;
+    onSearchValueChange?: (value: string) => void;
+};
+type UseSelectItemsReturn = {
+    isGrouped: boolean;
+    groupedItems: SelectItemGroup[] | null;
+    filteredItemsForRoot: SelectItemData[] | SelectItemGroup[];
+    resolvedSearchValue: string;
+    registerSearch: () => () => void;
+    handleSearchValueChange: (val: string) => void;
+};
+/**
+ * Manages item grouping, filtering, and search-mount lifecycle for the Select.
+ *
+ * - Automatically groups items when any item has a `group` field.
+ * - Applies the default case-insensitive label filter when `SelectSearch`
+ *   is mounted and no custom `filter` is provided.
+ * - Allows external/async filtering via `filteredItems`, bypassing
+ *   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 {};
+//# sourceMappingURL=useSelectItems.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectItems.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Select/useSelectItems/useSelectItems.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhE,KAAK,oBAAoB,GAAG;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IACnE,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACvC,oBAAoB,EAAE,cAAc,EAAE,GAAG,eAAe,EAAE,CAAC;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,MAAM,IAAI,CAAC;IACjC,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,MAAM,EACN,aAAa,EAAE,iBAAiB,EAChC,WAAW,EAAE,eAAe,EAC5B,kBAAkB,EAClB,mBAAmB,EAAE,uBAAuB,GAC7C,EAAE,oBAAoB,GAAG,oBAAoB,CAuE7C"}

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

@@ -0,0 +1,42 @@
+import { useState as b, useCallback as f, useMemo as u } from "react";
+import { useControllableState as x } from "../../../../utils/useControllableState/useControllableState.js";
+import { groupItemsByKey as i, defaultLabelFilter as G } from "../utils/groupItems.js";
+function B({
+  items: r,
+  filter: s,
+  filteredItems: o,
+  searchValue: m,
+  defaultSearchValue: d,
+  onSearchValueChange: p
+}) {
+  const [S, c] = b(!1), [t, h] = x({
+    prop: m,
+    defaultProp: d ?? "",
+    onChange: p
+  }), g = f(() => (c(!0), () => c(!1)), []), V = f(
+    (e) => {
+      h(e);
+    },
+    [h]
+  ), a = S ? s === void 0 ? G : s : null, n = u(
+    () => r.some((e) => e.group != null),
+    [r]
+  ), l = u(
+    () => n ? i(r) : null,
+    [r, n]
+  ), C = u(() => !a || !t.trim() ? l ?? r : l ? l.map((e) => ({
+    ...e,
+    items: e.items.filter((F) => a(F, t))
+  })).filter((e) => e.items.length > 0) : r.filter((e) => a(e, t)), [l, r, t, a]), I = u(() => o ? n ? i(o) : o : null, [o, n]) ?? C;
+  return {
+    isGrouped: n,
+    groupedItems: l,
+    filteredItemsForRoot: I,
+    resolvedSearchValue: t,
+    registerSearch: g,
+    handleSearchValueChange: V
+  };
+}
+export {
+  B as useSelectItems
+};

package/dist/lib/Components/Select/utils/groupItems.d.ts

@@ -0,0 +1,13 @@
+import { SelectItemData, SelectItemGroup } from '../types';
+/**
+ * Groups a flat list of items by their `group` field, preserving
+ * the insertion order of the first occurrence of each group key.
+ * Items without a `group` value are collected under an empty-string key.
+ */
+export declare function groupItemsByKey(items: SelectItemData[]): SelectItemGroup[];
+/**
+ * Case-insensitive substring match on `item.label`.
+ * Returns `true` for empty/whitespace-only queries so all items are shown.
+ */
+export declare const defaultLabelFilter: (item: SelectItemData, query: string) => boolean;
+//# sourceMappingURL=groupItems.d.ts.map

package/dist/lib/Components/Select/utils/groupItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupItems.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Select/utils/groupItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,eAAe,EAAE,CAY1E;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,cAAc,EACpB,OAAO,MAAM,KACZ,OAIF,CAAC"}

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

@@ -0,0 +1,16 @@
+function s(n) {
+  const r = [], e = {};
+  for (const t of n) {
+    const o = t.group ?? "";
+    e[o] || (r.push(o), e[o] = []), e[o].push(t);
+  }
+  return r.map((t) => ({ label: t, items: e[t] }));
+}
+const u = (n, r) => {
+  const e = r.trim().toLowerCase();
+  return e ? n.label.toLowerCase().includes(e) : !0;
+};
+export {
+  u as defaultLabelFilter,
+  s as groupItemsByKey
+};

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

@@ -0,0 +1,2 @@
+export { groupItemsByKey, defaultLabelFilter } from './groupItems';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Select/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/lib/Components/SideBar/SideBar.d.ts

@@ -19,27 +19,18 @@ import { SideBarProps, SideBarLeadingProps, SideBarTrailingProps, SideBarItemPro
  *   </SideBarTrailing>
  * </SideBar>
  */
-export declare const SideBar: {
-    ({ ref, collapsed: controlledCollapsed, defaultCollapsed, onCollapsedChange, active: controlledActive, defaultActive, onActiveChange, children, className, ...props }: SideBarProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
+export declare const SideBar: ({ ref, collapsed: controlledCollapsed, defaultCollapsed, onCollapsedChange, active: controlledActive, defaultActive, onActiveChange, children, className, ...props }: SideBarProps) => import("react/jsx-runtime").JSX.Element;
 /**
  * Container for the leading (top) section of the sidebar.
  * Typically contains the main navigation items.
  */
-export declare const SideBarLeading: {
-    ({ ref, children, className, ...props }: SideBarLeadingProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
+export declare const SideBarLeading: ({ ref, children, className, ...props }: SideBarLeadingProps) => import("react/jsx-runtime").JSX.Element;
 /**
  * Container for the trailing (bottom) section of the sidebar.
  * Typically contains secondary navigation items and settings.
  * Uses `mt-auto` to push itself and the footer to the bottom.
  */
-export declare const SideBarTrailing: {
-    ({ ref, children, className, ...props }: SideBarTrailingProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
+export declare const SideBarTrailing: ({ ref, children, className, ...props }: SideBarTrailingProps) => import("react/jsx-runtime").JSX.Element;
 /**
  * A navigation item within the sidebar.
  * Supports active state via value matching, icons, labels, and optional click handling.
@@ -62,10 +53,7 @@ export declare const SideBarTrailing: {
  *   tooltipContent="Wallet"
  * />
  */
-export declare const SideBarItem: {
-    ({ ref, value, icon: Icon, activeIcon: ActiveIcon, label, tooltipContent: tooltipContentProp, disabled: disabledProp, className, onClick, ...props }: SideBarItemProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
+export declare const SideBarItem: ({ ref, value, icon: Icon, activeIcon: ActiveIcon, label, tooltipContent: tooltipContentProp, disabled: disabledProp, className, onClick, ...props }: SideBarItemProps) => import("react/jsx-runtime").JSX.Element;
 /**
  * Collapse toggle button for the sidebar.
  * Place inside SideBarTrailing to allow users to collapse/expand the sidebar.
@@ -75,8 +63,5 @@ export declare const SideBarItem: {
  *   <SideBarCollapseToggle />
  * </SideBarTrailing>
  */
-export declare const SideBarCollapseToggle: {
-    ({ className, tooltipContent: tooltipContentProp, ...props }: SideBarCollapseToggleProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
+export declare const SideBarCollapseToggle: ({ className, tooltipContent: tooltipContentProp, ...props }: SideBarCollapseToggleProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SideBar.d.ts.map

package/dist/lib/Components/SideBar/SideBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SideBar.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/SideBar/SideBar.tsx"],"names":[],"mappings":"AAWA,OAAO,EAEL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAmDjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO;2KAWjB,YAAY;;CA4Bd,CAAC;AAGF;;;GAGG;AACH,eAAO,MAAM,cAAc;6CAKxB,mBAAmB;;CAUrB,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,eAAe;6CAKzB,oBAAoB;;CAUtB,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW;0JAWrB,gBAAgB;;CAuDlB,CAAC;AAGF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;kEAI/B,0BAA0B;;CA2C5B,CAAC"}
+{"version":3,"file":"SideBar.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/SideBar/SideBar.tsx"],"names":[],"mappings":"AAWA,OAAO,EAEL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAmDjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,GAAI,sKAWrB,YAAY,4CA4Bd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,wCAK5B,mBAAmB,4CAUrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,wCAK7B,oBAAoB,4CAUtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,GAAI,qJAWzB,gBAAgB,4CAuDlB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,6DAInC,0BAA0B,4CA2C5B,CAAC"}