@ihabdevteam/core 0.416.0 → 0.424.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 (48) hide show
  1. package/CHANGELOG.md +481 -0
  2. package/dist/components.cjs.js +184 -184
  3. package/dist/components.esm.css +3 -3
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +1 -1
  6. package/dist/ihabdevteam-core.cjs.js +191 -191
  7. package/dist/ihabdevteam-core.d.ts +288 -8
  8. package/dist/packages/core/src/components/Badge.css +26 -0
  9. package/dist/packages/core/src/components/Badge.d.ts +6 -1
  10. package/dist/packages/core/src/components/Button.css +114 -2
  11. package/dist/packages/core/src/components/Button.js +3 -2
  12. package/dist/packages/core/src/components/ChartSection.css +33 -0
  13. package/dist/packages/core/src/components/ChartSection.d.ts +8 -3
  14. package/dist/packages/core/src/components/ChartSection.js +106 -4
  15. package/dist/packages/core/src/components/HeroVisual.css +307 -0
  16. package/dist/packages/core/src/components/HeroVisual.d.ts +79 -0
  17. package/dist/packages/core/src/components/HeroVisual.js +250 -0
  18. package/dist/packages/core/src/components/Landing/Landing.css +235 -0
  19. package/dist/packages/core/src/components/Landing/LandingButton.d.ts +31 -0
  20. package/dist/packages/core/src/components/Landing/LandingButton.js +19 -0
  21. package/dist/packages/core/src/components/Landing/LandingCard.d.ts +31 -0
  22. package/dist/packages/core/src/components/Landing/LandingCard.js +21 -0
  23. package/dist/packages/core/src/components/Landing/LandingSection.d.ts +28 -0
  24. package/dist/packages/core/src/components/Landing/LandingSection.js +18 -0
  25. package/dist/packages/core/src/components/Landing/LandingStatBand.d.ts +23 -0
  26. package/dist/packages/core/src/components/Landing/LandingStatBand.js +90 -0
  27. package/dist/packages/core/src/components/Landing/LandingTitle.d.ts +34 -0
  28. package/dist/packages/core/src/components/Landing/LandingTitle.js +26 -0
  29. package/dist/packages/core/src/components/Popup/DeviceSideTable.js +6 -1
  30. package/dist/packages/core/src/components/StatChart.d.ts +1 -1
  31. package/dist/packages/core/src/components/TableField.css +9 -0
  32. package/dist/packages/core/src/components/Word/wordTableScoring.d.ts +54 -0
  33. package/dist/packages/core/src/components/Word/wordTableScoring.js +60 -0
  34. package/dist/packages/core/src/components/WordTable.css +30 -1
  35. package/dist/packages/core/src/components/WordTable.js +34 -2
  36. package/dist/packages/core/src/components/buttonTypes.d.ts +35 -2
  37. package/dist/packages/core/src/components.d.ts +12 -0
  38. package/dist/packages/core/src/components.js +7 -0
  39. package/dist/packages/core/src/hooks/useWordPoolViability.d.ts +24 -0
  40. package/dist/packages/core/src/hooks/useWordPoolViability.js +101 -0
  41. package/dist/packages/core/src/hooks/useWordTrainingFilter.d.ts +6 -42
  42. package/dist/packages/core/src/hooks/useWordTrainingFilter.js +16 -245
  43. package/dist/packages/core/src/hooks/wordTrainingFilterSections.d.ts +120 -0
  44. package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +183 -0
  45. package/dist/packages/core/src/version.d.ts +1 -1
  46. package/dist/packages/core/src/version.js +1 -1
  47. package/dist/utils.cjs.js +1 -1
  48. package/package.json +5 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,487 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.424.0 — **히어로 비주얼을 컴포넌트로**
11
+
12
+ 랜딩 머리에 세우는 그림 열셋을 `HeroVisual` 하나가 쥔다. 디자인 판(claude.ai/design 의
13
+ `Hero Visual Options`)에서 고른 꼴을 `variant` 로 부른다.
14
+
15
+ ### `HeroVisual` — 새로 생겼다
16
+
17
+ ```tsx
18
+ import { HeroVisual } from '@ihabdevteam/core/components'
19
+
20
+ <div style={{ width: 520 }}>
21
+ <HeroVisual variant="blobs" />
22
+ </div>
23
+ ```
24
+
25
+ **한 바퀴는 등장 · 머묾 · 퇴장**이고, 머무는 동안이 6할이다. 들고 나는 데 오래 걸리면
26
+ 그림이 제 꼴로 서 있는 시간이 짧아져 무엇을 보여 주려던 것인지가 흐려진다.
27
+
28
+ **꼴마다 제 몸에 맞는 길로 든다** — 선은 제 손으로 그어지고(`ribbon` · `doubleRing`),
29
+ 꽃잎·점·원판은 톡 튀어나왔다 다시 점으로 줄어들고(`clover` · `dottedRipple` ·
30
+ `concentric` · `stackedDiscs`), 필은 하나였다가 셋으로 갈라지고(`stackedPills`),
31
+ 방울과 렌즈는 가운데에 겹쳐 있다 갈라지고(`metaball` · `vesica`), 구체는 제자리에서
32
+ 오므라졌다 번지고(`spheres`), 꽃은 가운데에서 피어난다(`flower`).
33
+
34
+ `motion="still"` 은 **멈춰 선 한 장**이다. 한 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지
35
+ 멈추고, **다 선 모습**으로 붙든다 — 들어오는 틀의 0% 는 "아직 안 나온 모습"(크기 0,
36
+ 투명)이라, 그냥 멈추면 빈 자리가 된다. 움직임을 줄여 달라고 한 기기는 묻지 않아도
37
+ 같은 모습이 된다.
38
+
39
+ `cycleMs` 로 한 바퀴 길이를 바꾼다(기본 9000).
40
+
41
+ **크기는 쓰는 쪽이 정한다.** 가로를 100% 채우고 세로는 제 비율대로 따라오므로, 감싸는
42
+ 자리의 폭만 주면 된다.
43
+
44
+ **색은 CSS 변수 여섯으로 나간다**(`--hero-visual-1` … `-6`). 덮어쓰면 열셋이 한꺼번에
45
+ 바뀐다. 이름이 빛깔이 아니라 **줄기의 몇 번째**인지를 말하는 까닭은, 덮어쓰는 쪽이 제
46
+ 색을 넣으면 `blue` 라는 이름이 바로 거짓이 되기 때문이다.
47
+
48
+ `blobs` 와 `metaball` 만 브랜드 토큰(`--color-main` · `--color-sub`)을 쓴다 — 그 둘은
49
+ **지금 랜딩에 선 그림**이라 토큰이 바뀌면 함께 바뀌어야 한다.
50
+
51
+ **끝난 자리가 시작한 자리와 같다.** 나왔던 길로 되짚어 들어가므로 100% 와 0% 의 모습이
52
+ 한 치도 안 다르고, 되풀이되는 자리에서 튀는 데가 없다. 머문 뒤에 비는 마디도 없다 —
53
+ 퇴장이 100% 에서 끝나고 바로 다음 등장이 선다.
54
+
55
+ 이름을 안 주면 `aria-hidden` 으로 숨는다. 글이 따로 있는 히어로의 배경이라, 이름을
56
+ 읽어 주면 같은 말을 두 번 듣는다. 읽히게 하려면 `label` 을 준다.
57
+
58
+ ## 0.423.0 — **제목의 자를 이름에 맞추고, 수 띠 그림자를 옅게**
59
+
60
+ 판을 올리지 않은 채 셋이 쌓여 있던 것을 한 판으로 묶는다. 말귀가 쓰는 자리가 셋 다라
61
+ **올라가야 그쪽 운영에 간다.**
62
+
63
+ ### `ChartSection`·`LandingCard` 제목이 `h3` 인데 `h2` 자를 입고 있었다
64
+
65
+ 요소는 `h3` 인데 `--text-h2`(24px)를 입혀 두어 **이름과 자가 어긋났다.** `--text-h3`(20px)
66
+ 로 맞췄다. 구획 머리는 `h2`(display-2)라 단계는 그대로다.
67
+
68
+ ### `LandingCard` 의 `big` 을 걷었다 — **깨짐**
69
+
70
+ 제목이 두 크기(24px·17px)로 섞여 **같은 쪽 안에서 어느 것이 큰 자리인지 안 읽혔다.**
71
+ 제목은 `h3` 하나에 자 하나다. `big` 을 주던 자리는 그냥 지우면 된다 — 남은 한 꼴이
72
+ 전에 `big` 이던 그 크기다. 놀이터의 '제목을 한 칸 크게' 보기도 함께 걷었다.
73
+
74
+ ### 수 띠 그림자를 옅게
75
+
76
+ 흐린 사본의 `opacity` 를 0.5~0.4 → 0.36~0.28 로 내렸다. 흐림과 거리는 그대로다.
77
+
78
+ ## 0.422.0 — **`Button` 에도 `white` · `black`**
79
+
80
+ 사용자 지시 2026-11-06 — *"베리언트 white, black 추가"*(놀이터 Button 변형 칸을 짚으며).
81
+ 바로 앞 판에서 `Badge` 에 넣은 그 둘을 단추에도 넣는다. **값은 글자 하나 안 다르다** —
82
+ 흰 판에 본색 글자, 검은 판에 흰 글자다.
83
+
84
+ ### 강조가 아니라 바탕이다
85
+
86
+ 단추의 나머지 변형은 **세기**를 말한다 — `main` 은 쪽마다 하나뿐인 주요 행동,
87
+ `default` 는 흔한 보조 행동, `transparent-*` 는 덜 드러나야 하는 행동, `danger` 는
88
+ 되돌릴 수 없는 행동. 이 둘은 세기가 아니다. **놓일 바탕을 고른다.**
89
+
90
+ `transparent-white` 가 이미 있는데 왜 또 흰 것을 넣느냐 — 둘은 다르다.
91
+
92
+ | | 바탕 | 쓰는 자리 |
93
+ |---|---|---|
94
+ | `transparent-white` | 비어 있다(뒤가 비친다) | 사진 위에 테두리만 얹고 싶을 때 |
95
+ | `white` | **흰 판** | 사진 위에서 글자가 묻힐 때 · 브랜드색 띠 안 |
96
+
97
+ ### 테마를 안 따라간다
98
+
99
+ `--color-pureWhite` 는 어두운 테마에서 `#0f1215` 로 **뒤집힌다.** 그 토큰을 쓰면
100
+ `white` 라 적은 단추가 어두운 테마에서 검게 떠 **이름이 거짓말을 한다.** 게다가 이 둘이
101
+ 놓이는 자리(브랜드색 띠 · 사진)는 테마와 함께 안 바뀌는 자리다. 그래서 `#ffffff` ·
102
+ `#000000` 을 그대로 박았다. 바탕을 따라가야 하면 `default` 가 이미 그 일을 한다.
103
+
104
+ 앞 판의 `Badge` 에서 이것을 **놀이터 견본으로 실제로 겪었다** — 바탕에 토큰을 썼더니
105
+ 어두운 테마에서 검은 알약이 검은 바탕에 서서 사라졌다. 같은 함정을 두 번 밟지 않도록
106
+ 두 쪽 놀이터 모두 바탕을 흰색으로 박고, 왜 박았는지를 그 자리에 적어 두었다.
107
+
108
+ ### hover 색을 새로 안 골랐다
109
+
110
+ 색은 고르는 자리가 따로 있다. 그래서 **있는 두 색에서 섞어 썼다**:
111
+
112
+ ```css
113
+ .button--variant-white:hover { background: color-mix(in srgb, var(--color-main) 8%, #ffffff); }
114
+ .button--variant-black:hover { background: color-mix(in srgb, #ffffff 16%, #000000); }
115
+ ```
116
+
117
+ 눌린 꼴(`is-selected` · `aria-pressed`)은 **서로 뒤집는다** — 흰 단추는 브랜드색이 되고,
118
+ 검은 단추는 희어진다. `transparent-white` 가 이미 쓰고 있던 손짓이다.
119
+
120
+ ### 눌린 단추가 제 바탕 위에서 사라지고 있었다
121
+
122
+ 처음에는 테두리까지 함께 뒤집었다. 놀이터에서 재 보니 **브랜드색 판 위의 눌린 흰 단추가
123
+ 판과 똑같은 색**이 되어 통째로 사라졌다(단추 바탕 `73,156,223` · 판 `73,156,223`).
124
+ 검은 쪽도 흰 판에서 똑같았다. 하필 **이 둘이 놓이라고 만든 바로 그 바탕**에서 사라지는
125
+ 것이라 취향이 아니라 결함이다.
126
+
127
+ **테두리는 제 이름 색을 지키게** 했다 — 흰 단추의 테두리는 늘 희고, 검은 단추의 테두리는
128
+ 늘 검다. 쉬는 동안에는 바탕과 같은 색이라 안 보이고(상자 키를 다른 변형과 맞추는 일만
129
+ 한다), 눌리면 바탕이 뒤집히면서 **그 테두리가 윤곽으로 드러난다.**
130
+
131
+ 시험이 두 변형의 모든 규칙에서 **색 글자를 훑어 `#ffffff` · `#000000` 둘뿐임을 센다.**
132
+ 손으로 고른 색이 하나라도 들어오면 거기서 막힌다(`#eef4fb` 를 넣어 빨강을 확인했다).
133
+
134
+ ### 수 띠가 검은 판에서 묻히고 있었다
135
+
136
+ `.button__count`(라벨 옆 강조 숫자)의 기본색은 `--color-main` 이다. 검은 판 위에서
137
+ 디자인 시스템 기본 브랜드색(`#499cdf`)이면 6.8:1 로 읽히지만, **말귀의 브랜드색
138
+ (`#211f9f`)이면 1.6:1** 이라 사실상 안 보인다. `main` 변형이 이미 흰 글자로 갈아타는
139
+ 무리가 있어 거기에 `black` 을 함께 넣었다.
140
+
141
+ ### 명암비
142
+
143
+ `white` 의 글자가 본색이라 **앱마다 다르다**:
144
+
145
+ | 브랜드색 | 흰 판에서 |
146
+ |---|---|
147
+ | 디자인 시스템 기본 `#499cdf` | **2.96:1** — AA 아래 |
148
+ | 말귀 `#211f9f` | **11.92:1** |
149
+
150
+ `black` 은 흰 글자라 어느 브랜드색에서도 21:1 이다. 기본값의 미달은 **알고 두는 것**이라,
151
+ `--brand-main` 기본값이 바뀌면 시험이 *"다시 재라"* 로 빨강을 낸다.
152
+
153
+ ### 한 결정이 세 군데 적힌다 — 그래서 센다
154
+
155
+ 변형 이름 하나를 더하면 **CSS 규칙 · `ButtonVariant` 유니온 · 놀이터 표** 세 자리를 고쳐야
156
+ 한다. 글로 적어 두면 다음 사람이 한 자리를 빠뜨린다. 그래서 시험이 셋을 **서로 센다**:
157
+
158
+ - 놀이터 표에 적힌 변형은 하나도 빠짐없이 CSS 와 유니온에 있다
159
+ - 유니온에 적힌 변형은 하나도 빠짐없이 CSS 에 있다
160
+ - `white` · `black` 은 **세 자리 모두**에 있다
161
+
162
+ 세 훑기 모두 **닻**을 함께 들고 있다 — 셋 중 하나라도 못 읽으면(이름이 바뀌어 정규식이
163
+ 빗나가면) 빈 목록이 조용히 초록을 내므로, `main` 이 세 목록에 다 있는지를 먼저 센다.
164
+
165
+ ### 글에 적힌 수를 걷었다
166
+
167
+ `Button.css` 의 막힌-단추 머리말이 *"hover 규칙 **일곱**은 모두 …"* 라고 적고 있었다.
168
+ 이번에 둘이 늘어 아홉이 된다. 수를 글로 적으면 변형이 늘 때마다 거짓이 되므로 **수를
169
+ 걷고** *"하나도 빠짐없이"* 로 바꿨다.
170
+
171
+ ### 시험
172
+
173
+ `test/buttonWhiteBlackVariants1106.test.tsx` — 26개. 아홉 가지로 일부러 깨서 모두 빨강을
174
+ 확인했다(뒤집히는 토큰으로 바꾸기 · 유니온에서 빼기 · 놀이터 표에서 빼기 · 수 띠 규칙
175
+ 들어내기 · hover 에 새 색 넣기 · hover 통째로 지우기 · 검은 판에 새 색 넣기 · 검은 판
176
+ 수 띠 규칙 빼기 · 눌린 꼴의 테두리를 바탕색으로 되돌리기).
177
+
178
+ 막힌 꼴로 갈리는 것도 함께 들고 있다 — `disabled` 를 주면 변형이 통째로
179
+ `button--variant-disabled` 로 바뀌어 **흰 꼴이 안 남는다.** 믿고 쓰면 안 되는 자리라
180
+ 믿지 말라는 것을 시험으로 적어 두었다.
181
+
182
+ ---
183
+
184
+ ## 0.421.0 — **`Badge` 에 `white` · `black`**
185
+
186
+ 사용자 지시 2026-11-06 — *"badge 에 베리언트 white 하나 만들어줘. 흰색 배경에 main
187
+ 컬러 텍스트로"*, 이어서 *"black 도 하나 더"*.
188
+
189
+ ```css
190
+ .badge--white { --badge-color: #ffffff; --badge-on-color: var(--color-main); }
191
+ .badge--black { --badge-color: #000000; --badge-on-color: #ffffff; }
192
+ ```
193
+
194
+ ### 이 둘은 뜻이 아니라 **바탕**을 고른다
195
+
196
+ 나머지 색은 *뜻*을 말한다 — 위험하다(`danger`) · 됐다(`success`) · 꺼져 있다
197
+ (`disabled`). 이 둘에는 뜻이 없다. `white` 는 **색이 깔린 자리**(브랜드색 띠 · 사진 위)에,
198
+ `black` 은 **밝은 자리**에 놓는 이름표다. 쓰는 쪽이 이것을 모르면 흰 종이에 흰 알약을
199
+ 놓는다 — 그래서 TSDoc · 놀이터 · 시험 세 곳에 같은 말을 적어 뒀다.
200
+
201
+ `black` 의 글자색은 **흰색**이다(나머지 색들과 같다). `white` 만 글자가 본색인 까닭은
202
+ 흰 바탕에 흰 글자가 없어서고, 그 색은 사용자가 골랐다.
203
+
204
+ ### 테마를 안 따라간다 — **일부러다**
205
+
206
+ `--color-pureWhite` 는 어두운 테마에서 `#0f1215` 로 **뒤집힌다**(`tokens.css`). 그 토큰을
207
+ 쓰면 `white` 라 적은 알약이 어두운 테마에서 검게 떠 **이름이 거짓말을 한다.** 게다가 이
208
+ 둘이 놓이는 자리(브랜드색 띠 · 사진)는 테마와 함께 안 바뀌는 자리다. 그래서 `#ffffff` ·
209
+ `#000000` 을 그대로 박았다. 바탕을 따라가야 하면 `default` 가 그 일을 한다.
210
+
211
+ 놀이터 견본 바탕도 같은 이유로 토큰이 아니라 흰색을 박았다 — 처음엔 `--color-pureWhite`
212
+ 를 썼는데, 어두운 테마로 바꾸니 **검은 알약이 검은 바탕에 서서 사라졌다**(실측).
213
+
214
+ ### `fill` 셋을 따로 덮지 않는다
215
+
216
+ `outline` · `soft` 는 `--badge-color` 하나만 본다. 그래서 흰 알약의 테두리·글자는 **흰색**이
217
+ 되는데, 이 둘이 놓이는 바탕에서는 **그것이 맞는 그림**이다(색이 깔린 자리의 흰 테두리).
218
+ 따로 덮어쓰면 오히려 그 자리에서 안 보인다. 시험이 그 덮어쓰기를 막는다.
219
+
220
+ ### 명암비는 **앱의 브랜드색**에 달렸다
221
+
222
+ `white` 의 글자는 `--color-main` 이다.
223
+
224
+ | 브랜드색 | 흰 바탕에서 |
225
+ |---|---|
226
+ | 디자인 시스템 기본 `#499cdf` | **2.96:1** — AA 아래 |
227
+ | 말귀 `#211f9f` | **11.92:1** |
228
+
229
+ 쓰는 앱에서는 넉넉하지만 **기본값으로는 모자란다.** 모르고 둔 것이 아니라 알고 두는
230
+ 것이라, 그 수를 `test/badgeWhiteBlackVariants1106.test.tsx` 가 셈으로 들고 있다 —
231
+ 기본 브랜드색이 바뀌면 못이 울어 *"다시 재라"* 고 말한다.
232
+
233
+ ### 세는 자리
234
+
235
+ 색 목록이 네 곳(CSS · TSDoc · 놀이터 · `PropsBox`)에 적히는데, `success` 때 실제로
236
+ 어긋났다(청 (344)③). `badgeSuccessVariant1028` 이 그것을 세고 있어서 이번에도 그대로
237
+ 센다 — 놀이터 배열이 둘(`VARIANTS` · `INVERSE`)로 갈렸지만 **둘을 합쳐** 센다.
238
+
239
+ ## 0.420.0 — **채점 ○ △ ✕ 획이 자리마다 달라진다**
240
+
241
+ 사용자 지적 2026-11-03 — *"○ 왜 이렇게 두꺼워?"*. 맞는 지적이었다.
242
+
243
+ ### 한 자리를 위한 값이 모든 자리에 걸려 있었다
244
+
245
+ 2026-10-14 (302) 가 `stroke-width` 를 lucide 기본 2 에서 **3.5** 로 올렸다. 그 값은
246
+ *폰 · 읽기 전용 표* 한 자리를 위한 것이다 — 거기서는 아이콘이 **5.5px** 로 그려져
247
+ 획 2 면 **0.46px** 이 되고, 안티에일리어싱에 뭉개져 ○ 와 △ 가 둘 다 '작은 덩어리' 가
248
+ 된다(✕ 만 획이 교차해 남는다). 그러면 "모양과 색 둘 다로 가른다" 가 거기서 깨진다.
249
+
250
+ 그런데 **매길 수 있는 표는 그 자리에 안 간다.** `markUnscale` 이 표 배율을 되돌려 줘서
251
+ 폰에서도 아이콘이 19~20px 로 선다(실측 2026-11-03 · 375px 놀이터: **19.30px**). 거기서
252
+ 3.5 는 **2.81~2.92px** 로 찍힌다 — 저장소의 다른 아이콘보다 눈에 띄게 굵다.
253
+
254
+ | 자리 | 그려진 아이콘 | 획 3.5 로 찍히던 것 | 지금 |
255
+ |---|---|---|---|
256
+ | 데스크톱 · 매길 수 있는 표 | 20.00px | 2.92px | 획 2 → **1.67px** |
257
+ | 폰 375 · 매길 수 있는 표 | 19.30px | 2.81px | 획 2 → **1.61px** |
258
+ | 폰 375 · 읽기만 하는 표 | 5.5px | 0.80px | 획 3.49 → **0.80px** (그대로) |
259
+
260
+ ### 수가 아니라 셈으로 둔다
261
+
262
+ `markStrokeWidth(drawnPx)` 하나가 정한다 — 목표 획 **0.80px**(위 표 맨 아랫줄이 지키던
263
+ 값)을 채우는 데 필요한 굵기를 구하고 **2(lucide 기본)와 3.5 사이로 자른다.** 두 끝 모두
264
+ 오늘의 모양 그대로다. 사이는 이어진다 — 9.6px 아래로 내려가야 2 보다 굵어진다.
265
+
266
+ ### 크기는 **재어서** 넣는다
267
+
268
+ 단추 크기에서 셈하지 않는다. 아이콘 상자는 `Button.css` 가 단추 크기마다 따로 정하고
269
+ (40→20 · 32→18 · 28→16 · 24→14), 그 표를 `WordTable` 에 옮겨 적으면 같은 결정이 두
270
+ 자리에 적혀 조용히 갈린다. 잰 값에는 `scale` 과 `markUnscale` 이 이미 들어 있어 배율을
271
+ 따로 곱할 일도 없다. `test/markStrokeScalesWithSize1103.test.tsx` 가 그 표를 옮겨 적는
272
+ 것을 막는다.
273
+
274
+ **SVG 가 아니라 아이콘 상자(`.button__icon`)를 잰다.** lucide 는 늦게 받아져
275
+ (`useLucideIcon`) 첫 그림에는 SVG 가 없다 — SVG 를 찾으면 굵은 채로 한 번 그려졌다가
276
+ 바뀐다. 상자는 `Button` 이 처음부터 세우고 SVG 는 그 100% 라 크기가 같다.
277
+
278
+ ### 되먹임이 없다
279
+
280
+ 획은 SVG 의 상자를 안 바꾼다 — 상자는 `.button__icon` 이 px 로 쥐고 SVG 는 그 100% 다.
281
+ 브라우저에서 확인했다(2026-11-03): 획을 2 · 3.5 · **8** 로 바꿔 가며 재어도 상자는
282
+ **19.297px 로 한 번도 안 움직였다.** 그래서 재서 굵기를 바꿔도 다시 잴 값이 안 바뀐다.
283
+
284
+ ### 못 받는 자리는 옛 모양 그대로
285
+
286
+ CSS 는 `var(--word-table-mark-stroke, 3.5)` 로 읽는다. 아직 못 잰 첫 그림, 변수를 못 받는
287
+ 자리(SSR · 인쇄 창 캡처)에서는 3.5 다 — 가늘게 시작해 굵어지면 깜빡인다.
288
+
289
+ ### 종이는 제 굵기로 간다
290
+
291
+ 인쇄 · 새 창 · 내려받기는 **격자 칸만 복사하고**(`wordTablePrint` 의 `captureHtml`) 배율과
292
+ 변수를 쥔 `.word-table__scaler` 는 두고 온다. 그래서 종이에서는 되돌림 3.5 가 **제 크기로
293
+ 선 아이콘**에 걸려 화면보다 굵게 찍힌다 — 고친 자리를 종이로 옮겨 놓는 꼴이다.
294
+ 종이는 용지 크기로 1:1 이라 ○ 와 △ 가 뭉개질 일이 없으니 `2` 로 못 박는다.
295
+
296
+ 두 갈래로 적는다 — `@media print` 는 **실제로 인쇄할 때만** 들고, 새 창과 내려받은 HTML 은
297
+ 사람이 화면으로 보는 문서라 거기서는 안 든다. 그 문서의 겉포장(`.paper-wrap`)으로 한 번 더
298
+ 건다. 겉포장 이름이 바뀌면 못이 운다(닻).
299
+
300
+ ### 함께 고친 것 — 0.419.0 의 판 번호
301
+
302
+ 0.419.0 이 `package.json` 만 0.419.0 으로 올리고 `src/version.ts` 는 **0.418.0 인 채로**
303
+ 커밋됐다. 관문 맨 앞 검사(`test/coreVersion.test.ts`)가 바로 그것을 잡는데 안 돌린 것이다.
304
+ 나간 적은 없다(레지스트리는 0.416.0, 그 커밋은 안 밀렸다). 여기서 둘 다 0.420.0 으로
305
+ 맞춘다.
306
+
307
+ ## 0.419.0 — **단추 라벨 말줄임(`ellipsis`)** (청 (373))
308
+
309
+ 사장님 지시 2026-11-03 — *"2줄 나오게 하지말고 이클립스 되도록"*. 말귀_1 이 청으로 올렸다.
310
+
311
+ ### 왜 `nowrap` 으로는 안 되나
312
+
313
+ `nowrap` 머리말에 이미 적혀 있던 손해다 — *"좁은 자리에서 nowrap 은 **넘쳐 잘린다**"*.
314
+ 고를 수 있는 것이 둘뿐이었다: 줄바꿈(키가 늘어난다) 또는 `nowrap`(글자가 상자를 넘어
315
+ 옆을 덮는다). **키가 박힌 단추**(`.button56` 은 `height: 56px`)에서는 줄바꿈이 갈 데가 없다 —
316
+ 말귀 실측(0.418.0 · 폭 1738): 긴 훈련 이름 하나가 라벨 칸을 **60** 으로 부풀려 단추 56 을
317
+ 위아래 1px 씩 비어져 나왔다.
318
+
319
+ 이제 셋째 칸이 생겼다 — **상자 안에서 끝내고 `…` 를 남긴다.**
320
+
321
+ ### 알맹이는 `display` 다
322
+
323
+ `text-overflow` 는 **flex 줄에서 안 먹는다**(글자가 아니라 칸을 나누는 상자라서). 그래서
324
+ `.button__label-text` 를 `inline-flex` → `block` 으로 바꾼다. 가로 자리는 `justify-content`
325
+ 대신 `text-align` 이 들고, 감싼 `.button__label` 의 `min-width` 를 **0 으로 푼다**(flex 자식은
326
+ 밑바탕이 `min-width: auto` 라 제 글자보다 작아지지 않는다 — 안 풀면 말줄임이 영영 안 뜬다).
327
+
328
+ `subLabel` 이 붙은 단추가 더 미묘하다. 윗글은 **제 상자가 없다**(맨 글자 마디) —
329
+
330
+ ```html
331
+ <span class="button__label-text button__label-text--has-sub">
332
+ 윗글<span class="button__sub-label-text">아랫글</span>
333
+ </span>
334
+ ```
335
+
336
+ 그 칸이 flex 인 한 윗글은 익명 칸이 되어 말줄임이 **안 걸린다.** `block` 으로 두면 윗글은
337
+ 줄안 내용이 되어 걸리고, 아랫글은 제가 이미 `display: block` 이라 둘째 줄로 서서 **제
338
+ 말줄임을 따로** 받는다. 세로 틈 3px 은 flex `gap` 이라 block 에서 안 먹으니 바깥 여백으로
339
+ 돌려준다.
340
+
341
+ ### 안 건드린 것
342
+
343
+ `nowrap` 은 그대로다 — 그쪽에 기대어 선 화면이 있다('문자'·'카카오' 처럼 두 글자가 한
344
+ 낱말인 단추). 둘을 함께 줘도 되고, `ellipsis` 가 줄바꿈 금지를 이미 품는다.
345
+
346
+ **밑바탕은 안 바뀐다** — 안 켜면 전과 똑같이 줄바꿈한다.
347
+
348
+ ## 0.418.0 — **수 칸 한 급 더: `xSmall` 120 × 120, 안 들면 스스로 넓어진다** (청 (372))
349
+
350
+ 사장님 지시 2026-11-03 — *"small은 타이틀과 숫자가 적으면 120*120 으로 고정해서
351
+ 사용해보고 싶은데 … 즉 small은 260*120, 120*120 두개지"*. 말귀_1 이 청으로 올렸다.
352
+
353
+ 사다리에 맞아떨어진다 — `small` 이 이미 `120×2 + 20` 이라 **`xSmall` 둘을 가로로 세우면
354
+ `small` 하나와 옆끝이 한 선**에 선다.
355
+
356
+ ### 급만 주면 안 되는 까닭 — **안 드는 날이 온다**
357
+
358
+ 말귀_1 이 *"둘 중 하나만 받아야 한다면 내려앉는 쪽"* 이라고 적어 보냈다. 까닭이 둘인데,
359
+ 둘 다 **부르는 쪽이 고를 수 없는 것**이다.
360
+
361
+ | | 재어 보니 | 속폭 80 |
362
+ |---|---|---|
363
+ | `31,745` 의 수 줄 | **97.3** | **17 넘침** |
364
+ | `Sentence Training` 제목 | **123.4** | **43 넘침** |
365
+ | `Downloads` 제목 | 76.0 | 든다(4 남음) |
366
+ | `Published` 제목 | 67.2 | 든다 |
367
+ | `문장훈련` 제목 | 51.9 | 든다 |
368
+ | `총 다운로드 수` 제목 | 85.1 | **5 넘침** |
369
+
370
+ **수가 자라고, 영어가 거의 다 안 든다.** 한국어로 맞게 박아 둔 카드가 **영어로 바뀌는 날 ·
371
+ 수가 한 자리 자라는 날 조용히 깨진다** — 그러니 사람이 박을 수 없고, 코어가 재야 한다.
372
+
373
+ 깨지는 꼴이 **잘림이 아니라 부풂**이라 더 조용하다. 제목이 두 줄이 되어 카드 키가 120 을
374
+ 넘고 정사각이 무너진다(말귀_1 실측: 129 · 132 · 155). 말줄임으로 박으면
375
+ `Sentence …` · `30일 이상 …` 이 되어 **무엇의 수인지가 사라진다.**
376
+
377
+ ### 그래서 카드가 스스로 잰다
378
+
379
+ 제목이 한 줄에 안 들거나 수 줄이 속폭을 넘으면 **`small`(260 × 120)로 그리고 120 격자에서
380
+ 두 칸을 쓴다**(`grid-column: span 2`). 부르는 쪽이 고칠 것이 없다.
381
+
382
+ **120 에서는 그림씨를 접는다.** 18 + 틈 8 이 속폭 80 에서 26 을 먹으면 제목에 54 만 남아
383
+ 드는 것이 거의 없다. 낭독기 손해는 0 이다 — 그림씨는 본래 `aria-hidden` 이고 제목·수는
384
+ 따로 들어간다. 260 으로 넓어지면 자리가 있으니 다시 보인다.
385
+
386
+ ### 자를 고른 자리 — **카드 폭을 보면 셈이 돈다**
387
+
388
+ `row.scrollWidth > row.clientWidth` 로 재면 120 에서는 맞는다. 그런데 **260 으로 내려앉은
389
+ 뒤 다시 재면 "든다"** 가 되어 도로 120 이 되고, 카드가 두 폭 사이를 오간다. 그래서
390
+
391
+ · **속폭은 늘 120 에서 센다** — `CARD_W_XSMALL - (여백 + 테두리)`,
392
+ · **제목은 숨은 쌍둥이**(`nowrap` · `max-content`)로 잰다 — 카드 폭이 변해도 제 글자만큼,
393
+ · **수 줄은 칸(flex item)들의 속 폭**을 더한다 — 칸은 제 속만큼이라 역시 안 변한다.
394
+
395
+ 미끼를 넣어 확인했다 — 드는 카드의 쌍둥이에 긴 글을 꽂으니 **한 번만** 260 이 되고 멈췄다.
396
+
397
+ ### 속폭은 **80 이다**(82 가 아니다)
398
+
399
+ 말귀_1 이 82 로 적어 보냈는데 다시 재니 **80**(120 − 여백 19×2 − 테두리 1×2)이었다.
400
+ 자 셋이 소수점까지 맞았다 — 쌍둥이 상자 · `canvas measureText` · `Range`.
401
+
402
+ **그리고 이 수는 코어 기본값에서만 참이다.** 폰(767 이하)에서는 수 칸의 여백이
403
+ `12px 14px 16px` 로 덮여 **속폭이 90** 이 된다(실측: 같은 카드 넷이 폰에서는 다 들었다).
404
+ 그래서 **코드는 80 을 안 박고 그 자리에서 읽는다** — 소비처가 여백을 덮어도 따라간다.
405
+
406
+ ### 놀이터에서 잡은 것 — **`auto-fill` 이 40px 칸을 만든다**
407
+
408
+ 놀이터 격자를 `repeat(auto-fill, 120px)` 로 뒀더니 그 격자가 ComponentBox 안에서 제
409
+ 속만큼(180)만 넓어졌고, `auto-fill` 이 거기에 **`120px 40px`** 두 칸을 만들었다. 둘째
410
+ 칸의 카드가 40 으로 눌려 제목이 **세 줄**이 됐다. 칸 수를 박아 고쳤다.
411
+
412
+ 여기서 선이 하나 드러난다 — **코어는 "120 을 주면 든다" 고 할 뿐, 부르는 쪽이 40 을 주는
413
+ 것까지는 못 막는다.**
414
+
415
+ ### 부르는 쪽
416
+
417
+ ```tsx
418
+ <ChartSection type="stat" size="xSmall" title="회원" totalNum={48} icon="user" inGrid />
419
+ ```
420
+
421
+ 격자는 칸 120 · 틈 20 으로 둔다. `size="xSmall"` 은 **수 칸 전용**이다 — 차트 카드가
422
+ 받으면 `small` 로 읽는다(속폭 80 에 차트가 설 자리가 없다).
423
+
424
+ ## 0.417.0 — **머리글이 조용히 잘리던 것** (청 (368))
425
+
426
+ 표 머리글이 칸보다 길면 **끊긴 표시도 없이** 사라지고 있었다. 말귀_2 가 올린 청이고,
427
+ 코어 몫이 **둘**이다.
428
+
429
+ ### ① 끊겼으면 끊겼다고 보여 준다
430
+
431
+ `.table-field` 와 `.table-field__button` 이 `overflow: hidden` 인데 **`text-overflow` 를
432
+ 안 적어** 기본값 `clip` 으로 잘렸다. `Colloquial Pronunciation` 이
433
+ `Colloquial Pronunciati` 로 서면 **그것이 본디 이름인 줄로 읽힌다.** `ellipsis` 를 둔다.
434
+
435
+ 그 자리에 *"열 이름은 폭을 넓히면 다시 보인다"* 고 적혀 있었는데 **넓은 화면에서만 참**이다
436
+ — 좁은 화면(`max-width: 767px`)에서는 폭 조절을 통째로 끄므로 되돌릴 길이 없다.
437
+
438
+ ### ② `DeviceSideTable` 첫 칸 56 → 68
439
+
440
+ 실측(2026-11-03 · 머리 글꼴 400 13px · 좌우 여백 32):
441
+
442
+ | 머리글 | 잉크 | 드는 폭 | 56px 에서 |
443
+ |---|---|---|---|
444
+ | `착용` | 22.5 | 54.5 | **1.5px 남고 든다** |
445
+ | `In use` | 34.5 | **66.5** | **10.5px 잘림** |
446
+
447
+ **한국어로만 보고 고른 수였다.** 나머지 일곱은 다 남는다(가장 빠듯한 `Device Type` 103.7 <
448
+ 110). 표가 12px 넓어지고 좁은 화면에서는 그만큼 더 밀어 본다 — 담을 수 없을 때 **옆으로
449
+ 미는 것**이 이 표의 답이다(사장님 2026-09-22, `Table.tsx` 에 박혀 있다).
450
+
451
+ ### 이 청에서 **코어 몫이 아니었던 것**
452
+
453
+ 말귀_2 가 처음 올린 열여섯 칸 가운데 **열넷은 앱이 적어 둔 폭**이었다(`/word-management`
454
+ `:463` · `/customers` `:265`). 본인이 코드를 읽어 바로잡아 왔다. 그 수들도 `72`·`64`·`76`
455
+ 처럼 **한국어로만 보고 고른 수**라 같은 꼴이지만, 고치는 자리가 앱이다.
456
+
457
+ **우리 둘이 같은 덫에 반대로 걸렸다** — 열여섯 칸이 모두 `잘림 = max(0, 잉크 − (상자 − 32))`
458
+ 에 오차 0 으로 맞자, 말귀_2 는 *"원인이 하나니 코어다"* 로, 나는 *"증상이 같으니 내 놀이터
459
+ 것과 같다"* 로 읽었다. **한 식이 여러 원인을 덮는다** — 그 식은 *잘리는 양*을 맞히는 것이고
460
+ *그 상자가 어디서 왔는지*는 안 말해 준다. 갈린 것은 `--table-grid-cols` 를 **읽어 본** 뒤였다.
461
+
462
+ ### 남은 것 — 바닥이 격자에 안 실린다
463
+
464
+ 밑값 없는 `fr` 틀(`1fr 1.6fr 0.9fr …`)에서는 `columnFloors` 가 머리글 바닥을 **구해도
465
+ 격자에 안 실린다.** 놀이터 `TablePage:181` 이 그 꼴이라 `Status` 가 두 폭(375·768) 모두
466
+ 12~13px 잘린다. 셈이 헛도는 것이라 따로 봐야 한다 — 이 판에는 안 들어갔다.
467
+
468
+ ### 소비처가 볼 것
469
+
470
+ - 머리글이 잘리던 자리에 **말줄임(…)이 보인다.** 폭이 바뀌지는 않는다.
471
+ - 고객 상세 `기기` 표가 **12px 넓어진다**(첫 칸 56 → 68).
472
+ - 앱이 적어 둔 열 폭 가운데 **한국어로만 보고 고른 수**가 있으면 영어에서 잘린다 —
473
+ 말귀_2 가 `FULL_AUDIT` (78) 로 옮겨 두었다.
474
+
475
+ ### 그 닻이 못 보는 자리 하나
476
+
477
+ 여백 닻은 **코어 기본값만 센다.** 어드민이 `DataPage.css:181` 에서
478
+ `.data-page .table-field { padding: 0 12px }` 로 덮고 있어(열이 아홉이라 기본 여백이면
479
+ 값보다 여백이 넓어진다), **그 화면에서는 드는 폭이 `잉크 + 24`** 다. 코어 못이 소비처 CSS 를
480
+ 볼 길은 없으니 막지는 못하고, **"기본 여백에서만 참"** 임을 못 안에 적어 뒀다.
481
+
482
+ 말귀_2 가 짚어 준 것이고, 같은 자리에서 그쪽 자도 `−32` 를 박고 있었다 — 열여섯 칸이 오차 0
483
+ 이었던 것은 **그 칸들이 다 기본 여백이었기 때문**이다. 화면에서 잴 때는 **여백을 아예 모르는
484
+ 자**를 쓰는 편이 맞다(`btn.scrollWidth > btn.clientWidth`).
485
+
486
+ 못은 `test/tableHeadNotSilentlyClipped1103.test.ts` 6개다. **넷을 따로 깨 봤다** — 말줄임을
487
+ 걷으면 2개, 첫 칸을 56 으로 되돌리면 1개, **영어 글귀를 바꾸면 1개**(닻), **여백을 20 으로
488
+ 바꾸면 1개**(실측 바탕)가 운다. 글 폭은 안 잰다(jsdom 은 글꼴을 모른다) — 브라우저에서 잰
489
+ 수를 적되 **닻을 함께 박아**, 글귀나 여백이 바뀌면 *"다시 재라"* 고 말하게 했다.
490
+
10
491
  ## 0.416.0 — **기간 고르개 이름표가 끝까지 보인다** · 영어는 짧은 꼴로 (청 (365))
11
492
 
12
493
  차트 카드 머리의 기간 고르개가 상자를 **150px 에 못으로 박고** 있어서 긴 이름표가 끊겼다.