@ledgerhq/lumen-ui-rnative 0.0.45 → 0.0.47

package/src/lib/Components/ListItem/types.ts

@@ -0,0 +1,121 @@
+import React from 'react';
+import {
+  LumenTextStyle,
+  StyledPressableProps,
+  StyledTextProps,
+  StyledViewProps,
+} from '../../../styles';
+import { DiscriminatedSpotProps } from '../Spot';
+
+/**
+ * Context value for passing state to sub-components
+ */
+export type ListItemContextValue = {
+  disabled?: boolean;
+};
+
+/**
+ * Props for the ListItem root component
+ */
+export type ListItemProps = {
+  /**
+   * The content of the list item (ListItemLeading, ListItemTrailing)
+   */
+  children: React.ReactNode;
+  /**
+   * Whether the list item is disabled.
+   */
+  disabled?: boolean;
+  /**
+   * Callback function when the list item is pressed.
+   */
+  onPress?: StyledPressableProps['onPress'];
+} & Omit<StyledPressableProps, 'disabled' | 'children'>;
+
+/**
+ * Props for the ListItemLeading component
+ */
+export type ListItemLeadingProps = {
+  /**
+   * The content of the leading area (visual element + ListItemContent)
+   */
+  children: React.ReactNode;
+} & Omit<StyledViewProps, 'children'>;
+
+/**
+ * Props for the ListItemContent component
+ */
+export type ListItemContentProps = {
+  /**
+   * The content (ListItemTitle, ListItemDescription)
+   */
+  children: React.ReactNode;
+} & Omit<StyledViewProps, 'children'>;
+
+/**
+ * Props for the ListItemTitle component
+ */
+export type ListItemTitleProps = {
+  /**
+   * The title text or custom content
+   */
+  children: React.ReactNode;
+} & Omit<StyledTextProps, 'children'>;
+
+/**
+ * Props for the ListItemDescription component
+ */
+export type ListItemDescriptionProps = {
+  /**
+   * The description text or custom content
+   */
+  children: React.ReactNode;
+} & Omit<StyledTextProps, 'children'>;
+
+/**
+ * Props for the ListItemTrailing component
+ */
+export type ListItemTrailingProps = {
+  /**
+   * The trailing content (icons, switches, values, etc.)
+   */
+  children: React.ReactNode;
+} & Omit<StyledViewProps, 'children'>;
+
+/**
+ * Props for the ListItemTruncate component
+ * Used to truncate text that should when ListItemDescription or ListItemTitle contain custom content
+ */
+export type ListItemTruncateProps = {
+  /**
+   * The text content to truncate
+   */
+  children: string;
+  /**
+   * The variant determines typography and color styling.
+   * Use 'title' inside ListItemTitle and 'description' inside ListItemDescription.
+   * @default 'description'
+   */
+  variant?: 'title' | 'description';
+} & Omit<StyledTextProps, 'children'>;
+
+/**
+ * Props for the ListItemSpot component
+ * Spot adapter that inherits disabled state from parent ListItem
+ */
+export type ListItemSpotProps = DiscriminatedSpotProps &
+  Omit<StyledViewProps, 'children'>;
+
+/**
+ * Props for the ListItemIcon component
+ */
+export type ListItemIconProps = {
+  /**
+   * The icon component to render
+   */
+  icon: React.ComponentType<any>;
+  /**
+   * Optional color override. If not provided, uses theme color with disabled state handling.
+   */
+  color?: LumenTextStyle['color'];
+} & Omit<StyledViewProps, 'children'>;

package/src/lib/Components/{Search/Search.mdx → SearchInput/SearchInput.mdx}

@@ -1,31 +1,31 @@
 import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
-import * as SearchStories from './Search.stories';
-import { Search } from './Search';
+import * as SearchInputStories from './SearchInput.stories';
+import { SearchInput } from './SearchInput';
 import { CustomTabs, Tab } from '../../../../.storybook/components';
 import { DoVsDontRow, DoBlockItem, DontBlockItem } from '../../../../.storybook/components/DoVsDont';
-import CommonRulesDoAndDont from '../../../../.storybook/docs/CommonRulesDoAndDont.mdx';
+import CommonRulesDoAndDont from '../../../../.storybook/components/DoVsDont/CommonRulesDoAndDont.mdx';
 
-<Meta title='Input/Search' of={SearchStories} />
+<Meta title='Input/SearchInput' of={SearchInputStories} />
 
-# 🔍 Search
+# 🔍 SearchInput
 
 <CustomTabs>
   <Tab label="Overview">
 
 ## Introduction
 
-The Search component is a specialized input field designed specifically for search functionality on mobile platforms. It features a built-in search icon, placeholder text, and automatic clear button for enhanced user experience. Unlike regular inputs, it uses placeholder text instead of floating labels for better search UX patterns.
+The SearchInput component is a specialized input field designed specifically for search functionality on mobile platforms. It features a built-in search icon, placeholder text, and automatic clear button for enhanced user experience. Unlike regular inputs, it uses placeholder text instead of floating labels for better search UX patterns.
 
 > View in [Figma](https://www.figma.com/design/JxaLVMTWirCpU0rsbZ30k7/2.-Components-Library?node-id=2248-3468&m=dev).
 
 > ⚠️ **Note on Web Preview:** The Storybook preview below may display visual inconsistencies as certain React Native APIs (such as Reanimated animations) cannot be fully translated to web environments. While the component's functionality should accurately represent the native implementation, it may not render as intended. For the complete native experience, please refer to the component on an actual iOS or Android device.
 
-<Canvas of={SearchStories.Base} />
-<Controls of={SearchStories.Base} />
+<Canvas of={SearchInputStories.Base} />
+<Controls of={SearchInputStories.Base} />
 
 ## Anatomy
 
-> **Layout:** The Search component takes the full width of its container by default. You can control the width directly using `className` or by wrapping in a container.
+> **Layout:** The SearchInput component takes the full width of its container by default. You can control the width by using the `style` prop or by wrapping in a container.
 
 ### Search Icon
 
@@ -39,7 +39,7 @@ Uses placeholder text instead of floating labels for better search UX. Styled wi
 
 A clear button (×) appears **automatically** when input has content.
 
-<Canvas of={SearchStories.WithContent} />
+<Canvas of={SearchInputStories.WithContent} />
 
 > **Note:** The clear button only clears the input content/value. It does not clear error states - you must handle error state clearing separately in your component logic.
 
@@ -47,25 +47,25 @@ A clear button (×) appears **automatically** when input has content.
 
 Use `hideClearButton` to prevent the clear button from appearing.
 
-<Canvas of={SearchStories.WithHiddenClearButton} />
+<Canvas of={SearchInputStories.WithHiddenClearButton} />
 
 #### **Extending the Clear Behavior**
 
 Use `onClear` to extend the default clear behavior with custom logic.
 
-<Canvas of={SearchStories.WithClearCallback} />
+<Canvas of={SearchInputStories.WithClearCallback} />
 
 ### Disabled State
 
 The search input can be disabled using the `editable` prop set to `false`.
 
-<Canvas of={SearchStories.DisabledSearch} />
+<Canvas of={SearchInputStories.DisabledSearchInput} />
 
 ### Error State
 
 The search component supports error handling through `errorMessage` which displays an error message below the input with error styling including a red border and text color.
 
-<Canvas of={SearchStories.WithError} />
+<Canvas of={SearchInputStories.WithError} />
 
 The error message will be automatically:
 
@@ -76,7 +76,7 @@ The error message will be automatically:
 
 ## Controlled vs Uncontrolled
 
-The Search component supports both controlled and uncontrolled usage.
+The SearchInput component supports both controlled and uncontrolled usage.
 
 ### Uncontrolled (with defaultValue)
 
@@ -99,7 +99,7 @@ Set these using the `keyboardType` prop.
 
 ## Accessibility
 
-The Search component follows accessibility best practices:
+The SearchInput component follows accessibility best practices:
 
 - Supports screen reader navigation
 - Placeholder text is properly announced
@@ -132,14 +132,14 @@ Install and set up the library with our [Setup Guide →](?path=/docs/getting-st
 ### Basic Usage
 
 ```tsx
-import { Search } from '@ledgerhq/lumen-ui-rnative';
+import { SearchInput } from '@ledgerhq/lumen-ui-rnative';
 import { useState } from 'react';
 
 function MyComponent() {
   const [query, setQuery] = useState('');
 
   return (
-    <Search
+    <SearchInput
       placeholder='Search products'
       value={query}
       onChangeText={setQuery}
@@ -155,14 +155,14 @@ function MyComponent() {
 Use `hideClearButton` to prevent the clear button from appearing:
 
 ```tsx
-import { Search } from '@ledgerhq/lumen-ui-rnative';
+import { SearchInput } from '@ledgerhq/lumen-ui-rnative';
 import { useState } from 'react';
 
 function MyComponent() {
   const [query, setQuery] = useState('');
 
   return (
-    <Search
+    <SearchInput
       placeholder='Search'
       value={query}
       onChangeText={setQuery}
@@ -177,7 +177,7 @@ function MyComponent() {
 Provide `onClear` to extend the default clear behavior with additional logic:
 
 ```tsx
-import { Search } from '@ledgerhq/lumen-ui-rnative';
+import { SearchInput } from '@ledgerhq/lumen-ui-rnative';
 import { useState } from 'react';
 
 function MyComponent() {
@@ -185,7 +185,7 @@ function MyComponent() {
   const [error, setError] = useState('');
 
   return (
-    <Search
+    <SearchInput
       placeholder='Search users'
       value={query}
       onChangeText={setQuery}
@@ -203,10 +203,10 @@ function MyComponent() {
 
 ### With Error State
 
-The Search component supports error states and messages:
+The SearchInput component supports error states and messages:
 
 ```tsx
-import { Search } from '@ledgerhq/lumen-ui-rnative';
+import { SearchInput } from '@ledgerhq/lumen-ui-rnative';
 import { useState } from 'react';
 
 function MyComponent() {
@@ -224,7 +224,7 @@ function MyComponent() {
   };
 
   return (
-    <Search
+    <SearchInput
       placeholder='Search products'
       value={query}
       onChangeText={handleSearch}
@@ -238,14 +238,14 @@ function MyComponent() {
 
 ### With Custom Styling
 
-While the component comes with predefined styles, you can extend them using NativeWind classes:
+While the component comes with predefined styles, you can extend them using the `style` prop:
 
 ```tsx
-<Search
+<SearchInput
   placeholder='Search'
   value={query}
   onChangeText={setQuery}
-  className='max-w-md' // Control width
+  style={{ maxWidth: 320 }} // Control width
 />
 ```
 
@@ -255,7 +255,7 @@ Use the `keyboardType` prop to show the appropriate keyboard:
 
 ```tsx
 // Email search keyboard
-<Search
+<SearchInput
   placeholder='Search by email'
   value={query}
   onChangeText={setQuery}
@@ -263,7 +263,7 @@ Use the `keyboardType` prop to show the appropriate keyboard:
 />
 
 // URL search keyboard
-<Search
+<SearchInput
   placeholder='Search by URL'
   value={query}
   onChangeText={setQuery}
@@ -276,7 +276,7 @@ Use the `keyboardType` prop to show the appropriate keyboard:
 Use the `editable` prop to disable the search input:
 
 ```tsx
-<Search placeholder='Search' value='Current search' editable={false} />
+<SearchInput placeholder='Search' value='Current search' editable={false} />
 ```
 
 ### Debounced Search Example
@@ -284,7 +284,7 @@ Use the `editable` prop to disable the search input:
 For better performance, especially when dealing with API calls or expensive filtering operations, implement debounced search:
 
 ```tsx
-import { Search } from '@ledgerhq/lumen-ui-rnative';
+import { SearchInput } from '@ledgerhq/lumen-ui-rnative';
 import { useState, useCallback } from 'react';
 import { debounce } from 'lodash'; // or your preferred debounce utility
 
@@ -311,7 +311,7 @@ function MyComponent() {
   };
 
   return (
-    <Search
+    <SearchInput
       placeholder='Search products'
       value={query}
       onChangeText={handleChange}
@@ -322,18 +322,18 @@ function MyComponent() {
 
 ## Do's and Don'ts
 
-The following guidelines ensure consistent usage of the Search component and maintain design system principles.
+The following guidelines ensure consistent usage of the SearchInput component and maintain design system principles.
 
-<div className='flex flex-col gap-24'>
+<div style={{ display: 'flex', flexDirection: 'column', gap: 24 }}>
   <DoVsDontRow>
     <DoBlockItem
       title='Use placeholder text'
-      description='Search uses placeholder text instead of labels for optimal search UX'
+      description='SearchInput uses placeholder text instead of labels for optimal search UX'
     >
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   placeholder='Search by name or email'
   value={query}
   onChangeText={setQuery}
@@ -343,12 +343,12 @@ The following guidelines ensure consistent usage of the Search component and mai
     </DoBlockItem>
     <DontBlockItem
       title="Don't use label prop"
-      description='Search component does not support labels as they are not suitable for search UX patterns'
+      description='SearchInput component does not support labels as they are not suitable for search UX patterns'
     >
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   label='Search' // Not supported, will cause error
   placeholder='Search by name or email'
   value={query}
@@ -367,7 +367,7 @@ The following guidelines ensure consistent usage of the Search component and mai
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   placeholder='Search products'
   value={query}
   onChangeText={handleChange}
@@ -377,12 +377,12 @@ The following guidelines ensure consistent usage of the Search component and mai
     </DoBlockItem>
     <DontBlockItem
       title="Don't override the search icon"
-      description='The prefix prop is not available on Search component'
+      description='The prefix prop is not available on SearchInput component'
     >
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   prefix={<CustomIcon />} // Not supported, will cause error
   placeholder='Search products'
 />
@@ -400,7 +400,7 @@ The following guidelines ensure consistent usage of the Search component and mai
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   placeholder='Search'
   value={query}
   onChangeText={setQuery}
@@ -419,7 +419,7 @@ The following guidelines ensure consistent usage of the Search component and mai
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   placeholder='Search'
   value={query}
   onChangeText={setQuery}
@@ -444,7 +444,7 @@ const debouncedSearch = useCallback(
   []
 );
 
-<Search
+<SearchInput
   placeholder='Search'
   value={query}
   onChangeText={(text) => {
@@ -467,7 +467,7 @@ const debouncedSearch = useCallback(
   []
 );
 
-<Search
+<SearchInput
   placeholder='Search'
   value={query}
   onChangeText={(text) => {
@@ -489,7 +489,7 @@ const debouncedSearch = useCallback(
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   placeholder='Search by name or email'
   value={query}
   onChangeText={setQuery}
@@ -504,7 +504,7 @@ const debouncedSearch = useCallback(
 
 {/* prettier-ignore */}
 ```tsx
-<Search
+<SearchInput
   placeholder='Type here'
   value={query}
   onChangeText={setQuery}
@@ -544,14 +544,14 @@ const debouncedSearch = useCallback(
 
 ## Usage Guidelines
 
-Use Search for:
+Use SearchInput for:
 
 - Search functionality and data querying
 - Filtering lists or datasets
 - Quick find operations
 - Search bars in navigation
 
-Use TextInput (instead of Search) for:
+Use TextInput (instead of SearchInput) for:
 
 - Form data collection
 - User profile information
@@ -560,3 +560,4 @@ Use TextInput (instead of Search) for:
 
 </Tab>
 </CustomTabs>
+

package/src/lib/Components/{Search/Search.stories.tsx → SearchInput/SearchInput.stories.tsx}

@@ -1,11 +1,12 @@
 import type { Meta, StoryObj } from '@storybook/react-native-web-vite';
 import { useState } from 'react';
 import { View } from 'react-native';
-import { Search, type SearchProps } from './Search';
+import { SearchInput } from './SearchInput';
+import { SearchInputProps } from './types';
 
-const meta: Meta<typeof Search> = {
-  component: Search,
-  title: 'Input/Search',
+const meta: Meta<typeof SearchInput> = {
+  component: SearchInput,
+  title: 'Input/SearchInput',
   parameters: {
     docs: {
       source: {
@@ -36,15 +37,25 @@ const meta: Meta<typeof Search> = {
 };
 
 export default meta;
-type Story = StoryObj<typeof Search>;
+type Story = StoryObj<typeof SearchInput>;
 
-const SearchStory = (args: SearchProps & { initialValue?: string }) => {
+const SearchInputStory = (
+  args: SearchInputProps & { initialValue?: string },
+) => {
   const [query, setQuery] = useState(args.initialValue ?? '');
 
   return (
-    <View className='flex min-h-400 items-center justify-center p-24'>
-      <View className='w-full max-w-320'>
-        <Search
+    <View
+      style={{
+        flex: 1,
+        minHeight: 96,
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: 24,
+      }}
+    >
+      <View style={{ width: '100%', maxWidth: 400 }}>
+        <SearchInput
           {...args}
           value={query}
           onChangeText={setQuery}
@@ -56,7 +67,7 @@ const SearchStory = (args: SearchProps & { initialValue?: string }) => {
 };
 
 export const Base: Story = {
-  render: (args) => <SearchStory {...args} />,
+  render: (args) => <SearchInputStory {...args} />,
   args: {
     placeholder: 'Search products',
     editable: true,
@@ -65,7 +76,7 @@ export const Base: Story = {
 };
 
 export const WithContent: Story = {
-  render: (args) => <SearchStory {...args} initialValue='Search text' />,
+  render: (args) => <SearchInputStory {...args} initialValue='Search text' />,
   args: {
     placeholder: 'Search products',
     editable: true,
@@ -74,7 +85,9 @@ export const WithContent: Story = {
 };
 
 export const WithError: Story = {
-  render: (args) => <SearchStory {...args} initialValue='Invalid search' />,
+  render: (args) => (
+    <SearchInputStory {...args} initialValue='Invalid search' />
+  ),
   args: {
     placeholder: 'Search products',
     errorMessage: 'Search term is invalid',
@@ -83,8 +96,10 @@ export const WithError: Story = {
   },
 };
 
-export const DisabledSearch: Story = {
-  render: (args) => <SearchStory {...args} initialValue='Disabled search' />,
+export const DisabledSearchInput: Story = {
+  render: (args) => (
+    <SearchInputStory {...args} initialValue='Disabled search' />
+  ),
   args: {
     placeholder: 'Search products',
     editable: false,
@@ -93,7 +108,7 @@ export const DisabledSearch: Story = {
 };
 
 export const WithHiddenClearButton: Story = {
-  render: (args) => <SearchStory {...args} initialValue='Search text' />,
+  render: (args) => <SearchInputStory {...args} initialValue='Search text' />,
   args: {
     placeholder: 'Search products',
     editable: true,
@@ -103,7 +118,7 @@ export const WithHiddenClearButton: Story = {
 
 export const WithClearCallback: Story = {
   render: (args) => (
-    <SearchStory
+    <SearchInputStory
       {...args}
       initialValue='Click clear to see callback'
       onClear={() => alert('Search cleared!')}

package/src/lib/Components/SearchInput/SearchInput.tsx

@@ -0,0 +1,20 @@
+import React from 'react';
+import { TextInput } from 'react-native';
+import { Search as SearchIcon } from '../../Symbols';
+import { BaseInput } from '../BaseInput';
+import { type SearchInputProps } from './types';
+
+export const SearchInput = React.forwardRef<
+  React.ElementRef<typeof TextInput>,
+  SearchInputProps
+>((props, ref) => {
+  return (
+    <BaseInput
+      ref={ref}
+      prefix={<SearchIcon size={20} color='muted' accessible={false} />}
+      {...props}
+    />
+  );
+});
+
+SearchInput.displayName = 'SearchInput';

package/src/lib/Components/SearchInput/index.ts

@@ -0,0 +1,2 @@
+export * from './SearchInput';
+export * from './types';

package/src/lib/Components/SearchInput/types.ts

@@ -0,0 +1,5 @@
+import { BaseInputProps } from '../BaseInput';
+import { BoxProps } from '../Utility';
+
+export type SearchInputProps = Omit<BaseInputProps, 'prefix' | 'label'> &
+  BoxProps;