@ihabdevteam/core 0.124.0 → 0.125.0

package/CHANGELOG.md

@@ -7,6 +7,32 @@ 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` 파형)