feat(busqueda): búsqueda tolerante a tildes, conteo de resultados y estado vacío accionable
deploy-branch / deploy (push) Successful in 2m46s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m15s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m16s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped

Alternativa A de simplificación de la UX de búsqueda.

- src/utils/texto.js: normalizador compartido (minúsculas, sin tildes,
  espacios colapsados) + tokenizador por palabras. ProveedorUbicacion ahora
  delega aquí en vez de duplicar la implementación.
- src/utils/busqueda.js: reglas de la búsqueda libre. Se comparan TODAS las
  palabras de la consulta contra nombre, provincia, categoría, subcategoría y
  dirección. Antes era un `includes` con toLowerCase(): "peluqueria" no
  encontraba "Peluquería" y "malaga" no encontraba "Málaga".
- BarraFiltros: conteo de resultados con aria-live ("4 locales" / "2 de 4
  locales", sin anunciar como filtro el simple orden), ✕ dentro del input que
  borra solo la consulta (y Escape), placeholder que refleja de verdad lo que
  se busca. El reseteo de filtros pasa a App, que es dueña del estado.
- EstadoVacioLista (nuevo): el listado vacío explica el motivo y ofrece salida
  —«✕ Quitar filtros» y «➕ Proponer «‹término›»», que abre la pasarela con el
  nombre ya rellenado— en lugar del párrafo suelto sin acción.
- scripts/entornos.env: alta del entorno de la rama (el build de deploy-branch
  exige prefijo admin por slug).

Tests: 185/185 (21 nuevos) — unitarios de la búsqueda y de componente para el
conteo, el ✕/Escape y el estado vacío. Build ok.
This commit is contained in:
2026-11-01 12:21:40 +01:00
parent 76e19a3ab0
commit 2ec9259d19
10 changed files with 453 additions and 45 deletions
+52 -8
View File
@@ -16,6 +16,7 @@ function renderBarra(over = {}) {
soloFavoritos: false, setSoloFavoritos: vi.fn(),
ubicacion: null, buscandoUbicacion: false, errorUbicacion: "",
pedirUbicacion: vi.fn(), limpiarUbicacion: vi.fn(),
totalResultados: 4, totalLocales: 4, onLimpiar: vi.fn(),
...over,
};
const utils = render(<BarraFiltros {...props} />);
@@ -28,7 +29,7 @@ describe("BarraFiltros", () => {
it("Sección única con búsqueda, provincia, categorías y acciones rápidas", () => {
const { container } = renderBarra();
expect(screen.getByRole("region", { name: /filtros de locales/i })).toBeTruthy();
expect(screen.getByLabelText(/buscar por nombre, dirección o provincia/i)).toBeTruthy();
expect(screen.getByLabelText(/buscar por nombre/i)).toBeTruthy();
expect(screen.getByLabelText(/filtrar por provincia/i)).toBeTruthy();
expect(screen.getByRole("button", { name: /restauración/i })).toBeTruthy();
expect(screen.getByRole("button", { name: /favoritos/i })).toBeTruthy();
@@ -65,8 +66,9 @@ describe("BarraFiltros", () => {
it("El buscador comunica el filtrado por provincia y notifica los cambios", () => {
const { props } = renderBarra();
const input = screen.getByLabelText(/buscar por nombre, dirección o provincia/i);
const input = screen.getByLabelText(/buscar por nombre/i);
expect(input.getAttribute("placeholder")).toMatch(/provincia/i);
expect(input.getAttribute("placeholder")).toMatch(/categoría/i);
fireEvent.change(input, { target: { value: "Madrid" } });
expect(props.setBusqueda).toHaveBeenCalledWith("Madrid");
});
@@ -100,7 +102,7 @@ describe("BarraFiltros", () => {
expect(conUbicacion.props.setOrden).toHaveBeenCalledWith("fecha");
});
it("«✕ Limpiar» está siempre presente: deshabilitado sin filtros y resetea con ellos", () => {
it("«✕ Limpiar» está siempre presente: deshabilitado sin filtros y delega en App con ellos", () => {
renderBarra();
// Presente desde el principio (reserva su hueco: activar un filtro no
// desplaza al grupo de orden que el usuario acaba de pulsar)
@@ -119,12 +121,54 @@ describe("BarraFiltros", () => {
const activo = screen.getByRole("button", { name: /limpiar todos los filtros/i });
expect(activo.disabled).toBe(false);
fireEvent.click(activo);
// El reseteo vive en App (lo comparten la barra y el estado vacío)
expect(props.onLimpiar).toHaveBeenCalledTimes(1);
});
it("Muestra el conteo de resultados y distingue filtrar de ordenar", () => {
renderBarra();
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
renderBarra({ busqueda: "bar", totalResultados: 2 });
expect(screen.getByRole("status").textContent).toBe("2 de 4 locales");
cleanup();
// Ordenar no reduce: sigue siendo el total
renderBarra({ orden: "puntuacion", totalResultados: 4 });
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
// Un filtro que no reduce nada tampoco se anuncia como "N de M"
renderBarra({ filtroProvincia: "Madrid", totalResultados: 4 });
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
renderBarra({ totalResultados: 1, totalLocales: 1 });
expect(screen.getByRole("status").textContent).toBe("1 local");
cleanup();
renderBarra({ totalResultados: 0, totalLocales: 0 });
expect(screen.getByRole("status").textContent).toMatch(/todavía no hay locales publicados/i);
});
it("El ✕ del buscador aparece solo con texto y borra únicamente la consulta", () => {
renderBarra();
expect(screen.queryByRole("button", { name: /borrar búsqueda/i })).toBeNull();
cleanup();
const { props } = renderBarra({ busqueda: "pizza", filtroProvincia: "Madrid" });
fireEvent.click(screen.getByRole("button", { name: /borrar búsqueda/i }));
expect(props.setBusqueda).toHaveBeenCalledWith("");
// No toca el resto de filtros
expect(props.setFiltroProvincia).not.toHaveBeenCalled();
expect(props.onLimpiar).not.toHaveBeenCalled();
});
it("Escape en el buscador limpia la consulta", () => {
const { props } = renderBarra({ busqueda: "pizza" });
fireEvent.keyDown(screen.getByLabelText(/buscar por nombre/i), { key: "Escape" });
expect(props.setBusqueda).toHaveBeenCalledWith("");
expect(props.setFiltroCategoria).toHaveBeenCalledWith("");
expect(props.setFiltroProvincia).toHaveBeenCalledWith("");
expect(props.setOrden).toHaveBeenCalledWith("fecha");
expect(props.setSoloFavoritos).toHaveBeenCalledWith(false);
expect(props.limpiarUbicacion).toHaveBeenCalled();
});
it("Activar el orden no cambia el número de botones de la fila de acciones (sin reflujo)", () => {