@1doc/1ds-react 2.7.2 → 2.9.0

package/dist/teste/ChipsXs.test.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { describe, expect, it, vi } from "vitest";
+import { fireEvent, render, screen } from "@testing-library/react";
+import Chips from "../components/Chips/Chips";
+const raiz = (c) => c.firstElementChild;
+describe("Chips · xs e × em círculo", () => {
+    it("size xs escreve a classe; sem size continua md", () => {
+        const { container } = render(_jsxs(_Fragment, { children: [_jsx(Chips, { label: "a", size: "xs" }), _jsx(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(_jsx(Chips, { label: "Marcador", removable: true, circularRemove: true }));
+        expect(raiz(container)).toHaveClass("umds-chip--remove-circle");
+    });
+    it("circularRemove sem removable não escreve a classe (não há ×)", () => {
+        const { container } = render(_jsx(Chips, { label: "Marcador", circularRemove: true }));
+        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(_jsx(Chips, { label: "Urgente", size: "xs", removable: true, circularRemove: true, 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(_jsx(Chips, { label: "x", removable: true }));
+        expect(raiz(container)).not.toHaveClass("umds-chip--remove-circle");
+    });
+});

package/dist/teste/Coachmark.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/teste/Coachmark.test.js

@@ -0,0 +1,149 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+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) {
+    return (_jsxs("div", { children: [_jsx("button", { id: "alvo-a", children: "A" }), _jsx("button", { id: "alvo-b", children: "B" }), _jsx(Coachmark, { steps: PASSOS, ...props })] }));
+}
+describe("Coachmark", () => {
+    it("fechado não desenha nada", () => {
+        render(_jsx(Pagina, { open: false }));
+        expect(screen.queryByRole("dialog")).toBeNull();
+    });
+    it("aberto é um diálogo modal nomeado pelo título, com contador e texto", () => {
+        render(_jsx(Pagina, { open: true }));
+        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(_jsx(Pagina, { open: true }));
+        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(_jsx(Pagina, { open: true, 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(_jsx(Pagina, { open: true }));
+        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(_jsx(Pagina, { open: true, 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(_jsx(Pagina, { open: true, onClose: aoFechar }));
+        await usuario.click(screen.getByRole("button", { name: "Sair do tour" }));
+        expect(aoFechar).toHaveBeenCalledWith("skip");
+        rerender(_jsx(Pagina, { open: true, hideSkip: true, 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(_jsx(Pagina, { open: true, 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(_jsx(Pagina, { open: true }));
+        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(_jsx(Pagina, { open: true, 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(_jsx(Pagina, { open: true, 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(_jsx(Pagina, { open: true }));
+        expect(document.querySelector(".umds-coachmark__cutout")).not.toBeNull();
+        rerender(_jsx(Pagina, { open: true, 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(null);
+            return (_jsxs("div", { children: [_jsx("button", { ref: ref, children: "Alvo" }), _jsx(Coachmark, { open: true, steps: [{ target: ref, title: "Por ref" }] })] }));
+        }
+        render(_jsx(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(_jsx(Pagina, { open: true, 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 (_jsxs("div", { children: [_jsx("button", { id: "abrir", onClick: () => setAberto(true), children: "Fazer o tour" }), _jsx(Coachmark, { open: aberto, steps: PASSOS, onClose: () => setAberto(false) })] }));
+        }
+        render(_jsx(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 (_jsxs("div", { children: [_jsx("button", { onClick: () => setAberto(true), children: "Reabrir" }), _jsx(Coachmark, { open: aberto, steps: PASSOS, onClose: () => setAberto(false) })] }));
+        }
+        render(_jsx(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/dist/teste/ColorPicker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/teste/ColorPicker.test.js

@@ -0,0 +1,132 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+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(_jsx(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(_jsx(ColorPicker, { ariaLabel: "Cor" }));
+        const azul = screen.getByRole("radio", { name: "Azul" });
+        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(_jsx(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(_jsx(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(_jsx(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(_jsx(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(_jsx(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(_jsx(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(_jsx(ColorPicker, { ariaLabel: "Cor", families: ["blue", "gray"] }));
+        expect(screen.getAllByRole("radio")).toHaveLength(11);
+    });
+    it("swatches substitui a paleta (nomes traduzidos)", () => {
+        render(_jsx(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(_jsx(ColorPicker, { ariaLabel: "Cor", disabled: true }));
+        for (const r of screen.getAllByRole("radio"))
+            expect(r).toBeDisabled();
+    });
+    it("label visível nomeia o grupo", () => {
+        render(_jsx(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(_jsx(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(_jsx(ColorPicker, { ariaLabel: "Cor", allowCustom: true, 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(_jsx(ColorPicker, { ariaLabel: "Cor", allowCustom: true, customErrorMessage: "Formato inv\u00E1lido" }));
+        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 _jsx(ColorPicker, { ariaLabel: "Cor", allowCustom: true, value: valor, onChange: setValor });
+        }
+        render(_jsx(Controlado, {}));
+        const campo = screen.getByLabelText("Cor livre (hexadecimal)");
+        expect(campo.value).toBe("#336699");
+        await usuario.click(screen.getByRole("radio", { name: "Azul" }));
+        expect(campo.value).toBe("");
+    });
+});

package/dist/teste/ConfirmAIAction.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/teste/ConfirmAIAction.test.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, expect, it, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import ConfirmDialog from "../components/ConfirmDialog/ConfirmDialog";
+import ConfirmAIAction from "../components/ConfirmAIAction/ConfirmAIAction";
+/**
+ * O ConfirmAIAction dizia "digite CONFIRMAR", mas o botão continuava
+ * clicável: o ConfirmDialog não tinha como desabilitá-lo. Agora tem
+ * (`confirmDisabled`), e em risco alto o botão só libera com a frase.
+ */
+describe("ConfirmDialog · confirmDisabled", () => {
+    it("desabilita o confirmar sem mudar o texto do botão", () => {
+        render(_jsx(ConfirmDialog, { open: true, inline: true, title: "Excluir?", confirmLabel: "Excluir", confirmDisabled: true }));
+        expect(screen.getByRole("button", { name: "Excluir" })).toBeDisabled();
+    });
+    it("sem a prop, o confirmar fica habilitado", () => {
+        render(_jsx(ConfirmDialog, { open: true, inline: true, title: "Excluir?", confirmLabel: "Excluir" }));
+        expect(screen.getByRole("button", { name: "Excluir" })).toBeEnabled();
+    });
+});
+describe("ConfirmAIAction · risco alto", () => {
+    it("botão desabilitado até a frase conferir", () => {
+        const onConfirm = vi.fn();
+        const { rerender } = render(_jsx(ConfirmAIAction, { open: true, risk: "alto", title: "Arquivar", affected: ["Processo 1"], typedValue: "", onConfirm: onConfirm }));
+        expect(screen.getByRole("button", { name: "Confirmar" })).toBeDisabled();
+        rerender(_jsx(ConfirmAIAction, { open: true, risk: "alto", title: "Arquivar", affected: ["Processo 1"], typedValue: "confirmar", onConfirm: onConfirm }));
+        expect(screen.getByRole("button", { name: "Confirmar" })).toBeEnabled();
+    });
+    it("risco médio não exige digitação", () => {
+        render(_jsx(ConfirmAIAction, { open: true, risk: "medio", title: "Tramitar" }));
+        expect(screen.getByRole("button", { name: "Confirmar" })).toBeEnabled();
+    });
+});

package/dist/teste/DataTableCelulaLivre.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/teste/DataTableCelulaLivre.test.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { describe, expect, it } from "vitest";
+import { render, screen, within } from "@testing-library/react";
+import DataTable 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 = [
+            { key: "nome", label: "Usuário", render: (row) => _jsx("strong", { "data-testid": "nome", children: row.nome }) },
+            { key: "perfil", label: "Perfil" },
+        ];
+        render(_jsx(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 = [
+            { key: "nome", label: "Usuário", render: (row, i) => `${i + 1}. ${row.nome}` },
+        ];
+        render(_jsx(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 = {
+            key: "acoes",
+            label: "Ações",
+            render: () => _jsx("button", { type: "button", children: "Editar" }),
+        };
+        render(_jsx(DataTable, { columns: [coluna], data: USUARIOS }));
+        expect(screen.getAllByRole("button", { name: "Editar" })).toHaveLength(3);
+    });
+});
+describe("DataTable · linha de grupo (rowGroup)", () => {
+    const colunas = [
+        { key: "nome", label: "Usuário" },
+        { key: "perfil", label: "Perfil" },
+    ];
+    it("sem rowGroup não desenha linha de grupo", () => {
+        const { container } = render(_jsx(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(_jsx(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(_jsx(DataTable, { columns: colunas, data: USUARIOS, selectable: true, 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(_jsx(DataTable, { columns: colunas, data: USUARIOS, rowGroup: "setor", renderRowGroup: (rotulo) => _jsxs("em", { "data-testid": "grupo", children: [rotulo, "!"] }) }));
+        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(_jsx(DataTable, { columns: colunas, data: USUARIOS, rowGroup: "setor", selectable: true, selectedRows: [2] }));
+        const selecionadas = container.querySelectorAll(".umds-datatable__row--selected");
+        expect(selecionadas).toHaveLength(1);
+        expect(within(selecionadas[0]).getByText("Rafael Pereira")).toBeInTheDocument();
+    });
+});

package/dist/teste/DataTableDocumento.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/teste/DataTableDocumento.test.js

@@ -0,0 +1,92 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+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" },
+];
+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(_jsx(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(_jsx(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(_jsx(DataTable, { variant: "document", selectable: true, 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(_jsx(DataTable, { variant: "document", columns: COLUNAS, data: DADOS, onRowClick: aoClicar }));
+        const linha = container.querySelector("tbody tr");
+        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(_jsx(DataTable, { columns: COLUNAS, data: DADOS, selectable: true, 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(_jsx(DescriptionList, { items: ITENS, ariaLabel: "Dados de empenho" }));
+        const dl = container.querySelector("dl");
+        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(_jsx(DescriptionList, { items: ITENS }));
+        expect(container.querySelectorAll("dd")[2]).toHaveTextContent("—");
+        rerender(_jsx(DescriptionList, { items: ITENS, emptyValue: "N\u00E3o informado" }));
+        expect(container.querySelectorAll("dd")[2]).toHaveTextContent("Não informado");
+    });
+    it("inline é o padrão; fit encolhe", () => {
+        const { container, rerender } = render(_jsx(DescriptionList, { items: ITENS }));
+        const dl = container.querySelector("dl");
+        expect(dl).toHaveClass("umds-description-list--inline");
+        expect(dl).not.toHaveClass("umds-description-list--fit");
+        rerender(_jsx(DescriptionList, { items: ITENS, fit: true }));
+        expect(container.querySelector("dl")).toHaveClass("umds-description-list--fit");
+    });
+    it("stacked ganha as colunas e a caixa do valor", () => {
+        const { container } = render(_jsx(DescriptionList, { items: ITENS, layout: "stacked", columns: 3, bordered: true }));
+        const dl = container.querySelector("dl");
+        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(_jsx(DescriptionList, {}));
+        expect(container.querySelectorAll("dt")).toHaveLength(0);
+    });
+});

package/dist/teste/DatePicker.test.js

@@ -69,3 +69,26 @@ 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(_jsx(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(_jsx(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(_jsx(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(_jsx(DatePicker, { mode: "range", label: "Per\u00EDodo", value: "2025-01-01", range: { from: "2025-03-01", to: "2025-03-10" } }));
+        expect(screen.getByRole("combobox")).toHaveTextContent("01/03/2025 – 10/03/2025");
+    });
+});