@ihabdevteam/core 0.373.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,88 @@ 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
+
55
+ ## 0.374.0 — `WordTableBlock` 이 **머리 칸을 넘긴다**
56
+
57
+ ### `baseItem` · `baseContentTypes` 가 블록을 지나 안쪽 표까지 간다
58
+
59
+ 말귀 청 (325), 2026-10-28. `WordTable` 은 0.372.0 부터 **절반을 쓰는 머리 칸**을 받는데
60
+ 그 위의 `WordTableBlock` 은 그 둘을 안 받고 안 넘겼다.
61
+
62
+ #### 막혀 있던 것은 프롭 둘이 아니라 **블록 전체**였다
63
+
64
+ 활용표는 머리 칸이 꼭 있어야 해서 **`WordTable` 을 바로 그렸다.** 그러면 블록이 들고 있는
65
+ 것을 전부 잃어, 앱이 셋을 손으로 베껴 두게 된다 —
66
+
67
+ | 베낀 것 | 블록에 있는 그것 |
68
+ |---|---|
69
+ | 표 설정 판 | `filterTitle` · `filterCollapsible` · `filterCollapsed` |
70
+ | 저장 줄(이름 · 설명) | 블록이 그린다 |
71
+ | 쪽 나눔 · 인쇄 | `chunkItems` → 쪽마다 표 + `useWordTablePrint` |
72
+
73
+ **베낀 것은 베낀 날의 코어에 멈춰 있어 한쪽만 고쳐진다.** 실제로 말귀가 표 설정을
74
+ 맞추려다 `useWordTableDisplaySettings` 로 판만 겨우 같게 했고, 저장 줄과 인쇄는 두 벌로
75
+ 남아 있었다. 프롭 둘을 넘기는 것으로 그 셋이 앱에서 걷힌다.
76
+
77
+ #### 넘기는 것뿐이지만 결정이 하나 있다 — **쪽마다 머리 칸**
78
+
79
+ 쪽이 나뉘면 머리 칸을 쪽마다 그린다. 한 장만 뽑아 들었을 때 머리 낱말이 없으면
80
+ **나머지 칸이 무엇의 활용인지 알 수 없다.** 저장 창의 미리보기도 머리 칸을 함께 그린다 —
81
+ 미리보기가 실제 표와 달라 보이면 안 된다.
82
+
83
+ #### 편집 모드에 주면 알려 준다
84
+
85
+ 머리 칸은 표시 모드에서만 선다(편집 격자는 칸을 번호로 세므로 걸친 칸이 들어오면 활성
86
+ 칸·추가 자리가 어긋난다). 편집 모드에 주면 아무 데서도 안 터지고 **그냥 안 보이므로**,
87
+ 개발 모드에서 한 번 경고한다.
88
+
89
+ 놀이터 `WordTableBlock` 쪽에 `'감사하다'` 활용표 보기를 두었다 — 페이지당 4 로 나뉘어
90
+ 두 쪽 모두에 머리 칸이 선다.
91
+
10
92
  ## 0.373.0 — 칸 상한을 **12 로 되돌린다** · 칸 밑 **이름표**
11
93
 
12
94
  ### 칸 상한을 16 → **12 로 되돌린다**, 페이지당 개수에 **6**