@ihabdevteam/core 0.136.0 → 0.138.0

package/CHANGELOG.md

@@ -7,6 +7,104 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.138.0
+
+7차 검수 판이다 — 가로지르는 검수 셋(마운트 뒤 props 변경·비동기 경합·키보드와 낭독기)에서 **재현된** 결함을 고쳤다. 항목마다
+시험을 붙이고 고친 줄을 되돌리면 붉어지는 것을 확인했다. 걷은 prop·타입·열쇠는 없다. 더한 공개 API 도 없다.
+
+### 소비자에게 먼저
+
+- **useEditableList**(useVisitHistory·useVisitSchedule): 편집 중 들어온 목록을 **편집을 취소하면** 받는다(전에는 끝내 안 받음).
+  커밋(`commitEdit`)으로 끝나면 방금 편집을 옛 목록으로 덮지 않는다.
+- **TrainingStepAudioPlayer**: 대기 중이던 재생을 멈춤·정지로 끊으면 다시 시도하지 않는다. 큰 '듣기' 를 초점으로 누르면 초점이
+  '재생 / 멈춤' 으로 간다.
+- **Button**: 막혔다 풀릴 때 키보드로 잡은 초점은 놓지 않는다(마우스로 잡힌 초점만 푼다).
+- **MenuTooltip**: 하위 메뉴의 목록을 매 렌더 지금의 `columns` 에서 꺼낸다 — 부모가 바꾼 선택 표시가 하위 메뉴에도 보인다.
+
+### 바뀜 — 훈련
+
+- **TrainingStepAudioPlayer**: 버퍼링 중 멈춤·정지하면 AbortError 재시도로 **정지했는데 소리가 다시 났다**. 트랙 이동이 파형을
+  기다리는 중 정지·✓ 를 눌러도 기다림 뒤 재생했다. 늦게 resume 되면 떠난 플레이어의 미터를 다시 등록했다(useNoiseFade 도).
+- **TrainingWordCard**: 합성 폴백 주소를 기다리는 사이 다른 카드를 누르면 늦게 온 주소로 두 소리가 겹쳤고, 같은 카드를 두 번
+  누르면 두 번 울렸다. 같은 낱말에 발음이 새로 오거나 동음이의어 번호가 바뀌어도 앞면이 앞 값이었다.
+- **TrainingPagePopup**: 결과 계산이 비동기일 때 다시하기 뒤 늦게 온 결과가 새 판에 결과 창을 띄우거나 2회차 결과를 덮었다.
+- **TrainingStepConfirmWithText·TrainingStepConfirm·TrainingStepCard**: 보기만 바뀐 문항·같은 문장의 다음 쪽·같은 카드 묶음의 다음 쪽
+  에서 앞 선택이 남았다. `demoSelected` 변경을 안 따랐다.
+- **TrainingStepTextBox·TrainingBlock**: '문장 미리보기'·마지막 '더보기' 를 누르면 초점이 body 로 떨어졌다.
+- **TrainingCardGroup**: 접기 단추에 `aria-expanded`.
+
+### 바뀜 — 그 밖
+
+- **WordTable 칸**: 같은 칸의 낱말이 바뀐 뒤 새 소리 주소를 받는 동안 누르면 앞 낱말 소리가 났다.
+- **usePasswordChange**: 처리 중 다시 누르면 변경이 두 번 나가 성공 뒤 늦은 오류 문구가 남았다.
+- **buildPairIndex**: 빌드 중 `clearPairIndexCache()` 뒤 늦게 끝난 옛 빌드가 캐시를 되살리거나 새 인덱스를 덮었다.
+- **LoadTablePopup**: 고른 표가 목록에서 빠져도 '불러오기' 가 켜진 채였다.
+- **Table 접기 머리**: `headerActions` 안 단추에서 Enter/Space 를 누르면 표가 접혔다.
+- **PassCard**: 메뉴를 여는 카드에 `aria-haspopup`·`aria-expanded`. **PhonemeSelectBlock**: 좁은 화면 '유의사항' 단추에 이름.
+
+### 고치지 않은 것 — 결정·확인이 필요하다
+
+- 훈련 창 안 '훈련 설정'·'문장 미리보기' 떠 있는 창이 판 밖이라 키보드·낭독기로 닿지 못한다 — 판 안에 그릴지, 초점을 넣고 가둠
+  예외를 둘지.
+- 초점 중인 단추가 막히는 자리(Pagination 끝 쪽·순서 목록 위로·BarChart 넘김·선택 초기화·글자 크기 끝값), BulkBar 가 비며 inert,
+  Alert·NoticeBox·UpdateAlert 닫기 뒤 초점 자리, 여닫이 단추의 `aria-pressed` → `aria-expanded`.
+- 결과 계산 중 완료를 누르면 total null 완료 기록 / 소음 설정 저장 순서 / '모두 듣기' 중 사용자가 카드를 누를 때.
+- ReportDocument 는 블록 구성이 같으면 content 가 바뀌어도 쪽을 다시 안 잰다(문서화된 동작).
+- 앞 판에 적은 결정은 그대로.
+
+## 0.137.0
+
+6차 검수 판이다 — 이번에는 가로지르는 검수 넷(서버 렌더 안전·StrictMode 부작용·언마운트 뒤 남는 것·영어 화면의 한국어)과
+훅·기본 컴포넌트 2차 검수에서 **재현된** 결함을 고쳤다. 항목마다 시험을 붙이고 고친 줄을 되돌리면 붉어지는 것을 확인했다.
+말귀 훈련 계획 창이 덮어쓰던 규칙을 prop 으로 더 가져왔다. 걷은 prop·타입·열쇠는 없다. 사전 열쇠를 더했다
+(`wordTable.info.*`·`wordTable.pos.*`·`common.networkError`·`training.audioStatus.*`·`device.type.*`·`header.menuClose`).
+
+### 소비자에게 먼저
+
+- **Popup `height`**: 인라인 `height` 대신 CSS 변수 `--popup-height` + `.popup-panel--has-height` 로 건다 — 앱의
+  `.x .popup-panel { height }` 미디어 규칙이 이긴다. 패널 `style.height` 를 읽는 시험은 `style.getPropertyValue('--popup-height')` 로.
+- **useMediaQuery**(React 18+): 서버 렌더 HTML 을 붙일 때 첫 렌더는 `false`(서버와 같게), 붙인 뒤 곧바로 실제 값. 서버 렌더가
+  아닌 첫 렌더는 전과 같이 실제 값이다. React 16/17 은 예전 그대로.
+- **'use client'**: 훅을 쓰는 모듈 30곳에 지시문을 달았다(Icon·PageTitle·Breadcrumb·ProgressIndicator·DescriptionTooltip·
+  TrainingCardGroup·PassCardBg*·PromoBannerBg*·usePagedList·useTrainingTypeLabels·useVisitHistory). 빠뜨림을 잡는 시험을 둔다.
+- **영어 화면**: 훈련 블록 유형·카테고리, 팝업 아이콘 툴팁, 낱말 정보 툴팁, 네트워크 오류 안내(`toUserErrorMessage` —
+  `NETWORK_ERROR_MESSAGE` 상수는 그대로), 오디오 불러오기 상태, 기기 종류 배지, LandingHeader 기본 메뉴 이름이 사전을 거친다.
+  한국어 화면의 글자는 그대로다.
+- **Pagination** `totalPages=0`: `"1 / 1"`(전에는 `"1 / 0"`).
+- **Icon**: `label` 이 요소면 `img alt=""`(전에는 `"[object Object]"`).
+
+### 더함 (말귀 요청)
+
+- **Popup `fillBody`**: 본문은 굴리지 않고 안쪽이 세로 flex·높이 100% — 안의 한 칸만 굴린다.
+- **Panel `scrollbarGutter`**: `'auto'`(기본) | `'stable'`.
+- **Panel `compactRows`**: 행 최소 높이 46px·위아래 3px — `size="small"` 행 하나짜리 패널이 테두리까지 48px.
+
+### 바뀜 — 훈련
+
+- **TrainingStepOrderList**: `context` 를 안 주면 렌더가 끝없이 돌았다(CPU 100%). 끌기 첫 프레임 전에 끝내거나 떠나면 rAF 루프가
+  영영 돌았다. StrictMode 에서 처음 배치 알림이 두 번(첫 알림은 화면에 안 뜬 배치).
+- **useNoiseFade**(StrictMode·`<Activity>`): 소음 요소를 다시 만들면 파일이 안 물려, 소음이 켜진 채 마운트된 단계에서 소음이 안 났다.
+- **TrainingWordCard·TrainingStepCard**: 음성 합성으로 듣는 중·합성 주소를 기다리는 중·'모두 듣기' 중에 떠나면 소리가 계속 났다 —
+  떠날 때 제가 쥔 소리만 끊는다.
+- **TrainingStepAudioPlayer**: 불러오는 중 떠나면 늦게 온 소리로 blob 주소를 남기고 떼어진 `<audio>` 를 불러왔다.
+- **useTTSPlayback**: 마운트만 한 단계가 떠날 때 다른 곳의 음성 합성을 끊었다.
+- **TrainingResultPopup** 폭죽 신호 · **EffectPartyPopper** 움직임 줄이기 `onComplete`: StrictMode 에서 두 번.
+- **useWordTrainingDataGeneration**: `types` 가 늦게 오면 끝까지 안 만들었고, 언어를 바꿔도 단추 제목이 옛 언어였다.
+
+### 바뀜 — 훅·기본 컴포넌트
+
+- **useFontScale**: `storageKey` 가 바뀌면 앞 값으로 새 열쇠의 저장값을 덮었다. 저장소를 못 읽으면 범위를 안 조였다.
+- **Icon·useIcon**: 다른 SVG 로 바꾸는 동안 앞 아이콘이 그려졌다. 그림 파일 경로를 lucide 이름으로 찾아 개발 경고를 냈다.
+- **TextField**: 서버 렌더(React 18)에서 `useLayoutEffect` 경고.
+
+### 고치지 않은 것 — 결정·확인이 필요하다
+
+- i18n 이 불러오는 순간 저장된 언어로 시작해, 서버 렌더 앱에서 저장 언어가 en 이면 hydration 이 어긋난다(말귀 SPA 에는 장점).
+- Calendar·BarChart·useRelativeDay 가 렌더 중 '지금' 을 읽는다 — 서버·브라우저 날짜가 다르면 어긋난다.
+- `/images/brand/check.svg` 같은 파일 경로가 lucide `check` 로 그려진다. PanelRowDevice·HearingDeviceInfo 좌·우 단추 이름이 같다.
+- `reviewTableName` "N차 복습"·`duplicateTable` "(복사)" 가 저장 이름에 한국어로 붙는다. 한국어 원본 상수(POS_LABEL 등)를 계속 공개할지.
+- 앞 판에 적은 결정(저장 실패 반환·오프셋 없는 시각·Board 빈 문구·Rating 조작 소수·ConfirmPopup 거절)은 그대로.
+
 ## 0.136.0
 
 5차 검수 판이다 — 이번에는 아직 깊이 안 본 곳(context·i18n·유틸, 입력·표시 컴포넌트, 팝업·툴팁·단어표 도구, 훈련 단계)을