@nova-ui-native/core 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1 +1,40 @@
|
|
|
1
|
-
# nova-ui-native
|
|
1
|
+
# @nova-ui-native/core 🚀
|
|
2
|
+
|
|
3
|
+
Un kit de componentes nativos profesionales, intuitivos y altamente optimizados para tus aplicaciones de React Native. Diseñado con un enfoque estético moderno y limpio.
|
|
4
|
+
|
|
5
|
+
## 📦 Instalación
|
|
6
|
+
|
|
7
|
+
Instala el paquete en tu proyecto de Expo o React Native CLI:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @nova-ui-native/core
|
|
11
|
+
|
|
12
|
+
## 🛠️ Componentes Disponibles
|
|
13
|
+
|
|
14
|
+
### 🔍 CustomAutocomplete
|
|
15
|
+
|
|
16
|
+
Un componente de autocompletado avanzado, optimizado estructuralmente para evitar bucles de renderizado infinitos y diseñado para una experiencia de usuario fluida.
|
|
17
|
+
|
|
18
|
+
#### ⚙️ Propiedades (Props)
|
|
19
|
+
|
|
20
|
+
El componente acepta un tipo genérico `<T extends object>` para estructurar conjuntos de datos complejos con flexibilidad total.
|
|
21
|
+
|
|
22
|
+
| Propiedad | Tipo | Requerido | Por Defecto | Descripción |
|
|
23
|
+
| :--- | :--- | :---: | :--- | :--- |
|
|
24
|
+
| `data` | `T[]` | **Sí** | - | La colección completa de objetos (registros) a desplegar o filtrar. |
|
|
25
|
+
| `valueKey` | `keyof T` | **Sí** | - | La propiedad del objeto que actúa como identificador único (ej: `'id'`, `'value'`). |
|
|
26
|
+
| `filterKey` | `keyof T` | **Sí** | - | La propiedad del objeto por la cual se buscará y filtrará visualmente (ej: `'nombre'`, `'label'`). |
|
|
27
|
+
| `value` | `string \| number \| null` | **Sí** | - | El valor seleccionado actualmente. Vinculado al `valueKey` del objeto. |
|
|
28
|
+
| `onSelect` | `(value: string \| number \| null) => void` | **Sí** | - | Callback interactivo que devuelve el identificador (`valueKey`) seleccionado o `null` si se limpia. |
|
|
29
|
+
| `filterMode` | `'local' \| 'api'` | No | `'local'` | Modifica la estrategia de filtrado. `'local'` opera sobre el arreglo en memoria; `'api'` delega la búsqueda a llamadas externas. |
|
|
30
|
+
| `onSearch` | `(query: string) => void` | No | - | Callback que se gatilla al escribir en el input. Requerido si usas `filterMode="api"`. |
|
|
31
|
+
| `minSearchLength` | `number` | No | `1` | Longitud mínima de caracteres requerida antes de disparar el evento `onSearch`. |
|
|
32
|
+
| `placeholder` | `string` | No | `'Buscar...'` | Mensaje flotante dentro de la caja de texto vacía. |
|
|
33
|
+
| `label` | `string` | No | - | Título textual opcional sobre el selector, ideal para formularios limpios. |
|
|
34
|
+
| `helperText` | `string` | No | - | Nota de soporte o descripción corta que se renderiza debajo del input. |
|
|
35
|
+
| `error` | `boolean` | No | `false` | Activa estados visuales de advertencia (bordes y tipografías en tonalidades carmín). |
|
|
36
|
+
| `loading` | `boolean` | No | `false` | Muestra un indicador de carga (`ActivityIndicator`) en lugar de los botones normales de interacción. |
|
|
37
|
+
| `containerStyle` | `StyleProp<ViewStyle>` | No | - | Permite inyectar estilos personalizados para ajustar dimensiones externas de la caja contenedora. |
|
|
38
|
+
| `visibleItems` | `number` | No | `4` | Cantidad máxima de elementos visibles de golpe dentro de la lista flotante antes de activar scrollbar. |
|
|
39
|
+
| `maxResults` | `number` | No | `200` | Límite máximo de renderizado para mitigar sobrecargas en arreglos masivos (`slice`). |
|
|
40
|
+
| `heightItem` | `number` | No | `0` | Margen o altura extra aditiva a sumar sobre los `62px` base de diseño de las celdas táctiles. |
|
package/package.json
CHANGED