@ihabdevteam/core 0.122.0 → 0.124.0

package/CHANGELOG.md

@@ -7,6 +7,55 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.124.0
+
+### 바뀜 — 파형 세로 눈금: 소음 비율이 1 을 넘으면 칸을 넓혀 2배까지 보인다 (`TrainingStepAudioPlayer` 파형)
+
+0.123.0 까지 파형 칸 전체 = 1 이라, 소음 2배·전체 100% 면 소음 막대는 칸 끝에서 잘리고 문장 막대가
+절반(문제 소리 0.5)으로 줄었다. 말귀 사용자 지시("최대를 1로 두었을 때 2배는 영역을 더 늘려서") —
+
+- **그림은 "문장 = 기준"**: 문장 막대 크기 a = peak/문장최고치 × 전체 소리 M, 소음 막대 a = 같은 분모 × M
+  × 소음 비율 R. 소리 셈(문제 소리 = M×min(1,1/R))과 달리 문장을 줄이지 않고 소음을 R 배로 키워, 두
+  막대의 비가 곧 R 이다.
+- **구간별 눈금**(사용자 결정): a ≤ 1 은 a × 45px(지금과 같음), 1 < a ≤ 2 는 45 + (a−1) × 29px — 2배가
+  74px 에 닿는다. 74px 은 카드(120px)와 조작 줄 자리를 그대로 두고 가운데 선(y 45)에서 위아래로 쓸 수
+  있는 최대다(위 8px · 아래 조작 줄 윗변 82px). 새 파일 `waveScale.ts`(`waveBarPx`·`waveBarVal`·
+  `WAVE_H1_PX` 45·`WAVE_HMAX_PX` 74).
+- **칸 높이** `--wave-h` = 눈금 끝 max(1, R) 의 픽셀 — R ≤ 1 이면 45px 그대로, 소음이 안 보이면 늘 45px.
+  막대 셋(문장 두 겹·소음)은 칸 높이(100%) 대신 1배 높이 `--wave-h1` 을 scaleY 하므로 칸이 자라도 문장
+  막대 크기는 그대로다.
+- **전환**: 칸 높이와 막대 transform 이 막대 등장과 같은 350ms 곡선으로 옮겨 간다. 그러려고 등장
+  애니메이션 채움을 `both` → `backwards` 로 바꿨다(끝 키프레임이 --val 변화를 붙들지 않게).
+- `AudioPlayerWaveForm` prop `noiseVolume` → `noiseRatio`(R), `mainVolume` 은 문제 소리가 아니라 전체
+  소리 M. 훈련 플레이어 안에서만 쓴다(소비자 넷 호출 0).
+
+## 0.123.0
+
+### 고침 — 소음 비율이 1 을 넘으면 실제 배수가 슬라이더와 어긋났다 (`NoisePlayerContext` · 훈련 플레이어)
+
+0.120.0 셈은 문제 소리 = 전체 소리 `M`, 소음 = min(1, M × R) 이었다. M 이 50% 를 넘으면 소음이
+1 에 막혀 **전체 80% 에 2배 → 실제 1.25배**로 들렸다. "소음이 작다" 는 피드백에 1배 초과가 실제로
+들려야 한다는 말귀 사용자 판단으로 **전체 소리를 두 소리 중 큰 쪽의 크기**로 바꾼다.
+
+```
+R ≤ 1   문제 소리 = M        소음 = M × R
+R > 1   문제 소리 = M ÷ R    소음 = M
+        문제 소리 = M × min(1, 1/R)   소음 = M × min(1, R)   — 둘 다 1 이하, 배수는 늘 정확
+```
+
+- `effectiveNoiseVolume(settings)` = M × min(1, R). **새로** `effectiveSpeechVolume(settings)` =
+  M × min(1, 1/R)(R 0 이면 M).
+- 문제 소리를 내는 곳 — 훈련 플레이어 `<audio>` 볼륨, TTS 음성, 파형의 문장 막대 — 이
+  `effectiveSpeechVolume` 을 쓴다. 전체 소리·비율 어느 쪽을 바꿔도 두 소리가 함께 움직이고,
+  재생 중이면 문제 소리도 소음처럼 150ms 램프로 옮긴다(백그라운드 탭에서 RAF 가 멈춰도 200ms 에
+  끝값을 박는다).
+- **소음을 끈 판**(소음 종류 "없음")은 비율이 커도 문제 소리 = M — 들리지 않는 소음에 양보하지 않는다.
+- **옛 기록 옮김**(`noiseRatio` 없음, 옛 뜻 = 문제 소리 `mainVolume`·소음 `level/9`): R =
+  (level/9)÷mainVolume(0~2, 0.1 반올림)은 그대로, **R > 1 이면 mainVolume = level/9** 로 함께 박는다
+  (`mergeNoiseSettings`). 예: level 9·mainVolume 0.5 → R 2·M 1 = 소음 1·문제 0.5, 옛날 그대로.
+  두 볼륨 함수도 `noiseRatio` 없는 설정을 같은 규칙으로 읽는다.
+- 설정 창 모양·사전은 그대로.
+
 ## 0.122.0
 
 ### 고침 — 훈련 설정 창 위 안쪽 여백 0 (`NoiseSettingsTooltip`)