Files
tech-log-frontend/tests/features/tech-log/public-shell.test.tsx
T
DongHyeonkaandClaude Opus 5 618a228eff fix: 관계의 묶음 이름과 작성자가 쓴 문장을 갈라 놓는다
관계 한 줄에 세 가지가 뭉쳐 있었다. 대상이 어떤 종류인지, 작성자가 왜 걸었는지,
대상이 무엇인지 — 셋 다 `reason` 한 칸을 지나느라 경로마다 다른 것이 같은 자리에
나왔다. 렌더 모델 경로에서는 작성자의 문장이 묶음 이름 자리에 눌려 한 줄짜리 라벨인
척했고, 공개 조회 경로에서는 묶음 이름이 그 자리를 차지하고 작성자의 문장은 아예
버려졌다. 「다음에 무엇을 읽을지」의 답이 그 문장인데 공개 화면에 한 번도 나오지 않았다.

이제 셋이 각자의 칸을 갖는다. `label` 은 대상의 종류, `note` 는 작성자가 쓴 문장,
`summary` 는 대상의 요약이다. 설명 자리에는 문장이 있으면 문장을, 없으면 요약을
보인다 — 요약은 대상을 설명하고 문장은 왜 지금 이것을 읽어야 하는지를 설명한다.

공개 주소로 종류를 되짚던 삼항 사슬도 표로 바꾼다. `/concepts/` 가 어디에도 없어서
개념으로 가는 관계가 전부 `PROJECT` 로 떨어지고 있었다 — 손으로 나열한 목록에 새
종류를 빠뜨리는 일이 이 저장소에서만 다섯 번째다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
2026-09-01 16:48:11 +09:00

280 lines
9.9 KiB
TypeScript

// @vitest-environment jsdom
import { render, screen, within } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { createMemoryRouter, RouterProvider } from "react-router-dom";
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";
const originalShowModal = HTMLDialogElement.prototype.showModal;
const originalClose = HTMLDialogElement.prototype.close;
beforeEach(() => {
Object.defineProperty(HTMLDialogElement.prototype, "showModal", {
configurable: true,
value(this: HTMLDialogElement) {
this.setAttribute("open", "");
},
});
Object.defineProperty(HTMLDialogElement.prototype, "close", {
configurable: true,
value(this: HTMLDialogElement) {
this.removeAttribute("open");
this.dispatchEvent(new Event("close"));
},
});
vi.stubGlobal("requestAnimationFrame", (callback: FrameRequestCallback) => {
callback(0);
return 1;
});
});
afterEach(() => {
vi.unstubAllGlobals();
Object.defineProperty(HTMLDialogElement.prototype, "showModal", {
configurable: true,
value: originalShowModal,
});
Object.defineProperty(HTMLDialogElement.prototype, "close", {
configurable: true,
value: originalClose,
});
});
async function renderShell(initialEntry = "/projects") {
const techLog = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input;
const router = createMemoryRouter(
[
{
path: "*",
element: (
<PublicShell>
<main id="main-content" className="shell">
공개 본문
</main>
</PublicShell>
),
},
],
{ initialEntries: [initialEntry] },
);
const view = render(
renderWithQueryProviders(
<ApplicationProvider
application={createTestApplication({
featureInputs: { "tech-log": techLog },
})}
>
<RouterProvider router={router} />
</ApplicationProvider>,
));
// 포트가 async 가 되면서 첫 페인트에는 데이터가 없다. 화면이 정착한 뒤
// 단언하도록 여기서 한 번 기다린다 — 각 테스트에 흩어 놓으면 빠뜨린 곳이 생긴다.
await screen.findByRole("main");
return { ...view, router };
}
describe("TechLog Public shell", () => {
it("preserves source landmark order, navigation copy, current state, and footer", async () => {
const view = await renderShell();
const frame = view.container.querySelector(".site-frame");
expect(
Array.from(frame?.children ?? [], (child) => child.tagName),
).toEqual(["A", "HEADER", "MAIN", "FOOTER"]);
expect(screen.getByRole("link", { name: "본문으로 건너뛰기" })).toHaveAttribute(
"href",
"#main-content",
);
expect(screen.getByRole("banner")).toHaveClass("site-header");
expect(screen.getByRole("main")).toHaveAttribute("id", "main-content");
expect(screen.getByRole("contentinfo")).toHaveClass("site-footer");
expect(screen.getByRole("navigation", { name: "주요 탐색" })).toBeVisible();
expect(
screen.getByRole("navigation", { name: "모바일 주요 탐색" }),
).toBeInTheDocument();
const expectedNavigation = [
["탐색", "/explore"],
["프로젝트", "/projects"],
["프로필", "/profile"],
];
expect(
Array.from(
view.container.querySelectorAll<HTMLAnchorElement>(".desktop-nav a"),
(link) => [link.textContent, link.getAttribute("href")],
),
).toEqual(expectedNavigation);
expect(
Array.from(
view.container.querySelectorAll<HTMLAnchorElement>(
".mobile-nav nav a",
),
(link) => [link.textContent, link.getAttribute("href")],
),
).toEqual(expectedNavigation);
for (const link of screen.getAllByRole("link", { name: "프로젝트" })) {
expect(link).toHaveAttribute("aria-current", "page");
}
expect(screen.getByText("동현")).toHaveClass("footer-name");
expect(
screen.getByText("문제를 재현하고 검증해 운영 가능한 설계로 연결합니다."),
).toBeVisible();
expect(view.container.querySelector(".app-shell")).toBeNull();
});
it("uses the canonical root route for brand navigation", async () => {
const user = userEvent.setup();
const { router } = await renderShell("/projects/backend-skeleton");
await user.click(screen.getByRole("link", { name: "TechLog 홈" }));
expect(router.state.location.pathname).toBe("/");
});
it("opens search by click, closes on Escape, and restores trigger focus", async () => {
const user = userEvent.setup();
await renderShell();
const trigger = screen.getByRole("button", { name: "TechLog 검색 열기" });
await user.click(trigger);
const dialog = screen.getByRole("dialog", { name: "TechLog 검색" });
const input = within(dialog).getByRole("searchbox", { name: "검색어" });
expect(dialog).toHaveAttribute("open");
expect(dialog).toHaveAttribute("aria-labelledby", `${dialog.id}-title`);
expect(input).toHaveFocus();
await user.keyboard("{Escape}");
expect(dialog).not.toHaveAttribute("open");
expect(trigger).toHaveFocus();
});
it("opens the native search trigger from the keyboard", async () => {
const user = userEvent.setup();
await renderShell();
const trigger = screen.getByRole("button", { name: "TechLog 검색 열기" });
trigger.focus();
await user.keyboard("{Enter}");
expect(screen.getByRole("dialog", { name: "TechLog 검색" })).toHaveAttribute(
"open",
);
expect(screen.getByRole("searchbox", { name: "검색어" })).toHaveFocus();
});
it("returns source-equivalent results and navigates to their canonical route", async () => {
const user = userEvent.setup();
const { router } = await renderShell();
await user.click(
screen.getByRole("button", { name: "TechLog 검색 열기" }),
);
const input = screen.getByRole("searchbox", { name: "검색어" });
await user.type(input, "Keycloak");
expect(screen.getByText("1개의 공개 기록")).toBeVisible();
const result = screen.getByRole("link", { name: /Auth Lab/ });
expect(result).toHaveAttribute("href", "/projects/auth-lab");
expect(
screen.getByRole("link", { name: /전체 검색 결과 보기/ }),
).toHaveAttribute("href", "/search?q=Keycloak");
await user.click(result);
expect(router.state.location.pathname).toBe("/projects/auth-lab");
});
it("navigates the full-search action with its canonical query intact", async () => {
const user = userEvent.setup();
const { router } = await renderShell();
await user.click(
screen.getByRole("button", { name: "TechLog 검색 열기" }),
);
await user.type(
screen.getByRole("searchbox", { name: "검색어" }),
"Keycloak",
);
await user.click(
screen.getByRole("link", { name: /전체 검색 결과 보기/ }),
);
expect(router.state.location.pathname).toBe("/search");
expect(router.state.location.search).toBe("?q=Keycloak");
});
it("uses native mobile disclosure activation and closes it after selection", async () => {
const user = userEvent.setup();
const view = await renderShell();
const details = view.container.querySelector<HTMLDetailsElement>(
"details.mobile-nav",
);
const summary = details?.querySelector<HTMLElement>("summary");
expect(details).not.toBeNull();
expect(summary).not.toBeNull();
await user.click(summary!);
expect(details).toHaveAttribute("open");
await user.click(
within(details!).getByRole("link", { name: "탐색" }),
);
expect(details).not.toHaveAttribute("open");
await user.click(summary!);
expect(details).toHaveAttribute("open");
summary!.focus();
await user.keyboard("{Escape}");
expect(details).not.toHaveAttribute("open");
expect(summary).toHaveFocus();
});
it("closes a natively opened mobile disclosure before opening one search dialog", async () => {
const user = userEvent.setup();
const view = await renderShell();
const details = view.container.querySelector<HTMLDetailsElement>(
"details.mobile-nav",
);
const summary = details?.querySelector<HTMLElement>("summary");
expect(details).not.toBeNull();
expect(summary).not.toBeNull();
await user.click(summary!);
expect(details).toHaveAttribute("open");
await user.click(
screen.getByRole("button", { name: "TechLog 검색 열기" }),
);
expect(details).not.toHaveAttribute("open");
expect(screen.getAllByRole("dialog", { hidden: true })).toHaveLength(1);
});
});
describe("TechLog fatal Public state", () => {
it("preserves error copy, trace relationship, and retry variants", async () => {
const user = userEvent.setup();
const retry = vi.fn();
const view = render(
<FatalErrorState traceId="PUBLIC-500" onRetry={retry} />,
);
expect(screen.getByRole("main")).toHaveClass("shell", "fatal-state");
expect(
screen.getByRole("heading", { name: "페이지를 불러오지 못했습니다." }),
).toBeVisible();
expect(view.container.querySelector(".trace-id code")).toHaveTextContent(
"PUBLIC-500",
);
await user.click(screen.getByRole("button", { name: "다시 시도" }));
expect(retry).toHaveBeenCalledOnce();
});
});