@1doc/1ds-react 2.10.0 → 2.11.0

package/src/teste/SelectListaFiltro.test.tsx

@@ -0,0 +1,120 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import Select from "../components/Select/Select";
+import { lerArquivo } from "./lerArquivo";
+
+const cssSelect = await lerArquivo("../core/src/components/Select/Select.css");
+
+const OPCOES = [
+  { label: "Urgente", value: "urgente" },
+  { label: "Revisão", value: "revisao" },
+];
+
+afterEach(() => vi.restoreAllMocks());
+
+const lista = (container: HTMLElement) => container.querySelector(".umds-select__dropdown") as HTMLElement;
+
+/** jsdom não tem layout: só a lista "mede" o que o teste mandar. */
+function medirLista(direita: number, larguraDaJanela: number) {
+  vi.spyOn(HTMLElement.prototype, "getBoundingClientRect").mockImplementation(function (this: HTMLElement) {
+    const eLista = this.classList.contains("umds-select__dropdown");
+    return { top: 0, bottom: 0, left: 0, right: eLista ? direita : 0, width: 0, height: 0, x: 0, y: 0, toJSON() {} } as any;
+  });
+  Object.defineProperty(window, "innerWidth", { value: larguraDaJanela, configurable: true });
+}
+
+describe("Select filtro · listMinWidth", () => {
+  it("um número vira px e a lista nunca fica mais estreita que o gatilho", () => {
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" listMinWidth={220} />);
+    fireEvent.click(screen.getByRole("combobox"));
+    expect(lista(container).style.minWidth).toBe("max(100%, 220px)");
+  });
+
+  it("uma medida CSS vale como veio", () => {
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" listMinWidth="18rem" />);
+    fireEvent.click(screen.getByRole("combobox"));
+    expect(lista(container).style.minWidth).toBe("max(100%, 18rem)");
+  });
+
+  it("0 é um valor (sem mínimo além do gatilho), não ausência", () => {
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" listMinWidth={0} />);
+    fireEvent.click(screen.getByRole("combobox"));
+    expect(lista(container).style.minWidth).toBe("max(100%, 0px)");
+  });
+
+  it("sem a prop o mínimo é o do CSS (240px), sem estilo inline", () => {
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" />);
+    fireEvent.click(screen.getByRole("combobox"));
+    expect(lista(container).style.minWidth).toBe("");
+  });
+
+  it("o Select padrão ignora a prop (a lista é a largura do campo)", () => {
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} listMinWidth={220} />);
+    fireEvent.click(screen.getByRole("combobox"));
+    expect(lista(container).style.minWidth).toBe("");
+  });
+});
+
+describe("Select filtro · nunca passa da borda da janela", () => {
+  it("a lista que estoura a borda direita se alinha ao fim do gatilho", async () => {
+    medirLista(1457, 1440);
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" />);
+    fireEvent.click(screen.getByRole("combobox"));
+    await waitFor(() => expect(container.querySelector(".umds-select--list-end")).not.toBeNull());
+  });
+
+  it("a lista que cabe fica onde está", async () => {
+    medirLista(900, 1440);
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" />);
+    fireEvent.click(screen.getByRole("combobox"));
+    await waitFor(() => expect(lista(container)).not.toBeNull());
+    expect(container.querySelector(".umds-select--list-end")).toBeNull();
+  });
+
+  it("deixa 8px de respiro: encostada na borda ainda alinha", async () => {
+    medirLista(1436, 1440);
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" />);
+    fireEvent.click(screen.getByRole("combobox"));
+    await waitFor(() => expect(container.querySelector(".umds-select--list-end")).not.toBeNull());
+  });
+
+  it("fechar desliga o alinhamento", async () => {
+    medirLista(1457, 1440);
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} variant="filter" />);
+    fireEvent.click(screen.getByRole("combobox"));
+    await waitFor(() => expect(container.querySelector(".umds-select--list-end")).not.toBeNull());
+    fireEvent.click(screen.getByRole("combobox"));
+    await waitFor(() => expect(container.querySelector(".umds-select--list-end")).toBeNull());
+  });
+
+  it("o Select padrão (não filtro) não é movido", async () => {
+    medirLista(1457, 1440);
+    const { container } = render(<Select ariaLabel="x" options={OPCOES} />);
+    fireEvent.click(screen.getByRole("combobox"));
+    await waitFor(() => expect(lista(container)).not.toBeNull());
+    expect(container.querySelector(".umds-select--list-end")).toBeNull();
+  });
+});
+
+describe("Select filtro · CSS", () => {
+  const css = cssSelect.replace(/\r\n/g, "\n");
+  const bloco = (seletor: string) => {
+    const inicio = css.indexOf(seletor + " {");
+    return css.slice(inicio, css.indexOf("}", inicio));
+  };
+
+  it("o wrapper do filtro é fit-content (o auto o esticava até o pai e a lista herdava essa largura)", () => {
+    expect(bloco(".umds-select--filter")).toMatch(/width:\s*fit-content/);
+  });
+
+  it("a busca da lista fica fora da conta da largura natural", () => {
+    expect(bloco(".umds-select--filter .umds-select__search-container")).toMatch(/contain:\s*inline-size/);
+    expect(bloco(".umds-select__search-input")).toMatch(/min-width:\s*0/);
+  });
+
+  it("o alinhamento ao fim ancora a lista pela direita", () => {
+    const b = bloco(".umds-select--filter.umds-select--list-end .umds-select__dropdown");
+    expect(b).toMatch(/left:\s*auto/);
+    expect(b).toMatch(/right:\s*0/);
+  });
+});

package/src/teste/StatCardTamanhoSm.test.tsx

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { render } from "@testing-library/react";
+import StatCard from "../components/StatCard/StatCard";
+import { lerArquivo } from "./lerArquivo";
+
+const cssStatCard = await lerArquivo("../core/src/components/StatCard/StatCard.css");
+
+const css = cssStatCard.replace(/\r\n/g, "\n");
+const bloco = (seletor: string) => {
+  const inicio = css.indexOf(seletor + " {");
+  return css.slice(inicio, css.indexOf("}", inicio));
+};
+
+describe("StatCard · size", () => {
+  it("sm escreve a classe; sem a prop e com md o cartão é o de antes", () => {
+    const { container } = render(
+      <>
+        <StatCard value={44} label="Não lidos" size="sm" />
+        <StatCard value={44} label="Não lidos" />
+        <StatCard value={44} label="Não lidos" size="md" />
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-stat-card--sm");
+    expect(container.children[1]).not.toHaveClass("umds-stat-card--sm");
+    expect(container.children[2]).not.toHaveClass("umds-stat-card--sm");
+  });
+
+  it("o número do sm é 18px/800, e a regra vence o 32/800 do rótulo no topo", () => {
+    const regra = bloco(".umds-stat-card.umds-stat-card--sm .umds-stat-card__valor");
+    expect(regra).toMatch(/font-size:\s*1\.125rem/);
+    expect(regra).toMatch(/font-weight:\s*var\(--umds-primitive-font-weight-extrabold\)/);
+    const { container } = render(<StatCard value={44} label="Não lidos" size="sm" labelPosition="top" />);
+    expect(container.firstElementChild).toHaveClass("umds-stat-card--sm", "umds-stat-card--rotulo-topo");
+  });
+
+  it("o número continua antes do rótulo no HTML", () => {
+    const { container } = render(<StatCard value={44} label="Não lidos" size="sm" />);
+    const valor = container.querySelector(".umds-stat-card__valor") as HTMLElement;
+    const rotulo = container.querySelector(".umds-stat-card__rotulo") as HTMLElement;
+    expect(valor.compareDocumentPosition(rotulo) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
+  });
+});

package/src/teste/TabsCompacta.test.tsx

@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import Tabs from "../components/Tabs/Tabs";
+import Tab from "../components/Tabs/Tab";
+import { render } from "@testing-library/react";
+import { lerArquivo } from "./lerArquivo";
+
+const cssTabs = await lerArquivo("../core/src/components/Tabs/Tabs.css");
+
+const CSS: Record<string, string> = { Tabs: cssTabs };
+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("Tabs · density", () => {
+  it("compact escreve a classe na raiz; sem a prop e com default, não", () => {
+    const { container } = render(
+      <>
+        <Tabs value="0" density="compact"><Tab label="A" index="0" /></Tabs>
+        <Tabs value="0"><Tab label="B" index="0" /></Tabs>
+        <Tabs value="0" density="default"><Tab label="C" index="0" /></Tabs>
+      </>,
+    );
+    expect(container.children[0]).toHaveClass("umds-tabs--compact");
+    expect(container.children[1]).not.toHaveClass("umds-tabs--compact");
+    expect(container.children[2]).not.toHaveClass("umds-tabs--compact");
+  });
+
+  it("CSS: a compacta tem altura mínima de 40px (degrau sm) e padding vertical de 8px; o padrão segue em 48px", () => {
+    const t = css("Tabs");
+    const compacta = bloco(t, ".umds-tabs--compact .umds-tabs__tab");
+    expect(compacta).toMatch(/min-height:\s*var\(--umds-primitive-spacing-sm\)/);
+    expect(compacta).toMatch(/padding-block:\s*var\(--umds-primitive-spacing-nano\)/);
+    expect(bloco(t, ".umds-tabs__tab")).toMatch(/min-height:\s*48px/);
+  });
+
+  it("a pílula do contador é cinza na aba inativa e azul só na ativa (nas duas densidades)", () => {
+    const t = css("Tabs");
+    expect(bloco(t, ".umds-tabs__count")).toMatch(/background-color:\s*var\(--umds-semantic-color-neutral-light-medium\)/);
+    expect(bloco(t, ".umds-tabs__tab--selected .umds-tabs__count")).toMatch(/background-color:\s*var\(--umds-semantic-color-primary-pure\)/);
+    expect(t).not.toMatch(/--compact[^{]*\.umds-tabs__count/);
+  });
+});

package/src/teste/TagPositivoTingido.test.tsx

@@ -0,0 +1,60 @@
+import { describe, expect, it } from "vitest";
+import { render } from "@testing-library/react";
+import Tag from "../components/Tag/Tag";
+import { lerArquivo } from "./lerArquivo";
+
+const cssTag = await lerArquivo("../core/src/components/Tag/Tag.css");
+const tema1doc = await lerArquivo("../tokens/dist/css/theme-1doc.css");
+const temaEscuro = await lerArquivo("../tokens/dist/css/theme-1doc-dark.css");
+const temaAltoContraste = await lerArquivo("../tokens/dist/css/theme-1doc-high-contrast.css");
+
+const css = cssTag.replace(/\r\n/g, "\n");
+const bloco = (seletor: string) => {
+  const inicio = css.indexOf(seletor + " {");
+  return css.slice(inicio, css.indexOf("}", inicio));
+};
+
+const TEMAS: Record<string, string> = { "theme-1doc.css": tema1doc, "theme-1doc-dark.css": temaEscuro, "theme-1doc-high-contrast.css": temaAltoContraste };
+const tema = (arquivo: string) => {
+  const texto = TEMAS[arquivo];
+  const cor = (nome: string) => (texto.match(new RegExp("--umds-theme-" + nome + ":\\s*(#[0-9A-Fa-f]{6})")) as RegExpMatchArray)[1];
+  return cor;
+};
+const luz = (hex: string) => {
+  const c = [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16) / 255).map((v) => (v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4));
+  return 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2];
+};
+const contraste = (a: string, b: string) => {
+  const [x, y] = [luz(a), luz(b)].sort((m, n) => n - m);
+  return (x + 0.05) / (y + 0.05);
+};
+
+describe("Tag positive outlined sobre fundo tingido", () => {
+  it("escreve as classes que a regra de CSS escolhe", () => {
+    const { container } = render(<Tag label="Entregue" variant="positive" appearance="outlined" />);
+    const tag = container.firstElementChild as HTMLElement;
+    expect(tag).toHaveClass("umds-tag--outlined", "umds-tag--positive");
+  });
+
+  it("o texto é positive-dark e o contorno segue positive-pure", () => {
+    const regra = bloco(".umds-tag--outlined.umds-tag--positive");
+    expect(regra).toMatch(/color:\s*var\(--umds-semantic-color-feedback-positive-dark\)/);
+    expect(regra).toMatch(/border-color:\s*var\(--umds-semantic-color-feedback-positive-pure\)/);
+  });
+
+  it("no tema 1doc, sobre o azul-claro do card o texto passa de 4,5:1 (o pure dava 3,6:1)", () => {
+    const cor = tema("theme-1doc.css");
+    const fundo = cor("primary-light");
+    expect(contraste(cor("feedback-positive-pure"), fundo)).toBeLessThan(4.5);
+    expect(contraste(cor("feedback-positive-dark"), fundo)).toBeGreaterThanOrEqual(4.5);
+  });
+
+  it("nos temas escuro e de alto contraste o texto também passa de 4,5:1 sobre o fundo tingido e sobre a página", () => {
+    for (const arquivo of ["theme-1doc-dark.css", "theme-1doc-high-contrast.css"]) {
+      const cor = tema(arquivo);
+      for (const fundo of [cor("primary-light"), cor("background-white")]) {
+        expect(contraste(cor("feedback-positive-dark"), fundo)).toBeGreaterThanOrEqual(4.5);
+      }
+    }
+  });
+});

package/src/teste/lerArquivo.ts

@@ -0,0 +1,13 @@
+/**
+ * Lê um arquivo do pacote (relativo à pasta `packages/react`) para os testes que conferem uma regra de CSS na
+ * fonte: o jsdom não tem cascata de arquivo, e o `css: false` do vitest esvazia o `?raw` do CSS.
+ * O `node:fs` entra por import dinâmico com nome calculado porque o `tsc` do pacote não traz os tipos do Node.
+ */
+const modulo = (nome: string): Promise<any> => import(/* @vite-ignore */ nome);
+
+export async function lerArquivo(relativo: string): Promise<string> {
+  const fs = await modulo("node:fs");
+  const path = await modulo("node:path");
+  const raiz: string = (globalThis as any).process.cwd();
+  return fs.readFileSync(path.resolve(raiz, relativo), "utf8");
+}