@ihabdevteam/core 0.136.0 → 0.137.0

package/CHANGELOG.md

@@ -7,6 +7,59 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 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·유틸, 입력·표시 컴포넌트, 팝업·툴팁·단어표 도구, 훈련 단계)을