@ihabdevteam/core 0.374.0 → 0.375.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,51 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.375.0 — 표의 칸이 **합성 폴백**을 탄다
11
+
12
+ ### 색인에 없는 낱말도 울린다
13
+
14
+ 말귀 청 (326), 2026-10-28. 표의 칸은 `getTTSUrlResolver()` **하나만** 불렀고, 빈 글자가
15
+ 오면 `if (!audioUrl) return` 으로 조용히 돌아섰다 — 누르면 아무 일도 안 나고 네트워크도
16
+ 0건이었다.
17
+
18
+ 활용형('불러요' · '부릅니다' …)은 사전에 없는 글자라 음원 색인에 없다. 활용표는 **모든
19
+ 칸이 그 꼴**이라 머리 칸 하나만 들리고 나머지 열둘이 전부 먹통이었다(말귀 실측: 머리 칸만
20
+ `data-audio-src` 가 차 있고 열두 꼴이 모두 `''`).
21
+
22
+ 메우는 자리는 `configureTTS` 의 `fallbackUrlResolver` 다 — `TrainingWordCard` 가 이미
23
+ 쓰고 있고 앱이 런타임 합성을 붙여 두는 그 길이다. 코어에 길은 있었는데 `WordTable` 만
24
+ 그것을 안 봤다.
25
+
26
+ #### 미리 부르지 않는다 — **누른 칸 하나만** 간다
27
+
28
+ 그 리졸버는 음원이 없으면 **그 자리에서 합성한다**(말귀 실측 3,567ms). 칸마다 미리
29
+ 부르면 검색 결과의 낱말 수만큼 합성이 나간다. 그래서 미리 받아 두는 것은 지금까지대로
30
+ `urlResolver` 뿐이고, 폴백은 **누른 뒤에** 부른다.
31
+
32
+ 말귀가 *"`urlResolver` 쪽에서 폴백으로 떨어뜨리지는 말아 달라"* 고 함께 적어 주었다 —
33
+ 그 리졸버는 `checkAudioExists`('음성 있음' 거르개)도 쓰므로, 거기서 떨어뜨리면 **거르개가
34
+ 도는 것만으로** 합성이 나간다. 맞는 가름이라 그대로 따랐다.
35
+
36
+ #### 기다리는 동안에도 자물쇠를 쥔다
37
+
38
+ 합성을 기다리는 3.5초 사이에 옆 칸을 누르거나 화면이 닫히는 일이 있다. 소리 자물쇠
39
+ (`claimSound`)를 **받기 전에** 잡고, 맡기는 멈춤 함수 하나가 두 때를 다 맡는다 — 아직
40
+ 기다리는 중이면 기다림을 접고, 이미 틀고 있으면 그것을 멈춘다. 소리가 생긴 뒤에 자물쇠를
41
+ 다시 잡으면 **다시 잡는 그 순간 제 손으로 저를 멈춘다**(`claimSound` 가 앞 주인을 멈추는데,
42
+ 그 앞 주인이 저 자신이다).
43
+
44
+ #### 받은 주소는 들고 있는다
45
+
46
+ 두 번째 누름이 3.5초를 다시 기다리지 않는다. `data-audio-src` 도 함께 차므로 인쇄 문서의
47
+ 재생 단추가 **한 번 들어 본 칸만큼은** 살아난다.
48
+
49
+ #### 안 한 것 하나
50
+
51
+ 정식 음원 주소가 **있는데 재생이 실패하는** 때(404 등)는 그대로 두었다.
52
+ `TrainingWordCard` 는 그때도 폴백으로 가는데, 표의 칸까지 그렇게 하면 서버가 흔들리는
53
+ 동안 칸마다 합성이 나간다. 말귀가 잰 것은 빈 글자 쪽이고, 그 반쪽만 고쳤다.
54
+
10
55
  ## 0.374.0 — `WordTableBlock` 이 **머리 칸을 넘긴다**
11
56
 
12
57
  ### `baseItem` · `baseContentTypes` 가 블록을 지나 안쪽 표까지 간다