round9 수정 묶음 둘(폼 저장 규칙 F2a·F2b, 공통 primitive 접근성 F4a)을 한 PR로 낸다. runner가 하나라 PR 수를 줄인다. 커밋은 원인마다 나뉘어 있다.
폼 저장 규칙(F2a·F2b)
결과 불명 상태를 코디네이터(useApplicationMutation)와 폼(useAppForm)이 따로 갖고, 둘을 맞추는 규칙은 생성 작성 페이지의 사본에 있다(1112/01-01). 사본에 든 규칙은 이렇다.
결과 불명·다른 저장 중에는 새 저장을 막는다.
「변경됨으로 확인」 뒤에 settleApplied를 부른다.
같은 키로 재전송한다.
마운트된 동안만 저장 뒤 이동한다.
그래서 플랫폼에서 고친 것(1105/08-02, 1105/08-04, 1106/08-02)이 이미 생성한 기능에 들어가지 않는다.
같은 구조에서 결함이 더 나온다.
다시 마운트한 폼의 재전송이 보내지 않은 화면 값을 저장 값으로 써서 지우거나 깨끗하게 표시한다(1106/03-01 FR-03 재발, 1112/01-02). 성공하면 페이지가 그 값을 이탈 확인 없이 버린다.
재전송이 쓰기 전에 거절되거나 선언한 409가 나면 안내가 「입력 내용을 확인해 주세요」 요약 아래 나온다(1112/04-02).
폼 밖에서 부른 같은 입력이 NOT_APPLIED로 끝나면 훅은 결과 불명인데 폼은 다시 시도를 보인다(1106/03-01 ②).
필드 이름이 붙은 결과 불명(VALIDATION_REJECTED + MAYBE_APPLIED)이 필드 오류와 결과 불명 화면을 함께 띄운다(1101/03-04).
재전송에 401이 오면 다시 로그인 안내가 결과 불명 화면에 가려진다(D-2).
페이지가 늘 넘기는 빈 피드백 칸이 그리드 간격을 한 줄 더 만든다.
공통 primitive 접근성(F4a)
Popover가 이름 없는 dialog를 그린다(05-10).
Escape를 누르면 엉뚱한 층이 닫힌다.
Dialog 안의 Menu·Popover·Tooltip에서 누르면 Dialog까지 닫힌다(05-11).
Dialog 밖에 열린 Popover·Tooltip은 Dialog 안에서 누른 Escape를 가로챈다.
필수 표시와 포커스가 약속과 다르다.
SearchField·Checkbox의 required가 반쪽이다(05-13).
Toast를 닫으면 포커스가 body로 떨어진다(05-14).
TextArea 글자 수가 글자마다 발표된다(05-17).
route h1의 outline 제거가 키보드 표시까지 지운다(05-02).
Tooltip이 포인터를 설명 위로 옮기면 사라진다(1.4.13, 05-06).
홈 목록이 role 없는 div에 aria-label을 단다(05-15).
스킬 문장이 실제 포커스 이동(첫 오류 필드)과 다르다(05-09).
고른 방법과 버린 대안
R9-D1은 권하는 안으로 정함(2026-11-12, 총괄)이다.
폼
useAppForm에 선택 옵션 둘을 더한다(추가만).
mutation을 주면 폼이 막기(saveBlocked)·확인(confirmUnknownEffect)·재전송(resendUnknownEffect)을 맡는다. 재전송 뒤 결과 불명인지는 코디네이터의 새 holdsUnknownEffect에게 묻는다.
onSaved는 폼이 결과를 보이고 pending을 끈 뒤, 마운트된 동안만 부른다. 그래서 이동이 폼의 이탈 확인을 거친다.
새 FormSaveFeedback이 피드백을 이 순서로 그린다: 다시 로그인 → 결과 불명(확인·재전송) → 다른 실패 → 충돌 → 다른 저장. 재전송 거절 안내는 AsyncSurface의 새 notice 칸에 간다.
폼은 MAYBE_APPLIED를 입력 오류보다 먼저 본다.
다시 마운트한 폼은 보낸 값을 모름으로 두고({ values: null }), 화면 값과 dirty를 지킨다.
생성 작성 페이지는 mutation.submit·mutation·onSaved·FormSaveFeedback만 쓰고, 자기 사본(마운트 표시, 결과 불명 판정)을 지운다.
빈 .page-template__feedback은 자리를 차지하지 않는다(:empty).
mutation 없이 쓰는 폼(이미 생성한 페이지)은 코디네이터에게 물을 수 없어 같은 거절 표(isRefusedOnEveryAttempt)로 판정한다.
버린 안:
판정 hook을 따로 두고 폼은 그대로 두기: 사본이 하나 더 생긴다.
화면 값을 쓰고 성공 뒤 되돌리기: 사용자가 입력한 값을 잃는다.
primitive
Popover는 trigger id로 이름을 받는다.
Popover·Tooltip은 Escape를 capture 단계에서 받아 기본 동작을 막는다. Dialog는 막힌 Escape(와 그 뒤의 cancel)를 넘긴다.
escape-layer.ts의 escapeIsForLayer는 Escape를 누른 곳이 그 층을 품지 않은 <dialog> 안이면 그 Escape를 dialog 몫으로 둔다. Tooltip은 보일 때만 Escape를 가진다.
Toast를 닫으면 포커스가 다음 toast의 닫기 버튼, 없으면 들어오기 전 요소로 간다.
TextArea 글자 수는 aria-describedby로 잇고, 0에 닿을 때만 따로 발표한다.
h1은 :focus:not(:focus-visible)일 때만 outline을 지운다.
Tooltip은 보일 때만 포인터를 받고, ::before 다리로 틈을 메운다.
버린 안:
Dialog가 안쪽 층 목록을 들기: primitive끼리 묶인다.
대상이 층 안일 때만 Escape 받기: WebKit은 클릭한 버튼에 포커스를 주지 않는다.
정한 기본값
PageHeader는 전부터 첫 로드에도 h1에 포커스를 준다. 그대로 두었다.
05-02를 고치자 Chromium이 포인터 조작 전의 그 포커스를 :focus-visible로 보아 첫 화면 h1에 링이 보인다.
시각 골든 넷(앱 셸 wide, 갤러리 dark, 상태 화면, 플랫폼 구성)이 h1 자리에서만 달라져 test:visual:update로 다시 찍었다(diff 이미지로 확인).
첫 로드에 포커스를 주지 않는 쪽은 라우트 포커스 동작을 바꾸는 일이라 이 PR 밖이다.
위험과 영향
이미 생성한 기능은 바뀌지 않는다. 다운스트림은 생성 작성 페이지의 결과 불명·막기·마운트 사본을 useAppForm({ mutation, onSaved })와 <FormSaveFeedback form={form} onConfirmed=… />로 바꾼다(round9 CHANGELOG에 옮기는 법을 적는다).
저장 뒤 이동이 폼이 결과를 그린 뒤로 한 번 늦어진다. 다시 마운트한 폼에 보내지 않은 값이 있으면 이동이 이탈 확인을 띄운다(의도).
FormSaveMutation·FormSaveFeedback·holdsUnknownEffect·onSaved·notice는 새 공개 API다(추가만).
base.css·templates.css를 받은 제품은 자기 시각 골든도 다시 찍는다(첫 화면 h1 링).
native <dialog>가 아닌 modal(role="dialog"만 단 것)은 Escape 층 판정이 모른다. 템플릿의 Dialog·Drawer는 <dialog>다.
VD-04 결정 5의 범위(선언하지 않은 409만)는 그 기록 맨 아래 보완 절에 적었다(1103/03-01 (3)).
검증
desktop, CI env, scripts/verify.sh(flock). 묶음별 RED·GREEN과 변이는 각 브랜치에서, merge 단계는 이 PR head에서 돌렸다.
F2a RED: 다시 마운트한 폼의 재전송 시험 둘 실패(적용 확인 하나는 대조군으로 통과). GREEN 39 passed.
F2b
RED: 새 동작 시험 셋 실패(저장 뒤 이동, 재전송 뒤 가드, 다시 로그인 먼저), 생성 페이지 정적 시험 실패.
## 무엇을, 왜
round9 수정 묶음 둘(폼 저장 규칙 F2a·F2b, 공통 primitive 접근성 F4a)을 한 PR로 낸다. runner가 하나라 PR 수를 줄인다. 커밋은 원인마다 나뉘어 있다.
### 폼 저장 규칙(F2a·F2b)
- 결과 불명 상태를 코디네이터(`useApplicationMutation`)와 폼(`useAppForm`)이 따로 갖고, 둘을 맞추는 규칙은 생성 작성 페이지의 사본에 있다(1112/01-01). 사본에 든 규칙은 이렇다.
- 결과 불명·다른 저장 중에는 새 저장을 막는다.
- 「변경됨으로 확인」 뒤에 `settleApplied`를 부른다.
- 같은 키로 재전송한다.
- 마운트된 동안만 저장 뒤 이동한다.
- 그래서 플랫폼에서 고친 것(1105/08-02, 1105/08-04, 1106/08-02)이 이미 생성한 기능에 들어가지 않는다.
- 같은 구조에서 결함이 더 나온다.
- 다시 마운트한 폼의 재전송이 보내지 않은 화면 값을 저장 값으로 써서 지우거나 깨끗하게 표시한다(1106/03-01 FR-03 재발, 1112/01-02). 성공하면 페이지가 그 값을 이탈 확인 없이 버린다.
- 재전송이 쓰기 전에 거절되거나 선언한 409가 나면 안내가 「입력 내용을 확인해 주세요」 요약 아래 나온다(1112/04-02).
- 폼 밖에서 부른 같은 입력이 `NOT_APPLIED`로 끝나면 훅은 결과 불명인데 폼은 다시 시도를 보인다(1106/03-01 ②).
- 필드 이름이 붙은 결과 불명(`VALIDATION_REJECTED` + `MAYBE_APPLIED`)이 필드 오류와 결과 불명 화면을 함께 띄운다(1101/03-04).
- 재전송에 401이 오면 다시 로그인 안내가 결과 불명 화면에 가려진다(D-2).
- 페이지가 늘 넘기는 빈 피드백 칸이 그리드 간격을 한 줄 더 만든다.
### 공통 primitive 접근성(F4a)
- Popover가 이름 없는 dialog를 그린다(05-10).
- Escape를 누르면 엉뚱한 층이 닫힌다.
- Dialog 안의 Menu·Popover·Tooltip에서 누르면 Dialog까지 닫힌다(05-11).
- Dialog 밖에 열린 Popover·Tooltip은 Dialog 안에서 누른 Escape를 가로챈다.
- 필수 표시와 포커스가 약속과 다르다.
- SearchField·Checkbox의 required가 반쪽이다(05-13).
- Toast를 닫으면 포커스가 body로 떨어진다(05-14).
- TextArea 글자 수가 글자마다 발표된다(05-17).
- route h1의 outline 제거가 키보드 표시까지 지운다(05-02).
- Tooltip이 포인터를 설명 위로 옮기면 사라진다(1.4.13, 05-06).
- 홈 목록이 role 없는 div에 aria-label을 단다(05-15).
- 스킬 문장이 실제 포커스 이동(첫 오류 필드)과 다르다(05-09).
## 고른 방법과 버린 대안
R9-D1은 권하는 안으로 정함(2026-11-12, 총괄)이다.
**폼**
- `useAppForm`에 선택 옵션 둘을 더한다(추가만).
- `mutation`을 주면 폼이 막기(`saveBlocked`)·확인(`confirmUnknownEffect`)·재전송(`resendUnknownEffect`)을 맡는다. 재전송 뒤 결과 불명인지는 코디네이터의 새 `holdsUnknownEffect`에게 묻는다.
- `onSaved`는 폼이 결과를 보이고 pending을 끈 뒤, 마운트된 동안만 부른다. 그래서 이동이 폼의 이탈 확인을 거친다.
- 새 `FormSaveFeedback`이 피드백을 이 순서로 그린다: 다시 로그인 → 결과 불명(확인·재전송) → 다른 실패 → 충돌 → 다른 저장. 재전송 거절 안내는 `AsyncSurface`의 새 `notice` 칸에 간다.
- 폼은 `MAYBE_APPLIED`를 입력 오류보다 먼저 본다.
- 다시 마운트한 폼은 보낸 값을 모름으로 두고(`{ values: null }`), 화면 값과 dirty를 지킨다.
- 생성 작성 페이지는 `mutation.submit`·`mutation`·`onSaved`·`FormSaveFeedback`만 쓰고, 자기 사본(마운트 표시, 결과 불명 판정)을 지운다.
- 빈 `.page-template__feedback`은 자리를 차지하지 않는다(`:empty`).
- mutation 없이 쓰는 폼(이미 생성한 페이지)은 코디네이터에게 물을 수 없어 같은 거절 표(`isRefusedOnEveryAttempt`)로 판정한다.
- 버린 안:
- 판정 hook을 따로 두고 폼은 그대로 두기: 사본이 하나 더 생긴다.
- 화면 값을 쓰고 성공 뒤 되돌리기: 사용자가 입력한 값을 잃는다.
**primitive**
- Popover는 trigger id로 이름을 받는다.
- Popover·Tooltip은 Escape를 capture 단계에서 받아 기본 동작을 막는다. Dialog는 막힌 Escape(와 그 뒤의 cancel)를 넘긴다.
- `escape-layer.ts`의 `escapeIsForLayer`는 Escape를 누른 곳이 그 층을 품지 않은 `<dialog>` 안이면 그 Escape를 dialog 몫으로 둔다. Tooltip은 보일 때만 Escape를 가진다.
- Toast를 닫으면 포커스가 다음 toast의 닫기 버튼, 없으면 들어오기 전 요소로 간다.
- TextArea 글자 수는 `aria-describedby`로 잇고, 0에 닿을 때만 따로 발표한다.
- h1은 `:focus:not(:focus-visible)`일 때만 outline을 지운다.
- Tooltip은 보일 때만 포인터를 받고, `::before` 다리로 틈을 메운다.
- 버린 안:
- Dialog가 안쪽 층 목록을 들기: primitive끼리 묶인다.
- 대상이 층 안일 때만 Escape 받기: WebKit은 클릭한 버튼에 포커스를 주지 않는다.
## 정한 기본값
- `PageHeader`는 전부터 첫 로드에도 h1에 포커스를 준다. 그대로 두었다.
- 05-02를 고치자 Chromium이 포인터 조작 전의 그 포커스를 `:focus-visible`로 보아 첫 화면 h1에 링이 보인다.
- 시각 골든 넷(앱 셸 wide, 갤러리 dark, 상태 화면, 플랫폼 구성)이 h1 자리에서만 달라져 `test:visual:update`로 다시 찍었다(diff 이미지로 확인).
- 첫 로드에 포커스를 주지 않는 쪽은 라우트 포커스 동작을 바꾸는 일이라 이 PR 밖이다.
## 위험과 영향
- 이미 생성한 기능은 바뀌지 않는다. 다운스트림은 생성 작성 페이지의 결과 불명·막기·마운트 사본을 `useAppForm({ mutation, onSaved })`와 `<FormSaveFeedback form={form} onConfirmed=… />`로 바꾼다(round9 CHANGELOG에 옮기는 법을 적는다).
- 저장 뒤 이동이 폼이 결과를 그린 뒤로 한 번 늦어진다. 다시 마운트한 폼에 보내지 않은 값이 있으면 이동이 이탈 확인을 띄운다(의도).
- `FormSaveMutation`·`FormSaveFeedback`·`holdsUnknownEffect`·`onSaved`·`notice`는 새 공개 API다(추가만).
- base.css·templates.css를 받은 제품은 자기 시각 골든도 다시 찍는다(첫 화면 h1 링).
- native `<dialog>`가 아닌 modal(`role="dialog"`만 단 것)은 Escape 층 판정이 모른다. 템플릿의 Dialog·Drawer는 `<dialog>`다.
- VD-04 결정 5의 범위(선언하지 않은 409만)는 그 기록 맨 아래 보완 절에 적었다(1103/03-01 (3)).
## 검증
desktop, CI env, `scripts/verify.sh`(flock). 묶음별 RED·GREEN과 변이는 각 브랜치에서, merge 단계는 이 PR head에서 돌렸다.
- F2a RED: 다시 마운트한 폼의 재전송 시험 둘 실패(적용 확인 하나는 대조군으로 통과). GREEN 39 passed.
- F2b
- RED: 새 동작 시험 셋 실패(저장 뒤 이동, 재전송 뒤 가드, 다시 로그인 먼저), 생성 페이지 정적 시험 실패.
- GREEN: form-foundation·create-feature·mutation admission·query bridge 144 passed.
- 변이 셋을 새 시험이 잡는다: 막기를 지움, 다른 저장 표면을 지움, 충돌 안내를 입력 오류로 되돌림.
- 게이트 002·003·005·006·008·020 rc=0(각 단계 head 트리). 첫 실행에서 드러난 기존 시험의 옛 단언(생성 페이지 문자열 셋, 필드 이름이 붙은 결과 불명 하나)과 넓은 상태 질의 하나를 고쳤다.
- F4a
- RED: component 10 실패(대조 3 통과), e2e focus ring 세 엔진 실패, storybook hover 실패.
- 자체 리뷰 보강 RED: Dialog 밖 Popover·Tooltip 둘 실패, body Escape 대조 통과.
- GREEN 16 passed. tooltip 다리 변이를 새 hover 단언이 잡는다.
- 게이트 002·003·006·009 rc=0.
- focus ring 시험은 첫 화면이 그려진 뒤 포커스를 주게 고쳤다(세 엔진 30회 반복).
- merge 단계(이 PR head `8a9bc978`, 트리 `9cf951af`, 기준 main `ee47480c`): FE-GATE-001~013·020 모두 rc=0. 로그 `/tmp/claude-gates/r9pra-merge/`.
- documentation(FE-GATE-017): rc=0.
- 알려진 desktop 간헐 실패: Firefox에서 홈 라우트 lazy 청크가 5초 넘게 「로딩 중」에 머무는 일이 이 PR이 없는 트리에서도 있다. 공유 노트에 기록했고 시험 환경 담당에 넘긴다.
## 리뷰어가 볼 곳
- `src/presentation/forms/use-app-form.ts`의 `finishSave`, `resendLeftUnknown`, `saveBlocked`, MAYBE_APPLIED 판정 순서.
- `src/presentation/forms/form-components.tsx`의 `FormSaveFeedback`.
- `scripts/create-feature-write-slice.ts`의 생성 작성 페이지.
- `src/presentation/design-system/primitives/{dialog,popover,tooltip,escape-layer,toast}.tsx|ts`.
## 관련
- 발견: `docs/reviews/2026-11-round9-01-react.md` R-01·R-02, `-04-ux-design-system.md` UX-02, `-05-accessibility.md` A11Y-02·06·09·10·11·13·14·15·17, `-10/11-prior-findings-*.md`(1106/03-01, 1101/03-04, 1103/03-01)
- 결정: `docs/work/reference/decisions.md` R9-D1
- Refs: 1112/01-01, 1112/01-02, 1112/04-02, 1112/10-01, 1106/03-01, 1101/03-04, 1103/03-01, 1105/08-02, 1105/08-04, 1106/08-02, 1112/05-02, 1112/05-06, 1112/05-09, 1112/05-10, 1112/05-11, 1112/05-13, 1112/05-14, 1112/05-15, 1112/05-17
저장 결과가 불명인 채 페이지를 떠났다 돌아오면 폼은 새로 마운트되어
보낸 값을 모른다. 그때 resendUnknown은 화면 값을 제출 값으로 썼다
(unknownSubmissionRef ?? values). 재전송이 성공하면 기본 resetOnSuccess가
사용자가 돌아와 입력한, 보낸 적 없는 값을 지우거나 깨끗한 값으로
표시했다. 재전송이 쓰기 전에 거절되어 결과 불명에 남으면 그 화면 값을
보낸 값으로 기억해, 다음 「변경됨으로 확인」이 같은 일을 했다. 같은
상황의 settleApplied는 이미 화면 값과 dirty를 그대로 둔다(1106/08-01).
그 settleApplied 분기를 지키던 시험은 참조 기능 시험과 함께 지워졌다.
고른 방법: 결과 불명 기록을 { values: Values | null }로 바꿔 "보낸 값
모름"을 따로 둔다. 재전송은 그 값만 쓰고, 값을 모르면 성공·적용 확인을
settleApplied의 재마운트 분기와 같은 처리(settleUnsentValues)로 끝낸다.
기록이 남아 있는 동안 새 저장은 그대로 막는다. 버린 대안: 화면 값을
쓰되 성공 뒤 값을 되돌리기(사용자가 친 값을 잃는다).
위험·한계: 다시 마운트한 폼에서 결과 불명이 확인되기 전까지는 폼도 새
저장을 막는다(전에도 재전송이 불명으로 남으면 막았다). 결과 불명 상태를
코디네이터와 폼이 따로 갖는 구조(1112/01-01)는 결정 대기다.
검증: tests/component/form-foundation.test.tsx의 새 describe 셋 중 둘이
고치기 전 코드에서 실패하고 고친 뒤 통과한다(desktop, PR 본문).
Refs: 1106/03-01, 1112/01-02, 1112/10-01
공통 primitive가 디자인 시스템 설계 8.1·8.2절과 WCAG 2.2 AA 약속을
어긴다.
- Popover가 이름 없는 role="dialog"를 그린다(1112/05-10).
- Dialog 안의 Menu·Popover·Tooltip에서 Escape를 누르면 Dialog까지
닫힌다. Dialog가 안쪽이 처리한 Escape를 보지 않는다(05-11).
- SearchField는 required 기호만, Checkbox는 상태만 있다(05-13).
- Toast를 닫기 버튼으로 닫으면 포커스가 body로 떨어진다(05-14).
- TextArea 글자 수가 <output>(암묵 status)이라 글자마다 발표되고 입력과
이어지지 않는다(05-17).
- 라우트 h1의 :focus outline 제거가 layer 순서로 키보드 :focus-visible
표시까지 지운다(05-02). Tooltip이 pointer-events: none과 틈 때문에
포인터를 설명 위로 옮기면 사라진다(1.4.13, 05-06).
- 홈 readiness 목록이 role 없는 div에 aria-label을 단다(05-15).
- fe-a11y·fe-ux 스킬이 제출 실패 때 오류 요약으로 포커스가 간다고 적는다.
코드는 첫 오류 필드로 보낸다(05-09).
고른 방법: Popover는 trigger id로 이름을 받는다. Popover·Tooltip은
Escape를 capture 단계에서 받아 preventDefault하고, Dialog는 기본 동작이
막힌 Escape(과 그 뒤 cancel)를 넘긴다. Tooltip은 보일 때(hover·focus)만
Escape를 가진다. 숨은 tooltip이 다른 Dialog의 Escape를 막지 않게 하려는
것이다. Toast 닫기는 다음 toast의 닫기 버튼, 없으면 toast로 들어오기 전
요소로 포커스를 돌린다. TextArea 글자 수는 aria-describedby로 잇고 0에
닿을 때만 따로 발표한다. h1은 :focus:not(:focus-visible)만 outline을
지운다. Tooltip은 보일 때만 포인터를 받고 ::before 다리로 틈을 메운다.
버린 대안: Dialog가 안쪽 layer 목록을 들고 Escape를 나누기(primitive끼리
묶인다).
위험·한계: native <dialog>가 막힌 keydown 뒤에도 cancel을 쏘는지는
브라우저마다 다를 수 있어, Dialog는 같은 task의 cancel 하나를 넘긴다.
Toast가 돌려줄 요소가 지워졌으면 포커스를 옮기지 않는다. 시각 골든이
바뀌는지는 desktop test:visual로 본다.
검증: 새 component 시험(tests/component/design-system-a11y.test.tsx,
starter-pages), e2e(app-shell focus ring, 세 엔진), storybook(tooltip
hover)의 RED·GREEN은 desktop에서 돌려 PR 본문에 적는다.
Refs: 1112/05-02, 1112/05-06, 1112/05-09, 1112/05-10, 1112/05-11,
1112/05-13, 1112/05-14, 1112/05-15, 1112/05-17
결과 불명 상태를 코디네이터(useApplicationMutation)와 폼(useAppForm)이
따로 갖고, 둘을 맞추는 규칙은 생성 작성 페이지의 사본에 있다: 결과 불명·
다른 저장 중 새 저장 막기, 「변경됨으로 확인」 뒤 settleApplied, 같은 키
재전송, 다른 저장이 도는 동안의 표시. 그래서 플랫폼에서 고친 것(1105/08-02,
1105/08-04, 1106/08-02)이 이미 생성한 기능에 들어가지 않는다(1112/01-01).
같은 구조에서 셋이 더 나온다.
- 재전송이 쓰기 전에 거절되거나(429·503) 선언한 409가 나면 "입력 내용을
확인해 주세요." 요약 아래 나온다(1112/04-02).
- 폼 밖에서 부른 같은 입력이 NOT_APPLIED로 끝나면 훅은 결과 불명인데 폼은
다시 시도를 보인다(1106/03-01 ②).
- 필드 이름이 붙은 결과 불명(VALIDATION_REJECTED + MAYBE_APPLIED)이 필드
오류와 결과 불명 화면을 함께 띄운다(1101/03-04).
고른 방법(R9-D1, 권하는 안으로 정함(2026-11-12, 총괄)): useAppForm에 선택
옵션 mutation을 더한다(추가만). 주면 폼이 saveBlocked로 새 저장을 막고
confirmUnknownEffect·resendUnknownEffect를 내주며, 입력 오류가 아닌 저장
안내를 notice로 둔다. 새 FormSaveFeedback이 결과 불명 → 저장 실패 → 충돌 →
다른 저장 순으로 피드백을 그리고, AsyncSurface의 새 notice 칸에 재전송 거절
안내를 보인다. 결과 불명을 코디네이터 상태로 먼저 보므로 ②도 같은 화면이
된다. 폼은 MAYBE_APPLIED를 입력 오류보다 먼저 본다. 생성 작성 페이지는 이
둘을 쓰고 자기 사본을 지운다. mutation을 주지 않은 폼은 전과 같다. 버린
대안: 판정 hook을 따로 두고 폼은 그대로(사본이 하나 더 생긴다).
위험·한계: 이미 생성한 기능은 바뀌지 않는다. CHANGELOG에 생성 페이지를
옮기는 방법을 적는다. 다시 마운트한 폼이 mutation 없이 쓰이면 ②는 그대로다.
VD-04 결정 5의 범위(선언하지 않은 409만)는 머리 블록에 적었다(1103/03-01 (3)).
검증: tests/component/form-foundation.test.tsx의 새 시험 넷(막기, 확인,
재전송 거절 표면, 결과 불명 우선)과 create-feature.test.ts의 생성 페이지
시험이 고치기 전 코드에서 실패하고 고친 뒤 통과한다. 생성 페이지는
FE-GATE-020 scaffold 드릴과 FE-GATE-008 e2e가 돈다(PR 본문).
Refs: 1112/01-01, 1112/04-02, 1106/03-01, 1101/03-04, 1103/03-01
앞 커밋(1112/01-01) 뒤 확인 리뷰가 완료 기준의 남은 셋과 결함 둘을 찾았다.
- 생성 작성 페이지에 마운트 표시(useRef)와 저장 뒤 이동이 남았다. 저장이
끝나면 페이지가 폼보다 먼저, 폼이 pending인 동안 상세로 옮겼다. 다시
마운트한 폼에서 재전송이 성공하면 사용자가 돌아와 입력한, 보낸 적 없는
값을 이탈 확인 없이 버렸다(1112/01-02 영향).
- 폼이 재전송 결과로 결과 불명을 다시 판정했다(resendLeftUnknown).
코디네이터와 401에서 갈린다. 코디네이터는 결과 불명을 쥐고 폼은 다시
로그인으로 가는데, FormSaveFeedback이 결과 불명을 먼저 그려 다시 로그인
안내를 가렸다(D-2 위반).
- 지난 세 결함(1105/08-02·08-04, 1106/08-02)의 시험이 생성 페이지 시험에만
있었다.
고른 방법: useAppForm에 onSaved를 더한다(추가만). 폼이 결과를 보이고
pending을 끈 뒤, 마운트된 동안만 부른다. confirmUnknownEffect(then)도
마운트된 동안만 then을 부른다. resendUnknownEffect의 then 인자와
FormSaveFeedback의 onResent는 지운다(앞 커밋에서 생겨 아직 내보낸 적이
없다). 재전송 뒤 결과 불명인지는 코디네이터의 새 holdsUnknownEffect로
묻는다. mutation 없이 쓰는 폼(이미 생성한 페이지)은 물을 곳이 없어 같은
거절 표(isRefusedOnEveryAttempt)로 본다. FormSaveFeedback은 다시 로그인
실패를 결과 불명보다 먼저 그린다. 생성 페이지는 mutation.submit을 그대로
넘기고 onSaved와 onConfirmed에서 옮기기만 한다. VD-04 머리 칸에 넣었던
문장은 보완 절로 옮긴다(머리 칸의 백틱 낱말을 문서 검사가 경로로 본다).
페이지가 FormSaveFeedback을 늘 넘기므로, 할 말이 없는 피드백 칸은 자리를
차지하지 않는다(templates.css, 빈 칸이 그리드 간격을 한 줄 더했다).
위험·한계: 저장 뒤 이동이 폼이 결과를 그린 뒤로 한 번 늦어진다. 다시
마운트한 폼에 보내지 않은 값이 있으면 이동이 이탈 확인을 띄운다(의도).
검증: form-foundation 새 시험 일곱과 create-feature 생성 페이지 시험
(RED·GREEN, 막기·다른 저장·충돌 안내 변이 셋), 생성 기능 e2e의 피드백 칸 간격 시험은 desktop에서 돌려 PR
본문에 적는다.
Refs: 1112/01-01, 1112/01-02, 1105/08-02, 1105/08-04, 1106/08-02, 1112/04-02
앞 커밋은 Popover와 보이는 Tooltip이 Escape를 document capture 단계에서
받아 기본 동작을 막게 했다(1112/05-11). 그런데 대상이 어디인지 보지 않는다.
열린 popover를 Tab으로 벗어나 키보드로 Dialog를 열거나, tooltip이 보이는
채로 Dialog가 열리면, Dialog 안의 첫 Escape를 뒤쪽 층이 먹고 Dialog는 닫히지
않는다. 고치기 전에는 둘 다 닫혔다(확인 리뷰).
고른 방법: escape-layer.ts의 escapeIsForLayer가 Escape를 누른 곳이 그 층을
품지 않은 dialog 안이면 그 Escape를 dialog 것으로 본다. 층 안, 층을 품은
dialog 안, 요소 밖(포커스가 body)에서 누른 Escape는 층의 것이다. Popover와
Tooltip이 이것을 묻는다. 버린 대안: 대상이 층 안일 때만 받기(WebKit은 클릭한
버튼에 포커스를 주지 않아 열린 popover가 Escape로 닫히지 않는다).
위험·한계: native <dialog>가 아닌 modal(role="dialog"만 단 것)은 이 판정이
모른다. 템플릿의 Dialog·Drawer는 <dialog>다.
검증: design-system-a11y.test.tsx의 새 시험 셋(Dialog 밖 Popover, Dialog 밖
Tooltip, body에서 누른 Escape)이 고치기 전 코드에서 앞 둘이 실패하고 셋째는
통과(대조)하며, 고친 뒤 모두 통과한다(desktop, PR 본문).
Refs: 1112/05-11
tooltip hover 시험의 마지막 단언은 opacity가 1인지 poll로 본다. 숨김은
100ms 동안 흐려지므로, hover를 잃은 직후에 읽으면 결함이 있어도 1이 나와
통과할 수 있다(확인 리뷰).
고른 방법: 포인터를 틈과 tooltip 위로 옮길 때마다 tooltip을 감싼 요소가
:hover인지 본다. 보이는 것은 이 hover가 정한다. opacity 단언은 그대로 둔다.
검증: tooltip의 틈 다리(::before)를 지운 변이에서 새 단언이 실패하고 원래
코드에서 통과한다(desktop, PR 본문).
Refs: 1112/05-06
app-shell의 focus ring 시험이 FE-GATE-008 전체 실행에서 WebKit만 한 번
실패했다. 「플랫폼 구성」 heading이 5초 안에 나오지 않았다(단독 실행에서는
세 엔진 모두 통과). 시험은 page.goto 직후 링크에 focus()를 주고 Enter를
누른다. 홈 라우트는 셸보다 늦게 그려지므로, 그 전에 준 포커스는 바뀐 노드와
함께 사라지고 Enter는 아무것도 하지 않는다.
고른 방법: 홈 heading이 그려진 것을 기다린 뒤 포커스를 주고, 링크가 포커스를
가졌는지 확인한 뒤 Enter를 누른다. 버린 대안: 재시도나 timeout 늘리기(원인을
덮는다).
검증: 고치기 전 시험을 WebKit에서 30번, 고친 시험을 세 엔진에서 30번씩 돌린
결과를 PR 본문에 적는다.
Refs: 1112/05-02
앞 커밋들을 FE-GATE-006으로 돌리자 form-foundation 시험 둘이 실패했다.
- 「keeps the save off after a 422 the backend may have applied」는 결과 불명
422가 필드 오류도 함께 보이기를 기대했다. 그것이 1101/03-04가 결함이라 한
동작이고 이 PR이 고쳤다(결과 불명을 입력 오류보다 먼저 본다). 시험이 결과
불명과 저장 막힘을 보고, 필드가 aria-invalid가 아님을 본다.
- 새 시험 「says a resend refused before the write in the feedback」은
findByRole("status")로 안내를 찾았는데, 시험 harness의 <output>도 status라
여럿이 걸렸다. 안내 문구를 찾고 그것을 감싼 결과 불명 status를 본다.
검증: form-foundation 전체를 desktop에서 돌린다(PR 본문).
Refs: 1101/03-04, 1112/04-02
FE-GATE-020 drill에서 create-feature.test.ts 셋이 실패했다. 생성 작성
페이지의 옛 사본(otherSaveRunning 계산, mounted ref)을 문자열로 단언한다.
이 PR에서 그 규칙은 플랫폼 폼(useAppForm `mutation`·`onSaved`,
FormSaveFeedback)으로 옮겼고 form-foundation 시험이 걷는다(1105/08-04,
1106/08-02). 생성 페이지 시험은 페이지가 폼 상태로 버튼을 끄고, 저장 뒤
이동을 onSaved·onConfirmed에 두며, 마운트 표시를 두지 않는지 본다.
다시 마운트한 폼의 막기 시험은 막기를 지운 변이에서도 통과했다. 빈 이름이라
입력 검증이 멈췄고, 이름을 넣어도 코디네이터가 따로 새 요청을 막아 네트워크
호출 수가 같았다. 유효한 이름을 넣고, 폼이 mutation에 저장을 넘기는지를 직접
센다.
검증: 막기 변이에서 그 시험이 실패하고, create-feature·form-foundation과
FE-GATE-005·020이 통과하는지 desktop에서 본다(PR 본문).
Refs: 1112/01-01, 1105/08-04, 1106/08-02
이 PR은 route heading의 outline 제거를 `:focus`에서
`:focus:not(:focus-visible)`로 좁혔다(1112/05-02). PageHeader는 전부터 첫
로드에도 heading에 포커스를 준다. Chromium은 포인터 조작 전의 프로그램
포커스를 :focus-visible로 보므로, 이제 첫 화면 heading에 포커스 링이 보인다.
그래서 FE-GATE-008의 시각 골든 넷(앱 셸 wide, 갤러리 dark, 상태 화면, 플랫폼
구성)이 heading 자리에서만 달라졌다(diff 이미지로 확인).
고른 방법: 첫 로드 포커스 동작은 그대로 두고 골든 넷을 test:visual:update로
다시 찍는다. 포커스가 있는 곳에 표시가 보이는 것이 2.4.7이 요구하는 것이고,
전에 안 보였던 것이 이 결함이었다. 버린 대안: 첫 로드에는 heading에 포커스를
주지 않기(라우트 포커스 동작이 바뀌는 일이라 이 PR 범위 밖이다).
위험·한계: base.css·templates.css를 받은 제품은 자기 시각 골든도 다시 찍어야
한다(round9 CHANGELOG에 적는다).
검증: 다시 찍은 골든으로 test:visual 7 passed(desktop). 바뀐 파일은 이 넷뿐이다.
Refs: 1112/05-02
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 수정 묶음 둘(폼 저장 규칙 F2a·F2b, 공통 primitive 접근성 F4a)을 한 PR로 낸다. runner가 하나라 PR 수를 줄인다. 커밋은 원인마다 나뉘어 있다.
폼 저장 규칙(F2a·F2b)
useApplicationMutation)와 폼(useAppForm)이 따로 갖고, 둘을 맞추는 규칙은 생성 작성 페이지의 사본에 있다(1112/01-01). 사본에 든 규칙은 이렇다.settleApplied를 부른다.NOT_APPLIED로 끝나면 훅은 결과 불명인데 폼은 다시 시도를 보인다(1106/03-01 ②).VALIDATION_REJECTED+MAYBE_APPLIED)이 필드 오류와 결과 불명 화면을 함께 띄운다(1101/03-04).공통 primitive 접근성(F4a)
고른 방법과 버린 대안
R9-D1은 권하는 안으로 정함(2026-11-12, 총괄)이다.
폼
useAppForm에 선택 옵션 둘을 더한다(추가만).mutation을 주면 폼이 막기(saveBlocked)·확인(confirmUnknownEffect)·재전송(resendUnknownEffect)을 맡는다. 재전송 뒤 결과 불명인지는 코디네이터의 새holdsUnknownEffect에게 묻는다.onSaved는 폼이 결과를 보이고 pending을 끈 뒤, 마운트된 동안만 부른다. 그래서 이동이 폼의 이탈 확인을 거친다.FormSaveFeedback이 피드백을 이 순서로 그린다: 다시 로그인 → 결과 불명(확인·재전송) → 다른 실패 → 충돌 → 다른 저장. 재전송 거절 안내는AsyncSurface의 새notice칸에 간다.MAYBE_APPLIED를 입력 오류보다 먼저 본다.{ values: null }), 화면 값과 dirty를 지킨다.mutation.submit·mutation·onSaved·FormSaveFeedback만 쓰고, 자기 사본(마운트 표시, 결과 불명 판정)을 지운다..page-template__feedback은 자리를 차지하지 않는다(:empty).isRefusedOnEveryAttempt)로 판정한다.primitive
escape-layer.ts의escapeIsForLayer는 Escape를 누른 곳이 그 층을 품지 않은<dialog>안이면 그 Escape를 dialog 몫으로 둔다. Tooltip은 보일 때만 Escape를 가진다.aria-describedby로 잇고, 0에 닿을 때만 따로 발표한다.:focus:not(:focus-visible)일 때만 outline을 지운다.::before다리로 틈을 메운다.정한 기본값
PageHeader는 전부터 첫 로드에도 h1에 포커스를 준다. 그대로 두었다.:focus-visible로 보아 첫 화면 h1에 링이 보인다.test:visual:update로 다시 찍었다(diff 이미지로 확인).위험과 영향
useAppForm({ mutation, onSaved })와<FormSaveFeedback form={form} onConfirmed=… />로 바꾼다(round9 CHANGELOG에 옮기는 법을 적는다).FormSaveMutation·FormSaveFeedback·holdsUnknownEffect·onSaved·notice는 새 공개 API다(추가만).<dialog>가 아닌 modal(role="dialog"만 단 것)은 Escape 층 판정이 모른다. 템플릿의 Dialog·Drawer는<dialog>다.검증
desktop, CI env,
scripts/verify.sh(flock). 묶음별 RED·GREEN과 변이는 각 브랜치에서, merge 단계는 이 PR head에서 돌렸다.8a9bc978, 트리9cf951af, 기준 mainee47480c): FE-GATE-001~013·020 모두 rc=0. 로그/tmp/claude-gates/r9pra-merge/.리뷰어가 볼 곳
src/presentation/forms/use-app-form.ts의finishSave,resendLeftUnknown,saveBlocked, MAYBE_APPLIED 판정 순서.src/presentation/forms/form-components.tsx의FormSaveFeedback.scripts/create-feature-write-slice.ts의 생성 작성 페이지.src/presentation/design-system/primitives/{dialog,popover,tooltip,escape-layer,toast}.tsx|ts.관련
docs/reviews/2026-11-round9-01-react.mdR-01·R-02,-04-ux-design-system.mdUX-02,-05-accessibility.mdA11Y-02·06·09·10·11·13·14·15·17,-10/11-prior-findings-*.md(1106/03-01, 1101/03-04, 1103/03-01)docs/work/reference/decisions.mdR9-D1저장 결과가 불명인 채 페이지를 떠났다 돌아오면 폼은 새로 마운트되어 보낸 값을 모른다. 그때 resendUnknown은 화면 값을 제출 값으로 썼다 (unknownSubmissionRef ?? values). 재전송이 성공하면 기본 resetOnSuccess가 사용자가 돌아와 입력한, 보낸 적 없는 값을 지우거나 깨끗한 값으로 표시했다. 재전송이 쓰기 전에 거절되어 결과 불명에 남으면 그 화면 값을 보낸 값으로 기억해, 다음 「변경됨으로 확인」이 같은 일을 했다. 같은 상황의 settleApplied는 이미 화면 값과 dirty를 그대로 둔다(1106/08-01). 그 settleApplied 분기를 지키던 시험은 참조 기능 시험과 함께 지워졌다. 고른 방법: 결과 불명 기록을 { values: Values | null }로 바꿔 "보낸 값 모름"을 따로 둔다. 재전송은 그 값만 쓰고, 값을 모르면 성공·적용 확인을 settleApplied의 재마운트 분기와 같은 처리(settleUnsentValues)로 끝낸다. 기록이 남아 있는 동안 새 저장은 그대로 막는다. 버린 대안: 화면 값을 쓰되 성공 뒤 값을 되돌리기(사용자가 친 값을 잃는다). 위험·한계: 다시 마운트한 폼에서 결과 불명이 확인되기 전까지는 폼도 새 저장을 막는다(전에도 재전송이 불명으로 남으면 막았다). 결과 불명 상태를 코디네이터와 폼이 따로 갖는 구조(1112/01-01)는 결정 대기다. 검증: tests/component/form-foundation.test.tsx의 새 describe 셋 중 둘이 고치기 전 코드에서 실패하고 고친 뒤 통과한다(desktop, PR 본문). Refs: 1106/03-01, 1112/01-02, 1112/10-01앞 커밋들을 FE-GATE-006으로 돌리자 form-foundation 시험 둘이 실패했다. - 「keeps the save off after a 422 the backend may have applied」는 결과 불명 422가 필드 오류도 함께 보이기를 기대했다. 그것이 1101/03-04가 결함이라 한 동작이고 이 PR이 고쳤다(결과 불명을 입력 오류보다 먼저 본다). 시험이 결과 불명과 저장 막힘을 보고, 필드가 aria-invalid가 아님을 본다. - 새 시험 「says a resend refused before the write in the feedback」은 findByRole("status")로 안내를 찾았는데, 시험 harness의 <output>도 status라 여럿이 걸렸다. 안내 문구를 찾고 그것을 감싼 결과 불명 status를 본다. 검증: form-foundation 전체를 desktop에서 돌린다(PR 본문). Refs: 1101/03-04, 1112/04-02