@1doc/1ds-react 2.10.0 → 2.11.0

package/src/teste/AccordionControlado.test.tsx

@@ -0,0 +1,87 @@
+import { describe, expect, it, vi } from "vitest";
+import { useState } from "react";
+import { fireEvent, render, screen } from "@testing-library/react";
+import Accordion from "../components/Accordion/Accordion";
+
+const ITENS = [
+  { id: "prazos", title: "Prazos", content: "Dez dias úteis.", defaultOpen: true },
+  { id: "anexos", title: "Anexos", content: "Até 10 MB." },
+  { id: "sigilo", title: "Sigilo", content: "Só o setor." },
+];
+const aberto = (nome: string) => screen.getByRole("button", { name: nome }).getAttribute("aria-expanded") === "true";
+
+describe("Accordion · não controlado (como antes)", () => {
+  it("começa pelos defaultOpen e o clique abre e fecha; onOpenChange avisa a nova lista", () => {
+    const aoMudar = vi.fn();
+    render(<Accordion items={ITENS} multiple onOpenChange={aoMudar} />);
+    expect(aberto("Prazos")).toBe(true);
+    fireEvent.click(screen.getByRole("button", { name: "Anexos" }));
+    expect(aberto("Anexos")).toBe(true);
+    expect(aoMudar).toHaveBeenLastCalledWith(["prazos", "anexos"]);
+    fireEvent.click(screen.getByRole("button", { name: "Prazos" }));
+    expect(aberto("Prazos")).toBe(false);
+    expect(aoMudar).toHaveBeenLastCalledWith(["anexos"]);
+  });
+
+  it("sem multiple, abrir um fecha o outro", () => {
+    render(<Accordion items={ITENS} />);
+    fireEvent.click(screen.getByRole("button", { name: "Anexos" }));
+    expect(aberto("Anexos")).toBe(true);
+    expect(aberto("Prazos")).toBe(false);
+  });
+});
+
+describe("Accordion · controlado (open e onOpenChange)", () => {
+  it("open manda: o que está em open está aberto, ignorando defaultOpen", () => {
+    render(<Accordion items={ITENS} open={["sigilo"]} />);
+    expect(aberto("Sigilo")).toBe(true);
+    expect(aberto("Prazos")).toBe(false);
+  });
+
+  it("o clique só pede (onOpenChange); sem o app mudar open, nada abre", () => {
+    const aoMudar = vi.fn();
+    render(<Accordion items={ITENS} multiple open={["prazos"]} onOpenChange={aoMudar} />);
+    fireEvent.click(screen.getByRole("button", { name: "Anexos" }));
+    expect(aoMudar).toHaveBeenCalledWith(["prazos", "anexos"]);
+    expect(aberto("Anexos")).toBe(false);
+  });
+
+  it("o app guarda a escolha: com o estado dele, abre, fecha e a lista chega em ordem", () => {
+    let ultima: string[] = [];
+    function App() {
+      const [abertos, setAbertos] = useState<string[]>([]);
+      return (
+        <Accordion
+          items={ITENS}
+          multiple
+          open={abertos}
+          onOpenChange={(ids: string[]) => {
+            ultima = ids;
+            setAbertos(ids);
+          }}
+        />
+      );
+    }
+    render(<App />);
+    expect(aberto("Prazos")).toBe(false);
+    fireEvent.click(screen.getByRole("button", { name: "Sigilo" }));
+    fireEvent.click(screen.getByRole("button", { name: "Anexos" }));
+    expect(ultima).toEqual(["sigilo", "anexos"]);
+    expect(aberto("Sigilo") && aberto("Anexos")).toBe(true);
+    fireEvent.click(screen.getByRole("button", { name: "Sigilo" }));
+    expect(ultima).toEqual(["anexos"]);
+    expect(aberto("Sigilo")).toBe(false);
+  });
+
+  it("open vazio é controlado (tudo fechado), não ausência", () => {
+    render(<Accordion items={ITENS} open={[]} />);
+    expect(aberto("Prazos")).toBe(false);
+  });
+
+  it("item desabilitado não pede nada", () => {
+    const aoMudar = vi.fn();
+    render(<Accordion items={[{ id: "x", title: "Bloqueado", content: "...", disabled: true }]} open={[]} onOpenChange={aoMudar} />);
+    fireEvent.click(screen.getByRole("button", { name: "Bloqueado" }));
+    expect(aoMudar).not.toHaveBeenCalled();
+  });
+});

package/src/teste/BadgeAttachedTomEPadding.test.tsx

@@ -0,0 +1,60 @@
+import { describe, expect, it } from "vitest";
+import { render } from "@testing-library/react";
+import Badge from "../components/Badge/Badge";
+import { lerArquivo } from "./lerArquivo";
+
+const cssBadge = await lerArquivo("../core/src/components/Badge/Badge.css");
+
+const css = cssBadge.replace(/\r\n/g, "\n");
+const bloco = (seletor: string) => {
+  const inicio = css.indexOf(seletor + " {");
+  return css.slice(inicio, css.indexOf("}", inicio));
+};
+
+describe("Badge 2xs · padding lateral de 8px", () => {
+  it("a regra do 2xs usa o degrau nano (8px) dos lados e o micro (2px) em cima e embaixo", () => {
+    expect(bloco(".umds-badge--2xs")).toMatch(
+      /padding:\s*var\(--umds-primitive-spacing-micro\)\s+var\(--umds-primitive-spacing-nano\)/,
+    );
+  });
+
+  it("os outros tamanhos não mudam de padding", () => {
+    expect(bloco(".umds-badge--xs")).toMatch(/padding:\s*var\(--umds-primitive-spacing-micro\)\s+var\(--umds-primitive-spacing-quarck\)/);
+    expect(bloco(".umds-badge--md")).toMatch(/padding:\s*var\(--umds-primitive-spacing-quarck\)\s+var\(--umds-primitive-spacing-nano\)/);
+  });
+});
+
+describe("Badge attached · 22px e tom escuro", () => {
+  it("o rótulo colado tem altura mínima de 22px (24 - 2), de qualquer tamanho", () => {
+    expect(bloco(".umds-badge--attached")).toMatch(
+      /min-height:\s*calc\(var\(--umds-primitive-spacing-xxs\)\s*-\s*var\(--umds-primitive-spacing-micro\)\)/,
+    );
+    const { container } = render(<Badge attached size="xs" variant="neutral" appearance="solid">Tarefa manual</Badge>);
+    expect(container.firstElementChild).toHaveClass("umds-badge--attached", "umds-badge--xs");
+  });
+
+  it("attachedTone dark escreve a classe; sem ela e com light, não", () => {
+    const { container } = render(
+      <>
+        <Badge attached attachedTone="dark" variant="neutral" appearance="solid">A</Badge>
+        <Badge attached variant="neutral" appearance="solid">B</Badge>
+        <Badge attached attachedTone="light" variant="neutral" appearance="solid">C</Badge>
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-badge--attached-dark");
+    expect(container.children[1]).not.toHaveClass("umds-badge--attached-dark");
+    expect(container.children[2]).not.toHaveClass("umds-badge--attached-dark");
+  });
+
+  it("sem attached o tom é ignorado", () => {
+    const { container } = render(<Badge attachedTone="dark" variant="neutral" appearance="solid">A</Badge>);
+    expect(container.firstElementChild).not.toHaveClass("umds-badge--attached-dark");
+  });
+
+  it("CSS: o escuro é neutral-dark-down com texto branco, só no neutro sólido colado", () => {
+    const regra = bloco(".umds-badge--attached.umds-badge--neutral.umds-badge--solid.umds-badge--attached-dark");
+    expect(regra).toMatch(/background-color:\s*var\(--umds-semantic-color-neutral-dark-down\)/);
+    expect(regra).toMatch(/color:\s*var\(--umds-semantic-color-neutral-light-pure\)/);
+    expect(bloco(".umds-badge--attached.umds-badge--neutral.umds-badge--solid")).toMatch(/neutral-light-medium/);
+  });
+});

package/src/teste/ButtonDensidade.test.tsx

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { render, screen } from "@testing-library/react";
+import Button from "../components/Button/Button";
+import { lerArquivo } from "./lerArquivo";
+
+const cssButton = await lerArquivo("../core/src/components/Button/Button.css");
+
+const css = cssButton.replace(/\r\n/g, "\n");
+const bloco = (seletor: string) => {
+  const inicio = css.indexOf(seletor + " {");
+  return css.slice(inicio, css.indexOf("}", inicio));
+};
+
+describe("Button · density", () => {
+  it("comfortable escreve a classe; sem a prop e com default o botão é o de antes", () => {
+    render(
+      <>
+        <Button size="sm" density="comfortable">A</Button>
+        <Button size="sm">B</Button>
+        <Button size="sm" density="default">C</Button>
+      </>,
+    );
+    expect(screen.getByRole("button", { name: "A" })).toHaveClass("umds-button--sm", "umds-button--comfortable");
+    expect(screen.getByRole("button", { name: "B" })).not.toHaveClass("umds-button--comfortable");
+    expect(screen.getByRole("button", { name: "C" })).not.toHaveClass("umds-button--comfortable");
+  });
+
+  it("CSS: o sm confortável tem 12px de padding lateral; o sm de antes segue em 8px; o só-ícone fica de fora", () => {
+    expect(bloco(".umds-button--sm.umds-button--comfortable:not(.umds-button--icon)")).toMatch(
+      /padding:\s*0\s+var\(--umds-primitive-spacing-mini\)/,
+    );
+    expect(bloco(".umds-button--sm")).toMatch(/padding:\s*0\s+var\(--umds-primitive-spacing-nano\)/);
+  });
+
+  it("os outros tamanhos mantêm o padding (a densidade só mexe no sm)", () => {
+    expect(bloco(".umds-button--xs")).toMatch(/padding:\s*0\s+var\(--umds-primitive-spacing-mini\)/);
+    expect(bloco(".umds-button--md")).toMatch(/padding:\s*0\s+var\(--umds-primitive-spacing-xxxs\)/);
+    expect(bloco(".umds-button--lg")).toMatch(/padding:\s*0\s+var\(--umds-primitive-spacing-xxs\)/);
+  });
+});

package/src/teste/CalendarCompacto.test.tsx

@@ -0,0 +1,37 @@
+import { describe, expect, it } from "vitest";
+import Calendar from "../components/Calendar/Calendar";
+import { render } from "@testing-library/react";
+import { lerArquivo } from "./lerArquivo";
+
+const cssCalendar = await lerArquivo("../core/src/components/Calendar/Calendar.css");
+
+const CSS: Record<string, string> = { Calendar: cssCalendar };
+const css = (componente: string) => CSS[componente].replace(/\r\n/g, "\n");
+const bloco = (texto: string, seletor: string) => {
+  const inicio = texto.indexOf(seletor + " {");
+  expect(inicio, seletor).toBeGreaterThanOrEqual(0);
+  return texto.slice(inicio, texto.indexOf("}", inicio));
+};
+
+describe("Calendar · density compact", () => {
+  it("compact escreve a classe na raiz; sem a prop, não", () => {
+    const { container } = render(
+      <>
+        <Calendar today="2026-05-15" defaultDate="2026-05-15" density="compact" />
+        <Calendar today="2026-05-15" defaultDate="2026-05-15" />
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-calendar--compact", "umds-calendar--month");
+    expect(container.children[1]).not.toHaveClass("umds-calendar--compact");
+  });
+
+  it("CSS: evento de 20px (16 + 4), 4px de padding lateral e linha de 16px; o título só é cortado quando passa da largura", () => {
+    const t = css("Calendar");
+    const compacto = bloco(t, ".umds-calendar--compact .umds-calendar__event");
+    expect(compacto).toMatch(/min-height:\s*calc\(var\(--umds-primitive-spacing-xxxs\)\s*\+\s*var\(--umds-primitive-spacing-quarck\)\)/);
+    expect(compacto).toMatch(/padding:\s*var\(--umds-primitive-spacing-micro\)\s+var\(--umds-primitive-spacing-quarck\)/);
+    expect(compacto).toMatch(/line-height:\s*var\(--umds-primitive-spacing-xxxs\)/);
+    const titulo = bloco(t, ".umds-calendar__event-title");
+    expect(titulo).toMatch(/text-overflow:\s*ellipsis/);
+  });
+});

package/src/teste/CoachmarkUmPasso.test.tsx

@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import { render, screen } from "@testing-library/react";
+import Coachmark from "../components/Coachmark/Coachmark";
+
+const UM = [{ target: "#alvo-a", title: "Novo: arrastar", content: "Arraste a linha para trocar a ordem." }];
+const DOIS = [...UM, { title: "Pronto", content: "Sem alvo." }];
+
+function Pagina({ passos, ...resto }: any) {
+  return (
+    <div>
+      <button id="alvo-a">A</button>
+      <Coachmark steps={passos} open {...resto} />
+    </div>
+  );
+}
+
+describe("Coachmark · contador", () => {
+  it("com um passo só não há contador, nem visível nem na região aria-live", () => {
+    const { baseElement } = render(<Pagina passos={UM} />);
+    expect(screen.queryByText("1 de 1")).toBeNull();
+    expect(baseElement.textContent).not.toContain("1 de 1");
+    expect(baseElement.querySelector(".umds-coachmark__sr")?.textContent).toBe("Novo: arrastar");
+  });
+
+  it("com um passo e modal={false} também não (a dica pontual)", () => {
+    const { baseElement } = render(<Pagina passos={UM} modal={false} />);
+    expect(baseElement.textContent).not.toContain("1 de 1");
+  });
+
+  it("com dois passos o contador aparece e o leitor de tela o ouve", () => {
+    const { baseElement } = render(<Pagina passos={DOIS} />);
+    expect(screen.getByText("1 de 2")).toBeInTheDocument();
+    expect(baseElement.querySelector(".umds-coachmark__sr")?.textContent).toBe("1 de 2: Novo: arrastar");
+  });
+
+  it("counterLabel segue valendo com mais de um passo", () => {
+    render(<Pagina passos={DOIS} counterLabel="Step {current} of {total}" />);
+    expect(screen.getByText("Step 1 of 2")).toBeInTheDocument();
+  });
+
+  it("o botão do último passo continua sendo Concluir", () => {
+    render(<Pagina passos={UM} />);
+    expect(screen.getByRole("button", { name: "Concluir" })).toBeInTheDocument();
+  });
+});

package/src/teste/DataTableCompactaETom.test.tsx

@@ -0,0 +1,85 @@
+import { describe, expect, it } from "vitest";
+import { render } from "@testing-library/react";
+import DataTable from "../components/DataTable/DataTable";
+import { lerArquivo } from "./lerArquivo";
+
+const cssDataTable = await lerArquivo("../core/src/components/DataTable/DataTable.css");
+
+const COLUNAS = [
+  { key: "nome", label: "Nome" },
+  { key: "situacao", label: "Situação" },
+];
+const DADOS = [
+  { nome: "Ana Souza", situacao: "Ativa", tom: "positive" },
+  { nome: "Carlos Lima", situacao: "Bloqueado", tom: "negative" },
+  { nome: "Marina Alves", situacao: "Licença", tom: "info" },
+  { nome: "Rafael Pereira", situacao: "Desligado", tom: "muted" },
+  { nome: "Beatriz Lima", situacao: "Ativa" },
+];
+
+const linhas = (c: HTMLElement) => [...c.querySelectorAll("tbody tr")] as HTMLElement[];
+
+describe("DataTable · rowTone", () => {
+  it("o nome de um campo da linha traz o tom", () => {
+    const { container } = render(<DataTable columns={COLUNAS} data={DADOS} rowTone="tom" />);
+    const l = linhas(container);
+    expect(l[0]).toHaveClass("umds-datatable__row--positive");
+    expect(l[1]).toHaveClass("umds-datatable__row--negative");
+    expect(l[2]).toHaveClass("umds-datatable__row--info");
+    expect(l[3]).toHaveClass("umds-datatable__row--muted");
+    expect(l[4].className).toBe("umds-datatable__row");
+  });
+
+  it("uma função (row, rowIndex) devolve o tom", () => {
+    const { container } = render(
+      <DataTable columns={COLUNAS} data={DADOS} rowTone={(row, i) => (row.situacao === "Bloqueado" || i === 4 ? "negative" : undefined)} />,
+    );
+    const l = linhas(container);
+    expect(l[1]).toHaveClass("umds-datatable__row--negative");
+    expect(l[4]).toHaveClass("umds-datatable__row--negative");
+    expect(l[0].className).toBe("umds-datatable__row");
+  });
+
+  it("tom desconhecido ou vazio não vira classe", () => {
+    const { container } = render(
+      <DataTable columns={COLUNAS} data={[{ nome: "A", situacao: "x", tom: "rosa" }, { nome: "B", situacao: "y", tom: "" }]} rowTone="tom" />,
+    );
+    for (const l of linhas(container)) expect(l.className).toBe("umds-datatable__row");
+  });
+
+  it("sem rowTone nada muda", () => {
+    const { container } = render(<DataTable columns={COLUNAS} data={DADOS} />);
+    for (const l of linhas(container)) expect(l.className).toBe("umds-datatable__row");
+  });
+
+  it("o tom convive com a linha selecionada e a zebra (as classes ficam; o CSS faz a selecionada vencer)", () => {
+    const { container } = render(
+      <DataTable columns={COLUNAS} data={DADOS} rowTone="tom" striped rowKey="nome" selectedRowKeys={["Carlos Lima"]} />,
+    );
+    const l = linhas(container);
+    expect(l[1]).toHaveClass("umds-datatable__row--negative", "umds-datatable__row--selected", "umds-datatable__row--striped");
+  });
+});
+
+describe("DataTable · compacta, 44px e CSS do tom", () => {
+  const css = cssDataTable.replace(/\r\n/g, "\n");
+  const bloco = (seletor: string) => {
+    const inicio = css.indexOf(seletor + " {");
+    return css.slice(inicio, css.indexOf("}", inicio));
+  };
+
+  it("a densidade compacta fixa cabeçalho e linha na altura de campo (44px); o documento fica de fora", () => {
+    expect(bloco(".umds-datatable--compact:not(.umds-datatable--document) .umds-datatable__td")).toMatch(
+      /height:\s*var\(--umds-semantic-field-height\)/,
+    );
+    expect(css).toContain(".umds-datatable--compact:not(.umds-datatable--document) .umds-datatable__th,");
+    const { container } = render(<DataTable density="compact" columns={COLUNAS} data={DADOS} />);
+    expect(container.querySelector(".umds-datatable--compact")).not.toBeNull();
+  });
+
+  it("a linha selecionada vence o tom (o :not) e o tom vence a zebra", () => {
+    expect(css).toMatch(/\.umds-datatable__row--negative:not\(\.umds-datatable__row--selected\)/);
+    expect(css).toMatch(/\.umds-datatable__row--negative:not\(\.umds-datatable__row--selected\)\.umds-datatable__row--striped/);
+    expect(bloco(".umds-datatable__row--muted .umds-datatable__td")).toMatch(/neutral-dark-down/);
+  });
+});

package/src/teste/InputGhost.test.tsx

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import Input from "../components/Input/Input";
+import { render } from "@testing-library/react";
+import { lerArquivo } from "./lerArquivo";
+
+const cssInput = await lerArquivo("../core/src/components/Input/Input.css");
+
+const CSS: Record<string, string> = { Input: cssInput };
+const css = (componente: string) => CSS[componente].replace(/\r\n/g, "\n");
+const bloco = (texto: string, seletor: string) => {
+  const inicio = texto.indexOf(seletor + " {");
+  expect(inicio, seletor).toBeGreaterThanOrEqual(0);
+  return texto.slice(inicio, texto.indexOf("}", inicio));
+};
+
+describe("Input · variant ghost", () => {
+  it("ghost escreve a classe; sem a prop e com default, não", () => {
+    const { container } = render(
+      <>
+        <Input ariaLabel="a" variant="ghost" />
+        <Input ariaLabel="b" />
+        <Input ariaLabel="c" variant="default" />
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-input--ghost");
+    expect(container.children[1]).not.toHaveClass("umds-input--ghost");
+    expect(container.children[2]).not.toHaveClass("umds-input--ghost");
+  });
+
+  it("CSS: só o repouso muda (fundo claro, borda clara) e com baixa especificidade, para o hover e o foco vencerem", () => {
+    const t = css("Input");
+    const ghost = bloco(t, ".umds-input--ghost:where(:not(.umds-input--error):not(.umds-input--disabled):not(.umds-input--readonly)) .umds-input__container");
+    expect(ghost).toMatch(/background-color:\s*var\(--umds-semantic-color-background-light\)/);
+    expect(ghost).toMatch(/border-color:\s*var\(--umds-semantic-color-neutral-light-medium\)/);
+    expect(t.indexOf(".umds-input__container:focus-within:not(")).toBeGreaterThanOrEqual(0);
+  });
+
+  it("o foco, o erro e o desabilitado do campo ghost seguem as classes do padrão", () => {
+    const { container } = render(<Input ariaLabel="d" variant="ghost" errorMessage="Obrigatório" />);
+    expect(container.firstElementChild).toHaveClass("umds-input--ghost", "umds-input--error");
+  });
+});

package/src/teste/ModalProporcoes1Doc.test.tsx

@@ -0,0 +1,36 @@
+import { describe, expect, it } from "vitest";
+import Modal from "../components/Modal/Modal";
+import { render, screen } from "@testing-library/react";
+import { lerArquivo } from "./lerArquivo";
+
+const cssModal = await lerArquivo("../core/src/components/Modal/Modal.css");
+
+const CSS: Record<string, string> = { Modal: cssModal };
+const css = (componente: string) => CSS[componente].replace(/\r\n/g, "\n");
+const bloco = (texto: string, seletor: string) => {
+  const inicio = texto.indexOf(seletor + " {");
+  expect(inicio, seletor).toBeGreaterThanOrEqual(0);
+  return texto.slice(inicio, texto.indexOf("}", inicio));
+};
+
+describe("Modal · density 1doc", () => {
+  it("escreve a classe e convive com variant primary; sem a prop, não", () => {
+    render(<Modal open inline density="1doc" variant="primary" title="Resolver tarefa" />);
+    expect(screen.getByRole("dialog", { name: "Resolver tarefa" })).toHaveClass("umds-modal--1doc", "umds-modal--primary", "umds-modal--base");
+  });
+
+  it("sem density o modal é o de antes", () => {
+    render(<Modal open inline title="Padrão" />);
+    expect(screen.getByRole("dialog", { name: "Padrão" })).not.toHaveClass("umds-modal--1doc");
+  });
+
+  it("CSS: cabeçalho de 67px, rodapé de 65px (padding 12px 24px) e raio de 12px; o padrão (8px) não muda", () => {
+    const t = css("Modal");
+    expect(bloco(t, ".umds-modal--1doc.umds-modal--base .umds-modal__header")).toMatch(/min-height:\s*67px/);
+    const rodape = bloco(t, ".umds-modal--1doc.umds-modal--base .umds-modal__footer");
+    expect(rodape).toMatch(/min-height:\s*65px/);
+    expect(rodape).toMatch(/padding:\s*var\(--umds-primitive-spacing-mini\)\s+var\(--umds-primitive-spacing-xxs\)/);
+    expect(t).toMatch(/\.umds-modal--1doc:not\(\.umds-modal--fullscreen\):not\(\.umds-modal--janela-fullscreen\):not\(\.umds-modal--sheet\) \{\n(?:\s*\/\*.*\*\/\n)?\s*border-radius:\s*12px/);
+    expect(bloco(t, ".umds-modal")).toMatch(/border-radius:\s*var\(--umds-primitive-border-radius-sm\)/);
+  });
+});

package/src/teste/SegmentedControlSuperficie.test.tsx

@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vitest";
+import SegmentedControl from "../components/SegmentedControl/SegmentedControl";
+import { render } from "@testing-library/react";
+import { lerArquivo } from "./lerArquivo";
+
+const cssSegmentedControl = await lerArquivo("../core/src/components/SegmentedControl/SegmentedControl.css");
+
+const CSS: Record<string, string> = { SegmentedControl: cssSegmentedControl };
+const css = (componente: string) => CSS[componente].replace(/\r\n/g, "\n");
+const bloco = (texto: string, seletor: string) => {
+  const inicio = texto.indexOf(seletor + " {");
+  expect(inicio, seletor).toBeGreaterThanOrEqual(0);
+  return texto.slice(inicio, texto.indexOf("}", inicio));
+};
+
+describe("SegmentedControl · variant surface", () => {
+  const OPCOES = [
+    { label: "Individual", value: "individual", count: 12 },
+    { label: "Em lote", value: "lote" },
+  ];
+
+  it("surface escreve a classe; sem a prop e com default, não", () => {
+    const { container } = render(
+      <>
+        <SegmentedControl options={OPCOES} variant="surface" defaultValue="individual" />
+        <SegmentedControl options={OPCOES} defaultValue="individual" />
+        <SegmentedControl options={OPCOES} variant="default" defaultValue="individual" />
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-segmented--surface");
+    expect(container.children[1]).not.toHaveClass("umds-segmented--surface");
+    expect(container.children[2]).not.toHaveClass("umds-segmented--surface");
+  });
+
+  it("CSS: o escolhido é branco, em negrito e com sombra; o trilho é cinza claro; o azul cheio do padrão segue", () => {
+    const t = css("SegmentedControl");
+    const escolhido = bloco(t, ".umds-segmented--surface .umds-segmented__input:checked + .umds-segmented__item,\n.umds-segmented--surface .umds-segmented__input:checked + .umds-segmented__item:hover");
+    expect(escolhido).toMatch(/background-color:\s*var\(--umds-semantic-color-background-white\)/);
+    expect(escolhido).toMatch(/font-weight:\s*var\(--umds-primitive-font-weight-bold\)/);
+    expect(escolhido).toMatch(/box-shadow:\s*var\(--umds-semantic-shadow-md\)/);
+    expect(bloco(t, ".umds-segmented--surface .umds-segmented__track")).toMatch(/background-color:\s*var\(--umds-semantic-color-neutral-light-medium\)/);
+    expect(t).toMatch(/\.umds-segmented__input:checked \+ \.umds-segmented__item,\n\.umds-segmented__input:checked \+ \.umds-segmented__item:hover \{\n\s*background-color:\s*var\(--umds-semantic-color-primary-pure\)/);
+  });
+
+  it("o contador do escolhido fica cinza sobre o branco e o dos outros, branco sobre o trilho", () => {
+    const t = css("SegmentedControl");
+    expect(bloco(t, ".umds-segmented--surface .umds-segmented__count")).toMatch(/background-color:\s*var\(--umds-semantic-color-background-white\)/);
+    expect(bloco(t, ".umds-segmented--surface .umds-segmented__input:checked + .umds-segmented__item .umds-segmented__count")).toMatch(
+      /background-color:\s*var\(--umds-semantic-color-neutral-light-medium\)/,
+    );
+  });
+});

package/src/teste/SelectItemComEscopo.test.tsx

@@ -0,0 +1,69 @@
+import { describe, expect, it } from "vitest";
+import { fireEvent, render, screen } from "@testing-library/react";
+import Select from "../components/Select/Select";
+
+const OPCOES = [
+  { label: "Urgente", value: "urgente", etiqueta: "Prazo hoje" },
+  { label: "Rotina", value: "rotina", etiqueta: "Sem prazo" },
+];
+const item = ({ optionData }: any) => (
+  <span data-testid="item">
+    <b>{optionData.label}</b> <i>{optionData.etiqueta}</i>
+  </span>
+);
+
+describe("Select · item com escopo da opção", () => {
+  it("a lista mostra o item de cada opção, recebendo a opção (optionData e o apelido option)", () => {
+    const vistos: any[] = [];
+    render(
+      <Select
+        ariaLabel="Prioridade"
+        options={OPCOES}
+        item={(escopo: any) => {
+          vistos.push(escopo);
+          return <span data-testid="item">{escopo.optionData.label}</span>;
+        }}
+      />,
+    );
+    fireEvent.click(screen.getByRole("combobox"));
+    expect(screen.getAllByTestId("item").map((n) => n.textContent)).toEqual(["Urgente", "Rotina"]);
+    expect(vistos[0].optionData).toBe(OPCOES[0]);
+    expect(vistos[0].option).toBe(OPCOES[0]);
+  });
+
+  it("o gatilho com a opção escolhida mostra o conteúdo do item, não o texto", () => {
+    render(<Select ariaLabel="Prioridade" options={OPCOES} value="urgente" item={item} />);
+    const gatilho = screen.getByRole("combobox");
+    expect(gatilho.querySelector(".umds-select__trigger-item")).not.toBeNull();
+    expect(gatilho).toHaveTextContent("Urgente");
+    expect(gatilho).toHaveTextContent("Prazo hoje");
+    expect(gatilho.querySelector(".umds-select__placeholder")).toBeNull();
+  });
+
+  it("sem valor o gatilho mostra o placeholder; escolher na lista passa o item para o gatilho", () => {
+    function App() {
+      return <Select ariaLabel="Prioridade" placeholder="Escolha" options={OPCOES} item={item} />;
+    }
+    render(<App />);
+    const gatilho = screen.getByRole("combobox");
+    expect(gatilho).toHaveTextContent("Escolha");
+    expect(gatilho.querySelector(".umds-select__trigger-item")).toBeNull();
+    fireEvent.click(gatilho);
+    fireEvent.click(screen.getAllByRole("option")[1]);
+    expect(screen.getByRole("combobox").querySelector(".umds-select__trigger-item")).toHaveTextContent("Rotina");
+  });
+
+  it("seleção múltipla segue com o texto no gatilho", () => {
+    render(<Select ariaLabel="Prioridade" multiple options={OPCOES} value={["urgente"]} item={item} />);
+    expect(screen.getByRole("combobox").querySelector(".umds-select__trigger-item")).toBeNull();
+  });
+
+  it("sem item nada muda: o gatilho mostra o rótulo; item como nó solto (legado) não vai ao gatilho", () => {
+    const { rerender } = render(<Select ariaLabel="Prioridade" options={OPCOES} value="urgente" />);
+    expect(screen.getByRole("combobox")).toHaveTextContent("Urgente");
+    expect(screen.getByRole("combobox").querySelector(".umds-select__trigger-item")).toBeNull();
+    rerender(<Select ariaLabel="Prioridade" options={OPCOES} value="urgente" item={<em>fixo</em>} />);
+    expect(screen.getByRole("combobox").querySelector(".umds-select__trigger-item")).toBeNull();
+    expect(screen.getByRole("combobox")).toHaveTextContent("Urgente");
+  });
+});