Files
DongHyeonkaandClaude Opus 5 7dda6c7923 refactor: v4 편집기가 걷어낸 화면의 잔해를 지운다
즉시 미리보기(`InstantPreview`)와 동작 원리 띠(`MechanismMap`)는 파일로만 남아 있었다.
아무 화면도 부르지 않는데 규칙과 검사는 그대로여서, 고칠 때마다 살아 있는 코드처럼 따라왔다.

함께 죽어 있던 것들:
- `createAssetCatalogResolver` — 즉시 미리보기만 쓰던 픽셀 해석기
- `mergeAssetCatalog` 와 편집기의 자료 목록 — 그 목록을 읽던 화면이 없어졌다
  (`DocumentEditor` 는 이미 `assets: _assets` 로 받아만 두고 있었다)
- 분할 편집기·미리보기 모드·예전 검증 패널의 CSS 규칙

검사는 지우지 않고 살아 있는 쪽으로 옮겼다. 자료 열쇠 합의 검사는 이제 목 어댑터의 투영과
공개 화면이 실제로 쓰는 해석기를 맞대고 본다 — READY 검사를 빼 보면 144개 조합 중 16개가
어긋난다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-16 17:44:09 +09:00

62 lines
2.7 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",
".home-path-trail li",
".home-path-records li",
".investigation-records li",
// 흐름의 마디는 한 모양뿐이다 — 각 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")}`,
);
});