feat(resenas): media en la cabecera, formulario bajo la barra y cajón solo de reseñas

- LocalCard: las estrellas de la media van arriba a la derecha, a la
  altura del título; el formulario de reseña se monta DEBAJO de la barra
  y solo al pulsar «Comentar», que queda en estado activo (aria-pressed).
- ResenasLocal pasa a ser presentacional: el cajón animado revela SOLO
  el resto de reseñas y el control de ampliar/plegar es de ancho completo
  y va debajo de ellas (Ver las N reseñas / Ver menos).
- Nuevo hook useResenas (dueño único del estado: lista, total, media,
  reseña propia, envío, borrado, reporte, error) y nuevo FormularioResena
  controlado. Desaparece el ref imperativo comentar().
- Tarjetas de comentario con padding uniforme y texto sin margen interno.
- StarRating exporta TAMANO_ESTRELLAS (14) y lo usan media, tarjetas e
  input: un único tamaño.
- Botones con hover/activo a superficie completa por clases CSS
  (.btn-hover, .btn-hover.activo, .btn-sobre-tarjeta, .btn-primario,
  .btn-verde); se retiran los background inline que anulaban el hover.

164/164 tests y build en verde.
This commit is contained in:
2026-10-13 23:38:32 +02:00
parent 92a13915bc
commit 3f0c58e26d
10 changed files with 685 additions and 384 deletions
+71 -126
View File
@@ -1,164 +1,109 @@
// @vitest-environment jsdom
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { act, cleanup, fireEvent, render, screen, waitFor, within } from "@testing-library/react";
import { afterEach, describe, expect, it, vi } from "vitest";
import { cleanup, fireEvent, render, screen, within } from "@testing-library/react";
// Mock del cliente API (firebase.js re-exporta api.js: el mock intercepta la
// resolución del módulo y cubre ambas vías).
vi.mock("../../src/api.js", () => ({
listarResenas: vi.fn(),
enviarResena: vi.fn(),
borrarResena: vi.fn(),
reportarLocal: vi.fn(),
}));
import { createRef } from "react";
import ResenasLocal from "../../src/components/ResenasLocal.jsx";
import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../../src/api.js";
beforeEach(() => {
vi.clearAllMocks();
localStorage.clear();
});
afterEach(cleanup);
const ISO = "2026-10-11T10:00:00.000Z";
const reseña = (id, huella, puntuacion, comentario, extra = {}) => ({
const resena = (id, huella, puntuacion, comentario, extra = {}) => ({
id, huella, puntuacion, comentario, fecha: ISO, fechaEdicion: null, esPropia: false, ...extra,
});
const CUATRO = [
reseña("r1", "#111111", 5, "Uno"),
reseña("r2", "#222222", 4, "Dos"),
reseña("r3", "#333333", 3, "Tres"),
reseña("r4", "#444444", 2, "Cuatro"),
resena("r1", "#111111", 5, "Uno"),
resena("r2", "#222222", 4, "Dos"),
resena("r3", "#333333", 3, "Tres"),
resena("r4", "#444444", 2, "Cuatro"),
];
const PROPIA = reseña("r9", "#999999", 5, "Mi favorito", { esPropia: true });
const PROPIA = resena("r9", "#999999", 5, "Mi favorito", { esPropia: true });
const cabecera = () => screen.getByRole("button", { name: /reseñas \(\d+\)/i });
const botonAmpliar = () => screen.getByRole("button", { name: /ver las \d+ reseñas/i });
describe("ResenasLocal (grid + cierre por tres vías)", () => {
it("carga al montar y muestra 3 en fila; la 4ª y el formulario quedan plegados", async () => {
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" totalInicial={4} mediaInicial={4} />);
describe("ResenasLocal (presentación)", () => {
it("vista previa de 3 en fila, sin estrellas de media y sin formulario", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
await waitFor(() => expect(listarResenas).toHaveBeenCalledWith("loc-1", expect.any(String)));
expect(await screen.findByText("Uno")).toBeTruthy();
expect(screen.getByText("Dos")).toBeTruthy();
expect(screen.getByText("Tres")).toBeTruthy();
// la vista previa contiene solo las 3 primeras
const previa = screen.getByLabelText(/vista previa de reseñas/i);
const previa = screen.getByLabelText(/reseñas del local/i);
expect(within(previa).getByText("Uno")).toBeTruthy();
expect(within(previa).getByText("Tres")).toBeTruthy();
// la 4ª vive en el cajón plegado
expect(within(previa).queryByText("Cuatro")).toBeNull();
// pista y formulario plegado (aria-hidden excluye los roles)
expect(screen.getByRole("button", { name: /ver las 4 reseñas/i })).toBeTruthy();
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
// la media NO está en la sección (vive en la cabecera de la tarjeta)
expect(within(cabecera()).queryByRole("img")).toBeNull();
// no hay formulario de reseña
expect(screen.queryByRole("radio")).toBeNull();
expect(screen.queryByLabelText(/comentario de la reseña/i)).toBeNull();
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
});
it("expandir revela el resto en el mismo grid y el formulario; la cabecera vuelve a cerrar", async () => {
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno");
it("el control de ampliar va debajo de las reseñas y a ancho completo", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
const boton = botonAmpliar();
const previa = screen.getByLabelText(/reseñas del local/i);
expect(previa.compareDocumentPosition(boton) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
expect(boton.style.width).toBe("100%");
expect(boton.getAttribute("aria-expanded")).toBe("false");
});
it("expandir revela SOLO el resto de reseñas (sin formulario) y pasa a «Ver menos»", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
fireEvent.click(botonAmpliar());
expect(screen.getByText("Cuatro")).toBeTruthy();
expect(screen.queryByRole("radio")).toBeNull();
expect(screen.queryByLabelText(/comentario de la reseña/i)).toBeNull();
expect(screen.getByRole("button", { name: /ver menos/i })).toBeTruthy();
});
it("la cabecera también alterna el plegado", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
fireEvent.click(cabecera());
expect(await screen.findByText("Cuatro")).toBeTruthy();
expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy();
expect(screen.getByRole("button", { name: /cerrar/i })).toBeTruthy();
expect(screen.queryByRole("button", { name: /ver las 4 reseñas/i })).toBeNull();
expect(cabecera().getAttribute("aria-expanded")).toBe("true");
expect(screen.getByRole("button", { name: /ver menos/i })).toBeTruthy();
// cierre vía cabecera
fireEvent.click(cabecera());
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
expect(screen.getByRole("button", { name: /ver las 4 reseñas/i })).toBeTruthy();
});
it("el botón Cerrar del formulario pliega la sección", async () => {
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno");
fireEvent.click(cabecera());
fireEvent.click(await screen.findByRole("button", { name: /cerrar/i }));
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
it("sin reseñas que desplegar no aparece el control de ancho completo", () => {
render(<ResenasLocal resenas={CUATRO.slice(0, 3)} total={3} />);
expect(screen.queryByRole("button", { name: /ver las 3 reseñas/i })).toBeNull();
expect(screen.queryByRole("button", { name: /ver menos/i })).toBeNull();
});
it("comentar() (barra de acciones) alterna: abre con foco y vuelve a cerrar", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
const ref = createRef();
render(<ResenasLocal ref={ref} localId="loc-1" />);
await waitFor(() => expect(listarResenas).toHaveBeenCalled());
it("la reseña propia ofrece Borrar y la ajena Reportar (o el ✅ si ya se reportó)", () => {
const onBorrar = vi.fn();
const onReportar = vi.fn();
render(<ResenasLocal resenas={[PROPIA, CUATRO[0]]} total={2} onBorrar={onBorrar} onReportar={onReportar} />);
act(() => ref.current.comentar());
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 });
await waitFor(
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
{ timeout: 3000 },
);
const previa = screen.getByLabelText(/reseñas del local/i);
const tarjetaPropia = within(previa).getByText("Mi favorito").closest("div");
expect(within(tarjetaPropia).getByText(/^tú$/i)).toBeTruthy();
fireEvent.click(within(tarjetaPropia).getByRole("button", { name: /borrar/i }));
expect(onBorrar).toHaveBeenCalledWith(PROPIA);
act(() => ref.current.comentar());
await waitFor(() => expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull());
});
it("elegir estrellas y publicar llama a enviarResena con el deviceId", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
enviarResena.mockResolvedValue({ ok: true, media: 4, total: 1 });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText(/aún no hay reseñas/i);
fireEvent.click(cabecera());
fireEvent.click(await screen.findByRole("radio", { name: "4 estrellas" }));
fireEvent.change(screen.getByLabelText(/comentario de la reseña/i), { target: { value: "Muy bien" } });
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
await waitFor(() => expect(enviarResena).toHaveBeenCalledWith("loc-1", {
deviceId: expect.any(String),
puntuacion: 4,
comentario: "Muy bien",
}));
expect(localStorage.getItem("localesp_device_id")).toMatch(/./);
});
it("la propia aparece como «Tú» con botón Borrar en su tarjeta; el formulario se precarga (Actualizar)", async () => {
listarResenas.mockResolvedValue({ resenas: [PROPIA], total: 1 });
borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 });
render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={5} />);
const previa = screen.getByLabelText(/vista previa de reseñas/i);
await waitFor(() => expect(within(previa).getByText("Mi favorito")).toBeTruthy());
// tarjeta propia en la vista previa: etiqueta «Tú» + Borrar (sin Reportar)
const tarjeta = within(previa).getByText("Mi favorito").closest("div");
expect(within(tarjeta).getByText(/^tú$/i)).toBeTruthy();
fireEvent.click(within(tarjeta).getByRole("button", { name: /borrar/i }));
await waitFor(() => expect(borrarResena).toHaveBeenCalledWith("loc-1", expect.any(String)));
// el formulario expandido sigue precargando la propia (Actualizar)
fireEvent.click(cabecera());
expect(await screen.findByRole("button", { name: /actualizar/i })).toBeTruthy();
expect(screen.getByLabelText(/comentario de la reseña/i).value).toBe("Mi favorito");
});
it("las reseñas ajenas tienen botón Reportar por tarjeta y queda marcada", async () => {
listarResenas.mockResolvedValue({ resenas: [CUATRO[0]], total: 1 });
reportarLocal.mockResolvedValue({ ok: true });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno");
const tarjetaAjena = within(previa).getByText("Uno").closest("div");
fireEvent.click(within(tarjetaAjena).getByRole("button", { name: /reportar/i }));
expect(onReportar).toHaveBeenCalledWith(CUATRO[0]);
cleanup();
render(<ResenasLocal resenas={[CUATRO[0]]} total={1} reportada="r1" />);
const tarjeta = screen.getByText("Uno").closest("div");
fireEvent.click(within(tarjeta).getByRole("button", { name: /reportar/i }));
await waitFor(() => expect(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "r1"));
await waitFor(() => expect(within(tarjeta).getByText("✅")).toBeTruthy());
expect(within(tarjeta).getByText("✅")).toBeTruthy();
expect(within(tarjeta).queryByRole("button", { name: /reportar/i })).toBeNull();
});
it("errores del servidor (palabras no permitidas, 429) se muestran como aviso", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
enviarResena.mockRejectedValue(new Error("El comentario contiene palabras no permitidas"));
render(<ResenasLocal localId="loc-1" />);
await screen.findByText(/aún no hay reseñas/i);
it("estados de carga y sin reseñas", () => {
render(<ResenasLocal resenas={null} cargando total={0} />);
expect(screen.getByText(/cargando reseñas/i)).toBeTruthy();
cleanup();
fireEvent.click(cabecera());
fireEvent.click(await screen.findByRole("radio", { name: "3 estrellas" }));
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
expect((await screen.findByRole("alert")).textContent).toMatch(/no permitidas/i);
render(<ResenasLocal resenas={[]} total={0} />);
expect(screen.getByText(/aún no hay reseñas/i)).toBeTruthy();
});
});