@1doc/1ds-react 2.8.0 → 2.9.0

package/src/teste/DataTableCelulaLivre.test.tsx

@@ -0,0 +1,103 @@
+import { describe, expect, it } from "vitest";
+import { render, screen, within } from "@testing-library/react";
+import DataTable, { type DataTableColumn } from "../components/DataTable/DataTable";
+
+/**
+ * Célula livre (`render` devolvendo nó) e linha de grupo (`rowGroup`).
+ * No Vue o equivalente é o slot `#cell-<key>`: ver `datatable-slots.test.mjs`.
+ */
+
+const USUARIOS = [
+  { id: 1, nome: "Lucas Andrade", setor: "SADM", perfil: "Administrador" },
+  { id: 2, nome: "Marina Souza", setor: "SADM", perfil: "Nível 1" },
+  { id: 3, nome: "Rafael Pereira", setor: "SOBR", perfil: "Nível 2" },
+];
+
+describe("DataTable · célula livre", () => {
+  it("render devolvendo elemento desenha o nó, não texto", () => {
+    const colunas: DataTableColumn[] = [
+      { key: "nome", label: "Usuário", render: (row) => <strong data-testid="nome">{row.nome}</strong> },
+      { key: "perfil", label: "Perfil" },
+    ];
+    render(<DataTable columns={colunas} data={USUARIOS} />);
+
+    const nos = screen.getAllByTestId("nome");
+    expect(nos).toHaveLength(3);
+    expect(nos[0].tagName).toBe("STRONG");
+    expect(nos[0]).toHaveTextContent("Lucas Andrade");
+  });
+
+  it("render recebe a linha e o índice", () => {
+    const colunas: DataTableColumn[] = [
+      { key: "nome", label: "Usuário", render: (row, i) => `${i + 1}. ${row.nome}` },
+    ];
+    render(<DataTable columns={colunas} data={USUARIOS} />);
+    expect(screen.getByText("2. Marina Souza")).toBeInTheDocument();
+  });
+
+  it("DataTableColumn é exportado e tipa a coluna com render de nó", () => {
+    const coluna: DataTableColumn = {
+      key: "acoes",
+      label: "Ações",
+      render: () => <button type="button">Editar</button>,
+    };
+    render(<DataTable columns={[coluna]} data={USUARIOS} />);
+    expect(screen.getAllByRole("button", { name: "Editar" })).toHaveLength(3);
+  });
+});
+
+describe("DataTable · linha de grupo (rowGroup)", () => {
+  const colunas: DataTableColumn[] = [
+    { key: "nome", label: "Usuário" },
+    { key: "perfil", label: "Perfil" },
+  ];
+
+  it("sem rowGroup não desenha linha de grupo", () => {
+    const { container } = render(<DataTable columns={colunas} data={USUARIOS} />);
+    expect(container.querySelector("th[scope='rowgroup']")).toBeNull();
+  });
+
+  it("rowGroup por campo abre um grupo por valor consecutivo", () => {
+    const { container } = render(<DataTable columns={colunas} data={USUARIOS} rowGroup="setor" />);
+    const grupos = container.querySelectorAll("th[scope='rowgroup']");
+    expect(Array.from(grupos).map((g) => g.textContent)).toEqual(["SADM", "SOBR"]);
+    // a linha de grupo atravessa as colunas todas
+    expect(grupos[0]).toHaveAttribute("colspan", "2");
+  });
+
+  it("rowGroup por função e colspan com selectable", () => {
+    const { container } = render(
+      <DataTable
+        columns={colunas}
+        data={USUARIOS}
+        selectable
+        rowGroup={(row) => (row.id === 3 ? undefined : "Equipe A")}
+      />,
+    );
+    const grupos = container.querySelectorAll("th[scope='rowgroup']");
+    expect(grupos).toHaveLength(1);
+    expect(grupos[0]).toHaveTextContent("Equipe A");
+    expect(grupos[0]).toHaveAttribute("colspan", "3");
+  });
+
+  it("renderRowGroup devolve nó", () => {
+    render(
+      <DataTable
+        columns={colunas}
+        data={USUARIOS}
+        rowGroup="setor"
+        renderRowGroup={(rotulo) => <em data-testid="grupo">{rotulo}!</em>}
+      />,
+    );
+    expect(screen.getAllByTestId("grupo").map((n) => n.textContent)).toEqual(["SADM!", "SOBR!"]);
+  });
+
+  it("a linha de grupo não entra na seleção por índice", async () => {
+    const { container } = render(
+      <DataTable columns={colunas} data={USUARIOS} rowGroup="setor" selectable selectedRows={[2]} />,
+    );
+    const selecionadas = container.querySelectorAll(".umds-datatable__row--selected");
+    expect(selecionadas).toHaveLength(1);
+    expect(within(selecionadas[0] as HTMLElement).getByText("Rafael Pereira")).toBeInTheDocument();
+  });
+});

package/src/teste/DataTableDocumento.test.tsx

@@ -0,0 +1,102 @@
+import { describe, expect, it, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import DataTable from "../components/DataTable/DataTable";
+import DescriptionList from "../components/DescriptionList/DescriptionList";
+
+const COLUNAS = [
+  { key: "descricao", label: "Descrição", sortable: true },
+  { key: "quantidade", label: "Quantidade", align: "right" as const },
+];
+const DADOS = [
+  { descricao: "Diesel S10", quantidade: "5.760" },
+  { descricao: "Gasolina comum", quantidade: "1.200" },
+];
+
+describe("DataTable variant=document", () => {
+  it("é a tabela de documento: classe própria, cabeçalho e linhas", () => {
+    const { container } = render(<DataTable variant="document" columns={COLUNAS} data={DADOS} />);
+    expect(container.querySelector(".umds-datatable--document")).not.toBeNull();
+    expect(screen.getAllByRole("columnheader")).toHaveLength(2);
+    expect(screen.getByText("Diesel S10")).toBeInTheDocument();
+  });
+
+  it("não ordena: sem botão de ordenar, sem aria-sort", () => {
+    render(<DataTable variant="document" columns={COLUNAS} data={DADOS} sortKey="descricao" sortDirection="asc" />);
+    expect(screen.queryByRole("button")).toBeNull();
+    for (const th of screen.getAllByRole("columnheader")) expect(th).not.toHaveAttribute("aria-sort");
+  });
+
+  it("não seleciona: selectable é ignorado", () => {
+    render(<DataTable variant="document" selectable columns={COLUNAS} data={DADOS} />);
+    expect(screen.queryByRole("checkbox")).toBeNull();
+    expect(screen.getAllByRole("columnheader")).toHaveLength(2);
+  });
+
+  it("linha não é clicável nem entra na ordem de Tab", async () => {
+    const usuario = userEvent.setup();
+    const aoClicar = vi.fn();
+    const { container } = render(<DataTable variant="document" columns={COLUNAS} data={DADOS} onRowClick={aoClicar} />);
+    const linha = container.querySelector("tbody tr") as HTMLElement;
+    expect(linha).not.toHaveAttribute("tabindex");
+    expect(linha).not.toHaveClass("umds-datatable__row--clickable");
+    await usuario.click(linha);
+    expect(aoClicar).not.toHaveBeenCalled();
+  });
+
+  it("a tabela de interface continua igual (ordena, seleciona, clica)", async () => {
+    const usuario = userEvent.setup();
+    const aoOrdenar = vi.fn();
+    render(<DataTable columns={COLUNAS} data={DADOS} selectable onSort={aoOrdenar} />);
+    expect(screen.getAllByRole("checkbox").length).toBeGreaterThan(0);
+    await usuario.click(screen.getByRole("button", { name: /Descrição/ }));
+    expect(aoOrdenar).toHaveBeenCalledWith("descricao", "asc");
+  });
+});
+
+describe("DescriptionList", () => {
+  const ITENS = [
+    { label: "Dotação", value: "02.031.0001" },
+    { label: "Empenho", value: "2026NE000184" },
+    { label: "Fonte", value: "" },
+  ];
+
+  it("é um dl com um dt e um dd por par", () => {
+    const { container } = render(<DescriptionList items={ITENS} ariaLabel="Dados de empenho" />);
+    const dl = container.querySelector("dl") as HTMLElement;
+    expect(dl).toHaveAttribute("aria-label", "Dados de empenho");
+    expect(dl.querySelectorAll("dt")).toHaveLength(3);
+    expect(dl.querySelectorAll("dd")).toHaveLength(3);
+    expect(dl.querySelector("dt")).toHaveTextContent("Dotação");
+    expect(dl.querySelector("dd")).toHaveTextContent("02.031.0001");
+  });
+
+  it("valor vazio mostra o traço, ou o texto de emptyValue", () => {
+    const { container, rerender } = render(<DescriptionList items={ITENS} />);
+    expect(container.querySelectorAll("dd")[2]).toHaveTextContent("—");
+    rerender(<DescriptionList items={ITENS} emptyValue="Não informado" />);
+    expect(container.querySelectorAll("dd")[2]).toHaveTextContent("Não informado");
+  });
+
+  it("inline é o padrão; fit encolhe", () => {
+    const { container, rerender } = render(<DescriptionList items={ITENS} />);
+    const dl = container.querySelector("dl") as HTMLElement;
+    expect(dl).toHaveClass("umds-description-list--inline");
+    expect(dl).not.toHaveClass("umds-description-list--fit");
+    rerender(<DescriptionList items={ITENS} fit />);
+    expect(container.querySelector("dl")).toHaveClass("umds-description-list--fit");
+  });
+
+  it("stacked ganha as colunas e a caixa do valor", () => {
+    const { container } = render(<DescriptionList items={ITENS} layout="stacked" columns={3} bordered />);
+    const dl = container.querySelector("dl") as HTMLElement;
+    expect(dl).toHaveClass("umds-description-list--stacked");
+    expect(dl).toHaveClass("umds-description-list--cols-3");
+    expect(dl).toHaveClass("umds-description-list--bordered");
+  });
+
+  it("sem itens, não desenha par nenhum", () => {
+    const { container } = render(<DescriptionList />);
+    expect(container.querySelectorAll("dt")).toHaveLength(0);
+  });
+});

package/src/teste/DatePicker.test.tsx

@@ -84,3 +84,41 @@ describe("DatePicker · teclado", () => {
     expect(screen.getByRole("combobox")).toHaveTextContent(/15\/\d{2}\/\d{4}/);
   });
 });
+
+/**
+ * A story "Com valor" mostrava "Selecione o período" com `value="2025-12-31"`.
+ * Não era a story: no modo single o componente só lia `range`, e `value` e
+ * `defaultValue` eram declarados e nunca chegavam ao campo.
+ */
+describe("DatePicker · valor no modo single", () => {
+  it("`value` aparece no campo, no formato pedido", () => {
+    render(
+      <DatePicker label="Vencimento" value="2025-12-31" format="DD/MM/YYYY" />,
+    );
+    expect(screen.getByRole("combobox")).toHaveTextContent("31/12/2025");
+  });
+
+  it("`defaultValue` semeia o campo no modo não-controlado", () => {
+    render(<DatePicker label="Vencimento" defaultValue="2025-06-15" />);
+    expect(screen.getByRole("combobox")).toHaveTextContent("15/06/2025");
+  });
+
+  it("`value` vazio no modo controlado mostra o placeholder", () => {
+    render(<DatePicker label="Vencimento" value="" placeholder="DD/MM/AAAA" />);
+    expect(screen.getByRole("combobox")).toHaveTextContent("DD/MM/AAAA");
+  });
+
+  it("o modo range continua lendo `range`, não `value`", () => {
+    render(
+      <DatePicker
+        mode="range"
+        label="Período"
+        value="2025-01-01"
+        range={{ from: "2025-03-01", to: "2025-03-10" }}
+      />,
+    );
+    expect(screen.getByRole("combobox")).toHaveTextContent(
+      "01/03/2025 – 10/03/2025",
+    );
+  });
+});

package/src/teste/FileInputTrigger.test.tsx

@@ -0,0 +1,89 @@
+import { describe, expect, it, vi } from "vitest";
+import { fireEvent, render, screen } from "@testing-library/react";
+import FileInput from "../components/FileInput/FileInput";
+
+const arquivo = (nome: string) => new File(["conteudo"], nome, { type: "application/pdf" });
+
+describe("FileInput · variant trigger", () => {
+  it("renderiza o conteúdo como gatilho, sem a caixa de arrastar", () => {
+    const { container } = render(
+      <FileInput variant="trigger">
+        <button type="button">Anexar arquivo</button>
+      </FileInput>,
+    );
+    expect(screen.getByRole("button", { name: "Anexar arquivo" })).toBeInTheDocument();
+    expect(container.querySelector(".umds-file-input__drop-zone")).toBeNull();
+    expect(container.querySelector(".umds-file-input--trigger")).not.toBeNull();
+  });
+
+  it("clicar no conteúdo abre o seletor (clique no input nativo)", () => {
+    const { container } = render(
+      <FileInput variant="trigger">
+        <button type="button">Anexar arquivo</button>
+      </FileInput>,
+    );
+    const nativo = container.querySelector('input[type="file"]') as HTMLInputElement;
+    const clique = vi.spyOn(nativo, "click");
+    fireEvent.click(screen.getByRole("button", { name: "Anexar arquivo" }));
+    expect(clique).toHaveBeenCalledTimes(1);
+  });
+
+  it("disabled não abre o seletor", () => {
+    const { container } = render(
+      <FileInput variant="trigger" disabled>
+        <span>Alterar foto</span>
+      </FileInput>,
+    );
+    const nativo = container.querySelector('input[type="file"]') as HTMLInputElement;
+    const clique = vi.spyOn(nativo, "click");
+    fireEvent.click(screen.getByText("Alterar foto"));
+    expect(clique).not.toHaveBeenCalled();
+  });
+
+  it("escolher arquivos chama onChange, e accept e multiple chegam ao input", () => {
+    const aoMudar = vi.fn();
+    const { container } = render(
+      <FileInput variant="trigger" accept=".pdf" multiple onChange={aoMudar}>
+        <button type="button">Anexar</button>
+      </FileInput>,
+    );
+    const nativo = container.querySelector('input[type="file"]') as HTMLInputElement;
+    expect(nativo).toHaveAttribute("accept", ".pdf");
+    expect(nativo).toHaveAttribute("multiple");
+    fireEvent.change(nativo, { target: { files: [arquivo("a.pdf"), arquivo("b.pdf")] } });
+    expect(aoMudar).toHaveBeenCalledTimes(1);
+    expect(aoMudar.mock.calls[0][0].map((f: File) => f.name)).toEqual(["a.pdf", "b.pdf"]);
+  });
+
+  it("o input nativo não entra no Tab e tem nome acessível", () => {
+    const { container } = render(
+      <FileInput variant="trigger" label="Anexar arquivo">
+        <button type="button">Anexar</button>
+      </FileInput>,
+    );
+    const nativo = container.querySelector('input[type="file"]') as HTMLInputElement;
+    expect(nativo).toHaveAttribute("tabindex", "-1");
+    expect(nativo).toHaveAttribute("aria-label", "Anexar arquivo");
+    // o rótulo visível não aparece: o gatilho é o conteúdo
+    expect(container.querySelector(".umds-file-input__label")).toBeNull();
+  });
+
+  it("a lista de arquivos continua aparecendo no modo trigger", () => {
+    render(
+      <FileInput variant="trigger" files={[{ name: "oficio.pdf", size: 2048 }]}>
+        <button type="button">Anexar</button>
+      </FileInput>,
+    );
+    expect(screen.getByText("oficio.pdf")).toBeInTheDocument();
+  });
+
+  it("as variantes base e card seguem com a caixa", () => {
+    const { container } = render(
+      <>
+        <FileInput variant="base" />
+        <FileInput variant="card" />
+      </>,
+    );
+    expect(container.querySelectorAll(".umds-file-input__drop-zone")).toHaveLength(2);
+  });
+});

package/src/teste/IconPicker.test.tsx

@@ -0,0 +1,145 @@
+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 { faBuilding, faFileLines, faFolder, faGavel, faUser } from "@fortawesome/free-solid-svg-icons";
+import IconPicker from "../components/IconPicker/IconPicker";
+
+const ICONES = [
+  faUser,
+  faFolder,
+  faFileLines,
+  { icon: faBuilding, label: "Prédio", keywords: ["prefeitura", "órgão"] },
+  { icon: faGavel, label: "Martelo", keywords: ["jurídico", "decisão"] },
+];
+
+const radios = () => screen.getAllByRole("radio");
+
+describe("IconPicker", () => {
+  it("é um radiogroup com um radio por ícone, nomeado pelo iconName sem hífen", () => {
+    render(<IconPicker ariaLabel="Ícone da categoria" icons={ICONES} />);
+    expect(screen.getByRole("radiogroup", { name: "Ícone da categoria" })).toBeInTheDocument();
+    expect(radios()).toHaveLength(5);
+    expect(screen.getByRole("radio", { name: "user" })).toBeInTheDocument();
+    expect(screen.getByRole("radio", { name: "file lines" })).toBeInTheDocument();
+    expect(screen.getByRole("radio", { name: "Prédio" })).toBeInTheDocument();
+  });
+
+  it("iconLabel traduz os nomes que não vêm com label", () => {
+    render(<IconPicker ariaLabel="x" icons={[faUser, faFolder]} iconLabel={(n) => ({ user: "Pessoa", folder: "Pasta" } as any)[n]} />);
+    expect(screen.getByRole("radio", { name: "Pessoa" })).toBeInTheDocument();
+    expect(screen.getByRole("radio", { name: "Pasta" })).toBeInTheDocument();
+  });
+
+  it("clicar escolhe e entrega o NOME do ícone e o item em onChange", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<IconPicker ariaLabel="x" icons={ICONES} onChange={aoMudar} />);
+    await usuario.click(screen.getByRole("radio", { name: "folder" }));
+    expect(aoMudar).toHaveBeenCalledWith("folder", faFolder);
+    expect(screen.getByRole("radio", { name: "folder" })).toHaveAttribute("aria-checked", "true");
+    await usuario.click(screen.getByRole("radio", { name: "Prédio" }));
+    expect(aoMudar).toHaveBeenLastCalledWith("building", ICONES[3]);
+  });
+
+  it("defaultValue marca o escolhido; só ele entra na ordem de Tab", () => {
+    render(<IconPicker ariaLabel="x" icons={ICONES} defaultValue="file-lines" />);
+    expect(screen.getByRole("radio", { name: "file lines" })).toHaveAttribute("aria-checked", "true");
+    const comTab = radios().filter((r) => r.getAttribute("tabindex") === "0");
+    expect(comTab).toHaveLength(1);
+    expect(comTab[0]).toHaveAccessibleName("file lines");
+  });
+
+  it("sem valor, Tab entra no primeiro", () => {
+    render(<IconPicker ariaLabel="x" icons={ICONES} />);
+    expect(radios()[0]).toHaveAttribute("tabindex", "0");
+  });
+
+  it("a busca filtra por nome, rótulo e palavras-chave, sem acento nem caixa", async () => {
+    const usuario = userEvent.setup();
+    render(<IconPicker ariaLabel="x" icons={ICONES} />);
+    const campo = screen.getByRole("searchbox", { name: "Buscar ícone" });
+    await usuario.type(campo, "PREFEITURA");
+    expect(radios()).toHaveLength(1);
+    expect(radios()[0]).toHaveAccessibleName("Prédio");
+    await usuario.clear(campo);
+    await usuario.type(campo, "juridico");
+    expect(radios().map((r) => r.getAttribute("aria-label"))).toEqual(["Martelo"]);
+    await usuario.clear(campo);
+    await usuario.type(campo, "fol");
+    expect(radios().map((r) => r.getAttribute("aria-label"))).toEqual(["folder"]);
+  });
+
+  it("a quantidade de resultados é anunciada e resultsLabel traduz", async () => {
+    const usuario = userEvent.setup();
+    render(<IconPicker ariaLabel="x" icons={ICONES} resultsLabel="{count} icons" />);
+    expect(screen.getByRole("status")).toHaveTextContent("5 icons");
+    await usuario.type(screen.getByRole("searchbox"), "user");
+    expect(screen.getByRole("status")).toHaveTextContent("1 icons");
+  });
+
+  it("sem resultado mostra o texto e some a grade", async () => {
+    const usuario = userEvent.setup();
+    render(<IconPicker ariaLabel="x" icons={ICONES} emptyText="Nada por aqui" />);
+    await usuario.type(screen.getByRole("searchbox"), "zzz");
+    expect(screen.getByText("Nada por aqui")).toBeInTheDocument();
+    expect(screen.queryByRole("radiogroup")).toBeNull();
+  });
+
+  it("setas movem a escolha e o foco; cima e baixo andam uma linha (columns)", async () => {
+    const usuario = userEvent.setup();
+    const aoMudar = vi.fn();
+    render(<IconPicker ariaLabel="x" icons={ICONES} columns={2} defaultValue="user" onChange={aoMudar} />);
+    radios()[0].focus();
+    await usuario.keyboard("{ArrowRight}");
+    expect(aoMudar).toHaveBeenLastCalledWith("folder", faFolder);
+    expect(radios()[1]).toHaveFocus();
+    await usuario.keyboard("{ArrowDown}");
+    expect(radios()[3]).toHaveFocus();
+    await usuario.keyboard("{ArrowUp}");
+    expect(radios()[1]).toHaveFocus();
+    await usuario.keyboard("{End}");
+    expect(radios()[4]).toHaveFocus();
+    await usuario.keyboard("{ArrowRight}");
+    expect(radios()[0]).toHaveFocus();
+    await usuario.keyboard("{ArrowLeft}");
+    expect(radios()[4]).toHaveFocus();
+    await usuario.keyboard("{Home}");
+    expect(radios()[0]).toHaveFocus();
+  });
+
+  it("seta para baixo no campo de busca leva à grade", async () => {
+    const usuario = userEvent.setup();
+    render(<IconPicker ariaLabel="x" icons={ICONES} defaultValue="folder" />);
+    await usuario.click(screen.getByRole("searchbox"));
+    await usuario.keyboard("{ArrowDown}");
+    expect(screen.getByRole("radio", { name: "folder" })).toHaveFocus();
+  });
+
+  it("hideSearch tira o campo; disabled desabilita tudo", () => {
+    const { rerender } = render(<IconPicker ariaLabel="x" icons={ICONES} hideSearch />);
+    expect(screen.queryByRole("searchbox")).toBeNull();
+    rerender(<IconPicker ariaLabel="x" icons={ICONES} disabled />);
+    for (const r of radios()) expect(r).toBeDisabled();
+  });
+
+  it("textos da busca por prop; label visível nomeia o grupo; columns vira o grid", () => {
+    const { container } = render(
+      <IconPicker label="Ícone" id="ip" icons={ICONES} searchLabel="Search icon" searchPlaceholder="Search..." columns={4} maxHeight={120} />,
+    );
+    expect(screen.getByRole("radiogroup", { name: "Ícone" })).toBeInTheDocument();
+    expect(screen.getByRole("searchbox", { name: "Search icon" })).toHaveAttribute("placeholder", "Search...");
+    const grade = container.querySelector(".umds-icon-picker__grid") as HTMLElement;
+    expect(grade.style.gridTemplateColumns).toBe("repeat(4, var(--umds-icon-picker-tile))");
+    expect(grade.style.maxHeight).toBe("120px");
+  });
+
+  it("controlado: reflete o value", () => {
+    function Pai() {
+      const [valor, setValor] = useState("gavel");
+      return <IconPicker ariaLabel="x" icons={ICONES} value={valor} onChange={setValor} />;
+    }
+    render(<Pai />);
+    expect(screen.getByRole("radio", { name: "Martelo" })).toHaveAttribute("aria-checked", "true");
+  });
+});

package/src/teste/InputMascaraEAfins.test.tsx

@@ -0,0 +1,124 @@
+import { describe, expect, it, vi } from "vitest";
+import { fireEvent, render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { faMagnifyingGlass } from "@fortawesome/free-solid-svg-icons";
+import Input from "../components/Input/Input";
+
+describe("Input · onChange a cada tecla, uma vez só", () => {
+  it("digitar chama onChange uma vez por tecla, com o valor novo", async () => {
+    const aoMudar = vi.fn();
+    render(<Input label="Nome" onChange={aoMudar} />);
+    await userEvent.type(screen.getByLabelText("Nome"), "ab");
+    expect(aoMudar.mock.calls.map((c) => c[0])).toEqual(["a", "ab"]);
+  });
+
+  it("change disparado à mão também chega (testes de quem consome)", () => {
+    const aoMudar = vi.fn();
+    render(<Input label="Nome" onChange={aoMudar} />);
+    fireEvent.change(screen.getByLabelText("Nome"), { target: { value: "xyz" } });
+    expect(aoMudar).toHaveBeenCalledTimes(1);
+    expect(aoMudar).toHaveBeenCalledWith("xyz");
+  });
+
+  it("onBlur continua sendo o evento de saída do campo", async () => {
+    const aoSair = vi.fn();
+    const aoMudar = vi.fn();
+    render(<Input label="Nome" onBlur={aoSair} onChange={aoMudar} />);
+    const campo = screen.getByLabelText("Nome");
+    await userEvent.type(campo, "a");
+    expect(aoSair).not.toHaveBeenCalled();
+    await userEvent.tab();
+    expect(aoSair).toHaveBeenCalledTimes(1);
+    expect(aoMudar).toHaveBeenCalledTimes(1);
+  });
+});
+
+describe("Input · mask", () => {
+  async function digitar(mask: any, texto: string) {
+    const aoMudar = vi.fn();
+    render(<Input label="Campo" mask={mask} onChange={aoMudar} />);
+    const campo = screen.getByLabelText("Campo") as HTMLInputElement;
+    await userEvent.type(campo, texto);
+    return { campo, aoMudar };
+  }
+
+  it("cpf", async () => {
+    const { campo, aoMudar } = await digitar("cpf", "12345678901");
+    expect(campo.value).toBe("123.456.789-01");
+    expect(aoMudar).toHaveBeenLastCalledWith("123.456.789-01");
+  });
+
+  it("cnpj", async () => {
+    const { campo } = await digitar("cnpj", "12345678000190");
+    expect(campo.value).toBe("12.345.678/0001-90");
+  });
+
+  it("cep", async () => {
+    const { campo } = await digitar("cep", "80010000");
+    expect(campo.value).toBe("80010-000");
+  });
+
+  it("phone troca de formato com 10 ou 11 dígitos", async () => {
+    expect((await digitar("phone", "4133334444")).campo.value).toBe("(41) 3333-4444");
+  });
+
+  it("phone de 11 dígitos", async () => {
+    expect((await digitar("phone", "41999998888")).campo.value).toBe("(41) 99999-8888");
+  });
+
+  it("ignora letras e passa do tamanho, sem estourar", async () => {
+    const { campo } = await digitar("cpf", "12a3.4b5-678901999");
+    expect(campo.value).toBe("123.456.789-01");
+  });
+
+  it("valor controlado com dígitos aparece formatado", () => {
+    render(<Input label="CPF" mask="cpf" value="12345678901" onChange={() => {}} />);
+    expect((screen.getByLabelText("CPF") as HTMLInputElement).value).toBe("123.456.789-01");
+  });
+
+  it("abre o teclado numérico e limita o tamanho; sem máscara, nenhum dos dois", () => {
+    render(
+      <>
+        <Input label="Com" mask="cep" />
+        <Input label="Sem" />
+      </>,
+    );
+    expect(screen.getByLabelText("Com")).toHaveAttribute("inputmode", "numeric");
+    expect(screen.getByLabelText("Com")).toHaveAttribute("maxlength", "9");
+    expect(screen.getByLabelText("Sem")).not.toHaveAttribute("inputmode");
+    expect(screen.getByLabelText("Sem")).not.toHaveAttribute("maxlength");
+  });
+});
+
+describe("Input · iconRight e borderless", () => {
+  it("iconRight é decorativo: aparece, não é botão e fica fora da árvore de acessibilidade", () => {
+    const { container } = render(<Input ariaLabel="Número" iconRight={faMagnifyingGlass} />);
+    const icone = container.querySelector(".umds-input__icon-right") as HTMLElement;
+    expect(icone).not.toBeNull();
+    expect(icone).toHaveAttribute("aria-hidden", "true");
+    expect(icone.querySelector("svg")).not.toBeNull();
+    expect(screen.queryByRole("button")).toBeNull();
+  });
+
+  it("sem iconRight não há ícone à direita", () => {
+    const { container } = render(<Input ariaLabel="x" />);
+    expect(container.querySelector(".umds-input__icon-right")).toBeNull();
+  });
+
+  it("borderless escreve a classe; sem a prop não", () => {
+    const { container } = render(
+      <>
+        <Input ariaLabel="a" borderless />
+        <Input ariaLabel="b" />
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-input--borderless");
+    expect(container.children[1]).not.toHaveClass("umds-input--borderless");
+  });
+
+  it("borderless com erro continua marcando o erro", () => {
+    const { container } = render(<Input ariaLabel="a" borderless errorMessage="Obrigatório" />);
+    expect(container.firstElementChild).toHaveClass("umds-input--borderless", "umds-input--error");
+    expect(screen.getByLabelText("a")).toHaveAttribute("aria-invalid", "true");
+  });
+});