@ihabdevteam/core 0.149.0 → 0.151.0

package/CHANGELOG.md

@@ -7,6 +7,66 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.151.0
+
+**결정 판** — 그동안 "결정 필요" 로 남겨 둔 항목을 사용자 지시(2026-09-15 "결정이 필요한 것 모두 진행해")로 정해 구현했다.
+동작 계약이 바뀌는 것이 많아 **소비자에게 먼저** 를 꼭 읽는다.
+
+### 소비자에게 먼저 — 계약이 바뀜
+
+- **`saveTable` 은 `SavedWordTable | null`, `updateSavedTable` 은 `boolean`**: 브라우저 저장소가 차거나 거부하면 실패를 알린다(전에는 성공처럼 반환). `duplicateTable` 도 실패 시 null.
+- **`escapeCsvField`**: 수식 시작(= + - @ 탭 CR) 앞에 탭 대신 작은따옴표 `'`.
+- **`useTTSPlayback`**: speechSynthesis 가 없으면 `onDone(false)`(전에는 true) — 듣기 플레이어가 "이 기기에서는 음성을 들려줄 수 없습니다." 를 띄우고 흐름은 다음으로 간다. 문장 배열은 차례로 모두 말한다.
+- **`useWaveReady().waitForReady`** 는 `Promise<boolean>` — 화면을 떠나면 `false`.
+- **소음 설정 저장**: 판 중 변경은 멈춘 뒤 300ms 에 마지막 값만(떠날 때·pagehide·탭 숨김엔 즉시). 옛 기록(noiseRatio 없음)은 반올림 없이 0.1–2 로만 조임(0 은 0).
+- **trainingMissStats**: 같은 answeredAt 이면 `id`(숫자 크기·글 사전순)가 큰 쪽이 최근, id 가 없으면 배열 뒤쪽이 최근.
+- **Dropdown·Rating·Tabs** 는 값이 바뀔 때만 onChange(SegmentedControl 은 다시 누름도 부름). Rating 조작 모드는 소수 value 를 반올림.
+- **시간대 없는 시각 글자**('2026-09-30T20:00:00')는 KST 벽시계 시각으로 읽는다(toKstYmd·formatYmd·toKstHm·formatDate*·normalizeDate·formatRelativeTime).
+- **정렬**: 빈 값은 오름·내림 모두 맨 뒤(ListPopup·DeviceSideTable·`useTableSort().sortRows`). 칸순은 전화번호 꼴을 숫자 글자로 견준다. Table expandedId 는 String 비교.
+- **Alert** role: danger·warning 은 alert, info·success 는 status(`live` prop 으로 덮어씀).
+- **오늘의 훈련**: 유형별 시드·이웃한 날 겹침 방지 — **배포 날 오늘 세트가 한 번 바뀐다.**
+- **단어훈련 문제**: 음소 바꾸기 질문이 바뀌는 음소를 말함 · 한 음절 포함 타깃이 고른 음소를 가진 음절 · 음소 합치기에서 소리 없는 초성 ㅇ 제외 · 1음절 조각 둘은 합성어 아님 · 런타임 '음소 구조 같은' 이 대립쌍 표와 같은 활음 정의.
+- **WordSearchResultBlock**: searchQuery·resultCount 없이 items 만 주면 받은 순서가 기본. 대립쌍 등급순은 두 낱말 중 낮은 등급.
+- **복습표·동형어**: `SavedWordTable.reviewOf?·reviewRound?`, `reviewMeta`, `cellKey`·`labelOfCellKey`, `WeakItem.key?`.
+- **TrainingPagePopup `onComplete`** 인자에 `attempt`·`previousAttempts`(다시하기 전 판들). 결과 계산 중에는 완료가 막힌다(`TrainingResultPopup pending`).
+- **폭죽**: `EffectPartyPopperHost` 가 `party:trigger` 를 듣는다 — Host 를 붙인 앱은 결과 창 폭죽이 실제로 나기 시작한다.
+- **층(z-index)**: 페이지 < BulkBar(`--z-bulk-bar`) < 메뉴(`--z-menu`) < 창 < 툴팁 < 알림 < 토스트. UpdateAlert 가 둘이면 비켜 쌓인다.
+
+### 더함
+
+- Calendar·DatePicker `today` · PassCard `endInclusive`(종료일 당일 포함) · ConfirmPopup `initialFocus` · Accordion 항목 `id` · Breadcrumb `href`·`target`·`rel` · Button `ariaExpanded`·`ariaControls`·forwardRef ·
+  useTableSort `onSortChange` · 속성 필터 코드 도구(`toWordAttributeFilterCodes`·`wordAttributeFilterFromCodes`·`normalizeWordAttributeFilter`, config `attributeCodes`) · `TrainingCompleteResult` 타입.
+
+### 바뀜 (접근성·터치·움직임·인쇄)
+
+- 초점: 초점 중 막힌 단추는 aria-disabled 로 초점 유지 · BulkBar·Alert·NoticeBox·UpdateAlert 가 사라질 때 초점을 바깥으로 · 훈련 설정·문장 미리보기 창에 초점을 넣고 돌려줌(aria-expanded) · LoadTablePopup 삭제 뒤 다음 카드.
+- 낭독기: Button 툴팁 문구를 설명으로 · SegmentedControl 개수를 이름에 · Toast 첫 문구 · indeterminate 진행에 aria-valuenow 없음 · ProgressIndicator announce 모든 variant · 삭제 단추 이름에 표 이름.
+- 터치: 툴팁 톡 토글 · hover 로만 보이던 단추를 (hover: none) 에서 보임 · SideNav 는 (hover: hover) 에서만 :hover 판정 · PassCard·Rating 톡 뒤 상태 되돌림 · TopBanner 터치 멈춤.
+- 움직임 줄이기: Popup·Tooltip·TrainingPagePopup 닫기 대기 0 · TopBanner 자동 넘김 없음 · 멈춘 진행 막대·천천히 도는 스피너. TopBanner 는 :focus-visible 일 때만 멈춤, 장 수가 줄면 범위 안으로.
+- 겹창: TextField 후보 목록 body 포털 · DatePicker 창 안으로 조임 · 메뉴가 회전·크기 변경에 다시 잼.
+- 인쇄·내려받기: BOM 한 번 · Blob 주소 1초 뒤 회수 · 인쇄 전 글꼴 최대 1초 대기 · 빈 파일명 기본값. `printWordTable()` 은 @deprecated.
+- 보안: 메뉴 window.open 은 http(s)·상대·mailto·tel 만 · 인라인 SVG 의 <style>·바깥 url() 제거.
+- 자료 방어: `words` 없는 표 항목 · 착용일 null · ReportDocument 내용 높이 바뀌면 다시 잼·큰 group 은 앞 장부터 채움 · 월 보기 합계는 그 달 날짜만 · 한글 조합 중 후보 목록 유지 · 막대 수 다시 잼 · 탭 복귀 뒤 소음 다시 켬 · '모두 듣기' 중 카드 누르면 멈춤 · 서버 렌더는 기본 언어로 시작.
+- 작은 계약: RingChart hideCenter 명시 존중 · BarChart barWidth 2px 하한 · NoticeBox notices 닫기 · Icon 이미지 size · PhonemeSelectBlock showInfoButton 기본 true 로 바로잡음 · Board 빈 문구 i18n · ErrorState·EmptyState 다시 시도 중복 방지 · SummaryStrip title · ShortcutBadge static 배율 · FileUpload 던져도 같은 파일 다시 고름 · 단어 카드 재생도 스피커 자물쇠.
+
+### 정한 채 두는 것 (바꾸지 않음)
+
+- Popup `animateThen(cb)` 은 떠난 뒤에도 cb 를 부름 · ConfirmPopup 은 확인으로 닫혀도 onClose(JSDoc 을 동작에 맞춤) · TextField 카운터 UTF-16(네이티브와 같게) · POS_LABEL 등 한국어 상수 공개 유지 · 복습·복사 이름 꼬리 한국어 · check.svg → lucide 매핑 · CSV 선행 0 · 종이에 글자 크기 안 옮김.
+
+### 아직 사용자 결정·다른 곳 일
+
+- 요금제: light_* 레거시(개인 라이트)·homework 표 모순·TIER_RANK — 요금제 의미.
+- Table 표 구조(aria-sort) · 말귀 DB user_settings GRANT 범위 · 모바일 훈련 시간 한 줄(서버 세션 id) · 단어표 드래그 순서의 키보드·터치 대안 · 칩 한 번 46–212ms 성능.
+
+## 0.150.0
+
+### 소비자에게 먼저
+
+- **`useRelativeDay`**: 숙제 "오늘 / 어제 / N일 전" 을 24시간 단위가 아니라 **KST 달력날** 로 센다(사용자 결정 2026-09-15). 어제 23시(KST)에 온 숙제는 오늘 01시에
+  "어제"(전에는 "오늘"). 기기 시간대와 무관하고, 앞날은 전처럼 "오늘".
+- **듣기 플레이어(TrainingStepAudioPlayer)**: 녹음 파일 없이 브라우저 음성 합성으로 말하는 중(TTS 리졸버 없음·실패) 멈춤 단추가 소리 없는 `<audio>` 를 재생하려 들고
+  말은 멈추지 않았다 — 이제 합성기를 멈추고 잇는다.
+
 ## 0.149.0
 
 18차 검수 판이다 — 관리 훅(방문·예정)과 훈련 흐름(파형) 검수에서 재현된 것을 고쳤다.