fix(examples): 릴리스 신원 칸의 자리를 미리 잡고 lab이 대상 화면 직접 진입 CLS를 잰다

문제: 플랫폼 구성 화면(lab 대상)은 getReleaseSummary()가 끝날 때까지
릴리스 신원 칸을 "상태" 한 칸으로 그리고, 끝나면 hint 줄이 있는 네 칸으로
바꾼다. 제목이 보인 뒤 약 30~100 ms에 grid가 hint 한 줄만큼 커져 아래
section이 21 px 내려간다(layout shift 0.00461, 리뷰 15-platform-shift
16회). lab은 `/`에서 클릭으로만 들어가고, 클릭 뒤 500 ms 안의 shift는
hadRecentInput이라 CLS에서 빠지므로 0을 낸다. `/` 밖의 라우트 CLS는 어느
게이트도 보지 않는다.

고른 방법:
- 화면: 요약 전·실패 때도 같은 네 칸(빌드·릴리스·설정 스키마·계약 집합
  다이제스트)을 같은 hint 줄 구성으로 그린다. 값만 "확인하고 있습니다."
  / "확인하지 못했습니다." / "—"다. 상태 문장은 가장 좁은 칸(13rem)에서도
  한 줄이 되게 짧게 했다. dl에 aria-busy를 둔다. 시각 테스트는 이미
  `main [aria-busy='true']`가 0개가 될 때까지 기다리므로, dt만 보고 찍던
  대기가 값이 채워진 뒤로 유지된다.
- lab: run마다 대상 라우트를 새 context에서 직접 열고 heading 뒤 network
  idle까지의 CLS를 잰다(metrics.targetDeepLinkCls, 중앙값,
  context.sampling.targetDeepLink에 표본). evaluateLabBudget가 lab.cls
  임계값으로 판정한다. 클릭 시계(상호작용 중앙값)와 대상 라우트는 그대로다.
- 컴포넌트 테스트: 요약 전과 후의 칸 이름·hint 유무가 같다. 실패 테스트는
  빌드 칸의 값으로 본다. 단위 테스트: 직접 진입 CLS가 임계값을 넘으면
  lab 판정이 실패한다.
버린 대안: 릴리스 요약을 동기로 읽기 — getReleaseSummary()가 비동기
포트 계약이라 포트를 바꿔야 한다. 클릭 run에서 hadRecentInput을 무시 —
CLS 정의와 달라져 field 값과 비교할 수 없다.

위험·한계: lab 시간이 run마다 cold navigation 하나(lab 조건 약 2~3초)
늘어 5회면 +10~15초다. 직접 진입 CLS 예산은 0.1이라 0.0046 같은 작은
shift는 실패시키지 않고 lab.json에 값으로만 남는다. layout shift 0건은
lab 값(0)과 15-platform-shift 방법으로 확인해야 한다. 상태 문구가 바뀌어
"런타임 정보를 확인하고 있습니다." 문장은 이 화면에서 사라졌다(홈 화면
문구는 그대로). lab.json 스키마 문서(config/schemas/lab-performance.schema.json)에
새 칸을 필수로 더했다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/component/starter-platform-overview-page.test.tsx
tests/unit/performance-budgets.test.ts
corepack pnpm build && corepack pnpm test:performance -- --runs=5
(lab.json metrics.targetDeepLinkCls가 0인지)

Refs: 1105/15-01
This commit is contained in:
DongHyeonka
2026-11-06 01:23:48 +09:00
parent e02f252d57
commit 138c195fcd
7 changed files with 221 additions and 22 deletions
@@ -60,6 +60,23 @@ function Metric({
);
}
/**
* 1105/15-01. The release metrics before the summary resolves, or after it
* failed: the resolved metrics' labels and hint lines, so the grid keeps its
* height. The status takes the first card's value and stays short enough for
* one line in the narrowest card (13rem), as a build id does.
*/
function ReleaseMetricsPlaceholder({ status }: Readonly<{ status: string }>) {
return (
<>
<Metric label="빌드" value={status} />
<Metric label="릴리스" value="—" />
<Metric label="설정 스키마" value="—" hint="—" />
<Metric label="계약 집합 다이제스트" value="—" hint="—" />
</>
);
}
type RouteRow = (typeof ROUTE_REGISTRY)[keyof typeof ROUTE_REGISTRY];
const ROUTE_COLUMNS: readonly DataTableColumn<RouteRow>[] = Object.freeze([
@@ -419,10 +436,18 @@ export function PlatformOverviewPage({
부팅 시 경계 검사를 통과한 런타임 설정과 릴리스 매니페스트에서 옵니다.
</p>
</header>
<dl className="platform-metric-grid" aria-live="polite">
{release === "failed" ? (
<Metric label="상태" value="런타임 정보를 확인하지 못했습니다." />
) : release ? (
{/* 1105/15-01. The same four metrics, with the same hint lines, in
every state: the grid used to grow from one card to four with
hints once the summary resolved, about 30-100 ms after the title,
and pushed everything below it 21 px (CLS 0.0046 on a direct
visit). Only the values change; `aria-busy` says when they are
not there yet (the visual test waits on it). */}
<dl
className="platform-metric-grid"
aria-live="polite"
aria-busy={release === null}
>
{release !== null && release !== "failed" ? (
<>
<Metric label="빌드" value={release.buildId} />
<Metric label="릴리스" value={release.releaseId} />
@@ -450,7 +475,11 @@ export function PlatformOverviewPage({
/>
</>
) : (
<Metric label="상태" value="런타임 정보를 확인하고 있습니다." />
<ReleaseMetricsPlaceholder
status={
release === "failed" ? "확인하지 못했습니다." : "확인하고 있습니다."
}
/>
)}
</dl>
</section>