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:
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user