anima-ds-nucleus 1.0.103 → 1.0.104

package/README.md

@@ -86,6 +86,41 @@ También puedes usar el API más típico:
 <Button variant="Primary">Enviar</Button>
 ```
 
+### HeaderCore: resultados de búsqueda tipo persona
+
+`HeaderCore` soporta la prop `searchResultVariant`. Por defecto usa `"default"` y mantiene compatibilidad con el renderer textual anterior. Para búsquedas de personas, usar `searchResultVariant="persona"` evita definir `renderSearchResultItem` en el proyecto consumidor.
+
+```jsx
+<HeaderCore
+  searchValue={query}
+  onSearch={setQuery}
+  searchResults={people}
+  isSearchResultsOpen={query.trim().length > 0}
+  searchResultVariant="persona"
+  onSearchResultClick={(person) => setQuery(person.nombre ?? person.name)}
+/>
+```
+
+La variante `persona` acepta datos con keys tolerantes: `id | personId`, `nombre | name | fullName | label`, `email`, `documento | document`, `estado | statusLabel | status` y `foto | avatar | image | userAvatar`. Si se pasa `renderSearchResultItem`, ese renderer custom sigue teniendo prioridad.
+
+### Tabla y ListaPersonas: filtros aplicados
+
+`Tabla` y `ListaPersonas` soportan filtros aplicados nativos con chips responsive. El consumidor solo pasa datos y callbacks; el DS resuelve estilos, scroll mobile y contador del botón `Filtros` cuando no se controla explícitamente con `activeFiltersCount`.
+
+```jsx
+<Tabla
+  showFiltersButton
+  appliedFilters={[
+    { id: 'documento', label: 'Documento contiene 345' },
+    { id: 'persona', label: 'Persona contiene Lau' },
+  ]}
+  onAppliedFilterRemove={(filter) => removeFilter(filter.id)}
+  onAppliedFiltersClear={clearFilters}
+/>
+```
+
+`appliedFilters` acepta strings u objetos `{ id, label }`. Si se informa `filtersArea`, ese contenido custom tiene prioridad y reemplaza el render nativo.
+
 ### Ejemplo de uso en un proyecto demo (Button)
 
 Supongamos un proyecto React creado con Vite o Create React App.