이 사이트의 차별점은 "기록 하나에 아무 데서나 들어와도 그 결론을 만든 맥락의 사슬을 잃지 않는다"는 것이다. 그런데 그 사슬이 화면에서는 제목 위 얇은 breadcrumb 한 줄과 문서 맨 아래 「다음에 읽을 것」으로만 표현돼 있었다 — 검색으로 Case 하나에 들어온 사람은 바닥까지 내려가야 이 기록이 어느 프로젝트의 어느 질문에서 나왔는지 알 수 있었다. 저장은 되어 있는데 겪게 되지는 않는 상태였다. 제목·요약 바로 아래에 맥락을 하나의 덩어리로 세운다. 프로젝트 → 주제로 올라가는 길과, 같은 조사 안에서 이웃한 기록들을 함께 보인다. 이웃에는 작성자가 그 관계에 남긴 문장을 붙인다 — 「다음에 무엇을」보다 「왜 그것을」이 먼저 있어야 목록이 아니라 사슬로 읽힌다. 지금 보는 기록도 목록에 남겨 자기 자리가 보이게 한다. 여섯 종류 전부에 들어간다. 종류마다 하나씩 픽스처를 둔 `Record<RecordKind, …>` 검사로 막았다 — 한 종류에서만 빠지면 그 종류로 들어온 방문자에게만 조용히 사슬이 끊긴다. Question 에서 빼 보고 그 검사만 실패하는 것을 확인했다. 화면 촬영기(`scripts/capture-screens.ts`)도 함께 넣는다. 라우트 레지스트리를 돌며 공개·Studio 전 화면을 찍는다. 찍을 목록을 손으로 적지 않고 `Record<RouteId, …>` 로 두어 라우트가 늘면 컴파일러가 빈 자리를 잡는다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D
58 lines
2.5 KiB
TypeScript
58 lines
2.5 KiB
TypeScript
import assert from "node:assert/strict";
|
|
import { readFileSync } from "node:fs";
|
|
import { test } from "vitest";
|
|
|
|
/**
|
|
* 구역 클래스 하나에 태그 하나만 붙인 배치 규칙을 잡는다.
|
|
*
|
|
* <p>`.home-comparison a { display: grid; grid-template-columns: 200px … }` 는 비교 행을 위한
|
|
* 규칙인데, 같은 구역의 제목 안에 있던 링크까지 잡았다. 제목이 200px 칸에 갇혀 두 줄로 접히고
|
|
* 행용 padding 까지 물려 h2 높이가 199px 이 됐다 — 디자인이 빠진 것처럼 보였지만 규칙이 샌
|
|
* 것이었다. 같은 구역의 안내 문단도 행의 크기·색으로 덮여 있었다.
|
|
*
|
|
* <p>배치를 거는 규칙은 그 배치를 쓰는 요소까지 좁혀 적는다(`li > a`). 이 검사는 그 습관을
|
|
* 지키게 한다 — 색이나 글꼴만 거는 규칙은 새어도 티가 나지 않으므로 대상이 아니다.
|
|
*/
|
|
const CSS = readFileSync("src/features/tech-log/presentation/styles/globals.css", "utf8");
|
|
|
|
/** 배치를 만드는 속성. 이것들이 의도하지 않은 요소에 걸리면 화면이 접히거나 밀린다. */
|
|
const LAYOUT = /display:\s*(grid|flex)|grid-template-columns:|(?:^|;|\s)padding:/u;
|
|
|
|
/**
|
|
* 이미 좁혀 둔 규칙과, 그 태그 하나만 나오는 것이 확실한 구역.
|
|
*
|
|
* <p>`.document-toc a` 처럼 구역 안에 그 태그가 목록으로만 나오는 자리는 좁힐 것이 없다.
|
|
* 새 구역을 만들 때 여기 줄을 더하기 전에, 정말 그 태그가 한 종류로만 쓰이는지 먼저 본다.
|
|
*/
|
|
const SETTLED = new Set([
|
|
".document-toc a",
|
|
".public-filter-form a",
|
|
".profile-principles li",
|
|
".profile-topics li",
|
|
".project-topics li",
|
|
".question-options li",
|
|
".reference-rules li",
|
|
".studio-readiness-list li",
|
|
".studio-relations-editor li",
|
|
".project-index-title span",
|
|
// 맥락 덩어리의 두 목록은 한 모양의 항목만 담는다 — 프로젝트/주제 한 쌍, 기록 한 줄.
|
|
".context-trail li",
|
|
".context-siblings li",
|
|
".studio-warning-check span",
|
|
]);
|
|
|
|
test("배치를 거는 구역 규칙은 그 배치를 쓰는 요소까지 좁혀 적는다", () => {
|
|
const broad: string[] = [];
|
|
for (const match of CSS.matchAll(/\n(\.[a-z-]+ (?:a|p|strong|span|h2|h3|li))\s*\{([^}]*)\}/gu)) {
|
|
const selector = match[1]!;
|
|
if (SETTLED.has(selector)) continue;
|
|
if (LAYOUT.test(match[2]!)) broad.push(selector);
|
|
}
|
|
|
|
assert.deepEqual(
|
|
broad,
|
|
[],
|
|
`구역 전체에 배치를 걸고 있다 — 제목·안내 문단까지 잡는다:\n${broad.join("\n")}`,
|
|
);
|
|
});
|