@ihabdevteam/core 0.379.0 → 0.382.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.
Files changed (27) hide show
  1. package/CHANGELOG.md +189 -0
  2. package/dist/components.cjs.js +172 -172
  3. package/dist/components.esm.css +1 -1
  4. package/dist/hooks.cjs.js +3 -3
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core.cjs.js +177 -177
  7. package/dist/ihabdevteam-core.d.ts +20 -3
  8. package/dist/packages/core/src/components/Word/TableFilterPanel.d.ts +2 -0
  9. package/dist/packages/core/src/components/Word/TableFilterPanel.js +2 -2
  10. package/dist/packages/core/src/components/Word/WordTableBlock.d.ts +1 -1
  11. package/dist/packages/core/src/components/Word/WordTableBlock.js +43 -9
  12. package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts +15 -0
  13. package/dist/packages/core/src/components/Word/wordTableSettings.d.ts +23 -5
  14. package/dist/packages/core/src/components/Word/wordTableSettings.js +29 -7
  15. package/dist/packages/core/src/components/WordTable.css +48 -13
  16. package/dist/packages/core/src/components/WordTable.js +50 -7
  17. package/dist/packages/core/src/components/wordTableLayout.d.ts +1 -1
  18. package/dist/packages/core/src/i18n/locales/en.json +1 -0
  19. package/dist/packages/core/src/i18n/locales/ko.json +1 -0
  20. package/dist/packages/core/src/utils/headProbeStatus.d.ts +21 -0
  21. package/dist/packages/core/src/utils/headProbeStatus.js +23 -0
  22. package/dist/packages/core/src/utils/imageConfig.js +3 -2
  23. package/dist/packages/core/src/utils/ttsConfig.js +3 -2
  24. package/dist/packages/core/src/version.d.ts +1 -1
  25. package/dist/packages/core/src/version.js +1 -1
  26. package/dist/utils.cjs.js +160 -160
  27. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,195 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.382.0 — 말귀 청 (335)·(336)·(337)
11
+
12
+ 세 가지가 **같은 한 줄**에서 나왔다 — 사장님 *"x 버튼으로 제거를 눌렀는데 그 뒤에 있는
13
+ 버튼들이 재 정렬 되면서 전부 다시 로드하나보네?"*. ✕ 한 번에 HEAD 가 스물아홉에서
14
+ 마흔셋까지 나갔다(말귀 실측 2026-10-28).
15
+
16
+ ### (335) 칸의 열쇠를 **`item.id` 로** — 가운데를 빼도 뒤 칸이 다시 서지 않는다
17
+
18
+ 칸을 **자리 번호**로 묶고 있었다. 그러면 셋째 칸을 뺄 때 그 뒤 칸이 **전부 다른 `item` 을
19
+ 받는다** — 칸은 그대로 선 채로 속만 바뀌니 `WordCell` 의 `useEffect([pron, label])` 이
20
+ 그때마다 소리 주소를 다시 받아 온다. 서른네 칸짜리 표에서 둘째를 빼자 HEAD 가 **열다섯 번**
21
+ 나갔다(전부 이미 받아 둔 파일).
22
+
23
+ **그냥 `id` 로 바꿀 수는 없었다.** `id` 가 겹치는 표에서는 React 가 그 칸들을 **하나로
24
+ 본다** — 2026-10-27 에 활용표가 그랬다(`감사하다#1` 이 네 칸에 섰다). 말귀는 그 뒤
25
+ `감사하다#1::과거` 꼴로 겹침을 풀었지만, **코어는 부르는 쪽이 그랬다고 믿을 수 없다.**
26
+
27
+ 그래서 **센다** — `id` 가 표 안에서 하나뿐일 때만 그것으로 묶고, 겹치거나 빈 `id` 가 하나라도
28
+ 있으면 표 통째로 번호로 돌아가며 개발 모드에서 말한다(`devWarnOnce`). 부르는 쪽이 `id` 를
29
+ 고치면 경고가 사라지고 값도 함께 사라진다.
30
+
31
+ 번호에 `id` 를 **덧붙이지는 않는다**. 그러면 겹침은 풀리지만 자리바꿈에서 두 칸이 **다시
32
+ 태어난다** — 끌어 옮기는 동안 칸마다 `ResizeObserver` 가 뜯겼다 붙고 배율이 처음부터
33
+ 다시 선다(2026-10-27 실측).
34
+
35
+ 격자 자리·채점 열쇠·손가락 밑의 칸은 **그대로 번호**다. 그것들은 자리를 묻는 것이고,
36
+ 열쇠는 정체를 묻는 것이다.
37
+
38
+ ### (336) **400 을 "없다" 로 담는다** — 같은 글자를 또 묻지 않는다
39
+
40
+ 저장소가 *없는 파일* 에 404 가 아니라 **400** 을 준다. 그림·음원 확인은 2xx 와 404·410 만
41
+ 담았으니 400 은 그 어느 쪽도 아니라 캐시에 **영영 안 들어갔고**, 표가 다시 그려질 때마다
42
+ 같은 글자를 또 물었다 — 스물한 칸짜리 표에서 ✕ 한 번에 HEAD 가 **스물한 번** 나갔다.
43
+ 400 은 *답을 받은 것*이지 망이 끊긴 것이 아니다.
44
+
45
+ 어느 상태가 '없음' 인지를 **한 자리**(`isDefiniteAbsence`)로 모아, 그림과 음원이 같은 것을
46
+ 본다. 401·403·5xx·망 끊김·타임아웃은 **그대로 안 담는다** — 한 번의 장애가 그 낱말을 세션
47
+ 내내 '없음' 으로 못 박으면 '그림 있음'·'음성 있음' 거르개에서 통째로 빠진다.
48
+
49
+ **대가도 적어 둔다**: 리졸버가 설정이 덜 선 때에 엉뚱한 주소를 지어 내면 그 400 까지 담긴다.
50
+ 그 낱말은 `clearImageExistenceCache`·`clearAudioExistsCache` 로 비울 때까지 '없음' 이다.
51
+
52
+ ### (337) 쪽은 **쓸 자리가 닿는 곳까지만** 센다
53
+
54
+ 규칙 한 줄: **한 쪽은 항목을 쥐었거나, 다음에 들어갈 첫 빈자리를 쥐었을 때 선다.** 그 뒤는
55
+ 안 선다.
56
+
57
+ 전에는 **자리 수**로 셌다(`올림(cellCapacity / 쪽당)`). 빈 칸만 남은 쪽도 서야 거기
58
+ '추가하기' 가 닿는다고 보았는데(청 (327)), 자리 수를 부르는 쪽이 못 박아 넘기면 **아무것도
59
+ 없는 쪽이 여럿** 선다 — 자리 36 · 항목 27 · 쪽당 6 이면 다섯째 쪽에 셋과 빈 칸 셋이 서고
60
+ **여섯째 쪽은 통째로 빈 종이**다.
61
+
62
+ 위 규칙은 둘을 다 지킨다. 첫 빈자리를 쥔 쪽까지는 서니 꽉 찬 표에도 더할 길이 남고(청 (327)
63
+ 의 자리 10 · 항목 8 · 쪽당 4 도 셋째 쪽이 그대로 선다), 그 **뒤**는 더할 자리가 없으므로
64
+ 안 선다.
65
+
66
+ **쪽이 딱 나누어떨어질 때는 빈 쪽 하나가 남는다** — 항목 24 · 자리 36 · 쪽당 12 면 첫
67
+ 빈자리가 셋째 쪽 머리다. 그 한 장까지 없애려면 부르는 쪽이 **자리 수를 항목 수에 맞춰**
68
+ 주면 된다(말귀는 `올림(항목/12) × 12` 로 이미 그렇게 쥔다 — 항목 24 면 자리도 24 라 두 쪽).
69
+ 여기서 더 줄이면 더할 자리가 사라진다.
70
+
71
+ ### 이 판이 **0.381.0 까지 같이** 싣는다
72
+
73
+ 0.381.0 은 npm 에 닿지 못했다(올리는 자리가 막혀 있었다). 그 판의 (333)·(334) 는 아래 글
74
+ 그대로 이 판에 들어 있다.
75
+
76
+ ## 0.381.0 — 말귀 청 (333)·(334)
77
+
78
+ ### (333) `maxItemsPerPage` — **칸 수와 한 쪽에 서는 수는 다른 것**이다
79
+
80
+ 사장님 지시(2026-10-28) — *"단어 수 최대와 페이지당 단어 수 최대가 **다른거야**"* ·
81
+ *"단어는 20개더라도 페이지당 표현은 12로 선택할 수 있도록 해야지"*.
82
+
83
+ 활용표의 칸 수는 **낱말이 정한다**(동사 36 · 형용사 21). 종이 한 장에 열둘보다 많으면
84
+ 글자가 작아져 못 읽는다. 그런데 고르개의 첫 칸이 늘 칸 수라 스무 칸짜리 표에서는
85
+ `20개 · 8개 · 6개 …` 가 서고 **12를 고를 자리가 아예 없었다**(처음 값으로 12를 주면 돌기는
86
+ 도는데 목록에 없어 **아무것도 안 켜진 채**였다).
87
+
88
+ `maxItemsPerPage` 는 **칸을 줄이지 않는다** — `cellCapacity` 와 다른 수다. 스무 칸에 12를
89
+ 주면 칸은 스물 그대로고 쪽이 둘로 나뉜다.
90
+
91
+ #### 빠뜨리면 안 되던 한 가지 — **첫 칸이 '전부' 가 아니다**
92
+
93
+ 첫 칸은 지금까지 *한 쪽에 전부* 라는 뜻이라 `Infinity` 로 기억됐다. 천장이 생기면 그 뜻이
94
+ 뒤집힌다: 스무 칸에서 `12개` 는 전부가 아니라 **두 쪽**이다. 묻는 것을 *"첫 칸인가"* 에서
95
+ **"칸 수에 닿는가"** 로 바꿨다.
96
+
97
+ > **처음엔 그 물음을 천장에 걸었다가 틀렸다.** 천장을 주면 첫 칸이 곧 천장이라 `n >= 천장`
98
+ > 이 늘 참이 되어 **고른 수가 전부로 담겼다.** 그 자리에서는 `effectiveItemsPerPage` 가
99
+ > 천장으로 조여 **같은 두 쪽**이 나오므로 눈에 안 띈다 — 갈리는 자리는 **천장이 없어질 때**다.
100
+ > 그 꼴을 세는 못을 따로 세우고서야 잡혔다.
101
+
102
+ ### (334) '구성' 에 **`유형`** 칩 — 이름표를 끌 수 있다
103
+
104
+ 사장님 지시 — *"유형을 추가해서 끄면 (두루높임) -아/어요 라고 단어 위에 있는 것들을 끌 수
105
+ 있도록 해야 해"*.
106
+
107
+ 이름표(`captionBadge`·`captionLabel`)만 '구성' 고르개에 없어 **주면 늘 섰다.** 종이로 뽑아
108
+ 쓰는 자리라 **무엇을 숨기느냐가 그대로 과제가 된다** — 끄면 *이 꼴이 무엇인지 맞혀 보라*,
109
+ 켜면 *이 꼴은 이것이다* 다. 지금은 뒤쪽 하나만 만들 수 있었다.
110
+
111
+ `WordTableContentType` 에 `'caption'` 을 더하고 `유형` 칩을 `단어` 뒤에 세웠다. 이름표를
112
+ 쥔 칸이 하나도 없으면 회색으로 선다(머리 칸도 센다 — 활용표는 머리 칸만 쥐는 일이 있다).
113
+
114
+ > **블록의 처음 고름에 `caption` 을 넣었다.** `showOf` 는 빈 배열일 때만 다 켜므로, 안
115
+ > 넣으면 이 판이 들어오는 날 **지금까지 서던 이름표가 통째로 사라진다.**
116
+ >
117
+ > `WordTable` 을 바로 그리며 `contentTypes` 를 적어 넘기는 곳은 **`'caption'` 을 넣어야
118
+ > 이름표가 선다** — 그것이 이 기능이다.
119
+
120
+ ## 0.380.0 — 칸의 커서 · 빈 칸의 **+ 단추** · 손 단추의 **들여쓰기**
121
+
122
+ ### 손 단추의 들여쓰기가 **칸 폭을 따른다**
123
+
124
+ 사장님 지시 *"작아졌을때 패딩 20이 너무 커 보여 기준점 잡아서 패딩 낮춰줘"*.
125
+
126
+ 네 자리가 `20px` 을 못 박고 있었다(왼쪽 기둥 · 오른쪽 기둥 · 홀로 선 빼기 · 홀로 선
127
+ 손잡이). 종이 좌표의 20px 이라 표가 줄어도 **칸 안에서 차지하는 몫은 그대로**였다.
128
+
129
+ **기준점은 네 칸짜리 표다** — 거기서 칸이 503px 이고 20px 이 그 폭의 **4%** 다. 그 비를
130
+ 그대로 쓰면 큰 칸은 지금과 똑같고 작은 칸만 줄어든다. `clamp(6px, 4cqw, 20px)` —
131
+ 칸을 질의 컨테이너로 두고 제 폭의 4% 를 쓴다.
132
+
133
+ 브라우저 실측(종이 좌표, `들여쓰기 + 단추 40` 이 칸 폭에서 차지하는 몫) —
134
+
135
+ | 칸 수 | 칸 폭 | 들여쓰기 | 전 | 후 |
136
+ |---|---|---|---|---|
137
+ | 4 | 503 | **20**(그대로) | 11.9% | 11.9% |
138
+ | 4 | 678 | **20**(천장) | 8.8% | 8.8% |
139
+ | 8 | 251 | **10** | 23.9% | 19.9% |
140
+ | 16 | 169 | **6.7** | 35.6% | 27.7% |
141
+ | 18 | 167 | **6.7** | 35.9% | 28% |
142
+
143
+ 바닥 6px 은 더 내려가면 단추가 모서리에 붙어 잘린 것처럼 보여서고, 천장 20px 은 큰 칸이
144
+ 지금보다 더 벌어지지 않게 하려는 것이다.
145
+
146
+ > **남은 몫은 단추 자신이다** — 열여섯 칸에서 단추 40px 만으로 칸 폭의 23.7% 다.
147
+ > 들여쓰기를 0 으로 해도 거기까지만 준다. 그쪽은 `buttonSize` 가 쥔다.
148
+
149
+
150
+ 사장님 지시 셋(2026-10-28).
151
+
152
+ ### 칸 전체가 **손 모양**이던 것
153
+
154
+ *"wordcell 에 전체가 이동 기능으로 되어서 마우스 포인트가 아닌 손 모양이 나오니까 좀
155
+ 불편한데"*. `.word-table__card--draggable` 이 `cursor: grab` 이었다 — 칸은 읽는 자리인데
156
+ 손 모양이 칸 전체를 덮어 글을 읽는 내내 *잡으라*고 말했다.
157
+
158
+ **끌어 옮기는 일은 그대로 된다** — 칸 아무 데나 잡아 끌 수 있다. 다만 커서로 그것을 말하지
159
+ 않는다. 끌 수 있다는 것은 마우스를 얹을 때 뜨는 **손잡이**가 말하고, `grab`·`grabbing` 은
160
+ 그쪽으로 옮겼다.
161
+
162
+ `auto` 가 아니라 `default` 인 것은 글자 위에서 I 빔으로 바뀌지 않게 하려는 것이다 — 칸을
163
+ 가로지를 때 커서가 깜빡이면 그것대로 거슬린다.
164
+
165
+ ### 빈 칸의 '추가하기' 가 **점 단추**가 됐다
166
+
167
+ *"Button dot size 40 베리언트 디폴트로"*. 전에는 `추가하기` 글자를 단 가로 단추였는데,
168
+ 빈 칸이 열둘인 활용표에서는 같은 글자가 **열두 번** 서서 칸보다 글자가 먼저 읽혔다.
169
+
170
+ 글자가 빠졌으니 이름은 `ariaLabel` 이 든다 — 낭독기에는 그대로 '추가하기' 고, 마우스를
171
+ 얹으면 같은 글이 뜬다.
172
+
173
+ **편집 격자의 `+` 도 같은 꼴로 맞췄다.** 한쪽만 글자를 달면 같은 표를 만들다 보는 사이에
174
+ 단추가 바뀐다.
175
+
176
+ > **글자로 단추를 집던 시험이 하나 있었다.** 그날 아무것도 못 찾고 *"단추가 없다"* 로
177
+ > 빨개졌다 — 이름으로 집도록 고쳤다. 말귀도 같은 날 같은 꼴을 하나 걷었다(아이콘으로
178
+ > 집다가 도는 표시가 서자 못 찾았다).
179
+
180
+ ### 디자인 시스템 — 빈 칸 두 꼴 · 기둥이 닫히는 것
181
+
182
+ `WordCell` 쪽에 **빈 칸**을 두 꼴로 두었다 — 채울 길이 없는 빈 자리, 그리고 `+` 가 선 자리.
183
+
184
+ 오른쪽 기둥이 **없는 단추만큼 닫히는 것**도 보기로 세웠다(빼기만 / 빼기 + 손잡이 /
185
+ 빼기 + 둘 + 손잡이). 브라우저 실측(칸 810×545, 배율 0.804) —
186
+
187
+ | 보기 | 오른쪽 기둥의 자리 |
188
+ |---|---|
189
+ | 빼기만 | `16.08` |
190
+ | 빼기 + 손잡이 | `16.08` · `48.25` |
191
+ | 빼기 + 둘 + 손잡이 | `16.08` · `48.25` · `80.41` · `112.57` |
192
+
193
+ 한 칸이 `32.16`(40 × 0.804)이고 틈이 0 이라 **빈틈없이 붙어** 선다. 왼쪽 기둥도
194
+ `16.08` · `48.25` 로 **오른쪽과 같은 높이**다.
195
+
196
+ > **복사 단추는 코어에 없다.** 다시듣기·복사처럼 가운데 드는 것은 `renderCellAction` 으로
197
+ > 들어온다 — 하나를 넘기든 둘을 넘기든 안 넘기든 손잡이는 바로 윗것 밑에 붙는다.
198
+
10
199
  ## 0.379.0 — `WordTable` 이 **제 이름**을 쓴다 · 앱의 말 `manager-` 를 걷는다
11
200
 
12
201
  사장님 지시(2026-10-28) 뒤의 ③④. 0.378.0 에 세운 규약(`NAMING.md`)에 맞춘다.