Files
tech-log-frontend/tests/features/tech-log/style-contract.test.ts

272 lines
10 KiB
TypeScript

// @vitest-environment jsdom
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { readFileSync } from "node:fs";
import { resolve } from "node:path";
import { createElement } from "react";
import { MemoryRouter } from "react-router-dom";
import { afterAll, beforeAll, describe, expect, it } from "vitest";
import { createTechLogFeatureInstalledInput } from "../../../src/features/tech-log/adapters/create-tech-log-feature-input.ts";
import { MOCK_STUDIO_INSTALL_CONTEXT } from "../../helpers/studio-install-context.ts";
import { FatalErrorState } from "../../../src/features/tech-log/presentation/public/components/fatal-error-state.tsx";
import { PublicShell } from "../../../src/features/tech-log/presentation/public/public-shell.tsx";
import { ApplicationProvider } from "../../../src/presentation/providers/application-provider.tsx";
import { createTestApplication } from "../../helpers/create-test-application.ts";
import { renderWithQueryProviders } from "../../helpers/query-providers.tsx";
let styleElement: HTMLStyleElement;
beforeAll(() => {
styleElement = document.createElement("style");
styleElement.textContent = [
"src/features/tech-log/presentation/styles/tech-log-theme.css",
"src/features/tech-log/presentation/styles/globals.css",
]
.map((file) => readFileSync(resolve(process.cwd(), file), "utf8"))
.join("\n");
document.head.append(styleElement);
});
afterAll(() => {
styleElement.remove();
});
async function renderPublicSurface(node: React.ReactNode) {
const techLog = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input;
const shell = createElement(PublicShell, { children: node });
const router = createElement(
MemoryRouter,
{ initialEntries: ["/projects"] },
shell,
);
const view = render(
renderWithQueryProviders(
createElement(ApplicationProvider, {
application: createTestApplication({
featureInputs: { "tech-log": techLog },
}),
children: router,
}),
),
);
// 포트가 async 가 되면서 첫 페인트에는 데이터가 없다. 화면이 정착한 뒤 단언한다.
await screen.findByRole("main");
return view;
}
describe("TechLog consumer-visible style contract", () => {
it("applies the source typography, palette, shell width, and header spacing", async () => {
const view = await renderPublicSurface(
createElement(
"main",
{ id: "main-content", className: "shell" },
"공개 본문",
),
);
const rootStyle = getComputedStyle(document.documentElement);
const bodyStyle = getComputedStyle(document.body);
const headerInner = view.container.querySelector<HTMLElement>(
".header-inner",
);
const main = view.getByRole("main");
const wordmark = view.getByRole("link", { name: "TechLog 홈" });
expect(rootStyle.getPropertyValue("--techlog-theme-surface")).toBe("#f7f7f5");
expect(rootStyle.getPropertyValue("--techlog-theme-content")).toBe("#17181b");
expect(rootStyle.getPropertyValue("--techlog-theme-action")).toBe("#3e5cc7");
expect(rootStyle.getPropertyValue("--techlog-theme-success-content")).toBe("#176b5b");
expect(rootStyle.getPropertyValue("--techlog-theme-success-surface")).toBe("#edf7f3");
expect(rootStyle.getPropertyValue("--color-surface")).toBe(
"var(--techlog-theme-surface)",
);
expect(rootStyle.getPropertyValue("--color-content")).toBe(
"var(--techlog-theme-content)",
);
expect(rootStyle.getPropertyValue("--color-action")).toBe(
"var(--techlog-theme-action)",
);
expect(rootStyle.getPropertyValue("--canvas")).toBe("var(--color-surface)");
expect(rootStyle.getPropertyValue("--ink")).toBe("var(--color-content)");
expect(rootStyle.getPropertyValue("--signal")).toBe("var(--color-action)");
expect(rootStyle.getPropertyValue("--evidence")).toBe(
"var(--color-success-content)",
);
expect(rootStyle.getPropertyValue("--shell")).toBe("1180px");
// 장문 한글 본문은 약 720~760px의 읽기 단을 기준으로 한다. 코드·표·근거 자료도 같은 단을 따른다.
expect(rootStyle.getPropertyValue("--body-copy")).toBe("47rem");
expect(rootStyle.color).toBe("var(--ink)");
expect(rootStyle.background).toBe("var(--canvas)");
expect(bodyStyle.color).toBe("var(--ink)");
expect(
rootStyle
.getPropertyValue("--techlog-palette-28b516db")
.replaceAll(" ", ""),
).toBe("rgba(255,255,255,0.45)");
expect(bodyStyle.background).toContain(
"linear-gradient(to bottom, var(--techlog-palette-28b516db), transparent 420px)",
);
expect(bodyStyle.background).toContain("var(--canvas)");
expect(bodyStyle.fontFamily).toContain("Pretendard Variable");
expect(bodyStyle.fontSize).toBe("16px");
expect(bodyStyle.fontWeight).toBe("400");
expect(bodyStyle.lineHeight).toBe("1.6");
expect(bodyStyle.minWidth).toBe("320px");
expect(headerInner).not.toBeNull();
expect(getComputedStyle(headerInner!).display).toBe("grid");
expect(getComputedStyle(headerInner!).minHeight).toBe("76px");
expect(getComputedStyle(headerInner!).gap).toBe("48px");
expect(getComputedStyle(main).width).toBe(
"min(var(--shell), calc(100% - 80px))",
);
expect(getComputedStyle(wordmark).fontSize).toBe("17px");
expect(getComputedStyle(wordmark).fontWeight).toBe("680");
});
it("aligns code, table, and evidence widths with the article body", async () => {
const view = await renderPublicSurface(
createElement(
"main",
{ id: "main-content", className: "shell" },
createElement(
"article",
{ className: "document-body" },
createElement(
"section",
null,
createElement("p", null, "본문"),
createElement(
"figure",
{ className: "code-block" },
createElement("pre", null, createElement("code", null, "code")),
),
createElement(
"div",
{ className: "data-table-wrap" },
createElement("table", null, createElement("tbody")),
),
createElement(
"figure",
{ className: "evidence-figure" },
createElement("img", { alt: "근거 자료" }),
),
),
),
),
);
const article = view.container.querySelector<HTMLElement>(".document-body");
const code = view.container.querySelector<HTMLElement>(".code-block");
const codeScroller = view.container.querySelector<HTMLElement>(
".code-block pre",
);
const table = view.container.querySelector<HTMLElement>(".data-table-wrap");
const evidence = view.container.querySelector<HTMLElement>(
".evidence-figure",
);
expect(getComputedStyle(article!).width).toBe("min(100%, var(--body-copy))");
for (const material of [code, table, evidence]) {
expect(getComputedStyle(material!).width).toBe(
"min(var(--body-copy), 100%)",
);
expect(getComputedStyle(material!).transform).toBe("none");
}
expect(getComputedStyle(codeScroller!).overflowX).toBe("auto");
expect(getComputedStyle(table!).overflowX).toBe("auto");
});
it("preserves keyboard focus and the real search-field focus style", async () => {
const user = userEvent.setup();
const view = await renderPublicSurface(
createElement(
"main",
{ id: "main-content", className: "shell" },
"공개 본문",
),
);
const wordmark = view.getByRole("link", { name: "TechLog 홈" });
const searchInput = view.container.querySelector<HTMLInputElement>(
".search-field input",
);
const searchField = view.container.querySelector<HTMLElement>(
".search-field",
);
await user.tab();
await user.tab();
expect(wordmark).toHaveFocus();
searchInput!.focus();
expect(searchInput).toHaveFocus();
expect(searchField).not.toBeNull();
expect(searchField!.matches(":focus-within")).toBe(true);
expect(getComputedStyle(searchField!).boxShadow).toBe(
"0 0 0 3px var(--signal-soft)",
);
});
it("keeps every header and dialog control at the source minimum target size", async () => {
const view = await renderPublicSurface(
createElement(
"main",
{ id: "main-content", className: "shell" },
"공개 본문",
),
);
const wordmark = view.getByRole("link", { name: "TechLog 홈" });
const navLink = view.container.querySelector<HTMLElement>(".nav-link");
const searchButton = view.getByRole("button", {
name: "TechLog 검색 열기",
});
const closeButton = view.container.querySelector<HTMLElement>(
".ui-dialog__close",
);
const searchField = view.container.querySelector<HTMLElement>(
".search-field",
);
const dialogSurface = view.container.querySelector<HTMLElement>(
".search-dialog .ui-dialog__surface",
);
expect(getComputedStyle(wordmark).minHeight).toBe("44px");
expect(getComputedStyle(navLink!).minHeight).toBe("44px");
expect(getComputedStyle(searchButton).minHeight).toBe("44px");
expect(getComputedStyle(closeButton!).minWidth).toBe("52px");
expect(getComputedStyle(closeButton!).minHeight).toBe("44px");
expect(getComputedStyle(searchField!).minHeight).toBe("56px");
expect(getComputedStyle(searchField!).marginTop).toBe("24px");
const rootStyle = getComputedStyle(document.documentElement);
expect(rootStyle.getPropertyValue("--techlog-theme-surface-elevated")).toBe(
"#ffffff",
);
expect(rootStyle.getPropertyValue("--color-surface-elevated")).toBe(
"var(--techlog-theme-surface-elevated)",
);
expect(getComputedStyle(dialogSurface!).padding).toBe("27px 28px 22px");
});
it("preserves footer spacing and fatal-action sizing", async () => {
const view = await renderPublicSurface(
createElement(FatalErrorState, {
traceId: "PUBLIC-500",
retryHref: "/",
}),
);
const footerInner = view.container.querySelector<HTMLElement>(
".footer-inner",
);
const retry = view.getByRole("link", { name: "다시 시도" });
expect(getComputedStyle(footerInner!).minHeight).toBe("172px");
expect(getComputedStyle(footerInner!).gap).toBe("40px");
expect(getComputedStyle(retry).minHeight).toBe("44px");
expect(getComputedStyle(retry).marginTop).toBe("34px");
});
});