Files
tech-log-frontend/tests/features/tech-log/section-heading-rank.test.ts
T
DongHyeonka de4cb8b30b feat: 홈이 주제를 탭으로 나란히 세운다
홈은 주제 하나만 펴 두고 나머지는 비교 목록 밑 「다른 주제 N개 보기」 한 줄로 보냈다.
그 줄은 목록을 다 읽고 나서야 만나는 자리라 대개 지나쳤고, 그래서 JPA 주제는 홈에
있으면서도 없는 것과 같았다.

구역 제목이 서 있던 자리(「구조별로 알게 된 것」)를 주제 이름 탭이 대신한다. 무엇이 더
있는지가 목록을 읽기 전에 먼저 보이고, 탭을 고르면 그 주제의 축이 그대로 열린다 —
인증 경계면 SPA·Mediator·BFF·Forward-Auth, JPA면 그 주제의 조회 전략들이다.

- 축의 이름은 목록 바로 위로 내렸다. 제목 자리를 탭이 가져갔으니 「이 넷은 구조다」는
  목록에 붙어 있어야 짝이 보인다.
- 패널은 전부 그려 두고 감춘다. 상세는 이미 받아 온 것이라 탭을 눌러도 요청이 나가지
  않고, 페이지 내 검색이 감춘 주제까지 찾는다.
- 탭이 되는 주제 수에 상한을 둔다. 주제마다 상세 요청이 하나씩 나가므로, 주제가 늘어도
  홈의 요청 수는 정해져 있다.
- 「다른 주제」 줄은 축이 없어 탭이 되지 못한 주제만 받는다.

탭은 h2 가 아니지만 구역 제목의 자리를 물려받았으므로 `section-heading-rank` 가 그 급을
정본과 함께 묶는다.
2026-09-02 10:59:14 +09:00

62 lines
2.5 KiB
TypeScript

import assert from "node:assert/strict";
import { readFileSync } from "node:fs";
import { test } from "vitest";
/**
* 한 화면에 나란히 서는 구역 제목은 같은 급이어야 한다.
*
* <p>정본은 `.section-heading-row h2` 다. 그 안에 들어가지 않는 두 구역이 크기만 각자 적어 두어
* 굵기를 아무도 정하지 않았고, 400 으로 떨어져 「구조별로 알게 된 것」만 형제 구역보다 작고
* 가늘게 나왔다 — 규칙이 없는 게 아니라 절반만 있었고, 그래서 「디자인이 안 됐다」로 보였다.
*/
const RAW = readFileSync("src/features/tech-log/presentation/styles/globals.css", "utf8");
/**
* 좁은 화면용 값은 뺀다. 화면 폭마다 급이 달라지는 것은 의도이고, 여기서 보려는 것은 같은
* 폭에서 나란히 설 때의 급이다.
*/
const CSS = RAW.replace(/@media[^{]*\{(?:[^{}]*\{[^}]*\})*[^{}]*\}/gu, "");
/**
* 나란히 서는 구역 제목들. 정본이 맨 앞이다.
*
* <p>홈의 주제 탭은 h2 가 아니지만 구역 제목이 서 있던 자리를 그대로 물려받았다. 태그가 다르다는
* 이유로 급을 따로 정하면 같은 자리에 있는 글자가 화면마다 다른 크기로 나온다 — 이 검사가 처음
* 잡은 것이 바로 그 일이다.
*/
const SECTION_HEADINGS = [
".section-heading-row h2",
".document-relations h2",
".topic-variants h2",
".home-topic-tabs button",
] as const;
/** 마지막으로 선언된 값을 읽는다 — 뒤에 오는 규칙이 이긴다. */
function declared(selector: string, property: string): string | null {
const escaped = selector.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
const blocks = [
...CSS.matchAll(new RegExp(`(?:^|,|\\n)\\s*${escaped}\\s*(?:,[^{]*)?\\{([^}]*)\\}`, "gu")),
];
let value: string | null = null;
for (const block of blocks) {
const found = new RegExp(`${property}:\\s*([^;]+)`, "u").exec(block[1]!);
if (found) value = found[1]!.trim();
}
return value;
}
test("나란히 서는 구역 제목이 같은 크기와 굵기를 쓴다", () => {
const canonical = SECTION_HEADINGS[0];
for (const property of ["font-size", "font-weight"]) {
const want = declared(canonical, property);
assert.ok(want, `${canonical} 에 ${property} 가 없다 — 정본이 값을 갖고 있어야 한다`);
for (const selector of SECTION_HEADINGS.slice(1)) {
assert.equal(
declared(selector, property),
want,
`${selector} 의 ${property} 가 ${canonical} 과 다르다`,
);
}
}
});