문제
디자인 규칙이 올바른 CSS를 거부한다. 포커스 대비 규칙의 parseOklch는
색상각 단위 deg와 음수 색상각을 읽지 못해 oklch(52% 0.15 230deg)를 실패로
센다(B13). 첫 글꼴 규칙은 -apple-system, BlinkMacSystemFont로 시작하는
시스템 글꼴 스택을 실패로 센다(B6). color-mix()·알파 표면(B10, B11)은
"--color-focus or X is not a plain oklch() value"로 실패해서 어느 토큰이
무슨 값인지, 무엇이면 되는지 알 수 없다. 네 규칙의 설명은 코드 주석에만
있다.
고른 방법
- parseOklch가 색상각에 deg와 음수를 받는다. 알파는 계속 받지 않는다.
- oklch-contrast.ts에 resolveValue(var() 사슬 끝 값)를 두고 resolveColor가
그것을 쓴다. 포커스 규칙은 계산할 수 없는 토큰마다 "<테마> <토큰> is
<값>; contrast needs an opaque oklch(L C H), hue in degrees with or
without deg"를 낸다. 포커스 색 자체를 못 읽으면 표면 8개 대신 한 줄이다.
- 첫 글꼴 허용 목록에 -apple-system, BlinkMacSystemFont를 더한다.
- docs/styling/design-system-platform.md 4.1절에 규칙 4개, 지원 형식,
검사 위치를 표 하나로 적는다.
버린 대안
- color-mix()·알파 표면을 배경 위에 섞어 계산: 무엇이 아래에 그려지는지
규칙이 모른다. 추측하지 않고 실패하는 기존 원칙을 유지하고 메시지로
해결 형식을 알린다(리뷰 대안 비교와 같다).
- 리뷰 개선 (4) token-contract.ts에 "제품이 싣는 글꼴" 목록: 공개 계약에
새 이름을 넣는 설계 선택이고 완료 기준에 없다. 문서 표에 "아직 선언할
곳이 없어 실패한다"로 적었다.
- rad·grad·turn 단위: 쓰는 곳이 없다. 넣지 않은 단위는 메시지가 알려 준다.
위험·한계
- 실패 메시지 문구가 바뀐다. 문구를 단언하는 곳은 이 테스트 파일뿐이다.
- 패키지·<link>로 싣는 글꼴, 12-03의 검사 위치 밖 CSS는 그대로다.
- 화면 변화 없음. CSS를 바꾸지 않았다.
검증
- RED(수정 전): design-system-rules·oklch-contrast 테스트 19개 중 4개
실패. "reads a hue written with deg" expected [ …(8) ] to deeply equal [],
"names the value it cannot compute …" 메시지 불일치, "-apple-system"
expected [ Array(1) ] to deeply equal [], parseOklch("…230deg") expected
null.
- GREEN: 같은 두 파일과 design-system-contract 21/21 통과. 실제 스크립트
probe: 포커스를 oklch(52% 0.15 230deg)로 → PASS(B13). surface-muted를
oklch(0.97 0 0 / 0.9)로 → "light --color-surface-muted is oklch(0.97 0 0
/ 0.9); contrast needs …"로 실패(B11). 저장소 CSS는 PASS.
- tsc(tsconfig.node, tsconfig.test), 바꾼 파일 eslint, verify-
documentation-readiness PASS_SCOPED.
Refs: docs/reviews/2026-11-01-maturity-review/12-guardrails-ci.md 12-04
51 lines
1.8 KiB
TypeScript
51 lines
1.8 KiB
TypeScript
import { describe, expect, it } from "vitest";
|
|
|
|
import {
|
|
contrastRatio,
|
|
parseOklch,
|
|
readCustomProperties,
|
|
resolveColor,
|
|
} from "../../scripts/lib/oklch-contrast.ts";
|
|
|
|
const color = (value: string) => {
|
|
const parsed = parseOklch(value);
|
|
if (!parsed) throw new Error(`not an oklch value: ${value}`);
|
|
return parsed;
|
|
};
|
|
|
|
describe("oklch contrast", () => {
|
|
it("gives 21:1 for white on black", () => {
|
|
expect(contrastRatio(color("oklch(1 0 0)"), color("oklch(0 0 0)"))).toBeCloseTo(21, 1);
|
|
});
|
|
|
|
// UI-01: the old light focus ring measured 2.33:1 on white in Chromium.
|
|
it("matches the ratio the browser measured for the old focus ring", () => {
|
|
expect(
|
|
contrastRatio(color("oklch(0.72 0.16 225)"), color("oklch(1 0 0)")),
|
|
).toBeCloseTo(2.33, 1);
|
|
});
|
|
|
|
it("reads percentages and a missing hue", () => {
|
|
expect(parseOklch("oklch(50% 0.1 none)")).toEqual({ l: 0.5, c: 0.1, h: 0 });
|
|
expect(parseOklch("color-mix(in oklab, red, blue)")).toBeNull();
|
|
});
|
|
|
|
// 12-04: valid CSS the browser draws the same as the unitless form.
|
|
it("reads a hue in deg and a negative hue, and refuses alpha", () => {
|
|
expect(parseOklch("oklch(52% 0.15 230deg)")).toEqual({ l: 0.52, c: 0.15, h: 230 });
|
|
expect(parseOklch("oklch(0.5 0.1 -30)")).toEqual({ l: 0.5, c: 0.1, h: -30 });
|
|
expect(parseOklch("oklch(0.5 0.1 230 / 0.9)")).toBeNull();
|
|
});
|
|
|
|
it("follows var() chains and refuses values it cannot draw", () => {
|
|
const properties = readCustomProperties(`
|
|
--palette-white: oklch(1 0 0);
|
|
--color-panel: var(--palette-white);
|
|
--color-mixed: color-mix(in oklab, var(--palette-white) 50%, transparent);
|
|
`);
|
|
expect(resolveColor("--color-panel", properties)).toEqual({ l: 1, c: 0, h: 0 });
|
|
expect(resolveColor("--color-mixed", properties)).toBeNull();
|
|
expect(resolveColor("--color-missing", properties)).toBeNull();
|
|
});
|
|
});
|