Task #2374: [양식] 양식 컨트롤 값 변경을 record+역연산으로 기록 — 스냅샷 undo 무언 파괴 차단

[lpaiu-cs]

요약

양식 컨트롤 값 변경(체크박스·라디오·콤보·편집 필드)이 히스토리를 우회해, undo 불가에 더해 이후 스냅샷 undo 가 값 변경을 무언 파괴하던(#2337 계급) 계급 1 미라우팅을 수정합니다. 양식 모드에서는 snapshot 이 게이트에서 드롭되므로, #2337 이 연 kind:'record' + 경량 역연산 경로로 기록합니다 — 로드맵 #2369 Track 2 본체.

Fixes #2374

변경

• SetFormValueCommand (경량 역연산, 배치): targets {locator(본문/셀), beforeJson, afterJson} — execute=after 순방향, undo=before 역순. 라디오의 그룹 해제+선택 다중 쓰기를 1 엔트리로 원자화(개별 기록 시 undo 가 해제만 복원하는 반쪽 상태).
• recordFormValueChanges 헬퍼: before==after 필터(이미 선택된 라디오 재클릭 등 유령 엔트리 방지 — Task #2337: [undo] 머리말/꼬리말·각주 편집 히스토리 기록 — 본문 스냅샷 undo의 무언 데이터 손실 차단 #2338 FN 교훈) 후 executeOperation({kind:'record'}).
• 4곳 배선(이전 값을 뮤테이션 전에 캡처): 체크박스(formHit.value) · 라디오(getFormObjectInfo 그룹 값) · 콤보(currentText) · 편집 필드(formHit.text, Enter→blur 이중 커밋 1회 가드).

검증

• npx tsc --noEmit, npm test 358/358(신규 소스 가드 3 — 역연산 구조·record+no-op 필터·4곳 배선 핀).
• 브라우저(samples/form-01.hwp, 실제 handleFormObjectClick 경로) 게이트 6종:
  1. 체크박스 토글 → undoLen+1 → undo/redo 왕복.
  2. 양식 모드에서 record 기록(snapshot 드롭 모드의 핵심 경로).
  3. 라디오 기록 + 재클릭 no-op 0 엔트리 + undo.
  4. 편집 필드 홍길동 커밋 — Enter+blur 이중 발화에도 정확히 1 엔트리, undo 원복.
  5. 손실 게이트: page:hide(스냅샷) → 체크박스 토글 → undo 1회가 체크박스만 원복하고 hide 보존(수정 전엔 스냅샷 복원이 양식 값을 무언 파괴) → 2회째 hide 원복.
  6. 콤보 계절 선택→봄 기록·undo.
• 콘솔 에러 0.

범위 외

• 누름틀 삽입(insert:field) — 일반 모드 전용(양식 모드 차단)이라 별도 snapshot 건. active-field 얽힘 포함 Track 2 후속.
• PushButton(웹 비활성), 콤보 항목 없음 시 Edit 폴백(편집 필드 커밋으로 커버).

---

(a′) 이관 로드맵 #2369 의 Track 2(form 값·누름틀)에 속합니다.

[edwardkim]

결합 트리(＋#2378) tsc/362 전건 통과, 신규 가드 red→green 재현(devel src 원복 시 3건 FAIL). 라디오 원자화·no-op 필터·이중 커밋 가드 확인.

[edwardkim]

머지되었습니다. 결합 트리(#2378 동시)에서 tsc·npm test 362/362, 신규 소스 가드 red→green 재현(devel src 원복 시 FAIL 확인)으로 검증했습니다. 양식 모드에서 snapshot 드롭 조건의 유일 기록 경로를 record+역연산으로 연 설계와, 라디오 다중 쓰기 원자화·before==after 유령 엔트리 필터 같은 #2338 교훈의 일관 적용이 좋았습니다. 손실 게이트(스냅샷 undo 의 양식 값 무언 파괴 차단) 실측이 검토의 핵심 증거였습니다. 감사합니다. @lpaiu-cs