@1doc/1ds-react 2.8.0 → 2.9.0

package/src/teste/Calendar.test.tsx

@@ -0,0 +1,282 @@
+import { describe, expect, it, vi } from "vitest";
+import { useState } from "react";
+import { render, screen, within } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import Calendar from "../components/Calendar/Calendar";
+
+const HOJE = "2026-05-15";
+const EVENTOS = [
+  { id: "a", date: "2026-05-04", title: "Proc. Administrativo 002/2020", color: "--umds-primitive-blue-pure" },
+  { id: "b", date: "2026-05-11", title: "Protocolo 005/2020", color: "--umds-primitive-green-pure", time: "09:00" },
+  { id: "c", date: "2026-05-11", title: "Ofício 001/2020", color: "--umds-primitive-red-pure", time: "08:00" },
+  { id: "d1", date: "2026-05-20", title: "Reunião 1" },
+  { id: "d2", date: "2026-05-20", title: "Reunião 2" },
+  { id: "d3", date: "2026-05-20", title: "Reunião 3" },
+  { id: "d4", date: "2026-05-20", title: "Reunião 4" },
+  { id: "d5", date: "2026-05-20", title: "Reunião 5" },
+];
+
+const celula = (container: HTMLElement, iso: string) => container.querySelector(`[data-date="${iso}"]`) as HTMLElement;
+
+describe("Calendar", () => {
+  it("é uma grade nomeada pelo mês, com sete cabeçalhos de dia", () => {
+    render(<Calendar today={HOJE} defaultDate={HOJE} />);
+    expect(screen.getByRole("grid", { name: "Maio 2026" })).toBeInTheDocument();
+    const cabecalhos = screen.getAllByRole("columnheader");
+    expect(cabecalhos).toHaveLength(7);
+    expect(cabecalhos[0]).toHaveAccessibleName("Domingo");
+    expect(screen.getByText("Maio 2026")).toBeInTheDocument();
+  });
+
+  it("o mês de maio de 2026 ocupa seis semanas inteiras; dias de fora ganham a classe", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} />);
+    expect(container.querySelectorAll('[role="gridcell"]')).toHaveLength(42);
+    expect(celula(container, "2026-04-26")).toHaveClass("umds-calendar__cell--outside");
+    expect(celula(container, "2026-05-15")).not.toHaveClass("umds-calendar__cell--outside");
+  });
+
+  it("hoje é marcado com aria-current", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} />);
+    expect(celula(container, HOJE)).toHaveAttribute("aria-current", "date");
+    expect(celula(container, "2026-05-16")).not.toHaveAttribute("aria-current");
+  });
+
+  it("cada dia tem nome acessível com a data e a contagem de eventos", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} events={EVENTOS} />);
+    expect(celula(container, "2026-05-11")).toHaveAttribute("aria-label", "segunda-feira, 11 de maio de 2026, 2 eventos");
+    expect(celula(container, "2026-05-04")).toHaveAttribute("aria-label", "segunda-feira, 4 de maio de 2026, 1 evento");
+    expect(celula(container, "2026-05-12")).toHaveAttribute("aria-label", "terça-feira, 12 de maio de 2026, sem eventos");
+  });
+
+  it("dayLabel troca o nome do dia", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} dayLabel={(iso, n) => `${iso}:${n}`} events={EVENTOS} />);
+    expect(celula(container, "2026-05-11")).toHaveAttribute("aria-label", "2026-05-11:2");
+  });
+
+  it("os eventos caem no dia certo, em ordem de horário, com a cor do dado", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} events={EVENTOS} />);
+    const dia = celula(container, "2026-05-11");
+    const chips = within(dia).getAllByRole("button");
+    expect(chips).toHaveLength(2);
+    expect(chips[0]).toHaveTextContent("08:00");
+    expect(chips[0]).toHaveTextContent("Ofício 001/2020");
+    expect((chips[0] as HTMLElement).style.borderLeftColor).toBe("var(--umds-primitive-red-pure)");
+  });
+
+  it("evento sem cor usa o primário", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} events={EVENTOS} />);
+    const chip = within(celula(container, "2026-05-20")).getAllByRole("button")[0] as HTMLElement;
+    expect(chip.style.borderLeftColor).toBe("var(--umds-semantic-color-primary-pure)");
+  });
+
+  it("passou de maxVisible: mostra três e um +N, que avisa com os escondidos", async () => {
+    const usuario = userEvent.setup();
+    const aoVerMais = vi.fn();
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} events={EVENTOS} onMoreClick={aoVerMais} />);
+    const dia = celula(container, "2026-05-20");
+    expect(within(dia).getAllByText(/Reunião/)).toHaveLength(3);
+    const mais = within(dia).getByRole("button", { name: "2 eventos a mais em 20 de maio" });
+    expect(mais).toHaveTextContent("+2");
+    await usuario.click(mais);
+    expect(aoVerMais).toHaveBeenCalledTimes(1);
+    expect(aoVerMais.mock.calls[0][0]).toBe("2026-05-20");
+    expect(aoVerMais.mock.calls[0][1].map((e: any) => e.id)).toEqual(["d4", "d5"]);
+  });
+
+  it("maxVisible muda o corte", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} events={EVENTOS} maxVisible={1} />);
+    expect(within(celula(container, "2026-05-20")).getAllByText(/Reunião/)).toHaveLength(1);
+    expect(within(celula(container, "2026-05-20")).getByText("+4")).toBeInTheDocument();
+  });
+
+  it("clicar no evento avisa com o evento e não clica no dia", async () => {
+    const usuario = userEvent.setup();
+    const aoEvento = vi.fn();
+    const aoDia = vi.fn();
+    render(<Calendar today={HOJE} defaultDate={HOJE} events={EVENTOS} onEventClick={aoEvento} onDayClick={aoDia} />);
+    await usuario.click(screen.getByRole("button", { name: /Proc\. Administrativo 002\/2020/ }));
+    expect(aoEvento).toHaveBeenCalledWith(expect.objectContaining({ id: "a" }));
+    expect(aoDia).not.toHaveBeenCalled();
+  });
+
+  it("clicar no dia avisa com o ISO", async () => {
+    const usuario = userEvent.setup();
+    const aoDia = vi.fn();
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} onDayClick={aoDia} />);
+    await usuario.click(celula(container, "2026-05-12"));
+    expect(aoDia).toHaveBeenCalledWith("2026-05-12");
+  });
+
+  it("anterior, próximo e hoje navegam e avisam em onDateChange", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<Calendar today={HOJE} defaultDate={HOJE} onDateChange={aoMudar} />);
+    await usuario.click(screen.getByRole("button", { name: "Próximo" }));
+    expect(screen.getByText("Junho 2026")).toBeInTheDocument();
+    expect(aoMudar).toHaveBeenLastCalledWith("2026-06-15");
+    await usuario.click(screen.getByRole("button", { name: "Anterior" }));
+    await usuario.click(screen.getByRole("button", { name: "Anterior" }));
+    expect(screen.getByText("Abril 2026")).toBeInTheDocument();
+    await usuario.click(screen.getByRole("button", { name: "Hoje" }));
+    expect(screen.getByText("Maio 2026")).toBeInTheDocument();
+    expect(aoMudar).toHaveBeenLastCalledWith(HOJE);
+  });
+
+  it("só um dia entra na ordem de Tab (hoje), com os eventos dele", () => {
+    const { container } = render(<Calendar today="2026-05-11" defaultDate="2026-05-11" events={EVENTOS} />);
+    const comTab = [...container.querySelectorAll('[role="gridcell"]')].filter((c) => c.getAttribute("tabindex") === "0");
+    expect(comTab).toHaveLength(1);
+    expect(comTab[0]).toHaveAttribute("data-date", "2026-05-11");
+    const chipsComTab = [...container.querySelectorAll(".umds-calendar__event")].filter((c) => c.getAttribute("tabindex") === "0");
+    expect(chipsComTab).toHaveLength(2);
+  });
+
+  it("setas movem o foco entre os dias; Home, End e Enter", async () => {
+    const usuario = userEvent.setup();
+    const aoDia = vi.fn();
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} onDayClick={aoDia} />);
+    celula(container, HOJE).focus();
+    await usuario.keyboard("{ArrowRight}");
+    expect(celula(container, "2026-05-16")).toHaveFocus();
+    await usuario.keyboard("{ArrowDown}");
+    expect(celula(container, "2026-05-23")).toHaveFocus();
+    await usuario.keyboard("{ArrowLeft}{ArrowUp}");
+    expect(celula(container, "2026-05-15")).toHaveFocus();
+    await usuario.keyboard("{Home}");
+    expect(celula(container, "2026-05-10")).toHaveFocus();
+    await usuario.keyboard("{End}");
+    expect(celula(container, "2026-05-16")).toHaveFocus();
+    await usuario.keyboard("{Enter}");
+    expect(aoDia).toHaveBeenCalledWith("2026-05-16");
+  });
+
+  it("a seta que sai do mês troca de mês e leva o foco", async () => {
+    const usuario = userEvent.setup();
+    const { container } = render(<Calendar today={HOJE} defaultDate="2026-05-30" />);
+    celula(container, "2026-05-30").focus();
+    await usuario.keyboard("{ArrowRight}{ArrowRight}");
+    expect(screen.getByText("Junho 2026")).toBeInTheDocument();
+    expect(celula(container, "2026-06-01")).toHaveFocus();
+  });
+
+  it("PageDown e PageUp trocam de mês", async () => {
+    const usuario = userEvent.setup();
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} />);
+    celula(container, HOJE).focus();
+    await usuario.keyboard("{PageDown}");
+    expect(screen.getByText("Junho 2026")).toBeInTheDocument();
+    expect(celula(container, "2026-06-15")).toHaveFocus();
+    await usuario.keyboard("{PageUp}{PageUp}");
+    expect(screen.getByText("Abril 2026")).toBeInTheDocument();
+  });
+
+  it("a visão de semana mostra sete dias, todos os eventos, e avisa em onViewChange", async () => {
+    const usuario = userEvent.setup();
+    const aoVisao = vi.fn();
+    const { container } = render(<Calendar today="2026-05-20" defaultDate="2026-05-20" events={EVENTOS} onViewChange={aoVisao} />);
+    await usuario.click(screen.getByRole("radio", { name: "Semana" }));
+    expect(aoVisao).toHaveBeenCalledWith("week");
+    expect(container.querySelectorAll('[role="gridcell"]')).toHaveLength(7);
+    expect(within(celula(container, "2026-05-20")).getAllByText(/Reunião/)).toHaveLength(5);
+    expect(screen.queryByText("+2")).toBeNull();
+    expect(container.querySelector(".umds-calendar--week")).not.toBeNull();
+  });
+
+  it("na semana, anterior e próximo andam sete dias", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<Calendar today="2026-05-20" defaultDate="2026-05-20" defaultView="week" onDateChange={aoMudar} />);
+    await usuario.click(screen.getByRole("button", { name: "Próximo" }));
+    expect(aoMudar).toHaveBeenLastCalledWith("2026-05-27");
+    await usuario.click(screen.getByRole("button", { name: "Anterior" }));
+    await usuario.click(screen.getByRole("button", { name: "Anterior" }));
+    expect(aoMudar).toHaveBeenLastCalledWith("2026-05-13");
+  });
+
+  it("weekStartsOn=1 começa a semana na segunda", () => {
+    render(<Calendar today={HOJE} defaultDate={HOJE} weekStartsOn={1} />);
+    expect(screen.getAllByRole("columnheader")[0]).toHaveAccessibleName("Segunda-feira");
+  });
+
+  it("controlado: date e view mandam", () => {
+    function Pai() {
+      const [data, setData] = useState("2026-08-10");
+      return <Calendar today={HOJE} date={data} onDateChange={setData} view="month" />;
+    }
+    render(<Pai />);
+    expect(screen.getByText("Agosto 2026")).toBeInTheDocument();
+  });
+
+  it("locale e textos por prop (inglês)", () => {
+    render(
+      <Calendar
+        today={HOJE}
+        defaultDate={HOJE}
+        locale="en-US"
+        previousLabel="Previous"
+        nextLabel="Next"
+        todayLabel="Today"
+        monthLabel="Month"
+        weekLabel="Week"
+        viewLabel="View"
+      />,
+    );
+    expect(screen.getByText("May 2026")).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "Previous" })).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "Next" })).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "Today" })).toBeInTheDocument();
+    expect(screen.getByRole("radio", { name: "Week" })).toBeInTheDocument();
+    expect(screen.getByRole("group", { name: "View" })).toBeInTheDocument();
+    expect(screen.getAllByRole("columnheader")[0]).toHaveAccessibleName("Sunday");
+  });
+
+  it("moreLabel e moreAriaLabel traduzem o +N", () => {
+    render(
+      <Calendar
+        today={HOJE}
+        defaultDate={HOJE}
+        events={EVENTOS}
+        locale="en-US"
+        moreLabel="{count} more"
+        moreAriaLabel="{count} more events on {date}"
+      />,
+    );
+    expect(screen.getByRole("button", { name: "2 more events on May 20" })).toHaveTextContent("2 more");
+  });
+
+  it("hideViewSwitcher esconde o seletor; os slots do cabeçalho aparecem", () => {
+    render(
+      <Calendar
+        today={HOJE}
+        defaultDate={HOJE}
+        hideViewSwitcher
+        headerStart={<span data-testid="filtro">Todos os documentos</span>}
+        headerEnd={<span data-testid="legenda">Legenda</span>}
+      />,
+    );
+    expect(screen.queryByRole("radio")).toBeNull();
+    expect(screen.getByTestId("filtro")).toBeInTheDocument();
+    expect(screen.getByTestId("legenda")).toBeInTheDocument();
+  });
+
+  it("selectedDate marca o dia", () => {
+    const { container } = render(<Calendar today={HOJE} defaultDate={HOJE} selectedDate="2026-05-12" />);
+    expect(celula(container, "2026-05-12")).toHaveAttribute("aria-selected", "true");
+    expect(celula(container, "2026-05-12")).toHaveClass("umds-calendar__cell--selected");
+  });
+
+  it("evento com Date e com data-hora entra no dia", () => {
+    const { container } = render(
+      <Calendar
+        today={HOJE}
+        defaultDate={HOJE}
+        events={[
+          { date: new Date(2026, 4, 12), title: "Com Date" },
+          { date: "2026-05-13T10:30:00", title: "Com hora" },
+        ]}
+      />,
+    );
+    expect(within(celula(container, "2026-05-12")).getByText("Com Date")).toBeInTheDocument();
+    expect(within(celula(container, "2026-05-13")).getByText("Com hora")).toBeInTheDocument();
+  });
+});

package/src/teste/ChipsXs.test.tsx

@@ -0,0 +1,41 @@
+import { describe, expect, it, vi } from "vitest";
+import { fireEvent, render, screen } from "@testing-library/react";
+import Chips from "../components/Chips/Chips";
+
+const raiz = (c: HTMLElement) => c.firstElementChild as HTMLElement;
+
+describe("Chips · xs e × em círculo", () => {
+  it("size xs escreve a classe; sem size continua md", () => {
+    const { container } = render(
+      <>
+        <Chips label="a" size="xs" />
+        <Chips label="b" />
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-chip--xs");
+    expect(container.children[1]).toHaveClass("umds-chip--md");
+  });
+
+  it("circularRemove com removable escreve a classe do círculo", () => {
+    const { container } = render(<Chips label="Marcador" removable circularRemove />);
+    expect(raiz(container)).toHaveClass("umds-chip--remove-circle");
+  });
+
+  it("circularRemove sem removable não escreve a classe (não há ×)", () => {
+    const { container } = render(<Chips label="Marcador" circularRemove />);
+    expect(raiz(container)).not.toHaveClass("umds-chip--remove-circle");
+    expect(screen.queryByRole("button")).toBeNull();
+  });
+
+  it("o × em círculo continua sendo o mesmo botão, com o mesmo nome e o mesmo clique", () => {
+    const aoRemover = vi.fn();
+    render(<Chips label="Urgente" size="xs" removable circularRemove onRemove={aoRemover} />);
+    fireEvent.click(screen.getByRole("button", { name: "Remover Urgente" }));
+    expect(aoRemover).toHaveBeenCalledTimes(1);
+  });
+
+  it("sem circularRemove o chip removível é o de antes", () => {
+    const { container } = render(<Chips label="x" removable />);
+    expect(raiz(container)).not.toHaveClass("umds-chip--remove-circle");
+  });
+});

package/src/teste/Coachmark.test.tsx

@@ -0,0 +1,198 @@
+import { describe, expect, it, vi } from "vitest";
+import { useRef, useState } from "react";
+import { render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import Coachmark from "../components/Coachmark/Coachmark";
+
+const PASSOS = [
+  { target: "#alvo-a", title: "Cada item é uma aba", content: "Fluxos e formulários abrem em abas." },
+  { target: "#alvo-b", title: "Salvo sozinho", content: "Tudo fica neste navegador." },
+  { title: "Pronto", content: "Sem alvo: o cartão fica no centro." },
+];
+
+function Pagina(props: any) {
+  return (
+    <div>
+      <button id="alvo-a">A</button>
+      <button id="alvo-b">B</button>
+      <Coachmark steps={PASSOS} {...props} />
+    </div>
+  );
+}
+
+describe("Coachmark", () => {
+  it("fechado não desenha nada", () => {
+    render(<Pagina open={false} />);
+    expect(screen.queryByRole("dialog")).toBeNull();
+  });
+
+  it("aberto é um diálogo modal nomeado pelo título, com contador e texto", () => {
+    render(<Pagina open />);
+    const dialogo = screen.getByRole("dialog", { name: "Cada item é uma aba" });
+    expect(dialogo).toHaveAttribute("aria-modal", "true");
+    expect(dialogo).toHaveAccessibleDescription("Fluxos e formulários abrem em abas.");
+    expect(screen.getAllByText("1 de 3").length).toBeGreaterThan(0);
+    expect(screen.getByRole("button", { name: "Próximo" })).toBeInTheDocument();
+    expect(screen.queryByRole("button", { name: "Anterior" })).toBeNull();
+  });
+
+  it("o foco entra no cartão ao abrir", () => {
+    render(<Pagina open />);
+    expect(screen.getByRole("dialog")).toHaveFocus();
+  });
+
+  it("Próximo e Anterior trocam de passo e avisam em onStepChange", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<Pagina open onStepChange={aoMudar} />);
+    await usuario.click(screen.getByRole("button", { name: "Próximo" }));
+    expect(aoMudar).toHaveBeenLastCalledWith(1);
+    expect(screen.getByRole("dialog", { name: "Salvo sozinho" })).toBeInTheDocument();
+    await usuario.click(screen.getByRole("button", { name: "Anterior" }));
+    expect(aoMudar).toHaveBeenLastCalledWith(0);
+    expect(screen.getByRole("dialog", { name: "Cada item é uma aba" })).toBeInTheDocument();
+  });
+
+  it("setas direita e esquerda avançam e voltam", async () => {
+    const usuario = userEvent.setup();
+    render(<Pagina open />);
+    await usuario.keyboard("{ArrowRight}");
+    expect(screen.getByRole("dialog", { name: "Salvo sozinho" })).toBeInTheDocument();
+    await usuario.keyboard("{ArrowLeft}");
+    expect(screen.getByRole("dialog", { name: "Cada item é uma aba" })).toBeInTheDocument();
+  });
+
+  it("o último passo troca Próximo por Concluir e fecha com 'finish'", async () => {
+    const usuario = userEvent.setup();
+    const aoFechar = vi.fn();
+    render(<Pagina open defaultStep={2} onClose={aoFechar} />);
+    expect(screen.queryByRole("button", { name: "Próximo" })).toBeNull();
+    await usuario.click(screen.getByRole("button", { name: "Concluir" }));
+    expect(aoFechar).toHaveBeenCalledWith("finish");
+  });
+
+  it("Sair do tour fecha com 'skip' e hideSkip esconde o botão", async () => {
+    const usuario = userEvent.setup();
+    const aoFechar = vi.fn();
+    const { rerender } = render(<Pagina open onClose={aoFechar} />);
+    await usuario.click(screen.getByRole("button", { name: "Sair do tour" }));
+    expect(aoFechar).toHaveBeenCalledWith("skip");
+    rerender(<Pagina open hideSkip onClose={aoFechar} />);
+    expect(screen.queryByRole("button", { name: "Sair do tour" })).toBeNull();
+  });
+
+  it("Esc fecha com 'escape'", async () => {
+    const usuario = userEvent.setup();
+    const aoFechar = vi.fn();
+    render(<Pagina open onClose={aoFechar} />);
+    await usuario.keyboard("{Escape}");
+    expect(aoFechar).toHaveBeenCalledWith("escape");
+  });
+
+  it("o foco fica preso no cartão: Tab gira e Shift+Tab volta", async () => {
+    const usuario = userEvent.setup();
+    render(<Pagina open />);
+    const sair = screen.getByRole("button", { name: "Sair do tour" });
+    const proximo = screen.getByRole("button", { name: "Próximo" });
+    proximo.focus();
+    await usuario.tab();
+    expect(sair).toHaveFocus();
+    await usuario.tab({ shift: true });
+    expect(proximo).toHaveFocus();
+  });
+
+  it("todos os textos vêm por prop", () => {
+    render(
+      <Pagina
+        open
+        defaultStep={1}
+        nextLabel="Next"
+        previousLabel="Back"
+        skipLabel="Skip tour"
+        counterLabel="{current} of {total}"
+      />,
+    );
+    expect(screen.getByRole("button", { name: "Next" })).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "Back" })).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "Skip tour" })).toBeInTheDocument();
+    expect(screen.getAllByText("2 of 3").length).toBeGreaterThan(0);
+  });
+
+  it("finishLabel troca o texto do último passo", () => {
+    render(<Pagina open defaultStep={2} finishLabel="Done" />);
+    expect(screen.getByRole("button", { name: "Done" })).toBeInTheDocument();
+  });
+
+  it("com alvo, desenha o recorte; sem alvo (ou alvo que não existe), não", () => {
+    const { container, rerender } = render(<Pagina open />);
+    expect(document.querySelector(".umds-coachmark__cutout")).not.toBeNull();
+    rerender(<Pagina open step={2} />);
+    expect(document.querySelector(".umds-coachmark__cutout")).toBeNull();
+    expect(document.querySelector(".umds-coachmark--no-target")).not.toBeNull();
+    void container;
+  });
+
+  it("alvo por ref do React e por elemento", () => {
+    function ComRef() {
+      const ref = useRef<HTMLButtonElement>(null);
+      return (
+        <div>
+          <button ref={ref}>Alvo</button>
+          <Coachmark open steps={[{ target: ref, title: "Por ref" }]} />
+        </div>
+      );
+    }
+    render(<ComRef />);
+    expect(screen.getByRole("dialog", { name: "Por ref" })).toBeInTheDocument();
+    expect(document.querySelector(".umds-coachmark__cutout")).not.toBeNull();
+  });
+
+  it("step controlado manda no passo atual", () => {
+    render(<Pagina open step={1} />);
+    expect(screen.getByRole("dialog", { name: "Salvo sozinho" })).toBeInTheDocument();
+  });
+
+  it("ao fechar, o foco volta ao elemento de antes", async () => {
+    const usuario = userEvent.setup();
+    function Dono() {
+      const [aberto, setAberto] = useState(false);
+      return (
+        <div>
+          <button id="abrir" onClick={() => setAberto(true)}>
+            Fazer o tour
+          </button>
+          <Coachmark open={aberto} steps={PASSOS} onClose={() => setAberto(false)} />
+        </div>
+      );
+    }
+    render(<Dono />);
+    const abrir = screen.getByRole("button", { name: "Fazer o tour" });
+    await usuario.click(abrir);
+    expect(screen.getByRole("dialog")).toBeInTheDocument();
+    // O foco entra no cartão depois da montagem (um quadro de animação): na CI,
+    // mais lenta, o Esc chegava antes e caía no body.
+    await waitFor(() => expect(screen.getByRole("dialog").contains(document.activeElement)).toBe(true));
+    await usuario.keyboard("{Escape}");
+    await waitFor(() => expect(screen.queryByRole("dialog")).toBeNull());
+    expect(abrir).toHaveFocus();
+  });
+
+  it("reabrir recomeça do primeiro passo", async () => {
+    const usuario = userEvent.setup();
+    function Dono() {
+      const [aberto, setAberto] = useState(true);
+      return (
+        <div>
+          <button onClick={() => setAberto(true)}>Reabrir</button>
+          <Coachmark open={aberto} steps={PASSOS} onClose={() => setAberto(false)} />
+        </div>
+      );
+    }
+    render(<Dono />);
+    await usuario.keyboard("{ArrowRight}");
+    expect(screen.getByRole("dialog", { name: "Salvo sozinho" })).toBeInTheDocument();
+    await usuario.keyboard("{Escape}");
+    await usuario.click(screen.getByRole("button", { name: "Reabrir" }));
+    expect(screen.getByRole("dialog", { name: "Cada item é uma aba" })).toBeInTheDocument();
+  });
+});

package/src/teste/ColorPicker.test.tsx

@@ -0,0 +1,153 @@
+import { describe, expect, it, vi } from "vitest";
+import { useState } from "react";
+import { render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import ColorPicker from "../components/ColorPicker/ColorPicker";
+import { COLOR_PALETTE } from "../utils/paleta-de-cores";
+
+describe("ColorPicker", () => {
+  it("é um radiogroup com uma amostra por primitivo de cor, cada uma com nome", () => {
+    render(<ColorPicker ariaLabel="Cor do marcador" />);
+    const grupo = screen.getByRole("radiogroup", { name: "Cor do marcador" });
+    expect(grupo.querySelectorAll('[role="radio"]')).toHaveLength(COLOR_PALETTE.length);
+    expect(COLOR_PALETTE).toHaveLength(31);
+    expect(screen.getByRole("radio", { name: "Azul escuro" })).toBeInTheDocument();
+    expect(screen.getByRole("radio", { name: "Cinza muito claro" })).toBeInTheDocument();
+  });
+
+  it("pinta cada amostra com a variável do token", () => {
+    render(<ColorPicker ariaLabel="Cor" />);
+    const azul = screen.getByRole("radio", { name: "Azul" }) as HTMLElement;
+    expect(azul.style.backgroundColor).toBe("var(--umds-primitive-blue-pure)");
+  });
+
+  it("clicar escolhe e entrega o NOME do token em onChange", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<ColorPicker ariaLabel="Cor" onChange={aoMudar} />);
+    await usuario.click(screen.getByRole("radio", { name: "Verde" }));
+    expect(aoMudar).toHaveBeenCalledWith("--umds-primitive-green-pure");
+    expect(screen.getByRole("radio", { name: "Verde" })).toHaveAttribute("aria-checked", "true");
+  });
+
+  it("não escolhido tem aria-checked false e só a escolhida mostra a marcação", () => {
+    const { container } = render(<ColorPicker ariaLabel="Cor" defaultValue="--umds-primitive-red-pure" />);
+    expect(screen.getByRole("radio", { name: "Vermelho" })).toHaveAttribute("aria-checked", "true");
+    expect(screen.getByRole("radio", { name: "Azul" })).toHaveAttribute("aria-checked", "false");
+    expect(container.querySelectorAll(".umds-color-picker__swatch svg")).toHaveLength(1);
+  });
+
+  it("Tab entra na amostra escolhida (roving tabindex)", () => {
+    render(<ColorPicker ariaLabel="Cor" value="--umds-primitive-orange-pure" />);
+    const radios = screen.getAllByRole("radio");
+    const comTab = radios.filter((r) => r.getAttribute("tabindex") === "0");
+    expect(comTab).toHaveLength(1);
+    expect(comTab[0]).toHaveAccessibleName("Laranja");
+  });
+
+  it("sem valor, Tab entra na primeira amostra", () => {
+    render(<ColorPicker ariaLabel="Cor" />);
+    expect(screen.getAllByRole("radio")[0]).toHaveAttribute("tabindex", "0");
+  });
+
+  it("setas movem a escolha e o foco; Home e End vão às pontas; dá a volta", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<ColorPicker ariaLabel="Cor" families={["blue"]} defaultValue="--umds-primitive-blue-dark" onChange={aoMudar} />);
+    const radios = screen.getAllByRole("radio");
+    radios[0].focus();
+    await usuario.keyboard("{ArrowRight}");
+    expect(aoMudar).toHaveBeenLastCalledWith("--umds-primitive-blue-pure");
+    expect(radios[1]).toHaveFocus();
+    await usuario.keyboard("{ArrowLeft}{ArrowLeft}");
+    expect(aoMudar).toHaveBeenLastCalledWith("--umds-primitive-blue-light");
+    expect(radios[3]).toHaveFocus();
+    await usuario.keyboard("{Home}");
+    expect(radios[0]).toHaveFocus();
+    await usuario.keyboard("{End}");
+    expect(radios[3]).toHaveFocus();
+    await usuario.keyboard("{ArrowDown}");
+    expect(radios[0]).toHaveFocus();
+  });
+
+  it("pula amostra desabilitada no teclado", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(
+      <ColorPicker
+        ariaLabel="Cor"
+        defaultValue="a"
+        onChange={aoMudar}
+        swatches={[
+          { value: "a", label: "A" },
+          { value: "b", label: "B", disabled: true },
+          { value: "c", label: "C" },
+        ]}
+      />,
+    );
+    screen.getByRole("radio", { name: "A" }).focus();
+    await usuario.keyboard("{ArrowRight}");
+    expect(aoMudar).toHaveBeenLastCalledWith("c");
+  });
+
+  it("families recorta a paleta", () => {
+    render(<ColorPicker ariaLabel="Cor" families={["blue", "gray"]} />);
+    expect(screen.getAllByRole("radio")).toHaveLength(11);
+  });
+
+  it("swatches substitui a paleta (nomes traduzidos)", () => {
+    render(<ColorPicker ariaLabel="Color" swatches={[{ value: "--umds-primitive-blue-pure", label: "Blue" }]} />);
+    expect(screen.getAllByRole("radio")).toHaveLength(1);
+    expect(screen.getByRole("radio", { name: "Blue" })).toBeInTheDocument();
+  });
+
+  it("disabled desabilita todas as amostras", () => {
+    render(<ColorPicker ariaLabel="Cor" disabled />);
+    for (const r of screen.getAllByRole("radio")) expect(r).toBeDisabled();
+  });
+
+  it("label visível nomeia o grupo", () => {
+    render(<ColorPicker label="Cor de fundo" id="cp" />);
+    expect(screen.getByRole("radiogroup", { name: "Cor de fundo" })).toBeInTheDocument();
+  });
+
+  it("cor livre vem desligada: sem campo de hexadecimal", () => {
+    render(<ColorPicker ariaLabel="Cor" />);
+    expect(screen.queryByLabelText(/hexadecimal/i)).toBeNull();
+  });
+
+  it("allowCustom: hexadecimal completo vira #RRGGBB em maiúsculas; incompleto não emite", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<ColorPicker ariaLabel="Cor" allowCustom onChange={aoMudar} />);
+    const campo = screen.getByLabelText("Cor livre (hexadecimal)");
+    await usuario.type(campo, "0058d");
+    expect(aoMudar).not.toHaveBeenCalled();
+    await usuario.type(campo, "b");
+    expect(aoMudar).toHaveBeenCalledTimes(1);
+    expect(aoMudar).toHaveBeenCalledWith("#0058DB");
+  });
+
+  it("allowCustom: hexadecimal inválido mostra a mensagem ao sair do campo", async () => {
+    const usuario = userEvent.setup();
+    render(<ColorPicker ariaLabel="Cor" allowCustom customErrorMessage="Formato inválido" />);
+    const campo = screen.getByLabelText("Cor livre (hexadecimal)");
+    await usuario.type(campo, "xyz");
+    expect(screen.queryByText("Formato inválido")).toBeNull();
+    await usuario.tab();
+    expect(screen.getByText("Formato inválido")).toBeInTheDocument();
+  });
+
+  it("controlado: reflete o value e escolher uma amostra limpa o campo livre", async () => {
+    const usuario = userEvent.setup();
+    function Controlado() {
+      const [valor, setValor] = useState("#336699");
+      return <ColorPicker ariaLabel="Cor" allowCustom value={valor} onChange={setValor} />;
+    }
+    render(<Controlado />);
+    const campo = screen.getByLabelText("Cor livre (hexadecimal)") as HTMLInputElement;
+    expect(campo.value).toBe("#336699");
+    await usuario.click(screen.getByRole("radio", { name: "Azul" }));
+    expect(campo.value).toBe("");
+  });
+});