@ihabdevteam/core 0.128.0 → 0.131.0

package/CHANGELOG.md

@@ -7,6 +7,106 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.131.0
+
+0.130.0 에서 "정해야 할 것" 으로 남겼던 넷을 정한 판이다. 공개 prop·타입은 걷지 않았다.
+
+### 더함
+
+- **BottomNav `NavItem.badgeCount`**: 단추 우상단 원형 숫자 배지(SideNav 배지와 같은 모양, 99 에서 자름). 0/없음이면 숨긴다.
+  배지는 낭독기에서 숨기고 개수를 단추 이름에 붙인다 — `"숙제, 3개"`(사전 열쇠 `nav.badgeLabel`).
+  넘쳐 "…" 메뉴로 간 항목은 메뉴 항목에 배지가 서고, "…" 단추에는 넘친 항목 개수의 합이 선다.
+- **Header 모바일**: `items[].badge` 를 하단 내비의 `badgeCount` 로 넘긴다 — 데스크톱 SideNav 에만 보이던 숙제 배지가 모바일에도 보인다.
+  **단추 이름이 `"숙제"` → `"숙제, N개"` 로 바뀌므로 `getByRole('button', { name: '숙제' })` 로 찾던 시험은 이름을 고친다.**
+
+### 바뀜
+
+- **PassCardBg `variant`**: default(흰 바탕 + main·sub 원) · blue(짙은 main 바탕 + 흰 반투명 원) · dark(부드러운 검정 바탕 + main·sub 원)가
+  실제로 다르게 그려진다 — 스타일이 없어 셋이 빈 바탕으로 같았다. 기존 토큰만 쓴다. 글자 색은 정하지 않으니 blue·dark 에서는
+  PassCard 의 `textColor`·`subColor`·`copyrightColor` 를 넘긴다.
+- **`TOPIC_TYPES`**: 문장 훈련 주제 7개의 `desc` 를 걷었다 — 훈련 유형(`TRAINING_TYPES`)의 설명을 복사해 넣어 모두 같은 문구였다. `desc` 를 읽던 화면은 `undefined` 를 받는다(네 소비자 모두 주제 `desc` 를 읽지 않음).
+
+### 놀이터
+
+- 긴 코드 예(20줄 넘음 → 앞 12줄)와 props 표(12행 넘음 → 앞 8행)를 접는다. "전체 보기" 로 펴고, ⌘/Ctrl+F·인쇄 때는 페이지의 접힘을 모두 편다.
+
+## 0.130.0
+
+놀이터 문서를 소스와 한 줄씩 맞추다 드러난 결함을 고친 판이다. 공개 prop·타입은 하나도 걷지 않았다
+(안 쓰이던 것은 `@deprecated`). 항목마다 시험을 붙이고, 고친 줄을 되돌리면 시험이 붉어지는 것을 확인했다.
+
+### 더함 — 훈련 소리 모델·파형 눈금을 배럴에서 내보낸다
+
+`@ihabdevteam/core/components`(와 뿌리)에서 `noiseRatioOf` · `effectiveSpeechVolume` · `effectiveNoiseVolume` ·
+`noiseElementVolume` · `mergeNoiseSettings` · `DEFAULT_NOISE_SETTINGS` · `NOISE_RATIO_MAX` · `NOISE_RATIO_STEP` ·
+`LEVEL_MAX` · `levelToPct` · `pctToLevel` · `NoisePlayerContext` · `useNoisePlayer`(+ `NoisePlayerContextValue` 타입),
+`waveBarPx` · `waveBarVal` · `WAVE_H1_PX` · `WAVE_HMAX_PX` · `WAVE_A_MAX`. 앱이 딥 경로
+(`components/Training/NoisePlayerContext`)로 가져가던 것들이다 — 딥 경로도 그대로 된다.
+
+### 바뀜 — 앱에서 보이는 동작
+
+- **Toggle**: `role="switch"` — 낭독기가 켬/끔으로 읽는다. **`getByRole('checkbox')` 로 Toggle 을 찾던 시험은 `'switch'` 로.**
+- **useWordTrainingFilter**: `contrastCount` 가 고른 훈련 음소 칸 수(파생값)다 — 올라가기만 하던 결함이라 예전에 저장된 높은 값은 무시한다.
+  설정 팝업에서 취소하면 품사·어종도 되돌아가고, `groupKey` 를 바꿔도 '글자 입력'(direct) 보기가 유지된다.
+- **WordSearchResultBlock**: 검색어를 가진 채 처음 그려질 때도 기본 정렬이 '시작 우선'이다.
+- **음소 탈락·대립 문제**: 오답에 정답과 발음이 같은 모음(ㅔ/ㅐ, ㅖ/ㅒ, ㅚ/ㅞ/ㅙ)이 나오지 않는다.
+- **PanelRow variant="button"**: `onClick` 이 한 번만 불린다(단추와 행 양쪽에 걸려 두 번이었다). 행 전체는 더 이상 단추가 아니다 — 꺼진 단추인데 행을 누르면 불리던 것도 막힌다.
+- **Header 모바일 하단 내비**: 비활성 항목이 눌리지 않고 href 항목은 새 창으로 열린다(항목을 캐스팅만 하던 것). `malgwiItems`·`managerItems` 는 `@deprecated`.
+- **ListPopup**: `countLabel` 함수 꼴이 반영된다. `keepOpenOnSelect` 는 `@deprecated`(원래 효과가 없었다 — 팝업은 골라도 닫히지 않는다).
+- **TextField**: 자동완성 후보를 Enter 로 고르면 `onEnter` 도, 폼 제출도 일어나지 않는다. readOnly 칸이 Tab 으로 닿는다.
+- **IconGridMenu**: 고른 단추가 `disabled` 대신 `aria-pressed` — 키보드로 닿고 포커스 표시가 보인다. `selected={null}` 로 선택을 풀 수 있다.
+- **TrainingStepConfirmWithText**: 고른 답의 강조가 곧바로 풀리던 것을 고쳤다(문장이 바뀔 때만 풀린다).
+- **WordTable**: 편집 모드에서도 구어체 발음이 보인다.
+- **Tooltip**: `onClose` 없는 툴팁이 Esc·바깥 누름 뒤 흐려진 채 남지 않는다. 앵커 없이 제자리에 그린 툴팁은 document 의 Esc·바깥 누름·Tab 되감기를 듣지 않는다.
+- **usePasswordChange**: 변경 콜백이 거절해도 로딩이 풀리고 오류 문구가 보인다.
+- **Avatar**: 이미지가 실패한 뒤 `src` 를 바꾸면 다시 이미지를 그린다. **PromoBanner**: `titleColor`·`descriptionColor` 를 거두면 배경 색으로 돌아간다.
+- **Icon**: SVG 마스크 모드가 실제로 그려진다(규칙이 없어 빈 자리였다 — 글자색, `size` 반영). **EffectPartyPopper**: `duration` 이 조각 수명에 반영되고, 스코프 CSS 안에서도 브랜드색을 읽는다.
+- **useDeviceManagement**: 방향이 '좌'·'우' 가 아닌 폼은 무시한다(던졌다). **useFontScale**: 범위 밖 저장값을 조인다. **useWordMeanings**: 조회 거절이 처리되지 않은 거절로 새지 않는다.
+- **copyText**: 복사 뒤 원래 포커스로 돌아간다. **setAssetBaseUrl**: CJS 묶음이 여럿이어도 공유된다(globalThis).
+- **TOPIC_TYPES**: '한국 전통음식' 앞 공백, '건강상식' 오타.
+
+### 더함 — 선택 prop·반환값
+
+- `Section.headingLevel`(1~6 — 제목을 h1~h6 로, 낭독기 제목 목록에 나온다. 권장) · `RadioGroup.ariaLabel` · `ColorPicker.ariaLabel`
+- `WordDataUpdatePopup.onClose` — 오류인데 `onRetry` 가 없으면 "닫기" 단추(닫을 길이 없었다)
+- `useVisitAllPanel` 반환 `vapPageSizeOptions`(번역 — 상수 `VAP_PAGE_SIZE_OPTIONS` 는 그대로) · `formatDuration(…, durationStr?)`
+- `PaymentPlanData.group` 타입 · `AudioMeter` 가 `aria-valuenow`·`min`·`max`·`valuetext` 를 단다(글자 갱신 주기)
+- `Badge`: dot 에 icon 이 없으면 체크를 그린다, bar 가 `aria-label` 을 받는다. `LandingHeader` 서랍 id 가 `useId`(한 화면에 둘이어도 안 겹침)
+- `BulkBar`: 숨은 막대가 `inert`·`aria-hidden` 이라 Tab·낭독기에서 빠진다
+- 개발 경고: `FilterPanel` allOption 절에 값 '전체' 보기가 있으면(구별 안 됨), `WordTableBlock` 표시 모드에서 `onAddItem` 을 `showCellCount` 없이 주면(추가 칸이 안 생김)
+
+### 번역 — 박혀 있던 한국어 기본 문구가 사전을 탄다(ko 값은 지금 문구와 같다)
+
+BulkBar '선택 해제' · DatePicker 안내·연월 · Badge 이름 · Loader(`loader.loading` — ko 사전 '불러오는 중…', 전에는 'Loading') ·
+WordTableButton 배지 · TrainingResultPopup '(내용없음)' · DebugResultLauncher 라벨 · usePasswordChange 안내 ·
+getErrorMessage 기본값 · formatDuration. 사전 열쇠 18개 더함, 부르는 곳이 없어진 `training.contrast.diffPhonemeCount` 걷음.
+
+### 폼 안에서 제출되던 단추
+
+NoticeBox 닫기 · EmptyState 행동 · ErrorState 다시 시도 · Calendar 달 넘김 · DebugResultLauncher 에 `type="button"`.
+
+### JSDoc 을 동작대로
+
+Popup large 1080px · ConfirmPopup 기본 480px · Table loading 머리 유지 · ReportDocument 다시 재는 때 · Loader label ·
+PassCard bg 기본값(`startDate`·`queueIndex` @deprecated) · TrainingBlock(`count` @deprecated, selectedIds·size 치수) ·
+koreanSyllable 포함 매칭 · mergeQuestionText·soundOf 예 · computeDailySelection 의 어제 세트 · lucide "지연 로드" ·
+Pagination·ProgressIndicator·DebugTooltip 첫 문단의 앱 이름·사연 · `ScenarioPage.steps` 타입 `ScenarioStep[] | ReactNode[]` ·
+`CreateTTSResolverOptions.pitch` @deprecated · NoticeBox `notices[].variant` @deprecated.
+
+## 0.129.0
+
+### 바뀜 — 태블릿(768–1023px)의 **h3 를 데스크톱과 같은 20px / 30px** 로
+
+태블릿 블록이 h3 를 18px / 28px 로 줄이고 있었다. 사용자 결정으로 데스크톱과
+맞춘다 — 태블릿 블록에서 h3 두 줄을 걷어 루트 값을 물려받게 했다.
+모바일(≤767px)의 17px / 26px 은 그대로다.
+
+실측(놀이터, `.h3` · `.h3b`): 900px 20/30 · 1400px 20/30 · 500px 17/26.
+태블릿의 제목 사다리는 그대로 선다 — h2 22 > h3 20 > h4 16.
+
+줄이 **없어서** 맞는 꼴이라, 다른 제목들을 맞추다 한 줄을 되살리면 조용히
+되돌아간다. `test/tabletH3Size.test.ts` 가 그 자리를 막는다.
+
 ## 0.128.0
 
 ### 더해짐 — `Popup` 의 **어두운 바탕을 누르면 닫힌다** (기본값)