예제 화면 /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)는 옛·새 골든 모두 통과했다. 변이는 되돌렸다.
114 lines
4.0 KiB
TypeScript
114 lines
4.0 KiB
TypeScript
import AxeBuilder from "@axe-core/playwright";
|
|
|
|
import {
|
|
expect,
|
|
test,
|
|
type Page,
|
|
} from "../support/browser/strict-browser-test.ts";
|
|
|
|
/**
|
|
* The design-system gallery (src/presentation/design-system/galleries.stories.tsx)
|
|
* in a real browser. These checks ran on the template's example screen
|
|
* `/examples/ui` until the galleries became workshop stories; the primitives
|
|
* keep their own component suites. The a11y addon's own axe run is switched
|
|
* off, as in workshop.spec.ts: the dialog check below owns it.
|
|
*/
|
|
async function openDesignSystemGallery(page: Page) {
|
|
await page.goto(
|
|
"/iframe.html?id=platform-galleries--design-system&viewMode=story&globals=a11y.manual:!true",
|
|
);
|
|
await expect(
|
|
page.getByRole("heading", { level: 1, name: "UI 구성요소" }),
|
|
).toBeVisible();
|
|
}
|
|
|
|
test("validates and reports the common text-field flow", async ({ page }) => {
|
|
await openDesignSystemGallery(page);
|
|
await page.getByRole("button", { name: "입력 확인" }).click();
|
|
|
|
const field = page.getByRole("textbox", { name: "프로젝트 이름" });
|
|
await expect(field).toHaveAttribute("aria-invalid", "true");
|
|
await expect(field).toHaveAccessibleDescription(
|
|
/프로젝트 이름을 입력해 주세요/,
|
|
);
|
|
|
|
await field.fill("Starter");
|
|
await page.getByRole("button", { name: "입력 확인" }).click();
|
|
await expect(page.getByText("“Starter” 입력을 확인했습니다.")).toBeVisible();
|
|
});
|
|
|
|
test("traps modal interaction and restores focus to the trigger", async ({
|
|
page,
|
|
}) => {
|
|
await openDesignSystemGallery(page);
|
|
const trigger = page.getByRole("button", { name: "모달 열기" });
|
|
await trigger.click();
|
|
|
|
const dialog = page.getByRole("dialog", { name: "연동 확인" });
|
|
await expect(dialog).toBeVisible();
|
|
await expect(
|
|
dialog.getByRole("button", { name: "연동 확인 닫기" }),
|
|
).toBeFocused();
|
|
|
|
await page.keyboard.press("Escape");
|
|
await expect(dialog).toBeHidden();
|
|
await expect(trigger).toBeFocused();
|
|
});
|
|
|
|
test("opened design-system dialog has no blocking violations", async ({
|
|
page,
|
|
}) => {
|
|
await openDesignSystemGallery(page);
|
|
await page.getByRole("button", { name: "모달 열기" }).click();
|
|
const results = await new AxeBuilder({ page })
|
|
.include(".ui-dialog")
|
|
.withTags(["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"])
|
|
.analyze();
|
|
expect(
|
|
results.violations.filter((violation) =>
|
|
["critical", "serious"].includes(violation.impact ?? ""),
|
|
),
|
|
).toEqual([]);
|
|
});
|
|
|
|
test("runs menu typeahead, tabs and duplicate toast interactions", async ({
|
|
page,
|
|
}) => {
|
|
await openDesignSystemGallery(page);
|
|
|
|
const menuTrigger = page.getByRole("button", { name: "작업 메뉴" });
|
|
await menuTrigger.focus();
|
|
await page.keyboard.press("ArrowDown");
|
|
await page.keyboard.type("toast");
|
|
const toastItem = page.getByRole("menuitem", { name: "Toast 표시" });
|
|
await expect(toastItem).toBeFocused();
|
|
await page.keyboard.press("Enter");
|
|
await expect(page.getByText("예제가 저장되었습니다.")).toBeVisible();
|
|
await expect(menuTrigger).toBeFocused();
|
|
|
|
const tokenTab = page.getByRole("tab", { name: "토큰" });
|
|
await tokenTab.focus();
|
|
await page.keyboard.press("ArrowRight");
|
|
const primitiveTab = page.getByRole("tab", { name: "프리미티브" });
|
|
await expect(primitiveTab).toBeFocused();
|
|
await expect(primitiveTab).toHaveAttribute("aria-selected", "false");
|
|
await page.keyboard.press("Enter");
|
|
await expect(primitiveTab).toHaveAttribute("aria-selected", "true");
|
|
await expect(
|
|
page.getByRole("tabpanel", { name: "프리미티브" }),
|
|
).toContainText("native semantics");
|
|
});
|
|
|
|
test("reflows the gallery at the 320px minimum without horizontal overflow", async ({
|
|
page,
|
|
}) => {
|
|
await page.setViewportSize({ width: 320, height: 720 });
|
|
await openDesignSystemGallery(page);
|
|
|
|
const viewport = await page.evaluate(() => ({
|
|
clientWidth: document.documentElement.clientWidth,
|
|
scrollWidth: document.documentElement.scrollWidth,
|
|
}));
|
|
expect(viewport.scrollWidth).toBeLessThanOrEqual(viewport.clientWidth);
|
|
});
|