test(visual): 갤러리를 Storybook story로 옮기고 골든 대상을 바꾼다

예제 화면 /examples/ui·/examples/states가 visual 골든 2장과 갤러리
브라우저 시험의 대상이다. 2026-11-07 소유자 결정으로 예제 화면을
지우므로 그 역할을 먼저 옮긴다(design-docs repo-structure/
04-frontend-layout.md 9.2절 2단계 (1)).

두 갤러리 화면을 그대로 src/presentation/design-system/
galleries.stories.tsx로 옮겼다. 화면 단위 story(parameters.page)는
preview가 여백을 더하지 않아 앱 안과 같은 폭으로 그려진다. visual
설정은 Storybook 정적 빌드를 두 번째 web server로 띄우고
(TEST_VISUAL_WORKSHOP_PORT, 빌드 명령은 workshop 설정과 같은
scripts/lib/storybook-static.ts), 골든 2장은 그 story를 찍는다. 어두운
골든은 테마 선택기가 없어 시스템 dark(colorScheme)로 그린다. e2e의
갤러리 상호작용(텍스트 필드, 모달 포커스, 메뉴·탭·토스트, 열린 대화
상자 axe, 320px 리플로)은 tests/storybook/galleries.spec.ts로 옮겼다.

위험: 골든의 픽셀 색 허용치(threshold 0.2)는 그대로다. 미세한 토큰
변화는 옛 골든처럼 새 골든도 잡지 못한다.

검증(desktop): test:storybook 6 passed, test:visual 7 passed,
playwright-run-isolation 단위 시험 통과. 변이 확인: --color-action을
파랑→빨강으로 바꾸면 새 골든이 어두운 쪽 42,313px, 밝은 쪽 22,359px
차이로 실패했다. 옛 골든(main f33e4778)도 40,238px, 22,511px로 실패했다.
미세 변이(어두운 --color-danger red-500→600, 밝은 --color-danger-surface
색상각 25→145)는 옛·새 골든 모두 통과했다. 변이는 되돌렸다.
This commit is contained in:
DongHyeonka
2026-11-08 13:51:54 +09:00
parent f33e4778bb
commit c7e80f2f8a
19 changed files with 749 additions and 138 deletions
+18
View File
@@ -113,15 +113,33 @@ export function checkoutBuildReadFailure(
/**
* The port variable of each Playwright config's web server. Unset, the config
* picks a free port; set, it uses that one (to pin a port while debugging).
* `visualWorkshop` is the visual config's second server, the static workshop
* the gallery goldens open.
*/
export const TEST_PORT_VARIABLES = Object.freeze({
e2e: "TEST_E2E_PORT",
visual: "TEST_VISUAL_PORT",
visualWorkshop: "TEST_VISUAL_WORKSHOP_PORT",
capabilities: "TEST_CAPABILITIES_PORT",
storybook: "TEST_STORYBOOK_PORT",
dev: "TEST_DEV_PORT",
} as const);
/**
* The origin of a config's second server, for its specs. The runner reserved
* the port in `variable` (reservePort) and its workers inherit it.
*/
export function reservedOrigin(
variable: string,
environment: Readonly<Record<string, string | undefined>> = process.env,
): string {
const port = environment[variable];
if (port === undefined || port === "") {
throw new Error(`${variable} is not set: run this spec through its Playwright config`);
}
return `http://127.0.0.1:${port}`;
}
/**
* A port nothing listens on now: the one the kernel gives a socket bound to
* port 0, which is closed again. Another process can still take it before the
+27
View File
@@ -0,0 +1,27 @@
import { testRunPath, testRunRoot } from "./run-isolation.ts";
/**
* The static workshop a Playwright config serves: the workshop tests
* (playwright.storybook.config.ts) and the gallery goldens
* (playwright.visual.config.ts) open the same build.
*
* 1105/12-04. Under TEST_RUN_ID the workshop is built into the run's own
* folder (.tmp/runs/<id>/artifacts/storybook/static) with build:storybook's
* two steps and another output folder. Unset, the gate's build:storybook
* writes artifacts/storybook/static.
*/
export function storybookStaticServer(port: number): Readonly<{
directory: string;
command: string;
}> {
const directory = testRunPath("artifacts/storybook/static");
const build =
testRunRoot() === "."
? "corepack pnpm build:storybook"
: "node scripts/generate-product-feature-index.ts && " +
`corepack pnpm exec storybook build -o ${directory}`;
return Object.freeze({
directory,
command: `${build} && node scripts/serve-static.ts ${directory} ${port}`,
});
}