@ihabdevteam/core 0.123.0 → 0.125.0

package/CHANGELOG.md

@@ -7,6 +7,54 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.125.0
+
+### 고침 — 소음 비율 1~2배를 올려도 소음이 커지지 않았다: 키운 소음 파일로 푼다 (`NoisePlayerContext` · `configureStorage`)
+
+0.123.0 셈(문제 소리 = M×min(1,1/R), 소음 = M×min(1,R))은 비율을 1 넘게 올리면 소음은 1 에 머물고
+문제 소리만 줄었다(말귀 사용자 "소음 크기가 커지지 않는다"). `<audio>` 볼륨은 1 을 넘을 수 없으므로
+**원본보다 큰 소음 파일**을 쓰고, 파일이 몇 배 큰지를 코어에 알린다.
+
+```
+문제 소리           = M                      (비율과 상관없이 줄이지 않는다)
+소음 들리는 크기    = M × R        (0~2)     원본 소음 파일 기준
+소음 <audio> 볼륨   = min(1, M × R ÷ gain)   gain = noiseFileGain
+```
+
+- **새 설정** `configureStorage({ noiseFileGain })`(`CoreScope` 의 `storage.noiseFileGain` 도) — `noiseBaseUrl`
+  의 파일이 원본보다 몇 배 큰지(진폭), 기본 1. 없거나 0·음수·NaN 이면 1. `getNoiseFileGain()` 내보냄.
+  말귀는 2배로 키운 파일 경로와 `noiseFileGain: 2` 를 함께 준다. 기본 1 인 앱은 1배 넘는 소음만 1 에서
+  멈춘다.
+- `effectiveSpeechVolume(settings)` = mainVolume. `effectiveNoiseVolume(settings)` = mainVolume × R —
+  **들리는 크기, 0~2**(1 을 넘을 수 있다 — 결과 기록·파형용). **새로** `noiseElementVolume(settings, gain?)` =
+  min(1, effectiveNoiseVolume ÷ gain) — 소음 페이드·TTS 동기 재생이 이것을 `<audio>` 에 건다.
+- `mergeNoiseSettings` 옛 값 옮김은 R = (level/9)÷mainVolume 만 — 0.123.0 의 "R>1 이면 mainVolume =
+  level/9" 를 걷었다(옛 뜻도 문제 소리 = mainVolume 이라 옛 소리 그대로다).
+- 소음을 끈 판에서 문제 소리를 양보하지 않던 0.123.0 규칙은 문제 소리가 늘 M 이라 필요 없어 걷었다.
+- 파형(0.124.0 구간별 눈금)·설정 창은 그대로.
+
+## 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` · 훈련 플레이어)