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