@ihabdevteam/core 0.135.0 → 0.137.0

package/CHANGELOG.md

@@ -7,6 +7,134 @@ 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·유틸, 입력·표시 컴포넌트, 팝업·툴팁·단어표 도구, 훈련 단계)을
+훑어 **재현된** 결함만 고쳤다. 항목마다 시험을 붙이고 고친 줄을 되돌리면 붉어지는 것을 확인했다. 말귀가 앱에서 덮어쓰던
+규칙을 코어 prop 으로 가져왔다. 걷은 prop·타입·열쇠는 없다. 사전 열쇠 `training.selectInOrder` 를 더했다.
+
+### 소비자에게 먼저
+
+- **칸순**(ListPopup 정렬): 글자 안의 숫자도 수로 견준다 — `'회차 9'` 가 `'회차 10'` 앞에 선다(전에는 뒤). 숫자 칸과
+  숫자로 시작하는 글자 칸이 섞이면 차례가 돌아(`'9'<'10'`·`'10'<'10분'`·`'10분'<'9'`) 들어온 차례에 따라 결과가 달랐다.
+- **ProgressBar** `max=0`: 라벨 `"0 / 0"`·`aria-valuemax=0`(전에는 `"0 / 1"`).
+- **ProgressIndicator** `announce`: 알림 자리 안에 눈에 안 보이는 글자로 단계를 적고 aria-label 은 달지 않는다.
+- **StatChart** 누르는 카드 이름에 증감이 붙는다(`"오늘 방문 7 +3"`).
+- **formatDuration**: 초로 반올림한다(`90.5` → `"1분 31초"`, 0.5초 미만은 `'-'`).
+- **tableTrends**: 매긴 칸이 하나도 없는 기록은 흐름에서 뺀다(모두 비면 그 표는 결과에 없다).
+- **날짜 형식 함수**(`formatDateKo`·`formatDateLongKo`·`formatDatetimeKo`·`formatDateLocale`·`formatDateLongLocale`): 못 읽는 값이면
+  `"Invalid Date"` 대신 빈 글자.
+- **IconGridMenu** 제어 모드: prop 을 그대로 그린다 — 누르면 onSelect 만 부르고, 부모가 값을 안 바꾸면 화면도 그대로다.
+
+### 더함 (말귀 요청)
+
+- **Popup `layer`**: `'modal'`(기본) | `'belowPagePopup'` — 훈련 페이지 팝업 바로 아래 층(`--z-page-popup` - 1).
+- **Popup `size`**: `'xlarge'`(1320px, 폭 화면 - 80px) · `'fit'`(내용 폭, 최소 min(480px, 화면-40px)·최대 min(1140px, 화면-40px)).
+- **TrainingBlockButton `size="row"`**: 전체 너비 가로 행 [아이콘][유형·제목][문항수], 미리 듣기 없음 — 좁은 화면 목록용.
+- **Button `tooltipOnly`**: 툴팁만 보여 주는 칩 — 커서만 기본 화살표(모양·포커스·툴팁 그대로, `disabled` 와 다름).
+
+### 바뀜 — 입력·표시
+
+- **Checkbox**: `indeterminate` 가 누르는 순간 풀려(브라우저가 DOM 속성을 끔) prop 이 그대로 true 여도 빈 칸으로 남았다.
+- **IconGridMenu**: 비제어에서 카테고리가 늦게 오면 첫 항목이 안 골라졌고, StrictMode 에서 첫 알림이 두 번.
+- **SplashLogo**: `onDone` 이 나중에 들어오면 타이머가 끝내 안 걸려 스플래시가 남았다.
+- **Rating**: 소수 값이 모두 반 별로 그려져 4.1 과 4.9 가 같았다 — 값만큼 채운다.
+- **CodeBox**: `language` 가 'sh' 를 품기만 해도(csharp) 셸로 읽었다.
+- **Alert**: `message=""` 면 children 이 가려 빈 칸.
+- **useCalendarMonth**: 한 핸들러에서 `prevMonth` 를 두 번 부르면 (2026, -1).
+- **Toast**: 마우스·포커스로 멈춘 채 문구가 바뀌면 읽는 알림이 손 밑에서 사라졌다.
+- **SideNav**: `appMode` 를 안 주면 여기만 매니저로 봐 Header·BottomNav 와 반대 방향 전환 단추를 띄웠다.
+- **ListPopup**: 고른 행 표시가 열 className(맞춤·폭)을 덮었다.
+- **Button**: `onDisabledClick` 을 준 막힌 단추에 `aria-disabled` 가 안 붙었다.
+
+### 바뀜 — 훈련
+
+- **useSoundCompassExam**: 수가 같은 다른 배치로 바꾸면 다시 시작하지 않아 무엇을 골라도 오답이었다. 한 대기에서 고르기가
+  두 번 불리면 점수 +2.
+- **TrainingStepCard**: 따로 쓴 단계에서 '모두 듣기' 가 소리 없이 끝났다.
+- **TrainingStepCardOrder**: StrictMode 에서 onChange·onDone 두 번, 풀 때 onChange 없음, 낱말에 '|' 가 있으면 못 끝냄, 기본
+  제목 한국어 고정.
+- **TrainingStepTitle**: 키보드로 누른 '모두 듣기' 가 재생 중 막히며 초점이 body 로 빠졌다.
+- **TrainingStepTextBox**: 펼쳐 둔 상자에서 다음 문제로 넘어가면 한 틱 동안 새 문장(정답)이 드러났다.
+- **TrainingPagePopupTitle**: title 이 비고 depth 가 없으면 subtitle 이 두 줄.
+- **TrainingTooltip**: 영어에서도 훈련 유형 머리글이 한국어.
+- **summarizeMisses**: A→B→A 로 풀면 복습이 가장 최근 세트 대신 옛 세트로 짜였다.
+- **WordTablePopup `autoPrint`**: StrictMode·100ms 안 인쇄 설정 변경에서 한 번도 안 떴다.
+- **EffectPartyPopper**: 첫 틀이 조각 지연보다 이르면 한 조각도 안 나고 곧바로 끝났다.
+
+### 바뀜 — 단어표·팝업·유틸
+
+- **LoadTablePopup**: 저장소의 표 하나가 `savedAt`·`words` 가 없으면 팝업 전체가 렌더 중에 터졌다. 영어에서도 "N개".
+- **WordTableButton**: 카드 안 '더보기'·게시자 단추에서 Enter/Space 가 카드를 열었다.
+- **WordTableBlock·useWordTableDisplaySettings**: 페이지당 개수 '전체' 를 고른 뒤 항목이 늘면 선택지에 없는 값이 남았다.
+- **printWordTableElements**: iframe 인쇄 뒤 탭 제목이 표 이름으로 남을 수 있었고, 다음 인쇄가 그것을 원래 제목으로 잡았다.
+- **checkAudioExists**: 서버 오류(5xx)를 '음성 없음' 으로 영구 캐시했다. 비운 뒤 늦게 실패한 옛 요청이 새 확인을 지웠다.
+- **speak·stopSpeaking**: 목소리 목록이 비었을 때 부른 말이 줄을 서고 멈추지 않았고, 목록이 끝내 안 오면 onEnd 가 안 불렸다.
+- **I18nProvider**: `locale="en-US"` 이면 한국어로 떨어지고 context 는 `'en-US'` 로 남았다.
+
+### 고치지 않은 것 — 결정·확인이 필요하다
+
+- `saveTable`·`updateSavedTable`·`duplicateTable` 은 저장소 쓰기가 실패해도 성공처럼 돌려준다 — 반환 타입을 바꿔야 한다.
+- 오프셋 없는 시각 문자열(`normalizeDate`·`formatYmd`)이 기기 시간대를 따른다.
+- `reviewTableName`: '수업 3차' 의 첫 복습과 '수업' 의 3차 복습이 같은 이름이다(이름만으로는 가를 수 없다).
+- `weakItems`: 동형어가 저장 labels 에 번호가 없어 합쳐진다.
+- Board 의 빈 목록 기본 문구가 한국어 고정(서버 렌더 호환이라 hook 을 안 쓴다).
+- Rating 조작 모드에 소수 `value` 를 주면 화살표가 3.5 를 낸다.
+- ConfirmPopup: onConfirm 거절이 처리되지 않은 거절로 올라간다(삼키면 오류 추적에서 사라진다).
+
 ## 0.135.0
 
 3차·4차 검수 판이다 — 훈련 단계 UI·차트·리포트·팝업·방문 훅을 훑어 **재현된** 결함만 고쳤다. 항목마다 시험을 붙이고 고친 줄을